Skip to main content

Executar fluxos de trabalho por linha de comando

Você pode executar fluxos de trabalho através da linha de comando com o AlteryxEngineCmd.exe, localizado no diretório raiz de arquivos de programa da Alteryx. É necessário ter uma licença de Engine API para usar o AlteryxEngineCmd.exe.

Exemplo

Execute o aplicativo analítico contido na tag Workflow > Path do AppValues.xml.

AlteryxEngineCmd.exe MyWorkflow.yxmd

AlteryxEngineCmd.exe MyAnalyticApp.yxwz AppValues.xml

AlteryxEngineCmd.exe AppValues.xml

Exemplo de valores de retorno:

  • 0: Sucesso

  • 1: Existem avisos

  • 2: Existem erros

Para executar fluxos de trabalho através da linha de comando, adicione o caminho raiz do Alteryx às variáveis do sistema de caminho no computador.

O acesso às variáveis do sistema varia entre os sistemas operacionais. Este é o processo geral:

  1. Na área de trabalho, acesse as opções de segurança do sistema do computador.

  2. Acesse as opções avançadas.

  3. Acesse as variáveis ambientais.

  4. Acesse a variável de caminho.

  5. Para editar a variável, insira ou cole o caminho do Alteryx. O caminho padrão é C:\Program Files\Alteryx\bin.

Use este método, a menos que execute o AlteryxEngineCmd.exe a partir da pasta raiz do Alteryx, ou use o caminho completo para o executável:

"C:\Program Files\Alteryx\bin\AlteryxEngineCmd.exe" MyWorkflow.yxmd

Opções do motor

AlteryxEngineCmd.exe é uma interface de linha de comando publicada. Você pode invocá-la para executar um fluxo de trabalho ou um aplicativo analítico.

Se um fluxo de trabalho foi salvo sem o AMP Engine habilitado, há uma opção /amp que permite executar um fluxo de trabalho ou aplicativo analítico usando o AMP Engine na plataforma Windows. A opção /amp tem o mesmo efeito que a caixa de seleção Usar AMP Engine na guia Tempo de execução na janela de configuração do fluxo de trabalho na interface do Designer.

Se você não especificar o motor, a versão que estava definida quando o fluxo de trabalho foi salvo será usada.

Funções

Fluxos de trabalho

AlteryxEngineCmd.exe MyWorkflow.yxmd

Esta função executa um fluxo de trabalho padrão do Alteryx (.yxmd) na linha de comando. É útil para uma série de fluxos de trabalho em lote que precisam ser executados em sequência.

Exemplo

  • AlteryxEngineCmd.exe MyWorkflow1.yxmd

  • AlteryxEngineCmd.exe MyWorkflow2.yxmd

  • AlteryxEngineCmd.exe MyWorkflow3.yxmd

Aplicativos analíticos

AlteryxEngineCmd.exe MyAnalyticApp.yxwz AppValues.xml

Esta função executa um aplicativo analítico (.yxwz) e usa os parâmetros no AppValues.xml para configurar o aplicativo analítico dinamicamente.

A maneira mais fácil de construir o arquivo AppValues.xml é criar um aplicativo analítico na interface do Alteryx. Após construir o aplicativo, abra Designer de interface > Visualização de teste > Visualização. Cole o XML em um editor de texto e salve o arquivo como XML.

Exemplo

"<WizardValues ShowDebugMessages='False'> <Value name='FILEINPUT'>TEST.CSV</Value> </WizardValues>"

AlteryxEngineCmd.exe AppValues.xml

Esta função é idêntica à opção acima, exceto que, em vez dos parâmetros YXWZ e XML, usa o parâmetro XML e incorpora a referência YXWZ no XML.

Exemplo

"<WizardValues ShowDebugMessages='False'> <Module>MyAnalyticApp.yxwz</Module> <Value name='FILEINPUT'>TEST.CSV</Value> </WizardValues>"

AlteryxEngineCmd.exe "<<fluxo de dados xml bruto sem aspas ou quebras de linha>>"

Esta função inclui as respostas a perguntas em um aplicativo analítico. O XML em um aplicativo analítico contém respostas às perguntas do aplicativo.

Exemplo

AlteryxEngineCmd.exe "<WizardValues ShowDebugMessages='False'><Module>MyAnalyticApp.yxwz</Module><Value name='FILEINPUT'>TEST.CSV</Value></WizardValues>"