BCF Topic

Catenda Topics are BCF compliant Topics with additional properties to support Catenda specific features. Topics belong to Topic Boards but additionally Topic Boards belong to Catenda projects.

Catenda extensions

Catenda provides additional APIs and fields that are not part of the BCF standard, but are provided to make it easier to work with BCF. Usually these fields will be prefixed by bimsync_. For example bimsync_comments_size provides the number of comments in a topic.

Additional APIs:

  • Topic board statuses
  • Topic board types
  • Topic board users
  • Importing BCF files
  • Exporting BCF topics
  • Topic linked IFC entities
  • Topic points
  • Topic viewpoint models

Migration

We recommend using BCF 3.0 as it is the latest version and has the most features.

Migrating to a higher version of BCF may require changes in your application. In general migrating will add new features and fields but some differences are described below.

Migrating from BCF version 2.0 to 2.1

  • The upload snapshot endpoint https://api.catenda.com/opencde/bcf/2.0/projects/{topic-board-id}/topics/{topic-id}/viewpoints/{viewpoint-id}/snapshot has been removed. Include the snapshot when creating the topic viewpoint instead.
  • When creating a comment, the status and verbal_status fields have been removed. Update topics directly instead.

Migrating from BCF version 2.1 to 3.0

  • When creating a viewpoint, the required camera field aspect_ratio has been added.

Always refer to the official BCF documentation for the latest changes.

Updated 18 Jun 2024
Did this page help you?