Pular para o conteúdo

Documentação de tabelas, etapas e fluxos de trabalho

Selecione uma etapa ou um fluxo de trabalho em um projeto e o painel de detalhes é aberto. Na parte inferior, uma seção Documentação mostra uma página que o Weave escreve sobre o item a partir das configurações salvas do projeto. O painel de detalhes de uma tabela mostra suas Colunas, com o tipo e a descrição de cada coluna; a página abaixo descreve o que o Weave e os assistentes de IA leem para uma tabela:

  • para uma tabela, as etapas que a gravam e a leem, e suas colunas;
  • para uma etapa, o que ela faz e onde é executada;
  • para um fluxo de trabalho, suas etapas em ordem e as tabelas que ele lê e grava.

A página é escrita sempre que você seleciona o item, a partir das configurações como estão salvas naquele momento, portanto nunca fica desatualizada e não há nada para atualizar manualmente. Depois de um salvamento no mesmo painel de detalhes, como uma nova descrição, a página é escrita novamente.

O Weave AI, o chat na guia Weave de um projeto, e os assistentes de IA conectados por MCP podem ler a mesma página. Consulte Para assistentes de IA.

  • A descrição — o Memorando da tabela, exibido como uma citação. O PlaidCloud define o memorando Created dynamically em uma tabela criada por uma etapa; esse não é exibido, pois não diz nada sobre a tabela.
  • Written by e Read by — cada etapa, pelo nome, com seu tipo de etapa e os fluxos de trabalho em que está. (disabled) acompanha um fluxo de trabalho em que a etapa está desabilitada, e not in any workflow marca uma etapa que não está em nenhum. Uma etapa cujo nome de tabela contém uma variável que pode ou não nomear esta tabela é listada com depending on the values of its variables. Uma etapa que informa apenas um nome compartilhado por várias tabelas é listada com, por exemplo, unless it means another of the 2 tables with this name, contando apenas as tabelas que você pode abrir. Uma etapa Tabela: Limpar, Tabela: Descartar ou Tabela: Exclusão no local conta como gravação da tabela que ela altera, e uma etapa que lê uma tabela e a grava de volta é listada nos dois casos.
  • No step in this project reads this table. significa que nenhuma etapa neste projeto a lista como origem. A página não verifica painéis, exportações, outros projetos nem nada fora das etapas do projeto.
  • Colunas — cada coluna e seu tipo, com a descrição de Propriedades da coluna quando houver uma definida.

What it does apresenta uma frase para cada coisa que a etapa faz:

Etapa O que a página diz
Allocation: Split Qual valor ela divide de qual tabela, entre quais colunas, usando qual coluna de direcionador e como cada parcela é calculada — por exemplo, “Each product’s share is its weight divided by the total weight for the same cost_center, year and month.” As colunas são nomeadas como as tabelas de origem e de direcionadores as nomeiam. Um filtro na origem ou no direcionador da etapa é anotado, e as tabelas que ela grava são nomeadas.
Alocação: Dividir usando dimensão Qual valor ela divide de qual tabela e qual coluna de direcionador usa, e todas as tabelas que grava, incluindo suas tabelas de mapeamento, de caminho e de resumo.
Importação O arquivo ou os arquivos que ela importa e a tabela para a qual importa.
Exportação A tabela que ela exporta e o arquivo que grava.
Extrair: SQL sem origens listadas Que ela executa uma consulta SQL e a tabela que grava.
Tabela: Limpar, Tabela: Descartar, Tabela: Exclusão no local Que ela limpa, descarta ou exclui linhas de sua tabela ou, quando escolhe tabelas por pesquisa ou pasta, que atua sobre as tabelas que essa configuração seleciona.
Importar tabela de projeto externa Que ela copia uma tabela de outro projeto para uma tabela deste.
Uma etapa que executa outro fluxo de trabalho O fluxo de trabalho que ela executa e como: quando suas condições são atendidas, em um loop, como macro (uma vez para cada linha de sua tabela de origem, ou em uma execução concorrente) ou por inclusão. Um fluxo de trabalho escolhido por uma variável é exibido como o nome que a etapa informa, e um de outro projeto é descrito como tal. Qualquer tabela que a própria etapa leia, como a tabela que um loop percorre, também é listada.
Qualquer outra etapa As tabelas que ela lê e as tabelas que ela grava.

Em seguida, a página diz onde a etapa é executada — It is step 3 in seguido do fluxo de trabalho, numerado como na lista de etapas do fluxo de trabalho — ou que ela não está em nenhum fluxo de trabalho.

Uma tabela que a etapa nomeia por meio de uma variável é exibida pelo seu nome, seguido de (named by a variable).

  • Etapas — numeradas como na lista de etapas do fluxo de trabalho, com o tipo de cada etapa e a tabela que ela grava, ou o fluxo de trabalho que ela executa. As etapas de um fluxo de trabalho que ele inclui são listadas no lugar, como a lista de etapas as mostra.
  • Reads from outside this workflow — tabelas que uma etapa lê antes de qualquer etapa deste fluxo de trabalho gravá-las.
  • Writes — tabelas que as etapas do fluxo de trabalho gravam.

As etapas desabilitadas são listadas em Etapas, mas ficam de fora das duas outras listas. A página informa isso, pois uma tabela que uma etapa desabilitada grava pode então ser listada como lida de fora. As tabelas usadas por um fluxo de trabalho que uma de suas etapas executa estão na página desse próprio fluxo de trabalho.

Para transferir um projeto, por exemplo a um cliente ao fim de um trabalho, baixe todas as páginas de uma vez. Na janela Projetos, selecione um projeto e escolha Baixar pacote de transição no menu Ações ou no menu de contexto. Você precisa de acesso de leitura ao projeto, às suas etapas, aos seus fluxos de trabalho e às suas tabelas.

O pacote é um único arquivo Markdown, com o nome do projeto — por exemplo, Month End handover.md — e escrito a partir das configurações salvas no momento do download. Ele começa com a descrição do projeto e uma contagem do que ele contém, e depois tem quatro seções:

  • Fluxos de trabalho — a página de cada fluxo de trabalho. Os fluxos de trabalho que nenhum outro fluxo de trabalho executa vêm primeiro, por nome, e cada um é seguido pelos fluxos de trabalho que ele executa, na ordem em que os executa. Um fluxo de trabalho executado a partir de dois lugares é listado uma vez.
  • Tabelas — a página de cada tabela, como acima, incluindo suas colunas e as descrições delas.
  • Métricas — a versão atual de cada definição de métrica, em frases simples: o que ela mede, de qual tabela, as tabelas que ela une, as linhas que usa, suas linhas realizadas e de orçamento, seus períodos e pelo que pode ser detalhada. Uma métrica construída a partir de outras diz como, por exemplo Revenue divided by Orders. Consulte Definições de métricas.
  • Modelos de alocação — cada cadeia de etapas de alocação que alimentam umas às outras, com a etapa ou as etapas em que termina e a divisão de cada etapa, na ordem de execução. Uma etapa que não é executada em nenhum fluxo de trabalho fica de fora. Um modelo recebe o nome do seu fluxo de trabalho, ou da pasta que seus fluxos de trabalho compartilham. Quando não há esse nome, quando ele o compartilha com outro modelo ou quando o obtém de algo que sua função oculta, ele recebe como título uma de suas etapas. Um modelo de alocação não tem página própria fora do pacote.

O pacote segue as mesmas regras de uma página individual quanto ao que sua função oculta. Um fluxo de trabalho, uma tabela ou um modelo de alocação que você não pode abrir fica de fora e é contado no início, por exemplo It leaves out 2 workflows and 5 tables you can’t open. Uma etapa que você não pode abrir nunca é nomeada, como em uma página individual.

Uma tabela, etapa ou fluxo de trabalho pode ser ocultado da função Gerente ou Explorador. Uma página nunca nomeia um item que sua função oculta:

  • Uma etapa que você não pode abrir é contada — por exemplo, 2 more steps you can’t open — e mantém seu número na lista de etapas de um fluxo de trabalho.
  • Uma tabela, etapa ou fluxo de trabalho que você não pode abrir é exibido da mesma forma que um que não existe mais — por exemplo, a table you can’t open or that no longer exists — de modo que uma página não possa ser usada para descobrir se algo oculto existe. As etapas deixadas de fora das listas de um fluxo de trabalho dessa forma são anotadas, pois uma tabela que uma delas grava pode então ser listada como lida de fora. Uma tabela que uma etapa nomeia e que você não pode abrir, ou que não existe, é exibida pelo nome que a etapa lhe dá, seguido de (not a table you can open), e um fluxo de trabalho, da mesma forma, por (not a workflow you can open).
  • Pedir a página de um item que sua função oculta tem como resposta o mesmo que se ele não existisse.

Um Arquiteto pode abrir tudo, então as páginas de um Arquiteto dizem a deleted table, (table not found), A deleted step ou (workflow not found).

  • Contagens de linhas, tamanhos e horários de atualização.
  • Tabelas que uma etapa alcança apenas por meio de seu texto SQL ou de uma expressão. A página lista as tabelas que uma etapa nomeia em suas configurações.
  • Edições não salvas. A página descreve as configurações salvas.
  • O Weave AI pode ler a página de uma tabela, etapa ou fluxo de trabalho quando você pergunta sobre ele em uma conversa aberta em um projeto, e responder com base no que a página diz. Consulte Chat do Weave AI.
  • Os assistentes de IA conectados por MCP podem ler a mesma página com a ferramenta doc_describe, informando o projeto, se o item é uma tabela, etapa ou fluxo de trabalho, e seu id. Isso exige acesso de leitura a etapas, fluxos de trabalho e tabelas, e segue as mesmas regras para o que sua função oculta. Consulte Agentes de IA (MCP).