Manual TS: Plataforma Microsoft.NET 3.5, Fundamentos de las Aplicaciones de Flujo de Trabajo en Windows

Transcripción

1 Sé diferente, intégrate Mm074 Manual TS: Plataforma Microsoft.NET 3.5, Fundamentos de las Aplicaciones de Flujo de Trabajo en Windows Autor: Orlando Gutiérrez Fecha: 01/01/2011 Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 1

2 INDICE 0 INTRODUCCIÓN A WINDOWS WORKFLOW FOUNDATION (WWF)... 5 MOTOR DE TIEMPO DE EJECUCIÓN DEL FLUJO DE TRABAJO CREAR FLUJOS DE TRABAJO CON MÁQUINAS DE ESTADOS CREAR FLUJOS DE TRABAJO SECUENCIALES SELECCIONAR EL MODO DE AUTORIZACIÓN DE LOS FLUJOS DE TRABAJO HOSPEDAR UN FLUJO DE TRABAJO Y EL DISEÑADOR EN UNA APLICACIÓN... 8 CREACIÓN DE UNA APLICACIÓN HUESPED DE FLUJO DE TRABAJO... 8 RESPONSABILIDADES DE LA APLICACIÓN HOST... 9 TAREAS QUE LA APLICACIÓN HOST DEBE REALIZAR... 9 HOSPEDAJE DE DISEÑADORES DE FLUJO DE TRABAJO... 9 AGREGAR LA FUNCIONALIDAD DE COMANDOS DE MENÚ INICIALIZAR Y ADMINISTRAR EL CICLO DE VIDA DE UN FLUJO DE TRABAJO CREACIÓN DE WORKFLOWRUNTIME PROCESAMIENTO DE EVENTOS WORKFLOWRUNTIME EJECUCIÓN DE FLUJOS DE TRABAJO MODIFICAR EN TIEMPO DE EJECUCIÓN UN FLUJO DE TRABAJO USO DE CAMBIOS DE FLUJO DE TRABAJO EN FLUJOS DE TRABAJO RESTRICCIONES EN LOS CAMBIOS DE FLUJO DE TRABAJO MANEJAR EVENTOS DESDE LA MÁQUINA HUÉSPED INVOCAR MÉTODOS EN LA MÁQUINA HUÉSPED CONSUMIR SERVICIOS DESDE UN FLUJO DE TRABAJO CÓMO CONFIGURAR UN SERVICIO DE FLUJO DE TRABAJO EXPONER UN FLUJO DE TRABAJO COMO UN SERVICIO DESARROLLO DE SERVICIOS DE WINDOWS WORKFLOW FOUNDATION EXTENDER SERVICIOS BASE CREACIÓN DE NUEVOS SERVICIOS PERSONALIZADOS HOSPEDAR UN SERVICIO DE FLUJO DE TRABAJO EN IIS Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 2

3 11 CREAR ACTIVIDADES PERSONALIZADAS DESARROLLO DE ACTIVIDADES DE FLUJO DE TRABAJO CREACIÓN DE ACTIVIDADES PERSONALIZADAS CREAR ACTIVIDADES COMPUESTAS PERSONALIZADAS AGREGAR COMPATIBILIDAD EN TIEMPO DE DISEÑO A UNA ACTIVIDAD COMPUESTA PERSONALIZADA DEFINIR EL ESQUEMA DE UNA ACTIVIDAD PERSONALIZADA CÓMO SERIALIZAR FLUJOS DE TRABAJO SERIALIZACIÓN PREDETERMINADA INFRAESTRUCTURA DE SERIALIZACIÓN USO DEL MARCADO DE FLUJO DE TRABAJO ESTRUCTURA BÁSICA ELEMENTOS Y ATRIBUTOS AGREGAR PROPIEDADES DE DEPENDENCIA UTILIZACIÓN DE PROPIEDADES DE DEPENDENCIA EJEMPLO DE DEPENDENCYPROPERTY PROPIEDADES ASOCIADAS COMUNICAR UNA ACTIVIDAD PERSONALIZADA CON EL HOST SERVICIOS DE COMUNICACIÓN DE FLUJO DE TRABAJO CLASE DE SERVICIO PERSONALIZAR LA SERIALIZACIÓN DE LAS ACTIVIDADES SERIALIZACIÓN PERSONALIZADA ACTIVIDADES DE PERSONALIZACIÓN DEFINICIÓN DEL SERIALIZADOR PERSONALIZADO MARCADO DE FLUJO DE TRABAJO ESCRIBIR UN CONJUNTO DE REGLAS RULESETS DECLARATIVO RULEDEFINITIONS (CLASE) ENCADENAR REGLAS, DEFINIR PRIORIDADES Y ESTABLECER DEPENDENCIAS ENCADENAMIENTO HACIA DELANTE DE REGLAS MODIFICAR REGLAS EN TIEMPO REAL CAMBIOS DE FLUJO DE TRABAJO PARA CONDICIONES DE REGLA EJECUTAR CONJUNTO DE REGLAS IMPLEMENTAR LÓGICA CONDICIONAL EN LAS REGLAS Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 3

4 USO DE CONDICIONES EN FLUJOS DE TRABAJO ACTIVIDADES CONDICIONALES CREAR Y ADMINISTRAR FLUJOS DE TRABAJO TRANSACCIONALES CREAR Y MANEJAR COMPENSACIONES LISTAR LOS PROCESOS BATCH DE UNA TRANSACCIÓN UTILIZACIÓN DE LA ACTIVIDAD TRANSACTIONSCOPEACTIVITY CONTROLAR LAS EXCEPCIONES CONTROL DEL ERROR EN FLUJOS DE TRABAJO MANEJAR LAS CANCELACIONES SYSTEM.WORKFLOW.RUNTIME.TRACKING (ESPACIO DE NOMBRES) CREAR UN SERVICIO DE TIEMPO DE EJECUCIÓN CÓMO AGREGAR Y QUITAR SERVICIOS DE FLUJO DE TRABAJO AGREGAR SERVICIOS AL MOTOR DE TIEMPO DE EJECUCIÓN DEL FLUJO DE TRABAJO QUITAR SERVICIOS DEL MOTOR DE TIEMPO DE EJECUCIÓN DEL FLUJO DE TRABAJO NOTA INUNDAR (HYDRATING) Y DRENAR (DEHYDRATING) FLUJOS DE TRABAJO DRENAR INSTANCIAS DE FLUJOS DE TRABAJO INUNDAR INSTANCIAS DE FLUJOS DE TRABAJO REALIZAR TRAZAS A LOS FLUJOS DE TRABAJO SERVICIOS DE SEGUIMIENTO DE FLUJO DE TRABAJO DE WINDOWS CARACTERÍSTICAS DE SEGUIMIENTO EN WINDOWS WORKFLOW FOUNDATION PERFILES DE SEGUIMIENTO SEGUIMIENTO DE TIPOS DE EVENTO SEGUIMIENTO EXPLÍTICO DE NIVEL DE CÓDIGO SEGUIMIENTO DE FLUJOS DE TRABAJO DE SOLO MARCADO REGLAS DE SEGUIMIENTO SERVICIOS DE SEGUIMIENTO PERSONALIZADOS MONITOREAR FLUJOS DE TRABAJO CONTADORES DE RENDIMIENTO DEL FLUJO DE TRABAJO Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 4

5 0 INTRODUCCIÓN A WINDOWS WORKFLOW FOUNDATION (WWF) Windows Workflow Foundation es el modelo de programación, motor y herramientas para generar con rapidez las aplicaciones habilitadas por flujo de trabajo en Windows. Está compuesto de un espacio de nombres, un motor de flujo de trabajo en proceso y diseñadores para Visual Studio Windows Workflow Foundation es un marco que permite a los usuarios crear flujos de trabajo de sistema o humanos en sus aplicaciones para Windows Vista, Windows XP y la familia Windows Server Windows Workflow Foundation se puede utilizar para resolver los escenarios simples como mostrar los UI de controles basados en datos proporcionados por el usuario o los escenarios complejos que se producen en las empresas grandes, como procesamiento del orden y control de inventario. Escenarios que las direcciones de Windows Workflow Foundation incluyen: Habilitar el flujo de trabajo dentro de las aplicaciones empresariales Flujos de página del interfaz del usuario Flujo de trabajo centrado en el documento Flujos de trabajo humanos Flujos de trabajo compuestos para las aplicaciones orientadas a servicios Flujos de trabajo controlados por las reglas empresariales Flujos de trabajo para la administración de los sistemas Windows Workflow Foundation proporciona una experiencia de desarrollo coherente y familiar con otras tecnologías.net Framework 3.0, como Windows Communication Foundation y Windows Presentation Foundation. La API de la Windows Workflow Foundation proporciona la compatibilidad completa para Visual Basic.NET y C#, un compilador del flujo de trabajo especializado, depuración dentro de un flujo de trabajo, un Workflow Designer gráfico, y desarrolla completamente su flujo de trabajo en código o en marcado. Windows Workflow Foundation también proporciona un modelo extensible y un diseñador para generar actividades personalizadas que encapsulan la funcionalidad del flujo de trabajo para los usuarios finales o para reutilizarse en varios proyectos. Un flujo de trabajo es un conjunto de unidades elementales llamadas actividades que están almacenadas como un modelo que describe un proceso real. Los flujos de trabajo proporcionan una manera de describir el orden de ejecución y las relaciones de dependencia entre las partes de trabajo de ejecución corta o prolongada. Este trabajo pasa a través del modelo desde el principio hasta al final y las actividades pueden ser ejecutadas por personas o por funciones de sistema. MOTOR DE TIEMPO DE EJECUCIÓN DEL FLUJO DE TRABAJO Cada instancia de flujo de trabajo en ejecución es creada y mantenida por un motor de tiempo de ejecución en proceso al que se hace referencia normalmente como motor de tiempo de ejecución del flujo de trabajo. Puede haber varios motores de tiempo de ejecución del flujo de trabajo dentro de un dominio de aplicación y cada instancia del motor de tiempo de ejecución puede admitir varias instancias de flujo de trabajo que se ejecutan concurrentemente. Cuando un modelo del flujo de trabajo está compilado, se puede ejecutar dentro de cualquier proceso de Windows incluidas las aplicaciones de consola, aplicaciones basadas en formularios, servicios de Windows, sitios web ASP.NET y servicios web. Dado que un flujo de trabajo se hospeda en el proceso, puede comunicarse con facilidad con su aplicación host. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 5

6 La ilustración siguiente muestra cómo los flujos de trabajo, las actividades y el motor de tiempo de ejecución del flujo de trabajo se hospedan en el proceso con una aplicación host. 1 CREAR FLUJOS DE TRABAJO CON MÁQUINAS DE ESTADOS En el estilo de máquina de estado de creación de flujos de trabajo, el creador modela el flujo de trabajo como una máquina de estados. El mismo flujo de trabajo está compuesto por un conjunto de estados. Un estado se conoce como estado inicial. Cada estado puede recibir un conjunto de eventos determinado. En función de un evento, se puede realizar una transición a otro estado. El flujo de trabajo de equipo de estado puede tener un estado final. Cuando se realiza una transición al estado final, el flujo de trabajo se finaliza. El diagrama de flujo siguiente es un ejemplo de un flujo de trabajo de máquina de estado. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 6

7 La tabla siguiente enumera las actividades relacionadas con la máquina de estado en la biblioteca de actividad base de Windows Workflow Foundation. Actividad EventDrivenActivity SetStateActivity StateActivity Descripción Se utiliza para los estados que dependen de un evento externo para empezar a ejecutarse. La actividad EventDrivenActivity ha de tener una actividad que implemente la interfaz IEventActivity como su primera actividad secundaria. Especifica una transición a un nuevo estado. Representa un estado en una máquina de estado; puede contener actividades Estado adicionales. StateInitialitacionActivity Se ejecuta cuando se entra en un estado; puede contener otras actividades. StateFinalizationActivity Ejecuta las actividades contenidas al abandonar una actividad StateActivity. 2 CREAR FLUJOS DE TRABAJO SECUENCIALES El estilo de flujo de trabajo secuencial ejecuta un conjunto de actividades contenidas en orden, una a una. Puede agregar otras actividades compuestas a un flujo de trabajo secuencial para lograr paralelismo (ParallelActivity), paralelismo controlado por eventos (EventHandlingScopeActivity), ejecución controlada por datos (ConditionedActivityGroup), rama controlada por eventos (ListenActivity) y modelos de flujo de control imperativo familiar como ramificación condicional (IfElseActivity) e iteración (WhileActivity, ReplicatorActivity). También se puede utilizar la extensibilidad de Windows Workflow Foundation para escribir actividades compuestas personalizadas implementando los modelos de flujo de control concretos necesarios para las soluciones. El diagrama de flujo siguiente muestra un ejemplo de un flujo de trabajo secuencial. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 7

8 Un flujo de trabajo secuencial ejecuta actividades de una manera secuencial hasta que se finalice la última actividad. Los flujos de trabajo secuenciales no son necesariamente totalmente determinísticos, incluso en operación normal. Por ejemplo, puede utilizar una actividad ListenActivity o ParallelActivity, y la secuencia exacta de eventos puede variar en estos casos. 3 SELECCIONAR EL MODO DE AUTORIZACIÓN DE LOS FLUJOS DE TRABAJO Windows Workflow Foundation admite varios estilos de creación de flujo de trabajo, como secuencial, de máquinas de estado y controlado por datos. El estilo secuencial es sencillo y útil para operaciones repetitivas y predecibles que siempre son iguales. El estilo de flujo de trabajo de máquina de estado está compuesto por un conjunto de estados controlados por eventos. El estilo controlado por datos depende de los datos para determinar si se ejecutan o no ciertas actividades basadas en un estado de datos local. 4 HOSPEDAR UN FLUJO DE TRABAJO Y EL DISEÑADOR EN UNA APLICACIÓN El motor de tiempo de ejecución de Windows Workflow Foundation es responsable de crear y mantener en ejecución las instancias de flujo de trabajo. Para conseguirlo, el motor de tiempo de ejecución necesita un proceso huésped incluyendo aplicaciones consola, Windows Forms, sitios web de ASP.NET y servicios web. Además, las aplicaciones habilitadas por flujos de trabajo hospedando el motor de tiempo de ejecución de Windows Workflow Foundation pueden refinar más el comportamiento del motor de tiempo de ejecución del flujo de trabajo utilizando los servicios. Los servicios base en Windows Workflow Foundation se pueden configurar para que admitan transacciones, persistencia, seguimiento, subprocesamiento y programación. Para la funcionalidad específica de una aplicación, una aplicación puede definir también servicios personalizados agregadas al motor de tiempo de ejecución. CREACIÓN DE UNA APLICACIÓN HUESPED DE FLUJO DE TRABAJO La aplicación huesped interactúa con Windows Workflow Foundation a través de la clase WorkflowRuntime, o una clase personalizada heredando de esta. Se debe crear un objeto WorkflowRuntime y rellenarlo con los servicios a utilizar durante la ejecución de sus flujos de trabajo. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 8

9 RESPONSABILIDADES DE LA APLICACIÓN HOST Crear uno o más procesos y uno o más dominios de aplicación. Proporcionar, según sea necesario, mecanismos de aislamiento. Calcular llamadas entre los dominios de aplicación, según sea necesario. Iniciar instancias de flujo de trabajo. Crear servicios locales y personalizados. Además, una aplicación host podría hacer lo siguiente: Controlar la carga y descarga de flujos de trabajo de la memoria. Escuchar eventos concretos y comunicárselos a un usuario o administrador. Establecer tiempos de espera y reintentos para cada flujo de trabajo. Exponer contadores de rendimiento. Escribir información de registro para depuración y diagnósticos. Proporcionar implementaciones de servicio personalizadas. Crear servicios adaptados para cumplir los requisitos de lenguaje de la aplicación de hospedaje y base de usuarios. TAREAS QUE LA APLICACIÓN HOST DEBE REALIZAR Creación de WorkflowRuntime Procesamiento de eventos WorkflowRuntime Ejecución de flujos de trabajo Se pueden agregar y quitar servicios en el tiempo de ejecución del flujo de trabajo. Se agregan servicios mediante el método AddService definindo en la clase WorkflowRuntime. Se quitan servicios mediante el método RemoveService, también definido en la clase WorkflowRuntime. HOSPEDAJE DE DISEÑADORES DE FLUJO DE TRABAJO Aunque existe una versión Visual Studio del diseñador visual de flujos de trabajo de Windows Workflow Foundation, el diseñador de flujo de trabajo puede hospedarse en aplicaciones de Windows externas a Visual Studio. Se puede hospedar el diseñador de flujo de trabajo basado en gráficos en las aplicaciones personalizadas de Windows. Las aplicaciones personalizadas pueden implementar un formulario simple del diseñador de flujo de trabajo con una funcionalidad básica del diseñador, por ejemplo, la capacidad de mostrar gráficamente un flujo de trabajo antes de generarse o, puede implementar una versión del diseñador de flujo de trabajo con un conjunto de características más sólido, similar a la versión del diseñador de Visual Studio. Las clases primarias a utilizar al hospedar un diseñador de flujos de trabajo son las siguientes: La clase DesignSurface de.net, implementa lo que el usuario percibe como un diseñador proporcionando una superficie de diseño completamente autónoma. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 9

10 La clase WorkflowView, muestra una representación visual de un flujo de trabajo descrito en el marcado del flujo de trabajo. La clase WorkflowDesignerLoader admite la carga personalizada de un diseñador de flujo de trabajo y sus componentes. La clase WorkflowDesignerMessageFilter, que puede derivarse, mediante la invalidación de los métodos virtuales adecuados, para crear un filtro de mensajes personalizado que puede controlar eventos del diseñador de flujos de trabajo, como operaciones de arrastre, operaciones de diseño y pintura, así como otros eventos del diseñador. El control de WorkflowDesigner formando parte del Workflow Tracking Profile Designer proporciona un buen punto de partida para una aplicación de hospedaje de diseñador de flujo de trabajo personalizada. El control de WorkflowDesigner proporciona una manera fácil de agregar y extender la funcionalidad del diseñador de flujo de trabajo en una aplicación host. AGREGAR LA FUNCIONALIDAD DE COMANDOS DE MENÚ Como el diseñador de flujo de trabajo se generó a partir de clases básicas del diseñador en.net Framework SDK, para acceder a los comandos de menú de la aplicación personalizada se debe derivar de la clase MenuCommandService, invalidar algunos de sus miembros, y agregarla como servicio al host del cargador de diseñadores utilizado por el objeto del cargador de flujo de trabajo. 5 INICIALIZAR Y ADMINISTRAR EL CICLO DE VIDA DE UN FLUJO DE TRABAJO CREACIÓN DE WORKFLOWRUNTIME El mecanismo predeterminado para inicializar Windows Workflow Foundation es utilizar la clase WorkflowRuntime, de la siguiente manera (Ejemplo VB Net): Imports System.Threading Imports System.Workflow.Runtime Imports System.Workflow.Runtime.Hosting Class Program Shared Sub Main() Using workflowruntime As WorkflowRuntime = New WorkflowRuntime() End Using End Sub Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 10

11 End Class En el cuerpo de la instrucción using, se inicializa un objeto WorkflowRuntime y está preparado para su uso. En este punto, se puede crear controladores de eventos para administrar los eventos provocados por el motor en tiempo de ejecución, recuperar y configurar cualquiera de los servicios base utilizados por el motor en tiempo de ejecución y, finalmente, crear e iniciar una instancia de flujo de trabajo PROCESAMIENTO DE EVENTOS WORKFLOWRUNTIME El motor de tiempo de ejecución de Windows Workflow provoca varios eventos a lo largo de su duración aser controlados por la aplicación huesped. Éstos están compuestos de eventos informando a la aplicación cuando el motor de tiempo de ejecución es Started o Stopped, y también varios eventos correspondiendo a la duración de cualquier instancia de flujo de trabajo en ejecución. El procedimiento para crear controladores de eventos para estos eventos sigue el mismo modelo de control de eventos proporcionado en.net Framework. EJECUCIÓN DE FLUJOS DE TRABAJO Las instancias de flujo de trabajo pueden iniciarse de dos maneras: mediante los tipos de flujo de trabajo, o a través del marcado de flujo de trabajo basado en XAML. 6 MODIFICAR EN TIEMPO DE EJECUCIÓN UN FLUJO DE TRABAJO Windows Workflow Foundation permite actualizar dinámicamente las reglas declarativas y las instancias de flujo de trabajo en tiempo de ejecución. Antes de que las actividades se programen para ejecutarse, se pueden cambiar comportamientos esperados, el control de flujo, etc. Esta capacidad le permite modificar la lógica de procesamiento empresarial sin tener que volver a compilar y reiniciar el flujo de trabajo. USO DE CAMBIOS DE FLUJO DE TRABAJO EN FLUJOS DE TRABAJO Los cambios de flujo de trabajo permiten realizar cambios en tiempo de ejecución en una instancia en ejecución de un flujo de trabajo. Estos cambios podrían deberse a omisiones en el tiempo de diseño, cambios en las propiedades y enlaces de las actividades o una necesidad de lógica de negocio que mejora y modela de manera más completa los procesos de negocio. Los cambios de flujo de trabajo no están pensados para situaciones en las que se desea realizar modificaciones al por mayor, lo que llevaría a un flujo de trabajo que varía significativamente de los principios de diseño originales. En tal caso, se debería diseñar un nuevo flujo de trabajo en lugar de realizar cambios en una instancia en ejecución. Los cambios en un flujo de trabajo se aplican a una instancia única de un flujo de trabajo. No admiten cambios basados en tipo que se replican en todas las instancias, en ejecución y futuras, de un tipo determinado de flujo de trabajo. Puede utilizar cambios de flujo de trabajo para hacer lo siguiente: Por ejemplo, cambiar la estructura de flujo de trabajo, agregar o quitar una actividad. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 11

12 Cambiar el control de flujo. Algunos ejemplos de cambios del flujo de trabajo comunes incluyen lo siguiente: Cambiar un RuleSet utilizado por una actividad PolicyActivity. Actualizar definiciones RuleCondition para cambiar el comportamiento de actividades ramificadas, como ConditionedActivityGroup y IfElseActivity. Agregar una nueva actividad personalizada o una actividad InvokeWorkflowActivity para agregar un nuevo proceso de negocio a su flujo de trabajo después de implementarlo y ejecutarlo. Cambiar la creación que se usa declarativamente en el marcado de flujo de trabajo desde fuera del flujo de trabajo, tomando el marcado actualizado como un parámetro para efectuar el cambio. Agregar una nueva actividad EventDrivenActivity para responder a un nuevo evento, como un paso de aprobación adicional. Aplicar un cambio de flujo de trabajo a un flujo de trabajo en ejecución puede darse en dos puntos de entrada diferentes: en el archivo de código del flujo de trabajo y fuera del flujo de trabajo, como el host del flujo de trabajo. RESTRICCIONES EN LOS CAMBIOS DE FLUJO DE TRABAJO A continuación se muestran algunas restricciones en los cambios de flujo de trabajo impuestas por Windows Workflow Foundation que debe tener en cuenta: Se pueden agregar o quitar actividades de una instancia de flujo de trabajo, pero no se pueden cambiar las propiedades en una actividad existente a menos que esas propiedades sean condiciones de regla declarativas o conjuntos de reglas. No se pueden agregar o quitar de manera dinámica las actividades secundarias de los tipos de actividad compuesta personalizada que incorporen actividades secundarias como parte de su definición. Esto se debe a que actividades compuestas personalizadas como esta son actividades de "caja negra" y no se pueden modificar fundamentalmente durante el tiempo de ejecución. Una actividad que no está en los estados Initialized o Closed no se puede quitar dinámicamente durante el tiempo de ejecución. Un desarrollador de flujo de trabajo puede restringir el uso de cambios de flujo de trabajo a través de una ActivityCondition adjunta a la actividad raíz del flujo de trabajo, que es usada por el tiempo de ejecución del flujo de trabajo para determinar si se permiten o no los cambios de flujo de trabajo para una instancia de flujo de trabajo determinada. Las actividades compuestas personalizadas pueden validar cambios propuestos, como la suma o eliminación de actividades secundarias. Esto permite a los programadores de actividad determinar si cualquier cambio de flujo de trabajo propuesto entra en conflicto con la funcionalidad intencional de su actividad. Esta funcionalidad se proporciona a través de un ActivityValidator personalizado, donde los programadores pueden invalidar el método ValidateActivityChange y agregar su lógica de validación de cambios de flujo de trabajo personalizados. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 12

13 7 MANEJAR EVENTOS DESDE LA MÁQUINA HUÉSPED El motor de tiempo de ejecución de Windows Workflow provoca varios eventos a lo largo de su duración aser controlados por la aplicación huesped. Éstos están compuestos de eventos informando a la aplicación cuando el motor de tiempo de ejecución es Started o Stopped, y también varios eventos correspondiendo a la duración de cualquier instancia de flujo de trabajo en ejecución. El procedimiento para crear controladores de eventos para estos eventos sigue el mismo modelo de control de eventos proporcionado en.net Framework. Como ejemplo, el código siguiente crea un controlador de eventos para el evento Started elevado por el flujo de trabajo en tiempo de ejecución cuando comienza la ejecución. AddHandler workflowruntime.started, AddressOf OnWorkflowStarted... Shared Sub OnWorkflowStarted(ByVal sender As Object, ByVal e As WorkflowRuntimeEventArgs) Console.WriteLine("WorkflowRuntime started") End Sub A continuación se listan los eventos que pueden ser provocados por el motor de tiempo de ejecución de Windows Workflow el cual pertenece al mismo motor de tiempo de ejecución del flujo de trabajo. ServicesExceptionNotHandled Se genera cuando un servicio que se deriva de la clase abstracta WorkflowRuntimeService llama al método RaiseServicesExceptionNotHandledEvent, porque ocurre una excepción durante la ejecución del flujo de trabajo que el servicio no puede administrar. Started Se genera cuando el motor de tiempo de ejecución del flujo de trabajo inicia el funcionamiento. Stopped Se genera cuando el motor de tiempo de ejecución del flujo de trabajo finaliza el funcionamiento. A continuación se listan los eventos de instancia de flujo de trabajo provocados por el motor de tiempo de ejecución del flujo de trabajo. WorkflowAborted Se genera cuando un flujo de trabajo se detiene en el medio del procesamiento. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 13

14 WorkflowCompleted Se genera cuando un flujo de trabajo completa el procesamiento. WorkflowCreated Se genera cuando se crean instancias de un flujo de trabajo. WorkflowIdled Se genera cuando un flujo de trabajo entra en estado inactivo. WorkflowLoaded Se genera cuando un flujo de trabajo se vuelve a crear desde un medio de almacenamiento. WorkflowPersisted Se genera cuando el estado actual del flujo de trabajo se conserva en un medio de almacenamiento. WorkflowResumed Se genera cuando un flujo de trabajo reanuda la ejecución una vez detenido o descargado. WorkflowStarted Se genera cuando un flujo de trabajo inicia el funcionamiento. WorkflowSuspended Se genera cuando un flujo de trabajo entra en estado de suspensión. WorkflowTerminated Se genera cuando se finaliza un flujo de trabajo. WorkflowUnloaded Se genera cuando se descarga un flujo de trabajo. Condiciones de WorkflowAbort Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 14

15 Existen condiciones diferentes a producirse durante la ejecución de un flujo de trabajo generando el evento WorkflowAborted. Por ejemplo, una aplicación host puede intervenir en el proceso llamando al método Abort desde un objeto WorkflowInstance. En este caso, la razón se conoce y la lógica para administrar esto se puede crear con facilidad en la propia aplicación host. Sin embargo, hay condiciones en que el motor de tiempo de ejecución de Windows Workflow Foundation anulará un flujo de trabajo. Un ejemplo de esta condición es un resultado en que el motor de tiempo de ejecución no puede finalizar una instancia de flujo de trabajo. Un escenario común relacionado con esta condición involucra SqlWorkflowPersistenceService. Si el motor de tiempo de ejecución del flujo de trabajo necesita finalizar un flujo de trabajo y SqlWorkflowPersistenceService está activo, el motor de tiempo de ejecución intentará conservar el estado del flujo de trabajo. Sin embargo, si SqlException se inicia durante la operación de persistencia, el motor de tiempo de ejecución tendrá que anular la instancia de flujo de trabajo. Cuando esto se produce, se puede utilizar TrackingService para volcar la información de excepción con el fin de depurar el escenario que hizo que el motor de tiempo de ejecución anulara la instancia de flujo de trabajo. La ubicación en el flujo de trabajo donde se produce una excepción se puede buscar examinando el grafo del flujo de trabajo y comprobando el estado de cada actividad en el momento de la finalización. El código siguiente muestra cómo lograr esto si la excepción se produce desde FaultHandlerActivity. Function isexceptionfromfaulthandler(byval rootactivity As Activity) As Boolean If rootactivity Is Nothing Then Return False End If If TypeOf rootactivity Is CompositeActivity Then If TypeOf rootactivity Is FaultHandlersActivity Then If rootactivity.executionstatus = ActivityExecutionStatus.Closed Then Return True End If End If For Each act As Activity In (CType(rootActivity, CompositeActivity)).Activities If isexceptionfromfaulthandler(act) Then Return True Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 15

16 End If Next End If Return False End Function 8 INVOCAR MÉTODOS EN LA MÁQUINA HUÉSPED Las instancias de flujo de trabajo pueden iniciarse de dos maneras: mediante los tipos de flujo de trabajo, o a través del marcado de flujo de trabajo basado en XAML. Para iniciar una instancia de flujo de trabajo mediante un tipo de flujo de trabajo, se invoca al método CreateWorkflow, pasando el System.Type del flujo de trabajo y, a continuación, invocando al método Start. Dim workflowinstance As WorkflowInstance workflowinstance = workflowruntime.createworkflow(gettype(workflow1)) workflowinstance.start() Para iniciar una instancia de flujo de trabajo sólo mediante el marcado de flujo de trabajo, se llama al método CreateWorkflow, pasando el XmlReader conteniendo la definición de flujo de trabajo en un archivo o secuencia y, a continuación, se ejecuta Start. Dim workflowinstance As WorkflowInstance workflowinstance = workflowruntime.createworkflow(workflowdefinitionreader) workflowinstance.start() Se utiliza un archivo de marcado de flujo de trabajo con un archivo con separación de código, debe pasar el tipo del flujo de trabajo a CreateWorkflow, en lugar de pasar el archivo de marcado de flujo de trabajo. De manera predeterminada, el motor en tiempo de ejecución de Windows Workflow inicia los flujos de trabajo de forma asincrónica. Para asegurarse de que la aplicación host no se cierra antes de que finalice la ejecución del flujo de trabajo, se debe utilizar los objetos de subprocesamiento de sincronización proporcionados por.net Framework, como, por ejemplo, el objeto AutoResetEvent. El siguiente ejemplo de código muestra cómo crear e iniciar el tiempo de ejecución del flujo de trabajo, iniciar una instancia de flujo de trabajo, y salir utilizando un AutoResetEvent cuando el objeto WorkflowRuntime provoca el evento WorkflowCompleted. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 16

17 Class Program Shared WaitHandle As New AutoResetEvent(False) Shared Sub Main() Using workflowruntime As New WorkflowRuntime() AddHandler workflowruntime.workflowcompleted, AddressOf OnWorkflowCompleted Dim workflowinstance As WorkflowInstance workflowinstance = workflowruntime.createworkflow(gettype(workflow1)) workflowinstance.start() WaitHandle.WaitOne() End Using End Sub Shared Sub OnWorkflowCompleted(ByVal sender As Object, ByVal e As WorkflowCompletedEventArgs) WaitHandle.Set() End Sub End Class 9 CONSUMIR SERVICIOS DESDE UN FLUJO DE TRABAJO CÓMO CONFIGURAR UN SERVICIO DE FLUJO DE TRABAJO Configurar un cliente de servicios de flujo de trabajo es parecido a configurar un servicio Windows Communication Foundation (WCF), ya que se usa un archivo de configuración de aplicación. El tiempo de ejecución de flujo de trabajo se configura como parte de la sección de comportamientos del servicio. El ejemplo siguiente muestra cómo puede agregar SqlWorkflowPersistenceService agregando el tiempo de ejecución del flujo de trabajo como un comportamiento del servicio. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 17

18 <?xml version="1.0" encoding="utf-8"?> <configuration> <system.servicemodel> <services> <service name="microsoft.workflowservices.samples.sequentialcalculatorservice" behaviorconfiguration="servicebehavior" > <host> <baseaddresses> <add baseaddress=" /> </baseaddresses> </host> <endpoint address="" binding="wshttpcontextbinding" contract="icalculator" /> </service> </services> <behaviors> <servicebehaviors> <behavior name="servicebehavior" > <servicemetadata httpgetenabled="true" /> <servicedebug includeexceptiondetailinfaults="true" /> <servicecredentials> Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 18

19 <windowsauthentication allowanonymouslogons="false" includewindowsgroups="true" /> </servicecredentials> <!-- Comment out the following behavior to disable persistence store --> <workflowruntime name="workflowservicehostruntime" validateoncreate="true" enableperformancecounters="true"> <services> <add type="system.workflow.runtime.hosting.sqlworkflowpersistenceservice, System.Workflow.Runtime, Version= , Culture=neutral, PublicKeyToken=31bf3856ad364e35" connectionstring="data Catalog=NetFx35Samples_ServiceWorkflowStore;Integrated Security=True;Pooling=False" Source=localhost\sqlexpress;Initial LoadIntervalSeconds="1" UnLoadOnIdle= "true" /> </services> </workflowruntime> </behavior> </servicebehaviors> </behaviors> </system.servicemodel> </configuration> Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 19

20 10 EXPONER UN FLUJO DE TRABAJO COMO UN SERVICIO DESARROLLO DE SERVICIOS DE WINDOWS WORKFLOW FOUNDATION Los servicios trabajan en un entorno host de la Windows Workflow Foundation para proporcionar la función adicional al motor en tiempo de ejecución cuando administra la ejecución de flujos de trabajo. De forma predeterminada, varios servicios están incluidos con Windows Workflow Foundation. Estos servicios se pueden extender para proporcionar más servicios personalizados que dependen de sus necesidades de flujo de trabajo. Hay dos maneras de crear servicios personalizados que funcionen dentro del modelo de programación de la Windows Workflow Foundation: Crear servicios que están basados en servicios existentes. Crear nuevos servicios que van más allá de la capacidad de los servicios proporcionados predeterminados. EXTENDER SERVICIOS BASE Windows Workflow Foundation proporciona varios servicios base que puede utilizar para crear un servicio personalizado para trabajar en su escenario de flujo de trabajo. Para ello, se crea una nueva definición de clase y se deriva esa clase desde un servicio base existente. Por ejemplo, el servicio TrackingService se utiliza para supervisar un flujo de trabajo. La clase TrackingService es una clase abstracta que confía en una clase derivada para procesar los datos del seguimiento de un flujo de trabajo. Extender la clase TrackingService base le permite controlar cómo se procesa la información y cómo se transmite mediante el almacén de datos de su elección. CREACIÓN DE NUEVOS SERVICIOS PERSONALIZADOS Además de extender los servicios predeterminados que son proporcionados a través de Windows Workflow Foundation, puede definir nuevos servicios que no sigan ninguna arquitectura determinada que sea definida por los servicios predeterminados. HOSPEDAR UN SERVICIO DE FLUJO DE TRABAJO EN IIS Los servicios de flujo de trabajo pueden hospedarse en Internet Information Services (IIS) de la misma manera que los servicios de Windows Communication Foundation (WCF) se hospedan en IIS, mediante el uso de archivos de configuración web y de servicio, y algún código de aplicación. El hospedaje en IIS permite a un servicio de flujo de trabajo aprovechar las características de IIS como el reciclaje automático de procesos, supervisión del estado de los procesos, etc. Hay tres maneras de hospedar un servicio de flujo de trabajo en IIS. La primera es hacer referencia a una definición de flujo de trabajo precompilada en un archivo.svc. La segunda es utilizar un archivo de marcado de flujo de trabajo con una extensión.xoml. La tercera es hacer referencia a un archivo de marcado de flujo de trabajo en un archivo.svc. Prohibida la reproducción total o parcial, derechos reservados, Instituto Gala de Venezuela 20