Skip to main content

Density Serraview Integration

Emily Tallon
  • Updated

Density integrates with Serraview so that Density space metadata (space names and capacities) stays in sync with Serraview space metadata.

Getting started

Density uses the Serraview Core API to sync space metadata. To get started, please share a Serraview Core API token with the Density team. Once a Serraview integration is configured, all spaces with an IWMS ID will sync with the Serraview system.

How does the integration work?

Each Density space, floor, or building has a globally unique space ID. Each space ID can be mapped to an IWMS ID (integrated workplace management system ID, e.g., Serraview ID). Once a space has a valid IWMS ID, Density will sync the space’s name and capacity every 24 hours with the corresponding Serraview fields. Density consumes the buildings, floors, and spaces endpoints in Serraview.

When space updates are made, Density will notify select users of the IWMS updates that have been completed. If you’d like to be added to this list, please reach out to your CSM or  support@density.io.

Mapping spaces in bulk

You can import space mappings in bulk by sharing a Space Mappings File with Density (please use this template). This mappings file must have the following fields:

  • Density Space ID (can be exported via CSV from Density Atlas)
  • Serraview Space ID

Note that the same Serraview ID for a space, floor, or building cannot be mapped to multiple Density Space IDs for a space, floor, or building (respectively).

Alerts on floor plan changes

Density will alert when a space has been added or deleted on a floor plan. Once a space is added or deleted, the Density team will verify whether a floor plan update is needed and request floor plans from your team.

FAQ

  • What happens if a floor plan changes?
    • The Density Serraview sync does not automatically update floor plans if a space is added or deleted. However, the sync will alert Density and your users when a space is added or removed. The Density team will then inspect the changes and request new floor plans if necessary.
  • Do you sync space labels or functions?
    • No. Space labels and functions are not currently synced with Serraview.
  • What capacity field do you use when you sync a space, floor, or building?
    • We use the “capacity” field in the API response for the spaces, floors, and buildings endpoints.
  • What if there is no capacity from the Serraview API?
    • The capacity field for a space will not be synced if a space does not have a capacity from the Serraview API. Capacities for these spaces will continue to be user-editable.
  • How do we know when a space was last synced with Serraview?
    • We are working on adding this into Atlas. In the interim, please reach out to support@density.io or your Customer Success Manager.
  • What is an example Serraview API response for spaces, floors, and buildings?
Space:

{    

      "id": 202564,

      "name": "Test",

      "buildingId": 319,

      "floorId": 813,

      "isReserveDisabled": true,

      "isFlexible": false,

      "spaceType": {

        "id": 11320,

        "name": "Phone Room"

      },

      "assignedOrgUnit": null,

      "capacity": 1,

      "zone": {

        "id": 200254,

        "name": "28"

      },

      "customFields": {

        "MeetingRoomEmail": "cr-test@customer.com",

        "VC": "No",

        "Bookable": "No",

        "DropIn": "Yes",

        "Restricted": "No",

        "Interview": "No",

        "SyncwithAD": "Yes",

        "RestrictedRoomContact": "Not Available"

      },

      "tags": [],

      "occupants": [],

      "retentionStatusId": null,

      "manualOccupancyTypeId": 6073,

      "coordinates": {

        "x": 1873.296,

        "y": 502.1846

      }

    }




Floor:

{

    "id": 720,

    "name": "01",

    "sequence": 1,

    "buildingId": 336,

    "businessKey": null,

    "buildingNumberOverride": null,

    "nla": 0.0,

    "gla": 0.0,

    "showInVBS": true,

    "showInMapping": true,

    "showInWayfinding": true,

    "showInFloorplansPage": true

  },




Building:

{ 

      "id": 168,

      "name": "Building1",

      "shortName": "",

      "buildingNumber": "HDQ4",

      "region": {

        "id": 12474,

        "name": "Chicago"

      },

      "showInVBS": true,

      "showInMapping": true,

      "showInWayfinding": true,

      "showInPortfolioDashboard": true,

      "showInFloorplansPage": true,

      "buildingType": {

        "id": 12859,

        "name": "Direct Lease"

      },

      "country": "United States",

      "state": "IL",

      "city": "Chicago",

      "street": "123 Main Street",

      "postcode": "60661",

      "latitude": 43.880226750,

      "longitude": -88.640386888

    },

Related articles