Introducción
Como continuación al anterior artículo Introducción a los Workflows Secuenciales con Tareas y Formularios en Visual Studio 2010 para SharePoint 2010, en el cuál introducíamos algunos conceptos básicos de la programación de Workflows en Visual Studio 2010 para SharePoint 2010, en esta ocasión vamos a realizar un ejercicio práctico para ver paso a paso un ejemplo de desarrollo de un Workflow secuencial con Tareas.
Para no crear un artículo demasiado extenso (y en consecuencia, duro de leer y comprender), el presente artículo sólo describe la forma de crear un Workflow secuencial con Tareas, es decir, no vamos a tocar el tema de los formularios (ni html ni InfoPath).
Antes de empezar a realizar nuestro ejercicio, deberemos crear una Lista en SharePoint, tomando como partida una Custom List, la cual deberá tener un campo requerido denominado Manager de tipo Person or Group con la opción Show field configurada con el valor Account.
La idea del ejercicio que vamos a realizar es la siguiente: al crear un nuevo elemento en la Lista, se ejecutará el Workflow, el cuál creará una nueva Tarea asignada al usuario que especifiquemos en el campo Manager, y se quedará a la espera de que dicha Tarea sea completada, para finalizar la ejecución del Workflow.
Crear un Workflow con Tareas en Visual Studio 2010
Abriremos Visual Studio 2010 y crearemos un proyecto de tipo Sequential Workflow para SharePoint 2010.
En el Wizard para la creación del Proyecto en Visual Studio 2010, seleccionaremos la opción Deploy as a farm solution, asignaremos el nombre que deseemos para el Workflow, seleccionaremos el tipo List Workflow, asociaremos automáticamente el Workflow con la lista que acabamos de crear, y seleccionaremos las opciones A user manually starts the workflow y The workflow starts automatically when an item is created.
Realizado esto, deberemos agregar las siguientes actividades al Workflow:
- Una actividad LogToHistoryListActivity.
- Una actividad CreateTask. Nos permitirá crear una Tarea mediante código, utilizando para ello un evento de dicha actividad.
- Una actividad While, con una actividad OnTaskChanged en su interior. Nos permitirá que el Workflow continué ejecutándose mientras no se complete la Tarea que antes creamos. De nuevo, utilizaremos un evento de la actividad OnTaskChanged, y necesitaremos escribir un poco de código.
- Una actividad CompleteTask.
Con esto, el Workflow tendrá un aspecto similar al siguiente.
En las Propiedades de la actividad createTask1, especificaremos el valor de la propiedad CorrelationToken como taskToken, y seguidamente especificaremos el valor de la propiedad OwnerActivityName como Workflow1, tal y como se muestra en la siguiente pantalla capturada.
Seguidamente, para la propiedad TaskId de la actividad createTask1 crearemos una nueva variable (Create Field) que llamaremos taskId. Esto lo que hace es crear un nuevo miembro en la clase de nuestro Workflow, y enlazarlo con esta propiedad, lo que nos permitirá acceder a la misma desde código, como veremos más adelante en este mismo artículo.
Del mismo modo, para la propiedad TaskProperties de la actividad createTask1 crearemos una nueva variable (Create Field) que llamaremos taskProperties. De este modo, desde código podremos utilizar un evento de la actividad createTask1, para crear una tarea a nuestro antojo, como veremos más adelante.
Con esto ya tendremos establecido el valor de todas las propiedades de la actividad createTask1, al menos, de todas las propiedades que nos interesan para este ejercicio.
Estos dos últimos dos pasos, han modificado el código fuente de nuestro Workflow para incluir las siguientes dos declaraciones de miembros (taskId y taskProperties) a la Clase correspondiente a nuestro Workflow.
Continuamos con la actividad onTaskChanged1, para la que del mismo modo que hicimos con la actividad createTask1, especificaremos el valor de la propiedad CorrelationToken como taskToken, especificaremos el valor de la propiedad OwnerActivityName como Workflow1, y asociaremos (Bind) la propiedad TaskId a la variable miembro taskId que creamos en el paso anterior.
Seguidamente, para la propiedad AfterProperties de la actividad onTaskChanged1 crearemos una nueva variable (Create Field) que llamaremos taskAfterProperties.
Del mismo modo, para la propiedad BeforeProperties de la actividad onTaskChanged1 crearemos una nueva variable (Create Field) que llamaremos taskBeforeProperties.
Con estos últimos dos pasos, se habrán incluido dos nuevas declaraciones de miembros (taskAfterProperties y taskBeforeProperties) a la Clase correspondiente a nuestro Workflow.
Seguimos ahora con la actividad completeTask1, para la que del mismo modo que hicimos con la actividad createTask1, especificaremos el valor de la propiedad CorrelationToken como taskToken, especificaremos el valor de la propiedad OwnerActivityName como Workflow1, y asociaremos (Bind) la propiedad TaskId a la variable miembro taskId que creamos anteriormente.
Para continuar, seleccionaremos la opción Generate Handlers del menú contextual de la actividad createTask1. Después, seleccionaremos la opción Generate Handlers del menú contextual de la actividad onTaskChanged1.
En la vista de código fuente de nuestro Workflow, podremos observar los dos eventos que acabamos de crear a través de la opción de menú Generate Handlers. Continuando en la vista de código fuente, agregamos un nuevo miembro público de tipo booleano a la clase de nuestro Workflow, que denominaremos isTaskCompleted, con un valor por defecto de false, tal y como se muestra en la siguiente pantalla capturada.
El nuevo miembro que acabamos de crear lo utilizaremos para configurar la condición de la actividad whileActivity1. Para ello, en las propiedades de la actividad whileActivity1, estableceremos la propiedad Condition como Declarative Rule Condition, especificaremos el nombre que deseemos para la condición en la propiedad ConditionName, y especificaremos la expresión de nuestra condición en la propiedad Expression, tal y como se muestra en la siguiente pantalla capturada.
De vuelta a la vista de código, escribiremos el código deseado para los dos eventos.
Realizado esto, ya sólo nos queda compilar, desplegar, y probar nuestro Workflow.
Antes de acabar, aprovecha para colgar el código fuente de ejemplo:
Poco más por hoy. Como siempre, confío que la lectura resulte de interés.
