Introduzione allo sviluppo per SharePoint

Transcript

1 Introduzione allo sviluppo per SharePoint Esercitazione pratica Manuale dell esercitazione SPCHOL305 - Sviluppo di un flusso di lavoro di SharePoint 2010 con un modulo di avvio in Visual Studio VB

2 Questo documento viene fornito «così com è». Le informazioni e le opinioni espresse nel presente documento, inclusi gli URL e altri riferimenti a siti Web Internet, possono essere soggette a modifiche senza preavviso. L utente accetta di utilizzarlo a proprio rischio. Il presente documento non implica la concessione di alcun diritto di proprietà intellettuale relativo ai prodotti Microsoft. È possibile copiare e utilizzare questo documento per fini di riferimento interno Microsoft. Tutti i diritti riservati.

3 Sommario SPCHOL305 -SVILUPPO DI UN FLUSSO DI LAVORO DI SHAREPOINT 2010 CON UN MODULO DI AVVIO... 2 Obiettivo dell esercitazione... 2 Risorse aggiuntive... 2 Informazioni preliminari... 2 Esecuzione dell accesso alla macchina virtuale... 2 Percorsi... 2 Prerequisiti per l esercitazione... 3 Copia di esempi di codice dal documento di Word... 3 Frammenti di codice... 4 Esercizio Attività 1 - Creare e preparare un progetto... 5 Attività 2 - Creare una nuova attività flusso di lavoro per l utilizzo da parte del flusso di lavoro riutilizzabile... 6 Attività 3 - Aggiungere il codice per creare una raccolta documenti in base ai parametri passati all attività... 9 Attività 4 - Configurare l attività per la distribuzione Attività 5 - Aggiungere l attività SPDActivityDemo da distribuire con SPCHOL305Ex Attività 6 - Configurare una funzionalità mediante la relativa finestra di progettazione Attività 7 - Aggiungere un ricevitore di funzionalità e scriverne il codice Attività 8 - Creare un flusso di lavoro riutilizzabile mediante SharePoint Designer Attività 9 - Importare il flusso di lavoro riutilizzabile in Visual Studio Attività 10 - Associare il flusso di lavoro a un elenco in SharePoint Riepilogo dell esercizio Esercizio Attività 1 - Accertarsi che nel sito sia presente un elenco Customer Attività 2 - Creare e preparare un progetto Attività 2 - Creare un nuovo modulo di avvio per l utilizzo da parte del flusso di lavoro Attività 3 - Completare il modulo di avvio del flusso di lavoro Attività 4 - Elaborare i dati del modulo di avvio del flusso di lavoro in Workflow Attività 5 - Distribuire Workflow1 ed eseguirne il debug Riepilogo dell esercizio Riepilogo dell esercitazione Pagina 1

4 SPCHOL305 -Sviluppo di un flusso di lavoro di SharePoint 2010 con un modulo di avvio Tempo previsto per completare l esercitazione: 30 minuti Obiettivo dell esercitazione Informazioni generali sugli esercizi Nel primo esercizio viene illustrato come creare un attività flusso di lavoro personalizzata, utilizzata da un flusso di lavoro riutilizzabile di SharePoint Designer, e come distribuirli insieme come un unico file *.WSP. Viene inoltre illustrato come importare tale flusso di lavoro in Visual Studio Nel secondo esercizio viene illustrato come creare un flusso di lavoro di SharePoint con un modulo di avvio e come elaborare i dati del modulo. Informazioni generali sulle funzionalità SharePoint Designer consente di creare un flusso di lavoro riutilizzabile per più elenchi e siti. Il flusso di lavoro può essere esportato come file di soluzione SharePoint (*.WSP). Risorse aggiuntive In questa esercitazione sono incluse le risorse aggiuntive seguenti: Il manuale di questa esercitazione SPCHOL305_Manual_VB.docx Il presente documento Il codice sorgente Completed\VB\Ex1 Completed\VB\Ex2 Il codice sorgente completo dell esercitazione Risorse Resources\VB Diverse risorse utilizzate in questa esercitazione Informazioni preliminari Esecuzione dell accesso alla macchina virtuale Eseguire l accesso alla macchina virtuale con le credenziali seguenti: Nome utente: Amministratore Password: pass@word1 Percorsi In questa esercitazione pratica sono incluse diverse altre risorse in percorsi fissi. Per impostazione predefinita, si presuppone che la directory di base dell esercitazione pratica sia Supporting Files\SPCHOL305\Resources. La cartella di lavoro predefinita per questa esercitazione è C:\SPHOLs\SPCHOL305. Pagina 2

5 Prerequisiti per l esercitazione 1. Passare alla directory di base Supporting Files\SPCHOL305\Resources dell esercitazione pratica ed eseguire lo script di PowerShell denominato optimize.ps1: Fare clic con il pulsante destro del mouse su optimize.ps1 e scegliere Esegui con PowerShell: Figura 1 - Esecuzione dello script di PowerShell Verrà aperta una finestra di PowerShell per l esecuzione dello script. Attendere che venga completata l esecuzione dello script di PowerShell e che venga chiusa la finestra di PowerShell: Figura 2 - Finestra di PowerShell con lo script in esecuzione Copia di esempi di codice dal documento di Word Copiare e incollare codice da questo documento di Word a Visual Studio è un operazione sicura solo per le sezioni di codice formattato, ad esempio: Console.WriteLine("This is safe code!") Pagina 3

6 Nel codice non incluso in sezioni di questo tipo possono essere presenti caratteri Unicode o altri caratteri invisibili non riconosciuti come codice XML o C#/VB valido, ad esempio: Console.WriteLine( This is NOT safe code!! ) Frammenti di codice Per inserire il codice appropriato nell esercitazione, è inoltre possibile utilizzare frammenti di codice. Per utilizzare il frammento di codice necessario per questa esercitazione: Fare clic con il pulsante destro del mouse sul file di codice in cui si desidera inserire il frammento di codice. Scegliere Inserisci frammento di codice. Selezionare i frammenti di codice dalla raccolta Frammenti di codice. Pagina 4

7 Esercizio 1 In questo esercizio viene illustrato come creare un attività flusso di lavoro personalizzata, utilizzata da un flusso di lavoro riutilizzabile di SharePoint Designer, e come distribuirli insieme come un unico file *.WSP. Viene inoltre illustrato come importare tale flusso di lavoro in Visual Studio Attività 1 - Creare e preparare un progetto In questa attività verrà creata una soluzione Progetto vuoto e verranno utilizzati i controlli utente di SharePoint. 1. Aprire Visual Studio 2010 da Start Tutti i programmi Microsoft Visual Studio 2010 Microsoft Visual Studio In Visual Studio 2010 creare un nuovo progetto da File Nuovo Nuovo progetto. 3. Selezionare il modello di progetto Visual Basic SharePoint 2010 Progetto SharePoint vuoto. 4. Immettere SPCHOL305Ex1 nella casella di testo Nome e c:\sphols\spchol305\vb\ex1 nella casella di testo Percorso. Figura 3 - Finestra di dialogo Nuovo progetto 5. Fare clic su OK. Pagina 5

8 6. Nella Personalizzazione guidata SharePoint specificare come URL e selezionare Distribuisci come soluzione farm. Fare quindi clic su Fine. Figura 4 - Personalizzazione guidata SharePoint 7. In Visual Studio verrà creato il nuovo progetto SPCHOL305Ex1 e verranno aggiunti i file necessari. Attività 2 - Creare una nuova attività flusso di lavoro per l utilizzo da parte del flusso di lavoro riutilizzabile 1. File Aggiungi Nuovo progetto. 2. Per Framework impostare.net Framework 3.5. Figura 5 - Impostazione della versione di.net Framework 3. Selezionare il modello di progetto Visual Basic Workflow Libreria attività flussi di lavoro. Pagina 6

9 4. Nel campo Nome specificare SPDActivityDemo. Figura 6 - Finestra di dialogo Aggiungi nuovo progetto Pagina 7

10 5. Fare clic con il pulsante destro del mouse sul progetto SPDActivityDemo e scegliere Aggiungi riferimento per aggiungere un riferimento a Microsoft.SharePoint.dll e Microsoft.SharePoint.WorkflowActions.dll. A tale scopo, passare a C:\Programmi\Common Files\Microsoft Shared\Web Server Extensions\14\ISAPI e selezionare le DLL necessarie. Figura 7 - Finestra di dialogo Aggiungi riferimento 6. Fare clic con il pulsante destro del mouse su Activity1.vb in Esplora soluzioni e scegliere Rinomina. 7. Rinominare Activity1.vb come CreateDocumentLibrary.vb. Pagina 8

11 Attività 3 - Aggiungere il codice per creare una raccolta documenti in base ai parametri passati all attività 1. Fare clic con il pulsante destro del mouse sul file CreateDocumentLibrary.vb in Esplora soluzioni e scegliere Visualizza codice. 2. Modificare l impostazione della classe di base CreateDocumentLibrary da SequenceActivity ad Activity, come illustrato di seguito. Public class CreateDocumentLibrary Inherits Activity End Class 3. Aggiungere le istruzioni Imports seguenti nella parte superiore del file: Frammento di codice: My Code Snippets spchol305_ex1_createdoclib_namespace Imports Microsoft.SharePoint Imports Microsoft.SharePoint.Workflow Imports Microsoft.SharePoint.WorkflowActions 4. Aggiungere alla classe CreateDocumentLibrary un nuovo elemento DependencyProperty denominato UrlProperty. Questo è il percorso in cui verrà creata la raccolta documenti. Public Shared UrlProperty As DependencyProperty = DependencyProperty.Register("Url", GetType(String), GetType(CreateDocumentLibrary), New PropertyMetadata("")) <DescriptionAttribute("Url of base site")> _ <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 Frammento di codice: My Code Snippets spchol305_ex1_createdoclib_urlproperty Pagina 9

12 5. Aggiungere alla classe CreateDocumentLibrary un nuovo elemento DependencyProperty denominato DocLibNameProperty. Questo sarà il nome della raccolta documenti creata dall attività. Public Shared DocLibNameProperty As DependencyProperty = DependencyProperty.Register("DocLibName", GetType(String), GetType(CreateDocumentLibrary), New PropertyMetadata("")) <DescriptionAttribute("Used as doc lib name")> _ <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 Frammento di codice: My Code Snippets spchol305_ex1_createdoclib_doclibproperty 6. Aggiungere alla classe CreateDocumentLibrary il codice seguente: 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 & " Document Library", SPListTemplateType.DocumentLibrary) Dim spdl As SPList = spw.lists(id) spdl.onquicklaunch = True spdl.update() End Using End Using End Sub Frammento di codice: My Code Snippets spchol305_ex1_createdoclib_execute Pagina 10

13 Attività 4 - Configurare l attività per la distribuzione 1. Configurare l attività per un nome sicuro. Aggiungere SPDActivityDemo.snk dalla cartella Resources (il percorso è riportato all inizio del manuale) al progetto SPDActivityDemo. Figura 8 - Aggiungi Elemento esistente 2. Visualizzare le proprietà del progetto SPDActivityDemo. Fare clic su Firma, quindi selezionare Firma assembly, fare clic su <Cambia> e individuare SPDActivityDemo.snk. Figura 9 - Firma 3. Compilare il progetto (CTRL-MAIUSC-B) e correggere gli eventuali errori. Pagina 11

14 4. Fare clic con il pulsante destro del mouse sul progetto SPCHOL305Ex1, scegliere Aggiungi e quindi Cartella mappata di SharePoint. Figura 10 - Cartella mappata di SharePoint Pagina 12

15 5. Nella finestra di dialogo Aggiungi cartella mappata di SharePoint selezionare Template\1040\Workflow e fare clic su OK. Figura 11 - Finestra di dialogo Aggiungi cartella mappata di SharePoint 6. In Esplora soluzioni espandere la cartella Workflow appena aggiunta. 7. Fare clic con il pulsante destro del mouse sulla cartella SPCHOL305Ex1 (se presente) e scegliere Elimina. 8. Fare clic con il pulsante destro del mouse sulla cartella Workflow e scegliere Aggiungi Nuovo elemento. Pagina 13

16 9. Selezionare il modello File XML, specificare SPDActivityDemo.ACTIONS come nome e quindi fare clic su Aggiungi. Figura 12 - Finestra di dialogo Aggiungi nuovo elemento Pagina 14

17 10. Sostituire il contenuto di SPDActivityDemo.ACTIONS con il codice seguente: <?xml version="1.0" encoding="utf-8"?> <WorkflowInfo> <Actions Sequential="then" Parallel="and"> <Action Name="Create Document Library" ClassName="SPDActivityDemo.CreateDocumentLibrary" Assembly="SPDActivityDemo, Version= , Culture=neutral, PublicKeyToken=a66e91d2ee2fa8f8" AppliesTo="all" Category="Labs"> <RuleDesigner Sentence="Document Library Name %1 to site %2."> <FieldBind Field="DocLibName" Text="Document Library Name" DesignerType="TextArea" Id="1"/> <FieldBind Field="Url" Text="Url of base site" 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> Frammento di codice: My Code Snippets spchol305_ex1_workflowactions_xml 11. Compilare il progetto SPDActivityDemo. Attività 5 - Aggiungere l attività SPDActivityDemo da distribuire con SPCHOL305Ex1 1. In Esplora soluzioni espandere la cartella Package del progetto SPCHOL305Ex1. 2. Fare doppio clic sul file Package.package per visualizzare la finestra di progettazione pacchetti. 3. Fare clic sulla scheda Avanzata nella parte inferiore della finestra di progettazione. Figura 13 - Scheda Avanzata del pacchetto Pagina 15

18 4. Fare clic sul pulsante Aggiungi e quindi su Aggiungi assembly da output del progetto. 5. Nella finestra di dialogo Aggiungi assembly da output del progetto fare clic sulla casella combinata Progetto di origine e selezionare SPDActivityDemo\bin. Figura 14 - Finestra di dialogo Aggiungi assembly da output del progetto 6. Fare clic sul pulsante al di sotto di Controlli sicuri. In Controlli sicuri aggiungere quanto segue: Nome assembly: SPDActivityDemo, Version= , Culture=neutral, PublicKeyToken= a66e91d2ee2fa8f8 Spazio dei nomi: SPDActivityDemo Sicuro: Selezionato Nome tipo: * 7. Dopo avere specificato i dettagli relativi ai controlli sicuri, premere INVIO per confermarli. 8. Fare clic su OK. Pagina 16

19 Attività 6 - Configurare una funzionalità mediante la relativa finestra di progettazione 1. Fare clic con il pulsante destro del mouse sulla cartella Features del progetto SPCHOL305Ex1 in Esplora soluzioni e scegliere Aggiungi funzionalità. 2. Fare clic con il pulsante destro del mouse su Feature1 e rinominarla SPCHOL305Ex1Feature. 3. Nella finestra di progettazione funzionalità impostare l ambito di SPCHOL305Ex1Feature su WebApplication. Figura 15 - Finestra di progettazione funzionalità Attività 7 - Aggiungere un ricevitore di funzionalità e scriverne il codice 1. Fare clic con il pulsante destro del mouse sulla funzionalità SPCHOL305Ex1Feature in Esplora soluzioni e scegliere Aggiungi ricevitore di eventi. 2. Aggiungere un istruzione Imports nella parte superiore del codice: Imports Microsoft.SharePoint.Administration Pagina 17

20 3. Aggiungere il codice seguente alla dichiarazione di classe 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 Frammento di codice: My Code Snippets spchol305_ex1_spchol305feature_receiver 4. Compilare e distribuire il progetto SPCHOL305Ex1 facendo clic con il pulsante destro del mouse sul nome e scegliendo Distribuisci. Figura 16 - Distribuzione della soluzione Pagina 18

21 Attività 8 - Creare un flusso di lavoro riutilizzabile mediante SharePoint Designer 1. Aprire SharePoint Designer 2010 da Start Tutti i programmi SharePoint Microsoft SharePoint Designer Fare clic su Siti e quindi su Apri sito. Figura 17 - Pulsante di menu Siti in SharePoint Designer 2010 Se vengono richieste le credenziali, specificare quanto segue: Nome utente: Amministratore Password: pass@word1 Pagina 19

22 3. Nel campo Nome sito specificare e fare clic su Apri. Figura 18 - Finestra di dialogo Apri sito Pagina 20

23 4. Fare clic sul pulsante Flusso di lavoro riutilizzabile e, quando richiesto, specificare SPDWorkflow come nome, quindi fare clic sul pulsante OK per creare il flusso di lavoro riutilizzabile. Figura 19 - Creazione del flusso di lavoro riutilizzabile Pagina 21

24 5. Fare clic sul pulsante Azione sulla barra multifunzione, scorrere verso il basso fino a visualizzare Labs e quindi selezionare Crea raccolta documenti (Create Document Library). Nota: questa attività è stata creata precedentemente in Visual Studio. Figura 20 - Aggiunta dell azione Crea raccolta documenti Pagina 22

25 6. Fare clic nel Passaggio 1. Nella casella accanto a Document Library Name fare clic sul pulsante fx. 7. Selezionare Elemento corrente come origine dati e Titolo come valore di Campo dall origine. Fare quindi clic su OK. Figura 21 - Finestra di dialogo Cerca Stringa 8. Digitare come URL del sito di base. 9. Fare clic su Salva sulla barra multifunzione. Figura 22 - Configurazione dell azione flusso di lavoro Pagina 23

26 10. Dopo aver eseguito il salvataggio, fare clic sul pulsante Pubblica sulla barra multifunzione. Attendere che il flusso di lavoro venga pubblicato. Figura 23 - Pubblicazione del flusso di lavoro 11. Dopo aver eseguito il salvataggio, fare clic su Flussi di lavoro nel riquadro di spostamento sinistro. 12. Fare di nuovo clic sul flusso di lavoro sotto Flusso di lavoro riutilizzabile per visualizzare le relative proprietà. Fare clic su Salva come modello per salvare il file con estensione wsp nell elenco di SharePoint Raccolta risorse del sito. Figura 24 - Salva come modello Pagina 24

27 13. Accedere al sito da un Web browser. 14. Fare clic su Azioni sito I Visualizza tutto il contenuto del sito, quindi su Raccolta risorse del sito. Figura 25 - Raccolta risorse del sito 15. Fare clic sul menu a discesa SPDWorkflow e scegliere Invia a -> Scarica una copia. Figura 25 - Download del file WSP Pagina 25

28 16. Salvare il file WSP in un percorso a cui sia possibile accedere in un passaggio successivo, ad esempio sul desktop. Figura 26 - Finestra di dialogo Salva con nome Pagina 26

29 Attività 9 - Importare il flusso di lavoro riutilizzabile in Visual Studio 1. Tornando a Visual Studio 2010, nella finestra Esplora soluzioni fare clic con il pulsante destro del mouse sulla soluzione SPCHOL305Ex1 e scegliere Aggiungi Nuovo progetto. 2. Selezionare il modello di progetto Visual Basic SharePoint 2010 Importa flusso di lavoro riutilizzabile. 3. Nel campo Nome specificare SPDWorkflowImport. Figura 27 - Finestra di dialogo Aggiungi nuovo progetto 4. Fare clic su OK. Pagina 27

30 5. Verificare che l URL sia Fare clic su Avanti. Figura 28 - Personalizzazione guidata SharePoint Pagina 28

31 6. Quando viene richiesto il file WSP da importare, selezionare il file SPDWorkflow.wsp salvato in precedenza. Fare clic su Avanti. Figura 29 - Personalizzazione guidata SharePoint Pagina 29

32 7. Fare clic su Fine. NOTA: se si sta utilizzando Visual Studio 2010 Beta 2, verrà generato un errore e non sarà possibile completare l esercitazione. Se si sta utilizzando una versione successiva di Visual Studio 2010, sarà possibile continuare. Figura 30 - Personalizzazione guidata SharePoint Pagina 30

33 8. Fare doppio clic su Package nel progetto SPCHOL305Ex1 e aggiungere al pacchetto la funzionalità Flussi di lavoro convertiti. Figura 31 - Finestra di esplorazione pacchetti di SharePoint Pagina 31

34 9. Fare clic con il pulsante destro del mouse sul progetto SPDWorkflowImport e scegliere Aggiungi riferimento. 10. Selezionare il riferimento di progetto SPDActivityDemo e fare clic su OK. Figura 32 - Aggiunta di un riferimento di assembly 11. Nel progetto SPDWorkflowImport espandere il nodo Workflows\SPDWorkflowFT. 12. Aprire Elements.xml. 13. Come nome (Name) del flusso di lavoro specificare SPDWorkflowFT. Pagina 32 Figura 33 - Impostazione del nome del flusso di lavoro importato 14. Salvare il progetto, compilare la soluzione e distribuire il progetto SPCHOL305Ex1.

35 Attività 10 - Associare il flusso di lavoro a un elenco in SharePoint 1. Accedere al sito 2. Fare clic su Azioni sito Altre opzioni. 3. Selezionare Elenco personalizzato nell elenco degli elementi. 4. Specificare Customers come nome dell elenco e fare clic su Crea. 5. Aprire Impostazioni elenco. Figura 34 - Impostazioni elenco 6. In Autorizzazioni e gestione fare clic su Impostazioni flusso di lavoro. 7. Configurare le impostazioni del flusso di lavoro elenco come segue. Selezionare un modello di flusso di lavoro: PDWorkflowFT Digitare un nome univoco per il flusso di lavoro: Create Doc Lib for Customer Selezionare un elenco di attività: Attività Selezionare un elenco di cronologia: Cronologia flusso di lavoro Pagina 33

36 Opzioni di avvio: Avvia il flusso di lavoro quando viene creato un nuovo elemento Figura 35 - Impostazioni flusso di lavoro 8. Fare clic su OK. 9. Passare all elenco Customers e fare clic su Elementi Nuovo elemento. Figura 36 - Creazione di un nuovo elemento Pagina 34

37 10. Immettere Northwind come nome del nuovo cliente e fare clic su Salva quando viene visualizzata la finestra di dialogo Customers - Nuovo elemento. Figura 37 - Finestra di dialogo Nuovo elemento 11. Attendere che venga creata automaticamente una nuova raccolta documenti con lo stesso nome. Riepilogo dell esercizio In questa procedura dettagliata è stata creata una nuova attività flusso di lavoro da utilizzare nei flussi di lavoro di SharePoint Designer. È stato creato un flusso di lavoro riutilizzabile in SharePoint Designer ed è stata utilizzata l attività personalizzata. Il flusso di lavoro riutilizzabile è stato quindi importato in Visual Studio 2010 e il flusso di lavoro finale è stato quindi ridistribuito in SharePoint. Esercizio 2 In questo esercizio viene illustrato come creare un flusso di lavoro di SharePoint con un modulo di avvio e come elaborare i dati del modulo. Attività 1 - Accertarsi che nel sito sia presente un elenco Customer 1. Accedere al sito 2. Verificare che sia presente un Elenco personalizzato denominato Customer. In caso contrario, crearlo. Pagina 35

38 Attività 2 - Creare e preparare un progetto In questa attività verrà creato un progetto con una soluzione Flusso di lavoro sequenziale e verranno utilizzati i controlli utente di SharePoint. 1. In Visual Studio 2010 scegliere File Nuovo Nuovo progetto dal menu. 2. Selezionare il modello di progetto Visual Basic SharePoint 2010 Flusso di lavoro sequenziale. 3. Nel campo Nome specificare SPCHOL305Ex2. Figura 38 - Finestra di dialogo Nuovo progetto 4. Fare clic su OK. Pagina 36

39 5. Specificare come URL. Figura 39 - Personalizzazione guidata SharePoint 6. Fare clic su Avanti. Figura 40 - Personalizzazione guidata SharePoint Fare clic su Avanti. Pagina 37

40 7. Impostare Libreria o elenco a cui associare il flusso di lavoro su Customer. Figura 41 - Personalizzazione guidata SharePoint Fare clic su Avanti. 8. Deselezionare Il flusso di lavoro viene avviato automaticamente alla creazione di un elemento. Figura 42 - Personalizzazione guidata SharePoint 9. Fare clic su Fine. Pagina 38

41 Attività 2 - Creare un nuovo modulo di avvio per l utilizzo da parte del flusso di lavoro 1. Fare clic con il pulsante destro del mouse su Workflow1 nel progetto flusso di lavoro SPCHOL305Ex2 e scegliere Aggiungi Nuovo elemento. Figura 43 - Aggiunta di un nuovo elemento 2. Selezionare il modello di elemento Visual Basic SharePoint 2010 Form di avvio del flusso di lavoro. 3. Immettere WorkflowInitiationForm.aspx nella casella di testo Nome. Figura 44 - Finestra di dialogo Aggiungi nuovo elemento 4. Fare clic su Aggiungi. Pagina 39

42 Attività 3 - Completare il modulo di avvio del flusso di lavoro 1. Aggiungere al segnaposto di contenuto Main il codice seguente: <br /> <br /> <br /> <asp:checkbox ID="Checkbox" runat="server" Text="Fast Track Customer" /> Frammento di codice: My HTML Snippets spchol305_ex2_initiationform_html Figura 45 - Modulo di avvio del flusso di lavoro 2. Aprire WorkflowInitiationForm.aspx.vb. Nel metodo GetInitiationData sostituire return string.empty; con il codice seguente: Return Checkbox.Checked.ToString() Frammento di codice: My Code Snippets spchol305_ex2_workflowinitiationform Figura 46 - Codice del modulo di avvio del flusso di lavoro Pagina 40

43 Attività 4 - Elaborare i dati del modulo di avvio del flusso di lavoro in Workflow1 1. Aprire la finestra Progettazione visualizzazioni di Workflow1.vb. Dalla Casella degli strumenti aggiungere un attività Code (Windows Workflow v3.0) dopo l attività onworkflowactivated1. Figura 47 - Progettazione flussi di lavoro 2. Fare doppio clic su codeactivity1 per generare un evento ExecuteCode nel codice associato. Aggiungere al metodo codeactivity1_executecode il codice riportato di seguito. Impostare un punto di interruzione nel metodo. If workflowproperties.initiationdata = "True" Then System.Diagnostics.Debug.WriteLine("This is a fast track customer") End If Frammento di codice: My Code Snippets spchol305_ex2_codeactivity1 Figura 48 - Metodo ExecuteCode Pagina 41

44 Attività 5 - Distribuire Workflow1 ed eseguirne il debug 1. Premere F5 per distribuire il nuovo flusso di lavoro ed eseguirne il debug. 2. Passare all elenco Customer e crearvi un nuovo elemento che abbia Contoso come titolo. Figura 49 - Elenco Customer 3. Fare clic sull elenco a discesa di modifica relativo all elemento Contoso e selezionare Flussi di lavoro. Avviare SPCHOL305Ex2 - Workflow1 per tale elemento. Figura 50 - Avvio del flusso di lavoro 4. Selezionare la casella di controllo Fast Track Customer e fare clic sul pulsante Avvia flusso di lavoro. Figura 51 - Modulo di avvio del flusso di lavoro Pagina 42

45 5. Dovrebbe ora essere raggiunto il punto di interruzione impostato nel codice. Premere F10 per eseguire un istruzione alla volta del codice. Figura 52 - Punto di interruzione nel codice 6. Il valore inviato nel modulo di avvio è stato acquisito nella finestra di output. Figura 53 - Debug dell output 7. Il flusso di lavoro è stato così completato. Figura 54 - Flusso di lavoro completato Riepilogo dell esercizio In questo esercizio è stato creato un flusso di lavoro di SharePoint con un modulo di avvio e sono stati elaborati i dati del modulo. Pagina 43

46 Riepilogo dell esercitazione In questa esercitazione sono stati eseguiti gli esercizi seguenti: È stata creata un azione flusso di lavoro in Visual Studio È stato creato un progetto di SharePoint vuoto e in tale soluzione è stata inclusa l azione flusso di lavoro. L azione flusso di lavoro è stata distribuita come un pacchetto della soluzione WSP. L azione flusso di lavoro è stata utilizzata per creare un flusso di lavoro riutilizzabile di SharePoint Designer È stato utilizzato SharePoint Designer per creare un pacchetto WSP da poter reimportare in Visual Studio È stato importato in Visual Studio 2010 un file WSP di SharePoint Designer È stato utilizzato Visual Studio 2010 per creare un modulo di avvio e associarlo a un flusso di lavoro di SharePoint. In questa esercitazione si è appreso come creare un azione flusso di lavoro di SharePoint. Si è quindi appreso come includere tale azione in un pacchetto della soluzione WSP di SharePoint. È stato inoltre utilizzato SharePoint Designer 2010 per creare un flusso di lavoro riutilizzabile che applicasse l azione flusso di lavoro di Visual Studio. È stato successivamente utilizzato SharePoint Designer per generare un file WSP da reimportare in Visual Studio. È stato infine utilizzato un modulo di avvio per acquisire i dati utente e tali dati sono stati elaborati nel flusso di lavoro. Pagina 44