Migre um blueprint de ambiente para ambiente

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 3 min. de leitura

    • Migrar blueprints entre CPQ para garantir uma gestão de configuração consistente. Exporte, atualize e importe pacotes de blueprint com segurança usando o carregador de matriz para promover configurações testadas do desenvolvimento à produção.

    Antes de Iniciar

    Entender CPQ janelas de upgrade, descritas em CPQ Programação de upgrade. Agende sua migração para evitar janelas de upgrade publicadas. Em caso de dúvidas sobre este tópico, entre em contato com o gerente de sucesso do cliente.

    Os seguintes termos são usados nesta tarefa:

    Origem
    O ambiente do qual a funcionalidade é migrada.
    Destino
    O ambiente para o qual a funcionalidade é migrada.
    Pacote de migração
    O arquivo ou arquivos exportados do ambiente de origem a serem importados para o ambiente de destino.

    Esta tarefa presume que a migração seja realizada em um ou mais blueprints de cada vez.

    Função necessária: (Desconhecida)

    Procedimento

    1. Exporte o blueprint da origem.
      1. No ambiente de origem, selecione o blueprint que você deseja mover clicando na caixa de seleção ao lado de seu nome.Bleprints
      2. Clique em Exportar.Exporte blueprint
        Observe as notificações no ícone de sino localizado no canto inferior esquerdo. A primeira notificação indica que o processo de exportação foi iniciado. Após a conclusão da exportação, uma segunda notificação indica que o blueprint está pronto para download.
      3. Para baixar o blueprint, clique em Download no menu de ícone de sino.Download do plano gráfico
      4. Salve o blueprint em sua máquina local ou em um repositório central, como Git.
      5. Se o seu ambiente estiver integrado ao Salesforce e você estiver migrando o blueprint pela primeira vez, confirme os pré-requisitos e execute a etapa 1 em Migre um blueprint para um destino integrado ao SFDC.
    2. Modifique o pacote de migração.
      1. Descompacte o arquivo ZIP do blueprint baixado na etapa 1.
        O arquivo é descompactado em um arquivo blueprint.yaml.

        seleção de arquivo blueprint.yaml

      2. Abra o arquivo blueprint.yaml em um editor de texto.

        Ao migrar um blueprint para um destino no qual reside uma versão anterior do blueprint, recomendamos adicionar a seguinte linha à parte inferior do arquivo:

        fullBlueprintMigration: true

        Arquivo blueprint.yaml editado:

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

        Para obter uma descrição de como este parâmetro afeta a migração do blueprint, consulte O parâmetro fullBlueprintMigration.

      3. Se o seu ambiente estiver integrado ao Salesforce e você estiver migrando o blueprint pela primeira vez, execute a etapa 2 em Migre um blueprint para um destino integrado ao SFDC.
      4. Salve suas edições e feche o arquivo blueprint.yaml.
    3. Compacte todos os componentes do pacote de migração (incluindo blueprint.yaml, a pasta blueprints, a pasta fields, a pasta rules e quaisquer outros artefatos que possam estar presentes no pacote de migração, mas não na pasta primária) em um novo arquivo ZIP.Download do plano gráfico
      Importante:
      Ao compactar, certifique-se de selecionar somente o conteúdo da exportação de blueprint descompactado, e não a pasta primária em si. Se a pasta primária for selecionada, você receberá um erro ao carregá-la no CPQ Admin

      Logs de importação

    4. Migre componentes relacionados ao blueprint que você está migrando (por exemplo, tabelas gerenciadas e conexões externas usadas pelo blueprint) para o locatário de produção.
    5. Importe o blueprint para o destino.
      1. Faça login na área de administração do CPQ ambiente de destino.
      2. Abra o Carregador de matriz.
      3. Arraste o arquivo ZIP do pacote de migração editado para a área suspensa do Carregador de matriz.
      4. Clique em Próximo e clique em Importação .
      Se você encontrar erros após a importação, siga as instruções na tela para revisar os logs de erros.
    6. Teste a migração.
      1. Se o seu ambiente estiver integrado ao Salesforce e você estiver migrando o blueprint pela primeira vez, execute as etapas 3 e 4 em Migre um blueprint para um destino integrado ao SFDC.
      2. Revise seu blueprint migrado da IU do usuário final no destino CPQ ambiente.