Portfolio

Portfolios ermöglichen die Zusammenfassung und Steuerung mehrerer Projekte unter einem gemeinsamen Dach.

---

Portfolio

Die Portfolio-Entität repräsentiert ein Projektportfolio.

Datenmodell

Eigenschaft	Typ	Beschreibung
PortfolioId	guid	Eindeutige ID des Portfolios.
Name	string	Name des Portfolios.
Description	string	Freitextbeschreibung des Portfolios.
PortfolioManagerContactId	guid	Kontakt-ID des Portfoliomanagers.

Endpunkte

Alle Portfolios abrufen

GET/odata/Portfolio

Unterstützt OData-Abfrageoptionen.

---

Ein einzelnes Portfolio nach ID abrufen

GET/odata/Portfolio({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die PortfolioId des abzurufenden Portfolios.

---

Ein neues Portfolio erstellen

POST/odata/Portfolio

Parameter	Typ	Erforderlich	Beschreibung
Body	Delta<ApiPortfolio>	✅	JSON-Objekt mit den Portfolioeigenschaften.

Übergeben Sie die Portfolioeigenschaften im Anfragekörper. Die PortfolioId wird automatisch generiert, wenn sie nicht angegeben wird.

---

Ein bestehendes Portfolio aktualisieren

PATCH/odata/Portfolio({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die PortfolioId des zu aktualisierenden Portfolios.
Body	Delta<ApiPortfolio>	✅	JSON-Objekt mit den zu aktualisierenden Feldern.

---

Ein Portfolio löschen

DELETE/odata/Portfolio({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die PortfolioId des zu löschenden Portfolios.

Gibt 204 No Content bei Erfolg zurück.

warnung

Das Löschen eines Portfolios ist endgültig und kann nicht rückgängig gemacht werden.

---

OData-Abfragebeispiele

Alle Portfolios abrufen

GET /odata/Portfolio?$orderby=Name&$top=10

Portfolio nach Name filtern

GET /odata/Portfolio?$filter=Name eq 'Digitale Transformation 2025'

Budgetziele eines Portfolios abrufen

GET /odata/PortfolioTarget?$filter=PortfolioId eq xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Portfolio erstellen

POST /odata/Portfolio
Content-Type: application/json

{
  "Name": "Digitale Transformation 2025",
  "Description": "Alle Projekte zur digitalen Transformation.",
  "PortfolioManagerContactId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}