Exemple : Suppression de caractéristiques de stock prévu

Vous pouvez supprimer des caractéristiques de stock prévu à l'aide de l'utilitaire de chargement de données. Cet exemple utilise un fichier CSV pour expliquer comment supprimer des caractéristiques de stock prévu.

Cet exemple utilise un fichier CSV pour expliquer comment insérer, remplacer ou supprimer vos données. Vous pouvez aussi créer et utiliser un fichier au format XML pour insérer, remplacer ou supprimer vos données. Si vous choisissez de créer et d'utiliser un fichier au format XML, assurez-vous que vos éléments XML utilisent les mêmes noms que ceux des colonnes CSV.

Vous pouvez utiliser l'utilitaire de chargement de données pour supprimer des données de la table RADETAIL.

Fichier CSV avec exemples de données

Dans cet exemple, les données source proviennent d'un fichier CSV nommé radetail_delete.csv. Le fichier contient des exemples de données avec les colonnes minimales nécessaires pour le mode de chargement de données "delete" (suppression).

Fichier CSV avec exemples de données

VendorName RACreateTime PartNumber ExpectedDate CatEntryStoreIdentifier
MyCompany 2005-07-12 01:01:01.123456 FULO-0101 2005-12-08 00:00:00.0 10701
AdvancedB2BDirect Vendor 2008-05-15 04:04:04.0 FULO-0201 2008-12-24 00:00:00.0
AdvancedB2BDirect Vendor 2009-05-21 00:00:00.0 FULO-0301 2009-12-31 00:00:00.0
Remarque : Si la propriété "markForDelete" a pour valeur true dans le fichier de configuration d'objet métier, l'enregistrement RADETAIL n'est pas supprimé de la base de données ; à la place, la valeur de MARKFORDELETE de l'enregistrement est mise à jour avec la valeur "1". False est automatiquement attribué à toute valeur autre que true.

définitions de colonne CSV et d'élément XML

VendorName
(Obligatoire, Chaîne) Fournisseur d'où provient le stock. Cette zone est utilisée pour la résolution de RA_ID. Elle est obligatoire et ne peut pas avoir la valeur null.
RACreateTime
(Obligatoire, Horodatage) Date et heure de création de l'enregistrement de stock prévu correspondant. Le format de l'entrée est yyyy-mm-dd hh:mm:ss.SSSSSS. La longueur de fraction de seconde ne doit pas être supérieure à 6. Vous pouvez personnaliser le format en définissant la propriété timestampPattern dans le fichier wc-dataload.xml. Cette zone est utilisée pour la résolution de RA_ID. Elle est obligatoire et ne peut pas avoir la valeur null.
PartNumber
(Obligatoire, Chaîne) Numéro de référence de cet article. Identifie de manière unique un article d'un propriétaire spécifique. Combiné à l'identificateur de propriétaire, il est utilisé pour extraire la clé primaire de la table ITEMSPC, par exemple ITEMSPC_ID. Cette zone est obligatoire et ne peut pas être Null si la zone CatalogEntryUniqueId n'est pas spécifiée dans le fichier CSV.
ExpectedDate
(Obligatoire, Horodatage) Date de réception prévue de ce stock. Son format est identique à celui spécifié dans la zone RACreateTime.
CatEntryStoreIdentifier
(Chaîne) Cette zone est utilisée dans un magasin de site étendu. Si l'élément CatalogEntry est défini dans un magasin de ressources d'entrées de catalogue, cette zone correspond à l'identificateur de ce magasin. Cet identificateur est utilisé pour extraire le paramètre entryOwner du catalogue.
HCL Commerce EnterpriseCette zone est obligatoire si vous utilisez un magasin de site étendu.

Les autres zones facultatives non incluses dans l'exemple sont les suivantes :

StoreIdentifier
(Chaîne) Identificateur du magasin auquel l'article appartient. Cette colonne peut être ajoutée au fichier CSV si l'article appartient à un magasin différent du magasin qui est défini dans les éléments BusinessContext du fichier wc-dataload-env.xml. Si cette colonne n'est pas fournie dans le fichier CSV, l'élément StoreIdentifier du contexte métier est utilisé.
FulfillmentCenterId
(Entier) Identificateur du centre de distribution auquel appartient cet article. Cette colonne peut être ajoutée au fichier CSV si l'article appartient à un centre de distribution différent de celui qui est défini dans la propriété BusinessContext du fichier wc-dataload-env.xml. Si cette colonne n'est pas fournie dans le fichier CSV, l'élément fulfillmentCenterIdentifier est extrait par FulfillmentCenterName. S'il est introuvable, le paramètre fulfillmentCenterIdentifier du contexte métier est utilisé. S'il n'est pas spécifié dans le fichier CSV ni dans le contexte métier, le centre de distribution par défaut du magasin spécifié est utilisé.
FulfillmentCenterName
(Chaîne) Nom du centre de distribution auquel appartient cet article. Cette colonne est utilisée pour extraire l'élément fulfillmentCenterIdentifier.
OwnerId
(Long) Identificateur du propriétaire de cet article. S'il n'est pas spécifié dans le fichier CSV, le propriétaire du magasin de ressources d'entrées de catalogue est alors extrait. S'il n'est pas trouvé, le propriétaire du magasin en cours est alors extrait. S'il est introuvable, l'élément ownerId spécifié dans la propriété BusinessContext du fichier wc-dataload-env.xml est utilisé.
CatalogEntryUniqueId
(Long) Identificateur de l'entrée de catalogue. Il est utilisé pour extraire la clé primaire de la table ITEMSPC, par exemple ITEMSPC_ID. Si cette zone n'est pas spécifiée dans le fichier CSV, ITEMSPC_ID est extrait en fonction du numéro de référence et du propriétaire de l'article.

Données de contexte métier

Le fragment de code suivant du fichier de configuration wc-dataload-env.XML fournit les données de contexte métier requises pour le chargement des données :

<_config:BusinessContext storeIdentifier="AuroraESite">
               <_config:property name="fulfillmentCenterName" value="Aurora Home"/>
               <_config:property name="ownerId" value="7000000000000000102"/>
</_config:BusinessContext>
storeIdentifier
(Chaîne) Identificateur du magasin auquel l'article appartient. Il est utilisé si le fichier CSV ne fournit pas cette information. Utilisé pour extraire les éléments storeID et ownerID.
fulfillmentCenterId
(Chaîne) Identificateur du centre de distribution auquel appartient cet article. Il est utilisé si l'identificateur ne peut pas être extrait par le paramètre FulfillmentCenterId ou FulfillmentCenterName spécifié dans le fichier CSV.
FulfillmentCenterName
(Chaîne) Nom du centre de distribution auquel appartient cet article. Il est utilisé pour extraire le paramètre fulfillmentCenterID si fulfillmentCenterID n'est pas extrait du fichier CSV ni défini dans le contexte métier.
OwnerId
(Long) Identificateur de l'élément entryOwner du catalogue de cet article. Il est utilisé si le paramètre entryOwner de catalogue n'est pas fourni dans le fichier CSV et ne peut pas être extrait par l'identificateur de magasin spécifié.

Données de mappage

Le fragment suivant du fichier d'exemple de configuration illustre comment mapper chaque colonne de données dans le fichier CSV source à une valeur. Chaque colonne du fichier CSV doit comporter une telle définition. Si les zones facultatives figurent dans le fichier CSV, leur définition doit être ajoutée.


<_config:DataReader className="com.ibm.commerce.foundation.dataload.datareader.CSVReader" firstLineIsHeader="true">
        <_config:Data>
                       <_config:column number="1" name="VendorName" />
                       <_config:column number="2" name="RACreateTime" />
                       <_config:column number="3" name="PartNumber" />
                       <_config:column number="4" name="ExpectedDate" />
                       <_config:column number="5" name="CatEntryStoreIdentifier" />
        </_config:Data>
</_config:DataReader >

Le fragment suivant du fichier d'exemple de configuration illustre comment mapper chaque colonne de données dans le fichier CSV à un chemin de schéma logique d'objet métier. L'attribut 'value' représente le nom d'une colonne du fichier CSV défini dans le fragment de configuration précédent. Chaque colonne du fichier CSV doit disposer d'un mappage avec le chemin de schéma logique. Si les zones facultatives mentionnées sont présentes dans le fichier CSV, leur mappage doit être ajouté.

<_config:DataMapping>
        <_config:mapping xpath="ExpectedInventoryRecordIdentifier/ExternalIdentifier/VendorName" value="VendorName" valueFrom="InputData" />        
        <_config:mapping xpath="ExpectedInventoryRecordIdentifier/ExternalIdentifier/CreateDate" value="RACreateTime" valueFrom="InputData" />
        <_config:mapping xpath="ExpectedInventoryDetail[0]/ExpectedInventoryDetailIdentifier/ExternalIdentifier/CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="PartNumber" valueFrom="InputData" />
        <_config:mapping xpath="ExpectedInventoryDetail[0]/ExpectedInventoryDetailIdentifier/ExternalIdentifier/ExpectedDate" value="ExpectedDate" valueFrom="InputData" />
        <_config:mapping xpath="InventoryReceiptIdentifier/ExternalIdentifier/CatalogEntryIdentifier/ExternalIdentifier/StoreIdentifier/ExternalIdentifier/NameIdentifier" value="CatEntryStoreIdentifier" />
</_config:DataMapping>

Médiateur d'objet métier

Le nom de la classe du médiateur est com.ibm.commerce.inventory.dataload.mediator.ExpectedInventoryDetailMediator.

Remarque : Lorsque vous utilisez un médiateur qui est fourni avec HCL Commerce avec l'utilitaire de chargement des données, l'utilitaire suppose que vous chargez des données dans toutes les colonnes d'un objet métier. Si vous souhaitez mettre à jour les données dans des colonnes spécifiques seulement, configurez une liste d'exclusion de colonne pour le processus de chargement. Une liste d'exclusion de colonne amène l'utilitaire de chargement de données à ignorer des colonnes spécifiques au cours de l'opération de chargement. Si vous n'utilisez pas de liste d'exclusion de colonne, l'utilitaire met à jour toutes les colonnes dans la ligne d'une table base de données lorsque l'utilitaire met la ligne à jour. Si aucune valeur n'est définie dans le fichier d'entrée, l'utilitaire peut remplacer la valeur de colonne existante par une valeur par défaut ou définir que la valeur sera nulle. Pour plus d'informations, voir Configuration d'une liste d'exclusion de colonnes.