Każda tablica monday.com ma co najmniej jedną kolumnę, która przechowuje określony typ informacji. Wartości tych kolumn składają się na zawartość tablicy, a ich wewnętrzna struktura zależy od typu kolumny.

Zapytania

Pobieranie wartości kolumn

• Zwraca tablicę zawierającą metadane jednej lub wielu kolumn
• Można zagnieździć wyłącznie w zapytaniu items

query {
  items(ids: 1234567890) {
    column_values {
      column {
        title
      }
      id
      type
      value
    }
  }
}

Argumenty

Pola

Implementacje

Nasz schemat zawiera również konkretne typy dla poszczególnych wartości kolumn, takie jak ButtonValue i StatusValue. Rozszerzają one podstawowy typ ColumnValue, dzięki czemu możesz wysyłać zapytania o pola specyficzne dla danej kolumny zamiast analizować jej surową wartość JSON.

Weźmy na przykład typ StatusValue. Oprócz 6 podstawowych pól udostępnia on również pola index, is_done, label, label_style, update_id i updated_at, specyficzne dla typu StatusValue (pola).

Pobieranie pól specyficznych dla kolumny za pomocą fragmentów

Możesz zwracać podpola dla określonego typu kolumny za pomocą fragmentów GraphQL lub zapytań, które są wykonywane tylko wtedy, gdy zwrócony zostanie określony typ. Fragmenty pozwalają wybiórczo pobierać dane specyficzne dla kolumny, których nie ma w innych kolumnach na tablicy. Pola dla poszczególnych typów kolumn są opisane tutaj.

Przykład

Zwróć uwagę na wyrażenie ...on StatusValue, które zwróci pola label i update_id tylko dla kolumn statusu.

query {
  items (ids: 1234567890) {
    column_values {
      value
      type
      ... on StatusValue  { # will only run for status columns
        label
        update_id
      }
    }
  }
}