BOS工具支持从本地服务器、远程服务器导入解决方案。解决方案本质上就是从对应的服务器复制相关文件到本地，它支持BOS工具启动、调试和常规二开等一系列操作，是现场进行问题排查和二次开发的主要手段。

I 从远程服务器导入

1.1启动BOS工具

         可以点击BOS工具的启动图标，或者从BOS工具安装目录下的BOSModular.bat文件进行启动

1.2切换视图

         切换至”金蝶BOS业务建模视图”

1.3进入”导入解决方案向导”

         在左侧”业务单元管理”面板处，右键点击空白处，选择”导入解决方案”，进入导入解决方案向导。在向导页面下方”父目录”文本框中选择解决方案的导入目录（一般为默认工作空间的目录即可）。

1.4选择解决方案来源

         选择”从远程服务器导入”，并输入远程服务器的ip地址和用户名、口令信息；

         当只需要GUI客户端模块时，只需要在”方案选择”中勾选”GUI开发”进行导入即可；

         如若需要WEB模块时，需要根据自己需求额外勾选”WEB应用开发”、”基于新门户WEB应用开发”、”基于旧门户WEB应用开发”模块（这些模块内容较多，导入耗时较长）。

         注意：导入解决方案，需要依赖管理控制台启动的BIM服务器的启动，且需要服务器电脑开放10166、10167、10168端口，必要时还需要关闭对应的计算机防火墙。

用户名和口令均为管理控制台上BIM页签中的用户名和口令（默认情况下，BIM服务器的用户名和密码都为admin）。

1.5选择账套信息

         账套信息为服务器数据中心的账套信息，此处可以采用默认的选项进行导入；

         （在导入之后，会有操作对所要使用的数据中心进行测试连接操作，此处可以忽略）

1.6导入解决方案

         在1.5步骤中点击”完成”，即开始导入解决方案。

         在导入过程中，下方的”更新解决方案”页签中可以看到正在运行中的导入解决方案任务，当任务状态变成”运行完成”后，即导入任务结束。

         注意：导入任务结束并不意味着解决方案导入成功，只是表示当前并没有正在运行中的导入解决方案任务。导入解决方案成功的标识是在左侧”业务单元管理”面板中出现对应的解决方案。（后续的常见问题中将写明常见的导入解决方案的问题）

II 从本地服务器导入

         从本地服务器导入功能，一般需要本机有安装eas服务，或者将服务器的server目录完整拷贝至本机电脑，然后再从本机进行导入(这将在后续的常见问题的篇幅中介绍)。

         从本地服务器导入的步骤中，前3个步骤和后两个步骤与从”远程服务器导入”中的1.1-1.3步骤和1.5-1.6步骤相同。

         即：1.1-1.3步骤 -> 2.4步骤(下文) -> 1.5-1.6步骤

2.4 选择解决方案来源

         解决方案来源选择”从本地服务器导入”，然后在本地服务器信息中，选择本地服务器的安装目录即可。

         当只需要GUI客户端模块时，只需要在”方案选择”中勾选”GUI开发”进行导入即可；

         如若需要WEB模块时，需要根据自身需求额外勾选”WEB应用开发”、”基于新门户WEB应用开发”、”基于旧门户WEB应用开发”模块（这些模块内容较多，导入耗时较长）。

III 常见问题

3.1 文件名存在中文或者特殊字符导致解决方案导入失败

         解决方案是从服务器导入服务器相关文件至本地，本质就是一个文件下载的过程。如果服务器上存在文件名中包含特殊字符、中文将导致文件下载失败，从而导致整个解决方案导入过程失败（服务器文件非常重要，缺少相关重要文件可能会导致整个解决方案无法使用，所以一旦发现某个相关文件导入异常，整个流程就会终止）。

         表象：如下图所示，在”更新解决方案”页签中显示相关导入解决方案的任务已经完成，但是左侧的”业务单元管理”中并没有出现导入的解决方案。且在”更新解决方案”页签中存在报错，一般报错会显示下载某个文件是异常，然后后面跟着一串无法识别的乱码文件名。比较常出现的文件夹一般都是在ctrlhome下方的部分业务文件中；

         解决方案：判定文件是否为服务器必备文件，可以根据报错目录，找到对应的服务器文件，备份后从服务器移除，然后再重新进行导入操作，直到导入完成。

3.2 未启动BIM服务

         当管理控制台没有启动BIM服务的时候，在选择了更新解决方案的方式之后，会提示”连接BIM服务器失败…”，这时候只需要启动管理控制台，并在BIM服务器页签中启动BIM服务即可。

3.3连接服务器异常

         如果服务器连接失败，或出现如下提示：

         解决方案：1）确认服务器ip地址是否可以正常访问并连接，是否有内外网区分；

         2）服务器电脑是否开放10166、10167、10168端口

         3）服务器是否开启了高强度的防火墙，尝试关闭后导入；

         如果上述方案都无法解决，可以选择将服务器的eas服务的server目录拷贝到本机，然后选择”从本地服务器导入”，服务安装目录即为拷贝的server目录即可。（这样有一个弊病，无法通过更新解决方案从服务器更新到最新的文件，需要手工进行更新）

3.4 本机无D盘

         在8.5及以前的版本中，解决方案缓存等文件是默认强制导入到d盘文件的，如果所在电脑没有d盘，也会出现下载文件失败的情况，这也会导致解决方案失败，这时候需要虚拟出一个d盘即可。

         解决方案：新建bat文件，在文件中编辑下述命令：

subst d: /d
subst d:C:software

         即将c盘的software文件夹映射成虚拟d盘；

         然后双击运行改bat文件即可。

知识帖子-BOS工具导入解决方案.docx