Exemple : Insertion et remplacement des détails concernant le stock prévu

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

Eléments 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 doivent être 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 d'enregistrement de stock prévu 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

Dans cet exemple, les données source proviennent d'un fichier CSV nommé radetail.csv. Ce fichier contient des exemples de données.

Fichier CSV avec exemples de données

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

VendorName

(Requis, chaîne) Fournisseur du stock. Cette zone est utilisée pour la résolution de RA_ID. Cette zone est requise et ne peut pas contenir la valeur null.

RACreateTime

(Requis, 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. Cette zone est requise et ne peut pas contenir la valeur null.

PartNumber

(Requis, 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, par exemple 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.

ExpectedDate

(Requis, horodatage) La date prévue de réception de ce stock. Son format est identique à celui spécifié dans la zone RACreateTime.

Quantité

(Entier) Quantité commandée au fournisseur dans cet enregistrement de stock prévu.

RADetailComment

(Chaîne ) Commentaires. Le commentaire ne peut pas comporter plus de 254 caractères.

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.

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

Autres zones facultatives non incluses dans l'exemple :

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é.

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.

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.

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 :

<_config:BusinessContext storeIdentifier="AuroraESite">
        <_config:ContextData name="fulfillmentCenterName">Aurora Home</_config:ContextData>
        <_config:ContextData name="ownerId">7000000000000000102</_config:ContextData>
</_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="VendorName" />
    <_config:column number="2" name="RACreateTime" />
    <_config:column number="3" name="PartNumber" />
    <_config:column number="4" name="ExpectedDate" />
    <_config:column number="5" name="Quantity" />
    <_config:column number="6" name="RADetailComment" />
    <_config:column number="7" 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="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="ExpectedInventoryDetail[0]/QuantityOrdered/value" value="Quantity" valueFrom="InputData" />
  	<_config:mapping xpath="ExpectedInventoryDetail[0]/QuantityRemaining/value" value="Quantity" valueFrom="InputData" />
  	<_config:mapping xpath="ExpectedInventoryDetail[0]/Comment" value="RADetailComment" 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. Le schéma logique correspondant est ExpectedInventoryRecord.xsd.