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

Descrição

Selecione uma tabela, um passo ou um fluxo de trabalho num projeto e o respetivo painel de detalhes abre-se. Na parte inferior, uma secção Documentação mostra uma página que o Weave escreve sobre o item a partir das definições guardadas do projeto:

para uma tabela, os passos que a escrevem e leem, e as suas colunas;
para um passo, o que faz e onde é executado;
para um fluxo de trabalho, os seus passos por ordem e as tabelas que lê e escreve.

A página é escrita de cada vez que seleciona o item, a partir das definições tal como estão guardadas nesse momento, pelo que nunca fica desatualizada e não há nada para atualizar à mão. Não envolve IA, pelo que funciona quando nenhum fornecedor de IA está disponível. Depois de uma gravação no mesmo painel de detalhes, como uma nova descrição, a página é escrita de novo.

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

A página de uma tabela

A descrição — o Memorando da tabela, mostrado como citação. O PlaidCloud define o memorando Created dynamically numa tabela que um passo cria; esse não é mostrado, uma vez que não diz nada sobre a tabela.
Escrita por e Lida por — cada passo, por nome, com o seu tipo de passo e os fluxos de trabalho em que está. (desativado) segue-se a um fluxo de trabalho em que o passo está desativado, e em nenhum fluxo de trabalho assinala um passo que não está em nenhum. Um passo cujo nome de tabela contém uma variável que pode ou não nomear esta tabela é listado com consoante os valores das suas variáveis. Um passo que indica apenas um nome partilhado por várias tabelas é listado com, por exemplo, a menos que se refira a outra das 2 tabelas com este nome, contando apenas as tabelas que pode abrir. Um passo Tabela: Limpar, Tabela: Eliminar ou Tabela: Eliminação no local conta como escrita da tabela que altera, e um passo que lê uma tabela e a volta a escrever é listado em ambas.
Nenhum passo deste projeto lê esta tabela. significa que nenhum passo deste projeto a lista como origem. A página não verifica painéis de controlo, exportações, outros projetos nem nada fora dos passos do projeto.
Colunas — cada coluna e o seu tipo, com a respetiva descrição de Propriedades da coluna quando existe.

A página de um passo

O que faz dá uma frase por cada coisa que o passo faz:

Passo	A página diz
Alocação: Dividir	Que valor divide e de que tabela, por que colunas, usando que coluna de indutor, e como se calcula cada parcela — por exemplo, “A parcela de cada `product` é o seu `weight` dividido pelo total de `weight` para o mesmo `cost_center`, `year` e `month`.” As colunas são nomeadas como as tabelas de origem e de indutores as nomeiam. Um filtro na origem ou no indutor do passo é assinalado, e as tabelas que escreve são nomeadas.
Alocação: Dividir por dimensão	Que valor divide e de que tabela e que coluna de indutor usa, e todas as tabelas que escreve, incluindo as de mapeamento, de caminho e de resumo.
Importação	O ficheiro ou ficheiros que importa e a tabela para onde importa.
Exportação	A tabela que exporta e o ficheiro que escreve.
Extrair: SQL sem origens listadas	Que executa uma consulta SQL, e a tabela que escreve.
Tabela: Limpar, Tabela: Eliminar, Tabela: Eliminação no local	Que limpa, elimina ou apaga linhas da sua tabela ou, quando escolhe tabelas por pesquisa ou pasta, que atua sobre as tabelas que essa definição escolhe.
Importar tabela de projeto externa	Que copia uma tabela de outro projeto para uma tabela neste.
Um passo que executa outro fluxo de trabalho	O fluxo de trabalho que executa e como: quando as suas condições são cumpridas, num ciclo, como macro (uma vez por cada linha da tabela de origem, ou em execução simultânea), ou incluindo-o. Um fluxo de trabalho escolhido por uma variável é mostrado com o nome que o passo indica, e um de outro projeto é descrito como tal. Qualquer tabela que o próprio passo leia, como a tabela que um ciclo percorre, também é listada.
Qualquer outro passo	As tabelas que lê e as tabelas que escreve.

A página indica depois onde o passo é executado — É o passo 3 em seguido do fluxo de trabalho, numerado como na lista de passos do fluxo de trabalho — ou que não está em nenhum fluxo de trabalho.

Uma tabela que o passo nomeia através de uma variável é mostrada pelo seu nome, seguido de (nomeada por uma variável).

A página de um fluxo de trabalho

Passos — numerados como na lista de passos do fluxo de trabalho, com o tipo de cada passo e a tabela que escreve, ou o fluxo de trabalho que executa. Os passos de um fluxo de trabalho que inclui são listados no próprio local, como a lista de passos os mostra.
Lê de fora deste fluxo de trabalho — tabelas que um passo lê antes de qualquer passo deste fluxo de trabalho as escrever.
Escrita — tabelas que os passos do fluxo de trabalho escrevem.

Os passos desativados são listados em Passos, mas ficam de fora das duas listas. A página di-lo, uma vez que uma tabela que um passo desativado escreve pode então ser listada como lida de fora. As tabelas usadas por um fluxo de trabalho que um dos seus passos executa estão na página própria desse fluxo de trabalho.

Um pacote de transição para todo o projeto

Para entregar um projeto, por exemplo a um cliente no fim de um trabalho, transfira todas as páginas de uma só vez. Na janela Projetos, selecione um projeto e escolha Transferir pacote de transição no menu Ações ou no menu de contexto. Precisa de acesso de leitura ao projeto, aos seus passos, aos seus fluxos de trabalho e às suas tabelas.

O pacote é um único ficheiro Markdown, com o nome do projeto — por exemplo Month End handover.md — e escrito a partir das definições guardadas quando o transfere. Abre com a descrição do projeto e uma contagem do que contém, e depois tem quatro secçõ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 dos fluxos de trabalho que executa, pela ordem em que os executa. Um fluxo de trabalho executado a partir de dois locais é listado uma só vez.
Tabelas — a página de cada tabela, como acima, incluindo as suas colunas e as respetivas descrições.
Indicadores — a versão atual de cada definição de indicador, em frases simples: o que mede, a partir de que tabela, as tabelas que une, as linhas que usa, as suas linhas reais e de orçamento, os seus períodos e o que permite detalhar. Um indicador construído a partir de outros diz como, por exemplo Receitas divididas por Encomendas. Consulte Definições de indicadores.
Modelos de alocação — cada cadeia de passos de alocação que alimentam os seguintes, com o passo ou passos em que termina e a divisão de cada passo, pela ordem de execução. Um passo que não é executado em nenhum fluxo de trabalho fica de fora. Um modelo tem o nome do seu fluxo de trabalho, ou da pasta que os seus fluxos de trabalho partilham. Quando não tem esse nome, o partilha com outro modelo, ou o obtém de algo que a sua função oculta, é intitulado por um dos seus passos. Um modelo de alocação não tem página própria fora do pacote.

O pacote segue as mesmas regras que uma página individual quanto ao que a sua função oculta. Um fluxo de trabalho, tabela ou modelo de alocação que não pode abrir fica de fora e é contado no topo, por exemplo Deixa de fora 2 fluxos de trabalho e 5 tabelas que não pode abrir. Um passo que não pode abrir nunca é nomeado, como numa página individual.

O que a sua função oculta

Uma tabela, um passo ou um fluxo de trabalho pode estar oculto para a função Gestor ou Explorador. Uma página nunca nomeia um que a sua função oculta:

Um passo que não pode abrir é contado — por exemplo, mais 2 passos que não pode abrir — e mantém o seu número na lista de passos de um fluxo de trabalho.
Uma tabela, passo ou fluxo de trabalho que não pode abrir lê-se da mesma forma que um que já não existe — por exemplo, uma tabela que não pode abrir ou que já não existe — pelo que uma página não pode ser usada para descobrir se algo oculto existe. Os passos deixados de fora das listas de um fluxo de trabalho desta forma são assinalados, uma vez que uma tabela que um deles escreve pode então ser listada como lida de fora. Uma tabela que um passo nomeia e que não pode abrir, ou que não existe, é mostrada pelo nome que o passo lhe dá, seguido de (não é uma tabela que possa abrir), e um fluxo de trabalho da mesma forma por (não é um fluxo de trabalho que possa abrir).
Pedir a página de um item que a sua função oculta é respondido como se não existisse.

Um Arquiteto pode abrir tudo, pelo que as páginas de um Arquiteto dizem uma tabela eliminada, (tabela não encontrada), Um passo eliminado ou (fluxo de trabalho não encontrado).

O que não abrange

Contagens de linhas, tamanhos e horas de atualização.
Tabelas a que um passo chega apenas através do seu texto SQL ou de uma expressão. A página lista as tabelas que um passo nomeia nas suas definições.
Edições não guardadas. A página descreve as definições guardadas.

Para assistentes de IA

O Weave AI pode ler a página de uma tabela, passo ou fluxo de trabalho quando lhe pergunta sobre o item numa conversa aberta num projeto, e responder com base no que a página diz. Consulte Chat do Weave AI.
Os assistentes de IA ligados por MCP podem ler a mesma página com a ferramenta doc_describe, dados o projeto, se o item é uma tabela, um passo ou um fluxo de trabalho, e o seu id. Precisa de acesso de leitura a passos, fluxos de trabalho e tabelas, e segue as mesmas regras quanto ao que a sua função oculta. Consulte Agentes de IA (MCP).