Exemple : Insertion et remplacement de données de réception

Utilisez l'utilitaire de chargement de données pour charger des données de réception dans la table RECEIPT.

Prérequis

Avant d'exécuter cet exemple, vérifiez que les conditions requises sont remplies :

• Vérifiez que le système de stock est un système de stock disponible à la vente. Pour ce faire, vérifiez la table STORE pour vous assurer que INVENTORYSYSTEM=-1.
• Les données de catalogue, les données de groupe de catalogue et les données d'entrée de catalogue qui sont utilisées dans cet exemple sont chargées dans la base de données.
• Les données de configuration du stock disponible à la vente sont chargées dans la base de données.
• Les données de nom de fournisseur (VendorName) figurant dans le fichier CSV source existent dans la table VENDOR de la base de données.

Fichier CSV avec exemples de données de réception

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

PartNumber

(Chaîne) 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, c'est-à-dire ITEMSPC_ID. Cette zone est requise et ne peut pas contenir la valeur null si la zone CatalogEntryUniqueId n'est pas spécifiée dans le fichier CSV.

CreateTime

(Requis, horodatage) Date et heure de création de l'enregistrement. Le format de l'entrée par défaut 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 fait partie de l'index à entrées uniques de la table RECEIPT. Cette zone est requise et ne peut pas contenir la valeur null.

ReceiptDate

(Horodatage) Date et heure de réception du stock. Son format est identique à celui spécifié dans CreateTime. La date et l'heure courantes sont utilisées si ce paramètre n'est pas indiqué dans le fichier CSV.

Quantité

(Entier) Quantité reçue. 0 est utilisé lorsqu'aucune valeur n'est fournie.

Cost

(Double) Coût unitaire.

Devise

(Chaîne) Devise utilisée pour le coût unitaire. Il s'agit d'un code devise conforme aux normes ISO 4217.

VendorName

(Chaîne) Fournisseur d'où provient le stock.

Comment1

(Chaîne ) Commentaires. La longueur du commentaire ne doit pas dépasser 254 caractères.

Comment2

(Chaîne) Autres commentaires. La longueur du commentaire ne doit pas dépasser 254 caractères.

CatEntryStoreIdentifier

(Chaîne) Cet identificateur est utilisé 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.

Cette zone est requise si vous utilisez un magasin de site étendu.

Autres zones facultatives non incluses dans l'exemple :

CurrentStoreIdentifier

(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, c'est-à-dire 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.

Supprimer

(Chaîne) Indique si cet enregistrement doit être supprimé. Cette zone prend effet lorsque dataLoadMode est défini à "replace". Si la valeur de cette zone est égale à deleteValue, l'enregistrement correspondant est supprimé. La valeur par défaut de deleteValue est 1 et ce paramètre peut être configuré sous l'élément <DataMapping> dans BusinessObjectConfigFile.

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 de réception :

<_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 du propriétaire de cet article. Il est utilisé si le paramètre owner 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.

<_config:DataReader className="com.ibm.commerce.foundation.dataload.datareader.CSVReader" firstLineIsHeader="true">
  <_config:Data>
  <_config:column number="1" name="PartNumber" />
  <_config:column number="2" name="CreationTime" />
  <_config:column number="3" name="ReceiptDate" />
  <_config:column number="4" name="Quantity" />
  <_config:column number="5" name="Cost" />
  <_config:column number="6" name="Currency" />
  <_config:column number="7" name="VendorName" />
  <_config:column number="8" name="Comment1" />
  <_config:column number="9" name="Comment2" />
  <_config:column number="10" 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, qui est défini dans le fragment de configuration. 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é. Le chemin de schéma logique correspondant est spécifié dans le tableau suivant.

<_config:DataMapping>
                       
   <_config:mapping xpath="InventoryReceiptIdentifier/ExternalIdentifier/CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="PartNumber" valueFrom="InputData" />
   <_config:mapping xpath="InventoryReceiptIdentifier/ExternalIdentifier/CreationTime" value="CreationTime" valueFrom="InputData" />
   <_config:mapping xpath="ReceiptDate" value="ReceiptDate" valueFrom="InputData" /> 
   <_config:mapping xpath="QuantityReceived/value" value="Quantity" valueFrom="InputData" />
   <_config:mapping xpath="QuantityOnHand/value" value="Quantity" valueFrom="InputData" />
   <_config:mapping xpath="UnitCost/value" value="Cost" valueFrom="InputData" />
   <_config:mapping xpath="UnitCost/currency" value="Currency" valueFrom="InputData" />
   <_config:mapping xpath="VendorName" value="VendorName" valueFrom="InputData" />
   <_config:mapping xpath="Comment1" value="Comment1" valueFrom="InputData" />
   <_config:mapping xpath="Comment2" value="Comment2" 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 classe de médiateur est com.ibm.commerce.inventory.dataload.mediator.InventoryReceiptMediator. Le schéma logique correspondant est InventoryReceipt.xsd.