Contrôle et revues
Fichiers Word et PDF en tant qu'Artifacts
Ajoutez des documents Word et des PDF à un projet en tant qu'Artifacts, examinez et commentez leurs pages, conservez chaque version et libérez de l'espace en retirant les fichiers des anciennes versions.
Sur cette page
- Concepts
- Mode d'emploi
- Quand et pourquoi
- Ajouter des fichiers Word ou PDF
- Téléverser une nouvelle version
- Examiner et commenter
- Commentaires sur les versions suivantes
- Commentaires et modifications suivies de Word
- Comparer deux versions
- Exemple : une revue de conception sur la démo CubeSat EO-1
- Conseils et bonnes pratiques
- Erreurs courantes
- Liens avec le reste
- La section Fichier
- Retirer les fichiers des anciennes versions
- Fichiers en cours d'ajout
- Sans conversion
- Messages
- Limites
- Voir aussi
Un document Word ou un PDF peut faire partie de votre projet en tant qu'Artifact. Les relecteurs le lisent dans Holarch, commentent ses pages et l'approuvent comme tout autre élément. Chaque nouveau téléversement du même document devient une nouvelle version, et les versions antérieures restent lisibles.
Sur le service hébergé, les fichiers Word sont convertis en PDF lorsque vous les ajoutez, et les PDF sont compressés. C'est le PDF que tout le monde lit, télécharge et commente.
Concepts
- Artifact fichier : un Artifact qui contient un fichier. Sa page comporte en haut une section Fichier avec la visionneuse, les versions et les outils de fichier.
- Version : un téléversement du document. Chaque version conserve son PDF, la personne qui l'a téléversée, la date et une note facultative. La version la plus récente est affichée par défaut.
- Conversion : la transformation d'un fichier Word en PDF et la compression des PDF. Un seul fichier est converti à la fois pour tout le monde ; les fichiers de comptes différents passent à tour de rôle, de sorte qu'un gros lot ne bloque pas les autres.
- Commentaire épinglé : un commentaire rattaché à un endroit d'une version : des mots sélectionnés, un point, un cadre ou une page entière (ou, dans la vue Word, un paragraphe). Discussion indique où il se trouve, par exemple « sur la version 2, page 3 ».
Mode d'emploi
Quand et pourquoi
Utilisez un Artifact fichier lorsqu'un livrable est rédigé hors de Holarch : un dossier de revue de conception, le document de contrôle d'interface d'un fournisseur, un rapport de test. Le conserver dans le projet le place à côté des exigences et des éléments qu'il couvre. Les relecteurs commentent à un seul endroit, et les références enregistrent la version qui a été approuvée.
Ajouter des fichiers Word ou PDF
- Ouvrez la Base de données d'un projet LML.
- Cliquez sur + Nouvel élément, puis sur Artifact à partir d’un fichier Word ou PDF… sous le champ Nom. Lorsque la base de données n'affiche que des Artifacts, le bouton est + Nouvel Artifact et le bouton de la boîte de dialogue indique À partir d’un fichier Word ou PDF…. La boîte de dialogue se ferme et le sélecteur de fichiers s'ouvre.
Le même bouton se trouve dans la boîte de dialogue Nouvel élément partout où elle s'ouvre, par exemple ⌘K / Ctrl+K → Nouvel élément…. Vous pouvez aussi faire glisser des fichiers .docx et .pdf sur le tableau de la base de données, ou appuyer sur ⌘K / Ctrl+K et lancer Artifact depuis un fichier… sur n'importe quelle page du projet.
- Choisissez un ou plusieurs fichiers.
Fichiers en cours d'ajout apparaît au-dessus du tableau, avec l'état de chaque fichier : « En attente (2 avant) », Conversion…, Compression… ou Stockage….
- Patientez, ou continuez à travailler. Vous pouvez fermer l'onglet.
Lorsqu'un fichier est prêt, Holarch vous l'indique : « Design Review.docx est prêt en tant qu'Artifact. » Si aucun onglet Holarch n'est ouvert de votre côté, le message arrive par e-mail.
Chaque fichier devient un Artifact, nommé d'après le fichier sans son extension. La notification indique la taille stockée, par exemple « Stocké en 2,1 Mo, compressé à partir de 15 Mo. »
Téléverser une nouvelle version
- Ouvrez l'Artifact.
- Dans la section Fichier, cliquez sur Téléverser une nouvelle version… et choisissez le fichier.
- Saisissez éventuellement une Note pour la nouvelle version, par exemple « Commentaires de la revue de conception traités », puis cliquez sur Téléverser comme nouvelle version.
« Nouvelle version Design Review.docx : conversion… » s'affiche sur la page jusqu'à ce qu'elle soit prête.
Lorsque vous ajoutez un fichier dont le nom correspond à un Artifact déjà créé à partir d'un fichier de ce nom, Fichier déjà dans le projet demande quoi faire :
- Téléverser comme nouvelle version (par défaut) : le fichier devient la version suivante de cet Artifact.
- Conserver les deux : un Artifact distinct, dont le nom reçoit « (2) ».
- Annuler : rien n'est ajouté.
Examiner et commenter
- Ouvrez l'Artifact. Pages affiche le PDF dans la visionneuse de documents : une barre d'outils, les pages et un panneau Commentaires à côté.
- Parcourez le document avec la barre d'outils : Page 3 sur 12 (saisissez un numéro de page et appuyez sur Enter), les boutons page précédente et page suivante, Miniatures, le zoom (Pleine largeur, Page entière ou une taille fixe) et Rechercher (⌘F / Ctrl+F). Touches : ← et → tournent les pages, Home et End vont à la première et à la dernière page, + et − zooment.
- Commentez de l'une de quatre façons :
- Sélectionner le texte : sélectionnez des mots sur la page (vous pouvez aussi les copier), puis cliquez sur Commenter la sélection. Les mots sont surlignés.
- Point : cliquez à l'endroit de la page auquel le commentaire se rapporte.
- Cadre : tracez un cadre autour d'une zone, par exemple une figure ou un tableau.
- Commenter la page : un commentaire sur la page affichée, dans son ensemble.
Saisissez le commentaire dans le panneau et cliquez sur Ajouter un commentaire (⌘Enter / Ctrl+Enter). Saisissez @ et un nom pour mentionner quelqu'un.
- Le panneau Commentaires liste les fils dans l'ordre des pages, numérotés comme leurs repères sur la page. Cliquez sur un fil pour aller à son emplacement ; cliquez sur un repère ou un surlignage pour ouvrir son fil. Répondre, Résoudre et Rouvrir fonctionnent comme dans Discussion ; Afficher les résolus affiche les fils résolus.
- Pour plus d'espace, cliquez sur Vue de révision (la version sur toute la fenêtre) ou Détacher (une fenêtre séparée, par exemple sur un second écran). Les deux restent à jour à mesure que les personnes commentent.
Chaque commentaire appartient à la version sur laquelle il a été fait, et Discussion l'affiche aussi, par exemple « sur la version 2, page 3 ». Commenter ne modifie jamais le fichier : un PDF signé conserve sa signature.
Commentaires sur les versions suivantes
Lorsqu'une nouvelle version est ajoutée, les fils ouverts y sont déplacés, de sorte qu'une revue se poursuit d'une version à l'autre :
- Holarch retrouve les mots de chaque fil dans la nouvelle version, même lorsqu'ils ont été déplacés sur une autre page ou que le texte autour a été remis en page. Le fil s'y affiche avec l'étiquette De la version 1 (la version sur laquelle il a été fait).
- Lorsque les mots ont été modifiés, le fil est aussi marqué Texte modifié depuis et affiche ce que disait la version précédente, par exemple « La version 1 disait : “reject 40 W” ».
- Lorsque les mots ont disparu, le fil est listé sous Versions antérieures à la fin du panneau Commentaires, avec ses mots cités et Afficher sur la version 1 (la dernière version qui les contient).
- Un Point ou un Cadre suit la ligne de texte la plus proche. Sur une page sans texte (un dessin ou une numérisation), il reste où il était lorsque la page est identique dans la nouvelle version ; sinon, il passe sous Versions antérieures.
- Les fils résolus restent sur les versions où ils se trouvaient. Rouvrez-en un pour qu'il passe aux versions plus récentes.
- Fait sur (au-dessus des fils, dès qu'il existe des fils de plus d'une version) affiche seulement les fils faits sur une version, ou tous.
- Les fils provenant de Word suivent les mêmes règles.
Cela se produit lorsque la nouvelle version est ajoutée. Les projets contenant des commentaires antérieurs à cette fonctionnalité reçoivent le même traitement la première fois qu'une version plus récente est affichée. Dans Discussion, un commentaire d'une version plus ancienne indique où il se trouve maintenant, par exemple « Sur la version 1, page 2, “radiator” · reporté à la version 3 » ou « · absent de la version 3 ».
Les commentaires conservent leurs mots cités, de sorte qu'ils restent lisibles après le retrait du fichier d'une ancienne version. Un commentaire modifié conserve son texte antérieur : Texte antérieur sous le commentaire liste chaque formulation antérieure avec son auteur et sa date.
Une référence enregistre la version du fichier et ses fils de commentaires tels qu'ils étaient alors. Cliquez sur le nom de la référence sous Dans les références pour les voir.
Commentaires et modifications suivies de Word
Sur le service hébergé, les marques de revue propres à un fichier Word sont reprises lorsque vous l'ajoutez :
- Ses commentaires deviennent des fils de commentaires sur le PDF, sur les mots auxquels ils se rapportaient, avec leurs réponses. Chacun conserve l'auteur et la date de Word et est marqué De Word. Un commentaire que Word a marqué comme terminé arrive résolu.
- Ses modifications suivies sont listées comme suggestions : « Insertion suggérée : … » ou « Suppression suggérée : … », par la personne qui les a faites.
- Le PDF affiche les commentaires dans la marge et les modifications suivies en marques de révision.
La notification après le téléversement indique ce qui a été repris, par exemple « 3 commentaires et 2 modifications suivies ont été repris de Word. » Vous êtes propriétaire des fils importés, vous pouvez donc les résoudre ou les supprimer. Les personnes qui suivent l'élément ne sont pas notifiées pour chaque commentaire importé.
Comparer deux versions
- Ouvrez l'Artifact. Dans la section Fichier, cliquez sur Comparer les versions… (affiché lorsque l'Artifact a au moins deux versions).
- Choisissez la version Plus ancienne et la version Plus récente. Par défaut, la version affichée est comparée à celle qui la précède.
Les deux versions apparaissent côte à côte, page par page :
- Les mots Inséré sont en vert sur la version plus récente.
- Les mots Supprimé sont en rouge sur la version plus ancienne.
- Les phrases et paragraphes Déplacé sont en violet aux deux endroits. Un bloc déplacé qui a aussi été modifié affiche aussi ses modifications de mots. La liste des modifications nomme les deux pages, par exemple « Page 2 → page 5 ».
- Les pages sans texte (dessins, numérisations) sont comparées comme des images. Une page modifiée est entourée ; sur la page plus récente, Différences affiche en rouge ce qui n'est encré que dans la version plus ancienne et en vert ce qui ne l'est que dans la plus récente.
- Sélectionnez une modification dans la liste, ou cliquez sur Précédent et Suivant (F7 et Shift+F7), pour l'afficher des deux côtés. Défilement synchronisé garde le même texte côte à côte pendant le défilement.
Le texte est comparé sur l'ensemble du document, de sorte qu'un texte déplacé sur une autre page, ou remis en page sur d'autres lignes, est toujours mis en correspondance. Un fichier Word conservé sans conversion est comparé comme texte, sans pages. Les longs documents affichent une barre de progression pendant leur lecture.
La même comparaison marque les modifications de texte ailleurs : la revue des demandes de modification, l'historique des éléments, les modifications de documents et les différences de bibliothèque affichent les phrases déplacées comme déplacées, avec un lien Déplacé vers / Déplacé depuis entre les deux endroits.
Exemple : une revue de conception sur la démo CubeSat EO-1
- Dans la démo CubeSat EO-1, ouvrez la base de données, cliquez sur + Nouvel élément et ajoutez « EO-1 CDR Package.docx » avec Artifact à partir d’un fichier Word ou PDF….
- Lorsqu'il est prêt, ouvrez EO-1 CDR Package et reliez-le aux exigences qu'il couvre.
- Les relecteurs l'ouvrent et utilisent Commenter la page… pour la page 12 : « Thermal margin table is missing the eclipse case. »
- Après les corrections, téléversez de nouveau « EO-1 CDR Package.docx » et choisissez Téléverser comme nouvelle version, avec la note « CDR comments addressed ».
- Créez une référence. La page de l'Artifact affiche Dans les références avec le nom de la référence pour la version 2.
Conseils et bonnes pratiques
- Téléversez chaque nouvelle version sous le même nom de fichier. Un seul Artifact contient alors tout l'historique.
- Téléversez un PDF plutôt qu'un fichier Word lorsque la mise en page doit correspondre exactement à Word : la conversion peut déplacer des sauts de ligne.
- Les PDF signés, les formulaires PDF, les fichiers PDF/A et les PDF chiffrés sont conservés exactement tels que téléversés. Les compresser casserait la signature, le formulaire ou la conformité.
Erreurs courantes
- Un second Artifact est apparu : vous avez choisi Conserver les deux. Supprimez-le, puis téléversez de nouveau le fichier et choisissez Téléverser comme nouvelle version.
- Un fichier Word de plus de 100 Mo a été refusé : dans Word, choisissez Fichier → Enregistrer sous → PDF, puis téléversez le PDF.
Liens avec le reste
- Commentaires et revues : les commentaires épinglés sont des commentaires ordinaires ; les réponses, les mentions et les approbations fonctionnent comme pour tout élément. Voir Commentaires et revues.
- Références : une référence enregistre la version de chaque Artifact fichier. Voir Demandes de modification.
- Stockage : le PDF de chaque version compte dans le stockage du projet et dans le vôtre. Voir Pièces jointes, stockage et limites.
La section Fichier
| Commande | Ce qu'il fait |
|---|---|
| Version | Affiche une version : « Version 3 (la plus récente) · date · auteur du téléversement ». Les versions dont le fichier a été retiré indiquent « fichier retiré ». |
| Télécharger (PDF) | Enregistre le PDF de la version affichée. Un fichier Word affiché sans conversion propose Télécharger (.docx). |
| Restaurer comme la plus récente | Fait de la version affichée de nouveau la plus récente, sous forme de nouvelle version. Rien n'est écrasé. Éditeurs uniquement, pas sur la dernière version. |
| Téléverser une nouvelle version… | Ajoute la version suivante. Éditeurs uniquement. |
| Comparer les versions… | Deux versions côte à côte avec le texte inséré, supprimé et déplacé marqué. Voir « Comparer deux versions ». |
| Retirer les fichiers des anciennes versions… | Supprime les fichiers des anciennes versions choisies. Voir ci-dessous. |
| Pages / Visionneuse PDF | La visionneuse de documents (pages, Rechercher, commentaires) ; ou la visionneuse PDF du navigateur (impression). |
| Vue de révision / Détacher | La visionneuse de documents sur toute la fenêtre, ou dans une fenêtre séparée. |
| Commenter la page… / Épingler un commentaire | Dans la vue Word (un fichier Word conservé sans conversion) : un commentaire sur une page désignée par son numéro, ou sur le paragraphe sur lequel vous cliquez. Cliquez sur Arrêter l'épinglage pour terminer. Les PDF utilisent les outils propres à la visionneuse (voir Examiner et commenter). |
Sous les outils, les informations de la version : Téléversé (par qui et quand), Fichier téléversé (son nom d'origine), Note, Stocké (la taille et le gain) et Dans les références (cliquez sur le nom d'une référence pour voir les fils de commentaires qu'elle a enregistrés).
Retirer les fichiers des anciennes versions
Les PDF des anciennes versions occupent de l'espace de stockage. Retirez ceux dont personne n'a besoin :
- Sur l'Artifact, cliquez sur Retirer les fichiers des anciennes versions….
- Sélectionnez les versions.
Le message « Retire définitivement les fichiers de la version 2. La version reste dans l'historique. » s'affiche.
- Cliquez sur Retirer les fichiers.
Le message « Fichiers de 1 version retirés (12,4 Mo libérés). » s'affiche.
- Qui peut retirer : le titulaire du compte sur une offre personnelle (le propriétaire du projet), un administrateur de l'organisation sur l'offre Team. Un administrateur de l'organisation n'a pas besoin d'un accès en modification au projet ; le retrait porte le nom de l'administrateur.
- La dernière version ne peut pas être retirée de cette façon. Pour la retirer, supprimez l'Artifact.
- La version reste dans la liste, marquée « Fichier retiré par nom le date ». Ses commentaires restent dans Discussion sous forme de texte.
- Le retrait est enregistré dans le journal d'audit, avec les versions et l'espace libéré.
Fichiers en cours d'ajout
La base de données affiche Fichiers en cours d'ajout pendant que vos téléversements sont en cours.
- Téléversement… : le fichier est en cours d'envoi. Annuler l'arrête, et rien n'est ajouté.
- En attente (n avant) ou En attente (suivant) : le fichier attend son tour. Annuler le retire de la file.
- Conversion…, Compression…, Stockage… : le fichier est en cours de traitement.
- Un fichier qui n'a pas pu être ajouté reste dans la liste avec son message jusqu'à ce que vous cliquiez sur Ignorer.
Si le serveur redémarre pendant une conversion, le fichier retourne dans la file et est retenté une fois.
Sans conversion
Lorsque le serveur n'a pas de convertisseur, les fichiers sont stockés tels que téléversés :
- Les PDF sont stockés sans compression.
- Les fichiers Word sont affichés en lecture seule dans le navigateur : « Affiché en lecture seule dans le navigateur (pas de conversion PDF sur ce serveur). La mise en page peut différer de Word. » Épingler un commentaire épingle alors les commentaires aux paragraphes.
Messages
| Message | Que faire |
|---|---|
| « fichier fait 140 Mo. Les fichiers Word de plus de 100 Mo ne peuvent pas être convertis. Dans Word, choisissez Fichier → Enregistrer sous → PDF, puis téléversez le PDF. » | Enregistrer le document en PDF dans Word et téléverser le PDF. |
| « Impossible de convertir fichier : le fichier est protégé par mot de passe. Retirez le mot de passe et téléversez-le de nouveau. » | Ouvrir le fichier dans Word, retirer le mot de passe d'ouverture, enregistrer et téléverser de nouveau. |
| « Impossible de convertir fichier : le fichier est endommagé ou n'est pas un document Word. » | Ouvrir et enregistrer le fichier dans Word, ou téléverser un PDF. |
| « Impossible de convertir fichier : l'opération a pris plus de 5 minutes (fichier très volumineux ou complexe). Divisez-le ou enregistrez-le en PDF et téléversez le PDF. » | Diviser le document, ou l'enregistrer en PDF dans Word et téléverser le PDF. |
| « Impossible de convertir fichier : il nécessite plus de mémoire que le convertisseur n'en dispose (nombreuses grandes images). Réduisez les images ou téléversez un PDF. » | Compresser les images dans Word (Format de l'image → Compresser les images), ou téléverser un PDF. |
| « Impossible de stocker fichier : le fichier est endommagé ou n'est pas un PDF. » | Enregistrer de nouveau le PDF depuis le programme qui l'a créé. |
| « Seuls les documents Word (.docx) et les PDF deviennent des Artifacts. Non ajoutés : fichiers. » | Enregistrer d'abord les autres formats en .docx ou en PDF. |
| Un message de limite par fichier | Le fichier dépasse la limite par fichier de votre offre. Pour un fichier Word, le message conseille aussi de l'enregistrer en PDF. |
Lorsqu'un fichier ne peut pas être ajouté, rien n'est conservé : aucun Artifact, aucune version, et le téléversement est supprimé.
Limites
| Offre | Par fichier |
|---|---|
| Free / Academic | 10 Mo |
| Individual | 25 Mo |
| Team | 100 Mo |
- Les fichiers Word de plus de 100 Mo ne peuvent être convertis sur aucune offre.
- La limite par fichier s'applique au fichier que vous téléversez. Le PDF stocké compte dans le stockage du projet et dans le vôtre.
- Les Artifacts Word et PDF sont disponibles dans les projets LML.