Stakeholder
EntityDraftv1.0.0-rc.2
A stakeholder: a person or organization involved in a development, such as an operator, a consultant, a regulator or a resident.
https://opendevelopmentstandards.org/schema/1.0.0-rc.2/core/Stakeholder.json
Fields
Every entity also has the fields of the Entity base. The first row lists them.
From the Entity baseidnamedescriptionidentifierslinkscreatedAtupdatedAt
idRequiredtextnot emptyThe record's id: unique within the document. Fields that point at the record hold this id.
nametextThe name people use for the record.
descriptiontextWhat the record is, in words.
identifiersList ofDatatypeIdentifierIds the record has in other systems.
linksList ofDatatypeLinkOpen-ended links to other records.
createdAtdate-time (RFC 3339)When the record was created, in its producer's system.
updatedAtdate-time (RFC 3339)When the record last changed, in its producer's system.
typeOne ofthe codes belowWhat sort of stakeholder it is.
organization- A company, an agency or another body.
person- One person. Their name is personal information.
group- People who act together without being an organization, such as residents of an area.
Links
Held by Records that embed this one, with their field that holds it.
Pointed at by Records that hold this one's id, with their field that holds it.
- AlgorithmEntitypublisherA published or versioned computation, such as ISO 9613-2:2024, or a model trained on data. Sealed steps and runs refer to it by id, as the method they claim to follow.
- AssessmentEntityauthorsAn evaluation of a development and its result, such as a noise impact assessment. It names its authors, scope and framework, the traces and evidence it rests on, and its conclusions. A trace is one run; an assessment can rest on many.
- CalibrationPartperformedByA check of an instrument against a reference, with its date, its result and its certificate.
- FindingPartstatusBySomething a check, an agent or a person found about a record: a problem, a risk or a note. Traces, conformance checks and report imports all report findings.
- FrameworkEntityissuerA set of rules for one domain, issued by a regulator, an industry body or an organization, such as AER Directive 038. It holds its policies, controls, periods and variables.
- IdentifierDatatypeissuerA licence number, a register id or a producer's own key. The record's own
idstays the one that references use. - PermitEntityissuerholderA licence or approval that a regulator gives for a development, with its holder, its dates, its status and its own criteria, such as a site's own noise limit.
- RegulatorProfileEntitypublisherA framework written so that a program can run it. It names the framework, the flows that check it, who publishes it and its version. Its flows have no sealed steps, so any reader can run every rule.
- TraceEntityTraceStep.oversight.approvedByWhat one run of a flow or an algorithm did: what it used, each step, what it made, and the verdict. Its terms follow W3C PROV where they map: agents (prov:wasAssociatedWith), inputs (prov:used), outputs (prov:generated).
Examples
An id that another example defines opens that record.
Full example
{
"id": "stakeholder-aer",
"name": "Alberta Energy Regulator",
"type": "organization",
"identifiers": [
{
"scheme": "ca.ab.aer_ba_code",
"value": "A0001"
}
]
}Show 1 more exampleHide the other example
Minimal example: the required fields only
{
"id": "stakeholder-operator"
}Changes and file
Changes
- 0.1.0 First version.
Schema file
Show the JSON SchemaHide the JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://opendevelopmentstandards.org/schema/1.0.0-rc.2/core/Stakeholder.json",
"title": "Stakeholder",
"description": "A stakeholder: a person or organization involved in a development, such as an operator, a consultant, a regulator or a resident.",
"$ref": "Entity.json",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"organization",
"person",
"group"
],
"description": "What sort of stakeholder it is.",
"x-ods-options": [
{
"value": "organization",
"title": "Organization",
"description": "A company, an agency or another body."
},
{
"value": "person",
"title": "Person",
"description": "One person. Their name is personal information."
},
{
"value": "group",
"title": "Group",
"description": "People who act together without being an organization, such as residents of an area."
}
]
}
},
"patternProperties": {
"^x-": {}
},
"unevaluatedProperties": false,
"examples": [
{
"id": "stakeholder-operator"
},
{
"id": "stakeholder-aer",
"name": "Alberta Energy Regulator",
"type": "organization",
"identifiers": [
{
"scheme": "ca.ab.aer_ba_code",
"value": "A0001"
}
]
}
],
"x-ods-status": "draft",
"x-ods-kind": "entity",
"x-ods-module": "core",
"x-ods-changes": {
"0.1.0": "First version."
}
}