Iniciación a la personalización de Order Hub

Antes de personalizar Order Hub, configure un Developer Toolkit (DTK) y, a continuación, extraiga el código fuente en un directorio que cree. Cuando tienes el Centro de pedidos código fuente, puede crear nuevas aplicaciones o personalizar aplicaciones existentes para satisfacer sus necesidades comerciales. Después de personalizar Order Hub, pruebe las personalizaciones para verificar que funcionan según lo previsto en el entorno.

Procedimiento

Instale una Node.js versión que sea compatible con Angular v15 o v18. Para obtener más información, consulte Compatibilidad de versiones. Si se necesitan varias versiones de nodo, puede considerar el uso de nvm para Mac o Linux® ) o nvm-windows (para Windows).
Instale Yarn.
Instale la CLI Angular globalmente ejecutando uno de los siguientes comandos en una consola.
Para Angular v18, ejecute el siguiente comando.
```
npm install -g @angular/cli@18
```
Para Angular v20, ejecute el siguiente comando.
```
npm install -g @angular/cli@20
```
Configure el archivo hosts para correlacionar bucgenerichost con localhost. Necesita la correlación para conectar Order Hub con el entorno de desarrollo local.
Consulte el ejemplo siguiente.
1. Abra el archivo hosts.
  - Para Windows 10, abra el siguiente archivo:C:\Windows\System32\drivers\etc\hosts
  - Para Linux / Mac OS, abra el siguiente archivo: sudo vim /etc/hosts
2. Añada bucgenerichost a localhost. Por ejemplo:
```
127.0.0.1 localhost bucgenerichost
```
Para obtener un rendimiento óptimo, descargue y configure un entorno de kit de herramientas de desarrollador en la estación de trabajo local. No configure el kit de herramientas dentro de otro contenedor Docker o en una máquina virtual. Para obtener más información, consulte Configuración de un entorno de kit de herramientas para desarrolladores.
1. Descargue el kit de herramientas del desarrollador en la estación de trabajo local donde desea desarrollar personalizaciones para Order Hub.
  
  Sugerencia: Para Windows, guarde el archivo devtoolkit_docker.tar en el directorio raíz, como C:/devtoolkit_docker.tar. Después de la instalación, los archivos se extraen en la estación de trabajo local y las vías de acceso de archivo largas pueden causar problemas.
2. Abra una consola en la estación de trabajo local.
3. Vaya a la ubicación en la que ha descargado el archivo .tar y ejecute el mandato siguiente.
```
tar -xf devtoolkit_docker.tar && chmod +x devtoolkit_docker/compose/*.sh 
```
  El mandato crea una carpeta devtoolkit_docker en la estación de trabajo local.
4. En el directorio devtoolkit_docker/compose , cree una copia del archivo devtoolkit_docker/compose/om-compose.properties.sample y dele el nombre om-compose.properties tal como se muestra en el ejemplo siguiente.
```
cp om-compose.properties.sample om-compose.properties
```
5. Asegúrese de que el archivo om-compose.properties incluye el valor siguiente.
```
ORDERHUB_MODE=omoc
```
6. Inicie Docker.
  Si ha instalado Docker Desktop, inicie Docker Desktop. Si instalaste Docker Engine, comenzar Docker a través de la interfaz de línea de comandos utilizando elsudo service docker start dominio.
7. Configure el kit de herramientas del desarrollador ejecutando uno de los mandatos siguientes.
  - Para configurar Order Hub en el kit de herramientas del desarrollador, ejecute el mandato ./om-compose.sh setup-orderhub .
  - Para configurar un nuevo kit de herramientas de desarrollador completo que incluya también otros contenedores Order Management Software, como Sterling™ Business Center, ejecute el comando ./om-compose.sh setup.
  - Para actualizar un kit de herramientas de desarrollador completo existente para incluir también otros contenedores relacionados con Order Management Software, como Sterling Business Center, ejecute el mandato ./om-compose.sh setup-upg .
8. Para extraer el código fuente en la estación de trabajo local, ejecute el mandato siguiente. Utilice el código fuente para personalizar Order Hub.
```
./om-compose.sh extract-orderhub-code omoc
```
  El código fuente está disponible en la estación de trabajo local en devtoolkit_docker/orderhub-code.
  Nota: Si ha utilizado Windows Subsystem for Linux versión 2 (WSL 2) para instalar el kit de herramientas, los archivos también estarán disponibles en la estación de trabajo local. Por ejemplo, si ha ejecutado los mandatos en WSL en /mnt/c/devtoolkit_docker, los archivos también estarán disponibles en C:/devtoolkit_docker. Complete todas las personalizaciones en la estación de trabajo local, que se encuentra en C:/devtoolkit_docker.
Personalice Order Hub para que se ajuste a sus necesidades empresariales. Puede crear una aplicación a la que acceda a través de un nuevo elemento de menú, o puede personalizar las aplicaciones existentes proporcionadas por IBM.
Para obtener más información, consulte Creación de nuevas aplicaciones o Personalización de aplicaciones existentes.