核心功能
- 支援透過基於範本的欄位對映，從 XML 輸入生成 PDF 表單
- 支援多頁輸出、選擇性頁面生成以及條形碼欄位整合
- 支援 Code39、Code128、GS1-128 和 QR 碼等條形碼型別，並具備高階配置選項
概觀
PDF 端口將 XML 輸入轉換為 PDF 輸出。XML 元素名稱與 PDF 範本中的表單欄位名稱匹配。每個 XML 元素的值會填入相應的表單欄位，以生成 PDF 輸出檔案。端口配置
本節包含所有可配置的端口屬性。設定索引標籤
配置
_與端口核心操作相關的設定。其他設定
進階選項卡
其他設定
訊息
日誌
其他設定
自動化索引標籤
自動化設定
_與端口自動處理檔案相關的設定。效能
告警索引標籤
SLA 索引標籤
生成 PDF 文件
PDF 端口讀取 XML 輸入檔案，並使用這些 XML 檔案中的資料生成與設定索引標籤中指定的範本檔案 PDF 文件匹配的 PDF 文件。這些 XML 輸入檔案的結構應與下面描述的結構或下一節中描述的舊結構匹配。XML 格式
下面是一個 XML 輸入檔案範例：- 根目錄下有一個 Items 元素
- 一個 PDF 子元素代表一個 PDF 文件
- 在 PDF 元素內，每個元素與要動態填充資料的表單欄位名稱匹配
多頁輸出
如果範本檔案 PDF 包含多個頁面，則端口在處理 XML 輸入檔案時會自動生成適當數量的頁面。此外，也可以從單個 XML 檔案生成範本檔案的多個副本，此時附加副本會作為同一輸出檔案的多個 PDF 頁面追加。 要將範本檔案的多個副本生成到多頁輸出中，只需重複根 Items 元素的直接子元素 PDF。此位置的每個 PDF 元素都被視為範本檔案的單獨例項，因此應包含填寫範本所需的所有命名錶單欄位值。輸出頁面子集
如果範本檔案 PDF 包含多個頁面，則端口支援透過在 XML 輸入檔案中指定相應頁面來生成這些範本頁面的子集。輸入文件根目錄中的 Items 元素接受 pages 屬性，該屬性包含逗號分隔的頁碼清單（從零開始計數），用於指定輸出中應包含的頁面。 例如，如果範本檔案包含 4 頁，並且輸出中只應包含第一頁和最後一頁，則 XML 輸入檔案如下所示：條形碼
條形碼欄位（應包含條形碼資料的表單欄位）的處理方式與其他表單欄位相同：條形碼欄位在 PDF 範本中有一個標籤，該標籤應作為輸入 XML 中的元素名稱。此外，條形碼欄位應具有 type 屬性，用於確定要生成的條形碼型別。端口支援四種條形碼型別：- code39
- code128
- gs1128
- qrcode
高階條形碼配置
除了在 XML 輸入檔案中指定條形碼型別外，還可以直接在 PDF 範本檔案中配置條形碼。建立和編輯用於儲存條形碼的表單欄位時，可以將配置資訊新增到欄位工具提示中，以影響生成的條形碼。此配置資訊應始終採用以下格式：$$parameter1:value,parameter2:value$$
條形碼支援以下參數：
- barcode：條形碼型別（使用上一節所述的 type 屬性時冗餘）
- qrcodeversion：當條形碼型別設定為 qrcode 時 QR 碼的版本
- eclevel：使用 QR 碼時的糾錯級別。可接受的值為 L（低）、M（中）、Q（四分位）和 H（高）
- quietzone：條形碼周圍的空白緩衝區。該值應為整數，表示最小條形尺寸的倍數（建議值為 10 或更高）
- heightnarrowratio：最窄條相對於條形碼高度的寬度；必須指定為高度為 1 的比率（例如 ‘0.05’ 表示 1/20）
- widenarrowratio：最窄條相對於最寬條寬度的寬度；必須指定為最寬條為 1 的比率（例如 ‘0.2’ 表示 1/5）
- spacebarratio：條形碼中空白相對於條形寬度的寬度；必須指定為條形寬度為 1 的比率（預設值為 1）
範例
下面是一個範例 XML 輸入檔案、PDF 範本檔案 以及生成的 PDF 輸出。下面的範本檔案影像來自 Adobe Pro 表單編輯器，其中顯示每個表單欄位的名稱。請記住，範本檔案中的欄位名稱必須與 XML 中的元素標籤匹配。
輸入 XML
範本檔案
輸出
