创建 100Custom.xml 配置文件

要修改 Process Server 或 IBM® Process Center 配置，必须创建 100Custom.xml 文件（如果此文件不存在）。然后，您可以更改 IBM BPM 部署环境的 100Custom.xml 文件中的配置属性来覆盖其他 XML 配置文件（例如，99Local.xml 文件）中的缺省配置，包括存储库服务器信息和 Performance Data Warehouse 通信方法。

关于此任务

构成 TeamWorksConfiguration.running.xml 文件的 IBM BPM 设置源自于包含缺省值的系统 XML 文件以及 100Custom.xml 配置文件。从配置作用域读取所有 XML 文件，但是建议仅使用具有 100Custom 前缀的文件来对设置进行定制更改。您不应直接对系统 XML 文件进行修改。将依次按照字母顺序和数字顺序装入 XML 文件，最好避免定制设置中有任何冲突的更改，从而防止文件装入顺序影响最终设置。

以下 XML 片段显示 100Custom.xml 更改文件的顶级结构。特定 100Custom.xml 文件中至多应仅存在其中一个 XML 标记：

<properties>
   <authoring-environment>
   <!-- Settings related to Process Designer -->
   </authoring-environment>
   <common>
   <!-- General IBM BPM settings -->
   </common>
   <server>
   <!-- Settings related to the run-time server -->
   </server>
   <web-pd>
   <!-- Settings related to the web Process Designer -->
   </web-pd>
   <event-manager>
   <!-- Settings related to Event Manager -->
   </event-manager>
   <performance-server>
   <!-- Settings related to Performance Data Warehouse -->
   </performance-server>
</properties>

在上述 XML 片段中，某些部分仅用于特定配置作用域。例如，performance-server 部分仅用于 performance-data-warehouse 配置作用域。

嵌套元素的方式非常重要。例如，如果在不正确的父元素（例如，<server>）下嵌套 <timeout> 元素，那么值将不发生更改。属性必须位于 Process Server 的 XML 文档的正确位置中才能在运行时读取和更新值。

IBM BPM 根据 merge 属性的值，将在 100Custom.xml 文件中所做的更改与原始配置合并。指定的所有属性值必须加上引号。例如，merge 属性及其缺省值 mergeChildren 指定为 merge="mergeChildren"。根据要如何合并 100Custom.xml 文件和原始配置之间的已更新元素，使用下表中的某个值。

表 1. 100Custom.xml 文件的 merge 属性
merge 属性的值	描述
`append`	将新元素附加到任何现有元素，这在将其他元素添加到包含相同元素的多个副本的现有列表时非常有用。
`mergeChildren`	将新元素与第一个现有元素进行合并，这在指定需要更改的子元素的父 XML 标记时非常有用。`mergeChildren` 值是 merge 属性的缺省值，其意味着暗示属性值 `merge="mergeChildren"`，实际上无需在元素上指定。
`replace`	将所有现有元素及其子元素替换为新元素，这在更改子元素的值时或者在想要修改父元素及其所有子元素时非常有用。注：在为具有嵌套子元素的元素设置 `merge="replace"` 属性时，产品缺省配置的所有现有子元素都将被删除，并将仅设置定制中指定的子元素。因此，建议仅在元素无任何子代的叶节点上使用 `merge="replace"`。否则，确保在定制中包含所有必需的子元素。

过程

要配置 100Custom.xml 文件：

要包含更改，请使用现有 100Custom.xml 文件，或者基于现有文件创建新文件。如果创建多个文件以包含更改，那么应为每个文件附加前缀 100Custom。
应避免使用具有冲突更改的多个文件。在修改 100Custom.xml 配置文件时，首先应使用 .bak 扩展名生成包含原始文件内容的备份。请谨慎操作，不要将旧的 .xml 文件留在配置目录中，因为会将所有 *.xml 文件装入到服务器配置中。
使用期望的父/子 XML 结构填写 100Custom XML 文件，以引导至您期望修改的元素。所有元素均包含在顶级属性标记中，如以上示例中所示。请参阅特定设置的文档以获取更多信息，或者查看 TeamWorksConfiguration.running.xml 文件。
TeamWorksConfiguration.running.xml 文件中包含的部分设置不支持客户定制。因此，应避免更改未记录的设置。
根据以下准则，填写 XML 元素的 merge="attribute_value" 属性：
- 对于仅包含子元素更新的父 XML 元素，省略属性（暗示 mergeChildren 值）。
  注：要正确追加新的子元素以及合并或替换现有元素，父 XML 元素的名称必须与现有元素名称相匹配。此外，父元素的所有属性及其值必须精确匹配。（这不包括合并和匹配属性，不考虑这些属性。）
- 对于要更新值或属性的新的或现有 XML 元素，使用 merge="replace"。还将除去任何预先存在的子元素并替换为此元素的内容。您可以检查 TeamWorksConfiguration.running.xml 文件以查看特定元素的预先存在的内容。
- 对于想要添加到现有类似元素列表的 XML 元素，请使用 merge="append"。
通过将新文件更改部署到环境并检查更新的 TeamWorksConfiguration.running.xml 文件来进行测试。有关更多信息，请参阅主题将 100Custom.xml 文件部署到部署环境。或者，在确定需要的更改后，可以使用 updateBPMConfig 命令以将更改写入到 100Custom.xml 文件。