Schemas / Person / organisation / party

`rig.person.name`

v0.31.0 · draft 5 fields 0 required

Fields

Field	Type		Meaning
`givenName`	string	optional	Given / first name
`middleName`	string	optional	Middle name(s)
`familyName`	string	optional	Family / last name
`namePrefix`	string	optional	Honorific / prefix (`Dr`, `Mx`)
`nameSuffix`	string	optional	Generational / suffix (`Jr`, `III`)

Structured personal name of a human, character, user, or contact. Format when present.

Field meanings follow the ISO 20022 PersonName type used inside financial MX messages. This schema is that shared element set - not an MX message, not an organisation, and not a display label.

All fields optional. Emit what the source has; omit empty strings. An empty component is invalid - attach at least one field.

The formatted / full name is rig.meta.named name. Unstructured ISO 20022 Nm stays in the database. The importer maps it into named and these parts. Do not dual-author a fullName here.

Postal address is rig.place.address. Reach channels are rig.person.contact. Sex, gender identity, and birth are rig.person.vital. Employment is rig.person.employment. A photo is rig.person.portrait. A payment account is rig.party.account. Do not re-declare those here.

JSON Schema

Resolves at https://rig.works/schemas/rig.person.name.schema.json — raw file.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://rig.works/schemas/rig.person.name.schema.json",
  "title": "rig.person.name",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "givenName": {
      "$ref": "./_defs.schema.json#/$defs/string"
    },
    "middleName": {
      "$ref": "./_defs.schema.json#/$defs/string"
    },
    "familyName": {
      "$ref": "./_defs.schema.json#/$defs/string"
    },
    "namePrefix": {
      "$ref": "./_defs.schema.json#/$defs/string"
    },
    "nameSuffix": {
      "$ref": "./_defs.schema.json#/$defs/string"
    }
  },
  "description": "Structured personal name. Field meanings follow ISO 20022 PersonName. Display name is rig.meta.named.",
  "minProperties": 1
}

Seen in

art-object.json · book-isbn.json · calendar-event.json · legal-agreement.json · paper-citation.json · person-contact.json