Kolumna numeracji automatycznej wyświetla kolejny numer dla każdego elementu w grupie lub na tablicy. Najczęściej służy do śledzenia liczby elementów i ich kolejności. Numery są obliczane automatycznie po stronie klienta i nie można ustawić ich ręcznie.

Za pomocą API kolumna numeracji automatycznej obsługuje tylko operacje tworzenia kolumny i odczytu jej ustawień. Nie można odczytywać, filtrować, aktualizować ani czyścić wartości, ponieważ są obliczane po stronie klienta.

Typ kolumny	Typ implementacji	Obsługiwane operacje
auto_number	-	Odczyt: Nie Filtrowanie: Nie Tworzenie kolumny: Tak Aktualizacja: Nie Czyszczenie: Nie

---

Zapytania

Wartości kolumny numeracji automatycznej są niedostępne przez API. Zapytanie o column_values elementu nie zwróci wpisów dla kolumn numeracji automatycznej - kolumna jest całkowicie pomijana w odpowiedzi.

Dotyczy to zarówno filtrowania bezpośrednio po identyfikatorze kolumny, jak i zapytań column_values bez filtra.

---

Filtrowanie

Filtrowanie według wartości kolumny numeracji automatycznej nie jest obsługiwane. Użycie identyfikatora takiej kolumny w regułach filtrowania items_page nie zwróci żadnych wyników.

---

Mutacje

Tworzenie kolumny

Wymagany zakres uprawnień: boards:write

Kolumnę numeracji automatycznej można utworzyć za pomocą mutacji create_column. Przekaż opcje konfiguracji w argumencie defaults jako ciąg JSON.

mutation {
  create_column(
    board_id: 1234567890
    title: "Task Number"
    column_type: auto_number
    defaults: "{\"settings\":{\"scope\":\"board\",\"prefix\":\"TASK-\",\"order\":\"ascending\",\"font\":\"bold\",\"color\":\"#e2445c\"}}"
  ) {
    id
    title
    settings
  }
}

const query = `
  mutation ($boardId: ID!, $title: String!, $defaults: JSON) {
    create_column(
      board_id: $boardId
      title: $title
      column_type: auto_number
      defaults: $defaults
    ) {
      id
      title
      settings
    }
  }
`;

const variables = {
  boardId: "1234567890",
  title: "Task Number",
  defaults: JSON.stringify({
    settings: {
      scope: "board",
      prefix: "TASK-",
      order: "ascending",
      font: "bold",
      color: "#e2445c"
    }
  })
};

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

Ustawienia

Ustawienie	Typ	Wymagane	Opis
scope	String	Nie	Zakres numeracji. "group" numeruje elementy osobno w każdej grupie. "board" numeruje elementy na całej tablicy.
prefix	String	Nie	Tekst wyświetlany przed numerem (np. "TASK-" tworzy numery „TASK-1”, „TASK-2”).
order	String	Nie	Kierunek numeracji. "ascending" (1, 2, 3...) lub "descending" (N, N-1, N-2...).
font	String	Nie	Grubość czcionki wyświetlanego numeru. "regular" lub "bold".
color	String	Nie	Kod koloru w formacie szesnastkowym dla wyświetlanego numeru (np. "#e2445c"). Musi mieć dokładnie 7 znaków.

Przykładowa odpowiedź

{
  "data": {
    "create_column": {
      "id": "autonumber_mm1nn162",
      "title": "Task Number",
      "settings": {"scope": "board", "prefix": "TASK-", "order": "ascending", "font": "bold", "color": "#e2445c"}
    }
  }
}

Aktualizowanie wartości

Aktualizowanie wartości numeracji automatycznej nie jest obsługiwane. Kolumna jest obliczana automatycznie po stronie klienta.

Próba aktualizacji za pomocą change_simple_column_value zwraca:

column type AutonumberColumn is not supporting changing the column value with simple column value

Próba aktualizacji za pomocą change_multiple_column_values zwraca:

This column type can not be updated or created (client side auto calculated column)

Czyszczenie

Czyszczenie wartości numeracji automatycznej nie jest obsługiwane. Wartości są obliczane automatycznie i nie można ich zmieniać ręcznie.

---

Odczytywanie konfiguracji kolumny

Ustawienia kolumny numeracji automatycznej można odczytać przez pole settings kolumny. Dla kolumn utworzonych z ustawieniami domyślnymi pole settings zwraca pusty obiekt ({}). Dla kolumn utworzonych z własną konfiguracją zwraca skonfigurowane ustawienia.

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

Struktura odpowiedzi settings

Pole settings zwraca typowany obiekt JSON, który może zawierać następujące klucze:

Klucz	Typ	Opis
scope	string	"group" lub "board". Określa, czy numeracja dotyczy osobno każdej grupy, czy całej tablicy.
prefix	string	Prefiks wyświetlany przed numerem.
order	string	"ascending" lub "descending". Kierunek numeracji.
font	string	"regular" lub "bold". Grubość czcionki wyświetlanego numeru.
color	string	Kod koloru w formacie szesnastkowym dla wyświetlanego numeru.

Przykładowa odpowiedź settings

Ustawienia domyślne (bez konfiguracji):

{}

Własna konfiguracja:

{
  "scope": "board",
  "prefix": "TASK-",
  "order": "ascending",
  "font": "bold",
  "color": "#e2445c"
}

---

Pobieranie schematu typu kolumny

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

query {
  get_column_type_schema(
    type: auto_number
  )
}

{
  "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": {
              "scope": {
                "type": "string",
                "description": "Scope for auto number calculation",
                "enum": [
                  "group",
                  "board"
                ]
              },
              "color": {
                "type": "string",
                "description": "Hex color code for the auto number display (e.g., #e2445c)",
                "minLength": 7,
                "maxLength": 7
              },
              "font": {
                "type": "string",
                "description": "Font weight for the auto number",
                "enum": [
                  "regular",
                  "bold"
                ]
              },
              "order": {
                "type": "string",
                "description": "Order direction for numbering",
                "enum": [
                  "ascending",
                  "descending"
                ]
              },
              "prefix": {
                "type": "string",
                "description": "Prefix text to display before the auto number"
              }
            },
            "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 sprawdzania poprawności ustawień kolumn, dynamicznego generowania interfejsów użytkownika lub przekazywania kontekstu agentom AI. Dowiedz się więcej o formacie odpowiedzi schematu.