Considerações de design de ação do fluxo de dados

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • Siga estas considerações ao criar um Fluxo de dadose ao adicionar um Fluxo de dadosação para um fluxo para evitar erros e problemas de desempenho.

    Considerações ao criar uma ação de Fluxo de dados

    Criar Fluxo de dadosações com essas considerações em mente.

    Grave a lógica de paginação de acordo com os requisitos de terceiros

    Avalie e entenda o formato exigido pelo endpoint de terceiros. Por exemplo, talvez você precise gravar um script que defina a variável getNextPage interna como verdadeira, desde que haja um token nextPage na resposta. Se a resposta não contiver o token, defina a variável como falsa. Acesse variáveis no script usando colchetes ou notação de ponto. Por exemplo, variáveis ['getNextPage']. Esta variável aceita somente o tipo de dados booliano. O valor padrão é falso.

    Certifique-se de que os scripts de pré-processamento não chamem um MID Server ou pause a ação.
    As ações de fluxo de dados exigem uma conexão constante com o fluxo de resposta. Eles não oferecem suporte a scripts de pré-processamento que pausam a ação para chamar um MID Server ou pause a ação para aguardar uma condição ou duração. Um script de pré-processamento que pausa a ação por qualquer motivo retorna uma mensagem de erro.
    Converta tipos de dados variáveis de paginação para executar operações matemáticas

    Variáveis de paginação só são compatíveis com o tipo de dados de cadeia de caracteres. Para executar operações matemáticas, você deve converter o valor em um número inteiro, executar todas as operações necessárias e convertê-lo novamente em uma cadeia de caracteres.

    variables['offset'] = (parseInt(variables['offset']) + parseInt(variables['limit'])).toString();
    Certifique-se de que o script de paginação tenha uma condição final
    Evite loops infinitos em solicitações de paginação, criando uma condição que defina a variável getNextPage como falsa. Cancele todos os fluxos de longa execução. Sempre teste as ações Fluxo de dados antes de usá-las na produção.
    Limpe as opções da página de configuração com cuidado
    Limpar uma opção em uma página de configuração remove a etapa do contorno Fluxo de dados e exclui todos os dados associados à etapa.
    Considere o tamanho de cada página retornada
    Ao configurar as opções de paginação, tente garantir que o tamanho de cada página retornada seja inferior a um GB. Isso garante que os designers de fluxo que usam a ação não encontrem problemas de limite de tamanho ao recuperar dados de um MID Server. Se a ação retornar mais de um GB de dados por página, o designer de fluxo pode precisar aumentar o limite de tamanho do anexo. Para obter mais informações, consulte MID Server Suporte para ações de fluxo de dados.
    Nota:
    • Aninhamento Fluxo de dadosas ações não são compatíveis.
    • Ao usar a política de novas tentativas, certifique-se de estar ciente destas considerações:
      • Somente uma estratégia de intervalo de tempo fixo é respeitada para as ações de fluxo de dados.
      • O atraso total (contagem multiplicada pelo intervalo) não pode exceder 30 segundos. Por exemplo, se você quiser tentar novamente no máximo 3 vezes, o atraso máximo para cada nova tentativa será de 10 segundos.
      • A etapa do fluxo de dados não entra no estado Aguardando durante a nova tentativa.

    Considerações ao adicionar uma ação de Fluxo de dados a um fluxo

    Adicione um Fluxo de dadosação para um fluxo com essas considerações em mente.

    Não adicione ações com condições de espera a um Fluxo de dadosPara cada bloco lógico

    Não é possível adicionar uma ação que pausa o fluxo em um bloco de lógica de fluxo Fluxo de dadosPara cada. Ações Fluxo de dados exigem uma conexão constante com o fluxo de resposta. Por exemplo, você não pode usar as ações pedir aprovação ou aguardar condição na lógica de fluxo Fluxo de dados Para cada.

    Algumas ações e etapas sempre pausam um fluxo e não podem ser adicionadas a. Fluxo de dadosPara cada bloco de lógica de fluxo. No entanto, algumas ações e etapas podem pausar o fluxo, dependendo de como elas estão configuradas. Verifique a configuração da ação para garantir que ela não pause o fluxo no tempo de execução.

    Sempre pausa o fluxo (incompatível com ações de fluxo de dados) Solicitar Ação de aprovação
    Etapa para pedir aprovação
    Aguardar ação de condição
    Aguarde a etapa de condição
    Pode pausar o fluxo dependendo da configuração Ação Criar tarefa de catálogo
    Criar ação de tarefa
    Etapa de criação de tarefas
    Não adicione ações executadas no MID Server para um Fluxo de dadosPara cada bloco lógico

    Algumas ações e etapas sempre são executadas em um MID Server e não podem ser adicionados a. Fluxo de dadosPara cada bloco de lógica de fluxo. No entanto, algumas ações e etapas podem ser executadas em um MID Server dependendo de como eles estão configurados. Verifique a configuração da ação para garantir que ela não seja executada no MID Server em tempo de execução.

    Sempre é executado em um MID Server (incompatível com ações de fluxo de dados) Etapa JDBC
    Etapa de PowerShell
    Etapa de SSH
    Pode ser executado em um MID Server dependendo da configuração Etapa REST
    Etapa de script
    Etapa SOAP
    Desative a emissão de relatórios ao consumir um grande número de registros no para cada bloco lógico
    em um grande número de registros pode consumir muitos recursos, especialmente quando o bloco lógico de fluxo inclui ações complexas para cada iteração. Para evitar problemas de desempenho, desative o relatório usando a propriedade do sistema com.snc.process_flow.reporting.level. Para obter mais informações, consulte Workflow Studio flow system properties.