Mise à jour du fichier de configuration de gestion des versions de contenu

Le fichier de configuration de gestion des versions de contenu définit la configuration des objets d'interface utilisateur dont les versions peuvent être gérées. Pour modifier la configuration par défaut des objets versionnables, vous devez étendre le fichier de configuration en créant un fichier dans le dossier ext.

Le fichier de configuration étendu (wc-content-version.xml) doit être placé dans le répertoire suivant :
  • workspace_dir\WC\xml\config\com.ibm.commerce.servicemodule-ext\; où com.ibm.commerce.servicemodule-ext contient tous les fichiers étendus pour un module de service particulier.
Remarque : Ce fichier ne doit contenir que les modifications personnalisées.

Avant de commencer

  • Consultez la rubrique Fichier de configuration de gestion des versions de contenu (wc-content-version.xml) pour prendre connaissance du fichier de configuration de gestion des versions de contenu.
  • Ouvrez le fichier wc-content-version.xml dans le répertoire workspace_dir\WC\xml\config\com.ibm.commerce.servicemodule ou le répertoire workspace_dir\WC\xml\config\com.ibm.commerce.servicemodule-fep à des fins de référence. Ce fichier ne doit pas être modifié. Vous allez copier certains éléments XML de ce fichier dans votre fichier de configuration étendu, mais ne copiez que les lignes requises.
  • Assurez-vous que les tables personnalisées à versionner existent dans le schéma de base.

Procédure

  1. Ouvrez HCL Commerce Developer et basculez vers la vue Explorateur d'entreprise.
  2. Créez le dossier ext de votre fichier de configuration étendu s'il n'existe pas.
    1. Dans la vue Explorateur d'entreprise, développez WC > xml > config.
    2. Cliquez à l'aide du bouton droit de la souris sur le dossier config, puis cliquez sur Nouveau > Dossier.
    3. Dans la zone Nom, saisissez com.ibm.commerce.servicemodule-ext ;
      où com.ibm.commerce.servicemodule-ext contient tous les fichiers étendus pour un module de service particulier.
    4. Cliquez sur Terminer.
  3. Dans le dossier ext, créez le fichier de configuration étendu.
    1. Cliquez à l'aide du bouton droit de la souris sur le dossier com.ibm.commerce.servicemodule-ext, puis cliquez sur Nouveau > Fichier
    2. Dans la zone Nom, saisissez wc-content-version.xml.
  4. Ajoutez le fragment de code suivant dans le fichier de configuration personnalisé : 
    <?xml version="1.0" encoding="UTF-8"?>
<wc:ContentVersionConfiguration xmlns:wc="http://www.ibm.com/xmlns/prod/WebSphereCommerce"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/WebSphereCommerce ../../content-version/xsd/wc-content-version.xsd">
    Tous les fichiers de configuration commencent par le fragment de code précédent.
  5. Identifiez l'élément wc:ContentVersionContainer d'ouverture dans le fichier de configuration d'origine.
    Copiez cette balise dans votre fichier de configuration étendu. Par exemple, <wc:ContentVersionContainer name="com.ibm.commerce.catalog" id="-1">.
  6. Identifiez l'élément wc:ContentVersionNoun à étendre dans le fichier de configuration d'origine.
    Copiez la balise wc:ContentVersionNoun dans votre fichier de configuration étendu. Vous ne devez pas modifier les attributs topTableet les attributs className.

    Par exemple, <wc:ContentVersionNoun name="CatalogEntry" topTable="CATENTRY" className="com.ibm.commerce.catalog.version.CatalogEntryContentVersionServiceImpl">.

  7. Copiez l'élément wc:ConfigGroup et remplacez la valeur de l'attribut id par un nombre positif.

    Par exemple : <wc:ConfigGroup id="1">

    Remarque : Les valeurs d'attribut id négatives sont réservées pour IBM.
  8. Identifiez les objets d'interface utilisateur à étendre dans le fichier de configuration d'origine. Copiez toutes les balises d'objet d'interface utilisateur enfant (wc:ContentVersionUIObject) dans votre fichier de configuration étendu.

    Par exemple : <wc:ContentVersionUIObject name="Product" />

  9. Si vous souhaitez remplacer la configuration wc:ContentVersionRelatedTable existante, copiez la balise et modifiez-la si nécessaire. Assurez-vous que la valeur d'attribut name reste identique.
    Si vous modifiez la valeur de l'attribut whereClause, le système utilise cette entrée au lieu de l'entrée dans le fichier de configuration d'origine.
    Remarque : Ne copiez que les balises wc:ContentVersionRelatedTable à modifier. Le système fusionne automatiquement le contenu des deux fichiers de configuration.
  10. Si vous souhaitez ajouter une nouvelle table à inclure lors de la gestion des versions, créez un élément wc:ContentVersionRelatedTable pour cette dernière.
    Veillez à bien fournir les attributs suivants :
    nom
    Nom de la table à stocker lors de la gestion des versions.
    whereClause
    Cet attribut est utilisé dans l'instruction SELECT. Spécifie les lignes de la table à inclure lors de la création d'une version.
    valeurs
    Spécifiez des valeurs CSV qui correspondent aux points d'interrogation dans la valeur d'attribut whereClause.
    keyColumns
    Spécifiez cet attribut pour identifier les colonnes de la table à utiliser comme clé si la table ne possède pas de clé principale.
    enabled
    La valeur true indique que cette entrée est transmise par l'analyseur de configuration. La valeur false indique que cette entrée est ignorée.
  11. Fermez l'élément wc:ConfigGroup avec une balise </wc:ConfigGroup>.
  12. Fermez l'élément wc:ContentVersionNoun avec une balise </wc:ContentVersionNoun>.
  13. Fermez l'élément wc:ContentVersionContainer avec une balise </wc:ContentVersionContainer>.
  14. Fermez l'élément avec une balise </wc:ContentVersionConfiguration>.
    Le fragment de code suivant illustre un fichier de configuration étendu qui configure la gestion des versions des tables personnalisées supplémentaires (WARRANTY et XCAREINSTRUCTION) du nom CatalogEntry. 
    <?xml version="1.0" encoding="UTF-8"?>
<wc:ContentVersionConfiguration xmlns:wc="http://www.ibm.com/xmlns/prod/WebSphereCommerce" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/WebSphereCommerce ../../content-version/xsd/wc-content-version.xsd">
	<wc:ContentVersionContainer name="com.ibm.commerce.catalog" id="-1">
		<wc:ContentVersionNoun name="CatalogEntry" topTable="CATENTRY" className="com.ibm.commerce.catalog.version.CatalogEntryContentVersionServiceImpl">
			<wc:ConfigGroup id="-1">
   				<wc:ContentVersionUIObject name="Product" />
				<wc:ContentVersionRelatedTable name=" XWARRANTY" whereClause="CATENTRY_ID=?" values="${objectId}"/>
   				<wc:ContentVersionRelatedTable name=" XCAREINSTRUCTION" whereClause="CATENTRY_ID=?" values="${objectId}"/>
			</wc:ConfigGroup>
		</wc:ContentVersionNoun>
	</wc:ContentVersionContainer>
</wc:ContentVersionConfiguration>
  15. Sauvegardez et fermez le fichier de configuration étendu.