Specific Use
|
RPC
|
Relevant Event
|
Windchill Objects1
|
Procedure Applied
|
---|---|---|---|---|
Publish aWTPart
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPartMaster
|
None, works as is
|
Publish a WTPart with documents; documents requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
None, works as is
|
Publish aWTPart; documents modified, but documents not requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPartMaster
|
None, works as is
|
Publish a WTPart with custom additional modeled2 attributes not mapped3; documents not modified or documents not requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
None, works as is
|
|
• WTDocument, WTDocumentMaster, and EPMDocument are only affected if the relevant Windchill ESI RPC supports documents and if the Windchill ESI RPC invocation requests that documents be included. Windchill ESI RPCs GetPart, GetBOM and GetECN do support documents.
• Attributes described in the table as “modeled” attributes are presumed to have public getter methods.
• Non-mapped attributes are not included in the Windchill ESI Open API RPC responses.
• Windchill ESI uses the Windchill Adapter Query-Object webject to obtain all the attributes of parts and part master objects. As long as the Query-Object webject returns the attribute, that attribute is available to Windchill ESI mapping logic.
|
Specific Use
|
RPC
|
Relevant Event
|
Windchill Objects1
|
Procedure Applied
|
---|---|---|---|---|
Publish a WTPart with custom additional modeled attributes on a part usage link, substitute link, reference designator link, and/or alternate link that are not mapped; documents not modified or documents not requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
None, works as is
|
Publish a WTPart with custom additional modeled attributes that are mapped; documents not modified or documents not requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
Windchill ESI Configuration:
• Modify map file(s)
• Modify XML schema1
|
Publish a WTPart with custom additional modeled attributes on a substitute, alternate, or reference designator links that are mapped; documents not modified or documents not requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
Windchill ESI Configuration:
• Modify map file(s)
• Modify XML schema
|
|
Although it is possible to change the XML schema by customization, it is safer to create a custom RPC so that future Windchill ESI maintenance will not overlay customizations.
|
Specific Use
|
RPC
|
Relevant Event
|
Windchill Objects1
|
Procedure Applied
|
---|---|---|---|---|
Publish a WTPart with extensions of substitute, reference designator, or alternate links, additional modeled attributes on the extensions that are not mapped; documents not modified or documents not requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPart WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
Windchill ESI Configuration:
• Modify ESI properties
|
Publish a WTPart with extensions of substitute, reference designator, or alternate links, additional modeled attributes on the extensions that are mapped; documents not modified or documents not requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
Windchill ESI Configuration:
• Modify map file(s)
• Modify XML schema
• Modify ESI properties
|
Publish a WTPart with custom additional modeled attributes on a part usage link that are mapped; documents not modified or documents not requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
Windchill ESI Customization:
• Extend java code1
• Modify map file(s)
• Modify ESI properties
|
|
The Windchill BOM difference logic does not expose the part usage links directly. Instead it returns a set of wrapper objects of class, PartUsageInfo. If attributes are to be available to Windchill ESI mapping logic, PartUsageInfo must be modified. Otherwise, Windchill ESI java code must be modified to obtain the required attribute value(s).
|
Specific Use
|
RPC
|
Relevant Event
|
Windchill Objects1
|
Procedure Applied
|
---|---|---|---|---|
Publish a WTPart after modifying the master relationship between WTPart and WTPartMaster1
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
Windchill ESI Customization:
• Extend ESI java code
• Modify ESI properties
|
Publish a custom object, MyPart, extended from WTPart and/or a custom object, MyPartMaster, extended from WTPartMaster with additional modeled or non-modeled attributes which are not mapped; documents not modified or documents not requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
MyPart and/or
MyPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
Windchill ESI Configuration:
• Modify ESI properties2
|
|
• Windchill WTPart objects are related to WTPartMaster objects by a complex relationship that is defined by the Windchill code generation tool. The relationship is central to product structure navigation and to the release of parts by Windchill ESI. Changing the relationships will disrupt Windchill ESI logic. These are the kinds of modifications that require java coding to repair the disruption of Windchill ESI logic:
◦ Replacing the existing relationship implementation with a link class
◦ Creating a new object, extending WTPart, that disrupts the inherited relationship to WTPartMaster
◦ Creating a new object, extending WTPartMaster, that disrupts the inherited relationship to WTPart
• The properties define the name of the part class and the part master class. If these property values are changed, then it will only be possible to release the extension objects identified by the values. The GetPart RPC will no longer support WTPart and/or WTPartMaster.
|
Specific Use
|
RPC
|
Relevant Event
|
Windchill Objects 1
|
Procedure Applied
|
---|---|---|---|---|
Publish a custom object, MyPart, extended from WTPart and/or a custom object, MyPartMaster, extended from WTPartMaster with additional modeled or non-modeled attributes which are mapped; documents not modified or documents not requested
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
MyPart and/or MyPartMaster WTDocument WTDocumentMaster EPMDocument
|
Windchill ESI Configuration:
• Modify ESI properties1
• Modify map files
• Modify XML schema
|
Publish a WTPart with documents requested and modeled attribute or IBA or soft-type has been added to WTDocument, WTDocumentMaster, and/or EPMDocument
|
GetPart
GetBOM
GetECN
|
Part or change ready to publish
|
MyPart and/or
MyPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
Windchill ESI Configuration:
• Modify map files
• Modify ESI properties2
• Define XML schema
|
Publish a custom object, MyPart, extended from WTPart and/or a custom object, MyPartMaster, extended from WTPartMaster with additional modeled or non-modeled attributes which are mapped
|
Custom3
|
Part or change ready to publish
|
WTPart
|
Windchill ESI Customization:
• Author a custom RPC
• Define XML schema
|
|
• The properties define the name of the part class and the part master class. If these property values are changed, then it will only be possible to release the extension objects identified by the values. The GetPart RPC will no longer support WTPart and/or WTPartMaster.
• Declare the document soft type.
• The Windchill ESI GetPart RPC will still support for WTPart and WTPartMaster in this case.
|
Specific Use
|
RPC
|
Relevant Event
|
Windchill Objects 1
|
Procedure Applied
|
---|---|---|---|---|
Publish a WTPart with documents requested and:
• Document class (es) extended1 or
• Document links modified
|
Custom2
|
Part or change ready to publish
|
MyPart and/or
MyPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
Windchill ESI Customization:
• Customize Document Difference API
• Extend ESI java code
• Author a custom RPC
• Define XML Schema
|
Publish a WTPart with modified linkages to (or services supporting) non-local mapped attributes or modified services supporting non-local mapped attributes3
|
Custom
|
Part or change ready to publish
|
WTPart
|
Windchill ESI Customization:
• Author a custom RPC
• Modify XML Schema
|
Publish a WTPart with modified linkages (uses, substitute, or references)
|
Custom
|
Part or change ready to publish
|
WTPart
|
ESI Customization:
• Author a custom RPC based on GetBOM and/or GetECN
• Customize BOM Difference API
• Modify XML Schema
|
Publish aWTChangeOrder2
|
GetECN
|
Change ready to publish
|
WTChangeOrder2
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
None, works as is
|
|
• In this category extensions do not include soft types. Adding a new soft type document is a configuration option. See above
• GetPart, GetBOM and GetECN could be customized in this case, but such a customization would be vulnerable to future ESI DSU maintenance. A custom RPC is a safer choice.
• For example, modifying the part alternate relationship.
|
Specific Use
|
RPC
|
Relevant Event
|
Windchill Objects1
|
Procedure Applied
|
---|---|---|---|---|
Publish a WTChangeOrder2 with additional attributes not mapped
|
GetECN
|
Change ready to publish
|
WTChangeOrder2
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
None, works as is
|
Publish a WTChangeOrder2 with additional attributes mapped
|
GetECN
|
Change ready to publish
|
WTChangeOrder2
WTPart
WTPartMaster
WTDocument
WTDocumentMaster
EPMDocument
|
Windchill ESI Configuration:
• Modify map files
• Modify XML schema
|
Publish a custom object, MyObject, not extended from WTPart
|
Custom
|
MyObject ready to publish
|
MyObject
|
Windchill ESI Customization:
• Author a custom RPC
• Modify XML Schema
|
Modify ESITarget
|
Custom
|
Any
|
Any
|
See Distribution Targets for details.
|
|
• Although the above table lists only use cases pertaining to parts, BOMs, change notices and associated documents, use cases on exactly similar lines are also possible with standalone documents (in both object-centric and CN-centric modes), promotion requests and all of the MPMLink objects that are supported – viz., process plans and resources such as tooling, process materials and skills. The relevant RPCs for these objects would be GetDocument, GetPromotionRequest, GetProcessPlan and GetResource, and the affected objects would be WTDocument, EPMDocument, PromotionNotice, MPMProcessPlan, MPMSequence, MPMOperation, MPMTooling, MPMProcessMaterial and MPMSkill among others.
• By GetXXX PRC is meant the getXXX() API of the concrete implementation of ESIService (StandardESIService by default).
• The contents of the Relevant Event column in the table simply refer to the user action that triggers the publication (for example, setting the lifecycle state of an object to Released). It is important to be aware that no event is emitted by ESI services and passed to the EAI software components upon triggering the publication of an object; instead, ESI services proceed to generate the ESI response directly and hand it over to the EAI software components.
|