NWReport_DBWB使用说明

1. 软件使用

1.1 下载软件，并打开 ”NWReport_DBWB.exe” 程序，首先单击 ”参数设置” 按钮进行环境搭建如下图所示：

补充部分：

1）选择指定时间范围内导出数据

2）设置自定时间开始工作报表软件

如下图所示

1.2 打开参数设置界面进行环境搭建如下图所示：

注：“数据库名称”要在数据库中存在该库如下图所示，数据库由商家自己提供

如果没有，则可以自己手动创建，操作步骤如下：

1）登录数据库

2）右键数据库选择图下圈出的部分

3）创建对应的库名

1.3 数据库的表名有很多列，可以根据自己的需要修改字段名或者勾选要导出的数据（注：勾选要导出的参数要注意字段名是否为null，如果是null，请添加一个不重复的字段名），不需要导出的数据也可以去选（注：一旦创建了数据库表之后，不要随便更改字段名，否则数据会导出失败）

当前需要添加勾选的参数如下：

1）循环层放电容量衰减率：字段名设置为dc_cap_decay_rate

2）工步层

1.4 关闭软件会弹出密码提示框，默认密码是neware

接口信息及示例

2.1 接口信息

2.2请求参数示例

json字符串：

2.3响应参数描述

服务器端响应JSON格式的数据给调用方，响应参数字段为：

2.4响应参数示例

json字符串：

MySQL上传：

step:工步层

shcedule:工步设置

record:记录层

channel_status:通道状态

cycle:循环层

界面各项介绍

3.1 主界面介绍

1）版本号

2）配置连接方式

3）导出指定历史数据（可以设置开始时间或者结束时间，开始时间就是指通道时间范围开始测试的数据，结束时间就表示所有通道通道结束时间的数据）

4）定点上传即软件在固定的时间范围后才进行数据上传操作；上传完成后等待下一个时间时间范围到后才开启工作

5）定时上传即通过时间间隔进行上传，用户可在软件界面上配置数据上传的间隔时间，软件根据用户配置的时间间隔计划进行执行上传操作；

由于通道状态用于监控，测试数据（工步方案、循环层、工步层、记录层）数据主要数据提取；这两类数据对数据的更新频率要求不一致（通道状态更新的频率常常要求较高，测试数据更新频率常常要求较低），故将两种类型的数据分开配置数据上传的间隔时间；

6）查看问题打印详细日志

7）打印日志

3.2参数设置界面

1）对应的数据信息

1.1）通道状态

通道号（equiptCode）：设备编号

单元号（unitCode）：单元编号

通道号（channelCode）：通道编号

本地ID（localIP）：本地IP

电脑名（pcName）：当前电脑的命名称。

条码（packBarCode）：当前通道绑定的条码。

系统状态（systemStatus）：不传该字段。

测试方案名称（solutionName）：不传该字段。

测试项目名称（projectName）：不传该字段。

测试项目序号（projectNO）：不传该字段。

工步号（stepNO）：原始工步号。

循环组序号（cycleGroupNO）：不传该字段。

循环次数（cycleCount）：循环号；（循环的统计方式在软件界面上进行配置）

工步时间（stepTime）：当前工步运行时间，时间格式：hh:mm:ss;

总时间（totalTime）：当前测试运行时间，时间格式：hh:mm:ss;

充放电系统状态（btsSysState）：显示当前通道运行状态，请参考下表：

充放电运行模式（btsRunMode）：分为充电、放电、静置；

充放电控制模式（btsControMode）：分为恒流、恒压、恒流恒压、恒阻、恒功、工况、脉冲等（目前客户端内所有的充放电模式）。

电压（voltage）：当前通道实时电压值；

电流（current）：当前通道实时电流值：

功率（power）：当前通道实时功率值。

容量（capacity）：当前通道当前工步实时容量值。

总容量（totalAH）：当前测试总容量值，（充电为正放电为负，进行累加）

能量（stepKWH）：当前通道当前工步实时能量值。

总能量（totalKWH）：当前测试总能量值，（充电为正放电为负，进行累加）

充电总容量（totalChargeAH）：当前测试所有充电阶段容量之和；

放电总容量（totalDischargeAH）：当前测试所有放电阶段容量之和；

充电总能量（totalChargeKWH）：当前测试所有充电阶段能量之和；

放电总能量（totalDischargeKWH）：当前测试所有放电阶段能量之和；

电压设置值（voltageSetting）：当前工步的电压设置值。（注：即恒流工步的中截止电压或者恒压工步中设置的电压值。若无设置则该字段不写）

电流设定值（currentSetting）：当前工步的电压设置值。（注：即恒压工步的中截止电流或者恒流工步中的设置的电流值。若无设置则该字段不写）

辅助通道最高电压（maxSingleVoltage）：当前通道下所有辅助通道中实时电压的最大值。

辅助通道最低电压（minSingleVoltage）：当前通道下所有辅助通道中实时电压的最小值。

辅助通道最高温度（maxSingleTemperature）：当前通道下所有辅助通道中实时温度的最大值。

辅助通道最低温度（minSingleTemperature）：当前通道下所有辅助通道中实时温度的最小值。

温差（tem_deff）：当前通道下所有辅助通道的最大差值。

设备IP（dev_ip）：当前通道所属中位机的IP地址。

绝对时间（transmitTime）：当前消息推送的绝对时间。格式：YYYY-MM-DD hh:mm:ss

辅助通道电压（singleVoltage）：当前通道下所有辅助通道的实时电压值，用数组存储上传。

辅助通道温度（singleTemperature）：当前通道下所有辅助通道的实时温度值，用数组存储上传。

实验室（laboratory）：由用户输入默认值，软件上传默认值；

区域（area）：由用户输入默认值，软件上传默认值；

供应商（supplier）：由用户输入默认值，软件上传默认值；

1.2）工步设置

通道号（chl_id）：设备号-单元号-通道号；

电芯条码（barcode）：电池的条码；

工步号（step_id）：原始工步号；

工步名称（step_type）：工步名称；

工步时间（setting_time）：设置的工步时间。格式：hh:mm:ss.ms；（无设置则不写）

电压（setting_voltage）：工步中设置的电压条件/参数。单位：V；（无设置则不写）；

电流（setting_current）：工步中设置的电流参数。单位：A；（无设置则不写）；

倍率（setting_rate）：工步中设置的充放电倍率。（无设置则不写）；单位：C；

截止倍率（cut_of_rate）：工步中设置的倍率截止条件。（无设置则不写）；单位：C

截止电流（cut_of_current）：工步中设置的电流截止条件。（无设置则不写）；单位A；

能量（cut_of_energy）：工步中设置的能量截止条件。（无设置则不写）；单位Wh；

-△V（-△V）：工步设置的电压变化量的截止条件。（无设置则不写）；单位V；

功率（setting_power）：工步中设置的功率参数。（无设置则不写）；单位：W；

负载（setting_ohms）：工步中设置的负载参数。（无设置则不写）；单位：mΩ；

容量（cut_of_capacity）：工步设置的容量截止条件。（无设置则不写）；单位：Ah；

记录条件（recording_conditions）：工步中设置的主通道记录条件。格式：时间/电压/电流；例子：1s/1V/1A；（无设置则写0）；

辅助通道记录（aux_record_ conditions）：工步中设置的主通道记录条件辅助通道记录条件。

Max Vi：工步设置的辅助通道最高电压截止条件；

Min Vi：工步设置的辅助通道最低电压截止条件；

Max Ti：工步设置的辅助通道最高温度截止条件；

Min Ti：工步设置的辅助通道最低温度截止条件；

分段记录1（segment_recording1）：

分段记录2（segment_recording2）：

测试开始时间（star_time）：当前通道测试的开始时间；格式：YYYY-MM-DD hh:mm:ss

测试结束时间（end_time）：当前通道测试结束的时间；格式：YYYY-MM-DD hh:mm:ss

起始工步（start_step）：工步类型【循环】的设置参数。当前循环设置的从第几个原始工步号开始。

循环次数（cycle_times）：工步类型【循环】的设置参数。当前循环设置的循环次数。

1.3）循环层

设备号-单元号-通道号（chl_id）：设备号、单元号、通道号合并成一个字段，用“-”连接起来；

电池条码（barcode）：当前通道测试电池的条码。（无则该字段不写）；

循环序号（cycle_id）：循环号。统计方式：一充一放为一个循环；

充电容量（charge_capacity）：当前循环内所有充电工步的容量之和。（模拟工况工步则将所有充电阶段的容量累加进来）单位：Ah；

放电容量（discharge_capacity）：当前循环内所有放电工步的容量之和。（模拟工况工步则将所有放电阶段的容量累加进来）单位：Ah；

充电能量（charge_ energy）：当前循环内所有充电工步的能量之和。（模拟工况工步则将所有充电阶段的能量累加进来）单位：Wh；

放电能量（discharge_ energy）：当前循环内所有放电工步的能量之和。（模拟工况工步则将所有放电阶段的能量累加进来）单位：Wh；

净放电容量（Net_cap_dchg）：循环中所有放电阶段的容量总和减去所有充电阶段的充电容量总和。（模拟工况工步中的充放电阶段也需要统计）单位：Ah；（无特殊要求不建议勾选，影响上抛的性能）

净放电能量（Net_cap_dchg）：循环中所有放电阶段的能量总和减去所有充电阶段的充电能量总和。（模拟工况工步中的充放电阶段也需要统计）单位：Wh；（无特殊要求不建议勾选，影响上抛的性能）

充电中值电压（chg_mid_voltage）：充电过程中，当充电容量达到本循环总充电容量一半时的电压。如果一个等效循环有多次连续的充电，则总充电量为这几次充电工步的充电量之和。单位：V；（无特殊要求不建议勾选，影响上抛的性能）

放电中值电压（dc_mid_voltage）：放电过程中，当放电容量达到本循环总放电容量一半时的电压。如果一个等效循环有多次连续的放电，则总放电量为这几次放电工步的放电量之和。单位：V；（无特殊要求不建议勾选，影响上抛的性能）

辅助通道最高温度（aux_Temp_Max）：在当前循环内，提取所有辅助通道数据中最大的温度值；单位℃（无特殊要求不建议勾选，影响上抛的性能）

辅助通道最低温度（aux_Temp_Min）: 在当前循环内，提取所有辅助通道数据中最小的温度值；单位℃（无特殊要求不建议勾选，影响上抛的性能）

1.4）工步层

设备号-单元号-通道号（chl_id）：设备号、单元号、通道号合并成一个字段，用“-”连接起来；

电池条码（barcode）：当前通道测试电池的条码。（无则该字段不写）；

循环序号（cycle_id）：循环号。统计方式：一充一放为一个循环；

工步序号（step_num）：当前测试工步的流水号；

原始工步工步号（step_id）：当前测试工步的在工步方案的中的工步号；

工步名称（step_type）：工步名称；

工步时间（step_time）：工步运行的时间。单位：min；

充电容量（chg_capacity）：当前工步的充电容量。（若非充电工步是则不写，若为模拟工况工步是则将所有工充电阶段容量累加）单位：Ah；

放电容量（dc_capacity）：当前工步的放电容量。（若非放电工步是则不写，若为模拟工况工步是则将所有工放电阶段容量累加）单位：Ah；

充电能量（chg_energy）：当前工步的充电能量。（若非充电工步是则不写，若为模拟工况工步是则将所有工充电阶段能量累加）单位：Wh；

放电能量（dc_energy）：当前工步的放电能量。（若非放电工步是则不写，若为模拟工况工步是则将所有工放电阶段能量累加）单位：Wh；

充电中值电压（chg_mid_voltage）：当前工步容量值的一半时的电压。（若非充电工步是则不写，若为模拟工况工步是则将所有工充电阶段容量累加）；单位：V；（无特殊要求不建议勾选，影响上抛的性能）

放电中值电压（dc_mid_voltage）：当前工步容量值的一半时的电压。（若非放电工步是则不写，若为模拟工况工步是则将所有工放电阶段容量累加）；单位：V；（无特殊要求不建议勾选，影响上抛的性能）

充电时间：当前工步充电阶段时间的累加。（若非充电工步是则不写，若为模拟工况工步是则将所有工充电阶段时间累加）；单位：s；

放电时间：当前工步放电阶段时间的累加。（若非放电工步是则不写，若为模拟工况工步是则将所有工放电阶段时间累加）；单位：s；

起始电压（start_voltage）：当前工步开始时的第一条电压数据。单位：V;

结束电压（end_voltage）：当前工步结束时的最后一条电压数据。单位：V;

终止温度（end_temp）：当前工步最后一条温度辅助通道数据。单位：℃；（若无辅助通道则不写，若存在多个辅助通道时，将各个辅助通道按顺序排列后写入该字段中，用“,”隔开）

备注（remark）：当前测试工步文件中的备注字段。

恒流比（）:当前工步中恒流阶段容量占整个工步容量的比例；（无特殊要求不建议勾选，影响上抛的性能）

1.5）记录层

设备号-单元号-通道号（chl_id）：设备号、单元号、通道号合并成一个字段，用“-”连接起来；

电池条码（barcode）：当前通道测试电池的条码。（无则该字段不写）；

循环序号（cycle_id）：循环号。统计方式：一充一放为一个循环；

工步序号（step_num）：当前测试工步的流水号；

原始工步工步号（step_id）：当前测试工步的在工步方案的中的工步号；

记录序号（record_id）：当前测试的记录层数据的序号；

工步名称（step_type）：工步名称；

记录时间（record_time）：当前该条数据处于当前工步的时间点。单位：s；

电压（voltage）：当前电压；单位：V；

电流（current）：当前电流；单位：A；

容量（capacity）：当前记录的容量值；单位：Ah；（当前工步至该条记录所累加的容量值）

能量（energy）：当前记录的能量值；单位：Wh；（当前工步至该条记录所累加的能量值）

功率（power）：当前功率；（电压*电流）单位：W；

充电时间（chg_time）：当前工步充电阶段时间的累加。（若非充电工步是则不写，若为模拟工况工步是则将所有工充电阶段时间累加）；单位：s；

放电时间（dc_time）：当前工步放电阶段时间的累加。（若非放电工步是则不写，若为模拟工况工步是则将所有工放电阶段时间累加）；单位：s；

绝对时间：当前记录的绝对时间。格式：YYYY-MM-DD hh:mm:ss

附加温度（temperature）：当前辅助通道温度。单位：℃。（若无辅助通道则不写，若存在多个辅助通道时，将各个辅助通道按顺序排列后写入该字段中，用“,”隔开）

2）数据里面对应的字段

3）选择导出方式有导出数据库和接口导出方式（如果选择接口导出第5点就不需要任何设置）

4）如果选择接口导出那这边写接口地址

5）设置数据库（可以设置MySQL或者Mongdb）

5.1）数据库IP：MySQL存放在那台电脑上的IP地址（需要导出到哪台MySQL就填写哪台电脑上的IP）

5.2）数据库名称：MySQL创建的库名称

5.3）数据库端口号：数据库端口号（数据库默认安装的端口号是3306，注：同一台电脑不能装两个MySQL，除非端口不一致，安装的时候可以自己修改端口号）

5.4）数据库登录用户名：MySQL登录名

5.5）数据库登录密码：MySQL密码

6）导出循环统计方式

6.1）工步默认方式：从当前循环跳转到下一个循环跳转之间为一个循环。例：工步文件流程为：1.搁置；2.充电；3.搁置；4放电；5.搁置；6.充电；7.搁置；8.放电；9.循环（起始工步5~8；1次）；实际工步运行为：1→2→3→4→5→6→7→8→5→6→7→8，在工步默认循环号的规则下，循环1为1至8，循环2为：5至8。

6.2）先充后放：先充后放统计方式：以先一个充电工步后一个放电工步为循环，当存在多个连续的充电工步和多个连续的放电工步时，以第一个充电工步为循环的开始，以最后一个放电工步为循环的结束。即当放电工步后一个工步为充电工步时，则为新循环的开始。（使用NDA里的循环统计方式里的【先充后放统计方式】功能）。

6.3）先放后充：以先一个放电工步后一个充电为循环，当存在多个连续的充电工步和多个连续的放电工步时，以第一个放电工步为循环的开始，以最后一个充电工步为循环的结束。即当充电工步后一个工步为放电工步时，则为新循环的开始。（使用NDA里的循环统计方式里的【先放后充统计方式】功能）

7）开机自动启动报表软件

8）导入/导出配置功能

考虑到实际用户使用现场会存在多个服务器（新威软件服务器）电脑，每个服务器电脑均需要安装一份此报表软件，为了减少用户的配置时间，提升软件配置的便捷度和建议程度，同时提高软件的用户使用体检，需要添加【导出/导入配置】功能；

8.1）导出配置

用户仅需要在一台服务电脑上安装好报表软件后，将相关的配置内容进行设置完成（包含数据配置、数据表配置、数据库配置等）并保存后；用户可以将配置进行导出操作；软件将配置导出为.iconf文件，用户可手动选择文件保存的位置；

导出配置

8.2）导入配置

用户在安装新的报表软件时，若存在已经导出的配置文件；可在【参数配置】界面中选择点击导入，然后选择对应的.iconf文件，即可一键将配置设置完成；

导入配置文件

工步类型字段定义（step_type）