Crie uma ação de coleta de dados para um modelo dinâmico

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura

    • Crie uma ação de coleta de dados para coletar valores de campo de registro para uma entrada de modelo dinâmico.

    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ção.
    3. Em Nome da ação insira um nome para sua ação e escolha o apropriado Aplicação e selecione Enviar .
    4. Opcional: Em Descrição da ação, selecione Entradas .
      Pode ser necessário criar uma entrada para fornecer um nome de tabela ou um caminho de URL dinâmico para sua etapa REST.
      Por exemplo, crie uma entrada Cadeia de caracteres para armazenar um nome de tabela. Consulte Crie uma ação de coleta de dados para obter nomes de campos para obter instruções.
    5. Na Descrição da ação em Entradas, selecione o ícone adicionar uma nova etapa ( Ícone Adicionar uma nova etapa) e selecione REST etapa.
      1. Em Detalhes da conexão, selecione um alias de conexão ou defina uma conexão em linha.
        Um alias de conexão permite que você atualize os detalhes da conexão sem precisar editar a ação.
        Por exemplo, selecione um alias de conexão para sua instância local.
      2. Em Detalhes da solicitação, selecione um método para criar uma solicitação, forneça um caminho de recurso, selecione um método HTTP e forneça parâmetros de consulta.
        As ações de coleta de dados geralmente usam um método HTTP GET para solicitar dados de um endpoint REST. Para obter mais informações sobre como usar a etapa REST em IntegrationHub, consulte Etapa REST e. REST no IntegrationHub .
    6. 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 E criar uma variável de entrada para armazenar o corpo da resposta REST.
      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 um modelo dinâmico
        Você deve conhecer a estrutura de dados da Resposta REST para mapear valores de resposta para valores de modelo. Seu script deve criar um objeto JSON de modelo dinâmico que tenha uma propriedade chamada dados . O valor da propriedade de dados deve ser uma matriz de valores de modelo. Cada valor de modelo deve ter um rótulo propriedade, a. nome e um vazio valor propriedade. A propriedade do rótulo determina como a opção de valor do modelo aparece na ação. A propriedade name determina como a opção de valor do modelo é armazenada e referenciada no sistema. A propriedade Valor está vazia para que o valor possa ser definido dinamicamente quando a ação for configurada.

        Por exemplo, este objeto JSON define uma matriz de valores de modelo da tabela de incidentes.

        {
    "data": [
      {
        "name": "parent",
        "label": "Parent",
        "value": ""
      },
      {
        "name": "number",
        "label": "Number",
        "value": ""
      },
      {
        "name": "state",
        "label": "State",
        "value": ""
      },
      {
        "name": "active",
        "label": "Active",
        "value": ""
      },
      {
        "name": "priority",
        "label": "Priority",
        "value": ""
      },
      {
        "name": "caller_id",
        "label": "Caller id",
        "value": ""
      },
      {
        "name": "short_description",
        "label": "Short description",
        "value": ""
      },
      {
        "name": "description",
        "label": "Description",
        "value": ""
      },
      {
        "name": "sys_id",
        "label": "Sys id",
        "value": ""
      },
      {
        "name": "urgency",
        "label": "Urgency",
        "value": ""
      },
      {
        "name": "assigned_to",
        "label": "Assigned to",
        "value": ""
      },
      {
        "name": "severity",
        "label": "Severity",
        "value": ""
      },
      {
        "name": "category",
        "label": "Category",
        "value": ""
      }
    ]
}
        Nota:
        Uma entrada de modelo dinâmico só pode exibir até 5000 valores de modelo de campo. Um objeto JSON que retorna mais de 5000 valores de modelo de campo será truncado quando for renderizado.
        Defina o objeto de saídas
        Defina o objeto de saídas para retornar o objeto JSON do modelo dinâmico.
      4. Em Variáveis de saída, selecione Criar variável .
        Esta variável de saída armazena os valores de modelo 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.
    7. 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 valores de modelo.
    8. Clique em Salvar e. teste a ação .
      Nos detalhes da execução, sua ação de coleta de dados será executada com sucesso se o valor de tempo de execução for saída contém o. dados propriedade no formato apropriado.
    9. Clique em Publicar para disponibilizar a ação para outros fluxos ou 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 modelo dinâmico em uma ação primária.Use sua ação de coleta de dados para preencher opções para um modelo dinâmico.