Configuración de actualizaciones de datos automatizadas

Introducción

Si quieres realizar cargas de datos frecuentes o por intervalos para UiPath Process Mining , puedes configurar actualizaciones de datos automatizadas. Esta guía describe cómo configurar actualizaciones de datos automatizadas mediante un script por lotes.

Al ejecutar el script, primero se genera la estructura de carpetas para un conjunto de datos con el nombre del conjunto de datos que especificó. Luego, todas las tablas del conector se vuelven a cargar y se almacenan en caché para el módulo especificado. Estas tablas en caché se utilizan para exportar las tablas de salida desde el conector. El conjunto de datos de salida se utiliza para generar una caché para la aplicación en el entorno especificado.

Requisitos previos

Debe tener acceso al servidor o la máquina virtual que contiene la instalación de UiPath Process Mining .

También necesita un conector en un espacio de trabajo.

Nota: El script se hará pasar por su espacio de trabajo. Debe crear un espacio de trabajo para el conector y asegurarse de que el espacio de trabajo se mantiene actualizado. La actualización de datos utilizará el espacio de trabajo especificado tal como está, usando todos los cambios no confirmados, si los hay. Por lo tanto, se recomienda tener un espacio de trabajo dedicado solo para la actualización de datos.

Importante:

Este script por lotes requiere que la creación del Workspace y el superadministrador sean idénticos. Si actualiza la compilación del superadministrador sin cambiarla para el espacio de trabajo (o viceversa), el script fallará y no se actualizarán los datos.

Por tanto, se recomienda actualizar la compilación en todos los lugares (superadministrador, conector y otras aplicaciones) al mismo tiempo.

Paso 1: Preparación

Crea un script por lotes que desees utilizar para las actualizaciones de datos automatizadas a partir del siguiente código de muestra y guárdalo en la carpeta raíz de tu instalación de UiPath Process Mining .

Nota: se recomienda incluir el nombre del proceso y el nombre del sistema en el nombre del archivo por lotes.

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax\_datasets\%DATASET%"
mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org"
echo. > "%MAINDIR%\datax\_datasets\%DATASET%\nomodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax\_datasets\%DATASET%\_org\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*

Paso 2: establecer los parámetros en el script

A continuación se muestra una descripción de los parámetros que debe especificar en el script.

Parámetro	Descripción
ConjuntoDeDatos	el nombre del conjunto de datos de salida que desea generar a partir del script. Este conjunto de datos se mostrará en la pestaña de datos de Desarrollo de superadministrador .
Entorno	el entorno para el que quieres generar una caché. Nota: Por lo general, este será el entorno en el que está activo AppOne para su proceso.
Espacio de trabajo	la ruta al espacio de trabajo donde se encuentra el conector. Este es su nombre de inicio de sesión seguido del nombre del espacio de trabajo. Si el script no puede encontrar el espacio de trabajo correcto, intente utilizar una barra inclinada en lugar de una barra invertida.

WorkspaceName

Sigue estos pasos para determinar la ruta al espacio de trabajo.

Paso	Acción
1	Ve a la carpeta de instalación de UiPath Process Mining .
2	Ve a la carpeta de espaciosde trabajo.
3	Vaya a la carpeta [su nombre de inicio de sesión] . La carpeta contiene una carpeta para cada uno de sus espacios de trabajo.

Importante:

Cuando su nombre de inicio de sesión contiene caracteres especiales, la carpeta del nombre de usuario está codificada en HTML. Sin embargo, para su uso en el script, el% debe escaparse utilizando tres% s adicionales.

Por ejemplo: si su nombre de usuario es [e-mail] , se convertirá en la carpeta test%2Eexample%40uipath%2Ecom. En el script, el nombre de usuario debe especificarse como test%%%%2Eexample%%%%40uipath%%%%2Ecom. Si el nombre de usuario contiene un guion bajo ('_'), este guion bajo debe escaparse con %%%%5F.

Paso 3: Agregar el código del módulo del conector

Algunos conectores tienen múltiples módulos, por lo que necesitará especificar el código de módulo para el conector para el que quiere implementar actualizaciones de datos automatizadas.

Añada el código de módulo de su conector en el bucle for %M in (…) do .

Sigue estos pasos para encontrar el código del módulo y añadirlo al script.

Paso	Acción
1	Abre el conector en tu entorno de desarrollo.
2	Haga clic en el icono del logotipo y seleccione Modulos ....
3	Copia el código de módulo del campo Código de aplicación .
4	Haz clic en CANCELAR para cerrar el cuadro de diálogo de módulos.
5	Cierra el conector.
6	En el script, reemplaza "..." dentro de () con el código de módulo de tu conector en el bucle for %M in (…) do .

Paso 4: Programar una tarea para la sincronización

Puedes usar el Programador de tareas de Windows para programar una tarea que ejecute el script por lotes para actualizaciones de datos automatizadas.

Nota: Se recomienda seleccionar la cuenta de usuario del SISTEMA local para ejecutar la tarea y seleccionar la opción Ejecutar con la máxima prioridad en la ventana Crear tarea al crear la tarea en el Programador de Windows.

El tiempo que lleve esta tarea dependerá en gran medida de los volúmenes de datos que se muevan a través de su conector. Si la tarea se ejecuta durante demasiado tiempo, se recomienda tener en cuenta los siguientes puntos, en orden:

• Minimice el volumen de datos que va al conector;
• Compruebe si hay condiciones de unión erróneas que provoquen la duplicación de datos;

• Elimina cualquier atributo no utilizado en el conector (cada atributo adicional en el conector aumenta el tiempo de ejecución del script).

  Importante: se recomienda encarecidamente cancelar la tarea después de que haya estado en ejecución durante más de 3 días.

Formato del conjunto de datos

Los conjuntos de datos para usar con Process Mining tienen un formato específico, que depende de un marcador. Este marcador se almacena en la raíz del conjunto de datos. Consulta la siguiente ilustración para ver un ejemplo.

El marcador es solo un archivo vacío y solo se usa por su nombre. Hay dos marcadores diferentes: nomodcodes.marker y usemodcodes.marker.

usemodcodes.marker solo se aplica cuando se usa la fragmentación de datos para establecer el ámbito de los datos.

Nomodcodes.marcker

nomodcodes.marker utiliza la estructura de datos como se muestra a continuación.

<DATASET NAME>\<ORGANIZATION CODE>\MVNCache

A continuación, se describen los elementos de la nomodcodes.marker.

Elemento	Descripción
<DATASET NAME>	El nombre que se muestra en el Pestañade datos de desarrollo .
<ORGANIZATION CODE>	El valor predeterminado es _org , que será el 99% de los casos

UseModcodes.marcker

usemodcodes.marker utiliza la estructura de datos como se muestra a continuación.

<DATASET NAME>\<ORGANIZATION CODE>\<MODULE CODE>\MVNCache

A continuación, se describen los elementos de la usemodcodes.marker.

Elemento	Descripción
<DATASET NAME>	El nombre que se muestra en el Pestañade datos de desarrollo .
<ORGANIZATION CODE>	El valor predeterminado es _org , que será el 99% de los casos
<MODULE CODE>	El código que se establece en la aplicación. Consulta módulos. Esta opción te permite utilizar varios códigos de aplicación en una aplicación.

El script proporcionado en el paso 1. se aplica a nomodcodes.marker. Para usemodcodes.marker , debes usar el siguiente script.

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax\_datasets\%DATASET%"
mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org"
echo. > "%MAINDIR%\datax\_datasets\%DATASET%\usemodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org\%%M\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax\_datasets\%DATASET%\_org\%%M\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*