Exemplarische Vorgehensweise: Importieren eines wiederverwendbaren Workflows aus SharePoint-Designer in Visual Studio
Erstellen eines einfachen, wiederverwendbaren Workflows im SharePoint-Designer. Exportieren des wiederverwendbaren Workflows aus SharePoint Designer in eine WSP-Datei und nach SharePoint. Importieren der WSP-Datei in Visual Studio mit dem Projekttyp Wiederverwendbaren Workflow importieren. Ändern des Workflows durch Hinzufügen von Code. Verwenden des importierten Workflows in einer SharePoint-Website.
Hinweis |
|---|
|
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen. |
Unterstützte Editionen von Microsoft Windows und SharePoint. Weitere Informationen finden Sie unter Anforderungen für die Entwicklung von SharePoint-Lösungen. Visual Studio 2010. Microsoft Office SharePoint-Designer 2010.
So erstellen Sie SharePoint-Unterwebsites
Klicken Sie im SharePoint-Designer 2010 im Menü Datei auf Website öffnen. Wechseln Sie im Dialogfeld Website öffnen zu einer SharePoint-Website, in der den Workflow erstellen möchten, oder verwenden Sie den Standardwert http://system name/, und klicken Sie dann auf Öffnen. Die Homepage wird angezeigt. Klicken Sie im Abschnitt Unterwebsites auf Neu. Wählen Sie im Dialogfeld Neu im linken Bereich SharePoint-Vorlagen aus, und wählen Sie im rechten Bereich Teamwebsite aus. Ersetzen Sie im Feld Geben Sie den Standort der Website an das Wort Unterwebsite in der URL durch "SPD1", und klicken Sie dann auf OK. Hiermit wird die neue Unterwebsite im SharePoint-Designer geöffnet. Schließen Sie diese Instanz des SharePoint-Designers, und wechseln Sie wieder zur ersten Instanz (der Website der obersten Ebene). Wiederholen Sie die Schritte 3 bis 5, um die zweite Unterwebsite zu erstellen. Ersetzen Sie diesmal das Wort Unterwebsite in URL durch "SPD2".
So erstellen Sie einen wiederverwendbaren SharePoint-Designerworkflow
Klicken Sie im Abschnitt Unterwebsites auf die Website SPD1, um sie zu ändern. Klicken Sie im Menüband auf Wieder verwendbarer Workflow. Der Assistent zum Erstellen von wiederverwendbaren Workflows wird angezeigt. Geben Sie den Namen "SPD Task Workflow" in das Feld Name ein. Klicken Sie im Feld Inhaltstyp auf Aufgabe und dann auf OK. Der Workflow wird im SharePoint-Workflowdesigner geöffnet. Stellen Sie sicher, dass Schritt 1 ausgewählt ist, und klicken Sie im Menüband auf die Schaltfläche Bedingung. Wählen Sie dann Wenn das aktuelle Elementfeld gleich Wert ist aus der Liste der Bedingungen aus. Dadurch wird eine neue Bedingung mit dem Namen Wenn Feld gleich Wert hinzugefügt. Klicken Sie in der Bedingung Wenn Feld gleich Wert auf den Link Feld. Wählen Sie in der Liste der Werte Titel aus. Klicken Sie in der Bedingung Wenn Feld gleich Wert auf den Link Wert. Geben Sie im Feld New task ein. Die Bedingungsanweisung lautet jetzt Aktuelles Element:Wenn Titel gleich New task. Klicken Sie auf die Zeile unter der Bedingungsanweisung, klicken Sie im Menüband auf die Schaltfläche Aktion, und wählen Sie dann in der Liste der Aktionen die Option Feld im aktuellen Element festlegen aus. Klicken Sie in der Aktion Festlegen von Feld auf Wert auf den Link Feld, und wählen Sie dann Zugewiesen an aus. Klicken Sie in der Aktion Festlegen von Feld auf Wert auf den Link Wert, wählen Sie Benutzer, der den aktuellen Eintrag erstellt hat aus der Liste der vorhandenen Benutzer und Gruppen aus, klicken Sie auf die Schaltfläche Hinzufügen und dann auf OK. Die Aktionsanweisung lautet jetzt Festlegen von Zugwiesen auf Aktuelles Element:CreatedBy.
Wichtig |
|---|
So speichern und stellen Sie den wiederverwendbaren Workflow bereit
Klicken Sie am oberen Rand des SharePoint-Designers auf die Schaltfläche Speichern, um den Status zu speichern, und klicken Sie dann auf die Schaltfläche Veröffentlichen, um den Workflow auf der SharePoint-Website SPD1 bereitzustellen. Klicken Sie im Navigationsbereich auf Workflows. Klicken Sie unter Wiederverwendbarer Workflow auf SPD-Aufgabenworkflow. Klicken Sie im Menüband auf Als Vorlage speichern, um den Workflow als WSP-Datei zu speichern. Öffnen Sie die SharePoint-Website SPD1 in einem Browser, um die WSP-Datei in SharePoint anzuzeigen. Klicken Sie auf der Schnellstartleiste auf Bibliotheken. Klicken Sie im Abschnitt Dokumentbibliotheken auf Websiteobjekte. Die Datei SPD-Aufgabenworkflow wird zusammen mit anderen Websiteobjekten aufgeführt. Klicken Sie auf den Namen in der Liste. Das Dialogfeld Dateidownload wird angezeigt. Klicken Sie im Dialogfeld Dateidownload auf die Schaltfläche Speichern, um die WSP-Datei auf dem System zu speichern.
So importieren Sie einen Workflow aus einer WSP-Datei und ändern diesen
Zeigen Sie in Visual Studio das Dialogfeld Neues Projekt an, indem Sie im Menü Datei auf Neu zeigen und dann auf Neues Projekt klicken. Erweitern Sie unter Visual C# oder Visual Basic den Knoten SharePoint, und klicken Sie dann auf 2010. Klicken Sie im Bereich Vorlagen auf Wiederverwendbaren Workflow importieren, übernehmen Sie den Namen WorkflowImportProject1 des Projekts, und klicken Sie dann auf OK. Der Assistent zum Anpassen von SharePoint wird angezeigt. Geben Sie auf der Seite Site und Sicherheitsebene für Debugging angeben die URL für die zweite SharePoint-Unterwebsite ein, die Sie zuvor erstellt haben: http://system name/SPD2. Lassen Sie im Abschnitt Wie lautet die Vertrauensebene für diese SharePoint-Lösung? die Auswahl Als Farmlösung bereitstellen unverändert. Weitere Informationen über Sandkastenlösungen im Vergleich zu Farmlösungen finden Sie in Überlegungen zu Sandkastenlösungen. Wechseln Sie auf der Seite Neue Projektquelle angeben zu dem Speicherort im System, an dem Sie zuvor die WSP-Datei gespeichert haben, und klicken Sie dann auf Weiter.
HinweisWenn Sie auf dieser Seite auf Fertig stellen klicken, werden alle verfügbaren Elemente in der WSP-Datei importiert. Dadurch wird eine Liste wiederverwendbarer Workflows angezeigt, die zum Importieren verfügbar sind. Wählen Sie im Feld Zu importierende Elemente auswählen den Workflow SPD Task Workflow aus, und klicken Sie dann auf Fertig stellen. Nach Abschluss des Importvorgangs wird ein Projekt mit dem Namen WorkflowImportProject1 erstellt, das einen Workflow SPD_Workflow_TestFT enthält. Dieser Ordner enthält die Definitionsdatei "Elements.xml" des Workflows und die Workflow-Designerdatei (.xoml). Der Designer enthält zwei Dateien: die Regeldatei (.rules) und die Code-Behind-Datei (entweder .cs oder .vb, abhängig von der Programmiersprache des Projekts). Legen Sie das Workflowprojektelement WorkflowImportProject1 als Startelement fest. Dadurch wird die Liste direkt angezeigt, wenn Sie das Projekt debuggen. Da beim Projekttyp Wiederverwendbaren Workflow importieren keine Zuordnungseigenschaftswerte für den importierten Workflow importiert werden, müssen Sie diese Werte eingeben. Gehen Sie dazu wie folgt vor: Klicken Sie im Projektmappen-Explorer auf das Workflowprojektelement SPD_Workflow_TestFT. Klicken Sie neben der Eigenschaft Zielliste (oder einer anderen Eigenschaft mit einer Schaltfläche mit Auslassungspunkten) auf die Schaltfläche mit den Auslassungspunkten (). Füllen Sie die fehlenden Werte im Assistenten zum Anpassen von SharePoint aus. Klicken Sie anschließend auf Fertig stellen.
Klicken Sie mit der rechten Maustaste auf die XOML-Datei, und wählen Sie Ansicht-Designer aus, um den importierten Workflow im Workflow-Designer anzuzeigen. Ziehen Sie in der Toolbox im Abschnitt Windows Workflow v3.0 eine Code-Aktivität in den Designer, und legen Sie sie unter der Aktivität SequenceActivity1 ab. Hiermit wird dem Workflow-Designer eine Aktivität mit dem Namen CodeActivity1 hinzugefügt. In dieser Aktivität fügen Sie eine Codeaktion hinzu, die in der Ankündigungsliste eine Ankündigung erstellt, wenn der Benutzer den Workflow startet. Doppelklicken Sie auf CodeActivity1, um einen Ereignishandler zu generieren und den Code anzuzeigen. Fügen Sie unter den vorhandenen using- oder Imports- Anweisungen Folgendes hinzu: Ersetzen Sie codeActivity1_ExecuteCode durch Folgendes: private void codeActivity1_ExecuteCode(object sender, System.EventArgs e) { try { // Get reference to SharePoint site. SPSite site = new SPSite("http://MyServer"); SPWeb web = site.OpenWeb("SPD2/"); // Get reference to Announcements list. SPList announcementsList = web.Lists["Announcements"]; // Add announcement to Announcements list for the Task. SPListItem oListItem = announcementsList.Items.Add(); oListItem["Title"] = "Assigned task on " + DateTime.Now.ToString(); oListItem.Update(); } catch (Exception err) { Console.WriteLine("Error: " + err.ToString()); } }
So stellen Sie das Projekt bereit und ordnen den Workflow zu
Drücken Sie in Visual Studio die Taste F5, um das konvertierte Workflowprojekt auszuführen und bereitzustellen. Klicken Sie auf der Schnellstartleiste auf Aufgaben, um die Aufgabenliste anzuzeigen. Klicken Sie im Menüband Listentools auf Elemente und dann auf die Schaltfläche Neues Element. Geben Sie im Dialogfeld Aufgaben - Neues Element im Feld Titel den Titel "New task" ein, und klicken Sie dann auf Speichern. Zeigen Sie die Seite Listeneinstellungen an, indem Sie im Menüband Listentools auf Liste und dann auf Listeneinstellungen klicken. Klicken Sie im Abschnitt Berechtigungen und Verwaltung auf den Link Workfloweinstellungen. Die Seite Workflow hinzufügen wird angezeigt. Wählen Sie in der Liste Workflow den Eintrag WorkflowImportProject1 - SPD Workflow Test aus. Geben Sie im Feld Name den Namen "SPD Workflow Test ein, und klicken Sie dann auf OK. Klicken Sie auf der Schnellstartleiste auf Aufgaben. Klicken Sie auf den Dropdownpfeil neben Neue Aufgabe, und wählen Sie Workflows aus. Klicken Sie im Abschnitt Neuen Workflow starten auf den Link für SPD Workflow Test, und klicken Sie dann auf Start, um den Workflow zu initiieren.
HinweisAlternativ kann ein Workflow automatisch einer Liste zugeordnet werden, indem Sie den Workfloweinstellungs-Assistenten ausführen und den Workflow auf automatische Zuordnung festlegen. Beachten Sie, dass der Workflow zwei Aktionen ausführt: Ihr Name wird in der Spalte Zugewiesen an der Aufgabe angezeigt, und in der Liste Ankündigungen wird eine Ankündigung angezeigt.
Wichtig