PDF 水印
打开打印模板,在模板信息中设置 水印。PDF 画布的入口位于画布方向下方;Word、Excel 模板仅在打印格式选择 PDF 时,于打印格式下方显示。原生 DOCX/XLSX 导出不添加水印。
选择 文字水印 后输入多行文字;选择 图片水印 后上传图片。图片直接展示在容器中,文件名位于图片下方。选择无水印可关闭。保存模板后,使用有权限的记录预览或打印,检查最终 PDF。
| 设置 | 含义与范围 |
|---|---|
| 字体颜色 | #RRGGBB 或 #RRGGBBAA,默认 #000000 |
| 字号 | 8–200,默认 18 |
| 字体样式 | none、normal、italic、oblique,默认 normal |
| 字体粗细 | normal、lighter、bold、bolder 或 1–1000 的整数 |
| 图片宽高 | 1–1000,默认 160 × 80 |
| 水印宽高 | 重复水印单元尺寸,20–1000,默认 180 × 100 |
| 角度 | −180° 至 180°,默认 −22° |
| 透明度 | 百分比越高越透明;存储的 opacity 为 0–1,透明度 80% 对应 opacity: 0.2 |
| 水平/垂直间距 | gapX/gapY,0–1000 px,默认 100;间距越小越密集 |
页面预览与最终 PDF 使用保存的配置。字体效果受导出环境可用字体影响。图片水印引用当前调用者有权限读取的租户文件包资产。
CLI 配置
先用 system.form.print-template.get 读取模板及修订号,再更新:
sl system form print-template update --template-id "$TEMPLATE_ID" --expected-revision 2 --definition-file watermark.json --json
watermark.json 使用顶层 watermark,Runtime 将其写入 settings.watermark:
{"watermark":{"type":"text","text":"保密\n内部使用","fontColor":"#505050","fontSize":18,"fontStyle":"normal","fontWeight":"bold","width":180,"height":100,"gapX":80,"gapY":100,"rotate":-22,"opacity":0.2}}
图片配置使用 type: "image"、image: {"fileAssetId": "<已上传资产UUID>", "fileName": "seal.png"},并设置 imageWidth、imageHeight。使用 {"watermark":{"type":null}} 关闭水印。提交水印时应提供完整的预期配置,省略的水印属性取默认值;完全不传 watermark 则保留当前配置。只更新水印会保留 Office 源文件设置和画布布局,过期修订号会被拒绝。