Simple Tracking, exemple

Article
04/22/2008

Cet exemple illustre l'utilisation du service de suivi SQL fourni par Windows Workflow Foundation afin de suivre l'exécution d'un workflow.

L'exécution d'un workflow déclenche certains événements. Le service de suivi peut intercepter ces événements et stocker des informations les concernant dans une base de données SQL Server qui peut être interrogée.

L'exécution de workflow déclenche les types suivants d'événements :

Événements au niveau de l'instance. Ces événements sont déclenchés lorsqu'une instance de workflow passe dans un état particulier. Par exemple, un événement est déclenché lorsque l'instance de workflow est initialisée ou exécutée.
Événements au niveau de l'activité. Un workflow se compose d'activités, et chaque activité suit un cycle de vie. Pendant son cycle de vie, l'activité passe par plusieurs états. Un événement est déclenché lorsqu'une activité atteint un état particulier.
Événements suivis par un utilisateur. Un auteur de workflow peut créer des événements de suivi personnalisés et les ajouter au code-beside du workflow.

Les données du contexte des données du workflow peuvent être émises et transmises au service de suivi avec les événements.

Lorsque vous suivez un workflow, vous n'êtes pas forcément intéressé par tous les événements pour tous les états et activités. Vous pouvez créer un profil de suivi pour spécifier les événements et données qui vous intéressent. Le service de suivi SQL comporte un profil de suivi par défaut. Cet exemple montre comment utiliser le service de suivi SQL avec le profil de suivi par défaut.

Utilisez le code suivant pour inscrire un service de suivi avec l'exécution de workflow :

WorkflowRuntime wr = new WorkflowRuntime();
wr.AddService(new SqlTrackingService(connectionstring));
wr.StartRuntime();

La deuxième ligne inscrit le service de suivi SQL avec l'exécution de workflow. La chaîne de connexion est celle de la base de données de suivi.

Le résultat obtenu pour cet exemple se présentera comme suit :

Résultat de l'exemple Simple Tracking

Création de la base de données de suivi

Les services SQL installés par Windows Workflow Foundation utilisent Microsoft SQL Server pour stocker des informations. Vous pouvez utiliser Microsoft SQL Server 2005 Express, SQL Server 2000 et versions ultérieures ou Microsoft SQL Server 2000 Desktop Engine (MSDE) pour ces tâches.

Windows Workflow Foundation Setup n'installe pas les bases de données requises par ces services ; toutefois, il installe les scripts SQL pour créer et configurer les bases de données pour ces services.

Pour créer la base de données de suivi SQL

À l'aide de Microsoft SQL Server 2005 Express, SQL Server 2000 et versions ultérieures ou SQL Server 2000 Desktop Engine (MSDE), créez une base de données nommée Tracking avec l'instruction de requête SQL :
```
CREATE DATABASE Tracking
```

Remarque :
Lors de l'utilisation simultanée de SqlTrackingService et de SqlWorkflowPersistenceService dans une application de workflow, il est recommandé d'utiliser une base de données unique à la fois pour la persistance et le suivi.

Dans l'espace de travail de l'Analyseur de requêtes SQL, sélectionnez la base de données que vous avez créée à l'étape 1 dans la liste des bases de données disponibles.
Dans le menu Fichier, cliquez sur Ouvrir et ouvrez le script SQL %WINDIR%\Microsoft.NET\Framework\v3.0\Windows Workflow Foundation\SQL\<langue>\Tracking_Schema.sql.
Exécutez la requête en cliquant sur Exécuter ou en appuyant sur la touche F5 pour créer les tables de service de suivi SQL.
Dans le menu Fichier, cliquez sur Ouvrir et ouvrez le script SQL %WINDIR%\Microsoft.NET\Framework\v3.0\Windows Workflow Foundation\SQL\<langue>\Tracking_Logic.sql.
Exécutez la requête en cliquant sur Exécuter ou en appuyant sur la touche F5 pour créer les procédures stockées de service de suivi SQL.

Pour générer l'exemple

Téléchargez l'exemple en cliquant sur Télécharger l'exemple.

L'exemple de projet est alors extrait sur votre disque dur local.
Cliquez sur Démarrer, pointez sur Programmes, puis sur Microsoft Windows SDK et cliquez sur Environnement de commande.
Accédez au répertoire source de l'exemple.
À l'invite de commandes, tapez MSBUILD <Nom du fichier solution>.

Pour exécuter l'exemple

Dans la fenêtre Invite de commandes du Kit de développement SDK, exécutez le fichier .exe dans le dossier SimpleTrackingSample\bin\debug (ou le dossier SimpleTrackingSample\bin pour la version VB de l'exemple), situé sous le dossier principal de l'exemple.