Información general sobre el modelo de objetos de flujo de trabajo de SharePoint Foundation
Última modificación: jueves, 15 de abril de 2010
Hace referencia a: SharePoint Foundation 2010
Después de implementar la solución de flujo de trabajo, puede usar el modelo de objetos de Microsoft SharePoint Foundation para consultar los procesos de flujo de trabajo y realizar acciones de flujo de trabajo mediante programación, como agregar un flujo de trabajo a una lista o iniciar un flujo de trabajo para un elemento.
Principales objetos Microsoft.SharePoint.Workflow
El espacio de nombres Microsoft.SharePoint.Workflow representa la funcionalidad de flujo de trabajo incluida en SharePoint Foundation.
El objeto SPWorkflowTemplateCollection representa las plantillas de flujo de trabajo implementadas actualmente en un sitio. Cada objeto SPWorkflowTemplate representa una plantilla de flujo de trabajo y contiene las propiedades que se pueden usar para obtener o establecer información acerca de la plantilla, como datos de creación de instancias y listas de historial y de tareas para la plantilla.
Para asociar un flujo de trabajo a una lista o biblioteca de documentos, use el método AddWorkflowAssociation del objeto SPList. Para asociar un flujo de trabajo con un tipo de contenido, use el método AddWorkflowAssociation del objeto SPContentType. Ambos métodos usan un objeto SPWorkflowAssociation y lo agregan a la lista o al tipo de contenido especificado, respectivamente. Para crear la asociación de flujo de trabajo adecuada, use el método CreateListAssociation, CreateListContentTypeAssociation o CreateSiteContentTypeAssociation del objeto SPWorkflowAssociation mismo.
Como ocurre al agregar un flujo de trabajo a través de la interfaz de usuario, cuando se asocia un flujo de trabajo mediante programación, se agrega una columna de estado para el flujo de trabajo a la lista.
El método RemoveWorkflowAssociation permite quitar una asociación de flujo de trabajo de una lista y el método RemoveWorkflowAssociation permite quitar una asociación de flujo de trabajo de un tipo de contenido de sitio o lista.
Cada objeto SPWorkflowAssociation representa una plantilla de flujo de trabajo asociada a una lista o tipo de contenido específicos y que contiene las propiedades que devuelven información personalizada sobre la asociación de ese flujo de trabajo con la lista o tipo de contenido específicos. Esta información incluye si el flujo de trabajo está habilitado, si se puede iniciar automáticamente y la lista o tipo de contenido al que se ha asociado.
El parámetro SPWorkflowCollection representa las instancias de flujo de trabajo que se han ejecutado o se están ejecutando actualmente en un elemento especificado de la lista. Cada objeto SPWorkflow contiene propiedades que devuelven información sobre la instancia de flujo de trabajo, como si el flujo de trabajo ha finalizado, su estado interno y su lista de historial de flujo de trabajo. Además, cada flujo de trabajo contiene una colección de las tareas para el flujo de trabajo, SPWorkflowTaskCollection.
Use la propiedad Workflows para devolver un objeto SPWorkflowCollection que representa los flujos de trabajo que se están ejecutando para ese elemento de lista.
Administración de instancias de flujo de trabajo en ejecución mediante programación
Los usuarios interactúan con los flujos de trabajo que se ejecutan en los elementos de forma individual, a través de la interfaz de usuario de SharePoint Foundation. Pero SharePoint Foundation proporciona funcionalidad para controlar de forma centralizada las instancias de flujos de trabajo en ejecución en la colección de sitios a través de todo el modelo de objetos. Use el objeto SPWorkflowManager para administrar las instancias de flujos de trabajo en ejecución en una colección de sitios. El objeto SPWorkflowManager no tiene ningún equivalente en la interfaz de usuario. Use el objeto SPWorkflowManager para:
Iniciar, ejecutar o cancelar flujos de trabajo.
Devolver todos los flujos de trabajo que se están ejecutando actualmente en un elemento específico.
Realizar otras operaciones de administración de flujo de trabajo.
Para iniciar manualmente un flujo de trabajo específico para un elemento (es decir, un flujo de trabajo que no está configurado para iniciarse automáticamente), use el método StartWorkflow(SPListItem, SPWorkflowAssociation, String) o StartWorkflow(SPListItem, SPWorkflowAssociation, String, Boolean).