Configuration du Web Connector

Les paramètre de configuration du Web Connector Interact sont enregistrés dans un fichier appelé jsconnector.xml qui est stocké sur le système sur lequel le connecteur Web est déployé (tel que le serveur d'exécution Interact lui-même, ou un système distinct exécutant un serveur d'application Web). Vous pouvez éditer le fichier jsconnector.xml directement à l'aide d'un éditeur de texte ou l'éditeur XML ; toutefois, un moyen plus facile de configurer quasiment tous les paramètres de configuration disponibles consiste à utiliser la page de configuration de Web Connector à partir de votre navigateur Web.

Avant de pouvoir utiliser l'interface Web pour configurer Web Connector, vous devez installer et déployer l'application Web qui fournit Web Connector. Sur le serveur d'exécution Interact, une instance de Web Connector est installée automatiquement lorsque vous installez et déployez Interact. Sur n'importe quel autre serveur d'applications Web, vous devez installer et déployer l'application Web de Web Connector comme indiqué à la section Installation de Web Connector en tant qu'application Web distincte.

Lancez votre navigateur Web pris en charge et ouvrez une URL similaire à la suivante :

http://<host>:<port>/interact/jsp/WebConnector.jsp

Remplacez <host> par le serveur sur lequel Web Connector s'exécute, par exemple le nom d'hôte du serveur d'exécution ou le nom du serveur sur lequel vous avez déployé une autre instance de Web Connector.

Remplacez <port> par le numéro de port sur lequel l'application Web de Web Connector est à l'écoute de connexions, et qui correspond en général au port par défaut du serveur d'applications Web.

Sur la page Configurations qui s'affiche, renseignez les sections suivantes :

Récapitulatif des paramètres de configuration de Web Connector
Section	Paramètres
Paramètres de base	Utilisez la page Paramètres de base pour configurer le comportement global du Web Connector pour le site sur lequel vous allez déployer les pages marquées. Ces paramètres incluent l'adresse URL de base du site, les informations que Interact doit utiliser concernant les visiteurs sur le site, ainsi que les paramètres similaires qui s'appliquent à toutes les pages que vous prévoyez de référencer avec le code du Web Connector. Reportez-vous à Options de base de configuration de Web Connector pour plus de détails.
HTML Display Types	Utilisez la page HTML Display Type pour déterminer le code HTML qui sera fourni pour chaque point d'interaction sur la page. Vous pouvez choisir dans la liste des modèles par défaut (les fichiers .flt) qui contiennent une combinaison de code de feuille de style en cascade (CSS), de code HTML, et de code Javascript à utiliser pour chaque point d'interaction. Vous pouvez utiliser les modèles comme indiqué, les personnaliser selon vos besoins, ou créer les vôtres. Les paramètres de configuration de cette page correspondent à la section interactionPoints du fichier de configuration jsconnector.xml. Reportez-vous à Types d'affichage HTML de la configuration Web Connector pour plus de détails.
Enhanced Pages	Enhanced Pages permettent de mapper des paramètres spécifiques à une page avec un modèle d'URL. Par exemple, vous pouvez configurer une page de mappage, de façon à ce que toute adresse URL contenant le texte "index.htm" affiche votre page d'accueil générale, avec des événements spécifique de chargement de page et les points d'interaction définis pour ce mappage. Les paramètres de configuration de cette page correspondent à la section pageMapping du fichier de configuration jsconnector.xml. Reportez-vous à Enhanced Pages - Configuration de WebConnector pour plus de détails.

Sur la page Paramètres de base, vérifiez que les paramètres appliqués à tout le site sont valides pour votre installation. (Facultatif) Indiquez le mode de débogage (déconseillé sauf en cas de dépannage d'un problème). Indiquez également l'intégration de balise de page Digital Analytics for On Premises et les paramètres par défaut de la plupart des points d'interaction. Cliquez en suite sur le lien HTML Display Types sous Configurations.

Sur la page HTML Display Types, procédez comme suit pour ajouter ou modifier des modèles d'affichage qui définissent les points d'interaction sur la page Web du client.

Par défaut, les modèles d'affichage (fichiers .flt) sont stockés dans <jsconnector_home>/conf/html.

Sélectionnez le fichier .flt dans la liste que vous souhaitez examiner ou utiliser en tant que point de départ, ou cliquez sur Add a Type pour créer un nouveau modèle d'interaction vierge à utiliser.

Les informations sur le contenu du modèle, le cas échéant, s'affichent en face de la liste des modèles.

(Facultatif) Modifiez le nom du modèle dans la zone File name for this display type. Pour obtenir un nouveau modèle, mettez à jour CHANGE_ME.flt en lui attribuant un nom plus évocateur.

Si vous renommez le modèle ici, Web Connector crée un nouveau fichier portant ce nom lors de la prochaine sauvegarde du modèle. Les modèles sont sauvegardés lorsque vous modifiez le corps du texte, puis naviguez à une autre zone.

Modifier ou complétez les informations du fragment HTML si nécessaire, y compris les feuilles de style (CSS), le code JavaScript™ et le code HTML que vous souhaitez inclure. Vous pouvez également inclure des variables qui seront remplacées par les paramètres Interact lors de l'exécution. Par exemple, ${offer.HighlightTitle} est automatiquement remplacé par le titre de l'offre dans l'emplacement indiqué pour le point d'interaction.

Utilisez les exemples qui apparaissent sous la zone de fragment HTML pour plus d'indications sur le format de votre feuille de style en cascade (CSS) ou de vos blocs de code JavaScript™ ou HTML.

Utilisez la page Enhanced Pages améliorées si nécessaire pour configurer les mappages de page déterminant la manière dont des modèles d'URL spécifiques sont traités sur les pages.

Lorsque vous avez défini les propriétés de configuration, cliquez sur Roll Out the Changes.

Lorsque vous cliquez sur Roll Out the Changes, les actions suivantes sont exécutées :

Affiche la balise de page IBM® Interact de Web Connector, qui contient le code JavaScript™ que vous pouvez copier depuis la page Web Connector et insérer dans vos pages Web.

Sauvegarde le fichier de configuration du Web Connector existant sur le serveur Interact (le fichier jsconnector.xml sur le serveur sur lequel Web Connector est installé) et crée un nouveau fichier de configuration avec les paramètres que vous avez défini.

Les fichiers de configuration de sauvegarde sont stockés dans <jsconnector_home>/conf/archive/jsconnector.xml.<date>.<time>, comme dans jsconnector.xml.20111113.214933.750-0500 (où la chaîne de données est 20111113 et la chaîne d'heure, y compris l'indicateur de fuseau horaire, est 214933.750-0500)

Vous avez maintenant terminé de configurer Web Connector.

Pour modifier votre configuration, vous pouvez soit revenir au début de cette procédure et la réexécuter en utilisant de nouvelles valeurs, soit ouvrir le fichier de configuration (<Interact_home>/jsconnector/conf/jsconnector.xml) dans n'importe quel éditeur de texte ou éditeur XML et le modifier selon les besoins.

Options de base de configuration de Web Connector

Types d'affichage HTML de la configuration Web Connector

Enhanced Pages - Configuration de WebConnector

Options de configuration de Web Connector