/IWFND/MAINT_SERVICE
/IWFND/MAINT_SERVICE est la transaction SAP Gateway qui enregistre, active et maintient les services OData V2, y compris leurs alias système et leurs nœuds ICF, sur le système qui sert les applications SAP Fiori. Les services OData V4 sont publiés séparément, sous forme de groupes de services dans /IWFND/V4_ADMIN : activer une application fait donc souvent intervenir les deux transactions.
L'essentiel
- Type
- Transaction d'administration SAP Gateway
- Nom complet
- Activate and Maintain Services
- Couche
- Services et API
- Périmètre
- Services OData V2 ; les groupes de services V4 utilisent /IWFND/V4_ADMIN
- S'exécute sur
- Système hub SAP Gateway (le back-end lui-même en déploiement embedded)
- Utilisateurs
- Administrateurs basis, équipes de mise en œuvre SAP Fiori
- S'applique à
- SAP S/4HANA on-premise et Private Edition, SAP ERP (ECC)
Couche : Services et APIOù se situe-t-il ? ▾
Couche : Services et API
Ouvrir la carte d'architecture →Que fait /IWFND/MAINT_SERVICE ?
/IWFND/MAINT_SERVICE, intitulée « Activate and Maintain Services » et également accessible dans SPRO sous les paramètres SAP Gateway OData Channel, gère tous les services OData V2 enregistrés sur le système SAP Gateway. Dans un seul écran, elle :
- enregistre un service back-end sur le système Gateway sous un nom externe ;
- affecte un ou plusieurs alias système qui routent les requêtes vers le back-end d'implémentation ;
- affiche et active le nœud ICF du service ;
- supprime des services et leurs alias ;
- donne accès au SAP Gateway Client, au navigateur et au journal des erreurs pour un service sélectionné.
/IWFND/MAINT_SERVICE est l'interrupteur qui transforme un service OData V2 implémenté en un service qu'une application SAP Fiori peut réellement appeler.
Comment activer un service OData pas à pas ?
Pour activer le service spécifique ZALDER_SUPPLIER_SRV d'Alder Manufacturing :
- Lancez /IWFND/MAINT_SERVICE et choisissez Add Service.
- Saisissez l'alias système du back-end (LOCAL dans un déploiement embedded) et, si besoin, le nom technique du service, puis récupérez les services.
- Sélectionnez le service et ajoutez-le. Indiquez un package pour le transport, ou un package local pour un test.
- De retour sur l'écran principal, sélectionnez le service et vérifiez que le nœud ICF affiche un statut vert ; activez-le dans le cas contraire.
- Contrôlez l'affectation de l'alias système.
- Testez avec le SAP Gateway Client ou l'appel du document de service dans le navigateur.
- Accordez l'autorisation de démarrage : ajoutez le service au rôle PFCG de l'utilisateur en tant que service TADIR (R3TR IWSG, nom du service suivi du suffixe de version) afin que S_SERVICE soit renseigné.
Chaque étape reste visible ensuite : /IWFND/MAINT_SERVICE est donc le premier réflexe lorsqu'un service semble manquer.
Quand utiliser /IWFND/MAINT_SERVICE, et quand s'en passer ?
Utilisez /IWFND/MAINT_SERVICE pour :
- les services OData V2 spécifiques issus de projets SEGW ou de vues CDS publiées en V2 ;
- des services SAP livrés isolés qu'une activation de masse a omis ;
- corriger les alias système et les nœuds ICF de services existants.
Utilisez un autre outil pour :
- Les groupes de services OData V4 : /IWFND/V4_ADMIN.
- De nombreuses applications SAP Fiori à la fois : des task lists exécutées avec STC01 activent les applications et services d'un business role : SAP_FIORI_CONTENT_ACTIVATION pour les rôles modèles SAP et SAP_FIORI_FCM_CONTENT_ACTIVATION pour les rôles client, selon la documentation SAP S/4HANA 2025.
- Les service bindings RAP : publier le service binding dans ABAP Development Tools active son endpoint de service local ; les détails de l'enregistrement dépendent de la release et de la version OData.
Choisir le bon outil selon la version OData et le volume réserve /IWFND/MAINT_SERVICE aux corrections ciblées plutôt qu'aux traitements de masse.
Que signifient les erreurs courantes de /IWFND/MAINT_SERVICE ?
| Symptôme | Cause probable | Correction |
|---|---|---|
| Service absent de la liste Add Service | Mauvais alias système, ou service non généré dans le back-end | Vérifier l'alias et l'enregistrement du service back-end |
| « No service found for namespace … » à l'exécution | Service non enregistré ou mauvaise version sur le système Gateway | Enregistrer le service, vérifier le suffixe de version |
| « No System Alias found for Service … » | Service enregistré sans alias pour cet utilisateur ou ce mandant | Affecter l'alias système |
| HTTP 403 sur l'URL du service | Nœud ICF inactif, ou S_SERVICE manquant | Activer le nœud ; compléter le rôle PFCG |
| Anciennes métadonnées après un transport | Modèle en cache | Exécuter /IWFND/CACHE_CLEANUP et /IWBEP/CACHE_CLEANUP |
La plupart des problèmes de /IWFND/MAINT_SERVICE sont des lacunes d'enregistrement, d'alias ou d'autorisation, et non des défauts du code du service.
Quelles transactions associées vous aident ?
- /IWFND/V4_ADMIN : publie et gère les groupes de services OData V4.
- /IWFND/GW_CLIENT : envoie et rejoue des requêtes vers le service.
- /IWFND/ERROR_LOG : affiche les erreurs d'exécution après l'activation.
- SICF : maintient directement les nœuds ICF, par exemple le nœud V4 partagé.
- PFCG : ajoute le service aux rôles, afin que les utilisateurs reçoivent l'autorisation de démarrage S_SERVICE.
- SEGW : ouvre le projet Service Builder derrière un service V2 spécifique.
- /IWFND/CACHE_CLEANUP et /IWBEP/CACHE_CLEANUP : vident les caches de métadonnées du hub et du back-end.
/IWFND/MAINT_SERVICE active le service ; ces transactions prouvent qu'il fonctionne réellement.
/IWFND/MAINT_SERVICE, /IWFND/V4_ADMIN ou SICF : quelle différence ?
| /IWFND/MAINT_SERVICE | /IWFND/V4_ADMIN | SICF | |
|---|---|---|---|
| Gère | Services OData V2 | Groupes de services OData V4 | Nœuds ICF de tous les services HTTP |
| Unité d'activation | Un service | Un groupe de services | Un nœud de chemin d'URL |
| Gestion ICF | Un nœud par service V2 | Un nœud V4 partagé | Tout nœud, de façon générique |
| Usage typique | Enregistrer, affecter un alias, activer un service V2 | Publier et router des services V4 | Activer ou vérifier un nœud par son chemin |
Questions fréquentes
/IWFND/MAINT_SERVICE est-elle nécessaire dans un déploiement embedded ?
Oui. Dans un déploiement embedded, les composants hub et back-end s'exécutent dans le même système, mais les services OData V2 doivent tout de même y être enregistrés et activés. L'alias système est généralement LOCAL au lieu d'un back-end distant.
Pourquoi mon service OData V4 n'apparaît-il pas dans /IWFND/MAINT_SERVICE ?
/IWFND/MAINT_SERVICE gère uniquement les services OData V2. Les services OData V4 sont publiés sous forme de groupes de services dans /IWFND/V4_ADMIN, qui les route via un nœud ICF partagé unique au lieu d'un nœud par service.
Activer un service OData donne-t-il accès aux utilisateurs ?
Non. L'activation rend le service appelable, mais chaque utilisateur a encore besoin de l'autorisation de démarrage via l'objet d'autorisation S_SERVICE, normalement accordée en ajoutant le service à un rôle PFCG. Sans elle, la requête échoue avec une erreur d'autorisation.
Peut-on utiliser /IWFND/MAINT_SERVICE dans SAP S/4HANA Cloud Public Edition ?
SAP ne documente aucun usage client de cette transaction pour la Public Edition, où SAP exploite les services derrière les applications livrées. La transaction s'applique à SAP S/4HANA on-premise, à la Private Edition et aux systèmes SAP ERP exécutant SAP Gateway.
Sources
- 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)
- S'applique à
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
- Dernière relecture