Configurar Atualizações de Dados Automatizadas

Introdução

Se você deseja fazer carregamentos de dados frequentes ou em intervalos para o UiPath Process Mining, pode configurar atualizações de dados automatizadas. Este guia descreve como configurar atualizações de dados automatizadas usando um script em lote.

Ao executar o script, a estrutura de pastas para um conjunto de dados usando o nome do conjunto de dados que você especificou é gerada primeiro. Em seguida, todas as tabelas no conector são recarregadas e armazenadas em cache para o módulo especificado. Essas tabelas em cache são usadas para exportar as tabelas de saída do conector. O conjunto de dados de saída é usado para gerar um cache para o aplicativo no ambiente especificado.

Pré-requisitos

Você precisa ter acesso ao servidor ou máquina virtual que contém a instalação do UiPath Process Mining .

Você também precisa ter um conector em um espaço de trabalho.

Observação: o script representará seu espaço de trabalho. Você deve criar um espaço de trabalho para o conector e certificar-se de que o espaço de trabalho seja mantido atualizado. A atualização de dados usará o espaço de trabalho especificado como está, usando todas as alterações não confirmadas, se houver. Portanto, é recomendável ter um espaço de trabalho dedicado apenas para a atualização de dados.

Importante:

Este script em lote requer que a construção da área de trabalho e do Superadmin sejam idênticas. Se você atualizar o build do Superadmin sem alterá-lo para o espaço de trabalho (ou vice-versa), o script falhará, resultando em dados não atualizados.

Portanto, é recomendável atualizar a compilação em todos os locais (Superadmin, conector e outros aplicativos) ao mesmo tempo.

Passo 1: Preparação

Crie um script em lote que você deseja usar para as atualizações automatizadas de dados do exemplo de código abaixo e salve-o na pasta raiz de sua instalação do UiPath Process Mining .

Nota: Recomenda-se incluir o nome do processo e o nome do sistema no nome do arquivo em lote.

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax\_datasets\%DATASET%"
mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org"
echo. > "%MAINDIR%\datax\_datasets\%DATASET%\nomodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax\_datasets\%DATASET%\_org\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*

Passo 2: Defina os Parâmetros no Script

Abaixo está uma descrição dos parâmetros que você precisa especificar no script.

Parâmetro	Description
ConjuntoDeDados	o nome do conjunto de dados de saída que você deseja gerar a partir do script. Este conjunto de dados aparecerá na guia de dados de desenvolvimento do Superadmin .
Ambiente	o ambiente para o qual você deseja gerar um cache. Nota: Geralmente este será o ambiente em que o AppOne para o seu processo está ativo.
Workspace	o caminho para o espaço de trabalho onde o conector está localizado. Este é o seu nome de login seguido pelo nome do espaço de trabalho. Se o script não encontrar o espaço de trabalho correto, tente usar uma barra em vez de uma barra invertida.

Nome do Espaço de Trabalho

Siga estas etapas para determinar o caminho para o espaço de trabalho.

Etapa	Ação
1	Vá para a pasta de instalação do UiPath Process Mining .
2	Vá para a pasta de espaços de trabalho.
3	Vá para a pasta [seu nome de login] . A pasta contém uma pasta para cada uma das suas áreas de trabalho.

Importante:

Quando seu nome de login contém caracteres especiais, a pasta de nome de usuário é codificada para HTML. No entanto, para uso no script, o % precisa ser escapado usando três %s adicionais.

Por exemplo: se seu nome de usuário for [e-mail] , isso se transformará na pasta test%2Eexample%40uipath%2Ecom. No script, o nome de usuário deve ser especificado como test%%%%2Eexample%%%%40uipath%%%%2Ecom. Se o nome de usuário contiver um sublinhado ('_'), esse sublinhado precisa ser escapado com %%%%5F.

Etapa 3: adicionar o código do módulo conector

Alguns conectores têm vários módulos, portanto, você precisa especificar o código do módulo para o conector para o qual deseja implementar atualizações de dados automatizadas.

Adicione o código do módulo do seu conector no loop for %M in (…) do .

Siga estas etapas para localizar o código do módulo e adicioná-lo ao script.

Etapa	Ação
1	Abra o conector em seu ambiente de desenvolvimento.
2	Clique no ícone do logotipo e selecione Módulos....
3	Copie o código do módulo do campo Application Code .
4	Clique em CANCELAR para fechar a caixa de diálogo Módulos.
5	Feche o conector.
6	No script, substitua o "..." dentro do ( ) pelo código do módulo do seu conector no loop for %M in (…) do .

Etapa 4: Agendar uma tarefa para a sincronização

Você pode usar o Agendador de Tarefas do Windows para agendar uma tarefa que executa o script em lote para atualizações automatizadas de dados.

Observação: Recomenda-se selecionar a conta de usuário local do SISTEMA para executar a tarefa e selecione a opção Executar com prioridade máxima na janela Criar Tarefa ao criar a tarefa no Windows Scheduler.

O tempo necessário para esta tarefa dependerá muito dos volumes de dados que passam pelo seu conector. Se a tarefa estiver sendo executada por muito tempo, é recomendável considerar as seguintes coisas, em ordem:

• Minimize o volume de dados entrando no conector;
• Verifique se há condições de união errôneas que causam duplicação de dados;

• Remova quaisquer atributos não utilizados no conector (cada atributo adicional no conector aumenta o tempo de execução do script).

  Importante: É altamente recomendável cancelar a tarefa após ela estar em execução por mais de 3 dias.

Formato do conjunto de dados

Os conjuntos de dados para uso com Process Mining possuem um formato específico, que depende de um marcador. Este marcador é armazenado na raiz do conjunto de dados. Veja a ilustração abaixo para um exemplo.

O marcador é apenas um arquivo vazio e é usado apenas para seu nome. Existem dois marcadores diferentes: nomodcodes.marker e usemodcodes.marker.

O usemodcodes.marker só é aplicável quando a fragmentação de dados é usada para definir o escopo dos dados.

Nomodcodes.marker

O nomodcodes.marker usa a estrutura de dados exibida abaixo.

<DATASET NAME>\<ORGANIZATION CODE>\MVNCache

Abaixo encontra-se uma descrição dos elementos do nomodcodes.marker.

Element	Descrição
<DATASET NAME>	O nome que é exibido no Superadmin Guiade dados de desenvolvimento .
<ORGANIZATION CODE>	O valor padrão é: _org , que será para 99% dos casos

Usemodcodes.marker

O usemodcodes.marker usa a estrutura de dados exibida abaixo.

<DATASET NAME>\<ORGANIZATION CODE>\<MODULE CODE>\MVNCache

Abaixo encontra-se uma descrição dos elementos do usemodcodes.marker.

Element	Descrição
<DATASET NAME>	O nome que é exibido no Superadmin Guiade dados de desenvolvimento .
<ORGANIZATION CODE>	O valor padrão é: _org , que será para 99% dos casos
<MODULE CODE>	O código definido no aplicativo. Veja Módulos. Esta opção permite que você use vários códigos de aplicativo em um aplicativo.

O script fornecido na Etapa 1 se aplica a nomodcodes.marker. Para usemodcodes.marker você deve usar o script abaixo.

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax\_datasets\%DATASET%"
mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org"
echo. > "%MAINDIR%\datax\_datasets\%DATASET%\usemodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org\%%M\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax\_datasets\%DATASET%\_org\%%M\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*