Despliegue de la personalización de orden de planificación

Información sobre cómo desplegar las personalizaciones de pedidos de planificación en los entornos de Order Hub SaaS . Para obtener más información sobre el proceso de despliegue, consulte Despliegue de personalizaciones para aplicaciones existentes.

Procedimiento

  1. Inicie sesión en Order Hub.
  2. Cambie al arrendatario donde desea publicar la personalización.
  3. Vaya a Configuración > Configuraciones > Complementos > Configuración de personalización.
  4. Registre los valores siguientes.
    Carpeta de personalización
    Utilice este valor como customizatonContextRoot que necesita definir en package-customization.json para empaquetar las personalizaciones.
    ID de cliente de personalización
    Utilice este valor como client-id cuando ejecute el mandato para desplegar personalizaciones.
    Clave de autorización de personalización
    Utilice este valor como client-secret cuando ejecute el mandato para desplegar personalizaciones. La clave de autenticación sólo se visualiza cuando se configura por primera vez el arrendatario. Si no conoce la clave de autenticación, pulse Volver a generar claves.
  5. Edite el archivo package-customization.json que está en el nivel raíz del módulo que ha personalizado.
    1. Puesto que ha personalizado el módulo buc-app-order , abra el archivo devtoolkit_docker/orderhub-code/buc-app-order/package-customization.json .
    2. Actualice el customizationContextRoot con el valor de la carpeta de personalización que recuperó en el paso 4.
    3. En la sección "routes", incluya la ruta order-search-result que ha personalizado.
      Por ejemplo:
      {
          "repositoryName": "buc-app-order",
          "customizationContextRoot": "/buc-app-customization/balohTK4anG5GmXsRwOSeSidbQOKEw6N",
          // replace this with the value you retrieved for customization folder
          "routes": {
              "order-search-result": {
                  "type": "code"
              }
          }
      }
      
  6. Abra el archivo buc-app-order/packages/order-search-result/package.json .
  7. Añade la siguiente propiedad al script build-merged: - --deploy-url=<customizationContextRoot>/buc-app-order/order-search-result.
    Por ejemplo:
    "build-merged": "ng build order-search-result --configuration=merged-prod --deploy-url=/buc-app-customization/balohTK4anG5GmXsRwOSeSidbQOKEw6N/buc-app-order/order-search-result/"
    
    Nota: Es necesario actualizar el script build-merge porque ha personalizado un módulo existente.
  8. Cree un archivo features.json en devtoolkit_docker/packages/buc-app-order.
    Puesto que no ha añadido ninguna ruta nueva (sólo ha personalizado la ruta 'order-search-result' existente), añada una matriz vacía.
    []
  9. Abra un terminal y vaya a la carpeta raíz del módulo devtoolkit_docker/orderhub-code/buc-app-order.
  10. Ejecute el mandato siguiente para crear el paquete para el despliegue. Este mandato puede tardar algún tiempo en completarse.
    yarn package-customization
  11. Ejecute el mandato siguiente para desplegar las personalizaciones en el arrendatario.
    yarn orderhub-cli publish-customization --client-id=<clientId> --client-secret=<clientSecret> --package-name=buc-app-order
    Nota: Si el comando publish-customization falla (por ejemplo, debido a un secreto de cliente incorrecto), puede volver a ejecutar el comando con los parámetros --publish-only=true --package-name. /dist/buc-app-order.zip.
    yarn orderhub-cli publish-customization --client-id=<clientId> --client-secret=<clientSecret> --publish-only=true --package-name=./dist/buc-app-order.zip
    Para obtener más información sobre cómo utilizar el mandato publish-Customization, consulte Despliegue de personalizaciones para aplicaciones existentes.
  12. Si ha desplegado las personalizaciones en el arrendatario de DEV, desconecte la conexión con el kit de herramientas del desarrollador realizando los pasos siguientes. Si ha desplegado en un arrendatario diferente, simplemente inicie sesión en el arrendatario para verificar que las personalizaciones están disponibles.
    1. Inicie sesión en Order Hub.
    2. Vaya a Valores > Personalización.
    3. Pulse Habilitar personalización de módulo OOB.
    4. Establezca el módulo que ha personalizado en OFF.
    5. Guarde los cambios y vuelva a cargar el bastidor.
      Los menús vuelven a las etiquetas originales sin "(DEV MODE)". Ahora puede verificar que las personalizaciones están disponibles y se representan desde Order Hub en lugar del kit de herramientas del desarrollador.

Resultados

Ha desplegado correctamente las personalizaciones en el arrendatario y ha completado la guía de aprendizaje.