Schemas / Person / organisation / party
rig.person.employment
v0.31.0 · draft 9 fields 0 required
Fields
| Field | Type | Meaning | |
|---|---|---|---|
jobTitle |
string | optional | Role title |
responsibility |
string | optional | What the role covers |
department |
string | optional | Organisation unit of the person |
occupation |
string | optional | Profession / occupation |
employeeId |
string | optional | Staff / payroll number |
organisation |
entity | optional | Employer entity |
reportsTo |
entity | optional | Manager / supervisor person |
startDate |
string | optional | First day, YYYY-MM-DD |
endDate |
string | optional | Last day, YYYY-MM-DD |
Employment of a human, character, user, or contact. Format when present.
Job title, responsibility, and department follow those slots on ISO 20022 ContactDetails. The employer is an entity - not a second name string.
All fields optional. Emit what the source has; omit empty strings. An empty component is invalid - attach at least one field.
Name the employer with rig.meta.named on the organisation entity. Legal identifiers are rig.organisation.identity. A site address on that entity is rig.place.address. Do not put an organisation name string here.
department here is the person's unit. rig.place.address department is an organisation unit at a place. They are different meanings - do not copy one into the other.
A portrait is rig.person.portrait. Payroll account is rig.party.account.
JSON Schema
Resolves at https://rig.works/schemas/rig.person.employment.schema.json —
raw file.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://rig.works/schemas/rig.person.employment.schema.json",
"title": "rig.person.employment",
"type": "object",
"additionalProperties": false,
"properties": {
"jobTitle": {
"$ref": "./_defs.schema.json#/$defs/string"
},
"responsibility": {
"$ref": "./_defs.schema.json#/$defs/string"
},
"department": {
"$ref": "./_defs.schema.json#/$defs/string"
},
"occupation": {
"$ref": "./_defs.schema.json#/$defs/string"
},
"employeeId": {
"$ref": "./_defs.schema.json#/$defs/string"
},
"organisation": {
"$ref": "./_defs.schema.json#/$defs/entity"
},
"reportsTo": {
"$ref": "./_defs.schema.json#/$defs/entity"
},
"startDate": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "ISO 8601 calendar date."
},
"endDate": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "ISO 8601 calendar date."
}
},
"description": "Employment. Job title / department follow ISO 20022 ContactDetails; organisation is an entity.",
"minProperties": 1
}