Personalización de las aplicaciones existentes

Puede empezar con cualquiera de las aplicaciones Order Hub existentes y, a continuación, personalizar los módulos dentro de la aplicación. Por ejemplo, puede personalizar la página de resultados de búsqueda de pedidos para recuperar más datos de la API de IBM Sterling® Order Management System y mostrar los datos en una tabla existente.

Personalizar un módulo existente

Asegúrese de que ha extraído el código Order Hub. Para obtener más información, consulte Empezar a personalizar la nueva generación de Order Hub
Abra un terminal y vaya al directorio de código Order Hub. Para los contenedores, la ubicación por defecto es devtoolkit_docker/orderhub-code.

Vaya al módulo que desea personalizar. Por ejemplo, si desea actualizar el módulo de pedidos, vaya a la carpeta buc-app-order:

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

Tabla 1. Mapeo entre Order Hub elemento de menú y nombre de carpeta en el toolkit
Menú en Order Hub	Nombre del módulo/carpeta	Puerto
Inicio Espacios de trabajo Alertas Configuración > Reglas de alerta	buc-app-workspace	8900
Nodos y capacidad	buc-app-node	8200
Pedidos Envíos	buc-app-order	8300
Inventario	buc-app-inventory	8600
Despacho de pedidos Compromiso y despacho	buc-app-fulfillment	9000
Excepciones	buc-app-exception	9100
Ajustes > Ajustes de pantalla Configuración > Funciones de usuario Configuración > Personalización Configuración > Acerca de Configuración > Grupos de distribución	buc-app-settings	8400
Configuraciones > Nodos Configuraciones > Portadores Configuraciones > Atributos personalizados Configuraciones > Inquilino	buc-app-configuraciones	9200
Seguridad > Usuarios	usuario-de-la-aplicación-buc	9600

Ejecute el siguiente comando para establecer strict-ssl en false.
```
yarn config set "strict-ssl" false
```
Si ha actualizado el entorno del kit de herramientas para desarrolladores con una nueva versión, ejecute el siguiente comando para asegurarse de que obtiene la última versión de todas las dependencias de código abierto y bibliotecas.
```
yarn cache clean
```
Ejecute el siguiente comando para instalar todas las dependencias del módulo.
```
yarn install --update-checksums
```
Si se encuentra con un error similar al siguiente mensaje, puede ignorarlo. Estos errores no afectan a los iconos que utiliza Order Hub.
```
Error: Failed to compile entry-point @carbon/icons-angular/
```
Abra el archivo overrides.json en la raíz del módulo/carpeta. Por ejemplo, devtoolkit_docker/buc-app-order/overrides.json.
Actualice las rutas de las páginas que está personalizando estableciendo runAsCustomization en true. Por ejemplo, si desea editar la página Búsqueda de pedidos, establezca búsqueda de pedidos en true.
```
    "order-search": {
      "runAsCustomization": true
    },
```
Inicie el servidor.
```
yarn start-app
```
Compilar e iniciar la aplicación puede llevar varios minutos.
Nota: Verá el siguiente mensaje.
```
"** Angular Live Development Server está escuchando en bucgenerichost:<port>, 
abra su navegador en https://localhost:<port>/<module>/<route> **"
```
Puede hacer caso omiso de este mensaje.
Nota: Si se encuentra con un error similar al siguiente mensaje, aumente el tamaño del montón antes de iniciar la nueva aplicación.
```
El comando de error falló con el código de existencia 134.
¡lerna ERR! Inicio del recorrido del hilo... salió 134
```
Ejecute el siguiente comando e inicie la nueva aplicación.
- Símbolo del sistema de 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: Si necesita detener el servidor, detenga el trabajo del servidor y ejecute el comando yarn stop-app para verificar que todo se ha detenido correctamente.

Nota: Inicie únicamente los servidores de los módulos que está personalizando. Siempre que personalice un módulo, deberá ejecutar yarn start-app en el directorio del módulo correspondiente para ver las páginas personalizadas dentro del módulo.
Ya está listo para personalizar.
Personalice las páginas existentes proporcionadas por IBM. Order Hub admite los siguientes niveles de personalización a la hora de añadir funcionalidad a las páginas existentes:
- Personalización por configuración
- Personalización por código
  - Personalización diferencial
  - Personalización mediante anulaciones
Para obtener más información, consulte Personalización de la nueva generación de Order Hub.
O bien, repasa los tutoriales:
- Tutorial: Personalización de la acción Programar pedido - Utiliza el enfoque de personalización diferencial y personalización por anulaciones.
- Tutorial: Personalización del flujo Crear pedido - Utiliza los enfoques de personalización por configuración y personalización por anulaciones.
- Tutorial: Personalización de la página de resultados de búsqueda de Inventario - Utiliza los enfoques de personalización por configuración y personalización por anulaciones.
Después de personalizar el módulo, puede probar las personalizaciones en Order Hub.