Dokumentacja tabel, kroków i przepływów pracy

Opis

Wybierz tabelę, krok lub przepływ pracy w projekcie, a otworzy się jego panel szczegółów. Na dole sekcja Dokumentacja pokazuje stronę napisaną o nim przez Weave na podstawie zapisanych ustawień projektu:

dla tabeli — kroki, które ją zapisują i odczytują, oraz jej kolumny;
dla kroku — co robi i gdzie działa;
dla przepływu pracy — jego kroki w kolejności oraz tabele, które odczytuje i zapisuje.

Strona jest tworzona za każdym razem, gdy wybierasz element, na podstawie ustawień zapisanych w tej chwili, więc nigdy się nie dezaktualizuje i nie trzeba niczego odświeżać ręcznie. AI nie jest używane, więc działa także wtedy, gdy żaden dostawca AI nie jest dostępny. Po zapisie w tym samym panelu szczegółów, na przykład nowego opisu, strona jest tworzona ponownie.

Weave AI, czat na karcie Weave projektu, oraz asystenci AI połączeni przez MCP mogą odczytywać tę samą stronę. Zobacz Dla asystentów AI.

Strona tabeli

Opis — Notatka tabeli, pokazana jako cytat. PlaidCloud ustawia notatkę Created dynamically dla tabeli utworzonej przez krok; ta nie jest pokazywana, ponieważ nic nie mówi o tabeli.
Zapisywane przez i Odczytywane przez — każdy krok, według nazwy, wraz z jego typem i przepływami pracy, w których się znajduje. (disabled) następuje po przepływie pracy, w którym krok jest wyłączony, a not in any workflow oznacza krok, który nie należy do żadnego. Krok, którego nazwa tabeli zawiera zmienną mogącą wskazywać tę tabelę lub nie, jest wymieniony z dopiskiem depending on the values of its variables. Krok, który podaje tylko nazwę wspólną dla kilku tabel, jest wymieniony z dopiskiem, na przykład unless it means another of the 2 tables with this name, licząc tylko tabele, które możesz otworzyć. Krok Tabela: wyczyść, Tabela: usuń lub Tabela: usuń w miejscu jest liczony jako zapisujący tabelę, którą zmienia, a krok, który odczytuje tabelę i zapisuje ją z powrotem, jest wymieniony w obu miejscach.
No step in this project reads this table. oznacza, że żaden krok w tym projekcie nie wymienia jej jako źródła. Strona nie sprawdza pulpitów, eksportów, innych projektów ani niczego poza krokami projektu.
Kolumny — każda kolumna i jej typ, wraz z opisem z Właściwości kolumny, jeśli jest ustawiony.

Strona kroku

Co robi podaje jedno zdanie dla każdej rzeczy, którą krok robi:

Krok	Strona mówi
Allocation: Split	Którą wartość dzieli z której tabeli, między które kolumny, przy użyciu której kolumny sterującej oraz jak obliczany jest każdy udział — na przykład „Each `product`’s share is its `weight` divided by the total `weight` for the same `cost_center`, `year` and `month`.” Kolumny są nazwane tak, jak nazywają je tabele źródłowa i sterująca. Filtr na źródle lub kolumnie sterującej kroku jest odnotowany, a tabele, które zapisuje, są nazwane.
Alokacja: podział z użyciem wymiaru	Którą wartość dzieli z której tabeli i której kolumny sterującej używa oraz każdą tabelę, którą zapisuje, w tym tabele mapowania, ścieżek i podsumowań.
Import	Plik lub pliki, które importuje, i tabelę, do której importuje.
Eksport	Tabelę, którą eksportuje, i plik, który zapisuje.
Extract: SQL bez wymienionych źródeł	Że uruchamia zapytanie SQL, oraz tabelę, którą zapisuje.
Tabela: wyczyść, Tabela: usuń, Tabela: usuń w miejscu	Że czyści, usuwa lub kasuje wiersze swojej tabeli, albo — gdy wybiera tabele przez wyszukiwanie lub folder — że działa na tabelach wybranych przez to ustawienie.
Importuj zewnętrzną tabelę projektu	Że kopiuje tabelę z innego projektu do tabeli w tym projekcie.
Krok, który uruchamia inny przepływ pracy	Przepływ pracy, który uruchamia, i sposób: gdy spełnione są jego warunki, w pętli, jako makro (raz dla każdego wiersza tabeli źródłowej, w przypadku uruchomienia współbieżnego) lub przez dołączenie go. Przepływ pracy wybrany przez zmienną jest pokazany pod nazwą, jaką podaje krok, a przepływ pracy w innym projekcie jest tak opisany. Każda tabela, którą odczytuje sam krok, na przykład tabela, po której iteruje pętla, jest również wymieniona.
Dowolny inny krok	Tabele, które odczytuje, i tabele, które zapisuje.

Następnie strona podaje, gdzie krok działa — It is step 3 in, a po tym przepływ pracy, numerowany jak na liście kroków przepływu pracy — albo że nie należy do żadnego przepływu pracy.

Tabela, którą krok wskazuje przez zmienną, jest pokazana swoją nazwą, a po niej (named by a variable).

Strona przepływu pracy

Kroki — numerowane jak na liście kroków przepływu pracy, z typem każdego kroku i tabelą, którą zapisuje, lub przepływem pracy, który uruchamia. Kroki dołączonego przepływu pracy są wymienione w miejscu, tak jak pokazuje je lista kroków.
Odczyt spoza tego przepływu pracy — tabele, które krok odczytuje, zanim którykolwiek krok tego przepływu pracy je zapisze.
Zapis — tabele, które zapisują kroki przepływu pracy.

Wyłączone kroki są wymienione w Kroki, ale pominięte w obu listach. Strona o tym informuje, ponieważ tabela zapisywana przez wyłączony krok może wtedy zostać wymieniona jako odczytywana z zewnątrz. Tabele używane przez przepływ pracy uruchamiany przez jeden z jego kroków znajdują się na stronie tego przepływu pracy.

Pakiet przekazania dla całego projektu

Aby przekazać projekt, na przykład klientowi na zakończenie współpracy, pobierz wszystkie strony naraz. W oknie Projekty wybierz jeden projekt i wybierz Pobierz pakiet przekazania z menu Akcje lub z menu kontekstowego. Potrzebujesz dostępu do odczytu projektu, jego kroków, przepływów pracy i tabel.

Pakiet to jeden plik Markdown, nazwany od projektu — na przykład Month End handover.md — i tworzony z zapisanych ustawień w chwili pobierania. Zaczyna się od opisu projektu i liczby zawartych elementów, a następnie ma cztery sekcje:

Przepływy pracy — strona każdego przepływu pracy. Najpierw idą przepływy pracy, których nie uruchamia żaden inny przepływ pracy, według nazwy, a po każdym z nich przepływy pracy, które uruchamia, w kolejności uruchamiania. Przepływ pracy uruchamiany z dwóch miejsc jest wymieniony raz.
Tabele — strona każdej tabeli, jak powyżej, wraz z kolumnami i ich opisami.
Metryki — bieżąca wersja każdej definicji metryki, prostymi zdaniami: co mierzy, z której tabeli, jakie tabele łączy, jakich wierszy używa, jej wiersze rzeczywiste i budżetowe, jej okresy oraz według czego można ją rozbić. Metryka zbudowana z innych podaje, jak, na przykład Revenue divided by Orders. Zobacz Definicje metryk.
Modele alokacji — każdy łańcuch kroków alokacji zasilających się nawzajem, z krokiem lub krokami, którymi się kończy, i podziałem każdego kroku, w kolejności uruchamiania. Krok, który nie działa w żadnym przepływie pracy, jest pomijany. Model nosi nazwę swojego przepływu pracy lub folderu wspólnego dla jego przepływów pracy. Gdy nie ma takiej nazwy, dzieli ją z innym modelem lub bierze ją z czegoś, co ukrywa Twoja rola, jest tytułowany jednym ze swoich kroków. Model alokacji nie ma własnej strony poza pakietem.

Pakiet stosuje te same zasady co pojedyncza strona w kwestii tego, co ukrywa Twoja rola. Przepływ pracy, tabela lub model alokacji, których nie możesz otworzyć, są pomijane i zliczane na górze, na przykład It leaves out 2 workflows and 5 tables you can’t open. Krok, którego nie możesz otworzyć, nigdy nie jest nazwany, tak jak na pojedynczej stronie.

Co ukrywa Twoja rola

Tabela, krok lub przepływ pracy mogą być ukryte przed rolą Menedżera lub Eksploratora. Strona nigdy nie wymienia tego, co ukrywa Twoja rola:

Krok, którego nie możesz otworzyć, jest zliczany — na przykład 2 more steps you can’t open — i zachowuje swój numer na liście kroków przepływu pracy.
Tabela, krok lub przepływ pracy, których nie możesz otworzyć, wyglądają tak samo jak te, które już nie istnieją — na przykład a table you can’t open or that no longer exists — dzięki czemu strony nie można użyć do sprawdzenia, czy coś ukrytego istnieje. Kroki pominięte w ten sposób na listach przepływu pracy są odnotowane, ponieważ tabela zapisywana przez jeden z nich może wtedy zostać wymieniona jako odczytywana z zewnątrz. Tabela wskazana przez krok, której nie możesz otworzyć lub która nie istnieje, jest pokazana pod nazwą, jaką podaje krok, a po niej (not a table you can open), a przepływ pracy analogicznie (not a workflow you can open).
Zażądanie strony elementu, który ukrywa Twoja rola, kończy się odpowiedzią, jakby go nie było.

Architekt może otworzyć wszystko, więc strony Architekta zamiast tego mówią a deleted table, (table not found), A deleted step lub (workflow not found).

Czego nie obejmuje

Liczby wierszy, rozmiary i czasy aktualizacji.
Tabele, do których krok dociera wyłącznie przez tekst SQL lub wyrażenie. Strona wymienia tabele, które krok nazywa w swoich ustawieniach.
Niezapisane zmiany. Strona opisuje zapisane ustawienia.

Dla asystentów AI

Weave AI może odczytać stronę tabeli, kroku lub przepływu pracy, gdy zapytasz o nią w rozmowie otwartej w projekcie, i odpowiedzieć na podstawie tego, co mówi strona. Zobacz Czat Weave AI.
Asystenci AI połączeni przez MCP mogą odczytać tę samą stronę za pomocą narzędzia doc_describe, po podaniu projektu, informacji, czy element jest tabelą, krokiem czy przepływem pracy, oraz jego identyfikatora. Wymaga to dostępu do odczytu kroków, przepływów pracy i tabel i stosuje te same zasady dotyczące tego, co ukrywa Twoja rola. Zobacz Agenci AI (MCP).