Customizando aplicativos existentes

É possível iniciar com qualquer um dos aplicativos Order Hub existentes e, em seguida, customizar os módulos dentro do aplicativo. Por exemplo, você pode personalizar a página de resultados da pesquisa de pedidos para recuperar mais dados da API do IBM Sterling® Order Management System e exibir os dados em uma tabela existente.

Customizando um módulo existente

Certifique-se de ter extraído o código Order Hub . Para obter mais informações, consulte Introdução à customização do Order Hub.
Abra um terminal e acesse o diretório de código Order Hub .
- O local padrão é devtoolkit_docker/orderhub-code..

Acesse o módulo que você deseja customizar. Por exemplo, se desejar atualizar o módulo de pedido, acesse a pasta buc-app-order :

cd devtoolkit_docker/orderhub-code/buc-app-order

Tabela 1. Mapeamento entre o item de menu e o nome da pasta do Order Hub no kit de ferramentas
Menu em Order Hub	Nome do módulo / pasta	Porta
Página inicial Espaços de trabalho Alertas Configurações> Regras de alerta	buc-app-workspace	8900
Nós e capacidade	buc-app-node	8200
Pedidos Remessas	buc-app-order	8300
Inventário	buc-app-inventory	8600
Atendimento de pedidos Promessa e cumprimento	buc-app-fulfillment	9000
Exceções	buc-app-exception	9100
Configurações> Configurações de exibição Configurações> Funções de usuário. Configurações> Customização Configurações> Sobre Configuração> Grupos de distribuição	buc-app-settings	8400
Configurações> Nós Configurações> Portadoras Configurações> Atributos customizados Configurações> Locatário	buc-app-configurações	9200

Execute o comando a seguir para configurar strict-ssl como false
```
yarn config set "strict-ssl" false
```
Se você atualizou o ambiente do kit de ferramentas do desenvolvedor com uma nova versão, execute o seguinte comando para assegurar que você obtenha a versão mais recente de todas as dependências de software livre e biblioteca.
```
yarn cache clean
```
Execute o seguinte comando para instalar todas as dependências para o módulo.
```
yarn install --update-checksums
```
Se você encontrar um erro semelhante à mensagem a seguir, poderá ignorar com segurança o erro. Esses erros não afetam os ícones usados pelo Order Hub.
```
Error: Failed to compile entry-point @carbon/icons-angular/
```
Abra o arquivo overrides.json na raiz do módulo / pasta.. Por exemplo, devtoolkit_docker/buc-app-order/overrides.json..
Atualize as rotas das páginas que você está personalizando configurandorunAsCustomization para verdadeiro. Por exemplo, se você desejar editar a página Procura de Pedido , configure order-search como true
```
    "order-search": {
      "runAsCustomization": true
    },
```
Inicie o servidor.
```
yarn start-app
```
Pode demorar vários minutos para compilar e iniciar o aplicativo..
Nota: você vê a seguinte mensagem.
```
" ** Angular Live Development Server está atendendo no bucgenerichost: < port>, 
abra seu navegador em https://localhost: < port> / < module> / < route> ** "
```
Você pode ignorar essa mensagem.
Nota: se você encontrar um erro semelhante à seguinte mensagem, aumente o tamanho de heap antes de iniciar o novo aplicativo.
```
O comando de erro falhou com o código 134 existente
lerna ERR! Início da execução do yarn .... saiu 134
```
Execute o comando a seguir e, em seguida, inicie o novo aplicativo
- Prompt do Windows CMD:
```
SET NODE_OPTIONS=--max_old_space_size=8048
```
- Bash/ Git Bash:
```
export NODE_OPTIONS=--max_old_space_size=8048
```
- PowerShell:
```
$Env:NODE_OPTIONS=--max_old_space_size=8048
```
Nota: Se for necessário parar o servidor, pare a tarefa do servidor e execute o comando yarn stop-app para verificar se tudo está parado corretamente

Observação: Inicie apenas os servidores dos módulos que você está customizando. Sempre que você personaliza um módulo, você precisa executaryarn start-app no respectivo diretório do módulo para visualizar as páginas personalizadas dentro do módulo.
Agora você está pronto para customizar.
Customize as páginas existentes fornecidas pela IBM. Hub de Pedido suporta os seguintes níveis de customização quando se trata de incluir funcionalidade em páginas existentes:
- Customização por configuração
- Customização por código
  - Customização diferencial
  - Customização por substituições
Para mais informações, veja Personalizando o Order Hub de próxima geração.
Ou, passe pelo tutoriais :
- Tutorial: Personalizando a ação Agendar pedido - Utiliza a abordagem de customização diferencial e customização por substituições.
- Tutorial: Personalizando o fluxo Criar pedido - Utiliza abordagens de customização por configuração e customização por substituições.
- Tutorial: Personalizando a página de resultados da pesquisa de inventário - Utiliza abordagens de customização por configuração e customização por substituições.
Depois de personalizar o módulo, você pode testar as personalizações em Centro de pedidos .