Translations:Datenimport/-export Schnittstelle/37/de: Unterschied zwischen den Versionen

← Zum vorherigen Versionsunterschied Zum nächsten Versionsunterschied →

Version vom 19. März 2026, 12:50 Uhr

Information zur Nachricht (bearbeiten)

Zu dieser Nachricht ist keine Dokumentation vorhanden. Sofern du weißt, wo und in welchem Zusammenhang sie genutzt wird, kannst du anderen Übersetzern bei ihrer Arbeit helfen, indem du eine Dokumentation hinzufügst.

Nachricht im Original (Datenimport/-export Schnittstelle)

* Maßnahmen (Measures)
** PUT /api/v2/measures ersetzt PUT /api/measures
*** Einstellungen zur Wirksamkeitspüfung können nicht mehr gesetzt oder verändert werden, da dies auf interne IDs angewiesen ist
*** Der "ID" Parameter verweist jetzt auf die in HITGuard hinterlegte "ID in Drittsystem" und nicht mehr die interne ID
** PUT /api/measures/close/{id}
*** wurde als veraltet markiert, da dies eine interne ID verwendet hat → nur noch PUT /api/measures/close/byKey verwenden!
** Generell
*** Der Parameter "state" verwendet jetzt Enumerationswerte
* Kanten der Strukturanalyse (AssetEdges)
** PUT /api/v2/asset-edges ersetzt PUT /api/asset-edges
*** Die Parameter "sourceType" und "targetType" verwenden jetzt Enumerationswerte
* Ressourcen (Resources)
** alle Endpunkte wurden in "v1" als veraltet markiert
*** Der Parameter "modelSegment" verwendet jetzt Enumerationswerte
* Risiken (Risks)
** GET /api/v2/risks ersetzt GET /api/risks/{managementSystemId}
*** Der Pfad-Parameter "managementSystemId" wurde entfernt. Stattdessen können jetzt die optionalen Query-Parameter "managementSystemId" und "includePublicRisks" verwendet werden um Risiken abzufragen und zu filtern.
** GET /api/v2/risks/{id} ersetzt GET /api/risks/byKey/{id}
*** Endpunkt wurde angepasst um konsistent zu den anderen Endpunkten zu sein.
** PUT /api/v2/risks ersetzt PUT /api/risks
*** Das Datenmodell wurde angepasst. Die "managementSystemId" wird nicht mehr auf oberer Ebene vergeben sondern je Risiko. Das Modell ist jetzt "RiskCreateOrUpdateDtoV2" und nicht mehr "HazardSituationImportDto"
*** Es kann jetzt auch der Status des Risiko über die API aktualisiert werden. Erlaubte werte sind: Active, Inactive, Accepted, Rejected
*** Es kann jetzt auch die Strategie des Risiko über die API aktualisiert werden. Erlaubte werte sind abhängig davon ob es ein Schadensausmaß oder ein Nutzen zugewiesen ist (also ob es sich um ein Risiko oder eine Chance handelt). Ist es ein Schadensausmaß sind die erlaubte Werte: Undefined, Avoidance, Reduction, Transfer, Acceptance. Ist es ein Nutzen sind sind die erlaubte Werte: Undefined, Enhance, Share, Exploit, Ignore.
*** Es ist nun möglich die Anmerkungen zum Risiko zu ändern
*** Es ist nun möglich den Sachbearbeiter zu ändern
** POST /api/v2/risks/submit neuer Endpunkt zum importieren von Risiken im Status "Eingereicht"
** DELETE /api/v2/risks/{id} ersetzt DELETE /api/risks/{id}
** alle Endpunkte wurden in "v1" als veraltet markiert
** GET Endpunkte returnieren mehr Informationen zum Risiko wie Anmerkungen, Strategie und Sachbearbeiter

Maßnahmen (Measures)
- PUT /api/v2/measures ersetzt PUT /api/measures
  - Einstellungen zur Wirksamkeitspüfung können nicht mehr gesetzt oder verändert werden, da dies auf interne IDs angewiesen ist
  - Der "ID" Parameter verweist jetzt auf die in HITGuard hinterlegte "ID in Drittsystem" und nicht mehr die interne ID
- PUT /api/measures/close/{id}
  - wurde als veraltet markiert, da dies eine interne ID verwendet hat → nur noch PUT /api/measures/close/byKey verwenden!
- Generell
  - Der Parameter "state" verwendet jetzt Enumerationswerte
Kanten der Strukturanalyse (AssetEdges)
- PUT /api/v2/asset-edges ersetzt PUT /api/asset-edges
  - Die Parameter "sourceType" und "targetType" verwenden jetzt Enumerationswerte
Ressourcen (Resources)
- alle Endpunkte wurden in "v1" als veraltet markiert
  - Der Parameter "modelSegment" verwendet jetzt Enumerationswerte
Risiken (Risks)
- GET /api/v2/risks ersetzt GET /api/risks/{managementSystemId}
  - Der Pfad-Parameter "managementSystemId" wurde entfernt. Stattdessen können jetzt die optionalen Query-Parameter "managementSystemId" und "includePublicRisks" verwendet werden um Risiken abzufragen und zu filtern.
- GET /api/v2/risks/{id} ersetzt GET /api/risks/byKey/{id}
  - Endpunkt wurde angepasst um konsistent zu den anderen Endpunkten zu sein.
- PUT /api/v2/risks ersetzt PUT /api/risks
  - Das Datenmodell wurde angepasst. Die "managementSystemId" wird nicht mehr auf oberer Ebene vergeben sondern je Risiko. Das Modell ist jetzt "RiskCreateOrUpdateDtoV2" und nicht mehr "HazardSituationImportDto"
  - Es kann jetzt auch der Status des Risiko über die API aktualisiert werden. Erlaubte werte sind: Active, Inactive, Accepted, Rejected
- POST /api/v2/risks/submit neuer Endpunkt zum importieren von Risiken im Status "Eingereicht"
- DELETE /api/v2/risks/{id} ersetzt DELETE /api/risks/{id}
- alle Endpunkte wurden in "v1" als veraltet markiert

@@ Zeile 18: / Zeile 18: @@
 ** GET /api/v2/risks/{id} ersetzt GET /api/risks/byKey/{id}
 *** Endpunkt wurde angepasst um konsistent zu den anderen Endpunkten zu sein.
+** PUT /api/v2/risks ersetzt PUT /api/risks
+*** Das Datenmodell wurde angepasst. Die "managementSystemId" wird nicht mehr auf oberer Ebene vergeben sondern je Risiko. Das Modell ist jetzt "RiskCreateOrUpdateDtoV2" und nicht mehr "HazardSituationImportDto"
+*** Es kann jetzt auch der Status des Risiko über die API aktualisiert werden. Erlaubte werte sind: Active, Inactive, Accepted, Rejected
+** POST /api/v2/risks/submit neuer Endpunkt zum importieren von Risiken im Status "Eingereicht"
+** DELETE /api/v2/risks/{id} ersetzt DELETE /api/risks/{id}
+** alle Endpunkte wurden in "v1" als veraltet markiert