Exemplarische Vorgehensweise: Erstellen und Debuggen einer SharePoint-Workflow-Projektmappe

Článek
04/28/2010

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Visual Studio Tools for Office-Projekte und Versionen von Microsoft Office. Projekttyp SharePoint-Workflow Microsoft Office-Version SharePoint Server 2007 Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Die Informationen in diesem Thema gelten nur für die angegebenen Visual Studio Tools for Office-Projekte und Versionen von Microsoft Office.

Projekttyp

SharePoint-Workflow

Microsoft Office-Version

SharePoint Server 2007

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise wird gezeigt, wie eine grundlegende sequenzielle Workflowvorlage erstellt wird. Der Workflow überprüft eine Eigenschaft einer Dokumentbibliothek, um zu bestimmen, ob ein Dokument empfangen wurde. Nach dem Prüfen des Dokuments wird der Workflow fertig gestellt.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

Erstellen eines sequenziellen Workflowprojekts für SharePoint 2007.
Erstellen eines Workflowzeitplans.
Behandeln von Aktivitätsereignissen.

Hinweis:
Je nach den aktiven Einstellungen oder der verwendeten Version können sich die angezeigten Dialogfelder und Menübefehle von den in der Hilfe beschriebenen unterscheiden. Um die Einstellungen zu ändern, wählen Sie im Menü Extras die Option Einstellungen importieren und exportieren aus. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Weitere Informationen zum Erstellen von SharePoint-Workflowvorlagen mithilfe von Visual Studio Tools for Office finden Sie unter SharePoint-Workflow-Projektmappen.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

Visual Studio Tools for Office (eine optionale Komponente von Visual Studio 2008 Professional und Visual Studio Team System).
Microsoft SharePoint Server 2007.
Eine SharePoint Server-Website mit der Bezeichnung Dokument-Center und die URL mit der Bezeichnung https://localhost/Docs. Wurde Microsoft Office SharePoint Server 2007 auf einem einzelnen Computer als eigenständige Installation installiert, wird diese Website automatisch erstellt, wenn Sie Konfigurations-Assistent für SharePoint-Produkte und -Technologien ausführen.
Microsoft Office Word 2007 oder Microsoft Office Word 2003.

Visual Studio Tools for Office wird standardmäßig mit den aufgeführten Versionen von Visual Studio installiert. Wie Sie überprüfen können, ob die Software installiert ist, erfahren Sie in Installieren von Visual Studio Tools for Office.

Hinzufügen von Eigenschaften zur SharePoint-Dokumentbibliothek

Soll der Überprüfungsstatus von Dokumenten in der Dokumentbibliothek nachverfolgt werden, legen Workflowteilnehmer die Eigenschaften Document Status, Assignee und Review Comments des Dokuments fest. Definieren Sie diese Eigenschaften in der Dokumentbibliothek.

So fügen Sie der SharePoint-Dokumentbibliothek Eigenschaften hinzu:

Öffnen Sie in Internet Explorer die standardmäßige SharePoint Server 2007-Website.

Hinweis:
Standardmäßig befindet sich die SharePoint-Website unter https://localhost. Wird https://localhost einer Nicht-SharePoint-Website zugeordnet, kann die Workflowvorlage nicht mit den Schritten in dieser exemplarischen Vorgehensweise getestet werden.

Klicken Sie auf die Registerkarte Dokument-Center.
Klicken Sie im Navigationsbereich auf Dokumente.
Klicken Sie auf der Seite Dokumente auf Einstellungen, und klicken Sie anschließend auf Einstellungen Dokumentbibliothek.
Klicken Sie auf der Seite Dokumente anpassen unter Spalten auf Spalte erstellen.
Nennen Sie die Spalte Document Status, wählen Sie Auswahl (Menü), geben Sie die folgenden drei Optionen an, und klicken Sie anschließend auf OK:
- Review Needed
- Review Complete
- Changes Requested
Erstellen Sie zwei zusätzliche Spalten, und nennen Sie diese Assignee und Review Comments. Formatieren Sie die Spalte Assignee als einzelne Textzeile und die Spalte Review Comments als aus mehreren Zeilen bestehenden Text.

Bearbeiten von Dokumenten ohne Auschecken

Es ist einfacher, die Workflowvorlage zu testen, wenn die Dokumente ohne Auschecken bearbeitet werden können.

So können Dokumente ohne Auschecken bearbeitet werden

Klicken Sie auf der Seite Dokumente anpassen unter Allgemeine Einstellungen auf Versionierungseinstellungen.
Wählen Sie für Auschecken von Dokumenten erfordern, bevor sie bearbeitet werden können die Option Nein, und klicken Sie anschließend auf OK.
Schließen Sie Internet Explorer.

Erstellen eines sequenziellen Workflowprojekts für SharePoint.

Ein sequenzieller Workflow ist eine Abfolge von Schritten, die der Reihe nach ausgeführt werden, bis die letzte Aktivität fertig gestellt wurde.

So erstellen Sie ein sequenzielles Workflowprojekt für SharePoint:

Starten Sie Visual Studio.
Öffnen Sie das Dialogfeld Neues Projekt, erweitern Sie den Office-Knoten unter der gewünschten Sprache, und wählen Sie anschließend den 2007-Knoten aus.
Wählen Sie im Bereich Vorlagen die Option Sequenzieller SharePoint 2007-Workflow aus.
Geben Sie in das Feld NameMySharePointWorkflow ein. Falls Sie für die IDE Visual C#-Entwicklungseinstellungen oder allgemeine Entwicklungseinstellungen festgelegt haben, geben Sie einen Speicherort und einen Projektmappennamen ein.
Klicken Sie auf OK.

Der Assistent Neuer Office SharePoint-Workflow wird angezeigt.
Klicken Sie auf der Seite Workflownamen und Site zum Debugging angeben auf Weiter, um den standardmäßigen Workflownamen und die Website zu akzeptieren.
Klicken Sie auf der Seite Beim Debuggen verwendete Listen auswählen auf Weiter, um die standardmäßige Dokumentbibliothek sowie die Aufgaben- und Verlaufliste zu akzeptieren und die Workflowvorlage automatisch der Dokumentbibliothek zuzuordnen.
Klicken Sie auf der Seite Sie können die Bedingungen für den Start des Workflows festlegen auf Fertig stellen, um die Standardauswahl zu akzeptieren.

Erstellen eines Workflowzeitplans

Workflowvorlagen beinhalten mindestens einen Workflowzeitplan, der Aktivitäten beinhaltet, bei denen es sich um auszuführende Aktionen handelt. Ordnen Sie mit dem Workflow-Designer Aktivitäten in einem Zeitplan an. Fügen Sie zum Überwachen des Überprüfungsstatus eines Dokuments in der Liste Dokumente zwei Aktivitäten hinzu: HandleExternalEventActivity und Microsoft.SharePoint.WorkflowActions.OnWorkflowItemChanged.

So erstellen Sie einen Workflowzeitplan

Doppelklicken Sie im Projektmappen-Explorer auf Workflow1.cs oder Workflow1.vb, um den Workflowzeitplan im Designer zu öffnen.
Klicken Sie im Designer auf die OnWorkflowActivated1-Aktivität, um diese auszuwählen.
Geben Sie im Fenster Eigenschaften neben der Invoked-Eigenschaft onWorkflowActivated ein, und drücken Sie die EINGABETASTE.

Der Code-Editor wird geöffnet, und eine Ereignishandlermethode mit der Bezeichnung onWorkflowActivated wird der Workflow1-Codedatei hinzugefügt.
Öffnen Sie im Designer noch einmal den Workflowzeitplan.
Klicken Sie im Menü Ansicht auf Toolbox.
Ziehen Sie von der Registerkarte Windows Workflow v3.0 der Toolbox eine While-Aktivität unter die onWorkflowActivated1-Aktivität.
Klicken Sie auf die WhileActivity1-Aktivität, um diese auszuwählen.
Legen Sie im Fenster Eigenschaften die Condition-Eigenschaft auf Code Condition fest.
Erweitern Sie die Condition-Eigenschaft, geben Sie isWorkflowPending neben der untergeordneten Condition-Eigenschaft ein, und drücken Sie anschließend die EINGABETASTE.

Der Code-Editor wird geöffnet, und eine Methode mit der Bezeichnung isWorkflowPending wird der Workflow1-Codedatei hinzugefügt.
Öffnen Sie im Designer noch einmal den Workflowzeitplan.
Verschieben Sie von der Registerkarte SharePoint-Workflow der Toolbox eine OnWorkflowItemChanged-Aktivität in die whileActivity1-Aktivität.
Klicken Sie auf die onWorkflowItemChanged1-Aktivität, um diese auszuwählen.
Legen Sie im Fenster Eigenschaften die Eigenschaften entsprechend der Anzeige in der folgenden Tabelle fest.

Eigenschaft

Wert

CorrelationToken

workflowToken

Invoked

onWorkflowItemChanged

Eigenschaft	Wert
CorrelationToken	workflowToken
Invoked	onWorkflowItemChanged

Behandeln von Aktivitätsereignissen

Im letzten Schritt wird der Status des Dokuments von jeder Aktivität überprüft. Nach dem Prüfen des Dokuments ist der Workflow fertig gestellt.

So behandeln Sie Aktivitätsereignisse:

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Workflow1.cs oder Workflow1.vb, und klicken Sie anschließend auf Code anzeigen.
Fügen Sie das folgende Feld am Anfang der Workflow1-Klasse hinzu. Dieses Feld wird in einer Aktivität verwendet, um zu bestimmen, ob der Workflow abgeschlossen wurde.
```
Dim workflowPending As Boolean = True
```
```
Boolean workflowPending = true;
```
Fügen Sie der Workflow1-Klasse die folgende Methode hinzu. Mit dieser Methode wird der Wert der Eigenschaft Document Status der Dokumentliste überprüft, um zu bestimmen, ob das Dokument überprüft wurde. Wurde die Eigenschaft Document Status auf Review Complete festgelegt, wird das workflowPending-Feld mit der checkStatus-Methode auf false festgelegt, um anzugeben, dass der Workflow beendet werden kann.
```
Private Sub checkStatus()
    If CStr(workflowProperties.Item("Document Status")) = "Review Complete" Then
        workflowPending = False
    End If
End Sub 
```
```
private void checkStatus()
{
    if ((string)workflowProperties.Item["Document Status"] == "Review Complete")
    workflowPending = false;
}
```
Fügen Sie den folgenden Code der onWorkflowActivated-Methode und der onWorkflowItemChanged-Methode hinzu, um die checkStatus-Methode aufzurufen. Beim Start des Workflows wird mit der onWorkflowActivated-Methode die checkStatus-Methode aufgerufen, um zu bestimmen, ob das Dokument bereits überprüft wurde. Wurde der Workflow noch nicht überprüft, wird der Workflow fortgesetzt. Beim Speichern des Dokuments wird mit der onWorkflowItemChanged-Methode erneut die checkStatus-Methode aufgerufen, um zu bestimmen, ob das Dokument überprüft wurde. Während das workflowPending-Feld auf true festgelegt ist, wird die Ausführung des Workflows fortgesetzt.
```
Private Sub onWorkflowActivated(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub

Private Sub onWorkflowItemChanged(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub
```
```
private void onWorkflowActivated(object sender, ExternalDataEventArgs e)
{
    checkStatus();
}

private void onWorkflowItemChanged(object sender, ExternalDataEventArgs e)
{
    checkStatus();
}
```
Fügen Sie der isWorkflowPending-Methode den folgenden Code hinzu, um den Status der workflowPending-Eigenschaft zu überprüfen. Bei jedem Speichern des Dokuments wird mit der whileActivity1-Aktivität die isWorkflowPending-Methode aufgerufen. Mit dieser Methode wird die Result-Eigenschaft des ConditionalEventArgs-Objekts überprüft, um zu bestimmen, ob die WhileActivity1-Aktivität fortgesetzt oder beendet werden soll. Wurde die Eigenschaft auf true festgelegt, wird die Aktivität fortgesetzt. Andernfalls werden die Aktivität und der Workflow beendet.
```
Private Sub isWorkflowPending(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ConditionalEventArgs)
    e.Result = workflowPending
End Sub
```
```
private void isWorkflowPending(object sender, ConditionalEventArgs e)
{
    e.Result = workflowPending;
}
```

Testen der SharePoint-Workflowvorlage

Beim Starten des Debuggers stellt Visual Studio Tools for Office die Workflowvorlage für SharePoint Server 2007 bereit und ordnet die Workflowvorlage der Liste Dokumente zu. Starten Sie zum Testen des Workflows eine Instanz der Workflowvorlage von einem Dokument in der Liste Dokumente.

So testen Sie die SharePoint-Workflowvorlage:

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Workflow1.cs oder Workflow1.vb, und klicken Sie anschließend auf Code anzeigen.
Legen Sie neben der onWorkflowActivated-Methode einen Haltepunkt fest.
Drücken Sie F5.

Die Seite Dokumente der standardmäßigen SharePoint-Site wird geöffnet.
Klicken Sie auf der Seite Dokumente zum Erstellen eines neuen Dokuments auf Neu.
Speichern Sie das Dokument am Standardspeicherort.

Dadurch wird das Dokument der Liste Dokumente hinzugefügt und der Workflow gestartet.
Überprüfen Sie in Visual Studio, ob der Debugger am Haltepunkt neben der onWorkflowActivated-Methode beendet wird.
Drücken Sie F5, um die Ausführung fortzusetzen.
Schließen Sie das Dokument.
Kehren Sie zur Seite Dokumente der standardmäßigen SharePoint-Website zurück.
Überprüfen Sie auf der Seite Dokumente, ob der Wert unter der Spalte MySharePointWorkflow auf In Bearbeitung festgelegt ist. Dadurch wird angegeben, dass sich der Workflow in Bearbeitung befindet und dass die Überprüfung des Dokuments ansteht.
Zeigen Sie auf der Seite Dokumente auf das Dokument, klicken Sie auf den Pfeil nach unten, und klicken Sie anschließend auf Eigenschaften bearbeiten.
Legen Sie Document Status auf Review Complete fest, und klicken Sie anschließend auf OK.
Kehren Sie zur Seite Dokumente der standardmäßigen SharePoint-Website zurück.
Überprüfen Sie auf der Seite Dokumente, ob der Wert unter der Spalte MySharePointWorkflow auf Abgeschlossen festgelegt ist. Dadurch wird angegeben, dass der Workflow beendet ist und dass das Dokument überprüft wurde.

Nächste Schritte

Weitere Informationen zum Erstellen von Workflowvorlagen finden Sie in diesen Themen:

Weitere Informationen zu SharePoint-Workflowaktivitäten finden Sie unter Übersicht über Workflowaktivitäten für Windows SharePoint Services.
Weitere Informationen zu Windows Workflow Foundation-Aktivitäten finden Sie unter System.Workflow.Activities Namespace.

Siehe auch

Sdílet prostřednictvím