Aide incorporée en préparation
Avant de rédiger une aide incorporée personnalisée, planifiez le contenu et notez les informations utilisées dans le formulaire Aide incorporée. Une planification minutieuse garantit que la rubrique s’affiche pour la bonne page et le bon rôle.
Chaque page de l’interface utilisateur peut afficher de l’aide incorporée, spécifiée dans le champ Page comme illustré dans l’exemple suivant.
Lors de la planification des rubriques d’aide incorporées, réfléchissez à la façon dont les champs suivants sont utilisés et notez les valeurs dont vous avez besoin pour vos rubriques personnalisées.
- Page
- Identifiez et notez le nom de la page de l’interface utilisateur qui se trouve dans l’URL lorsque la page s’affiche comme indiqué. Si le nom de la page commence par un symbole du dollar, tel que $mid_server_user, incluez le signe du dollar dans le nom de la page. Avant d’écrire une rubrique d’aide incorporée pour la page, recherchez le nom de la page pour localiser un fichier que vous pouvez copier.
- Modificateur
- Un contenu normal s’affiche pour tout utilisateur disposant du rôle approprié qui accède à la page.
- Le contenu de la configuration s’affiche lorsque la page est accessible à partir d’un lien dans Configuration guidée.
De nombreuses rubriques d’aide incorporées dans le système de base concernent la configuration guidée. Vous pouvez copier le contenu de configuration et changer le modificateur en normal pour fournir rapidement de l’aide à tous les utilisateurs.
- Qualificateur
- Identifiez les pages pour lesquelles vous souhaitez obtenir une aide personnalisée et qui sont utilisées dans de nombreuses applications. Par exemple, la page home.do s’ouvre pour chaque module de la page d’accueil et pour de nombreux modules de tableau de bord. L’administrateur de l’aide incorporée peut utiliser des qualificateurs pour personnaliser le contenu d’une page commune de l’instance.
- Rôle
- Spécifiez le rôle de niveau le plus bas pour fournir l’accès à cette rubrique d’aide incorporée. Tous les rôles qui contiennent le rôle voient également le contenu, sauf si une autre rubrique ciblée sur leur rôle existe pour la même page.
Par exemple, si vous ajoutez du contenu d’aide incorporée pour le rôle itil qui décrit votre processus de gestion pour la saisie des incidents, le rôle itil_admin voit également le contenu. Si vous écrivez une rubrique différente avec le rôle itil_admin, le itil_admin voit ce contenu au lieu du contenu itil.
- Produit
- Écrivez du contenu uniquement pour la rubrique Entreprise . Vous pouvez copier une rubrique Express et changer ce champ en Entreprise si nécessaire.
- Version
- Le contenu du système de base est généralement spécifié pour la version actuelle du logiciel. Si vous modifiez le contenu d’une application personnalisée ou pour fournir des informations pertinentes pour le processus business de votre organisation, sélectionnez Tout.
- Domaine
- Si votre organisation utilise Séparation de domaine et personnalise le contenu de l’aide, indiquez le domaine auquel le contenu s’applique.
- ServiceNow Aide
- Si la case est cochée, ce champ indique une rubrique du système de base. Vous ne pouvez pas modifier une rubrique du système de base, mais vous pouvez en créer une copie pour ajouter du contenu personnalisé.
- Contenu
- Vous pouvez utiliser les outils de formatage pour formater le contenu. La liste suivante décrit les limitations.
- Vous ne pouvez pas inclure d’images dans le contenu d’aide incorporé.
- Pour intégrer une vidéo, vous devez coder les informations vidéo dans le code source <<>> vue. Le contenu vidéo de YouTube et Vimeo est pris en charge.
- Pour ajouter un lien d’informations connexes, vous devez utiliser une URL complète et non une URL relative.
- La meilleure pratique consiste à ne pas utiliser l’outil de surlignage du texte, car la couleur peut rendre le texte illisible en fonction du thème sélectionné par l’utilisateur.
- Les modifications que vous apportez à l’aide incorporée ne sont pas automatiquement déployées vers une autre instance.
- Les changements apportés à la table d’aide incorporée ne sont pas capturés dans les ensembles de mises à jour, update_sync=false est défini intentionnellement.