Utilisation du fichier de configuration de composant d'abonnement

Pour modifier des propriétés dans le fichier de configuration du composant des abonnements (SubscriptionConfigurationImpl.xml), vous devez créer une version personnalisée de ce fichier dans un nouveau dossier. La version personnalisée du fichier ne doit contenir que les propriétés modifiées. Vous pouvez modifier le fichier de configuration du composant des abonnements pour renommer les attributs que vous souhaitez utiliser avec les abonnements ou ajuster le délai d'annulation autorisé.

Avant de commencer

Le composant des abonnements prend en charge la configuration des paramètres suivants dans la configuration :

La configuration est lue au chargement initial du composant des abonnements. Une fois le composant chargé, à moins que la configuration ne doive être rechargée, la configuration du composant n'est pas modifiée tant que le serveur n'est pas redémarré. La configuration du composant d'abonnement utilise l'extension de configuration du composant fourni par la base. La configuration est définie dans le fichier com.ibm.commerce.subscription.facade.server.config.SubscriptionConfigurationImpl.xml qui se trouve dans le dossier com.ibm.commerce.subscription.

Procédure

Ouvrez HCL Commerce Developer et basculez vers la vue Explorateur d'entreprise.
Créez un dossier pour votre fichier de configuration personnalisé du composant des abonnements :
1. Accédez au chemin suivant :
  
  workspace_dir\WC\xml\config\
2. Sous le dossier config, ajoutez un nouveau dossier com.ibm.commerce.subscription-ext de sorte que son chemin d'accès soit similaire à ceci :
  workspace_dir\WC\xml\config\com.ibm.commerce.subscription-ext\.
  Si ce dossier existe déjà et qu'il contient une version personnalisée du fichier SubscriptionConfigurationImpl.xml, ouvrez ce fichier et passez à l'étape 7.
Accédez au chemin suivant :
workspace_dir\WC\xml\config\com.ibm.commerce.subscription\
Copiez le fichier SubscriptionConfigurationImpl.xml dans le nouveau dossier com.ibm.commerce.subscription-ext que vous avez créé lors de la première étape.
Ouvrez le fichier SubscriptionConfigurationImpl.xml copié dans un éditeur. Cette copie devient la version personnalisée du fichier SubscriptionConfigurationImpl.xml.

Localisez le code suivant :

<_subscr:SubscriptionComponentConfiguration
xmlns:_subscr="http://www.ibm.com/xmlns/prod/commerce/subscription/config"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/subscription/config xsd/SubscriptionConfiguration.xsd ">

Pour éviter les erreurs de validation, remplacez-le par :

<_subscr:SubscriptionComponentConfiguration
xmlns:_subscr="http://www.ibm.com/xmlns/prod/commerce/subscription/config"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/subscription/config ../com.ibm.commerce.subscription/xsd/SubscriptionConfiguration.xsd ">

Modifiez les propriétés ci-après en fonction des besoins de votre site.

Nom de l'attribut de fréquence d'exécution des commandes
Nom de l'attribut de fréquence des paiements.
Nom de l'attribut de période ou de durée.
Intervalle de récupération des travaux du planificateur (quantité de lecture anticipée en termes de temps utilisé par le planificateur une fois que ce dernier est actif)
Configuration d'une période de notification pour les actions d'annulation et les autres actions que nous risquons de développer.
Nombre maximal de tentatives d'une action planifiée d'abonnement.

Le fichier de configuration se présente comme suit :

<_subscr:SubscriptionComponentConfiguration
xmlns:_subscr="http://www.ibm.com/xmlns/prod/commerce/subscription/config"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/subscription/config ../com.ibm.commerce.subscription/xsd/SubscriptionConfiguration.xsd ">	<_subscr:subscription-catalogEntry-configuration time-period-attribute-name="timePeriod"
	fulfillment-frequency-attribute-name="fulfillmentFrequency"
	payment-frequency-attribute-name="paymentFrequency"/>
	<_subscr:subscription-child-order-configuration RecalculateChildOrderForRecurringOrder="true"/>	
	<_subscr:notice-period-configuration>
		<_subscr:notice-period actionName="Cancel"
			duration="12" uom="Hours" />		
	</_subscr:notice-period-configuration>
	<_subscr:scheduled-action-retry-configuration>
		<_subscr:scheduled-action scheduledActioName="CreateChildOrder" maxRetries="2"/>
		<_subscr:scheduled-action scheduledActioName="Cancel" maxRetries="2"/>
		<_subscr:scheduled-action scheduledActioName="Expire" maxRetries="2"/>
	</_subscr:scheduled-action-retry-configuration>
</_subscr:SubscriptionComponentConfiguration>

Remarque : Pour ajouter la configuration de l'intervalle d'anticipation au fichier personnalisé, ajoutez : <_subscr:scheduler-lookup-interval>600</_subscr:scheduler-lookup-interval> dans l'élément <_subscr:SubscriptionComponentConfiguration>.

Dans l'élément <_subscr:SubscriptionComponentConfiguration>, supprimez toutes les propriétés non modifiées de sorte que seules les propriétés modifiées demeurent dans le fichier personnalisé.
Enregistrez le fichier personnalisé et fermez-le.

Que faire ensuite

Les attributs du dictionnaire d'attributs utilisés pour spécifier les attributs d'abonnement, tels que fulfillmentFrequency, timePeriod et paymentFrequency, dans Management Center doivent correspondre aux noms définis dans le fichier de configuration du composant des abonnements.