Tutorial: Crear y depurar una solución de flujo de trabajo de SharePoint

Artículo
02/19/2013

En este tutorial se muestra cómo crear una plantilla de flujo de trabajo secuencial básica.El flujo de trabajo comprueba una propiedad de una biblioteca de documentos compartidos para determinar si se ha revisado un documento.Si se ha revisado el documento, el flujo de trabajo finaliza.

En este tutorial se muestran las tareas siguientes:

Crear un proyecto de flujo de trabajo secuencial de definición de lista de SharePoint en Visual Studio.
Crear actividades de flujo de trabajo.
Controlar eventos de actividad de flujo de trabajo.

[!NOTA]

Aunque en este tutorial se utiliza un proyecto de flujo de trabajo secuencial, el proceso es idéntico para un proyecto de flujo de trabajo de máquina de estados.

También es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones.La edición de Visual Studio que tenga y la configuración que esté usando determinan estos elementos.Para obtener más información, vea Valores de configuración de Visual Studio.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

Ediciones compatibles de Microsoft Windows y SharePoint.Para obtener más información, vea Requisitos para desarrollar soluciones de SharePoint.
Visual Studio.

Agregar propiedades a la biblioteca de documentos compartidos de SharePoint

Para hacer el seguimiento del estado de la revisión de documentos de la biblioteca Documentos compartidos, crearemos tres nuevas propiedades para documentos compartidos en nuestro sitio de SharePoint: Status, Assignee y Review Comments.Definimos estas propiedades en la biblioteca Documentos compartidos.

Para agregar propiedades a la biblioteca de documentos compartidos de SharePoint

Abra un sitio de SharePoint, como http://<nombre sistema>/SitePages/Home.aspx, en un explorador web.
En la barra de inicio rápido, elija compartidoDocumentos.
Elija Biblioteca en la cinta de opciones de Herramientas de biblioteca y elija el botón de cree la columna en la cinta de opciones para crear una nueva columna.
Llame al estado de documento de la columna, establezca su tipo en Opción (menú del que elegir), especifique las tres opciones siguientes, y elija el botón de Aceptar :
- Revisión necesaria
- Revisión completada
- Cambios solicitados
Cree dos columnas más y asígneles los nombres Assignee y Review Comments.Establezca el tipo de la columna Assignee como una línea de texto única y el tipo de la columna Review Comments como varias líneas de texto.

Permitir que los documentos se editen sin requerir la desprotección

Es más fácil probar la plantilla de flujo de trabajo si puede editar los documentos sin tener que desprotegerlos.En el procedimiento siguiente, se configura el sitio de SharePoint para habilitar esa posibilidad.

Para permitir que los documentos se editen sin desprotegerlos

En la barra de inicio rápido, elija el vínculo de Documentos compartidos .
En la cinta de opciones de Herramientas de biblioteca , elija la pestaña de Biblioteca , y elija el botón de Valores de biblioteca para mostrar la página de Configuración de la biblioteca de documentos .
En la sección de Configuración general , elija el vínculo de Valores de versión para mostrar la página de Valores de versión .
Compruebe que el valor de Solicitar que los documentos estén desprotegidos para poder modificarlos sea No.Si no, cámbiela a no y elija el botón de Aceptar .
Cierre el explorador.

Crear un proyecto de flujo de trabajo secuencial de SharePoint

Un flujo de trabajo secuencial es una sucesión de pasos que se ejecutan en orden hasta que finaliza la última actividad.En este procedimiento, creamos un flujo de trabajo secuencial que se aplicará a nuestra lista Documentos compartidos.El asistente de flujo de trabajo permite asociar el flujo de trabajo con la definición de sitio o la definición de lista, y le permite determinar cuando se iniciará el flujo de trabajo.

Para crear un proyecto de flujo de trabajo secuencial de SharePoint

Inicie Visual Studio.
En la barra de menú, elija Archivo, Nuevo, Proyecto para mostrar el cuadro de diálogo de Nuevo proyecto .
Expanda el nodo de SharePoint en Visual C# o Visual Basicy, a continuación el nodo de 2010 .
En el panel de Plantillas , elija la plantilla de Proyecto de SharePoint 2010 .
En el cuadro de Nombre , entre en MySharePointWorkflow y elija el botón de Aceptar .

Aparece el Asistente para la personalización de SharePoint.
En la página de Especifique el sitio y el nivel de seguridad de la depuración , elija el botón de opción de Implementar como solución de granja de servidores , y elija el botón de Finalizar para aceptar el nivel de confianza y el sitio predeterminado.

Este paso también establece el nivel de confianza para la solución como una solución de granja de servidores, la única opción disponible para los proyectos de flujo de trabajo.Para obtener más información, vea Consideraciones sobre las soluciones en espacio aislado.
En Explorador de soluciones, elija el nodo de proyecto y, a continuación, en la barra de menús, elija Proyecto, Agregar nuevo elemento.
En Visual C# o Visual Basic, expanda el nodo de SharePoint y, a continuación el nodo de 2010 .
En el panel de Plantillas , elija la plantilla de Flujo de trabajo secuencial (solución de granja de servidores únicamente) , y elija el botón de Agregar .

Aparece el Asistente para la personalización de SharePoint.
En la página Especifique el nombre del flujo de trabajo de depuración, acepte el nombre predeterminado (MySharePointWorkflow - Workflow1).Mantenga el valor del tipo predeterminado de la plantilla de flujo de trabajo, Flujo de trabajo de lista, y elija el botón de Siguiente .
En la página de ¿Tiene como Visual Studio automáticamente para asociar el flujo de trabajo en una sesión de depuración? , elija el botón de Siguiente para aceptar toda la configuración predeterminada.

Este paso asocia automáticamente el flujo de trabajo a la biblioteca Documentos compartidos.
En la página de Especifique las condiciones de inicio del flujo de trabajo , deje seleccionadas las opciones predeterminadas en la sección de Cómo desea que se inicie el flujo de trabajo? y elija el botón de Finalizar .

Esta página permite especificar cuándo se inicia el flujo de trabajo.De forma predeterminada, el flujo de trabajo se inicia cuando un usuario lo inicia manualmente en SharePoint o cuando se crea un elemento con el que está asociado el flujo de trabajo.

Crear actividades de flujo de trabajo

Los flujos de trabajo contienen una o más actividades que representan las acciones que se van a llevar a cabo.Utilice el diseñador de flujo de trabajo para organizar las actividades de un flujo de trabajo.En este procedimiento, agregaremos dos actividades al flujo de trabajo: HandleExternalEventActivity y OnWorkFlowItemChanged.Estas actividades supervisan el estado de la revisión de documentos en la lista Documentos compartidos

Para crear actividades de flujo de trabajo

El flujo de trabajo se debería mostrar en el diseñador de flujo de trabajo.Si no, abra Workflow1.cs o Workflow1.vb en Explorador de soluciones.
En el diseñador, elija la actividad de OnWorkflowActivated1 .
En la ventana de Propiedades , escriba onWorkflowActivated junto a la propiedad de invocado , y elija la tecla ENTRAR.

El Editor de código se abre y un método de control de eventos denominado onWorkflowActivated se agrega al archivo de código de Workflow1.
Vuelva al diseñador de flujo de trabajo, abra el cuadro de herramientas y, a continuación, expanda el nodo Windows Workflow v3.0.
En el nodo de Windows workflow v3.0 de Cuadro de herramientas, realice uno de los siguientes conjuntos de pasos:
1. Abrir el menú contextual de la actividad de Mientras y, a continuación Copiar.En el diseñador de flujo de trabajo, abra el menú contextual para la línea bajo la actividad de onWorkflowActivated1 y, a continuación Pegar.
2. Arrastre la actividad de Mientras de Cuadro de herramientas el diseñador de flujo de trabajo, y conectar la actividad a la línea bajo la actividad de onWorkflowActivated1 .
Elija la actividad de WhileActivity1 .
En la ventana de Propiedades , establezca Condición para codificar la condición.
Expanda la propiedad de Condición , escriba isWorkflowPending junto a la propiedad secundaria de Condición y, a continuación la tecla ENTRAR.

Se abre el Editor de código y se agrega el método isWorkflowPending al archivo de código de Workflow1.
Vuelva al diseñador de flujo de trabajo, abra el cuadro de herramientas y, a continuación, expanda el nodo Flujo de trabajo de SharePoint.
En el nodo de Flujo de trabajo de SharePoint de Cuadro de herramientas, realice uno de los siguientes conjuntos de pasos:
- Abrir el menú contextual de la actividad de OnWorkflowItemChanged y, a continuación Copiar.En el diseñador de flujo de trabajo, abra el menú contextual para la línea dentro de la actividad de whileActivity1 y, a continuación Pegar.
- Arrastre la actividad de OnWorkflowItemChanged de Cuadro de herramientas el diseñador de flujo de trabajo, y conectar la actividad a la línea dentro de la actividad de whileActivity1 .
Elija la actividad de onWorkflowItemChanged1 .
En la ventana Propiedades, establezca las propiedades tal y como se indica en la tabla siguiente.

Propiedad.

Valor

CorrelationToken

workflowToken

Invoked

onWorkflowItemChanged

Propiedad.	Valor
CorrelationToken	workflowToken
Invoked	onWorkflowItemChanged

Controlar eventos de actividad

Finalmente, compruebe el estado del documento en cada actividad.Si el documento se ha revisado, el flujo de trabajo termina.

Para controlar eventos de actividad

En Workflow1.cs o Workflow1.vb, agregue el campo siguiente a la parte superior de la clase Workflow1.Utilizará este campo en una actividad para determinar si el flujo de trabajo ha finalizado.
```
Dim workflowPending As Boolean = True
```
```
Boolean workflowPending = true;
```
Agregue el método siguiente a la clase Workflow1.Este método comprueba el valor de la propiedad Document Status de la lista Documentos para determinar si el documento se ha revisado.Si la propiedad Document Status está establecida en Review Complete, el método checkStatus establecerá el campo workflowPending en false para indicar que el flujo de trabajo está listo para finalizar.
```
Private Sub checkStatus()
    If CStr(workflowProperties.Item("Document Status")) = "Review Complete" Then
        workflowPending = False
    End If
End Sub 
```
```
private void checkStatus()
{
    if ((string)workflowProperties.Item["Document Status"] == "Review Complete")
    workflowPending = false;
}
```
Agregue el código siguiente a los métodos onWorkflowActivated y onWorkflowItemChanged para llamar al método checkStatus.Cuando el flujo de trabajo se inicia, el método onWorkflowActivated llama al método checkStatus para determinar si ya se ha revisado el documento.Si no se ha revisado, el flujo de trabajo continúa.Cuando se guarda el documento, el método onWorkflowItemChanged llama de nuevo al método checkStatus para determinar si se ha revisado el documento.Mientras el campo workflowPending esté establecido en true, el flujo de trabajo continuará ejecutándose.
```
Private Sub onWorkflowActivated(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub

Private Sub onWorkflowItemChanged(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub
```
```
private void onWorkflowActivated(object sender, ExternalDataEventArgs e)
{
    // Check the status.
    checkStatus();
}

private void onWorkflowItemChanged(object sender, ExternalDataEventArgs e)
{
    // Check the status.
    checkStatus();
}
```
Agregue el código siguiente al método isWorkflowPending para comprobar el estado de la propiedad workflowPending.Cada vez que se guarda el documento, la actividad whileActivity1 llama al método isWorkflowPending.Este método examina la propiedad Result del objeto ConditionalEventArgs para determinar si la actividad WhileActivity1 debería continuar o finalizar.Si la propiedad se establece en true, la actividad continúa.De lo contrario, la actividad finaliza y el flujo de trabajo también finaliza.
```
Private Sub isWorkflowPending(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ConditionalEventArgs)
    e.Result = workflowPending
End Sub
```
```
private void isWorkflowPending(object sender, ConditionalEventArgs e)
{
    e.Result = workflowPending;
}
```
Guarde el proyecto.

Probar la plantilla de flujo de trabajo de SharePoint

Al iniciar el depurador, Visual Studio implementa la plantilla de flujo de trabajo en el servidor de SharePoint y asocia la plantilla de flujo de trabajo con la lista Documentos compartidos.Para probar el flujo de trabajo, inicie una instancia de la plantilla de flujo de trabajo desde un documento de la lista Documentos compartidos.

Para probar la plantilla de flujo de trabajo de SharePoint

En Workflow1.cs o Workflow1.vb, establezca un punto de interrupción junto al método onWorkflowActivated.
Elija la tecla F5 para compilar y ejecutar la solución.

Aparecerá el sitio de SharePoint.
En el panel de navegación de SharePoint, elija el vínculo de Documentos compartidos .
En la página de Documentos compartidos , elija el vínculo de Documentos en la pestaña de Herramientas de biblioteca , y elija el botón de Cargar documento .
En el cuadro de diálogo de Cargar documento , elija el botón de Examinar , elija cualquier archivo de documento, elija el botón de Abrir , y elija el botón de Aceptar .

Esto carga el documento seleccionado en la lista Documentos compartidos e inicia el flujo de trabajo.
En Visual Studio, compruebe que el depurador se detiene en el punto de interrupción a continuación del método onWorkflowActivated.
Elija la tecla F5 para continuar la ejecución.
Puede cambiar los valores del documento aquí, pero los deja en los valores predeterminados por ahora eligiendo el botón de Guardar .

Esto le devolverá a la página Documentos compartidos del sitio web predeterminado de SharePoint.
En la página de Documentos compartidos , compruebe que el valor bajo la columna de MySharePointWorkflow – Workflow1 está establecido en En curso.Esto indica que el flujo de trabajo está en curso y que el documento está esperando la revisión.
En la página de Documentos compartidos , elija el documento, elija la flecha que aparece, y después elija el elemento de menú de Editar propiedades .
Establezca estado de documento a Revisión completada, y elija el botón de Guardar .

Esto le devolverá a la página Documentos compartidos del sitio web predeterminado de SharePoint.
En la página de Documentos compartidos , compruebe que el valor bajo la columna de estado de documento está establecido en Revisión completada.Actualice la página de Documentos compartidos y compruebe que el valor bajo la columna de MySharePointWorkflow – Workflow1 está establecido en Completado.Esto indica que el flujo de trabajo ha finalizado y que el documento se ha revisado.

Pasos siguientes

Puede aprender más acerca de la creación de plantillas de flujo de trabajo en estos temas:

Para obtener más información sobre las actividades de flujo de trabajo de SharePoint, vea Workflow Activities for SharePoint Foundation.
Para obtener más información sobre las actividades de Windows Workflow Foundation, vea System.Workflow.Activities (Espacio de nombres).

Vea también

Otros recursos

Crear soluciones de flujo de trabajo de SharePoint

Plantillas de proyecto y de elementos de proyecto de SharePoint

Compilar y depurar soluciones de SharePoint

Compartir a través de