/IWFND/MAINT_SERVICE
/IWFND/MAINT_SERVICE es la transacción de SAP Gateway para registrar, activar y mantener servicios OData V2, incluidos sus alias de sistema y nodos ICF, en el sistema que sirve las apps SAP Fiori. Los servicios OData V4 se publican por separado, como grupos de servicios en /IWFND/V4_ADMIN, por lo que activar una app suele implicar ambas transacciones.
Datos clave
- Tipo
- Transacción de administración de SAP Gateway
- Nombre completo
- Activate and Maintain Services
- Capa
- Servicios y API
- Alcance
- Servicios OData V2; los grupos de servicios V4 usan /IWFND/V4_ADMIN
- Se ejecuta en
- Sistema hub de SAP Gateway (el propio back-end en la implementación embedded)
- Quién lo usa
- Administradores de Basis, equipos de implementación de SAP Fiori
- Se aplica a
- SAP S/4HANA on-premise y Private Edition, SAP ERP (ECC)
Capa: Servicios y APIDónde se ubica ▾
Capa: Servicios y API
Abrir el mapa de arquitectura →¿Qué hace /IWFND/MAINT_SERVICE?
/IWFND/MAINT_SERVICE, titulada "Activate and Maintain Services" y accesible también en SPRO, en los ajustes de OData Channel de SAP Gateway, gestiona todos los servicios OData V2 registrados en el sistema SAP Gateway. En una sola pantalla:
- registra un servicio del back-end en el sistema Gateway con un nombre externo;
- asigna uno o varios alias de sistema que enrutan las solicitudes al back-end que lo implementa;
- muestra y activa el nodo ICF del servicio;
- elimina servicios y sus alias;
- salta a SAP Gateway Client, al navegador y al registro de errores para un servicio seleccionado.
/IWFND/MAINT_SERVICE es el interruptor que convierte un servicio OData V2 implementado en uno que una app SAP Fiori puede llamar realmente.
¿Cómo se activa un servicio OData paso a paso?
Para activar el servicio personalizado ZALDER_SUPPLIER_SRV de Alder Manufacturing:
- Inicie /IWFND/MAINT_SERVICE y elija Add Service.
- Introduzca el alias de sistema del back-end (LOCAL en una implementación embedded) y, opcionalmente, el nombre técnico del servicio; después, obtenga los servicios.
- Seleccione el servicio y añádalo. Indique un paquete para el transporte, o un paquete local para una prueba.
- De vuelta en la pantalla principal, seleccione el servicio y confirme que el nodo ICF muestra un estado verde; actívelo si no es así.
- Verifique la asignación del alias de sistema.
- Pruebe con SAP Gateway Client o con la llamada del documento de servicio en el navegador.
- Conceda la autorización de inicio: añada el servicio al rol PFCG del usuario como servicio TADIR (R3TR IWSG, nombre del servicio más el sufijo de versión) para que S_SERVICE quede informado.
Cada paso sigue visible después, por lo que /IWFND/MAINT_SERVICE es la primera parada cuando un servicio parece faltar.
¿Cuándo conviene usar /IWFND/MAINT_SERVICE y cuándo no?
Use /IWFND/MAINT_SERVICE para:
- servicios OData V2 personalizados de proyectos SEGW o vistas CDS publicadas como V2;
- servicios individuales entregados por SAP que una activación masiva omitió;
- corregir alias de sistema y nodos ICF de servicios existentes.
Use otra herramienta para:
- Grupos de servicios OData V4: /IWFND/V4_ADMIN.
- Muchas apps SAP Fiori a la vez: las task lists ejecutadas con STC01 activan las apps y los servicios de un business role: SAP_FIORI_CONTENT_ACTIVATION para los roles plantilla de SAP y SAP_FIORI_FCM_CONTENT_ACTIVATION para los roles del cliente, según la documentación de SAP S/4HANA 2025.
- Service bindings de RAP: publicar el service binding en ABAP Development Tools activa su endpoint de servicio local; los detalles del registro dependen de la release y de la versión de OData.
Elegir la herramienta adecuada según la versión de OData y el volumen reserva /IWFND/MAINT_SERVICE para correcciones puntuales y no para trabajo masivo.
¿Qué significan los errores habituales de /IWFND/MAINT_SERVICE?
| Síntoma | Causa probable | Corrección |
|---|---|---|
| El servicio no aparece en Add Service | Alias de sistema incorrecto, o el servicio no está generado en el back-end | Verifique el alias y el registro del servicio en el back-end |
| "No service found for namespace …" en tiempo de ejecución | Servicio no registrado o versión incorrecta en el sistema Gateway | Registre el servicio y verifique el sufijo de versión |
| "No System Alias found for Service …" | Servicio registrado sin alias para este usuario o mandante | Asigne el alias de sistema |
| HTTP 403 en la URL del servicio | Nodo ICF inactivo, o falta S_SERVICE | Active el nodo; amplíe el rol PFCG |
| Metadatos antiguos tras un transporte | Modelo en caché | Ejecute /IWFND/CACHE_CLEANUP y /IWBEP/CACHE_CLEANUP |
La mayoría de los problemas de /IWFND/MAINT_SERVICE son carencias de registro, de alias o de autorización, no defectos en el código del servicio.
¿Qué transacciones relacionadas ayudan?
- /IWFND/V4_ADMIN: publica y gestiona grupos de servicios OData V4.
- /IWFND/GW_CLIENT: envía y reproduce solicitudes contra el servicio.
- /IWFND/ERROR_LOG: muestra los errores de tiempo de ejecución tras la activación.
- SICF: mantiene directamente los nodos ICF, por ejemplo el nodo V4 compartido.
- PFCG: añade el servicio a los roles, para que los usuarios reciban la autorización de inicio S_SERVICE.
- SEGW: abre el proyecto de Service Builder detrás de un servicio V2 personalizado.
- /IWFND/CACHE_CLEANUP y /IWBEP/CACHE_CLEANUP: limpian las cachés de metadatos del hub y del back-end.
/IWFND/MAINT_SERVICE activa el servicio; estas transacciones demuestran que realmente funciona.
/IWFND/MAINT_SERVICE vs. /IWFND/V4_ADMIN vs. SICF: ¿cuál es la diferencia?
| /IWFND/MAINT_SERVICE | /IWFND/V4_ADMIN | SICF | |
|---|---|---|---|
| Gestiona | Servicios OData V2 | Grupos de servicios OData V4 | Nodos ICF de todos los servicios HTTP |
| Unidad de activación | Un servicio | Un grupo de servicios | Un nodo de ruta URL |
| Gestión de ICF | Un nodo por servicio V2 | Un nodo V4 compartido | Cualquier nodo, de forma genérica |
| Uso típico | Registrar, asignar alias y activar un servicio V2 | Publicar servicios V4 y enrutarlos | Activar o verificar un nodo por su ruta |
Preguntas frecuentes
¿Se necesita /IWFND/MAINT_SERVICE en una implementación embedded?
Sí. En una implementación embedded, los componentes de hub y de back-end se ejecutan en el mismo sistema, pero los servicios OData V2 siguen teniendo que registrarse y activarse allí. El alias de sistema suele ser LOCAL en lugar de un back-end remoto.
¿Por qué mi servicio OData V4 no aparece en /IWFND/MAINT_SERVICE?
/IWFND/MAINT_SERVICE gestiona solo servicios OData V2. Los servicios OData V4 se publican como grupos de servicios en /IWFND/V4_ADMIN, que los enruta a través de un único nodo ICF compartido en lugar de un nodo por servicio.
¿Activar un servicio OData concede acceso a los usuarios?
No. La activación hace que el servicio se pueda llamar, pero cada usuario sigue necesitando la autorización de inicio mediante el objeto de autorización S_SERVICE, que normalmente se concede añadiendo el servicio a un rol PFCG. Sin ella, la solicitud falla con un error de autorización.
¿Se puede usar /IWFND/MAINT_SERVICE en SAP S/4HANA Cloud Public Edition?
SAP no documenta ningún uso por parte del cliente en Public Edition, donde SAP opera los servicios detrás de las apps entregadas. La transacción se aplica a sistemas SAP S/4HANA on-premise, Private Edition y SAP ERP que ejecutan SAP Gateway.
Fuentes
- SAP Help Portal: Activate and Maintain Services (SAP Gateway Foundation)
- SAP Help Portal: Service Group Publishing (OData V4)
- SAP Help Portal: ICF Services for OData V2 and V4
- SAP Help Portal: Activating OData/ICF Services using Task Lists
- SAP Help Portal: Rapid Activation of SAP Fiori (task lists, SAP S/4HANA)
- Se aplica a
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
- Última revisión