Migrer un plan d’un environnement à l’autre

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • Migrez les plans entre CPQ les environnements pour assurer une gestion cohérente des configurations. Exportez, mettez à jour et importez des packages de plans en toute sécurité à l’aide du chargeur de matrice pour promouvoir les configurations testées du développement à la production.

    Avant de commencer

    Comprendre les CPQ fenêtres de mise à niveau, décrites dans .CPQ Mettre à niveau le calendrier Planifiez votre migration pour éviter les fenêtres de mise à niveau publiées. Si vous avez des questions à ce sujet, contactez votre Customer Success Manager.

    Les termes suivants sont utilisés dans cette tâche :

    Source
    Environnement à partir duquel la fonctionnalité est migrée.
    Destination
    Environnement vers lequel la fonctionnalité est migrée.
    Package de migration
    Le ou les fichiers exportés de l’environnement source à importer vers l’environnement de destination.

    Cette tâche suppose que la migration est effectuée sur un ou plusieurs plans à la fois.

    Rôle requis : (inconnu)

    Procédure

    1. Exportez le plan à partir de la source.
      1. Dans l’environnement source, sélectionnez le plan à déplacer en cochant la case en regard de son nom.Impressions
      2. Cliquez sur Exporter.Exporter le plan
        Surveillez les notifications sur l’icône en forme de cloche située dans le coin inférieur gauche. La première notification indique que le processus d’exportation a démarré. Une fois l’exportation terminée, une deuxième notification indique que le plan est prêt à être téléchargé.
      3. Pour télécharger le plan, cliquez sur le lien Télécharger dans le menu de l’icône en forme de cloche.Télécharger le plan
      4. Enregistrez le plan sur votre ordinateur local ou dans un référentiel central tel que Git.
      5. Si votre environnement est intégré à Salesforce et que vous migrez le plan pour la première fois, confirmez les conditions préalables et effectuez l’étape 1 dans Migrer un plan vers une destination intégrée SFDC.
    2. Modifiez le package de migration.
      1. Décompressez le fichier ZIP du plan que vous avez téléchargé à l’étape 1.
        Le fichier se décompresse dans un fichier blueprint.yaml.

        Sélection de fichier blueprint.yaml

      2. Ouvrez le fichier blueprint.yaml dans un éditeur de texte.

        Lors de la migration d’un plan vers une destination dans laquelle réside une version antérieure du plan, nous vous recommandons d’ajouter la ligne suivante au bas du fichier :

        fullBlueprintMigration: true

        Exemple de fichier blueprint.yaml modifié :

        ---
blueprints:
- variableName: someBlueprint
  related Fields:
  - field1
  - field2
  - field3
  lastModifiedBy: dev5@dev.logik.io
  name: someBlueprintName
  description: BP description goes here
  relatedSets: null
  scripts: null
  layouts: null
  products: null
productPickers: /fields/productPickers.yaml
sets: null
fieldOptions: /fields/fieldOptions.csv
rules: /rules/rules.csv
fields: /fields/fields.csv
fullBlueprintMigration: true

        Pour obtenir une description de la façon dont ce paramètre affecte la migration du plan, reportez-vous à la section Le paramètre fullBlueprintMigration.

      3. Si votre environnement est intégré à Salesforce et que vous migrez le plan pour la première fois, effectuez l’étape 2 dans Migrer un plan vers une destination intégrée SFDC.
      4. Enregistrez vos modifications et fermez le fichier blueprint.yaml.
    3. Compressez tous les composants du package de migration (y compris blueprint.yaml, le dossier blueprints, le dossier fields, le dossier rules et tous les autres artefacts qui ont pu être présents dans le package de migration, mais pas le dossier parent) vers un nouveau fichier ZIP.Télécharger le plan
      Important :
      Lors de la compression, assurez-vous de sélectionner uniquement le contenu de l’exportation de plan décompressé, et non le dossier parent lui-même. Si le dossier parent est sélectionné, vous recevrez une erreur lorsque vous le chargerez dans l’administrateur CPQ .

      Journaux d’importation

    4. Migrez les composants associés au plan que vous migrez (par exemple, les tables gérées et les connexions externes utilisées par le plan) vers le locataire de production.
    5. Importez le plan vers la destination.
      1. Connectez-vous à la zone d’administration de l’environnement CPQ de destination.
      2. Ouvrez le chargeur de matrice.
      3. Faites glisser le fichier ZIP du package de migration modifié dans la zone de dépôt du chargeur de matrice.
      4. Cliquez sur Suivant, puis sur Importer.
      Si vous rencontrez des erreurs après l’importation, suivez les instructions à l’écran pour consulter les journaux d’erreurs.
    6. Testez la migration.
      1. Si votre environnement est intégré à Salesforce et que vous migrez le plan pour la première fois, effectuez les étapes 3 et 4 dans Migrer un plan vers une destination intégrée SFDC.
      2. Examinez votre plan migré à partir de l’interface utilisateur de l’utilisateur final dans l’environnement de destination CPQ .