如何在內網主機啟用 PDF 下載功能

在私有主機版中， PDF 下載功能自建的需要條件為 node & Puppeteer （此為進階功能，建議由資深系統管理人員進行安裝及維護）。當前支援的版本為：Node（v.14.19.3） 以及 Puppeteer（v.14.4.1）。

1. 以 Windows 系統為例，請至連結（https://nodejs.org/download/release/v14.19.3/），進行下載、安裝作業（32 或 64位元版依您的環境而訂）。

2. 安裝完畢後，開啟 cmd，切換至相關位置底下，例如您安裝 Ragic! 的位置在D:\Ragic\RagicBuilder，那就切換到這個位置：D:\Ragic\RagicBuilder\web\sims\js\pdfMaker

接著在這個位置下 Command 安裝 Puppeteer，指令為：npm i puppeteer@14.4.1。

3. 安裝完畢後，即可啟動 node service，例如您安裝 Ragic! 的位置在D:\Ragic\RagicBuilder，那就切換到這個位置：D:\Ragic\RagicBuilder，接著下 Command：node web/sims/js/pdfMaker/nodeJs.js 8888。

注意：請不要將 cmd 畫面關掉，它必須一直執行。

4. 要驗證是否有啟動成功，可開啟 Powershell，下 Command：Get-NetTCPConnection -LocalPort 8888。

成功的話就像以下截圖：

5. 確認 Service & Port 都正確聆聽後，接著回到 Ragic! 設定，在 私有主機設定 裡修改值為：PDF_SERVER_URL=http://localhost:8888。

6. 修改完畢後，請重啟 Ragic! 服務，讓它重新載入設定。

7. 您可以在任一表單裡按下工具裡的下載成 PDF 來測試列印 PDF 功能有無成功。

安裝作業如果有任何問題，請截圖並來信告知當前的步驟為何，以利我們協助釐清問題。