Interface IAssemblies
Gives access to assemblies.
Namespace: TopSolid.Cad.Design.Automating
Assembly: TopSolid.Cad.Design.Automating.dll
Syntax
[ServiceContract]
[AvailableSinceVersion(7, 6, 0, 0)]
public interface IAssemblies
Remarks
This interface is available since v7.6.
Methods
AskOccurrence(UserQuestion, Boolean, Boolean, Boolean, Boolean, Boolean, ElementId, out ElementId)
Asks the user for a part or an assembly occurrence.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 10, 0, 0)]
UserAnswerType AskOccurrence(UserQuestion inQuestion, bool inAcceptsPositioned, bool inAcceptsInPlace, bool inAcceptsPart, bool inAcceptsAssembly, bool inAcceptsMechanism, ElementId inSuggestion, out ElementId outAnswer)
Parameters
| Type | Name | Description |
|---|---|---|
| UserQuestion | inQuestion | Question asked to the user. |
| System.Boolean | inAcceptsPositioned | Accepts positioned occurrence. |
| System.Boolean | inAcceptsInPlace | Accepts in-place occurrence. |
| System.Boolean | inAcceptsPart | Accepts part occurrence. |
| System.Boolean | inAcceptsAssembly | Accepts assembly occurrence. |
| System.Boolean | inAcceptsMechanism | Accepts mechanism occurrence. |
| ElementId | inSuggestion | Suggested answer, or Empty if none. |
| ElementId | outAnswer | User answer, or Empty if none. |
Returns
| Type | Description |
|---|---|
| UserAnswerType | Type of user answer. |
Remarks
Only occurrences that are directly in the parts folder of the document may be obtained by this method, not "deep" occurrences that are inside them.
This method is available since v7.10.
CreateDisassembly(ElementId, Boolean)
Creates the disassembly operation of an assembly entity.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 17, 300, 80)]
ElementId CreateDisassembly(ElementId inAssemblyId, bool inInheritsAuxiliaryElements)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inAssemblyId | Identifier of the assembly entity to modify. |
| System.Boolean | inInheritsAuxiliaryElements | Tells wehter auxiliary elements must be inherited. |
Returns
| Type | Description |
|---|---|
| ElementId | The created disassembly operation. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.17.
CreateFixedConstraint(ElementId)
Creates a fixed constraint of a positioning.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 15, 400, 120)]
ElementId CreateFixedConstraint(ElementId inOccurrenceId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inOccurrenceId | Identifier of the occurrence of the part or assembly to fix. |
Returns
| Type | Description |
|---|---|
| ElementId | Identifier of the created constraint. |
Remarks
This method is available since v7.15.400.120.
CreateFrameOnFrameConstraint(ElementId, SmartFrame3D, SmartFrame3D, SmartReal, Boolean, SmartReal, Boolean, SmartReal, Boolean, SmartReal, Boolean, Boolean)
Creates a "frame on frame" positioning constraint.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
ElementId CreateFrameOnFrameConstraint(ElementId inPositioningId, SmartFrame3D inSourceFrame, SmartFrame3D inDestinationFrame, SmartReal inOffsetDistance, bool inIsOffsetReversed, SmartReal inXRotationAngle, bool inIsXRotationReversed, SmartReal inYRotationAngle, bool inIsYRotationReversed, SmartReal inZRotationAngle, bool inIsZRotationReversed, bool inRotatesZYX)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inPositioningId | Identifier of the positioning operation that will contain the constraint. |
| SmartFrame3D | inSourceFrame | Frame on source occurrence. |
| SmartFrame3D | inDestinationFrame | Destination frame. |
| SmartReal | inOffsetDistance | Offset distance of the source frame along the destination frame Z direction. |
| System.Boolean | inIsOffsetReversed | Whether the offset is reversed. |
| SmartReal | inXRotationAngle | Rotation angle of the source frame around its X axis. |
| System.Boolean | inIsXRotationReversed | Whether the rotation around X is reversed. |
| SmartReal | inYRotationAngle | Rotation angle of the source frame around its Y axis. |
| System.Boolean | inIsYRotationReversed | Whether the rotation around Y is reversed. |
| SmartReal | inZRotationAngle | Rotation angle of the source frame around its Z axis. |
| System.Boolean | inIsZRotationReversed | Whether the rotation around Z is reversed. |
| System.Boolean | inRotatesZYX | Rotates around Z then Y then X instead of X then Y then Z. |
Returns
| Type | Description |
|---|---|
| ElementId | Identifier of the created constraint. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.8.
CreateFrameOnFrameConstraintWithXYOffsets(ElementId, SmartFrame3D, SmartFrame3D, SmartReal, Boolean, SmartReal, Boolean, SmartReal, Boolean, SmartReal, Boolean, SmartReal, Boolean, SmartReal, Boolean, Boolean)
Creates a "frame on frame" positioning constraint with X and Y offsets.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 9, 0, 0)]
ElementId CreateFrameOnFrameConstraintWithXYOffsets(ElementId inPositioningId, SmartFrame3D inSourceFrame, SmartFrame3D inDestinationFrame, SmartReal inXOffsetDistance, bool inIsXOffsetReversed, SmartReal inYOffsetDistance, bool inIsYOffsetReversed, SmartReal inZOffsetDistance, bool inIsZOffsetReversed, SmartReal inXRotationAngle, bool inIsXRotationReversed, SmartReal inYRotationAngle, bool inIsYRotationReversed, SmartReal inZRotationAngle, bool inIsZRotationReversed, bool inRotatesZYX)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inPositioningId | Identifier of the positioning operation that will contain the constraint. |
| SmartFrame3D | inSourceFrame | Frame on source occurrence. |
| SmartFrame3D | inDestinationFrame | Destination frame. |
| SmartReal | inXOffsetDistance | Offset distance of the source frame along the destination frame X direction. |
| System.Boolean | inIsXOffsetReversed | Whether the X offset is reversed. |
| SmartReal | inYOffsetDistance | Offset distance of the source frame along the destination frame Y direction. |
| System.Boolean | inIsYOffsetReversed | Whether the Y offset is reversed. |
| SmartReal | inZOffsetDistance | Offset distance of the source frame along the destination frame Z direction. |
| System.Boolean | inIsZOffsetReversed | Whether the Z offset is reversed. |
| SmartReal | inXRotationAngle | Rotation angle of the source frame around its X axis. |
| System.Boolean | inIsXRotationReversed | Whether the rotation around X is reversed. |
| SmartReal | inYRotationAngle | Rotation angle of the source frame around its Y axis. |
| System.Boolean | inIsYRotationReversed | Whether the rotation around Y is reversed. |
| SmartReal | inZRotationAngle | Rotation angle of the source frame around its Z axis. |
| System.Boolean | inIsZRotationReversed | Whether the rotation around Z is reversed. |
| System.Boolean | inRotatesZYX | Rotates around Z then Y then X instead of X then Y then Z. |
Returns
| Type | Description |
|---|---|
| ElementId | Identifier of the created constraint. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.9.
CreateInclusion(DocumentId, ElementId, String, DocumentId, String, List<String>, List<SmartObject>, Boolean, ElementId, ElementId, Boolean, Boolean, Boolean, Boolean, Transform3D, Boolean)
Creates an inclusion operation in a document.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 7, 0, 0)]
ElementId CreateInclusion(DocumentId inDocumentId, ElementId inPositioningId, string inOccurrenceName, DocumentId inDefinitionId, string inCode, List<string> inDriverNames, List<SmartObject> inDriverValues, bool inAutomaticallyFillsRepresentations, ElementId inConfigurationId, ElementId inRigidGroupId, bool inIsRigid, bool inInheritsRigidGroups, bool inInheritsJoints, bool inInheritsForces, Transform3D inTransform, bool inIsFixed)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of the document to modify. |
| ElementId | inPositioningId | Identifier of the positioning operation that will contain the inclusion, or Empty for creating a new one. |
| System.String | inOccurrenceName | Occurrence name, or null if none. |
| DocumentId | inDefinitionId | Identifier of the definition document of the part or assembly or family to include. |
| System.String | inCode | Instance code, or null if none. |
| System.Collections.Generic.List<System.String> | inDriverNames | Instance driver names, or null if none. |
| System.Collections.Generic.List<SmartObject> | inDriverValues | Instance driver values, or null if none. |
| System.Boolean | inAutomaticallyFillsRepresentations | Automatically fills assembly representations with corresponding representations of mechanical document to include. |
| ElementId | inConfigurationId | Identifier of the configuration to use when including a mechanism assembly, or Empty otherwise. |
| ElementId | inRigidGroupId | Identifier of the rigid group in which to put new node entity, or Empty otherwise. |
| System.Boolean | inIsRigid | Whether to make a rigid inclusion when including a mechanism sub-assembly. |
| System.Boolean | inInheritsRigidGroups | Whether to inherit sub-assembly rigid groups (when |
| System.Boolean | inInheritsJoints | Whether to inherit sub-assembly joints (when |
| System.Boolean | inInheritsForces | Whether to inherit sub-assembly forces (when |
| Transform3D | inTransform | Transformation to apply. |
| System.Boolean | inIsFixed | Whether to fix the result of the inclusion. |
Returns
| Type | Description |
|---|---|
| ElementId | Identifier of the created inclusion operation. |
Remarks
Code is not null if document to include is a family which has a catalog.
Driver names and values are not null if document to include is a family which has drivers. In this case, driver names and values must match.
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.7.
Automatic creation of the positioning by specifying inPositioningId = Empty is available since v7.8.
CreateInclusion2(DocumentId, ElementId, String, DocumentId, String, List<String>, List<SmartObject>, List<String>, List<SmartDesignObject>, Boolean, ElementId, ElementId, Boolean, Boolean, Boolean, Boolean, Transform3D, Boolean)
Creates an inclusion operation in a document.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 17, 0, 0)]
ElementId CreateInclusion2(DocumentId inDocumentId, ElementId inPositioningId, string inOccurrenceName, DocumentId inDefinitionId, string inCode, List<string> inKernelDriverNames, List<SmartObject> inKernelDriverValues, List<string> inDesignDriverNames, List<SmartDesignObject> inDesignDriverValues, bool inAutomaticallyFillsRepresentations, ElementId inConfigurationId, ElementId inRigidGroupId, bool inIsRigid, bool inInheritsRigidGroups, bool inInheritsJoints, bool inInheritsForces, Transform3D inTransform, bool inIsFixed)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of the document to modify. |
| ElementId | inPositioningId | Identifier of the positioning operation that will contain the inclusion, or Empty for creating a new one. |
| System.String | inOccurrenceName | Occurrence name, or null if none. |
| DocumentId | inDefinitionId | Identifier of the definition document of the part or assembly or family to include. |
| System.String | inCode | Instance code, or null if none. |
| System.Collections.Generic.List<System.String> | inKernelDriverNames | Instance kernel driver names, or null if none. |
| System.Collections.Generic.List<SmartObject> | inKernelDriverValues | Instance kernel driver values, or null if none. |
| System.Collections.Generic.List<System.String> | inDesignDriverNames | Instance design driver names, or null if none. |
| System.Collections.Generic.List<SmartDesignObject> | inDesignDriverValues | Instance design driver values, or null if none. |
| System.Boolean | inAutomaticallyFillsRepresentations | Automatically fills assembly representations with corresponding representations of mechanical document to include. |
| ElementId | inConfigurationId | Identifier of the configuration to use when including a mechanism assembly, or Empty otherwise. |
| ElementId | inRigidGroupId | Identifier of the rigid group in which to put new node entity, or Empty otherwise. |
| System.Boolean | inIsRigid | Whether to make a rigid inclusion when including a mechanism sub-assembly. |
| System.Boolean | inInheritsRigidGroups | Whether to inherit sub-assembly rigid groups (when |
| System.Boolean | inInheritsJoints | Whether to inherit sub-assembly joints (when |
| System.Boolean | inInheritsForces | Whether to inherit sub-assembly forces (when |
| Transform3D | inTransform | Transformation to apply. |
| System.Boolean | inIsFixed | Whether to fix the result of the inclusion. |
Returns
| Type | Description |
|---|---|
| ElementId | Identifier of the created inclusion operation. |
Remarks
Code is not null if document to include is a family which has a catalog.
Driver names and values are not null if document to include is a family which has drivers. In this case, driver names and values must match.
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.17.
Automatic creation of the positioning by specifying inPositioningId = Empty is available since v7.8.
CreatePositioning(DocumentId)
Creates a positioning operation in a document.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 6, 0, 0)]
ElementId CreatePositioning(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of the document to modify. |
Returns
| Type | Description |
|---|---|
| ElementId | Identifier of the created positioning operation. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.6.
DerivePartForModification(ElementId, Boolean)
Derives a part for modification in an assembly.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 10, 0, 0)]
DocumentId DerivePartForModification(ElementId inOccurrenceId, bool inUseDefaultTemplate)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inOccurrenceId | Identifier of the occurrence of the part to derive in the assembly document. |
| System.Boolean | inUseDefaultTemplate | Tells whether to use the default template if present. |
Returns
| Type | Description |
|---|---|
| DocumentId | Derived part document identifier. |
Remarks
The occurrence of the part must be in the parts folder of the assembly, or at the first level of an assembly occurrence that is in the parts folder of the assembly (in which case a derived sub-assembly will also be created).
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.10.
GetAssemblyCenterOfMassManagement(DocumentId)
Tells whether the physical property management of an assembly is center of mass managed.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
bool GetAssemblyCenterOfMassManagement(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The physical property management is center of mass managed. |
Remarks
This method is available since v7.13.300.220.
GetAssemblyMassManagement(DocumentId)
Tells whether the physical property management of an assembly is mass managed.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
bool GetAssemblyMassManagement(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The physical property management is mass managed. |
Remarks
This method is available since v7.13.300.220.
GetAssemblyMomentsOfInertiaManagement(DocumentId)
Tells whether the physical property management of an assembly is moments of inertia managed.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
bool GetAssemblyMomentsOfInertiaManagement(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The physical property management is moments of inertia managed. |
Remarks
This method is available since v7.13.300.220.
GetAssemblyStrictMode(DocumentId)
Tells whether the physical property management of an assembly is strict.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
bool GetAssemblyStrictMode(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The physical property management is strict. |
Remarks
This method is available since v7.13.300.220.
GetAssemblySurfaceAreaManagement(DocumentId)
Tells whether the physical property management of an assembly is surface area managed.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
bool GetAssemblySurfaceAreaManagement(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The physical property management is surface area managed. |
Remarks
This method is available since v7.13.300.220.
GetAssemblyVolumeManagement(DocumentId)
Tells whether the physical property management of an assembly is volume managed.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
bool GetAssemblyVolumeManagement(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The physical property management is volume managed. |
Remarks
This method is available since v7.13.300.220.
GetBom(DocumentId)
Gets BOM contents.
Declaration
[Obsolete("Since v7.12, access to BOM is done using IBoms interface.")]
[OperationContract]
[AvailableSinceVersion(7, 6, 0, 0)]
BomRoot GetBom(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of BOM document to analyze. |
Returns
| Type | Description |
|---|---|
| BomRoot | BOM contents. |
Remarks
This method is available since v7.6.
GetCollisionsManagement(DocumentId, out ElementId, out Boolean, out Boolean, out Boolean)
Gets the collisions management of an assembly.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
void GetCollisionsManagement(DocumentId inDocumentId, out ElementId outRepresentationId, out bool outFindsIntersections, out bool outExcludesThreadingTapping, out bool outIsRefreshAuto)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
| ElementId | outRepresentationId | Identifier of the analyzed representation entity, or empty if there is no collisions management. |
| System.Boolean | outFindsIntersections | Whether to find collisions intersections. |
| System.Boolean | outExcludesThreadingTapping | Whether to exclude threading-tapping collisions. |
| System.Boolean | outIsRefreshAuto | Whether refresh is automatic. |
Remarks
This method is available since v7.8.
GetDriversFromFamily(DocumentId, out String, out List<String>, out List<SmartObject>, out List<String>, out List<SmartDesignObject>)
Get code and drivers from a family document
Declaration
[OperationContract]
[AvailableSinceVersion(7, 19, 0, 0)]
void GetDriversFromFamily(DocumentId inDocumentId, out string outCode, out List<string> outKernelDriverNames, out List<SmartObject> outKernelDriverValues, out List<string> outDesignDriverNames, out List<SmartDesignObject> outDesignDriverValues)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of the family document. |
| System.String | outCode | Default code, or null if none. |
| System.Collections.Generic.List<System.String> | outKernelDriverNames | Generic document kernel driver names, or null if none. |
| System.Collections.Generic.List<SmartObject> | outKernelDriverValues | Generic document kernel driver values, or null if none. |
| System.Collections.Generic.List<System.String> | outDesignDriverNames | Generic document design driver names, or null if none. |
| System.Collections.Generic.List<SmartDesignObject> | outDesignDriverValues | Generic document design driver values, or null if none. |
Remarks
This method is available since v7.19.
GetDriverSubFolderName(ElementId, String)
Gets the name of the driver sub folder.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 17, 0, 0)]
string GetDriverSubFolderName(ElementId inElementId, string inDriverName)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation. |
| System.String | inDriverName | Instance driver names. |
Returns
| Type | Description |
|---|---|
| System.String | The name of the sub-folder. |
Remarks
This method is available since v7.17.
GetFunctionsInheritingOperation(ElementId, out ElementId, out List<ElementId>, out List<ElementId>)
Gets a functions inheriting operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
void GetFunctionsInheritingOperation(ElementId inOperationId, out ElementId outOccurrenceId, out List<ElementId> outFunctionIds, out List<ElementId> outChildIds)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inOperationId | Identifier of the functions inheriting operation to analyze. |
| ElementId | outOccurrenceId | Identifier of the occurrence of the part or assembly providing the functions to inherit. |
| System.Collections.Generic.List<ElementId> | outFunctionIds | Identifiers of the specified function entities to inherit from in the occurrence definition document. |
| System.Collections.Generic.List<ElementId> | outChildIds | Identifiers of the children provided functions. |
Remarks
This method is available since v7.8.
GetInclusionChildOccurrence(ElementId)
Gets the part or assembly occurrence entity generated by an inclusion operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
ElementId GetInclusionChildOccurrence(ElementId inElementId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation to analyze. |
Returns
| Type | Description |
|---|---|
| ElementId | Identifier of the part or assembly occurrence entity generated by the inclusion operation. |
Remarks
This method is available since v7.8.
GetInclusionCodeAndDrivers(ElementId, out String, out List<String>, out List<SmartObject>)
Gets the code and drivers of a family inclusion operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 10, 0, 0)]
void GetInclusionCodeAndDrivers(ElementId inElementId, out string outCode, out List<string> outDriverNames, out List<SmartObject> outDriverValues)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation to analyze. |
| System.String | outCode | Instance code, or null if none. |
| System.Collections.Generic.List<System.String> | outDriverNames | Instance driver names, or null if none. |
| System.Collections.Generic.List<SmartObject> | outDriverValues | Instance driver values, or null if none. |
Remarks
This method is available since v7.10.
GetInclusionCodeAndDrivers2(ElementId, out String, out List<String>, out List<SmartObject>, out List<String>, out List<SmartDesignObject>)
Gets the code and drivers of a family inclusion operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 17, 0, 0)]
void GetInclusionCodeAndDrivers2(ElementId inElementId, out string outCode, out List<string> outKernelDriverNames, out List<SmartObject> outKernelDriverValues, out List<string> outDesignDriverNames, out List<SmartDesignObject> outDesignDriverValues)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation to analyze. |
| System.String | outCode | Instance code, or null if none. |
| System.Collections.Generic.List<System.String> | outKernelDriverNames | Instance kernel driver names, or null if none. |
| System.Collections.Generic.List<SmartObject> | outKernelDriverValues | Instance kernel driver values, or null if none. |
| System.Collections.Generic.List<System.String> | outDesignDriverNames | Instance design driver names, or null if none. |
| System.Collections.Generic.List<SmartDesignObject> | outDesignDriverValues | Instance design driver values, or null if none. |
Remarks
This method is available since v7.17.
GetInclusionDefinitionDocument(ElementId)
Gets the definition document of an inclusion operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
DocumentId GetInclusionDefinitionDocument(ElementId inElementId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation to analyze. |
Returns
| Type | Description |
|---|---|
| DocumentId | Identifier of the definition document of the inluded part or assembly. |
Remarks
This method is available since v7.8.
GetNodeBomIndex(ElementId)
Gets the bill of material index attached to a specified assembly node entity.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 12, 0, 0)]
string GetNodeBomIndex(ElementId inNodeId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inNodeId | Identifier of the assembly node entity (assembly or part occurrence, local part, ...) to analyze. |
Returns
| Type | Description |
|---|---|
| System.String | Bill of material index attached, or |
Remarks
This method is available since v7.12.
GetNodeProperties(ElementId, out List<PropertyDefinition>, out List<Property>)
Gets the properties attached to a specified assembly node entity.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 12, 0, 0)]
void GetNodeProperties(ElementId inNodeId, out List<PropertyDefinition> outDefinitions, out List<Property> outProperties)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inNodeId | Identifier of the assembly node entity (assembly or part occurrence, local part, ...) to analyze. |
| System.Collections.Generic.List<PropertyDefinition> | outDefinitions | Definitions of the properties attached to the specified node, or empty if none. |
| System.Collections.Generic.List<Property> | outProperties | Properties attached to the specified node, or empty if none. |
Remarks
This method is available since v7.12.
GetOccurrenceDefinition(ElementId)
Gets the definition document of a part or assembly occurrence entity.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
DocumentId GetOccurrenceDefinition(ElementId inOccurrenceId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inOccurrenceId | Identifier of the part or assembly occurrence to analyze. |
Returns
| Type | Description |
|---|---|
| DocumentId | Identifier of the definition document of the occurrence. |
Remarks
This method is available since v7.8.
GetOccurrencePublishing(ElementId, ElementId)
Gets the constituent of an occurrence corresponding to a specified publishing entity.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
ElementId GetOccurrencePublishing(ElementId inOccurrenceId, ElementId inPublishingId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inOccurrenceId | Identifier of the part or assembly occurrence to analyze. |
| ElementId | inPublishingId | Identifier of the specified publishing entity in the occurrence definition document. |
Returns
| Type | Description |
|---|---|
| ElementId | Identifier of the corresponding constituent entity of the occurrence. |
Remarks
This method is available since v7.8.
GetParts(DocumentId)
Gets the part or assembly entities that are in the parts folder of an asssembly document.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
List<ElementId> GetParts(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of the assembly document to analyze. |
Returns
| Type | Description |
|---|---|
| System.Collections.Generic.List<ElementId> | Part or assembly entities found. |
Remarks
This method is available since v7.8.
HasDriverSubFolderOwner(ElementId, String)
Determines whether the driver is inside the sub-folder inside the driver folder of the family document.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 17, 0, 0)]
bool HasDriverSubFolderOwner(ElementId inElementId, string inDriverName)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation. |
| System.String | inDriverName | Instance driver names. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The driver is inside a sub-folder. |
Remarks
This method is available since v7.17.
InheritOccurrenceFunctions(ElementId, List<ElementId>)
Provides functions by inheriting from the ones provided in a part or assembly occurrence.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
ElementId InheritOccurrenceFunctions(ElementId inOccurrenceId, List<ElementId> inFunctionIds)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inOccurrenceId | Identifier of the occurrence of the part or assembly providing the functions to inherit. |
| System.Collections.Generic.List<ElementId> | inFunctionIds | Identifiers of the specified function entities to inherit from in the occurrence definition document. |
Returns
| Type | Description |
|---|---|
| ElementId | Identifier of the created functions inheriting operation. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.8.
IsAssembly(DocumentId)
Tells whether a document is an assembly document.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 6, 0, 0)]
bool IsAssembly(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of the document to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The document is an assembly document. |
Remarks
This method is available since v7.6.
IsAssemblyOccurrence(ElementId)
Tells whether an element is an assembly occurrence entity.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
bool IsAssemblyOccurrence(ElementId inElementId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the element to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The element is an assembly occurrence entity. |
Remarks
This method is available since v7.8.
IsCollisionsManagementCheckingMechanisms(DocumentId)
Tells whether the collisions management of an assembly is checking for collisions between rigid groups of articulated subassemblies.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 10, 0, 0)]
bool IsCollisionsManagementCheckingMechanisms(DocumentId inDocumentId)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | Whether the collisions management of the assembly is checking for collisions between rigid groups of articulated subassemblies. |
Remarks
This method is available since v7.10.
IsInclusion(ElementId)
Tells whether an element is an inclusion operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
bool IsInclusion(ElementId inElementId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the element to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The element is an inclusion operation. |
Remarks
This method is available since v7.8.
IsLocalPartOrLocalAssembly(ElementId)
Tells whether an element is a local part or a local assembly entity.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 17, 0, 0)]
bool IsLocalPartOrLocalAssembly(ElementId inElementId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the element to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The element is a local part or a local assemby entity. |
Remarks
This method is available since v7.17.
IsPartOccurrence(ElementId)
Tells whether an element is a part occurrence entity.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
bool IsPartOccurrence(ElementId inElementId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the element to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The element is a part occurrence entity. |
Remarks
This method is available since v7.8.
IsWizardInclusion(ElementId)
Tells whether an element is a wizard operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 19, 0, 0)]
bool IsWizardInclusion(ElementId inElementId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the element to analyze. |
Returns
| Type | Description |
|---|---|
| System.Boolean | The element is an inclusion operation. |
Remarks
This method is available since v7.19.
LinkBom(DocumentId, DocumentId, Boolean)
Make BOM.
Declaration
[Obsolete("Since v7.12, access to BOM is done using IBoms interface.")]
[OperationContract]
[AvailableSinceVersion(7, 11, 300, 9)]
void LinkBom(DocumentId inDocumentId, DocumentId inBomDocumentId, bool inGroupItemsByProperties)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of the assembly document. |
| DocumentId | inBomDocumentId | Identifier of the bom document. |
| System.Boolean | inGroupItemsByProperties | regroup mode |
Remarks
This method is available since v7.11.300.9
RedirectInclusion(ElementId, DocumentId)
Redirects an inclusion operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 7, 201, 100)]
void RedirectInclusion(ElementId inElementId, DocumentId inDefinitionId)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation to modify. |
| DocumentId | inDefinitionId | Identifier of the new definition document of the part or assembly to include. |
Remarks
The previous definition document must be a part or an assembly, not a family.
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.7.201.100.
RedirectInclusionWithCodeAndDrivers(ElementId, DocumentId, String, List<String>, List<SmartObject>)
Redirects an inclusion operation to a family with specified code and drivers.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 12, 300, 80)]
void RedirectInclusionWithCodeAndDrivers(ElementId inElementId, DocumentId inDefinitionId, string inCode, List<string> inDriverNames, List<SmartObject> inDriverValues)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation to modify. |
| DocumentId | inDefinitionId | Identifier of the new family definition document to include. |
| System.String | inCode | Instance code, or null if none. |
| System.Collections.Generic.List<System.String> | inDriverNames | Instance driver names, or null if none. |
| System.Collections.Generic.List<SmartObject> | inDriverValues | Instance driver values, or null if none. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.12.300.080.
RedirectInclusionWithCodeAndDrivers2(ElementId, DocumentId, String, List<String>, List<SmartObject>, List<String>, List<SmartDesignObject>)
Redirects an inclusion operation to a family with specified code and drivers.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 17, 300, 80)]
void RedirectInclusionWithCodeAndDrivers2(ElementId inElementId, DocumentId inDefinitionId, string inCode, List<string> inKernelDriverNames, List<SmartObject> inKernelDriverValues, List<string> inDesignDriversValues, List<SmartDesignObject> inDesignDriverValues)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation to modify. |
| DocumentId | inDefinitionId | Identifier of the new family definition document to include. |
| System.String | inCode | Instance code, or null if none. |
| System.Collections.Generic.List<System.String> | inKernelDriverNames | Instance kernel driver names, or null if none. |
| System.Collections.Generic.List<SmartObject> | inKernelDriverValues | Instance kernel driver values, or null if none. |
| System.Collections.Generic.List<System.String> | inDesignDriversValues | Instance design driver names, or null if none. |
| System.Collections.Generic.List<SmartDesignObject> | inDesignDriverValues | Instance design driver values, or null if none. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.17.
SetAssemblyCenterOfMassManagement(DocumentId, Boolean)
Sets the center of mass management of the physical property management of an assembly.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
void SetAssemblyCenterOfMassManagement(DocumentId inDocumentId, bool inIsCenterOfMassManaged)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
| System.Boolean | inIsCenterOfMassManaged | Tells whether the physical property management of an assembly is center of mass managed. |
Remarks
This method is available since v7.13.300.220.
SetAssemblyMassManagement(DocumentId, Boolean)
Sets the mass management of the physical property management of an assembly.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
void SetAssemblyMassManagement(DocumentId inDocumentId, bool inIsMassManaged)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
| System.Boolean | inIsMassManaged | Tells whether the physical property management of an assembly is mass managed. |
Remarks
This method is available since v7.13.300.220.
SetAssemblyMomentsOfInertiaManagement(DocumentId, Boolean)
Sets the moments of inertia management of the physical property management of an assembly.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
void SetAssemblyMomentsOfInertiaManagement(DocumentId inDocumentId, bool inIsInertiaManaged)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
| System.Boolean | inIsInertiaManaged | Tells whether the physical property management of an assembly is moments of inertia managed. |
Remarks
This method is available since v7.13.300.220.
SetAssemblyStrictMode(DocumentId, Boolean)
Sets the strict mode of the physical property management of an assembly.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
void SetAssemblyStrictMode(DocumentId inDocumentId, bool inIsStrict)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
| System.Boolean | inIsStrict | Tells whether the physical property management of an assembly is strict. |
Remarks
This method is available since v7.13.300.220.
SetAssemblySurfaceAreaManagement(DocumentId, Boolean)
Sets the surface area management of the physical property management of an assembly.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
void SetAssemblySurfaceAreaManagement(DocumentId inDocumentId, bool inIsSurfaceAreaManaged)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
| System.Boolean | inIsSurfaceAreaManaged | Tells whether the physical property management of an assembly is surface area managed. |
Remarks
This method is available since v7.13.300.220.
SetAssemblyVolumeManagement(DocumentId, Boolean)
Sets the volume management of the physical property management of an assembly.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 13, 300, 220)]
void SetAssemblyVolumeManagement(DocumentId inDocumentId, bool inIsVolumeManaged)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to analyze. |
| System.Boolean | inIsVolumeManaged | Tells whether the physical property management of an assembly is volume managed. |
Remarks
This method is available since v7.13.300.220.
SetCollisionsManagement(DocumentId, ElementId, Boolean, Boolean, Boolean)
Sets the collisions management of an assembly.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 8, 0, 0)]
void SetCollisionsManagement(DocumentId inDocumentId, ElementId inRepresentationId, bool inFindsIntersections, bool inExcludesThreadingTapping, bool inIsRefreshAuto)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to modify. |
| ElementId | inRepresentationId | Identifier of the analyzed representation entity, or empty for no collisions management. |
| System.Boolean | inFindsIntersections | Whether to find collisions intersections. |
| System.Boolean | inExcludesThreadingTapping | Whether to exclude threading-tapping collisions. |
| System.Boolean | inIsRefreshAuto | Whether refresh is automatic. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.8.
SetCollisionsManagementCheckingMechanisms(DocumentId, Boolean)
Sets whether the collisions management of an assembly is checking for collisions between rigid groups of articulated subassemblies.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 10, 0, 0)]
void SetCollisionsManagementCheckingMechanisms(DocumentId inDocumentId, bool inIsChecking)
Parameters
| Type | Name | Description |
|---|---|---|
| DocumentId | inDocumentId | Identifier of assembly document to modify. |
| System.Boolean | inIsChecking | Whether the collisions management of the assembly is checking for collisions between rigid groups of articulated subassemblies. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.10.
SetInclusionCodeAndDrivers(ElementId, String, List<String>, List<SmartObject>)
Sets the code and drivers of a family inclusion operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 10, 0, 0)]
void SetInclusionCodeAndDrivers(ElementId inElementId, string inCode, List<string> inDriverNames, List<SmartObject> inDriverValues)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation to modify. |
| System.String | inCode | Instance code, or null if none. |
| System.Collections.Generic.List<System.String> | inDriverNames | Instance driver names, or null if none. |
| System.Collections.Generic.List<SmartObject> | inDriverValues | Instance driver values, or null if none. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.10.
SetInclusionCodeAndDrivers2(ElementId, String, List<String>, List<SmartObject>, List<String>, List<SmartDesignObject>)
Sets the code and drivers of a family inclusion operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 17, 0, 0)]
void SetInclusionCodeAndDrivers2(ElementId inElementId, string inCode, List<string> inKernelDriverNames, List<SmartObject> inKernelDriverValues, List<string> inDesignDriverNames, List<SmartDesignObject> inDesignDriverValues)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation to modify. |
| System.String | inCode | Instance code, or null if none. |
| System.Collections.Generic.List<System.String> | inKernelDriverNames | Instance kernel driver names, or null if none. |
| System.Collections.Generic.List<SmartObject> | inKernelDriverValues | Instance kernel driver values, or null if none. |
| System.Collections.Generic.List<System.String> | inDesignDriverNames | Instance kernel driver names, or null if none. |
| System.Collections.Generic.List<SmartDesignObject> | inDesignDriverValues | Instance kernel driver values, or null if none. |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.17.
SetNodeBomIndex(ElementId, String)
Sets the bill of material index attached to a specified assembly node entity.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 12, 0, 0)]
void SetNodeBomIndex(ElementId inNodeId, string inBomIndex)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inNodeId | Identifier of the assembly node entity (assembly or part occurrence, local part, ...) to modify. |
| System.String | inBomIndex | Bill of material index to attach, or |
Remarks
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.12.
TransformInclusion(ElementId, Transform3D)
Transforms an inclusion operation.
Declaration
[OperationContract]
[AvailableSinceVersion(7, 7, 201, 100)]
void TransformInclusion(ElementId inElementId, Transform3D inTransform)
Parameters
| Type | Name | Description |
|---|---|---|
| ElementId | inElementId | Identifier of the inclusion operation to modify. |
| Transform3D | inTransform | Transformation to apply. |
Remarks
The inclusion operation must be constituent of a positioning operation (this method may not be used on in-place parts inclusions).
StartModification(String, Boolean) and EnsureIsDirty(ref DocumentId) must be called before calling this method.
This method is available since v7.7.201.100.