Bewährte Methoden für die SharePoint-Workflowentwicklung
Stellt eine Sammlung von bewährten Methoden für Entwickler bereit, die Visual Studio zum Erstellen von Workflows in SharePoint verwenden.
Hinweis
SharePoint 2010-Workflows wurden am 1. August 2020 für neue Mandanten eingestellt und am 1. November 2020 aus bestehenden Mandanten entfernt. Wenn Sie SharePoint 2010-Workflows verwenden, empfehlen wir die Migration zu Power Automate oder anderen unterstützten Lösungen. Weitere Informationen hierzu finden Sie unter Einstellung von SharePoint 2010-Workflows.
Bewährte Methoden für die Workflowentwicklung
Für die Entwicklung fehlerfreier Workflows für SharePoint ist es empfehlenswert, einige allgemeine Richtlinien oder „bewährte Methoden" zu befolgen, unabhängig davon, ob Sie SharePoint Designer 2013 oder Visual Studio 2012 für die Workflowentwicklung verwenden.
Wenn Sie die Aktion „In Verlaufsliste protokollieren“ verwenden, sind mehr Informationen besser.
Schreiben Sie den Wert jeder Zeichenfolge und Variable, die Sie erstellen, in die Verlaufsliste.
Stellen Sie sicher, dass die Variablen nicht Null sind und erwartete Werte enthalten.
Workflowdesign: Modellieren eines Geschäftsprozesses in einem einzigen Workflow
Apps für SharePoint, die integrierte Workflows enthalten, müssen ein Tag in der Datei workflowmanifest.xml bearbeiten.
SharePoint-Add-Ins mit integrierten Workflows (die Listen im übergeordneten Web zugeordnet sein können) werden von normalen Workflow-Apps unterschieden, indem das folgende Tag in der Datei im App-Paket in workflowmanifest.xml geändert wird:
<SPIntegratedWorkflow xmlns="http://schemas.microsoft.com/sharepoint/2014/app/integratedworkflow">
<IntegratedApp>true</IntegratedApp>
</SPIntegratedWorkflow>
Wenn Sie die Aktion „In Verlaufsliste protokollieren“ verwenden, sind mehr Informationen besser.
Die Aktion In Verlaufsliste protokollieren (oder die Klasse LogToHistoryListActivity bei Verwendung von Visual Studio) ermöglicht Ihnen das Aufzeichnen von Informationen dazu, was ein Workflow zu einem bestimmten Punkt im Lebenszyklus des Workflows ausgeführt hat. Damit wird sie zu einem der wichtigsten Tools für die Problembehandlung, das Ihnen zur Verfügung steht. Je mehr Informationen Sie an wichtigen Punkten des Workflows bereitstellen, umso einfacher ist es, unerwartete Ereignisse zu behandeln.
Weitere Informationen erhalten Sie unter den folgenden Themen:
Workflowaktionen in SharePoint Designer 2010: eine Kurzübersicht
LogToHistoryListActivity -Klasse
Gewusst wie: Protokollieren in die Verlaufsliste von einer Workflowaktivität
Verwenden der SharePoint-Workflowaktion „In Verlaufsliste protokollieren" für das Debugging
Schreiben Sie den Wert jeder Zeichenfolge und Variable, die Sie erstellen, in die Verlaufsliste.
Das Debuggen von Workflows, die mit SharePoint Designer erstellt wurden, ist viel einfacher, wenn Sie Zeichenfolgen und Variablen in mithilfe der Aktion Log to History List in die Verlaufsliste schreiben.
Weitere Informationen erhalten Sie unter den folgenden Themen:
Workflowaktionen in SharePoint Designer 2010: eine Kurzübersicht
LogToHistoryListActivity -Klasse
Gewusst wie: Protokollieren in die Verlaufsliste von einer Workflowaktivität
Verwenden der SharePoint-Workflowaktion „In Verlaufsliste protokollieren" für das Debugging
Geben Sie vor und nach jedem Schritt oder jeder wichtigen Arbeitseinheit im Workflow ein Ablaufverfolgungsprotokoll aus.
Zur Unterstützung beim Debuggen von Workflows ist es wichtig, dass Sie vor und nach jeder wichtigen Arbeitseinheit aussagekräftige Informationen erfassen. Diese Informationen sollten in Ablaufverfolgungsprotokolle committet werden. Weitere Informationen finden Sie unter den folgenden Themen:
Stellen Sie sicher, dass die Variablen nicht Null sind und erwartete Werte enthalten.
Stellen Sie vor der Verwendung von Variablen in Ihren Workflows sicher, dass keine Null-Variablen vorhanden sind. Stellen Sie außerdem sicher, dass Variablen erwartete Werte enthalten und dem richtigen Datentyp entsprechen. Weitere Informationen finden Sie unter Variablen und Argumente.
Stellen Sie sicher, dass Zeichenfolgen in Textfeldern des Workflows nicht länger als 255 Zeichen sind.
Die maximale zulässige Länge für Zeichenfolgen in Textfeldern von Workflows beträgt 255 Zeichen. Wenn Sie das Textfeld so festlegen, dass dieser Grenzwert überschritten wird, wird dessen Inhalt auf 255 Zeichen abgeschnitten.
Verwenden Sie erhöhte Berechtigungen für ein neutrales Konto bei Verwendung eines Identitätswechsels.
Wenn Sie Identitätswechselschritte in einem Workflow verwenden, sollten Sie den Workflow mit einem neutralen Konto (d. h. einem Konto, das nicht an einen bestimmten Benutzer gebunden ist) erstellen. Dadurch wird verhindert, dass Ihre Workflows unterbrochen werden, wenn das Konto des Autors aus irgendeinem Grund veraltet ist.
Weitere Informationen finden Sie unter Erstellen eines Workflows mit erhöhten Berechtigungen mithilfe der SharePoint-Workflowplattform.
Verwenden Sie in wieder verwendbaren Workflows Zuordnungsspalten, um fehlerfreie Listenfelder sicherzustellen.
Bei der Erstellung eines wieder verwendbaren Workflows, der darauf basiert, dass seine Liste über ein bestimmtes Feld verfügt, können Sie (1) den Workflow auf einen Inhaltstyp mit dem angegebenen Feld beschränken oder (2) das Feld zu einer Zuordnungsspalte machen. Option 2 wird empfohlen, da es möglich ist, dass sich ein Inhaltstyp ändert und dazu führt, dass der Workflow unterbrochen wird.
Workflowdesign: Modellieren eines Geschäftsprozesses in einem einzigen Workflow
Wenn möglich, ist es viel besser, einen Geschäftsprozess in einem einzigen Workflow zu modellieren als die Workflowlogik in mehrere kleinere Workflows zu unterteilen.
Workflowdesign: Effektive Verwendung der Genehmigungsaktion
Wenn möglich, ist es statt der Erstellung mehrerer Approval-Aktionen effektiver, das Stages-Feature innerhalb einer Approval-Aktion zu verwenden.