自定义点
可扩展类
如果对本文档的分布目标一节中所述的可扩展 Windchill ESI 类进行了扩展,则必须在 Windchill ESI 特性中定义这些类。以下类允许进行自定义扩展:
ESITarget
首选项名称:“分布目标类”
默认值:com.ptc.windchill.esi.tgt.ESITarget
ESITargetAssignmentLink
首选项名称:“分布目标分配类”
默认值:com.ptc.windchill.esi.tgt.ESITargetAssignmentLink
ESITargetFinder
首选项名称:“分布目标查找器”
默认值:com.ptc.windchill.esi.tgt.class.ESISimplePartTargetFinder
可配置选项
Windchill ESI 首选项用于控制与分布目标相关的多个可配置选项。选项包括:
定义显示 ESITarget 对象时使用的映射文件的名称。
首选项名称:“目标映射文件”
默认值:$CODEBASE$/tgt/ESITarget.map
定义在合并的 UFID 字符串中查找单个 UFID 时使用的分隔符。此首选项由 Windchill ESI 服务在内部使用;它不会影响其他 Windchill 组件的行为。
首选项名称:“唯一联合 ID 分隔符”
默认值:|
定义发布活动对象中用于标识 BOM 的发布类属性值。此值是必需项,因为可将单个 Windchill 部件两次发布到同一分布目标,其中第一次发布将定义部件,而第二次发布将定义 BOM。需要使用一些 Windchill ESI API 区分这两种类型的发布活动。此首选项用于确定这些 API 将查找的内容。
首选项名称:“BOM 类”
默认值:com.ptc.windchill.esi.BOMHeader
定义用于查找分布目标信息的类名称。Windchill ESI 服务使用此首选项来确定自定义分布目标的目标位置 ID 和工厂名称。首选项的预置值为具有 getDestinationId(ESITarget)getPlantName(ESITarget) 方法的 Java 接口的名称。要使该首选项适用于自定义目标 (如 ESIFileTarget 的可变扩展),应将其设置为根据需要定义上述方法的接口的具体实施名称。上述所有方法均可以返回一个基于所传递目标类型的输出。
首选项名称:“分布目标信息查找器”
默认值:com.ptc.windchill.esi.tgt.ESITargetInfoFinder
* 
目前,ERP Connector 提供了一种可配置功能,而不是自定义 ESITargetInfoFinder 类和改写 adjustTarget。现有自定义代码将继续运行,但建议使用新的配置方法。有关详细信息,请参阅配置 ESI 以在 ESI 响应中设置目标位置 ID 和目标 ID
定义用于验证分布目标分配的类名称。Windchill ESI 服务使用此首选项验证分布目标分配 (自动和显式)。要自定义验证,可将该首选项设置为用于定义 isTargetValidForAutoAssignment(Persistable, ESITarget)isTargetValid(Persistable, ESITarget) 方法的自定义类的名称。
首选项名称:“分布目标分配验证程序”
默认值:com.ptc.windchill.esi.tgt.ESITargetAssignmentValidator
* 
部件的预设验证取决于为 Windchill ESI 首选项“视图到分布目标映射”设置的值。
指定是否在“发送至分布目标”用户界面中显示“用户输入”步骤。如果设置为“是”,则“用户输入”步骤在“发送至分布目标”用户界面中可用。如果设置为“否”,则“用户输入”步骤不会显示在用户界面中。
首选项名称:“在‘发送至分布目标’用户界面中显示用户输入步骤”
默认值:No
* 
此首选项仅与分布式进程分布目标相关。
指定是否允许用户从“发送至分布目标”用户界面的“信息”步骤中选择分布目标。如果设置为“是”,用户将能够选择要将数据发送到的分布目标。如果设置为“否”,则无法选择分布目标,且数据将发送至所有关联的分布目标。
首选项名称:允许在“发送至分布目标”用户界面中选择目标
默认值:Yes
也可以配置分布目标上的某些属性。这些属性包括:
定义在将日期有效性信息发送至给定目标位置时用于有效性开始和结束日期的格式。
属性名称:EffectivityFormat
默认值:yyyy/MM/dd HH:mm:ss
* 
要使用此属性,不应设置名为“有效性格式”的首选项。
指向 ESI 响应元信息文件的路径,该文件包含给定目标位置的映射信息。
属性名称:responseMetaInfoPath
默认值:$CODEBASE$/com/ptc/windchill/esi/ESIResponseMetaInfo.xml
可以将该值变更为指向响应元信息文件的相应修改版本。有关如何修改此文件以获取响应消息的自定义版本的信息,请参阅修改 ESI 响应元信息文件
指向将 ESI 响应消息传送至所需目标位置的 Info*Engine 任务的路径。
属性名称:taskURI
默认值:com/ptc/windchill/esi/export/ExportTo<XXX>.xml,其中占位符 <XXX> 为文件、FTP 或 SMTP,对应的目标位置分别为文件、FTP 或电子邮件类型目标。
可以将该值变更为指向用户希望用于传送 ESI 响应消息的任何其他 Info*Engine 任务。在编写任务的此类自定义版本时,切记可将以下参数用于任务:
参数名称
transaction
表示基础 ESI 事务处理的 ESITransaction 对象。
target
要为其传送 ESI 响应消息的 ESITarget 对象。
objectId
已发布的主要业务对象的 UFID。
“类型”
表示主要业务对象类型的字符串 - 例如 com.ptc.windchill.esi.Part
username
已发布对象的 Windchill 用户的名称。
locale
与给定版本相关的区域设置实例。
* 
此参数不会用于 ERP Connector 目标。
此外,表示响应消息的 IeCollection 实例将通过其 VDB 用于任务,并且可通过调用 getVDB() 提取。
* 
ExportTo<XXX>.xml 中的默认 Info*Engine 任务将在调用向所需目标位置传送 ESI 响应的 webject 后调用 PostResult RPC。执行此操作的前提是
1. ESI 响应可以成功传送,并且 ERP Connector 首选项“启用公布结果”的值为 Yes
2. ESI 响应传送出于某种原因失败。
生成 ESI 响应消息时使用的格式。
属性名称:ESIResponseOutputFormat
默认值:ESI XML
使用默认值将导致 ESI 响应以 XML 格式生成,该格式符合 ESIResponse.xsd 中的结构 (有关此文件的详细信息,请参阅Windchill Enterprise Systems Integration Open Application Programming Interface Guide)。如果要以 PLM 服务格式生成 ESI 响应,则该值可能会变更为 PLM
* 
此属性一旦设定便无法编辑。
除以上列出的模型化属性外,还可以在分布目标上配置多个可变属性。这些属性的值将确定构成响应消息的确切数据。有关此类属性及其说明的列表,请参阅发布变更通告发布 BOM发布部件发布工艺计划发布资源小节。
最后,如 ESITarget 一节所述,除了 ERP Connector 提供的各种预设 ESITarget 可变类型扩展外,用户还可以创建自定义可变类型扩展并将其与 ESI 配合使用。有关如何使用“类型和属性管理”用户界面创建给定对象的可变类型扩展,请参阅《Windchill 自定义指南》
* 
如前所述,使用自定义分布目标时,应将 Windchill ESI 首选项“分布目标信息查找器”设置为接口 com.ptc.windchill.esi.tgt.ESITargetInfoFinder 的具体实施名称,该接口为 API getDestinationId() 和 getPlantName() 提供相应的定义。
目前,ERP Connector 提供了一种可配置功能,而不是自定义 ESITargetInfoFinder 类和改写 adjustTarget。现有自定义代码将继续运行,但建议使用新的配置方法。有关详细信息,请参阅配置 ESI 以在 ESI 响应中设置目标位置 ID 和目标 ID
这对您有帮助吗?