自定义点
可扩展类
如果对本文档的“分发目标”一节中所述的可扩展 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 的 ReleaseActivity 对象的 releaseClass 属性值。此值是必需项，因为可将单个 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
• 定义用于验证分发目标分配的类名称。Windchill ESI 服务使用此首选项验证分发目标分配 (自动和显式)。要自定义验证，可将该首选项设置为定义 isTargetValidForAutoAssignment(Persistable, ESITarget) 和 isTargetValid(Persistable, ESITarget) 方法的自定义类的名称。
首选项名称：分发目标分配验证程序
默认值：com.ptc.windchill.esi.tgt.ESITargetAssignmentValidator
 |
部件的预设验证取决于为 Windchill ESI 首选项“视图到分发目标映射”设置的值。
|
• 指定是否在“发送至分发目标”用户界面中显示“用户输入”步骤。如果设置为“是”，则“用户输入”步骤在“发送至分发目标”用户界面中可用。如果设置为“否”，则“用户输入”步骤不会显示在用户界面中。
首选项名称：在“发送至分发目标”用户界面中显示用户输入步骤
默认值：否
|
|
此首选项仅与分布式进程分发目标相关。
|
• 指定是否允许用户从“发送至分发目标”用户界面的“信息”步骤中选择分发目标。如果设置为“是”，用户将能够选择要将数据发送到的分发目标。如果设置为“否”，则无法选择分发目标，且数据将发送至所有关联的分发目标。
首选项名称：允许在“发送至分发目标”用户界面中进行目标选择
默认值：是
也可以配置分发目标上的某些属性。这些属性包括：
• 定义在将日期有效性信息发送至给定目标位置时用于有效性开始和结束日期的格式。
属性名称：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/ExportToJMSQueue.xml
可以将该值变更为指向用户希望用于传送 ESI 响应消息的任何其他 Info*Engine 任务。在编写任务的此类自定义版本时，切记可将以下参数用于任务：
|
参数名称
|
值
|
|---|---|
|
transaction
|
表示基础 ESI 事务的 ESITransaction 对象。
|
|
target
|
要为其传送 ESI 响应消息的 ESITarget 对象。
|
|
objectId
|
已发布的主要业务对象的 UFID。
|
|
type
|
表示主要业务对象类型的字符串 - 例如 com.ptc.windchill.esi.Part。
|
|
username
|
发布对象的 Windchill 用户的名称。
|
|
locale
|
与给定版本相关的区域设置实例。此项将用于设置通过 ESI 响应发送的 JMS 消息特性 com_infoengine_locale。
|
此外，表示响应消息的 IeCollection 实例将通过其 VDB 提供给任务，并且可通过调用 getVDB() 提取。
|
|
默认 Info*Engine 任务 (在 ExportTo<XXX>.xml 中) 将在调用向所需目标位置传送 ESI 响应的 webject 后调用 PostResult RPC。在以下情况下会执行此操作：(i) 可以成功传送 ESI 响应并且 ERP Connector 首选项“启用公布结果”的值为“是”，或者 (ii) ESI 响应传送由于某种原因失败。
|
• 生成 ESI 响应消息时使用的格式。
属性名称：ESIResponseOutputFormat
默认值：ESI XML
使用默认值将导致 ESI 响应以 XML 格式生成，该格式符合 ESIResponse.xsd 中的模式 (有关此文件的详情，请参阅 Windchill Enterprise Systems Integration Open API Guide (《Windchill Enterprise Systems Integration 开放式应用程序编程接口指南》))。如果要以 PLM 服务格式生成 ESI 响应，则该值可能会变更为 "PLM"。请知悉，此属性一旦设定便无法编辑。除以上列出的模型化属性外，还可以在分发目标上配置多个可变属性。这些属性的值将确定构成响应消息的确切数据。有关此类属性及其说明的列表，请参阅发布 CN、发布 BOM、发布部件、发布工艺计划和发布资源各节。
最后，如 ESITarget 一节所述，除了 Windchill ESI 提供的各种预设 ESITarget 可变类型扩展外，用户还可以创建自定义可变类型扩展并将其与 ESI 配合使用。有关如何使用“类型和属性管理”用户界面创建给定对象的可变类型扩展，请参阅 《Windchill 自定义指南》 (《Windchill 自定义者指南》)。
|
|
如前所述，使用自定义分发目标时，应将 Windchill ESI 首选项“分发目标信息查找器”设置为接口 com.ptc.windchill.esi.tgt.ESITargetInfoFinder 的具体实现名称，该接口根据需要为 API getDestinationId() 和 getPlantName() 提供定义。
|