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

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 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
    • Criar credenciais e conexões para seu endpoint REST

    Procedimento

    1. Navegar até Todos > Automação de Processo > Flow Designer.
    2. Selecionar Criar novo > Ação.
    3. No campo Nome da ação, insira um nome para sua ação, escolha o Escopo da aplicação apropriado e selecione Enviar.
    4. Opcional: Em Contorno 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 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. No Contorno 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. 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. No Contorno 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 da 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 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 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 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 ficará truncado quando for renderizado.
        Definir o objeto de saída
        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. No Contorno da ação, selecione Saídas
      1. Selecione Criar saída.
      2. Defina o rótulo de saída e o nome de 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 ( Selecionador 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 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.