AnnotationsApi.importXFDF()

Applies an XFDF file: its annotations are written as create(), reply() and setStatus() write them, with the file's names, authors, subjects and dates (a freetext as the Text Box tool writes it, from its <defaultappearance>), and its <fields> go through doc.forms.setValues().

options.mode: 'merge' (default) — an entry whose name the document already has replaces that annotation in place, keeping the replies in the document the file does not bring back (unless the file moves it to another page, where a thread cannot follow: the old one goes with its thread), and every other entry is added; 'replace' — every annotation the file could describe (text marks, notes, shapes, drawings, polygons, free text, replies, statuses) is removed first, so the document ends up with the file's alone; stamps, links and form fields stay either way.

skipped reasons: unsupported (a stamp, caret, attachment, sound or redaction, a state that is not a review status, an unknown element), no_page, invalid (missing geometry or a refused value, or a name that belongs to a form field, link or pop-up), no_parent (a reply to nothing). flags are written as the file states them; a member of a group (replyType="group") becomes an annotation of its own; an empty attribute is read as none. A name the API cannot write (an obj:… id, one too long) gets a fresh UUID; dashes, icon and a pop-up's own place are read but not written. The license is checked for both halves before either is written, and one annotations change is announced at the end. Needs annotations when the file has annotations, forms when it has fields.

On a certified document the annotations go in only where its certification allows them ('annotations'): at 'forms' a file with annotations is refused with INVALID_STATE unless options.invalidateSignatures (pass annotations: false to take its field values alone), and at 'none' the field values are rejected as read_only.