Podelementy to specjalne elementy zagnieżdżone pod elementami na tablicy. Możesz uzyskać do nich dostęp za pomocą kolumny podelementów. Dodaj ją ze środka kolumny lub kliknij element prawym przyciskiem myszy, aby wyświetlić menu rozwijane. Podobnie jak elementy, podelementy przechowują dane w swoich kolumnach.

Zapytania

Pobieranie podelementów

• Wymagany zakres:boards:read
• Zwraca tablicę zawierającą metadane jednego lub wielu podelementów.
• Zapytanie można zagnieździć tylko w innym zapytaniu (np. items). Nie można go wykonać bezpośrednio na poziomie głównym.

query {
  items(ids: 1234567890) {
    subitems {
      id
      column_values {
        value
        text
      }
    }
  }
}

Pola

Mutacje

Wymagany zakres:boards:write

Tworzenie podelementu

Tworzy nowy podelement za pomocą API. Zwraca Item.

Dane każdego podelementu są przechowywane w kolumnach tablicy podelementów, tak samo jak w przypadku elementów. Każda kolumna zawiera określoną informację. Kolumny mają różne typy, a każdy typ wymaga innych parametrów do aktualizacji wartości. Wysyłając dane do konkretnej kolumny, użyj ciągu znaków w formacie JSON. Jeśli używasz JavaScriptu, możesz przekonwertować obiekt JSON na ciąg znaków za pomocą JSON.stringify().

W tej mutacji możesz też używać prostych wartości lub łączyć je ze standardowymi wartościami. Więcej informacji o wysyłaniu danych do poszczególnych kolumn znajdziesz w referencji typów kolumn.

mutation {
  create_subitem(
    parent_item_id: 1234567890, 
    item_name: "New subitem", 
    column_values: "{\"date0\":\"2023-05-25\"}"
    ) {
    id
    board {
      id
    }
  }
}

Argumenty