Partager via

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

Lors du développement d’un adaptateur ou lorsque les métadonnées retournées par le système BLOB changent, il est souvent utile d’afficher la Description du langage des services Web (WSDL) retournée par l’adaptateur pour vérifier que les métadonnées qui concernent 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 du contrôle de recherche et de navigation des 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, puis 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 de recherche et de navigation des métadonnées

Le contrôle de recherche et de navigation de métadonnées est un contrôle Windows 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 fichier WSDL.

  1. Ouvrez une invite de commandes 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 à partir de 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 , cochez la case à côté de cet élément, puis cliquez sur OK.

  6. À partir de la boîte à outils, faites glisser MetadataUserControl vers Form1. Vous devrez peut-être redimensionner le formulaire pour voir l’intégralité 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 le 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 des adaptateurs créés à l’aide du SDK de l’adaptateur LOB WCF