Freigeben über

Extrahieren von WF-Daten mithilfe der Nachverfolgung

  • Artikel

Dieses Thema gilt für Windows Workflow Foundation 4.

In diesem Beispiel wird veranschaulicht, wie die Workflownachverfolgung verwendet wird, um Workflowvariablen und Argumente aus Aktivitäten zu extrahieren. Außerdem wird auch das Hinzufügen von Bemerkungen zu Überwachungsdatensätzen sowie das Extrahieren der Datennutzlast innerhalb von benutzerdefinierten Überwachungsdatensätzen dargestellt. Im Beispiel wird der ETW-Überwachungsteilnehmer (Ereignisablaufverfolgung für Windows) zum Extrahieren von Daten aus dem Workflow verwendet.

Beispieldetails

Windows Workflow Foundation (WF) stellt die Überwachung bereit, um einen Einblick in die Ausführung einer Workflowinstanz zu erhalten. Die Überwachungslaufzeit gibt während der Ausführung des Workflows Workflowüberwachungsdatensätze aus. Zusammen mit den Workflowüberwachungsdatensätzen können Daten innerhalb der Workflowinstanz aus dem Workflow extrahiert werden. In der folgenden Liste sind die Typen von Daten aufgeführt, die aus Überwachungsdatensätzen extrahiert werden können:

  1. Workflowvariablen in einer Aktivität und Überwachungsdatensätze während der Aktivitätsausführung.

    Um Workflowvariablen zu extrahieren, werden die zu extrahierenden Variablen in einem Profil angegeben. Zu extrahierende Variablen können nur mit ActivityStateQueries angegeben werden. Im folgenden Codebeispiel ist ein Überwachungsprofil dargestellt, das zum Extrahieren der Workflowvariablen aus einer Aktivität verwendet wird.

    <activityStateQuery activityName="StockPriceService">
     <states>
          <state name="Closed"/>
     </states>
     <variables>
          <variable name="symbol"/>
     </variables>
</activityStateQuery>

  2. Aktivitätsargumente und Aktivitätszustands-Überwachungsdatensätze.

    Argumente definieren die Richtung, in der Daten in oder aus einer Aktivität fließen. Zu extrahierende Argumente werden mit einer ActivityStateQuery angegeben. Im folgenden Codebeispiel ist ein Überwachungsprofil dargestellt, das das Value-Argument extrahiert.

    <activityStateQuery activityName="GetStockPrice">
     <states>
          <state name="Closed"/>
     </states>
     <arguments>
          <argument name="Value"/>
     </arguments>
</activityStateQuery>

  3. Anmerkungen sind Schlüssel-Wert-Paare, die einem beliebigen Überwachungsdatensatz hinzugefügt werden können, der ausgegeben wird.

    Anmerkungen dienen der Markierung von Überwachungsdatensätzen. Sie verwenden Überwachungsdatensätzen über ein Überwachungsprofil hinzugefügt. Anmerkungen können einem beliebigen Typ einer Workflowüberwachungsabfrage hinzugefügt werden. Im folgenden Codebeispiel ist ein Nachverfolgungsprofil dargestellt, das zeigt, wie einem Überwachungsdatensatz eine Anmerkung hinzugefügt werden kann.

    <workflowInstanceQuery>
     <states>
          <state name="Started"/>
     </states>
     <annotations>
          <annotation name="StockPriceWorkflow" value="Begin"/>
     </annotations>
</workflowInstanceQuery>

  4. Benutzerdefinierte Überwachungsdatensätze werden von benutzerdefinierten Aktivitäten ausgegeben.

    Benutzerdefinierte Überwachungsdatensätze können innerhalb dieser Aktivität definierte Nutzlastdaten tragen. Durch Abonnieren von benutzerdefinierten Überwachungsdatensätzen in einem Überwachungsprofil wird das Extrahieren der Nutzlast innerhalb des Überwachungsdatensatzes ermöglicht. Die benutzerdefinierten Überwachungsdatensätze können mit einer benutzerdefinierten TrackingQuery extrahiert werden. Im folgenden Codebeispiel ist ein Überwachungsprofil dargestellt, das einen benutzerdefinierten Überwachungsdatensatz zusammen mit seiner Nutzlast extrahiert.

    <customTrackingQuery name="QuoteLookupEvent" activityName="GetStockPrice"/>

In dem Beispiel wird das Extrahieren von Variablen, Argumenten, benutzerdefinierten Datensätzen und das Hinzufügen von Anmerkungen mithilfe eines in "Web.config" angegebenen Profils veranschaulicht. Die Nachverfolgung wird in dem Beispielworkflowdienst durch Hinzufügen eines <etwTracking>-Verhaltenselements ermöglicht. Im folgenden Codebeispiel wird die Verfolgung für das ExtractWorkflowVariables-Nachverfolgungsprofil aktiviert.

<serviceBehaviors>
     <behavior>
               <etwTracking profileName="ExtractWorkflowVariables"/>
     </behavior>
</serviceBehaviors>

So verwenden Sie dieses Beispiel

  1. Öffnen Sie mit Visual Studio 2010 die Projektmappendatei "WFStockPriceApplication.sln".

  2. Drücken Sie F6, um die Projektmappe zu erstellen.

  3. Drücken Sie F5, um die Projektmappe auszuführen.

    Das Browserfenster wird geöffnet und zeigt die Verzeichnisliste für die Anwendung an.

  4. Klicken Sie im Browser auf "StockPriceService.xamlx".

  5. Der Browser zeigt die Seite "StockPriceService" an, die die WSDL-Adresse des lokalen Diensts enthält. Kopieren Sie diese Adresse.

    Das folgende Beispiel zeigt eine WSDL-Adresse des lokalen Diensts. https://localhost:53797/StockPriceService.xamlx?wsdl

  6. Starten Sie vor dem Aufrufen des Diensts die Ereignisanzeige, und stellen Sie sicher, dass das Ereignisprotokoll eine Überwachung für vom Workflowdienst ausgegebene Überwachungsereignisse ausführt.

  7. Wählen Sie aus dem Menü Start die Option Verwaltung und dann Ereignisanzeige.

  8. Navigieren Sie in der Strukturansicht der Ereignisanzeige zu Ereignisanzeige, Anwendungs- und Dienstprotokolle und Microsoft. Klicken Sie mit der rechten Maustaste auf Microsoft, und wählen Sie Ansicht und dann Analytische und Debugprotokolle einblenden aus.

    Stellen Sie sicher, dass die Option Analytische und Debugprotokolle einblenden aktiviert ist.

  9. Navigieren Sie in der Strukturansicht der Ereignisanzeige zu Ereignisanzeige, Anwendungs- und Dienstprotokolle, Microsoft, Windows, Anwendungsserver-Anwendungen. Klicken Sie mit der rechten Maustaste auf Analytisch, und wählen Sie Protokoll aktivieren.

  10. Öffnen Sie den WCF-Testclient mit Windows Explorer.

    Der WCF-Testclient (WcfTestClient.exe) befindet sich im Ordner "<Visual Studio 2010-Installationsordner>\Common7\IDE\".

    Der standardmäßige Visual Studio 2010-Installationsordner ist "C:\Programme\Microsoft-Visual Studio 10.0".

  11. Wählen Sie im WCF-Testclient im Menü Datei die Option Dienst hinzufügen aus.

    Fügen Sie die WSDL-Adresse des lokalen Diensts, die Sie zuvor kopiert haben, in das Eingabefeld ein.

  12. Doppelklicken Sie im WCF-Testclient auf GetStockPrice.

    Dadurch wird die GetStockPrice-Methode geöffnet. Die Anforderung akzeptiert einen Parameter. Verwenden Sie den Wert Contoso.

  13. Klicken Sie auf Aufrufen.

  14. Wechseln Sie zurück zur Ereignisanzeige, und navigieren Sie zu Ereignisanzeige, Anwendungs- und Dienstprotokolle, Microsoft, Windows, Anwendungsserver-Anwendungen. Klicken Sie mit der rechten Maustaste auf Analytisch, und wählen Sie Aktualisieren. Die Workflowereignisse befinden sich im Ereignis-ID-Bereich 100-199.

    Die Ereignisse enthalten die Anmerkungen, Variablen, Argumente und benutzerdefinierten Überwachungsdatensätze, die in der Ereignisanzeige angezeigt werden können.

Bereinigen in der Ereignisanzeige

Der analytische Channel im Ereignisprotokoll kann in der Ereignisanzeige folgendermaßen bereinigt werden.

So führen Sie eine Bereinigung aus (optional)

  1. Öffnen Sie die Ereignisanzeige.

  2. Navigieren Sie zu Ereignisanzeige, Anwendungs- und Dienstprotokolle, Microsoft, Windows, Anwendungsserver-Anwendungen. Klicken Sie mit der rechten Maustaste auf Analytisch, und wählen Sie Protokoll deaktivieren aus.

  3. Navigieren Sie zu Ereignisanzeige, Anwendungs- und Dienstprotokolle, Microsoft, Windows, Anwendungsserver-Anwendungen. Klicken Sie mit der rechten Maustaste auf Analytisch, und wählen Sie Protokoll löschen aus.

    Wählen Sie die Option Löschen aus, um die Ereignisse zu löschen.

Bekannte Probleme

Ee662966.note(de-de,VS.100).gifHinweis:
Es gibt ein bekanntes Problem in der Ereignisanzeige, bei dem bei der Decodierung von ETW-Ereignissen ein Fehler auftritt. Möglicherweise wird eine Fehlermeldung ähnlich der Folgenden angezeigt.

Die Beschreibung für die Ereignis-ID <ID> aus der Quelle Microsoft Windows-Anwendungsserver-Anwendungen wurde nicht gefunden. Entweder ist die Komponente, die dieses Ereignis auslöst, nicht auf dem lokalen Computer installiert, oder die Installation ist beschädigt. Sie können die Komponente auf dem lokalen Computer installieren oder reparieren.

Wenn dieser Fehler auftritt, klicken Sie im Aktionsbereich auf Aktualisieren. Das Ereignis sollte jetzt ordnungsgemäß decodiert werden.

Ee662966.Important(de-de,VS.100).gif 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\Tracking\ExtractWfData