Dokumentacja dla programistów
Inne typy
Dokumentacja API (rdzeń)Dokumentacja API
Only available in API versions 2027-01 and later
Interfejs API monday.com items_page umożliwia odczytywanie elementów tablicy za pomocą rozbudowanych filtrów.
Każdy z opisanych poniżej typów obiektów reprezentuje konkretny aspekt filtra. Możesz przekazać je jako argumenty, aby zdefiniować zapytanie o elementy z filtrem.
ItemsQuery
Obiekt zawierający zestaw parametrów do filtrowania i sortowania zapytania oraz określania jego zakresu.
| Pole | Opis | Wartości wyliczeniowe | Obsługiwane pola |
|---|---|---|---|
groups [ItemsQueryGroup!] |
Reguły grup i atrybuty używane do filtrowania zapytań. | groups [ItemsQueryGroup!]\
operator ItemsQueryOperator\
rules [ItemsQueryRule!] |
|
ids [ID!] |
Identyfikatory konkretnych elementów, które mają zostać zwrócone. Maksymalna liczba to 100. | ||
operator ItemsQueryOperator |
Warunki łączące reguły zapytania. Domyślnie jest to and. |
and or |
|
order_by [ItemsQueryOrderBy!] |
Atrybuty, według których sortowane są wyniki. | column_id String!\
direction ItemsOrderByDirection |
|
rules [ItemsQueryRule!] |
Reguły używane do filtrowania zapytań. | column_id ID!\
compare_attribute String\
compare_value CompareValue!\
operator ItemsQueryRuleOperator |
ItemsQueryGroup
Obiekt zawierający reguły grup.
| Pole | Opis | Wartości wyliczeniowe | Obsługiwane pola |
|---|---|---|---|
groups [ItemsQueryGroup!] |
Reguły grup i atrybuty używane do filtrowania zapytań. | groups [ItemsQueryGroup!]\
operator ItemsQueryOperator\
rules [ItemsQueryRule!] |
|
operator ItemsQueryOperator |
Warunki łączące reguły zapytania. Domyślnie jest to and. |
and\
or |
|
rules [ItemsQueryRule!] |
Reguły używane do filtrowania zapytań. | column_id ID!\
compare_attribute String\
compare_value CompareValue!\
operator ItemsQueryRuleOperator |
ItemsQueryOrderBy
Obiekt zawierający atrybuty, według których sortowane są wyniki.
| Pole | Opis | Wartości wyliczeniowe |
|---|---|---|
column_id String! |
Unikalny identyfikator kolumny, według której mają być filtrowane lub sortowane wyniki. Możesz też wpisać "__creation_log__" lub "__last_updated__", aby chronologicznie posortować wyniki według daty ich ostatniej aktualizacji lub utworzenia (od najstarszych do najnowszych). |
|
direction ItemsOrderByDirection |
Kierunek sortowania elementów. Domyślnie jest to asc. | asc\
desc |
ItemsQueryRule
Obiekt zawierający reguły używane do filtrowania zapytań.
| Pole | Opis | Wartości wyliczeniowe |
|---|---|---|
column_id ID! |
Unikalny identyfikator kolumny, według której mają być filtrowane wyniki. | |
compare_attribute String |
Atrybut porównania. Obsługiwane atrybuty poszczególnych typów kolumn znajdziesz w dokumentacji typów kolumn. Większość kolumn nie ma atrybutu compare_attribute. |
|
compare_value CompareValue! |
Wartość kolumny, według której mają być filtrowane wyniki. Zależnie od typu kolumny może to być string lub wartość indeksu. Obsługiwane wartości poszczególnych typów kolumn znajdziesz w dokumentacji typów kolumn. |
|
operator ItemsQueryRuleOperator |
Warunek porównania wartości. Domyślnie jest to any_of. |
any_of\
not_any_of\
is_empty\
is_not_empty\
greater_than\
greater_than_or_equals\
lower_than\
lower_than_or_equal\
between\
not_contains_text\
contains_text\
contains_terms\
starts_with\
ends_with\
within_the_next\
within_the_last |