Usar fontes de dados de script genéricas

Introdução

O UiPath Process Mining contém funcionalidades que suportam o processamento de dados com ferramentas externas, como script R, Python, JavaScript, Ruby, Swift, etc., que podem ser usadas como fonte de dados em seu aplicativo.

Como desenvolvedor de aplicativos, você pode definir quais atributos precisam ser exportados para o processo externo.

Nota: Somente os atributos explicitamente disponibilizados para processamento externo estão disponíveis para uso no processo externo.

Processamento de dados com ferramentas externas

Visão geral

Quando a fonte de dados for recarregada, a plataforma UiPath Process Mining produzirá os atributos definidos em um arquivo. A plataforma então executa o processo externo com os argumentos fornecidos pelo desenvolvedor.

O processo externo deve fazer seu processamento lendo os dados do arquivo e gravando o resultado no canal de saída padrão. O processo externo pode mostrar mensagens como indicações de progresso, avisos e/ou erros gravando em seu canal de erro padrão.

Os dados no canal de saída padrão do processo externo são interpretados pela plataforma UiPath Process Mining como dados separados por ponto e vírgula e entre aspas duplas.

Veja a ilustração abaixo para uma visão geral do fluxo de dados da plataforma UiPath Process Mining para o processo externo e vice-versa.

Origens de Dados de Scripts Genéricos

A fonte de dados usa o drivermvscript , o que significa que é uma fonte de dados de script. O parâmetro script usado pelo driver mvscript refere-se ao script genérico. Por exemplo, a string de conexão:

‘driver={mvscript}; script=Rscript’

refere-se a uma fonte de dados Rscript.

 

Neste guia, nos referimos a essas fontes de dados como uma fonte de dados de script genérico. Em princípio, o script 'genérico' não suporta apenas scripts, mas qualquer executável que, dada a combinação certa de argumentos:

• pode ler dados de um arquivo e
• emita seu resultado como dados separados por ponto e vírgula e aspas duplas.

No entanto, o objetivo principal da fonte de dados de script genérico é executar scripts personalizados escritos em R, Python, etc.

Configurações do servidor

Antes de poder usar a fonte de dados de script genérico, você deve configurar os manipuladores disponíveis nas Configurações do servidor. Para fazer isso, adicione uma chave GenericScriptHandlers às Configurações do servidor. O valor desta chave é um objeto, onde:

• cada chave denota um identificador para o tipo de script,
• o valor para cada chave denota o caminho para o executável do interpretador do script.

O identificador pode ser qualquer string. No entanto, é recomendável usar a extensão de seus arquivos de script, porque a plataforma UiPath Process Mining tentará detectar automaticamente o manipulador correto da extensão do arquivo de script. Abaixo está um exemplo da configuração do servidor GenericScriptHandlers .

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

As chaves com as extensões '.r' e '.py' selecionarão automaticamente os executáveis R e Python.

Observação: para scripts Perl, que geralmente têm a extensão '.pl', a detecção automática não selecionará o manipulador “perl”. Nesse caso, o parâmetro de consulta avançada scriptType pode ser especificado para identificar o manipulador desejado.

Permissões

O usuário do Windows que executa o Microsoft (ou seja, IIS_IUSRS) deve ter a permissão correta para executar os executáveis referidos pelos manipuladores de script. Caso contrário, o executável não pode ser encontrado.

Fontes de Dados

Para configurar uma fonte de dados de script genérico, você deve criar uma tabela de cadeia de conexão que usa o driver mvscript com o script generic . O script genérico tem vários parâmetros, dos quais normalmente apenas os parâmetros scriptFile e inputData precisam ser especificados, pois o restante pode ser inferido pela plataforma UiPath Process Mining .

 

Visão geral do parâmetro

A tabela a seguir fornece uma visão geral dos parâmetros de script generic .

Parâmetro	Description	Obrigatório S/N
scriptFile	O caminho para o seu script. Por exemplo, resources/my_script.r. Observação: em vez de scriptFile você também pode usar o argumento scriptText .	N
TipoDoScript	Qual manipulador usar para o scriptFile. Deve ser um dos manipuladores no GenericScriptHandlers.	N
Dados de Entrada	Os dados que devem ser passados para o script para processamento.	Y
debugPath	Um caminho absoluto para uma pasta. Se este parâmetro for especificado, o UiPath Process Mining produzirá: • o arquivo de entrada (conforme fornecido ao processo externo) e • a saída do processo externo (conforme lida na saída padrão do processo externo) nesta pasta para fins de depuração.	N
argumentos	Uma matriz de argumentos adicionais para passar para o manipulador do script, por exemplo, ao usar Python, isso pode ser usado para passar o sinalizador -I para habilitar o modo isolado. • Pelo menos um dos elementos da matriz deve ser o texto <SCRIPT>, para indicar onde, na linha de comando, deve ser inserido o caminho para o arquivo de script. • Pelo menos um dos elementos da matriz deve ser o texto <INPUT> para indicar onde na linha de comando o caminho para o arquivo de entrada deve ser inserido.	N

Table Scope

A localização do script é interpretada como relativa ao escopo da tabela. Portanto, o escopo da tabela deve ser definido como Server ou Workspace. Quando definido como None, o caminho para o arquivo de script não existe e o carregamento de dados falhará. Você pode definir o escopo da tabela nas opções avançadas da tabela.

Dados

Os dados podem ser exportados da maneira mais conveniente para o processo externo receptor.

Siga estas etapas para exportar os dados que deseja processar em um script externo.

Etapa	Ação
1	Determine os campos que precisam estar disponíveis no script.
2	Crie uma nova tabela global em seu aplicativo.
3	Crie um atributo de expressão de pesquisa na tabela global para cada campo da Etapa 1.

Observação: essa tabela pode ser exportada para que o script possa lê-la. A função csvtable() pode ser usada para converter os dados em um formato semelhante a CSV. Como essa função espera uma lista de registros (texto), o tipo de resultado da expressão de pesquisa deve ser uma lista de texto, ou seja, um registro com todos os dados codificados em uma lista.

Interface da API

A interface entre o UiPath Process Mining e qualquer processo externo acessado por meio da fonte de dados do script genérico é definida conforme descrito abaixo.

Etapa	Description
1	O UiPath Process Mining cria um arquivo contendo os dados especificados pelo parâmetro inputData .
2	O processo externo: • lê os dados do arquivo; • realiza seu processamento; • grava o resultado em seu canal de saída padrão em um formato separado por ponto e vírgula e aspas duplas. A primeira linha de saída deve ser um cabeçalho especificando os nomes das colunas. Por exemplo: "Case_ID"; "Amount" "110553"; "73650" "110565"; "14420" "110689"; "262370" "110754"; "3500" "110939"; "50270" "111155"; "2400" "111251"; "27530" "111251"; "27530" "111397"; "123450" "111418"; "100"
3	O processo externo grava qualquer mensagem de status em seu canal de erro padrão.
4	O processo externo sai com um código de status zero, indicando sucesso, ou um código de status diferente de zero, indicando falha.
5	UiPath Process Mining avalia o código de status retornado pelo processo externo Se o código de status for: • zero, a plataforma analisará o canal de saída padrão do processo externo como dados separados por ponto e vírgula e aspas duplas. • diferente de zero, a plataforma exibirá uma mensagem de erro, incluindo quaisquer mensagens gravadas no canal de erro padrão pelo processo externo. O carregamento da tabela é abortado.