配置 Process Portal 索引

在线编辑
您可以通过修改环境变量来更改 Business Automation Workflow 系统上的索引的存储位置。 要更改索引行为 (例如，更新时间间隔的长度或在索引中包含已完成的任务) ，必须编辑 100Custom.xml 配置文件。
重要信息: 以下信息适用于 Heritage Process Portal (不推荐) 和 Process Portal。

该索引允许 Process Portal 中的流程参与者搜索包含特定元数据或实例数据的任务或流程实例。 索引还用于“流程业绩”和“团队业绩”仪表板中的历史记录数据。

因为缺省情况下索引建立已启用，所以下列配置操作为可选。

设置索引的位置

索引的位置由 BPM_SEARCH_TASK_INDEX WebSphere® 变量的值决定。 该变量在独立服务器上具有服务器作用域，在集群上具有集群作用域。

在集群上
缺省位置为 $<BPM_SEARCH_TASK_INDEX_ROOT>/cluster_name。 使用此缺省位置将针对每个节点上的每个集群生成一个索引，从而使同一节点上的所有集群成员共享同一索引。

这样就无需针对每个集群成员来维护索引，因此可在节点间共享一个索引。 一次只能在一个集群成员中维护索引，这由索引的锁定策略来强制实施。 要设置索引，请针对索引使用共享网络存储解决方案，并更改定义了单元作用域的 BPM_SEARCH_TASK_INDEX_ROOT 变量的值以指向公共位置。

如果希望集群成员具有独立的索引，那么可以更改已定义单元作用域的 BPM_SEARCH_TASK_INDEX_ROOT 变量的值以指向其他位置。

要查找环境变量，请在管理控制台中单击 环境 > WebSphere 变量。

在独立服务器上
任务索引的缺省位置是 $<BPM_SEARCH_TASK_INDEX_ROOT>/server_name。 如果未设置 BPM_SEARCH_TASK_INDEX 变量，那么位置缺省为 $<USER_INSTALL_ROOT>/searchIndex/task/$<WAS_SERVER_NAME>，它将针对每台服务器生成一个索引。

要更改索引位置，请在管理控制台中单击 环境 > WebSphere 变量。 如果 BPM_SEARCH_TASK_INDEX 变量不存在，请对它定义单元作用域，然后将该值设置为新位置。

更改索引行为

索引配置包含以下缺省设置：
  • 索引建立已启用。
  • 索引每 5 秒更新一次。
  • 任务完成后，系统将为刚刚完成的任务和打开的任务更新索引。 不会为先前已完成的与流程相关联的任务更新索引。
要更改索引行为，请执行以下操作：
  1. 为相应的服务器编辑 100Custom.xml 文件。 有关 100Custom.xml 文件位置的信息可在 100Custom 配置文件的位置主题中找到。
  2. 根据需要添加或编辑以下代码片段：
    <search-index merge="replace">            
    <task-index-enabled>true</task-index-enabled>            
    <task-index-update-interval>5</task-index-update-interval>
    <task-index-update-completed-tasks>false</task-index-update-completed-tasks>
    <task-index-store-fields>false</task-index-store-fields>
    <task-index-work-manager>wm/default</task-index-work-manager>
    <task-index-include-system-tasks>true</task-index-include-system-tasks>
    <process-index-instance-completion-best-effort>false</process-index-instance-completion-best-effort>
</search-index>
  3. 在 <search-index> 节中，为要更改的配置设置修改相应的任务索引标记。
    表 1. 可用于更改索引配置设置的 XML 标记
    XML 标记 配置设置描述
    <task-index-enabled> 该布尔值决定是否启用建立索引功能。 缺省值为 true；如果索引不存在，那么会创建索引。
    要关闭建立索引功能，请将该值更改为 false；如果索引不存在，那么不会创建索引。
    限制: 如果关闭了索引，那么将隐藏 Process Portal 用户界面中的搜索字段。 此外，“流程”列表、“流程业绩”仪表板和“团队业绩”仪表板未正常工作。
    <task-index-update-interval> 此整数值指定索引更新之间的时间间隔（秒）。 指定的时间间隔决定何时针对上次索引更新后完成的任务捕获实例变量的状态。 通过最新的实例数据只能搜索在当前时间间隔内完成的那些任务。

    更新时间间隔的缺省值为 5 秒。 最小值为 1 秒。
    <task-index-update-completed-tasks> 此布尔值控制是否对先前已完成的任务更新索引。 缺省值为 false，表示仅在索引中更新刚刚完成的任务和打开的任务。
    如果将值更改为 true，那么行为发生以下更改：
    • 实例级更新（如在后续流程中更新的业务数据）将传播到完成的任务。
    • 虽然系统具有其他工作在对已完成的任务建立索引，但对已完成任务的搜索是基于最终实例业务数据。
    • 被分配了多个任务的用户将体验到活动流程实例查询性能的提升，因为查询可从已完成的实例中过滤掉任务。
    <task-index-store-fields> 此布尔值可控制是否将实际的字段值存储为独立的字段。 缺省值为 false，表示不将实际的字段值存储为独立的字段。 您可能希望将该值更改为 true 以用于调试目的，因为这会提高可读性，并允许通过其他搜索工具进行查询。
    <task-index-work-manager> 该字符串包含建立索引流程用于管理搜索索引的工作管理器的 JNDI 名称。 默认值为 wm/default ，这是 WebSphere Application Server.

    要提高创建索引的性能，您可以在管理控制台中创建带有更大数量可用线程的专用工作管理器。 然后，您可以使用此标记来切换至新的工作管理器。
    <task-index-include-system-tasks> 此布尔值控制是否为系统任务建立索引。 要使系统任务能够显示在 Process Portal的甘特图中，请确保此标记的值设置为 true。 如果此标记的值为 false，那么系统任务不会显示在甘特图中。
    <process-index-instance-completion-best-effort> 此布尔值控制在对从先前版本的 IBM® BPM 迁移的实例建立索引时是否创建完成日期。 缺省设置为 false。

    如果您将该值更改为 true，那么关联任务的最后完成日期会用作实例完成日期。 如果不存在任何关联任务，那么实例的上次修改时间戳记会用作完成日期。
  4. 保存您的更改。
  5. 重新启动服务器以激活更改。