Pular para o conteúdo

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

Selecione 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 mesmo a partir das definições guardadas do projeto. O painel de detalhes de uma tabela mostra antes as 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, 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 sempre 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 a atualizar manualmente. Após uma gravação no mesmo painel de detalhes, como uma nova descrição, a página é escrita novamente.

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

  • 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 respetivo tipo de passo e os fluxos de trabalho em que se encontra. (desativado) acompanha um fluxo de trabalho em que o passo está desativado, e não está 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 designar 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 escrevendo a tabela que altera, e um passo que lê uma tabela e a volta a escrever é listado em ambas.
  • Nenhum passo neste projeto lê esta tabela. significa que nenhum passo neste 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 respetivo tipo, com a descrição proveniente de Propriedades da coluna quando esta está definida.

O que faz apresenta uma frase para cada coisa que o passo faz:

Passo A página indica
Alocação: Dividir Que valor divide e de que tabela, por que colunas, utilizando que coluna de indutor, e como é calculada cada parcela — 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 indutores as designam. É registado um filtro na origem ou no indutor do passo, e as tabelas que escreve são nomeadas.
Alocação: Dividir por dimensão Que valor divide e de que tabela, que coluna de indutor utiliza e todas as tabelas que escreve, incluindo as suas tabelas de mapeamento, de caminhos e de resumo.
Importar O ficheiro ou os ficheiros que importa e a tabela para a qual importa.
Exportar 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 de que forma: quando as suas condições são cumpridas, num ciclo, como macro (uma vez por cada linha da sua tabela de origem, ou numa execução simultânea) ou incluindo-o. Um fluxo de trabalho escolhido por uma variável é mostrado como o nome que o passo indica, e um de outro projeto é descrito como tal. Qualquer tabela que o próprio passo lê, 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 designa através de uma variável é mostrada pelo seu nome, seguido de (designada por uma variável).

  • 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 respetivo lugar, tal 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.
  • Escreve — 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 indica-o, uma vez que uma tabela que um passo desativado escreve pode então ser listada como lida de fora. As tabelas utilizadas por um fluxo de trabalho que um dos seus passos executa estão na página desse fluxo de trabalho.

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. É necessário ter 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. Começa 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 junta, as linhas que utiliza, as suas linhas reais e de orçamento, os seus períodos e por que critérios pode ser desagregado. Um indicador construído a partir de outros indica como, por exemplo Receita dividida por Encomendas. Consulte Definições de indicadores.
  • Modelos de alocação — cada cadeia de passos de alocação que se alimentam uns aos outros, com o passo ou os passos com que termina e a divisão de cada passo, por ordem de execução. Um passo que não é executado em nenhum fluxo de trabalho é deixado 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 de uma única página quanto ao que a sua função oculta. Um fluxo de trabalho, uma tabela ou um modelo de alocação que não pode abrir é deixado 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, tal como numa única página.

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

  • 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, um passo ou um fluxo de trabalho que não pode abrir aparece 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 utilizada 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 designa 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 obtém a resposta de que não existe.

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

  • 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 designa nas suas definições.
  • Edições não guardadas. A página descreve as definições guardadas.
  • O Weave AI pode ler a página de uma tabela, de um passo ou de um fluxo de trabalho quando lhe pergunta sobre o mesmo numa conversa aberta num projeto, e responder com base no que a página indica. Consulte Chat do Weave AI.
  • Os assistentes de IA ligados através de MCP podem ler a mesma página com a ferramenta doc_describe, indicando o projeto, se o item é uma tabela, um passo ou um fluxo de trabalho, e o respetivo id. Requer 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).