Transportando datos de archivos de texto plano a tablas de SQL Server con BizTalk Server 2006 paso a paso. Parte 2 de 2

Transportando datos de archivos de texto plano a tablas de SQL Server con BizTalk Server 2006 paso a paso. Parte 2 de 2.

Resumen

En la primer parte vimos cómo crear los esquemas necesarios para leer los archivos de texto plano de nuestra tienda.  Vimos también cómo configurar un pipeline de recepción que incluya los esquemas creados para poder desensamblar los archivo correctamente.  En este artículo continuaremos con el escenario y juntaremos todas las piezas del rompecabezas.

Creación de la Orquestación

El siguiente paso es crear la orquestación dentro de nuestro proyecto.  Para realizar esto hagamos clic derecho sobre nuestro proyecto y seleccionemos Add New Item.  A la orquestación le asignaremos el nombre Tienda_Orchestration.odx tal y como lo muestra la siguiente figura:

Ahora necesitamos un puerto de recepción por medio del cuál podamos obtener los archivos de texto plano.  Agreguemos el puerto a la orquestación haciendo clic derecho sobre el area denominada Port Surface y seleccionemos la opción Configured Port.  El nombre del puerto será Tienda_Recepcion:

En la siguiente ventana seleccionemos la opción de crear un nuevo tipo de puerto definiendo el nombre Tienda_Recepcion_Tipo y su tipo de comunicación como One-Way:

En la siguiente ventana seleccionemos la dirección de comunicación de tipo recepción y el port binding a Specify later.  Una vez hecho esto hagamos clic en siguiente y luego finalizar.

El paso anterior creará el puerto de recepción en la orquestación.  A la operación llamada Request del puerto debemos definir cuál será el tipo de mensaje que recibirá.  Seleccionemos Tienda_Album en la propiedad Message Type usando la ventana de propiedades

Agreguemos una actividad de tipo Receive a la orquestación y asignemos su propiedad Activate igual a True.  Su tipo de mensaje será Tienda_Input_Album (consultar la sección “Anexos” en este artículo para más información acerca de los mensajes y variables que deben ser creados) y su operación relacionada será Tienda_Recepcion.Operation_1.Request

Agreguemos una actividad de tipo Construct Message justo debajo de la actividad Receive recién incorporada.  En su propiedad Messages Constructed seleccionemos Tienda_Input_Artista ya que es el tipo de mensaje que deseamos construir.  Además le agregaremos una sub-actividad de tipo Message Assignment para poder construir el mensaje. 

Usando la ventana de propiedades modifiquemos Expression para que tenga el siguiente código:

El anterior código obtiene el artista del archivo recibido (gracias a que ese esquema está definido como header en el pipeline de recepción) y lo guarda en una variable de tipo XmlDocument.  Posteriomente, esta variable es usada para inicializar el mensaje de tipo Tienda_Input_Artista.

Bien, ahora necesitamos agregar un puerto de tipo Send usando la ventana de BizTalk Explorer con las siguientes consideraciones:

  • El tipo de puerto será Static-One-Way
  • Nombre: Tienda_Router_Sql
  • El tipo de transporte será SQL
  • La cadena de conexión deberá configurarse para conectarse a la base de datos Tienda usando el usuario biztalkuser definido en la parte 1 de este artículo.
  • Document Target Namespace: http://tienda.router/sqloutput
  • Response Document Root Element: alb
  • Send Pipeline: PassThruTransmit

Una vez agregado el puerto de tipo Send, hagamos clic derecho sobre la carpeta SPSchema y seleccionemos Add-Add Generated Items… e indiquemos la plantilla Add Adapter Metadata en la caja de diálogo.

Seleccionemos el puerto Tienda_Router_Sql en la siguiente ventana y hagamos clic en el botón Next.

En el siguiente paso del asistente llamado Database Information hagamos clic en el botón Next.  En el siguiente paso definamos los siguientes valores y despúes hagamos clic en el botón Next.

  • Target namespace:  http://tienda.router/sqloutput (el mismo que cuando creamos el puerto de tipo Send)
  • Port type: Send port
  • Request document root element name: alb_request
  • Response document root element name: alb_response

En el siguiente paso seleccionemos la opción Stored Procedure y hagamos clic en el botón Next.  En el siguiente paso seleccionemos InsertaArtista y en seguida hagamos clic en Finish.  Repitamos estos mismos pasos para el procedimiento almacenado InsertaAlbum.

Creación de los mapas de transformación

Hagamos clic derecho en la carpeta Map y seleccionemos la opción Add->New Item… y seleccionemos la plantilla Map de la caja de diálogo.  El nombre del mapa será Tienda_Artista.btm.

Seleccionemos el data source del esquema origen a Tienda_Artista:

Seleccionemos el data source del esquema destino a SqlService_sqloutput.  A continuación, seleccionemos alb_request como root node.  Realicemos el mapeo necesario tal y como lo muestra la siguiente figura:

Agreguemos una nueva actividad de tipo Construct Message a la orquestación y dentro de ella una actividad de tipo Transform.  Hagamos doble clic sobre Transform_1 y configuremos de la siguiente manera la transformación:

  • Existing Map
  • Fully Qualified Map Name: Tienda.Map.Tienda_Artista
  • Source: Tienda_Input_Artista
  • Destination: Tienda_Output_Artista

Agreguemos una actividad de tipo Send a la orquestación y le asignamos su propiedad Message a Tienda_Output_Artista.

Agregar un nuevo puerto de envío a la orquestación haciendo clic derecho sobre el Port Surface del diseñador con los siguientes parámetros:

  • Name: [Empresa]_Envio_Header
  • Tipo: [Empresa]_Envio_Header_Tipo
  • Comunicación: One-Way
  • Dirección: Send
  • Binding: Especificar después

Configurar su operación llamada Request con la propiedad Message Type como Tienda.SQLService_sqloutput.alb_request.  Una vez hecho esto, conectamos el shape Send_1 al nuevo puerto tal y como lo muestra la siguiente figura:

Repitamos los pasos anteriores para el mensaje Tienda_Output_Album.

Podemos usar una actividad de tipo Parallel para que el envío del artista junto con sus albumes relacionados sea al mismo tiempo en vez de secuencial.

Deployment

Como último paso debemos hacer Deploy de nuestro proyecto haciendo clic en la opción Deploy del menú Build de Visual Studio .NET.

Una vez hecho el deployment debemos configurar los puertos de recepción y envío usando la herramienta BizTalk Server 2006 Administration Console haciendo clic derecho sobre la orquestación en la lista de aplicaciones.

  • El pipeline del puerto de recepción debe ser de tipo Tienda_ReceivePipeline
  • El puerto de recepción debe tener relacionado un folder que tenga el suficiente nivel de permisos de acceso para poder leer los archivos (en este demo se agregó Everyone Full Control a un folder llamado C:\Archivos)
  • El filtro para el puerto de recepción debe ser *.txt
  • Configurar adecuadamente el polling interval. En esta demo se configuró a 15 segundos (15000 ms)
  • El puerto de envío debe ser de tipo SQL y su pipeline de tipo PassThruTransmit
  • El puerto de envío debe tener configurada la cadena de conexión correcta para poder ejecutar los stored procedures relacionados

Lo último que resta es iniciar la orquestación haciendo clic sobre ella y seleccionar la opción Start del menú contextual.  Para probar, copiemos un archivo de texto a la carpeta en donde se configuró el puerto de recepción y listo!  Nuestras tablas son actualizadas correctamente en SQL Server.

Anexos
Mensajes

Nombre del mensaje
Tipo

Observaciones

Tienda_Input_Artista
Tienda.FFSchema.Tienda_Artista

Creado por medio del Flat File Schema Wizard

Tienda_Input_Album
Tienda.FFSchema.Tienda_Album

Creado por medio del Flat File Schema Wizard

Tienda_Output_Artista
Tienda.SQLService_sqloutput.alb_request

Creado por medio de la opción Add Adapter Metadata (cambiar el nombre apropiadamente por medio de la ventana de propiedades si es que ya existe un archivo con el mismo nombre)

Tienda_Output_Album
Tienda.SQLService_sqloutput_1.alb_request

Creado por medio de la opción Add Adapter Metadata (cambiar el nombre apropiadamente por medio de la ventana de propiedades si es que ya existe un archivo con el mismo nombre)

Variables

Nombre de la variable
Tipo

headerDocString
String

headerDocXml
System.Xml.XmlDocument

Conclusión

BizTalk Server 2006 es una poderosa herramienta para la integración entre aplicaciones incluso de diferentes plataformas.  En este artículo dividido en dos partes vimos cómo enviar los datos de archivos de texto planos a tablas de SQL Server por medio de una orquestación de BizTalk Server 2006.

Transportando datos de archivos de texto plano a tablas de SQL Server con BizTalk Server 2006 paso a paso. Parte 1 de 2

No es raro hoy en día encontrarnos con aplicaciones que integran datos de diferentes plataformas para obtener la información necesaria y poder explotarla adecuadamente.  Son bastantes los escenarios que nos podemos encontrar como consultores en los que determinada empresa cuenta ya con un sistema de tipo legacy y que debido a su gran importancia histórica es imposible tirarlo a la basura incluso resultaría bastante caro y arriesgado adentrarse en el largo y sinuoso camino de la migración total -incluso parcial- de su código a una plataforma moderna y escalable como es .NET.  Por lo anterior es muy común que las empresas requieran de alguna forma u otra seguir obteniendo o procesando los datos que sus sistemas legacy arrojan y a la vez renovar su plataforma y arquitectura tecnológica a nuevos horizontes. 

Así que, en este artículo aprenderemos a procesar archivos de texto planos para leer su contenido y posteriormente escribirlo a tablas de SQL Server 2005 por medio de una orquestación de BizTalk Server 2006.  Una vez terminado de leer este artículo podrán apreciar lo sencillo que puede ser esta tarea al ser coordinada y procesada con esta magnífica pieza de software.

El escenario

Nuestro sistema legacy es un sistema de compras e inventarios de una cadena de gran importancia a nivel nacional de venta de discos compactos musicales.  No obstante, la empresa requiere que el catálogo de discos sea replicado a una base de datos de SQL Server 2005 por medio de una orquestación de BizTalk Server 2006 una vez que un nuevo título llegue a su inventario.

El sistema legacy escribirá un archivo de texto plano con extensión .txt por artista una vez que nuevos álbumes lleguen al inventario.  El archivo de texto plano tendrá el siguiente esquema:

ARTISTAID | NOMBRE | GENERO

ARTISTAID | ALBUMID | TITULO_DEL_ALBUM | ANIO | CANTIDAD

ARTISTAID | ALBUMID | TITULO_DEL_ALBUM | ANIO | CANTIDAD

ARTISTAID | ALBUMID | TITULO_DEL_ALBUM | ANIO | CANTIDAD

Con lo anterior podemos deducir que en un solo archivo podrán incluirse diferentes albumes del mismo artista.  Además, podemos observar que los archivos incluyen el pipe (|) como separador de cada atributo.

Por otro lado, tenemos una base de datos de SQL Server 2005 llamada Tienda la cual cuenta con las tablas Artista y Album que son donde se depositarán los datos de los archivos de texto plano y su esquema es el siguiente:

La solución

La solución está basada en una orquestación implementada con BizTalk Server 2006 la cual será capaz de detectar la existencia de un nuevo archivo y procesará su contenido apropiadamente para escribir los datos en las tablas del servidor de SQL Server 2005.

Para iniciar, implementemos los procedimientos almacenados encargados de escribir los datos en las tablas de la base de datos.  Los procedimientos almacenados serán llamados spInsertaArtista y spInsertaAlbum para las tablas Artista y Album respectivamente y su código es el siguiente:

También necesitamos un login de SQL para poder conectarnos a SQL Server 2005 desde BizTalk y poder ejecutar los procedimientos almacenados.  Claro está que será más recomendable usar autenticación de tipo Windows en vez de usar usuarios de tipo SQL pero para este artículo lo dejaremos así.  La cuenta que crearemos será biztalkuser con el password Pa$$W0rd y le asignaremos el rol de dbo_owner sobre la base de datos Tienda:

Muy bien, tenemos los elementos básicos para comenzar.  Lo primero que vamos a hacer es abrir Visual Studio .NET y crearemos un nuevo proyecto de tipo Empty BizTalk Server Project y le pondremos el nombre Tienda, tal y como lo muestra la siguiente figura:

Una vez creado nuestro proyecto es buena idea cambiarle las propiedades Application Name y Restart Host Instances para poder identificar nuestra aplicación en la consola de administración de BizTalk y para reiniciar todas las instancias cuando despleguemos el proyecto respectivamente.  La siguiente figura muestra las propiedades de nuestro proyecto:

Por efectos de orden y limpieza en nuestro proyecto crearemos los siguientes fólders:

Nombre
Descripción

FFSchema
Aquí guardaremos los esquemas para el pipeline que lee los archivos de texto planos

Map
Aquí guardaremos los mapas de transformación

Pipeline
Aquí guardaremos los pipelines de recepción para los archivos de texto planos

SPSchema
Aquí guardaremos los esquemas necesarios para ejecutar los procedimientos almacenados en SQL Server 2005

Creación de los esquemas

El siguiente paso será la creación de los esquemas apropiados para interpretar el esquema de los archivos de texto plano.  Para el tipo de archivo que procesaremos en este ejemplo crearemos dos esquemas: uno para el header que contiene información básica del artista y otro para el detalle el cual como mencionamos anteriormente puede contener uno o varios albumes del mismo artista.  Los siguientes pasos muestran la creación del esquema para los álbumes, sin embargo serán los mismos pasos para la creación del esquema para el artista.  Para hacer esto agreguemos al fólder FFSchema un nuevo elemento de tipo Flat File Schema Wizard y asignemos el nombre Tienda_Album.xsd tal como lo muestra la siguiente figura

Al hacer anterior Visual Studio nos muestra el asistente de creación de esquemas para archivos de texto planos.  En la primer ventana asignaremos un archivo muestra de los cuales necesitamos procesar y asignaremos algunos parámetros como Record name y Target namespace.  La siguiente figura da ejemplo de esto:

La siguiente tarea será seleccionar las líneas en el archivo de texto que representan el detalle tal y como lo muestra la siguiente figura:

Hagamos clic en siguiente para aceptar la opción “By delimiter symbol”.  La siguiente ventana nos solicita indicar el delimitador para cada registro, en nuestro caso será el default {CR}{LF} ya que cada registro está indicado en una línea por separado.  La siguiente figura muestra esta ventana:

Al hacer clic en el botón Siguiente en la ventana anterior se nos muestra la opción de indicar cuáles son los elementos hijos.  En el caso específico de este ejemplo seleccionaremos el primer registro como Repeating record y le asignaremos el nombre Album mientras que al resto de registros les asignaremos el tipo Ignore ya que son exactamente iguales que el primero en estructura.  La siguiente figura muestra los elementos configurados:

La siguiente ventana nos muestra un resumen del esquema, sin embargo aun falta terminar de configurar los registros así que haremos clic en siguiente.  La siguiente ventana llamada “Select Document Data” nos solicita seleccionar los datos que definen un registro dentro del archivo de texto plano.  De manera predeterminada el asistente es lo suficientemente inteligente para seleccionar el registro tal como lo muestra la siguiente figura, posteriormente haremos clic en Siguiente.

Tal y como hicimos anteriormente, en la ventana “Select Record Format” aceptaremos la opción “By delimiter symbol” y haremos clic en el botón Next.

Ahora se nos presenta de nueva cuenta la ventana “Delimited Record”, en ella especificaremos en la lista desplegable llamada “Child delimiter” el caracter que delimita cada columna dentro de nuestro archivo en este caso se trata del pipe (|).  Al hacer clic en el botón Next se nos muestra la siguiente ventana en donde podemos definir el nombre de cada elemento (columna) que representa un registro de cada álbum:

Al hacer clic en siguiente se nos presenta el resumen del esquema y para terminar haremos clic en el botón Finish.

Una vez terminada la creación del esquema modificaremos la propiedad Element FormDefault del nodo <Schema> para tener el valor “Qualified”:

No olvidemos el esquema para el Artista!  Sigamos todos los pasos anteriores que usamos para crear el esquema de los álbumes con la única diferencia que a la propiedad Max Occurs en Artistas/Artista le asignaremos un valor de 1.

Creación del Pipeline de recepción

Nuestra siguiente tarea será la creación del pipeline de recepción para nuestro proyecto.  Para hacer esto agreguemos un nuevo elemento de tipo Receive Pipeline dentro de nuestro fólder Pipeline y asignemos el nombre Tienda_ReceivePipeline.btp tal como lo muestra la siguiente figura:

Para diseñar nuestro pipeline usaremos el componente Flat file disassembler y lo colocaremos en la sección “Disassemble” del diseñador la cual permite indicar la funcionalidad a ejecutar cuando queremos desensamblar nuestro archivo.  Además le asignaremos las propiedades Document schema y Header schema a Tienda_Album y Tienda_Artista respectivamente, además de poner en True la propiedad Preserve header.  La siguiente figura muestra el componente Flat file dissasembler configurado:

Wuf! Vamos muy bien pero aún falta camino por recorrer.  La segunda parte de este articulo explicará la orquestación de BizTalk y demostrará cómo todas las piezas de este rompecabezas se unen.

How to be a better developer?

This is the english version of my “¿Cómo ser un mejor desarrollador?” article

Maybe we have asked this question to ourselves a bunch of times.  With so many technologies, acronyms and learning options available today it seems that the answer to this question is not as easy as it seems.

Maybe so many of you will respond right now: “Studying” or “Taking a Training Course”, but: Is that enough?

Here’s the list of things that -in my personal life- I try to do in order to be a better developer.  The main idea behind the following list is to enrich it with your ideas and collaboration.

I don’t know anything

Why?  This is the most important start point and the most critic because the fundamental idea -like in any other learning process- is to recognize and accept our ignorance in so many and so huge topics and technologies.  Take off our egocentrism allows us to open our mind to other kind of knowledge and other kind of questions.  After all, we learn something from everyone each day.  Remember that monotony is the mother of mediocrity.

Listen to PodCasts

Why?  You can listen to the podcast at any time you want using your iPod, Zen, Zune, etc. in your car, at the office, at the gym, before sleep (please… BEFORE sleeping not WHILE YOU ARE sleeping ;) ), etc.  I mean: you can stay in contact with the specific topic whenever you want and you can combine it with another kind of activity (please be careful when driving because you couldn’t say to the officer “I’m so sorry, I’ve crashed the car because I was listening how to create a workflow in WF…”).  But which ones?  Alright take these as a recommendation: Scott Hanselman’s Hanselminutes and Ron Jacobs’ ArCast.  In these podcasts you can listen to so many topics about recent and upcoming technologies and in the other hand they are fun!  Those guys really know what they’re talking about…seriously.

Watch WebCasts

Why? I like Webcasts because they show and explain visually a specific topic; meanwhile the podcasts are audio-only.  But which ones?  I recommend: http://www.microsoft.com/events/default.mspx

Watch ScreenCasts

Why? A ScreenCast is a small video file that shows an specific technology topic in a “how-to” way.  They just are awesome knowledge sources because they teach us how to perform the required tasks for the problem we’re trying to resolve.  But which ones?  Obviously, it depends on the technology we’re using.  What about the ASP.NET, AJAX, Silverlight and Workflow Foundation as a startup?

Forum Participation

Why?  The forums are a basic resource when we have a specific doubt related to technology.  With the word Forum I refer to those Web-based and Newsgroups as well.  Also we have the opportunity to answer the questions of any other people in the world that has a problem and maybe you know how to fix it.  But which ones?  Each technology has its own forum.  Personally, I often visit the Workflow Foundation and Silverlight ones.

User groups meetings / Community meetings

Why?  There’s no better way of learning from others but in person, front to front about an specific topic.  That’s what .NET User Groups are for, to schedule meetings between different people geographically related in order to talk and show the technology.  But which ones?  There’s always a .NET User Group near you.  Visit MSN Groups to find more information about it.

Read Books

Why?  The answer is obvious.  Books are an ancient source of any kind of knowledge (hundreds and hundreds of years of manual and automatic printing can’t be wrong).  But which ones?  Personally, I like Programmer-To-Programmer books from Wrox (yeah, the red ones).  Another great development books are Microsoft .NET Development Series books because they are written by truly experts.

Read Blogs

Why? A web log is a personal log from other’s ideas, thoughts and technical articles from its author and it’s accessible via Web.  A good example is this blog where I’m writing my own opinions in how to be a better developer.  Is this The Ultimate Special Platinum Double-Pack Director’s Cut Extended Anniversary Edition Article about it?  Of course not! And it’s not meant to be like that tho.  It’s just a way to synthesize what I do in order to be a better developer and it’s a mechanism to share it and to obtain feedback about it.  But which ones?  I could write down here all my feeds but I’ll just write the ones that I read day by day:

ScottGu
Soma
Silverlight
Eric Sink
Joel on Software
Erika Ehrli

Learn to use other technologies

Why? Yes. We are geeks.  And we love Microsoft development technologies, but we would be blind or crazy if we wouldn’t recognize that there’s a bunch of other excellent technologies and that not everyone in this world use the same tools as we do.  In the other hand, they’re not absolutely necessary to be non-Microsoft technologies.  For example, IronRuby is a technology that I don’t know how to use it but it seems to me very powerful and interesting enough to try to learn from it.  But which ones?  There’s a lot right in front of our eyes.  For example I’m currently using and learning ActiveRecord.  Other technologies in my “To-Learn” list are: IronRuby, IronPython, F#, Microsoft Sync Framework and ASP.NET MVC Framework.

Adopt a Development Methodology

(Very special thanks to Misael for this one)

Why?  A methodic person has more control over the things he performs, and he can identify where he is and what step follows in his development path:  Identify, Measure, Document, Secure and Control are steps that can be reached using the correct methodology.  But which ones? There are so many methodologies but the must important could be the following:

Do not procrastinate

Why?  Up to this point, we have mentioned a list of learning resources that we can use in order to be better developers.  But we need the tactics and strategy, and these are of course: Discipline.  We need a great effort and discipline in order to accomplish our goal and to stop using and doing the things that waste our time.  YouTube, FaceBook, MSN Messenger are just a few of those things that come to my mind right now.  No excuses (like Alice in Chains once said) please.  Remember how we worked 10 years ago.  Let’s measure our procrastination level:  If you think this is a very drastic solution then you have a very serious procrastination problem.  But, if you are willing to stop wasting your time (you know you do!) then: Congratulations, your procrastination problem can be cured.

Try to hang up with people that love software development

At last but not least, it’s very important to look for people that are just as restless as you are and have the same learning goals (please refer to point number one).  Once you find them then it will be very helpful to talk and chat with them, and get support from them in your process of personal improvement.  That process would be less painful and more fun!

This article was not meant to be a meme but I would like for this topic that the following people could share their own thoughts and ideas:

Publicando Flujos de Trabajo de Workflow Foundation como Servicios Web

Una de las características más novedosas y útiles que podemos encontrar al desarrollar flujos de trabajo con Workflow Foundation es su capacidad de exponer nuestros flujos como servicios Web y usarlos en cualquier tipo aplicaciones. En este capítulo veremos qué se requiere para realizar esta funcionalidad y también veremos cómo invocar nuestros flujos de trabajo como servicios Web desde una aplicación de consola.

Para iniciar, abramos Visual Studio .NET si es que no está ejecutándose ya y creemos un nuevo proyecto de tipo consola haciendo clic en la opción New Project y seleccionando la plantilla Console Application de la categoría Windows. A esta aplicación le asignaremos el nombre AplicacionCliente y nos servirá para invocar el web Service que expondrá la funcionalidad del flujo de trabajo. La siguiente figura muestra la caja de diálogo New Project al crear nuestro proyecto:

A la solución agregaremos un nuevo proyecto de tipo Sequential Workflow Library haciendo clic derecho sobre la solución en Solution Explorer y seleccionando la opción Add->New Project. En la caja de diálogo seleccionemos la plantilla Sequential Workflow Library de la categoría Workflow y asignemos “WorkflowEjemplo” como nombre. La siguiente figura muestra la creación de este proyecto:

Ahora bien, necesitamos definir una interface la cual nos servirá para establecer el conjunto de métodos que nuestro servicio Web expondrá. Para realizar esto hagamos clic derecho sobre el proyecto WorkflowEjemplo en Solution Explorer y seleccionemos la opción Add->New Item del menú. Al hacer esto Visual Studio .NET despliega la caja de diálogo Add New Item con una serie de plantillas a escoger y una caja de texto para asignar el nombre del nuevo elemento. Seleccionemos la plantilla Interface del panel derecho y asignemos “IEjemplo.cs” como nombre de la nueva interfaz. La siguiente figura muestra la caja de diálogo Add New Item al agregar el nuevo elemento:

Al hacer clic en Ok Visual Studio .NET nos muestra el diseñador de código de la interfaz agregada. Asignemos el siguiente código en IEjemplo.cs:

Una vez definida la interfaz para nuestro servicio Web, regresemos al diseñador del flujo de trabajo y arrastremos y coloquemos una actividad de tipo WebServiceInput, la cual indica al flujo de trabajo que obtendrá una solicitud externa a través de una aplicación, es decir, que será invocado como un servicio Web. La actividad WebServiceInput debe ser configurada, siendo su propiedad InterfaceType su propiedad más importante. Esta propiedad indica el tipo de interfaz relacionada con esta actividad y para este ejemplo usaremos la interfaz IEjemplo creada en los párrafos anteriores. Para asignar la interfaz IEjemplo a la propiedad InterfaceType hagamos clic en el botón con tres puntos “…” en la ventana de propiedades de Visual Studio .NET. Al hacer clic sobre ese botón se despliega la siguiente caja de diálogo:

En esta caja de diálogo seleccionemos la interfaz WorkflowEjemplo.IEjemplo (la cual es la única interfaz en nuestro proyecto) y hagamos clic en el botón Ok.

La siguiente propiedad que debemos configurar es MethodName, la cuál como podemos deducir será RegresaSignoZodiacal. Al seleccionar este método de la lista desplegable automáticamente la ventana de propiedades se actualiza para mostrarnos fechaNacimiento en la lista. Esta nueva propiedad la debemos mapear a un campo o propiedad en nuestro flujo de trabajo para tener acceso al dato pasado como parámetro cuando se esté invocando este servicio Web. Seleccionemos la propiedad fechaNacimiento y hagamos clic en la opción “Bind Property ‘fechaNacimiento’” en el panel de opciones de la parte inferior de la ventana de propiedades y en la caja de diálogo generemos un nuevo miembro de tipo campo llamado fechaNacimiento tal y como lo muestra la siguiente figura:

La última propiedad que configuraremos de la actividad WebServiceInput será IsActivating la cual indica si esta actividad activará el flujo de trabajo.

Agreguemos ahora una actividad de tipo IfElse a nuestro diseñador, y como expresión condicional en la rama izquierda asignemos un Code Condition llamado EsFechaValida. Este método validará que la fecha que asigne el usuario como parámetro no sea mayor que la fecha actual. El código entonces para este método será el siguiente:

Como paso siguiente agreguemos una actividad de tipo Code en la rama izquierda de la actividad IfElse y una actividad de tipo WebServiceOutput. A la actividad Code le asignaremos en su propiedad ExecuteCode el método CalculaSigno, y a la actividad WebServiceOutput le asignaremos en su propiedad InputActivityName el nombre de nuestra actividad WebServiceInput (webServiceInputActivity1). Al hacer lo anterior la ventana de propiedades se actualiza para mostrarnos una nueva propiedad llamada ReturnValue. Esta propiedad la mapearemos a un nuevo miembro de tipo field llamado resultado.

En la rama derecha de la actividad IfElse arrastraremos y colocaremos una actividad de tipo WebServiceFault con su propiedad InputActivityName mapeada a webServiceInputActivity1 y su propiedad fault a un nuevo miembro de tipo field llamado fault.

La siguiente figura muestra todo el flujo de trabajo configurado e implementado:

El siguiente código muestra el método CalculaSigno el cuál contiene una implementación muy sencilla para calcular el signo zodiacal según la fecha especificada en el parámetro:

Visual Studio .NET nos brinda una manera muy sencilla de exponer nuestros flujos de trabajo como servicios Web: simplemente hagamos clic derecho sobre el proyecto del flujo de trabajo y seleccionemos la opción “Publish as Web Service”. Al hacer esto Visual Studio .NET creará automáticamente un proyecto Web en nuestra solución el cual contiene el servicio Web que expone la funcionalidad del flujo de trabajo.

Finalmente, en la aplicación de consola agreguemos la referencia Web apuntando al proyecto que se creó en el párrafo anterior y en el método Main() escribamos el siguiente código:

Al ejecutar nuestra aplicación y escribir una fecha válida (que sea igual o anterior a la fecha actual), nos mostrará el signo zodiacal relacionado con la fecha especificada tal y como lo muestra la siguiente figura:

¿Cómo ser mejor desarrollador?

Tal vez esta pregunta todos nos la hemos hecho siquiera alguna vez.  Con tantas tecnologías disponibles, tantos acrónimos y tantas opciones técnicas y de aprendizaje que tenemos hoy en día parece ser que la respuesta a esta pregunta ya no es tan sencilla como parece.

Tal vez muchos responderán en este momento: “Estudiando” o “Asistiendo a un curso”, pero: es eso suficiente?

He aquí la lista de cosas que -en lo personal- trato de hacer para poder ser un mejor desarrollador.  La idea es que esta lista se enriquezca con la participación suya y de sus ideas.

  • Reconocer que no sabes nada
    • Por qué?  Este sencillamente, es el punto principal y más crítico ya que lo primordial -como en cualquier otro proceso de aprendizaje- es reconocer y aceptar nuestra ignorancia frente a tantos y tan grandes temas y tecnologías.  Quitarnos el egocentrismo nos permite abrir nuestra mente a otros conocimientos y a otras inquietudes.  Finalmente, todos aprendemos de todos algo nuevo todos los días.  Recordemos que la monotonía es la base de la mediocridad.
  • Escuchar podcasts
    • Por qué?  Puedes reproducir el podcast una y otra vez, en tu iPod/Zen/Zune, en tu auto, en la oficina, gimnasio, antes de dormir, etc., es decir: puedes estar en contacto con el tema en cuestión en cualquier momento y combinarlo con alguna otra actividad (ojo al conducir por favor, ya que no es buen pretexto “choqué porque estaba escuchando cómo se crea un workflow en WF oficial….”)
    • Pero cuáles?  Bien, si entiendes el idioma anglosajón te recomiendo dos magníficos podcasts:  Hanselminutes de Scott Hanselman y ArCast de Ron Jacobs.  Estos podcasts tratan diversos temas y lo mejor es que siempre están a la vanguardia, además de que son bastante amenos.  Si definitivamente estás buscando algo en nuestro vasto idioma te recomiendo el Podcast que mi buen amigo Luis Du Solier prepara frecuentemente con su característica pasión por la tecnología (SharePoint principalmente).
  • Ver WebCasts
  • Ver ScreenCasts
    • Por qué?  Los ScreenCasts son pequeños fragmentos de video en donde se demuestra un tema muy específico de la tecnología.  Son excelentes fuentes de conocimiento ya que nos llevan de la mano para efectuar la o las tareas que necesitamos realizar para alcanzar el objetivo deseado.
    • Pero cuáles?  Claro está que depende de la tecnología.  Qué tal los ScreenCasts de ASP.NET, AJAX, Silverlight y Workflow Foundation para empezar?
  • Participar en Foros
    • Por qué?  Los foros son un recurso básico cuando tenemos duda acerca de una duda muy específica acerca de la tecnología.  “Foro” en el contexto que estoy explicando se refiere tanto a los foros en páginas web, como los Grupos de Noticias o Newsgroups.  Además tenemos la oportunidad de participar también en responder preguntas de otras personas en el mundo que tengan un problema y que tal vez tú sabes cómo arreglarlo.
    • Pero cuáles?  Cada tecnología tiene su foro. Yo en lo particular visito frecuentemente los foros de Workflow Foundation y de Silverlight.
  • Participar en Comunidades
    • Por qué?  Qué mejor que aprender de otros en persona, de frente, en vivo y a todo color acerca de un tema.  Para esto precisamente sirven las Comunidades .NET, para programar y organizar reuniones entre personas geográficamente cercanas y platicar de un tópico en específico.
    • Pero cuáles?  Siempre hay una Comunidad cerca de ti, visita MSN Groups para más información.
  • Leer libros
    • Por qué?  La respuesta es más que obvia.  Los libros son la fuente de conocimiento de cualquier tipo (tantos siglos de historia de la imprenta no pueden estar equivocados).  Pero cuáles?  A mí en lo personal me gustan mucho los libros Programmer-To-Programmer de la editorial Wrox (sí, esos libros de color rojo que tal vez has visto alguna vez).  Otra serie de libros que a mi parecer es excelente es Microsoft .NET Development Series ya que las obras están escritas por verdaderos expertos en el tema.
  • Leer blogs
    • Por qué?  Un Web Log o simplemente Blog es la bitácora personal de ideas, pensamientos o artículos técnicos de su autor.  Un ejemplo muy sencillo es este blog, en donde yo su autor estoy escribiendo y agrupando las diferentes maneras o estrategias que podemos seguir para ser mejores desarrolladores.  Es el alfa y el omega relacionado con este tema?  Obviamente no lo es ni siquiera pretender serlo.  Es simplemente sintetizar lo que yo hago con respecto a este tema en específico y darlo a conocer al público para esperar retroalimentación al respecto.
    • Pero cuáles?  Podría poner aquí toda la lista de mis feeds pero me voy a limitar a poner los que leo diariamente:
  • Aprender a usar otras tecnologías
    • Por qué?  Si bien somos geeks y nos apasionan las tecnologías y plataforma de desarrollo Microsoft, estaríamos ciegos o locos si no reconocieramos que hay otras excelentes tecnologías y que no todos en este mundo utilizan las mismas herramientas que nosotros.  Por otro lado no es necesario que sean tecnologías no-Microsoft.  Por ejemplo IronRuby es una tecnología que no conozco pero se me hace lo suficientemente poderosa e interesante como para ponerme a investigar acerca de ella.
    • Pero cuáles?  Hay muchísima tela de dónde cortar.  Por mi parte estoy usando, investigando y aprendiendo a usar ActiveRecord.  Otras tecnologías que están en mi lista de “Para Próximo Estudio” son IronRuby, IronPython, F#, Microsoft Sync Framework y ASP.NET MVC Framework.
  • No procrastinar
    • Por qué?  Hasta el momento hemos mencionado una lista de recursos que podemos usar como apoyo para estudiarlas y ser mejores desarrolladores.  Pero falta la técnica y estrategia, y estas no son nada menos ni nada más que la  Disciplina.  Requerimos sin duda una fuerte disciplina para ser mejores desarrolladores y dejar a un lado los quitatiempos.  YouTube, FaceBook, MSN Messenger son solo algunos de los que se me vienen a la mente y los cuales son una tremenda pérdida de tiempo.  No excusas por favor, pues recordemos cómo trabajabamos hace 10 años.  Midamos nuestro grado de procrastinación:  Si crees que esta medida es muy drástica, que no puedes dejar de visitar los sitios anteriores o de usar tu mensajero favorito entonces tienes un serio problema de procrastinación.  Si al contrario estás dispuesto a dejar de perder el tiempo y ponerte a estudiar te felicito, tu procrastinación aun es curable.
  • Relacionarte con personas apasionadas por el desarrollo de software
    • Finalmente, es muy importante encontrar personas que tengan las mismas inquietudes por aprender, conocer más y superarse (ver primer punto).  Una vez que las encuentres será muy útil que platiques y te apoyes con ellas para tu proceso de mejora personal .  El proceso será menos tedioso y más divertido.

Aunque este artículo en realidad no tiene el objetivo de ser un meme me gustaría que para este tema participaran en especial las siguientes personas:

Claro está que quien sea está invitado(a) a participar en este orden de ideas.

Salu2!