Verträge / SalutationPatch
Anrede Patch
SalutationPatch · com.nexoware.connect.events
- Aggregat
- Salutation · State SalutationState
- Topic
- salutation.patch je Mandant mit Präfix, z. B.
<mandant>.salutation.patch - Key
- SalutationUuid
- Nachrichtenart
- Patch — ausdrückliche Teiländerungen, zusammengeführt vom Zusammenführungsdienst
- Schreiber
- c-entron Webservice (centron)
- Retention
- 30 Tage
- Fassung
- Version 1 (neueste)
- Schema-ID
- 82
Patch-Pfad
- Pflicht bei Anlage
- State
Vertragsentwurf: typisierte Teilaenderung fuer Anrede. Nur ChangedFields werden angewandt; null leert nur nullable State-Einheiten. Listen und Unterobjekte sind atomare Ersetzungen mit vollstaendigem Inhalt. Fachliche Freigabe und Regeln gekoppelter Werte sind offen; siehe docs/contracts/salutation.md.
Fassungen
Felder
-
EventId ↗ extern: EventId uuidBeim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch.
-
SalutationUuid Key uuidStabile, global eindeutige Identitaet der Anrede (Matching-Schluessel; zugleich Message-Key).
-
Mode enum(CHANGE|INITIAL_LOAD)
-
ChangedFields Liste string[]Explizite Maske der geaenderten Top-Level-Einheiten; keine Wildcards, Identitaets- oder Auditfelder. Listen und Records werden als Ganzes ersetzt.
-
Data SalutationPatchData
2 Felder von
SalutationPatchData-
Text optional stringDefault:
nullAnrede-Text, wie ihn die Quelle fuehrt (z. B. Herr, Frau). Der Katalog ist quellseitig offen; die Menge der Werte ist nicht Teil des Vertrags. -
State optional intDefault:
null
-
-
Default:
nullUUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt. -
ChangedAt timestampZeitpunkt der Aenderung als UTC-Instant.
Referenziert von
- Ansprechpartner
ContactPersonPatch.Data.SalutationUuid - Ansprechpartner
ContactPersonState.SalutationUuid
Rohfassung
Schema dieser Fassung (Avro)
{
"type": "record",
"name": "SalutationPatch",
"namespace": "com.nexoware.connect.events",
"doc": "Vertragsentwurf: typisierte Teilaenderung fuer Anrede. Nur ChangedFields werden angewandt; null leert nur nullable State-Einheiten. Listen und Unterobjekte sind atomare Ersetzungen mit vollstaendigem Inhalt. Fachliche Freigabe und Regeln gekoppelter Werte sind offen; siehe docs/contracts/salutation.md.",
"fields": [
{
"name": "EventId",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Beim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch."
},
{
"name": "SalutationUuid",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Stabile, global eindeutige Identitaet der Anrede (Matching-Schluessel; zugleich Message-Key)."
},
{
"name": "Mode",
"type": {
"type": "enum",
"name": "PatchMode",
"doc": "CHANGE: lokal autorisierte Aenderung, LWW je Einheit nach Kafka-Reihenfolge. INITIAL_LOAD: Erstbefuellung beim Anschluss eines Produkts - setzt eine Einheit nur, wenn sie noch nie geschrieben wurde; ueberschreibt nie einen vorhandenen oder ausdruecklich geleerten Wert. Bewusst ohne Enum-Default: ein unbekannter kuenftiger Modus darf nicht still als CHANGE gelesen werden.",
"symbols": [
"CHANGE",
"INITIAL_LOAD"
]
}
},
{
"name": "ChangedFields",
"type": {
"type": "array",
"items": "string"
},
"doc": "Explizite Maske der geaenderten Top-Level-Einheiten; keine Wildcards, Identitaets- oder Auditfelder. Listen und Records werden als Ganzes ersetzt."
},
{
"name": "Data",
"type": {
"type": "record",
"name": "SalutationPatchData",
"doc": "Werte der maskierten Einheiten. null ausserhalb der Maske wird ignoriert; innerhalb der Maske entscheidet die Nullability im State.",
"fields": [
{
"name": "Text",
"type": [
"null",
"string"
],
"doc": "Anrede-Text, wie ihn die Quelle fuehrt (z. B. Herr, Frau). Der Katalog ist quellseitig offen; die Menge der Werte ist nicht Teil des Vertrags.",
"default": null
},
{
"name": "State",
"type": [
"null",
"int"
],
"default": null
}
]
}
},
{
"name": "ChangedByUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "UUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt.",
"default": null,
"references": "Employee"
},
{
"name": "ChangedAt",
"type": {
"type": "long",
"logicalType": "timestamp-millis"
},
"doc": "Zeitpunkt der Aenderung als UTC-Instant."
}
],
"aggregate": "Salutation",
"label": "Anrede",
"topic": "salutation.patch",
"key": "SalutationUuid",
"cleanupPolicy": "delete",
"retentionMs": 2592000000,
"partitions": 1,
"writers": [
"centron"
],
"requiredOnCreate": [
"State"
]
}