Fichier d'entrée XML pour les promotions

Vous pouvez utiliser un fichier d'entrée XML afin de créer ou changer des promotions pour un magasin. Lorsque vous créez un fichier d'entrée pour charger des données de promotion, vous pouvez inclure divers éléments et valeurs XML. Les éléments XML que vous devez inclure dans votre fichier d'entrée dépendent des propriétés, de la description des conditions d'achat, des récompenses et des méthodes d'utilisation définis pour les promotions que vous chargez.

Conseil : Vous pouvez créer une promotion dans l'outil Promotions, puis exporter la promotion avec l'utilitaire d'extraction de données afin d'obtenir rapidement un exemple de fichier XML de promotion. Vous pouvez utiliser ce fichier XML comme fichier d'entrée pour l'utilitaire de chargement de données afin d'importer la promotion dans d'autres environnements, par exemple plusieurs environnements de test.
Le fichier d'entrée XML de promotion doit être constitué de trois sections :
<Base>
Les éléments dans cet élément parent définissent les propriétés générales et d'identification d'une promotion.
<Description>
Informations de description de la promotion. Incluez un élément <Description> distinct pour chaque langue définie que votre magasin prend en charge pour la promotion.
<Elements>
Informations de condition d'achat et de récompense de la promotion. Chaque élément enfant direct <Type> dans l'élément <Elements> est un type de condition ou de récompense distinct.

Lorsque vous créez votre fichier d'entrée pour le chargement des données de promotion, vous devez utiliser le nom correct pour les éléments XML enfant dans les éléments <Base> et <Description>. Il n'est pas nécessaire de définir une valeur pour chacun des éléments ci-après. Si vous ne définissez pas de valeur pour l'un des éléments ci-après, l'utilitaire de chargement de données définit la valeur NULL pour la colonne de base de données correspondante.

Eléments XML dans la section <Base>

Lorsque vous créez votre fichier d'entrée pour le chargement des données de promotion, vous devez utiliser le nom correct pour les éléments XML enfant dans la section <Base>. Il n'est pas nécessaire de définir une valeur pour chacun des éléments ci-après. Si vous ne définissez pas de valeur pour l'un des éléments ci-après, l'utilitaire de chargement de données définit la valeur NULL pour la colonne de base de données correspondante.

PromotionId
ID unique de la promotion. Vous devez inclure cet élément lorsque vous changez des promotions. Si vous créez une promotion avec l'utilitaire de chargement de données, n'incluez pas cette valeur. Lorsque vous créez une promotion, utilisez l'élément AdministrativeName.

Cet élément est mappé à PX_PROMOTION.PX_PROMOTION_ID.

AdministrativeName
Nom d'administration de la promotion. Vous devez inclure cet élément lorsque vous créez des promotions. L'utilitaire de chargement de données se sert de cet élément afin de résoudre un ID pour la promotion. Si une opération de chargement rencontre une valeur en double pour le nom d'administration, l'utilitaire de chargement de données ne charge pas la promotion dont le nom est dupliqué.

Mappé à PX_PROMOAUTH.ADMINSTVENAME.

PromotionGroupIdentifier
Nom du groupe de promotions auquel appartient la promotion.

Mappé à PX_GROUP.GRPNAME.

PromotionGroupStoreIdentifier
Identificateur du magasin auquel appartient le groupe de promotions dans lequel se trouve la promotion.

Mappé à PX_GROUP.STOREENT_ID.

Comments
Commentaires pour la promotion.

Mappé à PX_PROMOAUTH.COMMENTS.

Priority
Priorité de la promotion.

Mappé à PX_PROMOTION.PRIORITY.

Exclusive
Exclusivité de la promotion. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
La promotion peut être combinée avec une autre promotion.
1
La promotion ne peut pas être combinée avec d'autres promotions qui se trouvent dans le même groupe de promotions.
2
La promotion ne peut pas être combinée avec d'autres promotions.
3
La promotion ne peut pas être combinée avec d'autres promotions qui se trouvent dans le groupe de promotions sur le produit.
4
La promotion peut être ajoutée à d'autres promotions qui se trouvent dans le même groupe de promotions.

Mappé à PX_PROMOTION.EXCLSVE.

LastUpdateByLogonId
ID de connexion du professionnel qui a modifié la promotion en dernier.

Mappé à PX_PROMOTION.LOGONID.

PerOrderLimit
Nombre de fois que la promotion peut être appliquée à une commande unique. La valeur par défaut est -1, c'est-à-dire qu'il n'existe pas de limite.

Mappé à PX_PROMOTION.PERORDLMT.

PerShopperLimit
Nombre de fois qu'un client peut bénéficier de la promotion. La valeur par défaut est -1, c'est-à-dire qu'il n'existe pas de limite.

Mappé à PX_PROMOTION.PERSHOPPERLMT.

ApplicationLimit
Limite globale d'utilisation de la promotion. La valeur par défaut est -1, c'est-à-dire qu'il n'existe pas de limite.

Mappé à PX_PROMOTION.TOTALLMT.

TargetSales
Volume des ventes cible pour la promotion.

Mappé à PX_PROMOTION.TGTSALES.

PromotionTypeName
Type de règle de promotion.

Mappé à PX_PROMOAUTH.PROMOTIONTYPE.

ControlParameter
Informations de contrôle pour l'interface utilisateur.

Mappé à PX_PROMOAUTH.CTLPARAM.

StartDate
Date de début de la promotion.

Mappé à PX_PROMOTION.STARTDATE.

EndDate
Date de fin de la promotion.

Mappé à PX_PROMOTION.ENDDATE.

DailyStartTime
Jour de début de la promotion (par exemple : 01/01/2000).

Mappé à PX_PROMOAUTH.DAILYSTARTTIME.

DailyEndTime
Jour de fin de la promotion (par exemple : 01/01/2000).

Mappé à PX_PROMOAUTH.DAILYENDTIME.

Sunday
Indique si la promotion est disponible le dimanche. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
La promotion n'est pas disponible.
1
La promotion est disponible.

Mappé à PX_PROMOAUTH.WEEKDAY_SUN.

Monday
Indique si la promotion est disponible le lundi. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
La promotion n'est pas disponible.
1
La promotion est disponible.

Mappé à PX_PROMOAUTH.WEEKDAY_MON.

Tuesday
Indique si la promotion est disponible le mardi. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
La promotion n'est pas disponible.
1
La promotion est disponible.

Mappé à PX_PROMOAUTH.WEEKDAY_TUE.

Wednesday
Indique si la promotion est disponible le mercredi. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
La promotion n'est pas disponible.
1
La promotion est disponible.

Mappé à PX_PROMOAUTH.WEEKDAY_WED.

Thursday
Indique si la promotion est disponible le jeudi. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
La promotion n'est pas disponible.
1
La promotion est disponible.

Mappé à PX_PROMOAUTH.WEEKDAY_THU.

Friday
Indique si la promotion est disponible le vendredi. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
La promotion n'est pas disponible.
1
La promotion est disponible.

Mappé à PX_PROMOAUTH.WEEKDAY_FRI.

Saturday
Indique si la promotion est disponible le samedi. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
La promotion n'est pas disponible.
1
La promotion est disponible.

Mappé à PX_PROMOAUTH.WEEKDAY_SAT.

Type
Type de la promotion. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
La promotion peut être appliquée aux clients qui appartiennent à un ou plusieurs profils client ciblés. Si la liste des fichiers de profil ciblé est vide, la promotion s'applique à tous les clients.
1
La promotion s'applique uniquement aux clients qui peuvent bénéficier explicitement de la promotion, par exemple via un bon de réduction.

Mappé à PX_PROMOTION.TYPE.

Effectivedays
Si la promotion est privée, cet élément indique le nombre de jours au bout duquel le bon de réduction devient actif, après son émission.

Mappé à PX_PROMOTION.EFFECTIVE.

Expirationdays
Si la promotion est privée, cet élément indique le nombre de jours au bout duquel le bon de réduction arrive à expiration, après son émission.

Mappé à PX_PROMOTION.EXPIRE.

AllowTransfer
Si la promotion est privée, cet élément indique si les bons de réduction de promotion peuvent être transférés. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
Les bons de réduction de promotion ne peuvent pas être transférés.
1
Les bons de réduction de promotion peuvent être transférés.

Mappé à PX_PROMOTION.TRANSFER.

PromotionCodeRequired
Indique si un code promotionnel est nécessaire pour bénéficier de la promotion. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
Aucun code promotionnel n'est nécessaire pour bénéficier de la promotion.
1
Un code promotionnel est nécessaire.

Mappé à PX_PROMOTION.CDREQUIRED.

PromotionCodeCue
Code promotionnel public pour la promotion.

Mappé à PX_PROMOTION.CODE.

DisplayLevel
Indique si les montants calculés par le code de calcul sont affichés. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
Article de commande
1
Ordre
2
Produit
3
Elément
4
Contrat

Mappé à CALCODE.DISPLAYLEVEL.

CodeType
Type de code promotionnel nécessaire pour bénéficier de la promotion.
0
Code promotionnel public.
1
Code généré.
2
Code importé.

Mappé à PX_CDSPEC.CODETYPE.

Pattern
Modèle de génération de code promotionnel pour la génération de codes promotionnels avancés.

Mappé à PX_CDSPEC.PATTERN.

Count
Nombre de codes promotionnels pouvant être générés pour la promotion.

Mappé à PX_CDSPEC.COUNT.

CodeStatus
Statut des codes promotionnels pour la promotion. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
Non rempli.
1
Rempli.
2
En cours de traitement.
3
Annulé.
4
Echec de la génération.
5
Echec de l'importation.

Mappé à PX_CDSPEC.CODESTATUS.

Transferable
Indique si les codes promotionnels peuvent être transférés. Vous pouvez inclure les valeurs suivantes pour cet élément :
0
Les codes promotionnels peuvent être transférés.
1
Les codes promotionnels ne peuvent pas être transférés.

Mappé à PX_CDSPEC.TRANSFERABLE.

Eléments XML dans la section <Description>

Lorsque vous créez votre fichier d'entrée pour le chargement des données de promotion, vous devez utiliser le nom correct pour les éléments XML enfant dans la section <Description>. Il n'est pas nécessaire de définir une valeur pour chacun des éléments ci-après. Si vous ne définissez pas de valeur pour l'un des éléments ci-après, l'utilitaire de chargement de données définit la valeur NULL pour la colonne de base de données correspondante.

LanguageId
Langue des informations de description.

Mappé à PX_DESCRIPTION.LANGUAGE_ID.

AdminDescription
Description administrative de la promotion.

Mappé à PX_DESCRIPTION.ADMINDESC.

ShortDescription
Description abrégée de la promotion.

Mappé à PX_DESCRIPTION.SHORTDESC.

LongDescription
Description détaillée de la promotion.

Mappé à PX_DESCRIPTION.LONGDESC.

Field1
Zone de description personnalisée que vous pouvez utiliser pour les informations de promotion.

Mappé à PX_DESCRIPTION.FIELD1.

Field2
Zone de description personnalisée que vous pouvez utiliser pour les informations de promotion.

Mappé à PX_DESCRIPTION.FIELD2.

Field3
Zone de description personnalisée que vous pouvez utiliser pour les informations de promotion.

Mappé à PX_DESCRIPTION.FIELD3.

Field4
Zone de description personnalisée que vous pouvez utiliser pour les informations de promotion.

Mappé à PX_DESCRIPTION.FIELD4.

Field5
Zone de description personnalisée que vous pouvez utiliser pour les informations de promotion.

Mappé à PX_DESCRIPTION.FIELD5.

Eléments XML dans la section <Elements>

La dénomination des éléments enfant pour la section <Elements> est différente de celle des sections <Base> et <Description>. Dans l'élément <Elements>, vous devez utiliser le nom correct uniquement pour les éléments enfant <SubType>, <Sequence> et <Data>. Pour les éléments <Type> et <Name>, que vous pouvez inclure plusieurs fois pour une promotion, vous devez remplacer les noms d'élément avec le nom d'identification approprié.

Le code ci-dessous illustre la structure des éléments enfant dans la section <Elements> du fichier d'entrée.
<Elements>
  <Type>
    <SubType>...</SubType>
    <Sequence>...</Sequence>
    <Data> 
      <name>value</name>
      <name>value</name>
    </Data>
    <Type>
	      <SubType>...</SubType>
      <Sequence>...</Sequence>
      <Data> 
        <name>value</name>
        <name>value</name>
      </Data>
    </Type>
    ...
  </Type>
<Elements>
<Type>
Nom d'une condition de promotion ou d'une récompense. Remplacez <Type> par le nom de la condition ou de la récompense. Par exemple, <PurchaseCondition>.

Vous pouvez inclure plusieurs éléments <Type> pour une promotion. Un élément <Type> peut être imbriqué dans un autre élément <Type>. Par exemple, le code ci-dessous contient un élément <Type> appelé <IncludePaymentTypeIdentifier>, qui est imbriqué dans un élément <Type> appelé <PurchaseCondition>.

<Elements>
  <PurchaseCondition>
    ...
    <IncludePaymentTypeIdentifier>
	  ...
    </IncludePaymentTypeIdentifier>
  </PurchaseCondition>
  ...
  <Elements>

Mappé à PX_ELEMENT.TYPE.

SubType
Sous-type d'un élément de promotion <Type>. Chaque <Type> peut avoir un <SubType>. Par exemple, un élément <Type> nommé <PurchasingCondition> peut avoir un élément <SubType> appelé <OrderLevelPercentDiscountPurchaseCondition>.

Mappé à PX_ELEMENT.SUBTYPE.

Sequence
Séquence que l'élément de condition d'achat ou de récompense de la promotion affiche pour une promotion. Chaque élément <Type> peut comporter un élément <Sequence>.

Mappé à PX_ELEMENT.SEQUENCE.

Data
Indique que des informations de paire nom-valeur existent pour un élément <Type> parent (condition d'achat ou récompense). Tous les éléments XML enfant dans cet élément <Data> sont des paires nom-valeur. Incluez chaque paire nom-valeur comme élément distinct. Cet élément n'est mappé à aucune colonne et est utilisé par l'utilitaire de chargement de données pour lire le fichier d'entrée XML de promotion et identifier les éléments de paire nom-valeur.
<Name>
Nom d'une paire nom-valeur. Remplacez <Name> par le nom approprié. Par exemple, dans le fragment de code suivant qui provient d'un fichier d'entrée Currency, MinimumPurchase, <FixedCost> et <AdjustmentType>, sont tous utilisés comme éléments <Name> :
<Elements>
  <PurchaseCondition>
  ...
    <Data>    
      <Currency>USD</Currency>
      <MinimumPurchase>70</MinimumPurchase>
      <FixedCost>0</Fixed Cost>
      <AdjustmentType>IndividualAffectedItems</AdjustmentType>
    </Data>
  </PurchaseCondition>
  ...
<Elements>

Mappé à PX_ELEMENTNVP.NAME.

La valeur de chaque élément <Name>, par exemple USD dans le fragment de code précédent, est mappée à PX_ELEMENTNVP.VALUE.