Installieren und Konfigurieren von Workflow für SharePoint Server

  • Artikel

GILT FÜR:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

Dieser Artikel enthält die Informationen und Verfahren, die zum Konfigurieren von SharePoint Workflow-Manager (SPWFM) für SharePoint Server erforderlich sind.

Hinweis

Es gibt zwei separate Workflow-Engine-Produkte, die die SharePoint 2013-Workflowplattform unterstützen: Microsoft Workflow-Manager ("Classic WFM") und SharePoint Workflow-Manager (SPWFM). Microsoft Workflow-Manager kann nicht mehr installiert werden, während SharePoint Workflow-Manager veröffentlicht wurde, um es zu ersetzen. Daher wird in den anweisungen in diesem Dokument erläutert, wie SharePoint Workflow-Manager installiert wird.

Übersicht

Eine neue Option ist vorhanden, wenn Sie einen Workflow für SharePoint Server erstellen. Diese Option wird als Plattformtyp bezeichnet. Die Abbildung zeigt die Option Plattformtyp, wenn Sie einen neuen Workflow mithilfe von SharePoint Designer 2013 erstellen.

Abbildung: SharePoint Server umfasst drei Workflowplattform-Optionen.

Drei Workflowplattformen in SharePoint 2013.

Bei der Erstinstallation von SharePoint Server ist nur die SharePoint 2010 Workflow-Plattform verfügbar. Die SharePoint 2013-Workflowplattform und die Project Server-Plattform erfordern weitere Schritte. Die drei Workflow-Plattformen sind in der folgenden Tabelle beschrieben.

In SharePoint Server verfügbare Workflowplattformtypen

Plattformtyp Plattformframework Anforderungen
SharePoint 2010-Workflow
Windows Workflow Foundation 3
 Wird mit SharePoint Server automatisch installiert.
SharePoint 2013-Workflow
Windows Workflow Foundation 4
 Erfordert SharePoint Workflow-Manager oder Microsoft Workflow-Manager und SharePoint Server.
SharePoint 2013 Workflow - Project Server
Windows Workflow Foundation 4
 Erfordert SharePoint Workflow-Manager oder Microsoft Workflow-Manager und Project Server.

Hinweis

SharePoint-Workflow-Manager müssen separat von SharePoint Server heruntergeladen und installiert werden. It does not install automatically when you install SharePoint Server.

Neuinstallation von SharePoint Workflow-Manager

SharePoint-Workflow-Manager können auf denselben Servern wie SharePoint oder auf separaten dedizierten Servern installiert werden. Es wird empfohlen, sharePoint Workflow-Manager aus Leistungs- und Zuverlässigkeitsgründen auf eigenen dedizierten Servern zu installieren.

Hinweis

SharePoint Workflow-Manager wird in Farmen mit einer ungerade Anzahl von Hosts unterstützt, z. B. 1, 3 oder 5. Eine Farm mit 2 oder 4 SharePoint Workflow-Manager Hosts wird nicht unterstützt.

Voraussetzungen

SharePoint Workflow-Manager erfordert die Serverrolle Webserver (IIS). Wenn Sie SharePoint Workflow-Manager auf einem Server installieren, auf dem die IIS-Serverrolle nicht installiert ist, schlägt der Workflow-Manager-Konfigurations-Assistent mit einer Meldung wie Datei oder Assembly "Microsoft.Web.Administration" konnte nicht geladen werden fehl. Zusätzlich zu den Features, die standardmäßig mit der Webserverrolle installiert werden, erfordert SharePoint Workflow-Manager die folgenden Webserverfeatures:

  • Windows-Authentifizierung (unter Sicherheit)
  • .NET-Erweiterbarkeit 4.7 (unter Anwendungsentwicklung)
  • ASP.NET 4.7 (unter Anwendungsentwicklung)

Screenshot der Webserverfeatures, die für SharePoint Workflow-Manager erforderlich sind.

Hinweis

SharePoint-Workflow-Manager werden möglicherweise nicht ordnungsgemäß installiert und konfiguriert, wenn nur RODCs (schreibgeschützte Domänencontroller) in der Netzwerkumgebung verfügbar sind. Hierfür ist ein RWDC (Domänencontroller mit Lese-/Schreibzugriff) erforderlich. SharePoint Workflow-Manager erfordert Azure Service Fabric, das vor dem Ausführen von SharePoint Workflow-Manager-Setup installiert werden muss. Wenn die Azure Service Fabric-Runtime noch nicht installiert ist, führen Sie die folgenden Schritte aus, um sie zu installieren:

  1. Die von SharePoint Workflow-Manager unterstützte Mindestversion der Azure Service Fabric-Runtime ist 9.1.1583.9590. Sie können sie von Azure Service Fabric Runtime herunterladen. Sie können auch eine höhere Version von Windows Installer hier finden und herunterladen.

  2. Öffnen Sie eine PowerShell-Konsole als Administrator mit erhöhten Rechten, und führen Sie den folgenden Befehl aus:

    .\MicrosoftServiceFabric.9.1.1583.9590.exe /accepteula

  3. Um zu überprüfen, ob Azure Service Fabric installiert ist, sollten Sie es unter Programme und Features des Systemsteuerung finden können.

Hinweis

SharePoint Workflow-Manager unterstützt version 9.1 CU2 (9.1.1583.9590) von Azure Service Fabric und höheren Versionen.

Wenn Windows Fabric bereits auf Ihrem Computer installiert ist, müssen Sie es vor der Installation von Azure Service Fabric deinstallieren.

Es wurde berichtet, dass Azure Service Fabric möglicherweise eine große Anzahl von Protokollen generiert, wodurch der Speicherplatz auf dem Datenträger reduziert wird. Dies kann unabhängig von der SharePoint-Workflow-Manager Workload auftreten. Sie können dieses Problem identifizieren, indem Sie sich die im %ProgramData%\Microsoft Service Fabric\Log\Traces Verzeichnis generierten Dateien ansehen. Sie können die Protokollgröße nicht über die Clusterkonfiguration steuern, wobei nur Azure Service Fabric Runtime installiert ist. Möglicherweise müssen Sie abgelaufene Protokolle manuell löschen oder z. B. eine regelmäßige Aufgabe über den Windows-Aufgabenplaner erstellen, um dies zu tun.

Installieren von SharePoint Workflow-Manager

SharePoint Workflow-Manager und SharePoint Workflow-Manager Client können hier heruntergeladen werden. Die Systemanforderungen finden Sie ebenfalls auf dieser Seite.

Installieren Sie sharePoint Workflow-Manager und SharePoint Workflow-Manager Client auf allen Servern in der Workflow-Manager-Farm.

Installieren Sie nur den SharePoint Workflow-Manager Client auf allen Servern in der SharePoint Server-Farm.

Hinweis

Obwohl die Installation von SharePoint Workflow-Manager auf Servern mit SharePoint Server unterstützt wird, wird aus Leistungs- und Zuverlässigkeitsgründen empfohlen, sharePoint Workflow-Manager auf eigenen dedizierten Servern zu installieren.

Konfigurieren der SharePoint-Workflow-Manager-Farm

Um eine SharePoint Workflow-Manager-Farm zu erstellen und Ihre Server mit der Farm zu verbinden, können Sie SharePoint-Workflow-Manager über den Workflow-Manager-Konfigurations-Assistenten konfigurieren.

Melden Sie sich beim SharePoint-Workflow-Manager-Server an, klicken Sie auf "Workflow-Manager-Konfiguration", und klicken Sie je nach Anforderungen auf "Workflow-Manager mit Standardeinstellungen konfigurieren" oder "Workflow-Manager mit benutzerdefinierten Einstellungen konfigurieren". Wenn Sie verschiedene Ports, benutzerdefinierte Zertifikate oder benutzerdefinierte Datenbanknamen verwenden möchten, sollten Sie die Option "Workflow-Manager mit benutzerdefinierten Einstellungen konfigurieren" verwenden.

In diesem Beispiel verwenden wir die Option Standardeinstellungen.

Screenshot: Auswahl von Workflow-Manager mit Standardeinstellungen konfigurieren im Konfigurations-Assistenten für SharePoint Workflow-Manager

Hinweis

Standardmäßig ist nur DER HTTPS-Port (TLS/SSL) 12290 für die Workflowverwaltungswebsite konfiguriert. Wenn Sie auch die Kommunikation über unverschlüsselten HTTP-Port 12291 zulassen möchten, müssen Sie das Kontrollkästchen "Workflowverwaltung über HTTP auf diesem Computer zulassen" aktivieren. Dies ist ein Faktor beim späteren Ausführen des cmdlets Register-SPWorkflowService. Geben Sie die erforderlichen SQL Server- und Dienstkontodetails im Workflow-Assistenten an.

Screenshot: Konfigurationsoptionen im SharePoint Workflow-Manager-Konfigurations-Assistenten

Der Konfigurations-Assistent stellt eine Zusammenfassung Ihrer Optionen bereit, bevor ein Commit ausgeführt wird.

Screenshot: Zusammenfassungsseite des SharePoint-Workflow-Manager-Konfigurations-Assistenten.

Hinweis

Einige der Werte werden für Sie ausgewählt, wenn Sie die Option "Workflow-Manager mit Standardeinstellungen konfigurieren" verwenden. Wenn sie für Ihre Umgebung nicht korrekt sind, müssen Sie den Assistenten möglicherweise neu starten und "Workflow-Manager mit benutzerdefinierten Einstellungen konfigurieren" auswählen.

Der Konfigurations-Assistent sollte erfolgreich abgeschlossen werden. Wenn ein Fehler auftritt, wählen Sie den Link "Protokoll anzeigen" aus, suchen Sie das Problem, und beheben Sie es, bevor Sie den Assistenten erneut ausführen.

Screenshot: Der SharePoint-Workflow-Manager-Konfigurations-Assistent wurde erfolgreich abgeschlossen.

Wenn Sie eine SharePoint-Workflow-Manager-Farm mit mehreren Servern erstellen, müssen Sie den Workflowkonfigurations-Assistenten auf den anderen Knoten ausführen und die Option "Einer vorhandenen Workflow-Manager Farm beitreten" auswählen.

Konfigurieren von Diensten für App-Verwaltung und Abonnementseinstellungen in der SharePoint-Farm

Die Dienste App-Verwaltung und Abonnementeinstellungen sind in der SharePoint-Farm erforderlich, damit SharePoint 2013-Plattformworkflows funktionieren. Falls noch nicht in der SharePoint-Farm eingerichtet, richten Sie auf dem SharePoint-Server Dienste für die App-Verwaltung und Abonnementeinstellungen, Dienstanwendungen und Dienstanwendungsproxys ein.

Der App-Verwaltungsdienst kann mithilfe der Zentraladministration erstellt werden.

Sie können PowerShell verwenden, um eine Anwendung für den Abonnementeinstellungsdienst zu erstellen:

$sa = New-SPSubscriptionSettingsServiceApplication -ApplicationPool 'SharePoint Web Services Default' -Name 'Subscriptions Settings Service Application' -DatabaseName 'Subscription'

New-SPSubscriptionSettingsServiceApplicationProxy -ServiceApplication $sa

Konfigurieren von SharePoint Workflow-Manager für die Arbeit mit der SharePoint Server-Farm

Berücksichtigen Sie die folgenden Schlüsselfaktoren, bevor Sie SharePoint Workflow-Manager für die Arbeit mit SharePoint Server konfigurieren.

  • Wird für die Kommunikation zwischen SharePoint Workflow-Manager und SharePoint Server HTTP oder HTTPS verwendet?

Hinweis

Aus Sicherheitsgründen wird für eine Produktionsumgebung HTTPS empfohlen.

So konfigurieren Sie SharePoint-Workflow-Manager in einer Umgebung, in der die Kommunikation über HTTP erfolgt

Hinweis

Standardmäßig ist nur DER HTTPS-Port (TLS/SSL) 12290 für die Workflowverwaltungswebsite konfiguriert. Um die Verwendung von HTTP zu konfigurieren, sollte das Kontrollkästchen "Workflowverwaltung über HTTP auf diesem Computer zulassen" aktiviert sein, wenn der Assistent "Workflow-Manager-Konfiguration" in einem früheren Schritt ausgeführt wird.

  1. Melden Sie sich bei jedem Server in der SharePoint Server-Farm an.

  2. Installieren Sie den SharePoint Workflow-Manager Client auf jedem Server in der SharePoint-Farm.

    Wichtig

    Sie müssen den SharePoint Workflow-Manager Client auf jedem Server in der SharePoint-Farm installieren, bevor Sie das Cmdlet Register-SPWorkflowService ausführen.

  3. Öffnen Sie auf einem SharePoint-Server die SharePoint-Verwaltungsshell als Administrator, indem Sie mit der rechten Maustaste auf den Befehl SharePoint-Verwaltungsshell klicken und Als Administrator ausführen auswählen.

  4. Führen Sie das Cmdlet Register-SPWorkflowService aus, um die SharePoint-Farm mit der SharePoint-Workflow-Manager-Farm zu verbinden. Das Cmdlet sollte nur einmal ausgeführt werden und kann auf einem beliebigen Server in der SharePoint-Farm ausgeführt werden.

    Hinweis

    Der Wert für den Parameter -SPSite kann eine beliebige gültige Websitesammlung innerhalb der SharePoint-Farm sein. Den richtigen Wert für den Parameter -WorkflowHostUri finden Sie, indem Sie PowerShell Get-WFFarm | select endpoints auf dem SharePoint Workflow-Manager Server ausführen.

    Beispiel:

    Register-SPWorkflowService -SPSite "http://myserver/mysitecollection" -WorkflowHostUri "http://workflow.example.com:12291" -AllowOAuthHttp

So konfigurieren Sie SharePoint-Workflow-Manager in einer Umgebung, in der die Kommunikation über HTTPS erfolgt

  1. Bestimmen Sie, ob Sie SharePoint-Workflow-Manager-Zertifikate auf den SharePoint-Servern installieren müssen.

    Unter bestimmten Umständen müssen Sie SharePoint-Workflow-Manager-Zertifikate abrufen und installieren. Wenn Ihre Installation erfordert, dass Sie diese Zertifikate abrufen und installieren, müssen Sie diesen Schritt ausführen, bevor Sie fortfahren. Informationen dazu, ob Sie Zertifikate installieren müssen, und Anweisungen finden Sie unter Installieren Workflow-Manager Zertifikate in SharePoint Server.

  2. Melden Sie sich bei jedem Server in der SharePoint Server-Farm an.

  3. Installieren Sie den SharePoint Workflow-Manager Client auf jedem Server in der SharePoint-Farm.

    Wichtig

    Sie müssen den SharePoint Workflow-Manager Client auf jedem Server in der SharePoint-Farm installieren, bevor Sie das Cmdlet Register-SPWorkflowService ausführen.

  4. Öffnen Sie die SharePoint 15-Verwaltungsshell als Administrator. Klicken Sie dazu mit der rechten Maustaste auf den Befehl SharePoint-Verwaltungsshell, und wählen Sie Als Administrator ausführen.

  5. Führen Sie das Cmdlet Register-SPWorkflowService aus, um die SharePoint-Farm mit der SharePoint-Workflow-Manager-Farm zu verbinden. Das Cmdlet sollte nur einmal ausgeführt werden und kann auf einem beliebigen Server in der SharePoint-Farm ausgeführt werden.

    Hinweis

    Der Wert für den Parameter -SPSite kann eine beliebige gültige Websitesammlung innerhalb der SharePoint-Farm sein. Den richtigen Wert für den Parameter -WorkflowHostUri finden Sie, indem Sie PowerShell Get-WFFarm | select endpoints auf dem SharePoint Workflow-Manager Server ausführen.

    Beispiel:

    Register-SPWorkflowService -SPSite "https://myserver/mysitecollection" -WorkflowHostUri "https://workflow.example.com:12290"

Aktualisieren vorhandener Microsoft-Workflow-Manager

Microsoft Workflow-Manager kann nicht direkt aktualisiert werden, und SharePoint-Workflow-Manager können nicht über Microsoft Workflow-Manager platziert werden. Um Microsoft Workflow-Manager (Classic WFM) auf SharePoint Workflow-Manager (SPWFM) zu aktualisieren, müssen Sie alle früheren Versionen von Workflow-Manager, Workflow-Manager Client und Service Bus deinstallieren.

Hinweis

Sie können von jeder Version von Microsoft Workflow-Manager ein Upgrade auf SharePoint Workflow-Manager durchführen. Da Sie eine vorhandene "klassische WFM"-Farm auf SPWFM aktualisieren, werden die WFM Datenbanken wiederverwendet, und Ihre vorhandenen Registrierungen und Workflows sollten intakt bleiben.

Führen Sie die folgenden Schritte aus, um Microsoft Workflow-Manager zu deinstallieren und SharePoint Workflow-Manager zu installieren:

Wichtig

Da die Upgradeschritte erfordern, dass Sie einer vorhandenen WFM Farm nicht mehr beitreten und dann erneut beitreten, benötigen Sie beim erneuten Beitreten den WFM "Zertifikatgenerierungsschlüssel". Wenn Sie nicht sicher sind, was dieser Schlüssel ist und sie nicht irgendwo dokumentiert haben, müssen Sie möglicherweise den Zertifikatgenerierungsschlüssel zurücksetzen , bevor Sie fortfahren. Sie können der vorhandenen Workflowfarm nicht ohne einen gültigen Zertifikatgenerierungsschlüssel beitreten.

  1. Führen Sie den Workflow-Manager-Konfigurations-Assistenten aus.

  2. Wählen Sie Farm verlassen Workflow-Manager aus.

  3. Bestätigen Sie die nachfolgenden Schritte bis zum Ende des Assistenten.

  4. Wiederholen Sie diesen Schritt auf jedem Microsoft Workflow-Manager-Server in der Workflowfarm.

    Hinweis

    Jede datenbank, die von Workflow-Manager und Service Bus verwendet wird, muss angegeben werden, wenn sie der Farm erneut mit SharePoint Workflow-Manager beitreten. Beispielsweise der SQL Server instance und der Datenbankname für die Workflow-Manager Farmverwaltungsdatenbank und die Service Bus-Farmverwaltungsdatenbank.

  5. Deinstallieren Sie Microsoft Workflow-Manager, Workflow-Manager Client, Service Bus für Windows Server und Windows Fabric, wenn sie installiert sind. Sie können sie aus dem Systemsteuerung deinstallieren. Wenn Windows Fabric installiert ist, stellen Sie sicher, dass Sie Azure Service Fabric nach der Deinstallation Windows Fabric installieren.

    Wichtig

    Wenn Sie SharePoint-Workflow-Manager auf einem SharePoint-Server installieren, werden möglicherweise sowohl "Windows Fabric" als auch "AppFabric 1.1 für Windows Server" installiert. Stellen Sie sicher, dass Sie nur Windows Fabric deinstallieren. Deinstallieren Sie AppFabric 1.1 nicht. Es handelt sich um einen anderen Dienst, der für verteilten SharePoint-Cache erforderlich ist.

  6. Wenn die Ordner "%ProgramFiles%\Workflow-Manager\1.0" oder "%Programme%\Service Bus\1.0" bereits vorhanden sind, müssen Sie sie manuell entfernen, damit die nächsten Schritte erfolgreich sind.

  7. Starten Sie den SharePoint Workflow-Manager Server neu.

  8. Wenn es noch nicht installiert ist, führen Sie die Schritte aus dem Abschnitt Voraussetzungen oben aus, um Azure Service Fabric zu installieren.

  9. Installieren Sie SharePoint Workflow-Manager und SharePoint Workflow-Manager Client. SharePoint Workflow-Manager und SharePoint Workflow-Manager Client können hier heruntergeladen werden. Die Systemanforderungen finden Sie ebenfalls auf dieser Seite.

  10. Führen Sie den Workflow-Manager-Konfigurations-Assistenten aus, und wählen Sie "Einer vorhandenen Workflow-Manager Farm beitreten" aus, um der vorherigen Farm erneut beizutreten. Verwenden Sie die Informationen zu Datenbank, Dienstkonto und Zertifikatgenerierungsschlüssel, die in der vorherigen Farm "Classic WFM" verwendet wurden.

    Hinweis

    Beim Upgrade ist es in der Regel nicht erforderlich, die vorhandene Workflowdienst-Anwendungsproxy zu löschen und die Verbindung mithilfe des Cmdlets Register-SPWorkflowService wiederherzustellen. Wenn die Gültigkeit des Zertifikatgenerierungsschlüssels für SharePoint Workflow-Manager und Service Bus auftritt, müssen Sie ihn möglicherweise zurücksetzen. Weitere Informationen finden Sie unter Zurücksetzen des Zertifikatgenerierungsschlüssels.

  11. Führen Sie den Workflow-Manager-Konfigurations-Assistenten erneut aus, wählen Sie Upgrade Workflow-Manager Farm aus, und bestätigen Sie die nachfolgenden Schritte bis zum Ende.

    Hinweis

    Dieser Schritt sollte auf allen Servern in der SharePoint-Workflow-Manager-Farm ausgeführt werden. Die Option "Upgrade Workflow-Manager Farm" wird immer im Workflow-Manager-Konfigurations-Assistenten angezeigt, unabhängig davon, ob ein Upgrade erforderlich ist oder nicht. Es ist kein Schaden, wenn sie mehrmals ausgeführt wird oder wenn kein Upgrade aussteht.

  12. Wenn in Ihrer Workflow-Manager Farm mehrere Server vorhanden sind, wiederholen Sie die vorherigen Schritte auf allen Workflowfarmservern.

  13. Installieren Sie den SharePoint Workflow-Manager Client auf jedem Server in der SharePoint Server-Farm, nachdem Sie frühere Versionen deinstalliert haben.

Überprüfen der Installation

Führen Sie die folgenden Schritte aus, um zu überprüfen, ob Sie die erforderlichen Komponenten erfolgreich installiert und konfiguriert haben.

So überprüfen Sie die Installation

  1. Fügen Sie Ihrer SharePoint-Website einen Benutzer hinzu, und erteilen Sie dem Benutzer Website Designer Berechtigungen.
  2. Installieren Sie SharePoint Designer 2013 auf einem Clientcomputer, und erstellen Sie einen Workflow basierend auf der SharePoint 2013-Workflowplattform. Weitere Informationen dazu finden Sie unter Erstellen eines Workflows mithilfe von SharePoint Designer 2013 und der SharePoint 2013-Workflowplattform.
  3. Führen Sie diesen Workflow auf der SharePoint-Benutzeroberfläche aus.

Problembehandlung

Aus Sicherheitsgründen kann das Setupkonto nicht zum Erstellen eines Workflows verwendet werden, der auf der SharePoint 2013-Workflowplattform basiert. Wenn Sie versuchen, einen Workflow basierend auf der SharePoint 2013-Workflowplattform mithilfe von SharePoint Designer 2013 zu erstellen, erhalten Sie eine Warnung, dass die Liste der Workflowaktionen nicht vorhanden ist und der Workflow nicht erstellt wird.

Der Benutzer, der einen Workflow bereitstellt und ausführt, muss dem Benutzerprofildienst hinzugefügt sein. Überprüfen Sie die Anwendungsseite des Benutzerprofildiensts in der Zentraladministration, um zu bestätigen, dass der Benutzer, den Sie zum Überprüfen der Workflowinstallation verwenden, im Benutzerprofildienst ist.

Sie können - wie in der Abbildung dargestellt - mithilfe des IIS-Managers ermitteln, welche Ports von SharePoint Server und Workflow-Manager für HTTP und HTTPS verwendet werden.

Abbildung: Anzeigen der von SharePoint Workflow-Manager verwendeten Ports mithilfe des IIS-Managers

Anzeigen von Ports im IIS-Manager.

SharePoint Workflow-Manager kommuniziert über TCP/IP oder Named Pipes. Stellen Sie sicher, dass das entsprechende Kommunikationsprotokoll auf dem SQL Server instance aktiviert ist, der die SharePoint-Workflow-Manager-Datenbanken hostet.

Der SQL Browser-Dienst muss auf der SQL Server-Instanz ausgeführt werden, die die Workflow-Manager-Datenbank hostet.

Das Systemkonto kann nicht zum Entwickeln eines Workflows verwendet werden.

Informationen zur Problembehandlung bei SharePoint Server finden Sie unter Problembehandlung für SharePoint Server.