Visual Studio Team System : Workflows

[VS2008 – WWF – MOSS 2007] ¿Cómo crear tareas paralelas en MOSS 2007 desde Visual Studio 2008 ?

Francisco X. Fagas — Mon, 16 Mar 2009 16:44:29 GMT

Introducción

En un artículo anterior publiqué cómo crear una tarea en MOSS 2007, en este artículo aprenderá cómo crear tareas paralelas en MOSS 2007 utilizando Visual Studio 2008 Team Developer, Visual Studio 2008 nos permite crear de manera sencilla (al estilo Microsoft) flujos de trabajo para SharePoint, para esto disponemos de plantillas de proyecto al momento de empezar con la creación del mismo, en Microsoft Office SharePoint 2007 (MOSS 2007) podemos crear tareas en serie o en paralelo, las mismas que para crearlas las podemos hacer utilizando diferentes herramientas disponibles en el toolbox de Visual Studio 2008, en esta ocasión utilizaremos el replicator para la creación de las actividades en paralelo.

Les recomiendo leer el artículo anteriormente mencionado y descargar su código ya que reutilizaremos el ejemplo anterior para la creación de las tareas. El código fuente del presente artículo lo pueden descargar de aquí:

Descargar código Fuente.

Software Requerido

Windows Server 2003 o superior
Microsoft Office SharePoint 2007 (instalación stand alone)
Visual Studio 2008 Team Developer

Desarrollo

Empiece abriendo Visual Studio 2008 y agregando un nuevo proyecto a la solución anterior.

De la lista de Tipos de Proyectos seleccione Workflow y luego de la lista de plantillas SharePoint 2007 Sequential Workflow, le asigna un nombre a su proyecto y de clic en Ok.

Visual Studio 2008 iniciará un asistente, el cual en esta primera ventana deberá asignarle el nombre de su flujo de trabajo que desea que aparezca en SharePoint, e ingresar la url del sitio sobre el cual va a publicar el flujo de trabajo, Visual Studio 2008 en plataformas de 32 bits le permite publicar y hacer debug de sus flujos de trabajo para MOSS 2007, para lo cual utilizará la url proporcionada en este paso.

Si usted desea puede marcar para que automáticamente se asocie el flujo de trabajo que va a desarrollar con una librería en particular, caso contrario lo puede realizar manualmente utilizando comandos. Para la asociación automática debemos tener claro que significa cada elemento listado en este paso del asistente. El flujo de trabajo se debe asociar a una lista, esta lista será quien inicie el flujo de trabajo bajo ciertas condiciones, la lista de historial me permitirá almacenar toda la información relacionada al flujo de trabajo, por ejemplo: cuando inicio el flujo, cierta actividad, cuanto terminó, quién la terminó, etc., por último tenemos que seleccionar la lista de tareas, en esta lista el flujo de trabajo creará las tareas que nosotros le indiquemos. Antes de continuar y una vez entendido lo anterior pensemos en el siguiente escenario: Tenemos una librería de documentos que cada vez que se modifique un documento este deba ser aprobado por la persona X, persona Y o persona Z (esto implica que cualquiera de dichos usuarios puede aprobar el documento, es decir, estamos hablando de un flujo de aprobación en paralelo), para que dichos usuarios se enteren de que deben aprobar el documento debemos crear tareas y asignárselas para esto utilizaremos la lista de tareas.

En este paso final del asistente debemos seleccionar cuando queremos que el flujo de trabajo se inicie, basándonos en el ejemplo anterior debería seleccionar cuando el elemento cambie, pero en este caso yo quiero iniciar el flujo manualmente, razón por la cual selecciono sólo la primera acción.

Una vez terminado el asistente se abrirá el diseñador del flujo, recuerden que para la creación de una tarea utilizaremos el ejemplo publicado en el artículo anterior, por lo cual debemos a este proyecto agregar la referencia al mismo.

En la ventana de referencias seleccione de proyectos BasicTaskActivity.

En ese momento en el toolbox veremos el componente WssTaskActivity, pero antes de agregarlo debemos insertar en el flujo de trabajo el componente que realizará la creación de las tareas en paralelo, para lo cual seleccionen el componente replicator y llévenlo hacia el área de trabajo, luego seleccionen WssTaskActivity e insértenlo dentro del replicator.

La siguiente es la vista del flujo de trabajo con el replicator insertado. Le damos doble clic sobre el componente onWorkflowActivated1, para proceder a inicializar variables.

Una vez realizado lo anterior, vamos al código del flujo de trabajo y defina las siguientes variables públicas:

//Contendrá la lista de aprobadores.
public IList approversList;
//Bandera que se utilizará para determinar si la tarea actual
//fue completada o no, por defecto es falso.
public bool isActualTaskCompleted = false;

En este ejemplo quemaremos en el código la lista de aprobadores, pero debemos tener en cuenta que los aprobadores los podemos obtener de cualquier objeto.

private void onWorkflowActivated1_Invoked(object sender, ExternalDataEventArgs e)
{
   approversList = new ArrayList();
   approversList.Add("igec\\ffagas");
   approversList.Add("igec\\user1a");
   approversList.Add("igec\\user2a");
}

Una vez inicializada la lista de aprobadores regresamos a la vista de diseño del flujo de trabajo y procedemos a configurar las propiedades del replicator, lo primero que debemos hacer es vincular la variable approversList con la propiedad InitialChildData, el replicator utilizará esta lista para la creación de las actividades, veamos al replicator como un foreach, lo que implica que no debemos programar el avance al siguiente elemento de la lista, el replicator permite dos tipos de iteraciones en serie o en paralelo, por defecto está en serie, procedamos a cambiarlo a paralelo.

Luego, procedemos a programar los siguientes métodos del replicator, para lo cual en la lista de propiedades ingrese el nombre del método y enter, automáticamente el VS abrirá la vista de código del flujo:

private void ParallelChildInitialized(object sender, ReplicatorChildEventArgs e)
{
  /* Debemos hacer un cast de la actividad que está actualmente instanciada
     con la actividad que creamos en el proyecto anterior, para 
     poder tener acceso 
     a las propiedades públicas de la misma. Estas propiedades 
     nos permitirán asignar a un usuario,
     la descripción, título, ID (es un GUID), y el campo de estado de la tarea.
  */
  //Recuerde que los usuarios a los que se va a asignar la tarea se encuentran en la lista,
  //entonces debe hacer referencia al dato actualmente instanciado y asignarselo al campo público de la actividad.
  (e.Activity as BasicTaskActivity.WssTaskActivity).strAsignadoA = e.InstanceData.ToString();
  (e.Activity as BasicTaskActivity.WssTaskActivity).strDescripcion = "Demo Tarea Paralelas";
  (e.Activity as BasicTaskActivity.WssTaskActivity).strTitulo = "Demo Tarea Paralela";
  (e.Activity as BasicTaskActivity.WssTaskActivity).taskId = Guid.NewGuid();
  // Para obtener información de una columna de sharepoint la debemos instanciar por su GUID, 
para lo cual utilizaremos las propiedades del flujo,
  // instanciamos la lista de tareas, luego sus campos y le pasamos como 
parametro el nombre que se muestra en sharepoint
  // en este caso me interesa conocer la información del campo estado, y obtengo su ID (GUID) 
que utilizará el WssTaskActivity para obtener la información
  // del estado actual de la tarea 
  (e.Activity as BasicTaskActivity.WssTaskActivity).idCampoEstado = 
workflowProperties.TaskList.Fields["Estado"].Id;
}

 private void ParallelChildCompleted(object sender, ReplicatorChildEventArgs e)
        {
// Validamos cada vez que se complete una actividad hija del 
replicator el estado actual de la tarea
// si la tarea fue completada, cambiamos el estado de la 
variable isActualTaskCompleted a True.
            if ((e.Activity as BasicTaskActivity.WssTaskActivity).esTareaCompletada)
            {
                this.isActualTaskCompleted = true;
            }
        }


/*Este método corresponde a la condición del replicator, 
debe seleccionar en el tipo de condición (Until Condition)
código, y luego insertar el siguiente método, y le asignamos 
el valor de la variable this.isActualTaskCompleted, con esto
cuando un usuario complete la tarea el flujo terminará.
*/
private void ParallelTasksNotCompleteCondition(object sender, ConditionalEventArgs e)
        {
            e.Result = this.isActualTaskCompleted;
        }

Una vez realizado lo anterior, compilamos y ejecutamos el flujo de trabajo, esto le abrirá un navegador y deberá inicializar el flujo manualmente:

De la lista de flujos de trabajo seleccionamos el que acabamos de publicar y le aparecerá que la operación de inicialización está en proceso.

A continuación en el estado del flujo de trabajo veremos que se ha creado las tareas para los usuarios que configuramos en la lista

Seleccionamos cualquiera de ellas y editamos su estado

Seleccionamos completada. (Tenga en cuenta que si su sharepoint está en español deberá cambiar el código de la tarea personalizada), por lo siguiente:

private void cambiaTarea_Invoked(object sender, ExternalDataEventArgs e)
        {
            string estado = 
cambiaTarea_AfterProperties1.ExtendedProperties[idCampoEstado].ToString();
            if (estado != null)
            {
                if (estado.Equals("Completada"))
                    this.esTareaCompletada = true;
            }
        }

Luego de completar la tarea el flujo aparecerá con un estado ya no en curso sino en Finalizado.

Reunión con Célula .Net de la Estatal

Francisco X. Fagas — Tue, 12 Aug 2008 05:37:03 GMT

El jueves 7 de Agosto tuve una reunión con los miembros más activos de la célula .Net de la Universidad Estatal de Guayaquil para realizarles una presentación (bueno empezamos con una presentación pero luego empezamos a discutir sobre la aplicación de los temas tratados y futuras actividades para que los estudiantes empiecen a desarrollar sus aplicaciones con estas tecnologías y herramientas), entre todos los temas tratados los más destacados fueron WPF, WCF, WWF, Expression Blend, Silverlight y para cerrar con broche de oro les presenté las nuevas características de VSTS “Rosario”. Les comparto un par de fotos al final de la presentación con la gente activa de la célula.

[VS2008 -WWF- MOSS 2007] ¿Cómo crear actividades personalizadas?

Francisco X. Fagas — Thu, 07 Aug 2008 21:25:00 GMT

Introducción

En este artículo aprenderá cómo crear una actividad personalizada utilizando Visual Studio 2008, esta actividad contendrá los pasos básicos necesarios para asignar una tarea en MOSS 2007 a un usuario, la misma que esperará a que este la complete, en una segunda publicación aprenderá cómo utilizar ésta actividad personalizada en un flujo de trabajo para MOSS 2007.

Para poder utilizar esta actividad en un flujo para MOSS 2007 deberá ser firmada con un strong name (La clave para quienes descarguen el codigo de ejemplo es Password1) y publicada en el GAC del servidor de MOSS 2007.

Descargar código Fuente.

Software Requerido

Windows Server 2003 o superior
Microsoft Office SharePoint 2007 (instalación stand alone)
Visual Studio 2008

Desarrollo

Empiece abriendo Visual Studio 2008 y cree un nuevo proyecto.

Los flujos de trabajo para MOSS 2007 son flujos de Windows WorkFlow Foundation, por lo tanto de la lista de Project types seleccione Workflow, y luego seleccione la plantilla Workflow Activity Library, en el nombre del proyecto ingrese BasicTaskActivity.

Una vez creado el proyecto deberá firmar el assembly con un strong name, para lo cual haga clic derecho sobre el proyecto y seleccione propiedades, en la ventana de propiedades diríjase al tab signing.

Active la casilla Sign Assembly y seleccione new para crear un nuevo archivo de clave, deberá ingresar un nombre y una clave antes de dar clic en OK.

Una vez creado cierre la ventana de propiedades. Para poder utilizar las actividades para MOSS 2007 deberá agregar la referencia de los siguientes assemblies:

Identity	Description
Microsoft.Sharepoint	Windows® SharePoint® Services
Microsoft.SharePoint.WorkflowActions	Windows® SharePoint® Services Workflow Actions

Utilice el nombre que aparece en description (ver tabla anterior) para agregar las referencias.

Luego proceda a renombrar la actividad llamándola WssTaskActivity.cs

Vaya al código de la actividad personalizada y dentro de la clase agregue la siguiente definición de variables, las cuales servirán como parámetros de entrada cuando agregue la actividad a un flujo de aprobación de MOSS 2007.

#region Public Parameters

public Guid idCampoEstado;

public string strAsignadoA;

public string strTitulo;

public string strDescripcion;

public DateTime dtDuración;

public bool bEnviarNotificación;

#endregion

En el toolbox de VS 2008 existen las actividades necesarias para gestionar tareas de MOSS 2007, así como para enviar email, registrar mensajes en el historial del flujo de trabajo, etc.

Luego deberá agregar las siguientes actividades con sus respectivas propiedades en el área de diseño de la actividad que estamos creando.

Paso	Grupo	Actividad
Ver Paso A	SharePoint Workflow	CreateTask
Ver Paso B	Windows Workflow v3.0	While
Ver Paso C	SharePoint Workflow	OnTaskChanged
Ver Paso D	SharePoint Workflow	CompleteTask

Paso A

Configure las siguientes propiedades de la actividad CreateTask:

(Name): Ingrese Crear Tarea

CorrelationToken: Ingrese TaskToken

OwnerActivityName: Seleccione WssTaskActivity

Invoked: Ingrese CrearTarea_MethodInvoking y presione enter. El código del método será el siguiente:

private void CrearTarea_MethodInvoking(object sender, EventArgs e)

{

taskId = Guid.NewGuid();

CrearTarea_TaskProperties1.AssignedTo = this.strAsignadoA;

CrearTarea_TaskProperties1.Title = this.strTitulo;

CrearTarea_TaskProperties1.Description = this.strDescripcion;

CrearTarea_TaskProperties1.DueDate = this.dtDuración;

CrearTarea_TaskProperties1.SendEmailNotification = this.bEnviarNotificación;

}

TaskId:

Para configurar esta propiedad deberá ir al código de la actividad y declarar una variable pública llamada taskId.

public Guid taskId;

Luego regrese a la vista de diseño y en la propiedad TaskId de clic sobre el botón '…' y seleccione la variable que acaba de definir.

TaskProperties: De clic en el botón '…', luego en el tab Bind to a new member seleccione Create Field.

Paso B

(Name): Ingrese mientrasTareaNoCompletada

Condition: Seleccione Code Condition. Luego expanda la propiedad e ingrese el siguiente nombre para el método: CodeConditionMethod.

Una vez en el código agregue otro campo público:

public bool taskCompleted = false;

El método deberá quedar de la siguiente forma:

private void CodeConditionMethod(object sender, ConditionalEventArgs e)

{

e.Result = !taskCompleted;

}

Paso C

(Name): Ingrese CambiaTarea

CorrelationToken: Seleccione TaskToken

Invoked: Ingrese cambiaTarea_Invoked y presione enter. El código del método será el siguiente:

private void cambiaTarea_Invoked(object sender, ExternalDataEventArgs e)

{

string estado=cambiaTarea_AfterProperties1.ExtendedProperties[this.idCampoEstado].ToString();

if (estado != null)

{

if (estado.Equals("Completed"))

this.tareaCompletada = true;

}

AfterProperties: De clic en el botón '…', luego en el tab Bind to a new member seleccione Create Field.

BeforeProperties: De clic en el botón '…', luego en el tab Bind to a new member seleccione Create Field.

TaskId: De clic en el botón '…', y seleccione la propiedad TaskId de la actividad Crear Tarea.

Paso D

(Name): Ingrese TareaCompletada

CorrelationToken: Seleccione TaskToken

TaskId: De clic en el botón '…', y seleccione la propiedad TaskId de la actividad Crear Tarea.

Finalmente, compile el proyecto y registre la librería en el GAC y a partir de este momento podrá utilizar esta actividad personalizada en los flujos para MOSS 2007 que desarrolle con Visual Studio 2008.

[VSTS Team Architect Rosario April CTP] Cómo elaborar el diagrama de secuencia del inicializador de un WorkfFlow para SharePoint 2007

Francisco X. Fagas — Wed, 06 Aug 2008 14:33:00 GMT

En estos días me encuentro probando la aplicabilidad de los nuevos diagramas del Visual Studio "Rosario" Team Architect, y luego de algunas pruebas quise elaborar el diagrama de secuencia de la inicialización de los componentes para un flujo de trabajo que desarrollé para MOSS 2007, para esto realicé los siguientes pasos:

Importe la solución completa a mi máquina virtual de Rosario (April CTP) y lo abrí en VS "Rosario".
En el proyecto IG.DocumentMangement.WorkFlows (Este es el proyecto que contiene los flujos de trabajo), agregué un nuevo diagrama de secuencia de la siguiente forma:
1. Clic derecho sobre el proyecto, luego seleccionan Add -> New Item
2. Luego seleccionan la categoría general y en templates seleccionan sequence diagram, le asignan un nombre al diagrama y dan clic en Add.
3. Luego abren el Architecture Explorer (View -> Architecture Explorer)
4. En el Architecture Explorer van navegando desde la solución seleccionando Contains para que en la siguiente lista se muestre el contenido del componente(Solución - Proyecto - Clase - Miembros de clase) que seleccionaron en la lista anterior.
5. Una vez que han seleccionado el proyecto continúan seleccionando la clase, nuevamente contains para que puedan ver los métodos, seleccionamos el método InitializeComponent.
6. Finalmente seleccionan Insert Into Active Diagram y automáticamente VS generará la secuencia que sigue el método para construir los componentes que forman parte de su flujo de trabajo para MOSS 2007 :D. (Tip: dandole clic derecho sobre el área de trabajo del diseñador puede seleccionar la opción para exportar el diagrama como imagen, la cual estoy pegando a continuación).

[MOSS 2007 - VS 2008] Tip Workflows para MOSS 2007 con VS 2008

Francisco X. Fagas — Tue, 05 Aug 2008 11:37:00 GMT

Me he tenido que alejar un poco de mi blog debido a un proyecto en el que estado trabajando un Framework de Gestión Documental ISO para MOSS 2007 el cual ya lo pasé a producción y ahora tendré un poco más de tiempo hasta que me asignen a otro proyecto ;-), aunque ya llevo 1 año desarrollando aplicaciones para MOSS 2007 este proyecto en particular fue un reto debido a que ciertos requerimientos requerían implementar código complejo, por ejemplo el Framework es totalmente parametrizable ya que el sistema es capaz de soportar cualquier documento ya sea para ISO 9001, 14000, 22000 e incluso documentos no controlados (denominación para documentos que no forman parte del ningún sistema de gestión documental pero que se debe llevar un historial y debe estar habilitado para ejecutar acciones ISO), pero bueno cuando llegó el momento de la implementación del flujo de trabajo ningún flujo de MOSS 2007 ni con SharePoint Designer 2007 se podía implementar , se implementó un flujo utilizando la plantilla Sequential WorkFlow for SharePoint 2007 utilizando Visual Srudio 2008, ah y lo más importante es que la administración del ciclo de vida de desarrollo de este sistema se realizó con VISUAL STUDIO TEAM SYSTEM 2008 ;-), algunas consideraciones importantes que se debieron enfrentar en la implementación fueron:

El flujo en base a propiedades el documento debía ejecutar un flujo en serie o en paralelo.
Si los emisores eran los mismos que los aprobadores se debía aprobar automáticamente.
Los emisores, aprobadores y distribución del documento no eran usuarios de MOSS eran grupos de AD que reflejaban un rol, por ejemplo: el emisor podría ser: Asistente de RRHH, quien aprobaba era el Gerente de RRHH y un segundo aprobador Administrador de Documentación, y por último la distribución dependiendo de un campo del documento podría tomar de un campo llamado distribución del documento o leer los usuarios que tenían permisos sobre la carpeta que contenía el documento, de igual forma eran grupos del directorio activo.
Al final del flujo debía enviar notificación con el resultado de la aprobación a todos los involucrados: emisores, aprobadores y distribución.
La aprobación en serie era una aprobación en serie a nivel de grupos y en paralelo a nivel de usuarios, es decir, pensemos en un documento cuyos aprobadores son: GrupoA; Grupo B, al inicia el flujo en serie empezaría por el grupo a, y debería crear tareas de aprobación en paralelo para todos los usuarios que pertenecen al Grupo A, una vez que algún miembro de dicho grupo apruebe el flujo debería continuar al siguiente Grupo de aprobadores y hacer lo mismo que hizo para el Grupo anterior. Recordemos que los grupos son del AD.
La aprobación en paralelo consistía en ejecutar una aprobación en paralelo a nivel de usuarios, pero recordemos que los aprobadores son grupos de AD, por lo que el flujo debería crear tareas en paralelo los usuarios miembros de ambos grupos al mismo tiempo.

¿Interesantes requerimientos no?, pues a continuación algunos tips para trabajar con flujos de trabajo:

Las actividades básicas de aprobación de documentos se implementó en un proyecto de Activity Library de Windows WorkFlow Foundation. Recuerden en strong name para este tipo de proyectos ya que lo deben registrar en el GAC del servidor.
El proceso de aprobación como tal no estaba en el sequential workflow estaba en una librería del Framework el cual al invocar al constructor construía los objetos necesarios que se encontraban en la capa de entidades, objetos como por ejemplo: Grupo, Usuario, Documento.
Recuerden que cuando trabajen con workflows los objetos que declaren como globales ya sea para actividades personalizadas o para el propio flujo deben ser serializables, incluidos objetos de lógica del proceso. Esto no se encuentra documentado y pese a que las entidades eran serializables los objetos de proceso no lo eran esto ocasionó que el flujo no espere acción de los usuarios sobre las tareas debido a que los objetos de la capa de proceso no lo eran.
Para resolver el manejo de grupos, se utilizó utilitarios de la capa Core para conectarse al AD pasarle el grupo y que nos retorne sus miembros (usuarios que es con lo que trabaja MOSS 2007) con sus propiedades.
Para implementar tareas en paralelo utilicen el replicator configurado para que se ejecute en paralelo.
Para implementar tareas en serie pueden utilizar un replicator configurado en serie, o pueden utilizar una actividad while.

Espero que estos tips les sean de utilidad si algún momento deben implementar alguno de estos requerimientos.