Partager via

Accès au contrôle dans les pages web

  • Article

[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible dans les versions ultérieures de Windows.]

Pour accéder aux services de Microsoft Agent à partir d’une page web, utilisez la balise HTML <OBJECT> dans l’élément <HEAD> ou <BODY> de la page, en spécifiant le CLSID Microsoft (identificateur de classe) pour le contrôle. En outre, utilisez un paramètre CODEBASE pour spécifier l’emplacement du fichier d’installation de Microsoft Agent et son numéro de version.

Si Microsoft Internet Explorer (version 3.02 ou ultérieure) est installé sur le système, mais que Microsoft Agent n’est pas encore installé et que l’utilisateur accède à une page web qui a la <balise OBJECT> avec le CLSID de l’agent, le navigateur tente automatiquement de télécharger l’agent à partir du site web Microsoft. Ensuite, l’utilisateur est invité à procéder à l’installation. Pour les autres navigateurs, contactez le fournisseur pour plus d’informations sur son support ou la prise en charge tierce des contrôles ActiveX.

L’exemple suivant montre comment utiliser le paramètre CODEBASE pour télécharger automatiquement la version anglaise 2.0 de Microsoft Agent.

<OBJECT
classid="clsid: D45FD31B-5C6E-11D1-9EC1-00C04FD7081F"
CODEBASE = "#VERSION=2,0,0,0"
 id=Agent
>
</OBJECT>

L’agent peut également être installé à partir de votre propre serveur HTTP ou dans le cadre du processus d’installation d’une application. Pour prendre en charge l’installation à partir de votre propre serveur HTTP, vous devez publier le fichier d'.Exe de l’armoire d’installation automatique de Microsoft Agent et spécifier son URL dans la balise CODEBASE.

<OBJECT
classid="clsid: D45FD31B-5C6E-11D1-9EC1-00C04FD7081F"
CODEBASE = "https://your server/msagent.exe#VERSION=2,0,0,0"
 id=Agent
>
</OBJECT>

Pour prendre en charge le téléchargement automatique d’un composant de langue microsoft Agent à partir d’une page web, incluez la balise Object du composant de langage sur la page avant la balise Objet du contrôle Agent :

<OBJECT width=0 height=0
CLASSID="CLSID: C348XXXX-A7F8-11D1-AA75-00C04FA34D72"
CODEBASE = "#VERSION=2,0,0,0">
</OBJECT>

où XXXX est remplacé par un ID de langue. Pour les langues actuellement prises en charge, case activée le site web de Microsoft Agent.

  • La <OBJECT> balise d’un composant de langage doit précéder la <balise OBJECT> pour le composant principal de Microsoft Agent.
  • Plusieurs langues peuvent être installées sur le même client.
  • Avant de définir le LanguageID d’un caractère, nous vous recommandons de vérifier que les paramètres régionaux du navigateur, disponibles dans la propriété userLanguage , correspondent à la langue définie.

Pour prendre en charge d’autres versions linguistiques de l’Agent, vous utilisez une autre balise Object spécifiant le composant de langage. Toutefois, n’oubliez pas que la tentative d’installation de plusieurs langues en même temps peut nécessiter le redémarrage de l’utilisateur. Les composants du langage agent peuvent être obtenus à partir du site web de l’agent à l’aide de la même procédure que pour le composant principal de l’agent. Les licences de distribution pour les composants linguistiques sont couvertes dans la licence de distribution de l’Agent standard. Pour commencer à utiliser un caractère, vous devez charger le caractère à l’aide de la méthode Load . Un caractère peut être chargé à partir du stockage local de l’utilisateur ou d’un serveur HTTP. Pour plus d’informations sur la syntaxe de chargement d’un caractère, consultez la méthode Load . Une fois le caractère correctement chargé, vous pouvez utiliser les méthodes, les propriétés et les événements exposés par le contrôle Agent pour programmer le caractère. Vous pouvez également utiliser les méthodes, les propriétés et les événements exposés par votre langage de programmation et le navigateur pour programmer le caractère ; par exemple, pour programmer sa réaction à un clic de bouton. Consultez la documentation de votre navigateur pour déterminer les fonctionnalités qu’il expose dans son modèle de script. Pour microsoft Internet Explorer, consultez le modèle objet script, qui est disponible dans le Kit de développement logiciel (SDK) ActiveX.

Les services de l’agent restent chargés uniquement lorsqu’il existe au moins une application cliente avec une connexion. Cela signifie que lorsqu’un utilisateur passe d’une page web avec Agent, Agent s’arrête et tous les caractères que vous avez chargés disparaissent. Pour maintenir l’exécution de l’agent entre les pages (et ainsi garder un caractère visible), créez un autre client qui reste chargé entre les modifications de page. Par exemple, vous pouvez créer un jeu de cadres HTML et déclarer une <balise OBJECT> pour Agent dans le cadre parent. Vous pouvez ensuite créer un script pour les pages que vous chargez dans les images enfants afin d’appeler le script du parent. Vous pouvez également inclure une <balise OBJECT> sur chaque page que vous chargez dans le cadre enfant. Dans ce cas, n’oubliez pas que chaque page sera son propre client. Vous devrez peut-être utiliser la méthode Activate pour définir le client qui contrôle le moment où l’utilisateur interagit avec la page parent ou enfant.