Przenieś obiekt (Platform MCP)
Użyj tego narzędzia, aby zmienić położenie lub uporządkować tablicę, folder albo przegląd w monday.com. Możesz przenieść obiekt do innego folderu, innego obszaru roboczego lub ustawić go w określonym miejscu względem innego obiektu. To podstawowe narzędzie do zmiany układu obszaru roboczego bez modyfikowania zawartości samych obiektów.
Uwaga: Aby przenieść obiekt do folderu, podaj parentFolderId. Aby przenieść go do katalogu głównego obszaru roboczego, pomiń parentFolderId. Aby przenieść go do innego obszaru roboczego, podaj workspaceId. Parametry określające pozycję (position_object_id i position_object_type) zawsze muszą być podane razem.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| objectType | string |
Tak | Typ przenoszonego obiektu. Jedna z wartości: Board, Folder, Overview. |
| id | string |
Tak | Identyfikator przenoszonego obiektu. |
| parentFolderId | string |
Nie | Identyfikator folderu docelowego. Podaj go, aby przenieść obiekt do konkretnego folderu. |
| workspaceId | string |
Nie | Identyfikator docelowego obszaru roboczego. Podaj go, aby przenieść obiekt do innego obszaru roboczego. |
| accountProductId | string |
Nie | Identyfikator docelowego produktu na koncie. Podaj go, aby przenieść obiekt do innego kontekstu produktu na koncie. |
| position_object_id | string |
Nie | Identyfikator obiektu referencyjnego, względem którego ma zostać ustawiony przenoszony obiekt. Należy go podać razem z position_object_type. |
| position_object_type | string |
Nie | Typ obiektu referencyjnego określającego pozycję. Jedna z wartości: Board, Folder, Overview. Należy go podać razem z position_object_id. |
| position_is_after | boolean |
Nie | Jeśli wartość to true, umieszcza obiekt za obiektem referencyjnym. Jeśli wartość to false, umieszcza go przed nim. |
Przykład
Przenieś folder 20393953 do folderu nadrzędnego 19175809:
{
"objectType": "Folder",
"id": "20393953",
"parentFolderId": "19175809"
}
Podczas testu operacja zwróciła: Object moved z wartością object_id: 20393953. Folder pojawił się jako folder zagnieżdżony w folderze 19175809 bezpośrednio po wykonaniu operacji.
Aby zamiast tego umieścić tablicę za inną tablicą w tym samym folderze:
{
"objectType": "Board",
"id": "18394529013",
"position_object_id": "18406574366",
"position_object_type": "Board",
"position_is_after": true
}
Odpowiednik programistyczny
Aby uzyskać ten sam rezultat, użyj interfejsu API GraphQL. Aby przenieść tablicę do folderu:
mutation {
move_to_folder(
board_id: 20393953
folder_id: 19175809
) {
id
}
}
Aby przenieść tablicę między obszarami roboczymi, użyj update_board:
mutation {
update_board(
board_id: 18394529013
board_attribute: workspace_id
new_value: "12406666"
)
}
Pełną dokumentację znajdziesz w sekcji Foldery.