【EAS Cloud+其他】操作手册

EAS Cloud+其他

1.1.1 功能概述

EAS Cloud+其他模块主要针对EAS Cloud和其他非EAS Cloud系统之间的数据集成以及基础资料同步，共包括9个三级菜单，涵盖的内容可分为三大部分：单据集成、报表集成，基础资料同步。相对比EAS Cloud+K3Wise和EAS Cloud+EAS Cloud两个模块，EAS Cloud+其他模块中的配置更具有通用性和广泛性。

1.1.2 通用配置

1.1.2.1 数据中心管理

主要功能：

指定要连接的数据中心，方便后面取数或者同步所用。

1、 从路径“EAS Cloud+其他->通用配置->数据中心管理”进入数据中心连接主界面，如下图所示：

该界面上主要字段的说明：

（1） 左树：可新增左树分组类别，也可以移动节点；

（2） 包含下级节点：包含所有分组类别的数据库连接；

（3） 连接测试：检查新增数据连接的正确性，错误时会提示连接失败。

2、 点击新增按钮，弹出新增界面，如下图所示：

该界面上主要字段的说明：

（1） 编码：当前连接的编号，在新建时手工填写；

（2） 名称：当前连接的名称，在新建时手工填写；

（3） 数据库类型：源系统数据库的数据库类型。目前可以支持的有：SQLSERVER、DB2、ORACLE等；

（4） IP地址：源系统数据库所在机器的IP地址；

（5） 数据库名：源系统数据库的实体名；

（6） 用户名、密码：要连接的第三方数据库的用户名、密码。

3、 保存前请先进行连接测试，确认维护信息正确后再保存。

4、 查看许可占用：点击该按钮可进入集成许可占用明细页面，统计当前数据中心下所有的IP地址，列表数据按IP+端口+数据库名称进行去重过滤展示

1.1.2.2 客户端代理管理

在讲解客户端代理管理之前，先讲解一个概念“客户端Agent”.

客户端Agent的主要功能：

客户端Agent的功能是在客户端（一般会放置在第三方数据库所在机器）执行指令并反馈执行结果给EAS Cloud服务器。

可以直接将Agent文件拷贝到某台能够直接访问第三方数据库的机器上，放到一个没有空格的路径下，然后打开Agent文件夹找到agent\eip_agent\start.bat文件，双击即可打开客户端Agent配置界面。

另外，启用Agent需要有JDK文件，由于JDK文件比较大所以没放到agent文件中，可以自行下载或拷贝JDK文件放到agent文件夹中。

需要对Agent进行相关信息设置，以便Agent与服务端成功建立连接，需要配置的内容包括：本地服务管理、网络配置、用户配置、源系统数据库，此外还提供可客户端日志查看功能。

Agent文件不在补丁包里面，下载地址：http://web20.kingdee.com/share/# ，集成平台--AGENT。

Agent可以自动更新（在网络通畅的情况下）。

详细如下：

1、 本地服务管理：启用、停用Agent服务。界面如下：

（1） 启动服务：网络、用户、源系统数据库等配置完成后，点击该按钮启动Agent服务，如果网络、用户、源系统数据库中的任意一项没有配置完整，则会弹出提示且无法成功启动；

（2） 轮询频率：Agent访问服务端获取任务的频率。在此不可以修改频率，默认为180秒，仅在服务端可以修改该频率。

2、 网络配置：配置服务器相关信息以及网络代理。界面如下：

（1） 协议类型为HTTP（目前仅提供了这一种，以后会提供HTTPS）；

（2） 服务器地址、服务器端口用于指定目标系统的信息；

（3） 当“使用代理”复选框被勾选时，可以设置网络代理的地址、端口、用户名、密码；

（4） 配置完成后点击“网络测试”进行网络测试。

3、 上级EAS Cloud用户及数据库配置：配置Agent连接到EAS Cloud服务器时使用的用户名和密码等。界面如下：

（1） 用户账号、用户密码：客户端Agent连接EAS Cloud服务器时需要用的用户信息，该用户必须是EAS Cloud服务器中的用户。每个客户端Agent对应一套用户名和密码，以便在连接到服务端之后可以正确获取该客户端Agent需要执行的任务；

（2） 服务端数据中心：点击“服务端数据中心”的下拉列表时（弹开时），客户端从服务端获取最新的数据中心信息并列在下拉列表中，可以从中选择目标数据中心。

4、 本地数据库：配置源系统数据库相关信息。界面如下：

（1） 数据库类型：选择源系统数据库类型，可选的是Oracle、SQLServer、DB2数据库三种类型；

（2） 数据库名称：填写源系统数据库实体名称；

（3） IP地址、端口：源系统数据库的IP地址及端口；

（4） 用户名、密码：访问源系统数据库的用户名和密码。

5、 查看日志：启用后可查看客户端日志。界面如下：

重点字段说明：

（1） 查看日志时，点击“刷新列表”更新日志列表；

（2） 可以选择对应的日志文件进行查看。

以下内容将正式进入客户端代理管理模块。

主要功能：

列示曾经访问过当前EAS Cloud服务器的客户端Agent用户。

1、 从路径“EAS Cloud+其他->通用配置->客户端代理管理”进入客户端代理管理界面，如下图所示：

2、 点击界面上的“修改”按钮可以打开编辑界面。如下图所示：

该界面重要字段的说明如下：

（1） 只有轮询频率、描述这2个字段可以支持编辑，其余字段内容均从客户端获取不可修改；

（2） 轮询频率：设置客户端Agent定期访问EAS Cloud服务器的频率。

1.1.2.3 任务管理

主要功能：

列示所有客户端Agent已执行和待执行的任务。

1、 从路径“EAS Cloud+其他->通用配置->任务管理”进入任务管理的主界面，如下图所示：

2、 选择一条点击编辑按钮，出现编辑界面，如下图所示：

说明：只有下达时间可以支持编辑，其余字段内容均由系统自动填写不可修改。

1.1.3 基础资料集成—外发配置

1.1.3.1 基础资料集成配置

主要功能：

针对新上线的客户，使用凭证集成方案，将源系统A中的基础资料同步到目标系统B中。

1、 从路径“EAS Cloud+其他->基础资料集成-外发配置->基础资料集成配置”双击进入基础资料集成配置主界面中，如下图所示：

该界面为左树右边模式，主要字段说明如下：

（1） 左树：可以新增方案类别，如币别，值映射；

（2） 右表：显示具体方案；

（3） 启用：新增方案成功后，点击启用才能进行同步，立即执行按钮点亮；

（4） 禁用：选择禁用后，立即执行按钮置灰，将无法进行同步；

（5） 立即执行：点击立即执行，选择目标数据中心进行同步；

（6） 调度策略：采用自动执行的方式进行基础资料，按照执行频率查询同步任务。举例如下：

（7） 引出：基础资料同步方案引出保存成文件方式；

（8） 引入：将文件形式的方案引入EAS Cloud中，可直接使用。

2、 点击新增按钮，询问新增单一方案或组合方案，此处以币别单一方案为例，弹出方案新增的界面，如下图所示：

该界面上重要字段说明：

（1） 编码：用户手动写入，为此方案的编码，方便查询所用；

（2） 实现类：提供给用户自定义的开放接口；

（3） 备注：对方案的简单描述和文字说明；

（4） 新增方案：点击此按钮，弹出从本系统数据库获取的全部表，如下图：

（5） 主表：在所选表中选择一个作为主表，其余为从表；

（6） 主键：新增表时，主键默认为FID字段；

（7） 新增同步：选择字段勾选新增同步，进行新增同步时仅更新所选字段，未选择的字段不会进行同步，默认全选；

（8） 更新同步：选择字段勾选更新同步，进行更新同步时仅更新所选字段，未选择字段不进行更新同步，默认全选；

（9） 时间戳：主表的时间戳默认勾选FLastUpdatetime,即为最后更新时间，进行更新操作时将会记录时间在日志中；

（10） 关联关系：若存在主表和从表时，需设置表之间的关联关系，此处用值映射举例，如下图：

（11） 过滤条件：方案为通用，若同步一条数据时，需写入过滤条件，举例值映射方案的过滤条件where fid = '8r0AAAAD1c7ecRLc'；

（12） 前置脚本：若本系统与目标系统中含有相同定义的基础资料，则需写入前置脚本再进行同步，否则会同步失败，以币别前置脚本为例：

[{"selfSQL" : "select fid code, (fnumber || '_' || fname_l2) value, fnumber, fname_l2

from t_bd_currency where [fid = {fid}]"},{"oppSQL" : "select fid code,

(fnumber || '_' || fname_l2) value from t_bd_currency where [fnumber = {fnumber}

 and fname_l2 = {fname_l2}]"},{"value":"fnumber,fname_l2"}]；

（13） 描述：对本方案的文字说明；

（14） 发布：保存成功后才能点击发布按钮，方案发布，已发布勾选上。

3、 方案创建好之后，点击立即同步，弹出同步窗口，如下图：

（1） 新增同步：选择新增同步，检测本系统有新增数据，将会成功同步到目标系统中；

（2） 更新同步：检测新增同步的数据有更新，将更新同步到目标系统中；

（3） 目标数据类型：分为数据库和客户端代理两种；

（4） 客户端代理：若目标数据类型选择客户端代理，则此项点亮可选择相对应的客户端代理；

（5） 数据库连接：若目标数据类型选择数据库，则此项点亮可选择相对应的目标数据库连接。

1.1.3.2 基础资料集成类型映射

主要功能：

配置源系统基础资料类型与目标数据库基础资料类型之间的对应关系，例如：凭证类型－凭证类型。

1、 从路径“EAS Cloud+其他->基础资料集成-外发配置->基础资料集成类型映射”进入基础资料集成类型映射主界面，如下图所示：

2、 点击新增基础资料集成类型映射，弹出新增界面，举例如下：

该界面上的主要字段说明：

（1） 目标系统数据库来源：选择数据来源类型，局域网集成（JDBC模式）选择“数据库（jdbc）”；

（2） 目标系统连接：选择一个在“数据库连接”功能中已经创建的连接；

（3） 目标系统视图：获取目标系统基础资料的视图；

（4） 目标系统标识字段：外系统用于对照转换的字段，如果是编码对照，就是编码字段，如果是PK对照，就是PK字段；

（5） 目标系统显示字段：通常是基础资料的名称字段；

（6） 当前系统基础资料：在EAS Cloud系统中，基础资料保存为query，此处可以支持F7选择，F7界面中会显示基础资料名称及query；

（7） 当前系统标识属性：目标系统（EAS Cloud系统）用于对照转换的字段，在EAS Cloud系统中，通常是number字段；

（8） 当前系统显示属性：在EAS Cloud系统中，通常是name字段；

（9） 当前系统主业务组织：用于指定目标系统中该基础资料类型的主业务组织字段，在下一环节中配置基础资料值映射时需要用到该字段进行组织过滤；

1.1.3.3 基础资料集成值映射

主要功能：

配置某一种基础资料类型下的目标系统基础资料值与当前系统基础资料值之间的对应关系，例如：凭证类型－凭证类型。一个基础资料类型映射只配置一套基础资料值映射关系。

1、 从路径“EAS Cloud+其他->基础资料集成-外发配置->基础资料集成值映射”进入基础资料集成值映射主界面，如下图所示：

2、 选择一条数据，点击编辑，此处以凭证类型为例，如下所示：

该界面上的主要字段及按钮说明：

（1） 基础资料类型映射：在新建基础资料值映射时选择一个基础资料类型映射关系，指定基础资料类型映射关系后，下方的单据体中显示和配置的就是该类型映射关系下的基础资料值对应关系；

（2） 组织单元：进行值匹配时会根据组织单元过滤目标系统的值；

（3） 目标系统过滤条件：该条件可以对目标系统中的数据进行过滤，可以填写以“where”关键字开头的SQL过滤语句；

（4） 当前系统过滤条件：该条件可以对当前系统中的数据进行过滤，可以填写以“where”关键字开头的SQL过滤语句；

（5） 更新目标系统数据：点击该按钮，可以更新下方单据体中的目标系统数据，如果在当前的基础资料值映射关系中不是首次获取，则再次点击该按钮时，只会把在当前单据体中缺少的字段列出来，不会影响前一次已经列出的字段；

（6） 单据体：单据体中显示的是当前系统与目标系统之间的基础资料值映射关系；

（7） 导出：将当前系统和目标系统的值映射关系导出存成文档形式；

（8） 导入：将当前系统和目标系统的值映射关系从外界导入EAS Cloud中。

1.3.4.%4 特殊查询条件

主要功能：

通用方案同步时所使用的过滤条件，此处用特殊过滤条件来进行过滤。

1、 从路径“EAS Cloud+其他->基础资料集成_外发配置->特殊查询条件”进入特殊查询条件的主界面，如下图所示：

2、 左树类别选择值映射，点击新增，弹出新增界面，如下图所示：

该界面主要字段说明：

（1） 方案编码：当前特殊查询条件的编码，建立时默认直接获取同步方案的编码；

（2） 方案名称：当前特殊查询条件的名称，建立时默认直接获取同步方案的名称；

（3） 目标数据类型：分为数据库和客户端代理两种。根据同步方式选择任一；

（4） 目标数据中心连接：选择要同步的目标数据库；

（5） 客户端代理：以客户端代理的方式选择要同步的目标系统；

（6） 主表查询条件：通用向导同步时所用的过滤条件；

（7） 备注：对此查询条件的备注和文字说明。

1.1.4 基础资料集成—接收配置

1.1.4.1 基础资料字段映射

主要功能：

针对异构系统基础资料集成，将源系统的基础资料字段与中间表字段进行映射。

1、 从路径“EAS Cloud+其他->基础资料集成-接收配置->基础资料字段映射”双击进入基础资料字段映射界面中，如下图所示：

2、 点击新增按钮，弹出基础资料字段映射新增的界面，如下图所示：

该界面上重要字段说明：

（1） 编码：当前编辑的业务单据映射规则的编码。仅允许使用字母、数字及下划线，并且首字母要大写。编码的内容是增量表、中间单据表、中间单据分录表的名称中的组成部分；

（2） 规则名称：当前编辑的业务单据映射规则的名称。仅允许使用字母、数字、中文字。规则名称的内容是中间单据名称的组成部分；

（3） 源系统数据来源：可选择“数据库”或“客户端代理”；

（4） 源系统数据库连接：如源系统数据来源为“数据库”，则需要选择一个在“数据中心连接”功能中已经创建的连接；

（5） 源系统视图：如源系统数据来源为“数据库”，则需要选择源系统视图；

（6） 增量表名称：规则发布后，系统会自动生成；

（7） 源系统查询条件：该条件可以对源系统数据进行过滤，在其中填写以“where”关键字开头的SQL过滤语句；

（8） 目标系统中间单据：系统自动生成；

（9） 目标系统中间单据表：系统自动生成；

（10） 目标系统中间单据分录表：系统自动生成；

（11） 数据不完整时是否自动生成中间单据：可选择“仅数据完整的单据生成”、“全部生成”、“全部不生成”；

（12） 规则描述：对本规则的文字说明；

（13） 更新源系统视图字段：点击该按钮，可以更新下方单据体中的源系统字段；

（14） 单据体：单据体中配置的是源系统字段与目标系统字段的映射关系，需要指定基础资料类型；

（15） 发布：规则编辑完以后需要进行发布，发布时会在后台数据库中创建中间表、增量表以及相关元数据。发布成功后，字段不能修改，如果发现有配置错误想调整，可以先删除错误的字段，然后点击“更新源系统字段”刷新列出的源系统字段，然后再进行配置、保存、发布；

1.1.4.2 基础资料生成规则

主要功能：

针对异构系统基础资料集成，配置引入引出模板中字段与中间表字段之间的对应关系。

1、 从路径“EAS Cloud+其他->基础资料集成-接收配置->基础资料生成规则”进入基础资料生成规则主界面，如下图所示：

2、 点击新增基础资料生成规则，弹出新增界面，举例如下：

该界面上的主要字段说明：

（1） 单据编号：当前规则的编号，手工输入；

（2） 基础资料字段映射：选择基础资料字段映射；

（3） 引入引出模板：选择引入引出模板；

（4） 默认目标组织：选择基础资料默认组织；

（5） 目标组织字段：选择中间表具体的组织字段，目标组织字段和默认目标组织不能同时为空；

（6） 关系字段：中间表中的主键字段，一般选择编码；

（7） 参考信息：备注信息，手工输入；

（8） 字段编码：引入引出模板中定义的字段编码；

（9） 字段名称：引入引出模板中定义的字段编码；

（10） 中间表字段：选择对应的中间表字段；

（11） 是否必录：显示引入引出模板中字