/IWFND/GW_CLIENT
/IWFND/GW_CLIENT est la transaction du SAP Gateway Client, un outil de test HTTP intégré à SAP Gateway qui envoie des requêtes OData directement à un service, sans l'application SAP Fiori. /IWFND/GW_CLIENT affiche la réponse brute, rejoue les requêtes en échec depuis le journal des erreurs et stocke des cas de test réutilisables, ce qui distingue les problèmes de service des problèmes d'application.
L'essentiel
- Type
- Transaction de test et de dépannage SAP Gateway
- Nom complet
- SAP Gateway Client
- Couche
- Services et API
- S'exécute sur
- Système hub SAP Gateway (le back-end lui-même en déploiement embedded)
- Fonctions clés
- Toute méthode HTTP, en-têtes, payloads, cas de test, nettoyage du cache de métadonnées
- Utilisateurs
- Développeurs ABAP et SAP Fiori, équipes de support SAP Fiori, administrateurs basis
- 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/GW_CLIENT ?
/IWFND/GW_CLIENT agit comme un client HTTP à l'intérieur du système SAP Gateway. Vous choisissez une méthode (GET, POST, PUT, PATCH, MERGE, DELETE ou HEAD), saisissez une URI de requête, ajoutez des en-têtes et un payload, puis exécutez. La réponse s'affiche à côté de la requête, avec son statut HTTP, ses en-têtes et son corps. Depuis le même écran, vous pouvez :
- ajouter des options d'URI comme
$countou$format=json; - accéder au journal des erreurs, à la maintenance du service ou à l'implémentation du service ;
- transformer une réponse en requête suivante avec Use as Request ;
- nettoyer ou reconstruire le cache de métadonnées sur le hub, le back-end ou les deux.
/IWFND/GW_CLIENT répond à la question que masque une application SAP Fiori : que renvoie le service lui-même ?
Comment utiliser /IWFND/GW_CLIENT pas à pas ?
Un acheteur d'Alder Manufacturing signale que la liste des fournisseurs n'affiche aucune entrée pour Cedar Office Supply :
- Copiez l'URI de la requête en échec depuis les outils de développement du navigateur, par exemple
/sap/opu/odata/sap/ZALDER_SUPPLIER_SRV/SupplierSetavec son filtre. - Lancez /IWFND/GW_CLIENT, sélectionnez GET et collez l'URI.
- Exécutez, puis lisez le statut HTTP et le corps de la réponse.
- Modifiez un élément à la fois : supprimez le filtre, ajoutez
$format=json, demandez l'entité unique par sa clé. - Pour un enregistrement en échec, reconstruisez la requête avec la même méthode, les mêmes en-têtes et le même payload ; SAP Gateway attend un X-CSRF-Token valide, obtenu par un GET préalable, pour les requêtes de modification.
- Si l'erreur provient du signalement d'un utilisateur, ouvrez l'entrée dans /IWFND/ERROR_LOG et rejouez-la depuis là au lieu de la ressaisir.
Une requête qui échoue dans /IWFND/GW_CLIENT relève d'un problème de service ; une requête qui y aboutit renvoie à l'application ou à ses paramètres.
Que signifient les résultats courants de /IWFND/GW_CLIENT ?
| Résultat | Cause probable | Étape suivante |
|---|---|---|
| HTTP 200 avec les données attendues | Le service fonctionne | Comparer la requête réelle de l'application, ses filtres et l'utilisateur |
| HTTP 200 avec un flux vide | Un filtre, une clé ou une autorisation métier écarte les données | Tester sans le filtre ; vérifier le business role |
| HTTP 403 | Autorisation de démarrage ou autorisation métier manquante | SU53 pour l'utilisateur concerné |
| HTTP 404 | Entity set, clé ou chemin de service erroné | Comparer l'URI avec les métadonnées du service |
| HTTP 500 | Exception dans l'implémentation du service | /IWBEP/ERROR_LOG pour la pile d'appels |
| Anciennes propriétés dans les métadonnées | Cache de métadonnées obsolète | Menu Metadata : nettoyer ou reconstruire |
/IWFND/GW_CLIENT transforme un symptôme vague de l'application en un statut HTTP qui désigne une seule couche.
En quoi les cas de test de /IWFND/GW_CLIENT sont-ils utiles ?
/IWFND/GW_CLIENT peut enregistrer une requête comme cas de test dans un groupe de test, soit en base de données, soit sous forme de fichier sur votre PC. Un cas de test conserve la méthode, l'URI, les en-têtes, le payload et un statut HTTP attendu ; la validation de réponse compare une nouvelle réponse avec une réponse stockée.
SAP livre des groupes d'exemple, CORE_SAMPLES pour OData V2 et V4_TEST pour OData V4, qui ne fonctionnent que si les services qu'ils appellent sont actifs. Pour un service spécifique, un petit groupe de test exécuté après chaque transport détecte les régressions avant les utilisateurs. Les cas de test font de /IWFND/GW_CLIENT un outil de non-régression léger, et pas seulement un écran de débogage.
Quelles transactions associées vous aident ?
- /IWFND/ERROR_LOG et /IWBEP/ERROR_LOG : retrouvent la requête en échec et la rejouent dans /IWFND/GW_CLIENT.
- /IWFND/TRACES : enregistre des traces de payload et de performance lorsque la requête aboutit mais que les données semblent fausses.
- /IWFND/MAINT_SERVICE : vérifie l'enregistrement et l'alias système lorsque le service est introuvable.
- SU53 : confirme un échec d'autorisation derrière un 403.
Gardez à l'esprit que le résultat reflète l'utilisateur et les autorisations avec lesquels s'exécute la requête de test, qui ne sont généralement pas ceux de l'utilisateur ayant signalé le problème. /IWFND/GW_CLIENT reproduit la requête ; les transactions associées expliquent le résultat.
/IWFND/GW_CLIENT ou /IWFND/ERROR_LOG : quelle différence ?
| /IWFND/GW_CLIENT | /IWFND/ERROR_LOG | |
|---|---|---|
| Objectif | Envoyer et rejouer des requêtes | Enregistrer les requêtes en échec |
| Travaille avec | Des requêtes que vous construisez ou copiez | Des requêtes déjà envoyées par les utilisateurs |
| Question à laquelle il répond | Que renvoie le service en ce moment ? | Quelle requête a échoué, quand et pourquoi ? |
| Usage typique | Reproduire, isoler et tester une correction | Premier examen après le signalement d'un utilisateur |
Le journal des erreurs retrouve la requête en échec ; /IWFND/GW_CLIENT la reproduit dans des conditions maîtrisées.
Questions fréquentes
/IWFND/GW_CLIENT est-il la même chose que le SAP Gateway Client ?
Oui. /IWFND/GW_CLIENT est le code de transaction qui lance le SAP Gateway Client. Il s'exécute dans le système SAP Gateway, c'est-à-dire le système SAP S/4HANA lui-même dans un déploiement embedded et le système hub dans un déploiement hub.
Peut-on tester des services OData V4 dans /IWFND/GW_CLIENT ?
Oui. Le SAP Gateway Client teste les services OData V2 et V4, et SAP livre le groupe de test V4_TEST comme exemple pour V4. Pour les URI de requête V4, l'outil propose aussi une complétion de code basique via le menu contextuel du champ Request URI.
Pourquoi une requête fonctionne-t-elle dans /IWFND/GW_CLIENT mais échoue-t-elle dans l'application ?
L'application envoie une requête différente ou s'exécute sous un autre utilisateur. Comparez l'URI exacte, les filtres, les en-têtes et le payload relevés dans les outils de développement du navigateur, et vérifiez les autorisations de l'utilisateur concerné avant de modifier le service.
Peut-on utiliser /IWFND/GW_CLIENT dans SAP S/4HANA Cloud Public Edition ?
Aucun usage client n'est documenté pour SAP S/4HANA Cloud Public Edition ; consultez le SAP Help Portal pour connaître les options de test disponibles. Le SAP Gateway Client est documenté pour les systèmes on-premise, Private Edition et SAP ERP.
Sources
- SAP Help Portal: SAP Gateway Client (SAP Gateway Foundation)
- SAP Help Portal: Error Log (SAP Gateway Foundation)
- SAP Help Portal: Which Tools Can Be Used for Troubleshooting? (SAP Gateway Foundation)
- SAP Help Portal: Cross-Site Request Forgery Protection (SAP Gateway)
- S'applique à
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
- Dernière relecture