Macro iterativa

Uma macro iterativa é executada em todos os registros e, em seguida, retorna os registros pelo fluxo de trabalho, repetindo todo o processo quantas vezes forem especificadas ou até que uma condição seja atendida.

As propriedades da macro iterativa serão exibidas somente na guia "Teste" no designer de interface. O conteúdo da guia "Teste" não pode ser editado no designer de interface.

Criar macro iterativa

1. Comece com um fluxo de trabalho concluído.
2. Em Propriedades do fluxo de trabalho, selecione Macro iterativa na lista suspensa Tipo de fluxo de trabalho. Quando você salva o fluxo de trabalho como uma macro iterativa, cada ferramenta contida nele recebe uma âncora em formato de raio. Somente as ferramentas da categoria Interface podem se conectar a essas âncoras. Essa âncora indica que ações e elementos de interface estão atualizando uma ferramenta do fluxo de trabalho.
3. Configure as propriedades da macro iterativa, encontradas na janela Designer de interface utilizando Ctrl+Alt+D ou acessada pelo menu Exibir. Selecione o ícone de engrenagem para exibir as propriedades.
   • Entrada da iteração: na lista suspensa, selecione a ferramenta Dados de Entrada no fluxo de trabalho que contém os registros a serem usados para o processo iterativo.
   • Saída da iteração: na lista suspensa, selecione a ferramenta Dados de Saída no fluxo de trabalho que contém os registros que retornarão por meio do processo iterativo.
   • Número máximo de iterações: todos os processos devem terminar em algum ponto; caso contrário, podem entrar em loop indefinidamente. Especifique o número de iterações aqui.
   • Quando o número máximo de iterações for atingido: escolha o comportamento de sua preferência. Estas são as opções:
     • Erro: o fluxo de trabalho apresentará um erro e interromperá o processamento.
     • Aviso: emite uma mensagem de aviso e envia para a saída os registros restantes.
     • Fazer a saída dos registros restantes: envia todos os registros para a saída.
   • Modo de saída: os registros são unidos na saída. Escolha o comportamento preferencial para unir esses registros, pois alguns podem ter um esquema de tabela diferente. Estas são as opções:
     • Todas as iterações terão o mesmo esquema de saída (gerar erro se for diferente): se o esquema for o mesmo exceto pelo nomes dos campos, o usuário receberá um aviso, mas o processo continuará. Um erro só será gerado se houver diferenças nos tipos, tamanhos ou número de campos.
     • Configurar automaticamente por nome (aguardar todas as iterações serem executadas)
     • Configurar automaticamente por posição (aguardar todas as iterações serem executadas)