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" }
| Element | Regeln |
|---|---|
title | Optional. 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_name | Optional. Höchstens 100 Zeichen. |
last_name | Optional. 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
| Fehlertyp | Ursache |
|---|---|
type-mismatch | Der Wert ist kein Objekt, oder ein Element ist kein String. Der Pointer benennt das Element, zum Beispiel #/data/contact/title. |
unknown-field | Ein anderes Element als title, first_name oder last_name. |
string-too-long | Ein Element überschreitet seine Längengrenze. |
full-name-component-required | Ein 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}
}
| Konfiguration | Verhalten |
|---|---|
is_required | Ein Wert mit mindestens Vor- oder Nachnamen muss vorhanden sein. |
default | Nicht verfügbar. |
is_unique | Nicht unterstützt; liefert 422 unique-unsupported-type. |
Abfragefähigkeiten
| Oberfläche | Fähigkeit |
|---|---|
REST filter_operators | contains und is_null (is_null nur bei optionalen Attributen) |
REST is_sortable | true: sortiert nach last_name, dann first_name, ohne Beachtung der Groß-/Kleinschreibung |
| GraphQL-Ausgabe | RecordFullName { title: String, first_name: String, last_name: String, display: String! } |
| GraphQL-Filter | FullNameOperators mit _contains und _is_null |
GraphQL order_by | Verfügbar, gleiche Reihenfolge wie REST |
| Suche | Der 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.