{
  "id": "contact_role",
  "title": "Contacts and roles",
  "makes": "A setup record: a role that alerts and tickets route to.",
  "instructions": [
    "One row per role (who is told, who maintains). 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.",
    "Keep personal phone numbers and emails out of this sheet where a role address will do. The sheet is stored as an original."
  ],
  "columns": [
    {
      "name": "role_id",
      "type": "string",
      "required": true,
      "meaning": "The role id alert routes use.",
      "example": "vt_contractor",
      "pattern": "^[a-z][a-z0-9_]*$"
    },
    {
      "name": "role_name",
      "type": "string",
      "required": true,
      "meaning": "The role's name.",
      "example": "Escalator maintenance contractor"
    },
    {
      "name": "organisation",
      "type": "string",
      "required": true,
      "meaning": "Who fills it.",
      "example": "Example Lifts Ltd"
    },
    {
      "name": "contact",
      "type": "string",
      "required": false,
      "meaning": "A role address (a shared mailbox, a duty phone). Prefer a role to a person.",
      "example": "role:vt_contractor"
    },
    {
      "name": "asset_classes",
      "type": "list",
      "required": false,
      "meaning": "The asset classes it covers.",
      "example": "vt.escalator;vt.elevator",
      "ref": "catalogue:asset_class"
    },
    {
      "name": "asset_ids",
      "type": "list",
      "required": false,
      "meaning": "The assets it covers, from the assets sheet.",
      "example": "ESC-07"
    },
    {
      "name": "escalates_to",
      "type": "string",
      "required": false,
      "meaning": "The role_id told next if nobody acknowledges.",
      "example": "terminal_duty_manager"
    },
    {
      "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"
    }
  ]
}