Introdução à customização do Order Hub

Antes de customizar o Order Hub, configure um Developer Toolkit (DTK) e, em seguida, extraia o código-fonte para um diretório criado. Quando você tiver o Centro de pedidos código-fonte, você pode criar novos aplicativos ou personalizar aplicativos existentes para atender às suas necessidades de negócios. Depois de customizar o Order Hub, teste suas customizações para verificar se elas estão funcionando conforme desejado em seu ambiente.

Procedimento

Instale uma versão Node.js versão compatível com o Angular v15 ou v18. Para obter mais informações, consulte Compatibilidade de versão Se forem necessárias várias versões de nós, você pode considerar o uso do nvm para Mac ou Linux® ) ou do nvm-windows (para Windows).
Instale Yarn.
Instale a CLI do Angular globalmente executando um dos seguintes comandos em um console.
Para o Angular v18, execute o seguinte comando.
```
npm install -g @angular/cli@18
```
Para o Angular v20, execute o seguinte comando.
```
npm install -g @angular/cli@20
```
Configure o arquivo de hosts para mapear bucgenerichost para localhost. É necessário o mapeamento para conectar o Order Hub ao ambiente de desenvolvimento local.
Veja o exemplo a seguir.
1. Abra o arquivo de hosts
  - No Windows 10, abra o seguinte arquivo:C:\Windows\System32\drivers\etc\hosts
  - Para Linux / Mac OS, abra o seguinte arquivo: sudo vim /etc/hosts
2. Inclua bucgenerichost em localhost.. Por exemplo,
```
127.0.0.1 localhost bucgenerichost
```
Para obter um desempenho ideal, faça download e configure um ambiente do kit de ferramentas do desenvolvedor em sua Estação de Trabalho local Não configure o kit de ferramentas dentro de outro contêiner Docker ou em uma máquina virtual. Para obter mais informações, consulte Configuração de um ambiente de kit de ferramentas de desenvolvedor.
1. Faça download do kit de ferramentas do desenvolvedor para sua estação de trabalho local na qual você deseja desenvolver customizações para o Order Hub.
  
  Dica: para Windows, salve o arquivo devtoolkit_docker.tar no diretório raiz, como C:/devtoolkit_docker.tar. Após a instalação, os arquivos são extraídos para a estação de trabalho local e os caminhos de arquivo longos podem causar problemas
2. Abra um console na estação de trabalho local.
3. Procure o local no qual você transferiu por download o arquivo .tar e execute o comando a seguir.
```
tar -xf devtoolkit_docker.tar && chmod +x devtoolkit_docker/compose/*.sh 
```
  O comando cria uma pasta devtoolkit_docker em sua estação de trabalho local
4. No diretório devtoolkit_docker/compose , crie uma cópia do arquivo devtoolkit_docker/compose/om-compose.properties.sample e nomeie-o como om-compose.properties conforme mostrado no exemplo a seguir.
```
cp om-compose.properties.sample om-compose.properties
```
5. Certifique-se de que o arquivo om-compose.properties inclua o seguinte valor.
```
ORDERHUB_MODE=omoc
```
6. Iniciar Docker.
  Se você instalou o Docker Desktop, inicie o Docker Desktop Se você instalou Docker Engine, começar Docker através da interface de linha de comando usando osudo service docker start comando.
7. Configure o kit de ferramentas do desenvolvedor executando um dos comandos a seguir.
  - Para configurar o Order Hub no kit de ferramentas do desenvolvedor, execute o comando ./om-compose.sh setup-orderhub .
  - Para configurar um kit de ferramentas de desenvolvedor novo e completo para incluir também outros contêineres Order Management Software, como o Sterling™ Business Center, execute o comando ./om-compose.sh setup.
  - Para atualizar um kit de ferramentas do desenvolvedor completo existente para também incluir outros contêineres relacionados ao Order Management Software, como Sterling Business Center, execute o comando ./om-compose.sh setup-upg .
8. Para extrair o código-fonte para sua estação de trabalho local, execute o comando a seguir Use o código-fonte para customizar o Order Hub.
```
./om-compose.sh extract-orderhub-code omoc
```
  O código-fonte está disponível em sua estação de trabalho local em devtoolkit_docker/orderhub-code
  Nota: Se você usou o Subsistema Windows para Linux versão 2 (WSL 2) para instalar o kit de ferramentas, os arquivos também estarão disponíveis em sua estação de trabalho local. Por exemplo, se você executou os comandos em WSL em /mnt/c/devtoolkit_docker, então os arquivos também estarão disponíveis em C:/devtoolkit_docker Conclua todas as customizações em sua estação de trabalho local, que está em C:/devtoolkit_docker
Customize Order Hub para atender às suas necessidades de negócios. Você pode criar um aplicativo que pode ser acessado por meio de um novo item de menu ou personalizar aplicativos existentes fornecidos pelo IBM.
Para obter mais informações, consulte Criação de novos aplicativos ou Personalização de aplicativos existentes.