Introduccion a conectores de BizTalk R2 para WCF

Hace algún tiempo vengo trabajando con las nuevos adaptadores de WCF que vienen incluidos en la versión R2 de BizTalk 2006, y la idea de este post es solo dar una pequeña introducción a lo que me toca utilizar de todo este conjunto de nuevas herramientas y en algunos post posteriores iré publicando como consumir desde BiztTalk servicios publicados con WCF y las distintas opciones para esto.
Como la mayoría de los que puedan leer este post sabrán, WCF ofrece un rango bastante amplio de posibilidades a cerca de las opciones de cómo consumir un servicio WCF publicado, estas opciones o “bindings” varían tanto en el tipo de transporte y configuraciones de seguridad, pero en general las opciones serian las de la siguiente tabla:

Comenzar con un Send-Port Basico

Comenzaremos creando un Send Port que utiliza el adaptador WSHttpBinding. En este primer paso nuestro objetivo seria integrarse endpoint que se se construye por defecto al crear un servicio WCF en Visual Studio 2008.

Lo primero que deberíamos hacer es asegurarnos que el servicio este levantado y la configuración de su binding se corresponda con el Send Port que estamos creando, esto seria simplemente poner la URL en un IExplorer, verificar que el WSDL del servicio se muestra correctamente y además el binding del servicio expuesto como se muestra en la imagen

Realizados esto pasos tendremos que seleccionar el adaptador y luego podemos hacer click "Configure" para configurar como el adaptador WSHttpBinding como debería ser usado.







Donde los datos que deberemos completar este tipo de Send-Port son realmente muy pocos, por un lado la URL del servicio, por el otro la Soap-Action del methodo que queremos consumir en este Send-Port y cuyo "wsdl:operation name" coincide también con la operación de del servicio que queremos instanciar. (esto es básicamente copiar del WSDL al TextBox: Action como se muestra a continuación).

Muestra del WSDL del servicio:

Configuración del puerto para consumir la operación del WSDL marcado arriba:

Eso seria todo por ahora, en próximos post prometo mostrar como consumir servicios con Custom Binding, que por cierto son bastante mas complejos de consumir y configurar.

Espero que pueda servirles.

Ariel Serlin

Suscribirse a multiples IDOCs en una misma ReceiveLocation ( Biztalk )

Tuve un asunto hace poco en mi trabajo en la que necesitaba suscribirme a mas de un IDOC de SAP y por una cuestión de orden y buenas practicas en la arquitectura del proyecto de EAI en el que estoy trabajando los IDOCs debían ser recepcionados por la misma receive location.
La solucion vino de la mano de un Groso y en este post trato de pasar en claro la forma en la que puede hacer andar esto y por supuesto configurarlo.
La idea es básicamente crear una Pipeline la cual se encargue de desensamblar los IDOCs que lleguen a una determinada receive location y posteriormente configurar la pipeline construida en la receive location que necesitamos realice el trabajo.

El primer paso seria como venimos hablando generar una nueva Pipeline.
Debido a que los esquemas que Biztalk genera cuando importamos la estructura del IDOC sera local en cada proyecto en el que se hizo la importación, pero publico para cualquier proyecto que referenecie voy a hacer de cuenta que los esquemas son importados en los proyectos en los que se encuentran las orquestaciones con lógica y la pipeline se desarrollara en un assembly aparte.

En definitiva los proyectos de Biztalk o assemblys que contendría los esquemas de los IDOCs se verían así en el caso del primero:

Y así para el caso del segundo (pueden ser la cantidad que uno quiera o necesite):

En la siguiente instancia toca construir la Pipeline que nos va a solucionar el problema, la misma podría estar en un assembly aparte, esto es porque sera necesario referenciar las proyectos anteriormente construidos. Resumiendo en tres pasos el proceso de construcción de este proyecto serian básicamente, construirlo, referenciar los assemblys que contienen los esquemas correspondientes a cada IDOC y agregar una Pipeline de recepción que "desensamble" el IDOC correspondiente. Para esto en la Pipeline deberemos agregar tanto shapes de Flat File Disassemble como esquemas de IDCOs tengamos referenciados y configurar en cada sahpe arrastrado un el esquema correspondiente.

En lo que respecta a desarrollo esto seria todo. Quedaría finalmente hacer deploy de nuestros assemblys en el servidor y configurar, que es por cierto la parte mas sencilla, simplemente al crear nuestra Receive Location creada para recibir los IDOCs informarle que debera utilizar la Pipeline creada y recientemente desplegada en nuestro server de la siguiente manera:

Eso seria todo, espero que pueda servirle.

Ariel Serlin

Logging "Sencillo" en Biztalk

En la casi todas las ocasiones en las que uno trabaja con Biztalk Server, es imprescindible poder loguear resultados, mensajes o excepciones en algún archivo de texto plano o en el visor de eventos de nuestro server, ya que al no tener interfaz de usuario la única manera de poder analizar detalladamente la ejecución de nuestro flujo de trabajo (workflow) diseñado es analizando el log escrito por la orquestación. Indudablemente lo más conveniente y aconsejable para esta tarea seria utilizar alguna de las librerías ya diseñadas para esta tarea, podrían ser Enterprise Library o Log4Net las más conocidas y que de hecho funcionan bastante bien.

Pero debido a que el uso de estas librerías implica tener que configurar o modificar archivos de conflagración y confeccionar algunos mas en el caso de EntLib, en muchos casos para poder hacer pruebas rápidas o para el caso en el que el entorno va a ser utilizado solo para probar alguna versión nueva de alguna tecnología (me a tocado tener que trabajar en varias maquinas virtuales ) dejo esta pequeña assembly en la cual existen 2 métodos.
El primero solo loguea el valor de alguna variable y el segundo permite escribir contenido de todo un mensaje en un archivo de log.
El código de la clase conteniendo ambos métodos seria:

[Serializable]







     public class ArielLog







    {















        public static void WriteValue(string value)







        {







            File.AppendAllText("C:\\ArchivosLog.txt", value);







            System.Diagnostics.EventLog.WriteEntry("BizTalkLog", value);







        }








        public static void WriteMessage(XLANGMessage msg)







        {







            XmlDocument doc = (XmlDocument)msg[0].RetrieveAs(typeof(XmlDocument));











            string mensaje = doc.InnerXml;







            File.AppendAllText("C:\\Mensjaes.txt", mensaje);







        }








    }

Y para usar estos dos métodos simplemente restaría referenciar a la assembly en la que se encuentra la clase que los contiene y ya podrían ser llamados desde cualquier shape de expresión de la siguiente manera:

Para loguear un mensaje









O para loguear el valor de una variable:


Eso seria todo, por si alguien quiere recompilar la librería para cambiarle el nombre o lo que fuera, adjunto una solución con el código de la assembly firmado para poder ser subida a la GAC y así poder utilizarla desde Biztalk Server.

Ariel Serlin


Para bajar el código hace click aquí