Integrierte Konfiguration

Dieses Thema gilt für Windows Workflow Foundation 4.

In diesem Beispiel werden die Verwendung und die Konfiguration des SQL-Workflowinstanzspeichers veranschaulicht. Beim SQL-Workflowinstanzspeicher handelt es sich um die SQL-basierte Implementierung eines Instanzspeichers. Diese ermöglicht einer Instanz das Speichern und Laden von Zuständen in eine bzw. aus einer SQL Server- oder SQL Server Express-Datenbank.

Hinweis:

Die Beispiele sind möglicherweise bereits auf dem Computer installiert. Überprüfen Sie das folgende (standardmäßige) Verzeichnis, bevor Sie fortfahren. <Installationslaufwerk>:\WF_WCF_Samples Wenn dieses Verzeichnis nicht vorhanden ist, rufen Sie (Downloadseite) auf, und laden Sie alle Windows Communication Foundation (WCF)-Beispiele und WF-Beispiele herunter. Dieses Beispiel befindet sich im folgenden Verzeichnis. <Installationslaufwerk>:\WF_WCF_Samples\WF\Basic\Persistence\BuiltInConfiguration

Beispieldetails

Dieses Beispiel besteht aus einem Workflow, der einen Zähldienst implementiert. Wenn die Startmethode des Diensts aufgerufen wird, zählt der Dienst von 0 bis 59. Der Zählerwert wird alle zwei Sekunden erhöht. Der Workflow wird nach jeder Erhöhung des Zählerwerts gespeichert.

Der Zählworkflow wird auf einem Workflowdiensthost gehostet. Die Main-Methode des Programms erstellt eine Instanz des Workflowdiensthosts, auf dem der Zählworkflow gehostet ist. Zunächst werden die Endpunkte definiert, unter denen der Zählworkflow erreichbar ist. Anschließend wird das Verhalten zur Konfiguration des SQL-Workflowinstanzspeichers definiert. Dann erstellt das Programm einen Client, der die Startmethode des Zählworkflows aufruft.

Der Zählvorgang wird bei Programmstart automatisch gestartet. Beachten Sie, dass das Laden der Instanz und die Konfiguration des SQL-Workflowinstanzspeichers einige Sekunden dauern kann. Weitere Informationen über zum Workflowinstanzspeicher finden Sie unter SQL-Workflowinstanzspeicher.

Das Beispiel besteht aus zwei Teilen:

1. InstanceStore1 zeigt, wie der SqlWorkflowInstanceStore mit C#-Code konfiguriert wird (siehe "Program.cs").

2. InstanceStore2 zeigt, wie der SqlWorkflowInstanceStore mit XML konfiguriert wird (siehe "App.config").

Die folgenden Einstellungen sind zur Konfiguration des SQL-Workflowinstanzspeichers verfügbar:

• Legen Sie den HostLockRenewalPeriod-Wert fest. Dieser Wert definiert das Intervall zur Erneuerung des Sperrbesitzes der auf dem Host ausgeführten Instanzen. Die Sperrinformationen werden im Instanzspeicher gespeichert. Wenn der Besitz im Verlauf von zwei der mit HostLockRenewalPeriod definierten Intervalle nicht erneuert wird, gilt die Instanz als abgebrochen. Wenn ein anderer WorkflowServiceHost den gleichen Workflow ausführt und mit dem gleichen Instanzspeicher verbunden ist (auf dem gleichen oder auf einem anderen Computer), stellt dieser die Instanz wieder her. (Die Instanzwiederherstellung wird in diesem Beispiel nicht behandelt.)

• Legen Sie den RunnableInstancesDetectionPeriod-Wert fest. Dieser Wert definiert das Intervall, mit dem der Host Abfragen nach ausführbaren Instanzen ausführt. Instanzen können ausführbar werden, wenn eines der folgenden Ereignisse auftritt:

  • Ein permanenter Zeitgeber (Delay) läuft ab.

  • Ein anderer Host hält das HostLockRenewal-Intervall nicht ein (z. B. aufgrund eines Computerabsturzes), und die Instanz wird wiederhergestellt.

• Legen Sie den InstanceCompletionAction-Wert fest. Wenn Sie diese Eigenschaft auf DeleteNothing festlegen, verbleiben abgeschlossene Instanzen im Instanzspeicher. Wenn Sie diese Eigenschaft auf DeleteAll festlegen, werden abgeschlossene Instanzen aus dem Speicher gelöscht. Hinweis

  Hinweis:
  Wenn Sie den Host vor Abschluss des Zählvorgangs durch Drücken der EINGABETASTE beenden, wird die Workflowinstanz nicht abgeschlossen.

• Legen Sie den InstanceLockedExceptionAction-Wert fest. Mit dieser Einstellung wird die Aktion definiert, die vom Host ausgeführt wird, um eine Instanz zu laden, die durch einen anderen Host gesperrt ist. Folgende Optionen sind verfügbar:

  • NoRetry: Der Ladevorgang wird nicht erneut versucht, und auf dem Host wird eine InstanceLockedException zurückgegeben.

  • BasicRetry: Der Versuch, die Instanz zu laden, wird wiederholt. Die Wiederholungen erfolgen nach einem einfachen linearen Algorithmus (z. B. alle fünf Sekunden).

  • AggressiveRetry: Der Versuch, die Instanz zu laden, wird wiederholt. Die Wiederholungen erfolgen nach einem exponentiellen Backoff-Algorithmus.

• Legen Sie die Codierungsoption fest. Mit dieser Einstellung definieren Sie, wie der Instanzstatus im SQL-Workflowinstanzspeicher gespeichert wird. Folgende Optionen sind verfügbar:

  • Der Instanzstatus wird mit dem GZip-Algorithmus komprimiert.

  • Der Instanzstatus wird nicht komprimiert.

So verwenden Sie dieses Beispiel

1. Öffnen Sie eine Visual Studio 2010-Eingabeaufforderung als Administrator, falls Sie über die erforderlichen Berechtigungen verfügen.

2. Navigieren Sie zum Beispielverzeichnis (\WF\Basic\Persistence\BuiltInConfiguration\CS), und führen Sie "CreateInstanceStore.cmd" aus.

3. Wenn Sie nicht über Administratorberechtigungen verfügen, erstellen Sie eine SQL Server-Anmeldung. Navigieren Sie zu Security, Anmeldungen. Klicken Sie mit der rechten Maustaste auf Anmeldungen, und erstellen Sie eine neue Anmeldung.

4. Fügen Sie der SQL-Rolle Ihr ACL-Benutzerkonto hinzu. Öffnen Sie Datenbanken, InstanceStore, Sicherheit. Klicken Sie mit der rechten Maustaste auf Benutzer, und wählen Sie Neue Benutzer. Wählen Sie unter Anmeldename den im vorherigen Schritt erstellten Benutzer. Fügen Sie den Benutzer der Datenbankrolle System.Activities.DurableInstancing.InstanceStoreUsers (und anderen) hinzu. Beachten Sie, dass der Benutzer möglicherweise bereits vorhanden ist (z. B. als DBO).

5. Öffnen Sie die Datei "InstanceStore.sln" in Visual Studio 2010, und erstellen Sie die Projektmappe, indem Sie F6 drücken.

6. Navigieren Sie im Windows-Explorer zum bin\debug-Verzeichnis des Beispiels (\WF\Basic\Persistence\BuiltInConfiguration\cs\InstanceStore1 bzw. InstanceStore2\bin\debug), klicken Sie mit der rechten Maustaste auf "InstanceStore.exe", und wählen Sie Als Administrator ausführen. Dieses Beispiel muss mit Administratorberechtigungen ausgeführt werden, da es einen Kanallistener öffnet.

7. Wenn Sie den Instanzspeicher nicht in der lokalen Installation von SQL Server Express erstellt haben, müssen Sie die Datenbankverbindungszeichenfolge (InstanceStore1-Projekt: const string ConnectionString in der Datei "Program.cs", InstanceStore2-Projekt: connectionString-Attribut in der Datei "App.config") im Beispiel aktualisieren und das Beispiel neu kompilieren.

So überprüfen Sie, ob das Beispiel ordnungsgemäß ausgeführt wird

1. Starten Sie SQL Server Management Studio, während das Beispiel ausgeführt wird.

2. Wählen Sie im Objekt-Explorer Datenbanken, InstanceStore, Tabellen und dann System.Activities.DurableInstancing.InstanceTable.

3. Klicken Sie mit der rechten Maustaste auf InstanceTable, und wählen Sie Oberste 1000 Zeilen auswählen.

4. Beachten Sie, dass ein neuer Eintrag hinzugefügt wurde und dass der Lock Expiration-Wert sich alle fünf Sekunden ändert. (Klicken Sie in der Taskleiste auf die Schaltfläche Ausführen, um die Abfrage zu aktualisieren.) Dies ist der Fall, da Sie den Host Lock Renewal Period-Wert auf 5 festgelegt haben.

5. Nach Abschluss des Zählvorgangs wird der Eintrag aus der Instanztabelle entfernt. Dies ist der Fall, da Sie den Instance Completion Action-Wert auf DeleteAll festgelegt haben.

6. Drücken Sie die EINGABETASTE, um die Workflowhostanwendung zu beenden. Beachten Sie, dass die LockOwnersTable gelöscht wird.

So deinstallieren Sie das Beispiel

1. Führen Sie "RemoveInstanceStore.cmd" im Beispielverzeichnis (\WF\Basic\Persistence\BuiltInConfiguration) aus.

Hinweis:

Die Beispiele sind möglicherweise bereits auf dem Computer installiert. Überprüfen Sie das folgende (standardmäßige) Verzeichnis, bevor Sie fortfahren. <Installationslaufwerk>:\WF_WCF_Samples Wenn dieses Verzeichnis nicht vorhanden ist, rufen Sie Windows Communication Foundation (WCF) and Windows Workflow Foundation (WF) Samples for .NET Framework 4 auf, um alle Windows Communication Foundation (WCF)- und WF-Beispiele herunterzuladen. Dieses Beispiel befindet sich im folgenden Verzeichnis. <Installationslaufwerk>:\WF_WCF_Samples\WF\Basic\Persistence\BuiltInConfiguration