Holarch

Контроль і рецензування

Файли Word і PDF як Artifact

Додавайте документи Word і PDF до проєкту як Artifact, рецензуйте та коментуйте їхні сторінки, зберігайте кожну версію та звільняйте сховище, вилучаючи файли старих версій.

Як цим користуватися →

На цій сторінці
  1. Поняття
  2. Як користуватися
    1. Коли й навіщо
    2. Додати файли Word або PDF
    3. Передати нову версію
    4. Рецензування й коментування
    5. Коментарі до пізніших версій
    6. Коментарі й відстежувані зміни з Word
    7. Порівняти дві версії
    8. Розібраний приклад: рецензування проєкту в демо CubeSat EO-1
    9. Поради та добрі практики
    10. Типові помилки
    11. Як це пов’язано з іншим
  3. Розділ «Файл»
  4. Вилучити файли старих версій
  5. Файли, що додаються
  6. Без перетворення
  7. Повідомлення
  8. Обмеження
  9. Пов’язане

Документ Word або PDF може зберігатися у вашому проєкті як Artifact. Рецензенти читають його в Holarch, коментують його сторінки й затверджують, як будь-який інший елемент. Кожне нове передавання того самого документа стає новою версією, а попередні версії лишаються доступними для читання.

У хмарному сервісі файли Word перетворюються на PDF під час додавання, а PDF стискаються. Саме PDF усі читають, завантажують і коментують.

Поняття

  • Файловий Artifact: Artifact, що містить файл. Його сторінка має вгорі розділ Файл із засобом перегляду, версіями й інструментами для файлу.
  • Версія: одне передавання документа. Кожна версія зберігає свій PDF, хто її передав, дату й необов’язкову примітку. Типово показується найновіша версія.
  • Перетворення: перетворення файлу Word на PDF і стиснення PDF. Для всіх одночасно перетворюється один файл; файли з різних облікових записів обробляються по черзі, тож один великий пакет не затримує інших.
  • Закріплений коментар: коментар, що належить певному місцю однієї версії: виділеним словам, точці, рамці чи цілій сторінці (або, у поданні Word, абзацу). Обговорення показує, де він розташований, наприклад “у версії 2, сторінка 3”.

Як користуватися

Коли й навіщо

Використовуйте файловий Artifact, коли результат роботи написано поза Holarch: пакет рецензування проєкту, документ контролю інтерфейсів постачальника, звіт про випробування. Зберігання його в проєкті розміщує його поряд із вимогами й елементами, які він охоплює. Рецензенти коментують в одному місці, а базові лінії записують, яку версію затверджено.

Додати файли Word або PDF

  1. Відкрийте База даних проєкту LML.
  2. Натисніть + Новий елемент, потім Artifact із файлу Word або PDF… під полем Name. Коли База даних показує лише Artifact, кнопка називається + Новий Artifact, а кнопка діалогу — З файлу Word або PDF…. Діалог закривається, і відкривається вибір файлу.

    Та сама кнопка є в діалозі «Новий елемент» скрізь, де він відкривається, наприклад ⌘K / Ctrl+K → Новий елемент…. Також можна перетягнути файли .docx і .pdf на таблицю Бази даних або натиснути ⌘K / Ctrl+K і виконати Artifact із файлу… на будь-якій сторінці проєкту.

  3. Виберіть один або кілька файлів.

    Над таблицею з’являється Файли, що додаються зі станом кожного файлу: “Очікування (попереду 2)”, Перетворення…, Стиснення… або Збереження….

  4. Зачекайте або продовжуйте роботу. Вкладку можна закрити.

    Коли файл готовий, Holarch повідомляє вам: “Design Review.docx готовий як Artifact.” Якщо жодна ваша вкладка Holarch не відкрита, повідомлення надходить електронною поштою.

Кожен файл стає одним Artifact із назвою файлу без розширення. Сповіщення вказує збережений розмір, наприклад “Збережено як 2,1 MB, стиснено з 15 MB.”

Передати нову версію

  1. Відкрийте Artifact.
  2. У розділі Файл натисніть Передати нову версію… і виберіть файл.
  3. За бажанням введіть Примітка до нової версії, наприклад “Опрацьовано коментарі з рецензування проєкту”, і натисніть Передати як нову версію.

    До готовності на сторінці показується “Нова версія Design Review.docx: перетворення…”.

Коли ви додаєте файл, назва якого збігається з Artifact, уже створеним із файлу з такою назвою, Файл уже в проєкті запитує, що робити:

  • Передати як нову версію (типово): файл стає наступною версією цього Artifact.
  • Зберегти обидва: окремий Artifact, до назви якого додається “ (2)”.
  • Скасувати: нічого не додається.

Рецензування й коментування

  1. Відкрийте Artifact. Сторінки показує PDF у засобі перегляду документів: панель інструментів, сторінки й панель Коментарі поруч із ними.
  2. Переміщуйтеся документом за допомогою панелі інструментів: Сторінка 3 з 12 (введіть номер сторінки й натисніть Enter), кнопки попередньої й наступної сторінки, Мініатюри, масштаб (За шириною, Уся сторінка або фіксований розмір) і Знайти (⌘F / Ctrl+F). Клавіші: ← і → гортають сторінки, Home і End переходять до першої й останньої сторінки, + і − змінюють масштаб.
  3. Коментуйте одним із чотирьох способів:
    • Виділити текст: виділіть слова на сторінці (їх також можна скопіювати), потім натисніть Коментувати виділене. Слова підсвічуються.
    • Точка: клацніть місце на сторінці, до якого належить коментар.
    • Рамка: обведіть рамкою область, наприклад рисунок або таблицю.
    • Коментувати сторінку: коментар до показаної сторінки загалом.

      Введіть коментар на панелі й натисніть Додати коментар (⌘Enter / Ctrl+Enter). Введіть @ та ім’я, щоб згадати когось.

  4. Панель Коментарі перелічує обговорення в порядку сторінок, пронумеровані так само, як їхні позначки на сторінці. Клацніть обговорення, щоб перейти до його місця; клацніть позначку чи підсвічування, щоб відкрити його обговорення. Відповісти, Вирішити і Відкрити знову працюють так само, як в Обговоренні; Показати вирішені показує вирішені обговорення.
  5. Щоб мати більше місця, натисніть Режим рецензування (версія на все вікно) або Відкріпити (окреме вікно, наприклад на другому екрані). Обидва оновлюються, коли люди коментують.

Кожен коментар належить версії, до якої його зроблено, і Обговорення також його показує, наприклад “у версії 2, сторінка 3”. Коментування ніколи не змінює файл: підписаний PDF зберігає свій підпис.

Коментарі до пізніших версій

Коли додано нову версію, відкриті обговорення переходять до неї, тож рецензування триває через версії:

  • Holarch знаходить слова кожного обговорення в новій версії, навіть коли вони перемістилися на іншу сторінку або текст навколо них переформатувався. Обговорення показується там із позначкою З версії 1 (версія, до якої його зроблено).
  • Коли слова відредаговано, обговорення також позначається Текст змінено відтоді і показує, що було в попередній версії, наприклад “Версія 1: “reject 40 W””.
  • Коли слів більше немає, обговорення перелічується в розділі Попередні версії наприкінці панелі «Коментарі» з цитованими словами й Показати у версії 1 (остання версія, де вони є).
  • Точка або Рамка слідує за найближчим рядком тексту. На сторінці без тексту (креслення чи скан) вона лишається на місці, якщо сторінка в новій версії виглядає так само; інакше вона переходить до «Попередні версії».
  • Вирішені обговорення лишаються у версіях, де вони були. Відкрийте одне знову, щоб воно перейшло до новіших версій.
  • Зроблено у (над обговореннями, коли є обговорення з кількох версій) показує лише обговорення, зроблені в одній версії, або всі.
  • Обговорення з Word дотримуються тих самих правил.

Це відбувається, коли додано нову версію. Проєкти з коментарями, зробленими до появи цієї функції, обробляються так само, коли вперше показано новішу версію. В Обговоренні коментар зі старішої версії вказує, де він тепер, наприклад “У версії 1, сторінка 2, “radiator” · перенесено до версії 3” або “· немає у версії 3”.

Коментарі зберігають цитовані слова, тож їх і далі можна прочитати після вилучення файлу старої версії. Відредагований коментар зберігає свій попередній текст: Попередній текст під коментарем перелічує кожне попереднє формулювання з автором і часом.

Базова лінія записує версію файлу та його обговорення в тодішньому стані. Натисніть назву базової лінії в розділі У базових лініях, щоб побачити їх.

Коментарі й відстежувані зміни з Word

У хмарному сервісі власна розмітка рецензування файлу Word переноситься під час додавання:

  • Його коментарі стають обговореннями в PDF на тих словах, до яких їх зроблено, разом із відповідями. Кожне зберігає автора й дату з Word і позначене З Word. Коментар, який Word позначив виконаним, надходить вирішеним.
  • Його відстежувані зміни перелічено як пропозиції: “Запропонована вставка: …” або “Запропоноване видалення: …” від особи, яка їх зробила.
  • PDF показує коментарі на полях, а відстежувані зміни — червоною правкою.

Сповіщення після передавання повідомляє, що перенесено, наприклад “З Word перенесено 3 коментарі й 2 відстежувані зміни.” Імпортовані обговорення належать вам, тож ви можете їх вирішити чи видалити. Тих, хто стежить за елементом, не сповіщають про кожен імпортований коментар.

Порівняти дві версії

  1. Відкрийте Artifact. У розділі Файл натисніть Порівняти версії… (показується, коли Artifact має дві версії або більше).
  2. Виберіть версії Старіша і Новіша. Типово показана версія порівнюється з попередньою.

    Дві версії з’являються поруч, сторінка за сторінкою:

    • Вставлено: слова зеленим у новішій версії.
    • Видалено: слова червоним у старішій версії.
    • Переміщено: речення й абзаци фіолетовим в обох місцях. Переміщений блок, який також відредаговано, показує й зміни слів. Список змін називає обидві сторінки, наприклад “Сторінка 2 → сторінка 5”.
    • Сторінки без тексту (креслення, скани) порівнюються як зображення. Змінену обведено; на новішій сторінці Відмінності показує червоним місця, де чорнило є лише у старішій версії, і зеленим — де лише в новішій.
  3. Виберіть зміну в списку або натисніть Назад і Далі (F7 і Shift+F7), щоб показати її з обох боків. Синхронне прокручування тримає той самий текст поруч під час прокручування.

Текст порівнюється в межах усього документа, тож текст, що перемістився на іншу сторінку чи переформатувався в інші рядки, однаково зіставляється. Файл Word, збережений без перетворення, порівнюється як текст, без сторінок. Довгі документи показують індикатор перебігу під час читання.

Те саме порівняння позначає зміни тексту й деінде: рецензування запитів на зміну, історія елемента, зміни документів і відмінності бібліотек показують переміщені речення як переміщені з посиланням Переміщено до / Переміщено з між двома місцями.

Розібраний приклад: рецензування проєкту в демо CubeSat EO-1

  1. У демо CubeSat EO-1 відкрийте Базу даних, натисніть + Новий елемент і додайте "EO-1 CDR Package.docx" через Artifact із файлу Word або PDF….
  2. Коли він готовий, відкрийте EO-1 CDR Package і пов’яжіть його з вимогами, які він охоплює.
  3. Рецензенти відкривають його й використовують Коментувати сторінку… для сторінки 12: “Thermal margin table is missing the eclipse case.”
  4. Після виправлень передайте “EO-1 CDR Package.docx” знову й виберіть Передати як нову версію з приміткою “Опрацьовано коментарі CDR”.
  5. Створіть базову лінію. Сторінка Artifact показує У базових лініях з назвою базової лінії для версії 2.

Поради та добрі практики

  • Передавайте кожну нову версію під тим самим іменем файлу. Тоді один Artifact містить усю історію.
  • Передавайте PDF замість файлу Word, коли макет має точно відповідати Word: перетворення може зсунути розриви рядків.
  • Підписані PDF, форми PDF, файли PDF/A і зашифровані PDF зберігаються точно такими, як їх передано. Стиснення зламало б підпис, форму або відповідність стандарту.

Типові помилки

  • З’явився другий Artifact: ви вибрали Зберегти обидва. Видаліть його, потім передайте файл знову й виберіть Передати як нову версію.
  • Файл Word понад 100 MB відхилено: у Word виберіть Файл → Зберегти як → PDF, а потім передайте PDF.

Як це пов’язано з іншим

  • Коментарі й рецензування: закріплені коментарі є звичайними коментарями; відповіді, згадки й затвердження працюють як для будь-якого елемента. Див. Коментарі й рецензування.
  • Базові лінії: базова лінія записує версію кожного файлового Artifact. Див. Запити на зміну.
  • Сховище: PDF кожної версії враховується у сховищі проєкту й вашому сховищі. Див. Вкладення, сховище й ліміти.

Розділ «Файл»

Елемент керуванняЩо він робить
ВерсіяПоказує версію: “Версія 3 (найновіша) · дата · хто передав”. Версії, файл яких вилучено, показують “файл вилучено”.
Завантажити (PDF)Зберігає PDF показаної версії. Файл Word, показаний без перетворення, пропонує Завантажити (.docx).
Відновити як найновішуРобить показану версію знову найновішою як нову версію. Нічого не перезаписується. Лише для редакторів, не для найновішої версії.
Передати нову версію…Додає наступну версію. Лише для редакторів.
Порівняти версії…Дві версії поруч із позначеним вставленим, видаленим і переміщеним текстом. Див. «Порівняти дві версії».
Вилучити файли старих версій…Видаляє файли вибраних старих версій. Див. нижче.
Сторінки / Перегляд PDFЗасіб перегляду документів (сторінки, пошук, коментарі) або власний засіб перегляду PDF браузера (друк).
Режим рецензування / ВідкріпитиЗасіб перегляду документів на все вікно або в окремому вікні.
Коментувати сторінку… / Закріпити коментарУ поданні Word (файл Word, збережений без перетворення): коментар до сторінки за її номером або до абзацу, який ви клацнете. Натисніть Припинити закріплення, щоб завершити. PDF використовують власні інструменти засобу перегляду (див. «Рецензування й коментування»).

Під інструментами — відомості про версію: Передано (хто й коли), Передано файл (його початкова назва), Примітка, Збережено (розмір і заощадження) і У базових лініях (натисніть назву базової лінії, щоб побачити записані нею обговорення).

Вилучити файли старих версій

PDF старих версій займають сховище. Вилучіть ті, що нікому не потрібні:

  1. На Artifact натисніть Вилучити файли старих версій….
  2. Виберіть версії.

    Ви бачите “Остаточно вилучає файли версії 2. Версія лишається в історії.”

  3. Натисніть Вилучити файли.

    Ви бачите “Вилучено файли 1 версії (звільнено 12,4 MB).”

  • Хто може вилучати: власник облікового запису на персональному тарифі (власник проєкту), адміністратор організації на тарифі Team. Адміністратору організації не потрібен доступ до проєкту для редагування; вилучення записується з іменем адміністратора.
  • Найновішу версію так вилучити не можна. Щоб вилучити її, видаліть Artifact.
  • Версія лишається в списку з позначкою “Файл вилучено: ім’я, дата”. Її коментарі лишаються в Обговоренні як текст.
  • Вилучення записується в журнал аудиту з версіями й звільненим місцем.

Файли, що додаються

База даних показує Файли, що додаються, поки ваші передавання тривають.

  • Передавання…: файл надсилається. Скасувати зупиняє його, і нічого не додається.
  • Очікування (попереду n) або Очікування (наступний): файл чекає своєї черги. Скасувати вилучає його з черги.
  • Перетворення…, Стиснення…, Збереження…: файл обробляється.
  • Файл, який не вдалося додати, лишається в списку з повідомленням, доки ви не натиснете Закрити.

Якщо сервер перезапускається під час перетворення, файл повертається в чергу й обробляється ще раз.

Без перетворення

Коли сервер не має перетворювача, файли зберігаються такими, як їх передано:

  • PDF зберігаються без стиснення.
  • Файли Word показуються в браузері лише для читання: “Показано лише для читання в браузері (цей сервер не перетворює на PDF). Макет може відрізнятися від Word.” Тоді Закріпити коментар закріплює коментарі за абзацами.

Повідомлення

ПовідомленняЩо робити
“файл має розмір 140 MB. Файли Word понад 100 MB неможливо перетворити. У Word виберіть Файл → Зберегти як → PDF, а потім передайте PDF.”Збережіть документ як PDF у Word і передайте PDF.
“Не вдалося перетворити файл: файл захищено паролем. Зніміть пароль і передайте його знову.”Відкрийте файл у Word, зніміть пароль для відкриття, збережіть і передайте знову.
“Не вдалося перетворити файл: файл пошкоджено або це не документ Word.”Відкрийте й збережіть файл у Word або передайте PDF.
“Не вдалося перетворити файл: це тривало понад 5 хвилин (дуже великий або складний). Розділіть його або збережіть як PDF і передайте PDF.”Розділіть документ або збережіть його як PDF у Word і передайте PDF.
“Не вдалося перетворити файл: йому потрібно більше пам’яті, ніж має перетворювач (багато великих зображень). Зменште зображення або передайте PDF.”Стисніть зображення у Word (Формат рисунка → Стиснути рисунки) або передайте PDF.
“Не вдалося зберегти файл: файл пошкоджено або це не PDF.”Збережіть PDF знову з програми, у якій його створено.
“Artifact стають лише документи Word (.docx) і PDF. Не додано: файли.”Спочатку збережіть інші формати як .docx або PDF.
Повідомлення про ліміт на файлФайл перевищує ліміт на файл вашого тарифу. Для файлу Word також радять зберегти його як PDF.

Коли файл неможливо додати, нічого не зберігається: ні Artifact, ні версії, а передане видаляється.

Обмеження

ТарифНа файл
Free / Academic10 MB
Individual25 MB
Team100 MB
  • Файли Word понад 100 MB не можна перетворити на жодному тарифі.
  • Ліміт на файл застосовується до файлу, який ви передаєте. Збережений PDF враховується у сховищі проєкту й вашому сховищі.
  • Artifact із Word і PDF доступні в проєктах LML.