Utilitaire de migration de stratégie

Un utilitaire est fourni pour migrer les stratégies créées à l'aide de l'ancienne interface utilisateur de Strategy antérieure à la version 12.0 vers les nouveaux modèles afin de pouvoir les afficher et les modifier dans la nouvelle interface utilisateur de Strategy.

En outre, cet outil de migration de stratégie peut être utilisé pour rétablir la migration, c'est-à-dire les stratégies dynamiques introduites dans Unica Interact 12.0, vers l'ancien modèle.
Remarque : Cet utilitaire de migration doit uniquement être exécuté lors de la mise à niveau d'Interact depuis une version antérieure à la version 12.0 vers une version antérieure à la version 12.1.0.2. A partir de la version 12.1.0.3, Interact DT Upgrade Tool exécutera automatiquement cet utilitaire pour migrer toutes les anciennes stratégies vers des stratégies intelligentes.

Utilisation

En exécutant l'utilitaire de migration de stratégie, il est possible de planifier une ancienne stratégie pour migrer vers une stratégie dynamique introduite dans Interact version 12.0. Les utilisateurs peuvent migrer certaines stratégies ou toutes les stratégies en fonction de leurs besoins.

En exécutant le même utilitaire, il est possible de restaurer l'ancien modèle de la stratégie dynamique migrée. De même, la restauration peut se faire sur des stratégies sélectives ou sur toutes les stratégies en fonction de leurs besoins.

Configurations de propriétés pour l'utilitaire de migration de stratégie

Avant d'exécuter cet utilitaire, les utilisateurs doivent suivre le chemin d'accès <Installation_Directory>\Interact\interactDT\tools\upgrade\conf et ouvrir le fichier StrategyMigration.properties afin de configurer les propriétés requises pour la migration ou la restauration souhaitée.

Les utilisateurs doivent modifier les propriétés suivantes en fonction de leur utilisation.

  • DeleteOldRulesAndRuleGroups: Cette propriété décide s'il est nécessaire de supprimer le groupe de règles migré (UACI_RuleGroup) et les données de règle (UACI_Rule) après la migration. Cette propriété est uniquement applicable à la migration.
    • Si cette propriété est définie sur YES, la stratégie migrée ne peut pas être restaurée vers l'ancien modèle. Par conséquent, il est recommandé de conserver la valeur de cette propriété sur NO afin qu'il y ait une possibilité de comparaison permettant de décider si une restauration est requise après la migration. Si cette propriété est définie sur YES, vous devez conserver la sauvegarde des données des tables UACI_RuleGroup et UACI_Rule.
    • Si cette propriété est définie sur No, l'ancienne stratégie peut toujours être visualisée via l'objet de campagne associé. Cependant, elle ne peut pas être modifiée ou déployée.
  • ICNameList : Cette propriété désigne les canaux interactifs dont les stratégies seront migrées ou restaurées. Il doit s'agir d'une liste de noms de canaux interactifs séparés par des virgules (,). Par exemple : ICNameList=WebIC1, WebIC2. Si les stratégies de tous les canaux interactifs doivent être migrées ou restaurées, utilisez un astérisque (*) comme valeur : ICNameList=*.
  • StrategyNameList : Cette propriété désigne les stratégies qui sont migrées ou restaurées. Il doit s'agir d'une liste de noms de noms de stratégies séparés par des virgules (,). Par exemple : StrategyNameList= WebStrategy1, WebStrategy2). Si les stratégies doivent être migrées ou restaurées, utilisez un astérisque (*) comme valeur : StrategyNameList=*.
    Remarque : ICNameList et StrategyNameList fonctionnent de concert pour déterminer quelles stratégies seront affectées. En d'autres termes, une stratégie spécifiée dans StrategyNameList doit exister dans un canal interactif spécifié dans ICNameList pour qu'elle puisse être migrée ou restaurée.

Procédure d'exécution de l'utilitaire pour la migration ou de restauration de la migration

Une fois les propriétés correctement définies, la migration ou la restauration de la stratégie peut être effectuée à l'aide des approches suivantes.
  • Exécution de l'utilitaire de migration de stratégie pour la migration de stratégie
    La migration de stratégie peut être effectuée en exécutant le fichier de chargement par lots autonome aciSmartStrategyUpgradeTool.bat ou le fichier de script shell aciSmartStrategyUpgradeTool.sh à partir du chemin <Installation_Directory>\Interact\interactDT\tools\upgrade.
    Remarque :
    • Si une stratégie est marquée pour un état de déploiement ou d'annulation du déploiement, elle est ignorée pendant que cet outil poursuit la migration pour les autres stratégies.
    • Si une stratégie est déjà migrée et que les utilisateurs exécutent l'outil de migration de stratégie pour la même stratégie, l'outil affiche le message d'erreur "The Strategy ID <strategyId> is already present in database and it is already migrated. Please use this migration tool to clean the new data and try again" ("L'ID de stratégie <strategyId> est déjà présent dans la base de données et est déjà migré. Veuillez utiliser cet outil de migration pour supprimer les nouvelles données et réessayer).
  • Exécution de l'utilitaire de migration de stratégie pour la restauration de la migration de stratégie
    Les utilisateurs peuvent restaurer la migration de la stratégie de la version 12.0 vers la version précédente en exécutant l'utilitaire de migration de stratégie. Les utilisateurs doivent exécuter la commande "aciSmartStrategyUpgradeTool.bat REVERT" ou "aciSmartStrategyUpgradeTool.sh REVERT" à partir de <Installation_Directory>\Interact\interactDT\tools \upgrade pour rétablir la migration.
    Remarque :
    • Si une stratégie est marquée pour un déploiement ou une annulation du déploiement, elle est ignorée et cet outil poursuit la restauration des autres stratégies.
    • Après avoir été restaurée, une stratégie s'affiche sur la page Résumé du canal interactif, mais n'est pas disponible sur l'interface utilisateur de la nouvelle stratégie. Elle pourra également être modifiée et être marquée pour un déploiement ou une annulation du déploiement.
    • Si les utilisateurs ont migré l'ancienne stratégie vers la stratégie dynamique et ajouté ou modifié la stratégie dynamique migrée à partir de la nouvelle interface utilisateur, les nouvelles règles ou les règles mises à jour ne seront pas disponibles après leur restauration.

Données de stratégie pour la migration

Le processus de migration des données de stratégie de la version précédente vers la version 12.1 actuelle copie les données des anciennes tables UACI_Rule/UACI_RuleGroup/UACI_Predicate dans les tables UACI_SmartRule/UACI_SmartRuleGroup/UACI_SmartRuleToRuleGroup.

La migration des données de stratégie de la version précédente vers la version 12.1 actuelle comprend la mise à niveau des données vers les tables UACI_SmartRule, UACI_SmartRuleGroup et UACI_SmartRuleToRuleGroup.

  • Migration de données dans la table UACI_SmartRule: Les données des tables UACI_Rule, UACI_ RuleGroup et UACI_Predicate sont migrées dans la table UACI_SmartRule. Les détails de la colonne de la migration de données depuis les tables UACI_Rule, UACI_ RuleGroup et UACI_Predicate dans la table UACI_SmartRule se présentent comme suit.
    • Les données de la table UACI_Rule sont migrées vers la table UACI_SmartRule. Les détails de la colonne de la migration de données depuis la table UACI_Rule vers la table UACI_SmartRule se présentent comme suit.
      Nom de la colonne existante de la table UACI_Rule Nom de la colonne migrée de la table UACI_SmartRule
      RuleId RuleId
      MarketWeight MarketWeight
      Désactivé Désactivé
      OfferID OfferID
      ZoneID ZoneID
      CreateDate CreateDate
      CreateBy CreateBy
      UpdateDate UpdateDate
      UpdateBy UpdateBy
      MaxScore MaxScore
      SuppressCount SuppressCount
    • Les données de la table UACI_RuleGroup sont migrées vers la table UACI_SmartRule. Les détails de la colonne de la migration de données depuis la table UACI_RuleGroup vers la table UACI_SmartRule se présentent comme suit.
      Nom de la colonne existante de la table UACI_RuleGroup Nom de la colonne migrée de la table UACI_SmartRule
      CellId CellId
      StrategyId StrategyId
      SegmentId SegmentId
      LearningMode LearningMode
      LearningModeId LearningModeId
    • Les données de la table UACI_Predicate seront migrées vers la table UACI_SmartRule. Les détails de la colonne de la migration de données depuis la table UACI_Predicate vers la table UACI_SmartRule se présentent comme suit.
      Nom de la colonne existante de la table UACI_Predicate Nom de la colonne migrée de la table UACI_SmartRule
      PredicateId EligibilityPredicateId, ScorePredicateId
      EnableStateID EligibilityPredicateEnabled, ScorePredicateEnabled
      La valeur d'EligibilityPredicateId, ScorePredicateId, EligibilityPredicateEnabled et ScorePredicateEnabled de la table UACI_SmartRule sera migrée sur la base de la condition suivante :
      Valeur de la colonne UACI_Predicate.EnableStateID Valeur de la colonne migrée de la table UACI_SmartRule
      2 UACI_SmartRule.EligibilityPredicateId = UACI_Predicate.PredicateId, EligibilityPredicateEnabled = 1, ScorePredicateEnabled = 0
      3 UACI_SmartRule.ScorePredicateId = UACI_Predicate. PredicateId, EligibilityPredicateEnabled = 0, ScorePredicateEnabled = 1
      1 EligibilityPredicateEnabled = 0, ScorePredicateEnabled = 0
      • Si UACI_Predicate.EnableStateID = 2, alors la valeur d'UACI_Predicate.PredicateId est migrée vers la valeur d'UACI_SmartRule.EligibilityPredicateId, et les valeurs d'EligibilityPredicateEnabled et de ScorePredicateEnabled seront respectivement définies sur 1 et 0.
      • Si UACI_Predicate.EnableStateID = 3, alors la valeur d'UACI_Predicate.PredicateId est migrée vers la valeur d'UACI_SmartRule.ScorePredicateId, et les valeurs d'EligibilityPredicateEnabled et de ScorePredicateEnabled seront respectivement définies sur 0 et 1.
      • Si UACI_Predicate.EnableStateID = 1, alors la valeur des deux colonnes EligibilityPredicateEnabled et ScorePredicateEnabled est définie sur 0. Nous conserverons la valeur par défaut 0 pour les colonnes EligibilityPredicateEnabled et ScorePredicateEnabled.
      Remarque : La valeur d'UACI_SmartRule.RuleName est migrée en tant que MigratedRule-< UACI_Rule .RuleId>. Les valeurs d'autres colonnes de la table UACI_SmartRule sont migrées en tant que valeurs par défaut.
  • Migration de données dans la table UACI_SmartRuleGroup : Les données de la table UACI_RuleGroup seront migrées dans la table UACI_SmartRuleGroup. Les détails de la colonne de la migration de données depuis la table UACI_RuleGroup vers la table UACI_SmartRuleGroup se présentent comme suit.
    Nom de la colonne existante de la table UACI_RuleGroup Nom de la colonne migrée de la table UACI_RuleGroup
    RuleGroupID RuleGroupID
    StrategyId StrategyId
    CreateDate CreateDate
    CreateBy CreateBy
    UpdateDate UpdateDate
    UpdateBy UpdateBy
    Remarque : La valeur d'UACI_SmartRuleGroup.RuleGroupName est migrée en tant que MigratedRuleGroup-< UACI_RuleGroup .RuleGroupID>. La valeur d'UACI_SmartRuleGroup.RuleGroupType est migrée en tant que valeur 1, ce qui indique la valeur "Normal" pour "ABTesting". Les valeurs de toutes les autres colonnes de la table UACI_SmartRuleGroup sont migrées conformément à leurs valeurs par défaut.
  • Migration de données dans la table UACI_SmartRuleToRuleGroup : Les données de la table UACI_Rule seront migrées dans la table UACI_SmartRuleToRuleGroup. Les détails de la colonne de la migration de données depuis la table UACI_Rule vers la table UACI_SmartRuleToRuleGroup se présentent comme suit.
    Nom de la colonne existante de la table UACI_Rule Nom de la colonne migrée de la table UACI_SmartRuleToRuleGroup
    RuleID RuleID
    RuleGroupID RuleGroupID

Données de stratégie pour la restauration de la migration

Si les utilisateurs exécutent l'utilitaire de migration de stratégie pour la restauration de la migration de stratégies dynamiques introduites dans la version 12.0 vers une version antérieure, toutes les données des règles ou des groupes de règles de la stratégie dynamique migrée provenant des tables UACI_SmartRule ou UACI_SmartRuleGroup /UACI_SmartRuleToRuleGroup seront supprimées.