什么是文档在线编辑_对象存储(OSS)-阿里云帮助中心

您可以通过文档在线编辑功能在线编辑文档。本文介绍文档在线编辑处理功能参数及示例。

使用场景

协同办公平台：多个用户协同办公时，需要多人实时协作编辑同一份文档。
内容管理系统：一些企业级的内容管理系统需要进行在线编辑，以直接在系统内对文档进行增删改查。
教育平台：在线教育平台常会让学生提交作业或教师编写课件，文档直接保存在云端，方便随时查阅和分享。

注意事项

如果您需要通过x-oss-process使用文档在线编辑，请在配额中心申请。
文档在线编辑仅支持同步处理。关于文档编辑更多信息请参见WebOffice服务交互流程。
使用文档在线编辑前，需要先绑定IMM Project。关于控制台和API如何绑定，请参见快速入门和AttachOSSBucket。
不支持匿名访问。
必须拥有IMM处理所需的相关权限。更多信息，请参见权限。
文档在线编辑操作需要您在OSS Bucket绑定自定义域名，通过自定义域名访问文件时能打开编辑。如果使用OSS默认域名访问文件，将下载文档编辑HTML页面，在浏览器打开html页面方可编辑。关于绑定自定义域名更多信息请参见绑定自定义域名至Bucket默认域名。

参数说明

操作名称：doc/edit

具体参数如下表所示。

参数名称	类型	是否必须	描述
print	int	否	是否允许打印。取值： 1：允许打印。不传参：不允许打印。
export	int	否	是否允许导出为PDF。取值： 1：允许导出为PDF。不传参：不允许导出为PDF。
watermark	string	否	水印参数。
text	string	否	水印文字。需经过URL安全的Base64编码。具体操作，请参见水印编码。父节点：watermark
size	int	否	水印文字字号，取大于0的整数。父节点：watermark
t	int	否	水印文字透明度。取值范围：0~100。默认值：100，表示透明度100%（不透明）。父节点：watermark
color	string	否	水印文字颜色，RGB颜色值，例如：#000000表示黑色，#FFFFFF表示白色。默认值为#FFFFFF。父节点：watermark
rotate	int	否	指定文字顺时针旋转角度。取值范围：0~360。默认值为0，表示不旋转。父节点：watermark
type	string	否	指定文字水印的字体，需经过URL Safe的Base64编码。具体操作，请参见水印编码。支持的字体如下：中文字体：宋体（默认值）楷体英文字体： Arial Georgia Tahoma Comic Sans MS Times New Roman Courier New、Verdana 父节点：watermark

使用REST API

编辑信息

编辑文档名称：example.docx
编辑页面水印信息：
- 水印类型：文字水印
- 水印文字：内部资料
- 水印字号：30号字体
- 水印透明度：60
编辑页面权限信息：
- 允许用户导出
- 允许用户打印

处理示例

GET /exmaple.docx?x-oss-process=doc/edit,export_1,print_1/watermark,text_5YaF6YOo6LWE5paZ,size_30,t_60 HTTP/1.1
Host: doc-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****

使用SDK

文档在线编辑仅支持同步处理，SDK使用方法请参见使用SDK。