《在线文档预览用户手册》由会员分享，可在线阅读，更多相关《在线文档预览用户手册（11页珍藏版）》请在金锄头文库上搜索。
1、在线文档预览用户手册I Doc View2014年10月第一章、概述I Doc View在线文档预览支持以下格式文件的在线预览：文档：doc,docx,wps,odt,rtf、xls,xlsx.et,ods,cs，ppt、pptx、dps.odp,pdf、txt图片:jpg, jpeg, gif、png, bmp. tif, tiff音频： mp3, m4a. mid. wma视频：mp4压缩文件：zip, rar, tar, 7z图纸：dwg. dxf. dwf编程:js,cssJava,php,sql附加功能：word在线编辑，word、ppt同步预览I Doc View在线文档预览分为单
2、机版和集群版。单机版适用场景用户量5万以下日预览量百万级以下上传并发平均150个文档/秒预览并发平均1000个文档/秒单个文档转换平均2秒转换并发平均310个文档/秒（单机，如集群部署N台服务器，则速度提升接近N倍）注：以上参数根据带宽和机器配置有所不同硬件配置：内存：8G或以上（中小规模预览）如果预览量大，建议配置SSD,并且将O伍ce安装在SSD硬盘中。如果超过以上访问量，建议配置集群版。系统环境：Wmdows Sen-er 2016 64位（推荐）、2012 64位 或2008 R2 64位（最低版本,不推荐）特别提示：清自行进行数据冗余备份第二章、特色1. 预览本地文档您可以上传并在线
3、查看您计算机的文档。2. 预览网络文档您可以对网络文档进行预览。3. 阅读进度条doc, docx. ppt, pptx和txt文档大于约3页时，预览页面底部会出现阅读进度条。4. 页面定位doc, docx和txt文档大于约3页时，预览页面底部会出现一个页面定位区域，区域内每个圆 点代表一个页而，从左到右依次增加，圆点越多，文档越大。鼠标移动到页而定位区 域后会变为手形，点击即可跳转到对应页面：ppt. pptx文档预览时，电脑端可使用T、“一箭头向上翻页，“一、丁或空格键向下翻页， 或直接点击左侧缩略图跳转到对应页面，手机端则既可通过页面选择器定位页面，也可左右 滑动来切换幻灯片，pad端
4、则既可通过左侧缩略图定位页面，也可在右侧预览图上左右滑动 来切换幻灯片。5. 安全等级每个文档都可以设置两种访问方式：公开：任何人可以访问并预览，适用于公开文档私有：只能通过会话ID预览，会话过期后就需要重新获取预览会话ID,该预览方式适用于 私有文档6. 浏览器兼容在线文档预览兼容主流浏览器，如：Chrome浏览器（推荐）、IE8及以上版本、火狐浏览器、 Safari浏览器、360浏览器、Opera浏览器、搜狗浏览器等。7. 适应不同终端文档预览采用响应式设计，在不同的终端（如笔记本、平板电脑或手机等）上预览时，文档 会自动调整页而布局达到最佳效果。例如：在预览ppt或pptx文档时，手机、
5、平板和电脑 预览效果不同，左侧缩略图只在电脑或平板预览时生效，在屏幕较小的手机端则隐藏缩略图, 但会出现手机端专有的页而选择器来定位页而。8. 加载优化doc, docx和txt文档预览按需获取、分页加载，减少服务器、带宽和终端压力：ppt. pptx预览时，左侧缩略图每张大约5k,假如有20页的PPT,所有缩略图总和也只有100k 左右，右侧一张大图60k左右，初次页面加载图片总量只有160k左右，大大减少服务器、 带宽和终端压力，手机端预览更是隐藏缩略图，大大节省网络流量。9.易扩展对于非默认预览格式的文件，提供方便的扩展方式以供客户自定义预览页而。10.集群部署对于高并发环境，可方便地进
6、行集群部署，并可线性扩展。第三章、系统架构1. 单机版架构I Doc View在线文档预览服务所需软件分为两类：1. 私有软件：包括“在线文档预览服务WEB应用”和“在线文档预览转换器”，这两种软 件的获取与授权详情请联系I Doc View客服；2. 公有软件：公有软件为I Doc View在线文档预览服务正常运行所需的其他软件，大部分开 源免费，根据自己实际情况从其官网获取，也可从I Doc View提供的统一下载地址来获取。图中绿色部分为私有软件。2. 集群版架构预览流程：1. 用户通过第三方应用系统（以下简称“应用系统”）将所有文件上传到“分布式云存储” （或者现有的文件存储系统），并
7、在应用系统中记录文件基本信息如文件名、大小、MD5、下载链接等：2. 用户需要预览上传的文件时，应用系统在预览链接后而添加文件MD5值参数（或文档唯 一标识uuid,或者应用系统为文档生成的唯一 ID等，后续用作一致性哈希），预览链接格 式如：&naiiie=&md5=或者：?uuid= （这种方式需要在卜-而的Nguix配置中修改$arg_md5为SaTg_uuid）:3. 用户点击预览链接时候，访问请求到达代理层。代理层有两台互为热备的基于Linux系 统的Ngmx代理（图中N1和N2）, Ngrnx配置示例：upstream docdew_backend_cluster hash Sar
8、g_md5 consistent;server docviewl;server doc vie w2;server docview3: sen er (server_name ;location / (proxy_pass http:dociew_backend_cluster:参考：以上配置中，$arg_md5为预览链接中的MD5参数值（可为其他参数如uwd、文件唯一标识 id等），Ngmx根据该参数值做一致性哈希，将预览请求分发给服务层的后端Tomcat预览服 务 docviewl, dociew2 或 docview3 （对应图中 Tl,T2 或 T3）；4. 服务层的Tomcat预览服
9、务接收到请求后，首先根据NID5值判断是否成功预览过相同 MD5的文件，如果预览过，则直接展示给用户，否则，根据url参数再次判断是否预览过相 同链接的文档（可配置），如果预览过则直接展示给用户，否则，预览服务根据ml参数去 分布式云存储中获取原始文档，并在存储层的数据库和磁盘中分别存储文件元数据和文件实 体，然后做转换处理，如果转换成功则直接预览，如果转换失败则提示失败信恩。说明a）.文件存储：所有文件均统一存储在分布式云存储或己有的文件存储系统中；b）.有效转换：因为预览链接中有文件MD5参数（或uuid、应用系统文件唯一标识ID等）， 代理层的Ngrnx做一致性哈希，每次都会将同一个文件
10、的预览请求分发到相同的后端预览服 务，避免重复转换：c）.线性扩展：当预览服务器宕机时，Ngmx会自动探测并摘除，当预览服务器需要扩展时， 只需要水平扩展添加预览服务器即可，不管是摘除或添加预览服务器，根据一致性哈希原理, 只会影响少量数据的自动调整，保证整体预览集群的稳定高速：d）.高可用性：代理层的两台Ngmx做了双击热备做到高可用，后端预览服务宕机会被Ngmx 自动感知并临时摘除，落到宕机服务器的请求会自动分发到附近预览服务器。任何服务器的 宕机都不会影响整个预览服务：e）.清理数据：当预览服务器的磁盘空间不足时，可以开启自动删除旧数据功能，只保留X 天的数据，具体配置参见预览服务配置文
11、件。第四章、接入方式方式1:普通接入如果原始文档需要用户先上传，然后再预览，可以使用该接入方式。接入时，可以先调用预览服务的上传接口：该上传接口可以同时支持本地文档上传（file）参数和互联网文档上传（url）,但两个参数必 须选择其一。详细说明参见接口文档。上传后，预览服务会返回文档的唯一标识uuid,可以将此uuid存入您的数据库，之后的预 览和其他操作需要传入该参数。预览的时候，可以调用预览接口：其中，就是调用上传接口返回的uuid。方式2：互联网文档接入如果您的应用系统中己经有文档的“下载”链接，需要在旁边添加“预览”链接，可以直接 调用URL预览接口，而不需要调用上传接口。注意：该下
12、载链接可以被预览服务器直接（不 需要登录）访问到。URL预览接口如下：&name=可选文件名其中，是您文档的下载url,需要进行URLEncode编码，如果您使用Java 语言，可以使用.e（”文档下载链接,UTF-8）;来生成编码url,如果您使用javascript,可以使用encodeURIComponent（，文档下载链接）；来生成编码urLname参数为需要显示的文件名。预览服务获取文件名方式如下：如果传入name参数，则以name参数为准：如果不传name参数，程序会自动从名称为Content-Disposition的header里获取filename 作为文件名：如果header
13、里获取不到filename,则根据文档的下载链接来截取文件名（如下载链接为 http:/*/,则自动获取文件名为），如果下载链接为动态链接，末尾不是“.docx （docx 可以是预览服务器支持的任何格式后缀）这样的形式，则获取文件名失败，返回失败信息。生成预览地址步骤示例：第1步：网络文档下载url为：第2步:Encode（UTF-8编码）后的URL为：http%3a%2f%.com%2fdata%2fdoc%2f%e5%9c%a8%e7%ba%bf%e6%96%87%e6%al%a3%e9%a2%84%e8%a7%88%e7%94%a8%e6%88%b7%e6%89%8b%e5%86%8c
14、.docx第3步：最终预览URL为：方式3：预览服务器文档接入如果原始文档在预览服务器的某个磁盘路径下，您也可以直接使用URL预览方式，无需调 用上传接口。调用接口跟预览网络文档接口相同：&name=可选文件名只是部分为Encode后的您预览服务器本地文档路径。注：为了安全起见，默认不允许直接预览服务器本机文件，可修改预览服务配置文件中的.ns 参数来取消限制生成预览地址步骤示例：a）本地文档路径：D:/测试目录/测试文件.txtb）本地文档路径URL：file:/D:/测试目录/测试文件.txtc）Encode（UTF-8编码）后的本地文档URL：file%3A%2F%2F%2FD%3A%2
15、F%E6%B5%8B%E8%AF%95+%E7%9B%AE%E5%BD%95%2F%E6%B5%8B%E8%AF%95+%E6%96%87%E4%BB%B6.txtd）最终预览URL为：+%E7%9B%AE%E5%BD%95%2F%E6%B5%8B%E8%AF%95+%E6%96%87%E4%BB%B6.txt如果原始文档存储在预览服务器上，建议使用该预览方式，服务器会直接读取本地文件，不 通过网络，速度更快。展示大部分情况下，第三方系统需要在自己的文档列表页的文档“下载”链接旁边添加“预览” 链接的方式来集成在线文档预览服务，这时候只需要在“下载”链接旁边添加如下代码：a href= target=_blank预览 其中，viewur
