Implementando a customização do pedido de Planejamento..

Aprenda como implementar as customizações de pedido de Planejamento em seus ambientes do Hub de Pedido. SaaS Para saber mais sobre o processo de implementação, consulte Implementando customizações para aplicativos existentes.

Procedimento

  1. Efetue login no Order Hub.
  2. Alterne para o locatário no qual você deseja publicar a customização.
  3. Acesse Configurações > Configurações > Complementos > Configuração de customização
  4. Registre os valores a seguir.
    Pasta de customização
    Use esse valor como o customizatonContextRoot que você precisa definir no package-customization.json para empacotar as customizações..
    ID de cliente de customização
    Use esse valor como client-id ao executar o comando para implementar customizações.
    Chave de autenticação de customização
    Use esse valor como client-secret ao executar o comando para implementar customizações. A chave de autenticação é exibida apenas quando você configura o locatário pela primeira vez Se você não souber a chave de autenticação, clique em Regenerar Chaves
  5. Edite o arquivo package-customization.json que está no nível raiz do módulo customizado.
    1. Como você customizou o módulo buc-app-order , abra o arquivo devtoolkit_docker/orderhub-code/buc-app-order/package-customization.json .
    2. Atualize o customizationContextRoot com o valor da pasta de personalização que você recuperou na etapa 4.
    3. Na seção "rotas", inclua a rota order-search-result customizada.
      Por exemplo,
      {
          "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 o arquivo buc-app-order/packages/order-search-result/package.json .
  7. Adicione a seguinte propriedade ao script de compilação mesclada: - --deploy-url=<customizationContextRoot>/buc-app-order/order-search-result.
    Por exemplo,
    "build-merged": "ng build order-search-result --configuration=merged-prod --deploy-url=/buc-app-customization/balohTK4anG5GmXsRwOSeSidbQOKEw6N/buc-app-order/order-search-result/"
    
    Nota: é necessário atualizar o script de build-merge porque você customizou um módulo existente.
  8. Crie um arquivo features.json em devtoolkit_docker/packages/buc-app-order
    Como você não incluiu nenhuma nova rota (somente customizou a rota existente do 'order-search-result' ), inclua uma matriz vazia
    []
  9. Abra um terminal e acesse a pasta raiz do módulo devtoolkit_docker/orderhub-code/buc-app-order.
  10. Execute o seguinte comando para construir o pacote para implementação. Este comando pode levar algum tempo para ser concluído
    yarn package-customization
  11. Execute o comando a seguir para implementar as customizações no locatário.
    yarn orderhub-cli publish-customization --client-id=<clientId> --client-secret=<clientSecret> --package-name=buc-app-order
    Observação: Se o comando publish-customization falhar (por exemplo, devido a um segredo de cliente incorreto), você poderá executar novamente o comando com os 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 obter mais informações sobre como usar o comando publish-customization, consulte Implementando customizações para aplicativos existentes
  12. Se você implementou suas customizações no locatário DEV, desconecte a conexão com o kit de ferramentas do desenvolvedor concluindo as etapas a seguir. Se você tiver implementado em um locatário diferente, basta efetuar login no locatário para verificar se suas customizações estão disponíveis.
    1. Efetue login no Order Hub.
    2. Acesse Configurações > Customização.
    3. Clique em Ativar customização do módulo OOB.
    4. Configure o módulo customizado para OFF.
    5. Salve suas alterações e recarregue o quadro
      Os menus são revertidos para os rótulos originais sem "(DEV MODE)". Agora é possível verificar se suas customizações estão disponíveis e renderizar do Order Hub em vez de seu kit de ferramentas do desenvolvedor.

Resultados

Você implementou com sucesso as customizações em seu locatário e concluiu o tutorial..