Dokumentation für Tabellen, Schritte und Workflows

Beschreibung

Wählen Sie in einem Projekt eine Tabelle, einen Schritt oder einen Workflow aus, und sein Detailbereich öffnet sich. Unten zeigt ein Abschnitt Dokumentation eine Seite, die Weave dazu aus den gespeicherten Einstellungen des Projekts schreibt:

bei einer Tabelle die Schritte, die sie schreiben und lesen, und ihre Spalten;
bei einem Schritt, was er tut und wo er läuft;
bei einem Workflow seine Schritte in Reihenfolge und die Tabellen, die er liest und schreibt.

Die Seite wird bei jeder Auswahl des Elements aus den in diesem Moment gespeicherten Einstellungen geschrieben, veraltet also nie, und es gibt nichts von Hand zu aktualisieren. Es ist keine KI beteiligt, daher funktioniert sie auch, wenn kein KI-Anbieter verfügbar ist. Nach einem Speichern im selben Detailbereich, etwa einer neuen Beschreibung, wird die Seite neu geschrieben.

Weave AI, der Chat auf der Registerkarte Weave eines Projekts, und über MCP verbundene KI-Assistenten können dieselbe Seite lesen. Siehe Für KI-Assistenten.

Die Seite einer Tabelle

Die Beschreibung – die Notiz der Tabelle, als Zitat dargestellt. PlaidCloud setzt die Notiz Created dynamically bei einer Tabelle, die ein Schritt erstellt; diese wird nicht angezeigt, da sie nichts über die Tabelle aussagt.
Geschrieben von und Gelesen von – jeder Schritt mit Namen, seinem Schritttyp und den Workflows, in denen er vorkommt. (disabled) folgt auf einen Workflow, in dem der Schritt deaktiviert ist, und not in any workflow kennzeichnet einen Schritt, der in keinem vorkommt. Ein Schritt, dessen Tabellenname eine Variable enthält, die diese Tabelle benennen kann oder auch nicht, wird mit depending on the values of its variables aufgeführt. Ein Schritt, der nur einen Namen angibt, den mehrere Tabellen teilen, wird zum Beispiel mit unless it means another of the 2 tables with this name aufgeführt, wobei nur Tabellen gezählt werden, die Sie öffnen können. Ein Schritt Tabelle: Leeren, Tabelle: Verwerfen oder Tabelle: Direkt löschen zählt als Schreiben der Tabelle, die er ändert, und ein Schritt, der eine Tabelle liest und zurückschreibt, wird unter beiden aufgeführt.
No step in this project reads this table. bedeutet, dass kein Schritt in diesem Projekt sie als Quelle aufführt. Die Seite prüft keine Dashboards, Exporte, anderen Projekte oder irgendetwas außerhalb der Schritte des Projekts.
Spalten – jede Spalte und ihr Typ, mit ihrer Beschreibung aus den Spalteneigenschaften, wo eine festgelegt ist.

Die Seite eines Schritts

What it does gibt für alles, was der Schritt tut, einen Satz an:

Schritt	Die Seite sagt
Umlage: Aufteilung	Welchen Wert er aus welcher Tabelle auf welche Spalten aufteilt, mit welcher Treiberspalte, und wie jeder Anteil berechnet wird – zum Beispiel „Each `product`’s share is its `weight` divided by the total `weight` for the same `cost_center`, `year` and `month`.” Spalten werden so benannt, wie die Quell- und Treibertabellen sie nennen. Ein Filter auf die Quelle oder den Treiber des Schritts wird vermerkt, und die Tabellen, die er schreibt, werden benannt.
Umlage: Aufteilung mit Dimension	Welchen Wert er aus welcher Tabelle aufteilt, welche Treiberspalte er verwendet, und jede Tabelle, die er schreibt, einschließlich seiner Zuordnungs-, Pfad- und Zusammenfassungstabellen.
Import	Die Datei oder Dateien, die er importiert, und die Tabelle, in die er importiert.
Export	Die Tabelle, die er exportiert, und die Datei, die er schreibt.
Extract: SQL ohne aufgeführte Quellen	Dass er eine SQL-Abfrage ausführt, und die Tabelle, die er schreibt.
Tabelle: Leeren, Tabelle: Verwerfen, Tabelle: Direkt löschen	Dass er seine Tabelle leert, verwirft oder Zeilen daraus löscht oder, wenn er Tabellen per Suche oder Ordner auswählt, dass er auf die Tabellen wirkt, die diese Einstellung auswählt.
Externe Projekttabelle importieren	Dass er eine Tabelle aus einem anderen Projekt in eine Tabelle in diesem kopiert.
Ein Schritt, der einen anderen Workflow ausführt	Den Workflow, den er ausführt, und wie: wenn seine Bedingungen erfüllt sind, in einer Schleife, als Makro (einmal für jede Zeile seiner Quelltabelle, bei einer parallelen Ausführung) oder durch Einbinden. Ein per Variable gewählter Workflow wird als der Name angezeigt, den der Schritt angibt, und ein Workflow in einem anderen Projekt wird als solcher beschrieben. Jede Tabelle, die der Schritt selbst liest, etwa die Tabelle, die eine Schleife durchläuft, wird ebenfalls aufgeführt.
Jeder andere Schritt	Die Tabellen, die er liest, und die Tabellen, die er schreibt.

Die Seite sagt dann, wo der Schritt läuft – It is step 3 in gefolgt vom Workflow, nummeriert wie in der Schrittliste des Workflows – oder dass er in keinem Workflow vorkommt.

Eine Tabelle, die der Schritt über eine Variable benennt, wird mit ihrem Namen angezeigt, gefolgt von (named by a variable).

Die Seite eines Workflows

Schritte – nummeriert wie in der Schrittliste des Workflows, mit dem Typ jedes Schritts und der Tabelle, die er schreibt, oder dem Workflow, den er ausführt. Schritte eines eingebundenen Workflows werden an Ort und Stelle aufgeführt, wie die Schrittliste sie zeigt.
Reads from outside this workflow – Tabellen, die ein Schritt liest, bevor ein Schritt in diesem Workflow sie schreibt.
Schreibt – Tabellen, die die Schritte des Workflows schreiben.

Deaktivierte Schritte werden unter Schritte aufgeführt, aber in den beiden Listen ausgelassen. Die Seite weist darauf hin, da eine Tabelle, die ein deaktivierter Schritt schreibt, dann als von außen gelesen aufgeführt sein kann. Die Tabellen, die ein von einem seiner Schritte ausgeführter Workflow verwendet, stehen auf der eigenen Seite dieses Workflows.

Ein Übergabepaket für das ganze Projekt

Um ein Projekt zu übergeben, zum Beispiel am Ende eines Auftrags an einen Kunden, laden Sie alle Seiten auf einmal herunter. Wählen Sie im Fenster Projekte ein Projekt aus und wählen Sie Übergabepaket herunterladen im Menü Aktionen oder im Kontextmenü. Sie benötigen Lesezugriff auf das Projekt, seine Schritte, seine Workflows und seine Tabellen.

Das Paket ist eine Markdown-Datei, benannt nach dem Projekt – zum Beispiel Month End handover.md –, und wird beim Herunterladen aus den gespeicherten Einstellungen geschrieben. Es beginnt mit der Beschreibung des Projekts und einer Zählung dessen, was es enthält, und hat dann vier Abschnitte:

Workflows – die Seite jedes Workflows. Workflows, die kein anderer Workflow ausführt, kommen zuerst, nach Namen sortiert, und auf jeden folgen die Workflows, die er ausführt, in der Reihenfolge, in der er sie ausführt. Ein Workflow, der von zwei Stellen ausgeführt wird, wird einmal aufgeführt.
Tabellen – die Seite jeder Tabelle wie oben, einschließlich ihrer Spalten und deren Beschreibungen.
Kennzahlen – die aktuelle Version jeder Kennzahldefinition in einfachen Sätzen: was sie misst, aus welcher Tabelle, die Tabellen, die sie verknüpft, die Zeilen, die sie verwendet, ihre Ist- und Budgetzeilen, ihre Perioden und wonach sie sich aufschlüsseln lässt. Eine aus anderen aufgebaute Kennzahl sagt, wie, zum Beispiel Revenue divided by Orders. Siehe Kennzahldefinitionen.
Umlagemodelle – jede Kette von Umlageschritten, die einander speisen, mit dem Schritt oder den Schritten, mit denen sie endet, und der Aufteilung jedes Schritts in Ausführungsreihenfolge. Ein Schritt, der in keinem Workflow läuft, wird ausgelassen. Ein Modell wird nach seinem Workflow oder dem Ordner benannt, den seine Workflows teilen. Hat es keinen solchen Namen, teilt es ihn mit einem anderen Modell oder entnimmt es ihn etwas, das Ihre Rolle ausblendet, trägt es stattdessen den Titel eines seiner Schritte. Ein Umlagemodell hat außerhalb des Pakets keine eigene Seite.

Das Paket folgt denselben Regeln wie eine einzelne Seite für das, was Ihre Rolle ausblendet. Ein Workflow, eine Tabelle oder ein Umlagemodell, die Sie nicht öffnen können, wird ausgelassen und oben mitgezählt, zum Beispiel It leaves out 2 workflows and 5 tables you can’t open. Ein Schritt, den Sie nicht öffnen können, wird nie benannt, wie auf einer einzelnen Seite.

Was Ihre Rolle ausblendet

Eine Tabelle, ein Schritt oder ein Workflow kann für die Rolle Manager oder Explorer ausgeblendet sein. Eine Seite nennt nie eines, das Ihre Rolle ausblendet:

Ein Schritt, den Sie nicht öffnen können, wird mitgezählt – zum Beispiel 2 more steps you can’t open – und behält seine Nummer in der Schrittliste eines Workflows.
Eine Tabelle, ein Schritt oder ein Workflow, den Sie nicht öffnen können, liest sich wie einer, der nicht mehr existiert – zum Beispiel a table you can’t open or that no longer exists –, damit eine Seite nicht dazu genutzt werden kann, herauszufinden, ob etwas Ausgeblendetes existiert. Die auf diese Weise aus den Listen eines Workflows ausgelassenen Schritte werden vermerkt, da eine Tabelle, die einer von ihnen schreibt, dann als von außen gelesen aufgeführt sein kann. Eine Tabelle, die ein Schritt nennt und die Sie nicht öffnen können oder die nicht existiert, wird mit dem Namen angezeigt, den der Schritt ihr gibt, gefolgt von (not a table you can open), und ein Workflow entsprechend mit (not a workflow you can open).
Wird die Seite eines Elements angefordert, das Ihre Rolle ausblendet, lautet die Antwort, als gäbe es es nicht.

Ein Architect kann alles öffnen, daher sagen die Seiten eines Architects stattdessen a deleted table, (table not found), A deleted step oder (workflow not found).

Was nicht abgedeckt ist

Zeilenanzahlen, Größen und Aktualisierungszeiten.
Tabellen, die ein Schritt nur über seinen SQL-Text oder einen Ausdruck erreicht. Die Seite listet die Tabellen auf, die ein Schritt in seinen Einstellungen nennt.
Nicht gespeicherte Änderungen. Die Seite beschreibt die gespeicherten Einstellungen.

Für KI-Assistenten

Weave AI kann die Seite einer Tabelle, eines Schritts oder eines Workflows lesen, wenn Sie in einer in einem Projekt geöffneten Unterhaltung danach fragen, und anhand dessen antworten, was die Seite sagt. Siehe Weave-AI-Chat.
Über MCP verbundene KI-Assistenten können dieselbe Seite mit dem Werkzeug doc_describe lesen, wenn ihnen das Projekt, die Angabe, ob das Element eine Tabelle, ein Schritt oder ein Workflow ist, und seine ID übergeben werden. Es erfordert Lesezugriff auf Schritte, Workflows und Tabellen und folgt denselben Regeln dafür, was Ihre Rolle ausblendet. Siehe KI-Agenten (MCP).