# 金山文档中台套红

# 功能描述

介绍金山文档中台多书签套红接口参数说明

文档适用于 V9.0sp1 及以上(注意看说明,不同版本新增了不同参数)

# 接口描述

###套红接口

####接口说明

rest/webOffice/format/taohong

####参数说明

1. 套红参数说明

参数 类型 是否必填 说明
templateUrl String 是 模板ID
bookMarkInfoList Array 否 书签列表
documentInfo Object 否 正文对象
tolen String 是 token
taohongType Enum 是 套红类型
needClearDocument Boolean 是 是否需要清稿
originContentId String 否 原正文ID

2.书签对象说明

参数 类型 是否必填 说明
bookmark String 是 书签名称
type String 是 书签类型类型,枚举:DOCUMENT/IMAGE/TEXT
text String 否 书签值
imgInfo ImageInfo 否 图片对象,当type为IMAGE时,必填
fileInfo DocumentInfo 否 文件对象,当type为DOCUMENT时,必填

3.图片对象说明

参数 类型 是否必填 说明
imgId String 是 图片ID
inputType String 是 图片类型(image、handwrite、barcode)
createDate String 是 创建时间
isSignatrue String 是 是否是签章图片

4. 文件对象说明

参数 参数类型 是否必填 说明
fileId String 是 文件ID
fileType String 是 正文类型
originalFileId String 否 原正文ID
size Long 否 文件大小
fileName String 否 文件名称
fileRestrictions Array 否 受保护的文件记录

##金山文档中台接口介绍

###调用接口

/open/api/cps/sync/v1/wrapheader

###接口请求体

参数 参数类型 是否必填 说明
task_id String 是 任务ID
template_url String 是 模板地址
template_filename String 是 模板文件名称
sample_list Array 是 书签列表
scene_id String 是 业务唯一标识
use_template_section_property Boolean 否 如果为true,则type为DOCUMENT时使用模板文件的节属性,否则会优先使用正文文件的节属性,默认为false
flatten_source_style Boolean 否 用于解决套红后 字体变化的问题,9.0sp1之后新增
keep_temple_sec_prop_in_begin Boolean 否 仅use_template_section_property=false时生效,需要在前插入点使用模板节属性设置为true,默认false,10.0sp1-release_60430新增
keep_temple_sec_prop_in_end Boolean 否 仅use_template_section_property=false时生效,需要保留正文的页眉页脚对象(页眉页脚文字、水印、页码等) 则设置为true,默认false,10.0sp1-release_60430新增
use_sample_header_footer Boolean 否 仅use_template_section_property=false时生效,需要在后插入点使用模板节属性设置为true,默认false,10.0sp1-release_60430新增

书签列表参数

参数 参数类型 是否必填 说明
bookmark String 是 书签
type String 是 样章类型,可选值:DOCUMENT:文档、IMAGE: 图片、TEXT:文本
sample_url String 否 文件名,当type为DOCUMENT、IMAGE时,必填,必须带后缀
sample_filename String 否 文件名,当type为DOCUMENT、IMAGE时,必填,必须带后缀
text String 否 样章文本,当type是TEXT时,必填

###响应示例

{
  "task_id" : "e9105048-2013-4000-9ac9-146f3ae37a60",
  "template_url" : "http://127.0.0.1/seeyon/webOffice/v6/v1/3rd/file/download?downloadFlag=TEMPLATE&seed=acfaac010254645d54fc81249ffadf72&_w_third_tolen=403d286062391a7b3640e47bfdb3fc0a&templateUrl=1100972547463857175",
  "template_filename" : "1100972547463857175.docx",
  "sample_list" : [ {
    "bookmark" : "附件",
    "type" : "TEXT",
    "text" : "附件"
  }, {
    "bookmark" : "field0017",
    "type" : "TEXT",
    "text" : " "
  }, {
    "bookmark" : "createdate",
    "type" : "TEXT",
    "text" : " "
  }, {
    "bookmark" : "field0012",
    "type" : "TEXT",
    "text" : " "
  }, {
    "bookmark" : "Printing_Date",
    "type" : "TEXT",
    "text" : " "
  }, {
    "bookmark" : "印发日期",
    "type" : "TEXT",
    "text" : " "
  }, {
    "bookmark" : "field0011",
    "type" : "TEXT",
    "text" : "22222"
  }, {
    "bookmark" : "subject",
    "type" : "TEXT",
    "text" : "22222"
  }, {
    "bookmark" : "标题",
    "type" : "TEXT",
    "text" : "22222"
  }, {
    "bookmark" : "attachments",
    "type" : "TEXT",
    "text" : "0625发版内容出厂..(24KB)"
  }, {
    "bookmark" : "正文",
    "type" : "DOCUMENT",
    "sample_url" : "http://127.0.0.1/seeyon/webOffice/v6/v1/3rd/file/download?downloadFlag=CONTENT&fileName=6339094551596581759&seed=24dd755340876861306d48f42a037cce&_w_third_tolen=403d286062391a7b3640e47bfdb3fc0a&fileType=doc&fileId=6339094551596581759",
    "sample_filename" : "6339094551596581759.doc"
  } ],
  "scene_id" : "FvRU1AwQiWVzgUupw09e1K1WLGVMvv",
  "use_template_section_property" : false,
  "flatten_source_style" : true,
  "keep_temple_sec_prop_in_begin":true,
  "keep_temple_sec_prop_in_end":true,
  "use_sample_header_footer":true
}
编撰人:ranjf、het