Portfolio

Portfolios ermöglichen die Zusammenfassung und Steuerung mehrerer Projekte unter einem gemeinsamen Dach. Über PortfolioTarget-Einträge können Sie Budgetziele für bestimmte Geschäftsperioden definieren und den Fortschritt verfolgen.

tipp

Kombinieren Sie Portfolios mit PortfolioTarget-Einträgen, um operative Ausgaben (Opex), Investitionsausgaben (Capex) und Gesamtausgaben gegen Geschäftsperiodenziele zu verfolgen.

---

Portfolio

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

Eigenschaften

Property	Type	Description
PortfolioId	Edm.Guid	Eindeutige ID des Portfolios.
Name	Edm.String	Name des Portfolios.
Description	Edm.String	Freitextbeschreibung des Portfolios.
PortfolioManagerContactId	Edm.Guid	Kontakt-ID des Portfoliomanagers.

Endpunkte

GET/odata/Portfolio

Alle Portfolios abrufen

Unterstützt OData-Abfrageoptionen wie $filter, $select, $orderby, $top und $skip.

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

---

GET/odata/Portfolio/$count

Gesamtanzahl der Portfolios abrufen

Gibt eine Ganzzahl zurück. Unterstützt $filter für bedingte Zählung.

GET /odata/Portfolio/$count?$filter=Name eq 'Q4 Initiativen'

---

GET/odata/Portfolio({key})

Ein einzelnes Portfolio nach ID abrufen

Parameter	Type	Required	Description
key	Edm.Guid	✅	Die PortfolioId des abzurufenden Portfolios.

GET /odata/Portfolio(3fa85f64-5717-4562-b3fc-2c963f66afa6)

---

POST/odata/Portfolio

Ein neues Portfolio erstellen

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

{
  "Name": "Digitale Transformation 2025",
  "Description": "Alle Projekte zur digitalen Transformation im Jahr 2025.",
  "PortfolioManagerContactId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

info

Die Antwort enthält das erstellte Portfolio einschließlich der vom Server generierten PortfolioId.

---

PATCH/odata/Portfolio({key})

Ein bestehendes Portfolio aktualisieren

Parameter	Type	Required	Description
key	Edm.Guid	✅	Die PortfolioId des zu aktualisierenden Portfolios.

Senden Sie nur die Eigenschaften, die Sie ändern möchten:

{
  "Description": "Erweiterter Umfang: umfasst auch Nachhaltigkeitsprojekte."
}

---

DELETE/odata/Portfolio({key})

Ein Portfolio löschen

Parameter	Type	Required	Description
key	Edm.Guid	✅	Die PortfolioId des zu löschenden Portfolios.

Gibt 204 No Content bei Erfolg zurück.

---

PortfolioTarget

Portfolioziele definieren Budgetvorgaben für ein Portfolio innerhalb einer bestimmten Geschäftsperiode. Jedes Ziel erfasst operative Ausgaben (Opex), Investitionsausgaben (Capex) und Gesamtausgabenwerte.

Eigenschaften

Property	Type	Description
PortfolioTargetId	Edm.Guid	Eindeutige ID des Portfolioziels.
PortfolioId	Edm.Guid	ID des übergeordneten Portfolios.
FiscalPeriodId	Edm.Guid	ID der Geschäftsperiode.
Description	Edm.String	Freitextbeschreibung des Ziels.
TargetOpex	Edm.Double	Zielwert für operative Ausgaben.
TargetCapex	Edm.Double	Zielwert für Investitionsausgaben.
TargetTotal	Edm.Double	Gesamtausgabenziel.

Endpunkte

GET/odata/PortfolioTarget

Alle Portfolioziele abrufen

Unterstützt Standard-OData-Abfrageoptionen. Filtern Sie nach Portfolio:

GET /odata/PortfolioTarget?$filter=PortfolioId eq 3fa85f64-5717-4562-b3fc-2c963f66afa6

---

GET/odata/PortfolioTarget/$count

Gesamtanzahl der Portfolioziele abrufen

GET /odata/PortfolioTarget/$count

---

GET/odata/PortfolioTarget({key})

Ein einzelnes Portfolioziel nach ID abrufen

Parameter	Type	Required	Description
key	Edm.Guid	✅	Die PortfolioTargetId.

---

POST/odata/PortfolioTarget

Ein neues Portfolioziel erstellen

{
  "PortfolioId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "FiscalPeriodId": "c9a1e2b3-4d5f-6789-0abc-def123456789",
  "Description": "Budgetziel Q1 2025",
  "TargetOpex": 150000.00,
  "TargetCapex": 75000.00,
  "TargetTotal": 225000.00
}

---

PATCH/odata/PortfolioTarget({key})

Ein bestehendes Portfolioziel aktualisieren

Parameter	Type	Required	Description
key	Edm.Guid	✅	Die PortfolioTargetId.

{
  "TargetTotal": 250000.00
}

---

DELETE/odata/PortfolioTarget({key})

Ein Portfolioziel löschen

Parameter	Type	Required	Description
key	Edm.Guid	✅	Die PortfolioTargetId.

Gibt 204 No Content bei Erfolg zurück.