Définition des propriétés d'intégration dans Sterling Order Management

Vous pouvez utiliser ces informations pour définir des variables pour les services de communication.

Pourquoi et quand exécuter cette tâche

Pour configurer la communication entre le fichier HCL Commerce et Sterling Order Management, vous devez définir les propriétés du fichier Sterling Order Management customer_overrides.properties et exécuter le script setupfiles avant le déploiement. Pour utiliser l'utilitaire setupfiles, exécutez <INSTALL_DIR>\bin\setupfiles.cmd sur Windows ou <INSTALL_DIR>/bin/setupfiles.sh sur Linux/UNIX. Cet exemple de fichier customer_overrides.properties affiche toutes les propriétés et leurs valeurs, suivi d'un tableau qui décrit les services associés à ces propriétés.

Cette procédure suppose que vous souhaitez définir des variables de file d'attente pour les services liés à toutes les fonctions d'intégration (commande, stock, tarification, promotion). Pour plus d'informations sur la configuration d'une fabrique de connexion pour MQ, consultez le Centre de connaissances MQ V7.5. Vous pouvez créer des fabriques de connexion à l'aide de l'outil d'administration JMS.

Voici un exemple de fichier customer_overrides.properties :
yfs.scwc.sdf.integration.providerurl=corbaloc::<SC_host_where_MQ_QFC_and_JNDI_names_are_defined>:<WAS_bootstrap_port>
yfs.scwc.sdf.integration.apis.export.qcf=AGENT_QCF
yfs.scwc.sdf.integration.apis.import.qcf=AGENT_QCF
yfs.scwc.sdf.integration.apis.import.queue=inbounds

yfs.scwc.sdf.integration.apis.createorderonsuccess.event.queue=outbound
yfs.scwc.sdf.integration.apis.changeorderonsuccess.event.queue=outbound
yfs.scwc.sdf.integration.apis.changeorderoncancel.event.queue=outbound
yfs.scwc.sdf.integration.apis.confirmdraftorderonsuccess.event.queue=outbound
yfs.scwc.sdf.integration.apis.sendinventorychanges.event.queue=outbound

yfs.scwc.sdf.sendinventorychanges.service.url=http://WC_HOSTNAME:5080/webapp/wcs/component/inventory/services/InventoryServices
yfs.scwc.sdf.sendorderchanges.service.url=http://WC_HOSTNAME:5080/webapp/wcs/component/order/services/OrderServices
yfs.scwc.sdf.getOrderPrice.service.url=http://WC_HOSTNAME:5080/webapp/wcs/component/order/services/OrderServices
yfs.scwc.sdf.getItemPrice.service.url=http://WC_HOSTNAME:5080/webapp/wcs/component/price/services/PriceServices
yfs.scwc.sdf.validateCoupon.service.url=http://WC_HOSTNAME:5080/webapp/wcs/component/promotion/services/PromotionServices
yfs.scwc.sdf.getPricingRuleDetails.service.url=http://WC_HOSTNAME:5080/webapp/wcs/wcs/component/promotion/services/PromotionServices  
yfs.scwc.sdf.csv.dir=<csv directory>

yfs.scwc.sdf.wc.user=wc_username
yfs.scwc.sdf.wc.password=wc_password
yfs.scwc.value.mapping.file=/file_path/ValueMaps.xml
Notes :
  • Certaines propriétés relayent des données sensibles telles que les ID d'utilisateur et les mots de passe, que vous pouvez chiffrer. Autrement dit, vous pouvez chiffrer les fichiers de propriété yfs.scwc.sdf.wc.user=wc_username et yfs.scwc.sdf.wc.password=wc_password.
  • Pour pouvoir utiliser la fonctionnalité Pull Cart dans Commerce Call Center, vous devez configurer les propriétés suivantes de manière appropriée : 
    yfs.scwc.sdf.getOrder.service.url = http:<IP>:<Port>/webapp/wcs/component/order/services/OrderServices
yfs.scwc.sdf.processOrder.service.url = http:<IP>:<Port>/webapp/wcs/component/order/services/OrderServices
Voici les valeurs par défaut de ces propriétés Sterling Order Management, ainsi que leurs services associés.
Propriété Description Services associés à la propriété
yfs.scwc.sdf.integration.providerurl URL du fournisseur pour l'intégration. Utilisez le format corbaloc::<SC_host_where_MQ_QCF_and_JNDI_names_are_defined>:<WA_bootstrap_port> pour l'URL : Pour vous connecter à WebSphere MQ, vous devez ajouter des fabriques de connexion de file d'attente et des destinations de file d'attente dans HCL Commerce où Sterling Order Management est installé. Les rubriques suivantes expliquent comment configurer les fabriques de connexion de file d'attente WebSphere MQ et les destinations de file d'attente sur HCL Commerce ; vous pouvez vous référer à ces rubriques lors de la configuration des fabriques de connexion de file d'attente WebSphere MQ et des destinations de file d'attente pour Sterling Order Management :
  • Création de fabrique de connexions de file d'attente de messagerie WebSphere MQ
  • Création d'une file d'attente de fournisseur de messagerie WebSphere MQ
 Tous les services d'intégration
yfs.scwc.sdf.integration.apis.export.qcf Fabrique de connexions de file d'attente pour la file d'attente d'exportation. SCWC_SDF_createOrderOnSuccessSCWC_SDF_confirmDraftOrderOnSuccess**SCWC_SDF_changeOrderOnSuccess**SCWC_SDF_changeOrderOnCancel**SCWC_SDF_syncInventoryChangesSCWC_SDF_pushInventoryMessagesSCWC_SDF_pushOrderMessages
yfs.scwc.sdf.integration.apis.import.qcf Fabrique de connexions de file d'attente pour la file d'attente d'importation SCWC_SDF_createOrderSCWC_SDF_changeOrder**
yfs.scwc.sdf.integration.apis.import.queue File d'attente vers laquelle les messages de HCL Commerce à Sterling Order Management sont écrits. La file d'attente est utilisée pour la communication entre HCL Commerce et Sterling Order Management. HCL Commerce envoie le message processOrder dans la file d'attente et Sterling Order Management capte le message de la file d'attente. Le nom de la file d'attente est un alias créé sur le serveur WebSphere MQ. Vous pouvez modifier le nom de la file d'attente, par exemple pour smcfs.inbound. Sur HCL Commerce, la file d'attente est utilisée sous le titre JMSOutboundQueue. SCWC_SDF_createOrderSCWC_SDF_changeOrder**
yfs.scwc.sdf.integration.apis.createorderonsuccess.event.queue File d'attente dans laquelle les messages de création de commande réussis de Sterling Order Management à HCL Commerce sont écrits. La file d'attente est créée dans le serveur WebSphere MQ pour les communications internes Sterling Order Management entre les serveurs d'intégration et les agents. HCL Commerce n'a pas d'informations concernant cette file d'attente. SCWC_SDF_createOrderOnSuccess
yfs.scwc.sdf.integration.apis.changeorderonsuccess.event.queue File d'attente sur laquelle les messages de modification de commande réussis de Sterling Order Management à HCL Commerce sont écrits. La file d'attente est créée dans le serveur WebSphere MQ pour les communications internes Sterling Order Management entre les serveurs d'intégration et les agents. HCL Commerce n'a pas d'informations concernant cette file d'attente. SCWC_SDF_changeOrderOnSuccess**
yfs.scwc.sdf.integration.apis.changeorderoncancel.event.queue File d'attente à laquelle les messages d'annulation de commande de Sterling Order Management à HCL Commerce sont écrits. La file d'attente est créée dans le serveur WebSphere MQ pour les communications internes Sterling Order Management entre les serveurs d'intégration et les agents. HCL Commerce n'a pas d'informations concernant cette file d'attente. SCWC_SDF_changeOrderOnCancel **
yfs.scwc.sdf.integration.apis.confirmdraftorderonsuccess.event.queue File d'attente sur laquelle les messages de confirmation de brouillon de commande réussis de Sterling Order Management à HCL Commerce sont écrits. La file d'attente est créée dans le serveur WebSphere MQ pour les communications internes Sterling Order Management entre les serveurs d'intégration et les agents. HCL Commerce n'a pas d'informations concernant cette file d'attente. SCWC_SDF_confirmDraftOrderOnSuccess **
yfs.scwc.sdf.integration.apis.sendinventorychanges.event.queue File d'attente sur laquelle les messages de modification de stock Sterling Order Management à HCL Commerce sont écrits. La file d'attente est créée dans le serveur WebSphere MQ pour les communications internes Sterling Order Management entre les serveurs d'intégration et les agents. HCL Commerce n'a pas d'informations concernant cette file d'attente. SCWC_SDF_syncInventoryChanges
SCWC_SDF_pushInventoryMessages
yfs.scwc.sdf.sendinventorychanges.service.url URL de service invoquée par Sterling Order Management pour mettre à jour HCL Commerce sur les modifications de stock. SCWC_SDF_pushInventoryMessages
yfs.scwc.sdf.sendorderchanges.service.url URL de service invoquée par Sterling Order Management pour mettre à jour HCL Commerce sur les modifications de statut de la commande. SCWC_SDF_pushOrderMessages
yfs.scwc.sdf.getOrderPrice.service.url URL de service invoquée par Sterling Order Management pour obtenir des informations sur le prix de commande à partir de HCL Commerce. SCWC_SDF_getOrderPriceUE
yfs.scwc.sdf.getItemPrice.service.url URL de service invoquée par Sterling Order Management pour obtenir des informations sur le prix de l'article à partir de HCL Commerce. SCWC_SDF_getItemPriceUE
yfs.scwc.sdf.validateCoupon.service.url URL de service invoquée par Sterling Order Management pour valider les informations de bons de réduction dans HCL Commerce. SCWC_SDF_validateCouponUE
yfs.scwc.sdf.getPricingRuleDetails.service.url URL de service invoquée par Sterling Order Management pour obtenir les détails de la promotion à partir de HCL Commerce. SCWC_SDF_getPricingRuleDetailsUE**
yfs.scwc.sdf.csv.dir Le répertoire dans lequel le fichier InventoryAvailability.csv doit être créé. Si vous créez ce répertoire, assurez-vous que Sterling Order Management a lu et écrit l'autorisation. SCWC_SDF_syncInventoryChangesCSV**
yfs.scwc.sdf.wc.user Nom d'utilisateur de l'utilisateur d'intégration HCL Commerce.

De préférence, l'utilisateur d'intégration doit être un utilisateur HCL Commerce avec le rôle d'administrateur de site. Si un autre utilisateur d'intégration est spécifié, l'utilisateur doit avoir son organisation définie en tant qu'organisation racine et son jeu de rôles en tant qu'administrateur de site.

 Utilisé pour les appels synchrones sortants à partir de Sterling Order Management à HCL Commerce.
yfs.scwc.sdf.wc.password Mot de passe de l'utilisateur d'intégration HCL Commerce. Utilisé pour les appels synchrones sortants à partir de Sterling Order Management à HCL Commerce.
yfs.authonlyservlet.validate.authentication Définissez cette propriété pour sécuriser l'accès à authorizationOnlyApiServlet. La valeur par défaut est true. Si la SSL bidirectionnel n'est pas activé, définissez cette propriété sur false.
yfs.soapservlet.validate.authentication Définissez cette propriété pour sécuriser l'accès au servlet SOAP. La valeur par défaut est true. Si le SSL bidirectionnel n'est pas activé, définissez cette propriété sur false.
yfs.scwc.value.mapping.file Le chemin absolu vers ValueMaps.xml doit être spécifié. S'il n'est pas spécifié, Sterling Order Management regarde dans le dossier <INSTALL_DIR>/properties.
Important : Ce chemin d'accès à ValueMaps.xml doit être accessible à partir du serveur d'applications.
Pour plus d'informations sur le fichier ValueMaps.xml, voir Définition et déploiement du fichier ValueMaps.xml
yfs.scwc.action.properties.file Le chemin relatif (/action.properties) est attendu dans le format suivant : scwc.action.properties.file=/<action_property_file_name>.properties. S'il n'est pas spécifié, Sterling Order Management regarde dans le dossier <INSTALL_DIR>/properties.
yfs.scwc.server.connection.timeout Contrôle les délais d'expiration des connexions pour les appels SOAP de Sterling Order Management vers HCL Commerce . La valeur par défaut est 10 000 millisecondes. Tous les services d'intégration
yfs.scwc.server.read.timeout Contrôle les délais d'expiration de lecture pour les appels SOAP de Sterling Order Management à HCL Commerce. La valeur par défaut est de 15000 millisecondes. Tous les services d'intégration
yfs.scwc.sdf.getOrder.service.url URL du service invoqué par Sterling Order Management pour obtenir les détails d'une commande de HCL Commerce. Service SCWC_SDF_GetCartDetails
yfs.scwc.sdf.processOrder.service.url URL du service invoqué par Sterling Order Management pour mettre à jour HCL Commerce avec les modifications de statut de commande. 
SCWC_SDF_LockWCShoppingCart Service
SCWC_SDF_UnLockWCShoppingCart Service

Procédure

  1. Définissez les propriétés dans l'exemple de fichier <INSTALL_DIR>/properties/customer_overrides.properties comme indiqué ci-dessus.
  2. Pour spécifier différentes propriétés pour chaque processus que vous exécutez, ajoutez -DVendorFile au script de démarrage et définissez-le sur <path to your custom servers.properties file>. Vous devez avoir des fichiers servers.properties et customer_overrides.properties différents pour chaque processus que vous exécutez. Dans le fichier servers.properties, modifiez l'entrée pour customer_overrides.properties pour pointer vers votre nouveau fichier customer_overrides.properties. Effectuez les opérations suivantes en fonction de du chemin de fichiers -DVendorFile :
    • Si la valeur est un chemin d'accès complet, le fichier customer_overrides.properties est en dehors de l'EAR.
      1. Redémarrez le serveur d'applications.
    • Si la valeur est un chemin d'accès relatif, le fichier customer_overrides.properties se trouve à l'intérieur de l'EAR.
      1. Créez le fichier resources.jar en exécutant :
        • <INSTALL_DIR>/bin/deployer.sh -t resourcejar
        • Windows<INSTALL_DIR>/bin/deployer.cmd -t resourcejar
      2. Recréez le fichier EAR. Ce fichier est le package EAR Sterling Order Management. Pour plus d'informations sur la création et le déploiement du fichier EAR, reportez-vous à Création et déploiement du fichier EAR sur le serveur.