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

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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 admin
    • Crie credenciais e conexões para seu 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 Solicite um IntegrationHub plug-in.

    Procedimento

    1. Navegar até Tudo > Automação de Processo > Flow Designer.
    2. Selecionar Criar novo(a) > Ação.
    3. Em Nome insira um nome para sua ação e escolha o apropriado Aplicação e selecione Enviar .
    4. Na Descrição da ação, selecione o ícone adicionar uma nova etapa ( Ícone Adicionar uma nova etapa) em Entradas e selecione REST etapa.
      Configure sua etapa REST para obter dados do apropriado URL base e. Caminho do recurso com qualquer aplicável Parâmetros de consulta para Método HTTP OBTER . Para obter mais informações sobre como usar a etapa REST em IntegrationHub, consulte Etapa REST e. REST no IntegrationHub .
    5. Na Descrição da ação na etapa REST, selecione o ícone adicionar uma nova etapa ( Ícone Adicionar uma nova etapa) e selecione Script etapa.
      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 o valor da variável de entrada, selecione a cápsula de dados para as etapas REST Corpo da resposta saída.
      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.
        Analise a variável de entrada como JSON
        Você pode usar JSON - Global API para transformar a variável de entrada de uma cadeia de caracteres em um objeto JSON.
        Crie 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 de lista de seleção deve ter um rótulo e um nome propriedade definida como valores de cadeia de caracteres. A propriedade do rótulo determina como a opção aparece na lista de seleção. A propriedade name 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 seleção dinâmica só pode exibir até 5000 opções de lista de seleção. Um objeto JSON que retorna mais de 5000 opções de lista de seleção será truncado quando for renderizado.
        Defina o objeto de saídas
        Defina o objeto de saídas 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. Na Descrição da ação, selecione Saídas
      1. Selecione Criar saída.
      2. Defina o rótulo e o nome de saí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 de Valor , selecione o seletor de cápsula de dados ( Seletor de cápsula de dados) E selecione a 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 para saída Deve ser um objeto JSON que tenha um dados e uma matriz de opções de lista de seleção.
      Saída de exemplo 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 opção dinâmica.