formio/pdf-server

form.io PDF Server 镜像文档

镜像概述

该镜像提供form.io平台的PDF服务器后端服务，专为form.io表单系统设计，支持基于表单数据动态生成、管理PDF文档，实现表单与PDF文档处理的无缝集成。

核心功能

• 动态PDF生成：根据form.io表单提交的数据实时生成定制化PDF文档
• 模板支持：兼容自定义PDF模板，支持文本、图片、表格等元素排版
• form.io集成：与form.io平台深度整合，支持表单事件触发PDF生成
• API接口：提供RESTful API，支持外部系统调用PDF生成服务
• 轻量部署：基于Docker容器化部署，简化环境配置与依赖管理

使用场景

• 在线表单提交后自动生成确认PDF文档（如报名回执、申请确认书）
• 基于表单数据生成结构化报表PDF（如调查统计报告、数据汇总表）
• 需将form.io收集的数据转化为标准化PDF文件的业务场景
• 第三方系统通过API调用form.io表单数据生成PDF文档

使用方法

基本部署（docker run）

bash
docker run -d \
  --name formio-pdf-server \
  -p 3000:3000 \
  -e FORMIO_URL="https://your-formio-instance.com" \
  -e API_KEY="your-formio-api-key" \
  -e PORT=3000 \
  formio/pdf-server

Docker Compose配置

yaml
version: '3'
services:
  pdf-server:
    image: formio/pdf-server
    container_name: formio-pdf-server
    ports:
      - "3000:3000"
    environment:
      - FORMIO_URL=https://your-formio-instance.com  # form.io实例完整URL
      - API_KEY=your-formio-api-key                  # form.io平台API密钥
      - PORT=3000                                   # 服务监听端口
      - LOG_LEVEL=info                              # 日志级别（debug/info/warn/error）
      - TEMPLATE_DIR=/app/templates                  # PDF模板文件目录（容器内路径）
    volumes:
      - ./templates:/app/templates                   # 挂载本地模板目录（可选）
    restart: unless-stopped

环境变量配置

API调用示例

生成PDF文档（POST请求）：

bash
curl -X POST http://localhost:3000/generate \
  -H "Content-Type: application/json" \
  -d '{
    "formId": "your-form-id",
    "submissionId": "your-submission-id",
    "template": "default-template"
  }'

注意事项

• 确保FORMIO_URL指向的form.io实例与PDF服务器网络互通
• API_KEY需具备form.io平台的表单数据读取权限
• 自定义模板需符合Handlebars模板语***范，放置于指定模板目录
• 生产环境建议配置持久化存储卷以保存生成的PDF文件（可通过额外环境变量配置输出目录）