Instalando o extrator de dados UiPath

O extrator de dados no local da UiPath deve ser instalado dentro do mesmo ambiente de rede da origem de dados (por exemplo, o sistema SAP). Por exemplo, se o SAP estiver hospedado em uma nuvem privada ou data center, o extrator de dados da UiPath deve ser implantado dentro do mesmo ambiente ou segmento de rede para garantir uma conectividade confiável e segura.

Observação:

Se não for possível instalar o extrator de dados UiPath dentro da mesma rede que o sistema SAP, é possível instalá-lo fora da rede privada. Nesse caso, você deve abrir as portas necessárias (por exemplo, 33<xx>) no sistema SAP, onde <xx> corresponde ao número do sistema SAP, para permitir a comunicação de entrada e saída entre o extrator de dados da UiPath e o servidor SAP. Se um proxy for usado, ele deve encaminhar a mesma porta 33<xx> do proxy para a porta 33<xx> correspondente no sistema SAP. Isso ocorre porque o Theobald RFC não é compatível com a conexão a portas personalizadas ou remapeadas — ele espera conectar-se usando o formato de porta padrão com base no número do sistema SAP. Consulte a documentação oficial do Theobald sobre requisitos de porta para obter mais informações.

A instalação do extrator de dados no local da Uipath envolve as seguintes etapas.

1. Configure sua organização do UiPath Automation Cloud.
2. Instale o extrator de dados UiPath em seu ambiente local.
3. Instale o Theobald RFC no seu servidor SAP.
   Observação:

   Essa etapa é necessária apenas ao instalar o extrator de dados UiPath para extração de dados SAP.

1. Configuração da organização do UiPath Cloud

Siga estas etapas para configurar a organização UiPath Cloud para o extrator de dados Uipath.

1. No Automation Cloud, acesse Admin.
2. Selecione o bloco Aplicativos externos para adicionar um aplicativo externo.
3. Na guia Aplicativos OAuth , selecione +Adicionar aplicativo.
4. Digite um nome descritivo para o novo aplicativo no campo Nome do aplicativo . Por exemplo, "Extrator do Process Mining local".
5. Selecione +Adicionar escopos.
   1. Selecione Acesso à API do Process Mining na lista de Recursos.
   2. Selecione Escopo(s) do aplicativo e selecione a opção ProcessMining.DataExtractor para habilitar o acesso ao Process Mining.
   3. Selecione Salvar.
6. Na página Adicionar aplicativo , selecione Adicionar. Uma mensagem de confirmação é exibida
7. Copie e cole o ID do aplicativo e o Segredo do aplicativo, por exemplo, no Bloco de Notas.
   Observação:

   Você precisará do ID do aplicativo e do Segredo do aplicativo durante a instalação do extrator de dados no local no ambiente local.

8. Selecione Fechar.

2. Instalação do extrator de dados UiPath no ambiente local

Pré-requisitos

O extrator de dados no local da UiPath requer a instalação do.NET 8 ASP.NET Core Runtime. Você pode baixar a versão mais recente do site oficial do Microsoft.NET.

Download do extrator de dados no local da UiPath

Use o link a seguir para baixar o extrator de dados no local da UiPath:

https://uipath.blob.core.windows.net/download/UiPathDataExtractor-2025-11-07.zip

Passos de instalação

1. Extraia o pacote de instalação.
2. Abra o PowerShell como administrador na pasta extraída.
3. Configure DataExtractor/appsettings.json com suas configurações.
   Importante:

   Certifique-se de que as credenciais de usuário definidas no ConnectionString tenham acesso às tabelas que você deseja extrair. Você precisará salvar o ID do aplicativo e o Segredo do aplicativo ao configurar a organização do UiPath Cloud.

   {
   "UiPathURL": "https://cloud.uipath.com/<OrgName>/<TenantName>",
   "S2S": {
       "ClientId": "<Application id from UiPath admin portal>",
       "ClientSecret": "<Application secret from UiPath admin portal>"
   },
   "LogFilePath": "<OPTIONAL: Path to log file, otherwise will be in /Logs>",
   "Connections":[
      {
        "Type": "sapOnPrem",
        "Name": "<Connection Name>",
        "ConnectionString": "USER=<User>;PASSWORD=<Password>;LANG=<Language>;CLIENT=<ClientNumber>;HOST=<Host IP address>;SYSNR=<System number>;FUNCTIONMODULE=<Function module name>;"
      },
       {
         "Type": "sqlServer",
         "Name": "<Connection Name>",
         "ConnectionString": "Server=<ServerAddr>;Initial Catalog=<DatabaseName>;User Id=<User>;Password=<Password>;"
       }
    ]
   }
   

4. Execute o script de instalação usando o seguinte comando do Powershell: ./Setup.ps1 -Install.
   Observação:

   Siga estas etapas para adicionar, editar ou remover conexões do SQL Server ou SAP:

   1. Edite o arquivo appsettings.json e atualize os valores conforme necessário.
   2. Execute novamente o comando de instalação ./Setup.ps1 -Install.

Para obter opções adicionais de script, você pode usar o seguinte comando do Powershell: ./Setup.ps1 -Help

3. Instalação do Theobald RFC no seu servidor SAP

O Theobald Xtract Universal é a ferramenta de extração certificada pela SAP usada para extrair dados dos sistemas de origem SAP, integrando-se ao SAP por meio de Chamadas de Função Remota (RFC). O Theobald Xtract Universal contém um módulo de função personalizado somente leitura Z_THEO_READ_TABLE-transport1 que deve ser instalado no SAP.

A pasta XtractCore/Transports do extrator de dados UiPath contém várias versões de Chamadas de Função Remota (RFCs) usadas para ler tabelas, juntamente com um arquivo README que fornece detalhes sobre cada versão.

Consulte Configuração do Theobald Xtract Universal (etapas 2 a 4) para obter mais informações sobre como configurar o ambiente SAP para ser executado com o extrator de dados da UiPath.

Desinstalando o extrator de dados da UiPath

Use o seguinte comando do Powershell para desinstalar o extrator de dados da UiPath ./Setup.ps1 -Uninstall.

Todos os serviços subjacentes são interrompidos e desinstalados.