Aktualizuj formularz (Platform MCP)
Użyj tego narzędzia, aby zmodyfikować istniejący monday.com WorkForm. Każde wywołanie wykonuje jedną wskazaną action na formularzu - na przykład aktualizuje tytuł i opis, zmienia układ, aktywuje lub dezaktywuje formularz, ustawia hasło albo zmienia kolejność pytań. Przekaż tylko pola związane z wykonywaną akcją. Pola nieuwzględnione w wywołaniu pozostaną bez zmian (semantyka aktualizacji częściowej).
Typowy przebieg pracy z formularzem:
1. create_form - Utwórz formularz i pobierz formToken
2. form_questions_editor - Dodaj, zaktualizuj lub usuń pytania
3. update_form ← Jesteś tutaj - Skonfiguruj tytuł, wygląd, funkcje i dostępność formularza
4. get_form - Sprawdź stan zaktualizowanego formularza
5. create_form_submission - Prześlij odpowiedź
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| formToken | string |
Tak | Unikalny token identyfikujący formularz. |
| action | string |
Tak | Operacja do wykonania. Wszystkie obsługiwane akcje i wymagane dla nich pola znajdziesz w poniższej tabeli. |
| form | object |
Warunkowo | Dane formularza do aktualizacji. Wymagane dla akcji updateFormHeader, updateAppearance, updateAccessibility, updateFeatures i updateQuestionOrder. Obowiązuje semantyka aktualizacji częściowej - uwzględnij tylko pola, które chcesz zmienić. |
| formPassword | string |
Warunkowo | Wymagane dla akcji setFormPassword. |
| tag | object |
Warunkowo | Wymagane dla akcji createTag, updateTag i deleteTag. Przy tworzeniu podaj name i value. Przy aktualizacji podaj id i nową wartość value. Przy usuwaniu podaj tylko id. |
Obsługiwane akcje:
| Akcja | Wymagane pola | Opis |
|---|---|---|
activate |
- | Udostępnia formularz publicznie. |
deactivate |
- | Zatrzymuje przyjmowanie nowych odpowiedzi przez formularz. |
updateFormHeader |
form.title, form.description |
Aktualizuje tytuł formularza i jego opis. |
updateAppearance |
form.appearance |
Ustawia tło, układ, czcionkę, kolory i elementy marki. |
updateAccessibility |
form.accessibility |
Ustawia język formularza i tekst alternatywny logo. |
updateFeatures |
form.features |
Konfiguruje sposób przesyłania odpowiedzi, hasło, limit odpowiedzi, datę zamknięcia i inne ustawienia. |
updateQuestionOrder |
form.questions |
Zmienia kolejność pytań. Musi zawierać identyfikatory wszystkich istniejących pytań. |
setFormPassword |
formPassword |
Włącza ochronę hasłem i ustawia hasło. |
shortenFormUrl |
- | Tworzy skrócony adres URL wkf.ms formularza. |
createTag |
tag.name, tag.value |
Dodaje do formularza tag kierujący. |
updateTag |
tag.id, tag.value |
Aktualizuje wartość istniejącego tagu. |
deleteTag |
tag.id |
Usuwa tag z formularza. |
Przykład
Zaktualizuj tytuł i opis formularza:
{
"formToken": "your_form_token_here",
"action": "updateFormHeader",
"form": {
"title": "MCP Docs Test Form",
"description": "A test form created to demonstrate the monday.com MCP tools"
}
}
Narzędzie potwierdziło pomyślne wykonanie akcji updateFormHeader i zwróciło zaktualizowane wartości title i description.
Odpowiednik programistyczny
Formularzami monday.com WorkForms można zarządzać za pomocą interfejsu monday.com lub MCP. Ta operacja nie ma bezpośredniego odpowiednika w GraphQL API.