遠端 GoToR 註解 XFDF 交換

映射註解編解碼器經原生 headless、一般已載入文件以及既有 Windows/Linux callback 註解匯入匯出路徑,保留遠端 GoToR action

交換只序列化 PDF action 資料;不執行 action、不解析路徑、不讀取遠端文件,也不開啟閱讀器

結構

<xfdf xmlns="http://ns.adobe.com/xfdf/">
  <annots>
    <link page="0" rect="10,10,30,30">
      <OnActivation><Action>
        <GoToR NewWindow="yes">
          <File OriginalName="../manuals/remote.pdf"/>
          <Dest><Fit Page="42"/></Dest>
        </GoToR>
      </Action></OnActivation>
    </link>
  </annots>
</xfdf>

GoToR 恰好要求一個 File 與一個 Dest 子元素,順序不限,File 要求 OriginalName

遠端明確目標使用遠端文件中從零開始的整數頁碼,範圍 0 到 2147483647,與目前文件頁數無關

儲存的遠端目標以該整數開頭,而不是指向本機頁的間接參照

具名目標保留其 Unicode 名稱,不解析本機目標名稱樹

八種明確目標模式保留既有的座標、可空值與精確十進位行為

NewWindow 分別保留「省略」「false」「true」三種情形;設限的相容 profile 接受 yes/no、true/false 與 1/0

檔案規格與 Unicode

匯入建立帶 F 與 UF 值的外部 Filespec 字典;UF 是權威的 Unicode 目標,用 PDFDocEncoding 或帶 BOM 的 UTF-16BE 表示

F 在可表示時使用 PDFDocEncoding,否則保留 UTF-8 相容位元組;忽略 UF 的舊閱讀器可能把這些後備位元組解讀成別的樣子

路徑保持不透明的拼寫,不做作業系統轉換,也沒有檔案系統存取

匯出接受外部檔案規格字串或字典,UF 優先於 F

驗證與交易

整個遠端 action 子樹遵循既有的Adobe 命名空間 profile,包含正確綁定的前綴;一般編解碼器保留其明確的 legacy 無命名空間相容 profile

外來命名空間、重複或缺失的必要子元素、意外屬性、非法目標型別、畸形數值或視窗值,都會在原生交易發佈之前被拒絕

原生快照準備保留既有的位元組、物件、深度、工作儲存與取消限制

既有 JSON 操作記錄、公開 callback 配置與符號保持不變

Windows 一般匯入還執行經驗證的目前圖、加密與簽署修訂版政策

格式參照與邊界

File、GoToR、OriginalName 與 NewWindow 的映射遵循 Adobe 的 XML Forms Data Format Specification 3.0 印刷頁 59、63 與 87-88

遠端 PDF action 與檔案規格語義遵循 ISO 32000-1:2008 7.11.2、7.11.3 與 12.6.4.3 節

這個僅路徑 profile 不傳輸內嵌 GoToE 文件、平台專屬檔案替代表、檔案系統選擇器、描述、任意 action 鏈、AP 串流或 FDF action 交換