Kolumna identyfikatora elementu wyświetla unikalny identyfikator przypisany do każdego elementu. Może pokazywać identyfikator liczbowy albo klucz w niestandardowym formacie z konfigurowalnym prefiksem i dopełnieniem zerami.

Za pomocą API możesz odczytywać wartości tej kolumny i filtrować po nich. Nie możesz ich aktualizować ani czyścić, ponieważ system generuje je i zarządza nimi automatycznie. Identyfikator elementu możesz też odczytać bezpośrednio, pobierając pole id z dowolnego pola zwracającego typ items.

Typ kolumny	Typ implementacji	Obsługiwane operacje
item_id	ItemIdValue	Odczyt: tak Filtrowanie: tak Tworzenie: nie Aktualizowanie: nie Czyszczenie: nie

---

Zapytania

Kolumny identyfikatora elementu możesz odpytywać za pomocą pola column_values w zapytaniach items. Użyj do tego fragmentu inline dla ItemIdValue.

query {
  items(ids: [1234567890, 9876543210]) {
    name
    column_values {
      ... on ItemIdValue {
        id
        item_id
        text
        value
        is_leaf
      }
    }
  }
}

const query = `
  query ($itemIds: [ID!], $columnType: [ColumnType!]) {
    items(ids: $itemIds) {
      name
      column_values(types: $columnType) {
        column { title id }
        ... on ItemIdValue {
          item_id
          text
          is_leaf
        }
      }
    }
  }
`;

const variables = {
  itemIds: [1234567890, 9876543210],
  columnType: "item_id"
};

const response = await mondayApiClient.request(query, variables);

Pola

Możesz użyć następujących pól, aby określić, jakie informacje zwróci implementacja ItemIdValue.

Pole	Opis
column Column!	Kolumna, do której należy wartość.
id ID!	Unikalny identyfikator kolumny.
is_leaf Boolean!	Określa, czy element jest węzłem końcowym (nie ma podelementów). Zwraca true dla elementów bez podelementów.
item_id ID!	Unikalny identyfikator elementu.
text String	Wartość kolumny w postaci tekstu. Zwraca identyfikator elementu jako ciąg znaków.
type ColumnType!	Typ kolumny (item_id).
value JSON	Surowa wartość kolumny jako ciąg znaków JSON. Zwraca {"item_id": "1234567890"}.

Przykładowa odpowiedź

{
  "data": {
    "items": [
      {
        "name": "Task A",
        "column_values": [
          {
            "id": "pulse_id",
            "item_id": "1234567890",
            "text": "1234567890",
            "value": "{\"item_id\":\"1234567890\"}",
            "is_leaf": true
          }
        ]
      }
    ]
  }
}

---

Filtrowanie

Możesz filtrować elementy według ich identyfikatorów za pomocą obiektu items_page.

Operator	Wartość porównawcza	Opis
any_of	Tablica identyfikatorów elementów jako ciągów znaków (np. ["1234567890"])	Zwraca elementy, których identyfikator odpowiada dowolnej z podanych wartości.
not_any_of	Tablica identyfikatorów elementów jako ciągów znaków (np. ["1234567890"])	Pomija elementy, których identyfikator odpowiada dowolnej z podanych wartości.
contains_terms	Identyfikator elementu jako ciąg znaków (np. "1234567890")	Zwraca elementy, których identyfikator zawiera podany tekst.
is_not_empty	[]	Zwraca elementy, którym przypisano identyfikator. Ponieważ każdy element ma identyfikator, ten operator zwraca wszystkie elementy.
is_empty	[]	Zwraca elementy bez identyfikatora. Ponieważ każdy element ma identyfikator, ten operator zawsze zwraca pusty wynik.

Przykłady

Filtrowanie według konkretnych identyfikatorów elementów

Ten przykład zwraca elementy, których identyfikator odpowiada dowolnej z podanych wartości.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "pulse_id"
            compare_value: ["9876543210", "1122334455"]
            operator: any_of
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

Pomijanie konkretnych identyfikatorów elementów

Ten przykład zwraca wszystkie elementy oprócz tych o podanych identyfikatorach.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "pulse_id"
            compare_value: ["9876543210"]
            operator: not_any_of
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

---

Mutacje

Kolumna identyfikatora elementu jest tylko do odczytu, a jej wartości są obliczane automatycznie. Nie można jej aktualizować, czyścić ani ustawiać podczas tworzenia elementu.

Próba aktualizacji kolumny identyfikatora elementu za pomocą change_simple_column_value lub change_multiple_column_values zwraca błąd:

---

Odczytywanie konfiguracji kolumny

Aby wyświetlić konfigurację kolumny identyfikatora elementu, pobierz jej pole settings.

query {
  boards(ids: 1234567890) {
    columns(ids: ["pulse_id"]) {
      id
      title
      type
      settings
    }
  }
}

Struktura odpowiedzi settings

Pole settings zwraca obiekt JSON z typowanymi polami i następującymi kluczami:

Klucz	Typ	Opis
copyValueSetting	string	Sposób kopiowania wartości: "text" (sam identyfikator) lub "link" (odnośnik do elementu).
displayType	string	Typ wyświetlania: "pulseId" (surowy identyfikator liczbowy) lub "customKey" (klucz z prefiksem).
customKeySettings	object	Ustawienia niestandardowego formatu klucza. Zawiera prefix (ciąg znaków) i padding (liczba całkowita).

Przykład: ustawienia domyślne

W przypadku standardowej kolumny identyfikatora elementu pole settings zwraca pusty obiekt:

{}

Przykład: ustawienia niestandardowego klucza

W przypadku kolumny skonfigurowanej do wyświetlania klucza w niestandardowym formacie:

{
  "displayType": "customKey",
  "customKeySettings": {
    "prefix": "PROJ-",
    "padding": 5
  }
}

W monday.com ta konfiguracja wyświetla identyfikatory elementów w formacie PROJ-00001, PROJ-00002 itd. API nadal zwraca surowy identyfikator liczbowy w polach item_id i text.

---

Pobieranie schematu typu kolumny

Schemat JSON ustawień kolumny identyfikatora elementu możesz pobrać programowo za pomocą zapytania get_column_type_schema. Zwraca ono strukturę, reguły walidacji i dostępne właściwości konfiguracji kolumny.

query {
  get_column_type_schema(
    type: item_id
  )
}

{
  "data": {
    "get_column_type_schema": {
      "schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "settings": {
            "type": "object",
            "description": "Column specific settings",
            "properties": {
              "copyValueSetting": {
                "type": "string",
                "description": "How to copy the value (text or link)",
                "enum": [
                  "text",
                  "link"
                ]
              },
              "displayType": {
                "type": "string",
                "description": "Display type for the column value",
                "enum": [
                  "pulseId",
                  "customKey"
                ]
              },
              "customKeySettings": {
                "type": "object",
                "description": "Settings for custom key display type",
                "properties": {
                  "prefix": {
                    "type": "string",
                    "description": "Prefix for the generated key"
                  },
                  "padding": {
                    "type": "integer",
                    "description": "Minimum digits (zero padding)",
                    "minimum": 0
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          }
        }
      }
    }
  }
}

Odpowiedź zawiera nazwy pól i ich typy, ograniczenia (takie jak maksymalna długość i dozwolone wartości) oraz opisy poszczególnych ustawień. Możesz jej użyć do walidacji ustawień kolumny, dynamicznego generowania interfejsów użytkownika lub dostarczenia kontekstu agentom AI. Dowiedz się więcej o formacie odpowiedzi schematu.