Example: Creating an R Script

Introdução

Este exemplo explica como implantar a interface da plataforma UiPath Process Mining com scripts R externos para implementar o processamento de dados externo.

Instalação do R

Siga estas etapas para poder usar o R-script na plataforma.

Etapa	Ação
1	Baixe a versão mais recente do pacote R em https://cran.r-project.org/bin/windows/base/.
2	Instale o R no servidor. Nota: este deve ser o servidor no qual o UiPath Process Mining está instalado.
3	Localize o diretório de instalação e localize o caminho do Rscript.exe. Por exemplo: C:/Apps/Rscript.exe

R é instalado no servidor e os desenvolvedores podem se conectar a ele com uma string de conexão.

O caminho de instalação é necessário para criar strings de conexão para um script R.

Importante:

Comece com alguns dados fictícios para testar a configuração do seu espaço de trabalho. Por exemplo, use o exemplo “Hello World” conforme descrito em Exemplo: Criando um script Python.

O script R fictício conterá então:

write("Hello world!", stderr()); quit("default", 1)

Visão geral de alto nível

Neste exemplo, é criado um script R que agrupa casos com base em seus rastreamentos.

Etapas

1. Definir as configurações do servidor;
2. Escrevendo o roteiro.
3. Configurando a fonte de dados;
4. Configurando uma fonte de dados de script;

Definição das configurações dos servidores

A fonte de dados de script genérico requer manipuladores para todos os processos externos que você deseja executar.

Siga estas etapas para adicionar o manipulador de script para o script R.

Etapa	Ação
1	Vá para a aba Configurações de Superadmin.
2	Adicione um campo GenericScriptHandlers tendo como valor um objeto com uma chave, "r", que tem como valor o caminho para seu executável do Python. Por exemplo: "GenericScriptHandlers": {"r": "C:/Apps/Rscript.exe",}
3	Clique em SALVAR.

Escrever o script

Em seu editor de texto, inicie um arquivo de texto em branco e insira o código a seguir.

## 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")

Siga as etapas abaixo.

Etapa	Ação
1	Salve o arquivo de texto como script.r.
2	Carregue o arquivo script.r em seu espaço de trabalho.

Configuração da fonte de dados

Para definir os dados de entrada, crie um atributo que gere uma string semelhante a .CSV . Deve ser colocado na tabela Globals , pois servirá como entrada na definição de uma tabela.

Observação: você pode usar a função csvtable para definir os dados de entrada.

Para este exemplo, temos um aplicativo com uma tabela Eventos. Veja a ilustração abaixo.

Siga estas etapas para criar uma expressão de pesquisa R_input_data da tabela Globals para Events.

Etapa	Ação
1	Abra o aplicativo em seu ambiente de desenvolvimento e vá para a guia Dados.
2	Selecione a tabela Globals . Clique com o botão direito do mouse na tabela Globals na lista de itens da tabela e selecione Nova expressão….
3	Defina o tipo como Pesquisa.
4	Selecione Eventos como tabela de entrada.
5	Digite a seguinte expressão: csvtable( 'CaseID', records.text(Case_ID) , 'Activity', records.text(Activity) )
6	Digite R_input_data no campo de nome.
7	Clique em OK para salvar o atributo de expressão na tabela Globals .

O atributo de expressão é criado na tabela Globals . Veja a ilustração abaixo.

Configuração de uma fonte de dados de scripts

Em seguida, configure uma tabela de fonte de dados no aplicativo que chamará o script.

Siga estas etapas para configurar a fonte de dados do script.

Etapa	Ação
1	Na guia Dados , crie uma nova tabela de cadeia de conexão.
2	Renomeie o New_table para RscriptExample.
3	Clique com o botão direito do mouse na tabela RscriptExample e clique em Avançado > Opções....
4	Na caixa de diálogo Table Options , defina o Table scope como Workspace.
5	Clique duas vezes na tabela RscriptExample para abrir a janela Editar tabela de cadeia de conexão .
6	Digite o seguinte como string de conexão: ``'driver={mvscript
7	Digite o seguinte como Consulta: '' +'&scriptFile=' + urlencode("script.r") +'&inputData=' + urlencode(R_input_data) Veja a ilustração abaixo.
8	Clique em OKe clique em SIM para recarregar os dados.

Ao carregar os dados, novos atributos são detectados. Clique em SIM(2x) e clique em OK.

A tabela Rscript_example agora tem dois atributos de fonte de dados, Case_ID e cluster.

Veja a ilustração abaixo.

Definindo o Script R no Campo de Consulta

Em vez de usar um arquivo separado contendo o script R, você também pode definir o script R no campo Consulta da caixa de diálogo Editar cadeia de conexão . Nesse caso, você usa o parâmetro scriptText em vez do parâmetro scriptFile .

Veja a ilustração abaixo.