Debuggen von SharePoint-Workflow-Projektmappen
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
Microsoft Office-Version
Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp. |
Eine SharePoint-Workflowvorlage kann mithilfe des Visual Studio-Debuggers debuggt werden. Beim Starten des Debugvorgangs öffnet Visual Studio eine SharePoint-Site und fügt die Workflowvorlage einer Bibliothek oder Liste hinzu. Anschließend können Sie eine Instanz der Workflowvorlage starten und standardmäßige Debugtools zum Debuggen des Codes verwenden.
.gif "Hinweis") Hinweis: |
|---|
Werden anderen Assemblys Verweise hinzugefügt, muss sichergestellt werden, dass diese Assemblys im globalen Assemblycache installiert werden. Andernfalls tritt bei der Workflowlösung ein Fehler auf. Informationen über das Installieren von Assemblys finden Sie unter Gewusst wie: Installieren einer Assembly in den globalen Assemblycache. |
Angeben von Debugkonfigurationseinstellungen
Die Debugkonfigurationseinstellungen können im Assistenten Neuer Office SharePoint-Workflow angegeben werden, wenn zum ersten Mal ein Projekt für Sequenzieller SharePoint 2007-Workflow oder SharePoint 2007 State Machine-Workflow erstellt wird. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines SharePoint-Workflowprojekts.
Diese Einstellungen können im Fenster Eigenschaften oder durch erneutes Starten des Assistenten Neuer Office SharePoint-Workflow geändert werden. Weitere Informationen finden Sie unter Gewusst wie: Ändern der Debugkonfigurationseinstellungen eines SharePoint-Workflow-Projekts.
In der folgenden Tabelle sind die Debugeinstellungen in diesem Assistenten aufgeführt.
Einstellung |
Beschreibung |
|---|---|
Angezeigter Name |
Identifiziert die Workflowvorlage auf der SharePoint Server-Website. Dieser Name wird in einer Liste der Workflowvorlagen angezeigt, die für eine Bibliothek oder Liste verfügbar sind. |
Zielsite |
Gibt die URL der SharePoint-Site an, die Sie zum Ausführen dieses Workflows verwenden möchten. Damit dieser Workflow entwickelt und debuggt werden kann, muss sich diese Site auf dem lokalen Computer befinden. |
Zielliste |
Gibt die Bibliothek oder Liste an, mit der der Workflow initiiert wird. Die Aktivitäten im Workflow gelten für Elemente in dieser Bibliothek oder Liste. |
Aufgabenliste |
Gibt die Aufgabenliste an, die Sie verwenden möchten. In der Aufgabenliste sind die Workflowaufgaben aufgeführt, die jedem Workflowteilnehmer zur Verfügung stehen. |
Verlaufsliste |
Gibt die Liste an, in der alle während der Ausführung des Workflows auftretenden Ereignisse angezeigt werden. Ist auf der lokalen SharePoint-Site keine Verlaufsliste vorhanden, wird durch den Visual Studio Tools for Office-Workflowbereitstellungsprozess eine Liste erstellt. |
Automatisch zuordnen |
Gibt an, ob die Workflowvorlage automatisch der Bibliothek oder Liste zugeordnet werden soll, die Sie im Assistenten Neuer Office SharePoint-Workflow angeben. Bei Auswahl dieser Option wird die Workflowvorlage durch den Visual Studio Tools for Office-Workflowbereitstellungsprozess der angegebenen Bibliothek oder Liste zugeordnet. Wird diese Option deaktiviert, muss die Workflowvorlage der Bibliothek oder Liste manuell mithilfe der Verwaltungsseite Workflow hinzufügen auf der SharePoint-Site zugeordnet werden. |
Manuelles Starten zulassen |
Gibt an, ob Sie den Workflow manuell von einem Dokument in der Bibliothek oder einem Element in der Liste starten können. Weitere Informationen finden Sie unter Manually start a workflow on a document item. |
Starten bei Elementerstellung |
Gibt an, ob der Workflow beim Erstellen eines neuen Elements in der Bibliothek oder Liste gestartet werden soll. |
Starten bei Elementänderung |
Gibt an, ob der Workflow beim Aktualisieren eines Elements in der Bibliothek oder Liste gestartet werden soll. |
SharePoint-Features
Bei einem Feature handelt es sich um eine tragbare und modulare Funktionseinheit, die das Ändern von Websites mithilfe von Websitedefinitionen vereinfacht. Ein Feature ist ein Paket aus Windows SharePoint Services-Elementen, das für einen bestimmten Bereich aktiviert werden kann und Benutzer beim Erreichen eines bestimmten Ziels bzw. beim Ausführen einer Aufgabe unterstützt. Im Workflowbereitstellungsprozess werden Workflowvorlagen als Features bereitgestellt.
Beim Starten des Debuggers wird im Workflowbereitstellungsprozess unter %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES im Featureverzeichnis ein Ordner erstellt.
Der Ordner der Projektmappe im Featureverzeichnis beinhaltet eine Datei für Featuredefinition und eine Datei für Workflowdefinition. Die Featuredefinitionsdatei (feature.xml) beschreibt die Dateien im Workflowfeature.Die Workflowdefinitionsdatei (workflow.xml) beschreibt die Workflowvorlage. Diese Dateien befinden sich im Projektmappen-Explorer. Weitere Informationen zu diesen Dateien finden Sie unter SharePoint-Workflowprojektvorlagen.
Debuggen des Bereitstellungsprozesses
Beim Starten des Visual Studio-Debuggers werden im Visual Studio Tools for Office-Workflowbereitstellungsprozess die folgenden Aufgaben ausgeführt:
Stellt das Feature und die Workflowdefinitionsdateien für SharePoint Server bereit.
Installiert die Workflowassembly im globalen Assemblycache (GAC).
Startet Internetinformationsdienste (IIS) und SharePoint Server neu.
Aktiviert das Feature in SharePoint Server 2007.
Ordnet den Workflow der SharePoint-Bibliothek oder der Liste zu, die im Assistenten Neuer Office SharePoint-Workflow ausgewählt wurde.
Hängt den Visual Studio-Debugger an den Windows SharePoint Services-Prozess (w3wp.exe) an.
Zeigt die entsprechende Bibliothek- oder Listenseite an.
Hinweis:Soll die Workflowvorlage nicht automatisch der Bibliothek oder Liste zugeordnet werden, muss zuerst die Workflowvorlage der Bibliothek oder der Liste manuell mithilfe der Verwaltungsseite Workflow hinzufügen in SharePoint zugeordnet werden.
Visual Studio Tools for Office zeigt nach der Ausführung jeder Aufgabe im Ausgabefenster von Visual Studio eine Statusmeldung an. Kann eine Aufgabe nicht abgeschlossen werden, zeigt Visual Studio Tools for Office eine Fehlermeldung im Fenster Fehlerliste von Visual Studio an. Weitere Informationen zum Beheben von Fehlern finden Sie unter Problembehandlung bei SharePoint-Workflowprojektmappen.
Starten des Workflows
Der Workflow wird nicht vom Bereitstellungsprozess gestartet. Der Workflow muss von der SharePoint-Site gestartet werden. Der Workflow kann auch mithilfe einer Clientanwendung wie Microsoft Office Word 2007 oder mithilfe eines gesonderten serverseitigen Codes gestartet werden. Verwenden Sie eine der im Assistenten Neuer SharePoint-Workflow angegebenen Methoden.
Wenn Sie beispielsweise angegeben haben, dass der Workflow manuell gestartet werden kann, starten Sie den Workflow direkt vom Element in der Bibliothek oder der Liste. Weitere Informationen zum manuellen Starten eines Workflows finden Sie unter Manually start a workflow on a document item.
Siehe auch
Aufgaben
Gewusst wie: Einbeziehen von Hilfsdateien beim Debuggen einer SharePoint-Projektmappe
Beispiel für einen sequenziellen SharePoint-Workflow
Exemplarische Vorgehensweise: Erstellen und Debuggen einer SharePoint-Workflow-Projektmappe
Konzepte
SharePoint-Workflow-Projektmappen
Problembehandlung bei SharePoint-Workflowprojektmappen