User list
User list is one of Demiton's published registers for Australian civil construction. Users in your identity directory and operational systems. Demiton keeps it current from the systems a contractor already runs and publishes the record's shape as a versioned JSON Schema, so the same question works whichever system produced the record.
Part of Counterparties in the register catalog.
- Register ID
user_listUse this name to ask for the register. The API calls it a shelf ID.- Each record is
- A stateThe current value of something, replaced when it changes.
- Status
- AvailableFilled today from connected systems, uploads or public data.
- Data
- OrganisationPrivate to each organisation's own workspace.
- Version
- v1 (1.0.3)Current version.
Standards
This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.
- Fair Work Act 2009Fair Work Regulations 2009 - employee record content
- Privacy Act 1988Privacy Act 1988 - Australian Privacy Principles; employee-records exemption; health information s.6FA
- Single Touch PayrollSingle Touch Payroll Phase 2 employer reporting guidelines
- GDPRGeneral Data Protection Regulation
- ISO 30414Human resource management - Requirements and recommendations for human capital reporting and disclosure
- Privacy Act 2020 (NZ)Privacy Act 2020 and Health Information Privacy Code 2020
- UK GDPRUK GDPR and Data Protection Act 2018
Connectors
Connected today
Demiton keeps this register current from these systems now.
On the roadmap
Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.
- EROADPartial
- Geotab
- HammerTech
- MapTrack
- Mitti
- MYOB BusinessPartial
- Oracle Aconex
- PayappsPartial
- Procore
- SitematePartial
- Xero AccountingPartial
- Xero Payroll AUPartial
Fields
12 fields: 3 required, 9 optional.
Required
Every record carries these fields.
- display_nameText
The person's display name.
Example:
Aaron Patel- worker_entity_idWhole number
Demiton canonical worker spine node this fact anchors to (the subject)
Example:
5501- source_external_idText
The raw record id in the producing system, scoped to
source_systemExample:
a1b2c3d4-0001-4a2b-9c3d-000000000001
Optional
Present when the source system records them.
- emailText
Email address used as the cross-source identity bridge.
Example:
aaron.patel@example.com- phoneText
Contact phone number.
- job_titleText
Role/job title in the owning organisation.
Example:
Site Supervisor- departmentText
Organisational unit the account belongs to.
Example:
Operations- identity_kindText
The source's own classification of the account, where it exposes one.
- work_locationText
Location associated with the account (city/site/suburb)
- account_enabledTrue or false
Whether the source account is currently enabled/active.
Example:
true- source_created_atDate and time
When the source record was created (freshness)
- user_principal_nameText
Directory sign-in name (Entra UPN)
Example:
aaron.patel@bridgeworksgroup.example.com
Example record
A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.
{ "account_enabled": true, "department": "Operations", "display_name": "Aaron Patel", "email": "aaron.patel@example.com", "job_title": "Site Supervisor", "source_external_id": "a1b2c3d4-0001-4a2b-9c3d-000000000001", "source_system": "SHAREPOINT", "user_principal_name": "aaron.patel@bridgeworksgroup.example.com", "worker_entity_id": 5501}Use this contract
The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.
https://docs.demiton.io/registers/user_list/v1.jsonShow the full JSON Schema
Loading the schema…
Talk to the team
Tell us what you run - your ERP, field, payroll and document systems - and we will show you the registers Demiton would fill from them, on your data, in a 30-minute call.