Implementando a customização Criar pedido

Saiba como implementar as customizações Criar pedido em seus ambientes do Order Hub 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 create-order que você customizou.
      Por exemplo,
      {
          "repositoryName": "buc-app-order",
          "customizationContextRoot": "/buc-app-customization/balohTK3ang5GmXsRwOSeSidbQOKEw6N",
          // replace this with the value you retrieved for customization folder
          "routes": {
              "create-order": {
                  "type": "code"
              }
          }
      }
      
  6. Abra o arquivo buc-app-order/packages/create-order/package.json .
  7. Adicione a seguinte propriedade ao script de compilação mesclada: - --deploy-url=<customizationContextRoot>/buc-app-order/create-order.
    Por exemplo,
    "build-merged": "ng build create-order --configuration=merged-prod --deploy-url=/buc-app-customization/balohTK3ang5GmXsRwOSeSidbQOKEw6N/buc-app-order/create-order/"
    
    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 'create-order' ), 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. Faça login no Order Hub de última geração.
    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 voltam aos rótulos originais sem (MODO DE DESENVOLVIMENTO). Agora você pode verificar se suas personalizações estão disponíveis e sendo renderizadas a partir do Order Hub de última geração, em vez do seu kit de ferramentas de desenvolvedor.

Resultados

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