Status projektu i dane o jego kondycji znajdują się na tablicy portfolio, a nie na tablicy zadań. Każdy projekt jest elementem na tej tablicy. Ma osobne kolumny dotyczące kondycji (RAG), etapu, priorytetu i osi czasu.

Jak odróżnić tablicę portfolio od tablicy zadań

Podczas tworzenia projektu monday.com tworzy dwie tablice o tej samej nazwie. Zanim odczytasz lub zapiszesz dane projektu, ustal, która z nich jest tablicą portfolio.

Pobierz wszystkie tablice w obszarze roboczym i porównaj ich strukturę:

{
  boards(workspace_ids: [WORKSPACE_ID], limit: 20, order_by: created_at) {
    id
    name
    groups { title }
    columns { id title type }
  }
}

📘 Wskazówka

Tablica zadań jest zawsze tworzona jako pierwsza (ma wcześniejszą wartość created_at), dlatego sortowanie według created_at może ułatwić jej szybkie rozpoznanie.

Odczytywanie kolumn statusu projektu

Każdy projekt jest elementem na tablicy portfolio. Możesz pobrać wszystkie projekty naraz albo wyszukać konkretny element po jego identyfikatorze.

Wszystkie projekty na tablicy

{
  boards(ids: [PORTFOLIO_BOARD_ID]) {
    items_page(limit: 50) {
      items {
        id
        name
        column_values {
          id
          type
          text
          value
        }
      }
    }
  }
}

Konkretny projekt według identyfikatora elementu

{
  items(ids: [ITEM_ID]) {
    id
    name
    column_values {
      id
      type
      text
      value
    }
  }
}

Najważniejsze kolumny

📘 Uwaga

Kolumny mirror są tylko do odczytu - odzwierciedlają zagregowane dane z połączonej tablicy zadań i nie można ustawiać ich wartości bezpośrednio. Tak samo działają w interfejsie.

Ważne informacje

• Identyfikatory kolumn (portfolio_project_rag itd.) są takie same w różnych projektach, ale mogą się różnić, jeśli użyto niestandardowego szablonu projektu.
• Aby odczytać kondycję kilku projektów w portfolio, pobierz wszystkie elementy z tablicy portfolio w jednym wywołaniu.