Configuración de los datos históricos registrados

Bloques de creación > Bloques de creación comunes > Bloque de creación de conexión de base de datos > Registro de datos históricos > Configuración de los datos históricos registrados

El registro completo de datos históricos puede dar lugar a problemas de rendimiento significativos. Como resultado, al implementar los bloques de creación, se desactiva el registro completo de datos históricos. El registro de datos históricos se limita solo a las acciones que requiere otra funcionalidad. De forma estándar, los únicos datos históricos que se registran son el estado de ejecución de las definiciones de trabajo cuando se crean y actualizan.

Se puede configurar el conjunto de acciones limitadas que se registran cuando el registro completo está desactivado.

Si se decide activar el registro completo, se debe tener en cuenta que pueden producirse problemas de rendimiento significativos.

Configuración del conjunto limitado de acciones

Para configurar el conjunto limitado de acciones que se registran cuando se desactiva el registro completo de datos históricos, complete los siguientes pasos:

1. Cree un nuevo bloque de creación que se extienda desde el bloque de creación PTC.DBConnection.

Para crear el nuevo bloque de creación, complete los siguientes pasos:

a. Cree un proyecto nuevo. Utilice un prefijo exclusivo para el proyecto, como por ejemplo el nombre de la empresa. El prefijo de PTC está reservado para entidades entregadas por PTC. Para este ejemplo, cree un proyecto denominado MyCompany.DBConnection. Para cada nueva cosa, plantilla de cosa u otra entidad que se cree para este bloque de creación, se debe añadir el nuevo proyecto como el valor de Proyecto en Información general para la entidad en ThingWorx Composer.

b. Cree una nueva plantilla de cosa en el proyecto que utilice PTC.DefaultConfiguration.EntryPoint_TT como Plantilla de cosa base. En este ejemplo, asigne a la nueva plantilla de cosa el nombre MyCompany.DBConnection.EntryPoint_TT.

c. Cree una nueva cosa en el proyecto que utilice la plantilla de cosa creada en el paso 1.b como Plantilla de cosa base. En este ejemplo, asigne a la nueva cosa el nombre MyCompany.DBConnection.EntryPoint.

d. Cree una nueva plantilla de cosa en el proyecto que utilice la plantilla de cosa del administrador del bloque de creación de PTC desde el que se extiende como Plantilla de cosa base. En este ejemplo, asigne a la nueva plantilla de cosa el nombre MyCompany.DBConnection.HistoricalDataManager_TT y utilice PTC.DBConnection.HistoricalDataManager_TT como Plantilla de cosa base.

e. Cree una nueva cosa en el proyecto que utilice la plantilla de cosa creada en el paso 1.d como su Plantilla de cosa base. En este ejemplo, asigne a la nueva cosa el nombre MyCompany.DBConnection.Manager y utilice MyCompany.DBConnection.HistoricalDataManager_TT como Plantilla de cosa base.

El bloque de creación PTC.DBConnection contiene varias plantillas de cosa y cosas del administrador. El servicio que se va a reemplazar en este procedimiento se encuentra en PTC.DBConnection.HistoricalDataManager_TT. Asegúrese de que está utilizando esta plantilla de cosa del administrador como Plantilla de cosa base para la nueva plantilla de cosa que está creando en este paso, y no una de las otras plantillas de cosa del administrador del bloque de creación PTC.DBConnection.

2. Añada cualquier configuración de la cosa del administrador del bloque de creación original a la cosa del administrador del nuevo bloque de creación.

a. Navegue hasta la cosa del administrador que se ha creado en el paso 1.e, en este ejemplo, MyCompany.DBConnection.HistoricalDataManager.

b. En Configuración, añada las mismas configuraciones que se encuentran en la página Configuración de la cosa del administrador del bloque de creación original, en este ejemplo, PTC.DBConnection.HistoricalDataManager.

3. Registre la cosa del administrador del nuevo bloque de creación como el administrador que se debe utilizar en lugar del administrador del bloque de creación de PTC desde el que se extiende el bloque de creación.

a. Vaya a la cosa PTC.Base.Manager.

b. En Configuración, busque la tabla de configuración DefaultGlobalManagerConfiguration.

c. Pulse en Icono de edición.

para la fila con el valor managerThingName que coincide con el administrador del bloque de creación de PTC desde el que se extiende el bloque de creación.

Para este ejemplo, pulse en Icono de edición.

para la fila con el valor managerThingName de PTC.DBConnection.HistoricalDataManager.

d. En la ventana de edición, defina el campo manageThingName en el nombre de la cosa del administrador del bloque de creación que se ha creado en el paso 1.e.

e. Pulse en Definir para definir el nuevo valor.

f. Pulse en Guardar para guardar los cambios realizados en la cosa PTC.Base.Manager.

4. En ThingWorx Composer, navegue hasta la plantilla de cosa del administrador de datos históricos para el nuevo bloque de creación que se ha creado en el paso 1.d, en este ejemplo, MyCompany.DBConnection.HistoricalDataManager_TT.

5. En Servicios, busque y sustituya el servicio GetHistoricalDataLogConfig.

6. En el editor de scripts, añada una entrada en el área de configuración personalizada designada para cada evento adicional que desee que se registre.

No cambie ni quite las entradas de configuración por defecto que registran el valor de campo ExecutionStatus cuando se crean o actualizan definiciones de trabajo (PTC.SCA.SCO.WorkDefinition) sin conocimiento del impacto en otras funciones.

Las entradas utilizan el siguiente formato:

addLoggingConfiguration("<Data_Shape>", "<field>", "<action>");

Para cada <acción>, los valores de <campo> posibles son:

◦ CREATE: el nombre del campo, ALLo nada

◦ UPDATE: el nombre del campo o ALL

◦ DELETE: nada

En la siguiente tabla se proporcionan entradas de ejemplo para los distintos eventos que se pueden registrar:

Evento que se va a registrar	Entrada de ejemplo
Creación de una entidad (se añade una fila a la tabla de base de datos)	addLoggingConfiguration("PTC.SCA.SCO.WorkDefinition", "CREATE");
Creación de una entidad y el valor inicial de cada campo (se añade una fila a la tabla de base de datos y cada campo que tiene un valor cuando se añade la fila)	addLoggingConfiguration("PTC.SCA.SCO.WorkDefinition", "ALL", "CREATE");
Valor inicial de un campo específico cuando se crea la entidad (el campo especificado tiene un valor cuando la fila se añade a la tabla de base de datos).	addLoggingConfiguration("PTC.SCA.SCO.JobOrder", "ID", "CREATE");
Actualización del valor de un campo específico (el valor del campo especificado cambia en la tabla de base de datos)	addLoggingConfiguration("PTC.SCA.SCO.JobOrder", "PlannedEndTime", "UPDATE");
Actualización del valor de todos los campos (cualquier valor de campo cambia en la tabla de base de datos)	addLoggingConfiguration("PTC.SCA.SCO.JobOrder", "ALL", "UPDATE");
Eliminación de una entidad (se quita una fila de la tabla de base de datos)	addLoggingConfiguration("PTC.SCA.SCO.JobOrder", "DELETE");

7. Pulse en Terminado y, a continuación, en Guardar para guardar el servicio actualizado.

Activación del registro completo de datos históricos

Para activar el registro completo de datos históricos, complete los siguientes pasos:

Si anteriormente se han completado las acciones de los pasos 1 a 3, no es necesario repetirlas. Vaya directamente al paso 4.