Promotion Request Classes
BasicESIRenderer
This is the abstract class implementing the interface ESIRenderer and is extended by the promotion request renderer class provided by ESI services. See section VdbBuilderImpl for more information on BasicESIRenderer.
ESIPromotionRequestRenderer
It belongs to the package com.ptc.windchill.esi.promotionrequest and is instantiated when a promotion request that holds one or more Releasable promotables is approved (or reviewed), thereby causing the promotables to reach a certain target lifecycle state that triggers their release.
Refer to the Windchill release specific Java documentation for more details on available attributes and methods in the class.
Note:
1. When processing a given object in a promotion request, the renderer makes use of the response settings that apply to that object. For example, when rendering a part, distribution target attributes that reside under Part Settings (in the Create/Edit Distribution Target UI) are used. In other words, there are no attributes on the distribution target that are specific to a promotion request.
2. The RTM workflow that is spawned upon approving (or reviewing) a promotion request processes the promotion request as the primary business object. However, only the objects in the promotion request are sent with the ESI response that is generated for the release. In order that the promotion request gets sent as well, the ESI response meta information file should be configured appropriately. For example, this may be achieved by adding Map, MapInformation and GroupInformation elements to the file, along the lines of what is shown below:
<esi:Map id="PromotionRequest">
<esi:attributeMapping sourceAttribute="obid">ObjectID</esi:attributeMapping>
<esi:attributeMapping sourceAttribute="xxxx" defaultValue="com.ptc.windchill.esi.PromotionRequest">Class</esi:attributeMapping>
<esi:attributeMapping sourceAttribute="modifier">LastChangedBy</esi:attributeMapping>
<esi:attributeMapping sourceAttribute="number">Number</esi:attributeMapping>
<esi:attributeMapping sourceAttribute="name">Name</esi:attributeMapping>
<esi:attributeMapping sourceAttribute="description">Description</esi:attributeMapping>
</esi:Map>
<esi:attributeMapping sourceAttribute="obid">ObjectID</esi:attributeMapping>
<esi:attributeMapping sourceAttribute="xxxx" defaultValue="com.ptc.windchill.esi.PromotionRequest">Class</esi:attributeMapping>
<esi:attributeMapping sourceAttribute="modifier">LastChangedBy</esi:attributeMapping>
<esi:attributeMapping sourceAttribute="number">Number</esi:attributeMapping>
<esi:attributeMapping sourceAttribute="name">Name</esi:attributeMapping>
<esi:attributeMapping sourceAttribute="description">Description</esi:attributeMapping>
</esi:Map>
<esi:MapInformation id="PromotionRequestInfo">
<esi:typedef>wt.maturity.PromotionNotice</esi:typedef>
<esi:elementMetaName>PromotionRequest</esi:elementMetaName>
<esi:keyAttribute>ObjectID</esi:keyAttribute>
<esi:mapRef>PromotionRequest</esi:mapRef>
</esi:MapInformation>
<esi:typedef>wt.maturity.PromotionNotice</esi:typedef>
<esi:elementMetaName>PromotionRequest</esi:elementMetaName>
<esi:keyAttribute>ObjectID</esi:keyAttribute>
<esi:mapRef>PromotionRequest</esi:mapRef>
</esi:MapInformation>
<esi:GroupInformation>
<esi:logicalName>AddedPromotionRequests</esi:logicalName>
<esi:physicalName> AddedPromotionRequests</esi:physicalName>
<esi:releaseClass>com.ptc.windchill.esi.PromotionRequest</esi:releaseClass>
<esi:releaseActivityNeeded>true</esi:releaseActivityNeeded>
<esi:mapInformationRef>PromotionRequestInfo</esi:mapInformationRef>
</esi:GroupInformation>
<esi:logicalName>AddedPromotionRequests</esi:logicalName>
<esi:physicalName> AddedPromotionRequests</esi:physicalName>
<esi:releaseClass>com.ptc.windchill.esi.PromotionRequest</esi:releaseClass>
<esi:releaseActivityNeeded>true</esi:releaseActivityNeeded>
<esi:mapInformationRef>PromotionRequestInfo</esi:mapInformationRef>
</esi:GroupInformation>
3. The promotion request renderer cycles over the promotables that figure in the promotion request and delegates the actual work of rendering each object to an appropriate renderer. For example, it invokes the BOM renderer when processing a BOM.
4. Like any other renderer, this class is meant to be extended by customizers.