修改 ESI 响应信息文件时需要注意的点
修改 响应元信息文件的内容时,切记以下几点:
1. 不要直接从默认位置修改该文件;一定要创建该文件的副本并对其进行修改。如果您直接修改了该文件,则将安装更新为后续维护版本时,可能会消除变更内容。此外,当这些目标需要接收自定义数据时,您可能想要创建响应元信息文件的修改版本并将其与分布目标相关联。
2. 修改 Map 元素时,确保其 id 属性具有唯一值;换句话说,该值不应由相同版本或任何其他启用版本的文件中任何其他 Map 元素使用。如果不满足此条件,则在尝试保存引用已修改文件的分布目标时,将抛出一个错误。
3. 使用新 id 属性创建 Map 元素时,同时创建 mapReference 元素的内容与 id 属性值相同的 MapInformation 元素。或者,也可根据需要修改现有 MapInformation 元素的 mapRef 元素。
4. 除非 Map 元素的内容发生变更,否则不要修改其 id 属性。
5. 在新建 (或修改现有) MapInformation 元素时,确保其 id 属性在文件中具有唯一值。尽管并非必需,但建议该值在文件的不同版本中唯一。
6. 使用新 id 属性创建 MapInformation 元素时,确保文件中存在 mapInformationRef 元素的内容与 id 属性值相同的 GroupInformation 元素。
7. 不要更改任何 GroupInformation 元素的 logicalName 元素的值。可以修改 physicalName 元素的值,但这几乎始终需要在必要时修改文件
<Windchill>/tasks/com/ptc/windchill/esi/lite/GetPostResultInfoForTarget.xsl
8. 当需要发布部件的 ERP 物料 (或工厂特定) 属性时,
a. 将相关 attributeMapping 条目添加到部件的 Map 元素中
b. 根据需要将 XML 属性 erpMaterialAttribute (或 plantSpecificAttribute) 设置为 true。
9. 为了使对目标已参考的响应元信息文件进行的变更生效,
a. 重新启动 MethodServer 或
b. 将参考目标的“状况”属性从“启用”切换为“未启用”,保存该属性并再次将其重置为“启用”。
10. 如果发布对象的可变类型 (或模型化) 扩展,仅当需要发布与已扩展对象不同的扩展属性集时,响应元信息文件才需要变更。换句话说,只要扩展的属性集与父对象相同,文件本身的默认版本足以。
11. 添加表示自定义组的 <GroupInformation> 元素时,切记根据需要设置其属性 "isUnchanged",如下所示:
<esi:GroupInformation isUnchanged="true" >
<esi:logicalName>MyUnchangedType</esi:logicalName >
...
</esi:GroupInformation>
在上述示例中,名为 "MyUnchangedType" 的自定义组用于包含 ESI 响应中未变更的数据,因此需要将属性 "isUnchanged" 设置为 "true"。
仅当生成 XML 格式的消息时 (即,当分布目标属性 ESI Response Output Format 设置为 ESI XML 时),响应元信息文件的内容才会影响 ESI 响应消息。换句话说,在以 PLM 格式生成 ESI 响应时,该文件没有任何作用。
这对您有帮助吗?