Erstellen von SharePoint-Workflow-Projektmappen
Visual Studio bietet Tools, mit denen Sie benutzerdefinierte Workflows erstellen können, die den Lebenszyklus von Dokumenten und Listenelementen in einer SharePoint-Website verwalten können. Zu den bereitgestellten Elementen gehören ein Designer, Aktivitätssteuerelemente und die notwendigen Assemblyverweise. Außerdem umfasst Visual Studio den Assistenten zum Anpassen von SharePoint, mit dem Sie Workflows erstellen und konfigurieren können.
Weitere Informationen zu SharePoint finden Sie unter Microsoft SharePoint-Produkte und -Technologien.
Workflows in SharePoint
Wenn Sie einer SharePoint-Bibliothek oder -Liste einen Workflow hinzufügen, erzwingen Sie einen Geschäftsprozess für alle Elemente in der Bibliothek oder Liste. Ein Workflow beschreibt die Aktionen, die das System oder der Benutzer für jedes Element durchführen muss, z. B. das Senden eines Elements zur Bearbeitung und zum anschließenden Review. Diese Aktionen, die als Aktivitäten bezeichnet werden, sind die Bestandteile des Workflows.
Sie können SharePoint-Workflows in Visual Studio erstellen und auf einer SharePoint-Website bereitstellen. Nachdem ein Workflow in SharePoint bereitgestellt wurde, müssen Sie ihn einer Bibliothek oder Liste zuordnen. Dieser kann dann automatisch, von einem Prozess oder manuell von einem Benutzer gestartet werden. Weitere Informationen zum Workflowvorgang finden Sie unter Entwickeln von SharePoint-Workflows mithilfe von Visual Studio.
Erstellen von benutzerdefinierten SharePoint-Workflows
In Visual Studio stehen Ihnen zwei Arten von SharePoint-Workflowprojekten zur Verfügung: Sequenzieller Workflow und Zustandsautomatworkflow.
Ein sequenzieller Workflow stellt eine Reihe von Schritten dar. Die Schritte werden nacheinander ausgeführt, bis die letzte Aktivität abgeschlossen ist. Sequenzielle Workflows gehen bei der Ausführung immer strikt sequenziell vor. Da sie externe Ereignisse empfangen können und parallele logische Flows enthalten, kann die Ausführungsreihenfolge variieren. Die folgende Abbildung zeigt ein Beispiel für einen sequenziellen Workflow.
Ein Zustandsautomatworkflow stellt Zustände, Übergänge und Aktionen dar. Die Schritte in einem Zustandsautomatworkflow werden asynchron ausgeführt. Das bedeutet, dass sie nicht notwendigerweise nacheinander ausgeführt werden, sondern stattdessen durch Aktionen und Zustände ausgelöst werden. Ein Zustand wird als Startzustand festgelegt, und aufgrund eines Ereignisses wird ein Übergang in einen anderen Zustand vorgenommen. Für einen Zustandsautomaten kann ein Endzustand festgelegt werden, der das Ende des Workflows bestimmt. Das folgende Diagramm zeigt ein Beispiel für einen Zustandsautomatworkflow.
Weitere Informationen zu den verschiedenen Workflows finden Sie unter Workflowtypen.
Verwenden des Assistenten
Wenn Sie in ein SharePoint-Workflowprojekt in Visual Studio erstellen, geben Sie zunächst im Assistent zum Anpassen von SharePoint die zugehörigen Einstellungen an. Der Assistent verwendet diese Einstellungen, um ein Projekt im Projektmappen-Explorer zu erstellen. Dieses Projekt enthält eine Codedatei, mehrere Dateien zum Bereitstellen des Workflows sowie Verweise auf Assemblys, die zum Erstellen eines benutzerdefinierten SharePoint-Workflows erforderlich sind.
Nachdem Sie einen Workflow erstellt haben, können Sie dessen Eigenschaften im Eigenschaftenfenster bearbeiten. Obwohl die meisten Workfloweigenschaften direkt im Eigenschaftenfenster geändert werden können, müssen Sie für einige Eigenschaften auf die Schaltfläche mit den Auslassungspunkten (
) klicken, um ihre Werte zu ändern. Mit dieser Schaltfläche wird der Assistent zum Anpassen von SharePoint neu gestartet. Nachdem Sie die Änderungen an den Eigenschaftswerten vorgenommen haben, klicken Sie auf Fertigstellen, um den Vorgang abzuschließen.
Hinweis
Die Eigenschaft Workflowtyp ist schreibgeschützt und kann nicht geändert werden. Wenn Sie den Workflowtyp ändern möchten, müssen Sie einen weiteren Workflow erstellen.
Entwerfen eines SharePoint-Workflows
Nachdem Sie alle Schritte im Geschäftsprozess definiert haben, verwenden Sie den Visual Studio-Workflow-Designer, um den SharePoint-Workflow zu entwerfen. Doppelklicken Sie auf „Workflow1.cs“ oder „Workflow1.vb“ im Projektmappen-Explorer, oder öffnen Sie das Kontextmenü für eine dieser Dateien, und klicken Sie dort auf Öffnen, um den Designer zu öffnen.
Aktivitäten
Fügen Sie Aktivitäten aus der Toolbox zu einem Workflowzeitplan im Designer hinzu, um einen Workflow zu entwerfen. Ein Workflowzeitplan enthält die Abfolge der Aktivitäten in der Reihenfolge, in der sie ausgeführt werden sollen.
Es gibt zwei Arten von Aktivitäten:
Einfache Aktivitäten führen eine einzelne Arbeitseinheit durch, z. B. „Um 1 Tag verschieben“ oder „Webdienst starten“.
Zusammengesetzte Aktivitäten enthalten andere Aktivitäten. Beispielsweise kann eine bedingte Aktivität zwei Verzweigungen enthalten.
Beide Arten von Aktivitäten sind in der Toolbox verfügbar.
Aktivitäten können über Eigenschaften, Methoden und Ereignisse verfügen. Verwenden Sie das Fenster Eigenschaften, um die Eigenschaften einer Aktivität festzulegen.
Sie können auch eine benutzerdefinierte Aktivität erstellen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen einer benutzerdefinierten Website-Workflowaktivität.
Aktivitäten werden auf den folgenden Registerkarten der Toolbox organisiert:
SharePoint Workflow
Windows Workflow Version 3.0
Windows Workflow Version 3.5
SharePoint unterstützt nicht alle Kernaktivitäten für Workflows. Weitere Informationen finden Sie unter Workflowaktivitäten für SharePoint Foundation.
SharePoint-Workflowaktivitäten
Die Registerkarten für den SharePoint-Workflow enthalten spezielle Aktivitäten zur Verwendung in Microsoft SharePoint Foundation. Diese Aktivitäten vereinfachen und optimieren die Entwicklung von Lebenszyklusworkflows für Dokumente. Weitere Informationen zu den auf der Registerkarte SharePoint Workflow aufgeführten Aktivitäten finden Sie unter Workflowaktivitäten für SharePoint Foundation.
Windows Workflow-Aktivitäten
Die Registerkarten für den Windows-Workflow umfassen Aktivitäten, die von Windows Workflow Foundation bereitgestellt werden. Sie können diese Aktivitäten verwenden, um Workflowzeitpläne für jede Art von Windows Workflow-Anwendung zu erstellen.
Weitere Informationen zu den Aktivitäten auf der Registerkarte Windows Workflows finden Sie unter Windows Workflow Foundation-Aktivitäten. Weitere Informationen zu Windows Workflow Foundation finden Sie unter Übersicht über Windows Workflow Foundation.
Arbeiten mit Aktivitäten im Designer
Ihr Workflowzeitplan kann eine Kombination aus Windows Workflow-Aktivitäten und SharePoint Workflow-Aktivitäten enthalten.
Der Designer zeigt Hinweise an, damit Sie Aktivitäten ordnungsgemäß positionieren und konfigurieren können. Wenn Sie eine Aktivität in den Workflowzeitplan ziehen oder kopieren, erkennen Sie an einem grünen Pluszeichen (+) im Designer, welche Positionen für diese Aktivität im Workflow gültig sind. Sie können eine Aktivität nicht an einer ungültigen Position einfügen. Beispielsweise können Sie keine Sendeaktivät als erste Aktivität in der Verzweigung für eine Lauschaktivität positionieren. Weitere Informationen finden Sie im SharePoint Designer Developer Center.
Sammeln von Informationen während des Workflows
Sie sollten zu vordefinierten Zeitpunkten im Workflow Informationen von Benutzern einholen. Informationen können mithilfe von Formularen oder Elementeigenschaften gesammelt werden.
Formulare
Formulare sind wie Dialogfelder, die Fragen enthalten und es Benutzern ermöglichen, Antworten einzugeben.
Es gibt vier Arten von Formularen, die in einem Workflow verwendet werden können:
Zuordnung
Initiierung
Modifikation (Modification)
Aufgabe
Visual Studio umfasst Elementvorlagen für Zuordnungs- und Initiierungsformulare. Ein Zuordnungsformular ermöglicht es beispielsweise einem Administrator, bei der Installation des Workflows passende Parameter einzugeben (z. B. ein Ausgabenlimit für einen Ausgabenworkflow). Ein Initiierungsformular ermöglicht es beispielsweise dem Benutzer eines Ausgabenworkflows, den ausgegebenen Betrag in den Workflow einzugeben. Weitere Informationen zu diesen Formularen finden Sie unter SharePoint-Projekt- und -Projektelementvorlagen.
Elementeigenschaften
Sie können auch Informationen von Benutzern erfassen, indem Sie die Eigenschaften eines Elements in der SharePoint-Bibliothek oder -Liste verwenden. Die Hauptcodedatei („Workflow1.cs“ oder „Workflow1.vb“) deklariert eine Instanz der Klasse Microsoft.SharePoint.Workflow.SPWorkflowActivationProperties.WorkflowProperties namens workflowProperties. Verwenden Sie das workflowProperties-Objekt, um im Code auf die Eigenschaften der Bibliothek oder Liste zuzugreifen. Ein Beispiel finden Sie unter Exemplarische Vorgehensweise: Erstellen und Debuggen einer Projektmappe für einen SharePoint-Workflow.
Debuggen einer SharePoint-Workflowvorlage
Sie können ein SharePoint-Workflowprojekt auf die gleiche Weise wie andere webbasierte Visual Studio-Projekte debuggen. Wenn Sie den Visual Studio-Debugger starten, verwendet Visual Studio die im Assistenten zum Anpassen von SharePoint angegebenen Einstellungen, um die geeignete SharePoint-Website zu öffnen und die Workflowvorlage automatisch der entsprechenden Bibliothek oder Liste zuzuordnen. Visual Studio fügt außerdem den Visual Studio-Debugger an den Microsoft SharePoint Foundation-Prozess namens w3wp.exe an.
Sie müssen den Workflow manuell starten, um ihn zu testen. Weitere Informationen finden Sie im Abschnitt „Debuggen von Workflows“ unter Debuggen von SharePoint-Projektmappen. Weitere Informationen zum Debuggen von Visual Studio-Webanwendungen finden Sie im Artikel zum Debuggen von Webanwendungen und Skripts.
Bereitstellen einer SharePoint-Workflowvorlage
Visual Studio-SharePoint-Workflowprojekte werden genau wie andere Visual Studio-SharePoint-Projekte bereitgestellt. Weitere Informationen finden Sie unter Packen und Bereitstellen von SharePoint-Projektmappen.
Importieren global wiederverwendbarer Workflows
Mit SharePoint Designer können Sie nicht nur websitespezifisch wiederverwendbare Workflows erstellen, sondern auch global wiederverwendbare Workflows, die auf jeder SharePoint-Website verwendet werden können. Über die Option „Wiederverwendbaren Workflow importieren“ in Visual Studio können derzeit keine global wiederverwendbaren Workflows importiert werden. Sie können jedoch entweder SharePoint Designer verwenden, um einen global wiederverwendbaren Workflow in einen wiederverwendbaren Workflow zu konvertieren, oder den Workflow als nicht konvertierten deklarativen Workflow importieren. Weitere Informationen finden Sie unter Importieren von Elementen von einer vorhandenen SharePoint-Website.
Verwandte Themen
| Titel | BESCHREIBUNG |
|---|---|
| Exemplarische Vorgehensweise: Erstellen und Debuggen einer Projektmappe für einen SharePoint-Workflow | Diese Anleitung führt Sie Schritt für Schritt durch die Erstellung und das Debuggen eines einfachen Visual Studio-Workflows. |
| Exemplarische Vorgehensweise: Erstellen eines Workflows mit Zuordnungs- und Initiierungsformularen | Diese Anleitung führt Sie Schritt für Schritt durch das Erstellen eines vollumfänglichen Visual Studio-Workflows mit Zuordnungs- und Initiierungsformularen. |
| Exemplarische Vorgehensweise: Hinzufügen einer Anwendungsseite zu einem Workflow | Diese Anleitung baut auf Exemplarische Vorgehensweise: Erstellen eines Workflows mit Zuordnungs- und Initiierungsformularen auf und ergänzt diese durch eine zusätzliche ASPX-Anwendungsseite, die Berichte zu in den Workflow eingegebenen Daten erstellt. |
| Exemplarische Vorgehensweise: Erstellen einer benutzerdefinierten Website-Workflowaktivität | In dieser Anleitung werden zwei Hauptaufgaben veranschaulicht: das Erstellen eines Workflows auf Websiteebene und das Erstellen einer benutzerdefinierten Workflowaktivität. |
| Exemplarische Vorgehensweise: Importieren eines wiederverwendbaren Workflows aus SharePoint Designer in Visual Studio | In dieser Anleitung wird veranschaulicht, wie ein in SharePoint-Designer 2010 erstellter, wiederverwendbarer deklarativer Workflow in ein SharePoint-Projekt in Visual Studio importiert wird. |