Administración y resolución de problemas

/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 ▾
Dónde se ubica: L4 · Servicios y APICapa: Servicios y API.L1L2L3L4L5L6BTP

¿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:

  1. Inicie /IWFND/MAINT_SERVICE y elija Add Service.
  2. 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.
  3. Seleccione el servicio y añádalo. Indique un paquete para el transporte, o un paquete local para una prueba.
  4. 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í.
  5. Verifique la asignación del alias de sistema.
  6. Pruebe con SAP Gateway Client o con la llamada del documento de servicio en el navegador.
  7. 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íntomaCausa probableCorrección
El servicio no aparece en Add ServiceAlias de sistema incorrecto, o el servicio no está generado en el back-endVerifique el alias y el registro del servicio en el back-end
"No service found for namespace …" en tiempo de ejecuciónServicio no registrado o versión incorrecta en el sistema GatewayRegistre el servicio y verifique el sufijo de versión
"No System Alias found for Service …"Servicio registrado sin alias para este usuario o mandanteAsigne el alias de sistema
HTTP 403 en la URL del servicioNodo ICF inactivo, o falta S_SERVICEActive el nodo; amplíe el rol PFCG
Metadatos antiguos tras un transporteModelo 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.

  • /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_ADMINSICF
GestionaServicios OData V2Grupos de servicios OData V4Nodos ICF de todos los servicios HTTP
Unidad de activaciónUn servicioUn grupo de serviciosUn nodo de ruta URL
Gestión de ICFUn nodo por servicio V2Un nodo V4 compartidoCualquier nodo, de forma genérica
Uso típicoRegistrar, asignar alias y activar un servicio V2Publicar servicios V4 y enrutarlosActivar 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

Se aplica a
SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
Última revisión

SAP, SAP Fiori, SAPUI5, SAP S/4HANA, SAP BTP y los demás productos y servicios de SAP mencionados son marcas comerciales o marcas registradas de SAP SE (o de una empresa afiliada de SAP) en Alemania y otros países. Esta guía es independiente y no está afiliada, patrocinada ni respaldada por SAP SE.