OBA 工具使用说明

随盘 Portal 版本:U9.V6.0

1. 操作指南

(注:这里针对常用的一些功能进行介绍)

1.1. 系统授权
OBA 工具在系统中加入了权限控制，使用前先在系统管理中赋予用户使用权后方可正常使
用。
系统管理-->>界面权限
选择角色，表单：OBA 数据导入导出
在表单权限页签设置“访问”为允许

如果需要对 OBA 页签上的具体的每个按钮操作进行控制，则在操作权限页签设置（默认为

全部操作都允许）
注意：
1）数据权限 OBA 受系统数据权限控制,即读取当前登录用户的数据权限，无须设置
2）portal 版本为 3.0 以前的权限设置，请分别找系统管理下的功能权限（对应上述的表单
权限）和动作权限（对应上述的操作权限）来设置

1.2. 登录
点击登录按钮登陆 U9 系统.
服务器地址输入 U9 登陆地址
选择组织,用户名和密码单击”登录”按钮进行登录
注意：登录时，系统如果提示更新版本的信息，一般都不要取消，否则登陆成功后，导致

OBA 的功能是不可用。

1.3. 使用模版库中的模版
U9 各档案单据已经提供了不少现成的模版可以直接使用
路径在 OBA 安装目录下 Data\Template\DataForm\New 文件中。
1.4. 自己设计模版
对 U9 数据结构理解相对深刻的的顾问，可以自己修改或者重新设计模版

1）添加 U9 数据源

单击”设计”按钮，在右侧出现如下设置框

选择添加，以查找“部门”对象为例，为当前 excel 文档添加一个新数据源

下一步，当数据为主子实体时，excel 是多表还是单表显示，一般选择单表模式即可

双击所需字段，自动绑定到 excel 中。
一般而言，必须字段包含行状态、业务主键中的相关字段，及其他业务必输字段
注意：设计模版一般由产品直接提供，允许专业人员进行设计

1.5. 数据编辑
（主要说明一下参照字段的编辑）
选中 excel 文文件中的字段进行数据值的输入，参照类型列可以通过表头的”参照”按钮参
照 U9 系统的值.
单击参照按钮选择所需要的值:
!

参照类型字段的设置
对于参照类型的字段，在属性对话框中可以做相应的设置
参照回写：设置回写到 excel 的字段，类似于界面参照返回
参照设置：可以设置参照显示的列和参照的过滤条件
（注意：此处设置的参照过滤条件将会在提交时作为向数据库验证数据存在性的条件）
参照手工录入时触发回写：指在输入参照对应的字段时，按照参照回写的设置去回写相应
的字段的值
自动值对应字段：如果 true ，系统根据匹配的参照选取编码段（一般情况下是 Code）；如
果为 false，预设为 ID，也可以根据客户的需求，使用者自己去选择自己想要的字段。
（注意：由于系统个别参照存在非 Code 字段作为编码段，如果发现参照返回不是 Code，
请手工设置一下）
支持特殊字符：因为在 portal 中由用户自己去设置特殊字符集，而 OBA 中为了避免该情况，
默认是不支持特殊字符的。如果设置为 True ，则支持输入特殊字符的输入（这里主要针对
英文状态输入发下的单引号的处理所引起的功能）。
1.6. 资料提交
当在 Excel 文档中编辑好你需要的数据后,修改”行状态”字段的值进行导入操作..

Update：修改当前数据,而不新增(指当前行数据在系统中已存在)
Insert：新增一条新的数据(指当前行数据在系统中并不存在)，这里一般把 ID 字段的值写为-
1,-2,-3….
Ignore：导入时忽略当前行数据而不参与导入操作
Delete：删除当前行数据(前提条件是系统中存在该条数据,删除规则遵循 U9 系统的删除规
则!)
（注意：删除和更行时查找数据的规则为，excel 中有 ID 根据 ID 查找，没有 ID 根据业务主
键查找，如果业务主键无法定位到或者定位到多条数据，可能更新或删除失败）
当所有数据准备完毕后，即可提交数据至 U9 系统. 单击提交数据，打开提交数据窗口
在提交数据可以预览数据:
提交成功有提交成功，及成功记录数的提示。
如果失败，可以查看错误信息，修改后重新提交

1.7. 数据导出
单击导出数据按钮导出当前实体数据
通过导出向导，可以设置导出条件，导出条数
1.8. 串行于并行提交数据
新版本中，支持 OBA 使用串行提交数据，OBA 默认开启并行。

串行：串行程序中，程序会顺序的执行每一条指令，在整个程序的运行过程中，仅存在
一个运行上下文。（OBA 货源单要求使用串行，在 OBA 提交后报死锁的错误，也请使用串
行功能提交）

并行：在多处理器上，可以同时有数个任务在处理数据。
1.9. 导入附件功能
在 OBA 设计面板中，增加了附件列，并且所有实体都可以看到该列。
 双击可以绑定到 Excel 单元格上，单元格值格式为：文件完整路径|文件完整路径 （文件
路径中包含完整文件名，“|”表示多个文件的分割符号，单文件只填写一个文件完整路径
即可）

示例：

上例中，表示上传两个文件到服务器，E 盘下面的 1.png 于 2.png。 1 个文件格式：E:\

1.png 3 个文件格式：E:\1.png|E:\2.png|E:\3.png 多文件以此类推。

注意：当前附件功能只支持导入，无论行状态是 Update 还是 Insert 还是 Delete，附件所

进行的动作都只会是 Insert。

附件功能与 U9 系统的附件功能保持一致，OBA 导入成功后，可在 U9 系统中查询到。单

次导入大小限制总共为 100MB，与 U9 系统保持一致。
2. 安装指南

2.1. 安装前提
确保客户端 office 为 32 位版本，否则安装程序会检测不到 office 安装路径。
使用 3.0 随盘的 OBA 安装盘，请确保服务器 portal 版本为 3.0 版本
如果客户端曾经安装过旧版本的 OBA，请确保旧版本卸载后，清理一下注册表
工具如下

2.2. 安装过程
安装 OBA 依赖程序
安装程序目录 DOTNETFX\dotnetfx351.exe（微软.netframework3.5SP1）
VSTOSERUNTIME\vstor_redist.exe（微软 VSTO2010runtime）
运行 OBA 安装程序
如果处于联网状态可以直接运行 setup.exe，可以自动下载安装 OBA 所依赖的微软补丁程序；
上步骤可以跳过。
如果不处于联网，运行 yonyou_u9_OBA_cn.exe 进行安装，上步骤不可省略
检查并安装完依赖项后，进入 OBA 的安装程序
因 为 office2007 是 相 对 比 较 旧 的 版 本 ， 需 要 打 一 些 微 软 专 用 补 丁 ， 如 果 确 实 需 要 在
office2007 上部署多用户，参见下节说明。

2.3. Win7 版本以上的操作系统需关闭 UAC

对于 win7 版本以上，winserver2008 版本以上的操作系统一般需要关闭系统 UAC 功能。
对于 win7 版本以上，winserver2008 版本以上的操作系统，请设置控制面板-用户账户-更改
用户账户控制设置，如下图，”用户账户控制设置”为最低，即”从不通知”，有可能需
要重启电脑。
确认当前用户有管理员权限。

2.4. 针对 office2007 的 OBA 多用户部署

非 office2007，或者即使是 office2007 但无需部署多用户的可以不看本章节

由于 office2007 已经相对比较老的 office 版本，针对插件部署需要打 office2007SP2 的补丁，

注意务必是 SP2 的补丁，微软官网下载下来的全名为 office2007sp2-kb953195-fullfile-zh-
cn.exe。
然后，打补丁 office-kb976477-fullfile-x86-glb.exe，在测试过程中，全新安装的新系统安装没
有问题，但是发现个别使用较长时间的 PC 可能无法成功更新这个补丁。
如果微软补丁更新不成功，则无法多用户部署。
如果更新成功，导入注册表键值

如果操作系统为 64 位导入

如果操作系统为 32 位导入
3. 常见问题

3.1. 不能加载用友页签
建议按以下步骤进行检查。
步骤一：卸载 OBA 后重新安装
卸载后注意使用 2.1 章节的工具进行注册表清理一下

步骤二：检查 OBA 是否被列出禁用项目

在下图步骤 3 中如果 OBA 程序被禁用，选中启用即可

步骤三：检查 COM 加载项加载状态

步骤如下
弹出 COM 加载项的框，如下

1） 查看是否加载，如果没有加载，勾上 OBA 加载项，点击确定，再次加载后看看结果；

2） 确保位置所在的 vsto 文件在本地 PC 上存在，如果不存在则可能安装程序有问题。
3） 查看加载结果，如果加载结果为” 已卸载”，请回顾前面安装过程中是否 office 为
2007 且配置为多用户了，或者没有启用加载项

步骤四：运行时管理员权限
如果为 win7，server2008 以上操作系统，可以尝试赋予执行时管理员权限。但是根据部分
反馈结果，有时会导致双击 excel 文件发生“向程序发送命令失败”的错误，但是并不是所
有都存在此问题，可能是 office 补丁不齐全。
以 office2007 为例，设置步骤如下在 Program Files\Microsoft Office\Office12，找到对应的
EXCEL.EXE，右键属性，选择兼容性-->>选择”以管理员身份运行此程序”

3.2. 料品参照返回品名，而不是料号（参照返回设置）
现象：料品参照返回品名，而不是料号，并且原来设置的参照关联带值功能没有了。
原因：OBA 参照是到系统参照元数据中查找一条符合条件的第一条记录，并且根据该参照
元数据定义设置当前 OBA 参照的过滤条件、返回值等。通常情况下，系统参照都以 Code
作为编码段，但是个别料品参照的编码段设置成了 Name，并且刚好被选中作为 OBA 参照。
解决方案：设置参照列属性“自动选择值对应字段”为 false，并选择“值对应字段”为
Code

（其他非料品参照，如果有类似返回值不对的现象，同理。）

3.3. 关于跨组织参照使用的注意事项
问题背景：OBA 当前登录到 A 组织，但某些字段却想参照 B 组织的数据，无法通过参照方
式选择。
问题分析：OBA 的参照无法做到与 UI 参照完全一样的效果，UI 参照可以进行很多关联赋值，
定义各种入口参数，甚至在代码中修改参照过滤条件，以上都是 OBA 参照无法做到的。
解决方案：
1）找到该存储地点的组织属性，并拖拽出来，选择成目标组织；
2）不用头上的参照功能，手工输入目标组织的存储地点的编码
以下是关于“存储地点”跨组织选择的操作步骤截图

3.4. 特殊字符无法导入
检查该列属性是否设置为支持特殊字符，提交时提示检查时，确定。