11993-2019金蝶国际软件集团有限公司④内部公开请勿外传詹泽铨2020年8月1993-2018金蝶国际软件集团有限公司金蝶云星空BOS专题中级课文件服务2Content010203文件服务总体介绍文件服务配置及应用文件服务接口文件服务工具及常见问题04答疑053Content010203文件服务总体介绍文件服务配置及应用文件服务接口文件服务工具及常见问题04答疑054文件服务：整体结构5文件服务：执行流程图6Content010203文件服务总体介绍文件服务配置及应用文件服务接口文件服务工具及常见问题04答疑057文件服务实例8文件服务实例：文件服务器9文件服务器：相关控件、字段控件、字段名称功能说明附件数统计所在实体附件列表的附件数附件列表可见附件列表直接嵌入到单据详情界面附件(文件服务器)用以存储附件到当前启用的文件服务实例图片(文件服务器)用于表头直接展示图片，可预览原图单据体图片字段(文件服务器)用于表体直接展示图片，可预览原图文件上传用于服务端需要操作前端上传文件的场景图片控件展示固定的一些Logo图片，也可二开动态设置10附件数11附件列表12文件服务器：相关控件、字段131、通用控件，可放表头。2、用于展示固定的一些Logo图片，也可二开插件动态设置。3、小技巧：结合Tips属性给出部分字段或功能的提示信息。4、属性：图标键、Tips、SourceUrl。图片控件141、通用控件，可放表头。2、用于服务端需要拿到客户端上传文件的场景，如引入单据。3、需要配合表单插件使用，才可实现高度自定义的需求。4、属性：文件最大大小(单位KB)、允许多选、过滤条件。文件上传15案例演示演练单据：采购订单演练场景：拖文件上传通用控件，限制只允许上传txt文件，二开插件读取上传的内容并展示在单据上。演练内容：学习使用文件上传通用控件，读取上传内容。16select*fromT_BAS_FileServerFileInfo;select*fromT_BAS_Attachment;select*fromT_BAS_FileServerInfo;文件服务器：相关表格17亚马逊云存储：1、对接AmazonS3云存储服务，物理文件存放亚马逊服务器。2、注册亚马逊账号，只需输入可用区、存储桶、密钥等信息，即可直接使用。3、目前公有云用户统一使用亚马逊云存储，不需要用户额外配置。文件服务实例：亚马逊云存储18数据库：1、物理文件存储于数据库下，具体位置是T_BAS_Attachment附件信息表的FAttachment字段。2、长时间使用会导致数据库占用空间过大，因此不推荐使用。3、对已上传的数据库附件，可使用附件万能迁移工具迁移至其他存储方式。文件服务实例：数据库19数据库：相关字段字段名称功能说明上传文件字段物理文件及相关文件信息直接存储于数据库字段下图片字段用于表头直接展示图片，图片内容存储数据库字段下20对接第三方文件服务实例：1、可将一个第三方的文件服务实例集成到金蝶云星空下。2、自定义自己的文件服务实例，自由度最高。3、指导帖子：https://vip.kingdee.com/article/42558409972318208文件服务实例：对接第三方文件服务实例21在线预览服务默认在线预览服务本地文件服务预览对接第三方预览服务服务器安装Office软件需要不需要不需要客户端安装Flash插件需要不需要不需要客户端安装Office软件不需要需要不需要支持预览格式常见Office所有格式常见Office支持特殊字体不支持支持支持支持移动端不支持不支持支持是否免费免费免费付费22默认在线预览服务：1、要求文件服务器安装MSOffice201032位软件，配置DCOM，设置受信任目录及目录权限等。2、要求客户端安装AdobeFlashPlayerforIE软件。3、详情参见：https://vip.kingdee.com/article/13138在线预览服务：默认在线预览服务23本地文件服务预览：1、点击在线预览，自动下载文件至本地并打开。2、只要本地有安装相应的应用程序，不限制预览文件类型，目前主推的预览方式。3、具有缓存预览文件及定时自动清理的机制。4、详情参见：https://vip.kingdee.com/article/182406在线预览服务：本地文件服务预览24对接第三方预览服务：1、可将OfficeWeb365第三方预览服务集成到金蝶云星空下。2、支持桌面端及移动端。3、详情参见：https://vip.kingdee.com/article/66201968754138880在线预览服务：对接第三方预览服务25Content010203文件服务总体介绍文件服务配置及应用文件服务接口文件服务工具及常见问题04答疑0526文件服务接口27文件服务接口：WebApi方式28上传接口：协议://应用服务器IP:端口/k3cloud/FileUpLoadServices/FileService.svc/upload2attachment/?fileName={fileName}&fileId={fileId}&token={token}&last={last}具体参数：1、FileName：文件名。2、FileId：文件内码，首次上传传递空，分块上传传递返回的内码值，用以标识分块。3、Token：用户登录标识。4、Last：是否最后一次上传。WebApi方式：上传29下载接口：协议://应用服务器IP:端口/k3cloud/FileUpLoadServices/Download.aspx?fileId={fileId}&token={token}&nail={nail}具体参数：1、FileId：文件内码。2、Token：用户登录标识。3、Nail：是否下载缩略图，1为缩略图，其余为原图。WebApi方式：下载30删除接口：协议://应用服务器IP:端口/k3cloud/FileUpLoadServices/FileService.svc/delete/?fileId={fileId}&token={token}具体参数：1、FileId：文件内码。2、Token：用户登录标识。WebApi方式：删除31案例演示演练单据：采购订单演练场景：<1>开发一个程序，本地以单据编号作为文件夹，上传文件夹下所有附件到对应单据的附件列表上。<2>开发一个程序，输入单据编号，下载特定单据下所有附件到本地。演练内容：<1>学习WebApi方式的附件上传接口，附件信息关联单据。<2>学习WebApi方式的附件下载接口。32文件服务接口：二开插件方式33上传接口：Kingdee.BOS.FileServer.ProxyService.UpDownloadService.Upload(TFileInfofile)具体参数：1、FileId：文件内码，首次上传传递空，分块上传传递返回的内码值，用以标识分块。2、FileName：文件名。3、CTX：用户登录上下文。4、Last：是否最后一次上传。5、Stream：待上传文件的文件流。二开插件方式：上传34下载接口：Kingdee.BOS.FileServer.ProxyService.UpDownloadService.Download(TFileInfotFile)Kingdee.BOS.FileServer.ProxyService.UpDownloadService.GetFileData(TFileInfotFile)Kingdee.BOS.FileServer.ProxyService.UpDownloadService.GetFileByPart(TFileInfotFile)Kingdee.BOS.FileServer.ProxyService.UpDownloadService.DownloadSaveLocal(TFileInfotFile)具体参数：1、FileId：文件内码。2、CTX：用户登录上下文。3、Nail：图片下载时标识是否下载缩略图，为1代表缩略图，其余为原图，默认下载缩略图。4、StartIndex：为读取下载文件的起始位置。5、FilePath：应用服务器保存文件的路径。二开插件方式：下载35删除接口：Kingdee.BOS.FileServer.ProxyService.UpDownloadService.Delete(TFileInfofile)具体参数：1、FileId：文件内码。2、CTX：用户登录上下文。二开插件方式：删除36案例演示演练单据：采购订单演练场景：二开插件，下载指定文件到应用服务器，读取文件内容并展示到单据上。演练内容：学习面向二开插件方式的附件下载接口，操作附件内容。37Content010203文件服务总体介绍文件服务配置及应用文件服务接口文件服务工具及常见问题04答疑0538文件服务工具及常见问题39文件服务工具40文件服务器环境检测：1、一键检测，定位问题生成方案，将运行时错误，结束在一开始配置时。2、自定义的多种检测项，包括管理中心跟数据库连接、组件版本、Office安装情况及DCOM配置等。文件服务工具：文件服务器环境检测411、可实现任意存储方式之间互相迁移，灵活高效。迁移过程可溯源，失败数据可恢复，安全可控。2、相关帖子：<1>附件万能迁移工具使用指南：https://vip.kingdee.com/article/11703<2>公有云环境迁移到私有云，附件映射指南：https://vip.kingdee.com/article/170338<3>不同文件服务器之间的附件迁移：https://vip.kingdee.com/article/13483<4>文件服务器存储目录迁移方法：https://vip.kingdee.com/article/12969文件服务工具：附件万能迁移工具42附件数升级：1、附件数字段可以统计所在实体的附件列表挂了多少个附件。2、若先上传了附件后才拖的附件数字段，会存在不一致问题，可使用附件数升级工具。3、选择需要进行附件数升级的单据或者基础资料，点击升级即可一键修复。文件服务工具：附件数升级43常见问题44现象：点击在线预览失败，或者提示正在重新转换。1、DCOM配置有误，安全页签设置权限，标识页签设置交互式或用户名密码。2、上传目录、存储目录添加受信任位置。3、要求文件服务器历史没有安装过其他Office软件。4、客户端安装AdobeFlashPlayerforIE软件。5、详情参见：https://vip.kingdee.com/article/13138常见问题：在线预览失败45现象：单据上传了附件，结果附件却找不到了。1、附件菜单绑定的操作有附件管理操作、单据体附件管理操作，要区分开。2、单据列表的附件菜单看到的是单据头上的附件。3、单据体挂附件操作时，每行分录都有自己的附件，是分隔开的。常见问题：绑定附件管理操作有误46现象：文件服务器检测或附件相关操作报404NotFound错误。1、检查使用的协议与配置是否不匹配导致。2、文件服务器、应用服务器内存占用超过百分之九十五。3、应用服务器文件服务器组件版本不一致，或文件服务器存在文件丢失情况。4、WCF安装不全导致。5、排查步骤详情参见：https://vip.kingdee.com/article/12964常见问题：附件操作报404NotFound错误47现象：文件服务器检测或者附件相关操作报500错误。1、文件服务器、应用服务器内存占用超过百分之九十五。2、文件服务器组件冲突，或配置文件有误。3、排查步骤详情参见：https://vip.kingdee.com/article/12965常见问题：附件操作报500错误48Content010203文件服务总体介绍文件服务配置及应用文件服务接口文件服务工具及常见问题04答疑0549Thanksterimakasih感謝谢谢ありがとうขอบคุ ณ1993-2019金蝶国际软件集团有限公司
