Générer un client WCF ou un contrat de service WCF pour les artefacts de solution SAP
Vous pouvez utiliser le plug-in Visual Studio Add Adapter Service Reference pour générer une classe de client WCF ou un contrat de service WCF (interface) ciblant les opérations sélectionnées sur les artefacts SAP. Vous pouvez également utiliser l’outil ServiceModel Metadata Utility Tool (svcutil.exe) pour générer la classe de client WCF ou le contrat de service WCF ; Toutefois, le plug-in Add Adapter Service Reference expose les fonctionnalités de l’outil ServiceModel Metadata Utility Par le biais d’une interface Microsoft Windows standard. Il fournit également des fonctionnalités de navigation et de recherche qui ne sont pas disponibles avec l’outil svcutil.exe, et génère un fichier de configuration basé sur les propriétés de liaison que vous sélectionnez lorsque vous vous connectez au système SAP.
Génération d’une classe cliente à l’aide du plug-in Add Adapter Service Reference
Effectuez les étapes suivantes pour générer une classe de client WCF à l’aide du plug-in Add Adapter Service Reference.
Pour générer une classe de client WCF
Dans Visual Studio Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis cliquez sur Ajouter une référence de service d’adaptateur.
Une fois la boîte de dialogue Ajouter une référence de service d’adaptateur s’ouvre, suivez les étapes décrites dans Obtenir des métadonnées pour les opérations SAP dans Visual Studio pour vous connecter au système SAP et rechercher des opérations. Pour créer une classe de client WCF pour les opérations que vous sélectionnez, assurez-vous que Client (opérations sortantes) est sélectionné dans la liste déroulante Sélectionner le type de contrat (il s’agit de la valeur par défaut).
Après avoir sélectionné toutes les opérations que vous souhaitez cibler, cliquez sur OK pour générer la classe de client WCF.
Le plug-in Add Adapter Service Reference ajoute deux fichiers à votre projet :
SAPBindingClient.cs. Ce fichier contient la classe de client WCF et le code d’assistance générés pour les opérations que vous avez sélectionnées.
App.config. Ce fichier contient une configuration de liaison et des configurations de point de terminaison client. Les paramètres sont basés sur les sélections que vous avez effectuées lorsque vous avez configuré la liaison et la connexion pour le plug-in Add Adapter Service Reference.
Important
Lors de l’utilisation du plug-in Add Adapter Service Reference, si vous ne spécifiez pas de valeur pour une propriété de liaison de type string et dont la valeur par défaut est Null, cette propriété de liaison ne sera pas disponible dans le fichier app.config. Vous devez ajouter manuellement la propriété de liaison et sa valeur dans le fichier app.config, si nécessaire.
Génération d’un contrat de service WCF à l’aide du plug-in Add Adapter Service Reference
Lorsque vous utilisez l’adaptateur SAP pour recevoir des IDOC, RFC et tRFC à partir du système SAP, votre code agit en tant que service pour l’adaptateur. Autrement dit, l’adaptateur reçoit l’artefact approprié du système SAP, puis appelle une opération (entrante) sur votre code pour remettre l’artefact à votre application.
Vous devez donc implémenter un service WCF qui peut recevoir cette opération entrante de l’adaptateur. Pour ce faire, vous utilisez le plug-in Add Adapter Service Reference pour générer une interface .NET qui représente le contrat de service exposé par l’adaptateur pour l’opération. Cette interface .NET est également appelée contrat de service WCF. Le plug-in Add Adapter Service Reference génère également une classe qui contient une implémentation nommée du service WCF. Vous implémentez ensuite cette interface pour créer le service WCF que vous pouvez utiliser pour recevoir l’opération.
Effectuez les étapes suivantes pour générer un contrat de service WCF à l’aide du plug-in Add Adapter Service Reference.
Pour générer un contrat de service WCF
Dans Visual Studio Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis cliquez sur Ajouter une référence de service d’adaptateur.
Une fois la boîte de dialogue Ajouter une référence de service d’adaptateur s’ouvre, suivez les étapes décrites dans Obtenir des métadonnées pour les opérations SAP dans Visual Studio pour vous connecter au système SAP et rechercher des opérations. Pour créer un contrat de service WCF pour les opérations que vous sélectionnez, assurez-vous que Service (opérations entrantes) est sélectionné dans la liste déroulante Sélectionner le type de contrat .
Après avoir sélectionné toutes les opérations que vous souhaitez cibler, cliquez sur OK pour générer le contrat de service WCF.
Le plug-in Add Adapter Service Reference ajoute trois fichiers à votre projet :
SAPBindingInterface.cs. Ce fichier contient le contrat de service WCF (interface) et le code d’assistance générés pour les opérations que vous avez sélectionnées.
SAPBindingService.cs. Ce fichier contient une classe de service WCF nommée qui implémente l’interface définie dans SAPBindingInterface.cs. Vous pouvez implémenter la logique métier qui traite les RFC, tRFC ou IDOC directement dans les méthodes de cette classe.
App.config. Ce fichier contient une configuration de liaison, des comportements de point de terminaison et une configuration de point de terminaison de service qui sont basés sur les sélections que vous avez effectuées lorsque vous avez configuré la liaison et la connexion pour le plug-in Add Adapter Reference Service.
Important
Lors de l’utilisation du plug-in Add Adapter Service Reference, si vous ne spécifiez pas de valeur pour une propriété de liaison de type string et dont la valeur par défaut est Null, cette propriété de liaison ne sera pas disponible dans le fichier app.config. Vous devez ajouter manuellement la propriété de liaison et sa valeur dans le fichier app.config, si nécessaire.
Notes
Vous n’avez pas besoin de spécifier les paramètres du serveur RFC lorsque vous configurez l’URI de connexion pour le plug-in Add Adapter Service Reference pour générer le contrat de service WCF. L’adaptateur SAP récupère les métadonnées du système SAP via une connexion cliente.
Générer une classe de client WCF ou un contrat de service WCF à l’aide de svcutil.exe
Vous pouvez utiliser svcutil.exe pour générer une classe de client WCF ou un contrat de service WCF pour votre application. Vous devez configurer svcutil.exe pour l’utiliser avec l’adaptateur SAP. Pour plus d’informations sur la configuration et l’utilisation de svcutil.exe avec l’adaptateur SAP, consultez Utilisation de l’outil Utilitaire de métadonnées ServiceModel avec l’adaptateur BizTalk pour mySAP Business Suite.
Svcutil.exe génère la classe de client WCF ou le contrat de service WCF dans un fichier de sortie. Le nom de fichier par défaut est output.cs. Vous devez inclure manuellement ce fichier dans votre projet Visual Studio.
Voir aussi
Développer des applications SAP à l’aide du modèle de canal WCF