Actualizar los archivos de configuración y componentes para trabajar con Sterling Order Management

Para finalizar la configuración de la integración, actualice los archivos de configuración y los componentes para habilitar las características opcionales. A continuación, despliegue los cambios para la producción.

Procedimiento

Actualice el archivo de configuración de componente de pedido para que contenga los valores de integración en paralelo necesarios.
1. Abra HCL Commerce Developer y cambie a la vista Explorador de empresa.
2. Cree una carpeta para su archivo de configuración de componentes de pedidos personalizados.
  
  workspace_dir\WC\xml\config\com.ibm.commerce.order-ext
  
  Si esta carpeta existe y contiene una versión personalizada del archivo wc-admin-component.xml o si existe una versión personalizada en otra parte, abra la versión personalizada y vaya al paso siguiente. Si la carpeta no existe o contiene una versión personalizada, realice estos subpasos:
  1. Copie el archivo workspace_dir\WC\xml\config\com.ibm.commerce.order\wc-admin-component.xml en workspace_dir\WC\xml\config\com.ibm.commerce.order-ext\.
  2. Abra el wc-admin-component.xml copiado en un editor. Esta copia se convierte en la versión personalizada del archivo wc-admin-component.xml.
3. Cambie las propiedades.
  Para cambiar las propiedades que no están actualmente en el archivo personalizado, cópielas en el archivo personalizado del archivo de configuración del componente de pedidos predeterminados.
  1. Actualice las propiedades copyFrom, copyTo y loggingDir para especificar los directorios que ha creado en la primera tarea:
     <_config:configgrouping name="DOMInventoryAutoLoad"> <_config:property name="copyFrom" value="/data/SCWC/CSV_DIR/copyFrom"/> <_config:property name="copyTo" value="/data/SCWC/CSV_DIR/copied"/> <_config:property name="loggingDir" value="/data/SCWC/CSV_DIR/logs"/> </_config:configgrouping>
  2. Actualice los valores SideBySideIntegration y enableP2P tal como se muestra en el fragmento de código siguiente para habilitar las características:
    <_config:configgrouping name="SideBySideIntegration"> <_config:property name="enable" value="Y"/> </_config:configgrouping> <_config:configgrouping name="P2PIntegration"> <_config:property name="enableP2P" value="true"/> </_config:configgrouping>
  3. Actualice cualquier otro valor en el archivo wc-admin-component.xml para cualquier otra característica que necesite:
    
    OMSHeartbeatInterval
    
    Valor predeterminado = 5 minutos
    Establece el intervalo de tiempo para que HCL Commerce compruebe si hay una interrupción de OMS.
    
    OrderPendingOnTransferExpirationTime
    
    Establece el tiempo de caducidad para los pedidos en estado F. El valor predeterminado es un día o 86 400 segundos. El planificador de retransferencia de pedido vuelve a transferir un pedido que permanece en estado F durante un periodo superior a su valor de caducidad.
    
    IsSystemOutageTolerable
    
    Valor predeterminado = Sí
    Habilita la característica de interrupción de OMS.
    
    IsRespectFallbackForInsuffQuant
    
    Valor predeterminado = Sí
    Controla cómo se maneja y se notifica el estado del inventario. Puede configurar los mensajes de inventario para mostrar al cliente mensajes de estado como, por ejemplo, que no hay existencias cuando el artículo está agotado.
    Un valor N significa que el artículo está disponible, pero no es suficiente para satisfacer la solicitud, por lo que el estado del inventario del artículo es de agotado.
    Un valor Y significa que, en caso de que no haya suficientes existencias, el sistema utiliza el estado de inventario de reserva como estado de inventario de artículo del pedido.
    
    InventoryStatusForZeroQuantityInCache
    
    Valor predeterminado = disponible
    Esta propiedad se utiliza para visualizar el producto. Indica el estado de inventario que desea ver cuando el inventario es cero. Cuando el valor = disponible, significa que el inventario se trata como disponible si el inventario es cero.
    
    AllowPartialReservation
    
    Valor predeterminado = no
    Indica si se permite el soporte para la reserva parcial. Un valor N significa no permitido e Y significa permitido.
    
    accessProfile
    
    Valor predeterminado = IBM_TransferOrder
    Este perfil de acceso se utiliza durante la transferencia de pedidos a Sterling Order Management.
    
    accessProfile
    
    Valor predeterminado = IBM_Summary
    Este perfil de acceso se utiliza durante un pedido de modificación.
    
    enableP2P
    
    Valor predeterminado = false
    Si esta propiedad se establece en True, permite una integración directa o "punto a punto".
  Para obtener más información, consulte Cambio de propiedades en el archivo de configuración del componente de pedido (wc-admin-component.xml).
4. Elimine todas las propiedades que no están establecidas de forma distinta del archivo de configuración de componente de pedido predeterminado. El archivo personalizado solo debe contener las diferencias.
5. Guarde y cierre el archivo personalizado.
Opcional: Para habilitar la integración de pago:

Para convertir números de cuenta a tokens, debe configurar el perfil de acceso IBM_TransferOrder para llamar a TokenizeAccountNumberCmd. El ComposeTransferOrderCmdImpl llama a este mandato de tarea, una implementación de la tarea ComposeOrderCmd para el flujo de integración de pedidos de transferencia. Esto convierte en token el PAN al componer la información relacionada con el pago de un nombre Order para la transferencia de pedido. HCL Commerce da soporte de forma predeterminada a una implementación ficticia llamada TokenizeAccountNumberCmdImpl. Puede personalizar este flujo para ajustarlo a las necesidades de su empresa.
1. Implemente la clase y aplique el parche en el archivo WebSphereCommerceServerExtensionsLogic.jar y, a continuación, despliegue el archivo con parches. Por ejemplo: WebSphereCommerceServerExtensionsLogic.jar\com\ibm\commerce\sample\order\facade\server\commands\SampleTokenizeAccountNumberCmdImpl.class
2. Añada una entrada en la tabla CMDREG. Por ejemplo, si el nombre de la clase implementada es com.ibm.commerce.sample.order.facade.server.commands.SampleTokenizeAccountNumberCmdImpl, puede utilizar una sentencia SQL similar a la siguiente:
```
INSERT INTO CMDREG(STOREENT_ID, INTERFACENAME, CLASSNAME, TARGET) VALUES (
0,'com.ibm.commerce.order.facade.server.commands.TokenizeAccountNumberCmd', '
com.ibm.commerce.sample.order.facade.server.commands.SampleTokenizeAccountNumberCmdImpl','Local'); 
```
Habilite acciones asíncronas para pedidos.
1. Editae los archivos wc-component-client.xml y despliegue WC_eardir/xml/config/com.ibm.commerce.order.external/wc-component-client.xml.
2. Copie el wc-component-client.xml en una carpeta temporal, edite y establezca el asíncrono en "true", tal como se muestra en el siguiente ejemplo de código: <_config:action name="ProcessOrder" asynchronous="true"></_config:action>
3. Añada el siguiente contenido de <_config:Invocationservice> debajo de <_config:action name="ProcessOrder" asynchronous="true"></_config:action> para enlazar la acción para el mensaje GetOrder: <_config:action name="GetOrder" asynchronous="false" scope="action"></_config:action>
Copie los archivos JAR.
1. Copie el siguiente archivo de Sterling JAR en su servidor de HCL Commerce y, a continuación, despliegue los JAR copiados en WC_eardir/lib: <INSTALL_DIR>/xapiclient/xapiclient.jar.
Opcional: Configurar WebSphere Application Server para utilizarlo con WebSphere MQ.

Para configurar WebSphere Application Server para utilizarlo con IBM MQ, determine el número máximo de conexiones gestionadas para el conector JCA-JMS, cree una fábrica de conexiones de cola de proveedor de mensajería de IBM MQ, cree destinos de cola de proveedor de mensajería de IBM MQ y configure propiedades avanzadas para JMSQueueConnectionFactory y JMSOutboundQueue.

Opcional: Cree mensajería de IBM MQ.

Realice estos pasos para crear la colas JMS necesarias para la escucha de HCL Commerce para IBM MQ.

Las colas JMS se correlacionan con las colas de mensajes de IBM MQ que creó o identificó en Configuración de IBM MQ para su uso con HCL Commerce. La tabla 1 muestra cómo las colas JMS se correlacionan con las colas de mensajes de IBM MQ.

Tabla 1. Colas de JMS y colas de mensajes de IBM MQ
Colas JMS	Colas de mensajes de IBM MQ
JMSSerialInboundQueue	de entrada
JMSParallelInboundQueue	inboundp
JMSInboundQueue	de entrada
JMSOutboundQueue	de salida
JMSErrorQueue	error

Una cola JMS se crea al crear un destino de colas de proveedor de mensajería de IBM MQ en WebSphere Application Server.

Los nombres de colas JMS proporcionados en la tabla son los nombres predeterminados que utiliza HCL Commerce. Si modifica los nombres de colas JMS, debe hacerlo de manera que coincidan con los nuevos nombres de colas.

Si utiliza nombres de cola JMS personalizados o nombres de fábrica de conexiones de colas JMS editando el archivo de configuración de HCL Commerce, los nombres de colas JMS deben añadirse aquí para que se correspondan con los nuevos nombres de colas de IBM MQ.

Nota: El número de colas que se debe definir dependerá de la aplicación con la que está integrado HCL Commerce. Estas cinco colas son el número mínimo de colas necesarias para la integración. Los nombres de colas son sensibles a las mayúsculas y minúsculas. Asegúrese de escribir los nombres de las colas correctamente, respetando las mayúsculas y minúsculas.

Despliegue todos los cambios de archivo para la producción. Para obtener más información, consulte Empaquetado del código personalizado para el despliegue.