Conjuntos

Saiba como os conjuntos organizam grupos de campos repetíveis, simplificam configurações complexas e permitem a agregação de dados entre elementos repetidos em CPQ.

Um conjunto é uma coleção reutilizável e repetível de campos que permite que os administradores definam várias instâncias de dados de configuração semelhantes, como vários produtos, componentes ou opções, em um único blueprint.

Cada linha em um conjunto representa uma instância de um grupo repetido de campos, e cada campo nessa linha se comporta de forma independente. os conjuntos simplificam o design de configuração, reduzem a duplicação e oferecem suporte a casos de uso avançados que exigem entradas tabulares ou baseadas em lista.

Os administradores usam conjuntos para apresentar opções de configuração em layouts estruturados semelhantes a tabelas que os clientes podem editar facilmente na interface do usuário final.

Os conjuntos foram projetados para:

• Simplifique as configurações repetíveis. Em vez de criar vários campos e regras para cada repetição, defina uma vez e reutilize muitas vezes.
• Forneça entrada de dados tabulares e intuitiva. Os usuários finais podem adicionar, remover ou editar várias instâncias de produto em uma grade estruturada.
• Suporte a regras dinâmicas. As regras podem fazer referência a valores na mesma linha ou agregar dados em todas as linhas.
• Ative relatórios e resumos avançados. Os agregados resumem os valores de campo nas linhas (por exemplo, quantidade total ou total de unidades de rack).

Como os conjuntos funcionam

Um conjunto agrupa vários campos de configuração e repete esse grupo para cada item na lista.

Cada linha definida é totalmente independente:

• Os campos na mesma linha podem afetar outros campos nessa linha.
• Os campos em uma linha não podem afetar diretamente os campos em outra linha.
• Campos fora de um conjunto podem influenciar campos dentro dele, mas não vice-versa.

Para afetar campos fora de um conjunto, use:

• Valores: Soma, contagem, média, máximo ou mínimo em todas as linhas.
• Regras do produto: Defina a lógica que define valores de campo externo com base nos dados definidos.

Um conjunto pode conter até 2 000 linhas.

Opções de exibição

Os conjuntos podem aparecer na IU em vários formatos, dependendo dos requisitos de experiência do usuário:

Tabela 1. Opções de exibição para conjuntos

Tipo de exibição	Descrição	Caso de uso de exemplo
Tabela	Linhas, colunas e células com cabeçalhos; ideal para comparações detalhadas.	Configure vários dispositivos de rede.
Lista	Cada linha mostrada como um cartão; pode suportar seleção única ou múltipla.	Selecione slots de entrega ou pacotes de serviço.
Repetidor	Exibe um registro de cada vez com controles de navegação.	Edite configurações uma a uma em layouts menores.

Os administradores controlam o layout, o alinhamento e a rolagem no editor de layout.

Relacionamentos de campo

Relacionamento	Comportamento
Dentro → dentro	Os campos na mesma linha podem acionar uns aos outros por meio de regras.
Dentro → Fora	Não permitido diretamente; use agregados ou regras de produto.
Fora → dentro	Permitido. Ações de campo ou regras fora de um conjunto podem mudar os valores do campo definido.

Propriedades da chave

Os conjuntos incluem várias categorias de configuração que moldam como os usuários interagem com a tabela ou lista:

• Configurações gerais: Orientação, altura máxima, alinhamento, rótulos de índice.
• Tipo de exibição: Escolha entre as exibições Tabela e Lista.
• Configurações em linha: Mostre indicadores "Adicionar linha", controles suspensos ou ações de passar o mouse.
• Configurações de tamanho: Gerencie como os usuários aumentam ou diminuem as linhas definidas (campo numérico ou deslizante).
• Configurações de seleção: Adicione uma seleção de linha única ou múltipla com um campo de seleção booliana.
• Configurações de pesquisa: Permitir que os usuários pesquisem valores em um conjunto (por exemplo, filtrar por data disponível).
• Configurações de mensagem: Exiba mensagens ou indicadores de validação em células específicas.

Dados do conjunto de gestão

Os conjuntos são compatíveis com a importação e exportação de dados no formato CSV.

• Dados do conjunto de download: Exporta somente colunas visíveis com base nos filtros aplicados na IU.
• Carregar dados do conjunto: Adiciona ou atualiza linhas no conjunto usando um arquivo CSV estruturado.
  • As regras são executadas automaticamente no carregamento.
  • As novas linhas são anexadas; as linhas correspondentes são atualizadas.
  • Limites impostos pelo sistema se aplicam (recomenda-se 25 colunas visíveis).

Habilite uploads/downloads adicionando propriedades JSON no valor bruto do conjunto:

{
  "uploadDetails": {
    "uploadButton": { "label": "Upload CSV", "visible": true },
    "downloadButton": { "label": "Download CSV", "visible": true }
  }
}

Scripting com conjuntos

Para referenciar conjuntos em regras ou scripts, use a seguinte sintaxe:

Caso de uso	Sintaxe de exemplo
Acesse o conjunto	<setVarName>.Set
Acesse um campo agregado	Set.<setVarName>.<aggregateVarName>

Por exemplo:

if (set.networkDevices.totalRackUnits > 50) {
   field.requiresAdditionalCooling = true;
}

Conceitos relacionados

• Configurar conjuntos