本服务支持：

将常见的文档类文件转换为Pdf、Ofd文件，也可转换为Jpg格式图片；支持对文档类文件的在线预览。

将常见的视频文件转换为MP4、音频文件转换为MP3；支持对音视频文件转换后进行在线播放；支持对视频文件加入水印、截取指定时间的画面等功能。

支持通过path、url方式获取源文件；

支持对文件加图片水印、文字水印；

支持path、ftp、url方式回写文件。

• 本服务支持的文档类文件输入格式为：

  • 图片格式：tif、png、jpg、bmp、psd、sgi、pcx、webp、batik、icns、pnm、pict、tga、iff、hdr、gif

  • Office系列：

    • Word：doc、docx

    • Excel：xls、xlsx

    • PowerPoint：ppt、pptx

    • Visio：vsd、vsdx

  • OpenOffice系列：odt、odp、ods

  • WPS系列：wps

  • XML：支持文本化转换、预览；支持数电票、xbrl等格式化xml套版转换、预览。

  • 其他：csv、tsv

• 本服务支持的音视频文件格式为：avi、mp4、mkv、mov、flv、webm、mp3、m4a、ogg、3gp等（FFmpeg支持）。

• 支持多种文件输入方式：文件路径、http（get）下载、ftp，可扩展
• 支持输入多种文件格式。
• 文档类文件支持水印：文字水印、图片水印、归档章、页码；视频文件支持水印：文字水印、图片水印。
• 文档类文件支持生成双层PDF；视频文件、音频文件支持设置转换编码、分辨率等参数。
• 支持多种文件回写方式：文件路径（path）、http协议上传（url）、FTP服务上传（ftp），可扩展。
• 支持转换结果回调。
• 支持失败延迟重试。
• PDF文件支持涂抹遮盖。

• jdk8: 编译、运行环境
• 转换引擎：
  • WPS预览服务：推荐。需要Linux系统，需要8c32g，系统盘不小于100G，数据盘XFS格式，操作系统CentOS 7.9。
  • 永中FCS文档服务：推荐。需要Linux服务器部署。（支持各种格式转换）。
  • 数科文档转换服务：推荐。需要Linux服务器部署。（支持各种格式转换）。
  • 福昕文档转换服务：推荐。需要Linux服务器部署。（支持各种格式转换）。
  • OnlyOffice文档服务：不推荐。需要Linux服务器部署。（Office系列文件跑版）
  • WPS Office客户端：（Jacob方式单线程调用）。推荐。需要Windows环境部署。（支持Word、Excel、PowerPoint格式转换，速度快）
  • 微软Office客户端：（Jacob方式单线程调用）。推荐。需要Windows环境部署。（支持Word、Excel、PowerPoint、Visio格式转换，速度慢，PDF格式兼容性一般）
  • LibreOffice客户端：不推荐。支持Linux、Windows环境部署。（Office系列文件跑版）。
• maven: 编译打包，只运行jar不需要，建议V3.6.3以上版本
• rabbitMQ: 重试机制依赖MQ延迟队列，需安装插件 rabbitmq_delayed_message_exchange

1. 获取jar包：联系档案项目组或使用mvn clean package -Dmaven.test.skip=true编译。

2. 获取license文件：联系档案项目组获取, 试用则不需要，可免费试用7天。

3. 修改配置application.yml：

   1. 接收的输入文件存储的临时文件夹:convert.path.inPutTempPath:

   Windows： D:/work/input/

   Linux： /work/input/

   2. 默认的本地输出文件路径: convert.path.outPutPath:

   Windows： D:/work/output/

   Linux： /work/output/

   3. 如需支持失败重试功能，需配置 RabbitMQ 相关参数

4. 确认文件目录结构

│  application.yml               配置文件
│  convertpreview-{版本号}.jar    运行jar
│  {项目名}.license               license文件，文件名不重要
│  utils                         工具程序文件夹
│  watermark                     水印、归档章文件夹

5. 以管理员身份运行

   Windows： javaw -jar convertpreview-{版本号}.jar

   Linux： nohup java -jar convertpreview-{版本号}.jar &

6. 浏览器访问 https://{ip}:{端口} , 返回 启动成功 标识项目启动正常

1. 项目日志在哪里？

   运行目录下log文件夹内

2. 项目启动失败，日志中有The Tomcat connector configured to listen on port 8080 failed to start. The port may already be in use or the connector may be misconfigured.的报错

   端口被占用，修改application.yml中server.port, 改为其他端口

配置说明

本服务提供REST接口供外部系统调用，提供了直接转换接口和通过MQ异步转换的接口。

文件格式转换接口说明

生成文件后返回Base64字符串

生成文件后返回文件流

预览接口（页面）说明

PDF脱敏（涂抹）说明