Przejdź do głównej zawartości

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

Wybierz krok lub przepływ pracy w projekcie, a otworzy się jego panel szczegółów. Na dole sekcja Dokumentacja pokazuje stronę, którą Weave tworzy na podstawie zapisanych ustawień projektu. Panel szczegółów tabeli pokazuje zamiast tego jej Kolumny, z typem i opisem każdej kolumny; poniższa strona opisuje, co Weave i asystenci AI odczytują dla tabeli:

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

Strona jest tworzona za każdym razem, gdy wybierzesz element, na podstawie ustawień zapisanych w tym momencie, więc nigdy się nie dezaktualizuje i nie trzeba nic odświeżać ręcznie. 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ą odczytać tę samą stronę. Zobacz Dla asystentów AI.

  • Opis — Notatka tabeli, wyświetlana jako cytat. PlaidCloud ustawia notatkę Created dynamically w tabeli tworzonej przez krok; ta notatka nie jest wyświetlana, ponieważ nic nie mówi o tabeli.
  • Zapisywana przez i Odczytywana przez — każdy krok, według nazwy, wraz z typem kroku i przepływami pracy, w których się znajduje. (disabled) występuje przy przepływie pracy, w którym krok jest wyłączony, a not in any workflow oznacza krok, który nie należy do żadnego przepływu. Krok, którego nazwa tabeli zawiera zmienną, mogącą wskazywać tę tabelę, 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, przy czym liczone są tylko tabele, które możesz otworzyć. Krok Tabela: wyczyść, Tabela: usuń lub Tabela: usuń w miejscu jest traktowany jako zapisujący tabelę, którą zmienia, a krok, który odczytuje tabelę i zapisuje ją z powrotem, jest wymieniony w obu listach.
  • 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, z opisem z sekcji Właściwości kolumny, jeśli został ustawiony.

Sekcja What it does podaje jedno zdanie dla każdej rzeczy, którą krok wykonuje:

Krok Co mówi strona
Alokacja: podział Jaką wartość dzieli z której tabeli, między które kolumny, z użyciem której kolumny klucza i 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 tabela źródłowa i tabela klucza. Filtr na źródle lub kluczu kroku jest odnotowany, a tabele, które zapisuje, są wymienione z nazwy.
Alokacja: podział z użyciem wymiaru Jaką wartość dzieli z której tabeli i której kolumny klucza używa oraz każdą tabelę, którą zapisuje, w tym tabele mapowania, ścieżek i podsumowań.
Import Plik lub pliki, które importuje, oraz tabelę, do której importuje.
Eksport Tabelę, którą eksportuje, i plik, który zapisuje.
Wyodrębnienie: 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, a gdy wybiera tabele przez wyszukiwanie lub folder — że działa na tabelach wskazanych 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. Przepływ pracy wybrany przez zmienną jest pokazany jako nazwa podana w kroku, a przepływ pracy z innego projektu jest opisany jako taki. Każda tabela odczytywana przez sam krok, na przykład tabela, przez którą przechodzi pętla, jest również wymieniona.
Dowolny inny krok Tabele, które odczytuje, i tabele, które zapisuje.

Następnie strona podaje, gdzie krok jest uruchamiany — It is step 3 in oraz przepływ pracy, numerowany tak 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).

  • Kroki — numerowane tak 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 przepływu pracy, który jest dołączony, są wymienione w miejscu, tak jak pokazuje je lista kroków.
  • Reads from outside this workflow — tabele odczytywane przez krok, zanim jakikolwiek krok tego przepływu pracy je zapisze.
  • Zapis — tabele zapisywane przez kroki przepływu pracy.

Wyłączone kroki są wymienione w sekcji Kroki, ale pomijane w obu listach. Strona informuje o tym, 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.

Aby przekazać projekt, na przykład klientowi po zakończeniu zlecenia, 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 na podstawie zapisanych ustawień w chwili pobierania. Zaczyna się od opisu projektu i liczby zawartych w nim 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 ich uruchamiania. Przepływ pracy uruchamiany z dwóch miejsc jest wymieniony raz.
  • Tabele — strona każdej tabeli, jak powyżej, wraz z jej 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 i 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, które zasilają 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 jest uruchamiany w żadnym przepływie pracy, jest pomijany. Model nosi nazwę swojego przepływu pracy lub folderu, który współdzielą jego przepływy pracy. Gdy nie ma takiej nazwy, dzieli ją z innym modelem lub otrzymuje ją od czegoś, co twoja rola ukrywa, jest zatytułowany nazwą jednego ze swoich kroków. Model alokacji nie ma własnej strony poza pakietem.

Pakiet stosuje te same zasady co pojedyncza strona w odniesieniu do tego, co ukrywa twoja rola. Przepływ pracy, tabela lub model alokacji, których nie możesz otworzyć, są pomijane i policzone na początku, 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.

Tabela, krok lub przepływ pracy mogą być ukryte przed rolą Menedżer lub Eksplorator. Strona nigdy nie nazywa elementu ukrytego przed twoją rolą:

  • Krok, którego nie możesz otworzyć, jest policzony — 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ć, są opisane 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, którą jeden z nich zapisuje, 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ą, którą nadaje jej krok, a po niej (not a table you can open), natomiast przepływ pracy analogicznie z (not a workflow you can open).
  • Żądanie strony elementu ukrytego przed twoją rolą kończy się odpowiedzią, jakby go nie było.

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

  • Liczby wierszy, rozmiary i czasy aktualizacji.
  • Tabele, do których krok sięga tylko przez tekst SQL lub wyrażenie. Strona wymienia tabele, które krok nazywa w swoich ustawieniach.
  • Niezapisane zmiany. Strona opisuje zapisane ustawienia.
  • 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, rodzaju elementu (tabela, krok lub przepływ pracy) i 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).