Items to podstawowe obiekty platformy monday.com, które przechowują właściwe dane na tablicy. Aby lepiej zrozumieć platformę, wyobraź sobie, że każda tablica jest tabelą, a element to pojedynczy wiersz w tej tabeli. Wybierz wiersz i wypełnij go dowolnymi informacjami - w ten sposób utworzysz element!

Zapytania

Pobieranie elementów

• Wymagany zakres: boards:read
• Zwraca tablicę zawierającą metadane jednego lub kilku wskazanych elementów
• Można go używać tylko bezpośrednio na poziomie głównym; nie można go zagnieżdżać w innym zapytaniu

query {
  items(ids: [1234567890, 9876543210, 2345678901]) {
    name
  }
}

Argumenty

Argument	Typ	Opis
exclude_nonactive	Boolean	Pomija nieaktywne lub usunięte elementy oraz elementy należące do usuniętych elementów. Działa tylko w połączeniu z argumentem ids.
ids	[ID!]	Identyfikatory elementów, podelementów lub elementów nadrzędnych do zwrócenia. Za pomocą argumentu limit można podać maksymalnie 100 identyfikatorów naraz.
limit	Int	Liczba zwracanych elementów. Domyślnie 25, maksymalnie 100.
newest_first	Boolean	Umieszcza najnowsze elementy na początku listy.
page	Int	Numer strony do zwrócenia. Numeracja zaczyna się od 1.

Pola

Pole	Typ	Opis	Wartości wyliczeniowe
assets	[Asset]	Zasoby i pliki elementu.
board	Board	Tablica zawierająca element.
column_values	[ColumnValue]	Wartości kolumn elementu.
created_at	Date	Data utworzenia elementu.
creator	User	Twórca elementu.
creator_id	String!	Unikalny identyfikator twórcy elementu. Zwraca null, jeśli element został utworzony domyślnie na tablicy.
description	ItemDescription	Opis elementu.
email	String!	Adres e-mail elementu.
group	Group	Grupa elementu.
id	ID!	Unikalny identyfikator elementu.
linked_items	[Item!]!	Powiązane elementy.
name	String!	Nazwa elementu.
parent_item	Item	Element nadrzędny podelementu. Zwraca null, jeśli zapytanie dotyczy elementu nadrzędnego.
relative_link	String	Ścieżka względna elementu.
state	State	Stan elementu.	active all archived deleted
subitems	[Item]	Podelementy elementu.
subscribers	[User]!	Obserwujący element.
updated_at	Date	Data ostatniej aktualizacji elementu.
updates	[Update!]	Aktualizacje elementu.
url	String!	Adres URL elementu.

Mutacje

Wymagany zakres: boards:write

Tworzenie elementu

Tworzy nowy element. Zwraca Item.

Dane elementu są przechowywane w kolumnach, które zawierają określone informacje zależnie od typu kolumny. Każdy typ kolumny wymaga innego zestawu parametrów do aktualizacji wartości. Dane przekazywane do kolumny muszą mieć postać ciągu znaków w formacie JSON. Jeśli używasz JavaScriptu, możesz użyć JSON.stringify(), aby przekonwertować obiekt JSON na ciąg znaków.

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

mutation {
  create_item(
    board_id: 1234567890
    group_id: "group_one" 
    item_name: "new item" 
    column_values: "{\"date\":\"2023-05-25\"}"
    ) {
    id
  }
}

Argumenty

Argument	Typ	Opis	Akceptowane wartości
board_id	ID!	Unikalny identyfikator tablicy.
column_values	JSON	Wartości kolumn nowego elementu.
create_labels_if_missing	Boolean	Tworzy brakujące etykiety statusu lub menu rozwijanego (wymaga uprawnień do zmiany struktury tablicy).
group_id	String	Unikalny identyfikator grupy.
item_name	String!	Nazwa nowego elementu.
position_relative_method	PositionRelative	Określa położenie elementu względem innego elementu. Tego argumentu należy używać razem z relative_to.	Możesz użyć tego argumentu razem z relative_to, aby określić, nad którym lub pod którym elementem ma zostać utworzony nowy element. before_at: ta wartość wyliczeniowa tworzy nowy element nad elementem wskazanym przez relative_to. Jeśli nie użyjesz argumentu relative_to, nowy element zostanie utworzony na dole pierwszej aktywnej grupy (chyba że wskażesz grupę za pomocą group_id). after_at: ta wartość wyliczeniowa tworzy nowy element pod elementem wskazanym przez relative_to. Jeśli nie użyjesz argumentu relative_to, nowy element zostanie utworzony na górze pierwszej aktywnej grupy (chyba że wskażesz grupę za pomocą group_id).
relative_to	ID	Unikalny identyfikator elementu na tej samej tablicy, względem którego ma zostać określone położenie. Tego argumentu należy używać razem z position_relative_method.

Duplikowanie elementu

Duplikuje element lub podelement wraz z jego zagnieżdżonymi podelementami. Zwraca Item.

Uwaga: nie należy żądać aktualizacji w odpowiedzi, ponieważ są duplikowane asynchronicznie.

mutation {
  duplicate_item(
    board_id: 1234567890
    item_id: 9876543210 
    with_updates: true
  ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
item_id	ID	Unikalny identyfikator elementu. Wymagany.
with_updates	Boolean	Duplikuje element wraz z jego aktualizacjami.

Zmiana położenia elementu

Zmienia położenie elementu na tej samej tablicy. Zwraca Item.

mutation { 
 change_item_position(
  item_id: 1234567890
  relative_to: 9876543210
  position_relative_method: after_at
 ) {
  id
  group {
   id
  }
 }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
group_id	ID	Unikalny identyfikator istniejącej grupy. Tego argumentu należy używać razem z group_top.
group_top	Boolean	Określa, czy element zostanie umieszczony na górze, czy na dole grupy. Tego argumentu należy używać razem z group_id.
item_id	ID!	Unikalny identyfikator elementu. Przenoszenie podelementów ani przekształcanie elementu w podelement nie jest obecnie obsługiwane.
position_relative_method	PositionRelative	Określa położenie elementu względem innego elementu. Tego argumentu należy używać razem z relative_to.	after_at (przenosi element pod element wskazany przez relative_to) before_at (przenosi element nad element wskazany przez relative_to)
relative_to	ID	Unikalny identyfikator elementu na tej samej tablicy, względem którego ma zostać określone położenie. Tego argumentu należy używać razem z position_relative_method.

Ustawianie treści opisu elementu

Aktualizuje opis elementu przy użyciu Markdowna. Podany tekst w formacie Markdown jest konwertowany na bloki dokumentu i zastępuje dotychczasową treść elementu. Zwraca DocBlocksFromMarkdownResult.

mutation {
  set_item_description_content(
    item_id: 1234567890
    markdown: "**The updated description!**"
  ) {
    success
    error
    block_ids
  }
}

Argumenty

Argument	Typ	Opis	Uwagi
item_id	ID!	Unikalny identyfikator elementu.
markdown	String!	Zaktualizowana treść opisu elementu.	Markdown nie obsługuje kolorów tekstu ani wyróżnień tła. Istniejący tekst z kolorem lub wyróżnieniem zostanie utracony.

Aktualizowanie zasobów elementu

Aktualizuje pliki w kolumnie plików. Zwraca Item.

mutation {
  update_assets_on_item(
    board_id: 1234567890
    item_id: 9876543210
    column_id: "YOUR_COLUMN_ID"
    files: {
      fileType: asset
      name: "New asset"
      assetId: 12345
      linkToFile: "https://yourlink.com"
    }
  ) {
    assets {
      id
      name
      url
    }
  }
}

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
column_id	String!	Unikalny identyfikator kolumny.
files	[FileInput!]!	Obiekt zawierający dane wejściowe pliku.
item_id	ID!	Unikalny identyfikator elementu.

Przenoszenie elementu do grupy

Przenosi element lub podelement wraz z jego zagnieżdżonymi podelementami między grupami na tej samej tablicy. Zwraca Item.

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

Argumenty

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

Przenoszenie elementu na inną tablicę

Przenosi element lub podelement wraz z jego zagnieżdżonymi podelementami na inną tablicę. Zwraca Item.

mutation {
  move_item_to_board(
    board_id: 1234567890
    group_id: "new_group"
    item_id: 9876543210
    columns_mapping: [
      { source: "status", target: "status2" }
      { source: "person", target: "person" }
      { source: "date", target: "date4" }
    ]
  ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy, na którą ma zostać przeniesiony element (tablicy docelowej).
group_id	ID!	Unikalny identyfikator grupy, do której ma zostać przeniesiony element (grupy docelowej).
item_id	ID!	Unikalny identyfikator elementu do przeniesienia.
columns_mapping	[ColumnMappingInput!]	Obiekt określający mapowanie kolumn między tablicą źródłową a docelową. Można mapować wszystkie typy kolumn z wyjątkiem kolumn formuły. Jeśli używasz tego argumentu, musisz określić mapowanie wszystkich kolumn. Dla kolumn, których nie chcesz mapować, możesz ustawić wartość docelową null. Spowoduje to utratę danych z tych kolumn. Jeśli pominiesz ten argument, kolumny zostaną dopasowane na podstawie najlepszego dopasowania.
subitems_columns_mapping	[ColumnMappingInput!]	Obiekt określający mapowanie kolumn podelementów między tablicą źródłową a docelową. Można mapować wszystkie typy kolumn z wyjątkiem kolumn formuły. Jeśli używasz tego argumentu, musisz określić mapowanie wszystkich kolumn. Dla kolumn, których nie chcesz mapować, możesz ustawić wartość docelową null. Spowoduje to utratę danych z tych kolumn. Jeśli pominiesz ten argument, kolumny zostaną dopasowane na podstawie najlepszego dopasowania.

Archiwizowanie elementu

Archiwizuje element lub podelement wraz z jego zagnieżdżonymi podelementami. Zwraca Item.

mutation {
  archive_item(item_id: 1234567890) {
    id
  }
}

Argumenty

Argument	Typ	Opis
item_id	ID!	Unikalny identyfikator elementu.

Czyszczenie aktualizacji elementu

Usuwa wszystkie aktualizacje konkretnego elementu, w tym odpowiedzi i polubienia. Zwraca Item.

mutation {
  clear_item_updates(
    item_id: 1234567890
    ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
item_id	ID!	Unikalny identyfikator elementu.

Usuwanie elementu

Usuwa element lub podelement wraz z jego zagnieżdżonymi podelementami. Zwraca Item.

mutation {
  delete_item(
    item_id: 1234567890
    ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
item_id	ID	Unikalny identyfikator elementu.