This endpoint is used to create a configuration for filtering iModel data based on a view definition or a saved view.
A View renders geometry from one or more Models of an iModel in a web browser. A View is an element of the ViewDefinition class. For more information, see Using Views in iTwin.js.
This transformation is usually leveraged to filter out unnecessary data and align an iModel to the view within a browser window.
Limitations: Saved views are capable of displaying elements while hiding their parent elements. This cannot be achieved by filtering logic because child elements cannot exist without their parent elements within an iModel. To workaround this misalignment between display and filtering logic, the transformations service does not filter out:
- elements that are ancestors of visible child elements
- elements that are scoping ancestors of visible elements
Such elements will remain in iModel with cleared properties, meaning that their geometries and other non mandatory properties will be deleted.
Configuration specific properties explained:
models - ids of enabled/visible models contained within a view definition.
hiddenModels - ids of disabled/hidden models contained within a view definition.
categories - ids of visible enabled/categories contained within a view definition.
hiddenCategories - ids of disabled/hidden categories contained within a view definition.
neverDrawn - element ids which should be left out of the target iModel.
alwaysDrawn - element ids which should be included in to the target iModel.
subCategoryOvr
- subCategory - id of sub category
- invisible - geometry belonging to an invisible subCategory will be left out of target iModel
clip - data needed to create clipping. This cannot be an empty object.
- shapes - array of shape clippings
- points - array of number arrays describing the polygon. Each low level array contains numbers corresponding to coordinates [x, y, z]
- trans - array of number arrays describing the transform applied to the polygon. Each low level array contains four numbers of a transform row [qx, qy, qz, ax].
- zlow - lower bound on Z.
- zhigh - upper bound on Z.
- mask - `true` if this shape is a mask.
- invisible -`true` if this shape is invisible.
- planes - array of plane line clippings
- invisible - `true` if this union of plane clip intersections is invisible.
- clips - a union of plane clip set intersections
- normal - the plane's inward normal as a number array corresponding to coordinates [x, y ,z].
- dist - the plane's distance from the origin.
- invisible - `true` if this plane is invisible.
- interior - `true` if this plane is interior.
perModelCategoryVisibility - array of objects containing perModelCategoryVisibility data
- modelId - id of model for which category override will apply.
- categoryId - id of category for which the override will apply.
- visible - boolean flag indicating if category is visible for the given model.
viewMode - enumerator that specifies the transformation saved view mode. It can have two values: IncludeNewContent and FilterContent.
- IncludeNewContent includes all new content that was introduced into the iModel after the view was created.
- FilterContent filters out all new content that was introduced into the iModel after the view was created.
All ids must be well-formed valid hexadecimal ids conforming with iTwin.js specification.
PerModelCategoryVisibility override affects geometry on all subcategories belonging to the overridden category. That is, if the category is overridden to be visible, then geometry on all subcategories of the category will be visible, regardless of any subCategory overrides.
In addition to exported data, the transformer will also push some additional metadata. This metadata contains:
BisCore:RepositoryLinkandBisCore:ExternalSourceelements that mark the source where the data was imported from.- A "Scope"
BisCore:ExternalSourceAspectthat contains Synchronization changeset metadata that is needed by the transformation service to process any later changes correctly. - Element provenance information (
BisCore:ExternalSourceAspects) for elements that do not have federation guids.
Note: Creating a configuration does not run the transformation. To run the transformation, please see transformations reference.
Authentication
Requires Authorization header with valid Bearer token for scope itwin-platform.
For more documentation on authorization and how to get access token visit OAUTH2 Authorization page.
Authorization
You must have imodels_write assigned at the target project level and imodels_read assigned at the source project level within related configuration. If permissions at the project level are not configured, then you must have same assigned at the iModel level.
Alternatively, you must be an Organization Administrator for the Organization that owns a given project the iModel belongs to.
An Organization Administrator must have at least one of the following roles assigned in User Management: Account Administrator, Co-Administrator, or CONNECT Services Administrator. For more information about User Management see Bentley Communities Licensing, Cloud, and Web Services wiki page.
Rate limits
All iTwin Platform API operations have a rate limit. For more documentation on that visit Rate limits and quotas page.