跳到主要内容

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 源文件设置和画布布局,过期修订号会被拒绝。