Limitations

The following limitations apply to the document builder mode.

During document creation, document builder uses repository-document and repository-annotations

The document is built with the source document as it is saved in the repository. The document is also built by using the annotations that are saved in the repository, unless annotations were edited. The following scenarios explain the effects of this behavior:

Scenario 1 - Editing and building the document:
  1. Two instances of the viewer are opened in document builder mode.
  2. A document is loaded from a repository into each viewer window.
  3. The document builder user copies a page from the document in viewer window 1 and pastes the page in the document into viewer window 2.
  4. While the document builder user is working on the documents, another user or system process alters one or both of the master documents.
  5. The document builder user builds the modified document.
  6. Because one or both of the master documents were altered during the document builder session, the built document contains the pages from the latest saved version of the master documents.
Scenario 2 - Editing and building annotations:
  1. Two instances of the viewer are opened in document builder mode.
  2. A document with annotations is loaded from a repository into each viewer window.
  3. The document builder user copies a page from the document in viewer window 1 and pastes the page into the document in viewer window 2.
  4. While the document builder user is working on the document, another user or system process alters one or more of the annotations used in one or both master documents.
  5. The document builder user builds the modified document.
  6. The built document contains the pages from the latest saved version of the master documents. For pages where the document builder user has not modified annotations in the viewer, the annotations for those pages come from the latest saved annotations version. Pages where the user modified the annotations in the viewer contain annotations as seen in the viewer, which might not contain the latest changes.

As a result in both scenarios, the document that is displayed in the viewer differs from the newly built document in the system. To prevent this issue, you must lock or check out the master document when you retrieve it for document builder.

Note: For scenario 1, versioned documents are not affected. This issue occurs only when the document that a URL refers to has changed.

Restore annotations is not supported in document builder mode

In document builder mode, the option to restore annotations is not supported. The following scenario explains the effects of this behavior:
  1. The viewer is loaded in document builder mode.
  2. A document is loaded from a repository.
  3. Annotations are created by the user.
  4. The Restore annotations button is disabled.
  5. The JavaScript API reloadAnnotations() is disabled

As a result, you cannot reload the annotations from the server. Newly created annotations and edited annotation edits remain.

To restore any newly created annotations, you must take the following steps:
  1. Remove the page on which annotations are present that you want to restore.
  2. Put the page with the original annotations on the clipboard (cut/copy).
  3. Paste the page into the new document location.

Document Builder supported file type limitations

Document builder mode supports PDF files, except for email attachments. PDF files that are attached to emails cannot be used as source files for a new document.

If the owner of a document set access control flags to a PDF file, such as a password to view the document or an indication that the content cannot be copied, this document cannot be used as a source document for document building.

No docN support in document builder mode

Document builder mode does not support DocN documents. The combination of these features might result in unexpected behavior.