Utwórz element (Platform MCP)
Użyj tego narzędzia, aby dodać elementy do tablicy monday.com. Możesz utworzyć nowy element z początkowymi wartościami kolumn, utworzyć podelement pod istniejącym elementem nadrzędnym albo zduplikować istniejący element i zastąpić wybrane wartości kolumn. Element zostanie dodany do pierwszej grupy na tablicy, chyba że podasz groupId.
Warunek wstępny: przed utworzeniem elementów na nieznanej tablicy wywołaj get_board_info, aby pobrać prawidłowe identyfikatory i typy kolumn, identyfikatory grup oraz nazwy etykiet statusu. Nieprawidłowe identyfikatory kolumn lub formaty wartości spowodują błędy.
Parametr columnValues to ciąg JSON. Format wartości zależy od typu kolumny - w przypadku kolumn statusu użyj {"label": "Done"}, w przypadku kolumn daty - {"date": "2024-05-10"}, a w przypadku kolumn tekstowych - zwykłego ciągu znaków.
Parametry
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| boardId | number |
Tak | Identyfikator tablicy, na której ma zostać utworzony element. |
| name | string |
Tak | Nazwa wyświetlana nowego elementu. |
| columnValues | string |
Tak | Ciąg JSON z początkowymi wartościami kolumn. Kluczami są identyfikatory kolumn, a wartości zależą od typu. Przykłady: {"text_col": "hello"}, {"status_col": {"label": "Done"}}, {"date_col": {"date": "2024-05-10"}}, {"email_col": "user@example.com"}. |
| groupId | string |
Nie | Identyfikator grupy, do której ma zostać dodany element. Jeśli go nie podasz, element zostanie dodany do pierwszej grupy na tablicy. |
| parentItemId | number |
Nie | Identyfikator elementu nadrzędnego, pod którym ma zostać utworzony podelement. |
| duplicateFromItemId | number |
Nie | Identyfikator istniejącego elementu, który ma posłużyć za podstawę duplikatu. Podaj go tylko wtedy, gdy duplikujesz element. |
Przykład
Utwórz element z wartością kolumny statusu na tablicy 18412502536:
{
"boardId": 18412502536,
"name": "Design homepage mockup",
"columnValues": "{\"color_mm37gbqg\": {\"label\": \"Working on it\"}}"
}
Narzędzie zwróciło identyfikator elementu 11971936030, nazwę elementu, bezpośredni adres URL i identyfikator tablicy.
Odpowiednik programistyczny
Aby uzyskać ten sam wynik, użyj GraphQL API:
mutation {
create_item(
board_id: 18412502536
item_name: "Design homepage mockup"
column_values: "{\"color_mm37gbqg\": {\"label\": \"Working on it\"}}"
) {
id
name
url
}
}
Pełną dokumentację znajdziesz w sekcji Elementy - tworzenie elementu.