Exemple : Extraction de données marketing

Cet exemple explique comment extraire des données marketing depuis la base de données HCL Commerce, comme des activités, des emplacements e-Marketing, des segments de clientèle, un contenu et des pièces jointes. Il se sert de l'Utilitaire d'extraction de donnée afin d'extraire les données marketing pour un magasin spécifique. Ensuite, vous pouvez utiliser l'pour l'utilitaire de chargement de données pour charger les données extraites dans une autre instance ou un autre magasin HCL Commerce afin de copier rapidement des données marketing d'une instance ou d'un magasin à l'autre.

Avant de commencer

Vous devez exécuter les tâches suivantes :
  • Vérifiez que le magasin à partir duquel vous procédez à l'extraction de données inclut des données marketing. S'il n'existe pas de données pour un type spécifique d'objet marketing, le fichier de sortie généré pour le type d'objet ne comporte pas de données.

A propos de cet exemple

Lorsque vous exécutez cet exemple, l'Utilitaire d'extraction de donnée est configuré pour extraire les données marketing uniquement pour le magasin que vous spécifiez. Vous pouvez spécifier le magasin dans le fichier de configuration de l'environnement.

Les exemples de fichier de configuration qui sont utilisés pour configurer l'Utilitaire d'extraction de donnée se trouvent dans le répertoire et les sous-répertoires suivants :
  • Linuxutilities_root/samples/DataExtract/Marketing
  • HCL Commerce DeveloperWCDE_installdir\samples\DataExtract\Marketing

Lorsque vous exécutez cet exemple, les fichiers extraient les données pour tous les types d'objet marketing. Les données pour chaque type d'objet se trouvent dans des fichiers de sortie distincts. Par défaut, cet exemple extrait les données dans des fichiers au format CSV. Si vous voulez exporter les données dans des fichiers au format XML, vous pouvez éditer les exemples de fichier de configuration d'objet métier pour qu'ils utilisent un éditeur de données qui génère des fichiers de sortie XML.

Exemples de fichier de configuration

Les fichiers de configuration ci-après sont utilisés pour configurer l'Utilitaire d'extraction de donnée en vue de l'extraction de données dans des fichiers de sortie CSV.
wc-dataextract-env.xml
Fichier de configuration de l'environnement. Il inclut les variables d'environnement pour votre instance HCL Commerce. Ces variables incluent les informations suivantes :
  • Variables de contexte métier, notamment l'identificateur de magasin, l'identificateur de catalogue, ainsi que la langue et la devise par défaut pour votre magasin.
  • Paramètres d'environnement de base de données, notamment le type, le nom et le schéma de base de données.
wc-dataextract.xml
Fichier de configuration de l'ordre d'extraction des données. Il spécifie les chemins d'accès au fichier de configuration de l'environnement et aux fichiers de configuration d'objet métier pour chaque type d'objet. Il identifie également l'ordre dans lequel l'Utilitaire d'extraction de donnée extrait les données et identifie les fichiers de sortie que l'utilitaire génère afin d'inclure les données extraites.
wc-extract-business-object.xml
Fichier de configuration d'objet métier. Il définit la façon dont l'utilitaire identifie les données à extraire ainsi que le médiateur d'objet métier dont l'utilitaire doit se servir afin de transformer les données extraites. Dans cet exemple, un fichier de configuration distinct est fourni pour chaque type d'objet marketing. Tous les exemples de fichier de configuration d'objet métier configurent l'utilitaire en vue de l'utilisation du médiateur d'objet métier suivant :

com.ibm.commerce.foundation.dataload.businessobjectmediator.AssociationObjectMediator

  • Segments de clientèle
    wc-extract-customer-segment.xml
    Configure l'utilitaire en vue de l'extraction des segments de clientèle avec des informations de description pour une langue de magasin spécifique seulement. Vous pouvez spécifier cette langue dans le contexte métier du fichier de configuration de l'environnement. Ce fichier configure l'utilitaire en vue de l'extraction des données depuis les tables de base de données de groupes de membre (MBRGRP et MBRGRPDESC) car les segments de clientèle constituent un type de groupe de membres. L'utilitaire extrait des données uniquement pour les groupes de membres dont la valeur d'utilisation est -1, qui indique que le groupe est un segment de clientèle. Les données se trouvent dans le fichier de sortie MemberGroup.csv.
    wc-extract-customer-segment-description.xml
    Configure l'utilitaire en vue de l'extraction des informations de description des segments de clientèle dans toutes les langues prises en charge. Les données se trouvent dans le fichier de sortie MemberGroupDescription.csv.
    wc-extract-customer-segment-condition.xml
    Configure l'utilitaire en vue de l'extraction des conditions de segment de clientèle. Les données se trouvent dans le fichier de sortie MemberGroupCondition.csv.
    Remarque : Les caractères de retour à la ligne dans la chaîne XML de condition pour un objet se trouvant dans la base de données sont convertis en caractère espace dans le fichier de sortie CSV.
  • Pièces jointes
    wc-extract-attachment.xml
    Configure l'utilitaire en vue de l'extraction des pièces jointes avec des informations de description pour une langue de magasin spécifique seulement. Vous pouvez spécifier cette langue dans le contexte métier du fichier de configuration de l'environnement. Les données se trouvent dans le fichier de sortie Attachment.csv.
    wc-extract-attachment-description.xml
    Configure l'utilitaire en vue de l'extraction des informations de description des pièces jointes dans toutes les langues prises en charge. Les données se trouvent dans le fichier de sortie AttachmentDescription.csv.
    wc-extract-attachment-asset.xml
    Configure l'utilitaire en vue de l'extraction des ressources de pièce jointe. Les données se trouvent dans le fichier de sortie AttachmentAsset.csv.
    wc-extract-attachment-asset-language.xml
    Configure l'utilitaire en vue de l'extraction des relations des ressources de pièce jointe et des langues. Les données se trouvent dans le fichier de sortie AttachmentAssetLanguage.csv.
  • Contenu marketing
    wc-extract-marketing-content.xml
    Configure l'utilitaire en vue de l'extraction du contenu marketing avec des informations de description pour une langue de magasin spécifique seulement. Vous pouvez spécifier cette langue dans le contexte métier du fichier de configuration de l'environnement. Les données se trouvent dans le fichier de sortie MarketingContent.csv.
    wc-extract-marketing-content-description.xml
    Configure l'utilitaire en vue de l'extraction des informations de description du contenu marketing dans toutes les langues prises en charge. Les données se trouvent dans le fichier de sortie MarketingContentDescription.csv.
    wc-extract-marketing-content-attachment.xml
    Configure l'utilitaire en vue de l'extraction de la relation de contenu marketing et de pièce jointe avec des informations de description pour une langue de magasin spécifique seulement. Vous pouvez spécifier cette langue dans le contexte métier du fichier de configuration de l'environnement. Les données se trouvent dans le fichier de sortie MarketingContentAttachment.csv.
    wc-extract-marketing-content-attachment-description.xml
    Configure l'utilitaire en vue de l'extraction des informations de description de la relation de contenu marketing et de pièce jointe dans toutes les langues prises en charge. Les données se trouvent dans le fichier de sortie MarketingContentAttachmentDescription.csv.
    wc-extract-marketing-content-imagemap.xml
    Configure l'utilitaire en vue de l'extraction des mappes d'image de contenu marketing. Les données se trouvent dans le fichier de sortie MarketingContentImageMap.csv.
  • Emplacements e-marketing
    wc-extract-marketing-spot.xml
    Configure l'utilitaire en vue de l'extraction des emplacements e-Marketing. Les données se trouvent dans le fichier de sortie MarketingSpot.csv.
    wc-extract-marketing-spot-default-content.xml
    Configure l'utilitaire en vue de l'extraction des informations de contenu par défaut pour des emplacements e-Marketing. Les données se trouvent dans le fichier de sortie MarketingSpotDefaultContent.csv.
    wc-extract-marketing-spot-default-title.xml
    Configure l'utilitaire en vue de l'extraction des informations de titre par défaut pour des emplacements e-Marketing. Les données se trouvent dans le fichier de sortie MarketingSpotDefaultTitle.csv.
  • Activités
    wc-extract-marketing-activity.xml
    Configure l'utilitaire en vue de l'extraction des activités marketing de type Web, Dialogue et Courrier électronique, ainsi que des règles de recherche. Les données se trouvent dans le fichier de sortie MarketingActivity.csv.
    wc-extract-marketing-campaign.xml
    Configure l'utilitaire en vue de l'extraction des campagnes marketing. Les données se trouvent dans le fichier de sortie MarketingCampaign.csv.
    wc-extract-marketing-element.xml
    Extrait les éléments marketing pour des activités marketing. Les données se trouvent dans le fichier de sortie MarketingElement.csv.
    wc-extract-marketing-elementnvp.xml
    Extrait les paires nom-valeur d'élément marketing pour les activités marketing. Les données se trouvent dans le fichier de sortie MarketingElementNVP.csv.

Procédure

  1. Copiez les exemples de fichier de configuration et les répertoires dans un répertoire local.
  2. Editez votre copie des exemples de fichier de configuration de l'environnement afin de définir les variables de configuration pour votre environnement. Tous les exemples de fichier de configuration qui sont utilisés dans cet exemple incluent des valeurs pour un environnement HCL Commerce Developer par défaut qui utilise une base de données Apache Derby. Si vos paramètres d'environnement sont différents, vous devez changer les valeurs configurées dans ces fichiers pour qu'elles correspondent à votre environnement. Pour plus d'informations sur la mise à jour d'un fichier de configuration de l'environnement, voir Configuration et exécution de l'utilitaire d'extraction de données.
  3. HCL Commerce DeveloperDans une ligne de commande, accédez au répertoire WCDE_installdir\bin.
  4. LinuxOuvrez une ligne de commande dans le . Accédez au répertoire utilities_root/bin. Pour plus d'informations sur l'entrée et la sortie des conteneurs, voir Exécution des utilitaires à partir de Utility server Docker container.
  5. Entrez la commande suivante pour exécuter l'exemple de configuration de l'ordre d'extraction des données pour l'extraction des données marketing :
    • Linux./dataextract.sh ../samples/DataExtract/Marketing/wc-dataextract.xml
    • HCL Commerce Developerdataextract ..\samples\DataExtract\Marketing\wc-dataextract.xml
Une fois que l'utilitaire a terminé le processus d'extraction, il génère les fichiers de sortie dans le répertoire et les sous-répertoires de sortie configurés. Ces fichiers incluent des données pour tous les objets marketing qui existent pour le magasin configuré. Par défaut, les fichiers sont générés dans le répertoire et les sous-répertoires de sortie suivants :
  • Linuxutilities_root/samples/DataExtract/Marketing/output
  • HCL Commerce DeveloperWCDE_installdir\samples\DataExtract\Marketing\output

Vérification des résultats

  1. Accédez au répertoire que vous avez configuré comme répertoire de sortie. Si vous n'avez pas configuré de répertoire de sortie, accédez au répertoire suivant :
    • Linuxutilities_root/samples/DataExtract/Marketing/output
    • HCL Commerce DeveloperWCDE_installdir\samples\DataExtract\Marketing\output
  2. Vérifiez que les fichiers de sortie CSV suivants ont été générés :
    • CustomerSegment/MemberGroup.csv
    • CustomerSegment/MemberGroupDescription.csv
    • CustomerSegment/MemberGroupCondition.csv
    • Attachment/Attachment.csv
    • Attachment/AttachmentDescription.csv
    • Attachment/AttachmentAsset.csv
    • Attachment/AttachmentAssetLanguage.csv
    • MarketingContent/MarketingContent.csv
    • MarketingContent/MarketingContentDescription.csv
    • MarketingContent/MarketingContentAttachment.csv
    • MarketingContent/MarketingContentAttachmentDescription.csv
    • MarketingContent/MarketingContentImageMap.csv
    • MarketingSpot/MarketingSpot.csv
    • MarketingSpot/MarketingSpotDefaultContent.csv
    • MarketingSpot/MarketingSpotDefaultTitle.csv
    • MarketingActivity/MarketingCampaign.csv
    • MarketingActivity/MarketingActivity.csv
    • MarketingActivity/MarketingElement.csv
    • MarketingActivity/MarketingElementNVP.csv
  3. Ouvrez les fichiers de sortie afin d'examiner leur contenu.
  4. Vérifiez que le contenu des fichiers correspond aux données qui se trouvent dans la base de données pour les objets marketing appartenant au magasin spécifié. Pour plus d'informations sur les données pouvant être incluses dans ces fichiers, voir Définitions de fichier d'entrée pour les objets marketing.

Etapes suivantes

Vous pouvez charger les données que vous avez extraites dans une autre instance HCL Commerce avec l'pour l'utilitaire de chargement de données. Pour un exemple qui explique comment charger des données marketing, voir Exemple : Chargement de données marketing. Si vous suivez cet exemple, éditez le fichier de configuration de l'ordre de chargement afin de spécifier les fichiers de sortie qui ont été générés par l'Utilitaire d'extraction de donnée.