DocumentaciónAide

Pages importées

Reconnaissez les pages qui proviennent du dépôt d'un produit, comprenez pourquoi elles ne se modifient pas dans Elion ITSM et consultez le rapport de chaque importation.

Sur cette page

Certains espaces ne sont pas rédigés dans Elion ITSM : leur contenu provient de la documentation d'un produit, stockée dans des fichiers de son dépôt. Chaque fois que cette documentation change, elle est importée dans l'espace. Ainsi, la documentation a une seule source et il n'existe jamais deux versions différentes du même texte.

Reconnaître une page importée

En ouvrant une page importée, vous verrez au-dessus du contenu le message Importée depuis suivi du chemin du fichier d'origine. Le message indique que la page se modifie dans le dépôt du produit et qu'elle est en lecture seule dans Elion ITSM.

Sur une page importée :

  • les boutons Modifier, Sous-page, Déplacer, Archiver et Supprimer n'apparaissent pas ;

  • si vous essayez d'ouvrir son éditeur, un message indique que la page est importée depuis son fichier d'origine et qu'elle est ici en lecture seule ;

  • vous pouvez en revanche la lire, consulter son Historique, utiliser Copier le lien et laisser des Commentaires si vous pouvez modifier dans l'espace. Marquer comme résolu n'apparaît pas sur ces pages.

Pourquoi ne pas la modifier ici ? Si quelqu'un corrigeait la page dans Elion ITSM, la prochaine importation rapporterait le texte du dépôt et la modification serait perdue. Pour corriger une page importée, prévenez l'équipe qui maintient la documentation du produit. Un commentaire sur la page est un bon moyen de laisser le message.

Ce que fait chaque importation

Chaque fichier du dépôt correspond à une page et se reconnaît toujours par son chemin. À chaque importation :

  • un nouveau fichier crée une page et la publie ;

  • un fichier modifié crée une nouvelle version de sa page et la publie, avec la note Importé dans l'historique ;

  • un fichier inchangé ne touche pas à sa page ;

  • un fichier supprimé archive sa page, sans la supprimer. Si le fichier revient, la page revient avec le même numéro.

Si un fichier est marqué comme brouillon dans le dépôt, sa page reste un brouillon au lieu d'être publiée.

Tout reste dans l'historique de chaque page, comme n'importe quelle autre publication (consultez Historique et versions).

Consulter le rapport des importations

Avant de commencer

  • Vous devez disposer de Administrer dans Connaissances (rôle Administrateur).

Étapes

  1. Entrez dans l'espace.

  2. Appuyez sur Importations. La fenêtre Importations de suivi du nom de l'espace s'ouvre.

  3. Consultez la liste. Chaque importation affiche :

    • la date et le temps écoulé ;

    • l'origine : Terminal, Zip importé ou GitHub Action ;

    • la version du dépôt importée, si elle a été indiquée ;

    • le résumé, par exemple « 3 créées · 1 mise à jour · 12 inchangées ». Il indique aussi les pages archivées. S'il n'y a eu aucune page, il affiche Aucune page.

  4. Si l'importation a produit des avertissements, appuyez sur avertissements (avec leur nombre) pour les voir. Chacun indique le fichier et ce qui s'est passé.

  5. Appuyez sur Fermer pour sortir.

Si l'espace n'a jamais reçu d'importation, vous verrez Cet espace n'a encore aucune importation.

Signification des avertissements

Les avertissements n'interrompent pas l'importation : ils signalent quelque chose qu'il convient de corriger dans le dépôt du produit. Les plus courants sont :

  • un élément du texte que la base de connaissances ne prend pas en charge et qui a été ignoré ;

  • une image manquante ou un lien cassé ;

  • un fichier ignoré parce qu'il n'est ni une page ni une image, ou parce qu'il est trop volumineux.

Consultez le rapport après chaque modification importante de la documentation. Corriger les avertissements dans le dépôt permet d'obtenir des pages complètes à l'importation suivante.

Voir aussi

Rechercher dans Elion ITSM

Saisissez au moins 2 caractères pour rechercher dans Elion ITSM.

↑↓ naviguer · Enter ouvrir · Esc fermer