Zmienianie wartości kolumn elementu (Platform MCP)
Użyj tego narzędzia, aby zaktualizować wartości kolumn istniejącego elementu. Możesz zmienić kilka kolumn podczas jednego wywołania, przekazując obiekt JSON, który przypisuje identyfikatory kolumn do nowych wartości. Format wartości zależy od typu kolumny: w kolumnach statusu użyj {"label": "Done"}, w kolumnach daty - {"date": "2024-05-10"}, w kolumnach tekstowych - zwykłego ciągu znaków itd.
Jeśli ustawiana etykieta statusu lub lista rozwijana nie istnieje jeszcze w kolumnie, ustaw createLabelsIfMissing: true, aby narzędzie utworzyło ją automatycznie. Wymaga to uprawnień do modyfikowania struktury tablicy.
W przypadku zadań polegających na łączeniu tablic wywołaj link_board_items_workflow przed użyciem tego narzędzia.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| boardId | number |
Tak | Identyfikator tablicy, na której znajduje się element. |
| itemId | number |
Tak | Identyfikator elementu do zaktualizowania. |
| columnValues | string |
Tak | Ciąg JSON z wartościami kolumn do zaktualizowania. Klucze to identyfikatory kolumn, a wartości zależą od ich typu. Przykłady: {"text_col": "New value"}, {"status_col": {"label": "Done"}}, {"date_col": {"date": "2024-06-01"}}, {"email_col": "user@example.com"}, {"phone_col": "+1-800-555-0100"}. |
| createLabelsIfMissing | boolean |
Nie | Jeśli ma wartość true, tworzy nowe etykiety statusu lub listy rozwijanej, które jeszcze nie istnieją. Wymaga uprawnień do modyfikowania struktury tablicy. Domyślnie ma wartość false. |
Przykład
Ustaw kolumnę Status elementu 11971936030 na „Done”:
{
"boardId": 18412502536,
"itemId": 11971936030,
"columnValues": "{\"color_mm37gbqg\": {\"label\": \"Done\"}}"
}
Narzędzie zwróciło komunikat potwierdzający zaktualizowanie elementu 11971936030 („Design homepage mockup”) oraz adres URL elementu.
Odpowiednik programistyczny
Użyj GraphQL API, aby uzyskać ten sam rezultat:
mutation {
change_multiple_column_values(
board_id: 18412502536
item_id: 11971936030
column_values: "{\"color_mm37gbqg\": {\"label\": \"Done\"}}"
) {
id
name
column_values {
id
text
}
}
}
Pełną dokumentację znajdziesz w sekcji Elementy.