Interfejs Portfolio API monday.com udostępnia mutacje i zapytania, które pozwalają programowo zarządzać portfolio i projektami. Wiele operacji wykonywanych przez agentów AI wymaga kilkuetapowego procesu. Na przykład utworzenie portfolio nie zwraca bezpośrednio identyfikatora tablicy, więc agent musi cyklicznie wysyłać zapytania, aż go otrzyma.

Ten przewodnik zawiera wzorce implementacji typowych operacji na portfolio. Każda instrukcja opisuje konkretny przypadek użycia i zawiera gotowe do użycia zapytania GraphQL, instrukcje krok po kroku oraz informacje o działaniu API, których nie da się wywnioskować z samego schematu.

Instrukcje

Tworzenie portfolio i zarządzanie nim

• Utwórz nowe portfolio - Utwórz tablicę portfolio i pobierz jej identyfikator, cyklicznie wysyłając zapytania
• Połącz projekt z portfolio - Połącz istniejącą tablicę projektu z portfolio, opcjonalnie z asynchronicznym dostarczaniem odpowiedzi zwrotnej
• Wyświetl wszystkie projekty w portfolio - Pobierz metadane projektów i znajdź identyfikatory tablic zadań
• Zduplikuj projekt - Zduplikuj tablicę zadań za pomocą duplicate_board
• Zarchiwizuj lub usuń projekt - Zarchiwizuj tablice projektów lub usuń je na stałe

Odczytywanie i aktualizowanie danych projektu

• Pobierz status lub kondycję projektu - Odczytaj kondycję, etap, priorytet i oś czasu z tablicy portfolio
• Zaktualizuj status projektu - Zmień wartości kondycji, etapu, priorytetu lub osi czasu
• Pobierz zadania przypisane do osoby w różnych projektach - Przejdź przez tablice zadań, aby znaleźć elementy przypisane do danej osoby

Kluczowe pojęcia

Zanim przejdziesz do instrukcji, warto poznać strukturę tablic, na której opiera się każdy projekt w portfolio.

Gdy tworzysz projekt w portfolio, monday.com tworzy dwie tablice o tej samej nazwie:

W przypadku większości operacji musisz wiedzieć, której tablicy użyć. Instrukcja Pobierz status lub kondycję projektu wyjaśnia, jak programowo rozpoznać typ każdej tablicy.

📘 Tylko plan Enterprise

Rozwiązania Portfolio są dostępne tylko w planach Enterprise. Wszystkie mutacje wymagają zakresu boards:write.

Następne kroki

• Dokumentacja Portfolio API - Pełna dokumentacja schematu mutacji Portfolio
• Wysyłanie zapytań o elementy tablicy - Wzorce paginacji używane w tych instrukcjach
• Optymalizacja użycia API - Sprawdzone sposoby na ograniczenie kosztu złożoności

Jeśli masz pytania, zadaj je w społeczności deweloperów monday.