Kolumna długiego tekstu przechowuje do 2000 znaków dowolnego tekstu. Obsługuje treści wielowierszowe i jest często używana do opisów, notatek oraz szczegółowych komentarzy.

Za pomocą API kolumna długiego tekstu obsługuje operacje odczytu, filtrowania, tworzenia, aktualizacji i czyszczenia.

Typ kolumny	Typ implementacji	Obsługiwane operacje
long_text	LongTextValue	Odczyt: Tak Filtrowanie: Tak Tworzenie: Tak Aktualizacja: Tak Czyszczenie: Tak

---

Zapytania

Możesz pobierać dane z kolumn długiego tekstu za pomocą pola column_values obiektu items, używając fragmentu inline dla LongTextValue.

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

const query = `
  query ($itemIds: [ID!]) {
    items(ids: $itemIds) {
      name
      column_values {
        ... on LongTextValue {
          id
          text
          value
          updated_at
        }
      }
    }
  }
`;

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

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

Pola

Za pomocą poniższych pól możesz określić, jakie informacje zwróci implementacja LongTextValue.

Pole	Opis
column Column!	Kolumna, do której należy wartość.
id ID!	Unikalny identyfikator kolumny.
text String	Tekst w kolumnie. Jeśli kolumna jest pusta, zwraca "".
type ColumnType!	Typ kolumny.
updated_at Date	Data ostatniej aktualizacji kolumny. Zwraca null, jeśli kolumna nigdy nie była ustawiona.
value JSON	Surowa wartość kolumny w postaci ciągu JSON. Jeśli kolumna ma ustawioną wartość, zwraca {"text": "..."}, a jeśli jest pusta - null.

Przykładowa odpowiedź

{
  "data": {
    "items": [
      {
        "name": "Task A",
        "column_values": [
          {
            "id": "long_text",
            "text": "This is a detailed description.\nWith multiple lines.",
            "value": "{\"text\":\"This is a detailed description.\\nWith multiple lines.\",\"changed_at\":\"2026-03-21T12:00:00Z\"}",
            "updated_at": "2026-03-21T12:00:00+00:00"
          }
        ]
      }
    ]
  }
}

---

Filtrowanie

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

Operator	Wartość porównawcza	Opis
any_of	Tablica pełnych wartości tekstowych (np. ["exact text"])	Zwraca elementy, których tekst w kolumnie długiego tekstu dokładnie odpowiada dowolnej z podanych wartości. Użyj [""], aby dopasować puste wartości.
not_any_of	Tablica pełnych wartości tekstowych (np. ["exact text"])	Pomija elementy, których tekst w kolumnie długiego tekstu dokładnie odpowiada dowolnej z podanych wartości. Użyj [""], aby pominąć puste wartości.
contains_text	Fragment lub pełny ciąg tekstowy (np. "description")	Zwraca elementy, których tekst w kolumnie długiego tekstu zawiera podany fragment.
not_contains_text	Fragment lub pełny ciąg tekstowy (np. "description")	Pomija elementy, których tekst w kolumnie długiego tekstu zawiera podany fragment.
is_empty	[]	Zwraca elementy z pustą wartością w kolumnie długiego tekstu.
is_not_empty	[]	Zwraca elementy, dla których ustawiono wartość w kolumnie długiego tekstu.

Przykłady

Filtrowanie według częściowego dopasowania tekstu

Ten przykład zwraca wszystkie elementy, których kolumna długiego tekstu zawiera słowo „description”.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "long_text"
            compare_value: "description"
            operator: contains_text
          }
        ]
      }
    ) {
      items {
        id
        name
        column_values {
          ... on LongTextValue {
            text
          }
        }
      }
    }
  }
}

Filtrowanie według pustej wartości

Ten przykład zwraca wszystkie elementy, których kolumna długiego tekstu jest pusta.

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

---

Mutacje

Tworzenie

Wymagany zakres uprawnień: boards:write

Możesz utworzyć kolumnę długiego tekstu za pomocą ogólnej mutacji create_column, ustawiając column_type: long_text.

mutation {
  create_column(
    board_id: 1234567890
    title: "Notes"
    column_type: long_text
  ) {
    id
    title
    description
  }
}

Podczas tworzenia kolumny możesz też przekazać argument defaults, aby skonfigurować jej ustawienia. Dostępne ustawienia opisano w sekcji Odczytywanie konfiguracji kolumny.

mutation {
  create_column(
    board_id: 1234567890
    title: "Notes"
    column_type: long_text
    defaults: "{\"settings\": {\"hide_footer\": true}}"
  ) {
    id
    title
    settings
  }
}

Aktualizacja wartości

Możesz zaktualizować wartość w kolumnie długiego tekstu za pomocą mutacji change_simple_column_value lub change_multiple_column_values. Kolumna obsługuje do 2000 znaków.

change_simple_column_value

Przekaż treść tekstową bezpośrednio jako ciąg znaków. Użyj \n, aby wstawić nowy wiersz.

mutation {
  change_simple_column_value(
    item_id: 9876543210
    board_id: 1234567890
    column_id: "long_text"
    value: "This is a detailed description.\nWith a second line."
  ) {
    id
    name
  }
}

change_multiple_column_values

Przekaż klucz text jako obiekt JSON w column_values.

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"long_text\": {\"text\": \"This is a detailed description.\\nWith a second line.\"}}"
  ) {
    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({
    long_text: { text: "This is a detailed description.\nWith a second line." }
  }),
};

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

Ustawianie długiego tekstu podczas tworzenia elementu

Możesz ustawić wartość długiego tekstu podczas tworzenia elementu, przekazując wartość kolumny w argumencie column_values.

mutation {
  create_item(
    board_id: 1234567890
    item_name: "New task"
    column_values: "{\"long_text\": {\"text\": \"Initial description for this task.\"}}"
  ) {
    id
    name
  }
}

Czyszczenie

Możesz wyczyścić kolumnę długiego tekstu za pomocą mutacji change_simple_column_value lub change_multiple_column_values.

change_simple_column_value

Przekaż pusty ciąg znaków w value.

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

change_multiple_column_values

Przekaż null w column_values.

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"long_text\": null}"
  ) {
    id
    name
  }
}

---

Odczytywanie konfiguracji kolumny

Aby pobrać ustawienia kolumny długiego tekstu, wykonaj zapytanie o jej pole settings.

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

Struktura odpowiedzi settings

Pole settings zwraca typowany obiekt JSON z następującymi kluczami:

Klucz	Typ	Opis
hide_footer	boolean	Określa, czy stopka jest ukryta w interfejsie kolumny. Gdy ma wartość true, liczba słów i znaków nie jest wyświetlana.

Przykładowa odpowiedź settings

Domyślna kolumna długiego tekstu zwraca pusty obiekt ustawień:

{}

Kolumna z ukrytą stopką:

{
  "hide_footer": true
}

---

Pobieranie schematu typu kolumny

Możesz programowo pobrać schemat JSON ustawień kolumny długiego tekstu za pomocą zapytania get_column_type_schema. Zwraca ono strukturę, reguły walidacji oraz dostępne właściwości konfiguracji kolumny.

query {
  get_column_type_schema(
    type: long_text
  )
}

{
  "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": {
              "hide_footer": {
                "type": "boolean",
                "description": "Whether to hide the footer"
              }
            },
            "additionalProperties": false
          }
        }
      }
    }
  }
}

Odpowiedź zawiera nazwy właściwości, 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 lub przekazywania kontekstu agentom AI. Dowiedz się więcej o formacie odpowiedzi schematu.