Usar aplicativos Alteryx convertidos
O PlaidCloud converte as perguntas de um aplicativo analítico 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 de etapas posteriores.
O Front-End do App Runner
Seção intitulada “O Front-End do App Runner”Converter um aplicativo analítico do Alteryx (.yxwz) também materializa a interface dele
como um “App Runner” publicado do Panel: 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 se tornam 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 de 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 está vinculado a uma variável de fluxo de trabalho real é exibido com uma observação visível, em vez de coletar silenciosamente um valor que não leva 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, com as guias e as caixas rotuladas com que o autor criou o aplicativo, e o texto explicativo do autor (as ferramentas Label do Alteryx) é exibido no formulário junto às 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 salvado 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 ser exibido como uma seleção obsoleta. Uma pergunta numérica aplica o mínimo, o máximo e o passo definidos pelo autor, de modo que uma pergunta restrita a um intervalo pequeno não possa ser respondida fora dele.
Quando o fluxo de trabalho convertido se ramifica, 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 mesma forma que o aplicativo Alteryx o escolhia.
Perguntas de Arquivo e Pasta
Seção intitulada “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.
- O 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 nos níveis. Escolher uma pasta na lista a abre; escolher um arquivo o seleciona.
- Selecionar mostra o caminho que ele vai preencher antes de você pressioná-lo. Sem nada destacado, Selecionar usa a pasta que você está vendo, e é assim que você escolhe o nível superior de uma conta.
- Se não for possível listar uma pasta, 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 recebe resposta em 20 segundos informa que a conta não respondeu.
Executar o Aplicativo
Seção intitulada “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, em que somente os Arquitetos podem alterá-lo. Para alterar os valores com que o formulário abre, salve-os no fluxo de trabalho, conforme 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 identificadas, em vez de serem descobertas no meio de uma execução que pode levar boa 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 no momento. Pausar e Parar aparecem ao lado de Executar somente enquanto uma execução está em andamento;
Pausar se torna Retomar enquanto a execução está pausada.
Uma etapa que falha é identificada 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 mostradas separadamente como não executadas, em vez de como falhas, e ainda contam para a barra de progresso, de modo que ela 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. Ele funciona mesmo que a própria visão do formulário sobre uma execução tenha parado de ser atualizada.
Você ainda pode executar o fluxo de trabalho diretamente definindo as variáveis dele, conforme descrito abaixo; o App Runner é uma forma adicional, no estilo de aplicativo, de acessá-lo.
Manter o Aplicativo Atualizado
Seção intitulada “Manter o Aplicativo Atualizado”Um aplicativo do 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 assumem 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
Aplicativos.
As configurações do aplicativo e o fluxo de trabalho dele não são alterados.
- Onde ficam os arquivos. Na conexão gerenciada do PlaidCloud Git, um aplicativo do
App Runner é uma pasta com o nome do aplicativo dentro do repositório
appsdo seu espaço de trabalho, ao lado dos seus outros aplicativos Panel. Um aplicativo que tinha repositório próprio é movido automaticamente para a sua pasta, e o repositório antigo é arquivado (mantido somente leitura, nunca excluído). Um push paraappsrecompila um aplicativo somente quando a pasta dele, ou orequirements.txtda raiz do repositório, mudou. - 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.pyerequirements.txtatuais por cima das suas alterações. O histórico do aplicativo no Git mantém as versões anteriores.
Tipos de Entrada Convertidos
Seção intitulada “Tipos de Entrada Convertidos”O PlaidCloud converte os controles comuns de aplicativos Alteryx em entradas de fluxo de trabalho tipadas:
- As caixas de texto se tornam variáveis de texto.
- Os controles numéricos se tornam variáveis numéricas.
- Os controles de data se tornam 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 se tornam variáveis de escolha controlada.
- Os controles de procura de arquivo se tornam variáveis de arquivo de Documentos.
- Os controles de procura de pasta se tornam variáveis de pasta de Documentos.
O fluxo de trabalho convertido usa essas variáveis em qualquer lugar em que o aplicativo Alteryx usava 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 um 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 da dependência importada ou para outro caminho de Documentos aprovado.
- Executar o fluxo de trabalho.
Para execuções agendadas, salve os valores das variáveis que devem ser usados sempre 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 erro de aplicativos 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 exigir.
- Direcionar a execução por um branch diferente.
Use esse comportamento para preservar a validação no nível do aplicativo ao executar o fluxo de trabalho no PlaidCloud.
Entradas de Arquivo e Pasta
Seção intitulada “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 de desktop 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
Seção intitulada “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 para o fluxo de trabalho de macro gerado por meio do tratamento de parâmetros de entrada e de controle da macro.
As execuções simultâneas de macro são isoladas, de modo que 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
Seção intitulada “Lista de Verificação de Validação”Para cada aplicativo convertido, confirme que:
- Toda pergunta esperada aparece como uma variável de fluxo de trabalho.
- Os padrões correspondem ao aplicativo original onde havia padrões 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 é aprovada para os valores de variáveis selecionados.