Dokumentacja dla programistów
Zależności
Dokumentacja API (rdzeń)Dokumentacja API
Zależności łączą elementy na tablicy, dzięki czemu jeden element (poprzednik) jest powiązany z innym (elementem zależnym). Użyj poniższych zapytań, aby pobrać poprzedniki wszystkich elementów na tablicy lub pojedynczego elementu, wraz z typem zależności i opóźnieniem każdego z nich.
Aby odczytać lub zaktualizować wartość kolumny zależności elementu, zobacz dokumentację kolumny zależności.
Dostępne tylko w wersji API 2026-07 i nowszych
Zapytania
Pobieranie zależności na tablicy
- Zwraca poprzedniki zależności elementów na tablicy, po jednej stronie naraz
- Każdy element zawiera krawędzie prowadzące do jego poprzedników, wraz z typem zależności i opóźnieniem
query {
board_dependencies(board_id: 1234567890, limit: 50, page: 1) {
total_count
items {
item_id
predecessors {
source_item_id
dependency_type
lag
}
}
}
}
Argumenty
| Argument | Typ | Opis |
|---|---|---|
| board_id | ID! |
Unikalny identyfikator tablicy, dla której mają zostać pobrane zależności. |
| limit | Int |
Maksymalna liczba elementów zwracanych na stronie. Domyślnie 25, maksymalnie 500. |
| page | Int |
Numer strony do zwrócenia, zaczynając od 1. Domyślnie 1. |
| include_items_without_predecessors | Boolean |
Określa, czy uwzględnić elementy bez zależności od poprzedników. Domyślnie true. |
Pola
| Pole | Typ | Opis |
|---|---|---|
| items | [ItemDependency!] |
Elementy na bieżącej stronie wraz z krawędziami do poprzedników. |
| total_count | Int |
Łączna liczba elementów na wszystkich stronach. |
Więcej informacji o tym typie znajdziesz w dokumentacji BoardDependencies.
Pobieranie zależności elementu
- Zwraca wszystkich poprzedników zależności danego elementu
- Każda krawędź prowadząca do poprzednika zawiera typ zależności i opóźnienie
query {
item_dependency(board_id: 1234567890, item_id: 9876543210) {
item_id
predecessors {
source_item_id
dependency_type
lag
}
}
}
Argumenty
| Argument | Typ | Opis |
|---|---|---|
| board_id | ID! |
Unikalny identyfikator tablicy zawierającej ten element. |
| item_id | ID! |
Unikalny identyfikator elementu, którego poprzednicy mają zostać pobrani. |
Pola
| Pole | Typ | Opis |
|---|---|---|
| item_id | ID |
Identyfikator elementu. |
| predecessors | [DependencyEdge!] |
Krawędzie zależności od poprzedników elementu. |
Więcej informacji o tym typie znajdziesz w dokumentacji ItemDependency.