Zarządzane kolumny pomagają ujednolicić przepływy pracy na koncie monday.com. Wybrani użytkownicy mogą tworzyć, posiadać i zarządzać kolumnami statusu oraz kolumnami listy rozwijanej z predefiniowanymi etykietami, których inni członkowie nie mogą edytować. Dzięki temu terminologia pozostaje spójna w różnych przepływach pracy, a zespoły mogą korzystać ze wspólnej struktury.

Zapytania

Pobieranie zarządzanej kolumny

• Zwraca tablicę zawierającą metadane jednej lub kilku zarządzanych kolumn
• Można ją wywołać tylko bezpośrednio na najwyższym poziomie. Nie można zagnieżdżać jej w innym zapytaniu

query {
  managed_column(state: active) {
    created_by
    revision
    settings {
      ...on StatusColumnSettings { 
        type
        labels {
          id
          description
        }
      }
    }
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
id	[String!]	Unikalny identyfikator zarządzanej kolumny, według którego ma być filtrowana.
state	[ManagedColumnState!]	Stan zarządzanej kolumny, według którego ma być filtrowana.	active inactive

Pola

Pole	Typ	Opis	Wartości wyliczeniowe	Możliwe typy
created_at	Date	Data utworzenia zarządzanej kolumny.
created_by	ID	Unikalny identyfikator użytkownika, który utworzył zarządzaną kolumnę.
description	String	Opis zarządzanej kolumny.
id	String	Unikalny identyfikator zarządzanej kolumny.
revision	Int	Bieżąca wersja zarządzanej kolumny.
settings	ColumnSettings	Ustawienia zarządzanej kolumny.		DropdownColumnSettings StatusColumnSettings
settings_json	JSON	Ustawienia zarządzanej kolumny w formacie JSON.
state	ManagedColumnState	Stan zarządzanej kolumny.	active inactive
title	String	Tytuł zarządzanej kolumny.
updated_at	Date	Data ostatniej aktualizacji zarządzanej kolumny.
updated_by	ID	Unikalny identyfikator użytkownika, który ostatnio zaktualizował zarządzaną kolumnę.

Mutacje

Tworzenie zarządzanej kolumny statusu

Tworzy nową zarządzaną kolumnę statusu. Zwraca StatusManagedColumn.

mutation {
  create_status_managed_column(
    title: "Project status"
    description:"This column indicates the project's status."
    settings: {
      labels: [
        {
          color: done_green
          label: "Done"
          index: 1
          is_done: true
        },
        {           
          color: working_orange
          label: "In progress"
          index: 2
        },
        {           
          color: stuck_red
          label: "Stuck"
          index: 3
        }
      ]
    }
  ) {
    id
    state
    created_at
    created_by
  }
}

Argumenty

Argument	Typ	Opis
description	String	Opis nowej zarządzanej kolumny listy rozwijanej.
settings	CreateStatusColumnSettingsInput	Ustawienia nowej zarządzanej kolumny listy rozwijanej.
title	String!	Tytuł nowej zarządzanej kolumny listy rozwijanej.

Tworzenie zarządzanej kolumny listy rozwijanej

Tworzy nową zarządzaną kolumnę listy rozwijanej. Zwraca DropdownManagedColumn.

mutation {
  create_dropdown_managed_column(
    title: "Project Domains"
    description: "This column lists all of the domains the project falls under."
    settings: {
      labels: [
        {
          label: "Research and Development" 
        }, 
        { 
          label: "Human Resources" 
        }, 
        {
          label: "Customer Support"
        }
      ]
    }
  ) {
    id
    title
    state
    created_at
    created_by
    settings {
      labels {
        id
        label
        is_deactivated
      }
    }
  }
}

Argumenty

Argument	Typ	Opis
description	String	Opis nowej zarządzanej kolumny listy rozwijanej.
settings	CreateDropdownColumnSettingsInput	Ustawienia nowej zarządzanej kolumny listy rozwijanej.
title	String!	Tytuł nowej zarządzanej kolumny listy rozwijanej.

Aktywowanie zarządzanej kolumny

Aktywuje zarządzaną kolumnę. Zwraca ManagedColumn.

mutation {
  activate_managed_column(
    id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
    ) {
    status
    title
  }
}

Argumenty

Argument	Typ	Opis
id	String!	Unikalny identyfikator zarządzanej kolumny do aktywowania.

Dołączanie zarządzanej kolumny listy rozwijanej

Tworzy nową kolumnę listy rozwijanej połączoną z zarządzaną kolumną. Ustawienia i dane nowej kolumny są kontrolowane przez zarządzaną kolumnę. Zwraca ManagedColumn.

mutation {
  attach_dropdown_managed_column(
    board_id: 1234567890
    managed_column_id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
    title: "Project Domains"
    description: "This column is attached to a managed column."
    settings: {
      label_limit_count: 3
      limit_select:true
    }
  ) {
    id
    title
    type
  }
}

Argumenty

Argument	Typ	Opis
after_column_id	ID	Unikalny identyfikator kolumny, za którą ma zostać wstawiona nowa kolumna.
board_id	ID!	Unikalny identyfikator tablicy.
description	String	Opis nowej kolumny listy rozwijanej. Jeśli go nie podasz, zostanie użyty opis połączonej zarządzanej kolumny.
managed_column_id	ID!	Unikalny identyfikator zarządzanej kolumny, którą chcesz dołączyć.
settings	DropdownSettingsOverridesInput	Opcjonalne ustawienia nowej kolumny listy rozwijanej.
title	String	Tytuł nowej kolumny listy rozwijanej. Jeśli go nie podasz, zostanie użyty tytuł połączonej zarządzanej kolumny.

Dołączanie zarządzanej kolumny statusu

Tworzy nową kolumnę statusu połączoną z zarządzaną kolumną. Ustawienia i dane nowej kolumny są kontrolowane przez zarządzaną kolumnę. Zwraca ManagedColumn.

mutation {
  attach_status_managed_column(
    board_id: 1234567890
    managed_column_id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
    title: "Project Status"
    description: "This column is attached to a managed column."
  ) {
    id
    title
    type
  }
}

Argumenty

Argument	Typ	Opis
after_column_id	ID	Unikalny identyfikator kolumny, za którą ma zostać wstawiona nowa kolumna.
board_id	ID!	Unikalny identyfikator tablicy.
description	String	Opis nowej kolumny statusu. Jeśli go nie podasz, zostanie użyty opis połączonej zarządzanej kolumny.
managed_column_id	ID!	Unikalny identyfikator zarządzanej kolumny, którą chcesz dołączyć.
title	String	Tytuł nowej kolumny statusu. Jeśli go nie podasz, zostanie użyty tytuł połączonej zarządzanej kolumny.

Aktualizowanie zarządzanej kolumny statusu

Aktualizuje zarządzaną kolumnę statusu. Zwraca ManagedColumn.

:construction: Musisz podać wszystkie etykiety kolumny, nawet jeśli aktualizujesz tylko jedną z nich!

mutation {
  update_status_managed_column(
    id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
    revision: 0
    title: "Project status"
    description:"This column indicates the status of the project."
    settings: {
      labels: [
        {
          color: bright_blue
          label: "In progress"
          index: 2
        }
      ]
    }
) {
  id
  description
  updated_at
  settings {
    labels {
      color
    }
  }
}

Argumenty

Argument	Typ	Opis
description	String	Nowy opis zarządzanej kolumny statusu.
id	String!	Unikalny identyfikator zarządzanej kolumny statusu do zaktualizowania.
revision	Int!	Bieżąca wersja zarządzanej kolumny. Musisz ją podać podczas aktualizowania kolumny, aby mieć pewność, że dane są aktualne. Jeśli pojawi się błąd wersji, użyta wersja może być nieaktualna - pobierz najnowsze dane kolumny i spróbuj ponownie.
settings	UpdateStatusColumnSettingsInput	Ustawienia zarządzanej kolumny statusu do zaktualizowania.
title	String	Nowy tytuł zarządzanej kolumny statusu.

Aktualizowanie zarządzanej kolumny listy rozwijanej

Aktualizuje zarządzaną kolumnę listy rozwijanej. Zwraca ManagedColumn.

:construction: Musisz podać wszystkie etykiety kolumny, nawet jeśli aktualizujesz tylko jedną z nich!

mutation {  
  update_dropdown_managed_column(
    id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
    revision: 0
    title: "Project Domains"
    description: "This column tracks each domain a project falls under."
    settings: {
      labels: [
        {
          id: 1
          label: "Research & Development"
        }
      ]
    }
  ) {
    description
    updated_at
    revision
    state
  }
}

Argumenty

Argument	Typ	Opis
description	String	Zaktualizowany opis zarządzanej kolumny listy rozwijanej.
id	String!	Unikalny identyfikator zarządzanej kolumny listy rozwijanej do zaktualizowania.
revision	Int!	Bieżąca wersja zarządzanej kolumny. Musisz ją podać podczas aktualizowania kolumny, aby mieć pewność, że dane są aktualne. Jeśli pojawi się błąd wersji, użyta wersja może być nieaktualna - pobierz najnowsze dane kolumny i spróbuj ponownie.
settings	UpdateDropdownColumnSettingsInput	Ustawienia zarządzanej kolumny listy rozwijanej do zaktualizowania.
title	String	Zaktualizowany tytuł zarządzanej kolumny listy rozwijanej.

Dezaktywowanie zarządzanej kolumny

Dezaktywuje zarządzaną kolumnę. Zwraca ManagedColumn.

Dezaktywowanie zarządzanej kolumny uniemożliwia użytkownikom dodawanie jej do nowych tablic. Kolumna pozostaje na istniejących tablicach i można ją w dowolnym momencie ponownie aktywować za pomocą mutacji activate_managed_column lub w interfejsie użytkownika.

mutation {
  deactivate_managed_column(
    id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
  ) {
    state
    title
  }
}

Argumenty

Argument	Typ	Opis
id	String!	Unikalny identyfikator zarządzanej kolumny do dezaktywowania.

Usuwanie zarządzanej kolumny

Usuwa zarządzaną kolumnę za pomocą API. Zwraca ManagedColumn.

Usunięcie zarządzanej kolumny usuwa ją z listy „Zarządzana kolumna” („Managed Column”) w „Centrum kolumn” („Column Center”) i uniemożliwia użytkownikom dodawanie jej do nowych tablic. Usunięta kolumna pozostaje na istniejących tablicach jako zwykła kolumna, ale nie można jej ponownie aktywować jako zarządzanej kolumny.

mutation {
  delete_managed_column(
    id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
  ) {
    state
    title
  }
}

Argumenty

Argument	Typ	Opis
id	String!	Unikalny identyfikator zarządzanej kolumny do usunięcia.