Utwórz widok tabeli (Platform MCP)
Użyj tego narzędzia, aby utworzyć nowy widok tablicy typu tabela z opcjonalnymi filtrami, sortowaniem, tagami i ustawieniami właściwymi dla tabeli (widoczność i kolejność kolumn oraz grupowanie). Użyj tego narzędzia zamiast create_view, gdy chcesz skonfigurować ustawienia właściwe dla tabeli. W przypadku prostego widoku tabeli wystarczy też użyć create_view.
Parametry
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| boardId | string |
Tak | ID tablicy, na której ma zostać utworzony widok tabeli. |
| name | string |
Nie | Nazwa widoku (np. „Elementy o wysokim priorytecie”, „Moje zadania”). |
| filter | object |
Nie | Konfiguracja filtra. Zawiera rules (tablicę elementów { column_id, compare_value, operator }) oraz opcjonalny operator (operator logiczny łączący reguły; domyślnie and). |
| sort | array |
Nie | Konfiguracja sortowania. Tablica obiektów { column_id, direction }. Domyślną wartością direction jest asc. |
| tags | array |
Nie | Tagi przypisywane do widoku. |
| settings | object |
Nie | Ustawienia właściwe dla tabeli: columns (widoczność i kolejność) oraz group_by. Zobacz opis ustawień poniżej. |
Pola settings.columns:
| Pole | Typ | Opis |
|---|---|---|
column_properties |
array |
Konfiguracja widoczności kolumn głównej tablicy - każda pozycja ma postać { column_id, visible }. |
subitems_column_properties |
array |
Konfiguracja widoczności kolumn podelementów - każda pozycja ma postać { column_id, visible }. |
floating_columns_count |
number |
Liczba wyświetlanych przypiętych kolumn. |
column_order |
array |
Lista identyfikatorów kolumn w określonej kolejności. |
Pola settings.group_by:
| Pole | Typ | Opis |
|---|---|---|
conditions |
array |
Warunki grupowania - każda pozycja ma postać { columnId, config? }, gdzie config.sortSettings zawiera { direction (ASC/DESC), type? }. |
hideEmptyGroups |
boolean |
Określa, czy ukrywać grupy, które nie zawierają elementów. |
Operatory reguł filtrowania: any_of, not_any_of, is_empty, is_not_empty, greater_than, lower_than, between, contains_text, not_contains_text (domyślnie any_of).
Przykład
Utwórz widok tabeli pogrupowany według statusu, z przypiętą i widoczną kolumną statusu:
{
"boardId": "1234567890",
"name": "By Status",
"settings": {
"columns": {
"column_properties": [
{ "column_id": "status", "visible": true }
],
"column_order": ["name", "status", "date"]
},
"group_by": {
"conditions": [{ "columnId": "status" }],
"hideEmptyGroups": true
}
}
}
Narzędzie zwraca potwierdzenie zawierające nazwę, identyfikator i typ nowego widoku tabeli.
Odpowiednik programistyczny
To narzędzie odpowiada mutacji create_view_table w API monday.com. Szczegółowe informacje znajdziesz w dokumentacji widoków tablicy.