Documentos de Académico
Documentos de Profesional
Documentos de Cultura
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
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
Recursos
Resources\CS
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
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):
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...:
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.
Pgina 5
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
Pgina 7
7.
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;
Pgina 9
Figura 9 - Firma
Pgina 11
.
Figura 10 - Carpeta asignada de SharePoint
Pgina 12
Pgina 13
Pgina 14
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.
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
Pgina 17
Pgina 18
Pgina 19
.
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.
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.
Pgina 22
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.
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.
Pgina 24
16. Haga clic en el men desplegable SPDWorkflow y, a continuacin, en Enviar a -> Descargar
una copia.
Pgina 25
17. Guarde el WSP en una ubicacin a la que pueda obtener acceso en un paso siguiente (como el
escritorio).
Pgina 26
Pgina 27
Pgina 28
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.
Pgina 30
8. Haga doble clic en el paquete del proyecto SPCHOL305Ex1 y agregue la caracterstica Flujos
de trabajo convertidos al paquete.
Pgina 31
.
Figura 34 - Se configura el nombre del flujo de trabajo importado
Pgina 32
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
Pgina 33
Pgina 34
10. Escriba Northwind como el nombre del cliente y presione Guardar cuando aparezca el cuadro
de dilogo Customers Nuevo elemento.
11. Espere mientras se crea automticamente una nueva biblioteca de documentos con el mismo
nombre.
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.
Pgina 36
Pgina 37
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...
Pgina 39
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.
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");
}
Pgina 41
3. Haga clic en el desplegable de edicin del elemento Contoso y seleccione Flujos de trabajo.
Inicie SPCHOL305Ex2 Workflow1 en este elemento.
4. Compruebe la casilla Fast Track Customer y haga clic en el botn Iniciar flujo de trabajo.
Pgina 42
5. Debera alcanzarse el punto de interrupcin definido en el cdigo. Utilice F10 para recorrer el
cdigo.
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.
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