Example: Creating an R Script

Introducción

Este ejemplo explica cómo interconectar UiPath Process Mining con scripts de R externos para implementar el procesamiento de datos externos.

Instalar R

Siga estos pasos para poder usar R-Script en la plataforma.

Paso	Acción
1	Descargue la última versión del paquete de R https://cran.r-project.org/bin/windows/base/.
2	Instala R en el servidor. Nota: este debe ser el servidor en el que está instalado UiPath Process Mining .
3	Localice el directorio de instalación y busque la ruta de Rscript.exe. Por ejemplo: C: /Apps/Rscript.exe

R está instalado en el servidor y los desarrolladores pueden conectarse a él con una cadena de conexión.

La ruta de instalación es necesaria para crear cadenas de conexión para un script de R.

Importante:

Comience con algunos datos ficticios para probar la configuración de su espacio de trabajo. Por ejemplo, utiliza el ejemplo "Hola, mundo" como se describe en Ejemplo: crear un script de Python. El script R ficticio contendrá: write("Hello world!", stderr()); quit("default", 1)

Información general de alto nivel

En este ejemplo se crea un script R que agrupa los casos en función de sus seguimientos.

Pasos

1. Configurar los ajustes del servidor;
2. Escribiendo el script.
3. Configurar el origen de datos;
4. Configurar una fuente de datos de script;

Configurar los Ajustes de servidor

El origen de datos de script genérico requiere controladores para todos los procesos externos que desea ejecutar.

Sigue estos pasos para añadir el controlador de script para el script R.

Paso	Acción
1	Ve a la pestaña Ajustes de superadministrador.
2	Añade un campo GenericScriptHandlers con como valor un objeto con una clave, "r", que tiene como valor la ruta a tu python ejecutable.Por ejemplo: "GenericScriptHandlers": {"r": "C:/Apps/Rscript.exe",}
3	Haz clic en GUARDAR.

Escribir el Script

En tu editor de texto, crea un archivo de texto en blanco e introduce el siguiente código.

# get command line arguments
args <- commandArgs(trailingOnly=TRUE)
inputfile <- args[1]
# read csv file
input <- file(inputfile, 'r')
df <- read.table(input, header=TRUE, sep=";")
# pre-processing
df <- table(df)
df <- as.data.frame.matrix(df)
df <- df[, sapply(data.frame(df), function(df) c(length(unique(df)))) > 1] #remove columns with unique value 
# cluster
df <- scale(df)
kc <- kmeans(df, centers = 5)
cluster <- kc$cluster
# output
resultdata <- cbind(rownames(df), cluster)
colnames(resultdata)[1] <- 'Case ID'
write.table(resultdata, row.names = FALSE, sep=";", qmethod = "double")

Sigue los siguientes pasos.

Paso	Acción
1	Guarda el archivo de texto como script.r.
2	Cargue el archivo script.r a su espacio de trabajo.

Configurar el origen de datos

Para definir los datos de entrada, crea un atributo que genere una cadena similar a .CSV . Debe colocarse en la tabla Globals , ya que servirá como entrada en una definición de tabla.

Nota:

Puedes utilizar la función csvtable para definir los datos de entrada.

Para este ejemplo, tenemos una aplicación con una tabla de eventos.Consulta la siguiente ilustración.

Sigue estos pasos para crear una expresión de búsqueda R_input_data de la tabla Globales a Eventos.

Paso	Acción
1	Abre la aplicación en tu entorno de desarrollo y ve a la pestaña Datos.
2	Selecciona la tabla Globales . Haz clic con el botón derecho en la tabla Globales en la lista de elementos de la tabla y selecciona Nueva expresión....
3	Configura el tipo de campo como Búsqueda.
4	Selecciona Eventos como tabla de entrada.
5	Introduzca la siguiente expresión: csvtable( 'CaseID', records.text(Case_ID) , 'Activity', records.text(Activity) )
6	Introduce R_input_data en el campo de nombre.
7	Haz clic en Aceptar para guardar el atributo de expresión en la tabla Globales .

El atributo de expresión se crea en la tabla Globales . Consulta la siguiente ilustración.

Configurar un origen de datos Script

A continuación, configure una tabla de fuentes de datos en la aplicación que llamará al script.

Sigue estos pasos para configurar el origen de datos del script.

Paso	Acción
1	En la pestaña Datos , crea una nueva tabla de cadenas de conexión.
2	Cambia el nombre de New_table a RscriptExample.
3	Haz clic derecho en la RscriptExampletabla y después en Avanzado > Opciones....
4	En el cuadro de diálogo Opciones de tabla , establece el Ámbito de la tabla en Espacio de trabajo.
5	Haz doble clic en la tabla RscriptExample para abrir la ventana Editar tabla de cadenas de conexión .
6	Introduce lo siguiente como Cadena de conexión: ``'driver={mvscript
7	Introduce lo siguiente como Consulta: '' +'&scriptFile=' + urlencode("script.r") +'&inputData=' + urlencode(R_input_data) Consulta la siguiente ilustración.
8	Haz clic en Aceptar y haz clic en SÍ para volver a cargar los datos.

Al cargar los datos, se detectan nuevos atributos. Haz clic en SÍ(2 veces) y haz clic en Aceptar.

La tabla Rscript_example ahora tiene dos atributos de origen de datos, Case_ID y cluster.

Consulta la siguiente ilustración.

Definición del script R en el campo de consulta

En lugar de utilizar un archivo independiente que contenga el script R, también puedes definir el script R en el campo Consulta del cuadro de diálogo Editar cadena de conexión . En este caso, utilizas el parámetro scriptText en lugar del parámetro scriptFile .

Consulta la siguiente ilustración.