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

Descrição

Selecione uma tabela, etapa ou fluxo de trabalho em um projeto e o painel de detalhes dela abre. 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:

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

A página é escrita cada vez 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 à mão. Nenhuma IA está envolvida, então ela funciona quando nenhum provedor de IA está disponível. 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 página de uma tabela

A descrição: o Memorando da tabela, mostrado como citação. O PlaidCloud define o memorando Created dynamically em uma tabela que uma etapa cria; esse não é mostrado, pois não diz nada sobre a tabela.
Gravada por e Lida por: cada etapa, por nome, com o tipo de etapa e os fluxos de trabalho em que está. (desativada) segue um fluxo de trabalho em que a etapa está desativada, e fora de qualquer fluxo de trabalho 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 dependendo dos valores das suas variáveis. Uma etapa que informa apenas um nome compartilhado por várias tabelas é listada com, por exemplo, a menos que se refira a outra das 2 tabelas com este nome, contando apenas as tabelas que você pode abrir. Uma etapa Tabela: Limpar, Tabela: Descartar ou Tabela: Exclusão no local conta como gravação na tabela que altera, e uma etapa que lê uma tabela e a grava de volta é listada nas duas.
Nenhuma etapa deste projeto lê esta tabela. significa que nenhuma etapa deste 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 em Propriedades da coluna quando houver uma definida.

A página de uma etapa

O que ela faz traz 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: “A parcela de cada `product` é o seu `weight` dividido pelo `weight` total do mesmo `cost_center`, `year` e `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, além de todas as tabelas que grava, incluindo as tabelas de mapeamento, de caminho e de resumo.
Importação	O arquivo ou os arquivos que ela importa e a tabela em que 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 da sua tabela ou, quando escolhe tabelas por pesquisa ou pasta, que atua nas tabelas que essa configuração escolhe.
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 as condições são atendidas, em um loop, como macro (uma vez para cada linha da tabela de origem, em caso de execução simultânea) ou por inclusão. Um fluxo de trabalho escolhido por uma variável é mostrado como o nome que a etapa informa, e um de outro projeto é descrito como tal. Qualquer tabela que a própria etapa lê, como a tabela que um loop percorre, também é listada.
Qualquer outra etapa	As tabelas que ela lê e as tabelas que grava.

A página então diz onde a etapa é executada, É a etapa 3 em seguido do fluxo de trabalho, numerada 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 é mostrada pelo seu nome, seguido de (nomeada por uma variável).

A página de um fluxo de trabalho

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.
Lê de fora deste fluxo de trabalho: tabelas que uma etapa lê antes de qualquer etapa deste fluxo de trabalho gravá-las.
Grava: tabelas que as etapas do fluxo de trabalho gravam.

As etapas desativadas são listadas em Etapas, mas ficam fora das outras duas listas. A página informa isso, pois uma tabela que uma etapa desativada 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 própria desse fluxo de trabalho.

Um pacote de transição para o projeto inteiro

Para entregar um projeto, por exemplo a um cliente no 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 etapas, aos fluxos de trabalho e às tabelas dele.

O pacote é um único arquivo Markdown, com o nome do projeto, por exemplo Month End handover.md, escrito a partir das configurações salvas quando você o baixa. Ele começa com a descrição do projeto e a 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 as colunas e as respectivas descrições.
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 une, as linhas que usa, as linhas de realizado e de orçamento, os períodos e pelo que pode ser detalhada. Uma métrica construída a partir de outras diz como, por exemplo Receita dividida por Pedidos. 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 com 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 tem esse nome, o compartilha com outro modelo ou o obtém de algo que o seu perfil oculta, ele recebe como título o de 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 para o que o seu perfil oculta. Um fluxo de trabalho, tabela ou modelo de alocação que você não pode abrir fica de fora e é contado no topo, por exemplo Deixa de fora 2 fluxos de trabalho e 5 tabelas que você não pode abrir. Uma etapa que você não pode abrir nunca é nomeada, como em uma página individual.

O que o seu perfil oculta

Uma tabela, etapa ou fluxo de trabalho pode ser ocultado do perfil de Gerente ou de Explorador. Uma página nunca nomeia um item que o seu perfil oculta:

Uma etapa que você não pode abrir é contada, por exemplo mais 2 etapas que você não pode abrir, e mantém o 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 aparece da mesma forma que um que não existe mais, por exemplo uma tabela que você não pode abrir ou que não existe mais, para 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, é mostrada pelo nome que a etapa lhe dá, seguido de (não é uma tabela que você pode abrir), e um fluxo de trabalho da mesma forma por (não é um fluxo de trabalho que você pode abrir).
Pedir a página de um item que o seu perfil oculta recebe a resposta de que ele não existe.

Um Arquiteto pode abrir tudo, portanto as páginas de um Arquiteto dizem uma tabela excluída, (tabela não encontrada), Uma etapa excluída ou (fluxo de trabalho não encontrado).

O que ela não cobre

Contagens de linhas, tamanhos e horários de atualização.
Tabelas que uma etapa alcança apenas pelo texto SQL ou por uma expressão. A página lista as tabelas que uma etapa nomeia nas suas configurações.
Edições não salvas. A página descreve as configurações salvas.

Para assistentes de IA

O Weave AI pode ler a página de uma tabela, etapa ou fluxo de trabalho quando você pergunta sobre ela 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 o id dele. Ela exige acesso de leitura a etapas, fluxos de trabalho e tabelas e segue as mesmas regras para o que o seu perfil oculta. Consulte Agentes de IA (MCP).