如何安装 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 功能有无成功。

安装操作如果有任何问题，请截屏并来信告知当前的步骤为何，以利我们协助厘清问题。