Partage via

Générer WSDL avec le Kit de développement logiciel (SDK) de l’adaptateur LOB WCF

  • Article

Pendant le développement d’un adaptateur, ou lorsque les métadonnées retournées par le système métier changent, il est souvent utile d’afficher le langage WSDL (Web Services Description Language) retourné par l’adaptateur pour vérifier que les métadonnées de vos opérations sont générées correctement. Il existe plusieurs méthodes pour générer le WSDL. Cette rubrique fournit des informations sur l’utilisation de svcutil.exe et le contrôle De recherche de métadonnées.

Utiliser svcutil.exe

Svcutil.exe est un utilitaire en ligne de commande fourni avec le Kit de développement logiciel (SDK) Windows qui accepte une URL et des commutateurs facultatifs et retourne WSDL. Voici un exemple d’utilisation de svcutil.exe pour retourner le WSDL de l’adaptateur Echo :

Svcutil.exe “echov2://lobhostname/lobapplication?enableAuthentication=False” /target:metadata

Cela enregistre les métadonnées en tant que Microsoft.Adapters.Samples.Echov2.wsdl. Si votre adaptateur a de nombreuses opérations, vous pouvez choisir de renvoyer uniquement les opérations souhaitées à l’aide de « op=OperationName » dans le cadre de l’URI. Voici un exemple d’utilisation de ceci pour renvoyer uniquement les informations EchoStrings :

SvcUtil.exe “echov2://lobhostname/lobapplication?enableAuthentication=False&op=Echo/EchoStrings” /target:metadata

Utiliser le contrôle d’accès de recherche de métadonnées

Le contrôle De recherche de métadonnées Est un contrôle Windows qui est utilisé dans les Assistants inclus dans le Kit de développement logiciel (SDK) de l’adaptateur LOB WCF. Vous pouvez ajouter ce contrôle à n’importe quel projet Windows Forms dans Visual Studio et l’utiliser pour sélectionner votre adaptateur, les opérations souhaitées, puis générer le WSDL.

  1. Ouvrez une invite de commandes de Visual Studio.

  2. Dans le menu Fichier , sélectionnez Nouveau, puis cliquez sur Projet.

  3. Dans la boîte de dialogue Nouveau projet , sélectionnez Application Windows dans modèles. Entrez un nom de projet, puis cliquez sur OK.

  4. Ouvrez la boîte à outils, développez Contrôles communs, cliquez avec le bouton droit sur la boîte à outils, puis cliquez sur Choisir des éléments.

  5. Dans la boîte de dialogue Choisir des éléments de boîte à outils, recherchez MetadataUserControl sous l’onglet Composants .NET Framework, sélectionnez la zone case activée en regard de cet élément, puis cliquez sur OK.

  6. À partir de la boîte à outils, faites glisser le MetadataUserControl vers Form1. Vous devrez peut-être redimensionner le formulaire pour afficher l’ensemble du contrôle. Vous devez être en mesure d’exécuter le projet maintenant et de vérifier que le contrôle est fonctionnel, ce qui vous permet de sélectionner un adaptateur et des opérations.

  7. Pour générer WSDL à l’aide de ce contrôle, vous devez ajouter du code à votre formulaire pour appeler la méthode GetWsdl de ce contrôle. L’exemple suivant montre comment appeler GetWsdl et enregistrer les données dans un fichier :

    private void button1_Click(object sender, EventArgs e)  
{  
   ServiceDescription sd = mdUserControl.GetWsdl();  
   FileStream myFileStream = new FileStream(tbWsdlFileName.Text, FileMode.OpenOrCreate, FileAccess.Write);  
   StreamWriter myStreamWriter = new StreamWriter(myFileStream);  
   sd.Write(myStreamWriter);  
   myStreamWriter.Flush();  
   myStreamWriter.Close();  
   MessageBox.Show("WSDL file " + tbWsdlFileName.Text + " is created.");  
}

Voir aussi

Résoudre les problèmes d’adaptateur créé à l’aide du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF