process-mining
2023.4
false
Importante :
Este contenido se ha localizado parcialmente a partir de un sistema de traducción automática.
Process Mining
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 14 de ago. de 2024

Loading data using Theobald Xtract Universal

Introducción

En esta página se describe cómo utilizar Theobald Xtract Universal (XU) para cargar datos de tu sistema origen SAP en una aplicación de proceso en Process Mining (Automation Suite). Consulta el sitio web oficial de Theobald Software para obtener más información sobre Theobald Xtract Universal (XU).

Theobald Xtract Universal proporciona un rápido acceso a datos y extracciones en orígenes de datos SAP ECC y SAP HANA. Para obtener instrucciones generales sobre cómo utilizar Theobald Xtract Universal (XU), consulta la documentación oficial del software Theobald Introducción a Theobald Xtract Universal.

Requisitos previos

Asumimos que:

Nota:
Loading data using Theobald Xtract Universal requires that the command line tool (xu.exe) can be executed without additional authentication.

Configurar Theobald Xtract Universal

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 un módulo de funciones personalizadas de solo lectura que debe instalarse en SAP. Utiliza el siguiente enlace para descargar el módulo personalizado: Z_THEO_READ_TABLE-transport1.zip.

Nota:

La licencia se proporciona a través de UiPath con fines de Process Mining.

Sigue estos pasos para configurar Theobald Xtract Universal.

  1. Para descargar la última versión de prueba de Theobald Xtract Universal de nuestra página web, consulta Descargar versión de prueba. Instala Theobald Xtract Universal en un servidor Windows / máquina virtual.

  2. Para comprobar si el acceso a la red de tu sistema SAP está abierto, consulta Puertos SAP TCP/IP.

  3. Para otorgar derechos de usuario SAP para acceder a la instancia SAP, consulta Objetos de autoridad: derechos de usuario de SAP para Tabla.

  4. Los siguientes componentes de Theobald Xtract Universal requieren personalización en SAP: Z_THEO_READ_TABLE.
  5. Configura Theobald Xtract Universal para la(s) plantilla(s) de aplicación requerida(s). Consulta Plantillas de aplicación.

Nota:

Los pasos 2-4 requerirán la validación de tu equipo SAP.

Setup credentials for the SQL Server database

La carga de datos a Process Mining (Automation Suite) requiere acceso a la ubicación de la base de datos de SQL Server a la que deben cargarse los datos extraídos. Para configurar una conexión de destino de SQL Server necesitas los siguientes parámetros de configuración para autenticar el acceso a la ubicación de la base de datos de SQL Server.

  • Servidor
  • Base de datos
  • Esquema
  • Rol

Cargar datos con Theobald Xtract Universal

La configuración de la carga de datos mediante Theobald Xtract Universal requiere varios pasos.

  1. Configura el usuario SQL para cargar los datos;
  2. Importar las extracciones de plantillas;
  3. Configurar el origen
  4. Configurar el destino
  5. Configurar el script de extracción
  6. Ejecuta el script de extracción.

Los pasos se describen en detalle a continuación.

Configuración del usuario SQL para cargar los datos

Cada aplicación de proceso que utilice la opción de cargar datos a través del extractor necesita un usuario de SQL Server con acceso específico al esquema asociado a la aplicación de proceso.

Sigue estos pasos.

Paso

Acción

Sintaxis

1

Crea un inicio de sesión.

Nota:

Debe crearse el inicio de sesión en la base de datos maestra.

CREATE LOGIN <SQL_login_name> WITH PASSWORD = '<Password>'

2

Crea un usuario de base de datos para el inicio de sesión.

Nota:

Este usuario debe crearse en la base de datos de AutomationSuite_ProcessMining_Warehouse.

CREATE USER <User_name> FOR LOGIN <SQL_login_name>

3

Asigna el usuario al rol de base de datos correcto.

SP_ADDROLEMEMBER <Role>, <User_name>

4

Establece el esquema predeterminado para el usuario creado.

Atención:

Este paso solo es necesario para cargar datos utilizando Theobald Xtract Universal.

ALTER USER <User_name> WITH DEFAULT_SCHEMA = <Schema>



Importar las extracciones de plantillas

Sigue estos pasos para importar las extracciones de plantillas en Theobald Xtract Universal.

Paso

Acción

1

Ve a la página Plantillas de aplicaciones y abre la página de documentación de tu plantilla de aplicación.

2

Localiza la sección Cargar datos con Theobald Xtract Universal y descarga el archivo XU_template_extractions_as.zip para la plantilla de tu aplicación. Consulta Plantillas de aplicaciones. Este archivo XU_template_extractions_as.zip contiene las carpetas destinations, extractionsy sources.

3

Copia las carpetas del archivo XU_template_extractions_as.zip descargado a la carpeta config de Xtract Universal. La ubicación de esta carpeta es [XU_installation_path]/ config.

4

Abre Xtract Universal Designer y haz clic en el botón Actualizar para cargar todas las extracciones.

Nota:

Puede iniciar sesión utilizando el usuario predeterminado.

docs image
docs image

Se muestra una lista de todas las extracciones que cada una extrae una tabla del sistema SAP. El origen de la plantilla se llama SAP y el destino de la plantilla se llama SQL Server.

Configurar el origen

Sigue estos pasos para configurar el origen SAP en Theobald Xtract Universal.

Paso

Acción

1

Ve a Servidor - Administrar orígenes y edita el origen de SAP.

2

Rellene la configuración en las pestañas General y Autenticación para conectarse a su sistema SAP.

3

Pruebe la conexión.

Configurar el destino

Sigue estos pasos para configurar el destino de SQL Server en Theobald Xtract Universal.

  1. Ve a Servidor - Administrar destinos y edita el destino de SQL Server.
  2. Rellene la configuración para conectarse a su destino de SQL Server.

Configurar el script de extracción

Sigue estos pasos para configurar el script de extracción.

Paso

Acción

1

Ve a la página Plantillas de aplicaciones y abre la página de documentación de tu plantilla de aplicación.

2

Localiza la sección Cargar datos con Theobald Xtract Universal y descarga el archivo extract_theobald_as.zip para la plantilla de tu aplicación. Este archivo extract_theobald_as.zip contiene el script extract_theobald.ps1 y el archivo config.json .

3

Descomprime el contenido del archivo extract_theobald_as.zip en el servidor donde está instalado Theobald Xtract Universal.

4

Configure las variables para el script en config.json como se indica a continuación.

Variable

Descripción

xu_location

La carpeta de instalación de Xtract Universal. Esta es la carpeta donde puedes encontrar el xu.exe. Por ejemplo: C: \ \ MyFolder.

xu_server

Dirección del servidor donde está instalado Xtract Universal. El valor predeterminado es localhost.

xu_port

Puerto del servidor donde está instalado Xtract Universal. El puerto predeterminado de una instalación es 8065.

as_server

La parte de la URL que indica el servidor en el que se crea la aplicación. Consulta Recuperar los parámetros de la base de datos de SQL Server.

as_organization

Parte de la URL que indica la organización de la aplicación creada. Consulta Recuperar los parámetros de la base de datos de SQL Server.

as_tenant

La parte de la URL que indica el tenant de la aplicación creada. Consulta Recuperar los parámetros de la base de datos de SQL Server.

as_app_ID

El ID de la aplicación creada.

extraction_start_date

Fecha de inicio que se utilizará para limitar las extracciones. Solo las tablas donde se aplica un filtro de fecha se filtran en esta fecha. El formato es YYYYMMDD. El valor predeterminado es que no haya límite indicado por la fecha de inicio 19700101.
Nota: extraction_start_date debe tener un valor.

extraction_end_date

Fecha de finalización que se utilizará para limitar las extracciones. Solo las tablas donde se aplica un filtro de fecha se filtran en esta fecha. El formato es YYYYMMDD. El valor predeterminado es que no haya límite indicado por la fecha de finalización 20991231.
Nota: extraction_end_date debe tener un valor.

language

El idioma en el que se extraen los datos del sistema de origen. El predeterminado es E.

exchange_rate_type

El tipo de cambio que se utiliza para la conversión de divisas. El predeterminado es M.

Ejecutar el script de extracción

Para cargar los datos y utilizarlos en Process Mining, debes ejecutar el archivo extract_theobald.ps1.

El tiempo necesario para esta tarea dependerá en gran medida de los volúmenes de datos cargados.

Iniciar el archivo manualmente

Sigue este paso para iniciar la ejecución de los datos.

Paso

Acción

1

Ejecuta el archivo extract_theobald.ps1 para iniciar la ejecución de datos.
La ejecución de datos también crea un archivo de registro que puede ayudar en caso de resultados inesperados o si falla la carga de datos con el cargador de datos. El archivo extraction.log contiene los registros de la última ejecución de datos. Por cada extracción fallida, se muestra un código de retorno. Consulte la documentación oficial de Theobald Software Llamada a través de la línea de comandos para obtener más información. Cuando algo con la configuración es incorrecto, esto se menciona en el mensaje de error.

Programar una tarea para la ejecución de datos

En lugar de ejecutar el archivo manualmente, puedes utilizar el Programador de tareas de Windows para programar una tarea que ejecute el script por lotes para la actualización automática de datos.

Nota: Se recomienda seleccionar la cuenta de usuario del SISTEMA local para ejecutar la tarea y seleccionar la opción Ejecutar con la máxima prioridad en la ventana Crear tarea al crear la tarea en el Programador de Windows.
Importante:

Si añades un intervalo para el que no hay datos disponibles, los paneles mostrarán un mensaje de error.

Cuando la extracción se realiza correctamente, la ingestión de datos puede fallar debido a la extracción de algunos datos defectuosos. Puedes filtrar estos datos en caso de utilizar Theobald Xtract Universal utilizando la cláusula DONDE. Consulta la documentación oficial de Theobald para obtener más información sobre la cláusula DONDE.

Nota:

Si tiene una cláusula DONDE que usa variables (por ejemplo, la fecha de extracción) no puede filtrar a través de la interfaz de usuario.

Solución de problemas

La ejecución de datos también crea un archivo de registro que puede ayudar en caso de resultados inesperados o si falla la carga de datos con el cargador de datos. El archivo extraction.log contiene los registros de la última ejecución de datos. Por cada extracción fallida, se muestra un código de retorno. Consulte la documentación oficial de Theobald Software Llamada a través de la línea de comandos para obtener más información. Cuando algo con la configuración es incorrecto, esto se menciona en el mensaje de error.

Problemas de extracción con CDPOS para sistemas no HANA

En algunos sistemas antiguos que no son HANA, CDPOS es una tabla de clúster y puede generar un error de "unión con la tabla de billar", como el que se indica a continuación.



La extracción de la tabla CDPOS incluye de forma predeterminada una combinación con la tabla CDHDR para limitar el número de registros que deben extraerse. Sigue estos pasos para superar este error.
  1. Edita la extracción de CDPOS en Xtract Universal Designer para eliminar el CDHDR de las tablas.
  2. Reemplazar CDHDR~UDATE between @extraction_start_date and @extraction_end_date por:

    CHANGENR between @CHANGENR_min and @CHANGENR_max

  3. En extract_theobald.ps1, reemplaza &"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDPOS" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date" con el código que se muestra a continuación.
&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDHDR_CSV" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date"
CheckExtractionError('CDHDR_CSV')
$CDHDR = Import-Csv -Path "$xu_location\<app_template_specific>output\CDHDR_CSV.csv" -Delimiter "`t"
$CDHDR_sorted = $CDHDR | Sort-Object -Property CHANGENR 
$CHANGENR_min=$CDHDR_sorted.GetValue(0).CHANGENR
$CHANGENR_max=$CDHDR_sorted.GetValue($CDHDR_sorted.Count-1).CHANGENR
&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDPOS" -o "CHANGENR_min=$CHANGENR_min" -o "CHANGENR_max=$CHANGENR_max"&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDHDR_CSV" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date"
CheckExtractionError('CDHDR_CSV')
$CDHDR = Import-Csv -Path "$xu_location\<app_template_specific>output\CDHDR_CSV.csv" -Delimiter "`t"
$CDHDR_sorted = $CDHDR | Sort-Object -Property CHANGENR 
$CHANGENR_min=$CDHDR_sorted.GetValue(0).CHANGENR
$CHANGENR_max=$CDHDR_sorted.GetValue($CDHDR_sorted.Count-1).CHANGENR
&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDPOS" -o "CHANGENR_min=$CHANGENR_min" -o "CHANGENR_max=$CHANGENR_max"
Nota: Este es un ejemplo genérico, los nombres de las tablas pueden ser diferentes para tu plantilla de aplicación.
Aviso: Reemplaza la carpeta de salida <app_template_specific> por la carpeta de salida especificada para tu plantilla de aplicación en extract_theobald.ps1.

Otros problemas de extracción

Clave duplicada

Al cargar datos mediante Theobald Xtract Universal, puede aparecer el siguiente mensaje de error:
docs image
Posible causa

Un campo utilizado para la clave principal en la tabla no se recupera en la extracción.

Solución

Para resolver esto, debe verificar si todos los campos usados para la clave principal en la tabla se recuperan en la extracción.

A continuación se muestra un ejemplo de la tabla EKKN . Para esta tabla, la clave principal no está completa porque el campo ZEKKN no se recupera. El problema se puede solucionar asegurándose de que este campo también se utiliza en la extracción.
Consejo:

Las claves primarias en las tablas SAP pueden reconocerse por el símbolo de clave que se muestra delante del nombre del campo.

docs image

¿Te ha resultado útil esta página?

Obtén la ayuda que necesitas
RPA para el aprendizaje - Cursos de automatización
Foro de la comunidad UiPath
Uipath Logo White
Confianza y seguridad
© 2005-2024 UiPath. Todos los derechos reservados.