Carregador de matriz: Carregamento de regras CSV

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

    • Use o Carregador de matriz para criar, editar e exportar regras em massa no CPQ. Defina condições de regra, ações e lógica em um arquivo CSV para simplificar a gestão de configurações e automatizar atualizações em grande escala.

    O Carregador de matriz permite que os administradores carreguem e gerenciem com eficiência todos os tipos de regra no CPQ. Em vez de criar manualmente cada regra na interface do administrador, você pode defini-las em uma planilha, exportar a planilha para o formato CSV e carregá-la diretamente no ambiente. Isso permite uma configuração mais rápida, testes mais fáceis e migração simplificada entre ambientes de área restrita e de produção.

    Estrutura de carregamento de regras

    Cada linha no arquivo CSV representa um registro de regra. A tabela a seguir descreve as colunas e os dados que o Carregador de matriz aceita para carregamentos de regra.

    Tabela 1. Dados e colunas aceitas para carregamentos de regra
    Nome da Coluna Descrição Valores válidos Anotações
    record_type Identifica isso como um carregamento de regra regra Necessários
    rule_name Nome exibido na página do administrador da lista de regras As cadeias de caracteres válidas podem ser compostas por até 255 caracteres, incluindo letras, números, espaços e os seguintes caracteres especiais: ()():/.-,*"&%"! Necessários
    rule_variable_name Cadeia de caracteres exclusiva usada por CPQ para fazer referência à regra Os nomes de variáveis de campo válidos consistem em até 128 letras, números e sublinhados. O primeiro e o último caractere devem ser uma letra ou um número. Necessário; deve ser exclusivo
    rule_description Descrição contextual para referência do administrador As cadeias de caracteres válidas podem ser compostas por até 255 caracteres, incluindo letras, números, espaços e os seguintes caracteres especiais: ()():/.-,*"&%"! Opcional
    rule_status Determina se a regra está ativa ativo, inativo Necessário; regras inativas são ignoradas pelo mecanismo
    action_type Define o tipo de ação executada quando a regra é executada visibilidade, mensagem, exclusão, inclusão, determinação, produto Necessários
    action_sub_type Aumento de definição suplementar action_type ocultar, informações, aviso, erro, oculto, desabilitado, definir, forceset, fabricação, vendas Opcional; depende de action_type
    action_field Campo ao qual a ação se aplica <field variableName> Necessários
    action_value Valor aplicado a action_field Varia de acordo com o tipo de ação Necessário para ações de mensagem, exclusão, inclusão ou determinação
    action_product Referência do produto para ações da lista de materiais (BOM) Código do produto SFDC, ID do produto2 ou ID externo Necessário para ações do produto
    action_quantity Quantidade do produto adicionada à BOM <positive float> ou <positive integer> Necessário para ações do produto
    action_mandatory Especifica se um produto da BOM é opcional ou obrigatório VERDADEIRO, FALSO, <empty> Opcional; o padrão é VERDADEIRO
    agrupamento Define como as condições são agrupadas e avaliadas qualquer, tudo, personalizado, sempre Necessários
    recurso/operador/valor Define as tuplas de condição que formam a lógica de regra <field variableName>, operador, valor O recurso, o operador e o valor juntos definem a expressão de condição

    Agrupamentos de condições

    Os agrupamentos de condições determinam como as condições de regra são combinadas logicamente. As opções compatíveis incluem:
    • Qualquer: Ou todas as condições definidas na linha.
    • Todas: E todas as condições definidas na linha.
    • Personalizado: Permite expressões lógicas complexas, como (1 OU 2) E 3.
    • Sempre: Aplica a regra incondicionalmente.

    Operadores válidos

    Os seguintes operadores são compatíveis com a avaliação de condição:
    • igual (igual a)
    • não é igual a (!)
    • menor que
    • menor ou igual a
    • maior que (>)
    • maior que ou igual (>)
    • contém/não contém
    • em / não em

    Diretrizes gerais

    • Sempre verifique se os nomes das variáveis correspondem exatamente às referências do campo.
    • Mantenha as descrições da regra concisas, mas descritivas, para ajudar na solução de problemas.
    • Use o status inativo para testar novas regras antes de habilitar na produção.
    • Valide a lógica de agrupamento (qualquer/todos/personalizado) cuidadosamente para evitar resultados não intencionais.
    • Certifique-se de que as referências do produto (ID do Product2 ou ID externo) estejam alinhadas com a configuração do Salesforce.

    Exportando regras para CSV

    Os administradores podem exportar todas as definições de regra do CPQ Formato CSV para revisão ou migração. O arquivo ZIP resultante contém um único arquivo CSV de todas as definições de regra exportadas.
    1. No painel de navegação do administrador esquerdo, clique em Regras .
    2. Opcional: Insira uma cadeia de caracteres de pesquisa e pressione Enter para restringir os resultados.
    3. Clique em Exportar. Uma mensagem confirmando a exportação aparece na parte inferior da página.
    4. Abra a Central de notificações (parte inferior esquerda) e clique em Download link.

    Informações adicionais

    • As cadeias de caracteres válidas podem incluir letras, números, espaços e caracteres especiais: ( ) | : / . - , * ' E % número "
    • Os nomes de variáveis de regra podem conter até 255 caracteres alfanuméricos e sublinhados. Eles devem começar e terminar com uma letra ou um número.
    • As células com planos de fundo cinza nos arquivos de amostra denotam campos irrelevantes para o contexto atual.
    • Use os arquivos de amostra fornecidos (Administrador → Carregador de matriz → Arquivos de amostra → Regras) como um modelo para formatação.