Data modeling status for CDF projects

Every Cognite Data Fusion (CDF) project has a data modeling status, stored as dataModelingStatus. The status controls whether the project can use asset-centric APIs, and how applications store and show data. The data modeling status applies to all users in the project. To change the data modeling status for a CDF project, contact your Cognite representative.

DATA_MODELING_ONLY is the default status. Use it for new projects and after you upgrade a project to data modeling. Asset-centric write APIs for assets, annotations, and relationships are blocked, and applications use data modeling concepts such as spaces and instances.
HYBRID is only for legacy projects. It keeps asset-centric APIs and workflows available while you upgrade to data modeling.

Understanding each status

The status changes what you can configure, and what each application shows.

Application or service	DATA_MODELING_ONLY	HYBRID
Group capabilities	You can’t add `assets:write`, `annotations:write`, `annotations:review`, `annotations:suggest`, or `relationships:write` to a group. CDF blocks write operations on the asset-centric assets, annotations, and relationships APIs.	You can use all capability sets.
InField	InField opens the data modeling version of the application.	InField opens the asset-centric version of the application.
Charts	Scheduled calculations create a CogniteTimeSeries in a space. Charts hides events.	Scheduled calculations create a time series in a data set. Charts shows events.
Canvas	Dropping a file on a canvas creates an instance in a space you choose. You can only find and add data modeling resources.	Dropping a file on a canvas creates a file in a data set you choose. You can find and add both asset-centric and data modeling resources.
Search	You can find only data modeling resources.	You can find both asset-centric and data modeling resources. Location filters can limit a location to asset-centric resources, data modeling resources, or both.
3D	3D data uses the core data model. You can contextualize only core data model assets. Automatic text detection in 360° images is available.	You can contextualize CAD models to asset-centric assets and to core data model assets. Contextualization for 360° images and point clouds is not available. Automatic tag detection in 360° images is not available.
Diagram parsing	Diagram parsing stores annotations as `CogniteDiagramAnnotation`. Tag detection is generally available. Symbol detection is in public preview.	Diagram parsing stores annotations with the Annotations API.
Entity matching	CDF doesn’t provide a user interface. The API works with data modeling.	CDF provides a user interface.
Data catalog	The API works with data modeling.	CDF provides a user interface.

To preview DATA_MODELING_ONLY behavior for 3D in a HYBRID project, turn on the read-only override described in Verify migrated 360° images. Treat the 3D user interface as read-only while the override is on. Leave the override off when you finish.

Why only some APIs and experiences are restricted

DATA_MODELING_ONLY restricts only some asset-centric APIs and application experiences. The restriction safeguards the user experience against unintended issues caused by remaining data dependencies. Cognite will resolve those dependencies gradually and tighten the restrictions as each dependency is removed. Write access is blocked today for assets, annotations, and relationships. In data modeling, assets map to types in the core data model, diagram parsing annotations map to CogniteDiagramAnnotation, and relationships map to direct relations and edges. Events, sequences, files, and time series stay available. In a DATA_MODELING_ONLY project, files and time series reference instances instead of assets.

The migration plugin upgrades an asset-centric project to data modeling.
Configure InField on CDM sets up InField for a data modeling project.
The 3D contextualization APIs cover contextualization in a data modeling project.
Assign capabilities lists the capabilities you can add to a group.

​Understanding each status

​Why only some APIs and experiences are restricted

​Related pages

Understanding each status

Why only some APIs and experiences are restricted

Related pages