1. Windchill PDMLink Part Creation Utility
PTC INTERNAL USE ONLY
Windchill PDMLink Part Creation Utility

2. Introduction
PDMLink’s Part Creation utility helps to selectively decide for which of the migrated CAD
Documents should WTPart be created.
The part creation process can be refined by configuring an XML file called ‘part_creation.xml’ which
is used by the part creation utility at runtime, so as to filter and select the CAD documents for which
WTPart need’s to be created.
© 2006 PTC

3. Introduction Cont…
The Object for which part’s are to be created can be selected based on the following 7 criteria.
1. CAD Document Authoring Application
2. Document Type
3. CAD Document Name
4. CAD Document Number
5. Attribute Value
6. Release Level
7. Folder Location
© 2006 PTC

4. Part_creation.xml
The part selection is determined by the criteria defined in part_creation.xml. This XML file is at
‘codebase\com\ptc\windchill\pdmlink\proimigration\server\xml’ The root tag of this file is <Specifier> tag. This tag
contain one or more <PartAction> tags.
<Specifier>
<PartAction>
</PartAction>
</Specifier>
The <PartAction> element can contain three child elements that can be used to filter and select CAD Documents.
1. <FolderSpec> [Folder specification],
2. <PISpec> [Product Item Specification] and
3. <PIVSpec> [Product Item Version Specification].
<FolderSpec>
</FolderSpec>
<PISpec>
</PISpec>
<PIVSpec>
</PIVSpec>
Conditions: PartAction Element
must contain at least one of these elements or a combination of several.
cannot use any single element more than once in the <PartAction> element
© 2006 PTC

5. PartAction Element
The PartAction tag determines whether or not the system should create part, and the Class for the WTParts to be created from the selected CAD Documents.
The <PartAction> element has the following two attributes.
Create :- Determines whether or not the part creation tool should create parts for the CAD Documents selected by <PartAction>. This attribute can have a value of either ‘True’ or ‘False’. The default value is True.
Class :- This attribute determines the class for WTPart that would be created by the part creation tool for the selected CAD Document objects. This is a required attribute
PartAction Element and Its Attributes
Example:
<PartAction Class="wt.part.WTPart">
<PartAction>
Attributes
Values
Create
True/False
Class
wt.part.WTPart
wt.part.WTProduct
wt.part.WTSerialNumberedPart
wt.part.WTPart | com.orgname.OrgPart
© 2006 PTC

6. Folder Specification Element
This element allows for the selection of CAD Documents based on specific folder locations.
The <FolderSpec> tag can contain one or more <FolderCriteria> Elements.
The <FolderSpec> tag has the following attribute
CriteriaJoin :- if the <FolderSpec> element contains multiple <FolderCriteria> statements, then this attribute determines
if the system selects CAD Documents that meets all of this
Criteria or any of the criteria. The ‘CriteriaJoin’ attribute can have a value of either
And :- Selects CAD documents that meets all the of the criteria specified in <FolderCriteria> element.
Or :- Selects CAD Document that meets any of the criteria specified in <FolderCriteria> Element.
FolderSpec Element and Its Attributes
<FolderSpec CriteriaJoin="Or">
<FolderCriteria></FolderCriteria>
</FolderSpec>
Attributes
Values
CriteriaJoin
And/Or
© 2006 PTC

7. FolderCriteria
<FolderCriteria> element is a container for all of the <FolderCondition> element in
<FolderSpec>. There can be multiple <FolderCriteria> element within a folder
specification. The folder criteria element has the following attribute.
ConditionJoin :- If the folder criteria element has multiple folder condition statements then this attribute specifies
determines if the system should create parts for CAD Documents that meets all the criteria or any of the criteria’s.
This attribute can have either of the following values.
And :- The system selects CAD documents that meets all of the criteria specified in the <FolderCondition> elements.
Or :- The system selects CAD documents that meet any of the criteria specified in the <FolderCondition> element.
FolderCriteria Element and Its Attributes
<FolderCriteria ConditionJoin="Or">
<FolderCondition></FolderCondition>
</FolderCriteria>
Attributes
Values
ConditionJoin
And/Or
© 2006 PTC

8. FolderCondition
This element specifies and individual folder location from which to ‘select/not select’ the CAD documents.
The <FolderCondition> has the following Attributes,
Context :This attribute specifies the product context including organization for which parts have to be created.
Operator :This attribute specifies an assignment operator that connects the lookup attribute to the value attribute. This attribute can have the following values: equal or notEqual
Value : This attribute specifies the full path to the folder location. E.g. Value=”/Default/Templates”
Attributes
Values
Context
And/Or
Operator
equal/notEqual
Value
Eg: Root Folder/Some_location/
FolderCondition Element and Its Attributes
<FolderCondition>
Operator="notEqual"
Value="/Default/Design“
Context="/wt.inf.container.OrgContainer=ITCINFOTECH/wt.pdmlink.PDMLinkProduct=GOLF_CART"/>
</FolderCondition>
© 2006 PTC

9. <PISpec> Product Item Specification Element
Product item specification allows to select CAD Document based on Product Item criteria.
The <PISpec> element can contain one or more <PICriteria> elements and it has the following attribute:
CriteriaJoin :If the <PISpec> element has multiple <PICriteria> statements then this attribute specifies if the system
should select CAD Documents that satisfies all of the criteria or those that satisfies any of the criteria. This attribute can
have the following values:
And :- The system selects the CAD Documents that satisfies all of the criteria specified by <PICriteria> elements.
Or :- The system selects CAD Documents that meets any of the conditions specified by <PICriteria> elements.
Product Item Specification Element
<PISpec>
<PICriteria>
<AttrCondition>
</AttrCondition>
</PICriteria>
</PISpec>
E.g:
<PISpec CriteriaJoin= "Or">
……………………
Attributes
Values
CriteriaJoin
And/Or
© 2006 PTC

10. <PICriteria> Product Item Criteria
<PICriteria> element is a container for all of the individual <AttrCondition> elements. There can be multiple
<PICriteria> elements within a <PISpec> element. The <PICriteria> element has the following attribute.
ConditionJoin: If the <PICriteria> element has multiple <AttrCondition> statements, then this attribute specifies if the
system selects CAD Documents that meets all of the condition statements or any of the condition statements. This
attribute can have the following values.
And :- The system selects CAD Documents that meets all of the conditions specified by the <AttrCondition> statements.
Or :- The system selects CAD Documents that meet any of the condition specified by the <AttrCondition> statements.
E.g
<PISpec>
<PICriteria ConditionJoin= “Or”>
…………………...
</PICriteria>
</PISpec>
Attributes
Values
ConditionJoin
And/Or
© 2006 PTC

11. <AttrCondition> Attribute Condition
This element allows identifying attribute values as criteria for selecting CAD Documents.
This element has four attributes.
Attributes
Values
AttrName
Eg: name
Operator
equal/notEqual/greaterThan/greaterThanOrEqual/lessThan/lessThanOrEqual
Value
The value of the desired attribute.
AttrTypeIsDate
True/False
<AttrCondition AttrName=”Some_date” Operator=”greaterThan” Value= ”01/01/1986” AttrTypeIsDate=”True”/>
© 2006 PTC

12. <PIVSpec> Product Item Version Specification Element
The product item version specification allows to select CAD Documents based on PIV Criteria.
The <PIVSpec> is a container within which one or more <PIVCriteria> elements reside. The
<PIVSpec> element has the following attribute
CriteriaJoin :-If the PIVSpec element has multiple PIVCriteria elements, then this attribute specifies if the system selects CAD Documents that meets all of the Criteria or any of the criteria. This attribute can have the following value.
And :- the system selects CAD Objects that meets all of the conditions specified in the <PIVCriteria> element
Or :- The system selects CAD Documents that meets all of the condition specified by the <PIVCriteria> element.
E.g:
<PIVSpec CriteriaJoin= “Or”>
…………………..
</PIVSpec>
© 2006 PTC

13. <PIVCriteria> Element
The <PIVCriteria> element is a container for all of the individual <PIVCondition> or <AttrCondition> element in <PIVSpec>.
The <PIVCriteria> element has the following attributes.
ConditionJoin : If the <PIVCriteria> element has multiple <PIVCondition> or <AttrCondition> element, then this attribute specifies if the system selects CAD Documents that meets all or any of the condition specified. This attribute can have the following value
And :-The system selects CAD Documents that meets all the criteria’s specified by the <PIVCondition> element.
Or :- The system selects CAD Documents that satisfies any of the criteria’s specified by the <PIVCondition> element
E.g
<PIVSpec>
<PIVCriteria ConditionJoin= “Or”> ..
</PIVCriteria>
</PIVSpec>
© 2006 PTC

14. <PIVCondition> Element
This Tag contains the individual conditions under which a particular product item version should be
selected.
This tag can have the following attributes.
Version :- This attribute specified whether the <PIVCondition> selects all version, latest version or a
specific version of a CAD Document.
This attribute can have the following value.
a) latest :- Indicates that the <PIVCondition> element selects the latest version.
b) all :- Indicates that the <PIVCondition> element selects all versions of a CAD Document.
c) specific :-Indicates that the <PIVCondition> element selects CAD Document with a specific version value.
Operator :- This attribute specifies an assignment operator. This attributes can have the following values.
a) equal
b) notEqual
c) greaterThan
d) greaterThanOrEqual
e) lessThan
f) lessThanOrEqual
Value :- Indicates the version value to be searched for. E.g. A,B,A1
© 2006 PTC

15. Mapping Life Cycle and States
The EMP Documents Lifecycle and States need to be mapped to WTPart lifecycle and States.
To do this, edit ‘lifecyclemap.properties.xconf’ in ‘/codebase/ com/ ptc/ windchill/ pdmlink/proimigration/’, and add
properties in the following format.
<Property default="PartLifeCycle" name="EPMLifeCycle"/>
<Property default="PartLifeCycle.State1" name="EPMLifeCycle.State1"/>
<Property default="PartLifeCycle.State2" name="EPMLifeCycle.State2"/>
<Property default="PartLifeCycle.State3" name="EPMLifeCycle.State3"/>
<Property default="PartLifeCycle.State4" name="EPMLifeCycle.State4"/>
Propagate the changes made to the xconf file, which will add the following entries to ‘lifecyclemap.properties’.
EPMLifeCycle=PartLifeCycle
EPMLifeCycle.State1=PartLifeCycle.State1
EPMLifeCycle.State2=PartLifeCycle.State2
EPMLifeCycle.State3=PartLifeCycle.State3
EPMLifeCycle.State4=PartLifeCycle.State4
© 2006 PTC

16. Executing WTPart Creator
To execute the WTPart Creator tool run the following command from windchill shell :
WT_Home/codebase>windchill com.ptc.windchill.pdmlink.proimigration.server.WTPartCreator
Which will give the following menu ..
ProIntralink to PDMLink Part Create Migration Tool
1. Search for CAD Documents to process.
2. Validate your objects, and see existing warnings.
3. Create new parts.
4. Create links WTPart ->EPMDocument .
5. Build Part Structures.
6. Add Parts to Baselines.
7. Delete the temporary status table.
8. Exit
>>> Choose an option:
© 2006 PTC

17. Examples 1. CAD Document authoring application
<PISpec CriteriaJoin="And">
<PICriteria ConditionJoin="And">
<AttrCondition AttrName="authoringApplication" Operator="equal" Value="PROE" AttrTypeIsDate = "false"/>
</PICriteria>
</PISpec>
2. Document type
<AttrCondition AttrName="docType" Operator="equal" Value=“CADCOMPONENT" AttrTypeIsDate = "false"/>
© 2006 PTC

18. Examples 3. CAD document name <PISpec CriteriaJoin="And">
<PICriteria ConditionJoin="And">
<AttrCondition AttrName="CADName" Operator="equal" Value="72155.prt" AttrTypeIsDate = "false"/>
</PICriteria>
</PISpec>
4. Attribute value
<PISpec CriteriaJoin="Or">
<PICriteria ConditionJoin="Or">
<AttrCondition AttrName="name" Operator="notEqual" Value="SomeThing*" AttrTypeIsDate = "false"/>
<AttrCondition AttrName="number" Operator="equal" Value=" " AttrTypeIsDate = "false"/>
© 2006 PTC

19. Examples 5. Release Level <PISpec CriteriaJoin="And">
<PICriteria ConditionJoin="And">
<AttrCondition AttrName="state. state" Operator="equal" Value="INWORK" AttrTypeIsDate = "false"/>
</PICriteria>
</PISpec>
6. Folder Location
<FolderSpec CriteriaJoin="Or">
<FolderCriteria ConditionJoin="And">
<FolderCondition Operator="equal" Value="/Default/SomeFolder" Context= "/wt.inf.container.OrgContainer=ORG/wt.pdmlink.PDMLinkProduct=PRD"/>
</FolderCriteria>
</FolderSpec>
© 2006 PTC

20. WTPartCreator startup
© 2006 PTC

21. After Choosing Option 1
© 2006 PTC

22. After Choosing Option 2
© 2006 PTC

23. After Choosing Option 3
© 2006 PTC

24. After Choosing Option 4
© 2006 PTC

25. After Choosing Option 5
© 2006 PTC

26. After Choosing Option 7
It will remove the rows exists with status initial or validated
It will not remove rows with status created or linked or built
© 2006 PTC

27. Questions
© 2006 PTC