Crie uma ação de coleta de dados para gerar uma lista de opções de escolha para uma entrada de escolha dinâmica.
Antes de Iniciar
- Função necessária: action_designer ou admin
- Criar credenciais e conexões para seu endpoint REST
Procedimento
-
Navegar até .
-
Selecionar .
-
No campo Nome, insira um nome para sua ação, escolha o Escopo da aplicação apropriado e selecione Enviar.
-
No Contorno da ação, selecione o ícone adicionar uma nova etapa (ícone
) em Entradas e selecione a etapa REST.
Configure sua etapa REST para obter dados do
URL base e
do caminho do recurso apropriados com todos os
parâmetros de consulta aplicáveis ao
método HTTP GET. Para obter mais informações sobre como usar a etapa REST em
IntegrationHub, consulte
Etapa REST e
REST no IntegrationHub.
-
No Contorno da ação na etapa REST, selecione o ícone adicionar uma nova etapa (ícone ) e selecione a etapa Script.
-
Em Variáveis de entrada, selecione Criar variável.
Esta variável de entrada armazena o corpo da resposta REST.
Por exemplo, para a variável de entrada Nome, insira carga útil.
-
Para a variável de entrada Valor, selecione a cápsula de dados para a saída do corpo da resposta da etapa REST.
-
Em Script, insira um script para criar uma saída JSON a partir da variável de entrada.
Seu script precisa fazer essas tarefas.
- Analisar a variável de entrada como JSON
- Você pode usar a API JSON - Global para transformar a variável de entrada de uma cadeia de caracteres em um objeto JSON.
- Criar um novo objeto JSON formatado para uma opção dinâmica
- Você deve conhecer a estrutura de dados da resposta REST para mapear valores de resposta para opções da lista de seleção. Seu script deve criar um objeto JSON de escolha dinâmica que tenha uma propriedade chamada
dados. O valor da propriedade de dados deve ser uma matriz de opções de lista de seleção. Cada opção da lista de seleção deve ter um rótulo e uma propriedade de nome definida como valores de cadeia de caracteres. A propriedade de rótulo determina como a opção aparece na lista de seleção. A propriedade de nome determina como a opção é armazenada e referenciada no sistema.Por exemplo, este objeto JSON define uma matriz com três opções de lista de seleção.
{
data: [
{
label: "Choice Option 1",
name: "choice_option_1"
},
{
label: "Choice Option 2",
name: "choice_option_2"
},
{
label: "Choice Option 3",
name: "choice_option_3"
}
]
}
Nota: Uma entrada de escolha dinâmica só pode exibir até 5.000 opções de lista de seleção. Um objeto JSON que retorna mais de 5.000 opções da lista de seleção ficará truncado quando for renderizado.
- Definir o objeto de saída
- Defina o objeto de saída para retornar seu objeto JSON de escolha dinâmica.
-
Em Variáveis de saída, selecione Criar variável.
Esta variável de saída armazena as opções da lista de seleção que seu script cria.
-
Para o tipo de variável de saída, selecione JSON.
O tipo de variável de saída do script deve ser JSON.
-
No Contorno da ação, selecione Saídas
-
Selecione Criar saída.
-
Defina o rótulo de saída e o nome de saída.
-
Defina o tipo de saída como JSON.
Nota: A ação pode ter várias saídas, mas só pode haver uma do tipo JSON.
-
Selecione Sair do modo de edição.
-
Ao lado do campo Valor, selecione o seletor de cápsula de dados ( Selecionador de cápsula de
) e selecione a Variável de saída da etapa de script que você criou para armazenar opções da lista de seleção.
-
Selecione Salvar e teste a ação.
O valor de tempo de execução para a saída deve ser um objeto JSON que tenha uma propriedade de dados e uma matriz de opções de lista de seleção.
-
Selecione Publicar para disponibilizar a ação para outros fluxos e ações no mesmo escopo da aplicação.
Resultado
Agora você pode usar sua ação de coleta de dados para preencher as opções que aparecem para uma entrada de escolha dinâmica em uma ação primária.