Introducción para el programador de SharePoint. Laboratorio práctico. Manual del laboratorio

Transcripción

1 Introducción para el programador de SharePoint Laboratorio práctico Manual del laboratorio SPCHOL305 - Desarrollar un flujo de trabajo de SharePoint 2010 con un formulario de iniciación en Visual Studio VB

2 Este documento se proporciona tal cual. Es posible que la información y los puntos de vista reflejados en este documento, incluidas la dirección 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 ningún derecho legal sobre la propiedad intelectual e industrial de ningún producto de Microsoft. Este documento puede copiarse y usarse para fines internos y de referencia Microsoft. Todos los derechos reservados.

3 Contenido SPCHOL305 -DESARROLLAR UN FLUJO DE TRABAJO DE SHAREPOINT 2010 CON UN FORMULARIO DE INICIACIÓN... 2 Objetivo del laboratorio... 2 Recursos adicionales... 2 Introducción... 2 Iniciar sesión en la máquina virtual... 2 Ubicaciones... 2 Requisitos previos para el laboratorio... 3 Copiar las muestras de código desde un documento de Word... 3 Fragmentos de código... 4 Ejercicio 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 código para crear una biblioteca de documentos basada en parámetros pasados a la actividad... 9 Tarea 4: configurar actividades para implementar Tarea 5: agregar la actividad SPDActivityDemo que se va a implementar con SPCHOL305Ex Tarea 6: configurar una característica mediante el diseñador de características Tarea 7: agregar y codificar el receptor de características Tarea 8: crear un flujo de trabajo reutilizable mediante SharePoint Designer Tarea 9: importar el flujo de trabajo reutilizable a Visual Studio Tarea 10: asociar el flujo de trabajo con una lista en SharePoint Resumen del ejercicio Ejercicio Tarea 1: asegurarse de que hay una lista Customer en el sitio Tarea 2: crear y preparar el proyecto Tarea 2: crear un formulario de iniciación de flujo de trabajo nuevo que va a usar el flujo de trabajo Tarea 3: completar el formulario de iniciación de flujo de trabajo Tarea 4: procesar los datos del formulario de iniciación del flujo de trabajo en Workflow Tarea 5: implementar y depurar Workflow Resumen del ejercicio Resumen del laboratorio Página 1

4 SPCHOL305 -Desarrollar un flujo de trabajo de SharePoint 2010 con un formulario de iniciación Tiempo estimado para completar este laboratorio: 30 minutos Objetivo del laboratorio Descripción del ejercicio En el primer ejercicio, se muestra cómo crear una actividad personalizada de flujos de trabajo que usa un flujo de trabajo reutilizable de SharePoint Designer y cómo implementarlos juntos como un único *.WSP. También se muestra cómo importar ese flujo de trabajo a Visual Studio En el segundo ejercicio, se muestra cómo crear un flujo de trabajo de SharePoint en un formulario de iniciación y procesar los datos del formulario. Descripción de la característica SharePoint Designer permite crear un flujo de trabajo que se puede reutilizar a través de múltiples listas y sitios. El flujo de trabajo puede exportarse como un archivo de solución de SharePoint (*.WSP). Recursos adicionales Este laboratorio incluye los siguientes recursos adicionales: Este manual del laboratorio. Código fuente. SPCHOL301_Manual_VB.docx Completed\VB\Ex1 Completed\VB\Ex2 Este documento. Código fuente del laboratorio completado. Recursos Resources\VB Recursos varios usados a lo largo de este laboratorio. Introducción Iniciar sesión en la máquina virtual Inicie sesión en la máquina virtual como el usuario siguiente: Nombre de usuario: Administrator Contraseña: pass@word1 Ubicaciones Este laboratorio práctico contiene diversos recursos adicionales en ubicaciones establecidas. De forma predeterminada, se asume que el directorio HOL base es Supporting Files\SPCHOL305\Resources. La carpeta de trabajo predeterminada para este laboratorio es C:\SPHOLs\SPCHOL305. Página 2

5 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 botón 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 hasta que se complete la ejecución del script de PowerShell y se cierre la ventana de PowerShell: Página 3 Figura 2 - Ventana de PowerShell donde se ejecuta el script Copiar las muestras de código desde un documento de Word Solo será seguro copiar y pegar código desde este documento de Word en Visual Studio para las secciones de código con formato, por ejemplo: Console.WriteLine ( Esto es código seguro! ) Es posible que el código que no se encuentre en estas secciones contenga Unicode o caracteres invisibles que no sean código XML o C#/VB válido, por ejemplo: Console.WriteLine ( Esto NO es código seguro!! )

6 Fragmentos de código También se pueden usar fragmentos de código para insertar el código apropiado en el laboratorio. Para usar el fragmento de código necesario para este laboratorio: Haga clic con el botón secundario en el archivo de código donde desea insertar el fragmento de código. Seleccione Insertar fragmento de código...: Seleccione fragmentos de código en la galería Mis fragmentos de código. Página 4

7 Ejercicio 1 En este ejercicio, se muestra cómo crear una actividad personalizada de flujos de trabajo que usa un flujo de trabajo reutilizable de SharePoint Designer y cómo implementarlos juntos como un único *.WSP. También se muestra cómo importar ese flujo de trabajo a Visual Studio Tarea 1: crear y preparar el proyecto En esta tarea, creará una solución de proyecto vacío 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 En Visual Studio 2010, cree un proyecto nuevo; para ello, vaya a Archivo Nuevo Nuevo proyecto. 3. Seleccione la plantilla de proyecto Proyecto vacío de Visual Basic SharePoint Escriba SPCHOL305Ex1 en el cuadro de texto Nombre y c:\sphols\spchol305\vb\ex1 en el cuadro de texto Ubicación. Figura 3 - Cuadro de diálogo Nuevo proyecto Página 5

8 5. Haga clic en Aceptar. 6. En el Asistente para personalizar SharePoint, cambie la dirección URL a y seleccione Implementar como solución de granja de servidores. A continuación, 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. Archivo Agregar Nuevo proyecto. 2. Cambie.NET Framework por.net Framework 3.5. Figura 5 - Establecer la versión de.net Framework 3. Seleccione la plantilla de proyecto Visual Basic Workflow Biblioteca de actividades de flujo de trabajo. Página 6

9 4. Cambie el Nombre a SPDActivityDemo. Figura 6 - Cuadro de diálogo Nuevo proyecto Página 7

10 5. Haga clic con el botón secundario en el proyecto SPDActivityDemo y en Agregar referencia... a Microsoft.SharePoint.dll y Microsoft.SharePoint.WorkflowActions.dll; para ello vaya a C:\Archivos de programa\archivos comunes\microsoft Shared\Web Server Extensions\14\ISAPI y seleccione los DLL necesarios. Figura 7 - Cuadro de diálogo Agregar referencia 6. Haga clic con el botón secundario en Activity1.vb en el Explorador de soluciones y seleccione cambiar el nombre. 7. Cambie el nombre de Activity1.vb por CreateDocumentLibrary.vb. Página 8

11 Tarea 3: agregar código para crear una biblioteca de documentos basada en parámetros pasados a la actividad. 1. Haga clic con el botón secundario en el archivo CreateDocumentLibrary.vb del Explorador de soluciones y seleccione Vista de Código. 2. Cambie la clase base de CreateDocumentLibrary de SequenceActivity a Activity, como se muestra a continuación. Public class CreateDocumentLibrary Inherits Activity End Class 3. Agregue las siguientes instrucciones Imports al principio del archivo: Fragmento de código: Mis fragmentos de código spchol305_ex1_createdoclib_namespace Imports Microsoft.SharePoint Imports Microsoft.SharePoint.Workflow Imports Microsoft.SharePoint.WorkflowActions 4. Agregue una nueva propiedad de dependencia a la clase CreateDocumentLibrary denominada UrlProperty. Esta es la ubicación donde se creará la biblioteca de documentos. Public Shared UrlProperty As DependencyProperty = DependencyProperty.Register("Url", GetType(String), GetType(CreateDocumentLibrary), New PropertyMetadata("")) <DescriptionAttribute("Url del sitio base")>_ <BrowsableAttribute(True)>_ <DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible )>_ <ValidationOption(ValidationOption.[Optional])>_ Public Property Url() As String Get Return DirectCast((MyBase.GetValue(CreateDocumentLibrary.UrlProperty)), String) End Get Set(ByVal value As String) MyBase.SetValue(CreateDocumentLibrary.UrlProperty, value) End Set End Property Fragmento de código: Mis fragmentos de código spchol305_ex1_createdoclib_urlproperty Página 9

12 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 Shared DocLibNameProperty As DependencyProperty = DependencyProperty.Register("DocLibName", GetType(String), GetType(CreateDocumentLibrary), New PropertyMetadata("")) <DescriptionAttribute("Utilizado como nombre de biblioteca de documentos")>_ <BrowsableAttribute(True)>_ <DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible )>_ <ValidationOption(ValidationOption.[Optional])>_ Public Property DocLibName() As String Get Return DirectCast((MyBase.GetValue(CreateDocumentLibrary.DocLibNameProperty)), String) End Get Set(ByVal value As String) MyBase.SetValue(CreateDocumentLibrary.DocLibNameProperty, value) End Set End Property Fragmento de código: Mis fragmentos de código spchol305_ex1_createdoclib_doclibproperty 6. Agregue el siguiente código a la clase CreateDocumentLibrary: InitializeComponent() End Sub Public Sub New() Protected Overloads Overrides Function Execute(ByVal executioncontext As ActivityExecutionContext) As ActivityExecutionStatus CreateDocLib() Return ActivityExecutionStatus.Closed End Function Private Sub CreateDocLib() Using sps As New SPSite(Url) Using spw As SPWeb = sps.rootweb Dim ID As Guid = spw.lists.add(doclibname, DocLibName & " Biblioteca de documentos", SPListTemplateType.DocumentLibrary) Dim spdl As SPList = spw.lists(id) spdl.onquicklaunch = True spdl.update() End Using End Using End Sub Fragmento de código: Mis fragmentos de código spchol305_ex1_createdoclib_execute Página 10

13 Tarea 4: configurar actividades para implementar. 1. Configure la actividad para un nombre seguro. Agregue SPDActivityDemo.snk de la carpeta Resources (ubicación al principio de este manual) al proyecto SPDActivityDemo. Figura 8 - Agregar elemento existente 2. Abra las propiedades del proyecto SPDActivityDemo. Haga clic en Firma, marque "Firmar el ensamblado", <Examinar...> y busque SPDActivityDemo.snk. Figura 9 - Firma 3. Cree el proyecto (CTRL-MAYÚS-B) y solucione los errores. Página 11

14 4. Haga clic con el botón secundario en el proyecto SPCHOL305Ex1 y, a continuación, en Agregar, Carpeta asignada de SharePoint.... Figura 10 - Carpeta asignada de SharePoint Página 12

15 5. Seleccione Template\3082\Workflow en el cuadro de diálogo Agregar carpeta asignada de SharePoint y seleccione Aceptar. Figura 11 - Cuadro de diálogo Agregar carpeta asignada de SharePoint 6. En el Explorador de soluciones, expanda la carpeta Workflow agregada recientemente. 7. Haga clic con el botón secundario en la carpeta SPCHOL305Ex1 (si existe) y seleccione Eliminar. 8. Haga clic con el botón secundario en la carpeta Workflow y seleccione Agregar Nuevo elemento. Página 13

16 9. Seleccione la plantilla Archivo XML, denomine al archivo SPDActivityDemo.ACTIONS y, a continuación, haga clic en Agregar. Figura 12 - Cuadro de diálogo Agregar nuevo elemento Página 14

17 10. Reemplace el contenido de SPDActivityDemo.ACTIONS por lo siguiente: <?xml version="1.0" encoding="utf-8"?> <WorkflowInfo> <Actions Sequential="then" Parallel="and"> <Action Name="Crear biblioteca de documentos" ClassName="SPDActivityDemo.CreateDocumentLibrary" Assembly="SPDActivityDemo, Version= , Culture=neutral, PublicKeyToken=a66e91d2ee2fa8f8" AppliesTo="all" Category="Labs"> <RuleDesigner Sentence="Nombre de biblioteca de documentos %1 para sitio %2."> <FieldBind Field="DocLibName" Text="Nombre de biblioteca de documentos" DesignerType="TextArea" Id="1"/> <FieldBind Field="Url" Text="Url del sitio base" Id="2" DesignerType="TextArea"/> </RuleDesigner> <Parameters> <Parameter Name="DocLibName" Type="System.String, mscorlib" Direction="In" /> <Parameter Name="Url" Type="System.String, mscorlib" Direction="In" /> </Parameters> </Action> </Actions> </WorkflowInfo> Fragmento de código: Mis fragmentos de código spchol305_ex1_workflowactions_xml 11. 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 diseñador de paquetes. 3. Haga clic en la pestaña Avanzadas en la parte inferior del diseñador. Figura 13 - Pestaña Avanzadas del paquete Página 15

18 4. Haga clic en el botón Agregar y seleccione Agregar ensamblado desde la salida del proyecto. 5. En el cuadro de diálogo Agregar ensamblado desde la salida del proyecto, haga clic en el cuadro combinado Proyecto de origen y seleccione SPDActivityDemo\bin. Figura 14 - Agregar ensamblado existente desde resultados del proyecto 6. Haga clic en el botón situado debajo de Controles seguros. Dentro de Controles seguros agregue lo siguiente: Nombre de ensamblado: SPDActivityDemo, Version= , 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. Página 16

19 Tarea 6: configurar una característica mediante el diseñador de características 1. Haga clic con el botón secundario en la carpeta Features en el Explorador de soluciones debajo del proyecto SPCHOL305Ex1 y seleccione Agregar característica. 2. Haga clic con el botón secundario en Feature1 y cambie el nombre a SPCHOL305Ex1Feature. 3. En el diseñador de características, cambie el ámbito de SPCHOL305Ex1Feature a WebApplication. Figura 15 - Diseñador de características Tarea 7: agregar y codificar el receptor de características 1. Haga clic con el botón secundario en la característica SPCHOL305Ex1Feature en el Explorador de soluciones y seleccione Agregar receptor de eventos. 2. Agregue una instrucción Imports al principio del código: Imports Microsoft.SharePoint.Administration Página 17

20 3. Agregue el siguiente código a la declaración de clases de FeatureReceiver: Public Overloads Overrides Sub FeatureActivated(ByVal properties As SPFeatureReceiverProperties) Dim wappcurrent As SPWebApplication = DirectCast(properties.Feature.Parent, SPWebApplication) Dim modauthorizedtype As New SPWebConfigModification() modauthorizedtype.name = "AuthType" modauthorizedtype.owner = "SPDActivityDemo" modauthorizedtype.path = "configuration/system.workflow.componentmodel.workflowcompiler/authorizedtypes" modauthorizedtype.type = SPWebConfigModification.SPWebConfigModificationType.EnsureChildNode modauthorizedtype.value = "<authorizedtype Assembly=""SPDActivityDemo, " & "Version= , Culture=neutral, PublicKeyToken=a66e91d2ee2fa8f8"" " & "Namespace=""SPDActivityDemo"" TypeName=""*"" Authorized=""True"" />" wappcurrent.webconfigmodifications.add(modauthorizedtype) wappcurrent.webservice.applywebconfigmodifications() End Sub Fragmento de código: Mis fragmentos de código spchol305_ex1_spchol305feature_receiver 4. Genere e implemente el proyecto SPCHOL305Ex1 ; para ello, haga clic con el botón secundario en el nombre del proyecto y seleccione Implementar. Figura 16 - Implementar la solución Página 18

21 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 Haga clic en Sitios y, a continuación, en Abrir sitio. Figura 17 - Botón de menú Sitios en SharePoint Designer 2010 Si se le solicitan credenciales, use: Nombre de usuario: Administrator Contraseña: pass@word1 Página 19

22 3. Cambie el Nombre de sitio a y seleccione Abrir Figura 18 - Cuadro de diálogo Abrir sitio. Página 20

23 5. Haga clic en el botón Flujo de trabajo reutilizable y, cuando se le solicite, asígnele el nombre SPDWorkflow y, a continuación, haga clic en el botón Aceptar para crear el flujo de trabajo reutilizable. Figura 19 - Creación de un flujo de trabajo reutilizable Página 21

24 6. Haga clic en el botón Acción de la cinta de opciones y desplácese hacia abajo hasta Labs y haga clic en Create Document Library. Nota: ya se realizó esta actividad en Visual Studio anteriormente. Figura 20 - Agregar la acción Crear biblioteca de documentos Página 22

25 7. Haga clic en el Paso 1. En el cuadro situado junto a Nombre de la biblioteca de documentos, haga clic en el botón Fx. 8. Seleccione Elemento actual como Origen de datos y Título como el valor de Campo del origen. A continuación, haga clic en Aceptar. Figura 21 - Cuadro de diálogo Búsqueda de cadena 9. Escriba como la dirección URL del sitio base. 10. Haga clic en Guardar en la cinta de opciones. Figura 22 - Configuración de la acción del flujo de trabajo Página 23

26 11. Después de guardar, haga clic en el botón Publicar de la cinta de opciones. Espere hasta que se publique el flujo de trabajo. Figura 23 - Publicar el flujo de trabajo 12. Después de guardar, haga clic en Flujos de trabajo en la zona de navegación 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 Página 24

27 14. Abra un explorador web en Haga clic en Acciones del sitio Ver todo el contenido del sitio, a continuación, seleccione Biblioteca de activos del sitio. Figura 25 - Biblioteca de activos del sitio 16. Haga clic en el menú desplegable SPDWorkflow y, a continuación, en Enviar a -> Descargar una copia. Página 25 Figura 26 - Descarga del WSP

28 17. Guarde el WSP en una ubicación a la que pueda obtener acceso más adelante (como el escritorio). Figura 27 - Cuadro de diálogo Guardar como Página 26

29 Tarea 9: importar el flujo de trabajo reutilizable a Visual Studio 1. En Visual Studio 2010, haga clic con el botón secundario en la solución 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 Basic SharePoint Cambie el Nombre a SPDWorkflowImport. Figura 28 - Cuadro de diálogo Nuevo proyecto 4. Haga clic en Aceptar. Página 27

30 5. Asegúrese de que la dirección URL sea Haga clic en Siguiente. Figura 29 - Asistente para personalizar SharePoint Página 28

31 6. Cuando se le pregunte qué archivo.wsp desea importar, busque el archivo SPDWorkflow.wsp que guardó anteriormente. Haga clic en Siguiente. Figura 30 - Asistente para personalizar SharePoint Página 29

32 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 versión posterior de Visual Studio 2010, podrá continuar. Figura 31 - Asistente para personalizar SharePoint Página 30

33 8. Haga doble clic en el paquete del proyecto SPCHOL305Ex1 y agregue la característica Flujos de trabajo convertidos al paquete. Figura 32 - Explorador de paquetes de SharePoint Página 31

34 9. Haga clic con el botón 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 14. Guarde el proyecto, genere la solución e implemente el proyecto SPCHOL305Ex1. Página 32

35 Tarea 10: asociar el flujo de trabajo con una lista en SharePoint 1. Busque 2. Haga clic en Acciones del sitio Más 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 Configuración de la lista. Figura 35 - Configuración de la lista 6. En Permisos y administración, haga clic en Configuración del flujo de trabajo. 7. Configure el flujo de trabajo de la lista del siguiente modo: Seleccione una plantilla de flujo de trabajo: PDWorkflowFT 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 Página 33

36 Figura 36 - Configuración del flujo de trabajo 8. Haga clic en Aceptar. 9. Navegue a la lista Customers y seleccione Elementos Nuevo elemento. Figura 37 - Crear un nuevo elemento Página 34

37 10. Escriba Northwind como el nombre del cliente y haga clic en Guardar cuando aparezca el cuadro de diálogo Customers Nuevo elemento. Figura 38 - Cuadro de diálogo Nuevo elemento 11. Espere mientras se crea automáticamente una nueva biblioteca de documentos con el mismo nombre. Resumen del ejercicio En este tutorial, generó una nueva actividad de flujo de trabajo para su uso en flujos de trabajo de SharePoint Designer. Generó un flujo de trabajo reutilizable en SharePoint Designer y usó la actividad personalizada. A continuación, se importó el flujo de trabajo reutilizable a Visual Studio 2010 y se implementó el flujo de trabajo final de vuelta a SharePoint. Ejercicio 2 En este ejercicio, se muestra cómo crear un flujo de trabajo de SharePoint en un formulario de iniciación y procesar los datos del formulario. Tarea 1: asegurarse de que hay una lista Customer en el sitio 1. Vaya al sitio 2. Compruebe que existe una Lista personalizada denominada Customer; de no ser así, cree una. Página 35

38 Tarea 2: crear y preparar el proyecto En esta tarea, creará un proyecto con una solución de flujo de trabajo secuencial y usará los controles de usuario de SharePoint. 1. En Visual Studio 2010 y en el menú seleccione Archivo Nuevo Nuevo proyecto. 2. Seleccione la plantilla de proyecto Flujo de trabajo secuencial de Visual Basic SharePoint Cambie el Nombre a SPCHOL305Ex2. Figura 39 - Cuadro de diálogo Nuevo proyecto 4. Haga clic en Aceptar. Página 36

39 5. Cambie la dirección URL a Figura 40 - Asistente para personalizar SharePoint Haga clic en Siguiente. Figura 41 - Asistente para personalizar SharePoint Haga clic en Siguiente. Página 37

40 6. Cambie La biblioteca o lista a la que va a asociar el flujo de trabajo: a Customer. Figura 42 - Asistente para personalizar SharePoint Haga clic en Siguiente. 7. Desactive El flujo de trabajo se inicia automáticamente cuando se crea un elemento Figura 43 - Asistente para personalizar SharePoint 8. Haga clic en Finalizar. Página 38

41 Tarea 2: crear un formulario de iniciación de flujo de trabajo nuevo que va a usar el flujo de trabajo. 1. Haga clic con el botón secundario en Workflow1 en el proyecto de flujo de trabajo SPCHOL305Ex2 y en Agregar, nuevo elemento Figura 44 - Agregar nuevo elemento 2. Seleccione la plantilla de proyecto Formulario de iniciación de flujo de trabajo de Visual Basic SharePoint Escriba WorkflowInitiationForm.aspx en el cuatro de texto Nombre. Figura 45 - Cuadro de diálogo Nuevo elemento 4. Haga clic en Agregar. Página 39

42 Tarea 3: completar el formulario de iniciación de flujo de trabajo. 1. Agregar el código siguiente al marcador de posición Main. <br /> <br /> <br /> <asp:checkbox ID="Checkbox" runat="server" Text="Cliente de seguimiento rápido" /> Fragmento de código: Mis fragmentos de código spchol305_ex2_initiationform_html Figura 46 - Formulario de iniciación de flujo de trabajo 2. Abra WorkflowInitiationForm.aspx.vb. En el método GetInitiationData sustituya return string.empty; con el código siguiente: Return Checkbox.Checked.ToString() Fragmento de código: Mis fragmentos de código spchol305_ex2_workflowinitiationform Figura 47 - Código del formulario de iniciación de flujo de trabajo Página 40

43 Tarea 4: procesar los datos del formulario de iniciación del flujo de trabajo en Workflow1 1. Abra la Vista Diseñador de Workflow1.vb. En el cuadro de herramientas, agregue una actividad Code (Windows Workflow v3.0) después de activar la actividad onworkflowactivated1. Figura 48 - Diseñador de flujo de trabajo 2. Haga doble clic en codeactivity1 para generar un evento ExecuteCode en el código subyacente. Agregue el código siguiente al método codeactivity1_executecode. Establecer un punto de interrupción en el método. If workflowproperties.initiationdata = "True" Then System.Diagnostics.Debug.WriteLine("Este es un cliente de seguimiento rápido") End If Fragmento de código: Mis fragmentos de código spchol305_ex2_codeactivity1 Figura 49 - Ejecutar método Code Página 41

44 Tarea 5: implementar y depurar Workflow1 1. Presione F5 para implementar y depurar el flujo de trabajo nuevo. 2. Vaya a la lista Customer y cree un elemento nuevo en la lista con el título de Contoso. Figura 50 - Lista Customer 3. Haga clic en la lista desplegable para editar el elemento Contoso y seleccione Flujos de trabajo. Inicie SPCHOL305Ex2 Workflow1 en este elemento. Figura 51 - Iniciar el flujo de trabajo 4. Active la casilla de verificación Seguimiento rápido de cliente y haga clic en el botón Iniciar flujo de trabajo. Figura 52 - Formulario de iniciación de flujo de trabajo Página 42

45 5. Se debería llegar ahora al punto de interrupción que se estableció en el código. Use F10 para desplazarse por el código. Figura 53 - Punto de interrupción en el código 6. Se capturó en la ventana de resultados el valor que se proporcionó en el formulario de iniciación. Figura 54 - Resultado de la depuración 7. Flujo de trabajo completado Figura 55 - Flujo de trabajo completado Resumen del ejercicio En este ejercicio, creó un flujo de trabajo de SharePoint en un formulario de iniciación y procesó los datos del formulario. Página 43

46 Resumen del laboratorio En este laboratorio, ha realizado los ejercicios siguientes: Crear una acción Workflow en Visual Studio Crear un proyecto vacío de SharePoint e incluir la acción Workflow en esta solución. Implementar la acción Workflow como un paquete de soluciones WSP. Usar la acción Workflow para crear un flujo de trabajo reutilizable de SharePoint Designer Usar SharePoint Designer para crear un paquete WSP que se puede volver a importar en Visual Studio Importar un WSP de SharePoint Designer 2010 en Visual Studio Usar Visual Studio 2010 para crear un formulario de iniciación y asociarlo con un flujo de trabajo de SharePoint. En este laboratorio, aprendió a crear una acción Workflow en SharePoint y a incluir esta acción en un paquete de soluciones WSP de SharePoint. Asimismo, usó SharePoint Designer 2010 para crear un flujo de trabajo reutilizable que ha usado la acción Workflow de Visual Studio. Posteriormente, usó SharePoint Designer para generar un WSP que se volvió a importar a Visual Studio. Por otra parte, usó un formulario de iniciación para capturar datos de usuario y procesó estos datos en el flujo de trabajo. Página 44