Ampliación del número máximo de caracteres en datos de rendimiento rastreados

De manera predeterminada, el número máximo de caracteres que se permite en los datos de rendimiento (campos de variables que Performance Data Warehouse rastrea con fines de creación de informes) es 64. Puede ampliar este límite realizando los cambios siguientes en el archivo de propiedades de IBM® Business Process Manager Performance Data Warehouse. Los cambios que realice en esta propiedad afectarán a los tamaños de columnas de las tablas de grupo de seguimiento.

Procedimiento

  1. Abra el archivo 00Static.xml en un editor de textos. Consulte el tema Ubicación de los archivos de configuración para conocer la ubicación del archivo 00Static.xml.
  2. Copie la propiedad siguiente: <max-length-of-string-columns>64</max-length-of-string-columns>
  3. Abra cada archivo 100Custom.xml de la topología, tal como se describe en el tema Ubicación de los archivos de configuración.
  4. Pegue la propiedad siguiente en cada archivo 100Custom.xml desde el archivo 00Static.xml y realice los cambios indicados.
    <performance-server>
       <max-length-of-string-columns merge="replace">200</max-length-of-string-columns>
    </performance-server>
    Nota: debe realizar este cambio de forma global en Performance Data Warehouse, ya que el servidor no tiene especificidad a nivel de grupo o de campo para el parámetro de longitud máxima de serie. Aunque puede utilizar una longitud de serie mayor para un campo, debe ser en cierta medida conservador y aplicar este parámetro globalmente.
  5. En la base de datos de rendimiento, cambie el tamaño de los campos siguientes para que tengan el mismo tamaño que el valor de la propiedad max-length-of-string-columns. El tamaño varía según el sistema de gestión de la base de datos y la codificación. Para algunos sistemas de gestión de bases de datos, los campos pueden tener el mismo valor que la propiedad max-length-of-string-columns. Sin embargo, para la codificación DB2 y UTF-8, multiplique el tamaño de las series por 4 para obtener el tamaño de los campos en la base de datos de rendimiento.
    1. Cambie la anchura de columna de todos los campos de grupo de rastreo de las tablas TG_* que son parámetros VARCHAR.
    2. Cambie la anchura de columna de la columna STRING_VALUE en la tabla LSW_OPTIMIZER_DATA.
    Importante: Si cambia el tamaño de los campos de grupos de rastreo, seguirá necesitando aplicar el campo de longitud máxima de serie a la configuración de Performance Data Warehouse para que IBM BPM escriba datos con una longitud mayor que la longitud máxima de serie predeterminada. Los datos con una longitud mayor al valor de longitud máxima de serie predeterminada pasarán a la lista de errores de Performance Admin Console. Si aumenta el valor de longitud máxima de serie pero no aumenta el tamaño de los demás campos de serie, la cantidad de datos escritos podría sobrepasar la capacidad de estos campos.
  6. Después de cambiar las tablas TG_*, actualice las definiciones de rastreo para volver a crear las vistas correspondientes.
  7. Reinicie Performance Data Warehouse.

Resultados

Si intenta enviar datos al Performance Data Warehouse mayores que el número de caracteres máximo permitido, el archivo SystemOut.log contendrá errores. Por ejemplo:
2007-08-08 18:05:26,156 [DataTransfer Thread #2] ERROR com.lombardisoftware.server.ejb.tracking.APIServicesBean - Excepción en llamada EJB com.lombardisoftware.core.TeamWorksException: (PFS-0062) El campo rastreado con ID externo t193b943b74411 tiene un valor con una longitud de 96 caracteres. El máximo es 64. ...
Sólo verá estos errores en el archivo de registro y en Performance Admin Console. No se visualizará ninguna indicación de un error en Process Server. Estos errores se almacenan en la cola de errores donde puede reprocesarlos mediante Performance Admin Console. Consulte el enlace relacionado para obtener información adicional sobre cómo reprocesar mensajes de la cola de errores.