Compartir a través de

Generación de WSDL con el SDK del adaptador de LOB de WCF

  • Artículo

Durante el desarrollo de un adaptador o cuando cambian los metadatos devueltos por el sistema LOB, a menudo resulta útil ver el Lenguaje de descripción de servicios web (WSDL) que se devuelve desde el adaptador para comprobar que los metadatos de las operaciones se generan correctamente. Hay varios métodos para generar el WSDL. En este tema se proporciona información sobre el uso de svcutil.exe y el control Examinar de búsqueda de metadatos.

Usar svcutil.exe

Svcutil.exe es una utilidad de línea de comandos que se incluye con Windows SDK que acepta una dirección URL y modificadores opcionales y devuelve WSDL. A continuación se muestra un ejemplo del uso de svcutil.exe para devolver el WSDL del adaptador de eco:

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

Esto guarda los metadatos como Microsoft.Adapters.Samples.Echov2.wsdl. Si el adaptador tiene muchas operaciones, puede optar por devolver solo las operaciones deseadas mediante "op=OperationName" como parte del URI. A continuación se muestra un ejemplo de cómo usar esto para devolver solo la información de EchoStrings:

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

Usar el control Examinar de búsqueda de metadatos

El control Examinar de búsqueda de metadatos es un control de Windows que se usa en los asistentes incluidos en el SDK del adaptador de LOB de WCF. Puede agregar este control a cualquier proyecto de Windows Forms en Visual Studio y usarlo para seleccionar el adaptador, las operaciones deseadas y, a continuación, generar el WSDL.

  1. Abra un símbolo del sistema de Visual Studio 2010.

  2. En el menú Archivo, seleccione Nuevo y después haga clic en Proyecto.

  3. En el cuadro de diálogo Nuevo proyecto , seleccione Aplicación de Windows en Plantillas. Escriba un nombre de proyecto y haga clic en Aceptar.

  4. Abra el Cuadro de herramientas, expanda Controles comunes, haga clic con el botón derecho en el Cuadro de herramientas y, a continuación, haga clic en Elegir elementos.

  5. En el cuadro de diálogo Elegir elementos del cuadro de herramientas , busque MetadataUserControl en la pestaña Componentes de .NET Framework , active la casilla situada junto a este elemento y, a continuación, haga clic en Aceptar.

  6. En el Cuadro de herramientas, arrastre MetadataUserControl a Form1. Es posible que tenga que cambiar el tamaño del formulario para ver todo el control. Debería poder ejecutar el proyecto ahora y comprobar que el control es funcional, lo que le permite seleccionar un adaptador y operaciones.

  7. Para generar WSDL mediante este control, debe agregar código al formulario para llamar al método GetWsdl de este control. En el ejemplo siguiente se muestra cómo llamar a GetWsdl y guardar los datos en el archivo:

    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.");  
}

Consulte también

Solución de problemas del adaptador creado mediante el SDK del adaptador de LOB de WCF