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 no fluxo de trabalho > tag do caminho 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>"