Listas de seleção e extensões de lista de seleção em regras

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 4 min. de leitura
  • Saiba como usar extensões de lista de seleção (ples) de forma eficaz em regras. Entenda como a filtragem, inclusão e exclusão interagem e aplique operadores corretos, como Igual e Contém, para listas de seleção única e múltipla para garantir o comportamento preciso da regra em configurações avançadas.

    As extensões da lista de seleção (ples) são uma maneira poderosa para os administradores exibirem o máximo de informações possível sobre um produto, facilitando a seleção exata do que os usuários finais desejam. No entanto, a simplicidade no front-end pode mascarar a complexidade no back-end Este artigo mostra aos administradores como usar corretamente ples em regras e funções avançadas e explica algumas advertências importantes.

    Nota:
    • Primeiro, tente usar Opções de filtro e Informações do produto.
    • Não use regras de inclusão para ples. A filtragem de PLE funciona como regras de inclusão, portanto, para remover outras opções, o usuário deve usar regras de exclusão.
    • Contém e. Igual a agir de forma diferente nas listas de seleção de seleção múltipla. Array.includes() e. . também aja de forma diferente.

    Regras simples

    É melhor não usar regras com extensões de lista de seleção. Os ples foram projetados para que você possa filtrar opções e enviar dados para a lista de materiais sem escrever regras. Portanto, a maioria dos motivos para usar regras de inclusão, exclusão e produto não está presente em ples. Certifique-se de que seu caso de uso não possa ser concluído com recursos típicos de PLE antes de continuar a criar suas regras.

    Se você estiver usando seleções em um PLE para conduzir ações, certifique-se de observar a diferença entre os operadores Equals e Contém.

    • Igual verifica se a seleção no PLE corresponde exatamente ao valor da condição.
      • Ele pode ser usado com listas de seleção de seleção única e múltipla, mas é recomendável usá-lo com ples de seleção única, pois é o mais próximo do que os usuários geralmente imaginam que a funcionalidade seria.
      • Se você estiver usando uma seleção múltipla na condição, se o usuário fizer várias seleções, a condição não será atendida se estiver usando Igual.
    • Verifica se a seleção no PLE inclui o valor descrito. Este é o operador recomendado para campos PLE de seleção múltipla.

    Por exemplo: Um usuário cria um campo de lista de seleção de seleção múltipla com quatro opções.

    Listas de seleção e extensões de lista de seleção em regras

    Suponha que a condição de uma regra (neste caso, uma ação de determinação) esteja definida como acionada se o campo de seleção múltipla for igual a opção múltipla 4.

    Listas de seleção e extensões de lista de seleção em regras

    Se o usuário final selecionar somente a opção múltipla 4, a regra será acionada:

    Listas de seleção e extensões de lista de seleção em regras

    Se o usuário final selecionar a opção múltipla 3 e a opção múltipla 4, a regra não será acionada:

    Listas de seleção e extensões de lista de seleção em regras

    Por outro lado, se a condição estiver definida como Disparar se o campo de seleção múltipla contiver a opção 4, ela será acionada em ambas as instâncias.

    Listas de seleção e extensões de lista de seleção em regras

    Listas de seleção e extensões de lista de seleção em regras

    Listas de seleção e extensões de lista de seleção em regras

    Como os filtros de PLE interagem com as regras de exclusão

    Os filtros de extensão da lista de seleção agem da mesma forma que as regras de inclusão simples funcionam, exceto que quando os campos de filtro definidos estão vazios, nenhuma opção é incluída em vez de todas as opções quando uma regra de inclusão simples não está sendo acionada.

    Se você quiser ter um campo que não esteja definido como um filtro no PLE e que limite as opções no seu campo PLE, precisará usar uma regra de exclusão simples para limitar ainda mais essas opções de campo, já que o uso de uma regra de inclusão combinaria com a inclusão inerente contida no filtro PLE e deixaria todas as opções de campo disponíveis.

    Nota:
    Devido à natureza do mapeamento das informações estendidas por meio de campos de filtro, o uso de uma regra de inclusão para mostrar mais opções para um PLE mostrará somente o valor da opção e nenhum dado adicional. Não use regras de inclusão que atuem nas opções de um PLE.

    Regras avançadas

    Ao usar listas de seleção em regras avançadas, é importante saber como esses campos aparecem quando referenciados usando o. cfg objeto. Para listas de seleção única, o campo tem o texto da opção, mas para listas de seleção múltipla, elas estarão em uma matriz. Muitas vezes, essa diferença pode levar a discrepâncias ao criar funções avançadas.

    Semelhante às diferenças em condições simples entre iguais e contém, enquanto as listas de seleção de seleção única podem ser referenciadas em uma declaração "if" como:

    1 if (cfg.field == "option") {
    2 //code
    3 }

    As listas de seleção de seleção múltipla devem usar a função "Array.includes()” para ver se uma das opções foi selecionada:

    1 if (cfg.field.includes("option")) {
    2 //code
    3 }

    Esta função atua em uma matriz e retornará verdadeiro ou falso, dependendo se a matriz inclui o valor inserido.

    Para determinar as seleções de uma lista de seleção de seleção múltipla em uma função avançada, use .push() para adicionar a opção. A adição de uma opção que não está definida nos campos da lista de seleção resulta em um erro.

    Para outras manipulações com a matriz de lista de seleção de seleção múltipla em funções avançadas, consulte as Funções de matriz do menu Ajuda. Se houver ações conflitantes de inclusão e exclusão, as ações de exclusão terão precedência.

    Leitura adicional

    Para obter uma visão geral do recurso de extensão da lista de seleção, consulte Extensões da lista de seleção.

    Para uma compreensão mais profunda do back-end e como exibir ples, consulte Exibindo uma extensão de lista de seleção em um layout.

    Para obter uma visão geral do recurso de aprimoramento de preços de extensão da lista de seleção, consulte O aprimoramento de preços da extensão da lista de seleção.