GuilleSQL :: Microsoft SQL Server, SSIS, y más !!

Crear formularios ASPX de Asociación e Iniciación para Workflows de SharePoint 2010 con Visual Studio 2010


El presente artículo describe paso a paso como crear un Workflow Secuencial para SharePoint 2010 que incluya formularios ASPX de Asociación (Association Form) e Iniciación  (Initiation Form) utilizando Visual Studio 2010, un caso típico (y quizás el más sencillo) de programación de Workflows con formularios para SharePoint.

Introducción

Como continuación a los anteriores artículos de Introducción a los Workflows Secuenciales con Tareas y Formularios en Visual Studio 2010 para SharePoint 2010 y Cómo crear un Workflow con Tareas en Visual Studio 2010, en esta ocasión vamos a realizar un ejercicio práctico de programación de un Workflow Secuencial con formularios, en particular utilizando formularios ASPX de Asociación (Association Form) e Iniciación  (Initiation Form) utilizando Visual Studio 2010.  Recordemos brevemente para qué sirven estos dos tipos de formularios.

  • Formularios de asociación (Workflow Association Form). Se muestran en el momento en que se asocia el Workflow al Site o Lista correspondiente. Permiten, por ejemplo, que un adminitrador pueda parametrizar el Workflow (ej: establecer un límite para la Aprobación automática, en un Workflow de Aprobación de gastos) en el momento de su asociación.
  • Formularios de iniciación (Workflow Initiation Form). Se muestran al iniciar la ejecución de un Workflow, lo cual resulta útil en Workflows de Sitio y en Workflows de Lista que no se inician automáticamente, permitiendo que un usuario pueda configurar parámetros del Workflow incluso para sobrescribir los parámetros especificados por el administrador.

La creación de un Workflow con formularios ASPX de Asociación y/o Iniciación es francamente sencilla. Los principales detalles que deberemos tener en cuenta para tal menester son:

  • Se pueden agregar directamente desde Visual Studio 2010 y están totalmente integrados en Visual Studio. No es necesario modificar manualmente el fichero Elements.xml del Workflow para indicar la URL de los formularios (atributos AssociationURL e InstantiationURL), ya que Visual Studio lo realizará de manera automática por nosotros.
  • Los formularios ASPX incluidos por Visual Studio 2010 incluyen algo de código fuente, como los botones de Associate Workflow y Cancel en el caso de formularios de Asociación, y los botones Start Workflow y Cancel en el caso de los formularios de Iniciación. Del mismo modo incluye el código fuente mínimo necesario en el Code Behind.
  • Los formularios ASPX de Asociación incluyen un método GetAssociationData que devuelve un valor String, y que se utiliza para devolver la información deseada desde el formulario al Workflow. Del mismo modo, si durante la iniciación del formulario se desea inicializar sus campos con algún valor en particular, es posible utilizar el método PopulateFormFields.
  • Los formularios ASPX de Iniciación incluyen un método GetInitiationData que devuelve un valor String, y que se utiliza para devolver la información deseada desde el formulario al Workflow. Del mismo modo, si durante la iniciación del formulario se desea inicializar sus campos con algún valor en particular, es posible utilizar el evento Page_Load.
  • Desde el evento Page_Load de un formulario ASPX de Inicialización podemos acceder a la información introducida en el formulario ASPX de Asociación, tal y como veremos más adelante en este mismo artículo.
  • Dentro del Workflow podemos acceder en cualquier momento al información devuelta por los formularios ASPX de Asociación e Iniciación utilizando las propiedades AssociationData e InitiationData del objeto workflowProperties (es decir, workflowProperties.AssociationData y workflowProperties.InitiationData) ambas de tipo String.

Además, los formularios ASPX funcionan en cualquier versión de SharePoint 2010, no sólo en SharePoint Server 2010, sino también en SharePoint Foundation 2010 (la edición gratuita, continuación de WSS3), una ventaja muy interesante en comparación con los formularios desarrollados con InfoPath. Por desgracia, no está disponible la vista Diseño de los formularios ASPX, por lo que deberemos desarrollar escribiendo directamente código HTML y el Code Behind.

Dicho todo esto, vamos a empezar con nuestro ejercicio práctico.

Crear un Workflow con formularios ASPX de Asociación e Iniciación

Abriremos Visual Studio 2010 y crearemos un proyecto de tipo Sequential Workflow para SharePoint 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, y NO asociaremos el Workflow con ninguna lista.

Una vez creado nuestro Proyecto de Visual Studio 2010 (que contendrá un Workflow vacío) vamos a crear un formulario ASPX de Asociación, para lo cual deberemos hacer click con el botón derecho sobre el nodo Workflow1 en el Solution Explorer, para seguidamente, seleccionar la opción New Item del menú Add.

Una vez creado nuestro Proyecto de Visual Studio 2010 (que contendrá un Workflow vacío) vamos a crear un formulario ASPX de Asociación, para lo cual deberemos hacer click con el botón derecho sobre el nodo Workflow1 en el Solution Explorer, para seguidamente, seleccionar la opción New Item del menú Add.

En la ventana Add New Item, seleccionaremos la opción Workflow Association Form, y especificaremos el nombre deseado para dicho formulario ASPX. Click Add para continuar.

En la ventana Add New Item, seleccionaremos la opción Workflow Association Form, y especificaremos el nombre deseado para dicho formulario ASPX. Click Add para continuar.

Si nos fijamos en el fichero Elements.xml del Workflow, podremos observar que se ha añadido el atributo AssociationUrl al tag Workflow, conforme al formulario ASPX que acabamos de añadir.

Si nos fijamos en el fichero Elements.xml del Workflow, podremos observar que se ha añadido el atributo AssociationUrl al tag Workflow, conforme al formulario ASPX que acabamos de añadir.

A continuación deberemos editar la Página ASPX que acabamos de crear, para escribir el código HTML deseado dentro del contenedor PlaceHolderMain, tal y como se muestra en la siguiente pantalla capturada.

A continuación deberemos editar la Página ASPX que acabamos de crear, para escribir el código HTML deseado dentro del contenedor PlaceHolderMain, tal y como se muestra en la siguiente pantalla capturada.

Ahora mostraremos el código fuente de la Página ASPX que acabamos de crear, es decir, el código Behind. En nuestro caso, nos limitaremos a codificar el método GetAssociationData, para que devuelva la información que deseamos desde el formulario ASPX al Workflow (ojo, que sólo es un String).

Ahora mostraremos el código fuente de la Página ASPX que acabamos de crear, es decir, el código Behind. En nuestro caso, nos limitaremos a codificar el método GetAssociationData, para que devuelva la información que deseamos desde el formulario ASPX al Workflow (ojo, que sólo es un String).

Ahora vamos a crear nuestro formulario ASPX de Iniciación, para lo cual, igual que hicimos antes, deberemos hacer click con el botón derecho sobre el nodo Workflow1 en el Solution Explorer, para seguidamente, seleccionar la opción New Item del menú Add.

Ahora vamos a crear nuestro formulario ASPX de Iniciación, para lo cual, igual que hicimos antes, deberemos hacer click con el botón derecho sobre el nodo Workflow1 en el Solution Explorer, para seguidamente, seleccionar la opción New Item del menú Add.

En la ventana Add New Item, seleccionaremos la opción Workflow Initiation Form, y especificaremos el nombre deseado para dicho formulario ASPX. Click Add para continuar.

En la ventana Add New Item, seleccionaremos la opción Workflow Initiation Form, y especificaremos el nombre deseado para dicho formulario ASPX. Click Add para continuar.

Si nos fijamos de nuevo en el fichero Elements.xml del Workflow, podremos observar que se ha añadido el atributo InstantiationUrl al tag Workflow, conforme al formulario ASPX que acabamos de añadir.

Si nos fijamos de nuevo en el fichero Elements.xml del Workflow, podremos observar que se ha añadido el atributo InstantiationUrl al tag Workflow, conforme al formulario ASPX que acabamos de añadir.

A continuación deberemos editar la Página ASPX que acabamos de crear, para escribir el código HTML deseado dentro del contenedor PlaceHolderMain, tal y como se muestra en la siguiente pantalla capturada.

A continuación deberemos editar la Página ASPX que acabamos de crear, para escribir el código HTML deseado dentro del contenedor PlaceHolderMain, tal y como se muestra en la siguiente pantalla capturada.

Ahora mostraremos el código fuente de la Página ASPX que acabamos de crear, es decir, el código Behind. En nuestro caso, nos limitaremos a codificar el método GetInitiationData y el evento PageLoad, para que se devuelva la información que deseamos del formulario ASPX al Workflow (ojo, que sólo es un String) y para inicializar los Controles de nuestro formulario ASPX. Téngase en cuenta, que en nuestro ejemplo vamos inicializar un campo del formulario de Inicialización en función de los datos introducidos en el formulario de Asociación.

Ahora mostraremos el código fuente de la Página ASPX que acabamos de crear, es decir, el código Behind. En nuestro caso, nos limitaremos a codificar el método GetInitiationData y el evento PageLoad, para que se devuelva la información que deseamos del formulario ASPX al Workflow (ojo, que sólo es un String) y para inicializar los Controles de nuestro formulario ASPX. Téngase en cuenta, que en nuestro ejemplo vamos inicializar un campo del formulario de Inicialización en función de los datos introducidos en el formulario de Asociación.

Realizado esto, deberemos editar el Workflow en modo diseño para agregar las siguientes actividades: Una actividad IfElse, con una actividad CreateTask en una rama y una actividad LogToHistoryLog en la otra rama. Suficiente, para el objetivo didáctico del presente artículo. Con esto, el Workflow tendrá un aspecto similar al siguiente.

Realizado esto, deberemos editar el Workflow en modo diseño para agregar las siguientes actividades: Una actividad IfElse, con una actividad CreateTask en una rama y una actividad LogToHistoryLog en la otra rama. Suficiente, para el objetivo didáctico del presente artículo. 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. Seguidamente, para la propiedad TaskId crearemos una nueva variable (Create Field) que llamaremos taskId, y para la propiedad TaskProperties crearemos una nueva variable (Create Field) que llamaremos taskProperties. En la siguiente pantalla capturada se muestra como quedan configuradas las Propiedades de la actividad createTask1. Para más información, es conveniente consultar el artículo Cómo crear un Workflow con Tareas en Visual Studio 2010.

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. Seguidamente, para la propiedad TaskId crearemos una nueva variable (Create Field) que llamaremos taskId, y para la propiedad TaskProperties crearemos una nueva variable (Create Field) que llamaremos taskProperties. En la siguiente pantalla capturada se muestra como quedan configuradas las Propiedades de la actividad createTask1. Para más información, es conveniente consultar el artículo Cómo crear un Workflow con Tareas en Visual Studio 2010.

Para continuar, seleccionaremos la opción Generate Handlers del menú contextual de la actividad createTask1. Escribiremos el código fuente del evento MethodInvoking y también escribiremos el método checkApprovalNeeded. Fíjese que el método checkApprovalNeeded accede a los valores introducidos en ambos formularios (Iniciación y Asociación) a través del objeto workflowProperties.

Para continuar, seleccionaremos la opción Generate Handlers del menú contextual de la actividad createTask1. Escribiremos el código fuente del evento MethodInvoking y también escribiremos el método checkApprovalNeeded. Fíjese que el método checkApprovalNeeded accede a los valores introducidos en ambos formularios (Iniciación y Asociación) a través del objeto workflowProperties.

En las Propiedades de la actividad IfElseBranchActivity, deberemos configurar la propiedad Condition con el valor Code Condition y especificar como condición el método checkApprovalNeeded, tal y como se muestra en la siguiente pantalla capturada.

En las Propiedades de la actividad IfElseBranchActivity, deberemos configurar la propiedad Condition con el valor Code Condition y especificar como condición el método checkApprovalNeeded, tal y como se muestra en la siguiente pantalla capturada.

Ahora seleccionaremos la opción Generate Handlers del menú contextual de la actividad LogToHistoryListActivity1 y escribiremos el código fuente del evento MethodInvoking.

Ahora seleccionaremos la opción Generate Handlers del menú contextual de la actividad LogToHistoryListActivity1 y escribiremos el código fuente del evento MethodInvoking.

Realizado esto, ya habremos finalizado el desarrollo de nuestro Workflow Secuencial con formularios ASPX de Asociación e Iniciación. Tan sólo queda probarlo.

Probando los formularios ASPX de nuestro Workflow

No nos complicaremos mucho, pero al menos que podamos ver cómo quedan los formularios que acabamos de desarrollar. Pulsaremos F5 en Visual Studio para compilar, desplegar y ejecutar nuestro pequeño desarrollo. Una vez arrancado Internet Explorer, navegaremos hasta la librería Shared Documents y la asociaremos el Workflow que acabamos de crear, lo cual, nos mostrará nuestro formulario de asociación.

No nos complicaremos mucho, pero al menos que podamos ver cómo quedan los formularios que acabamos de desarrollar. Pulsaremos F5 en Visual Studio para compilar, desplegar y ejecutar nuestro pequeño desarrollo. Una vez arrancado Internet Explorer, navegaremos hasta la librería Shared Documents y la asociaremos el Workflow que acabamos de crear, lo cual, nos mostrará nuestro formulario de asociación.

Realizado esto, seleccionaremos un documento de la Librería (Item), y click en el botón Workflows de la botonera (Ribbon).

Realizado esto, seleccionaremos un documento de la Librería (Item), y click en el botón Workflows de la botonera (Ribbon).

Click sobre el Workflow que queremos asociar con el documento seleccionado, es decir, el Workflow Secuencial que acabamos de desarrollar.

Click sobre el Workflow que queremos asociar con el documento seleccionado, es decir, el Workflow Secuencial que acabamos de desarrollar.

Con esto, se mostrará el formulario ASPX de Iniciación, tal y como se muestra en la siguiente pantalla capturada.

Crear_formularios_ASPX_Asociacion_Iniciacion_Show_Initiation_Form.jpg

Conclusiones y Despedida

Como se ha podido ver a lo largo del presente artículo, el desarrollo de formularios ASPX de Asociación y de Iniciación en Workflows, es una tarea bastante sencilla, que en función de nuestras habilidades de programación en ASP.NET, nos puede permitir desarrollar formularios muy potentes capaces de ejecutarse tanto en SharePoint Server con en SharePoint Foundation, siendo esta quizás la principal ventaja frente al desarrollo de formularios con InfoPath.

Antes de acabar, aprovecho para incluir un par de enlaces de interés, que han sido la principal fuente de este artículo:

Y por supuesto, como era de esperar, también quería incluir el código fuente de ejemplo.

Descargar ZIP con el proyecto de ejemplo sobre Cómo crear formularios ASPX de Asociación e Iniciación para Workflows de SharePoint 2010 con Visual Studio 2010 (WorkflowProjectASPXInitiationAssociationForms.zip)

Poco más por hoy. Como siempre, confío que la lectura resulte de interés.

 


[Fecha del Artículo (UTC): 19/11/2012]
[Autor: GuilleSQL]



Escribir un Comentario

Para poder escribir un comentario, debe Iniciar Sesión con un usuario.

Si no dispone de un usuario, puede Registrarse y hacerse miembro.

Si dispone de un usuario, pero no recuerda sus credenciales de acceso, puede Restablecer su Contraseña.

Miembros de
Miembros de GITCA (Global IT Community Association)

Menu de Usuario
  Iniciar Sesión
  Registrarse
  Restablecer Contraseña
  Ventajas de Registrarse

Acerca de
  Contigo desde Oct 2007
  771 usuarios registrados
  86146 pageloads/mes
  Ranking Alexa 498160

Social Networks
Sigue a Portal GuilleSQL en Linkedin !!
Sigue a Portal GuilleSQL en Twitter !!



Archivo

Enero de 2017 (4)
Junio de 2016 (1)
Mayo de 2016 (2)
Abril de 2016 (2)
Septiembre de 2015 (2)
Agosto de 2015 (2)
Junio de 2015 (10)
Mayo de 2015 (4)
Abril de 2015 (8)
Marzo de 2015 (11)
Octubre de 2014 (3)
Septiembre de 2014 (7)
Agosto de 2014 (5)
Julio de 2014 (2)
Mayo de 2014 (4)
Abril de 2014 (4)
Marzo de 2014 (4)
Febrero de 2014 (1)
Enero de 2014 (5)
Diciembre de 2013 (8)
Noviembre de 2013 (2)
Octubre de 2013 (7)
Septiembre de 2013 (6)
Agosto de 2013 (1)
Julio de 2013 (6)
Junio de 2013 (11)
Mayo de 2013 (7)
Abril de 2013 (6)
Febrero de 2013 (5)
Enero de 2013 (7)
Diciembre de 2012 (12)
Noviembre de 2012 (13)
Octubre de 2012 (5)
Septiembre de 2012 (3)
Agosto de 2012 (6)
Julio de 2012 (4)
Junio de 2012 (1)
Mayo de 2012 (2)
Abril de 2012 (7)
Marzo de 2012 (16)
Febrero de 2012 (9)
Enero de 2012 (5)
Diciembre de 2011 (10)
Noviembre de 2011 (10)
Octubre de 2011 (4)
Septiembre de 2011 (5)
Agosto de 2011 (2)
Julio de 2011 (2)
Junio de 2011 (4)
Mayo de 2011 (2)
Abril de 2011 (6)
Marzo de 2011 (4)
Febrero de 2011 (10)
Enero de 2011 (5)
Diciembre de 2010 (6)
Noviembre de 2010 (4)
Octubre de 2010 (8)
Septiembre de 2010 (4)
Agosto de 2010 (1)
Julio de 2010 (3)
Mayo de 2010 (5)
Abril de 2010 (6)
Marzo de 2010 (8)
Febrero de 2010 (3)
Enero de 2010 (1)
Diciembre de 2009 (9)
Noviembre de 2009 (14)
Octubre de 2009 (2)
Septiembre de 2009 (8)
Agosto de 2009 (2)
Julio de 2009 (10)
Junio de 2009 (9)
Mayo de 2009 (10)
Abril de 2009 (9)
Marzo de 2009 (3)
Febrero de 2009 (2)
Enero de 2009 (3)
Noviembre de 2008 (2)
Octubre de 2008 (2)
Septiembre de 2008 (2)
Agosto de 2008 (5)
Julio de 2008 (5)
Junio de 2008 (1)
Mayo de 2008 (3)
Abril de 2008 (2)
Marzo de 2008 (2)
Febrero de 2008 (2)
Enero de 2008 (5)
Noviembre de 2007 (2)
Octubre de 2007 (2)






Esta información se proporciona "como está" sin garantías de ninguna clase, y no otorga ningún derecho.
This information is provided "AS IS" with no warranties, and confers no rights.

Copyright © 2007 GuilleSQL, todos los derechos reservados.
GuilleSQL.com y GuilleSQL.net son también parte de Portal GuilleSQL.

Visitas recibidas (Page Loads) en GuilleSQL (fuente: StatCounter):

screen resolution stats
Visitas