Utilizar aplicações do Alteryx convertidas

O PlaidCloud converte as perguntas das aplicações analíticas do Alteryx em variáveis de fluxo de trabalho controladas. Os utilizadores podem definir essas variáveis antes de uma execução e, depois, o PlaidCloud aplica os valores a fórmulas, filtros, caminhos de ficheiros, condições, parâmetros de macros e definições de passos a jusante.

A interface App Runner

Converter uma aplicação analítica do Alteryx (.yxwz) também materializa a sua interface como um “App Runner” Panel publicado: um formulário de entrada funcional que recolhe os mesmos valores que as perguntas do Alteryx e executa o fluxo de trabalho convertido com eles. Obtém esta interface automaticamente como parte da conversão; uma aplicação sem widgets de entrada é ignorada.

As perguntas da aplicação tornam-se controlos do App Runner: texto, numérico, data, caixa de verificação, botão de opção, lista pendente, caixa de lista, árvore, procura de ficheiros e procura de pastas. Cada controlo escreve na variável do fluxo de trabalho que o passo convertido lê, pelo que uma execução a partir do App Runner aciona a mesma lógica que definir as variáveis manualmente. Um controlo que não está associado a uma variável de fluxo de trabalho real é apresentado com uma nota visível em vez de recolher silenciosamente um valor que não vai a lado nenhum; reveja-o e aponte-o para a variável pretendida.

O formulário é organizado segundo o agrupamento do próprio autor da aplicação, os separadores e as caixas com etiqueta com que o autor construiu a aplicação, e o texto explicativo do autor (ferramentas Label do Alteryx) é apresentado no formulário junto às perguntas que descreve. Uma pergunta que a aplicação fixou na altura da conceção, como um Detour sem pergunta de interface a controlá-lo, não é apresentada como pergunta.

O formulário abre com os valores guardados nas variáveis do fluxo de trabalho (os predefinidos do autor, a menos que alguém tenha guardado outros), e uma pergunta sem valor guardado fica em branco. Se um valor guardado já não corresponder a uma das escolhas de uma pergunta, é ignorado em vez de apresentado como seleção desatualizada. Uma pergunta numérica aplica o mínimo, o máximo e o incremento que o autor definiu, pelo que uma pergunta limitada a um intervalo pequeno não pode ser respondida fora dele.

Quando o fluxo de trabalho convertido se ramifica, o App Runner apresenta o ramo como uma escolha com etiqueta, pelo que o caminho que uma execução segue é escolhido em tempo de execução tal como a aplicação do Alteryx o escolhia.

Perguntas de ficheiros e pastas

Cada pergunta de ficheiro ou pasta tem um botão Procurar que abre um navegador de documentos, para que escolha o caminho em vez de o escrever de memória.

Procurar oferece as contas de documentos a que tem acesso, predefinindo a conta da própria aplicação, e permite alternar entre elas.
Abre na pasta que a resposta atual da pergunta indica; se a pergunta ainda não tem resposta, abre no topo da conta.
Um trilho no topo permite subir. Escolher uma pasta na lista abre-a; escolher um ficheiro seleciona-o.
Selecionar mostra o caminho que vai preencher antes de o premir. Sem nada realçado, Selecionar assume a pasta que está a ver: é assim que escolhe o nível superior de uma conta.
Se uma pasta não puder ser listada, a lista di-lo e indica o motivo, e Selecionar não preenche um caminho que não tenha visto. Uma listagem que não obtém resposta em 20 segundos indica que a conta não respondeu.

Executar a aplicação

Preencha o formulário e prima Executar.

As suas respostas acompanham a execução e valem apenas para essa execução. Nunca são guardadas no fluxo de trabalho, pelo que as respostas de uma pessoa nunca chegam à execução de outra pessoa, e executar a aplicação não exige o direito de alterar o fluxo de trabalho, o que é relevante num projeto que restringe linhas, onde só os seus Arquitetos o podem alterar. Para alterar os valores com que o formulário abre, guarde-os no fluxo de trabalho, como abaixo.

As respostas são verificadas antes de a execução começar. As perguntas de escolha que nunca foram respondidas impedem a execução antes de começar e são indicadas, em vez de serem descobertas a meio de uma execução que pode demorar a melhor parte de uma hora.

Enquanto uma execução decorre, o formulário apresenta uma barra de progresso, N of M steps contados face ao número total de passos do fluxo de trabalho, o tempo decorrido e o passo ou passos em execução neste momento. Pausar e Parar aparecem junto a Executar apenas enquanto uma execução decorre; Pausar passa a Retomar enquanto a execução está em pausa.

Um passo que falha é indicado no formulário assim que falha e, quando a execução termina, o formulário cita o que cada passo falhado disse. Não tem de abrir o fluxo de trabalho para descobrir por que motivo parou. Os passos que não puderam ser executados porque um passo anterior falhou são apresentados em separado como não executados em vez de como falhas, e continuam a contar para a barra de progresso, que assim chega ao fim.

Uma execução continua se fechar a página ou perder a ligação. Abrir a aplicação novamente enquanto essa execução ainda decorre mostra a execução em curso, com Pausar e Parar, em vez de um formulário inativo.

Uma ligação Abrir fluxo de trabalho junto a Executar abre o fluxo de trabalho subjacente no PlaidCloud num novo separador, na sua área de desenho quando é um fluxo de trabalho DAG. Funciona mesmo que a própria vista do formulário de uma execução tenha deixado de ser atualizada.

Pode continuar a executar o fluxo de trabalho diretamente definindo as suas variáveis, como abaixo; o App Runner é uma forma adicional, ao estilo de aplicação, de aceder.

Manter a aplicação atualizada

Uma aplicação App Runner é uma aplicação de servidor Panel cujos app.py, widget_map.py e requirements.txt o PlaidCloud gera. Quando o PlaidCloud atualiza o App Runner, as suas aplicações existentes assumem a nova versão por si: cada uma é atualizada para os ficheiros atuais e recompilada na próxima atualização do PlaidCloud, e novamente sempre que Recompilar ou editar a aplicação no ecrã As minhas aplicações Panel. As definições da aplicação e o seu fluxo de trabalho não são tocados.

Uma aplicação bloqueada é deixada como está. Desbloqueie-a e clique em Recompilar para a atualizar.
As edições manuais aos ficheiros gerados são substituídas. Uma atualização escreve os app.py, widget_map.py e requirements.txt atuais por cima das suas alterações. O histórico Git da aplicação mantém as versões anteriores.

Tipos de entrada convertidos

O PlaidCloud converte os controlos comuns de aplicações do Alteryx em entradas de fluxo de trabalho tipificadas:

As caixas de texto tornam-se variáveis de texto.
Os controlos numéricos tornam-se variáveis numéricas.
Os controlos de data tornam-se variáveis de data ISO.
As caixas de verificação, os botões de opção, as listas pendentes, as caixas de lista e as árvores tornam-se variáveis de escolha controlada.
Os controlos de procura de ficheiros tornam-se variáveis de ficheiro de Document.
Os controlos de procura de pastas tornam-se variáveis de pasta de Document.

O fluxo de trabalho convertido utiliza estas variáveis em qualquer local onde a aplicação do Alteryx utilizava o valor da pergunta original.

Definir valores antes de uma execução

Antes de executar o fluxo de trabalho de uma aplicação convertida:

Abra o fluxo de trabalho convertido.
Reveja as variáveis do fluxo de trabalho.
Defina os valores necessários de texto, numéricos, de data, de escolha, de ficheiro e de pasta.
Confirme que os caminhos de ficheiros e pastas de Document apontam para a localização das dependências importadas ou para outro caminho de Document aprovado.
Executar o fluxo de trabalho.

Para execuções agendadas, guarde os valores das variáveis que devem ser utilizados de cada vez que o agendamento é executado.

Condições, avisos e erros

As condições e verificações de erro das aplicações do Alteryx são convertidas em condições de passos do PlaidCloud. Uma condição pode:

Permitir que o fluxo de trabalho continue.
Emitir uma mensagem de aviso.
Parar o fluxo de trabalho com um erro claro quando a regra da aplicação o exigir.
Encaminhar a execução por um ramo diferente.

Utilize este comportamento para preservar a validação ao nível da aplicação enquanto executa o fluxo de trabalho no PlaidCloud.

Entradas de ficheiros e pastas

As perguntas de ficheiros e pastas utilizam caminhos de Document:

As entradas de ficheiro selecionam um ficheiro de Document.
As entradas de pasta selecionam uma pasta de Document.
As dependências importadas do ambiente de trabalho são armazenadas no caminho de Document selecionado durante a importação.
Os passos de entrada dinâmica podem utilizar variáveis para resolver o caminho final de Document em tempo de execução.

Isto mantém as aplicações convertidas portáteis entre utilizadores e execuções agendadas.

Parâmetros de macros

Quando uma aplicação convertida chama uma macro, as variáveis da aplicação podem alimentar os parâmetros da macro. O PlaidCloud passa esses valores para o fluxo de trabalho da macro gerado através do tratamento de entradas de macro e de parâmetros de controlo.

As execuções simultâneas de macros são isoladas, pelo que várias execuções de fluxos de trabalho podem utilizar a mesma macro convertida sem partilhar estado intermédio.

Lista de verificação da validação

Para cada aplicação convertida, confirme que:

Todas as perguntas esperadas aparecem como variável do fluxo de trabalho.
Os valores predefinidos coincidem com os da aplicação original onde foram configurados valores predefinidos.
As listas controladas contêm as escolhas esperadas.
As variáveis de ficheiro e de pasta apontam para caminhos de Document.
As condições produzem as mensagens, os avisos ou o comportamento de paragem esperados.
A paridade dos resultados é aprovada para os valores de variáveis selecionados.