Dokumentation für Tabellen, Schritte und Workflows
Beschreibung
Abschnitt betitelt „Beschreibung“Wählen Sie in einem Projekt einen Schritt oder Workflow aus, und sein Detailbereich öffnet sich. Unten zeigt ein Abschnitt Dokumentation eine Seite, die Weave aus den gespeicherten Einstellungen des Projekts dazu erstellt. Der Detailbereich einer Tabelle zeigt stattdessen ihre Spalten mit dem Typ und der Beschreibung jeder Spalte; die folgende Seite beschreibt, was Weave und KI-Assistenten für eine Tabelle lesen:
- bei einer Tabelle die Schritte, die sie schreiben und lesen, und ihre Spalten;
- bei einem Schritt, was er tut und wo er ausgeführt wird;
- bei einem Workflow seine Schritte in der richtigen Reihenfolge sowie die Tabellen, die er liest und schreibt.
Die Seite wird jedes Mal neu erstellt, wenn Sie das Element auswählen, und zwar aus den Einstellungen in dem Stand, in dem sie in diesem Moment gespeichert sind. Sie wird also nie veraltet, und Sie müssen nichts manuell aktualisieren. Nach einem Speichern im selben Detailbereich, etwa einer neuen Beschreibung, wird die Seite erneut erstellt.
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
Abschnitt betitelt „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 – jeweils die Schritte mit Namen, Schritttyp und den Workflows, in denen sie enthalten sind. (deaktiviert) folgt auf einen Workflow, in dem der Schritt deaktiviert ist, und in keinem Workflow kennzeichnet einen Schritt, der in keinem Workflow enthalten ist. Ein Schritt, dessen Tabellenname eine Variable enthält, die diese Tabelle benennen kann oder nicht, wird mit abhängig von den Werten seiner Variablen aufgeführt. Ein Schritt, der nur einen Namen angibt, den sich mehrere Tabellen teilen, wird zum Beispiel mit es sei denn, er meint eine der anderen 2 Tabellen mit diesem Namen aufgeführt, wobei nur Tabellen gezählt werden, die Sie öffnen können. Ein Schritt „Tabelle: Leeren“, „Tabelle: Verwerfen“ oder „Tabelle: Direkt löschen“ gilt als Schreibzugriff auf die Tabelle, die er ändert, und ein Schritt, der eine Tabelle liest und wieder in sie schreibt, wird unter beiden aufgeführt.
- Kein Schritt in diesem Projekt liest diese Tabelle. bedeutet, dass kein Schritt in diesem Projekt sie als Quelle aufführt. Die Seite prüft keine Dashboards, Exporte, anderen Projekte oder sonstigen Elemente außerhalb der Schritte des Projekts.
- Spalten – jede Spalte und ihr Typ, mit ihrer Beschreibung aus den Spalteneigenschaften, sofern eine festgelegt ist.
Die Seite eines Schritts
Abschnitt betitelt „Die Seite eines Schritts“What it does liefert einen Satz für jede Sache, die der Schritt tut:
| Schritt | Die Seite sagt |
|---|---|
| Umlage: Aufteilung | Welchen Wert er aus welcher Tabelle aufteilt, auf welche Spalten, mit welcher Treiberspalte und wie jeder Anteil berechnet wird – zum Beispiel „Der Anteil jedes product ist sein weight geteilt durch das gesamte weight für denselben cost_center, year und month.“ Spalten werden so benannt, wie die Quell- und die Treibertabelle sie benennen. Ein Filter auf der Quelle oder dem Treiber des Schritts wird vermerkt, und die Tabellen, die er schreibt, werden benannt. |
| Umlage: Aufteilung mit Dimension | Welchen Wert er aus welcher Tabelle aufteilt und welche Treiberspalte er verwendet, sowie 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. |
| SQL extrahieren 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 Projekt 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 gleichzeitigen Ausführung), oder durch Einbinden. Ein Workflow, der durch eine Variable gewählt wird, wird mit dem Namen dargestellt, den der Schritt angibt, und ein Workflow in einem anderen Projekt wird entsprechend 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. |
Anschließend nennt die Seite, wo der Schritt ausgeführt wird – It is step 3 in, gefolgt vom Workflow, nummeriert wie in der Schrittliste des Workflows – oder dass er in keinem Workflow enthalten ist.
Eine Tabelle, die der Schritt über eine Variable benennt, wird mit ihrem Namen angezeigt, gefolgt von (named by a variable).
Die Seite eines Workflows
Abschnitt betitelt „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 direkt an der Stelle aufgeführt, wie die Schrittliste sie zeigt.
- Liest von außerhalb dieses Workflows – 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 aus den beiden Listen weggelassen. Die Seite weist darauf hin, da eine Tabelle, die ein deaktivierter Schritt schreibt, dann als von außerhalb gelesen aufgeführt sein kann. Die Tabellen, die ein Workflow verwendet, den einer seiner Schritte ausführt, stehen auf der eigenen Seite dieses Workflows.
Ein Übergabepaket für das gesamte Projekt
Abschnitt betitelt „Ein Übergabepaket für das gesamte Projekt“Um ein Projekt zu übergeben, zum Beispiel an einen Kunden am Ende eines Projektauftrags, laden Sie alle Seiten auf einmal herunter. Wählen Sie im Fenster Projekte ein Projekt aus und wählen Sie im Menü Aktionen oder im Kontextmenü (Rechtsklick) Übergabepaket herunterladen. Sie benötigen Lesezugriff auf das Projekt, seine Schritte, seine Workflows und seine Tabellen.
Das Paket ist eine einzige Markdown-Datei, benannt nach dem Projekt – zum Beispiel Month End handover.md – und wird beim Herunterladen aus den gespeicherten Einstellungen erstellt. Sie 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, stehen 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 aus ausgeführt wird, wird einmal aufgeführt.
- Tabellen – die Seite jeder Tabelle, wie oben beschrieben, einschließlich ihrer Spalten und deren Beschreibungen.
- Kennzahlen – die aktuelle Version jeder Kennzahldefinition, in einfachen Sätzen: was sie misst, aus welcher Tabelle, welche Tabellen sie verknüpft, welche Zeilen sie verwendet, ihre Ist- und Budgetzeilen, ihre Perioden und wonach sie aufgeschlüsselt werden kann. Bei einer Kennzahl, die aus anderen aufgebaut ist, steht, wie, zum Beispiel Umsatz geteilt durch Aufträge. 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 ausgeführt wird, wird weggelassen. Ein Modell wird nach seinem Workflow oder dem Ordner benannt, den seine Workflows gemeinsam nutzen. Hat es keinen solchen Namen, teilt es ihn mit einem anderen Modell oder bezieht es ihn aus etwas, das Ihre Rolle ausblendet, wird es stattdessen nach einem seiner Schritte betitelt. Ein Umlagemodell hat außerhalb des Pakets keine eigene Seite.
Für das, was Ihre Rolle ausblendet, gelten für das Paket dieselben Regeln wie für eine einzelne Seite. Ein Workflow, eine Tabelle oder ein Umlagemodell, das Sie nicht öffnen können, wird weggelassen und oben gezä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
Abschnitt betitelt „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 ein Element, das Ihre Rolle ausblendet:
- Ein Schritt, den Sie nicht öffnen können, wird gezä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, die Sie nicht öffnen können, lesen sich genauso wie solche, die nicht mehr existieren – zum Beispiel a table you can’t open or that no longer exists –, sodass eine Seite nicht dazu dienen kann herauszufinden, ob etwas Ausgeblendetes existiert. Die auf diese Weise aus den Listen eines Workflows weggelassenen Schritte werden vermerkt, da eine Tabelle, die einer von ihnen schreibt, dann als von außerhalb gelesen aufgeführt sein kann. Eine Tabelle, die ein Schritt benennt 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).
- Wenn Sie die Seite eines Elements anfordern, das Ihre Rolle ausblendet, lautet die Antwort, als gäbe es es nicht.
Ein Architect kann alles öffnen, daher steht auf den Seiten eines Architects stattdessen a deleted table, (table not found), A deleted step oder (workflow not found).
Was nicht abgedeckt ist
Abschnitt betitelt „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 benennt.
- Nicht gespeicherte Änderungen. Die Seite beschreibt die gespeicherten Einstellungen.
Für KI-Assistenten
Abschnitt betitelt „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 Tool
doc_describelesen, wenn das Projekt, die Angabe, ob das Element eine Tabelle, ein Schritt oder ein Workflow ist, und seine ID angegeben werden. Dafür ist Lesezugriff auf Schritte, Workflows und Tabellen erforderlich, und es gelten dieselben Regeln für das, was Ihre Rolle ausblendet. Siehe KI-Agenten (MCP).