Instalación del módulo de función Z_XTRACT_IS_TABLE en su sistema SAP

Introducción

Para utilizar la extracción SAP nativa de UiPath Process Mining, debes añadir el módulo Función Z_XTRACT_IS_TABLE a tu sistema SAP.

Nota:

When setting up a native SAP extraction the SAP Z_XTRACT_IS_TABLE Function Module is required. If, for example, the Function Module is renamed in your SAP system, you can specify the correct name in the (optional) FunctionModule parameter in the SAP connection string.

Requisito previo

Para poder instalar el módulo de funciones personalizadas en tu sistema SAP, debes tener las credenciales de un usuario SAP con clave de desarrollo.

Añadir un nuevo grupo de funciones

Nota:

Se recomienda añadir un nuevo grupo de funciones para añadir el módulo de funciones.

Sigue estos pasos para añadir un nuevo Grupo de función.

Paso	Acción
1	Abra la GUI de SAP.
2	Introduce SE37 en el campo de comando en la parte superior izquierda.
3	Ve al menú Ir a y selecciona Grupo de funciones -> Crear grupo .
4	Introduzca un nombre para el grupo de funciones. Nota: el nombre debe comenzar con Z , por ejemplo Z_PM_DATA_EXTRACTION .
5	Introduce una descripción para el grupo Función en el campo Texto corto , por ejemplo ProcessMining Data Extraction .
6	Haz clic en GUARDAR.

Activar el grupo de funciones

Sigue estos pasos para activar el grupo Función.

Paso	Acción
1	Selecciona Grupo de funciones.
2	Busca el grupo de funciones que creaste, por ejemplo, PM_DATA_EXTRACTION.
3	Haz clic con el botón derecho en el objeto superior del grupo Función y selecciona Activarlo en el menú contextual.

Añadir el módulo de funciones

Una vez creado el grupo de funciones, puedes añadir el módulo de funciones desde la ventana de la GUI del SE37.

Siga estos pasos para instalar el módulo de función Z_XTRACT_IS_TABLE.

Paso	Acción
1	Introduce Z_XTRACT_IS_TABLE en el campo Módulo de función y haz clic en Crear .
2	Ve a la pestaña Atributos y selecciona la opción Módulo habilitado a distancia en la lista de opciones Tipo de procesamiento .
3	Ve a la pestaña Importar y define los parámetros de importación como se indica a continuación. Nota: es posible que recibas una advertencia de que el operador LIKE está obsoleto. Puedes ignorar la advertencia y revisar la lista. Haz clic en ENTRAR para confirmar que quieres seguir utilizándolo. Una vez que haya revisado toda la lista, se aceptará el código.
4	Ve a la pestaña Tablas y define los parámetros de las tablas como se indica a continuación. Nota: es posible que recibas una advertencia de que el operador LIKE está obsoleto. Puedes ignorar la advertencia y revisar la lista. Haz clic en ENTRAR para confirmar que quieres seguir utilizándolo. Una vez que haya revisado toda la lista, se aceptará el código.
5	Ve a la pestaña Excepciones para definir las excepciones como se indica a continuación.
6	Ve a la pestaña Código fuente e introduce el código ABAP para el Z_XTRACT_IS_TABLE . Nota: puedes copiar y pegar el código que se muestra a continuación.
7	Guarde el módulo Función y actívelo.

Importar parámetros

Consulta la siguiente ilustración para obtener una descripción general de los parámetros de importación que se definirán en la pestaña Importar .

Parámetros de tablas

Consulta la ilustración de abajo para obtener información general sobre los parámetros de las tablas que se definirán en la pestaña Tablas.

Excepciones

Consulta la siguiente ilustración para obtener una descripción general de las excepciones que se definirán en la pestaña Excepciones .

Código ABAP

Consulta el texto del código a continuación para ver el código ABAP que se pegará en la pestaña Código fuente .

FUNCTION Z_XTRACT_IS_TABLE.
*"
*"*"Lokale Schnittstelle:
*"  IMPORTING
*"     VALUE(QUERY_TABLE) LIKE  DD02L-TABNAME
*"     VALUE(DELIMITER) LIKE  SONV-FLAG DEFAULT SPACE
*"     VALUE(NO_DATA) LIKE  SONV-FLAG DEFAULT SPACE
*"    VALUE(ROWSKIPS) LIKE  SOID-ACCNT DEFAULT 0
*"     VALUE(ROWCOUNT) LIKE  SOID-ACCNT DEFAULT 0
*"  TABLES
*"      OPTIONS STRUCTURE  RFC_DB_OPT
*"      FIELDS STRUCTURE  RFC_DB_FLD
*"     DATA STRUCTURE  CHAR8000
*"  EXCEPTIONS
*"      TABLE_NOT_AVAILABLE
*"      TABLE_WITHOUT_DATA
*"     OPTION_NOT_VALID
*"     FIELD_NOT_VALID
*"     NOT_AUTHORIZED
*"      DATA_BUFFER_EXCEEDED
*"-------------------------------------------
"
CALL FUNCTION 'VIEW_AUTHORITY_CHECK'
     EXPORTING
          VIEW_ACTION                    = 'S'
          VIEW_NAME                      = QUERY_TABLE
     EXCEPTIONS
          NO_AUTHORITY                   = 2
          NO_CLIENTINDEPENDENT_AUTHORITY = 2
          NO_LINEDEPENDENT_AUTHORITY     = 2
          OTHERS                         = 1.
IF SY-SUBRC = 2.
  RAISE NOT_AUTHORIZED.
ELSEIF SY-SUBRC = 1.
  RAISE TABLE_NOT_AVAILABLE.
ENDIF.
* -------------------------------------------- 
*  find out about the structure of QUERY_TABLE
* --------------------------------------------
DATA BEGIN OF TABLE_STRUCTURE OCCURS 10.
        INCLUDE STRUCTURE DFIES.
DATA END OF TABLE_STRUCTURE.
"DATA TABLE_HEADER LIKE X030L.
DATA TABLE_TYPE TYPE DD02V-TABCLASS.
CALL FUNCTION 'DDIF_FIELDINFO_GET'
  EXPORTING
    TABNAME              = QUERY_TABLE
*   FIELDNAME            = ' '
*   LANGU                = SY-LANGU
*   LFIELDNAME           = ' '
*   ALL_TYPES            = ' '
*   GROUP_NAMES          = ' '
  IMPORTING
*   X030L_WA             =
    DDOBJTYPE            = TABLE_TYPE
*   DFIES_WA             =
*   LINES_DESCR          =
  TABLES
    DFIES_TAB            = TABLE_STRUCTURE
*   FIXED_VALUES         =
  EXCEPTIONS
    NOT_FOUND            = 1
    INTERNAL_ERROR       = 2
    OTHERS               = 3
          .
IF SY-SUBRC <> 0.
  RAISE TABLE_NOT_AVAILABLE.
ENDIF.
IF TABLE_TYPE = 'INTTAB'.
  RAISE TABLE_WITHOUT_DATA.
ENDIF.
* -------------------------------------------
*  isolate first field of DATA as output field
*  (i.e. allow for changes to structure DATA!)
* -------------------------------------------
DATA LINE_LENGTH TYPE I.
FIELD-SYMBOLS <D>.
ASSIGN COMPONENT 0 OF STRUCTURE DATA TO <D>.
* If this line leads to a syntax error
* please just delete the 'in character mode'
DESCRIBE FIELD <D> LENGTH LINE_LENGTH in character mode.
* -------------------------------------------
*  if FIELDS are not specified, read all available fields
* -------------------------------------------
DATA NUMBER_OF_FIELDS TYPE I.
DESCRIBE TABLE FIELDS LINES NUMBER_OF_FIELDS.
IF NUMBER_OF_FIELDS = 0.
  LOOP AT TABLE_STRUCTURE.
    MOVE TABLE_STRUCTURE-FIELDNAME TO FIELDS-FIELDNAME.
    APPEND FIELDS.
  ENDLOOP.
ENDIF.
* -------------------------------------------
*  for each field which has to be read, copy structure information
*  into tables FIELDS_INT (internal use) and FIELDS (output)
* -------------------------------------------
DATA: BEGIN OF FIELDS_INT OCCURS 10,
        FIELDNAME  LIKE TABLE_STRUCTURE-FIELDNAME,
        TYPE       LIKE TABLE_STRUCTURE-INTTYPE,
        DECIMALS   LIKE TABLE_STRUCTURE-DECIMALS,
        LENGTH_SRC LIKE TABLE_STRUCTURE-INTLEN,
        LENGTH_DST LIKE TABLE_STRUCTURE-LENG,
        OFFSET_SRC LIKE TABLE_STRUCTURE-OFFSET,
        OFFSET_DST LIKE TABLE_STRUCTURE-OFFSET,
      END OF FIELDS_INT,
      LINE_CURSOR TYPE I.
LINE_CURSOR = 0.
*  for each field which has to be read ...
LOOP AT FIELDS.
  READ TABLE TABLE_STRUCTURE WITH KEY FIELDNAME = FIELDS-FIELDNAME.
  IF SY-SUBRC NE 0.
    RAISE FIELD_NOT_VALID.
  ENDIF.
* compute the place for field contents in DATA rows:
* if not first field in row, allow space for delimiter
  IF LINE_CURSOR <> 0.
    IF NO_DATA EQ SPACE AND DELIMITER NE SPACE.
      MOVE DELIMITER TO DATA+LINE_CURSOR.
    ENDIF.
    LINE_CURSOR = LINE_CURSOR + STRLEN( DELIMITER ).
  ENDIF.
* ... copy structure information into tables FIELDS_INT
* (which is used internally during SELECT) ...
  FIELDS_INT-FIELDNAME  = TABLE_STRUCTURE-FIELDNAME.
  FIELDS_INT-LENGTH_SRC = TABLE_STRUCTURE-INTLEN.
*  FIELDS_INT-LENGTH_DST = TABLE_STRUCTURE-LENG.
* modified by Theobald, 2007-11-20
  FIELDS_INT-LENGTH_DST = TABLE_STRUCTURE-OUTPUTLEN.
  FIELDS_INT-OFFSET_SRC = TABLE_STRUCTURE-OFFSET.
  FIELDS_INT-OFFSET_DST = LINE_CURSOR.
  FIELDS_INT-TYPE       = TABLE_STRUCTURE-INTTYPE.
  FIELDS_INT-DECIMALS   = TABLE_STRUCTURE-DECIMALS.
* compute the place for contents of next field in DATA rows
*  LINE_CURSOR = LINE_CURSOR + TABLE_STRUCTURE-LENG.
* modified by Theobald, 2007-11-20
LINE_CURSOR = LINE_CURSOR + TABLE_STRUCTURE-OUTPUTLEN.
  IF LINE_CURSOR > LINE_LENGTH AND NO_DATA EQ SPACE.
    RAISE DATA_BUFFER_EXCEEDED.
  ENDIF.
  APPEND FIELDS_INT.
* ... and into table FIELDS (which is output to the caller)
  FIELDS-FIELDTEXT = TABLE_STRUCTURE-FIELDTEXT.
  FIELDS-TYPE      = TABLE_STRUCTURE-INTTYPE.
  FIELDS-LENGTH    = FIELDS_INT-LENGTH_DST.
  FIELDS-OFFSET    = FIELDS_INT-OFFSET_DST.
  MODIFY FIELDS.
ENDLOOP.
* end of loop at FIELDS
* -------------------------------------------
*  read data from the database and copy relevant portions into DATA
* -------------------------------------------
* output data only if NO_DATA equals space (otherwise the structure
* information in FIELDS is the only result of the module)
IF NO_DATA EQ SPACE.
DATA: BEGIN OF WORK, BUFFER(30000), F TYPE F, END OF WORK.
FIELD-SYMBOLS: <WA> TYPE ANY, <COMP> TYPE ANY.
ASSIGN WORK TO <WA> CASTING TYPE (QUERY_TABLE).
IF ROWCOUNT > 0.
  ROWCOUNT = ROWCOUNT + ROWSKIPS.
ENDIF.
  SELECT * FROM (QUERY_TABLE) INTO <WA> WHERE (OPTIONS).
    IF SY-DBCNT GT ROWSKIPS.
*   copy all relevant fields into DATA (output) table
      LOOP AT FIELDS_INT.
        IF FIELDS_INT-TYPE = 'P'.
        ASSIGN COMPONENT FIELDS_INT-FIELDNAME
            OF STRUCTURE <WA> TO <COMP>
            TYPE     FIELDS_INT-TYPE
            DECIMALS FIELDS_INT-DECIMALS.
        ELSE.
        ASSIGN COMPONENT FIELDS_INT-FIELDNAME
            OF STRUCTURE <WA> TO <COMP>
            TYPE     FIELDS_INT-TYPE.
        ENDIF.
        MOVE <COMP> TO
            <D>+FIELDS_INT-OFFSET_DST(FIELDS_INT-LENGTH_DST).
      ENDLOOP.
*   end of loop at FIELDS_INT
      APPEND DATA.
      IF ROWCOUNT > 0 AND SY-DBCNT GE ROWCOUNT. EXIT. ENDIF.
    ENDIF.
  ENDSELECT.
ENDIF.
ENDFUNCTION.

Comprobación y activación del módulo de funciones

Después de pegar el código ABAP, se recomienda comprobar si hay errores de sintaxis en el código antes de activar el módulo Función.

Comprobar el módulo de función

Siga este paso para verificar el código ABAP.

Paso	Acción
1	Pulsa CTRL+F2 en la pestaña Código fuente de SAP.

Si no hay errores, puede activar el módulo de Función.

Activar el módulo de función

Sigue estos pasos para activar el Módulo de función.

Paso	Acción
1	Introduce SE80 en el campo de comando en la parte superior izquierda.
2	Selecciona Módulo de funciones.
3	Buscar Z_XTRACT_IS_TABLE.
4	Haz clic derecho en el objeto de arriba de Z_XTRACT_IS_TABLE y selecciona Activarlo en el menú de contexto.

Conexión al origen de datos SAP desde UiPath Process Mining

En este punto, es posible extraer datos del sistema SAP utilizando la conexión SAP nativa. Puedes conectarte al origen de datos SAP creando una nueva tabla de entrada con una tabla de cadena de conexión SAP y definiendo una consulta para extraer los datos. Consulta la siguiente ilustración.