Skip to main content

Macro de lote

Uma macro de lote é executada múltiplas vezes em um fluxo de trabalho, gerando uma saída após cada execução. A macro é executada uma vez para cada registro (ou para cada grupo de registros) nos dados. As entradas podem ser configuradas para utilização em cada execução do fluxo de trabalho ou apenas em execuções específicas.

Conecte uma  ferramenta Parâmetro de Controle para configurar uma macro de lote. Macros de lote com mais de uma ferramenta Parâmetro de Controle exibem uma guia com opções de entrada para os usuários. Essa guia não é exibida no designer de interface para os criadores das macros.

Criar uma macro de lote

  1. Na guia Configuração do fluxo de trabalho , na seção Tipo , selecione Macro  > Macro de lote . Depois que o fluxo de trabalho é salvo como uma macro de lote, cada ferramenta contida nele recebe uma âncora em formato de raio. Somente as ferramentas da categoria Interface podem se conectar a essas âncoras.

  2. Configure a ferramenta Parâmetro de Controle conectada.

  3. Configure as propriedades da macro de lote por meio da janela do designer de interface  (Ctrl+Alt+D) ou acessando o menu Exibir  > Designer de interface . Selecione o ícone de engrenagem para exibir as Propriedades .

    • Escolha um Ícone padrão  ou, caso queira carregar um ícone próprio, clique em Ícone personalizado .

    • Ajuda: usar arquivo ou hiperlink : adicione um caminho relativo ou URL para um tópico personalizado de ajuda referente a um aplicativo ou macro. A página padrão de ajuda é Aplicativos analíticos ou Macros . O tópico referenciado é exibido quando um usuário pressiona F1 ou seleciona a ferramenta e clica no ícone de ajuda na janela Configuração .

    • Os campos de saída mudam com base na configuração da macro ou na entrada de dados : selecione essa opção para que a macro armazene os campos de saída da execução anterior. Para redefinir os campos de saída para o valor padrão, altere a configuração da macro.

      Selecione essa opção caso haja alteração nos campos de saída com base nos dados passados para a macro. Não selecione essa opção caso os campos de saída sejam alterados somente com base em campos de entrada ou respostas a perguntas.

    • Modo de saída : uma macro de lote é executada do início ao fim para cada registro que passa por ela e, depois, todas essas iterações são unidas. É necessário definir como essa união deve ser processada caso o esquema mude de uma iteração para a outra.

      • Todas as iterações terão o mesmo esquema de saída (gerar erro se for diferente) : essa é a opção mais simples. O Alteryx usa o esquema da primeira execução e pressupõe que o restante será igual. Em caso de divergências, é exibido um erro. A vantagem dessa opção é que não é preciso esperar todos os registros serem recebidos para começar a enviar os dados para as próximas etapas.

      • Configurar automaticamente por nome (aguardar todas as iterações serem executadas) : espera até que todas as iterações tenham sido executadas e combina os esquemas de acordo com os nomes dos campos. Se os tipos de campo forem diferentes, será escolhido um que consiga armazenar todos os valores.

      • Configurar automaticamente por posição (aguardar todas as iterações serem executadas) : funciona como a configuração por nome, mas a correspondência entre os campos é feita com base em suas posições nos dados. Os nomes de campo são definidos com base na primeira iteração que tiver um campo naquela posição.

Entradas adicionais

Algumas macros de lote têm entradas adicionais. Se forem especificadas entradas adicionais, será exibida uma guia chamada Agrupar por . Por padrão, não é especificado um agrupamento e cada iteração do fluxo de trabalho obtém todos os registros das entradas adicionais. Quando um agrupamento é especificado, as entradas adicionais só recebem registros que correspondem ao campo de agrupamento de controle dessa iteração.