Kolumna przycisku pozwala użytkownikom uruchamiać zdefiniowane wcześniej działania jednym kliknięciem. Przyciski są zwykle połączone z integracjami lub automatyzacjami i wyświetlają konfigurowalną etykietę oraz kolor.

Za pośrednictwem API kolumna przycisku obsługuje operacje odczytu i tworzenia kolumny. Nie można filtrować, aktualizować ani czyścić jej wartości, ponieważ stan przycisku jest zarządzany przez automatyzacje, a nie przez dane użytkownika.

Typ kolumny	Typ implementacji	Obsługiwane operacje
button	ButtonValue	Odczyt: Tak Filtrowanie: Nie Tworzenie kolumny: Tak Aktualizacja: Nie Czyszczenie: Nie

---

Zapytania

Kolumny przycisku można odpytywać za pomocą pola column_values w zapytaniach items, używając wbudowanego fragmentu dla ButtonValue.

query {
  items(ids: [1234567890]) {
    id
    name
    column_values {
      ... on ButtonValue {
        id
        label
        color
        text
        value
      }
    }
  }
}

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

const variables = { itemIds: [1234567890] };

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 ButtonValue.

Pole	Opis
id ID!	Unikatowy identyfikator kolumny.
label String	Etykieta wyświetlana na przycisku (np. "Click me"). Jest konfigurowana w ustawieniach kolumny.
color String	Wartość koloru przycisku w formacie HEX (np. "#579bfc").
text String	Tekst wyświetlany na przycisku. Zwraca tę samą wartość co label.
value JSON	Surowa wartość kolumny w formacie JSON. Zwraca null, ponieważ przyciski nie przechowują danych użytkownika.
column Column!	Kolumna, do której należy ta wartość.
type ColumnType!	Typ kolumny (button).

Przykładowa odpowiedź

{
  "data": {
    "items": [
      {
        "id": "1234567890",
        "name": "Task A",
        "column_values": [
          {
            "id": "button_1",
            "label": "Click me",
            "color": "#579bfc",
            "text": "Click me",
            "value": null
          }
        ]
      }
    ]
  }
}

---

Filtrowanie

Filtrowanie według wartości w kolumnie przycisku nie jest obsługiwane. Kolumny przycisku nie przechowują danych użytkownika, dlatego reguły filtrowania dotyczące identyfikatora kolumny przycisku nie zwrócą przydatnych wyników.

---

Mutacje

Tworzenie kolumny

Wymagany zakres uprawnień: boards:write

Możesz utworzyć kolumnę przycisku za pomocą mutacji create_column. Przekaż opcje konfiguracji w argumencie defaults jako ciąg JSON.

Przycisk domyślny

Tworzy przycisk z domyślną etykietą „Click me” i kolorem #579bfc.

mutation {
  create_column(
    board_id: 1234567890
    title: "Action"
    column_type: button
  ) {
    id
    title
    settings
  }
}

Niestandardowy tekst przycisku

Przekaż właściwość buttonText w ustawieniach defaults, aby dostosować etykietę.

mutation {
  create_column(
    board_id: 1234567890
    title: "Launch"
    column_type: button
    defaults: "{\"settings\":{\"buttonText\":\"Launch\"}}"
  ) {
    id
    title
    settings
  }
}

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

const variables = {
  boardId: "1234567890",
  title: "Launch",
  defaults: JSON.stringify({
    settings: {
      buttonText: "Launch"
    }
  })
};

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

Ustawienia

Ustawienie	Typ	Wymagane	Opis
buttonText	String	Nie	Tekst wyświetlany na przycisku. Jeśli go nie określisz, domyślnie używana jest wartość "Click me".

Przykładowa odpowiedź

{
  "data": {
    "create_column": {
      "id": "button_1",
      "title": "Launch",
      "settings": {"buttonText": "Launch"}
    }
  }
}

Aktualizacja wartości

Aktualizowanie wartości w kolumnie przycisku nie jest obsługiwane. Przyciski są elementami wyświetlanymi na ekranie, połączonymi z automatyzacjami, i nie przechowują danych, które użytkownik może edytować.

Próba aktualizacji za pomocą change_simple_column_value zwraca:

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

Czyszczenie

Czyszczenie wartości w kolumnie przycisku nie jest obsługiwane. Przyciski nie przechowują danych użytkownika.

---

Odczyt konfiguracji kolumny

Możesz odpytać ustawienia kolumny przycisku za pomocą pola settings kolumny. W przypadku kolumn utworzonych z ustawieniami domyślnymi settings zwraca pusty obiekt ({}). W przypadku kolumn z niestandardowym tekstem przycisku zwraca skonfigurowany tekst.

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

Struktura odpowiedzi settings

Pole settings zwraca typowany obiekt JSON, który może zawierać:

Klucz	Typ	Opis
buttonText	string	Tekst wyświetlany na przycisku. Nie występuje, gdy używana jest domyślna etykieta.

Przykładowa odpowiedź settings

Ustawienia domyślne (bez konfiguracji):

{}

Niestandardowy tekst przycisku:

{
  "buttonText": "Launch"
}

---

Pobieranie schematu typu kolumny

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

{
  "data": {
    "get_column_type_schema": {
      "schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "settings": {
            "type": "object",
            "description": "Button settings",
            "properties": {
              "buttonText": {
                "type": "string",
                "description": "Text displayed on the button"
              }
            },
            "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 walidowania ustawień kolumny, dynamicznego generowania interfejsów użytkownika lub przekazywania kontekstu agentom AI. Dowiedz się więcej o formacie odpowiedzi schematu.