【熊说星空】基础管理：文件服务器配置及常见问题2021.08（直播复盘笔记）

主讲老师：陈北春（金蝶总部技术支持）

课程链接：金蝶云星空文件服务器配置及常见问题

上课时间：2021.08.05 19:00 - 20:00

主要内容：

1、了解文件服务五种存储方式

2、学习如何安装及配置文件服务器

3、学习四种附件预览方式及配置方法

4、常见问题处理

其它：

小熊补充的论坛中我自己写的帖子和别人的解决办法

另外我自己遇到的主要是电子回单附件这一块的问题，相关解决办法也附在最后。

一、文件服务器安装及配置

（一）文件服务器是用来干什么的

存储附件（单据附件、基础资料附件）

单据上的附件的位置：

• 附件列表

• 单据头或体的附件控件上

• 上传文件字段

（二）存储方式：总共五种

文件服务几种存储方式的整体介绍 (kingdee.com)

• （1）线下私有云：建议使用文件服务器，不建议使用默认的数据库存储方式（目前数据库存储方式，仅图片类型文件支持在线预览，其他类型的文件，目前都不支持在线预览。）

• （2）公有云的亚马逊云存储统一由金蝶总部运维配置

• （3）关于数据库存储的疑难点可参考文章：如果文件比较大，会影响数据库的性能。excel文件无法在线预览，报错此文件存储位置为数据库，暂不支持在线预览，但是图片是可以的 (kingdee.com)

• （4）金蝶云存储：个人云存储的服务已停止无法使用，企业云存储有用到的企业也不多

• （5）对接第三方文件服务实例：文件服务.二开案例.第三方文件服务集成至金蝶云星空 (kingdee.com)

（三）文件服务执行流程图

针对私有云部署文件服务器，不需要外网地址，客户端不需要直接连接文件服务器。

（四）文件服务器安装

【分享】K3 Cloud文件服务器配置指南 (kingdee.com)

金蝶云星空文件服务器部署，包含以下两种情况：

Q&A：

1. 针对于分开部署：因为未勾选【管理站点】，下一步的时候需要连接管理中心配置。

   
   

2. 针对于部署在一起：如果一开始安装时未勾选文件服务器，等星空应用服务器都安装好了才想起来需要安装文件服务器怎么办？需要在应用服务器上使用批处理文件，安装文件服务器，请下载压缩包InstallFS.zip（见本文章附件），并在应用服务器所在服务器解压，参照压缩包内的使用说明（或参见下图，红圈和黄色的部分时需要根据目前星空安装包和安装目录中的文件更新的，否则执行批处理时会提示某文件找不到），运行批处理文件，安装文件服务器。可以通过网址测试文件服务器是否部署正常。

   如何测试文件服务器已安装，可参考文章中解答（【熊说星空】文件服务器连接异常：请检查地址及端口等配置是否正确，远程服务器返回错误404未找到 (kingdee.com)）第二部分中的前提事项确认：文件服务器是否已部署、是否部署正常

（五）文件服务器与应用服务器分开部署配置

Step01：修改文件服务器上{安装目录}\WebSite\App_Data\Common.config及WebSite\App_Data\Common.config文件中的<add key="managementSiteUrl"value="http://{MC的IP}:8000"/>

Step02：修改管理中心上{安装目录}\ManageSite\App_Data\KDEnvironment.xml文件中

加下述行<WebServer HostName= "fileserver的IP" Type="All" />

需要注意事项：

应用服务器与文件服务器版本必须一致，如果不一致，需要对文件服务器安装补丁，另外需要开放管理中心/应用服务器的8000、8088/8087端口和文件服务器的8088/8087及IIS端口，或者关闭两者的防火墙，否则安装补丁时选择不到文件服务器站点。

（六）文件服务器设置

Step01：使用administrator登录星空，打开基础管理-公共设置-文件服务设置，选择文件服务器，点设置按钮

Step02：打开文件服务器列表，点击新增

上述参数填完后，需要保存，只有保存成功后才可以设置存储目录。

Step03：新增附件存储目录，必须先在文件服务器上建立存储目录，并授予该目录用户NetWord Service读写权限，且须先启用文件服务器。

填入路径格式：D:\CloudFiles支持设置多个路径，但只有一个默认存储路径，作为文件存储目录。

当设置了一个默认路径后，其它默认路径会被取消。

Step04：配置好后使用检测文件服务器是否可用进行一个全面的检测，检测完成后会给出检测结果，检测不通过的项，根据提示信息进行逐一配置。然后可以测试附件的新增、下载是否正常。

其中9、10检测不通过，不影响附件上传下载，只影响flash及PDF预览方式在线预览

其中2检测不通过，可参考文章【熊说星空】文件服务器连接异常：请检查地址及端口等配置是否正确，远程服务器返回错误404未找到 (kingdee.com)

二、四种附件预览方式介绍

附件在线预览支持几种预览方式 (kingdee.com)

截止金蝶云星空7.7.0.202106版本（直播课程时间为20210805）

一共有4种附件预览方式，在参数设置-BOS平台-文件服务参数中可以设置：

1. 使用flash方式预览（星空最早的方式，将源文件转换生成Flash文件进行预览，要求客户端本地安装flash插件。）

   （1）文件服务器上需要安装office2010 32位，预览附件的电脑需要安装flash插件（客户端环境需要安装adobe flash player才能在线预览文件。安装的是：Adobe_Flash_Player_For_IE_ActiveX插件）。

   （2）由于安全问题，Adobe公司已停止更新flash，微软也已发文windows系统默认不再支持flash，所以该种预览方式可能出现因flash无法加载，导致预览失败。该种预览方式已不推荐。

   （3）如需配置，相关配置方法可以参考：金蝶云星空-文件服务器配置指南 (kingdee.com)中的文件服务器DCOM配置说明（或者本文章附件也放了直播老师讲的录屏）

   （4）注意：如果存在首次上传文件转换失败的情况，在线预览时需要进行二次转换，或者可以重新上传文件才可以正常转换，文件的第二次转换则需要应用服务器也安装office2010 32位（针对应用服务器和文件服务器分开部署的情况）。此处是我在做笔记的时候不知道怎样会遇到这个问题和怎么解决，具体还得待实战。

   （5）报错示例：Fi提醒，就是配置有问题的。

   
   

2. 使用PDF方式预览：该预览方式需要文件服务器上安装office2010 32位，需要与flash在线预览相同的配置和部署，但客户端不需要安装flash。具体介绍可参考星空附件预览：附件支持PDF方式预览 (kingdee.com)

   （1）office配置请参考：金蝶云星空-文件服务器配置指南 (kingdee.com)中的文件服务器DCOM配置说明（或者本文章附件也放了直播老师讲的录屏）

   （2）注意

   ①使用pdf方式预览仅支持文件服务器存储附件，云存储附件因为无法部署office暂不支持

   ②如果存在首次上传文件转换失败的情况，在线预览时需要进行二次转换，或者可以重新上传文件才可以正常转换，文件的第二次转换则需要应用服务器安装office2010 32位，如果需要可安装。

   ③客户端pdf方式预览，需要客户端操作系统安装IE11及以上版本才可以，因为pdf预览用了IE浏览器的内核。如果用浏览器pdf预览，则没有这个要求。

   如果环境之前用的是flash方式预览，后面转为pdf方式预览，可以在数据库中执行：UPDATE T_BAS_FileServerFileInfo SET FSWFLOCATIONPATH = '' WHERE 1 = 1；（执行前可以先备份一下T_BAS_FileServerFileInfo表格），这样之前上传的附件就可以以PDF方式预览了。此处是我在做笔记的时候不知道怎样会遇到这个问题和怎么解决，具体还得待实战。

3. 使用本地文件服务预览：文件服务器附件本地预览 (kingdee.com)

   （1）附件存储在文件服务器，启用本地文件服务预览，将下载文件至客户端本地进行预览。

   支持使用客户端本地软件来预览附件，例如在线预览word文档，只需客户端安装有office即可。

   （2）勾选支持图片时：将下载图片至客户端本地进行预览。不勾的话图片默认在线预览。

   （3）配置方法

   Step01：管理员administator登陆，打开参数设置-基础管理-BOS平台下的参数：使用本地文件服务器预览

   Step02：管理员administator登陆，打开文件服务器配置，打开附件测试功能新增附件，例如选择一个excel文档，点击在线预览，此时弹出本地服务安装界面，点击下载并安装。

   Step03：安装好本地服务后，再次点击在线预览，文件会正常打开Excel。

4. 使用第三方预览服务：如对接OfficeWeb365方式预览

   文件服务.新增特性.金蝶云星空对接OfficeWeb365第三方预览服务 (kingdee.com)【预览效果可见此处】

   T