Attribute Values

Each Attribute contains an instance of an Attribute Value within its value property. There are different types of Attribute Values. The types define the value’s structural definition, rendering information and validators. For example, an email address with the value “address@company.corp” is stored with the Attribute Value type EMailAddress, which defines

the data type of the actual value (a String)
how it is validated (the pattern of an email address and a maximum length)
information about how it can be rendered on the UI

Enmeshed defines a standard set of possible Attribute Value types for Identities within the Enmeshed ecosystem and its meaning for the Identities. And every Identity can understand/use/fill/query these Attribute Value types of other Identities.

Most Attribute Value types are atomic, which means that they have only one property called value (e.g. EMailAddress, DisplayName, PhoneNumber). But there are also more complex Attribute Value types which consist of multiple properties with a strong correlation (e.g. StreetAddress, PersonName). These properties can (but don’t have to) contain other Attribute Values.

Identity Attributes

The Attribute Values in this chapter can only be used in an Identity Attribute.

Affiliation

A complex Attribute Value type which defines the affiliation of a person to an organization. Inside of the organization the person can have a role and it can be assigned to a specific unit inside of the organization.

Properties

Name	Type	Required	Validation
`@type`	`"Affiliation"`	✓
role	`string`	✗	see `AffiliationRole`
organization	`string`	✓	see `AffiliationOrganization`
unit	`string`	✗	see `AffiliationUnit`

AffiliationOrganization

The organization the person is affiliated to.

It is not recommended to send an AffiliationOrganization to another Identity by its own. Instead, send an Affiliation with the organization property set.

Properties

Name	Type	Required	Validation
`@type`	`"AffiliationOrganization"`	✓
`value`	`string`	✓	max. length: 100

Validation

AffiliationRole

The role the person has in the organization.

It is not recommended to send an AffiliationRole to another Identity by its own. Instead, send an Affiliation with the role property set.

Properties

Name	Type	Required	Validation
`@type`	`"AffiliationRole"`	✓
`value`	`string`	✓	max. length: 100

AffiliationUnit

The organization unit the person is affiliated to.

It is not recommended to send an AffiliationUnit to another Identity by its own. Instead, send an Affiliation with the unit property set.

Properties

Name	Type	Required	Validation
`@type`	`"AffiliationUnit"`	✓
`value`	`string`	✓	max. length: 100

BirthCity

The city of birth.

It is not recommended to send a BirthCity to another Identity by its own. Instead, send a BirthPlace with the city property set.

Properties

Name	Type	Required	Validation
`@type`	`"BirthCity"`	✓
`value`	`string`	✓	max. length: 100

BirthCountry

The country of birth.

It is not recommended to send a BirthCountry to another Identity by its own. Instead, send a BirthPlace with the country property set.

Properties

Name	Type	Required	Validation
`@type`	`"BirthCountry"`	✓
`value`	`string`	✓	only ISO 3166-1 alpha-2 country codes

BirthDate

The birth date of a natural person.

Properties

Name	Type	Required	Validation
`@type`	`"BirthDate"`	✓
`day`	`number`	✓	see `BirthDay`
`month`	`number`	✓	see `BirthMonth`
`year`	`number`	✓	see `BirthYear`

BirthDay

The day of birth.

It is not recommended to send a BirthDay to another Identity by its own. Instead, send a BirthDate with the day property set.

Name	Type	Required	Validation
`value`	`number`	✓	min: 1 max: 31 must be an integer

BirthMonth

The day of month.

It is not recommended to send a BirthMonth to another Identity by its own. Instead, send a BirthDate with the month property set.

Name	Type	Required	Validation
`@type`	`"BirthDay"`	✓
`value`	`number`	✓	min: 1 max: 12 must be an integer

BirthName

The BirthName is the surname of the person at birth. Some countries allow changing the surname, thus the BirthName is also used as the identification. The BirthName is innate depending on your surname at birth.

If this value is set, there has been a change of the surname throughout the life of the person.

Properties

Name	Type	Required	Validation
`@type`	`"BirthName"`	✓
`value`	`string`	✓	max. length: 100

BirthPlace

The BirthPlace consists of the BirthCity and BirthCountry and can optionally include a BirthState (e.g. if the BirthCity is ambiguous within the BirthCountry).

Properties

Name	Type	Required	Validation
`@type`	`"BirthPlace"`	✓
`city`	`string`	✓ see	`BirthCity`
`country`	`string`	✓ see	`BirthCountry`
`state`	`string`	✗ see	`BirthState`

BirthState

The state of birth.

It is not recommended to send a BirthState to another Identity by its own. Instead, send a BirthPlace with the state property set.

Properties

Name	Type	Required	Validation
`@type`	`"BirthState"`	✓
`value`	`string`	✓	max. length: 100

BirthYear

The year of birth in the Gregorian calendar.

It is not recommended to send a BirthYear to another Identity by its own. Instead, send a BirthDate with the year property set.

Name	Type	Required	Validation
`@type`	`"BirthMonth"`	✓
`value`	`number`	✓	min: 1 max: 9999 must be an integer

Citizenship

The Citizenship defines which country currently recognizes you as a citizen. Thus, the Citizenship usually refers to the country you have a passport from.

Properties

Name	Type	Required	Validation
`@type`	`"Citizenship"`	✓
`value`	`string`	✓	only ISO 3166-1 alpha-2 country codes

City

The name of a city. This is usually used as part of a DeliveryBoxAddress, PostOfficeBoxAddress or StreetAddress.

It is not recommended to send a City to another Identity by its own. Instead, send a DeliveryBoxAddress, PostOfficeBoxAddress or StreetAddress with the city property set.

Properties

Name	Type	Required	Validation
`@type`	`"City"`	✓
`value`	`string`	✓	max. length: 100

CommunicationLanguage

The CommunicationLanguage is an officially recognized language the person can communicate with.

Properties

Name	Type	Required	Validation
`@type`	`"CommunicationLanguage"`	✓
`value`	`string`	✓	only ISO-639-1 language codes

Country

A country code according to the standard “ISO 3166-1 alpha-2”. This is usually used as part of a DeliveryBoxAddress, PostOfficeBoxAddress or StreetAddress.

It is not recommended to send a Country to another Identity by its own. Instead, send a DeliveryBoxAddress, PostOfficeBoxAddress or StreetAddress with the country property set.

Properties

Name	Type	Required	Validation
`@type`	`"Country"`	✓
`value`	`string`	✓	only ISO 3166-1 alpha-2 country codes

DeliveryBoxAddress

A complex Attribute Value defining the components of a delivery box address.

Properties

Name	Type	Required	Validation
`@type`	`"DeliveryBoxAddress"`	✓
`recipient`	`string`	✓	max. length: 100
`deliveryBoxId`	`string`	✓	max. length: 100
`userId`	`string`	✓	max. length: 100
`zipCode`	`string`	✓	see `ZipCode`
`city`	`string`	✓	see `City`
`country`	`string`	✓	see `Country`
`phoneNumber`	`string`	✗	see `PhoneNumber`
`state`	`string`	✗	see `State`

DisplayName

The Display Name is the textual representation of the natural or legal person. It is usually combined out of titles, names or legal statuses.

Properties

Name	Type	Required	Validation
`@type`	`"DisplayName"`	✓
`value`	`string`	✓	max. length: 100

EMailAddress

The email address which can be used to reach the Identity over email systems.

Properties

Name	Type	Required	Validation
`@type`	`"EMailAddress"`	✓
`value`	`string`	✓	min. length: 3 max. length: 100 must match `^[A-Z0-9._%+-]+@[A-Z0-9.-]+.[A-Z]{2,}$`

FaxNumber

The telephone number which can be used to reach the Identity via fax systems.

Properties

Name	Type	Required	Validation
`@type`	`"FaxNumber"`	✓
`value`	`string`	✓	min. length: 3 max. length: 100 must match `^[\d+\-x#*()/[\] ]{3,100}$`

FileReference

A FileReference is a link to an Enmeshed File and can be used to add a File as an Attribute of an Identity. One example for a use case is some kind of certificate.

Properties

Name	Type	Required	Validation
`@type`	`"FileReference"`	✓
`value`	`string`	✓	max. length: 100

GivenName

The Given Name, also called first name or forename, is the name given to a person at birth which differentiates it from other family, tribe or community members.

It is not recommended to send a GivenName to another Identity by its own. Instead, send a PersonName with the givenName property set.

Properties

Name	Type	Required	Validation
`@type`	`"GivenName"`	✓
`value`	`string`	✓	max. length: 100

HonorificPrefix

The honorific prefix of a person, e.g. ‘Sir’.

It is not recommended to send a HonorificPrefix to another Identity by its own. Instead, send a PersonName with the honorificPrefix property set.

Properties

Name	Type	Required	Validation
`@type`	`"HonorificPrefix"`	✓
`value`	`string`	✓	max. length: 100

HonorificSuffix

The honorific suffix of a person, e.g. ‘PhD’

It is not recommended to send a HonorificSuffix to another Identity by its own. Instead, send a PersonName with the honorificSuffix property set.

Properties

Name	Type	Required	Validation
`@type`	`"HonorificSuffix"`	✓
`value`	`string`	✓	max. length: 100

HouseNumber

A house number. This is usually used as part of a StreetAddress.

It is not recommended to send a HouseNumber to another Identity by its own. Instead, send a StreetAddress with the houseNumber property set.

Properties

Name	Type	Required	Validation
`@type`	`"HouseNumber"`	✓
`value`	`string`	✓	max. length: 100

JobTitle

A short phrase that describes the position an employee has within an organization. (e.g. “Senior Developer” in case of a software company).

Properties

Name	Type	Required	Validation
`@type`	`"JobTitle"`	✓
`value`	`string`	✓	max. length: 100

MiddleName

In various cultures, a middle name is a portion of a personal name that is written between the person’s first given name and their surname.

It is not recommended to send a MiddleName to another Identity by its own. Instead, send a PersonName with the middleName property set.

Properties

Name	Type	Required	Validation
`@type`	`"MiddleName"`	✓
`value`	`string`	✓	max. length: 100

Nationality

The Nationality is the citizenship of a person at birth. One cannot change the Nationality because it’s innate. Thus, the Nationality refers usually to the country where you are born.

Properties

Name	Type	Required	Validation
`@type`	`"Nationality"`	✓
`value`	`string`	✓	only ISO 3166-1 alpha-2 country codes

PersonName

The PersonName is a complex Attribute Value type consisting of the GivenName, MiddleName, Surname, HonorificSuffix and HonorificPrefix of a person.

Properties

Name	Type	Required	Validation
`@type`	`"PersonName"`	✓
`givenName`	`string`	✓	see `GivenName`
`middleName`	`string`	✗	see `MiddleName`
`surname`	`string`	✓	see `Surname`
`honorificSuffix`	`string`	✗	see `HonorificSuffix`
`honorificPrefix`	`string`	✗	see `HonorificPrefix`

PhoneNumber

The telephone number which can be used to reach the Identity via telephone.

Properties

Name	Type	Required	Validation
`@type`	`"PhoneNumber"`	✓
`value`	`string`	✓	max. length: 100

PostOfficeBoxAddress

A complex Attribute Value defining the components of a post office box address.

Properties

Name	Type	Required	Validation
`@type`	`"PostOfficeBoxAddress"`	✓
`recipient`	`string`	✓	max. length: 100
`boxId`	`string`	✓	max. length: 100
`zipCode`	`string`	✓	see `ZipCode`
`city`	`string`	✓	see `City`
`country`	`string`	✓	see `Country`
`state`	`string`	✗	see `State`

Pseudonym

The officially registered pseudonym of a person.

Properties

Name	Type	Required	Validation
`@type`	`"Pseudonym"`	✓
`value`	`string`	✓	max. length: 100

Sex

The Sex is the biological, medical, or public gender of a natural person.

Please be advised that the possible values are defined by the public laws and technical passport measures between countries.

We embrace the person’s own definition of its/her/his sexual and gender orientations. Therefore we have no “Gender” AttributeValueType (yet). We look forward in hearing your comments about this.

Properties

Name	Type	Required	Validation
`@type`	`"Sex"`	✓
`value`	`string`	✓	one of: `"intersex"`, `"female"`, `"male"`

State

The name of a state. This is usually used as part of a DeliveryBoxAddress, PostOfficeBoxAddress or StreetAddress.

It is not recommended to send a State to another Identity by its own. Instead, send a DeliveryBoxAddress, PostOfficeBoxAddress or StreetAddress with the state property set.

Properties

Name	Type	Required	Validation
`@type`	`"State"`	✓
`value`	`string`	✓	max. length: 100

Street

A street name. This is usually used as part of a StreetAddress.

It is not recommended to send a Street to another Identity by its own. Instead, send a StreetAddress with the street property set.

Properties

Name	Type	Required	Validation
`@type`	`"Street"`	✓
`value`	`string`	✓	max. length: 100

StreetAddress

A complex Attribute Value defining the components of a “normal” address.

Properties

Name	Type	Required	Validation
`@type`	`"StreetAddress"`	✓
`recipient`	`string`	✓	max. length: 100
`street`	`string`	✓	see `Street`
`houseNumber`	`string`	✓	see `HouseNumber`
`zipCode`	`string`	✓	see `ZipCode`
`city`	`string`	✓	see `City`
`country`	`string`	✓	see `Country`
`state`	`string`	✓	see `State`

Surname

The Surname, also called family name or last name, is the portion of the personal name that indicates the family, tribe or community.

It is not recommended to send a Surname to another Identity by its own. Instead, send a PersonName with the surname property set.

Properties

Name	Type	Required	Validation
`@type`	`"Surname"`	✓
`value`	`string`	✓	max. length: 100

Website

The website of the person which can be used to get more information about the person.

Properties

Name	Type	Required	Validation
`@type`	`"Website"`	✓
`value`	`string`	✓	min. length: 3 max. length: 1024 must be a valid URL

ZipCode

A zip code. This is usually used as part of a DeliveryBoxAddress, PostOfficeBoxAddress or StreetAddress.

It is not recommended to send a ZipCode to another Identity by its own. Instead, send a DeliveryBoxAddress, PostOfficeBoxAddress or StreetAddress with the zipCode property set.

Properties

Name	Type	Required	Validation
`@type`	`"ZipCode"`	✓
`value`	`string`	✓	max. length: 100

Relationship Attributes

The Attribute Values in this chapter can only be used in a Relationship Attribute. Most of them are generic. You can recognize those by the prefix Proprietary (e.g. ProprietaryInteger, ProprietaryString, …). In order to add some validation, you have the option to add valueHints.

Represents the consent of a person to a specific topic. If you want to obtain a consent, you can send a ReadAttributeRequestItem with a Consent-RelationshipAttribute where the owner is the peer.

Properties

Name	Type	Required	Validation
`@type`	`"Consent"`	✓
`consent`	`string`	✓	max. length: 2000
`valueHintsOverride`	`ValueHintsOverride`	✗
`link`	`string`	✗	min. length: 3 max. length: 1024 must be a valid URL

ProprietaryBoolean

An arbitrary boolean value.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryBoolean"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`boolean`	✓

ProprietaryCountry

A two-letter country code according to ISO 3166-1 alpha-2.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryCountry"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`string`	✓	only ISO 3166-1 alpha-2 country codes

ProprietaryEMailAddress

An email address.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryEMailAddress"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`string`	✓	min. length: 3 max. length: 100 must match `^[A-Z0-9._%+-]+@[A-Z0-9.-]+.[A-Z]{2,}$`

ProprietaryFileReference

A FileReference is a link to an Enmeshed File and can be used to add a File as an Attribute of a Relationship.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryFileReference"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`string`	✓	max. length: 100

ProprietaryFloat

An arbitrary floating-point number.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryFloat"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`number`	✓

ProprietaryHEXColor

A hexadecimal color code.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryHEXColor"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`string`	✓	min.length: 4 must match `^#([0-9A-F]{3}){1,2}$` max. length: 100

ProprietaryInteger

An arbitrary integer number.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryInteger"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`number`	✓	must be an integer

ProprietaryJSON

An arbitrary JSON value. The value property can contain any valid JSON structure (except null).

For validation purposes, the value property is stringified using JSON.stringify. That string must not exceed the maximum length of 4096 characters.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryJSON"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`value`	`unknown`	✓	max. length: 4096

Examples

{
  "@type": "ProprietaryJSON",
  "title": "My JSON",
  // length: 94
  "value": {
    "foo": "bar",
    "baz": 123,
    "qux": true,
    "quux": {
      "corge": "grault"
    },
    "garply": ["waldo", "fred", "plugh"]
  }
}

{
  "@type": "ProprietaryJSON",
  "title": "My JSON",
  // length: 8
  "value": "a string"
}

{
  "@type": "ProprietaryJSON",
  "title": "My JSON",
  // length: 28
  "value": ["a string", 1, { "foo": "bar" }]
}

ProprietaryLanguage

A two-letter ISO-639-1 language code.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryLanguage"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`string`	✓	only ISO-639-1 language codes

ProprietaryPhoneNumber

A phone number.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryPhoneNumber"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`string`	✓	min. length: 3 max. length: 100 must match `^[\d+\-x#*()/[\] ]{3,100}$`

ProprietaryString

An arbitrary string.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryString"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`string`	✓	max. length: 100

ProprietaryURL

A URL.

Properties

Name	Type	Required	Validation
`@type`	`"ProprietaryURL"`	✓
`title`	`string`	✓	max. length: 100
`description`	`string`	✗	max. length: 1000
`valueHintsOverride`	`ValueHintsOverride`	✗
`value`	`string`	✓	min. length: 3 max. length: 1024 must be a valid URL

Explore Enmeshed

Identity Attributes

Affiliation

AffiliationOrganization

AffiliationRole

AffiliationUnit

BirthCity

BirthCountry

BirthDate

BirthDay

BirthMonth

BirthName

BirthPlace

BirthState

BirthYear

Citizenship

City

CommunicationLanguage

Country

DeliveryBoxAddress

DisplayName

EMailAddress

FaxNumber

FileReference

GivenName

HonorificPrefix

HonorificSuffix

HouseNumber

JobTitle

MiddleName

Nationality

PersonName

PhoneNumber

PostOfficeBoxAddress

Pseudonym

Sex

State

Street

StreetAddress

Surname

Website

ZipCode

Relationship Attributes

Consent

ProprietaryBoolean

ProprietaryCountry

ProprietaryEMailAddress

ProprietaryFileReference

ProprietaryFloat

ProprietaryHEXColor

ProprietaryInteger

ProprietaryJSON

ProprietaryLanguage

ProprietaryPhoneNumber

ProprietaryString

ProprietaryURL