Map Metasys equipment to the underlying controller objects via equipment points

Documented steps

1. Locate the equipment instance by walking GET {base}/equipment/tree (Metasys 15.0+) or from a space via GET {base}/spaces/{spaceId}/servingEquipment.
2. GET {base}/equipment/{equipmentId}/points to list that equipment's points. Page with page and pageSize; sort accepts shortName, -shortName, category, -category, isDisplayData, -isDisplayData (default shortName).
3. For each item read: id, itemReference, equipmentName, shortName, label, category, isDisplayData, equipmentUrl, objectUrl, and attribute (a value from attributeEnumSet). On Metasys 15.0+ each item also carries objectReference, the underlying object's FQR.
4. Understand the model: an equipment point is a mapping from a semantic point name to a specific attribute on a specific object. shortName is the semantic name (e.g. a zone temperature); objectUrl plus attribute is where the live value actually lives.
5. Read the value by following objectUrl and appending /attributes/{attribute}, or by resolving objectReference through GET /objects/identifiers?fqr=.
6. Filter to operator-facing points using isDisplayData when you want the same subset the Metasys UI shows rather than every mapped attribute.
7. Go the other direction with GET {base}/objects/{objectId}/points, which lists the equipment points mapped to attributes of a given object. Its sort enum additionally includes equipmentName and -equipmentName.
8. Use GET {base}/equipment/{equipmentId}/spaces to tie equipment back to the spaces it serves for reporting.
9. Reference: https://jci-metasys.github.io/api-landing/api/v6-16 (Metasys REST API, 'Version 6 for 16.0', OpenAPI 3.0.3). Doc set index: https://jci-metasys.github.io/api-landing/ | changelog: https://jci-metasys.github.io/api-landing/guides/api-changelog/ | version support: https://jci-metasys.github.io/api-landing/guides/version-support-matrix/ | polling and streaming limits: https://jci-metasys.github.io/api-landing/guides/attribute-access-guidelines/