Iniciación a la personalización de Order Hub

Editar en línea

Para poder personalizar Order Hub, debe obtener el código fuente Order Hub y decidir si desea crear nuevas aplicaciones o personalizar las aplicaciones existentes para que se ajusten a sus necesidades empresariales. Después de personalizar Order Hub, pruebe las personalizaciones para asegurarse de que funcionan según lo previsto en el entorno.

Nota: Este tema se aplica a Sterling Order Management System (SaaS). Para Sterling Order Management System (On Premises), consulte Requisitos previos para personalizar Order Hub (On Premises).

Acerca de esta tarea

En esta tarea, complete los siguientes pasos de alto nivel para personalizar Order Hub:

Obtenga el código fuente de Order Hub.
Personalice Order Hub para que se adapte a sus necesidades empresariales, ya sea creando nuevas aplicaciones o personalizando aplicaciones existentes.
Pruebe las personalizaciones para asegurarse de que funcionan según lo previsto en el entorno.

Procedimiento

Obtener el código fuente de Order Hub:

Instale Docker.
Docker se utiliza para instalar los componentes y dependencias necesarios para configurar solo el contenedor Order Hub . No desarrolla personalizaciones de Order Hub dentro del contenedor. Se desarrolla en la estación de trabajo local.
Instale Node.js Versión 16. Si se necesitan varias versiones de nodo, considere la posibilidad de utilizar nvm (para Mac o Linux) o nvm-windows (para Windows).
Instale Yarn.
Instale la CLI angular globalmente ejecutando el mandato siguiente en un terminal.
```
npm install -g @angular/cli@13.3.9
```
Configure el archivo hosts para correlacionar bucgenerichost con localhost. Necesita la correlación para permitir que Order Hub se conecte al entorno de desarrollo local.
Por ejemplo:
1. Abra el archivo hosts.
  - Windows 10: C:\Windows\System32\drivers\etc\hosts
  - Linux/Mac OS: sudo vim /etc/hosts
2. Añada bucgenerichost a localhost. Por ejemplo:
```
127.0.0.1 localhost bucgenerichost
```
Descargue y configure un entorno de kit de herramientas de desarrollador en la estación de trabajo local para obtener un rendimiento óptimo. Se recomienda no configurar el kit de herramientas dentro de otro contenedor Docker o en una máquina virtual. Los pasos siguientes resumen rápidamente cómo configurar el kit de herramientas para personalizar Order Hub. Para obtener una guía completa sobre cómo configurar un kit de herramientas de desarrollador, consulte Configuración de un entorno de kit de herramientas de desarrollador.
1. Descargue el kit de herramientas del desarrollador en la estación de trabajo local donde desea desarrollar personalizaciones para Order Hub.
  
  Sugerencia: Para Microsoft Windows, guarde el archivo devtoolkit_docker.tar en el directorio raíz de la unidad. Por ejemplo, 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 causan problemas.
2. Abra un terminal 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
```
  Como resultado, se crea una carpeta devtoolkit_docker en la estación de trabajo local.
4. Vaya al directorio devtoolkit_docker/compose .
5. Cree una copia del archivo devtoolkit_docker/compose/om-compose.properties.sample y dele el nombre om-compose.properties.
  Por ejemplo:
```
cp om-compose.properties.sample om-compose.properties
```
6. Asegúrese de que el archivo om-compose.properties incluye el valor siguiente.
```
ORDERHUB_MODE=omoc
```
  Para obtener una lista completa de propiedades, consulte Alteración temporal de las propiedades predeterminadas de Docker Compose.
7. Inicie Docker.
  Si ha instalado Docker Desktop, inicie Docker Desktop. Si ha instalado Docker Engine, inicie Docker a través de la línea de mandatos.
```
sudo service docker start
```
8. Ejecute el mandato siguiente para configurar el kit de herramientas del desarrollador.
  - Si sólo desea configurar Order Hub en el kit de herramientas del desarrollador, ejecute el mandato siguiente.
```
./om-compose.sh setup-orderhub
```
  - Si desea configurar el kit de herramientas de desarrollador completo para incluir también otros contenedores relacionados con Sterling Order Management(como Sterling Business Center), ejecute el mandato siguiente.
    - Para configurar un nuevo kit de herramientas:
      ./om-compose.sh setup
    - Para actualizar un kit de herramientas existente:
      ./om-compose.sh setup-upg
9. Ejecute el mandato siguiente para extraer el código fuente en la estación de trabajo local. Utilice el código fuente para personalizar Order Hub.
```
./om-compose.sh extract-orderhub-code <version>
```
  < version>: Los valores válidos son oms o omoc.
  - oms: Para la versión local de Order Hub
  - omoc: Para la versión de SaaS de Order Hub
  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 están disponibles en C:/devtoolkit_docker. Complete todas las personalizaciones en la estación de trabajo local (C:/devtoolkit_docker).

Personalizar Order Hub para que se adapte a sus necesidades empresariales:

Decida si desea crear una aplicación a la que pueda acceder a través de un nuevo elemento de menú dentro de Order Hubo personalizar las aplicaciones existentes proporcionadas por IBM.
Para obtener más información, consulte:
- Creación de nuevas aplicaciones
- Personalización de aplicaciones existentes
Opcional: Puede hacer referencia al libro de cuentos para ayudarle a crear componentes de interfaz de usuario.
Acceda al libro de cuentos en el siguiente URL.
```
https://localhost:8443
```
Nota: Si ha cambiado OH_EXT_HTTPS_PORT en el archivo om-compose.properties , actualice el puerto de 8443 al puerto que ha especificado.
El contenedor orderhub extension Docker debe estar en ejecución para acceder al libro de cuentos. Si el contenedor no se está ejecutando, vaya a devtoolkit_docker/compose y ejecute el mandato siguiente.
```
./om-compose.sh start orderhubext
```

Pruébelo:

Pruebe las personalizaciones para asegurarse de que funcionan según lo previsto en el entorno.
- Si ha creado una nueva aplicación o una nueva ruta, utilice el menú Valores > Personalización para añadir la aplicación al arrendatario de personalización para la prueba. Para obtener más información, consulte Prueba de nuevas aplicaciones o rutas en Order Hub.
- Si ha personalizado una aplicación existente, puede probar los cambios configurando Order Hub para conectarse a su entorno de kit de herramientas. Para obtener más información, consulte Prueba de personalizaciones de módulos existentes en Order Hub.