Representations of CAD Documents containing Owner-Associated Parts
This topic describes how Representations relate to CAD Documents with and without owner-associated parts.
Understanding How WVS Representations Function with Associations
Representations are always stored on EPM Documents when there are no owner—associations to a Part. If an EPM Document has an owner-association to a Part, the representation is stored on the Part.
This situation can lead to unanticipated (although correct) behavior in certain scenarios. For example, if you have an EPM Document and you publish it to create a representation, you see the representation on the EPM Document’s Representations/Annotations tab. However, if you manually create an owner-association that EPM Document to a Part, the check-in process performs a build, and during that process the representation becomes hidden on the EPM Document and is available for read-only reference on the newly associated Part (in the same way as representations on a drawing can be seen from the Part associated to the part). The representation is not on the Part; it is still on the EPM Document, so the resulting representation on the Part is in “read-only” mode. This is the correct behavior, but can appear confusing because it looks like the representation has vanished from the EPM Document.
A similar situation arises if you do not perform a build upon checkin. Normally, when you check in an EPM Document (and you specify that you want to create the associated Part) the build creates the owner association between the two objects.In this scenario, the Part does not have the owner association created yet.If you do not perform a build when checking in an EPM Document, a publish job is executed, but since the Part is associated by a means other than the EPM Build History Link, the representation lives on the EPM Document. Once a manual build action occurs, the association acts exactly the same as it does when you manually create an association between an EPM Document and a Part.The representation on the EPM Document is hidden.
Representations of CAD Documents with Owner-Associated Parts
When the owner association part iterates independently, the new Representation is associated to the CAD Document. In the case of a CAD Document with a built owner association to a part, the new Representation is directly associated to the part, and not the CAD Document.
When the owner association between the CAD Document and the Part is created after the CAD Document is published, the following describes some expected behavior:
1. The representation is no longer displayed on the Representation listing from the CAD Document details page. The CAD Document must be submitted for publishing again to create a new representation. The representation that is created is on the Part.
2. The representation is displayed as a read-only representation on the Part details page. When the associated CAD Document is submitted for publishing again, the new Representation is displayed in the Representation listing for both the CAD Document and Part, since the new representation is associated to the Part.
Build After Check In—The above behaviors occur when setting the Build After Check In preference to None, and when a CAD Document is checked in with associated parts, and is submitted for publishing. The CAD Document and part can appear to have an owner association, but that is not the case until a “Build Associated Parts” action is performed to create the owner association. To set the Build After Check In preference, navigate to > > > .
CAD Document to Part Owner Link Behavior
By default, when publishing a CAD Document, the new published representation is created using the first iteration of the Part referred to by the current iteration of the CAD Document (the iteration that the CAD Document built). This is the case when the wvs.property.xconf property, publish.representable.owner.usefirstiteration is set to true (default).
When viewing the CAD Document it is this representation that is displayed.
Action | Result |
---|
The Part iterates independently from the CAD Document | No representation of the Part is displayed in the Representations page. |
View the CAD Document, | The representation associated to the first iteration is displayed (A.1 in the above figure). |
Submit the CAD Document for publishing, | The newly created representation resides on the first iteration (A.1). |
To publish an CAD Document using the latest iteration of the Part referred to by the current iteration of the CAD Document, set the publish.representable.owner.usefirstiteration property to false.
Action | Result |
---|
View the first iteration (A1). | The representation associated to A.1 is displayed. |
View the CAD Document. | The representation associated to the latest iteration is displayed (A.2 in the above figure). |
Submit the CAD Document for publishing. | The newly created representation resides on the latest iteration (A.2). |
Multiple Owner Associations
When a CAD Document with more than one owner association to multiple parts is submitted for publishing, the new Representation is associated to the primary owner-associated part. The primary owner is the first Part associated to the CAD Document. All other associated parts in this case are referred to as non-primary owner-associated parts. The first iteration of primary owner-association Part is used to obtain the representation. Non primary owner associations are ignored.
This is the case when the wvs.property.xconf property, publish.representable.owner.usefirstiteration is set to true (default).
To use the latest iteration of primary owner-association Part to obtain the representation, set the wvs.property.xconf property, publish.representable.owner.usefirstiteration, to false.
This mechanism is also used by the dynamic structure processing. If the traversal mechanism returns a Part that has no representation, then the CAD Document has no display data. Similarly, publishing this Part representation also creates display data for the CAD Document.
Copy Representations to Described Parts
To copy the Representation to the Non-primary owner-association Parts, use the Copy Representations to Described Parts feature. Assume you have multiple Parts associated to one CAD Document; for example, one owner and some additional image associations. You can use the copy to described parts functionality to copy the representation that is published for the CAD Document to those other non-owner Parts so that they have a representation available on them for visualization — typically when those parts are included in Part structures.
The Copy Representations to Described Parts set of preferences are located in the Visualization section of Preference Management.
Preferences available in this section consist of:
• Choose Which Representation to Copy - When a representation is created, you can choose to copy either the default representation, or any representation.
• Enabled (Yes/No) - When a representation is created, enables/disables representation copying to described parts.
• Include Markups (Yes/No) - Allows you to specify whether to include markups when copying a representation to described parts.
• Latest Iteration (Yes/No) - Allows representations to be copied to described parts only if the representable being published is the latest iteration.
• Navigation - Specifies which association types to navigate when locating described parts for the copy operation.
• Require owner association (Yes/No) - Allows you to specify whether an owner association to a part is required in order for the representation to be copied to described parts.
Further information about these preferences can be found in the Set Preference window of each preference.
| The Copy Representations to Described Parts preference is available in the Site and Organization contexts. It is not available in the Product context. |