Entradas dinâmicas
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 Flow Designer, você deve Solicitar um IntegrationHub plug-in.
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 Opção dinâmica reúne uma lista de valores de opção a serem exibidos. Para obter mais informações sobre como criar uma opção dinâmica, consulte Criar uma ação de coleta de dados para uma opção 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 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 no 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 Criar uma ação de coleta de dados para um modelo dinâmico.
Há três etapas gerais para usar entradas dinâmicas.
- Um autor de ação cria uma ação de coleta de dados para gerar dados dinâmicos.
- 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.
- 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.
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 Flow Designer, 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 seja atingido. Se sua 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 
- 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 grande demais para ser armazenado na memória. Limitar as entradas dinâmicas a 40 valores de entrada minimiza as chances de ficar sem memória e de experimentar comportamentos inesperados, como erros de renderização ou truncamento de dados.
- Limitar a saída JSON a 5.000 itens de matriz para modelos dinâmicos e opções 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 sua 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 que ela retorna para 5.000. 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.