首次同步数据中心控件安装

==数据中心控件在进行数据同步时会自动检测安装，一般默认安装即可，如果想了解更多关于数据中心控件内容，可继续阅读==

## 控件简介

数据中心控件用于集中处理旭诺应用市场前端和旭诺海关云盒发起的数据处理请求，通过处理中心控件和电子口岸控件、税控盘控件通讯，以便海关、发票勾选平台交互时，获得必要的加密加签数据。

数据中心控件解决了旭诺应用市场前端数据同步时，为了保证只有一个线程和卡控件交互，避免卡控件冲突导致的问题所采用的的等待条遮罩因为同步时间过长影响用户体验的问题；实现了多模块同时使用，多同步任务件请求；同时实现了云盒和旭诺应用市场前端将数据中心控件作为统一入口，方便市场客户端、云申报、第三方平台接入。

## 解决痛点（使用前后对比）

| 数据中心控件 | 使用前| 使用后|
| ---- | ---- | ---- |
| 同步等待条| 一直遮罩，直到任务结束消失，期间无法进行其他操作| 无等待条，可进行其他操作，任务结束通过弹窗和微信公众号提醒|
| 同步任务并发 | 无法并发，必须等待上一任务结束后才可发起新任务| 可并发，任务在数据中心排队处理，同时支持多个海关模块同时使用|
| 代码复杂度| 旭诺市场前端、云盒、云盒处理中心数据同步代码冗余，代码重复度高，运维成本高，效率低 | 旭诺市场前端、云盒仅发起任务请求，数据同步统一归集到数据中心控件，运维成本低，效率高|
| 云盒解决方案 | 卡插入云盒后，旭诺市场前端同步需要在本机插卡，无法跨机器、跨部门使用| 卡插入云盒后，统一由云盒的数据中心处理，其他机器使用旭诺市场前端可发起同步任务，任务结束后在旭诺市场中可查看数据（仅支持局域网内使用） |
| 跨平台接入| 只支持 C#市场客户端接入| 提供 C#、JAVA 接入，不限于市场调度|

## 控件界面

![](/media/202112/2021-12-03_133925_146535.png)

# 运转原理

![](/media/202112/2021-12-03_133928_925723.png)

# 使用效果

使用旭诺应用市场中海关类数据同步（如关单通专业版），发起任务后，返回任务请求成功，此时确定关闭窗体，做其他操作。

![](/media/202112/2021-12-03_133934_920739.png)

任务同步成功后，在弹窗提示同步结果，或关注微信公众号接收任务推送结果

![](/media/202112/2021-12-03_133939_435924.png)

# 系统环境要求

windows xp（部分机器若出现问题，可通过安装 IE8 解决）

Win7（部分机器若出现问题，可通过安装 framework4.5 解决）

Win8/Win10

# 网络要求

本地需开放** 62626** 端口，局域网访问时，需将该端口加入防火墙，并确保 server 端和客户端地址为服务器内网地址

api.xunoi.com:80

data.xunoi.com:80

# 安装步骤

数据中心控件在使用旭诺应用市场中的海关模块，认证模块时会自动检测是否可与数据中心控件连通，未连通情况下，系统会自动提示，引导用户安装。

![](/media/202112/2021-12-03_133945_284852.png)

控件安装时，会自动检测系统环境，如 Framework4.0、海关数据中心控件、国税数据中心控件是否安装，检测未通过时，系统会自动下载安装，安装结束后，控件会自动运行，并在每次机器启动后自动运行。

### 安装引导页

![](/media/202112/2021-12-03_133949_078963.png)

### 路径选择（默认不用改）

![](/media/202112/2021-12-03_133954_834575.png)

### 开机启动（默认，不要改）

![](/media/202112/2021-12-03_133959_109155.png)

### 依赖控件安装

![](/media/202112/2021-12-03_134003_451803.png)

### 依赖控件自动下载安装

![](/media/202112/2021-12-03_134009_248154.png)

![](/media/202112/2021-12-03_134012_595335.png)

### 安装结束后自动运行

![](/media/202112/2021-12-03_134016_195800.png)

# 自动升级

控件每次启动自动检测升级

用户也可通过在任务状态栏中找到控件图标，右键点击，进行手工更新

每个任务执行前自动检测升级，发现升级版本后，队列中的任务全部失败，需重新请求任务

![](/media/202112/2021-12-03_134020_534009.png)

# 问题及解决

* 同步海关数据时，需确保数据中心控件运行，若未运行，可通过在开始菜单中手动运行；
* 同步海关数据时，任务未结束前，不能将口岸卡拔出；
* 同步海关数据时，尽量不要在单一窗口进行操作；
* 若数据中心控件未开机自动启动，需确保安装时，是否勾选开机启动选项，同时确保安装时，未被杀毒软件拦截，可通过尝试重新安装控件解决；
* 数据中心控件安装和卸载时，会检测数据中心控件是否运行，需退出后再进行安装、卸载；
* 发起任务后，若在数据中心控件中出现长时间执行中，可通过任务日志了解任务进度及状态。
* 若需强制中止任务，可在任务管理器中强制关闭数据中心控件，重新发起同步任务；
* 正在同步中的任务，超过 3 个小时仍处于同步中的，会在第二天自动更新任务状态为失败；

# 常见失败错误代码及解决办法

| 错误描述| 原因| 解决办法|
| ---- | ---- | ---- |
| [读卡器底层库]复位读卡器失败:错误码=50070[读卡器底层库]打开读卡器失败:错误码=50200| 读卡器未连接或未检测| 电脑上重新插拔读卡器重启电脑|
| [智能卡应用模块]输入口令错误，还可以重试四次:错误码=51574[智能卡应用模块]输入口令错误，还可以重试二次:错误码=51572[智能卡应用模块]输入口令错误，还可以重试一次:错误码=51571[智能卡应用模块]输入口令错误，还可以重试三次:错误码=51573[智能卡应用模块]输入口令错误，口令长度不正确:错误码=51680| 参数设置中口岸卡密码不正确；当同一企业有多张卡且密码不同时，确认是否插错卡；同一电脑上插入多个卡或多种读卡设备 | 参数设置中重新设置密码；确认插入的卡正确；可拔除电脑上其他卡设备 |
| [智能卡应用模块]输入口令错误，卡被锁定:错误码=51570[智能卡应用模块]卡口令被锁定:错误码=51560|密码错误多次，卡被锁| 去海关解锁|
| 电子口岸卡：中国电子口岸客户端控件连接失败!电子口岸卡：中国电子口岸客户端控件未启动!| 未安装或未启动中国电子口岸客户端控件| 重新安装中国电子口岸客户端控件或重新启动控件|
| [智能卡应用模块]卡片无效:错误码=51590| 卡片消磁或接触不良| 重新插拔卡或去海关换卡|
| 同步失败！SDK 调用异常：找不到方法...| 数据中心控件中部分 DLL 未更新| 手工更新或重启电脑重新更新|
| 海关服务器登入失败！ StepFiveGetUserInfo if (StringHelper.IsNullOrEmpty(resultStr))| xp 系统或网络请求失败| xp 系统升级至 sp3 并更新补丁换 win7 以上电脑|
| 电子口岸卡企业信息读取异常,请确认！| 非本企业卡、卡内信息错误或插卡错误| 更新卡内企业信息||| | |

# 局域网多客户端部署方案

使用数据中心控件作为任务处理中心，支持局域网中用户，使用旭诺财税应用市场、云盒、云申报、第三方平台，同时向数据中心发起任务请求，由任务中心集中进行数据同步工作，以满足用户跨部门数据协同、企业信息化共享、二次开发等特殊要求。

## 数据中心配置说明

修改 xunoidatacenter.ini 文件中的数据中心运行地址

![](/media/202112/2021-12-03_134526_582033.png)

将 ws_server 地址，由本机 ws://127.0.0.1:62626/ 修改为 ws://ip:62626/ 后保存

![](/media/202112/2021-12-03_134530_048387.png)

## 旭诺财税应用市场配置说明

数据中心地址修改后，旭诺市场的地址修改需联系在线客服进行修改；

其他第三方平台接入数据中心，也需要按照数据中心配置的ws_server 的地址配置相同 ip 才可与数据中心通讯。