Creación de editores de flujo de trabajo declarativos sin código
Última modificación: lunes, 28 de febrero de 2011
Hace referencia a: SharePoint Foundation 2010
El servicio web websvcWebPartPages de Microsoft SharePoint Foundation contiene métodos que permiten que un editor declarativo de flujo de trabajo sin código y basado en reglas, como Microsoft SharePoint Designer 2010, cree plantillas de flujo de trabajo y las asocie a listas de SharePoint específicas.
Estos métodos son:
Método FetchLegalWorkflowActions()
Use este método para obtener una lista específica del lenguaje de las acciones de flujo de trabajo válidas instaladas para SharePoint Foundation. De este modo, una aplicación creada para actuar como un editor de flujos de trabajo declarativo muestra las acciones en la interfaz de usuario correspondiente.
La lista devuelta es una lista combinada que engloba el contenido de todos los archivos .actions instalados en el servidor donde, de forma predeterminada, se enumeran en primer lugar las acciones de flujo de trabajo principal que se incluyen con SharePoint Foundation.
Para obtener más información acerca de las acciones de flujo de trabajo, consulte Introducción al flujo de trabajo de SharePoint Designer.
Método ValidateWorkflowMarkupAndCreateSupportObjects(String, String, String, String)
Use este método para validar el marcado de flujo de trabajo de un flujo de trabajo declarativo y, de forma opcional, crear los objetos necesarios para que el flujo de trabajo se ejecute. Esto incluye:
Crear la lista de tareas de flujo de trabajo, si no se especifica una lista de tareas en los datos de configuración de flujo de trabajo o si la lista de tareas especificada no existe.
Establecer los tipos de contenido de cada tarea de flujo de trabajo para el formulario de edición especificado.
El método toma los parámetros siguientes:
XML que representa un archivo de marcado de flujo de trabajo en formato XOML.
XML que representa un marcado de reglas de flujo de trabajo en formato RULES.
Para obtener más información acerca de los formatos de flujo de trabajo XOML y RULES, vea el tema sobre Windows Workflow Foundation.
XML que representa un archivo de configuración completo de flujo de trabajo que cumple el esquema de configuración de flujo de trabajo.
Para obtener más información acerca del esquema de configuración de flujo de trabajo, consulte Introducción al esquema de configuración de flujos de trabajo.
Un valor indicador que especifica si únicamente debe validarse el marcado de flujo de trabajo o si se debe validar el marcado de flujo de trabajo y también crear los objetos de compatibilidad.
Método AssociateWorkflowMarkup(String, String)
Use este método para crear una plantilla de flujo de trabajo y asociarla a la lista de SharePoint especificada.
Este método toma los parámetros siguientes:
La ruta de acceso al archivo de configuración del flujo de trabajo que se va a usar para este flujo de trabajo.
La versión del archivo de configuración del flujo de trabajo que se va a usar.
El archivo de configuración de flujos de trabajo contiene la información necesaria para crear una plantilla de flujo de trabajo en SharePoint Foundation a partir de los archivos especificados de marcado y reglas de flujo de trabajo, y para asociarla a una lista de SharePoint específica. Un archivo de configuración de flujo de trabajo contiene la información siguiente:
Los archivos de marcado y reglas de flujo de trabajo que se usarán, incluida la versión correcta de dichos archivos.
La lista de SharePoint a la que se asociará el flujo de trabajo.
La lista de tareas y el historial que usará el flujo de trabajo.
Condiciones necesarias para que se inicie el flujo de trabajo.
Ubicación del formulario de inicio del flujo de trabajo, de los campos de datos y de los valores predeterminados.
El archivo de configuración de flujo de trabajo debe cumplir el esquema de configuración de flujo de trabajo. Para obtener más información, consulte Introducción al esquema de configuración de flujos de trabajo.
Cuando la plantilla de flujo de trabajo declarativo se crea y se asocia a la lista especificada, los objetos SPWorkflowTemplate y SPWorkflowAssociation se crean para representar la plantilla de flujo de trabajo y asociación respectivamente. Para flujos de trabajo declarativos, la propiedad IsDeclarative de cada objeto se establece en True.
SharePoint Foundation incluye un compilador Just-In-Time para compilar el ensamblado de flujo de trabajo la primera vez que el flujo de trabajo se inicia en un elemento. SharePoint Foundation conserva el flujo de trabajo compilado en la memoria hasta que se le llama de nuevo, de forma parecida a las páginas ASPX compiladas en la memoria caché de los servidores para acelerar el rendimiento de la ejecución la siguiente vez que se llama a la página.
Cada vez que un flujo de trabajo se inicia en un elemento, SharePoint Foundation determina si el flujo de trabajo se implementó como un ensamblado o como un marcado declarativo. Si existe un ensamblado de flujo de trabajo, SharePoint Foundation llama a ese ensamblado para crear la instancia de flujo de trabajo. Si el flujo de trabajo se ha implementado como marcado declarativo, SharePoint Foundation determina después si ya tiene un ensamblado de flujo de trabajo compilado desde ese marcado en la memoria. Si lo tiene, SharePoint Foundation llama al flujo de trabajo compilado en memoria para crear la instancia de flujo de trabajo. En caso contrario, SharePoint Foundation usa su compilador Just-In-Time para compilar el marcado de flujo de trabajo en un flujo de trabajo en memoria al que llama después para crear la instancia de flujo de trabajo.
Para un sitio determinado, los flujos de trabajo declarativos deben almacenarse en una biblioteca de documentos de sitio denominada Flujos de trabajo. Los archivos de cada flujo de trabajo declarativo deben almacenarse en una carpeta independiente de la biblioteca de documentos de flujo de trabajo. Esto incluye el archivo de marcado de flujo de trabajo (.xoml), el archivo de reglas y el archivo de configuración de flujo de trabajo. Asimismo, se recomienda encarecidamente almacenar también los formularios de flujo de trabajo en la carpeta del flujo de trabajo.
Vea también
Conceptos
Desarrollo de flujos de trabajo para SharePoint Foundation
Introducción al esquema de configuración de flujos de trabajo