Eine Einführung für SharePoint-Entwickler. Praktische Übung. Übungsanleitung

Transkript

1 Eine Einführung für SharePoint-Entwickler Praktische Übung Übungsanleitung SPCHOL305 Entwickeln eines SharePoint 2010-Workflows mit Initiierungsformularen in Visual Studio 2010 C#

2 Dieses Dokument wird "wie besehen" bereitgestellt. Die in diesem Dokument enthaltenen Informationen und Ansichten, einschließlich URLs und Verweise auf Internetwebsites, können ohne vorherige Ankündigung geändert werden. Das Risiko der Nutzung liegt bei Ihnen. Mit diesem Dokument werden keine Rechte an geistigem Eigentum an einem Microsoft-Produkt auf Sie übertragen. Sie sind berechtigt, dieses Dokument zu kopieren und für eigene interne Referenzzwecke zu nutzen Microsoft Corporation. Alle Rechte vorbehalten.

3 Inhalt SPCHOL305 ENTWICKELN EINES SHAREPOINT 2010-WORKFLOWS MIT INITIIERUNGSFORMULAREN. 2 Übungsziel... 2 Weitere Ressourcen... 2 Erste Schritte... 2 Anmelden beim virtuellen Computer... 2 Speicherorte... 2 Voraussetzungen für diese praktische Übung... 3 Kopieren von Codebeispielen aus einem Word-Dokument... 3 Codeausschnitte... 4 Übung 1:... 5 Aufgabe 1: Erstellen und Vorbereiten des Projekts... 5 Aufgabe 2: Erstellen einer neuen Workflowaktivität zur Verwendung durch den wiederverwendbaren Workflow... 6 Aufgabe 3: Hinzufügen von Code zum Erstellen einer Dokumentbibliothek auf Basis von Parametern, die an die Aktivität übergeben werden... 9 Aufgabe 4: Konfigurieren der Aktivität für die Bereitstellung Aufgabe 5: Hinzufügen der mit SPCHOL305Ex1 bereitzustellenden SPDActivityDemo -Aktivität Aufgabe 6: Konfigurieren eines Features mithilfe des Feature-Designers Aufgabe 7: Hinzufügen und Programmieren eines Featureempfängers Aufgabe 8: Erstellen eines wiederverwendbaren Workflows mithilfe von SharePoint Designer Aufgabe 9: Importieren des wiederverwendbaren Workflows in Visual Studio Aufgabe 10: Zuordnen eines Workflows zu einer Liste in SharePoint Zusammenfassung der Übung Übung 2: Aufgabe 1: Sicherstellen, dass die Website die Liste Customer enthält Aufgabe 2: Erstellen und Vorbereiten des Projekts Aufgabe 2: Erstellen eines neuen Workflowinitiierungsformulars zur Verwendung durch den wiederverwendbaren Workflow Aufgabe 3: Vervollständigen des Workflowinitiierungsformulars Aufgabe 4: Verarbeiten des Workflowinitiierungsformulars in Workflow Aufgabe 5: Bereitstellen und Debuggen von Workflow Zusammenfassung der Übung Übungszusammenfassung Seite 1

4 SPCHOL305 Entwickeln eines SharePoint 2010-Workflows mit Initiierungsformularen Voraussichtliche Zeit zum Durcharbeiten dieser Übung: 30 Minuten Übungsziel Übersicht über die Übung In der ersten Übung wird veranschaulicht, wie Sie eine benutzerdefinierte Workflowaktivität erstellen, die von einem wiederverwendbaren SharePoint Designer-Workflow verwendet wird, und beides zusammen als einzelne WSP-Datei bereitstellen. Außerdem wird gezeigt, wie Sie diesen Workflow in Visual Studio 2010 importieren. In der zweiten Übung wird gezeigt, wie Sie einen SharePoint-Workflow mit einem Initiierungsformular erstellen und die Formulardaten verarbeiten. Featureübersicht SharePoint Designer ermöglicht das Erstellen eines Workflows, der für mehrere Listen und Websites wiederverwendet werden kann. Der Workflow kann als SharePoint-Lösungsdatei (*.wsp) exportiert werden. Weitere Ressourcen Zu dieser Übung gehören die folgenden weiteren Ressourcen: Diese Übungsanleitung Quellcode SPCHOL305_Manual_CS.docx Completed\CS\Ex1 Completed\CS\Ex2 Dieses Dokument Vervollständigter Übungsquellcode Ressourcen Resources\CS Verschiedene andere im Verlauf dieser Übung verwendete Ressourcen Erste Schritte Anmelden beim virtuellen Computer Melden Sie sich beim virtuellen Computer als der folgende Benutzer an: Benutzername: Administrator Kennwort: Speicherorte Zu dieser praktischen Übung gehören verschiedene weitere Ressourcen an festen Speicherorten. Standardmäßig wird vorausgesetzt, dass C:\Content Packs\Packs\SharePoint 2010 Developer Labs 1.0\Supporting Files\SPCHOL305\Resources das Basisverzeichnis dieser praktischen Übung ist. Der standardmäßige Arbeitsordner für diese praktische Übung ist C:\SPHOLS\SPCHOL305. Seite 2

5 Voraussetzungen für diese praktische Übung 1. Wechseln Sie zum Basisverzeichnis Supporting Files\SPCHOL305\Resources dieser praktischen Übung, und führen Sie das PowerShell-Skript optimize.ps1 aus: Klicken Sie mit der rechten Maustaste auf optimize.ps1, und wählen Sie Mit PowerShell ausführen aus: Abbildung1: Ausführen des PowerShell-Skripts Hierdurch wird ein PowerShell-Fenster zum Ausführen des Skripts geöffnet. Warten Sie ab, bis die Ausführung des PowerShell-Skripts beendet und das PowerShell-Fenster geschlossen wurde (was eine gewisse Zeit dauern kann): Abbildung 2: PowerShell-Fenster, in dem das Skript ausgeführt wird Kopieren von Codebeispielen aus einem Word-Dokument Das Kopieren und Einfügen von Code aus diesem Word-Dokument in Visual Studio ist nur für die Abschnitte mit formatiertem Code sicher. Beispiel: Console.WriteLine("Dieser Code ist sicher!"); Seite 3

6 Nicht in diesen Abschnitten enthaltener Code kann Unicode- oder andere unsichtbare Zeichen erhalten, die keinen gültigen XML- oder C#-/VB-Code darstellen. Beispiel: Console.WriteLine ( Dieser Code ist NICHT sicher!! ); Codeausschnitte Sie können auch mit Codeausschnitten arbeiten, um den in dieser Übung benötigten Code einzufügen. So verwenden Sie den für diese Übung benötigten Codeausschnitt Klicken Sie mit der rechten Maustaste an der Stelle auf die Codedatei, an der Sie den Codeausschnitt einfügen möchten. Wählen Sie Codeausschnitt einfügen aus. Wählen Sie im Katalog Eigene Codeausschnitte Codeausschnitte aus. Seite 4

7 Übung 1: In dieser Übung wird veranschaulicht, wie Sie eine benutzerdefinierte Workflowaktivität erstellen, die von einem wiederverwendbaren SharePoint Designer-Workflow verwendet wird, und beides zusammen als einzelne WSP-Datei bereitstellen. Außerdem wird gezeigt, wie Sie diesen Workflow in Visual Studio 2010 importieren. Aufgabe 1: Erstellen und Vorbereiten des Projekts In dieser Aufgabe erstellen Sie eine Projektmappe des Typs Leeres Projekt und verwenden SharePoint-Benutzersteuerelemente. 1. Öffnen Sie Visual Studio 2010, indem Sie im Startmenü Alle Programme, dann Microsoft Visual Studio 2010 und danach Microsoft Visual Studio 2010 auswählen. 2. Erstellen Sie in Visual Studio 2010 ein neues Projekt, indem Sie im Menü Datei die Option Neu und dann Projekt auswählen. 3. Wählen Sie Visual C#, danach SharePoint und dann 2010 und hier die Projektvorlage Leeres SharePoint-Projekt aus. 4. Geben Sie SPCHOL305Ex1 in das Textfeld Name und C:\SPHOLS\SPCHOL305\CS\Ex1 in das Textfeld Speicherort ein. Seite 5 Abbildung 3: Dialogfeld Neues Projekt 5. Klicken Sie auf OK.

8 6. Ändern Sie im Assistenten zum Anpassen von SharePoint die URL in und wählen Sie Als Farmlösung bereitstellen aus. Klicken Sie dann auf Fertig stellen. Abbildung 4: Assistent zum Anpassen von SharePoint 7. Das neue Projekt SPCHOL305Ex1 und die notwendigen Dateien werden von Visual Studio erstellt. Aufgabe 2: Erstellen einer neuen Workflowaktivität zur Verwendung durch den wiederverwendbaren Workflow 1. Fügen Sie in Visual Studio 2010 ein neues Projekt hinzu, indem Sie im Menü Datei die Option Hinzufügen und dann Neues Projekt auswählen. 2. Ändern Sie die Frameworkeinstellung in.net Framework 3.5. Abbildung 5: Festlegen der.net Framework-Version Seite 6

9 3. Wählen Sie Visual C#, dann Workflow und danach die Projektvorlage Workflowaktivitätsbibliothek aus. 4. Geben Sie SPDActivityDemo in das Textfeld Name ein, und klicken Sie auf OK. Abbildung 6: Dialogfeld Neues Projekt 5. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt SPDActivityDemo, und wählen Sie Verweis hinzufügen aus. 6. Wechseln Sie zur Registerkarte Durchsuchen. Geben Sie C:\Programme\Gemeinsame Dateien\Microsoft Shared\Web Server Extensions\14\ISAPI in das Textfeld Dateiname ein, und drücken Sie die EINGABETASTE. Seite 7

10 7. Wählen Sie Microsoft.SharePoint.dll und Microsoft.SharePoint.WorkflowActions.dll aus, und klicken Sie auf OK. Abbildung 7: Dialogfeld Verweis hinzufügen 8. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Activity1.cs, und wählen Sie Umbenennen aus. 9. Benennen Sie Activity1.cs in CreateDocumentLibrary.cs um. Seite 8

11 Aufgabe 3: Hinzufügen von Code zum Erstellen einer Dokumentbibliothek auf Basis von Parametern, die an die Aktivität übergeben werden 1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Datei CreateDocumentLibrary.cs, und wählen Sie Code anzeigen aus. 2. Ändern Sie die Einstellung für die CreateDocumentLibrary-Basisklasse von SequenceActivity in Activity, wie im Folgenden gezeigt wird. public partial class CreateDocumentLibrary : Activity 3. Fügen Sie am Anfang der Datei die folgenden using-anweisungen unterhalb der vorhandenen using-anweisungen hinzu: using Microsoft.SharePoint; using Microsoft.SharePoint.Workflow; using Microsoft.SharePoint.WorkflowActions; Codeausschnitt: Eigene Codeausschnitte spchol305_ex1_createdoclib_namespace 4. Fügen Sie der CreateDocumentLibrary-Klasse ein neues DependencyProperty-Element mit dem Namen UrlProperty hinzu. Dies ist der Speicherort, an dem die Dokumentbibliothek erstellt wird. 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); } } Codeausschnitt: Eigene Codeausschnitte spchol305_ex1_createdoclib_urlproperty Seite 9

12 5. Fügen Sie der CreateDocumentLibrary-Klasse ein neues DependencyProperty-Element mit dem Namen DocLibNameProperty hinzu. Dies ist der Name der Dokumentbibliothek, die durch die Aktivität erstellt wird. 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); } } Codeausschnitt: Eigene Codeausschnitte spchol305_ex1_createdoclib_doclibproperty 6. Fügen Sie den folgenden Code unterhalb des CreateDocumentLibrary-Konstruktors hinzu: 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(); } } } Codeausschnitt: Eigene Codeausschnitte spchol305_ex1_createdoclib_execute Seite 10

13 Aufgabe 4: Konfigurieren der Aktivität für die Bereitstellung 1. Konfigurieren Sie die Aktivität für die Verwendung eines starken Namens. Fügen Sie SPDActivityDemo.snk aus dem Ordner Resources (dem Speicherort vom Anfang dieser Anleitung) dem Projekt SPDActivityDemo hinzu. Abbildung 8: Vorhandenes Element hinzufügen 2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt SPDActivityDemo, und wählen Sie Eigenschaften aus. 3. Klicken Sie auf die Registerkarte Signierung, aktivieren Sie Assembly signieren, und wählen Sie dann SPDActivityDemo.snk aus. Abbildung 9: Signierung 4. Erstellen Sie das Projekt (STRG+UMSCHALT+B), und beheben Sie alle Fehler, die möglicherweise gemeldet wurden. Seite 11

14 5. Klicken Sie mit der rechten Maustaste auf das Projekt SPCHOL305Ex1, klicken Sie auf Hinzufügen und dann auf Zugeordneter SharePoint-Ordner. Abbildung 10: Befehl Zugeordneter SharePoint-Ordner Seite 12

15 6. Wählen Sie im Dialogfeld Zugeordneten SharePoint-Ordner hinzufügen das Verzeichnis Template\1033\Workflow aus, und klicken Sie dann auf OK. Abbildung 11: Dialogfeld Zugeordneten SharePoint-Ordner hinzufügen 7. Erweitern Sie im Projektmappen-Explorer den neu hinzugefügten Ordner Workflow. 8. Klicken Sie mit der rechten Maustaste auf den Ordner SPCHOL305Ex1 (falls vorhanden), und wählen Sie Löschen aus. 9. Klicken Sie mit der rechten Maustaste auf den Ordner Workflow, und wählen Sie Hinzufügen und anschließend Neues Element aus. Seite 13

16 10. Wählen Sie die Vorlage XML-Datei aus, geben Sie der Datei den Namen SPDActivityDemo.ACTIONS, und klicken Sie dann auf Hinzufügen. Abbildung 12: Dialogfeld Neues Element hinzufügen Seite 14

17 11. Ersetzen Sie den Inhalt der Datei SPDActivityDemo.ACTIONS durch folgenden Code: <?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> Codeausschnitt: Eigene Codeausschnitte spchol305_ex1_workflowactions_xml 12. Erstellen Sie das Projekt SPDActivityDemo. Aufgabe 5: Hinzufügen der mit SPCHOL305Ex1 bereitzustellenden SPDActivityDemo - Aktivität 1. Erweitern Sie im Projektmappen-Explorer den Ordner Paket unter dem Projekt SPCHOL305Ex1. 2. Doppelklicken Sie auf die Datei Package.package, um den Paket-Designer zu öffnen. 3. Klicken Sie unten im Designer auf die Registerkarte Erweitert. Seite 15 Abbildung 13: Registerkarte für erweiterte Paketoptionen

18 4. Klicken Sie auf die Schaltfläche Hinzufügen, und wählen Sie Assembly aus Projektausgabe hinzufügen aus. 5. Klicken Sie im Dialogfeld Assembly aus Projektausgabe hinzufügen auf das Kombinationsfeld Quellprojekt, und wählen Sie SPDActivityDemo\bin aus. Abbildung 14: Dialogfeld Assembly aus Projektausgabe hinzufügen 6. Klicken Sie auf die Schaltfläche unter Sichere Steuerelemente. Fügen Sie in Sichere Steuerelemente Folgendes hinzu: Assemblyname: SPDActivityDemo, Version= , Culture=neutral, PublicKeyToken= a66e91d2ee2fa8f8 Namespace: SPDActivityDemo Sicher: Aktiviert Typname: * 7. Drücken Sie, wenn Sie alle Details für das sichere Steuerelement eingegeben haben, die EINGABETASTE, um die Eingabe zu bestätigen. 8. Klicken Sie auf OK. Seite 16

19 Aufgabe 6: Konfigurieren eines Features mithilfe des Feature-Designers 1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Ordner Features unter dem Projekt SPCHOL305Ex1, und wählen Sie Feature hinzufügen aus. 2. Klicken Sie mit der rechten Maustaste auf Feature1, und benennen Sie es in SPCHOL305Ex1Feature um. 3. Ändern Sie im Feature-Designer den Bereich von SPCHOL305Ex1Feature in WebApplication. Abbildung 15: Feature-Designer Aufgabe 7: Hinzufügen und Programmieren eines Featureempfängers 1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf SPCHOL305Ex1Feature, und wählen Sie Ereignisempfänger hinzufügen aus. 2. Fügen Sie am Anfang des Codes eine using-anweisung hinzu: using Microsoft.SharePoint.Administration; Seite 17

20 3. Fügen Sie der FeatureReceiver-Klassendeklaration folgenden Code hinzu: 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= , Culture=neutral, PublicKeyToken=a66e91d2ee2fa8f8\" " + "Namespace=\"SPDActivityDemo\" TypeName=\"*\" Authorized=\"True\" />"; wappcurrent.webconfigmodifications.add(modauthorizedtype); wappcurrent.webservice.applywebconfigmodifications(); } Codeausschnitt: Eigene Codeausschnitte spchol305_ex1_spchol305feature_receiver 4. Klicken Sie mit der rechten Maustaste auf das Projekt SPCHOL305Ex1Feature, und wählen Sie Bereitstellen aus, um das Projekt zu erstellen und bereitzustellen. Abbildung 16: Bereitstellen der Projektmappe Seite 18

21 Aufgabe 8: Erstellen eines wiederverwendbaren Workflows mithilfe von SharePoint Designer 1. Öffnen Sie SharePoint Designer 2010, indem Sie im Startmenü Alle Programme, dann SharePoint und anschließend Microsoft SharePoint Designer 2010 auswählen. 2. Klicken Sie auf Websites und dann auf Website öffnen. Abbildung 17: Menüschaltfläche Website öffnen in SharePoint Designer 2010 Verwenden Sie folgende Informationen, wenn Sie zur Angabe von Anmeldeinformationen aufgefordert werden: Benutzername: Administrator Kennwort: Seite 19

22 3. Ändern Sie den Websitenamen in und wählen Sie dann Öffnen aus. Abbildung 18: Dialogfeld Website öffnen Seite 20

23 4. Klicken Sie auf die Schaltfläche Wieder verwendbarer Workflow, und geben Sie ihm, wenn die entsprechende Aufforderung angezeigt wird, den Namen SPDWorkflow. Klicken Sie dann auf die Schaltfläche OK, um den wiederverwendbaren Workflow zu erstellen. Abbildung 19: Erstellen eines wiederverwendbaren Workflows Seite 21

24 5. Klicken Sie im Menüband auf die Schaltfläche Aktionen, führen Sie einen Bildlauf zu Labs durch, und klicken Sie dann auf Dokumentbibliothek erstellen. Hinweis: Dies ist die Aktivität, die zuvor in Visual Studio erstellt wurde. Abbildung 20: Hinzufügen der Aktion Dokumentbibliothek erstellen 6. Klicken Sie in Schritt 1 neben Dokumentbibliothekname auf die Schaltfläche Fx. 7. Wählen Sie Aktuelles Element unter Datenquelle und Titel als Wert in Quellenfeld aus. Klicken Sie dann auf OK. Seite 22

25 Abbildung 21: Dialogfeld Nachschlagen für Zeichenfolge 8. Geben Sie als URL der Basiswebsite ein. 9. Klicken Sie im Menüband auf Speichern. Abbildung 22: Konfigurieren der Workflowaktion 10. Klicken Sie nach dem Speichern im Menüband auf Veröffentlichen. Warten Sie, bis der Workflow veröffentlicht wurde. Seite 23

26 Abbildung 23: Veröffentlichen des Workflows 11. Klicken Sie nach dem Speichern im linken Navigationsbereich auf Workflows. 12. Klicken Sie unterhalb von Wieder verwendbarer Workflow erneut auf den Workflow, um die Workfloweigenschaften anzuzeigen. Klicken Sie auf Als Vorlage speichern, um die WSP-Datei in der SharePoint-Liste Websiteobjektbibliothek zu speichern. Abbildung 24: Option Als Vorlage speichern Seite 24

27 13. Öffnen Sie in einem Webbrowser. 14. Klicken Sie auf Websiteaktionen, danach auf Alle Websiteinhalte einblenden und dann auf Websiteobjektbibliothek. Abbildung 25: Bibliothek Websiteobjekte Klicken Sie auf das Dropdownmenü SPDWorkflow, klicken Sie auf Senden an und dann auf Eine Kopie herunterladen. Abbildung 25: Herunterladen einer WSP-Datei Seite 25

28 15. Speichern Sie die WSP-Datei an einem Speicherort, auf den Sie in einem nachfolgenden Schritt zugreifen können (z. B. im Ordner Desktop) Abbildung 26: Dialogfeld Speichern unter Seite 26

29 Aufgabe 9: Importieren des wiederverwendbaren Workflows in Visual Studio 1. Klicken Sie in Visual Studio 2010 im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe SPCHOL305Ex1, klicken Sie dann auf Hinzufügen und danach auf Neues Projekt. 2. Wählen Sie Visual C#, danach SharePoint und dann 2010 und hier die Projektvorlage Wieder verwendbaren Workflow importieren aus. 3. Ändern Sie den Namen in SPDWorkflowImport. Abbildung 27: Dialogfeld Neues Projekt 4. Klicken Sie auf OK. Seite 27

30 5. Stellen Sie sicher, dass die URL lautet. Klicken Sie auf Weiter. Abbildung 28: Assistent zum Anpassen von SharePoint Seite 28

31 6. Wenn Sie zur Angabe der zu importierenden WSP-Datei aufgefordert werden, navigieren Sie zur Datei SPDWorkflow.wsp, die Sie zuvor gespeichert haben. Klicken Sie auf Weiter. Abbildung 29: Assistent zum Anpassen von SharePoint Seite 29

32 7. Klicken Sie auf Fertig stellen. Hinweis: Wenn Sie mit Visual Studio 2010 Beta 2 arbeiten, tritt ein Fehler auf, der Sie am Abschließen dieser praktischen Übung hindert. Wenn Sie eine spätere Version von Visual Studio 2010 verwenden, können Sie fortfahren. Abbildung 30: Assistent zum Anpassen von SharePoint Seite 30

33 8. Doppelklicken Sie im Projekt SPCHOL305Ex1 auf Paket, und fügen Sie das Feature Konvertierte Workflows zum Paket hinzu. Abbildung 31: SharePoint-Paket-Explorer Seite 31

34 9. Klicken Sie mit der rechten Maustaste auf das Projekt SPDWorkflowImport, und wählen Sie Verweis hinzufügen aus. 10. Wählen Sie den Projektverweis SPDActivityDemo aus, und klicken Sie auf OK. Abbildung 32: Hinzufügen eines Assemblyverweises 11. Erweitern Sie unter dem Projekt SPDWorkflowImport den Knoten Workflows\SPDWorkflowFT. 12. Öffnen Sie Elements.xml. 13. Ändern Sie den Workflownamen in SPDWorkflowFT. Abbildung 33: Festlegen des Namens für den importierten Workflow Seite 32

35 14. Speichern Sie das Projekt, erstellen Sie die Projektmappe, und stellen Sie das Projekt SPCHOL305Ex1 bereit. Aufgabe 10: Zuordnen eines Workflows zu einer Liste in SharePoint 1. Navigieren Sie zu 2. Klicken Sie auf Websiteaktionen und dann auf Weitere Optionen. 3. Wählen Sie in der Elementliste Benutzerdefinierte Liste aus. 4. Geben Sie der Liste den Namen Customers, und klicken Sie auf Erstellen. 5. Öffnen Sie die Listeneinstellungen. Abbildung 34: Option Listeneinstellungen 6. Klicken Sie unter Berechtigungen und Verwaltung auf Workfloweinstellungen. 7. Konfigurieren Sie die Liste mit den Workfloweinstellungen wie folgt: Wählen Sie eine Workflowvorlage aus: SPDWorkflowFT Geben Sie einen eindeutigen Namen für diesen Workflow ein: Create Doc Lib for Customer Wählen Sie eine Aufgabenliste aus: Aufgaben Wählen Sie eine Verlaufsliste aus: Workflowverlauf Startoptionen: Diesen Workflow starten, wenn ein neues Element erstellt wird Seite 33

36 Abbildung 35: Workfloweinstellungen 8. Klicken Sie auf OK. 9. Navigieren Sie zur Liste Customers, und wählen Sie Elemente und dann Neues Element aus. Abbildung 36: Erstellen eines neuen Elements Seite 34

37 10. Geben Sie Northwind als Name des neuen Kunden ein, und klicken Sie auf Speichern, wenn das Dialogfeld Customers Neues Element angezeigt wird. Abbildung 37: Dialogfeld Neues Element 11. Warten Sie, bis automatisch eine neue Dokumentbibliothek mit diesem Namen erstellt wird. Zusammenfassung der Übung In dieser Übung haben Sie eine neue Workflowaktivität für die Nutzung in SharePoint Designer- Workflows erstellt. Sie haben einen wiederverwendbaren Workflow in SharePoint Designer erstellt und die benutzerdefinierte Aktivität verwendet. Anschließend haben Sie diesen wiederverwendbaren Workflow in Visual Studio 2010 importiert und den endgültigen Workflow wieder in SharePoint veröffentlicht. Seite 35

38 Übung 2: In dieser Übung wird gezeigt, wie Sie einen SharePoint-Workflow mit einem Initiierungsformular erstellen und die Formulardaten verarbeiten. Aufgabe 1: Sicherstellen, dass die Website die Liste Customer enthält 1. Navigieren Sie zur Website 2. Vergewissern Sie sich, dass die benutzerdefinierte Liste Customer vorhanden ist. Falls nicht, erstellen Sie sie. Aufgabe 2: Erstellen und Vorbereiten des Projekts In dieser Aufgabe erstellen Sie eine Projektmappe vom Typ Sequenzieller Workflow und verwenden SharePoint-Benutzersteuerelemente. 1. Wählen Sie im Visual Studio 2010-Menü Datei die Option Neu und dann Neues Projekt aus. 2. Wählen Sie Visual C#, danach SharePoint und dann 2010 und hier die Projektvorlage Sequenzieller Workflow aus. 3. Ändern Sie den Namen in SPCHOL305Ex2. Abbildung 38: Dialogfeld Neues Projekt 4. Klicken Sie auf OK. Seite 36

39 5. Ändern Sie die URL in 6. Abbildung 39: Assistent zum Anpassen von SharePoint Klicken Sie auf Weiter. Abbildung 40: Assistent zum Anpassen von SharePoint Klicken Sie auf Weiter. Seite 37

40 7. Ändern Sie Die Bibliothek oder Liste, der der Workflow zugeordnet werden soll: in Customer. Abbildung 41: Assistent zum Anpassen von SharePoint Klicken Sie auf Weiter. 8. Deaktivieren Sie Der Workflow wird automatisch gestartet, wenn ein Element erstellt wird. Abbildung 42: Assistent zum Anpassen von SharePoint 9. Klicken Sie auf Fertig stellen. Seite 38

41 Aufgabe 2: Erstellen eines neuen Workflowinitiierungsformulars zur Verwendung durch den wiederverwendbaren Workflow 1. Klicken Sie im Workflowprojekt SPCHOL305Ex2 mit der rechten Maustaste auf den Ordner Workflow1, und wählen Sie Hinzufügen und anschließend Neues Element aus. Abbildung 43: Neues Element hinzufügen 2. Wählen Sie Visual C#, danach SharePoint und dann 2010 und hier die Elementvorlage Workflowinitiierungsformular aus. 3. Ändern Sie den Eintrag Name in WorkflowIntiationForm.aspx. Abbildung 44: Dialogfeld Neues Element hinzufügen 4. Klicken Sie auf Hinzufügen. Seite 39

42 Aufgabe 3: Vervollständigen des Workflowinitiierungsformulars 1. Fügen Sie dem Inhaltsplatzhalter Main den folgenden Code hinzu: <br /> <br /> <br /> <asp:checkbox ID="Checkbox" runat="server" Text="Fast Track Customer" /> Codeausschnitt: Eigene HTML-Ausschnitte spchol305_ex2_initiationform_html Abbildung 45: Workflowinitiierungsformular 2. Öffnen Sie WorkflowInitiationForm.aspx.cs. Ersetzen Sie return string.empty; in der GetInitiationData-Methode durch folgenden Code: return Checkbox.Checked.ToString(); Codeausschnitt: Eigene Codeausschnitte spchol305_ex2_workflowinitiationform Abbildung 46: Code des Workflowinitiierungsformulars Seite 40

43 Aufgabe 4: Verarbeiten des Workflowinitiierungsformulars in Workflow1 1. Öffnen Sie den Ansicht-Designer von Workflow1.cs. Fügen Sie aus der Toolbox hinter der onworkflowactivated1-aktivität eine Code-Aktivität (Windows Workflow 3.0) hinzu. Abbildung 47: Workflow-Designer 2. Doppelklicken Sie auf codeactivity1, um ein ExecuteCode-Ereignis in der CodeBehind-Datei zu erstellen. Fügen Sie den folgenden Code hinter der codeactivity1_executecode-methode ein: Setzen Sie einen Haltepunkt in der Methode. if (workflowproperties.initiationdata == "True") { System.Diagnostics.Debug.WriteLine("This is a fast track customer"); } Codeausschnitt: Eigene Codeausschnitte spchol305_ex2_codeactivity1 Abbildung 48: Codeausführungsmethode Seite 41

44 Aufgabe 5: Bereitstellen und Debuggen von Workflow1 1. Drücken Sie F5, um den neuen Workflow bereitzustellen und zu debuggen. 2. Navigieren Sie zur Liste Customers, und erstellen Sie in der Liste ein neues Element mit dem Namen Contoso. Abbildung 49: Benutzerdefinierte Liste 3. Klicken Sie für das Element Contoso auf die Dropdownliste zur Bearbeitung, und wählen Sie Workflows aus.starten Sie SPCHOL305Ex2 Workflow1 für dieses Element. Abbildung 50: Starten des Workflows 4. Aktivieren Sie das Kontrollkästchen Fast Track Customer, und klicken Sie dann auf die Schaltfläche Workflow starten. Abbildung 51: Workflowinitiierungsformular Seite 42

45 5. Der Haltepunkt, der im Code gesetzt wurde, sollte nun erreicht werden. Drücken Sie F10, um den Code schrittweise zu durchlaufen. Abbildung 52: Haltepunkt im Code 6. Der im Initiierungsformular übermittelte Wert wurde im Ausgabefenster erfasst. Abbildung 53: Debuggen der Ausgabe 7. Workflow abgeschlossen Abbildung 54: Workflow abgeschlossen Zusammenfassung der Übung In dieser Übung haben Sie einen SharePoint-Workflow mit einem Initiierungsformular erstellt und die Formulardaten verarbeitet. Seite 43

46 Übungszusammenfassung In dieser praktischen Übung haben Sie die folgenden Aufgaben ausgeführt: Erstellen einer Workflowaktion in Visual Studio 2010 Erstellen eines leeren SharePoint-Projekts und Einbeziehen der Workflowaktion in diese Lösung Bereitstellen der Workflowaktion als WSP-Lösungspaket Verwenden der Workflowaktion zum Erstellen eines wiederverwendbaren SharePoint Designer 2010-Workflows Verwenden von SharePoint Designer zum Erstellen eines WSP-Pakets, das in Visual Studio 2010 zurückimportiert werden kann Importieren einer SharePoint 2010-WSP-Datei in Visual Studio 2010 Verwenden von Visual Studio 2010 zum Erstellen eines Initiierungsformulars, das einem SharePoint-Workflow zugeordnet wird In dieser praktischen Übung haben Sie gelernt, eine SharePoint-Workflowaktion zu erstellen. Ferner haben Sie erfahren, wie diese Aktion in ein SharePoint-WSP-Lösungspaket einbezogen wird. Darüber hinaus haben Sie in SharePoint Designer 2010 einen wiederverwendbaren Workflow erstellt, der die Visual Studio-Workflowaktion verwendet hat. Danach haben Sie mit SharePoint Designer eine WSP- Datei erstellt, die in Visual Studio zurückimportiert wurde. Sie haben außerdem mithilfe eines Initiierungsformulars Benutzerdaten erfasst und diese Daten im Workflow verarbeitet. Seite 44