Pobierz elementy z tablicy (Platform MCP)
Użyj tego narzędzia, aby pobrać elementy z tablicy monday.com. Obsługuje stronicowanie oparte na kursorze, ustrukturyzowane filtry kolumn, wyszukiwanie pełnotekstowe, sortowanie oraz opcjonalne uwzględnianie wartości kolumn, opisów elementów i podelementów. Odpowiedź zawiera identyfikatory i nazwy elementów, adresy URL, znaczniki czasu oraz - jeśli includeColumns ma wartość true - wartości każdej kolumny.
Warunek wstępny: przed użyciem filtrów wywołaj get_board_info, aby pobrać prawidłowe identyfikatory kolumn, typy kolumn i wartości etykiet statusu dla tej tablicy. Aby filtrować na podstawie widoku (np. „pokaż widok Zaległe”), najpierw wywołaj get_board_info, pobierz obiekt filtrów widoku, a następnie przekaż go jako filters.
Gdy odpowiedź zawiera has_more o wartości true, przekaż wartość nextCursor jako cursor, aby pobrać następną stronę.
Parametry
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| boardId | number |
Tak | Identyfikator tablicy, z której chcesz pobrać elementy. |
| itemIds | array |
Nie | Pobierz konkretne elementy na podstawie ich identyfikatorów (maksymalnie 100). |
| searchTerm | string |
Nie | Wyszukiwany tekst. Użyj tego parametru, gdy użytkownik podaje przybliżone hasło, a nie dokładną wartość kolumny. Do wyszukiwania dokładnych wartości używaj zamiast tego ustrukturyzowanych filtrów filters. |
| limit | number |
Nie | Liczba elementów zwracanych na stronie. Zakres: 1–500. Domyślnie 25. |
| cursor | string |
Nie | Kursor stronicowania z pola nextCursor w poprzedniej odpowiedzi. |
| includeColumns | boolean |
Nie | Czy uwzględnić wartości kolumn. Domyślnie false. Włącz tę opcję tylko wtedy, gdy potrzebujesz danych kolumn - znacznie zwiększa rozmiar odpowiedzi. |
| includeItemDescription | boolean |
Nie | Czy uwzględnić opis elementu w formacie tekstu sformatowanego (treść/notatki). Domyślnie false. |
| includeSubItems | boolean |
Nie | Czy uwzględnić podelementy każdego elementu. Domyślnie false. |
| subItemLimit | number |
Nie | Liczba podelementów zwracanych dla każdego elementu, gdy includeSubItems ma wartość true. Zakres: 1–100. Domyślnie 25. |
| filters | array |
Nie | Tablica obiektów filtrów kolumn. Każdy filtr wymaga columnId i compareValue; opcjonalnie można podać operator i compareAttribute. Wywołaj get_column_type_info z fetchMode: "guidelines", aby sprawdzić prawidłowe wartości filtrów dla danego typu kolumny. |
| filtersOperator | string |
Nie | Operator logiczny używany do łączenia wielu filtrów. Przyjmuje wartość and (domyślnie) lub or. |
| columnIds | array |
Nie | Ogranicza zwracane kolumny, gdy includeColumns ma wartość true. Jeśli pominiesz ten parametr, zwrócone zostaną wszystkie kolumny. |
| orderBy | array |
Nie | Tablica obiektów sortowania zawierających columnId i direction (asc lub desc). |
Przykład
Pobierz pierwsze 5 elementów z tablicy 18392419286 wraz z wartościami kolumn:
{
"boardId": 18392419286,
"limit": 5,
"includeColumns": true
}
Odpowiedź zawierała 5 elementów z nazwami, adresami URL, datami utworzenia i wartościami kolumn (w tym status, date, status_1 i files). Obiekt pagination wskazywał has_more: true i zawierał wartość nextCursor, która pozwala pobrać następną stronę.
Odpowiednik programistyczny
Użyj GraphQL API, aby uzyskać ten sam wynik:
query {
boards(ids: [18392419286]) {
items_page(limit: 5) {
cursor
items {
id
name
url
created_at
updated_at
column_values {
id
text
value
}
}
}
}
}
Pełną dokumentację znajdziesz na stronie Items Page.