====== Beispiele für den Datenaustausch ======

<WRAP b2hero>
**Synthetische Beispiele zum Nachbauen**

Die Beispiele illustrieren Datenstrukturen und Prüfungen. Sie sind keine Erfolgsgeschichten oder Nachweise realer Transaktionen.

[[schemes:scheme|Schemata]] · [[:guidelines|Integration]]
</WRAP>

===== Eine Person mit nur einem Namen =====

Ein Formular muss keinen Nachnamen erfinden. Das Modul [[schemes:person:nameandbirthdetails|Name und Geburt]] erlaubt:

<file json person.json>
{"name":{"preferredName":"Sukarno"},"birthDatePartial":"1984"}
</file>

Der Designer kann ''[name][preferredName]'' als Textfeld verwenden. Die unvollständige Geburt wird nicht automatisch als ''1984-01-01'' interpretiert.

===== Ein lokales Konto ohne IBAN =====

Bei einer [[schemes:financial:bankaccount|Bankverbindung]] außerhalb eines IBAN-Verfahrens genügt die strukturelle Alternative aus lokaler Kontonummer und den übrigen Pflichtfeldern. Der konkrete Zahlungsweg bestimmt zusätzliche Routing-Angaben:

<file json bankaccount.json>
{"accountHolders":[{"entityType":"person","id":"urn:example:person:42"}],"accountNumber":"000123456789","bank":{"name":"Example Bank","country":"US"},"currency":"USD"}
</file>

Die führenden Nullen bleiben erhalten. Das Beispiel führt keine Zahlung aus und bestätigt kein existierendes Konto.

===== Ein Betrag mit drei Nachkommastellen =====

Das Modul [[schemes:financial:money|Geldbetrag]] trennt Wert und Währung:

<file json money.json>
{"amount":"12.345","currency":"KWD"}
</file>

Die Dezimalstellen werden beim JSON-Transport erhalten. Die Berechnung erfolgt mit einer Dezimalarithmetik; Rundung ist eine zusätzliche Geschäftsregel.

===== Aufgabe und Dokument verbinden =====

Eine [[schemes:process:task|Aufgabe]] enthält einen Verweis auf [[schemes:process:document|Dokumentmetadaten]]:

<file json task.json>
{"id":"urn:example:task:42","title":"Unterlagen prüfen","status":"pending","documentRefs":["urn:example:document:42"]}
</file>

Das Dokument wird separat gespeichert. Ein Adapter muss die Kennung auflösen, Berechtigungen prüfen und anschließend das vorhandene Workspace-Format bedienen.

===== Einen Folgeworkflow beschreiben =====

[[schemes:process:handoff|Workflowübergaben]] verwenden eine einheitliche Hülle für Zielart, Ziel und freigegebene Nutzdaten. Beim Beispiel auf der Modulseite beschreibt ''payload.schemaId'' das Schema des enthaltenen Geldbetrags. Hülle und Nutzdaten werden getrennt validiert. Die Datei selbst ruft weder eine URL noch ein Skript auf.