配置 Process Portal 索引

您可以通过修改环境变量来更改存储索引的位置。要更改索引行为(例如更新时间间隔的长度或者是否在索引中包含已完成的任务),您必须编辑 100Custom.xml 配置文件。

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

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

设置索引的位置

索引位置由 BPM_SEARCH_TASK_INDEX 环境变量的值决定。该变量在独立服务器上具有单元作用域,在集群上具有集群作用域。

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

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

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

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

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

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

更改索引行为

索引配置包含以下缺省设置:
  • 索引建立已启用。
  • 索引每 5 秒更新一次。
  • 对于任务,仅对开启的活动任务更新索引,而不对已完成的任务更新索引。
要更改索引行为,请执行以下操作:
  1. 为相应的服务器编辑 100Custom.xml 文件:
    • For Windows operating system<process_center_profile>\config\cells\<Cell>\nodes\<node>\servers\<server>\process-server\config\system\100Custom.xml
    • For Linux operating systemFor UNIX operating system<process_center_profile>/config/cells/<Cell>/nodes/<node>/servers/<server>/process-server/config/system/100Custom.xml
  2. 根据需要添加或编辑以下代码片段:
    <search-index>            
        <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>falsetrue</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. 重新启动服务器以激活更改。