Edytor pytań formularza (Platform MCP)
Użyj tego narzędzia, aby zarządzać pytaniami w formularzu monday.com WorkForm. Każde wywołanie wykonuje jedną operację create, update lub delete na jednym pytaniu. Możesz dodać dowolny z 23 typów pytań - od krótkiego tekstu i adresu e-mail po oceny, przesyłanie plików i logikę warunkową. Przed aktualizacją pytań wyboru użyj get_form, aby pobrać istniejące wartości opcji. Pominięcie istniejącej opcji w aktualizacji spowoduje jej trwałe usunięcie.
Typowy proces pracy z formularzem:
1. create_form - Utwórz formularz i pobierz formToken
2. form_questions_editor ← Jesteś tutaj - Dodaj, zaktualizuj lub usuń pytania
3. update_form - Skonfiguruj tytuł, wygląd, funkcje i dostępność formularza
4. get_form - Sprawdź bieżący stan formularza
5. create_form_submission - Prześlij odpowiedź, używając identyfikatorów pytań zwróconych w tym miejscu
Ważne uwagi:
- Po utworzeniu pytania nie można zmienić jego typu (type). Podczas aktualizacji zawsze podawaj istniejący typ.
- W przypadku operacji update i delete pole questionId jest wymagane.
- W przypadku operacji create pole question.title jest wymagane.
- Podczas aktualizacji pytań SingleSelect lub MultiSelect zawsze uwzględniaj wszystkie opcje, które chcesz zachować, wraz z ich oryginalnymi polami value. Każda opcja pominięta w tablicy options zostanie usunięta.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| action | string |
Tak | Operacja do wykonania: create, update lub delete. |
| formToken | string |
Tak | Unikalny token identyfikujący formularz. |
| questionId | string |
Warunkowo | ID pytania do zaktualizowania lub usunięcia. Wymagane dla operacji update i delete. |
| question | object |
Warunkowo | Definicja pytania. Wymagana dla operacji create. W przypadku operacji update jest wymagana, a pole type musi być zawsze uwzględnione. Zobacz pola podrzędne poniżej. |
Pola obiektu question:
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
type |
string |
Tak | Typ pytania. Nie można go zmienić po utworzeniu. Obsługiwane typy: Boolean, ConnectedBoards, Country, DISPLAY_TEXT, Date, DateRange, Email, File, HOUR, Link, Location, LongText, MultiSelect, Name, Number, PAGE_BLOCK, People, Phone, Rating, ShortText, Signature, SingleSelect, Subitems, Updates. |
title |
string |
Przy tworzeniu | Treść pytania wyświetlana osobom udzielającym odpowiedzi. |
description |
string |
Nie | Tekst pomocy wyświetlany pod pytaniem. |
visible |
boolean |
Nie | Określa, czy pytanie jest widoczne dla osób udzielających odpowiedzi. Domyślnie ma wartość true. |
required |
boolean |
Nie | Określa, czy osoba udzielająca odpowiedzi musi odpowiedzieć na to pytanie. |
insert_after_question_id |
string or null |
Nie | ID pytania, za którym należy wstawić to pytanie. Pomiń to pole, aby dodać pytanie na końcu. Ustaw wartość null, aby wstawić je na początku. |
page_block_id |
string or null |
Nie | ID bloku strony, w którym ma się znaleźć to pytanie. Ustaw wartość null, aby usunąć pytanie z bloku strony. |
options |
array |
Dla typów wyboru | Opcje dla pytań SingleSelect i MultiSelect. Zawsze uwzględniaj wszystkie opcje - pominięcie którejkolwiek spowoduje jej usunięcie. Każda opcja zawiera pola label (wymagane), value i visible. |
settings |
object |
Nie | Ustawienia zależne od typu pytania (np. display dla pytań wyboru, includeTime dla daty, prefill do automatycznego wypełniania). |
show_if_rules |
object |
Nie | Reguły warunkowej widoczności. Wszystkie operatory muszą mieć wartość OR. |
Przykład
Dodaj do formularza wymagane pytanie z krótką odpowiedzią tekstową:
{
"action": "create",
"formToken": "your_form_token_here",
"question": {
"type": "ShortText",
"title": "What is your favorite feature?",
"required": true,
"visible": true
}
}
Narzędzie zwróciło question_id: "short_text413vvqbb". Użyj tego ID podczas wywoływania create_form_submission, aby przesłać odpowiedź na to pytanie.
Odpowiednik programistyczny
Formularzami monday.com WorkForms można zarządzać za pomocą interfejsu monday.com lub przez MCP. Ta operacja nie ma bezpośredniego odpowiednika w API GraphQL.