Asset 📝

Official URL: https://bcgov.github.io/nr-pies/docs/spec/element/data/asset

JSON Schema URL: https://raw.githubusercontent.com/bcgov/nr-pies/refs/heads/main/docs/spec/element/data/asset.schema.json

Standard message asset attributes present for all PIES message data types. All defined attributes are needed for identification and attribution.

Scope

This data type is intended to define all expected attributes required to identify and attribute a message, at minimum. This data structure is not intended for standalone use.

Structure

Name	Cardinality	Type	Description & Constraints
system_id	1..1	Code	A valid CSNR IT Service Management code which identifies the source system, service or asset that the data originates from.
record_id	1..1	string	The record or primary key representing what the data this message is directly associated to.
record_kind	1..1	string	The kind of record the source system stores this record as (for example, Anchor or Permit).

Specification

Schema

Loading ....

Source

{
  "$id": "https://raw.githubusercontent.com/bcgov/nr-pies/refs/heads/main/docs/spec/element/data/asset.schema.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Asset",
  "description": "Represents a set of standardized attributes needed for identification and attribution.",
  "type": "object",
  "properties": {
    "system_id": {
      "type": "string",
      "description": "A valid CSNR IT Service Management code which identifies the source system, service or asset that the data originates from.",
      "pattern": "^ITSM-\\d{4,5}$"
    },
    "record_id": {
      "type": "string",
      "description": "The record or primary key representing what the data this message is directly associated to."
    },
    "record_kind": {
      "type": "string",
      "description": "The kind of record the source system stores this record as (for example, Anchor or Permit).",
      "enum": [
        "Anchor",
        "Permit"
      ]
    }
  },
  "required": [
    "system_id",
    "record_id",
    "record_kind"
  ]
}

Example

{
  "system_id": "ITSM-5917",
  "record_id": "06bc53dc-3e4f-420b-801c-bd9cc0ea01b2",
  "record_kind": "Permit"
}

Implementation Guidance

All asset attributes are mandatory. A valid PIES message datagram must define all of the asset attributes.

References

• Guidelines