Topics

Connect Topics Service

Overview

BCF Topics are meant for communication between the construction project members. The communication topics can be, for example issues, requests, questions, or clashes.

BCF stands for BIM Collaboration Format and it is an open industry standard from buildingSMART International. It is adopted by many software applications in the construction industry. Because it’s an open standard, it means that you can share issues between applications that support the standard, using Trimble Connect as the BCF server.

Connect BCF Topics enables model-based communication, which means that you can link your issue directly to a BIM model using 3D viewpoints and links to model objects. However, it’s not a must to have a BIM model to communicate with BCF Topics. You can also create an issue and use other rich communication fields like the description, status, priority, assignees, comments, and document references. Use Connect BCF Topics for example, in design, procurement, construction, and operation phases of your construction project.

The Connect BCF Topics is a data-level service with a REST API and a corresponding .NET SDK. It is part of the Trimble Connect platform.

Use Cases

In general, BCF allows different BIM applications to communicate model-based issues with each other by leveraging BIM models. There are two different ways to utilize BCF; using a file-based exchange or using a web service. The Connect BCF Topics API represents the web service-based (RESTful) API mode for BCF where Trimble Connect acts as the BCF Server enabling project participants to sync the creation, editing, and management of BCF topics in one centralized location.

There are a number of phases in a construction project that can benefit from BCF-enabled workflows, for example:

  • Design - QA/QC, clash checking, annotating
  • Procurement - Bidding coordination
  • Construction - QA/QC of installation vs BIM, tracking
  • Operations - Notations and owner notes

Concepts

When looking at the Connect BCF Topics API, it is good to have a basic understanding of some of the terminology:

  • BCF - BIM Collaboration Format - open industry standard by BuildingSMART (BuildingSmart)
  • Topic - A unit of communication. Each Topic has a type, title, description, status, priority, and assignee(s). A topic can have comments, tags, document reference(s), viewpoint(s), and linked model objects
  • BCF-API - BuildingSMART standard API specification. Connect BCF Topics API supports the standard version 2.1.

Topics API Concepts

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).

Dependencies

Topics exist in the context of a Trimble Connect project. The user must be part of the project to work with project data. The Connect BCF Topics API supports the standard version 2.1.

Getting Started

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

API & SDK

See the API specification.

SDK is available for the following platforms