Executes an existing Smart 3D filter object and returns the resulting objects. The filter must exist in the Plant Filters or Catalog Filters folder in the Smart 3D database. The filter cannot be in My Filters. The URL to execute this action is similar to:
POST https://MyServer.Domain.com/s3d/v1/Sites('MySiteAlias')/Plants('MyPlant')/S3dFilters('{0000272E-0000-0000-0300-8F1F455B1706}')/Com.Ingr.Smart3d.V1.ExecuteS3dFilter
Where {0000272E-0000-0000-0300-8F1F455B1706} is the OID of the filter being executed. Smart 3D filters implement the Smart API Parametric Filters Protocol. Therefore, the body of this request must contain a JavaScript object that adheres to this protocol (empty "{}" if no parameters are required by filter). ODATA query options, aside from $filter, are supported on the ExecuteS3dFilter action; however, they go in the body of the POST action as declared by the protocol.
An example of parameters for executing a parametric filter that requires inputs for:
-
A value for the Approval Status property.
-
One or more Assembly parents.
-
One or more System parents.
-
One or more object types.
Smart 3D Web API uses a more efficient algorithm and your data is returned faster when ExecuteS3dFilter
is invoked with a "$select=Id" queryExpression and no $expand or $orderby clauses.