Zum Hauptinhalt springen

Vollständiger Name

full_name speichert den Namen einer Person als Bestandteile, die einzeln bearbeitet und abgefragt werden können, aber als ein Wert angezeigt werden: ein optionaler title, ein first_name und ein last_name. Verwenden Sie ihn, wo ein Datensatz eine Person benennt. Verwenden Sie text für Namen von Dingen, und lassen Sie bestehende Freitext-Namensattribute wie sie sind: Attributtypen sind unveränderlich und es wird nicht automatisch aufgeteilt.

Wert​

{ "title": "Dr. Mag.", "first_name": "Anna", "last_name": "Muster" }
ElementRegeln
titleOptional. Akademische oder berufliche Titel genau wie eingegeben, etwa Dr., Mag., Prof. oder Dr. Mag.. Es gibt keine Liste erlaubter Titel und keine Umsortierung. Höchstens 50 Zeichen.
first_nameOptional. Höchstens 100 Zeichen.
last_nameOptional. Höchstens 100 Zeichen.

Elemente werden getrimmt, und Folgen von Leerraum werden zu einem Leerzeichen zusammengefasst. Ein leeres Element entfällt, sodass ein Lesevorgang nie ""- oder null-Elemente zurückgibt. Einteilige Namen sind gültig: Mindestens eines von first_name und last_name muss vorhanden sein. Ein Titel ohne Namen liefert 422 full-name-component-required.

Ein mitgesendeter Wert ersetzt den gespeicherten Wert vollständig. {"first_name": "Anna", "last_name": "Muster"} entfernt einen gespeicherten Titel, und {"title": "Prof.", "last_name": "Muster"} entfernt den gespeicherten Vornamen. Clients, die ein Element bearbeiten, senden die gesamte Struktur.

Leere Werte​

Ein Wert, dessen Elemente alle leer sind, etwa {} oder {"first_name": " "}, ist leer. Er leert das Attribut genau wie null: Ein optionales Attribut wird entfernt, ein Pflichtattribut liefert 422 required-field. Lesevorgänge geben nie ein leeres Objekt zurück.

Validierungsfehler​

FehlertypUrsache
type-mismatchDer Wert ist kein Objekt, oder ein Element ist kein String. Der Pointer benennt das Element, zum Beispiel #/data/contact/title.
unknown-fieldEin anderes Element als title, first_name oder last_name.
string-too-longEin Element überschreitet seine Längengrenze.
full-name-component-requiredEin Titel wurde ohne Vor- oder Nachnamen gesendet.

Anzeige​

Anzeigevorlagen, automatische Anzeigenamen, kompakte Listenzellen, das GraphQL-Feld display und der Suchindex verwenden eine gemeinsame Regel: title first_name last_name, durch einzelne Leerzeichen verbunden, fehlende Teile werden übersprungen. Dr. Mag. Anna Muster, Anna Muster, Prof. Muster und Muster werden alle ohne zusätzliche Leerzeichen oder Platzhaltertext dargestellt. Sprachspezifische Namensreihenfolgen werden nicht angeboten.

Definition​

{
"slug": "contact",
"type": "full_name",
"name": {"en": "Contact", "de": "Kontakt"},
"config": {"is_required": false}
}
KonfigurationVerhalten
is_requiredEin Wert mit mindestens Vor- oder Nachnamen muss vorhanden sein.
defaultNicht verfügbar.
is_uniqueNicht unterstützt; liefert 422 unique-unsupported-type.

Abfragefähigkeiten​

OberflächeFähigkeit
REST filter_operatorscontains und is_null (is_null nur bei optionalen Attributen)
REST is_sortabletrue: sortiert nach last_name, dann first_name, ohne Beachtung der Groß-/Kleinschreibung
GraphQL-AusgabeRecordFullName { title: String, first_name: String, last_name: String, display: String! }
GraphQL-FilterFullNameOperators mit _contains und _is_null
GraphQL order_byVerfügbar, gleiche Reihenfolge wie REST
SucheDer kombinierte Anzeigetext wird indexiert; Elementnamen nicht

contains vergleicht den kombinierten Anzeigetext ohne Beachtung der Groß-/Kleinschreibung, sodass "anna must" auf Dr. Anna Muster passt. Filter auf ein einzelnes Element werden nicht veröffentlicht: Ein contains-Operand wird gegen den ganzen Namen geprüft. Gleichheits-, Präfix- und Suffixoperatoren liefern 422 filter-operator-not-applicable.

Integrationsoberflächen​

Webhook-Nutzdaten, MCP-Datensatzwerkzeuge, Workflow-Datensatzoperationen und Fahrzeugdefinitionen übertragen dasselbe Objekt innerhalb von data, genau wie REST es zurückgibt. Titel reisen über jede Oberfläche mit dem Wert mit und werden nie in die Namenselemente eingemischt.