Instalar el extractor de datos de UiPath

El extractor de datos local de UiPath debe instalarse en el mismo entorno de red que el origen de datos (por ejemplo, el sistema SAP). Por ejemplo, si SAP está alojado en una nube o centro de datos privado, el extractor de datos de UiPath debe implementarse dentro de ese mismo entorno o segmento de red para garantizar una conectividad fiable y segura.

Nota:

Si no es posible instalar el extractor de datos de UiPath dentro de la misma red que el sistema SAP, es posible instalarlo fuera de la red privada. En ese caso, debes abrir los puertos necesarios (por ejemplo, 33<xx>) en el sistema SAP, donde <xx> corresponde al número de sistema SAP, para permitir la comunicación entrante y saliente entre el extractor de datos de UiPath y el servidor SAP.

Si se utiliza un proxy, debe reenviar el mismo puerto 33<xx> del proxy al puerto 33<xx> correspondiente en el sistema SAP. Esto se debe a que Theobald RFC no admite la conexión a puertos personalizados o reasignados; espera conectarse utilizando el formato de puerto predeterminado basado en el número de sistema SAP.

Consulta la documentación oficial de Theobald sobre los requisitos de puerto para obtener más información.

La instalación del extractor de datos local de Uipath implica los siguientes pasos.

1. Configura tu organización de UiPath Automation Cloud.
2. Instala el extractor de datos de UiPath en tu entorno local.
3. Instala el RFC de Theobald en tu servidor SAP.
   Nota: Este paso solo es necesario al instalar el extractor de datos de UiPath para la extracción de datos de SAP.

1. Configurar la organización de UiPath Cloud

Sigue estos pasos para configurar la organización de UiPath Cloud para el extractor de datos de Uipath.

1. En Automation Cloud, ve a Administrador.
2. Selecciona el mosaico Aplicaciones externas para añadir una aplicación externa.
3. En la pestaña Aplicaciones OAuth , selecciona +Añadir aplicación.
4. Introduce un nombre descriptivo para la nueva aplicación en el campo Nombre de la aplicación . Por ejemplo, "Extractor local de Process Mining".
5. Selecciona +Añadir ámbitos.
   1. Selecciona Acceso a la API de Process Mining en la lista de Recursos.
   2. Selecciona Ámbito(s) de aplicación y selecciona la opción ProcessMining.DataExtractor para habilitar el acceso a Process Mining.
   3. Selecciona Guardar.
6. En la página Añadir aplicación , selecciona Añadir. Se muestra un mensaje de confirmación
7. Copia y pega el ID de la aplicación y el Secreto de la aplicación, por ejemplo, en el Bloc de notas.
   Nota: Necesitarás el ID de la aplicación y el Secreto de la aplicación durante la instalación del extractor de datos local en el entorno local.
8. Selecciona Cerrar.

2. Instalar el extractor de datos de UiPath en el entorno local

Requisitos previos

El extractor de datos local de UiPath requiere la instalación de .NET 8 ASP.NET Core Runtime. Puedes descargar la última versión desde el sitio web oficial de Microsoft .NET.

Descargar el extractor de datos local de UiPath

Utiliza el siguiente enlace para descargar el extractor de datos local de UiPath:

https://uipath.blob.core.windows.net/download/UiPathDataExtractor.zip

Pasos de la instalación

1. Extrae el paquete de instalación.
2. Abre PowerShell como administrador en la carpeta extraída.
3. Configura DataExtractor/appsettings.json con tus ajustes.
   Nota: necesitará guardar el ID de la aplicación y el Secreto de la aplicación al configurar la organización de UiPath Cloud.
   Importante: Asegúrate de que las credenciales de usuario definidas en ConnectionString tengan acceso a las tablas que deseas extraer.

   {
   "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. Ejecuta el script de instalación utilizando el siguiente comando de Powershell: ./Setup.ps1 -Install.

Nota: sigue estos pasos para añadir, editar o eliminar conexiones de SQL Server o SAP:

1. Edita el archivo appsettings.json y actualiza los valores según sea necesario.
2. Vuelve a ejecutar el comando de instalación ./Setup.ps1 -Install.

Consejo: para obtener opciones de script adicionales, puedes utilizar el siguiente comando de Powershell: ./Setup.ps1 -Help

3. Instalar Theobald RFC en tu servidor SAP

Theobald Xtract Universal es la herramienta de extracción certificada por SAP que se utiliza para la extracción de datos de los sistemas fuente SAP, que se integra con SAP a través de Llamada de función remota (RFC). Theobald Xtract Universal contiene el módulo de funciones personalizadas de solo lectura Z_THEO_READ_TABLE-transport1que debe instalarse en SAP.

La carpeta XtractCore/Transports del extractor de datos de UiPath contiene varias versiones de llamadas de función remota (RFC) utilizadas para leer tablas, junto con un archivo README que proporciona detalles sobre cada versión.

Consulta Configurar Theobald Xtract Universal (Pasos 2 a 4) para obtener más información sobre la configuración del entorno SAP para que se ejecute con el extractor de datos de UiPath.

Desinstalar el extractor de datos de UiPath

Utiliza el siguiente comando de Powershell para desinstalar el extractor de datos de UiPath ./Setup.ps1 -Uninstall.

Todos los servicios subyacentes se detienen y se desinstalan.