Regras

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

    • Saiba como criar e gerenciar regras para oferecer experiências de configuração dinâmicas. Defina condições e ações para mostrar ou ocultar campos, exibir mensagens, calcular valores e gerar listas de materiais (BOMs). Explorar tipos de regra, incluindo visibilidade, mensagem, inclusão, exclusão, determinação e ações do produto para criar configurações inteligentes e responsivas com eficiência.

    À medida que o usuário final navega pela experiência de configuração e preenche as informações, as regras fornecem seus elementos dinâmicos: Ocultar e mostrar conteúdo, calcular valores, entregar recomendações e mensagens e criar a lista de materiais (BOM).

    Com foco na administração de regras na interface do usuário de administração, este artigo discute os dois componentes de regras, condições e ações e os seis tipos de ação disponíveis em CPQ. Assim como outros elementos na aplicação, a IU é um bom lugar para adicionar ou editar pequenos números de regras. Quando muitas regras precisarem de manipulação, recomendamos usar o Carregador de matriz. Para obter mais informações, consulte Carregador de matriz: Carregamento de regras CSV.

    Na IU de administração, as regras podem ser acessadas de duas maneiras:

    • Regras globais: No painel de navegação, clique em Regras . A página de administração da lista de regras exibe todas as regras definidas no ambiente. Se a sua tarefa for adicionar novas regras, este será o único local na IU do administrador onde você pode iniciar uma nova regra.
    • Regras associadas a um único blueprint: Clique Planos gráficos e clique em um blueprint. Clique na guia Regras para exibir as regras. Clique em uma regra para abri-la.

    Condições

    CPQ as condições de regra consistem em uma expressão lógica. No tempo de execução, o mecanismo de regras executa a regra se a expressão for avaliada como verdadeira.

    O administrador pode definir vários tipos de condições:

    • Qualquer condição é atendida: Ou as expressões lógicas definidas.
    • Todas as condições são atendidas: E as expressões lógicas definidas.
    • Sempre (Mudança de entrada de ação): Executa a regra sempre que o usuário final altera uma entrada relevante.
    • A lógica personalizada foi atendida: Permite que o administrador defina a lógica personalizada, incluindo ANDs e ORs, entre expressões.
    • Função avançada: Permite que o administrador grave um script para definir a condição da regra.

    Ações

    A seção Ações de uma regra define as tarefas que a regra realiza quando é executada (quando sua condição é avaliada como verdadeira). CPQ, ao contrário de outros mecanismos, permite várias ações e tipos de ação em uma condição. Este é um recurso organizacional útil que consolida todas as tarefas que precisam ser executadas no mesmo cenário em uma regra. A consolidação de várias tarefas com uma condição também aumenta a eficiência com a qual o mecanismo de regras avalia e realiza tarefas. O aumento da eficiência se traduz em desempenho que o usuário final pode ver.

    Na página de administração de regras, revise a seção Ações localizada abaixo da área de resumo e condições.

    • Lista de ações: Ações definidas nesta regra. A entrada de filtro permite encontrar ação(ões) rapidamente, especialmente quando muitas ações são definidas.
    • Painel do editor de ações: Permite que o administrador revise e edite a ação selecionada na lista de ações.
    • Botão Adicionar nova ação: Defina uma nova ação para esta regra. Seis tipos de ação disponíveis são exibidos no painel do editor de ações.

    Ocultando ações

    Ocultar ações oculta um campo inteiro da exibição para o usuário final. Use ações de ocultação para concentrar a atenção do usuário final, apresentando somente os campos relevantes para a solução que está sendo configurada. Um campo oculto mantém seu valor.

    Ações de mensagem

    As ações de mensagem fornecem informações contextuais à medida que o usuário final trabalha na configuração. A mensagem está localizada em relação a um campo designado no layout. Há quatro tipos de mensagem disponíveis.

    Tabela 1. Ações de mensagem
    Tipo de mensagem Exemplo Anotações
    Informações mensagem informativa Nenhum efeito na experiência de configuração além da mensagem
    Aviso mensagem de aviso Nenhum efeito na experiência de configuração além da mensagem
    Erro mensagem de erro Desabilita o botão Cotação para que o usuário não possa avançar até que o estado de erro seja aliviado.
    Personalizado A aparência é determinada pelo usuário O usuário pode controlar se isso não tem efeito na experiência de configuração além da mensagem de se desabilita o botão Cotação para que o usuário não possa avançar até que o estado de erro seja aliviado.

    Ações de inclusão/exclusão

    Controle as opções de campo da lista de seleção usando ações de inclusão e exclusão. Os dois tipos de ação permitem que o administrador defina o conjunto de opções de campo da maneira mais conveniente possível. As regras de inclusão e exclusão podem operar no mesmo campo de lista de seleção. Para uma lista de seleção, as opções exibidas são determinadas da seguinte forma:

    1. As regras de inclusão são aplicadas ao conjunto de opções definidas no campo da lista de seleção. Se nenhuma regra de inclusão for definida para o campo, todas as opções da lista de seleção continuarão após esta etapa. O resultado desta etapa é o conjunto incluído de opções da lista de seleção.
    2. O conjunto incluído é então avaliado em relação a todas as regras de exclusão aplicáveis. O resultado é o "exibido setʼ de opções.

    As opções da lista de seleção que são eliminadas como resultado de ações de inclusão/exclusão podem ser removidas ou desabilitadas no menu da lista de seleção de opções visíveis para o usuário final.

    Durante o tempo de execução, se uma opção de lista de seleção for selecionada (por um usuário final ou por meio de uma ação de determinação), mas as regras de inclusão/exclusão determinarem posteriormente que é uma opção inválida, os usuários poderão especificar o que acontecerá se as opções selecionadas no momento forem excluídas. O usuário pode optar por deixar as seleções inalteradas, desmarcar as seleções ou desmarcar as seleções e, em seguida, selecionar a primeira opção válida. O botão Cotação fica desabilitado até que o usuário final corrija esse estado de erro.

    Ações de determinação

    Uma ação de determinação define programaticamente o valor de um campo. O administrador pode escolher se o valor determinado é soft-set ou somente leitura (forceset).

    Se um usuário final mudar o valor de um campo que foi definido temporariamente por uma regra de determinação, CPQ exibe uma mensagem para o usuário lembrando-o do valor recomendado. A mensagem não limita o usuário de citar a configuração; é apenas informativa. Se o usuário reverter o valor do campo para o valor de Determinação recomendada, a mensagem desaparecerá. O administrador pode optar por não exibir esta mensagem.

    Ações do produto

    As ações do produto resultam em adições à lista de materiais (BOM). Quando o Tipo de BOM é definido como Vendas, uma ação de produto simples exibe o produto para o usuário como uma linha no carrinho de compras. Esses itens da BOM de vendas são transferidos para o editor de linha de cotação do Salesforce (SFDC QLE) quando a configuração é cotada. Se o Tipo de BOM estiver definido como Fabricação, os administradores geralmente não mostrarão essas linhas para os usuários finais no carrinho de compras. Os itens da BOM de fabricação, no entanto, são registrados e transferidos para o objeto de item de linha de configuração do SFDC para comunicação com ERP e aplicações de provisionamento downstream.

    Tabela 2. Entradas
    Entrada Anotações
    Produto

    Quando Tipo de BOM é Vendas, o valor em Produto pode ser um ID do produto SFDC de 15-18 dígitos com o formato 01t5f0000001tElAAI. CPQ Extrai o código do produto, a descrição e o preço do registro do produto do SFDC ou do código do produto do SFDC ou do ID externo, dependendo das configurações do campo ID do produto do ambiente.

    Quando Tipo de BOM for Fabricação, quatro opções estão disponíveis:
    • SFDC Product2 ID>
    • Código do produto do SFDC Product2>
    • Identificador externo
    • Uma cadeia de caracteres válida composta de letras, números, espaços e os seguintes caracteres especiais: ();:/.-, ʼ&%"!
    Quantidade <positive integer>
    Tipo DE BOM

    Vendas: Exibir no carrinho de compras. A cotação envia o item para os objetos QLE do SFDC e Itens de linha de configuração.

    Fabricação: Geralmente não mostrado ao usuário final. A cotação envia o item para o objeto Itens de linha de configuração do SFDC.

    Todos: Todos os tipos de BOM são exibidos no carrinho de compras. A cotação envia os itens de vendas e fabricação para o objeto Itens de linha de configuração e Vendas para o objeto QLE do SFDC.
    Obrigatório(a)

    VERDADEIRO: O usuário final não pode excluir o item do carrinho de compras.

    FALSO: O usuário final tem permissão para excluir o item do carrinho de compras.

    Ações avançadas do produto

    Se o seu caso de uso exigir listas de materiais multiníveis (BOMs), definir uma quantidade dinâmica ou atribuição de produto além da disponível em ações de produto simples, uma ação de produto avançada será necessária. A ação avançada do produto permite que você grave um script que gera registros para o objeto ProductList.

    A matriz a seguir descreve as atribuições de ProductList disponíveis.

    Tabela 3. Atribuições da ProductList
    ProductList.<param> ReqOpt Valores válidos Anotações
    BomType R Vendas, Fabricação, Todos Em casos de uso integrados ao Salesforce, os itens de fabricação são gravados somente em LGK__Configurat ionLineItem__c; os itens de vendas são gravados em QLE e LGK__Configurat ionLineItem__c.
    descrição O <text>
    estendido O <JSON object> que consiste em pares key : value (consulte a observação 1) Se preenchidas, essas informações serão transferidas para LGK_Extended_I nformation__c no objeto Item de linha de configuração no Salesforce, depois que o usuário clicar no botão Cotar
    id R Quando o caso de uso integrado ao SF E bomType são Vendas...
    Product2.ID, Product2.ProductCode ou ID externo Consulte a nota 2
    Quando Headless/eCommerce E bomType são Vendas...
    ProductId ou ProductCode Consulte a nota 2
    Quando SF-integrated E bomType são Manufatura...

    <text>, Product2.ID, Product2.ProductCode ou ID externo

    		 Os administradores podem adicionar itens não armazenados no produto2. Se fizer referência a registros armazenados no Produto2, a observação 2 se aplica
    Quando Headless/eCommerce E bomType são Manufatura...
    <text>, productId ou ProductCode Os administradores podem adicionar itens não armazenados no objeto Produto. Se fizer referência a registros armazenados no Produto, a observação 2 se aplica
    nível O <integer> Opcional; para referência do administrador; não orienta a lógica do app
    Anotações O <text>
    Número do pedido O <integer>

    Preencha este parâmetro com valores numéricos que determinam o número de sequência de linhas. Observação: O objeto ProductList é preenchido por todas as ações de produto que são acionadas no blueprint. Limitado a 28 dígitos.
    Produto parent O <text>

    Se preenchido, deve corresponder ao uniqueIdentifier da linha primária. Em casos de uso integrados ao SF, o principal parenteProduct é o Produto configurável. Defina este valor como Product2.Id ou Product2.ProductCode do Produto configurável.
    preço O <float> Zero e negativo permitidos. Se não atribuído, CPQ recupera o preço base do produto principal.
    qtd O <float> Zero e negativo permitidos. Se não atribuído, o padrão é 1.
    SeleçãoType O Opcional Se não for preenchido, o padrão será Obrigatório
    Identificador único R <unique text> Cadeia de caracteres que identifica exclusivamente esta linha de outras nesta sessão de configuração (consulte a seção Atributo Identificador exclusivo abaixo)
    uom O <text> Unidade de medida
    Nota:
    1. O parâmetro ProductList.extended pode aceitar um objeto JSON superficial. Exemplo: - "val1", "key2": "val2" Além disso, o administrador pode definir os pares de chave estendida: Valor para um registro ProductList usando JavaScript. Exemplos: ProductList.extended["key"]: "val"; ProductList.extended.key: "val";
    2. Para simplificar a migração de dados de produto entre ambientes de teste e produção, especialmente em ambientes integrados ao SF, os administradores podem solicitar que ações de produto façam referência a um ProductCode ou ID externo em vez de productId. Em CPQ Administrador, vá para o menu Utilitários no painel de navegação e clique em Configurações . Em seguida, você pode definir o campo ID do produto como Código do produto, ID do parceiro ou ID externo. Se considerar migrar de productId para ProductCode após a ativação, você deve coordenar a mudança de configuração com os valores referenciados em suas Ações de produto e as ações de produto implícitas em todos os dados de extensão da lista de seleção definidos.

    Atributo de identificador exclusivo

    CPQ passa o identificador exclusivo de um produto em CPQ Para o campo ID de linha exclusivo na linha de cotação no Salesforce, permitindo que os usuários atribuam IDs exclusivos a linhas de cotação específicas do Salesforce.

    Ao usar os atributos parentProduct e uniqueIdentifier para a hierarquia de produtos, se dois produtos secundários tiverem o mesmo produto primário e ID de produto, mas precisarem ser exibidos separadamente na BOM, cada um exigirá um "uniqueIdentifier" exclusivo. Isso garante que a IU os trate como produtos exclusivos ao listá-los.

    Consulte o script de amostra a seguir para observar como a hierarquia de itens, a diferenciação de itens primários por meio de uniqueIdentifier, bomTypes e a iteração por meio de registros ProductList podem funcionar: Ação do produto avançado: Amostra de BOM hierárquica .