Entradas dinâmicas

  • Versão de lançamento: Yokohama
  • Atualizado 5 de fev. de 2025
  • 6 min. de leitura

    • Gere uma lista de entradas de ação ou valores de entrada sempre que alguém configurar a ação em um fluxo. As entradas dinâmicas podem exibir uma lista de entradas de ação relacionadas, uma lista de campos de um registro ou uma lista de opções disponíveis em uma lista de seleção.

    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. As entradas dinâmicas fazem parte do plug-in ServiceNow Flow Designer - Introspection [com.glide.hub.flow_designer_introspection].
    Durante o design de fluxo, as entradas dinâmicas recuperam valores e os exibem como entradas em uma ação dinamicamente. Esses tipos de entradas dinâmicas estão disponíveis para autores de ação.
    Opção dinâmica
    A entrada do tipo Seleção dinâmica reúne uma lista de valores de seleção a serem exibidos. Para obter mais informações sobre como criar uma escolha dinâmica, consulte Criação de uma ação de coleta de dados para uma escolha dinâmica.
    Entradas dinâmicas
    A entrada do tipo Entradas dinâmicas reúne uma lista de entradas de ação adicionais a serem exibidas. Use entradas dinâmicas para adicionar entradas arbitrárias a uma ação. Para obter mais informações sobre como criar entradas dinâmicas, consulte Criar uma ação de coleta de dados para uma entrada do tipo de entradas dinâmicas.
    Modelo Dinâmico
    A entrada do tipo de modelo dinâmico reúne uma lista de campos de um tipo de registro selecionado dinamicamente. Os autores do fluxo podem selecionar quais campos serão incluídos em seu fluxo. Como a lista de campos é gerada dinamicamente, você não precisa mudar a ação quando os campos são adicionados ou removidos da tabela de origem. Para obter mais informações sobre como criar um modelo dinâmico, consulte Criação de uma ação de coleta de dados para um modelo dinâmico.
    Existem três etapas gerais para usar entradas dinâmicas.
    1. Um autor de ação cria uma ação de coleta de dados para gerar dados dinâmicos.
    2. Um autor de ação cria uma ação com uma entrada dinâmica e configura a entrada dinâmica para chamar a ação de coleta de dados.
    3. Um autor de fluxo adiciona a ação a um fluxo e configura a ação com dados coletados dinamicamente.

    Ações de coleta de dados

    Uma ação de coleta de dados obtém dados para serem usados por outras ações. As ações de coleta de dados devem ser chamadas a partir de entradas dinâmicas em vez de serem adicionadas diretamente a um fluxo. As ações de coleta de dados normalmente obtêm dados de sistemas de terceiros usando uma chamada REST. Todas as ações de coleta de dados devem atender a esses requisitos e restrições.
    • A ação tem uma etapa de script com uma variável de saída do tipo JSON.
    • A ação possui uma saída chamada output do tipo JSON, cujo valor é derivado da variável de saída JSON da etapa de script.
      Nota:
      A ação pode ter várias saídas, mas só pode ter uma do tipo JSON.
    • A etapa de script formata a saída JSON para ter uma propriedade chamada data.
    • A saída JSON não deve retornar mais de 5.000 opções de escolha, valores de modelo de campo ou itens de elemento de matriz quando os dados se destinam a uma escolha dinâmica ou a uma entrada de modelo dinâmico.
      Nota:
      As entradas de escolha dinâmica e modelo dinâmico só podem exibir até 5.000 opções de escolhas ou 5.000 valores de modelos da saída JSON.
    • A ação aguarda até 300 segundos (5 minutos) para coletar dados antes que o tempo limite seja atingido.
      Nota:
      Para mudar o tempo limite de todas as ações, modifique o valor da propriedade do sistema sn_flow_designer.sync_action_execution_timeout_in_seconds.

    Tipos de dados de entrada dinâmica compatíveis

    As entradas dinâmicas são compatíveis com um número limitado de tipos de dados Now Platform. Você pode usar o exemplo de JSON para criar suas próprias entradas dinâmicas. Você pode alterar os valores das propriedades de rótulo e nome para atender às suas necessidades. A propriedade de tipo deve especificar um nome de tipo de dados Now Platform. Para obter mais informações sobre Now Platform tipos de dados de campo e como configurá-los, consulte Field types reference.

    Tabela 1. Tipos de dados de entrada dinâmica compatíveis
    Tipo de dados de entrada Exemplo de JSON
    Escolha 
    { 
    data: [{
      label: 'Choice type input',
      name: 'choicetype',
      defaultValue: 'choice_1',
      type: 'choice',
      choices: [
          { label: 'Choice 1', value: 'choice_1' },
          { label: 'Choice 2', value: 'choice_2' }
      ]
    }]
  }
    Data e hora 
    { 
    data: [{
      label: 'Datetime type input',
      name: 'datetimetype',
      type: 'datetime',
    }]
  }
    Decimal 
    { 
    data: [{
      label: 'Decimal type input',
      name: 'decimaltype',
      type: 'decimal',
    }]
  }
    E-mail 
    { 
    data: [{
      label: 'Email type input',
      name: 'emailtype',
      type: 'email',
    }]
  }
    HTML 
    { 
    data: [{
      label: 'HTML type input',
      name: 'htmltype',
      type: 'html',
    }]
  }
    Números inteiros 
    { 
    data: [{
      label: 'Integer type input',
      name: 'integertype',
      type: 'integer',
    }]
  }
    Senha 2 
    { 
    data: [{
      label: 'Password2 type input',
      name: 'password2type',
      type: 'password2',
    }]
  }
    Referência 
    { 
    data: [{
      label: 'Reference type input',
      name: 'referencetype',
      reference: 'sys_user',
      type: 'reference',
    }]
  }
    Cadeia de caracteres 
    { 
    data: [{
      label: 'String type input',
      name: 'stringtype',
      defaultValue: 'abcdef',
      type: 'string',
      mandatory: true
    }]
  }

    Diretrizes gerais

    Considerar entradas dinâmicas para integrações de terceiros
    As entradas dinâmicas permitem criar fluxos que buscam dados dinamicamente de fontes externas. Em integrações de terceiros, as entradas dinâmicas podem fornecer valores de dados que pertencem a um endpoint específico. Para obter mais informações sobre como configurar integrações de terceiros com Workflow Studio, consulte IntegrationHub.
    Esteja ciente do tempo necessário para recuperar grandes quantidades de dados
    Por padrão, as entradas dinâmicas têm até 300 segundos para coletar dados antes que o tempo limite se esgote. Se a ação de coleta de dados precisar de mais tempo para coletar dados, defina a propriedade do sistema sn_flow_designer.sync_action_execution_timeout_in_seconds com um valor mais alto. No entanto, não use valores de tempo limite longos para fluxos interativos em que um usuário final deve inserir ou selecionar um valor.
    Esteja ciente dos erros de script
    Como todas as ações de coleta de dados usam uma etapa de script, podem ocorrer erros de script. Ao usar scripts para gerar variáveis JSON para suas entradas dinâmicas, você pode encontrar erros que impedem as entradas de receber os valores JSON de que precisam. Quando ocorre um erro de script de entrada dinâmica, a seguinte mensagem de aviso pode ser exibida.
    Figura 1. Mensagem exibida para erro de script
    Mensagem de erro de ação dinâmica
    Limitar as entradas do tipo de entradas dinâmicas a 40 valores de entrada
    Uma entrada do tipo de entradas dinâmicas só pode renderizar um determinado número de entradas antes que o objeto JSON se torne muito grande para ser armazenado na memória. Limitar suas entradas dinâmicas a 40 valores de entrada minimiza as chances de você ficar sem memória e enfrentar comportamentos inesperados, como erros de renderização ou truncamento de dados.
    Limitar a saída JSON a 5000 itens de matriz para modelos dinâmicos e escolhas dinâmicas
    As entradas de escolha dinâmica e modelo dinâmico podem exibir até 5.000 itens de matriz. Uma opção dinâmica só pode exibir até 5.000 opções de lista de seleção e um modelo dinâmico só pode exibir até 5.000 valores de modelo de campo. Se a ação de coleta de dados coletar dados para um modelo dinâmico ou uma opção dinâmica, restrinja o número máximo de itens de matriz retornados para 5000. O limite de 5.000 itens de matriz evita que a instância tenha problemas de desempenho ao renderizar as opções ou os valores de campo.