Zum Inhalt

Verknüpfte Daten abrufen

Dieser Service Task ruft alle Datenobjekte ab, die von einem bestimmten Quell-Datenobjekt aus verknüpft sind. Er löst die im Datenmodell definierten Referenzen auf und gibt alle verbundenen Datensätze zurück.

Nutzen: Prozesse können automatisch Datenbeziehungen folgen — von einer Bestellung zum verknüpften Kunden, von einem Vertrag zu den zugehörigen Dokumenten — ohne manuelle Suche.

Funktionsweise

In Pantarey können Datenstrukturen aufeinander verweisen (z. B. „Bestellung" verweist auf „Kunde" und „Produkt"). Wenn ein Datenobjekt auf Basis einer solchen Struktur erstellt wird, zeigen diese Referenzen auf konkrete Datensätze.

Dieser Service Task folgt den ausgehenden Referenzen eines Quellobjekts und gibt alle Ziele zurück.

Bestellung-2026-001 ──→ Kunde: Müller GmbH
                     ──→ Produkt: Widget Pro
                     ──→ Rechnung: RE-2026-042

Eingabeparameter

Parameter Typ Pflicht Beschreibung
dataObjectId String Ja Die ID des Quell-Datenobjekts, dessen Verknüpfungen aufgelöst werden sollen.
dataSchemaId String Nein Ergebnisse nach einer bestimmten Ziel-Datenstruktur filtern (z. B. nur verknüpfte „Kunden"-Datensätze).
includeDetails Boolean Nein Wenn true, wird jede Referenz um den Dokumentnamen und Pfad des Ziels angereichert. Standard: false.

Beispiel-Eingabe

{
  "dataObjectId": "550e8400-e29b-41d4-a716-446655440000",
  "dataSchemaId": "customer",
  "includeDetails": true
}

Ausgabe

Feld Typ Beschreibung
dataObjectId String Die Quellobjekt-ID (zurückgegeben).
totalCount Zahl Anzahl der gefundenen Verknüpfungen.
references Array Liste der verknüpften Datenobjekt-Referenzen.

Jede Referenz enthält:

Feld Typ Beschreibung
sourceObjectId String Die Quellobjekt-ID.
sourceObjectAttribute String Der Attributname am Quellobjekt, der die Referenz hält.
targetObjectId String Die ID des verknüpften Zielobjekts.
targetDataSchemaId String Der Datenstruktur-Typ des Ziels.
sourceDataSchemaId String Der Datenstruktur-Typ der Quelle.
sourceDocumentName String Der Dokumentname des Quellobjekts.
targetDocumentName String / null Der Dokumentname des Ziels (nur mit includeDetails: true).
targetDataObjectKey String / null Der Datenobjekt-Pfad des Ziels (nur mit includeDetails: true).

Beispiel-Ausgabe

{
  "dataObjectId": "550e8400-e29b-41d4-a716-446655440000",
  "totalCount": 2,
  "references": [
    {
      "sourceObjectId": "550e8400-e29b-41d4-a716-446655440000",
      "sourceObjectAttribute": "customer",
      "targetObjectId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "targetDataSchemaId": "customer",
      "sourceDataSchemaId": "order",
      "sourceDocumentName": "Bestellung-2026-001",
      "targetDocumentName": "Müller GmbH",
      "targetDataObjectKey": "customer/objects/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    {
      "sourceObjectId": "550e8400-e29b-41d4-a716-446655440000",
      "sourceObjectAttribute": "product",
      "targetObjectId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "targetDataSchemaId": "product",
      "sourceDataSchemaId": "order",
      "sourceDocumentName": "Bestellung-2026-001",
      "targetDocumentName": "Widget Pro",
      "targetDataObjectKey": "product/objects/b2c3d4e5-f6a7-8901-bcde-f12345678901"
    }
  ]
}

Anwendungsfälle

  • Auftragsbearbeitung: Kunde, Produkte und Rechnung einer Bestellung in einem Schritt abrufen.
  • Vertragsmanagement: Von einem Vertrag zu den zugehörigen Parteien, Dokumenten und Anhängen navigieren.
  • Auswirkungsanalyse: Vor der Änderung eines Datensatzes prüfen, welche anderen Datensätze davon abhängen.
  • Dynamische Benachrichtigungen: Alle verknüpften Kontakte finden und bei Statusänderungen benachrichtigen.
  • Datenanreicherung: Daten aus verknüpften Datensätzen in einer Prozessvariable kombinieren.

Hinweise

  • Ohne includeDetails werden nur die Referenz-Metadaten zurückgegeben (1 Datenbankabfrage). Mit includeDetails wird pro verknüpftem Objekt eine zusätzliche Abfrage ausgeführt.
  • Wurde ein referenziertes Zielobjekt gelöscht, wird es trotzdem im Ergebnis aufgeführt, aber mit targetDocumentName: null.
  • Mit dataSchemaId können Ergebnisse eingegrenzt werden, wenn nur ein bestimmter Typ verknüpfter Daten relevant ist.