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. Observação: 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: criação de um script do Python. O script R fictício passará a conter: 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 dados de entrada, crie um atributo que gere uma string .CSV como. Ela deve ser colocada na tabela Globais , já que servirá como entrada na definição de uma tabela.

Observação:

Você pode usar a função csvtable para definir 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 Globais até Eventos.

Etapa	Ação
1	Abra o aplicativo em seu ambiente de desenvolvimento e vá para a guia Dados.
2	Selecione a tabela Globais . Clique com o botão direito do mouse na tabela Globais 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	Insira R_input_data no campo Nome.
7	Clique em OK para salvar o atributo de expressão na tabela Globais .

O atributo de expressão é criado na tabela Globais . 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 strings 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 Opções de tabela , defina o escopo da tabela como Espaço de trabalho.
5	Clique duas vezes na tabela RscriptExample para abrir a janela Editar tabela de strings 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 OK e 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 datasource, 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 string de conexão . Neste caso, você usa o parâmetro scriptText em vez do parâmetro scriptFile .

Veja a ilustração abaixo.