Definindo opções dinâmicas

Para definir uma resposta do cliente de opções dinâmicas:

1. Em uma etapa, clique em Definir resposta do cliente..

2. Escolha o tipo de resposta Opções.

3. Clique no toggle Dynamic.

4. No campo Fonte de origem, escolha a variável que contém a matriz que define as opções dinâmicas (por exemplo, a variável contendo a resposta a partir de uma extensão personalizada que você chamou em uma etapa anterior).

5. Opcional: No campo Opção, escreva uma expressão que mapeia os itens na matriz de origem para as opções que serão listadas. Esta expressão serve como um template que converte cada item na matriz para um valor significativo que será exibido para o cliente. Nesta expressão, use a variável dinâmica ${item} para representar o item.

   Em algumas situações, você não precisa especificar uma expressão:

   • Se os itens da matriz forem valores simples como strings ou números inteiros, o valor de cada item será automaticamente mostrado como uma opção. No entanto, você ainda pode querer definir um mapeamento se você deseja manipular ou reformatar os itens para torná-los mais significativos. Por exemplo, você pode usar a expressão "Part #" + ${item} para mostrar números de peça usando o formato Part #12345.

   • Se os itens da matriz forem objetos JSON, o mapeamento padrão procura uma propriedade chamada label e usa seu valor (se presente) como a opção. Se o item não incluir uma propriedade label, ou você não quiser usar o valor da propriedade label como a opção, você deve gravar uma expressão para especificar um mapeamento. Você pode usar notação de ponto para referir-se a uma propriedade no objeto usando seu caminho JSON (por exemplo, ${item}.name).

6. Opcional: clique em Incluir opção de fallback para incluir uma opção estática, como None of the above, se as opções não forem as desejadas pelo cliente.. Em seguida, é possível incluir uma etapa condicionada a essa opção estática para fornecer assistência adicional. Para incluir a condição, escreva uma expressão como ${step_id}.value == "None of the above"

Exemplos de mapeamento

Suponhamos que você deseje construir uma ação que mostre uma lista de animais de estimação disponíveis para adoção e avisa o cliente para selecionar um pet para ver mais informações sobre. A variável de origem contém uma matriz a partir de uma extensão personalizada no seguinte formato:

[
  {
    "id": "123",
    "name": "Casey",
    "breed": "Shetland sheepdog",
    "age": 3
  },
  {
    "id": "987",
    "name": "Phoebe",
    "breed": "chihuahua",
    "age": 7
  }
]

O esquema para os itens não inclui uma propriedade label, portanto, o mapeamento padrão não está disponível. Em vez disso, você pode usar uma expressão para construir um rótulo complexo que inclui dados retirados de várias propriedades diferentes. Por exemplo, você pode usar a expressão ${item}.name + " (" + ${item}.breed + ", age " + ${item}.age + ")" para definir os rótulos da opção:

Lembre-se de que você pode usar métodos de expressão para manipular valores da variável de origem de várias formas. Por exemplo, você pode ter uma ação que os clientes usam para selecionar um cartão de crédito para pagamento, mas por motivos de segurança você não quer mostrar o número do cartão inteiro. Você poderia escrever uma expressão que usa o método substring() para incluir apenas os quatro últimos dígitos de cada número do cartão (por exemplo, "Card ending in " + ${item}.card_number.substring(16, 20)).

Referenciando o item selecionado

Depois que o cliente tiver selecionado uma das opções geradas dinamicamente, você provavelmente precisará referencia o item selecionado em uma etapa subsequente.

Se você referencia a variável de ação que representa a resposta do cliente, o padrão é utilizar o valor da opção selecionada. No entanto, em algumas situações, você pode não querer usar o mesmo valor que foi usado para exibir a opção para o cliente. Em vez disso, você pode precisar usar um identificador único ou outra propriedade que identifique inequivocamente a opção selecionada.

Por exemplo, se o cliente seleciona um pet para mostrar mais informações sobre, você provavelmente precisa usar um identificador único (a propriedade id no nosso exemplo) para consultar o banco de dados, já que o nome do pet, idade e raça podem não ser exclusivos. Ou se o cliente estiver selecionando um cartão de crédito a partir de opções que mostram apenas os últimos quatro dígitos, você precisará utilizar o número do cartão de crédito completo para acessar os detalhes da conta ou concluir uma transação.

Nessa situação, é possível escrever uma expressão para acessar as propriedades originais do item selecionado:

1. Crie ou edite uma etapa que venha após a etapa em que o cliente seleciona a partir das opções dinâmicas.

2. Na seção Valores Variáveis, escreva uma expressão para atribuir um valor a uma variável de sessão. (Para obter mais informações, consulte Usando uma expressão para atribuir um valor a uma variável de sessão.)

3. No editor de expressão, digite um sinal de dólar ($) e, em seguida, selecione a etapa na qual o cliente selecionou a opção dinâmica.

4. Use o nome da propriedade item para representar o item selecionado, e notação de ponto para acessar suas propriedades. Por exemplo, a expressão a seguir acessa a propriedade id do item selecionado em uma etapa anterior:

   ${step_331}.item.id
   

   Você pode usar uma expressão complexa para construir um valor usando várias propriedades do item selecionado. Por exemplo, você pode usar uma expressão tal como ${step_123}.item.firstname + " " + ${step_123}.item.lastname para construir o nome completo de uma pessoa. Use a expressão para definir o valor em qualquer formato que for necessário para concluir qualquer ação necessária.