Utilizar orígenes de datos de script genéricos

Introducción

UiPath Process Mining contiene una funcionalidad que admite el procesamiento de datos con herramientas externas, como script R, Python, JavaScript, Ruby, Swift, etc. que se pueden utilizar como fuente de datos en su aplicación.

Como desarrollador de aplicaciones, puede definir qué atributos deben exportarse al proceso externo.

Nota: Solo los atributos que están explícitamente disponibles para el procesamiento externo están disponibles para su uso en el proceso externo.

Procesar datos con herramientas externas

Información general

Cuando se vuelve a cargar el origen de datos, la plataforma de Process Mining de UiPath generará los atributos definidos en un archivo. Luego, la plataforma ejecuta el proceso externo con los argumentos proporcionados por el desarrollador.

El proceso externo debe hacer su procesamiento leyendo los datos del archivo y escribiendo el resultado en el canal de salida estándar. El proceso externo puede mostrar mensajes como indicaciones de progreso, advertencias y / o errores escribiendo en su canal de errores estándar.

La plataforma de UiPath Process Mining interpreta los datos del canal de salida estándar del proceso como datos separados por punto y coma.

Consulte la siguiente ilustración para obtener una descripción general del flujo de datos desde la plataforma de UiPath Process Mining al proceso externo y viceversa.

Orígenes de datos de script genéricos

La fuente de datos utiliza el controladormvscript , lo que significa que es una fuente de datos de script. El parámetro script utilizado por el controlador mvscript se refiere al script genérico. Por ejemplo, la cadena de conexión:

‘driver={mvscript}; script=Rscript’

se refiere a un origen de datos Rscript.

 

En esta guía, nos referiremos a estas fuentes de datos como una fuente de datos de script genérica. En principio, el script 'genérico' no solo admite scripts, sino cualquier ejecutable que, dada la combinación correcta de argumentos:

• puede leer datos de un archivo
• generar su resultado como datos separados por punto y coma y entre comillas dobles.

Sin embargo, el destino principal para la fuente de datos del script genérico es ejecutar scripts personalizados escritos en R, Python, etc.

Ajustes del servidor

Antes de poder utilizar el origen de datos de script genérico, debes configurar los controladores disponibles en la configuración del servidor. Para ello, añade una clave GenericScriptHandlers a la Configuración del servidor. El valor de esta clave es un objeto, donde:

• cada clave denota un identificador para el tipo de script,
• el valor de cada clave indica la ruta al ejecutable del intérprete del script.

El identificador puede ser cualquier cadena. Sin embargo, se recomienda usar la extensión de sus archivos de script, ya que la plataforma UiPath Process Mining intentará detectar automáticamente el controlador correcto desde la extensión del archivo de script. A continuación se muestra un ejemplo de la configuración del servidor GenericScriptHandlers .

"GenericScriptHandlers": {
    "r": "D:/R/R.exe",
    "py": "P:/Python/bin/python.exe",
    "perl": "C:/Strawberry/perl/bin/perl.exe"
}

Las claves con las extensiones '.r' y '.py' seleccionarán automáticamente los ejecutables de R y Python.

Nota: para los scripts en Perl, que normalmente tienen la extensión '.pl', la detección automática no seleccionará el controlador "perl". En este caso, se puede especificar el parámetro de consulta avanzado scriptType para identificar el controlador deseado.

Permisos

El usuario de Windows que ejecuta Microsoft (es decir, IIS_IUSRS) debe tener el permiso correcto para ejecutar los ejecutables referidos desde los controladores de scripts. De lo contrario, no se podrá encontrar el ejecutable.

Orígenes de datos

Para configurar un origen de datos de script genérico, debes crear una tabla de cadenas de conexión que utilice el controlador mvscript con el script generic . El script genérico tiene varios parámetros, de los cuales normalmente solo se deben especificar los parámetros scriptFile y inputData , ya que la plataforma UiPath Process Mining puede inferir el resto.

 

Resumen de parámetros

La siguiente tabla ofrece una descripción general de los parámetros del script generic .

Parámetro	Descripción	Obligatorio S/N
scriptFile	La ruta de su script. Por ejemplo, resources/my_script.r. Nota: en lugar de scriptFile también puedes usar el argumento scriptText .	N
TipoDeScript	Qué controlador usar para scriptFile. Debe ser uno de los controladores en GenericScriptHandlers.	N
Datos de entrada	Los datos que deben enviarse al script para su procesamiento.	Y
debugPath	Una ruta absoluta a una carpeta. Si se especifica este parámetro, UiPath Process Mining generará: • el archivo de entrada (como se le dio al proceso externo), y • la salida del proceso externo (como se lee de la salida estándar del proceso externo) en esta carpeta para fines de depuración.	N
argumentos	Una matriz de argumentos adicionales para pasar al controlador del script; por ejemplo, cuando se usa Python, esto se puede usar para pasar la marca -I para habilitar el modo aislado. • Al menos uno de los elementos de la matriz debe ser el texto <SCRIPT> para indicar en qué parte de la línea de comandos debe insertarse la ruta al archivo de script. • Al menos uno de los elementos del "array" debe ser el texto <INPUT> para indicar en qué parte de la línea de comando debe insertarse la ruta al archivo de entrada.	N

Table Scope

La ubicación del script se interpreta como relativa al ámbito de la tabla. Por lo tanto, el ámbito de la tabla debe establecerse en Servidor o Espaciode trabajo. Cuando se establece en Ninguno, la ruta al archivo de script no existe y la carga de datos fallará. Puedes establecer el ámbito de la tabla en las Opciones avanzadas.

Datos

Los datos pueden exportarse de la forma más conveniente para el proceso externo de recepción.

Sigue estos pasos para exportar los datos que deseas procesar en un script externo.

Paso	Acción
1	Determina los campos que deben estar disponibles en el script.
2	Crea una nueva tabla global en tu aplicación.
3	Crea un atributo de expresión de búsqueda en la tabla global para cada campo del Paso 1.

Nota: Esta tabla se puede exportar para que el script pueda leerla. La función csvtable() puede utilizarse para convertir los datos a un formato similar al de CSV. Dado que esta función espera una lista de registros (de texto), el tipo de resultado de la expresión de búsqueda debe ser una lista de texto, es decir, un registro con todos los datos codificados en una lista.

Interfaz API

La interfaz entre UiPath Process Mining y cualquier proceso externo al que se acceda a través del origen de datos de script genérico se define como se describe a continuación.

Paso	Descripción
1	UiPath Process Mining crea un archivo que contiene los datos especificados por el parámetro inputData .
2	El proceso externo: Lee los datos del archivo; • realiza su procesamiento; Escribe el resultado en su canal de salida estándar en formato separado por punto y coma y entre comillas dobles. La primera línea de salida debe ser un encabezado que especifique los nombres de las columnas. Por ejemplo: "Case_ID"; "Amount" "110553"; "73650" "110565"; "14420" "110689"; "262370" "110754"; "3500" "110939"; "50270" "111155"; "2400" "111251"; "27530" "111251"; "27530" "111397"; "123450" "111418"; "100"
3	El proceso externo escribe cualquier mensaje de estado en su canal de errores estándar.
4	El proceso externo sale con un código de estado cero, que indica éxito, o un código de estado distinto de cero, que indica fallo.
5	UiPath Process Mining evalúa el código de estado devuelto por el proceso externo Si el código de estado es: • cero, la plataforma analizará el canal de salida estándar del proceso externo como datos separados por punto y coma y entre comillas dobles. Si no es cero, la plataforma mostrará un mensaje de error, incluido cualquier mensaje escrito en el canal de error estándar por el proceso externo. Se cancela la carga de la tabla.