{
  "id": "sensor_point",
  "title": "Sensor points",
  "makes": "A setup record: a point the Collector expects, with the event types it raises.",
  "instructions": [
    "One row per point (one thing measured at one asset). Fill the Data sheet; this sheet explains each column.",
    "Leave an optional cell empty when the value is not known. Do not write a guess; write what you know and say where it came from in source.",
    "Lists take several values separated by a semicolon (;).",
    "Ids in a catalogue column must come from MissionSight's catalogue (the Catalogue column below names which list).",
    "If a row does not match, the whole load stops and the report names the row and the column. Nothing is half loaded.",
    "The example row is an example only. It names a made-up airport, Acme County, and is not anyone's data."
  ],
  "columns": [
    {
      "name": "point_id",
      "type": "string",
      "required": true,
      "meaning": "Your id for the point. Unique in the sheet.",
      "example": "ESC-07-RUN",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]*$"
    },
    {
      "name": "asset_id",
      "type": "string",
      "required": true,
      "meaning": "The asset it measures, from the assets sheet.",
      "example": "ESC-07"
    },
    {
      "name": "sensor_type",
      "type": "string",
      "required": true,
      "meaning": "The sensor type.",
      "example": "sensor.oem_escalator_status",
      "ref": "catalogue:sensor_type"
    },
    {
      "name": "event_types",
      "type": "list",
      "required": true,
      "meaning": "The event types the point raises.",
      "example": "vt.escalator.stopped;vt.escalator.running",
      "ref": "catalogue:event_type"
    },
    {
      "name": "point_name",
      "type": "string",
      "required": false,
      "meaning": "The name in the source system (a PLC tag, a BMS point).",
      "example": "ESC07.RunState"
    },
    {
      "name": "protocol",
      "type": "string",
      "required": false,
      "meaning": "How it is read.",
      "example": "Maker cloud API"
    },
    {
      "name": "unit",
      "type": "string",
      "required": false,
      "meaning": "The unit.",
      "example": "",
      "ref": "catalogue:unit"
    },
    {
      "name": "state",
      "type": "enum",
      "required": true,
      "meaning": "Whether the asset reports it today.",
      "example": "reported",
      "values": [
        "reported",
        "needs sensor",
        "to confirm"
      ]
    },
    {
      "name": "source",
      "type": "string",
      "required": true,
      "meaning": "Where this row came from: a system export, a document and page, a walk-down, a person.",
      "example": "Example only: Acme County Airport asset spreadsheet, tab Conveying, row 12"
    }
  ]
}