Hol7 Manual Cs

Introduccin para el

programador de

SharePoint

Laboratorio prctico

Manual del laboratorio

SPCHOL305 - Desarrollar un flujo de trabajo de SharePoint 2010 con un formulario de iniciacin en Visual Studio 2010 - C#

Este documento se proporciona tal cual. Es posible que la informacin y los puntos de vista reflejados en este

documento, incluidas la direccin URL y otras referencias a sitios web de Internet, cambien sin previo aviso. El

usuario asume el riesgo de su uso.

Este documento no proporciona ningn derecho legal sobre la propiedad intelectual e industrial de ningn

producto de Microsoft. Este documento puede copiarse y usarse para fines internos y de referencia.

2010 Microsoft. Todos los derechos reservados.

Pgina 1

Contenido

SPCHOL 305 DESARROLLAR UN FLUJO DE TRABAJO DE SHAREPOINT 2010 CON UN FORMULARIO

DE INICIACIN .......................................................................................................................................................... 2 Objetivo del laboratorio .......................................................................................................................................... 2 Recursos adicionales ............................................................................................................................................. 2 Introduccin ............................................................................................................................................................ 2

Iniciar sesin en la mquina virtual .................................................................................................................... 2 Ubicaciones........................................................................................................................................................ 2 Requisitos previos para el laboratorio ............................................................................................................... 3 Copiar las muestras de cdigo desde un documento de Word ......................................................................... 3 Fragmentos de cdigo ....................................................................................................................................... 4

Ejercicio 1 ............................................................................................................................................................... 5 Tarea 1: crear y preparar el proyecto ................................................................................................................ 5 Tarea 2: crear una actividad de flujo de trabajo para que lo use el flujo de trabajo reutilizable ....................... 6 Tarea 3: agregar cdigo para crear una biblioteca de documentos basada en parmetros pasados a la actividad. ............................................................................................................................................................ 9 Tarea 4: configurar actividades para implementar. ......................................................................................... 11 Tarea 5: agregar la actividad SPDActivityDemo que se va a implementar con SPCHOL305Ex1. ................. 15 Tarea 6: configurar una caracterstica mediante el diseador de caractersticas ........................................... 17 Tarea 7: agregar y codificar el receptor de caractersticas ............................................................................. 17 Tarea 8: crear un flujo de trabajo reutilizable mediante SharePoint Designer ................................................ 19 Tarea 9: importar el flujo de trabajo reutilizable a Visual Studio ..................................................................... 27 Tarea 10: asociar el flujo de trabajo con una lista en SharePoint ................................................................... 33 Resumen del ejercicio ...................................................................................................................................... 35

Ejercicio 2 ............................................................................................................................................................. 36 Tarea 1: Asegrese de que exista una lista de clientes en el sitio .................................................................. 36 Tarea 2: crear y preparar el proyecto .............................................................................................................. 36 Tarea 2: creacin de un nuevo formulario de iniciacin de flujo de trabajo que utilizar el flujo de trabajo. .. 39 Tarea 3: complecin del Formulario de iniciacin de flujo de trabajo. ............................................................ 40 Tarea 4: proceso de los datos del Formulario de iniciacin de flujo de trabajo en Workflow1 ....................... 41 Tarea 5: implementacin y depuracin de Workflow1 ..................................................................................... 42 Resumen del ejercicio ...................................................................................................................................... 43

Resumen del laboratorio ...................................................................................................................................... 44

Pgina 2

SPCHOL 305 Desarrollar un flujo de trabajo de SharePoint 2010 con un formulario de iniciacin

Tiempo estimado para completar este laboratorio: 30 minutos

Objetivo del laboratorio

Descripcin del ejercicio En el primer ejercicio, se muestra cmo crear una actividad personalizada de flujos de trabajo que usa un flujo de trabajo reutilizable de SharePoint Designer y cmo implementarlos juntos como un nico *.WSP. Tambin se muestra cmo importar ese flujo de trabajo a Visual Studio 2010. En el segundo ejercicio, se muestra cmo crear un flujo de trabajo de SharePoint en un formulario de iniciacin y procesar los datos del formulario. Descripcin de la caracterstica SharePoint Designer permite crear un flujo de trabajo que se puede reutilizar a travs de mltiples listas y sitios. El flujo de trabajo puede exportarse como un archivo de solucin de SharePoint (*.WSP).

Recursos adicionales

Este laboratorio incluye los siguientes recursos adicionales:

Este manual del

laboratorio.

SPCHOL305_Manual_CS.docx Este documento.

Cdigo fuente. Completed\CS\Ex1

Completed\CS\Ex2

Cdigo fuente del laboratorio completado.

Recursos Resources\CS Recursos varios usados a lo largo de este

laboratorio.

Introduccin

Iniciar sesin en la mquina virtual

Inicie sesin en la mquina virtual como el usuario siguiente: Nombre de usuario: Administrator Contrasea: pass@word1

Ubicaciones

Este laboratorio prctico contiene diversos recursos adicionales en ubicaciones establecidas. De forma predeterminada, se asume que el directorio HOL base es C:\Content Packs\Packs\SharePoint 2010 Developer Labs 1.0\Supporting Files\SPCHOL305\Resources. La carpeta de trabajo predeterminada para este laboratorio es C:\SPHOLs\SPCHOL305.

Pgina 3

Requisitos previos para el laboratorio

1. Vaya al directorio HOL base Supporting Files\SPCHOL305\Resources y ejecute el script de PowerShell optimize.ps1:

Haga clic con el botn secundario en optimize.ps1 y seleccione Ejecutar con PowerShell:

Figura 1 - Ejecutar el script de PowerShell

De esta forma se abrir la ventana de PowerShell para ejecutar el script. Espere mientras PowerShell completa la ejecucin del script y cierra la ventana de PowerShell (esto puede tardar varios minutos):

Figura 2 - Ventana de PowerShell donde se ejecuta el script

Copiar las muestras de cdigo desde un documento de Word

Solo ser seguro copiar y pegar cdigo desde este documento de Word en Visual Studio para las secciones de cdigo con formato, por ejemplo:

Console.WriteLine("Esto es cdigo seguro!");

Pgina 4

Es posible que el cdigo que no se encuentre en estas secciones contenga Unicode o caracteres invisibles que no sean cdigo XML o C#/VB vlido, por ejemplo:

Console.WriteLine(Esto NO es cdigo seguro!!);

Fragmentos de cdigo

Tambin se pueden usar fragmentos de cdigo para insertar el cdigo apropiado en el laboratorio. Para usar el fragmento de cdigo necesario para este laboratorio:

Haga clic con el botn secundario en el archivo de cdigo donde desea insertar el fragmento de cdigo.

Seleccione Insertar fragmento de cdigo...:

Seleccione fragmentos de cdigo en la galera Mis fragmentos de cdigo.

Pgina 5

Ejercicio 1

En este ejercicio, se muestra cmo crear una actividad personalizada de flujos de trabajo que usa un

flujo de trabajo reutilizable de SharePoint Designer y cmo implementarlos juntos como un nico

*.WSP. Tambin se muestra cmo importar ese flujo de trabajo a Visual Studio 2010.

Tarea 1: crear y preparar el proyecto

En esta tarea, crear una solucin de proyecto vaco y usar los controles de usuario de SharePoint. 1. Abra Visual Studio 2010; para ello, vaya a Inicio | Todos los programas | Microsoft Visual

Studio 2010 | Microsoft Visual Studio 2010.

2. En Visual Studio 2010, cree un proyecto nuevo; para ello, vaya a Archivo | Nuevo | Proyecto.

3. Seleccione la plantilla de proyecto Proyecto de SharePoint vaco de Visual C# | SharePoint | 2010.

4. Escriba SPCHOL305Ex1 en el cuadro de texto Nombre y C:\SPHOLS\SPCHOL305\CS\Ex1 en el cuadro de texto Ubicacin.

Figura 3 - Cuadro de dilogo Nuevo proyecto

5. Haga clic en Aceptar.

Pgina 6

6. En el Asistente para personalizar SharePoint, cambie la direccin URL a http://intranet.contoso.com y seleccione Implementar como solucin de granja de servidores. A continuacin, haga clic en Finalizar.

Figura 4 - Asistente para personalizar SharePoint

7. Visual Studio crear el nuevo proyecto SPCHOL305Ex1 y agregar los archivos necesarios.

Tarea 2: crear una actividad de flujo de trabajo para que lo use el flujo de trabajo reutilizable

1. En Visual Studio 2010, agregue un proyecto nuevo; para ello, vaya a Archivo | Agregar | Nuevo

proyecto.

2. Cambie .NET Framework por .NET Framework 3.5

.

Figura 5 - Establecer la versin de .NET Framework

Pgina 7

3. Seleccione la plantilla de proyecto Visual C# | Workflow | Biblioteca de actividades de flujo de trabajo.

4. Escriba SPDActivityDemo en el cuadro de texto Nombre y haga clic en Aceptar.


5. En el Explorador de soluciones, haga clic con el botn secundario en el proyecto SPDActivityDemo

y seleccione Agregar referencia.

6. Cambie a la ficha Examinar. Escriba C:\Archivos de programa\Archivos comunes\Microsoft

Shared\Web Server Extensions\14\ISAPI en el cuadro de texto Nombre de archivo y presione

ENTRAR.

Pgina 8

7. Seleccione Microsoft.SharePoint.dll y Microsoft.SharePoint.WorkflowActions.dll y,

a continuacin, haga clic en Aceptar.

Figura 7 - Cuadro de dilogo Agregar referencia

8. Haga clic con el botn secundario en Activity1.cs en el Explorador de soluciones y seleccione

Cambiar nombre.

9. Cambie el nombre de Activity1.cs por CreateDocumentLibrary.cs.

Pgina 9

Tarea 3: agregar cdigo para crear una biblioteca de documentos basada en parmetros pasados a la actividad.

1. Haga clic con el botn secundario en el archivo CreateDocumentLibrary.cs del Explorador de

soluciones y seleccione Ver cdigo.

2. Cambie la clase base de CreateDocumentLibrary de SequenceActivity a Activity, como se

muestra a continuacin.

public partial class CreateDocumentLibrary : Activity

3. Agregue las siguientes instrucciones using al principio del archivo debajo de las instrucciones

using existentes:

using Microsoft.SharePoint; using Microsoft.SharePoint.Workflow; using Microsoft.SharePoint.WorkflowActions;

Fragmento de cdigo: Mis fragmentos de cdigo | spchol305_ex1_createdoclib_namespace

4. Agregue una nueva propiedad de dependencia denominada UrlProperty a la clase

CreateDocumentLibrary.

Esta ser la ubicacin donde se crear la biblioteca de documentos.

public static DependencyProperty UrlProperty = DependencyProperty.Register("Url",

typeof(string), typeof(CreateDocumentLibrary), new PropertyMetadata(""));

[DescriptionAttribute("Url of base site")]

[BrowsableAttribute(true)]

[DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible

)]

[ValidationOption(ValidationOption.Optional)]

public string Url

{

get

{

return ((string)(base.GetValue(CreateDocumentLibrary.UrlProperty)));

}

set

{

base.SetValue(CreateDocumentLibrary.UrlProperty, value);

}

}

Fragmento de cdigo: Mis fragmentos de cdigo | spchol305_ex1_createdoclib_urlproperty

Pgina 10

5. Agregue una nueva propiedad de dependencia a la clase CreateDocumentLibrary

denominada DocLibNameProperty.

Este ser el nombre de la biblioteca de documentos creada por la actividad.

public static DependencyProperty DocLibNameProperty =

DependencyProperty.Register("DocLibName", typeof(string),

typeof(CreateDocumentLibrary), new PropertyMetadata(""));

[DescriptionAttribute("Used as doc lib name")]

[BrowsableAttribute(true)]

[DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible

)]

[ValidationOption(ValidationOption.Optional)]

public string DocLibName

{

get

{

return ((string)(base.GetValue(CreateDocumentLibrary.DocLibNameProperty)));

}

set

{

base.SetValue(CreateDocumentLibrary.DocLibNameProperty, value);

}

}

Fragmento de cdigo: Mis fragmentos de cdigo | spchol305_ex1_createdoclib_doclibproperty

6. Agregue el siguiente cdigo debajo del constructor CreateDocumentLibrary:

protected override ActivityExecutionStatus Execute(ActivityExecutionContext

executionContext)

{

CreateDocLib();

return ActivityExecutionStatus.Closed;

}

private void CreateDocLib()

{

using (SPSite sps = new SPSite(Url))

{

using (SPWeb spw = sps.RootWeb)

{

Guid ID = spw.Lists.Add(DocLibName, DocLibName + " Document Library",

SPListTemplateType.DocumentLibrary);

SPList spdl = spw.Lists[ID];

spdl.OnQuickLaunch = true;

spdl.Update();

}

}

}

Fragmento de cdigo: Mis fragmentos de cdigo | spchol305_ex1_createdoclib_execute

Pgina 11

Tarea 4: configurar actividades para implementar.

1. Configure la actividad para un nombre seguro. Agregue SPDActivityDemo.snk de la carpeta

Resources (ubicacin al principio de este manual) al proyecto SPDActivityDemo.

Figura 8 - Agregar elemento existente

2. Haga clic con el botn secundario en el proyecto SPDActivityDemo en el Explorador de

soluciones y seleccione Propiedades.

3. Haga clic en la pestaa Firma, active Firmar el ensamblado y, a continuacin, seleccione

SPDActivityDemo.snk.

Figura 9 - Firma

4. Cree el proyecto (CTRL-MAYS-B) y solucione los errores.

Pgina 12

5. Haga clic con el botn secundario en el proyecto SPCHOL305Ex1 y, a continuacin, en

Agregar, Carpeta asignada de SharePoint...

.

Figura 10 - Carpeta asignada de SharePoint

Pgina 13

6. Seleccione Template\3082\Workflow en el cuadro de dilogo Agregar carpeta asignada de

SharePoint y seleccione Aceptar.

Figura 11 - Cuadro de dilogo Agregar carpeta asignada de SharePoint

7. En el Explorador de soluciones, expanda la carpeta Workflow agregada recientemente.

8. Haga clic con el botn secundario en la carpeta SPCHOL305Ex1 (si existe) y seleccione Eliminar.

9. Haga clic con el botn secundario en la carpeta Workflow y seleccione Agregar | Nuevo elemento.

Pgina 14

10. Seleccione la plantilla Archivo XML, denomine al archivo SPDActivityDemo.ACTIONS y, a continuacin, haga clic en Agregar.

Figura 12 - Cuadro de dilogo Agregar nuevo elemento

Pgina 15

11. Reemplace el contenido de SPDActivityDemo.ACTIONS por lo siguiente:

Fragmento de cdigo: Mis fragmentos de cdigo | spchol305_ex1_workflowactions_xml

12. Genere el proyecto SPDActivityDemo.

Tarea 5: agregar la actividad SPDActivityDemo que se va a implementar con SPCHOL305Ex1.

1. En el Explorador de soluciones, expanda la carpeta Package en el proyecto SPCHOL305Ex1.

2. Haga doble clic en el archivo Package.package para abrir el diseador de paquetes.

3. Haga clic en la pestaa Avanzadas en la parte inferior del diseador.

Figura 13 - Pestaa Avanzadas del paquete

Pgina 16

4. Haga clic en el botn Agregar y seleccione Agregar ensamblado desde la salida del proyecto.

5. En el cuadro de dilogo Agregar ensamblado desde la salida del proyecto, haga clic en el

cuadro combinado Proyecto de origen y seleccione SPDActivityDemo.

Figura 14 - Agregar ensamblado existente desde resultados del proyecto

6. Haga clic en el botn situado debajo de Controles seguros. Dentro de Controles seguros

agregue lo siguiente:

Nombre de ensamblado: SPDActivityDemo, Version=1.0.0.0, Culture=neutral, PublicKeyToken= a66e91d2ee2fa8f8 Espacio de nombres: SPDActivityDemo Seguro: Comprobado Nombre de tipo: *

7. Una vez rellenados los detalles del control seguro, presione ENTRAR para confirmarlos. 8. Haga clic en Aceptar.

Pgina 17

Tarea 6: configurar una caracterstica mediante el diseador de caractersticas

1. Haga clic con el botn secundario en la carpeta Features en el Explorador de soluciones

debajo del proyecto SPCHOL305Ex1 y seleccione Agregar caracterstica.

2. Haga clic con el botn secundario en Feature1 y cambie el nombre a SPCHOL305Ex1Feature.

3. En el diseador de caractersticas, cambie el mbito del mbito SPCHOL305Ex1Feature

a WebApplication.

Figura 15 - Diseador de caractersticas

Tarea 7: agregar y codificar el receptor de caractersticas

1. Haga clic con el botn secundario en la caracterstica SPCHOL305Ex1Feature en el Explorador de soluciones y seleccione Agregar receptor de eventos.

2. Agregue una instruccin using al principio del cdigo:

using Microsoft.SharePoint.Administration;

Pgina 18

3. Agregue el siguiente cdigo a la declaracin de clases de FeatureReceiver: public override void FeatureActivated(SPFeatureReceiverProperties properties) { SPWebApplication wappCurrent = (SPWebApplication)properties.Feature.Parent; SPWebConfigModification modAuthorizedType = new SPWebConfigModification(); modAuthorizedType.Name = "AuthType"; modAuthorizedType.Owner = "SPDActivityDemo"; modAuthorizedType.Path = "configuration/System.Workflow.ComponentModel.WorkflowCompiler/authorizedTypes"; modAuthorizedType.Type = SPWebConfigModification.SPWebConfigModificationType.EnsureChildNode; modAuthorizedType.Value = ""; wappCurrent.WebConfigModifications.Add(modAuthorizedType); wappCurrent.WebService.ApplyWebConfigModifications(); }

Fragmento de cdigo: Mis fragmentos de cdigo | spchol305_ex1_spchol305feature_receiver

4. Genere e implemente el proyecto SPCHOL305Ex1; para ello, haga clic con el botn

secundario en el nombre del proyecto y seleccione Implementar.

Figura 16 - Implementar la solucin

Pgina 19

Tarea 8: crear un flujo de trabajo reutilizable mediante SharePoint Designer

1. Abra SharePoint Designer 2010; para ello, vaya a Inicio | Todos los programas | SharePoint | Microsoft SharePoint Designer 2010

2. Haga clic en Sitios y, a continuacin, en Abrir sitio.

Figura 17 - Botn de men Sitios en SharePoint Designer 2010

Si se le solicitan credenciales, use: Nombre de usuario: Administrator Contrasea: pass@word1

Pgina 20

3. Cambie el Nombre de sitio a http://intranet.contoso.com y seleccione Abrir

.

Figura 18 - Cuadro de dilogo Abrir sitio

Pgina 21

5. Haga clic en el botn Flujo de trabajo reutilizable y, cuando se le pida, asigne el nombre

SPDWorkflow al flujo de trabajo y, a continuacin, haga clic en el botn Aceptar para crear el

flujo de trabajo reutilizable.

Figura 19 - Creacin de un flujo de trabajo reutilizable

Pgina 22

6. Haga clic en el botn Accin de la cinta de opciones y desplcese hacia abajo hasta Labs y

haga clic en Create Document Library. Nota: Esta es la actividad que realizamos previamente

en Visual Studio.

Figura 20 - Agregar la accin Crear biblioteca de documentos

Pgina 23

7. Haga clic en el Paso 1. En el cuadro situado junto a Nombre de la biblioteca de documentos,

haga clic en el botn Fx.

8. Seleccione Elemento actual como Origen de datos y Ttulo como el valor de Campo del

origen. A continuacin, haga clic en Aceptar.

Figura 21 - Cuadro de dilogo Bsqueda de cadena

9. Escriba http://intranet.contoso.com como la direccin URL del sitio base.

10. Haga clic en Guardar en la cinta de opciones.

Figura 22 - Configuracin de la accin del flujo de trabajo

Pgina 24

11. Despus de guardar, haga clic en el botn Publicar de la cinta de opciones. Espere hasta que

se publique el flujo de trabajo.

Figura 23 - Publicar el flujo de trabajo

12. Despus de guardar, haga clic en Flujos de trabajo en la zona de navegacin izquierda.

13. Vuelva a hacer clic en el flujo de trabajo debajo de Flujo de trabajo reutilizable para abrir las

propiedades del flujo de trabajo. Haga clic en Guardar como plantilla para guardar el archivo

.WSP en la lista Biblioteca de activos del sitio de SharePoint.

Figura 24 - Guardar como plantilla

Pgina 25

14. Abra un explorador web en http://intranet.contoso.com. 15. Haga clic en Acciones del sitio -> Ver todo el contenido del sitio -> Biblioteca de activos

del sitio.

Figura 25 - Biblioteca de activos del sitio

16. Haga clic en el men desplegable SPDWorkflow y, a continuacin, en Enviar a -> Descargar

una copia.

Figura 26 - Descarga del WSP

Pgina 26

17. Guarde el WSP en una ubicacin a la que pueda obtener acceso en un paso siguiente (como el

escritorio).

Figura 27 - Cuadro de dilogo Guardar como

Pgina 27

Tarea 9: importar el flujo de trabajo reutilizable a Visual Studio

1. En Visual Studio 2010, haga clic con el botn secundario en la solucin SPCHOL305Ex1 de

la ventana Explorador de soluciones y seleccione Agregar | Nuevo proyecto.

2. Seleccione la plantilla de proyecto Importar flujo de trabajo reutilizable de Visual C# | SharePoint | 2010.

3. Cambie el Nombre a SPDWorkflowImport.



Pgina 28

5. Asegrese de que la direccin URL sea http://intranet.contoso.com. Haga clic en Siguiente.


Pgina 29

6. Cuando se le pregunte qu archivo .WSP desea importar, busque el archivo SPDWorkflow.wsp

que guard anteriormente. Haga clic en Siguiente.


Pgina 30

7. Haga clic en Finalizar. NOTA: si est usando Visual Studio 2010 Beta 2, se producir un

error y no podr completar este laboratorio. Si est usando una versin posterior de

Visual Studio 2010, podr continuar.


Pgina 31

8. Haga doble clic en el paquete del proyecto SPCHOL305Ex1 y agregue la caracterstica Flujos

de trabajo convertidos al paquete.

Figura 32 - Explorador de paquetes de SharePoint

Pgina 32

9. Haga clic con el botn secundario en el proyecto SPDWorkflowImport y seleccione Agregar

referencia.

10. Seleccione la referencia de proyecto SPDActivityDemo y haga clic en Aceptar.

Figura 33 - Agregar referencia de ensamblado

11. En el proyecto SPDWorkflowImport, expanda el nodo Workflows\SPDWorkflowFT.

12. Abra Elements.xml.

13. Cambie el nombre del flujo de trabajo a SPDWorkflowFT

.

Figura 34 - Se configura el nombre del flujo de trabajo importado

Pgina 33

14. Guarde el proyecto, genere la solucin e implemente el proyecto SPCHOL305Ex1.

Tarea 10: asociar el flujo de trabajo con una lista en SharePoint

1. Busque http://intranet.contoso.com.

2. Haga clic en Acciones del sitio | Ms opciones.

3. Seleccione Lista personalizada en la lista de elementos.

4. Asigne el nombre Customers a la lista y haga clic en Crear.

5. Abra la Configuracin de la lista

.

Figura 35 - Configuracin de la lista

6. En Permisos y administracin, haga clic en Configuracin del flujo de trabajo.

7. Configure el flujo de trabajo de la lista del siguiente modo:

Seleccione una plantilla de flujo de trabajo: SPDWorkflowFT

Escriba un nombre nico para este flujo de trabajo: Create Doc Lib for Customer

Seleccione una lista de tareas: Tareas

Seleccione una lista de historial: Historial del flujo de trabajo (Nuevo)

Opciones de inicio: Iniciar este flujo de trabajo cuando se cree un nuevo elemento

Pgina 34

Figura 36 - Configuracin del flujo de trabajo


9. Navegue a la lista Customers y seleccione Elementos | Nuevo elemento.

Figura 37 - Creacin de un nuevo elemento

Pgina 35

10. Escriba Northwind como el nombre del cliente y presione Guardar cuando aparezca el cuadro

de dilogo Customers Nuevo elemento.

Figura 38 - Cuadro de dilogo Nuevo elemento

11. Espere mientras se crea automticamente una nueva biblioteca de documentos con el mismo

nombre.

Resumen del ejercicio

En este ejercicio, gener una nueva actividad de flujo de trabajo para su uso en flujos de trabajo de SharePoint Designer. Se gener un flujo de trabajo reutilizable en SharePoint Designer y se us la actividad personalizada. A continuacin, se import el flujo de trabajo reutilizable a Visual Studio 2010 y se implement el flujo de trabajo final de vuelta a SharePoint.

Pgina 36

Ejercicio 2

En este ejercicio, se muestra cmo crear un flujo de trabajo de SharePoint en un formulario de iniciacin y procesar los datos del formulario.

Tarea 1: Asegrese de que exista una lista de clientes en el sitio

1. Vaya al sitio http://intranet.contoso.com

2. Compruebe si existe una Lista personalizada llamada Customer; si no es as, crela.

Tarea 2: crear y preparar el proyecto

En esta tarea, crear una solucin de Flujo de trabajo secuencial y usar los controles de usuario de SharePoint. 1. En el men de Visual Studio 2010, seleccione Archivo | Nuevo | Nuevo proyecto.

2. Seleccione la plantilla de proyecto Flujo de trabajo secuencial de Visual C# | SharePoint | 2010 |.

3. Cambie el Nombre a SPCHOL305Ex2.



Pgina 37

5. Cambie la direccin URL a http://intranet.contoso.com.


6. Haga clic en Siguiente.


Haga clic en Siguiente.

Pgina 38

7. Cambie La biblioteca o lista a la que va a asociar el flujo de trabajo: por Customer


Haga clic en Siguiente.

8. Desactive El flujo de trabajo se inicia automticamente cuando se crea un elemento


9. Haga clic en Finalizar.

Pgina 39

Tarea 2: creacin de un nuevo formulario de iniciacin de flujo de trabajo que utilizar el flujo de trabajo.

1. Haga clic con el botn secundario en Workflow1 en el proyecto de flujo de trabajo SPCHOL305Ex2 , Agregar, Nuevo elemento...

Figura 44 - Agregar nuevo elemento

2. Seleccione la plantilla de elemento Formulario de iniciacin de flujo de trabajo de Visual C# | SharePoint | 2010.

3. Cambie el Nombre a WorkflowIntiationForm.aspx.

Figura 45 Cuadro de dilogo Nuevo elemento

4. Haga clic en Agregar.

Pgina 40

Tarea 3: complecin del Formulario de iniciacin de flujo de trabajo.

1. Agregue el siguiente cdigo al marcador de posicin principal

Fragmento de cdigo: Mis fragmentos de cdigo HTML | spchol305_ex2_initiationform_html

Figura 46 - Formulario de iniciacin de flujo de trabajo

2. Abra el archivo WorkflowInitiationForm.aspx.cs. En el mtodo GetInitiationData sustituya return string.Empty; por el cdigo siguiente

return Checkbox.Checked.ToString();

Fragmento de cdigo: Mis fragmentos de cdigo | spchol305_ex2_workflowinitiationform

Figura 47 - Cdigo del formulario de iniciacin de flujo de trabajo

Pgina 41

Tarea 4: proceso de los datos del Formulario de iniciacin de flujo de trabajo en Workflow1

1. Abra la Vista Diseador de Workflow1.cs. En el Cuadro de herramientas, agregue una actividad de Cdigo (Windows Workflow v3.0) tras la actividad onWorkflowActivated1.

Figura 48 - Diseador de flujo de trabajo

2. Haga doble clic en codeActivity1 para generar un evento de tipo ExecuteCode en el cdigo anterior. Agregue el cdigo siguiente al mtodo codeActivity1_ExecuteCode. Defina un punto de interrupcin en el mtodo.

if (workflowProperties.InitiationData == "True") { System.Diagnostics.Debug.WriteLine("This is a fast track customer"); }

Fragmento de cdigo: Mis fragmentos de cdigo | spchol305_ex2_codeactivity1

Figura 49 - Mtodo Execute Code

Pgina 42

Tarea 5: implementacin y depuracin de Workflow1

1. Presione F5 para implementar y depurar el nuevo flujo de trabajo

2. Vaya a la lista Customer y cree un nuevo elemento en la lista denominado Contoso

Figura 50 - Lista de clientes

3. Haga clic en el desplegable de edicin del elemento Contoso y seleccione Flujos de trabajo. Inicie SPCHOL305Ex2 Workflow1 en este elemento.

Figura 51 - Iniciar flujo de trabajo

4. Compruebe la casilla Fast Track Customer y haga clic en el botn Iniciar flujo de trabajo.

Figura 52 - Formulario de iniciacin de flujo de trabajo

Pgina 43

5. Debera alcanzarse el punto de interrupcin definido en el cdigo. Utilice F10 para recorrer el cdigo.

Figura 53 - Punto de interrupcin del cdigo

6. En la ventana de resultados, se ha capturado el valor enviado en el formulario de iniciacin

Figura 54 - Resultados de la depuracin

7. Flujo de trabajo completo

Figura 55 - Flujo de trabajo completo

Resumen del ejercicio

En este ejercicio, ha creado un flujo de trabajo de SharePoint con un formulario de iniciacin y ha procesado los datos del formulario.

Pgina 44

Resumen del laboratorio

En este laboratorio, ha realizado los ejercicios siguientes:

Crear una accin de flujo de trabajo en Visual Studio 2010

Crear un proyecto vaco de SharePoint e incluirlo en la accin de flujo de trabajo de esta

solucin

Implementar la accin de flujo de trabajo como paquete de soluciones WSP

Usar la accin de flujo de trabajo para crear un flujo de trabajo reutilizable de SharePoint

Designer 2010

Usar SharePoint Designer para crear un paquete WSP que se puede volver a importar a Visual

Studio 2010.

Importar un WSP de SharePoint Designer 2010 en Visual Studio 2010.

Usar Visual Studio 2010 para crear un formulario de iniciacin y asociarlo a un flujo de trabajo

de SharePoint

En este laboratorio, ha aprendido a crear una accin de flujo de trabajo de SharePoint. Ha aprendido a

incluir esta accin en un paquete de soluciones WSP de SharePoint. Tambin ha utilizado SharePoint

Designer 2010 para crear un flujo de trabajo reutilizable utilizando la accin de flujo de trabajo de

Visual Studio. A continuacin, ha utilizado SharePoint Designer para generar un WSP que se ha vuelto

a importar en Visual Studio.

Tambin ha utilizado un formulario de iniciacin para capturar los datos del usuario y procesar estos datos en el flujo de trabajo.

Documents

Hol7 Manual Cs