5.01.2017

Integrando Azure Service Bus con DocumentDB utilizando LogicApps

El “Stack” de integración de Azure crece continuamente con nuevas características dentro de los productos ya desarrollados o con nuevos productos para escenarios específicos. Una herramienta que facilita las tareas de integración en la nube es Logic Apps; la cual nos permite conectarnos con diversos endpoints tales como Dynamics, OneDrive, Azure Service Bus, y muchas otras más.

En este post vamos a desarrollar un flujo de integración para escenarios asincrónicos utilizando los siguientes componentes:

  • Cliente .NET
  • Azure Service Bus Queues
  • Logic Apps
  • DocumentDB

El siguiente diagrama nos muestra el escenario a implementar.

image

Como se puede ver en la figura anterior una aplicación de consola desarrollada en C# va a enviar un mensaje a una cola en el Azure Service Bus; seguidamente un flujo en Logic App va a estar escuchando la cola del Service Bus para guardar el contenido del mensaje en una colección en la base de datos DocumentDB.

El cliente C#

El primer paso es crear un cliente en .NET que envíe los mensajes al bus. Este cliente incorpora los valores de un pago ficticio dentro de las propiedades del mensaje. El código del cliente se ve a continuación.

image

El flujo en Logic App

El flujo de Logic App tiene un disparador que es un componente que se dispara cada vez que llega un mensaje a la cola del bus de servicios. La configuración del mismo se puede apreciar en la siguiente imagen.

image

Seguidamente procedemos a configurar el componente que guarda el registro del pago en la colección del DocumentDB. En este componente no solo especificamos la configuración de conexión sino que también creamos la estructura del documento que vamos a enviar a guardar, en este caso, un documento de pago. Tal y como se ve en la siguiente figura el mensaje se construye con las propiedades del mensaje obtenido de la cola del Azure Service Bus.

image

Cuando se intenta crear el documento desde las propiedades de mensaje que vienen del bus de servicios no tenemos acceso a las propiedades del mismo porque estas no son tipificadas y no se pueden determinar en tiempo de diseño. Para lograr acceso a las mismas tenemos que cambiar a la vista de código tal y como se muestra en al siguiente figura.

image

En este caso se accede la colección de propiedades y se especifica cual es el campo que se desea acceder. Después de esto, ejecutamos el flujo y el registro se inserta en a partir del mensaje que se envía a la cola de Windows Azure.

4.28.2017

Configurando Visual Studio para trabajar con Logic Apps

Para trabajar el diseño de flujos de Logic Apps hay que configurar el ambiente de desarrollo instalando un par de componentes. En este post vamos a ver rápidamente como llevar a cabo esta configuración

Azure SDK

El primer componente a utilizar es el SDK de Azure. Este se puede obtener utilizando el Web Platform Installer. Este SDK tiene todos los componentes para programar diferentes funcionalidades de Azure, incluyendo Logic Apps.

image

Azure Logic Apps Tools for VS 2015

Seguidamente procedemos a instalar la extensión para desarrollar Logic Apps en Visual Studio. Para esto vamos al menú de herramientas y seleccionamos la opción extensiones y actualizaciones.

image

En esta ventana seleccionamos la ubicación de la extensión (1 – en línea), seguidamente digitamos logic apps en la caja de búsqueda (2), y por último instalamos la extensión que nos aparece en el cuadro principal como se ve en la siguiente figura.

image

Crear un proyecto para Logic Apps

Ahora procedemos a crear un proyecto de prueba para verificar que todo esté instalado correctamente, primero creamos un nuevo proyecto y seleccionamos la opción Cloud (1), seguidamente procedemos a seleccionar la plantilla Grupo de recursos de Azure (2) – habrá un post posterior detallando el tema de grupos de recurso de Azure o ARM.

image

En la siguiente ventana seleccionamos la plantilla de Logic Apps.

image

Una vez creado el proyecto en el vamos al explorador de soluciones y vemos los archivos json generados(1), los cuales son las plantillas de los flujos de logic apps.

image

Para poder ver el lienzo de diseño de Logic Apps, procedemos a abrir el archivo LogicApp.json con el diseñador tal y como se muestra en la siguiente figura.

image

Seguidamente el VS nos va  a pedir las credenciales de nuestra cuenta de Azure y la cuenta de recursos donde queremos ubicar

image

Luego se nos presenta la pantalla principal para escoger una plantilla a partir de la cual queremos crear nuestro flujo (esta pantalla es la página web del desarrollo en logic Apps)Nosotros escogemos la plantilla vacía(1).

image

Por último, nos aparece el lienzo de diseño con las opciones correspondientes y estamos listos para desarrollar.

image

4.11.2017

Creando un app con Ionic y VS Code–configurando el ambiente

Visual Studio Code es un IDE muy versátil que nos permite desarrollar utilizando muchas tecnologías, y en este caso lo vamos a utilizar para desarrollar un app móvil utilizando Ionic Framework. Ionic es un Framework que permite utilizar los conceptos del desarrollo web para crear aplicaciones para iOS, Android, Windows, etc.  En esta serie de post vamos a aprender como desarrollar estas aplicaciones usando Ionic + VS Code.

Instalando el ambiente

Para iniciar tenemos que instalar node.js en nuestra máquina ya que Ionic necesita de esta librería para poder funcionar. Para llevarlo vamos a la pagina de node.js y descargamos e instalamos la versión de node.js para nuestro sistema operativo, en mi caso, Windows de 64 bits.

image

Utilizamos LTS porque es la versión que es normalmente soportada por Ionic.

Ahora ya podemos utilizar el IDE VS Code para continuar con los siguientes pasos. Primeramente abrimos el terminal integrado de VS Code y procedemos a instalar Ionic utilizando el siguiente comando – utilizando npm de node.js

image

Ahora desde el mismo terminal procedemos a crear una aplicación utilizando el comando ionic start nombredelapp –-version de ionic.

image

Este comando nos crea un aplicativo llamado AccountMe en el folder donde estamos posicionados con una plantilla de “tabs” pre diseñada y lista para funcionar. Si abrimos este folder en VS Code podemos ver a estructura del proyecto generada.

image

El siguiente paso es probar nuestro aplicativo recién generado para comprobar que todo esta listo para iniciar el desarrollo utilizando el Ionic Serve Lab desde donde podemos ver nuestro aplicativo en una página Web y probarlo. El comando para lanzar el app es el siguiente:

image

Si todo salió correctamente veremos el aplicativo web funcionando con las plataformas seleccionadas en el combo de plataformas tal y como se ve en la siguiente figura.

image

3.29.2017

Trabajando JSON en BizTalk Server 2016 – Parte 2

Continuando con los post acerca de trabajar documentos JSON en BizTalk Server 2016, vamos a proceder a crear un ejemplo donde se recibe un documento XML y se rutea a un folder donde lo vamos a dejar convertido a un documento JSON.

Ejemplo

En este ejemplo, vamos a crear un puerto de ingreso donde se recibe un documento XML (el mismo que convertimos en el ejemplo del post anterior) tal y como lo muestra la siguiente figura.

image

Iniciamos creando un puerto de una vía por donde ingresará este documento XML utilizando el pipelines estándar de PassThru.

image

Ahora procedemos a crear el puerto de salida de una vía con dos condiciones importantes. La primera de esas condiciones es utilizar el pipeline de envío JSON que creamos en el proyecto JSONPipelines del post anterior tal y como se muestra en la siguiente figura.

image

La segunda condición es agregar un filtro para rutear el mensaje XML desde el puerto de recibo al puerto de envío utilizando la propiedad ReceivePortName tal y como se ve en la siguiente figura.

image

Seguidamente procedemos a activar los puertos de envío y recibo y enviamos el mensaje XML de prueba mostrado al inicio de este post. Como vemos en la siguiente figura, el documento fue enviado al puerto especificado en formato JSON.

image

3.28.2017

Trabajando JSON en BizTalk Server 2016 – Parte 1

Uno de las nuevas características en BizTalk 2016 es la adición de componentes para pipeline para manejar el formato JSON(codificar/decodificar) tanto para consumir como para enviar mensajes JSON. En este post vamos a ver como trabajar el formato JSON en BizTalk Server 2016 a nivel de pipelines.

Ejemplo

Inicialmente, vamos a crear una pequeña orquestación que recibe un documento JSON y lo decodifica a un documento XML para direccionarlo a otro puerto en formato XML. Por facilidad del ejemplo, la orquestación funcionara con adaptadores FILE tanto para iniciar la orquestación como para enviar la respuesta.

Primero vamos a crear un proyecto que solo va a contener todos los pipelines (los que vamos a ir usando en esta serie de posts) y creamos un pipeline para decodificar un mensaje JSON a XML y otro para codificar un mensaje XML en un mensaje JSON. El primer pipeline se puede ver en la siguiente figura.

image

En el siguiente paso procedemos a publicar el aplicativo BizTalk para que estos pipelines queden disponibles para otras aplicaciones. Seguidamente procedemos a crear una aplicación BizTalk y agregamos como referencia el aplicativo recientemente publicado.

Ahora procedemos a crear un puerto de recibo donde vamos a configurar el pipeline para recibir el documento JSON tal y como se ve en la siguiente figura.

image

El primer paso es configurar el adaptador FILE(1), seguidamente seleccionamos el pipeline que creamos en el proyecto común y agregamos como referencia(2),  luego vía el botón elipse procedemos a configurar el pipeline(3). En este caso debemos definir el nodo raíz y seguidamente proceder a crear un namespace ya que el documento XML así lo va a requerir(4).

Ahora procedemos a crear un puerto de envío que tiene la particularidad de que utiliza un filtro para rutear el mensaje recibido JSON, solo que vamos a usar el pipeline passthru para grabarlo en el directorio tal y como viene decodificado.

image

Luego de este paso ya estamos listos, arrancamos el aplicativo y procedemos a realizar la prueba con el siguiente archivo.

image

La salida resultante será en formato XML tal y como se ve en la siguiente figura.

image

5.31.2016

Databinding en Xamarin - parte 1: XAML

El databinding en Xamarin se puede llevar a cabo de dos formas: desde el "code behind" o desde el XAML. Para llevarlo a cabo desde el "code behind" se establece la relación entre dos objetos - la fuente y el destino de los datos - donde la propiedad BindingContext del objeto destino debe de tener establecido el objeto fuente o una de sus propiedades. La propiedad del objeto destino debe de ser "bindeable" lo que significa que debe de heredar de BindableObject. En XAML se utilizan los brackets {} para establecer el objeto o propiedad del objeto fuente - despues de establecer el BindingContext.

Ejemplo

En la primera parte de esta seria de post acerca del databinding vamos a llevar a cabo un ejemplo sencillo desde el markup de XAML.   
Vamos a crear un proyecto multiplataforma en Xamarin Studio y vamos a agregar una nueva pantalla la que llamaremos pantalla principal. Esta a su vez la vamos a instanciar desde un NavigationPage para permitir la navegación entre pantallas.










Luego vamos a crear una clase POCO para almacenar los datos obtenidos (esta vez desde el código, pero puede ser desde una BD, un servicio, un blob, etc) Esta clase tiene la siguiente estructura.























Ahora en el XAML del MainPage vamos a crear el binding del objeto. Para crear el binding se utilizan los brackets y el nombre de la propiedad que se desea "ligar" a la propiedad del control destino tal y como se ve en la siguiente figura.













Ahora vamos a crear un metodo en la clase MainPage que nos devuelva un objeto Proyecto ya instanciado el cual vamos a invocar desde el constructor de la clase. Por último asignamos al BindingContext el objeto retornado por el método recién creado.


















Ahora procedemos a ejecutar el aplicativo y el resultado de esta ejecución se puede ver en la siguiente figura.













5.29.2016

Navegación en Xamarin

Una de las tareas más comunes en el desarrollo de aplicaciones multiplataforma en Xamarin es la navegación entre páginas. Para poder hacer transiciones entre páginas debemos utilizar la interface INavigation la cual contiene una gran cantidad de métodos para lograr las transiciones de diversas formas.
Los métodos normalmente utilizados para estas tareas son PushAsyn y PopAsync los cuales nos permiten avanzar de una página a otra y devolvernos respectivamente. 

Demostración

Para demostrar el uso de estos métodos vamos a crear un ejemplo usando Xamarin Studio. Primero vamos a crear un proyecto multiplataforma tal y como se ve en la siguiente figura.















Una vez creado el proyecto procedemos a crear una pagina XAML y la vamos a llamara MainPage - esta será la página principal del proyecto.



















Ahora en el código del archivo DemoNavegacion.cs procedemos a instanciar e invocar la página que acabamos de crear tal y como se muestra en la siguiente figura.















En la página MainPage.Xaml agregamos un label para identificar la página en que estamos y además agregamos un botón para navegar a la siguiente vista; en el botón además vamos a agregar un evento para insertar el código necesario para invocar la página siguiente.












Ahora en el archivo MainPage.cs procedemos a crear el manejador del evento del botón, en el cual vamos a invocar la nueva pantalla - Pagina2(La Pagina2 se crea exactamente igual que se creó la página MainPage).













En el archivo Pagina2.Xaml agregamos un par de etiquetas para identificar que estamos en la página 2.











Cuando ejecutamos el aplicativo podemos navegar entre páginas utilizando el botón de avance y usando el toolbar de navegación por defecto del aplicativo.






5.25.2016

Invocar una orquestación en otro assembly

Una de las preguntas más frecuentes en el desarrollo de aplicaciones en BizTalk Server es como invocar una orquestación que reside otro assembly. Esta pregunta se da principalmente porque aunque hayamos publicado la orquestación en otro proyecto, cuando agregamos la referencia no podemos ver la orquestación en el cuadro de invocar orquestación.
Para poder ver las orquestaciones disponibles en otro Assembly el modificador del tipo debe de estar en público tal y como se ve en la siguiente imagen.



















Después vez instalada en el servidor, ya podemos referenciar la orquestación desde el GAC y seguidamente invocar la orquestación desde una forma para iniciar la orquestación sincrónica o asincrónicamente.


















Una vez seleccionada la orquestación deseada, esta aparece seleccionada en la forma de invocación.




5.18.2016

Integrar Xamarin Studio con Visual Studio Team Services

Al iniciar desarrollos con el Xamarin Studio en Mac OS X a los que usamos el Visual Studio Team Services nos surge la necesidad de integrar nuestros proyectos de Xamarin con el controlador de versiones de Microsoft en la nube. En este post vamos a ver cómo lograr esta tarea.

Crear el proyecto en VSTS

El primer paso es crear el proyecto en VSTS. El proyecto debe de utilizar git y además tenemos que habilitar las credenciales alternativas del VSTS.



















Como se ve en la imagen anterior, cuando vamos a la sección de código del VSTS podemos ver el URL para el repositorio git del proyecto que acabamos de crear.

Crear el proyecto en Xamarin Studio

Seguidamente procedemos a crear un proyecto para desarrollo de apps para Mac OS X de la forma tradicional, solamente nos preocupamos por no marcar la opción de utilizar git para el control de versiones (lo haremos posteriormente desde el menú del Xamarin Studio) 




























Subir el proyecto al VSTS

El siguiente paso es subir el proyecto recién creado al VSTS. Para llevar a cabo esta tarea seleccionamos la opción control de versiones/publicar, desde donde nos aparece la pantalla para configurar el repositorio deseado.





















En esta pantalla elegimos el tipo de repositorio (git) y copiamos el url del repositorio (obtenido del VSTS). En la siguiente pantalla se nos va a solicitar el usuario y password del repositorio, donde tendremos que agregar nuestras credenciales alternativas para VSTS.








Luego seleccionamos aceptar y nuestro proyecto será publicado exitosamente en el VSTS.