Usar aplicativos do Alteryx convertidos

O PlaidCloud converte as perguntas dos aplicativos analíticos do Alteryx em variáveis de fluxo de trabalho controladas. Os usuários podem definir essas variáveis antes de uma execução, e então o PlaidCloud aplica os valores a fórmulas, filtros, caminhos de arquivo, condições, parâmetros de macro e configurações das etapas seguintes.

O front-end App Runner

Converter um aplicativo analítico do Alteryx (.yxwz) também materializa a interface dele como um “App Runner” do Panel publicado — um formulário de entrada funcional que coleta os mesmos valores que as perguntas do Alteryx coletavam e executa o fluxo de trabalho convertido com eles. Você recebe esse front-end automaticamente como parte da conversão; um aplicativo sem widgets de entrada é ignorado.

As perguntas do aplicativo viram controles do App Runner: texto, numérico, data, caixa de seleção, botão de opção, lista suspensa, caixa de listagem, árvore, procura de arquivo e procura de pasta. Cada controle grava na variável do fluxo de trabalho que a etapa convertida lê, de modo que uma execução a partir do App Runner aciona a mesma lógica que definir as variáveis manualmente. Um controle que não se vincula a uma variável real do fluxo de trabalho é exibido com uma observação visível em vez de coletar silenciosamente um valor que não vai a lugar nenhum — revise-o e aponte-o para a variável pretendida.

O formulário é organizado no agrupamento do próprio autor do aplicativo — as guias e as caixas rotuladas com que o autor montou o aplicativo — e o texto explicativo do autor (ferramentas Label do Alteryx) é exibido no formulário ao lado das perguntas que descreve. Uma pergunta que o aplicativo fixou em tempo de design, como um Detour sem nenhuma pergunta de interface que o controle, não é exibida como pergunta.

O formulário abre com os valores salvos nas variáveis do fluxo de trabalho — os padrões do autor, a menos que alguém tenha salvo outros — e uma pergunta sem valor salvo fica em branco. Se um valor salvo não corresponder mais a uma das opções de uma pergunta, ele é ignorado em vez de exibido como uma seleção obsoleta. Uma pergunta numérica impõe o mínimo, o máximo e o passo que o autor definiu, de modo que uma pergunta restrita a um intervalo pequeno não pode ser respondida fora dele.

Onde o fluxo de trabalho convertido tem ramificações, o App Runner mostra a ramificação como uma escolha rotulada, de modo que o caminho que uma execução segue é escolhido em tempo de execução, da forma como o aplicativo do Alteryx o escolhia.

Perguntas de arquivo e pasta

Cada pergunta de arquivo ou pasta tem um botão Procurar que abre um navegador de documentos, para que você escolha o caminho em vez de digitá-lo de memória.

Procurar oferece as contas de documentos que você pode acessar, usando por padrão a conta do próprio aplicativo, e permite alternar entre elas.
Ele abre na pasta que a resposta atual da pergunta indica; se a pergunta ainda não tem resposta, ele abre no topo da conta.
Uma trilha na parte superior permite voltar. Escolher uma pasta na lista a abre; escolher um arquivo o seleciona.
Selecionar mostra o caminho que será preenchido antes de você pressioná-lo. Sem nada destacado, Selecionar usa a pasta que você está vendo — é assim que você escolhe o nível superior de uma conta.
Se uma pasta não puder ser listada, a lista informa isso e indica o motivo, e Selecionar não preencherá um caminho que você não viu. Uma listagem que não obtém resposta em 20 segundos informa que a conta não respondeu.

Executar o aplicativo

Preencha o formulário e pressione Executar.

Suas respostas acompanham a execução e valem somente para ela. Elas nunca são salvas no fluxo de trabalho, então as respostas de uma pessoa nunca chegam à execução de outra, e executar o aplicativo não exige direito de alterar o fluxo de trabalho — o que importa em um projeto que restringe linhas, no qual somente os Arquitetos podem alterá-lo. Para alterar os valores com que o formulário abre, salve-os no fluxo de trabalho, como descrito abaixo.

As respostas são verificadas antes de a execução começar. As perguntas de escolha que nunca foram respondidas interrompem a execução antes que ela comece e são nomeadas, em vez de serem descobertas no meio de uma execução que pode levar a maior parte de uma hora.

Enquanto uma execução está em andamento, o formulário mostra uma barra de progresso, N of M steps contado em relação ao total de etapas do fluxo de trabalho, o tempo decorrido e a etapa ou as etapas em execução agora. Pausar e Parar aparecem ao lado de Executar somente enquanto uma execução está em andamento; Pausar vira Retomar enquanto a execução está pausada.

Uma etapa que falha é nomeada no formulário assim que falha, e quando a execução termina o formulário cita o que cada etapa com falha informou. Você não precisa abrir o fluxo de trabalho para descobrir por que ele parou. As etapas que não puderam ser executadas porque uma etapa anterior falhou são exibidas separadamente como não executadas, e não como falhas, e ainda contam para a barra de progresso, que assim chega ao fim.

Uma execução continua se você fechar a página ou perder a conexão. Abrir o aplicativo novamente enquanto essa execução ainda está em andamento mostra a execução em curso, com Pausar e Parar, em vez de um formulário ocioso.

Um link Abrir fluxo de trabalho ao lado de Executar abre o fluxo de trabalho subjacente no PlaidCloud em uma nova guia — na tela dele, quando é um fluxo de trabalho DAG. Funciona mesmo que a visão do próprio formulário sobre uma execução tenha parado de ser atualizada.

Você ainda pode executar o fluxo de trabalho diretamente definindo suas variáveis, como descrito abaixo; o App Runner é uma forma adicional, no estilo de aplicativo, de acessá-lo.

Manter o aplicativo atualizado

Um aplicativo App Runner é um aplicativo de servidor Panel cujos app.py, widget_map.py e requirements.txt o PlaidCloud gera. Quando o PlaidCloud atualiza o App Runner, seus aplicativos existentes adotam a nova versão por conta própria: cada um é atualizado para os arquivos atuais e recompilado na próxima atualização do PlaidCloud, e novamente sempre que você usa Recompilar ou edita o aplicativo na tela Meus aplicativos Panel. As configurações do aplicativo e o fluxo de trabalho dele não são alterados.

Um aplicativo bloqueado é deixado como está. Desbloqueie-o e clique em Recompilar para atualizá-lo.
As edições manuais nos arquivos gerados são substituídas. Uma atualização grava os app.py, widget_map.py e requirements.txt atuais sobre as suas alterações. O histórico do Git do aplicativo mantém as versões anteriores.

Tipos de entrada convertidos

O PlaidCloud converte os controles comuns de aplicativos do Alteryx em entradas tipadas do fluxo de trabalho:

As caixas de texto viram variáveis de texto.
Os controles numéricos viram variáveis numéricas.
Os controles de data viram variáveis de data ISO.
As caixas de seleção, os botões de opção, as listas suspensas, as caixas de listagem e as árvores viram variáveis de escolha controlada.
Os controles de procura de arquivo viram variáveis de arquivo de Documentos.
Os controles de procura de pasta viram variáveis de pasta de Documentos.

O fluxo de trabalho convertido usa essas variáveis em qualquer lugar em que o aplicativo do Alteryx usava o valor original da pergunta.

Definir valores antes de uma execução

Antes de executar um fluxo de trabalho de aplicativo convertido:

Abra o fluxo de trabalho convertido.
Revise as variáveis do fluxo de trabalho.
Defina os valores obrigatórios de texto, numéricos, de data, de escolha, de arquivo e de pasta.
Confirme que os caminhos de arquivo e pasta de Documentos apontam para o local das dependências importadas ou para outro caminho de Documentos aprovado.
Execute o fluxo de trabalho.

Para execuções agendadas, salve os valores das variáveis que devem ser usados toda vez que o agendamento for executado.

Condições, avisos e erros

As condições e verificações de erro dos aplicativos do Alteryx são convertidas em condições de etapa do PlaidCloud. Uma condição pode:

Permitir que o fluxo de trabalho continue.
Emitir uma mensagem de aviso.
Interromper o fluxo de trabalho com um erro claro quando a regra do aplicativo assim exigir.
Direcionar a execução por uma ramificação diferente.

Use esse comportamento para preservar a validação em nível de aplicativo ao executar o fluxo de trabalho no PlaidCloud.

Entradas de arquivo e pasta

As perguntas de arquivo e pasta usam caminhos de Documentos:

As entradas de arquivo selecionam um arquivo de Documentos.
As entradas de pasta selecionam uma pasta de Documentos.
As dependências da área de trabalho importadas são armazenadas no caminho de Documentos selecionado durante a importação.
As etapas de entrada dinâmica podem usar variáveis para resolver o caminho final de Documentos em tempo de execução.

Isso mantém os aplicativos convertidos portáteis entre usuários e execuções agendadas.

Parâmetros de macro

Quando um aplicativo convertido chama uma macro, as variáveis do aplicativo podem alimentar os parâmetros da macro. O PlaidCloud passa esses valores ao fluxo de trabalho da macro gerada por meio do tratamento de entrada de macro e de parâmetros de controle.

As execuções simultâneas de macro são isoladas, então várias execuções de fluxo de trabalho podem usar a mesma macro convertida sem compartilhar estado intermediário.

Lista de verificação de validação

Para cada aplicativo convertido, confirme que:

Toda pergunta esperada aparece como uma variável do fluxo de trabalho.
Os padrões coincidem com os do aplicativo original onde padrões foram configurados.
As listas controladas contêm as opções esperadas.
As variáveis de arquivo e pasta apontam para caminhos de Documentos.
As condições produzem as mensagens, os avisos ou o comportamento de interrupção esperados.
A paridade de saída passa para os valores de variáveis selecionados.