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

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. 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 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é Tudo > Automação de Processo > Flow Designer.
    2. Selecionar Criar novo > Ação.
    3. No campo Nome da ação, insira um nome para a ação, escolha o Escopo da aplicação apropriado 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 a etapa REST.
      Por exemplo, crie uma entrada de cadeia de caracteres para armazenar um nome de tabela. Consulte Criar uma ação de coleta de dados para obter nomes de campo para obter instruções.
    5. Em Descrição da ação em Entradas, selecione o ícone adicionar uma nova etapa ( ícone Adicionar uma nova etapa) e selecione a etapa REST.
      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. Para os 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 todos os parâmetros de consulta.
        As ações de coleta de dados geralmente usam um método GET HTTP para solicitar dados de um endpoint REST. Para obter mais informações sobre como usar a etapa REST em Integration Hub, consulte Etapa REST e REST no IntegrationHub.
    6. 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ávele crie uma variável de entrada para armazenar o corpo da resposta REST.
      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 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 data. O valor da propriedade de dados deve ser uma matriz de valores de modelo. Cada valor de modelo deve ter uma propriedade de rótulo, uma propriedade de nome e uma propriedade de valor vazia. A propriedade de rótulo determina como a opção de valor do modelo aparece na ação. A propriedade de nome determina como a opção de valor do modelo é armazenada e referenciada no sistema. A propriedade de valor está vazia para que o valor possa ser definido dinamicamente quando a ação é 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é 5.000 valores de modelo de campo. Um objeto JSON que retorna mais de 5.000 valores de modelo de campo será truncado quando for renderizado.
        Definir o objeto de saídas
        Defina o objeto de saída 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. 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 escolha 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 de execução, sua ação de coleta de dados será executada com sucesso se o valor de tempo de execução da saída contiver a propriedade de dados 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.