Construir e executar com o Weave

Descrição

Pode começar a maior parte do trabalho no PlaidCloud dizendo ao Weave o que pretende, numa frase. O Weave responde com um cartão que indica exatamente o que vai construir ou alterar, e nada acontece até o aprovar. Tudo o que está nesta página acontece no painel lateral do Weave, e todos os cartões seguem as mesmas regras:

Aprova um cartão no navegador, com Aprovar 1 alteração (ou Aprovar 6 alterações), deixa tudo como está com Agora não, ou volta a pedir com Alterar….
Todas as execuções que o Weave inicia têm o lançamento no ERP desativado.
O Weave não executa, altera nem agenda um passo que escreva fora do PlaidCloud. Em vez disso, remete-o para o formulário do passo ou para o fluxo de trabalho.
O Weave só pode fazer o que a sua função permite. Se a sua função não puder fazer algo, o Weave indica-o e não altera nada.

Consulte Aprovar uma alteração para saber como se lê um cartão e como anular a alteração.

Diga ao Weave o que pretende

As caixas de diálogo que criam um projeto, um fluxo de trabalho, um passo, uma importação ou uma dimensão abrem em Tell Weave what you want: uma caixa para uma frase, com algumas sugestões de início como ligações por baixo.

Caixa de diálogo	A caixa pergunta	Sugestões de início
Novo projeto	Descreva o projeto, com um exemplo	Começar a partir de um modelo, Importar ficheiros de Documentos, Copiar um projeto
Novo fluxo de trabalho	O que deve fazer este fluxo de trabalho?	Importar um ficheiro para uma tabela, Copiar passos de outro fluxo de trabalho, Reconciliar duas tabelas
Novo passo	O que deve fazer este passo?	Importar um ficheiro, Procurar, Filtro
Importar	Que ficheiro deve tornar-se uma tabela?	Importar um ficheiro para uma tabela
Nova dimensão	O que deve conter esta dimensão?	Construir a partir da coluna de uma tabela

Escreva a frase e prima Enter. O painel lateral abre-se com a sua frase enviada. Prima Shift+Enter para uma nova linha. Em Novo projeto, Perguntar ao Weave é o botão principal assim que a caixa tem texto.

Clique em Fill in the form instead para o formulário habitual, e em Tell Weave instead para voltar à caixa. O PlaidCloud memoriza qual utilizou por último para cada tipo de objeto.

O menu Novo passo da área de desenho do fluxo de trabalho começa com Describe the step…, que abre a mesma caixa para um passo a seguir àquele em que está.

A caixa aparece quando o chat do Weave está ativado e a sua função pode criar esse objeto. Caso contrário, a caixa de diálogo mostra o formulário.

Listas e páginas vazias

Uma lista sem nada também começa a partir do Weave:

Projetos, Fluxos de trabalho, Tabelas, Dimensões e os passos de um fluxo de trabalho mostram a caixa para a frase.
Editores de dados, UDFs, Ligações e Painéis de controlo mostram um botão Perguntar ao Weave.
Uma área de desenho de um fluxo de trabalho vazia indica Este fluxo de trabalho está vazio. Diga ao Weave o que deve fazer, ou adicione um passo., com a caixa, uma sugestão de início Importar um ficheiro e Add a step.
Um projeto sem fluxos de trabalho mostra um cartão Start with Weave na respetiva Visão geral.

Os botões habituais da lista, como carregar dados de exemplo, continuam disponíveis por baixo.

Descrever um fluxo de trabalho e vê-lo a ser construído

Descreva o que um fluxo de trabalho deve fazer, como Importar freight.csv, procurar a região de cada transportadora e totalizar o frete por transportadora. O Weave responde com um único cartão de plano, com um título como, por exemplo, Construir 3 passos num novo fluxo de trabalho “Freight by Carrier” e, depois, executá-lo. Cada linha do plano indica o que faz um passo, em linguagem simples:

Importar freight.csv para uma nova tabela Freight (Carrier, Amount, Month).
Procurar Region em Carriers por Carrier.
Totalizar Amount por Carrier em Freight by Carrier.
Executar Freight by Carrier. O lançamento no ERP está desativado nesta execução.

Um plano pode importar ficheiros, extrair, procurar, juntar, unir e totalizar, e os passos posteriores podem ler as tabelas que os passos anteriores criam. A execução do fluxo de trabalho é a última linha do plano.

Quando aprova, o painel lateral mostra A criar o fluxo de trabalho, A construir o passo 2 de 3 e Em execução. Na área de desenho, cada passo aparece à medida que é criado com um contorno Built by Weave, que desaparece quando a construção termina, e uma faixa acima do fluxo de trabalho indica O Weave está a construir este fluxo de trabalho. Clique em Parar na faixa para parar. O Weave indica então o que tinha construído, como Parado a meio: foram construídos Import Freight e Lookup Region.

O Weave constrói em fluxos de trabalho avançados. Se lhe pedir que construa num fluxo de trabalho Standard, propõe construir um novo fluxo de trabalho em vez disso.
Um novo fluxo de trabalho não pode ter o nome de um que já exista.
O Weave importa ficheiros CSV, Excel, Parquet e DB2. Uma linha que o Weave não consegue construir é listada como Não adicionado: com o motivo, como um ficheiro que não existe ou que não tem linha de cabeçalho.

Executar ou agendar um fluxo de trabalho

Peça ao Weave que execute um fluxo de trabalho, ou parte de um: Executar Month-End Close a partir de Allocate by Driver. O cartão tem como título o que vai ser executado, como Executar “Month-End Close” a partir do passo “Allocate by Driver”, e lista:

Execuções — quantos passos são executados.
Escreve — as tabelas que a execução escreve.
Lançamento ERP — O lançamento no ERP está desativado nesta execução., quando há passos na execução que lançam num ERP.
Anular — Uma execução não pode ser anulada: substitui o conteúdo destas tabelas.

Num fluxo de trabalho Standard, os passos são executados por ordem, pelo que uma execução de passos que não são contíguos abrange tudo o que está entre eles, e o cartão indica-o.

Após a execução, o Weave indica como correu, como teve êxito em 4 min, com as linhas de cada tabela e se estão dentro do respetivo intervalo habitual. Se o fluxo de trabalho já estiver em execução, nada é iniciado, e o Weave indica-lhe que volte a aprovar quando terminar.

Peça ao Weave que agende um fluxo de trabalho, como Executar Month-End Close todos os dias úteis às 06:00, ou que altere, ative, desative ou elimine um dos respetivos agendamentos. O cartão de agendamento mostra Quando, as três próximas horas de execução em Seguinte, e Ativado. Uma alteração a um agendamento existente mostra-o antes e depois. Depois de aprovar, o Weave indica-lhe quando é a próxima execução.

Executar um fluxo de trabalho requer uma função que possa editar fluxos de trabalho. Alterar agendamentos requer também uma função que possa alterar a automatização do projeto.
O Weave não ativa nem altera um agendamento que lance num ERP. Indica Este agendamento lança no ERP. Ative-o em Agendamentos.
O Weave não executa nem agenda um fluxo de trabalho que envie dados para fora do PlaidCloud. Execute-o a partir do fluxo de trabalho.

Alterar ou adicionar um passo

Peça ao Weave que altere um passo, como Alterar Allocate by Driver para que divida por número de colaboradores. O cartão tem o título Alterar “Allocate by Driver”, mostra cada definição antes e depois, e termina com Depois: executar de novo Allocate by Driver com o lançamento no ERP desativado e verificar se tem êxito. Depois de aprovar, o Weave guarda a alteração, volta a executar o passo e indica-lhe o resultado. Anular, no cartão, repõe as definições.

Peça ao Weave que adicione um passo, como Adicionar um passo a seguir a Load Freight que mantenha apenas as linhas de 2026. O cartão tem o título Adicionar um passo “Freight 2026” a seguir a “Load Freight”, e uma tabela que o passo cria é assinalada com (nova tabela). Num fluxo de trabalho avançado, o passo é colocado à direita daquele a que se segue.

O Weave não altera, através de um cartão:

um passo que lance num ERP ou escreva fora do PlaidCloud;
passos SQL, como Extrair: SQL e Importar: SQL, passos de funções definidas pelo utilizador e passos que executam scripts ou Python;
nada que esvazie, remova ou elimine uma tabela ou uma dimensão.

Indica quais e remete-o para o formulário do passo. Um passo que executa outros fluxos de trabalho, ou que está em mais do que um fluxo de trabalho, não é executado de novo após a alteração. O Weave indica-lhe que o execute de novo a partir do respetivo fluxo de trabalho.

Largar um ficheiro no Weave

Arraste um ficheiro para a Visão geral de um projeto, ou para a área de desenho de um fluxo de trabalho avançado. A página indica Largue aqui um ficheiro ou um fluxo de trabalho Alteryx, carrega o ficheiro para Documentos e abre o painel lateral com um cartão para o ficheiro:

Larga	O Weave propõe
Um ficheiro de dados: CSV, TSV, TXT, Excel ou Parquet	Uma nova tabela, na Visão geral, ou um passo de importação com o nome do ficheiro, colocado onde o largou na área de desenho.
Um script SQL (`.sql`)	Passos que fazem o que o script faz. Consulte Transformar um script SQL em passos.
Um fluxo de trabalho Alteryx (`.yxmd` ou `.yxwz`)	Um novo projeto com o fluxo de trabalho convertido. Consulte Trazer fluxos de trabalho Alteryx.
Um ficheiro `.zip`	Mover os fluxos de trabalho Alteryx que contém para um novo projeto.

O Weave aceita um ficheiro de cada vez. Se largar vários, utiliza o primeiro e indica-o. Para trazer uma pasta, comprima-a em zip e largue o zip, ou carregue-a para Documentos e indique-a no painel lateral. Um ficheiro que o Weave não reconhece fica em Documentos, e o Weave indica-lhe onde.

Também pode indicar um ficheiro que já esteja em Documentos: Converter Revenue Prep.yxmd a partir de Documentos.

Transformar um script SQL em passos

Largue um ficheiro .sql, ou cole o script no painel lateral. O Weave lê-o e propõe passos padrão que fazem o mesmo trabalho, num cartão de plano como Construir 6 passos a partir de 4 instruções num novo fluxo de trabalho “Revenue Prep” e, depois, executá-lo. Se o largar numa área de desenho, os passos vão para esse fluxo de trabalho.

O cartão indica o dialeto SQL com que leu o script: Databricks, Spark, Snowflake, BigQuery, T-SQL, Oracle, PostgreSQL, MySQL ou StarRocks. Se o Weave adivinhou o dialeto e o script foi escrito para outra base de dados, indique qual e volte a pedir.

Cada linha indica o que faz um passo, como Totalizar Amount por Region em Revenue by Region. Tudo o que não pode tornar-se um passo é listado como Não adicionado: com a instrução e o motivo, por exemplo uma instrução que altera a própria base de dados, ou uma tabela que ainda não está no projeto. Uma instrução ou é convertida na totalidade ou não é adicionada: o Weave nunca constrói parte de uma.

O Weave lê scripts até 1 MB. Divida um script mais longo em vários ficheiros.
As instruções INSERT, UPDATE, DELETE e MERGE tornam-se passos que escrevem novas tabelas ou atualizam uma. O Weave não esvazia tabelas, pelo que um DELETE sem WHERE não é adicionado.
Uma tabela que o script cria é utilizada pelas instruções que se lhe seguem. Qualquer outra tabela que o script leia já tem de estar no projeto.
Tal como em qualquer plano, o Weave constrói em fluxos de trabalho avançados, e a execução no fim tem o lançamento no ERP desativado.

Trazer fluxos de trabalho Alteryx

Um fluxo de trabalho

Largue um fluxo de trabalho Alteryx (.yxmd ou .yxwz) na Visão geral de um projeto, ou indique um que esteja em Documentos. O cartão Converter “Revenue Prep” num novo projeto mostra:

Nome do projeto — Revenue Prep (from Alteryx). O cartão cria um novo projeto com o fluxo de trabalho convertido e as respetivas tabelas, e copia os ficheiros de entrada que lê para a pasta ao lado. Nada nos seus projetos existentes muda.
Estimativa — aproximadamente quantas ferramentas o fluxo de trabalho tem, e quantas são convertidas, precisam de revisão ou não têm equivalente no PlaidCloud.
Guardado em — a pasta de Documentos para onde vão os ficheiros do projeto.

Quando aprova, o Weave converte o fluxo de trabalho e indica-lhe o que criou, com Abrir o projeto e Abrir o fluxo de trabalho. Os ficheiros de entrada que não conseguiu encontrar são listados, para que os possa adicionar à pasta mais tarde. Anular move o novo projeto para o lixo.

Um fluxo de trabalho com mais de 25 MB, ou cuja estimativa demore demasiado tempo, é convertido no conversor do Alteryx em vez disso.

Uma pasta inteira

Indique uma pasta de fluxos de trabalho Alteryx em Documentos, como Mover a pasta Alteryx Finance Close, ou largue um .zip de uma na Visão geral de um projeto. Coloque também na pasta os ficheiros que os seus fluxos de trabalho Alteryx escreveram, e o Weave compara com eles os resultados dos fluxos de trabalho convertidos.

O cartão Mover 12 fluxos de trabalho Alteryx para um novo projeto mostra o nome do projeto, uma estimativa de como os fluxos de trabalho são convertidos, os ficheiros de saída com que vai comparar e os passos que deixa de fora da verificação por escreverem fora do PlaidCloud. Todas as execuções têm o lançamento no ERP desativado, e os passos que escrevem ficheiros de saída não são executados durante a verificação: em vez disso, são comparadas as tabelas que escrevem.

Uma pasta grande pode demorar várias horas. Pode fechar o PlaidCloud enquanto o trabalho decorre. O progresso da tarefa no painel lateral passa pela descompactação, conversão, importação dos ficheiros de saída, execução e comparação e, por fim, pela escrita do relatório. Termina com uma frase como Finance Close (from Alteryx) está pronto: 9 de 12 fluxos de trabalho correspondem às saídas que forneceu, 2 diferem, 1 não foi executado. 3 precisam de uma decisão no relatório de migração. com Open the report.

O Move-in report lista primeiro os fluxos de trabalho que precisam de uma decisão e, depois, todos os fluxos de trabalho com o que foi reconhecido e convertido, o que rever, se foi executado (Ran) e se os respetivos resultados correspondem (Match) aos ficheiros que forneceu. Cada linha tem:

Comparar — abre a comparação dos resultados desse fluxo de trabalho com o seu ficheiro.
Verificar de Novo — propõe executar de novo e comparar esse fluxo de trabalho.
Abrir — abre o fluxo de trabalho.
Atribuir — escolhe quem decide sobre a linha. Essa pessoa é avisada no PlaidCloud. Só pode atribuir uma linha a um membro do projeto que consiga abrir esse fluxo de trabalho.

Um fluxo de trabalho precisa de uma decisão quando não foi convertido, tem ferramentas sem equivalente no PlaidCloud, não foi executado, difere do seu ficheiro ou não pôde ser comparado.