Elementy są uporządkowane w różnych sekcjach tablicy, nazywanych grupami. Każda tablica zawiera co najmniej jedną grupę, w której znajduje się jeden lub więcej elementów.

Zapytania

Pobieranie grup

• Wymagany zakres:boards:read
• Zwraca tablicę zawierającą metadane jednej lub wielu grup na określonej tablicy.
• To zapytanie może być używane wyłącznie wewnątrz innego zapytania (np. boards).

query {
  boards(ids: 1234567890) {
    groups {
      title
      id
    }
  }
}

Argumenty

Argument	Typ	Opis
ids	[String]	Konkretne grupy do zwrócenia.

Pola

Pole	Typ	Opis
archived	Boolean	Zwraca true, jeśli grupa jest zarchiwizowana.
color	String!	Kolor grupy.
deleted	Boolean	Zwraca true, jeśli grupa została usunięta.
id	ID!	Unikalny identyfikator grupy.
items_page	ItemsResponse!	Elementy w grupie.
position	String!	Pozycja grupy na tablicy.
title	String!	Tytuł grupy.

Mutacje

Wymagany zakres:boards:write

Tworzenie grupy

Tworzy nową, pustą grupę. Zwraca Group.

mutation {
  create_group(
    board_id: 1234567890, 
    group_name: "new group", 
    relative_to: "test_group", 
    group_color: "#ff642e", 
    position_relative_method: before_at
    ) {
    id
  }
}

Argumenty

Argument	Typ	Opis	Akceptowane wartości
board_id	ID!	Unikalny identyfikator tablicy.
group_color	String	Kolor grupy w formacie HEX.	Pełną listę akceptowanych wartości kodów HEX i odpowiadających im kolorów znajdziesz tutaj (pamiętaj, aby w ciągu znaków uwzględnić #).
group_name	String!	Nazwa nowej grupy. Maksymalnie 255 znaków.
position (DEPRECATED)	String	Pozycja grupy na tablicy.	Pozycja grupy jest określana za pomocą ciągu znaków zawierającego wyłącznie wartość liczbową (bez liter i znaków specjalnych). Im wyższa wartość, tym niżej grupa znajduje się na tablicy; im niższa wartość, tym wyżej. Jeśli podasz nieprawidłową wartość zawierającą litery lub znaki specjalne, grupa zostanie umieszczona na górze tablicy. Jeśli podasz wartość typu number zamiast string, pojawi się błąd. Na przykład:* Załóżmy, że Grupa 1 ma pozycję 10000, a Grupa 3 ma pozycję 30000. Jeśli chcesz utworzyć między nimi nową grupę o nazwie Grupa 2, jej pozycja musi być większa niż 10000 i mniejsza niż 30000.
relative_to	String	Unikalny identyfikator grupy, względem której chcesz utworzyć nową grupę. Domyślnie nowa grupa zostanie utworzona poniżej wskazanej wartości group_id. Możesz też użyć tego argumentu razem z position_relative_method, aby określić, czy nowa grupa ma być utworzona powyżej, czy poniżej wskazanej grupy.
position_relative_method	PositionRelative	Określa pozycję nowej grupy.	Możesz użyć tego argumentu razem z relative_to, aby wskazać, powyżej której lub poniżej której grupy chcesz utworzyć nową grupę. before_at: Ta wartość wyliczeniowa tworzy nową grupę powyżej wartości relative_to. Jeśli nie użyjesz argumentu relative_to, nowa grupa zostanie utworzona na dole tablicy. after_at: Ta wartość wyliczeniowa tworzy nową grupę poniżej wartości relative_to. Jeśli nie użyjesz argumentu relative_to, nowa grupa zostanie utworzona na górze tablicy.

Aktualizowanie grupy

Aktualizuje grupę. Zwraca Group.

mutation {
  update_group(
    board_id: 1234567890, 
    group_id: "test group id", 
    group_attribute: relative_position_before, 
    new_value: "test_group"
    ) { 
    id
  } 
}

Argumenty

Argument	Typ	Opis	Akceptowane wartości
board_id	ID!	Unikalny identyfikator tablicy.
group_attribute	GroupAttributes!	Atrybut grupy do zaktualizowania.	color position relative_position_after relative_position_before title
group_id	String!	Unikalny identyfikator grupy.
new_value	String!	Nowa wartość atrybutu.	Pełną listę akceptowanych wartości kolorów znajdziesz tutaj. Podczas aktualizowania pozycji grupy za pomocą atrybutu relative_position_after lub relative_position_before nową wartością atrybutu powinien być unikalny identyfikator grupy, względem której chcesz umieścić aktualizowaną grupę.

Duplikowanie grupy

Duplikuje grupę i wszystkie jej elementy. Zwraca Group.

mutation {
  duplicate_group(
    board_id: 1234567890, 
    group_id: "test group id", 
    add_to_top: true
    ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
add_to_top	Boolean	Wartość logiczna określająca, czy dodać nową grupę na górze tablicy.
board_id	ID!	Unikalny identyfikator tablicy.
group_id	String!	Unikalny identyfikator grupy.
group_title	String	Tytuł grupy.

Przenoszenie elementu do grupy

Przenosi element między grupami na tej samej tablicy. Zwraca Group.

mutation {
  move_item_to_group(
    item_id: 1234567890, 
    group_id: "test group id"
    ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
group_id	String!	Unikalny identyfikator grupy.
item_id	ID	Unikalny identyfikator elementu.

Archiwizowanie grupy

Archiwizuje grupę i wszystkie jej elementy. Zwraca Group.

mutation {
  archive_group(
    board_id: 1234567890, 
    group_id: "test group id"
    ) {
    id
    archived
  }
}

Argumenty

Możesz użyć poniższych argumentów, aby określić, którą grupę zarchiwizować.

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
group_id	String!	Unikalny identyfikator grupy.

Usuwanie grupy

Usuwa grupę i wszystkie jej elementy. Zwraca Group.

mutation {
  delete_group(
    board_id: 1234567890
    group_id: "Test Group ID"
  ) {
    id
    deleted
  }
}

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
group_id	String!	Unikalny identyfikator grupy.