Ajout de liens à la page d'accueil du Web Client – Base de connaissances d’InterAction® Administrator

Un des types de personnalisations les plus courants pour la page d'accueil du Web Client est l'ajout de liens supplémentaires vers d'autres parties du système et d'autres sites. Par exemple, vous pourriez vouloir faire ce qui suit :

Ajouter des liens vers d'autres formulaires de recherche importants et moteurs de recherche externes à l'ensemble de liens sous "Rechercher".
Ajouter des liens vers certaines listes spécifiques de contacts importants, comme les principaux clients et prospects.
Ajouter des liens de "recherche rapide" vers des sous-ensembles des listes de contacts de l'organisation, comme le personnel d'un bureau particulier.
Ajouter des liens vers plus de sujets d'aide ou vers des procédures de processus sur votre intranet.

Page d'Accueil Personnalisée avec de Nouveaux Liens

[A] Lien personnalisé ajouté au module Rechercher... Ce lien ouvre le formulaire de recherche Clients.

[B] Ce sont de nouveaux modules ajoutés à la page pour fournir plus de liens personnalisés.

La page d'accueil par défaut comprend plusieurs listes standard de liens (Rechercher, Ajouter un nouveau, Centre de messages, etc.) et une liste supplémentaire qui est incluse si votre organisation a souscrit à l'un des Modules Associés.

Chacune de ces listes est placée sur la page en utilisant le module formatSearchList.jsp, qui peut afficher un ensemble de liens définis dans une déclaration de liste de recherche distincte. Par conséquent, la façon dont vous modifiez les liens sur la page dépend exactement de ce que vous souhaitez changer :

Si vous souhaitez simplement ajouter de nouveaux liens à l'une des listes par défaut, vous modifiez la déclaration de liste de recherche correspondante.

Dans la figure ci-dessus, c'est ainsi que le nouvel élément pour les Clients a été ajouté à la liste "Rechercher".
Si vous souhaitez ajouter un bloc entier de nouveaux liens, vous devez modifier la déclaration de la page pour ajouter une nouvelle instance du module formatSearchList.jsp, puis ajouter également une nouvelle déclaration de liste de recherche pour définir les liens.

Dans l'exemple ci-dessus, le module Autres Ressources est une toute nouvelle instance du module formatSearchList.jsp qui a été ajoutée à la page.

Pour en savoir plus sur l'ajout de nouveaux modules à la page d'accueil, voir Modifier la Mise en Page et les Modules sur la Page d'Accueil.

Le tableau suivant décrit les déclarations de listes de recherche par défaut utilisées sur la page d'accueil :

Section de la Page	Liens	Déclaration de Liste de Recherche
Rechercher...	Personnes Entreprises Activités Questions, Opportunités ou Engagements (si souscrit) Ces liens ouvrent les formulaires de recherche correspondants sur la page de recherche de contacts.	home-search
Ajouter un nouveau...	Contact (ouvre l'assistant de nouveau contact) Activité Rappel Questions, Opportunités ou Engagements (si souscrit) Modifier cette liste de recherche n'est pas recommandé.	home-add
Centre de Messages	Liens dynamiques selon l'état des contacts de l'utilisateur. Modifier cette liste de recherche n'est pas recommandé.	home-message
Modules Associés	Affiche un lien vers les recherches de qualité des données pour les Modules Associés (InterAction Opportunités, InterAction Engagements, et InterAction Questions). Le lien n'apparaît que si votre organisation a souscrit à l'un des modules et que vous êtes connecté en tant qu'utilisateur ayant la permission d'utiliser les recherches.	home-related-modules
Voir...	Liens pour voir les rappels (si activé). Modifier cette liste de recherche n'est pas recommandé.	home-view
Référence Rapide	Ajouter un téléphone et une adresse à un contact Imprimer un rapport pour un contact Utiliser la Carte des Relations Garder mes contacts à jour Personnaliser mes paramètres InterAction En savoir plus sur InterAction Ces liens ouvrent des sujets dans le système d'aide du Web Client InterAction.	home-how

Ces déclarations de listes de recherche sont stockées dans le fichier de configuration searchLists.xml, qui est installé dans le répertoire etc de la machine du serveur d'applications.

Avant de modifier l'une de ces déclarations, vous devriez la copier dans le fichier localSearchLists.xml dans le répertoire local de la machine du serveur d'applications. Dans une installation typique, le répertoire local est C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc\local.

Une liste complète des balises XML pouvant être utilisées dans une déclaration de liste de recherche est disponible dans Référence XML de Déclaration de Liste de Recherche. Les sections suivantes mettent en évidence comment les balises sont utilisées dans les déclarations de listes de recherche par défaut de la page d'accueil :

Balises qui Commencent une Liste de Recherche
Définir les Éléments de Liste de Recherche (Titres et Liens) pour la Page d'Accueil
Exemples d'URLs pour les Liens de la Page d'Accueil
Lier aux Sujets d'Aide du Web Client
Faire une Copie de la Liste de Recherche par Défaut pour Modifier

Balises qui Commencent une Liste de Recherche

Toutes les déclarations de liste de recherche dans un fichier de configuration XML doivent être imbriquées dans la balise searchListDeclarations Tag. Après cette balise, chaque liste de recherche commence par la balise searchList Tag. Fournir une valeur pour l'attribut id nomme la liste afin qu'elle puisse être référencée à partir d'autres déclarations. Cela commence essentiellement une nouvelle liste. Après la première balise searchList Tag, les balises suivantes définissent les en-têtes et les liens. Voir Balise searchList (searchList Tag).

Par exemple, dans l'exemple de code suivant, la première instance de la balise searchList Tag a l'attribut id défini sur home-search. Par conséquent, elle commence une nouvelle liste de recherche avec cet ID. Les instances suivantes de la balise searchList Tag ne définissent pas l'attribut ID, elles définissent donc de nouveaux éléments dans la liste. La méthode de page pour la page d'accueil (home dans le fichier pages.xml) se réfère à l'ID home-search lors de l'insertion du module formatSearchList.jsp sur la page.

Commencer une liste de recherche et définir des éléments — Exemples XML

...

</searchList>

...

</searchList>

Définir les éléments de la liste de recherche (en-têtes et liens) pour la page d'accueil

Vous définissez les éléments de la liste de recherche avec la balise searchList Tag. Voir searchList Tag pour plus de détails.

La balise searchList Tag identifie les éléments suivants :

Le texte qui sera affiché sur la page. Vous le définissez avec la balise label Tag.
L'URL cible pour le lien. Vous le définissez avec la balise url Tag.

Par exemple, le code suivant pour la déclaration home-search crée le lien vers le formulaire de recherche de personnes :

Définir les éléments de la liste de recherche

<label>Personnes</label>

<url>$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&

usePersistence=false&proxyAccount=$(proxyAccount)</url>

</searchList>

Les étiquettes et les cibles pour les liens peuvent inclure des variables du serveur d'applications. Lorsque le Web Client affiche le texte, ces variables sont remplacées par leurs valeurs réelles. Étant donné que la page d'accueil n'a pas de contexte spécifique aux contacts, vous ne pouvez vraiment utiliser que les variables liées à l'environnement, telles que userName.

Vous pouvez utiliser des variables à la fois dans le nom de l'étiquette et dans la destination de l'URL. Pour plus de détails sur l'utilisation des variables, voir Utilisation des variables pour les informations InterAction.

Définir l'URL du lien

La cible d'un lien spécifiée avec la balise url Tag peut être l'adresse d'une autre page Web Client ou de toute autre page Web accessible avec une requête HTTP standard.

Lors de la liaison à une page Web Client, vous pouvez utiliser la variable PAGE_SERVER au lieu de saisir le nom complet de votre serveur d'applications. Vous pouvez également passer des paramètres à la page. Par exemple, l'URL suivante appelle la page advanced-searches et passe trois paramètres :

defaultItemId=item5001

usePersistence=false

proxyAccount=$(proxyAccount)

URL du lien

$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&usePersistence=false&proxyAccount=$(proxyAccount)

Les paramètres forcent la page de recherche de contacts à aller à la recherche de personnes. Pour plus de détails sur la détermination de l'URL d'une page Web Client, voir URLs des pages Web Client. Voir aussi Exemples d'URLs pour les liens de la page d'accueil.

Exemples d'URLs pour les liens de la page d'accueil

La plupart des liens que vous ajoutez à la page d'accueil entrent dans l'une des cinq catégories.

Sites non-InterAction

Vous pouvez lier à n'importe quel site Internet ou intranet interne. Consultez le site que vous souhaitez lier pour le format de l'URL.

Formulaires de recherche Web Client

Utilisez le même format fourni pour les liens prêts à l'emploi dans le module Rechercher, mais remplacez l'ID par l'ID du formulaire que vous souhaitez ouvrir :

$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&

usePersistence=false&proxyAccount=$(proxyAccount)

Par exemple, changez item5001 en item10013 pour que le lien ouvre le formulaire de recherche des principaux clients. Vous pouvez voir l'ID d'un formulaire de recherche dans le Windows Client dans la boîte de dialogue Gérer les formulaires de recherche Web Client. Notez qu'un lien ne peut ouvrir que des formulaires de recherche qui apparaissent dans la navigation principale.

Listes de types de contacts

Chaque type de contact dans votre environnement est disponible depuis la page Liste des types de contacts. Cependant, il peut être utile de mettre des raccourcis vers des listes particulièrement importantes directement sur la page d'accueil. L'URL suivante affiche une liste de contacts assignés au type de contact avec l'ID de 10 (le type de contact par défaut des principaux clients).

$(PAGE_SERVER)/InterAction/contact-search-results?isProfile=true&

searchDescription=Top Clients&profileId=10005&contactTypeId=10

Notez que la portion profileId=8 identifie un profil (le profil Client) qui sera utilisé pour le volet de résumé. Vous pouvez obtenir l'ID d'un profil dans le Windows Client dans la boîte de dialogue Gérer les profils Web Client.

Listes Marketing

La liaison aux pages de listes marketing est similaire à la liaison aux types de contacts. L'URL suivante affiche une liste de contacts dans la liste Carte de vœux. Notez que vous devez fournir l'ID du dossier.

$(PAGE_SERVER)/mailing-list-membership?searchDescription=Holiday+Card&

folderId=2/-10017&proxyAccount=

Sous-ensembles de listes

Les formulaires de recherche permettent aux utilisateurs de trouver un sous-ensemble de contacts dans une liste, comme uniquement les clients qui répondent à certains critères. Certaines de ces listes de sous-ensembles peuvent être suffisamment importantes pour être incluses en tant que lien sur la page d'accueil. Cela évite aux utilisateurs de devoir entrer les critères pour trouver les contacts. Par exemple, vous pourriez vouloir un lien qui affiche la liste des employés dans un bureau particulier.

La façon la plus simple de déterminer ce type d'URL est d'effectuer la recherche dans le Web Client, puis de copier l'URL résultante depuis le navigateur et de la modifier si nécessaire. Pour un exemple, voir Raccourci pour déterminer l'URL d'une page Web Client.

Sujets d'aide du Web Client

Si certains sujets d'aide du Web Client seraient utiles aux professionnels de votre organisation, vous pouvez ajouter des liens vers eux sur la page d'accueil. Pour plus de détails sur la détermination de l'URL d'un sujet, voir Lien vers les sujets d'aide du Web Client.

Lien vers les sujets d'aide du Web Client

Le Web Client fournit un système d'aide en ligne pour répondre aux questions et tâches courantes. La page d'accueil inclut une série de liens vers des sujets spécifiques au sein du système d'aide.

Vous pouvez ajouter des liens vers des sujets supplémentaires. Spécifiez l'URL suivante pour le tag url Tag (tout sur une seule ligne) :

Lien vers les sujets d'aide du Web Client

javascript:var remoteWin = IA_openWindow('$(HELP_URL)/TopicFilename.htm', '', 'height=550, width=700, location=no, menubar=no, resizable=yes, scrollbars=yes, status=no, titlebar=no, toolbar=no');

Remplacez TopicFilename.htm par le nom de fichier réel du sujet que vous souhaitez lier. Le reste du code dans l'URL est utilisé pour afficher le sujet dans une fenêtre pop-up. Assurez-vous de saisir l'URL exactement comme indiqué – le moyen le plus simple est de copier l'URL d'un des liens de sujet d'aide existants.

Utilisez les étapes suivantes pour déterminer le nom de fichier d'un sujet d'aide donné :

Ouvrez l'aide et naviguez jusqu'au sujet que vous souhaitez lier. Vous pouvez utiliser le lien Aide sur le cadre de la page Web Client pour ouvrir l'aide.
Lorsque le sujet souhaité apparaît dans le volet de droite de la fenêtre d'aide, cliquez avec le bouton droit dans le sujet et choisissez Propriétés.
Notez l'Adresse (URL) indiquée dans la boîte de dialogue des propriétés. Vous verrez quelque chose comme ce qui suit :

http://bailey/IA_HELP/ad1015791.htm
Le nom de fichier pour le sujet est la partie *.html. Dans l'exemple ci-dessus, le nom de fichier de ce sujet est ad1015791.htm. Notez qu'il peut y avoir un dièse (#) ou d'autres textes supplémentaires après le nom de fichier ; vous pouvez les ignorer.

Faire une copie de la liste de recherche par défaut pour la modifier

Notez que vous n'avez besoin de suivre cette procédure qu'une seule fois, avant d'apporter toute modification à une liste de recherche particulière.

Sur votre machine serveur d'application InterAction, localisez le répertoire etc. Dans une installation typique, cela se trouve normalement à l'emplacement suivant :

C:\Program Files\LexisNexis\InterAction\AppServer\iahome\etc
Ouvrez le fichier searchLists.xml dans un éditeur XML.
Trouvez les lignes qui commencent la déclaration pour la liste de recherche que vous souhaitez modifier. Pour une liste des listes de recherche disponibles, voir Déclarations de recherche de la page d'accueil. Le nom de la liste de recherche apparaîtra comme suit :

<searchList id="home-search" template="searchList.xsl">
Copiez l'ensemble du bloc de code XML pour la liste de recherche. La déclaration se termine par le tag <\searchList>. Notez que la déclaration inclut plusieurs tags <searchList> imbriqués, alors assurez-vous de copier l'intégralité de la déclaration.
Ouvrez le fichier localSearchLists.xml et collez la déclaration de menu à un certain point après le tag d'ouverture searchListDeclarations Tag.
Mettez à jour cette version copiée de la déclaration de la liste de recherche avec vos modifications.

"Cet article d'aide a été traduit à l'aide de l'IA et peut contenir des inexactitudes. Si vous avez des doutes sur une information, veuillez vous référer à la version originale en anglais."