Cargar datos utilizando Theobald Xtract Universal

Introducción

En esta página se describe cómo utilizar Theobald Xtract Universal (XU) para cargar datos de tu sistema fuente 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 acceso y extracciones de datos rápidos a las fuentes de datos de SAP ECC y SAP HANA. Para obtener instrucciones generales sobre cómo utilizar Theobald Xtract Universal (XU), consulta la documentación oficial de Theobald Software Primeros pasos con Theobald Xtract Universal.

Requisitos previos

Asumimos que:

• una licencia universal de Theobald Xtract válida.
• instalado Theobald Xtract Universal. Consulta la documentación oficial de Theobald Software para obtener más información sobre la instalación de una actualización de Theobald Xtract Universal y la personalización del módulo de funciones para la extracción de tablas en SAP.

Nota:

La carga de datos mediante Theobald Xtract Universal requiere que la herramienta de línea de comandos (xu.exe) pueda ejecutarse sin autenticación adicional.

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

Uploading data to Process Mining (Automation Suite) requires access to the SQL Server database location to which the extracted data needs to be uploaded. To set up a SQL Server destination connection you need the following setup parameters to authenticate access to the SQL Server database location.

• Server
• Database
• Schema
• Role

Consulta Recuperar los parámetros de la base de datos de SQL Server.

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. 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. 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. 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 aplicación y abre la página de documentación de tu plantilla de aplicación.
2	Localiza la sección Cargar datos utilizando Theobald Xtract Universal y descarga el archivo XU_template_extractions_as.zip para tu plantilla de aplicación. Consulta Plantillas de aplicación. Este archivo XU_template_extractions_as.zip contiene las carpetas destinations, extractions y 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.

Se muestra una lista de todas las extracciones en las 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 SAP.
2	Rellena los ajustes en las pestañas General y Autenticación para conectarte a tu 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.

Consulta Recuperar los parámetros de la base de datos de SQL Server para obtener más información.

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 aplicación y abre la página de documentación de tu plantilla de aplicación.
2	Localiza la sección Cargar datos mediante Theobald Xtract Universal y descarga el archivo extract_theobald_as.zip para tu plantilla de 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:\MiCarpeta.
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	La 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. 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. 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. Para cada extracción fallida, se muestra un código de retorno. Consulta 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:

Es recomendable seleccionar la cuenta de usuario local del SISTEMA 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 con éxito, la ingestión de datos puede fallar debido a que se extraen algunos datos defectuosos. Puedes filtrar estos datos mediante Theobald Xtract Universal utilizando la cláusula WHERE. Consulta la documentación oficial de Theobald para obtener más información sobre la cláusula WHERE.

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. Para cada extracción fallida, se muestra un código de retorno. Consulta 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"

Nota:

este es un ejemplo genérico, los nombres de las tablas pueden ser diferentes para tu plantilla de aplicación.

Nota:

Reemplace la carpeta de salida <app_template_specific> con la carpeta de salida especificada para tu plantilla de aplicación en extract_theobald.ps1.

Otros problemas de extracción

Errores de análisis

Cuando la extracción falla con un error de análisis (por ejemplo Unexpected ')'), comprueba la cláusula WHERE de la extracción que está fallando. Asegúrate de que el espacio alrededor de los paréntesis y los valores dentro de ellos sean correctos. Un formato inconsistente puede causar problemas de análisis.

Por ejemplo, name in ('a', ‘b', ‘c’) debe actualizarse a name in ( ‘a’, ‘b’, ‘c’ )).

Después de corregir la cláusula WHERE y guardar la extracción, ejecútala de nuevo.

Metadatos

Puede encontrar errores inesperados durante la extracción. Por ejemplo:

23,O2C_VBAK,2023-05-16_08:46:54.984,4,FinishedErrors,Error,LiveDataExtraction,Theobald.Extractors.Table.TheoReadTableException: Length of the field VBTYP not valid. Given length is 000002 . Length in SAP is 000008

Esto puede deberse al hecho de que las propiedades definidas en las extracciones de la plantilla no coinciden con su sistema SAP.

En Theobald Xtract Universal, selecciona el botón Actualizar metadatos para actualizar las propiedades de los metadatos para reflejar tu sistema SAP y comprueba si el problema está resuelto.

Problemas de extracción incremental

Si tienes un problema con una extracción incremental en Theobald Xtract Universal, puedes restablecer la configuración incremental abriendo la extracción y seleccionando Eliminar recursos CDC.

Esto elimina el registro de la última extracción correcta. La próxima vez que se ejecute la extracción, realizará una carga completa de la tabla. Las extracciones posteriores se ejecutarán de nuevo de forma incremental.

También puedes utilizar esta opción al modificar la configuración de extracción (por ejemplo, al añadir un nuevo campo).

Problemas de tiempo de espera

Durante la extracción, puede que se produzcan problemas de tiempo de espera. Consulta la documentación oficial de SAP para comprobar los parámetros de tiempo de espera disponibles.

Clave duplicada

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

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.

La siguiente ilustración 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.