扩展所跟踪的业绩数据中的最大字符数

缺省情况下,业绩数据(出于报告目的而跟踪至 Performance Data Warehouse 中的可变字段)中允许的最大字符数为 64。 可以通过对 Performance Data Warehouse 的属性文件进行以下更改来扩展此限制。您对该属性所作的更改会影响跟踪组表中的列大小。

过程

  1. 在文本编辑器中打开 00Static.xml 文件。 请参阅主题100Custom 配置文件的位置以获取 00Static.xml 文件的位置。
  2. 复制以下属性:<max-length-of-string-columns>64</max-length-of-string-columns>
  3. 打开拓扑中的每个 100Custom.xml 文件,如主题100Custom 配置文件的位置中所述。
  4. 00Static.xml 中的以下属性粘贴至每个 100Custom.xml 文件,并按指示进行编辑。
    <performance-server>
       <max-length-of-string-columns merge="replace">200</max-length-of-string-columns>
    </performance-server>
    注: 您需要在 Performance Data Warehouse 中全局进行此更改,因为服务器不会从字段级别或组级别指定最大字符串长度设置。 虽然您可以对字段使用较大的字符串长度,但是应小心谨慎并全局应用此设置。
  5. 在业绩数据库中,根据 max-length-of-string-columns 属性的值更改以下字段的大小。 该大小因数据库管理系统和编码而异。 对于某些数据库管理系统,这些字段的值可以与 max-length-of-string-columns 属性的值相同。 但是,对于 DB2 和 UTF-8 编码,请将该字符串大小乘以 4,以获取业绩数据库中字段的大小。
    1. TG_* 表中更改所有跟踪组字段(即 VARCHAR 参数)的列宽。
    2. LSW_OPTIMIZER_DATA 表中更改 STRING_VALUE 列的列宽。
    要点: 如果您更改跟踪组字段的大小,那么仍需要将对最大字符串长度的更改应用于 Performance Data Warehouse 配置,以便 IBM® BPM 写入超过缺省最大字符串长度的数据。 超过缺省的最大字符串长度值的任何数据都将被列入 Performance Admin Console 中的错误列表内。 如果您增加最大字符串长度值,但是不增加其他字符串字段的大小,那么写入的数据量可能超过这些字段的容量。
  6. 更改 TG_* 表之后,更新跟踪定义以重新创建对应的视图。
  7. 重新启动 Performance Data Warehouse。

结果

如果尝试将超过允许的最大字符数的数据发送至 Performance Data Warehouse,那么 SystemOut.log 文件中会包含错误。 例如:
2007-08-08 18:05:26,156 [DataTransfer Thread #2] ERROR com.lombardisoftware.server.ejb.tracking.APIServicesBean - Exception in EJB call com.lombardisoftware.core.TeamWorksException: (PFS-0062) The tracked field with external ID t193b943b74411 has a value that is 96 characters long. The maximum is 64. ...
您将仅在日志文件和 Performance Admin Console 中看到这些错误。 在 Process Server 中不显示任何错误指示。这些错误存储在错误队列中,您可以在此队列中使用 Performance Admin Console 来对其进行重新处理。 请参阅相关的链接以获取有关错误队列中的重新处理消息的其他信息。