Umiejętność: Aktualizowanie statusu projektu
Pola statusu projektu znajdują się na tablicy portfolio jako wartości kolumn elementu projektu. Możesz je aktualizować za pomocą mutacji change_column_value.
Zobacz Pobieranie statusu i kondycji projektu, aby dowiedzieć się, jak znaleźć tablicę portfolio i identyfikator elementu projektu.
Aktualizowanie kolumny statusu
mutation {
change_column_value(
board_id: PORTFOLIO_BOARD_ID,
item_id: PROJECT_ITEM_ID,
column_id: "portfolio_project_rag",
value: "{\"index\": 1}"
) {
id
}
}
Kolumny, które można edytować
| Identyfikator kolumny | Tytuł | Typ |
|---|---|---|
portfolio_project_rag |
Kondycja projektu (RAG) (Project Health (RAG)) | status |
portfolio_project_step |
Etap (Stage) | status |
portfolio_project_priority |
Priorytet (Priority) | status |
portfolio_project_planned_timeline |
Planowany harmonogram (Planned Timeline) | timeline |
portfolio_project_scope |
Opis projektu (Project Description) | text |
Wartości kondycji projektu (RAG)
| Indeks | Etykieta |
|---|---|
0 |
Zagrożony (At risk) |
1 |
Zgodnie z planem (On track) |
2 |
Poza planem (Off track) |
👍 Jak znaleźć indeksy etykiet statusu
Aby znaleźć dostępne wartości indeksów dla innych kolumn statusu, spróbuj zapisać nieprawidłową etykietę. Odpowiedź błędu API zawiera listę wszystkich prawidłowych opcji.
Aktualizowanie osi czasu
Aby ustawić lub zaktualizować planowany harmonogram, przekaż daty from i to jako ciąg JSON:
mutation {
change_column_value(
board_id: PORTFOLIO_BOARD_ID,
item_id: PROJECT_ITEM_ID,
column_id: "portfolio_project_planned_timeline",
value: "{\"from\": \"2026-01-01\", \"to\": \"2026-03-31\"}"
) {
id
}
}
Ważne informacje
- Kolumny typu
mirror(Postęp projektu (Project Progress), Rzeczywisty harmonogram (Actual Timeline)) są tylko do odczytu - zbierają dane z tablicy zadań i nie można ustawiać ich bezpośrednio. Tak samo działa to w interfejsie. - Aby zaktualizować status kilku projektów, wyślij osobną mutację
change_column_valuedla elementu każdego projektu.