Está en la página 1de 46

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.

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 1

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

Cdigo fuente del laboratorio completado.

Completed\CS\Ex2
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 2

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 3

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 4

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 5

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 6

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.

Figura 6 - Cuadro de dilogo Nuevo proyecto

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 7

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 8

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 9

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 10

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 11

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 12

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 13

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 14

11. 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=1.0.0.0,
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 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 15

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 16

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 17

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 = "<authorizedType Assembly=\"SPDActivityDemo, "
+ "Version=1.0.0.0, Culture=neutral, PublicKeyToken=a66e91d2ee2fa8f8\" "
+ "Namespace=\"SPDActivityDemo\" TypeName=\"*\" Authorized=\"True\" />";
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 18

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 19

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

.
Figura 18 - Cuadro de dilogo Abrir sitio

Pgina 20

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 21

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 22

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 23

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 24

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 25

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 26

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.

Figura 28 - Cuadro de dilogo Nuevo proyecto

4. Haga clic en Aceptar.

Pgina 27

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

Figura 29 - Asistente para personalizar SharePoint

Pgina 28

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

Pgina 29

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.

Figura 31 - Asistente para personalizar SharePoint

Pgina 30

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 31

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 32

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.
2.
3.
4.
5.

Busque http://intranet.contoso.com.
Haga clic en Acciones del sitio | Ms opciones.
Seleccione Lista personalizada en la lista de elementos.
Asigne el nombre Customers a la lista y haga clic en Crear.
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 33

Figura 36 - Configuracin del flujo de trabajo

8. Haga clic en Aceptar.


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

Figura 37 - Creacin de un nuevo elemento

Pgina 34

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 35

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.

Figura 39 - Cuadro de dilogo Nuevo proyecto

4. Haga clic en Aceptar.

Pgina 36

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

Figura 40 - Asistente para personalizar SharePoint

6. Haga clic en Siguiente.

Figura 41 - Asistente para personalizar SharePoint

Haga clic en Siguiente.

Pgina 37

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

Figura 42 - Asistente para personalizar SharePoint

Haga clic en Siguiente.


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

Figura 43 - Asistente para personalizar SharePoint

9. Haga clic en Finalizar.


Pgina 38

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 39

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


1. Agregue el siguiente cdigo al marcador de posicin principal
<br />
<br />
<br />
<asp:CheckBox ID="Checkbox" runat="server" Text="Fast Track Customer" />

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 40

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 41

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 42

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 43

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.

Pgina 44

También podría gustarte