Tracking Profile Designer, exemple

Article
04/22/2008

Le concepteur de profil de suivi de workflow est un outil permettant la création de profils de suivi à partir de définitions de workflow à l'aide de l'aire du concepteur de workflow. Pour cet exemple d'application, on suppose que vous êtes familiarisé avec les services et les profils de suivi. Pour plus d'informations, consultez les références figurant à la fin de cette rubrique.

Pour générer l'exemple

Téléchargez l'exemple en cliquant sur Télécharger l'exemple dans cette rubrique.

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 TrackingProfileDesigner\bin\debug (ou le dossier TrackingProfileDesigner\bin pour la version VB de l'exemple), situé sous le dossier principal de l'exemple.

Création de profils de suivi

Suivez ces procédures pour ajouter et configurer des trackpoints d'activité et ouvrir des profils de suivi.

Pour créer un trackpoint d'activité

Dans le menu File, cliquez sur Open, puis sur Workflow From File.
Naviguez jusqu'à l'assembly qui contient le workflow que vous souhaitez utiliser, puis cliquez sur Open pour revenir à l'écran principal du concepteur de profil de suivi de workflow.
Sur l'aire du concepteur, cliquez sur une activité pour la sélectionner.

Cela active le bouton Track sur la barre d'outils.
Cliquez sur Track pour suivre l'activité sélectionnée.

Pour configurer un trackpoint d'activité

Cliquez sur Events pour sélectionner l'événement d'état de l'activité que vous souhaitez suivre pour le trackpoint sélectionné.

Vous pouvez sélectionner zéro ou tous les événements en cliquant sur Select All ou Select None.
Cliquez sur Annotate pour ouvrir une barre d'outils Annotation.
Dans la zone de texte, entrez une chaîne pour décrire le trackpoint d'activité.
Cliquez sur Extract Data et sélectionnez Properties dans la liste pour choisir les éléments qui seront suivis pour cette activité.
Sélectionnez Match Derived Types pour indiquer que ce trackpoint correspondra au type d'activité sélectionné et à tous les types dérivés.
Vous pouvez également ajouter des conditions pour filtrer le jeu de trackpoints émis.

Pour ajouter une condition de suivi

Cliquez sur Conditions sur le trackpoint d'activité sélectionné et sélectionnez Add new condition.
Dans la barre d'outils Conditions, sélectionnez le membre qui apparaîtra du côté gauche de la condition, par exemple Name.
Cliquez le bouton == pour basculer entre les modes égalité et inégalité (!=).
Entrez une valeur de chaîne pour le côté droit de la condition, par exemple codeActivity1.
Cliquez sur Save pour ajouter la condition terminée.

Pour ouvrir des profils de suivi

Dans le menu File, cliquez sur Open, puis sur Profile From File.
Sélectionnez le fichier de profil de suivi à utiliser, puis cliquez sur Open.

Remarque :
Un workflow doit être chargé préalablement à l'ouverture d'un profil de suivi. En outre, seuls les profils générés avec cet outil sont assurés de se charger correctement.

Pour enregistrer des profils de suivi

Dans le menu File, cliquez sur Save, puis sur Profile as File.
Entrez un chemin d'accès et un nom du fichier présentant l'extension .xml.
Cliquez sur Save pour enregistrer le profil de suivi.

Utilisation de la base de données de suivi SQL

Si vous avez configuré une base de données de suivi SQL, vous pouvez également enregistrer vos profils dans la base de données. Si vous n'avez pas encore créé la base de données de suivi, reportez-vous aux instructions de configuration de la base de données dans Simple Tracking, exemple.

Pour utiliser l'application avec la base de données de suivi SQL

Mettez à jour le fichier .config de l'application avec un ConnectionString valide dans la base de données de profils.

Le fichier de configuration par défaut ressemble à ce qui suit :

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
        <add key="ConnectionString" value="Persist Security Info=False;Integrated Security=SSPI;database=TrackingStore;server=localhost"/>
    </appSettings>
</configuration>

Dans le menu File, cliquez sur Save, puis sur Profile to SQL Tracking Database pour enregistrer le profil actuel dans la base de données de suivi.

Si la version dans la base de données est ultérieure au profil actuel, une boîte de dialogue apparaît et demande une version ultérieure avant l'enregistrement du profil.
Dans le menu File, cliquez sur Open, puis sur From SQL Tracking Database pour charger un profil à partir de la base de données de suivi.

Une boîte de dialogue apparaît pour vous permettre de sélectionner un type de workflow et une version de profil. Si les assemblys de workflow ne sont pas dans le même chemin d'accès que le concepteur, une autre boîte de dialogue apparaît et demande l'emplacement des assemblys requis.

Notes

Comme il s'agit d'une application d'exemple, il existe certaines limitations concernant son utilisation.
Seuls les profils de suivi créés par le concepteur de profil sont assurés de se charger correctement. La raison est que le concepteur suppose qu'un emplacement de suivi d'activité unique existe pour un trackpoint particulier.
Les profils de suivi sont enregistrés par type de workflow. Pour enregistrer un profil en tant que profil de suivi par défaut, vous pouvez appeler la procédure stockée UpdateDefaultTrackingProfile.
Les annotations apparaissent seulement pour les activités composites les plus à l'extérieur.
Vous ne pouvez pas ajouter UserTrackPoints via le concepteur.

Voir aussi

Autres ressources

Creating and Using Tracking Profiles
Windows Workflow Tracking Services
Creating Custom Tracking Services
File Tracking Service and Query, exemple
Task 4 : Using the Windows Workflow Tracking Service
Exemples d'applications

Footer image

Partager via