Aide incorporée planification
Avant d’écrire une aide incorporée personnalisée, planifiez le contenu et notez les informations utilisées dans le formulaire d’aide incorporée. Une planification minutieuse garantit que la rubrique apparaît pour la bonne page et le bon rôle.
Chaque page de l’interface utilisateur peut afficher une 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ée, tenez compte de 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 dollar, tel que $mid_server_user, incluez le signe 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
- Le contenu normal s’affiche pour tout utilisateur ayant le rôle approprié qui navigue vers 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 sont destinées à la configuration guidée. Vous pouvez copier le contenu de la 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 d’aide incorporée peut utiliser des qualificatifs pour personnaliser le contenu d’une page commune de l’instance.
- Rôle
- Spécifiez le rôle du 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 s’il existe une autre rubrique ciblée pour leur rôle 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 business 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, l’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 modifier ce champ en Entreprise , le cas échéant.
- 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 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 mise en forme pour mettre en forme le contenu. La liste suivante décrit les limitations.
- Vous ne pouvez pas inclure d’images dans le contenu d’aide incorporée.
- 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.
- Il est recommandé de ne pas utiliser l’outil de surbrillance du texte, car la couleur peut rendre le texte illisible selon le thème sélectionné par l’utilisateur.
- Les modifications que vous apportez à l’aide incorporée ne sont pas automatiquement déployées dans 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.