Utwórz widżet (Platform MCP)
Użyj tego narzędzia, aby dodać widżet do istniejącego pulpitu lub widoku tablicy. Widżety są podstawowymi elementami pulpitów monday.com - wizualizują dane z tablic w postaci wykresów, liczników, kalendarzy, osi czasu, wykresów Gantta i widoków listy.
Zawsze wywołaj all_widgets_schema przed utworzeniem widżetu. Każdy typ widżetu ma własną wymaganą strukturę ustawień. Podanie nieprawidłowych lub niekompletnych ustawień spowoduje błąd. Najpierw pobierz schemat, a następnie utwórz obiekt ustawień zgodny z typem widżetu, który chcesz utworzyć.
Zalecany przebieg pracy:
1. Użyj all_widgets_schema, aby pobrać schemat JSON dla wszystkich typów widżetów.
2. Utwórz obiekt settings zgodny ze schematem wybranego widget_kind.
3. Wywołaj create_widget, podając identyfikator pulpitu i zweryfikowane ustawienia.
Parametry
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| parent_container_id | string |
Tak | ID kontenera nadrzędnego - identyfikator pulpitu lub widoku tablicy. |
| parent_container_type | string |
Tak | Typ kontenera nadrzędnego. Musi mieć wartość DASHBOARD lub BOARD_VIEW. |
| widget_kind | string |
Tak | Typ widżetu do utworzenia. Jedna z wartości: APP_FEATURE, BATTERY, CALENDAR, CHART, GANTT, LISTVIEW, NUMBER. |
| widget_name | string |
Tak | Nazwa wyświetlana widżetu (od 1 do 255 znaków UTF-8). |
| settings | object |
Nie | Konfiguracja widżetu w postaci obiektu JSON. Musi być zgodna ze schematem określonego widget_kind. Użyj all_widgets_schema, aby pobrać wymaganą strukturę dla każdego typu. |
Przykład
Dodaj do pulpitu 37055164 widżet NUMBER (licznik), który zlicza elementy z tablicy 18394529013:
{
"parent_container_id": "37055164",
"parent_container_type": "DASHBOARD",
"widget_kind": "NUMBER",
"widget_name": "Item Count",
"settings": {
"counter_data": {
"calculation_type": "count",
"column_ids_per_board": {
"18394529013": []
},
"counter_type": "sum"
}
}
}
Narzędzie zwróciło identyfikator widżetu 666707475, potwierdzając jego utworzenie na pulpicie 37055164 pod nazwą Item Count.
Odpowiednik programistyczny
Użyj GraphQL API, aby uzyskać ten sam wynik:
mutation {
create_widget(
board_id: 37055164
widget_type: number
name: "Item Count"
settings: "{\"counter_data\":{\"calculation_type\":\"count\",\"counter_type\":\"sum\"}}"
) {
id
name
type
}
}
Pełną dokumentację znajdziesz w sekcji Widżety.