Personalização de aplicativos existentes

Você pode começar com qualquer um dos aplicativos existentes do Order Hub e, em seguida, personalizar 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.

Personalização de um módulo existente

Certifique-se de que você extraiu o código Order Hub. Para obter mais informações, consulte Começando a personalizar o Order Hub de última geração
Abra um terminal e vá para o diretório de código do Order Hub. Para contêineres, o local padrão é devtoolkit_docker/orderhub-code.

Vá para o módulo que você deseja personalizar. Por exemplo, se você quiser atualizar o módulo de pedidos, vá para a pasta buc-app-order:

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

Tabela 1. Mapeamento entre o item de menu Order Hub e o nome da pasta 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 do usuário Configurações > Personalização Configurações > Sobre Configuração > Grupos de distribuição	buc-app-settings	8400
Configurações > Nós Configurações > Transportadoras Configurações > Atributos personalizados Configurações > Inquilino	configurações do aplicativo buc	9200
Segurança > Usuários	usuário-do-aplicativo-buc	9600

Execute o seguinte comando para definir strict-ssl como falso.
```
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 garantir que você obtenha a versão mais recente de todas as dependências de código aberto e de biblioteca.
```
yarn cache clean
```
Execute o seguinte comando para instalar todas as dependências do módulo.
```
yarn install --update-checksums
```
Se você encontrar um erro semelhante à mensagem a seguir, poderá ignorá-lo com segurança. 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, definindo runAsCustomization como true. Por exemplo, se você quiser editar a página Order search, defina order-search como true.
```
    "order-search": {
      "runAsCustomization": true
    },
```
Inicie o servidor.
```
yarn start-app
```
Pode levar vários minutos para compilar e iniciar o aplicativo.
Nota: Você vê a seguinte mensagem.
```
"** O servidor de desenvolvimento do Angular Live está escutando em bucgenerichost:<port>, 
Abra seu navegador em https://localhost:<port>/<module>/<route> **"
```
Você pode ignorar essa mensagem.
Nota: Se você encontrar um erro semelhante à mensagem a seguir, aumente o tamanho do heap antes de iniciar o novo aplicativo.
```
O comando de erro falhou com o código de existência 134.
lerna ERR! Início da corrida do fio... saiu 134
```
Execute o seguinte comando e inicie o novo aplicativo.
- Prompt de CMD do Windows:
```
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 você precisar interromper o servidor, interrompa o trabalho do servidor e execute o comando yarn stop-app para verificar se tudo foi interrompido corretamente.

Nota: Inicie apenas os servidores dos módulos que você está personalizando. Sempre que você personalizar um módulo, precisará executar yarn start-app no respectivo diretório do módulo para visualizar as páginas personalizadas dentro do módulo.
Agora você está pronto para personalizar.
Personalize as páginas existentes que são fornecidas pela IBM. O Order Hub suporta os seguintes níveis de personalização quando se trata de adicionar funcionalidade a páginas existentes:
- Personalização por configuração
- Personalização por código
  - Personalização diferencial
  - Personalização por substituições
Para obter mais informações, consulte Personalização do Order Hub de última geração.
Ou consulte os tutoriais:
- Tutorial: Personalização da ação Programar ordem - Usa a abordagem de personalização diferencial e personalização por substituições.
- Tutorial: Personalização do fluxo de pedidos Create - Usa as abordagens de personalização por configuração e personalização por substituições.
- Tutorial: Personalização da página de resultados de pesquisa do Inventário - Usa as abordagens de personalização por configuração e personalização por substituições.
Depois de personalizar o módulo, você pode testar as personalizações no Order Hub.