Model Feature

Overview

Model Feature Service provides easy access to Organizer groups in the context of a Trimble Connect project. The initial release allows read access to both Manual and Rule-based Organizer groups in the context of a project to enable automated consumption of this data.

Creating, updating, and deleting Organizer groups is still done using the Trimble Connect for Browser application. The feature set provided by the service will grow over time.

For low-level/write access to Organizer groups or non-project use cases, see the Organizer service.

Use Cases

A typical use case within the Trimble Connect ecosystem is grouping construction objects in BIM models into breakdown structures. Examples include:

• Location breakdown structures
• Object property-based breakdown structures (for example, type, material)
• Work packages

Concepts

On the top level of the organized data are the groups. They can have subgroups. Each subgroup can have subgroups and a set of links, each link identifies a data, most commonly a model entity.

Information in the Manual Groups is static. Users can create subgroups and add/remove links and every modification has to be done manually.

The Rule-Based Groups follow a different approach. The group collects data from a set of models and has a set of rules that describe how to subgroups should be created and which objects should be linked to the subgroups. Users don’t have to create subgroups and add links manually, this is done automatically based on the rules. All they have to do is to trigger a re-computation of the group.

Regions

Trimble Connect offers regional API endpoints that you can use to make your requests. The resources in each region are independent of similar resources in other regions. Each Trimble Connect project is hosted in a specific region, therefore all data in the project must be accessed through that regional API endpoint (see /regions API).

Getting Started

You need to complete the steps in the Getting Started guide to be able to call the API.

API

See the API specification.

Additional Links

• Connect Model Feature API announcement (Community)