Pular para o conteúdo

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.

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.

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.

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.

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 apps da 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 para apps recompila uma aplicação apenas quando a sua própria pasta, ou o requirements.txt na 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.py e requirements.txt por cima das suas alterações. O histórico Git da aplicação mantém as versões anteriores.

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.

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

  1. Abra o fluxo de trabalho convertido.
  2. Reveja as variáveis do fluxo de trabalho.
  3. Defina os valores obrigatórios de texto, numéricos, de data, de escolha, de ficheiro e de pasta.
  4. 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.
  5. 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.

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.

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.

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.

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.