Pulpity monday.com gromadzą dane z jednej lub kilku tablic i przedstawiają je w jednym miejscu w formie ogólnego przeglądu. Składają się z aplikacji i widżetów, które wizualnie prezentują kluczowe wskaźniki, takie jak postęp projektu, budżety, obciążenie pracą i wiele innych.

Mutacje

Utwórz pulpit

Tworzy nowy pulpit. Zwraca Dashboard.

mutation {
  create_dashboard(
    board_ids: ["1234567890", "9876543210"]
    board_folder_id: 543210
    kind: PRIVATE
    name: "Team Performance"
    workspace_id: -1
  ) {
    id
    name
    kind
    workspace_id
  }
}

{
  "data": {
    "create_dashboard": {
      "id": "12345",
      "name": "Team Performance",
      "kind": "PRIVATE",
      "workspace_id": -1
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
board_ids	[ID!]!	Unikalny identyfikator tablicy lub tablic, dla których mają zostać utworzone pulpity.
board_folder_id	ID	Unikalny identyfikator folderu, w którym ma zostać utworzony pulpit.
kind	DashboardKind	Widoczność pulpitu. Wartość domyślna to PRIVATE.	PRIVATE PUBLIC
name	String!	Nazwa pulpitu. Maksymalnie 255 znaków.
workspace_id	ID!	Unikalny identyfikator obszaru roboczego, w którym ma zostać utworzony pulpit.

Utwórz widżet

Tworzy nowy widżet. Zwraca WidgetModel.

mutation CreateNumberWidget($settings: JSON!) {
  create_widget(
    parent: {
      kind: BOARD_VIEW
      id: 54321
    }
    kind: NUMBER
    name: "High Cost Sum (>$1000)"
    settings: $settings
    filter: {
      operator: and
      rules: [
        {
          column_id: "cost"
          operator: greater_than
          compare_value: [1000]
        }
      ]
    }
  ) {
    id
    name
    kind
  }
}

// Pass these variables with the sample mutation

{
  "settings": {
    "counter_data": {
      "calculation_type": "columns",
      "column_ids_per_board": {
        "1234567890": ["cost"]
      },
      "counter_type": "sum",
      "counter_unit": {
        "symbol": "$",
        "direction": "left"
      }
    },
    "prefix": "Total",
    "suffix": "in high-cost flights",
    "number_format": "currency"
  }
}

{
  "data": {
    "create_widget": {
      "id": 123456789,
      "name": "High Cost Sum (>$1000)",
      "kind": "NUMBER"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
filter	ItemsQueryGroup	Opcjonalny filtr widżetu. Działa tylko z widokami tablic.
kind	ExternalWidget!	Typ widżetu do utworzenia.
name	String!	Nazwa widżetu wyświetlana w interfejsie.
parent	WidgetParentInput!	Kontener nadrzędny widżetu.
settings	JSON!	Ustawienia specyficzne dla typu widżetu. Aby zobaczyć dostępne właściwości, sprawdź all_widgets_schema.

Zaktualizuj pulpit

Aktualizuje pulpit. Zwraca Dashboard.

mutation {
  update_dashboard(
    id: 12345
        board_folder_id: 9876543210
    kind: PUBLIC
    name: "Team Performance Q4"
    workspace_id: -1
  ) {
        id
    name
    kind
    workspace_id
  }
}

{
  "data": {
    "update_dashboard": {
      "id": "12345",
      "name": "Team Performance Q4",
      "kind": "PUBLIC",
      "workspace_id": -1
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
board_folder_id	ID	Unikalny identyfikator folderu, do którego ma zostać przeniesiony pulpit.
id	ID!	Unikalny identyfikator pulpitu do zaktualizowania.
kind	DashboardKind	Zaktualizowany typ pulpitu.	PRIVATE PUBLIC
name	String	Zaktualizowana nazwa pulpitu.
workspace_id	ID	Unikalny identyfikator obszaru roboczego, w którym ma zostać zaktualizowany pulpit.

Zaktualizuj hierarchię przeglądu

Aktualizuje pozycję lub lokalizację pulpitu. Zwraca UpdateOverviewHierarchy.

mutation {
  update_overview_hierarchy(
    overview_id: 12345
    attributes: {
      workspace_id: -1
      position: {
        is_after: true
        object_id: "9876543210"
        object_type: Board
      }
    }
  ) {
    success
    message
    overview {
      workspace_id
      name
      state
      creator {
        id
      }
    }
  }
}

{
  "data": {
    "update_overview_hierarchy": {
      "success": true,
      "message": "Overview position updated successfully",
      "overview": {
        "workspace_id": "-1",
        "name": "New Dashboard",
                "state": "1",
        "creator": {
          "id": "1234567890"
        }
      }
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
attributes	UpdateOverviewHierarchyAttributes	Zaktualizowane atrybuty pozycji i lokalizacji pulpitu.
overview_id	ID!	Unikalny identyfikator pulpitu.

Usuń pulpit

Usuwa pulpit. Zwraca wartość logiczną określającą, czy usunięcie się powiodło.

mutation {
  delete_dashboard(id: 12345)
}

{
  "data": {
    "delete_dashboard": true
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
id	ID!	Unikalny identyfikator pulpitu do usunięcia.

Usuń widżet

Usuwa widżet. Zwraca wartość logiczną określającą, czy usunięcie się powiodło.

mutation {
  delete_widget(id: 12345)
}

{
  "data": {
    "delete_widget": true
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
id	ID!	Unikalny identyfikator widżetu do usunięcia.