Cache generation

Introducción

Nota:

En esta guía se asume un único entorno.

Antes de que un usuario final pueda acceder a un entorno y a la versión que esté activa, se deben adquirir los datos (p. ej., consultas a una base de datos externa) y los cálculos deben estar en la caché. El resultado de una sola generación de caché de este tipo se denomina "instancia".

Las cachés se pueden generar manualmente o automatizar. El resultado de estas generaciones de caché puede verse en la pestaña de Datos de superadministrador liberados.

Generar cachés manualmente

Para crear instancias de datos, deberás generar cachés, que son necesarias para permitir que los usuarios finales puedan acceder a la aplicación.

Sigue estos pasos para crear una caché para tu versión.

Paso	Acción
1	Ve a la pestaña Datos liberados de superadministrador.
2	Haz clic en Generar caché ahora.
3	Haz clic en GENERAR CACHÉ.
4	Cuando el diálogo muestra Finalizado, haz clic en CERRAR.

Se habrá añadido una nueva fila con el nombre de tu módulo y una columna para el datarun designado después de la fecha actual. En esta columna se mostrará 1/1, que indica que la instancia se ha generado correctamente.

Si haces clic en la para expandir la fila, podrás ver el nombre de tu organización y algunos iconos en la fila, indicando que la generación de datos se ha realizado correctamente y esta instancia de datos estará activa. Consulta la siguiente ilustración.

Generar cachés automáticamente

También se puede realizar la gerneación del a caché de forma periódica (p. ej., a diario) en lugar de manualmente. Esto es útil cuando los datos se consultan de una base de datos externa, ya que los usuarios podrán disponer de los datos actualizados de forma automática.

Para configurar esto, se necesitan derechos de acceso de administrador al servidor.

Es posible generar cachés para módulos específicos de la versión activa. Utiliza app=MODULECODE en lugar de app=* en el archivo batch (ver más abajo). Si se utiliza app=*, las cachés se generarán para todos los módulos de la versión activa.

También es posible generar cachés para organizaciones específicas. Utilizao=[org] para generar una caché para la organización especificada. Si se utiliza o=*, las cachés se generarán para toda la organización en orden secuencial.

Nota:

Solo es aplicable para aplicaciones que no utilicen un conector para generar datos de entrada.

Sigue estos pasos para programar una tarea de generación de cachés.

Paso	Acción
1	Abre el directorio PLATFORMDIR.
2	Crea un archivo batch vacío, por ejemplo, generatecaches.bat.
3	Edita este archivo de lote y usa la siguiente línea como contenido: call builds/processgold.bat -DataServer -ccdb app=* o=org refreshmvncaches=both Este archivo de lote generará cachés para todas las aplicaciones.
4	Programa una tarea en Windows para llamar a este archivo de lote.

Una tarea programada se ejecutará de forma periódica para generar cachés para todos los proyectos de esa instalación de UiPath Process Mining.

Importante:

Se recomienda ejecutar esta tarea fuera de las horas de trabajo para tener el menor impacto posible en los usuarios.

Interpretar resultados

La visualización de datos publicada contiene las instancias de datos generadas para cada módulo.

A continuación se muestra una descripción de los iconos que indican el estado de una instancia.

Icono	Descripción
A	La instancia de datos actualmente activa.
B	Una instancia de datos válida.
C	Una instancia de datos válida, pero con alertas.
D	Una instancia de datos fallida.
E	Una instancia de datos válida pero bloqueada.
F	Una instancia de datos fallida pero marcada como corregida.

Cuando se crea una nueva instancia de datos, se establecerá automáticamente como activa si es válida. Sin embargo, si ha fallado, la última instancia válida permanecerá activa en su lugar.

Visualización del registro detallado de la generación de instancias de datos

A veces es necesario consultar un registro más detallado de la generación de instancias de datos. Por ejemplo, cuando se produce un error o una alerta y quieres ver más detalles.

Sigue estos pasos para ver el registro de una generación de instancias de datos.

Paso	Acción
1	Ve a la pestaña Datos liberados de superadministrador.
2	Haz clic derecho en la instancia de datos de la que quieres ver el registro y selecciona Mostrar registro. (opcional: selecciona los módulos a utilizar, consulta "el cuadro de diálogo Seleccionar instancias")
3	Haz clic en Aceptar.

Se muestra el registro de la generación de la instancia de datos.

Abrir una instancia

Sigue estos pasos para ver una instancia de datos específica.

Paso	Acción
1	Ve a la pestaña Datos liberados de superadministrador.
2	Haz clic derecho en la instancia de datos que quieres abrir y seleccionar Abrir....
3	Haz clic en ABRIR.

El proyecto se abre utilizando la instancia de datos que seleccionaste.

Sobreescribir el estado de una instancia

Bloquear una instancia de datos

A veces, una instancia que se considera válida puede contener un problema. En tal caso, es posible bloquearla para asegurarse de que se desactivo y los usuarios finales no puedan acceder a ella más.

Sigue estos pasos para revertir una caché activa.

Paso	Acción
1	Ve a la pestaña Datos liberados de superadministrador.
2	Haz clic derecho en la instancia de datos en la que se detecta el problema y selecciona Marcar como bloqueado. (Opcional: selecciona los módulos a utilizar, consulta "el cuadro de diálogo Seleccionar instancias")
3	Haz clic en Aceptar. (2x)

La instancia de datos activa se habrá marcado como bloqueada. La instancia de datos actualmente activa será la última instancia de datos que fue válida.

Marcar una instancia de datos como corregida

Cuando un problema con una instancia de datos bloqueada o fallida no es en realidad un problema, es posible marcarla como corregida y reactivarla.

Sigue estos pasos para marcar una instancia de datos como corregida.

Paso	Acción
1	Ve a la pestaña Datos liberados de superadministrador.
2	Haz clic derecho en la instancia de datos en la que se ha corregido y selecciona Marcar como corregida. (opcional: selecciona los módulos a utilizar, consulta "el cuadro de diálogo Seleccionar instancias")
3	Haz clic en Aceptar. (2x)

La instancia de datos activa se debe marcar como válida, y la instancia de datos actualmente activa se establece en la instancia de datos más reciente válida.

El cuadro de diálogo Seleccionar instancias

Cuando se utiliza el menú contextual (haz clic derecho en una instancia) en la pestaña Datos de versión, cada una de las opciones abre un cuadro de diálogo llamado Seleccionar instancias. Consulta la siguiente ilustración.

En este cuadro de diálogo tienes la opción de seleccionar los módulos en los que se aplica la operación seleccionada. Algunas acciones, como Abrir, requieren que se seleccione una sola instancia, mientras que otras permiten múltiples, como Mostrar registros. Dependiendo de dónde hagas clic derecho en la cuadrícula, se seleccionarán inicialmente diferentes módulos en el cuadro de diálogo Seleccionar instancias.

Sigue estos pasos para seleccionar módulos específicos para la acción que estás ejecutando actualmente.

Paso	Acción
1	Ve a la pestaña Datos liberados de superadministrador.
2	Haz clic derecho en la instancia de datos y selecciona cualquiera de las opciones.
3	Haz clic en SELECCIONAR MÓDULOS.
4	Selecciona los módulos que quieres utilizar.
5	Haz clic en Aceptar.

Los módulos que hayas seleccionado se indicarán en el cuadro de diálogo Seleccionar instancias.

Deshacer ajustes

Las instancias más antiguas se eliminarán automáticamente cuando se creen nuevas. Por defecto, solo se mantendrá disponible la última instancia de datos con un error, y las dos últimas instancias de datos válidas.

Es posible aumentar esos números a lo que mejor te convenga. Además, cuando se crea una instancia válida, se eliminan todas las instancias no válidas de más de una semana de antigüedad.

Sigue estos pasos para adaptar los ajustes de reversión.

Paso	Acción
1	Ve a la pestaña Ajustes de superadministrador.
2	En el campo Ajustes del servidor, establece KeepInstancesError en el número de instancias de error que deseas mantener (por ejemplo, “KeepInstancesError”: 2).
3	En el campo de texto Configuración del servidor , establece KeepInstancesOk en el número de instancias válidas que deseas mantener (p. ej. “KeepInstancesOk”: 6)
4	Haz clic en GUARDAR.

La cantidad de instancias de datos válidas y de instancias fallidas se actualizará a los ajustes seleccionados. La próxima vez que se genere una instancia, estos nuevos ajustes se utilizarán para eliminar instancias antiguas.

Correos electrónicos de errores automatizados

Es posible recibir correos electrónicos cuando falla tu generación de caché.

Sigue estos pasos para configurar correos electrónicos de error automatizados.

Paso	Acción
1	Ve a la pestaña Ajustes de superadministrador.
2	En el campo de texto Configuración del servidor , establece SendMailReportTo en el correo electrónico en el que deseas recibir correos electrónicos en caso de fallo. (por ejemplo "SendMailReportTo": "[email]"). (Opcional) En el campo de texto de configuración del servidor, establece SendMailReportId en una cadena que identifique tu servidor. Esto se añadirá al asunto del correo electrónico. (por ejemplo "SendMailReportId": "[id]").
3	Haz clic en GUARDAR.

Cuando se produzca un fallo, se enviará un correo electrónico a la dirección establecida en SendMailReportTo, con SendMailReportIdcomo asunto.

Exportar conjuntos de datos para desarrolladores

Puedes exportar los datos contenidos en una instancia como conjunto de datos de desarrollo. Los desarrolladores pueden utilizar estos conjuntos de datos para no necesitar adquirir datos (por ejemplo, ejecutando consultas) ellos mismos.

Sigue estos pasos para exportar un conjunto de datos para desarrollo.

Paso	Acción
1	Ve a la pestaña Datos liberados de superadministrador.
2	Haz clic derecho en la instancia de datos que deseas exportar y selecciona Exportar datos a desarrollo.... (Opcional: selecciona los módulos a utilizar, consulta "el cuadro de diálogo Seleccionar instancias")
3	Haz clic en Aceptar.
4	Introduce un nombre para el conjunto de datos a exportar y haz clic en Aceptar.

El conjunto de datos exportado se añadirá a los conjuntos de datos de la pestaña Datos de desarrollo.

Información relacionada

Para obtener más información sobre varios entornos, consulta: Entornos.