Kolumna nazwy przechowuje nazwę elementu i zawsze jest pierwszą kolumną na tablicy. Każdy element musi mieć nazwę - nie może być ona pusta ani usunięta.

Za pomocą API można odczytywać, filtrować i aktualizować wartości w kolumnie nazwy.

Typ kolumny	Typ implementacji	Obsługiwane operacje
name	-	Odczyt: Tak Filtrowanie: Tak Tworzenie: Nie (kolumna jest tworzona automatycznie na każdej tablicy) Aktualizacja: Tak Czyszczenie: Nie

---

Zapytania

Nie można odczytać kolumny nazwy przez pole column_values. Zapytanie column_values(ids: ["name"]) zwraca pustą tablicę.

Zamiast tego użyj jednej z poniższych metod:

Odczyt za pomocą pola name

Najprostszy sposób na odczytanie nazwy elementu to użycie pola name w obiekcie items.

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

const query = `
  query ($itemIds: [ID!]) {
    items(ids: $itemIds) {
      id
      name
    }
  }
`;

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

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

Przykładowa odpowiedź

{
  "data": {
    "items": [
      {
        "id": "1234567890",
        "name": "Task A"
      },
      {
        "id": "9876543210",
        "name": "Task B"
      }
    ]
  }
}

Odczyt za pomocą items_page_by_column_values

Możesz też użyć zapytania items_page_by_column_values, aby znaleźć elementy o nazwie zgodnej z określoną wartością.

query {
  items_page_by_column_values(
    board_id: 1234567890
    columns: {
      column_id: "name"
      column_values: "Task A"
    }
  ) {
    items {
      id
      name
    }
  }
}

const query = `
  query ($boardId: ID!, $columnValues: String!) {
    items_page_by_column_values(
      board_id: $boardId
      columns: {
        column_id: "name"
        column_values: $columnValues
      }
    ) {
      items {
        id
        name
      }
    }
  }
`;

const variables = { boardId: 1234567890, columnValues: "Task A" };

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

---

Filtrowanie

Możesz filtrować elementy według wartości w kolumnie nazwy za pomocą obiektu items_page. Kolumna nazwy obsługuje następujące operatory:

Operator	Wartość porównania	Opis
any_of	Tablica pełnych nazw (np. ["Task A"])	Zwraca elementy, których nazwa jest dokładnie taka sama jak jedna z podanych wartości.
not_any_of	Tablica pełnych nazw (np. ["Task A"])	Pomija elementy, których nazwa jest dokładnie taka sama jak jedna z podanych wartości.
contains_text	Fragment lub pełna nazwa (np. ["Task"])	Zwraca elementy, których nazwa zawiera podany tekst.
not_contains_text	Fragment lub pełna nazwa (np. ["Task"])	Pomija elementy, których nazwa zawiera podany tekst.

Przykłady

Filtrowanie według dokładnej nazwy

Ten przykład zwraca wszystkie elementy, których nazwa to dokładnie „Project Alpha”.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "name"
            compare_value: ["Project Alpha"]
            operator: any_of
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

Filtrowanie według fragmentu nazwy

Ten przykład zwraca wszystkie elementy, których nazwa zawiera tekst „Project”.

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

Wykluczanie według nazwy

Ten przykład zwraca wszystkie elementy, których nazwa nie zawiera tekstu „Draft”.

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

---

Mutacje

Aktualizacja

Możesz zaktualizować nazwę elementu za pomocą change_simple_column_value lub change_multiple_column_values. Nazwa musi mieć od 1 do 255 znaków.

change_simple_column_value

Przekaż nową nazwę jako zwykły ciąg znaków w argumencie value.

mutation {
  change_simple_column_value(
    item_id: 9876543210
    board_id: 1234567890
    column_id: "name"
    value: "Updated Task Name"
  ) {
    id
    name
  }
}

const query = `
  mutation ($boardId: ID!, $itemId: ID!, $value: String!) {
    change_simple_column_value(
      item_id: $itemId
      board_id: $boardId
      column_id: "name"
      value: $value
    ) {
      id
      name
    }
  }
`;

const variables = {
  boardId: 1234567890,
  itemId: 9876543210,
  value: "Updated Task Name"
};

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

change_multiple_column_values

Przekaż nazwę jako wartość ciągu JSON w polu column_values.

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"name\": \"Updated Task Name\"}"
  ) {
    id
    name
  }
}

const query = `
  mutation ($boardId: ID!, $itemId: ID!, $columnValues: JSON!) {
    change_multiple_column_values(
      item_id: $itemId
      board_id: $boardId
      column_values: $columnValues
    ) {
      id
      name
    }
  }
`;

const variables = {
  boardId: 1234567890,
  itemId: 9876543210,
  columnValues: JSON.stringify({ name: "Updated Task Name" })
};

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

Ustawianie nazwy podczas tworzenia elementu

Podczas tworzenia elementu ustaw jego nazwę za pomocą argumentu item_name. Możesz też podać ją w polu column_values.

Użycie item_name

mutation {
  create_item(
    board_id: 1234567890
    item_name: "New Task"
  ) {
    id
    name
  }
}

Użycie column_values

mutation {
  create_item(
    board_id: 1234567890
    item_name: "Placeholder"
    column_values: "{\"name\": \"Actual Task Name\"}"
  ) {
    id
    name
  }
}

Czyszczenie

Nie można wyczyścić kolumny nazwy. Każdy element musi mieć nazwę.

• Przekazanie pustego ciągu znaków do change_simple_column_value zwraca: "Invalid item name. Name must not be empty"
• Przekazanie null lub "" przez change_multiple_column_values spowoduje zignorowanie aktualizacji bez komunikatu - nazwa pozostanie bez zmian.

---

Odczyt konfiguracji kolumny

Kolumna nazwy nie ma ustawień, które można konfigurować. Zapytanie o settings zwraca pusty obiekt JSON.

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

Przykładowa odpowiedź

{
  "data": {
    "boards": [
      {
        "columns": [
          {
            "id": "name",
            "title": "Name",
            "type": "name",
            "settings": {}
          }
        ]
      }
    ]
  }
}

---

Pobieranie schematu typu kolumny

Możesz programowo pobrać schemat JSON ustawień kolumny nazwy 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: name
  )
}

{
  "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": {},
            "additionalProperties": false
          }
        }
      }
    }
  }
}

Kolumna nazwy nie ma ustawień, które można konfigurować, dlatego schemat zwraca pusty obiekt settings. Dowiedz się więcej o formacie odpowiedzi schematu.