Upload de CSV para opções de campo dependentes - Amazon Connect

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Upload de CSV para opções de campo dependentes

Ao configurar as opções de campo dependentes para modelos de caso, você pode carregar um arquivo CSV. O arquivo contém seus mapeamentos de opções de campo. Essa abordagem economiza tempo em comparação com a inserção manual de cada relacionamento por meio do site de administração do Amazon Connect. Esse recurso é útil quando você tem grandes conjuntos de dados de relacionamentos hierárquicos. Os exemplos incluem hierarquias geográficas (País → Estado → Cidade) ou categorizações de produtos (Categoria → Subcategoria).

O que é upload de CSV para opções de campos dependentes?

O upload de CSV é um método de configuração em massa para opções de campo dependentes nos casos do Amazon Connect. As opções de campo dependentes criam menus suspensos em cascata. As opções disponíveis em um campo (o campo de destino) dependem do valor selecionado em outro campo (o campo de origem).

Você pode preparar seus mapeamentos em um arquivo CSV e carregá-lo. Isso economiza tempo em comparação com a configuração manual de cada relação de valor entre origem e destino por meio do site de administração do Amazon Connect. O sistema analisa seu arquivo CSV e valida os nomes e valores dos campos em relação ao seu modelo de caso. Em seguida, o sistema preenche previamente o formulário de criação de regras com seus dados. Você cria a regra usando o fluxo de trabalho padrão.

Como funciona o upload de CSV?

Estrutura de arquivos CSV

O arquivo CSV usa um formato de quatro colunas com os seguintes cabeçalhos:

  • Nome do campo pai - O nome do campo de origem que controla o relacionamento

  • Nome do campo filho - O nome do campo de destino cujas opções dependem do campo de origem

  • Valor pai - Um valor específico do campo de origem

  • Valor secundário - Uma opção que aparece no campo de destino quando o valor principal é selecionado

Cada linha em seu CSV representa uma relação de valor de origem e destino. Você pode incluir vários pares de campos em um único arquivo CSV usando diferentes combinações de nomes de campo pai-filho. Por exemplo, você pode incluir os relacionamentos País-Estado e os relacionamentos Categoria-Subcategoria do Produto no mesmo arquivo. O número de entradas que você pode salvar depende dos limites de cota da sua conta.

Você pode baixar um modelo CSV no site de administração do Amazon Connect. O modelo fornece o formato correto com cabeçalhos de espaço reservado.

Processo de upload e validação

Quando você carrega um arquivo CSV, o sistema executa várias verificações de validação:

  • Validação do formato de arquivo - Verifica a estrutura CSV e as colunas necessárias

  • Existência do campo - Confirma se os nomes dos campos em seu CSV correspondem aos campos do modelo de caso selecionado

  • Validação do tipo de campo - Garante que os campos de origem e de destino sejam campos do tipo de seleção única

  • Validação de valor - verifica se os valores do campo de origem existem em seu modelo e identifica quaisquer valores de campo secundário que não existam

O sistema exibirá um erro se os valores do campo de origem em seu CSV não existirem no modelo. Se os valores do campo filho não existirem, o sistema ignorará esses valores e mostrará uma mensagem informativa.

Após a validação, o sistema agrupa suas linhas CSV por pares de campos exclusivos. O sistema exibe cada par detectado como uma opção selecionável. Se seu CSV contiver vários pares de campos, você seleciona qual par configurar.

Criação de regras a partir de dados CSV

Depois de selecionar um par de campos do CSV carregado, o formulário de criação de regras é preenchido automaticamente com os nomes dos campos e os mapeamentos de valores do seu arquivo.

Você deve criar explicitamente a regra depois que o formulário for preenchido. O processo de upload não cria regras automaticamente. Se você fizer upload de um novo arquivo CSV antes de criar a regra, os dados do novo arquivo substituirão as opções preenchidas anteriormente.

Cada upload de CSV cria uma regra por vez. Se seu CSV contiver vários pares de campos, você cria regras para cada par separadamente. Selecione pares diferentes e conclua o fluxo de trabalho de criação de regras para cada um.

Limites e requisitos

O upload de CSV tem os seguintes limites e requisitos:

  • Somente campos de seleção única - Os campos de origem e de destino devem ser campos do tipo de seleção única

  • Campos existentes obrigatórios - Todos os nomes de campo em seu CSV devem corresponder aos campos que já existem

Recursos adicionais do

Use o seguinte APIs para criar condições de opções de campo de forma programática: