Exporter (0) Imprimer
Développer tout

Introduction à Smart Tag Explorer et à Smart Tag Recognize Tester

Microsoft Corporation

Septembre 2004

S'applique à :
   Éditions Microsoft Office 2003

Résumé  :   Découvrez deux utilitaires de balises actives importants. Smart Tag Explorer fournit au développeur une interface visuelle permettant de parcourir les informations liées aux balises actives sur sa station de travail et des plates-formes ciblées au sein de son entreprise. Recognize Tester permet de tester la méthode Recognize d'un module de reconnaissance de balise active hors d'une application hôte. (4 pages imprimées)

Sommaire

Introduction
Smart Tag Explorer
Prise en charge d'Information Bridge Framework
Recognize Tester

Introduction

Smart Tag Explorer et Smart Tag Recognize Tester sont des utilitaires conçus pour faciliter la création rapide de balises actives à la fois efficaces, stables et fiables pour différentes applications. Ces utilitaires et la documentation correspondante ne fournissent pas d'informations sur les balises actives ni n'expliquent comment écrire ces dernières. Pour cela, téléchargez le SDK Office 2003 : Smart Tag Software Development Kit  Site en anglais.

À mesure que les développeurs connaissent mieux l'API de balises actives et son architecture, telle que documentée dans le SDK Microsoft Office Smart Tag, ils prennent conscience de la nécessité d'un équilibre subtil dans le mode d'interfonctionnement entre la DLL de balise active personnalisée, l'application hôte et les données et actions associées. Pour le développeur, il en résulte généralement des questions et des défis à relever, à savoir :

  • Quelles balises actives sont installées sur un système et quels sont leurs paramètres ?
  • Comment gérer les différents paramètres au niveau de chaque balise et pour chaque application hôte (Microsoft Office Word 2003, Microsoft Office Excel 2003, Microsoft Office Outlook 2003 et Microsoft Internet Explorer) ?
  • Existe-t-il un moyen de tester les balises actives et d'éliminer la tâche complexe consistant à lancer et à arrêter continuellement l'application hôte ?

Pour répondre à ces questions, les utilitaires suivants permettent au développeur d'examiner les aides sur les balises actives installées :

  • Smart Tag Explorer (STExplorer.exe) fournit au développeur un instantané de la configuration des balises actives sur son système.
  • Smart Tag Recognize Tester (RecognizeTester.exe) permet de tester les méthodes Recognize et Recognize2 d'un module de reconnaissance hors d'une application hôte. Cela peut simplifier le test du code du module de reconnaissance.

Le code source de ces outils et les mises à jour sont disponibles dans un espace de travail sur GotDotNet.com  Site en anglais. Les contributions de la communauté sont vivement encouragées.

Smart Tag Explorer

Smart Tag Explorer fournit une interface visuelle vous permettant de parcourir les informations liées aux balises actives sur votre station de développement et des plates-formes ciblées au sein de votre entreprise.

Vous pouvez utiliser ces informations durant le développement de balises actives pour vérifier que celles-ci fournissent des informations exactes à l'application hôte. Vous pouvez aussi examiner les balises actives incluses dans les éditions Microsoft Office 2003 pour savoir comment elles fonctionnent, en fournissant un exemple de conception de vos propres balises.

L'outil indique les détails internes suivants concernant les balises actives :

  • Paramètres détaillés pour chaque DLL de module de reconnaissance et d'action installée. Ces informations comprennent la liste des DLL installées ainsi que le nom, la description, le ProgID, le nombre et le type des balises actives, les paramètres de registre, etc., de chaque balise active.
  • Paramètres partagés par toutes les applications hôtes, à savoir l'emplacement de recherche des nouveaux modules de reconnaissance de balises actives, les actions de balises actives et la couleur de soulignement de ces dernières.
  • Paramètres de chaque application hôte dans Word et Excel. Par exemple, si la reconnaissance est activée, l'utilisateur visualise les actions et d'autres détails.

La plupart des paramètres affichés par Smart Tag Explorer sont extraits des bibliothèques (COM et gérées) de balises actives. Il s'agit donc principalement d'informations en lecture seule. Lorsque cela est possible, vous pouvez changer dans Smart Tag Explorer les paramètres modifiables à la volée.

Prise en charge d'Information Bridge Framework

Smart Tag Explorer examine vos bibliothèques de balises actives pour déterminer si elles référencent Information Bridge Framework. S'il trouve une référence, l'outil place dans la fenêtre des détails l'observation suivante : « This assembly references the Information Bridge Framework ». Cette observation ne s'applique qu'aux bibliothèques gérées au niveau de l'assembly et s'affiche à la fois pour les modules de reconnaissance et les actions. Comme elle recherche la référence dans l'assembly, elle n'apparaît pas si Information Bridge FrameWork est utilisé via Reflection.

Smart Tag Explorer : procédure pas à pas

Figure 1. Smart Tag Explorer

Figure 1. Smart Tag Explorer

Les éléments numérotés suivants décrivent les zones de la page Global Smart Tag Settings :

  • Zone 1. Smart Tag Explorer affiche le nom de tous les modules de reconnaissance ou de toutes les actions dans cette fenêtre. Pour actualiser la liste, cliquez sur Refresh (F5) dans le menu File. Le point d'exclamation rouge indique une erreur de chargement de la bibliothèque, M une bibliothèque créée à l'aide de code géré et C une bibliothèque COM.
  • Zone 2. La fenêtre Item Details affiche les propriétés statiques de cette bibliothèque et les observations faites durant le chargement.
  • Zone 3. Vous pouvez définir des paramètres du registre (manuellement ou à l'aide de différentes applications Office) qui activent une bibliothèque donnée pour toutes les applications utilisables. Cette zone de l'explorateur affiche les applications pour lesquelles la balise sélectionnée (module de reconnaissance ou action) est activée. Lorsque vous cliquez sur l'écran, une boîte de dialogue permettant de modifier ces valeurs s'affiche.
  • Zone 4. La fenêtre Smart Tag Types affiche les actions configurées pour un module de reconnaissance donné ou les options de menu (et d'autres détails associés) lorsque l'entrée de bibliothèque sélectionnée est une action.
  • Zone 5. La barre d'état de l'application affiche le nom de celle-ci et le LocaleID que l'explorateur va simuler lors de l'interrogation d'une bibliothèque pour trouver des propriétés. Pour changer ces éléments, dans le menu Tools, cliquez sur Options.
Remarque   Smart Tag Explorer utilise les mêmes chemins d'accès au registre que Microsoft Office pour atteindre une liste de DLL de module de reconnaissance et d'action installées :
HKEY_CURRENT_USER\Software\Microsoft\Office\Common\Smart Tag\Recognizers
HKEY_CURRENT_USER\Software\Microsoft\Office\Common\Smart Tag\Actions

Paramètres généraux des balises actives

Le fonctionnement des balises actives dépend de plusieurs paramètres individuels et partagés de l'application hôte. La boîte de dialogue Global Smart Tag Settings permet au développeur de revoir et de modifier ces paramètres. Pour accéder à cette boîte de dialogue dans Smart Tag Explorer, dans le menu Tools, cliquez sur Global Smart Tag Settings.

La section Global Settings affiche les paramètres partagés par toutes les balises actives. La zone Check for new smart tags at est une URL ou un chemin UNC utilisé par Office lorsque l'utilisateur sélectionne le bouton Balises actives supplémentaires dans l'onglet Balise active de la boîte de dialogue Correction automatique de Word ou d'Excel. Ce paramètre par défaut ouvre Internet Explorer sur la page Balises actives disponibles de Microsoft Office Online afin que les utilisateurs puissent accéder à d'autres téléchargements de balises actives. Le paramètre Check for new smart tag actions at contrôle la page Web présentée à l'utilisateur lors de l'appel de l'option de menu Vérification des nouvelles actions dans un ensemble d'actions de balises actives. Vous pouvez remplacer ces paramètres par défaut et rediriger les utilisateurs vers un site Web d'entreprise.

Les deux dernières sections affichent l'état actuel des différents paramètres de balise spécifiques de l'hôte pour Word et Excel. Vous pouvez changer tous ces paramètres à partir de Word ou d'Excel, mais ils sont fournis ici ensemble pour des raisons pratiques.

Recognize Tester

Le chargement et le déchargement répétés d'une application hôte durant le processus de développement de balises actives peuvent prendre du temps. Recognize Tester supprime cette contrainte car il permet de tester les méthodes Recognize et Recognize2 en cours de développement sans devoir charger une application hôte. Cela peut simplifier le développement de balises actives et réduire les délais nécessaires.

Recognize Tester : procédure pas à pas

Commencez par lancer Recognize Tester. En nous reportant à la figure suivante, nous allons étudier le processus de test de la méthode Recognize d'un module de reconnaissance au moyen de cet outil.

Une fois l'application lancée, sachez que vous pouvez exécuter tous les tests à partir de son formulaire principal. L'utilisateur peut également redimensionner les différents volets selon les besoins.

Figure 2. Smart Tag Recognize Tester

Figure 2. Smart Tag Recognize Tester

Vous trouverez ci-dessous la description des principales zones de Smart Tag Recognize Tester :

  • Zone 1 : cette zone de la fenêtre répertorie les bibliothèques de modules de reconnaissance installées sur le système. Vous pouvez sélectionner celles que vous voulez tester en cochant la case située à gauche de chaque élément. Vous noterez que les modules de reconnaissance suivants, disponibles dans les éditions Office 2003, ne figurent pas dans la liste : noms de personne, dates, adresses, lieux et numéros de téléphone. Recognize Tester est conçu pour tester des modules de reconnaissance personnalisés développés au sein de l'entreprise. Par conséquent, il effectue une itération dans le registre pour trouver des DLL de balise active personnalisées qu'il rend ensuite disponibles pour le test. Les balises actives intégrées à Office ne sont pas des DLL distinctes. Il n'est donc pas possible de les tester au moyen de cet outil. Les balises MOSTL ne sont pas incluses dans les options de l'outil de test.
  • Zone 2 : type de texte intégral à tester dans cette zone de texte.
  • Zone 3 : la méthode Recognize d'un module de reconnaissance accepte un IF_TYPE. Le IF_TYPE indique le type de données textuelles transmises au module de reconnaissance. Word utilise IF_TYPE_PARA et Excel IF_TYPE_CELL. Sélectionnez le IF_TYPE à employer pour le test du module de reconnaissance.
  • Zone 4 : pour tester l'ensemble du texte, il suffit de cliquer sur le bouton Recognize (Ctrl+R). Les résultats s'affichent alors dans la zone 4.

Durant le test, vous pouvez changer tous les paramètres. Par conséquent, le développeur de balises actives peut travailler en mode interactif avec différents modules de reconnaissance et échantillonner le texte à reconnaître. Comme Recognize Tester charge dynamiquement les DLL de module de reconnaissance lorsque vous cliquez sur Scan Text, il est inutile de le lancer et de l'arrêter comme cela est nécessaire lorsque vous travaillez avec Word ou Excel.



Dernière mise à jour le mardi 9 novembre 2004



Afficher:
© 2014 Microsoft