Utilizar aplicações Alteryx convertidas
O PlaidCloud converte as perguntas das aplicações analíticas 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.
O front-end do App Runner
Seção intitulada “O front-end do App Runner”Converter uma aplicação analítica 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 este front-end 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 esteja 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 está organizado segundo o agrupamento do próprio autor da aplicação, ou seja, os separadores e as caixas com etiqueta com que o autor criou a aplicação, e o texto explicativo do autor (ferramentas Label do Alteryx) é apresentado no formulário junto das perguntas que descreve. Uma pergunta que a aplicação fixou na fase de conceção, como um Detour sem nenhuma 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 (as predefinições 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 nenhuma das opções de uma pergunta, é ignorado em vez de ser apresentado como uma seleção desatualizada. Uma pergunta numérica impõe o mínimo, o máximo e o incremento definidos pelo autor, pelo que uma pergunta limitada a um intervalo reduzido não pode ser respondida fora dele.
Quando o fluxo de trabalho convertido se ramifica, o App Runner apresenta o ramo como uma escolha etiquetada, de modo que o caminho seguido por uma execução é escolhido no momento da execução, tal como a aplicação Alteryx o escolhia.
Perguntas de ficheiro e de pasta
Seção intitulada “Perguntas de ficheiro e de pasta”Cada pergunta de ficheiro ou de 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, com a conta da própria aplicação como predefinição, e permite alternar entre elas.
- Abre na pasta que a resposta atual da pergunta indica; se a pergunta ainda não tiver resposta, abre no topo da conta.
- Um trilho no topo permite subir novamente. 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 não for possível listar uma pasta, a lista indica-o e refere o motivo, e Selecionar não preencherá um caminho que não viu. Uma listagem que não obtenha resposta em 20 segundos indica que a conta não respondeu.
Executar a aplicação
Seção intitulada “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, e executar a aplicação não requer o direito de alterar o fluxo de trabalho, o que é importante num projeto que restringe linhas, onde apenas os respetivos Arquitetos o podem alterar. Para alterar os valores com que o formulário abre, guarde-os no fluxo de trabalho, como indicado abaixo.
As respostas são verificadas antes de a execução começar. As perguntas de escolha que nunca foram respondidas impedem o arranque da execução e são indicadas pelo nome, em vez de serem descobertas a meio de uma execução que pode demorar quase uma hora.
Enquanto uma execução decorre, o formulário mostra uma barra de progresso,
N of M steps contado em relação 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 pelo nome no formulário assim que falha e, quando a execução termina, o formulário cita o que cada passo falhado indicou. Não tem de abrir o fluxo de trabalho para descobrir porque parou. Os passos que não puderam ser executados porque um passo anterior falhou são apresentados separadamente como não executados, em vez de falhas, e contam na mesma 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 novamente a aplicação 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 respetiva área de desenho quando é um fluxo de trabalho DAG. Funciona mesmo que a vista própria do formulário sobre uma execução tenha deixado de ser atualizada.
Pode continuar a executar o fluxo de trabalho diretamente definindo as respetivas variáveis, como indicado abaixo; o App Runner é uma forma adicional, ao estilo de aplicação, de lhe aceder.
Manter a aplicação atualizada
Seção intitulada “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 são gerados pelo PlaidCloud. Quando o
PlaidCloud atualiza o App Runner, as suas aplicações existentes passam para 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 utilizar
Recompilar ou editar a aplicação no ecrã
Aplicações.
As definições da aplicação e o respetivo fluxo de trabalho não são alterados.
- Onde residem os ficheiros. Na ligação PlaidCloud Git gerida, uma aplicação
App Runner é uma pasta com o nome da aplicação dentro do repositório
appsda sua área de trabalho, junto das suas outras aplicações Panel. Uma aplicação que tinha um repositório próprio é movida automaticamente para a sua pasta, e o repositório antigo é arquivado (mantido só de leitura, nunca eliminado). Um envio paraappsrecompila uma aplicação apenas quando a sua própria pasta, ou orequirements.txtna raiz do repositório, foi alterada. - 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 atuais
app.py,widget_map.pyerequirements.txtpor cima das suas alterações. O histórico Git da aplicação mantém as versões anteriores.
Tipos de entrada convertidos
Seção intitulada “Tipos de entrada convertidos”O PlaidCloud converte os controlos comuns das aplicações Alteryx em entradas de fluxo de trabalho com tipo:
- 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 documentos.
- Os controlos de procura de pastas tornam-se variáveis de pasta de documentos.
O fluxo de trabalho convertido utiliza estas variáveis em todos os locais onde a aplicação Alteryx utilizava o valor da pergunta original.
Definir valores antes de uma execução
Seção intitulada “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 obrigatórios de texto, numéricos, de data, de escolha, de ficheiro e de pasta.
- Confirme que os caminhos de ficheiros e pastas de documentos apontam para a localização das dependências importadas ou para outro caminho de documentos aprovado.
- Execute o fluxo de trabalho.
Para execuções agendadas, guarde os valores das variáveis que devem ser utilizados de cada vez que o agendamento for executado.
Condições, avisos e erros
Seção intitulada “Condições, avisos e erros”As condições e as verificações de erros das aplicações Alteryx são convertidas em condições de passo 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 ficheiro e de pasta
Seção intitulada “Entradas de ficheiro e de pasta”As perguntas de ficheiro e de pasta utilizam caminhos de documentos:
- As entradas de ficheiro selecionam um ficheiro a partir de documentos.
- As entradas de pasta selecionam uma pasta de documentos.
- As dependências de ambiente de trabalho importadas são armazenadas no caminho de documentos selecionado durante a importação.
- Os passos de entrada dinâmica podem utilizar variáveis para resolver o caminho final de documentos no momento da execução.
Isto mantém as aplicações convertidas portáteis entre utilizadores e execuções agendadas.
Parâmetros de macros
Seção intitulada “Parâmetros de macros”Quando uma aplicação convertida invoca uma macro, as variáveis da aplicação podem alimentar os parâmetros da macro. O PlaidCloud transmite esses valores ao fluxo de trabalho da macro gerado através do tratamento de parâmetros de entrada e de controlo da macro.
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 de validação
Seção intitulada “Lista de verificação de validação”Para cada aplicação convertida, confirme que:
- Todas as perguntas esperadas aparecem como uma variável de fluxo de trabalho.
- As predefinições correspondem à aplicação original onde foram configuradas predefinições.
- As listas controladas contêm as opções esperadas.
- As variáveis de ficheiro e de pasta apontam para caminhos de documentos.
- As condições produzem as mensagens, os avisos ou o comportamento de paragem esperados.
- A paridade dos resultados passa para os valores de variáveis selecionados.