Dokumentacja dla programistów›Umiejętności AI›Umiejętność: Aktualizowanie statusu projektu
Dokumentacja dla programistów

Umiejętność: Aktualizowanie statusu projektu

Umiejętności AIDokumentacja API
Aktualizacja 2026-09-06

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_value dla elementu każdego projektu.