process-mining

2023.4

false

Importante :

Este contenido se ha localizado parcialmente a partir de un sistema de traducción automática.

Process Mining

ENTREGA:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Last updated 17 de oct. 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:

una licencia universal de Theobald Xtract válida.
ha instalado Theobald Xtract Universal. Consulta la documentación oficial del software Theobald 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:

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.

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.
Para comprobar si el acceso a la red de tu sistema SAP está abierto, consulta Puertos SAP TCP/IP.
Para otorgar derechos de usuario SAP para acceder a la instancia SAP, consulta Objetos de autoridad: derechos de usuario de SAP para Tabla.
Los siguientes componentes de Theobald Xtract Universal requieren personalización en SAP: Z_THEO_READ_TABLE.
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

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.

Configura el usuario SQL para cargar los datos;
Importar las extracciones de plantillas;
Configurar el origen
Configurar el destino
Configurar el script de extracción
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`, `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 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.

Ve a Servidor - Administrar destinos y edita el destino de SQL Server.
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

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.

Edita la extracción de CDPOS en Xtract Universal Designer para eliminar el CDHDR de las tablas.
Reemplazar CDHDR~UDATE between @extraction_start_date and @extraction_end_date por:
CHANGENR between @CHANGENR_min and @CHANGENR_max
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:

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.