Blog Thinking Together

Workshop Windows Server AppFabric

Roberto — Wed, 26 May 2010 08:26:00 GMT

Next Friday (Madrid, May 28th 2010) we’ll deliver a Workshop about Windows Server AppFabric.

You can register yourself using this page:

https://msevents.microsoft.com/CUI/EventDetail.aspx?EventID=1032451744&Culture=es-ES

Agenda (9:30 – 14:00):

- Introduction to AppFabric (Windows Server & Azure) – César de la Torre – Microsoft

- Distributed Cache using AppFabric-Cache (aka. codename ‘Velocity’) – César de la Torre – Microsoft

-- Coffee time

- Hosting & Monitoring WCF Services (aka. codename ‘Dublin’) – Roberto Gonzalez - Renacimiento

- Hosting Workflow-Services 4.0 (aka. codename ‘Dublin’) – Unai Zorrilla – Plain Concepts

Cloud Computing (Azure) Event

Roberto — Wed, 21 Apr 2010 16:09:00 GMT

Aventia-Renacimiento in collaboration with Microsoft made an event about Cloud Computing.

The event was divided into two parts, in the morning was oriented to business and we had the presence of an expert in legal issues about Cloud Computing. In the Evening, the event was completely technical and we given several talks about development in AZURE and SQL Services. Finally If you wanted could make Hand-On-Labs about Azure.

In the next folder in skydrive http://cid-99fb7d3a483b374f.skydrive.live.com/browse.aspx/Evento%20de%20Azure you can get the ppts.

Regards.

New Site about Architecture in the spanish msdn

Roberto — Wed, 21 Apr 2010 15:57:00 GMT

Microsoft has just opened a portal about Architecture on msdn. http://msdn.microsoft.com/es-es/architecture/default.aspx.

Yesterday Microsoft also presented a book about DDD very interesting in which Renacimiento has participated in its revision.

For those that have not been able to attend, you can download all the documentation of this architecture at the following url:

http://download.microsoft.com/download/2/2/1/221AD022-E701-488F-B070-7A0B87DFE789/Guia_Arquitectura_N-Capas_DDD_NET_4_(Borrador_Marzo_2010).pdf

The sample code:

http://microsoftnlayerapp.codeplex.com/

Regards.

Native Boot to HyperV

Roberto — Wed, 21 Apr 2010 15:49:00 GMT

If you have Windows 7 or Windows Server 2008 R2 and you would like use a virtual machine created for native boot also with HyperV only need to do the next operations:

1. Run Diskpart

2. With Diskpart run the next commands:

· Select vdisk file=C:\<VHDFILENAME>.VHD

· Attach Vdisk

· select part 1

· active

· Assign letter=Z

· Exit

3. With the command prompt, change to Z:\Windows\System32.

· Run BCDboot.exe Z:\Windows /s Z:\

· Run BCDedit /store Z:\boot\BCD /set {bootmgr} device boot

· Run BCDedit /store Z:\boot\BCD /set {default} device boot

· Run BCDedit /store Z:\boot\BCD /set {default} osdevice boot

· Exit

4. Open Diskpart again and run the next commands:

· Select vdisk file=C:\<VHDFILENAME>.VHD

· detach vDISK

· Exit

Once this is done you can open the vhd from HyperV.

Regards.

Microsoft Lauches Biztalk Server 2009

Roberto — Sat, 20 Mar 2010 05:00:00 GMT

Microsoft Lauches globally Biztalk Server 2009

If your are interested in the new feature in Biztalk Server 2009 you can read this information:

http://www.microsoft.com/biztalk/en/us/whats-new.aspx

Regards.

Product Key not valid - SharePoint Server 2010 RC

Roberto — Thu, 18 Feb 2010 20:35:00 GMT

If you are installing SharePoint 2010 in the same machine when you had the beta versión may be you get the error that your Product Key is not valid when try to install the product.

The reason is due to the fact that the beta installation files are yet in the cache folder.

You need go to the path C:\Users\Usuario Instalación\AppData\Local\Temp and find a similar file like SharePoint Server Setup(2010020513575012B4...). If you open this file you can find de cache path, in my case C:\Program Files (x86)\MSECache\oserver2010.

You have to delete this folder to resolve the problem.

MVP Renewal

Roberto — Thu, 02 Jul 2009 04:06:59 GMT

Yesterday I received the email from Microsoft that informs me that Iâ€™ve been awarded the Microsoft Most Valued Professional for last years community effort.

Iâ€™m really happy for being renewed as MVP BizTalk Server.

Congrats to all those renewed, and especially to those who were awarded for the first time.

Regards.

TFS 2008 and VS2010 Beta1

Roberto — Tue, 23 Jun 2009 12:33:48 GMT

Some users have tried to connect to TFS 2008 using VS2010 Beta1, and they have got the following error:

TF31001: Cannot connect to Team Foundation Server at xxx.com. The server returned the following error: The ServicePointManager does not support proxies with the https scheme.

The problem is that the default value to BypassProxyOnLocal (proxy server should be bypassed for local addresses) in TFS 2008 is false, while in 2010 the default value is true, resolving a performance problem experienced by some customers.

If you want to solve your problem just follow this post:

http://blogs.msdn.com/ablock/archive/2009/05/20/for-tfs-2010-beta-1-resolving-tf31001-the-servicepointmanager-does-not-support-proxies-with-the-https-scheme.aspx

Regards.

Whitepaper WCF LOB Adapter SDK and Biztalk Adapter Pack

Roberto — Mon, 08 Jun 2009 08:41:00 GMT

In the next url WCF LOB Adapter SDK and the BizTalk Adapter Pack, you can download a whitepaper about development of adapters based on WCF LOB Adapter SDK and the consume from .NET Application, from Biztalk, MOSS, and so on.

Part of this document to tell you how to create WCF-based adapters and also explains you the WCF channel model.

I strongly recommend reading.

Regards

Architects not programming

Roberto — Thu, 04 Jun 2009 07:07:00 GMT

The other day I was giving a talk on Microsoft about Microsoft Visual Studio 2010 focused on Architect. My talk was specifically about Test Driven Development.

Hadi Hariri asked the audience how many of them developed and used unit tests. The curious thing about this question was the answer: about 150 people raised their hands about 10 people.
This means that most attendees were architects, project managers, etc.. and only 10 developed.
My question is, can you be a good software architect, and not to program?. For example, how can you recommend using Entity Framework if you've not used it and no known problems (or the actual benefits) that can give it to you?.
I understand that the role of an architect is not programming, but from my point of view, an architect should always to be updated and not should disconnect from the technical part, participating developing certain projects (not with a large load course).

I think that reading only, yout don’t get enough knowledge to be able to define which components, technologies or products are best suited to develop an application.

Regards.

OSLO CTP Mayo 2009

Roberto — Fri, 29 May 2009 07:33:38 GMT

Microsoft have just released the May 2009 â€œOslo CTPâ€.

As you will know Oslo is a Microsoft modeling tool.
The Oslo modeling tools include:

A storage runtime (based on SQL Server 2008) where to store the schemas and instances of data.
A visual modeling tool (Microsoft code name "Quadrant").
A modeling language (Microsoft code name "M").

In this CTP is the first time that Quadrant is made available to the public . Until now we could only create models by "M".

The link to download this CTP is http://go.microsoft.com/?linkid=9648442.
For more details about the changes in this release visit http://msdn.microsoft.com/en-us/oslo/releasenotes.aspx.

Regards.

REST AND WCF

Roberto — Fri, 29 May 2009 06:25:35 GMT

REST defines a style of architecture-focused resources. These resources are accessed using URIs and HTTP verbs (GET, POST, PUT and DELETE) rather than based on the SOAPAction as SOAP HTTP.
Some of the benefits of REST are:

Lightweight. Excluding extra xml as SOAP packets.
The result returned by REST is easily understandable. Is Human Readable.
No need toolkits for use.
Simple. Obviously has less functionality than a service based on soap/WS- *, but in many cases should be sufficient with this functionality.

If we were to invoke a RESTFUL web service that returned us a customer identifier (25) . The URI to invoke this resource would be as follows:

http://demo/ventas.svc/cliente/25

However in the case of a SOAP Web service through the URI we could only identify the endpoint of the service:

http://demo/ventas.svc

At most the operation to invoke:

http://demo.ventas.asmx?op=ObtenerClientes

Once you "know" that is REST, we will implement a RESTful service based on WCF.

Service Creation

First of all we must create a new service, for this we will build on the default template for VS 2008. Call RESTService project.

2. Rename the file IService1 by ICalc and modifies the contents of it with the following code:

     using System;using System.Collections.Generic;

    using System.Linq;

    using System.Runtime.Serialization;

    using System.ServiceModel;

    using System.Text;

    using System.ServiceModel.Web; 

    namespace RESTService{   

        [ServiceContract]     

        public interface ICalculadora    

        {        

            [OperationContract]        

            [WebGet(         

                BodyStyle = WebMessageBodyStyle.Bare,         

                ResponseFormat = WebMessageFormat.Xml,         

                UriTemplate="/Sumar/{op1}/{op2}")]        

            string Sumar(string op1,string op2);    

        }

    }

The only difference between a WCF Service is that we have added the attribute WebGet to the method Sum. This attribute indicates that the operation is a recovery one and can be called via the web programming model. Furthermore, we indicate that the URI to access to the resource is:

http://servidor/RESTService.Calculadora.svc/Sum/25/50.

Note: You will see that the parameters in this case should be numeric but are string. This is because it is required by UriTemplate.

In the case that the operation is not a recovery operation , we must use the [WebInvoke] attribute.

Sample:

       1: [OperationContract]   

       2: [WebInvoke(Method="DELETE",UriTemplate="/Product/{idProduct}")]   

       3: public void DeleteProduct(string idProduct)   

       4: {   

       5:     // Delete the product 

       6: }

3. Rename the file Service1.cs by Calc.cs and modifies the contents of it with the following code:

1: using System;

2: using System.Collections.Generic;

3: using System.Linq;

4: using System.Runtime.Serialization;

5: using System.ServiceModel;

6: using System.Text;

7: namespace RESTService

8: {

9: public class Calc : ICalc

10: {

11: public string Sum(string op1, string op2)

12: {

13: int operator1=0;

14: int operator2=0;

15: string sResult = "";

16: if ((int.TryParse(op1, out operator1)) && (int.TryParse(op2, out operator2)))

17: {

18: sResult = string.Format("The result is: {0}", operator1 + operator2);

19: }

20: return sResult;

21: }

22: }

23: }

As you can see, this code implements a method which has two parameters and returns the sum as a result . There's no difference between a "traditional" Service and RESTful.

4. Verify that int the app.config file are reflected all the changes we have made names for code files.

5. Locate the endpoint definition and change wsHttpbinding by webHttpbinding. At the end you should have something like the following.

       1: <endpoint address="" binding="webHttpBinding" 

       2:     contract="RESTService.ICalc" 

       3:     behaviorConfiguration="WebBehavior">

6. Add the following xml node inside <behaviors>:

       1: <endpointBehaviors>   

       2:     <behavior name="WebBehavior">        

       3:         <webHtpp/>    

       4:     </behavior>

       5: </endpointBehaviors>

The binding webHttpbinding indicates that this service should be exposed via HTTP requests exposing Plain old XML (POX) instead of SOAP-based messages. This binding is used in conjunction with behavior WebHttp to enable web programming model for WCF service.

With this we have already created a RESTful service.

Consuming Service

RESTful services can be invoked in two ways:

1. Invoking the service directly through the object WebChannelFactory.
2. Adding a reference to the service and minimally changing the proxy.

I prefer the last one, because everything is much cleaner and we invoke all the services in the same way regardless of how they are exposed.

Method 1: WebChannelFactory

1. Create a console program used to test the RESTful service.
2. Add a reference to System.ServiceModel.Web namespace .
3. Adds a copy of the ICalculadora.cs to this project.
4. Add the following code to consume the service:

       1: WebChannelFactory<ICalc> factory = new WebChannelFactory<ICalc>(new Uri("Service_URI"));    

       2: ICalc proxy = factory.CreateChannel();    

       3: string response = proxy.Sum("25","70");    

       4: ((IDisposable)proxy).Dispose();

Remeber you need change â€œService_URIâ€ by the Service URL.

This invoking method does not need a services reference, it is only necessary to gain access to the Service interface.

Method 2 (Add Services Reference)

1. Create a console program used to test the RESTful service.
2. Add a reference to System.ServiceModel.Web namespace .
3. Add a reference to the RESTful service that you want to invoke.
4. Open the file containing the proxy code (Reference.cs) to invoke the service. Locate the Sum method and add the following attribute above:

       1: [WebGet(    

       2:     BodyStyle = WebMessageBodyStyle.Bare,    

       3:     ResponseFormat = WebMessageFormat.Xml,    

       4:     UriTemplate = "/Sum/{op1}/{op2}")]

With this attribute the proxy knows how to invoke the service.

5. Open the app.config file and locate the node called <client> and add the service endpoint definition to consume:

       1: <endpoint address="service_address" behaviorConfiguration="test"   

       2:     binding="webHttpBinding" contract="ServiceReference1.ICalc"    

       3:     name="WebHttpBinding1"/>

6. Below </client> add the next xml:

       1: <behaviors>  

       2:     <endpointBehaviors>   

       3:         <behavior name="test">       

       4:             <webHttp/>   

       5:         </behavior>   

       6:     </endpointBehaviors>        

       7: </behaviors>

Having made these changes we can invoke the service:

       1: CalcClient calc = new ConsoleApplication2.ServiceReference1.CalcClient("WebHttpBinding1");    

       2: string response = calc.Sum("25","70");

Finally, we will use fiddler to see the calls exchange between the client and HTTP service.
In the case of the REST service call we will get the following trace:

       1: GET /RESTService.Calculadora.svc/Sumar/25/70 HTTP/1.1   

       2: Content-Type: application/xml; charset=utf-8   

       3: VsDebuggerCausalityData: uIDPo8iVuDxtWzVIoOWhMWz8d6cAAAAAQQ14Z3Np/kGe9oMjdzTKnIAB0WdKCntFi092ERAO19oACQAA   

       4: Host: xxxxxx   

       5: Connection: Keep-Alive

In the case of the SOAP service call we will get the following trace:

       1: POST /WcfServiceLibrary1.Service1.svc HTTP/1.1   

       2: Content-Type: text/xml; charset=utf-8   

       3: VsDebuggerCausalityData: uIDPo9JShnIh9h9LnpM3i3SLcV8AAAAADD0BBgGqLkCAeQs6rXWB4Cv3lHKbfRpOq02eDFtYkC4ACQAA   

       4: SOAPAction: "http://tempuri.org/IService1/GetData"   

       5: Host: xxxxxxxx   

       6: Content-Length: 158   

       7: Expect: 100-continue   

       8: Connection: Keep-Alive   

       9:  

      10: <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  

      11:     <s:Body>  

      12:         <GetData xmlns="http://tempuri.org/"> 

      13:             <value>25</value>  

      14:         </GetData>  

      15:     </s:Body>  

      16: </s:Envelope>

If we compare with another one trace, we will test that in the "REST" Service is the GET operation which defines the method to invoke and the parameters , there is no SOAPAction, while in the "SOAP" Service we need the SOAPAction attribute to define the method to invoke and a envelope where we define the parameters passed to this method.

The service "REST" response is the following:

       1: HTTP/1.1 200 OK   

       2: Content-Type: application/xml; charset=utf-8   

       3: Server: Microsoft-IIS/7.0   

       4: X-Powered-By: ASP.NET   

       5: Date: Mon, 27 Apr 2009 14:33:52 GMT   

       6: Content-Length: 92   

       7:  

       8: <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">The result is: 95</string>

The service "SOAP" response is the following:

       1: HTTP/1.1 200 OK   

       2: Content-Type: text/xml; charset=utf-8   

       3: Server: Microsoft-IIS/7.0   

       4: X-Powered-By: ASP.NET   

       5: Date: Mon, 27 Apr 2009 14:28:00 GMT   Content-Length: 203   

       6:  

       7:  

       8:  

       9: <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  

      10:     <s:Body>  

      11:         <GetDataResponse xmlns="http://tempuri.org/">  

      12:             <GetDataResult>You entered: 25</GetDataResult>  

      13:         </GetDataResponse>  

      14:     </s:Body>  

      15: </s:Envelope>

As we can see in the trace, the "REST" response is much simpler and smaller than the "SOAP" response.
In the next link RESTService.zip you have available the example files. It is a very simple example but it explains the basis for building a REST service.
Finally it is only to say that Microsoft has released a Starter Kit on CodePlex (Preview 2) that provides classes and templates for the creation of RESTful services.
In another post we will see how to create and consume a service using this starter kit.

Regards.

New site Talking about Windows

Roberto — Tue, 28 Apr 2009 06:09:00 GMT

Microsoft has opened a new site called Talking about Windows www.talkingaboutwindows.com.

In this site, the Windows 7 product team is going to publish information without NDA. Thist site has videos which you can comment.

Regards.

Biztalk Development Center

Roberto — Tue, 07 Apr 2009 10:17:00 GMT

Microsft has just to release a site to share resource about Biztalk.

In this Site we will have available whitepapers, web casts, talks, etc which may be interesting for you.

http://msdn.microsoft.com/en-us/biztalk/default.aspx

Regards.

WCF Champ

Roberto — Tue, 07 Apr 2009 09:51:00 GMT

Microsft has just launched a campaign target web service developers who unaware WCF or who has tried WCF in the past but dont use this technology in their applications.

The campaign has two primary components:

Three videos

These videos have a common theme: WCF developers versus traditional web services developers.

2. Web site

Web Site with resource to improve the learning curve about WCF.

http://www.microsoft.com/net/wcf/champ

Regards.

Biztalk Server 2009 Beta

Roberto — Tue, 09 Dec 2008 07:40:00 GMT

Microsoft has just release a beta version of BizTalk Server 2009.
Some of the enhancements in this version are the support for Visual Studio 2008 SP1, .NET Framework 3.5 SP1, SQL Server 2008 and TFS.
The support of TFS will allow us to manage a complete life cycle of an application BizTalk. Among other things we can management unit tests, continuous integration, automated desployments and so on.
Is available a new sdk to development of adapters rely on WCF (LOB Adapter SDK).
The new version is avalilable in connect.microsoft.com.

Regards.

Mount a Virtual Hard Disk (VHD)

Roberto — Fri, 07 Nov 2008 08:25:00 GMT

How many times we have to start a Virtual Machine only to get a Project or document. Trying to resolve this problem I found that Vitual Server 2005 R2 allow you mount a VHD in your operating system.

You have not to install the complete product. Installing the VHDMount utility will be enought.

To mount the vhd we'll have to execute the next command "C:\Program Files\Microsoft Virtual Server\Vhdmount\vhdmount.exe" /m "path file vhd".

To unmount the vhd we'll have to execute the next command "C:\Program Files\Microsoft Virtual Server\Vhdmount\vhdmount.exe" /u "path file vhd".

Evento CEUS

Roberto — Thu, 30 Oct 2008 10:06:51 GMT

Ayer he estado impartiendo una charla en la Conferencia de usuarios de Sharepoint organizada por Microsoft, donde hemos visto como construir aplicaciones RIA basándonos en MOSS y Silverlight 2.0.

Aquí os dejo la presentación y las demos que se vieron en la charla.

http://cid-99fb7d3a483b374f.skydrive.live.com/browse.aspx/CEUS%20IV%20-%20Silverlight%20MOSS?uc=2

Muchas gracias a todos los asistentes.

Evento de ALM'08 - Gestión del ciclo de vida de soluciones Sharepoint

Roberto — Mon, 13 Oct 2008 05:34:00 GMT

Este Jueves 16 de Octubre participaré como ponente en el evento de ALM que organiza Mcrosoft.

En esta charla veremos como gestionar el ciclo de vida de soluciones Sharepoint usando Visual Studio 2008 y TFS.

Veremos como gestionar de una forma automatizada las compilaciones diarias, pruebas unitarias y despliegues de soluciones basadas en Sharepoint.

Espero veremos por alli.

Charla en el grupo de usuarios Madrid.Net

Roberto — Mon, 28 Jul 2008 09:46:00 GMT

El jueves 24 de Julio impartí una charla de integración de WCF y WF (Workflow Services) en el grupo de usuarios de Madrid.NET.

Agradecer a todos los asistentes que tuvieron la amabilidad de venir el jueves a la charla antes del puente :).

Como lo prometido es deuda aquí os dejo el contenido de la charla.

MVP de Microsoft por segundo año consecutivo

Roberto — Tue, 01 Jul 2008 14:31:44 GMT

Acabo de recibir un mail comunicándome la renovación del MVP de Biztalk por segundo año consecutivo.

Es una inyección de moral para seguir colaborando con la comunidad y aprendiendo de todos vosotros.

Saludos.

Poster Interactivo con las capacidades de Biztalk

Roberto — Thu, 26 Jun 2008 04:41:37 GMT

Microsoft ha publicado hace tiempo la siguiente página http://www.microsoft.com/biztalk/capabilities/reader/ construida con Silverlight, que permite ir navegando de forma interactiva por un poster con las capacidades de Biztalk Server 2006 R2.

Si hacemos click en cada funcionalidad del poster se abrirá una ventana explicando dicha capacidad con enlaces al msdn de microsoft por si queremos completar la explicación.

Saludos.

Como crear un adaptador con WCF LOB Adapter SDK

Roberto — Mon, 16 Jun 2008 04:10:00 GMT

He encontrado muy poca información en español sobre el desarrollo de adaptadores con WCF LOB Adapter SDK. Con este post intento poner mi granito de arena para intentar arrojar algo de luz sobre este tema.

¿Porqué la necesidad de WCF LOB Adapter SDK?

Los adaptadores desarrollados hasta ahora eran dependientes tanto del consumidor como de la aplicación destinataria, es decir un adaptador desarrollado para comunicar Microsoft Biztalk Server con SAP no nos vale para comunicar Sharepoint con SAP.

WCF LOB Adapter SDK soluciona esta limitación, permitiendo que el adaptador que desarrollemos para obtener información de una aplicación de línea de negocio pueda ser consumido desde Biztalk, desde SQL Server, desde Microsoft Office Sharepoint Server o por ejemplo desde una aplicación .NET personalizada.

¿Qué es WCF LOB Adapter SDK?

Es un conjunto de herramientas y componentes que nos van a facilitar el desarrollo de adaptadores para aplicaciones de línea de negocio.

Las principales características de WCF LOB Adapter SDK son las siguientes:

Proporciona un Wizard que facilita la creación de nuevos adaptadores guiando al desarrollador paso a paso.
Expone el adaptador como si fuera un binding de WCF.
Proporciona un Add-in que permite añadir referencias a adaptadores desde aplicaciones .net desarrolladas con Visual Studio 2005.
Crea un contrato dinámicamente en tiempo de diseño.

WCF LOB Adapter SDK está basado en el modelo de Canal de WCF.

El modelo de canal de WCF consiste en una pila con uno o varios canales que se encargan de procesar los mensajes que fluyen entre ellos. Es muy parecida a la pila de TCP.

WCF LOB Adapter SDK utiliza el modelo de extensibilidad de canales exponiendo los adaptadores mediante binding personalizados.

Pasos para la creación de un adaptador

En la siguiente url podemos descargarnos el SDK con el Service Pack 1.

A continuación vamos a empezar a desarrollar un adaptador de que nos permitirá obtener correos mediante el protocolo POP3. Este adaptador lo podremos usar independientemente en aplicación .net o por ejemplo en Microsoft Biztalk sin modificar una sola línea de código.

Asistente de creación del adaptador

Lo primero que debemos hacer es crear un nuevo proyecto en con Visual Studio 2005 y seleccionar la plantilla WCF LOB Adapter.

Una vez creado el proyecto se lanzará un asistente que nos irá guiando paso paso en la creación del adaptador.

En el primer paso debemos definir los siguientes campos:

Scheme: esquema usado para el protocolo de transporte del binding del adaptador. Por ejemplo el binding WSHttpBinding usa HTTP como esquema. Nosotros deberemos rellenar esta caja de texto con el valor mail.
Project namespace: todas las clases creadas por el asistente pertenecerá al namespace que pongamos aquí. Nosotros usaremos el namespace ejemplo.adaptadorwcf.
Service namespace: La concatenación del esquema más el namespace del proyecto dará lugar al namespace del WSDL generado por el adaptador. En nuestro caso el namespace del servicio será mail://ejemplo.adaptadorwcf. Si quisiéremos modificar el namespace propuesto por el wizard solamente tenemos que marcar la opción Overwrite default service namespace y modificar el valor por el que deseemos.

2. En el siguiente paso debemos definir la dirección del flujo de datos soportado por el adaptador:

Synchronous outbound: el adaptador soporta el envío de mensajes al sistema destino.
Asynchronous outbound: el adaptador soporta el envío de mensajes de forma asíncrona al sistema destino.
Synchronous inbound: el cliente recibe información del sistema destino vía adaptador.
Asynchronous inbound: el adaptador soporta la recepción de mensajes del sistema destino de forma asíncrona.

Además debemos definir las opciones de metadatos soportada por el adatador:

Retrieval: Genera la definición de las operaciones y tipos complejos del sistema destino. Esta información será utilizada por el adaptador para la generación del contrato del servicio.
Browse: Permite que el usuario navegue de forma jerárquica por los metadatos del sistema destino para seleccionar las operaciones que desea invocar.
Search:Permite que el usuario realice una búsqueda en los metadatos del sistema destino para seleccionar las operaciones que desea invocar.

3. En el siguiente paso debemos definir las propiedades del adaptador:

En nuestro caso no definiremos nada aquí.

3. En el siguiente paso debemos definir las propiedades de conexión con el sistema destino:

Las propiedades necesarias para la conexión son el servidor, el usuario y el password.

La gestión de credenciales utilizada en este ejemplo no es ni mucho menos la ideal, ya que se muestra el usuario y el password en texto plano en la URI. Os invito a que modifiquéis el adaptador para dar una solución mas eficiente y segura a la gestión de credenciales.

Finalmente se mostrará un resumen de la configuración del adaptador que hemos ido estableciendo en los pasos precedentes. Si estamos conformes pulsaremos en el botón Finish para que el Wizard cree las clases necesarias para implementar el adaptador.

Gestión de la conexión con el sistema destino

El adaptador crea por nosotros el esqueleto de las clases necesarias para poder gestionar la conexión con el sistema destino.

La clase Pop3AdapterConnectionUri.cs es la encargada de parsear y construir la cadena de conexión de la aplicación de línea de negocio destino.

El desarrollador del adaptador usará esta clase para parsear la URI de conexión proporcionada por el cliente y extraer de ella todos los parámetros de conexión necesarios.

public override Uri Uri
{
   get
   {
      	//Validación de las propiedades de conexión
      	if (Servidor == string.Empty)
      	{
           throw new InvalidUriException("Parámetro Servidor no válido");
      	}
      	if (Usuario == string.Empty)
      	{
           throw new InvalidUriException("Parámetro Usuario no válido");
	}
       if (Password== string.Empty)
       {
       	    throw new InvalidUriException("Parámetro Password no válido");
       }

       return new Uri(Pop3Adapter.SCHEME + "://" +
                      Servidor + "/" + Usuario + "/" + Password);

   }
   set
   {
      string[] datosUri = value.AbsoluteUri.Split('/');
                Servidor = datosUri[2];
                Usuario = datosUri[3];
                Password = datosUri[4];
               
   }
}

La clase Pop3AdapterConnectionFactory.cs es la responsable de definir y crear la conexión con el sistema destino.

Para ello debemos modificar el método CreateConnection para que devuelva un objeto de conexión con el servidor de correo.

public IConnection CreateConnection()
{
  return new Pop3AdapterConnection(conexionUri.Usuario,conexionUri.Password,

					conexionUri.Servidor, this);
}

El constructor de la clase Pop3AdapterConnectionFactory pasa en uno de los parámetros un objeto de tipo ConnectionUri con la información de conexión con el sistema destino. El problema es que el wizard no asigna ese objeto a ninguna propiedad de la clase con lo cual se pierde la información. Para solucionar este problema debemos declarar una variable privada llamada conexionUri y modificar el constructor de la clase para asignar a esta propiedad la información de conexión.

public Pop3AdapterConnectionFactory(ConnectionUri connectionUri
            , ClientCredentials clientCredentials
            , Pop3Adapter adapter)
{
    this.clientCredentials = clientCredentials;
    this.adapter = adapter;
    this.conexionUri = (Pop3AdapterConnectionUri)connectionUri;
}

Por último la clase Pop3AdapterConnection.cs es la encargada de realizar las llamadas a bajo nivel para gestionar la conexión con el sistema destino.

Debemos modificar el constructor de la clase para inicializar el objeto de conexión con el servidor de correo. La clase Pop3 es una clase gratuita obtenida de la web Codeproject en la url http://www.codeproject.com/KB/IP/despop3client.aspx que emplearemos para obtener los mail del servidor de correo.

public Pop3AdapterConnection(string Usuario,string Password, string Servidor,

				Pop3AdapterConnectionFactory connectionFactory)
{
    this.connectionFactory = connectionFactory;
    this.connectionId = Guid.NewGuid().ToString();
    objConexionPop3 = new Pop3.Pop3Client(Usuario,Password,Servidor);
}

Debemos modificar los métodos que se encargan de abrir y cerrar la conexión:

public void Close(TimeSpan timeout)
{
    objConexionPop3.CloseConnection();
}

 public bool IsValid(TimeSpan timeout)
{
    return true;
}
 public void Open(TimeSpan timeout)
{
    objConexionPop3.OpenInbox();
}

Gestión de metadatos

La clase Pop3AdapterMetadataBrowseHandler.cs se encargará de mostrar de forma jerárquica las categorías y operaciones de la aplicación de línea de negocio al consumidor para que este seleccione las operaciones que desea invocar.

Debemos implementar el método Browse de esta clase para mostrar la operación de Monitorización de correo al consumidor.

Como podemos ver en el siguiente código, este método devuelve cada una de las operaciones y categorías del sistema destino como una lista de objetos de tipo MetadataRetrievalNode.

public MetadataRetrievalNode[] Browse(string nodeId
            , int childStartIndex
            , int maxChildNodes, TimeSpan timeout)
{
	List<MetadataRetrievalNode> lista = new List<MetadataRetrievalNode>();
       //Nodo raiz
       if (MetadataRetrievalNode.Root.NodeId.Equals(nodeId))
       {

          MetadataRetrievalNode nodo = new MetadataRetrievalNode("Operaciones");
          nodo.Direction = MetadataRetrievalNodeDirections.Inbound;
          nodo.DisplayName = "Operaciones";
          nodo.IsOperation = false;
          return new MetadataRetrievalNode[] { nodo };
       }
       else
       {
          MetadataRetrievalNode nodoInbound = new MetadataRetrievalNode("MonitorizacionCorreo");
          nodoInbound.DisplayName = "MonitorizacionCorreo";
          nodoInbound.IsOperation = true;
          nodoInbound.Direction = MetadataRetrievalNodeDirections.Inbound;
          lista.Add(nodoInbound);

          return lista.ToArray();
       }
}

La clase Pop3AdapterMetadataSearchHandler.cs nos permite buscar operaciones en la aplicación de línea de negocio para su posterior invocación.

El usuario introducirá un criterio de búsqueda en el asistente del adaptador y el método Search de la clase Pop3AdapterMetadataSearchHandler.cs se encargará de realizar la búsqueda de metadatos en el sistema destino utilizando dicho criterio.

La implementación del método Search es muy similar al del método Browse. El método debe devolver como resultado una lista de objetos de tipo MetadataRetrievalNode que el adaptador usará para mostrar las operaciones encontradas al usuario para su posterior consumo.

En este caso concreto comparamos el criterio de búsqueda introducido por el usuario con la palabra "monitorizacioncorreo" devolviendo, si hay coincidencia, una lista con un nodo que contendrá la operación MonitorizacionCorreo.

Este es el caso mas simple que nos podemos encontrar, lo ideal es permitir al usuario que introduzca caracteres comodín para que la búsqueda sea mas sencilla para el.

public MetadataRetrievalNode[] Search(string nodeId
		, string searchCriteria
            	, int maxChildNodes, TimeSpan timeout)
{
	List<MetadataRetrievalNode> lista = new List<MetadataRetrievalNode>();
       
       if (searchCriteria.ToLower() == "monitorizacioncorreo")
       {
          MetadataRetrievalNode nodoInbound = new MetadataRetrievalNode("MonitorizacionCorreo");
          nodoInbound.DisplayName = "MonitorizacionCorreo";
          nodoInbound.IsOperation = true;
          nodoInbound.Direction = MetadataRetrievalNodeDirections.Inbound;
          lista.Add(nodoInbound);
       }
       return lista.ToArray();

La clase Pop3AdapterMetadataResolverHandler.cs es la encargada de obtener la definición de las operaciones y tipos complejos de estas operaciones, para que el adaptador pueda generar en base a esta información el contrato del servicio.

Esta clase tiene dos métodos que debemos desarrollar:

ResolveOperationMetadata: este método es el responsable de obtener los metadatos que representan las operaciones ofrecidas por el sistema destino.
ResolveTypeMetadata: este método es el responsable de obtener los metadatos de los tipos complejos usados por el sistema destino.

En el método ResolveOperationMetadata vamos a crear un objeto de tipo ParameterizedOperationMetadata que va a contener la definición de la operación.

Una vez creado el objeto que contiene la operación, vamos a ir añadiendo a la colección Parameters de este cada uno de los parámetros del la operación.

public OperationMetadata ResolveOperationMetadata(string operationId, TimeSpan timeout,

					out TypeMetadataCollection extraTypeMetadataResolved)
{
  extraTypeMetadataResolved = null;

  string nombreOperacion = "MonitorizacionCorreo";
  ParameterizedOperationMetadata operationMetadata =

		new ParameterizedOperationMetadata(operationId, nombreOperacion);

  operationMetadata.DisplayName = "RecibirNuevoCorreo";
  operationMetadata.OriginalName = "Evento_RecibirNuevoCorreo";

  OperationParameter asuntoCorreo = new OperationParameter("asuntoCorreo",

			OperationParameterDirection.In,

			QualifiedType.StringType, false);
  asuntoCorreo.Description = "Asunto del correo";
  operationMetadata.Parameters.Add(asuntoCorreo);

  OperationParameter cuerpoCorreo = new OperationParameter("cuerpoCorreo",

					OperationParameterDirection.In,

					QualifiedType.StringType, false);
  asuntoCorreo.Description = "Contenido del correo";
  operationMetadata.Parameters.Add(cuerpoCorreo);

  OperationParameter remitente = new OperationParameter("remitente",

					OperationParameterDirection.In,

					QualifiedType.StringType, false);
  asuntoCorreo.Description = "Remitente del correo";
  operationMetadata.Parameters.Add(remitente);

  OperationParameter destinatario = new OperationParameter("destinatario",

					 OperationParameterDirection.In,

					 QualifiedType.StringType, false);
  asuntoCorreo.Description = "Destinatario del correo";
  operationMetadata.Parameters.Add(destinatario);


  operationMetadata.OperationResult = null;
  return operationMetadata;
}

En nuestro caso no tenemos ningún tipo complejo por lo tanto no implementaremos el método ResolveTypeMetadata.

Ejecución de las operaciones

Ya por último solo nos queda añadir la lógica que monitorizará el correo y enviará los mensajes obtenidos al consumidor del adaptador.

Para ello vamos a implementar los siguientes métodos:

StartListener: lógica de escucha de mensajes asociados a una operación en concreto (action).
StopListener: fin de la escucha de mensajes.
TryReceive: intenta recibir un mensaje de entrada de la aplicación de negocio destino. Este método devuelve un valor booleano indicando si se ha podido obtener el mensaje del sistema destino o no.
WaitForMessage: espera un mensaje de entrada de la aplicación de negocio destino.

En el método StartListener crearemos una cola de mensajes que contendrán todos los mails del servidor de correo pendientes de notificar al consumidor.

Para monitorizar el servidor de correo vamos a crear un timer que cada 10 segundos compruebe los mails que hay.

public void StartListener(string[] actions, TimeSpan timeout)
{
       colaMensajesEntrada = new Queue<Message>();
       foreach (string action in actions)
       {
          if ("MonitorizacionCorreo".Equals(action))
          {
             delegado = new TimerCallback(Monitoriza);
             objThread = new Timer(delegado, null, 1000, 10000);
          }
       }
}

En el método StopListener pararemos la monitorización del servidor de correo.

public void StopListener(TimeSpan timeout)
{
	objThread.Dispose();
}

En el método TryReceive comprobaremos si la cola de mensajes tiene algún correo pendiente de notificar al consumidor del adaptador. La notificación la realizaremos mediante el parámetro de salida message que tiene el propio método. Además debemos de devolver como resultado de la función true en el caso que estemos devolviendo un mensaje o false si no tenemos nada pendiente que notificar del sistema destino.

public bool TryReceive(TimeSpan timeout, out System.ServiceModel.Channels.Message message,

			out IInboundReply reply)

{
       reply = new Pop3AdapterInboundReply();
       message = null;

       if (colaMensajesEntrada.Count != 0)
       {
          message = colaMensajesEntrada.Dequeue();
          if (message != null)
          {
              return true;
          }
        }
        return false;
}

El método encargado de monitorizar la entrada de nuevos correos obtendrá la conexión del servidor de correo de las propiedades del adaptador e irá encolando cada uno de los mensajes que reciba.

private void Monitoriza(Object stateInfo)
{
  int contadorMail=0;
  Pop3Client email = this.Connection.Conexion;
  while (email.NextEmail(contadorMail))
  {
     string asuntoCorreo = email.Subject;
     string cuerpoCorreo = email.Body;
     string remitente = email.From;
     string destinatario = email.To;

     Message msg = CrearMensajeRecepcionPedido(asuntoCorreo,cuerpoCorreo,remitente,destinatario);
     colaMensajesEntrada.Enqueue(msg);
     contadorMail++;
  }
            
}

El mensaje que debemos enviar al consumidor del adaptador para notificarle de la llegada de nuevos correos debe cumplir un formato concreto.

En el siguiente método podemos ver como transformar la información obtenida del servidor de correo en un formato que podamos enviar al consumidor a través del adaptador.

private Message CrearMensajeRecepcionPedido(string asuntoCorreo, string cuerpoCorreo,

					string remitente, string destinatario)
{

  Pop3Adapter adapter = this.Connection.ConnectionFactory.Adapter;

  String xmlData = String.Format(@"<RecibirNuevoCorreo xmlns=""{0}""><asuntoCorreo>" + asuntoCorreo

  + "</asuntoCorreo><cuerpoCorreo>" + cuerpoCorreo + "</cuerpoCorreo><remitente>" + remitente

  + "</remitente><destinatario>" + destinatario

  + "</destinatario></RecibirNuevoCorreo>", adapter.ServiceNamespace);

  XmlReader reader = XmlReader.Create(new StringReader(xmlData));

  Message msgResultado = Message.CreateMessage(MessageVersion.Default,

                          "MonitorizacionCorreo", reader);
  return msgResultado;
}

Despliegue del adaptador

Una vez desarrollado el adaptador, debemos firmarlo con un strong name y subirlo al Global Assembly Cache. Debemos copiar la clave pública del assembly una vez que lo hayamos subido al GAC ya que lo necesitaremos luego para registrar el adaptador en el fichero de configuración.

El adaptador lo podremos registrar tanto en el machine.config en el caso que queramos que el adaptador esté disponible para todos los proyectos de la máquina, o lo podemos registrar en el fichero de configuración del proyecto donde vayamos a consumir el adaptador.

Nosotros en este ejemplo vamos a registrarlo en el machine.config para que esté accesible desde todos los proyectos.

Vamos a registrar el adaptador como un elemento de binding. Para ello en la sección <system.serviceModel><extensions><bindingElementExtensions> añadiremos el

siguiente xml:

<add name="AdapterPOP3" type="ejemplo.adaptadorwcf.Pop3AdapterBindingElementExtensionElement,

Pop3Adapter, Version=1.0.0.0,

Culture=neutral, PublicKeyToken=447f918ac099d73e" />

También podemos registrar el adaptador como un binding. Para ello añadiremos el siguiente XML en la sección <system.serviceModel><extensions><bindingExtensions>.:

<add name="AdapterPOP3Binding" type="ejemplo.adaptadorwcf.Pop3AdapterBindingCollectionElement,

Pop3Adapter, Version=1.0.0.0,

Culture=neutral, PublicKeyToken=447f918ac099d73e" />

Una vez registrado el adaptador ya podemos utilizarlo en un endpoint de cliente. Para ello en la sección <system.serviceModel><client> vamos a añadir el siguiente XML:

<endpoint binding="AdapterPOP3Binding" contract="IMetadataExchange"
        name="AdaptadorPOP3" />

Debemos asegurarnos que el nombre del binding que pongamos en el endpoint sea el mismo que hayamos utilizado al registrar el binding.

En los próximos días publicaré un post indicando como consumir este adaptador desde una aplicación .NET.

Adjunto un archivo con el código fuente para que os quede un poco mas claro la implementación del adaptador. Solamente decir que este código ha sido implementado para servir de apoyo al post y en ningún momento está optimizado ni ha sido pensado para poder utilizarse en un entorno real.

Pop3Adapter.rar

Proyecto Fjord: Biztalk Mapper + Surface

Roberto — Mon, 28 Apr 2008 16:21:00 GMT

En el blog de Tim Rayburn aparece una noticia cuanto menos interesante.

Nos cuenta la integración de Biztalk Mapper y Surface. No dejéis de leer el post de Tim porque no tiene desperdicio.

Esperaremos noticias nuevas.

Biztalk Server 2006 R3

Roberto — Wed, 23 Apr 2008 06:15:00 GMT

Como siempre Biztalk se adapta a la nueva oleada de cambios tecnológicos y nuevos productos que han ido saliendo estos último meses.

Como en su día se adaptó a Visual Studio 2005 y a SQL Server 2005, Microsoft adaptará Biztalk Server a Windows Server 2008, Sql Server 2008 y .NET Framework 3.5.

El nombre de la release será Biztalk Server 2006 R3. Se espera una CTP para verano de este año y una versión RTM para el principios del año 2009.

Algunas de las novedades que traerá el produto son las siguientes:

Nuevas capacidades de registro de web service con soporte para UDDI (Universal Description Discovery and Integration) version 3.0
Nuevos adaptadores mejorados para aplicaciones LOB, bases de datos, ...
Soporte de conectividad e interoperabilidad mejorada para protocolos de la industria (SWIFT, EDI, etc)
Patrones SOA y guía de best practices para asistir a implementaciones de clientes