Saídas dinâmicas
Acesse as saídas de ação e subfluxo como cápsulas de dados geradas dinamicamente durante o design do fluxo. Você também pode criar ações de coleta de dados para gerar objetos complexos das saídas de ServiceNow AI Platform e IntegrationHub.
Nota:
As saídas dinâmicas não estão disponíveis no sistema de base. Para usar saídas dinâmicas em Workflow Studio, você deve Solicite um IntegrationHub plug-in. As saídas dinâmicas fazem parte do plug-in ServiceNow Flow Designer - introspection [com.glide.hub.flow_designer_introspection].
Durante o design de fluxo, uma saída dinâmica recupera os valores de esquema do objeto complexo e os exibe como cápsulas de dados no painel de dados.
Uma saída dinâmica deve apontar para uma ação de coleta de dados que coleta os dados exibidos. Por exemplo, uma ação de coleta de dados pode recuperar valores de um sistema de terceiros como parte de um IntegrationHub spoke. Para usar uma saída dinâmica em Workflow Studio:
- Um designer de ação cria uma ação de coleta de dados.
- Um designer de ação cria uma ação primária com uma saída dinâmica que aponta para a ação de coleta de dados secundária.
- Um designer de fluxo adiciona a ação primária a um fluxo.
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.
Objeto dinâmico
Um objeto dinâmico é um objeto complexo ou uma matriz de objetos complexos. Os designers de ação criam a estrutura do objeto dinamicamente com uma ação de coleta de dados em vez de codificá-la. Para obter mais informações sobre como criar um objeto dinâmico, consulte Crie uma ação de coleta de dados para um objeto dinâmico .
Diretrizes gerais
- Use saídas dinâmicas para integrações de terceiros
- Use saídas dinâmicas para introspeção e buscar dados de sistemas externos durante o design de fluxo. Por exemplo, você pode especificar endpoints de serviço ou ações de chamada que interagem com APIs de endpoint específicas. Para obter mais informações sobre como configurar integrações de terceiros com Workflow Studio, consulte IntegrationHub .
- Observe o tempo necessário para recuperar grandes quantidades de dados
- Por padrão, as saídas dinâmicas têm até 300 segundos para coletar dados antes que o sistema as interrompa. Se sua ação de coleta de dados precisar de mais tempo para coletar dados, defina sn_flow_designer.sync_action_execution_timeout_in_secondspropriedade do sistema para um valor maior. Evite valores de tempo limite longo para fluxos interativos em que um usuário final espera 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, possíveis erros podem ocorrer no script. Revise todos os scripts usados para variáveis JSON de saída porque erros de script podem impedir que as saídas recebam os valores JSON de que precisam. Quando ocorre um erro de script de saída dinâmica, a seguinte mensagem de aviso pode ser exibida.
Figura 1. Mensagem exibida para erro de script 