Configuring Mass Update Options
Use the following procedures to configure your mass updating options.
|
|
If you modify any configuration file listed in the following sections, you must execute the following command in a Windchill shell after you have finished making your modifications:
xconfmanager -pF
|
Mass Update of Attributes:
Use the following procedure to configure the types and attributes to display when calling the Mass Update action for attributes.
1. Navigate to and open the following file:
codebase\com\ptc\windchill\mpml\xconfs\mpmlink.wt.properties.xconf
2. Modify the following attributes:
◦ massUpdate.AllowedTypes: Displays a list of types shown in the Types combo box. When adding a type to this property there is no need to add all of its subtypes as they will be added to the combo box automatically.
◦ massUpdate.ExcludedTypes: Modify this attribute to exclude some subtypes when performing a mass update.
◦ massUpdate.Attribute.WCTYPE|<xyz>: Where <xyz> is the class name (for example: wt.part.WTPart). Configure one line per type to specify the list of attributes to expose when the type is selected.
Mass Update of Associations
Configuring the Mass Update action for associations consists of defining collectors in the collector UI and hooking them to the Mass Update action. The following steps show an example on how to hook the collector of Windchill MPMLink objects associated to a WTDocument.
1. To modify the collectors available in the collector UI of the Mass Update action, navigate to and open the following file:
codebase\com\ptc\core\htmlcomp\collection\CollectionComponentConfig.xml
2. Locate the section where the collectionComponentID is “MassUpdateAssociation”.
3. In this section, add the collection tool usages associated with the collection tool that will allow collecting link owners where the other side role is the seed (the seed is the initially selected object when launching the Mass Update action). For example, the collection tool to collect Windchill MPMLink objects associated to WTDocument is MPMLINK_OBJECTS_ASSOCIATED_TO_DOCUMENT.
4. Locate the collection tool in the XML file. For example:
<CollectionTool id="MPMLINK_OBJECTS_ASSOCIATED_TO_DOCUMENT">
|
|
A collection tool can refer to a list of collection definitions using the collectionServiceKey tag. All collection definitions are defined in the XML files located in the following folders:
• codebase\com\ptc\core\collectionsrv
• codebase\com\ptc\core\collectionsrv\mpml
For this collection tool, the following collection definitions used are:
• MPMLINK_OBJECTS_ASSOCIATED_TO_DESCRIBED_DOCUMENT
• MPMLINK_OBJECTS_ASSOCIATED_TO_REFERENCED_DOCUMENT
|
5. Each collectionServiceKey is associated to a unique collectedAsKey, which must be respected throughout the entire file. For example:
◦ 804 is the collectionServiceKey for MPMLINK_OBJECTS_ASSOCIATED_TO_DESCRIBED_DOCUMENT
◦ 805 is the collectionServiceKey for MPMLINK_OBJECTS_ASSOCIATED_TO_REFERENCED_DOCUMENT
6. Since the collector user interface does not provide information about links associated to collected objects, the Mass Update action must access the database to query the links after the objects are collected. To associate the link information to the collection definitions, navigate to and open the following file:
codebase\com\ptc\windchill\mpml\xconfs\mpmlink.wt.properties.xconf
7. Define one massUpdate.Collection.<xyz> property per collectedAsKey where <xyz> is the collectedAsKey value. The property value is created by concatenating the link class name and the name of roles A and B for this link. Note that because of this way of associating links to collectors, only simple collection definitions can be used. For example, collection definitions navigating only one link. Since collecting Windchill MPMLink objects associated to WTDocument involves two collectedAsKeys, the properties are:
◦ <Property name="massUpdate.Collection.804"
default="WCTYPE|com.ptc.windchill.mpml.MPMDocumentDescribeLink,describes,describedBy"/>
◦ <Property name="massUpdate.Collection.805"
default="WCTYPE|com.ptc.windchill.mpml.MPMDocumentReferenceLink,referencedBy,references"/>
