Fichier de configuration de composant de promotion (wc-admin-component.xml)

Le fichier de configuration du composant de promotion (wc-admin-component.xml) contient des propriétés associées à la configuration des fonctions de promotion du Centre de gestion. Vous pouvez modifier les propriétés pour les adapter aux besoins métier de votre site en créant un fichier wc-admin-component.xml ne contenant que les propriétés modifiées.

Les fichiers de configuration du composant Promotion sont stockés aux emplacements suivants :

workspace_dir\WC\xml\config\com.ibm.commerce.promotion\wc-admin-component.xml

Le tableau suivant recense les propriétés configurables dans le fichier `workspace_dir`\WC\xml\config\com.ibm.commerce.promotion\wc-admin-component.xml :
Propriété	Description
`PromotionUniqueCodeValidation`	Contrôle la validation des codes promotion uniques. Cette propriété indique si un message d'erreur de validation doit être émis lorsqu'un code promotion public (saisi manuellement par l'utilisateur) est réutilisé dans une autre promotion active. Le paramètre Value peut prendre les valeurs suivantes : false La validation n'est pas activée. Un professionnel peut affecter le même code promotion à plusieurs promotions actives dans le même magasin. Il s'agit du paramètre par défaut. true La validation est activée. Empêche les professionnels d'affecter le même code promotion à plusieurs promotions actives dans le même magasin. Ce paramètre met en vigueur des codes promotionnels uniques, de sorte qu'une seule promotion associée puisse s'appliquer à la commande d'un client dans la boutique en ligne du magasin. Lorsqu'un utilisateur professionnel active une promotion, le moteur de promotion vérifie la présence dans le magasin de promotions actives utilisant le même code promotionnel. S'il en existe, l'utilisateur est dans l'incapacité d'activer la promotion. Un message d'erreur l'avise que le code promotion est actuellement utilisé pour qu'il puisse en changer. Dans un modèle de site étendu, la validation du code de promotion est un paramètre au niveau du site. Ce paramètre s'applique au magasin de ressources et aux magasins de site étendu. Si une promotion active possède le code promotion ABC, aucune autre promotion active du magasin de ressources ou d'un magasin de site étendu ne peut posséder ce code promotion.
`PromotionUniquePriorityValidation`	Contrôle la validation des priorités de promotion uniques. Cette propriété indique si un message d'erreur de validation doit être émis lorsqu'une priorité de promotion est réutilisée dans une autre promotion active. Le paramètre Value peut prendre les valeurs suivantes : false La validation n'est pas activée. Permet aux professionnels d'affecter la même priorité à plusieurs promotions actives dans le même groupe de promotions d'un même magasin. Il s'agit du paramètre par défaut. true La validation est activée. Empêche les professionnels d'affecter la même priorité à plusieurs promotions actives dans le même groupe de promotions d'un même magasin. Par exemple, la priorité 1 ne peut être affectée qu'à une seule promotion sur frais de port active. Ceci garantit que les professionnels affectent des priorités uniques déterminant l'ordre dans lequel le moteur de promotion évalue les promotions dans un même groupe de promotions. Lorsqu'un utilisateur professionnel active une promotion, le moteur de promotion vérifie la présence dans le même groupe de promotions de promotions actives dotées de la même priorité. S'il en existe, l'utilisateur est dans l'incapacité d'activer la promotion. Un message d'erreur l'avise que cette priorité est déjà utilisée pour qu'il puisse en changer. Dans un modèle de site étendu, la validation de priorité est un paramètre au niveau du site. Ce paramètre s'applique au magasin de ressources et aux magasins de site étendu. Si une promotion active possède une priorité de 10, aucune autre promotion active du magasin de ressources ou d'un magasin de site étendu ne peut posséder ce niveau de priorité.
`PromotionSiteWideValidation`	Cette propriété indique si la validation sur l'ensemble du site doit être effectuée. Si une promotion est marquée comme portant sur l'ensemble du site, elle ne doit pas contenir d'entrées de catalogue ni de catégories pour inclusion. Si une promotion est marquée comme ne portant pas sur l'ensemble du site, elle doit contenir au moins une entrée de catalogue ou une catégorie pour inclusion. Le paramètre Value peut prendre les valeurs suivantes : false La validation ne doit pas être effectuée sur l'ensemble du site. true La validation doit être effectuée. Il s'agit de la valeur par défaut.
`PopulateCodeColumnOfPxPromotionTable`	Cette propriété indique si la colonne PX_PROMOTION.CODE doit contenir la liste des codes promotion publics. La colonne PX_PROMOTION.CODE a une longueur de 128 caractères et n'est pas forcément susceptible de contenir un grand nombre de codes promotion publics associés à une promotion. Les codes promotion publics sont sauvegardés au format d'un par ligne dans la table PX_PROMOCD. Le paramètre Value peut prendre les valeurs suivantes : false La colonne n'est pas disponible en écriture. Si vous créez une promotion qui est associée à de nombreux codes promotion publics, il est recommandé de définir la valeur false. true L'écriture dans la colonne est activée. Il s'agit de la valeur par défaut.

Le tableau suivant recense les propriétés configurables dans le fichier `workspace_dir`\WC\xml\config\com.ibm.commerce.promotion-fep\wc-admin-component.xml :
Propriété liée à l'exécution de la promotion	Description
`PromotionCatalogEntryAttributeRuleValidation`	Cette propriété indique si une validation des attributs d'entrée de catalogue doit être appliquée au moment de la validation d'une promotion. La validation est destinée aux promotions sur entrées de catalogue pour lesquelles des attributs sont définis. Elle vérifie que le nom et la valeur des attributs qui sont définis dans une promotion existent pour toutes les entrées de catalogue ciblées par la promotion. Le paramètre Value peut prendre les valeurs suivantes : false La validation n'est pas activée. true La validation est activée. Il s'agit de la valeur par défaut.
`maxNumberOfActivePromotionsWithRedemptionLimits`	Utilisez cette propriété pour définir le nombre maximal de promotions actives susceptibles d'être soumises à une limite d'utilisation pouvant exister dans le système. Lorsque ce nombre est atteint, les nouvelles promotions sont pas activables tant qu'une promotion active soumise à une limite d'utilisation n'est pas désactivée. Définissez le paramètre Value sur `-1` pour autoriser un nombre illimité de promotions actives avec des limites d'utilisation. La valeur par défaut est `-1`.
`maxNumberOfActivePromotionsWithAttributes`	Utilisez cette propriété pour définir le nombre maximal de promotions actives susceptibles de cibler des attributs produit pouvant exister dans le système. Lorsque ce nombre est atteint, les nouvelles promotions sont pas activables tant qu'une promotion active ciblant des attributs n'est pas désactivée. Définissez le paramètre Value sur `-1` pour autoriser un nombre illimité de promotions actives ciblant des attributs produit. La valeur par défaut est `-1`.
`maxTargetedCatalogEntriesPerPromotion`	Utilisez cette propriété pour définir le nombre maximal d'entrées de catalogue qui peuvent être ciblées pour une promotion. Lorsque ce nombre est atteint, la promotion n'est pas activables tant qu'elle n'est pas corrigée. Définissez le paramètre Value sur `-1` pour autoriser le ciblage d'un nombre illimité d'entrées de catalogue pour une promotion. La valeur par défaut est `-1`.
`maxTargetedCategoriesPerPromotion`	Utilisez cette propriété pour définir le nombre maximal de catégories qui peuvent être ciblées pour une promotion. Lorsque ce nombre est atteint, la promotion n'est pas activables tant qu'elle n'est pas corrigée. Définissez le paramètre Value sur -1 pour autoriser le ciblage d'un nombre illimité de catégories pour une promotion. La valeur par défaut est `-1`.
`ListOnlyPromotionsNotInFolders`	Cette propriété détermine si les promotions qui se trouvent dans un dossier s'affichent dans la vue principale Promotions - Liste de l'outil Promotions. Les valeurs possibles de cette propriété sont les suivantes : true La vue principale Promotions - Liste n'affiche pas les promotions incluses dans un dossier. false Toutes les promotions s'affichent dans la vue principale Promotions - Liste (valeur par défaut).
`ConvertPromotionDatesToUTC`	Utilisez cette propriété pour convertir la date et l'heure de début et de fin d'une promotion en valeurs UTC (temps universel coordonné) avant de les enregistrer dans le XML d'exécution de la promotion. true Cette propriété est activée et les dates/heures sont lues et interprétées en temps UTC lorsqu'une promotion est propagée à l'environnement de production. Cette propriété permet de garantir la cohérence des fuseaux horaires entre les environnements de transfert et de production. Ainsi, une promotion définie pour une certaine période dans le Management Center sur l'environnement de transfert est active pendant la même période sur l'environnement de production. false (Valeur par défaut).
`AllowDeactivatingPromotionWhileGeneratingCodes`	Utilisez cette propriété pour déterminer si les utilisateurs peuvent annuler la création des codes promotion en désactivant la promotion alors que la création du code est en cours. true Les utilisateurs peuvent annuler la génération de code en cliquant sur le bouton Désactiver pour la promotion. false Les utilisateurs doivent attendre la fin de la génération de code promotionnel pour désactiver la promotion (valeur par défaut).
`TrackPublicPromotionCodeUsage`	Utilisez cette propriété pour indiquer si l'utilisation de codes promotionnels publics est enregistrée dans la table de base de données PX_CDUSAGE. Vous pouvez définir les valeurs suivantes pour cette propriété : true L'utilisation de codes promotionnels publics est enregistrée, ainsi que l'utilisation de codes uniques. Lorsqu'un client utilise un code promotionnel public, un enregistrement est ajouté à la table de base de données PX_CDUSAGE. L'activation de ce suivi d'utilisation peut affecter les performances. Lorsque cette propriété est activée et que votre magasin fait l'objet d'un trafic élevé, les clients peuvent observer des retards ou des délais d'attente lors du paiement de leur commande. C'est notamment le cas lorsque les codes promotionnels publics sont partagés entre plusieurs promotions. false L'utilisation de codes promotionnels publics n'est pas suivie (valeur par défaut). Ce paramètre n'a pas d'incidence sur l'enregistrement de codes promotionnels uniques.
Propriété liée aux codes promotion unique	Description
`CodePopulateBatchSize`	Contrôle le nombre des codes promotion uniques à inclure dans un lot à insérer dans votre base de données. Le paramètre Value peut être défini sur un nombre entier positif. La valeur par défaut est 1000.
`CodeDeleteBatchSize`	Utilisez cette propriété pour indiquer le nombre de codes promotion à inclure dans un lot lors de la suppression de codes. Cette propriété est utilisée pour les codes qui sont supprimés lorsqu'un processus de création de code est annulé avant son achèvement, ou lorsqu'une promotion qui génère des codes est activée alors que des codes existent déjà dans la base de données pour cette promotion. Le paramètre Value peut être défini sur un nombre entier positif. La valeur par défaut est 1000.
`HostForPromotionCodePopulationScheduledJob`	Utilisez cette propriété pour identifier l'instance de planificateur qui doit exécuter le travail planifié d'insertion des codes promotion uniques. Si le paramètre Value est une chaîne vide, le travail est exécuté par une instance quelconque de planificateur. Chaque instance de planificateur peut avoir un nom d'instance unique. Par défaut, le nom est celui de l'hôte du serveur Web HCL Commerce. La valeur par défaut pour cette propriété est une chaîne vide.
`PriorityForPromotionCodePopulationScheduledJob`	Utilisez cette propriété pour identifier la priorité du travail planifié d'insertion des codes promotion uniques. Si le paramètre Value est une chaîne vide, le travail obtient par défaut la priorité 5 (`java.lang.Thread.NORM_PRIORTY`). Les valeurs admises pour cette propriété sont comprises entre 1 (`java.lang.Thread.MIN_PRIORITY`) et 10 (`java.lang.Thread.MAX_PRIORITY`).
`ApplicationTypeForPromotionCodePopulationScheduledJob`	Utilisez cette propriété pour identifier le groupe de planification d'applications auquel appartient le travail d'insertion des codes promotion uniques. Si le paramètre Value est une chaîne vide, le travail est affecté au type d'application par défaut. Les types d'application, et les règles qui régissent leur accès aux ressources, sont définis dans la console d'administration. La valeur par défaut est une chaîne vide.
`com.ibm.commerce.promotion.uniquecode.generator.AlphabeticLowerPatternCharacters` `com.ibm.commerce.promotion.uniquecode.generator.AlphabeticLowerPatternCode` `com.ibm.commerce.promotion.uniquecode.generator.AlphabeticMixPatternCharacters` `com.ibm.commerce.promotion.uniquecode.generator.AlphabeticMixPatternCode` `com.ibm.commerce.promotion.uniquecode.generator.AlphabeticUpperPatternCharacters` `com.ibm.commerce.promotion.uniquecode.generator.AlphabeticUpperPatternCode` `com.ibm.commerce.promotion.uniquecode.generator.AlphaLowerNumericPatternCharacters` `com.ibm.commerce.promotion.uniquecode.generator.AlphaLowerNumericPatternCode` `com.ibm.commerce.promotion.uniquecode.generator.AlphaMixNumericPatternCharacters` `com.ibm.commerce.promotion.uniquecode.generator.AlphaMixNumericPatternCode` `com.ibm.commerce.promotion.uniquecode.generator.AlphaUpperNumericPatternCharacters` `com.ibm.commerce.promotion.uniquecode.generator.AlphaUpperNumericPatternCode` `com.ibm.commerce.promotion.uniquecode.generator.NumericPatternCharacters` `com.ibm.commerce.promotion.uniquecode.generator.NumericPatternCode`	Contrôle les valeurs d'entrée et de sortie qui sont générées à l'aide des codes promotionnels uniques avancés, générés par le système. Les valeurs de modèle d'entrée et de sortie par défaut sont basées sur des caractères alphanumériques anglais. Le paramètre Value de chaque propriété peut être défini sur des valeurs de caractère alphanumérique personnalisées afin de prendre en charge vos caractères personnalisés. Les valeurs par défaut de ces propriétés figurent dans le fichier de configuration wc-admin-component.xml du composant de promotion.
`WaitingPeriodForUniqueCodeRelease`	Contrôle le nombre de minutes après lequel un code promotion unique, appliqué par un visiteur à une commande abandonnée, est libéré. Le code promotion peut ensuite être appliqué par un autre client. Le paramètre Value peut être défini sur une valeur d'entier positif en minutes. La valeur peut également être égale à `-1`, ce qui signifie que le code promotion n'est pas déverrouillé sauf s'il est supprimé manuellement par le visiteur. La valeur par défaut est 1440 minutes.
`ShopperTypeForUniqueCodeRelease`	Contrôle le comportement du mode de libération des codes promotionnels uniques. Par défaut, lorsqu'un visiteur ajoute un code promotionnel unique à un panier, ce code est verrouillé pour la commande pendant la période indiquée dans la propriété de configuration `WaitingPeriodForUniqueCodeRelease`. Lorsque le délai indiqué est atteint, tout visiteur ou client enregistré peut demander le code promotionnel. Si un client enregistré ajoute un code unique à un panier, ce code n'est libéré que lorsqu'il le supprime de la commande. A l'aide de la propriété de configuration `ShopperTypeForUniqueCodeRelease`, un administrateur peut sélectionner l'un des comportements suivants pour le mode de libération d'un code promotionnel unique : 1 Les codes des visiteurs sont libérés lorsque le délai défini pour la propriété `WaitingPeriodForUniqueCodeRelease` est atteint. Les clients enregistrés ne perdent leurs codes promotionnels uniques que s'ils les suppriment de la commande. Il s'agit du comportement et de la valeur par défaut de la propriété `ShopperTypeForUniqueCodeRelease`. 2 Les codes des clients enregistrés sont libérés lorsque le délai défini pour la propriété `WaitingPeriodForUniqueCodeRelease` est atteint. Les visiteurs ne perdent leurs codes promotionnels uniques que s'ils les suppriment de la commande. 3 Les codes promotionnels de tous les clients sont libérés lorsque le délai défini pour la propriété `WaitingPeriodForUniqueCodeRelease` est atteint.
`HostForPromotionCodeExportScheduledJob`	Utilisez cette propriété pour identifier l'instance de planificateur qui doit exécuter un travail planifié d'exportation de codes promotion.
`CompressPromotionCodeExportFile`	Contrôle si les codes promotionnels sont exportés dans un fichier téléchargeable compressé lors de leur exportation à l'aide du Management Center. Le paramètre Value peut prendre les valeurs suivantes : false Les codes promotionnels sont exportés dans un format de fichier CSV nom compressé. Il s'agit du paramètre par défaut pour cette propriété. true Les codes promotion sont exportés dans un format de fichier compressé.
`ApplyPromotionOnLowestPricedOrderItemsFirst`	Contrôle si la promotion s'applique d'abord à l'article le moins cher ou au plus cher. Pour plus d'informations sur l'ajout de contraintes, voir Pour faire appliquer une promotion à l'article le moins cher. false Il s'agit de la valeur par défaut. La promotion s'applique d'abord à l'article le plus cher. true La promotion s'applique d'abord à l'article le moins cher.

Remarque : En tant qu'administrateur, vous pouvez configurer l'outil Promotion pour que les promotions incluses dans un dossier ne s'affichent plus dans la vue principale Promotions - Liste. Si le magasin utilise des centaines ou des milliers de promotions, empêcher l'affichage dans la vue Promotions - Liste de promotions classées dans des dossiers peut faciliter la recherche de promotions. Avec cette configuration, les professionnels peuvent rechercher des promotions triées dans des dossiers et parcourir la vue Promotions - Liste pour trouver des promotions non triées. Pour plus d'informations, voir Recherche de promotions.