Configure location filters

You can configure location filters using the CDF interface or the Cognite Toolkit. How you set up the location filters depends on how your data is stored and structured in the CDF project.

notă

If you're creating a hierarchy of parent-child locations, all the locations within the hierarchy must be part of the same asset sub-tree.

Before you start

• Use the locationfilters access capability to manage access to configure and view location filters. Follow the instructions in Assign capabilities to provide access to the underlying data.

• To see 3D content for a location, set up scenes for the 3D content. When you filter on a location, the 3D scene displays in the 3D view.

Set up filters with the CDF interface

Early adopter

The features described in this section are currently only available to customers via our Early Adopter groups. For more information and to sign up, visit the Manage location filters group on the Cognite Hub.

1. Navigate to the Admin workspace > Project settings > Locations > Manage locations.

2. Select Add and enter a descriptive location name.

3. Select a parent if you're creating a hierarchy of parent-child locations. If you define multiple locations, CDF uses an OR operator between them.

4. Link the location to the 3D scene you want to display in the 3D view for the location.

5. Under Filter on resource types, select Resources if the data is modeled with resource types in an asset-centric data model. Otherwise, select Data models.

   • Resources: specify data sets, asset sub-trees, or external ID prefixes for asset-centric resources, such as assets, events, files, time series, and sequences.

     Note

     Be careful if you're specifying both asset sub-trees or data sets. CDF uses an AND operator between these, which may cause unexpected behavior.

   • Data models: specify data models, data model versions, and data model spaces.

   • Instance spaces: specify instance spaces.

6. Save the settings and test the location filters from the CDF home page.

Set up filters with the Cognite Toolkit

See the Cognite Toolkit articles for information about configuring, deploying, and managing location filters as part of a CI/CD pipeline.