Criar uma ação de coleta de dados para uma opção dinâmica

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura

    • 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 administrador
    • Criar credenciais e conexões para o endpoint REST
    Nota:
    As entradas dinâmicas não estão disponíveis no sistema de base. Para usar entradas dinâmicas em Workflow Studio, você deve Solicitar um Integration Hub plug-in.

    Procedimento

    1. Navegar até Todos > Automação de Processo > Flow Designer.
    2. Selecionar Criar novo(a) > Ação.
    3. No campo Nome, insira um nome para sua ação, escolha o Escopo da aplicação apropriado e selecione Enviar.
    4. Em Descrição da ação, selecione o ícone adicionar uma nova etapa (ícone Adicionar uma nova etapa) em Entradas e selecione a etapa REST.
      Configure sua etapa REST para obter dados da URL base e do caminho do recurso apropriados com todos os parâmetros de consulta aplicáveis para o método HTTP GET. Para obter mais informações sobre como usar a etapa REST em Integration Hub, consulte Etapa REST e REST no IntegrationHub.
    5. Em Descrição da ação na etapa REST, selecione o ícone Adicionar uma nova etapa (ícone Adicionar uma nova etapa) e selecione a etapa Script.
      1. 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.
      2. Para a variável de entrada Valor, selecione a cápsula de dados para a saída do Corpo de resposta da etapa REST.
      3. Em Script, insira um script para criar uma saída JSON a partir da variável de entrada.
        Seu script precisa executar 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 opção dinâmica que tenha uma propriedade chamada data. 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 para valores de cadeia de caracteres. A propriedade do 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 de lista de seleção será truncado quando for renderizado.
        Definir o objeto de saídas
        Defina o objeto de saída para retornar seu objeto JSON de escolha dinâmica.
      4. 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.
      5. Para o tipo de variável de saída, selecione JSON.
        O tipo de variável de saída do script deve ser JSON.
    6. Em Descrição da ação, selecione Saídas
      1. Selecione Criar saída.
      2. Defina o rótulo de saída e o nome da saída.
      3. 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.
      4. Selecione Sair do modo de edição.
      5. Ao lado do campo Valor, selecione o seletor de cápsula de dados ( Seletor de cápsula de dados) e selecione Variável de saída da etapa de script que você criou para armazenar opções da lista de seleção.
    7. Selecione Salvar e teste a ação.
      O valor de tempo de execução da saída deve ser um objeto JSON que tenha uma propriedade de dados e uma matriz de opções de lista de seleção.
      Exemplo de saída da ação de teste
    8. 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.Use sua ação de coleta de dados para preencher opções para uma escolha dinâmica.