Administration et dépannage

/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 ? ▾
Où se situe-t-il ?: L4 · Services et APICouche : Services et API.L1L2L3L4L5L6BTP

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 $count ou $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 :

  1. 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/SupplierSet avec son filtre.
  2. Lancez /IWFND/GW_CLIENT, sélectionnez GET et collez l'URI.
  3. Exécutez, puis lisez le statut HTTP et le corps de la réponse.
  4. Modifiez un élément à la fois : supprimez le filtre, ajoutez $format=json, demandez l'entité unique par sa clé.
  5. 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.
  6. 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ésultatCause probableÉtape suivante
HTTP 200 avec les données attenduesLe service fonctionneComparer la requête réelle de l'application, ses filtres et l'utilisateur
HTTP 200 avec un flux videUn filtre, une clé ou une autorisation métier écarte les donnéesTester sans le filtre ; vérifier le business role
HTTP 403Autorisation de démarrage ou autorisation métier manquanteSU53 pour l'utilisateur concerné
HTTP 404Entity set, clé ou chemin de service erronéComparer l'URI avec les métadonnées du service
HTTP 500Exception dans l'implémentation du service/IWBEP/ERROR_LOG pour la pile d'appels
Anciennes propriétés dans les métadonnéesCache de métadonnées obsolèteMenu 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.

  • /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
ObjectifEnvoyer et rejouer des requêtesEnregistrer les requêtes en échec
Travaille avecDes requêtes que vous construisez ou copiezDes requêtes déjà envoyées par les utilisateurs
Question à laquelle il répondQue renvoie le service en ce moment ?Quelle requête a échoué, quand et pourquoi ?
Usage typiqueReproduire, isoler et tester une correctionPremier 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

S'applique à
SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
Dernière relecture

SAP, SAP Fiori, SAPUI5, SAP S/4HANA, SAP BTP et les autres produits et services SAP mentionnés sont des marques commerciales ou des marques déposées de SAP SE (ou d'une société affiliée à SAP) en Allemagne et dans d'autres pays. Ce guide est indépendant ; il n'est ni affilié à SAP SE, ni sponsorisé, ni approuvé par SAP SE.