Holarch

Working with Others

Word and PDF Files as Artifacts

Bring a Word document or a PDF into the project as an Artifact, so reviewers read it, comment on its pages and approve it in Holarch. Each new upload of the same document becomes a new version; earlier versions stay readable.

Where to find it

  • The New Item dialog (LML projects): Artifact from a Word or PDF File… under the Name field (From a Word or PDF File… in a New Artifact dialog). It opens from + New Item on the Database (+ New Artifact when the Database shows Artifacts only) and ⌘K / Ctrl+K → New Item….
  • Drag .docx and .pdf files onto the Database table, or run ⌘K / Ctrl+K → Artifact from File… on any page of a project.
  • The Artifact page: the File section at the top.

Main actions

  • Add files: one Artifact per file, named after the file. When the project already has an Artifact from a file with the same name, choose Upload as New Version (the default), Keep Both (the new one gets “(2)”) or Cancel. A note for the new version is optional.
  • Conversion (hosted): Word files are turned into PDF and PDFs are compressed, one file at a time for everyone; files from different accounts take turns. The Database shows Files being added with “Waiting (2 ahead)”, Converting… or Compressing…. You may close the tab: you are told when it is done, in Holarch or by email. The Word original is not kept once its PDF is stored.
  • When a file can't be converted: nothing is added, and the message names the file, the reason and the fix, for example “Couldn't convert Design Review.docx: the file is password-protected. Remove the password and upload it again.”
  • Read and comment: Pages is the document viewer: Page 3 of 12, previous and next page, Thumbnails, zoom (Fit Width, Fit Page), Find (⌘F / Ctrl+F) and selectable text. Comment on selected words (Select Text, then Comment on Selection), on a spot (Point), on an area (Box, drag on the page) or on the whole page (Comment on Page); type @ to mention someone. The Comments panel lists threads in page order with Reply, Resolve and Reopen; clicking a thread shows its spot and clicking a marker opens its thread. Keys: ← →, Home, End, + and −. Review View opens the version across the whole window and Pop Out in a separate window. PDF Viewer opens the browser's own viewer for printing. Comments belong to the version they were made on; Discussion shows “on version 2, page 3”. Commenting never changes the file.
  • Comments and tracked changes from Word (hosted): a Word file's comments come over as threads on the words they were made on, with replies, author and date, marked From Word; tracked changes are listed as Suggested insertion or Suggested deletion. The PDF shows comments in the margin and changes as redline. The notice says what came over, for example “3 comments and 2 tracked changes came over from Word.”
  • Comments on later versions: a comment belongs to the version it was made on. When a new version is added, open threads move to it: words are found again even when they moved to another page, and the thread is labelled From version 2. When the words were edited it is also marked Text changed since and shows what the earlier version said. Threads whose words are gone are listed under Earlier versions, with Show on Version N. Points and boxes follow the nearest line of text; on a drawing or scan they stay only when the page looks the same. Resolved threads stay on their version. Made on shows only the threads made on one version. Comments keep their quoted words, so they still read after an old version's file is removed. An edited comment keeps its earlier text (Earlier text). A baseline records the file version and its threads: click its name under In baselines.
  • Versions: the Version list shows every version with its date and uploader. Download (PDF) saves the version shown; Restore as Newest makes an old version the newest again (a new version; nothing is overwritten); Upload New Version… adds the next one. Baselines record the version they include.
  • Compare versions: Compare Versions… (beside the Version list, when there are two versions or more) shows two versions side by side, page by page: inserted words green on the newer version, deleted words red on the older one, moved sentences and paragraphs violet in both places (with their word changes when they were also edited). The text is compared across the whole document, so text that moved to another page is found. The change list counts the changes; select one, or use Previous and Next (F7, Shift+F7), to show it on both sides. Sync scrolling keeps the same text side by side. Pages without text (drawings, scans) are compared as pictures; a changed one shows its differences on the newer page (red: only in the older version, green: only in the newer one). A Word file kept without conversion is compared as text.
  • Remove old versions' files: Remove Old Versions' Files… (the account holder on a personal plan; on Team an organization admin, also without edit access to the project) deletes the files of chosen old versions to free storage: “Removes the files of version 2 permanently. The version stays in the history.” The version then shows “File removed by name on date”. The latest version can't be removed this way.
  • File limits: 10 MB per file on Free, 25 MB on Individual, 100 MB on Team. Word files over 100 MB can't be converted: save them as PDF in Word (File → Save As → PDF) and upload the PDF. After an upload, the notice states the stored size, for example “Stored as 2.1 MB, compressed from 15 MB.”
  • Without conversion (a server without a converter): PDFs are stored as uploaded, and Word files are shown read-only in the browser, with comments on paragraphs.

Tips

  • Signed PDFs, PDF forms and PDF/A files are kept exactly as uploaded: compressing them would break the signature, the form or the conformance.
  • Text changes elsewhere in Holarch (change-request review, item History, document changes, library differences) use the same comparison: a sentence that moved is marked as moved, with a link to its other place, instead of as one deletion and one insertion.
  • Upload the next version of a document under the same file name to keep one Artifact with its whole history.

Related

Attachments and Project Storage · Comments and Reviews · Baselines & Versions