Módulos de función SAP RFC
Introducción
El módulo de función RFC certificado /DABEXP/RFC_SAPCONNECTOR es necesario para conectar un SAP System a las soluciones de extracción SAP de dab. La solución de extracción SAP de dab Add-On se instala posteriormente en el SAP System.
También se requiere una cuenta de usuario SAP, a la que se le debe asignar un perfil de autorizaciones correspondiente. Los capítulos siguientes describen la instalación del módulo de función y la estructura del perfil de autorizaciones necesario.
Para la instalación inicial del módulo RFC en su sistema SAP, utilice el archivo AOI-SAR. Si desea actualizar el módulo RFC existente, utilice el archivo AOU-SAR.
Requisitos técnicos
Soluciones compatibles
La solución de extracción SAP de dab puede utilizarse con las siguientes soluciones SAP:
- SAP NetWeaver - 7.50 (SAP_BASIS 750) o superior
- SAP ERP - 6.0 (ECC 6.0)
- SAP CRM - 7.0
- SAP SRM - 7.0
- SAP SCM - 7.0
- SAP EWM - 7.0
- Esta lista no es exclusiva: otras soluciones basadas en SAP NetWeaver con ABAP-Stack y conectividad RFC también son compatibles
- SAP S/4HANA - 1610 o superior
- SAP S/4HANA Cloud, Extended Edition - todas las versiones
- SAP Cloud ERP Private o SAP S/4HANA Cloud, Private Edition - todas las versiones
- RISE with SAP Ready: Nuestra Add-On SAP está oficialmente soportada y certificada para su uso en entornos RISE with SAP (Private Cloud Edition)
SAP Cloud ERP o SAP S4/HANA Cloud, Public Edition no permite la importación de Add-Ons y, por tanto, es incompatible.
Transacciones necesarias
Para instalar el Add-On, usted o su responsable SAP Basis debe tener acceso a las siguientes transacciones (versión 0053 o superior):
- SAINT - herramienta de instalación de Add-On en SAP
- SPAM - gestor de paquetes de soporte
Instalación y actualización
Instalación
Para la instalación sobre SAP Basis 740 o superior se requiere la versión 1.61 o superior. Puede descargarla en el Customer Portal.
Para la instalación sobre SAP Basis 731 o inferior se requiere el archivo dabexp-sapconn-aoi-140.sar. Puede descargarlo aquí.
Se requieren autorizaciones especiales para este proceso. Para configurar el Add-On se utiliza la transacción SAINT.
Tras acceder a la transacción SAINT, puede instalar el archivo SAR del paquete de instalación (AOI) a través del menú.
En la barra de menú pulse Installation Package > Load Packages > From Frontend y seleccione el archivo SAR.
Si el paquete DABEXP no se muestra, debe desactivar los filtros:
Si aparece un mensaje sobre solicitudes abiertas de extracción de datos, puede omitirlo, ya que Add-On no realiza modificaciones en las estructuras de datos en el sistema SAP.
Si aparece un mensaje indicando que el paquete no está firmado, puede ignorarlo. Solo los paquetes propios de SAP están firmados; los Add-Ons de terceros no reciben firma.
Actualización
Si el Add-On ya está instalado en su SAP System, puede actualizar el Add-On a una nueva versión utilizando el paquete de actualización (AOU). El procedimiento de actualización es idéntico al de instalación.
Para la actualización en sistemas SAP con Basis 740 o superior se necesita el archivo dabexp-sapconn-aou-161.sar. Puede descargar el archivo en el Customer Portal.
Para actualizar sistemas SAP con Basis 731 o inferior se necesita el archivo dabexp-sapconn-aou-140.sar. Puede descargar el archivo aquí.
Autorizaciones
Las soluciones de extracción SAP de dab se basan en los mecanismos de seguridad y el concepto de autorización del SAP System. Además, el acceso a las tablas es siempre de solo lectura. Para conectar la solución de extracción SAP de dab al SAP System, se requiere un usuario al que se le haya asignado un rol de autorización con los siguientes objetos de autorización.
El usuario SAP que se requiere para la conexión puede ser de alguno de los siguientes tipos:
- Diálogo
- Sistema
- Comunicación
- Servicio
Para crear o modificar un usuario correspondiente, es necesario contar con autorizaciones para las siguientes transacciones:
- PFCG: mantenimiento o creación del rol de autorización
- SU01: mantenimiento o creación de usuarios
Autorizaciones para ejecutar el módulo RFC
Aquí puede optar entre dos alternativas: autorización a nivel de grupo de funciones o a nivel de módulo de función.
El objeto de autorización S_RFC se utiliza para autorizar: puede encontrarlo bajo la clase de autorización AAAB - objetos de autorización entre aplicaciones > objeto de autorización S_RFC - control de autorización para acceso RFC.
Autorización a nivel de grupo de funciones
La primera opción consiste en autorizar los grupos de funciones correspondientes mediante el RFC_TYPE en FUGR (grupo de funciones).
Consulte la siguiente tabla para ver los campos y valores correspondientes para el objeto de autorización S_RFC.
| Campo | Valor |
|---|---|
| ACTVT (Actividad) | 16 (ejecutar) |
| RFC_NAME (Nombre del objeto RFC a proteger) | /SDF/RI_CRM CMON RFC1 SYST /DABEXP/DAB_FUGR |
| RFC_TYPE (Tipo de objeto RFC a proteger) | FUGR (grupo de funciones) |
Autorización a nivel de módulo de función
Como alternativa, desde SAP NW 7.0 EHP 2 (SAP_BASIS 702), el RFC_TYPE puede establecerse en FUNC (módulo de función).
Consulte la siguiente tabla para los campos y valores correspondientes del objeto de autorización S_RFC.
| Campo | Valor |
|---|---|
| ACTVT (Actividad) | 16 (ejecutar) |
| RFC_NAME (Nombre del objeto RFC a proteger) | /SDF/CMO_GET_INSTNO CMO_GET_INSTNO DDIF_FIELDINFO_GET RFC_GET_FUNCTION_INTERFACE RFC_GET_NAMETAB RFCPING /DABEXP/RFC_SAPCONNECTOR |
| RFC_TYPE (Tipo de objeto RFC a proteger) | FUNC (grupo de funciones) |
Otros módulos de función requeridos
Además del módulo de función /DABEXP/RFC_SAPCONNECTOR, se requieren otros módulos para un funcionamiento sin inconvenientes.
La siguiente tabla enumera el grupo de funciones, los respectivos módulos y su finalidad prevista:
| Grupo de funciones | Módulo de función | Finalidad |
|---|---|---|
| /SDF/RI_CRM | /SDF/CMO_GET_INSTNO | Consultar el número de instalación bajo S4/HANA |
| CMON | CMO_GET_INSTNO | Consultar el número de instalación |
| RFC1 | RFC_GET_FUNCTION_INTERFACE RFC_GET_NAMETAB | Comprobar la estructura y existencia de módulos RFC |
| SDIFRUNTIME | DDIF_FIELDINFO_GET | Requerido para el correcto funcionamiento de RFC en Netweaver |
| SYST | RFCPING | Probar la conectividad RFC |
| /DABEXP/DAB_FUGR | /DABEXP/RFC_SAPCONNECTOR | Consultar los contenidos de las tablas |
Autorizaciones a nivel de tabla
Las tablas solo pueden autorizarse completamente o no autorizarse. No es posible limitar la autorización a contenidos concretos, p. ej. sociedades.
Estos objetos de autorización pueden emplearse para conceder autorizaciones de acceso al contenido de las tablas a exportar. La comprobación se efectúa utilizando el módulo de función VIEW_AUTHORITY_CHECK.
Existen dos maneras diferentes de autorizar las tablas —ya sea mediante el grupo de autorización o mediante el nombre de la tabla.
Si la autorización de tablas se realiza utilizando ambos objetos de autorización, primero se realiza la comprobación con S_TABU_DIS (grupo de autorización de tabla). Si esta comprobación falla, la autorización se verifica con S_TABU_NAM (nombre de la tabla).
Si utiliza la autorización a nivel de tabla, asegúrese de que también estén autorizadas las siguientes tablas.
| Tabla | Grupo de autorización | Finalidad |
|---|---|---|
| T000 | SS | Clients – tabla estándar para prueba de conectividad |
| T001 | FC01 | Sociedades – tabla alternativa para prueba de conectividad |
| DD02L | Diccionario ABAP – tablas disponibles en el sistema | |
| DD02T | Diccionario ABAP – descripciones de las tablas | |
| DD02V | Diccionario ABAP – búsqueda de tablas en dab Nexus Package Studio | |
| DD03L | Diccionario ABAP – campos disponibles en el sistema | |
| DD03T | Diccionario ABAP – descripciones de campos | |
| DD04L | Diccionario ABAP – extracción del tipo de dato FLTP | |
| NRIV | SC | Intervalos de numeración – objetos en tiempo real en dab Nexus |
| NRIVSHADOW | NRIV local para multiprocesador – objetos en tiempo real en dab Nexus | |
| TNRO | SS | Definición de objetos de intervalos de numeración – objetos en tiempo real en dab Nexus |
Autorización mediante grupos de autorización de tabla
Clase de autorización BC_A Basis - administración → objeto de autorización S_TABU_DIS
Se utiliza para definir a nivel de grupo de autorización de tabla a qué tabla se puede acceder y cómo. Los grupos de autorización se indican en el parámetro DICBERCLS y el tipo de acceso se define mediante ACTVT. La relación entre una tabla y su grupo de autorización (o viceversa) puede consultarse en la tabla TDDAT.
| Campo | Valor |
|---|---|
| ACTVT (Actividad) | 03 (mostrar) |
| DICBERCLS (Grupo de autorización) | * |
Autorización mediante nombres de tabla
Clase de autorización BC_A Basis - administración > objeto de autorización S_TABU_NAM
Se utiliza para definir a nivel de nombre de tabla a qué tabla se puede acceder y cómo. Las tablas se indican en el parámetro TABLE y el tipo de acceso se define mediante ACTVT.
| Campo | Valor |
|---|---|
| ACTVT (Actividad) | 03 (mostrar) |
| TABLE (Grupo de autorización) | * |
Pruebas
Probar el módulo de función
Una vez instalado el módulo de función según lo descrito anteriormente, se puede realizar una primera prueba de funcionamiento con la transacción SE37 del módulo de función usando el botón Test/Execute o la tecla F8.
Los parámetros de importación pueden indicarse en el primer diálogo. En nuestro ejemplo se utiliza la tabla de sociedades T001 en el campo QUERY_TABLE. Puede utilizarse cualquier tabla a la que el usuario tenga derecho de acceso. No es necesario indicar ningún otro parámetro para la prueba inicial. Para iniciar la prueba, pulse el botón Execute o la tecla F8.
Si el módulo de función se ejecuta sin errores, recibirá Result Tables. Puede visualizar los resultados pulsando el icono Detailed view junto al número de entradas de TABL_FIELDS o DATA.
TABL_FIELDS contiene la estructura de los campos de la tabla consultada:
DATA contiene los registros de datos de la tabla consultada:
Probar la conexión RFC
Puede utilizar el dab FunctionModuleTester para comprobar si la conexión puede establecerse correctamente a través de RFC. Puede consultar más instrucciones aquí.
Desinstalación
- abra la transacción SAINT
- pulse la pestaña Uninstallable components, seleccione el componente DABEXT y pulse Start
- tras confirmar la desinstalación, el componente se elimina del SAP System
Certificaciones SAP
SAP ya no certifica Add-Ons para sistemas ECC. Esto significa que SAP ya no puede (re)certificar el módulo de función propio de dab para sistemas ECC. Puede encontrar más información al respecto en esta entrada de blog de SAP.
El Add-On cuenta con certificaciones para las siguientes versiones - las certificaciones actuales pueden consultarse en cualquier momento en el SAP Certified Solutions Directory.
Notas de la versión
Versión 1.71
- Ajustes para SAP Clean Core Nivel B, lo que significa que solo se utilizan APIs aprobadas por SAP
- Ajustes en las condiciones de importación: el Add-On puede instalarse en SAP ECC, SAP S4/HANA y SAP BW/4HANA
- Extensiones para la extracción de vistas con claves primarias no únicas (por ejemplo, FAGLFLEXT): se requiere una actualización adicional de la aplicación para esta funcionalidad
Versión 1.61
- al desinstalar el Add-On, no se podían eliminar todos los objetos debido a información incorrecta de objeto. Esto provocaba la interrupción del proceso de desinstalación.
Versión 1.60
- además de la corrección de la versión 110, ahora también se admite la resolución de .INCLUDES anidados con sufijos. Específicamente, hubo problemas en la tabla ACDOCA donde el include .INCLU-_PA contiene un sufijo y además se extiende con .APPEND. Con esta corrección, el sufijo ahora también se aplica a los campos en el .APPEND.
Versión 1.50
- el módulo de función ha sido preparado para soportar la exportación de textos largos desde la columna CLUSTD en la tabla STXL
Versión 1.40
- última versión de SAP Add-On compatible con SAP Basis 731 y anteriores
- cumplimiento de los niveles de seguridad requeridos para S/4 Cloud EX
Versión 1.30
- la lectura de la información DDIC proporcionaba un OUTPUTLEN incorrecto para el tipo de dato RAW para el GUID en las tablas CGPL_TASK o DPR_TASK. Como resultado, los GUID afectados se exportaban en forma abreviada. Para campos de tipo de dato RAW y INTLEN 16 y un OUTPUTLEN menor a 32, ahora el OUTPUTLEN se fija en 32.
Versión 1.20
- al construir la lista de campos para la consulta SQL, **<table>~<fieldname>** era truncado después de 30 caracteres durante la composición, lo que generaba errores en la consulta SQL.
Versión 1.10
- se producían errores en sistemas S4/HANA con ciertas tablas (BKPF, BSEG, MATDOC, ACDOCA, MHNK). Se ha ajustado la resolución de las estructuras INCLUDE dentro de estas tablas con los nombres
- .INCLU-_PN
- .INCLU-_A1
- .INCLU-LO Se ha modificado la estructura de la lista de campos para la consulta SQL de solo nombre de campo a **<table>~<fieldname>** para evitar excepciones con determinados nombres de campos que utilizan nombres protegidos en SQL. (por ejemplo, tabla TOAM - campo Connection).
SAP Legacy RFC Function Modules
Si usted utiliza un módulo de función diferente a /DABEXP/RFC_SAPCONNECTOR, le recomendamos encarecidamente que realice la actualización a este módulo RFC. dab no actualizará ni ofrecerá soporte para otros módulos de función. Además, estos módulos no cuentan con certificación SAP.
Además de /DABEXP/RFC_SAPCONNECTOR, en el pasado también se han soportado otros módulos en el espacio de nombres Z que se originaron en instalaciones antiguas de dab:Exporter o en personalizaciones individuales de clientes.
La siguiente tabla compara el alcance funcional de los respectivos módulos:
- Caracteres máximos por registro de datos: define el número máximo de caracteres que se pueden extraer por registro de datos (especialmente relevante para tablas con muchas columnas)
- S_DEVELOP requerido: los módulos Z requieren el objeto de autorización S_DEVELOP para poder ejecutarse
- Textos largos: los textos largos se almacenan en las tablas STXH y STXL – versiones más recientes del módulo pueden decodificar y extraer el contenido de estas tablas
- Tipos de datos FLT y RAW: soporte para la extracción en columnas con tipos de datos FLT y RAW
- Actualización mediante SAINT: los módulos Z deben mantenerse mediante las transacciones SE37 y SE80 (el módulo certificado debe instalarse y actualizarse mediante la transacción SAINT)
| Módulo de función | Caracteres máximos por registro de datos | S_DEVELOP requerido | Textos largos | Tipos de datos FLT y RAW | Actualización mediante SAINT | Certificación SAP |
|---|---|---|---|---|---|---|
| Z_RFC_READ_TABLE (Versión 2.0) | 8000 | sí | no | sí | no | no |
| Z_RFC_READ_TABLE (Versión 1.7) | 2048 | sí | no | sí | no | no |
| Z_RFC_READ_TABLE (Versión 1.6 o anterior) | 2048 | sí | no | no | no | no |