Comece a usar saídas dinâmicas

Crie uma ação de amostra que cria saídas dinâmicas para uso em um fluxo.

Antes de Iniciar

Função necessária: Action_designer ou admin

Procedimento

1. Crie registros de conexão e credencial para saídas dinâmicas
   Este alias de conexão e credencial fornecerá a URL base e a conta de usuário necessárias para configurar as etapas REST de suas ações de coleta de dados.
2. Crie uma ação de coleta de dados para obter um esquema de registro
   Esta ação de coleta de dados converterá um único registro em um objeto JSON para uma saída dinâmica de registro.
3. Crie uma ação de coleta de dados para obter uma matriz de esquemas de registros
   Esta ação de coleta de dados converterá uma lista de registros de registros em uma matriz JSON de objetos para uma saída dinâmica de registros.
4. Crie uma ação personalizada para testar saídas dinâmicas
   Esta ação personalizada ilustra dois tipos de dados de saída dinâmica. Uma saída dinâmica gera um objeto para um único registro. Outra saída dinâmica gera uma matriz de objetos para uma lista de registros.

Tarefas relacionadas

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

Referência relacionada

• Opções de configuração de saída dinâmica

Crie registros de conexão e credencial para saídas dinâmicas

Crie os aliases, conexões e credenciais que as etapas REST usarão para se conectar à sua instância local.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > Conexões e Credenciais > Credenciais.
2. Selecione Novo , selecione Credenciais de autenticação básica e insira estes valores de campo.
   1. Para Nome insira Administrador local .
   2. Para Nome de usuário Insira uma conta de usuário com acesso ao Flow Designer e à REST API.
      Por exemplo, insira administrador .
   3. Para Senha insira a senha da conta.
3. Selecione Enviar para criar o registro de credencial.
4. Navegar até Tudo > Conexões e Credenciais > Aliases de conexão e credenciais.
5. Selecione Novo e insira esses valores de campos.
   1. Para Nome Insira Instância local.
   2. Aceite o valor padrão de HTTP para Tipo de conexão .
   3. Selecione Enviar Para criar o registro de alias de conexão e credencial.
6. Selecione o alias que você criou.
   Por exemplo, selecione Instância local .
7. Na lista relacionada Conexões, selecione Novo e insira estes valores de campo.
   1. Para Nome insira Minha instância .
   2. Em Credencial, selecione o registro de credencial de autenticação básica que você criou.
      Por exemplo, selecione Administrador local credencial.
   3. Em URL de conexão, insira o URL base da sua instância, incluindo a barra no final
      Inclua o prefixo de URL https:// e adicione um caractere de barra no final do URL.
      Por exemplo, https://example.service-now.com/ .
   4. Selecione Enviar Para criar o registro de conexão HTTP(s).

Crie uma ação de coleta de dados para obter um esquema de registro

Crie uma ação de coleta de dados para pesquisar um esquema de tabela e converter em um objeto JSON.

Antes de Iniciar

Função necessária: Action_designer ou admin

Por Que e Quando Desempenhar Esta Tarefa

Nesta tarefa, você cria uma ação de coleta de dados que coleta o esquema de um registro em sua instância. O objetivo é criar um objeto complexo para uso como uma saída dinâmica. Esta ação de coleta de dados consiste no seguinte:

• Uma etapa REST para coletar dados de esquema de tabela para uma tabela selecionada. O corpo de resposta da etapa REST está no formato JSON.
• Uma etapa de script para transformar o corpo de resposta JSON da etapa REST em um objeto dinâmico. O objeto dinâmico consiste em pares de nome-valor JSON, em que há uma entrada para cada campo na tabela.
• Uma variável de saída chamada saída Do tipo JSON para armazenar o objeto dinâmico.

Nota:

Esta tarefa recria as ações de demonstração que são instaladas quando você Solicite um IntegrationHub plug-in para sua instância.

Procedimento

1. Navegar até Tudo > Automação de Processo > Workflow Studio.
2. Na página inicial, selecione Ações .
3. Selecione Novo e selecione Nova ação .
   1. Na tela Propriedades da ação, em Nome campo, insira Obter esquema de objeto da ServiceNow (dinâmico) .
   2. Selecione Enviar.
4. Na Descrição da ação, selecione Entradas .
   1. No cabeçalho de Entrada de ação, selecione Criar entrada .
   2. Em Rótulo e. Nome campos, insira Tabela .
   3. Em Tipo campo, selecione Cadeia de caracteres .
   4. Para tornar essa entrada necessária, alterne Obrigatório controle deslizante para que ele fique ativo.
5. Na Descrição da ação, selecione o ícone adicionar uma nova etapa ( Em Entradas e selecione Etapa REST .
6. No cabeçalho da etapa REST, preencha os seguintes campos.

   Campo	Valor
   Conexão	Saia do Usar Alias de Conexão opção selecionada.
   Alias de conexão	selecione o ícone criar novo registro ( ) para criar um novo Crie uma conexão HTTP(s) ou use uma conexão existente para sua instância. . Credencial Para a conexão HTTP(s) deve usar Credenciais de autenticação básica . . URL de conexão Deve ser o URL base da sua instância, incluindo a barra no final Para obter mais informações sobre conexões e credenciais, consulte Introdução ao Connections e. Introdução às credenciais .
   Criar solicitação	Saia do Manualmente opção selecionada.
   Caminho do recurso	Insira api/now/processflow/table/ e selecione o seletor de cápsula de dados ( ). Selecionar Entradas > Tabela. Em seguida, insira /schema .
   Método HTTP	Insira OBTER
   Parâmetros de Consulta	selecione o ícone de mais ( para adicionar um novo parâmetro de consulta. Em seguida, em Nome campo, insira get_choices e. verdadeiro em Valor campo.

7. Na Descrição da ação, selecione o ícone adicionar uma nova etapa ( Em sua etapa REST e selecione Script etapa.
   1. Na seção Variáveis de entrada, selecione Criar variável .
   2. Em Nome campo, insira carga .
   3. Ao lado de Valor , selecione o seletor de cápsula de dados ( ) e selecione Etapa REST > Corpo da Resposta.
   4. No campo Script, insira o código a seguir.

      
      (function execute(inputs, outputs) {
        var payload = JSON.parse(inputs.payload);
        
        var columns = payload.result.data.columns;
        var schema = columns.map(function(column) {
          var value = {
            label: column.label,
            name: column.name,
            type: getCOType(column.definition.base_type),
          };
          if (column.definition.type === 'choice') {
            value.type = 'choice';
            value.choices = column.definition.choices;
          } 
          if (column.definition.base_type === 'GUID') {
            value.children = [
              { label: 'Link', name: 'link', type: 'string' },
              { label: 'Value', name: 'value', type: 'string' },
            ];
          }
          return value;
        });
        outputs.schema = { 
          data: {
            type: 'object',
            children: schema,
          },
        };
        
        function getCOType(type) {
          if (type === 'GUID') return 'reference';
          return type;
        }
      })(inputs, outputs);

   5. Na seção Variáveis de saída, selecione Criar variável .
   6. Em Rótulo e. Nome campos, insira esquema .
   7. Em Tipo campo, selecione JSON .
8. Na Descrição da ação, selecione Saídas .
   1. No cabeçalho Saída da ação, selecione Criar saída .
   2. Em Rótulo e. Nome campos, insira saída .
   3. Em Tipo campo, selecione JSON .
   4. No cabeçalho Saída da ação, selecione Sair do Modo de edição .
   5. Ao lado de Valor , selecione o seletor de cápsula de dados ( ) e selecione Etapa de script > esquema.
9. No cabeçalho Ação, selecione Salvar e selecione Teste . teste a ação .
   1. Na tela Ação de teste, insira incidente para Tabela entrada.
   2. Selecione Run Test (Executar teste).
   3. Verifique os detalhes da execução da ação.
   Sua ação de coleta de dados será executada com sucesso se o valor de tempo de execução for campos é um objeto complexo em um formato semelhante ao exemplo abreviado a seguir.

   {
          "data": {
              "type": "object",
              "children": [
                  {
                      "name": "active",
                      "label": "Active",
                      "type": "boolean"
                  },
                  {
                      "name": "activity_due",
                      "label": "Activity due",
                      "type": "datetime"
                  }, ...

10. No cabeçalho Ação, selecione Publicar para fazer o. Get ServiceNow Object Schema (Dynamic)Ação disponível para outros fluxos e ações no escopo global.

Crie uma ação de coleta de dados para obter uma matriz de esquemas de registros

Crie uma ação de coleta de dados para gerar uma matriz de objetos de uma lista de registros.

Antes de Iniciar

Função necessária: Action_designer ou admin

Por Que e Quando Desempenhar Esta Tarefa

Nesta tarefa, você cria uma ação de coleta de dados que coleta o esquema de um registro em sua instância. O objetivo é criar um objeto complexo para uso como uma saída dinâmica. Esta ação de coleta de dados consiste no seguinte:

• Uma etapa REST para coletar dados de esquema de tabela para uma tabela selecionada. O corpo de resposta da etapa REST está no formato JSON.
• Uma etapa de script para transformar o corpo de resposta JSON da etapa REST em um objeto dinâmico. O objeto dinâmico consiste em uma matriz JSON de objetos, em que cada registro de origem é convertido em um objeto da matriz.
• Uma variável de saída chamada saída Do tipo JSON para armazenar o objeto dinâmico.

Nota:

Esta tarefa recria as ações de demonstração que são instaladas quando você Solicite um IntegrationHub plug-in para sua instância.

Procedimento

1. Navegar até Tudo > Automação de Processo > Workflow Studio.
2. Na página inicial, selecione Ações .
3. Selecione Novo e selecione Nova ação .
   1. Na tela Propriedades da ação, em Nome campo, insira Esquema Array.Object da ServiceNow (dinâmico) .
   2. Selecione Enviar.
4. Na Descrição da ação, selecione Entradas .
   1. No cabeçalho de Entrada de ação, selecione Criar entrada .
   2. Em Rótulo e. Nome campos, insira Tabela .
   3. Em Tipo campo, selecione Cadeia de caracteres .
   4. Para tornar a entrada necessária, alterne Obrigatório controle deslizante para que ele fique ativo.
5. Na Descrição da ação, selecione o ícone adicionar uma nova etapa ( Em Entradas e selecione REST etapa.
6. No cabeçalho da etapa REST, preencha os seguintes campos.

   Campo	Valor
   Conexão	Sair Usar Alias de Conexão selecionado.
   Alias de conexão	selecione o ícone criar novo registro ( ) para criar um novo Crie uma conexão HTTP(s) ou use uma conexão existente para sua instância. . Credencial Para a conexão HTTP(s) deve usar Credenciais de autenticação básica . . URL de conexão Deve ser o URL base da sua instância, incluindo a barra no final
   Criar solicitação	Sair Manualmente selecionado.
   Caminho do recurso	Insira api/now/processflow/table/ e selecione o seletor de cápsula de dados ( ). Selecionar Entradas > Tabela. Por fim, insira /schema
   Método HTTP	Insira OBTER
   Parâmetros de Consulta	selecione o ícone de mais ( para adicionar um novo parâmetro de consulta. Em seguida, em Nome campo, insira get_choices e. verdadeiro em Valor campo.

7. Em Descrição da ação, selecione Adicione uma nova etapa ( ) Em sua etapa REST e selecione Script etapa.
   1. Na seção Variáveis de entrada, selecione Criar variável .
   2. Em Nome campo, insira carga .
   3. Ao lado de Valor , selecione o seletor de cápsula de dados ( ) e selecione Etapa REST > Corpo da Resposta.
   4. No campo Script, insira o código a seguir.

      
      (function execute(inputs, outputs) {
        var payload = JSON.parse(inputs.payload);
        
        var columns = payload.result.data.columns;
        var schema = columns.map(function(column) {
          var value = {
            label: column.label,
            name: column.name,
            type: getCOType(column.definition.base_type),
          };
          if (column.definition.type === 'choice') {
            value.type = 'choice';
            value.choices = column.definition.choices;
          }
          return value;
        });
        outputs.schema = { 
          data: {
            type: 'array.object',
            attributes: {
              child_type: 'object',
            },
            children: schema,
          },
        };
        
        function getCOType(type) {
          if (type === 'GUID') return 'string';
          return type;
        }
      })(inputs, outputs);

   5. Na seção Variáveis de saída, selecione Criar variável .
   6. Em Rótulo e. Nome campos, insira esquema .
   7. Em Tipo campo, selecione JSON .
8. Na Descrição da ação, selecione Saídas .
   1. No cabeçalho Saída da ação, selecione Criar saída .
   2. Insira saída em Rótulo e. Nome campo.
   3. Selecione JSON para Tipo campo.
   4. Selecione Sair do Modo de edição .
   5. Ao lado de Valor , selecione o seletor de cápsula de dados ( ) e selecione Etapa de script > esquema.
9. No cabeçalho Ação, selecione Salvar e selecione Teste . teste a ação .
   1. Na tela Ação de teste, em Tabela campo, insira incidente .
   2. Selecione Run Test (Executar teste).
   3. Verifique os detalhes da execução da ação.
      Sua ação de coleta de dados será executada com sucesso se o valor de tempo de execução for campos a saída é um objeto complexo que contém uma matriz de pares de chave-valor para rótulo , nome e valor conforme mostrado no exemplo resumido a seguir.

      {
             "data": {
                 "type": "array.object",
                 "children": [
                     {
                         "name": "active",
                         "label": "Active",
                         "type": "boolean"
                     },
                     {
                         "name": "activity_due",
                         "label": "Activity due",
                         "type": "datetime"
                     }, ...
      

10. No cabeçalho Ação, selecione Publicar para fazer o. Get ServiceNow Array.Object Schema (Dynamic)Ação disponível para outras ações no escopo global.

Crie uma ação personalizada para testar saídas dinâmicas

Criar uma ação de amostra para gerar dinamicamente duas saídas de ação, Registro e. Registros que são atualizados dinamicamente quando o valor de Tabela mudanças de entrada.

Antes de Iniciar

Função necessária: Action_designer ou admin

Por Que e Quando Desempenhar Esta Tarefa

Esta ação personalizada usa duas ações de coleta de dados para preencher saídas dinâmicas.

Procedimento

1. No cabeçalho principal, selecione o ícone Criar fluxo, subfluxo ou ação ( ) e selecione Ação .
   1. No modal Propriedades da ação, em Nome campo, insira Obter registros da ServiceNow (dinâmico) .
   2. Selecione Enviar.
2. Na Descrição da ação, selecione Entradas .
   1. No cabeçalho de Entrada de ação, selecione Criar entrada .
   2. Em Rótulo e. Nome campos, insira Tabela .
   3. Em Tipo campo, selecione Opção dinâmica .
   4. Para tornar a entrada necessária, alterne Obrigatório controle deslizante para que ele fique ativo.
   5. Selecione o ícone Alternar entradas avançadas ( para exibir as opções avançadas do Tabela entrada.
   6. Em Valor padrão campo, insira incidente .
   7. Em Opções dinâmicas, em Ação campo, selecione Obter tabelas da ServiceNow - dinâmicas .
   8. Selecione Criar entrada para criar outra entrada de ação.
   9. Em Rótulo e. Nome campos, insira NumberOfRegistros .
   10. Em Tipo campo, selecione Inteiro .
   11. Para tornar a entrada necessária, alterne Obrigatório controle deslizante para que ele fique ativo.
   12. Selecione o ícone Alternar entradas avançadas ( para exibir as opções avançadas do Tabela entrada.
   13. Em Valor padrão campo, insira 3 .
3. Na Descrição da ação, selecione o ícone adicionar uma nova etapa ( Em Entradas e selecione REST etapa.
4. No cabeçalho da etapa REST, preencha os seguintes campos.

   Campo	Valor
   Conexão	Sair Usar Alias de Conexão selecionado.
   Alias de conexão	Selecione o ícone Criar novo registro ( ) para criar um novo Crie uma conexão HTTP(s) ou use uma conexão existente para sua instância. . Credencial Para a conexão HTTP(s) deve usar Credenciais de autenticação básica . . URL de conexão Deve ser o URL base da sua instância, incluindo a barra no final
   Criar solicitação	Sair Manualmente selecionado
   Caminho do recurso	Insira api/now/table/ e selecione o seletor de cápsula de dados ( ). Selecionar Entradas > Tabela.
   Método HTTP	Insira OBTER
   Parâmetros de Consulta	Selecione o ícone de mais ( para adicionar um novo parâmetro de consulta. Em seguida, insira sysparm_limit em Nome campo. Ao lado de Valor , selecione o seletor de cápsula de dados ( ) e selecione Entradas > Número de registros.

5. Na Descrição da ação, selecione o ícone adicionar uma nova etapa ( ) em Entradas e selecione Script etapa.
   1. Na seção Variáveis de entrada, selecione Criar variável .
   2. Em Nome campo, insira carga .
   3. Ao lado de Valor , selecione o seletor de cápsula de dados ( ) e selecione Etapa REST > Corpo da Resposta.
   4. No campo Script, insira o código a seguir.

      
      (function execute(inputs, outputs) {
        var response = JSON.parse(inputs.payload);
        var records = response.result;
        outputs.record = records[0];
        outputs.records = JSON.stringify(records);
      })(inputs, outputs);

   5. Na seção Variáveis de saída, selecione Criar variável .
   6. Em Rótulo e. Nome campos, insira registro .
   7. Selecione JSON para Tipo campo.
   8. Alterne Obrigatório controle deslizante para que ele fique ativo.
   9. Selecione Criar variável para criar outra variável de saída para a etapa de script.
   10. Em Rótulo e. Nome campos, insira registros .
   11. Em Tipo campo, selecione JSON .
   12. Para tornar a entrada necessária, alterne Obrigatório controle deslizante para que ele fique ativo.
6. Na Descrição da ação, selecione Saídas .
   1. No cabeçalho Saída da ação, selecione Criar saída .
   2. Em Rótulo e. Nome campos, insira Registros .
   3. Em Tipo campo, selecione Objeto dinâmico .
   4. Selecione o ícone Alternar entradas avançadas ( para exibir as opções avançadas do Registros saída.
   5. Em Opções dinâmicas, selecione Esquema Array.Object da ServiceNow (dinâmico) . Ação .
   6. Para tornar a entrada Tabela dependente de outra entrada, alterne Depende de outra entrada controle deslizante para ativá-lo.
   7. Em Tabela e, selecione Tabela .
   8. No cabeçalho Saída da ação, selecione Sair do Modo de edição .
   9. Ao lado de Valor , selecione o seletor de cápsula de dados ( ) e selecione Etapa de script > registros.
   10. No cabeçalho Saída da ação, selecione Editar saídas > Criar Saída para criar outra saída de ação.
   11. Em Rótulo e. Nome campos, insira Registro .
   12. Em Tipo campo, selecione Objeto dinâmico .
   13. Selecione o ícone Alternar entradas avançadas ( para exibir as opções avançadas do Registro saída.
   14. Em Opções dinâmicas, em Ação campo, selecione Obter esquema de objeto da ServiceNow (dinâmico) .
   15. Para tornar a entrada Tabela dependente de outra entrada, alterne Depende de outra entrada controle deslizante para ativá-lo.
   16. Em Tabela campo, selecione Tabela .
   17. No cabeçalho Saída da ação, selecione Sair do Modo de edição .
   18. Para Valor , selecione o seletor de cápsula de dados ( ) e selecione Etapa de script > registro.
7. No cabeçalho Ação, selecione Salvar e selecione Teste . teste a ação .
   1. Na tela Ação de teste, selecione qualquer valor de opção gerado dinamicamente para Tabela entrada.
   2. Selecione Run Test (Executar teste).
   3. Verifique os detalhes da execução da ação.
      Sua ação será executada com sucesso se o valor de tempo de execução for Registro é um objeto complexo formatado corretamente e o valor de tempo de execução para Registros é uma matriz de objetos complexos formatados corretamente.
8. No cabeçalho Ação, selecione Publicar para fazer o. Get ServiceNow Records (Dynamic)Ação disponível para fluxos no escopo global.

Resultado

Agora você pode adicionar Get ServiceNow Records (Dynamic)ação para um fluxo. Esta ação de amostra gera dinamicamente duas saídas de ação, Registro e. Registros , que podem ser acessadas como cápsulas de dados no painel de dados. As cápsulas de dados são atualizadas dinamicamente quando o valor de Tabela mudanças de entrada.