#报表开发文档

##页面对应文件说明
 一、数据配置
    --1、数据源配置：
        --(1)、数据源配置列表页  (src\app\routes\data-setting\data-source);
        --(2)、新建sql (src\app\routes\data-setting\data-source\add-source\upload-mysql);
        --(3)、新建sqlserver (src\app\routes\data-setting\data-source\add-source\upload-sqlserver);
        --(4)、新建oracle (src\app\routes\data-setting\data-source\add-source\upload-oracle);
        --(5)、新建csv (src\app\routes\data-setting\data-source\add-source\upload-csv);
        --(6)、新建excel (src\app\routes\data-setting\data-source\add-source\upload-excel);
        --(7)、创建数据集 (src\app\routes\data-setting\data-source\add-group)
        --(8)、字段详情 (src\app\routes\data-setting\data-source\detail-table);
        --(9)、预览数据 (src\app\routes\data-setting\data-source\preview-table);
        --(10)、编辑数据源<本地文件：csv/excel> (src\app\routes\data-setting\data-source\edit-source\edit-bendi)
        --(11)、编辑数据源<数据库：sql/sqlserve/oracle> (src\app\routes\data-setting\data-source\edit-source\edit-guanxi)

    --2、数据集配置：
        --(1)、新建数据集市/编辑数据集市 (src\app\routes\data-setting\add-settings);
        --(2)、创建数据集 (src\app\routes\data-setting\add-database);
        --(3)、编辑数据集 (src\app\routes\data-setting\data-set-create);
        --(4)、变更数据集信息 (src\app\routes\data-setting\updata-data)
        --(5)、复制数据集 (src\app\routes\data-setting\copy-data)

 二、报表管理
    --1、报表新建，编辑页面 (jsp部份);
    --2、图表新建，编辑页面 (src\app\routes\widget-manager\create-chart)
    --3、透视图新建，编辑页面 (src\app\routes\widget-manager\create-perspective-table)
    --4、我的报表列表页(src\app\routes\widget-manager\my-widget)
        --(1)、添加节点弹窗 (src\app\routes\widget-manager\my-widget\add-node)
        --(2)、预览页面 (src\app\routes\widget-manager\my-widget\preview)
    --5、模板参考列表 (src\app\routes\widget-manager\template-reference)

 三、系统配置
    --1、看板配置列表 (src\app\routes\system-setting\dashboard-setting)
    --2、看板新建页面 (src\app\routes\system-setting\dashboard-setting\add-time-board)

 四、平台配置<管理中心>
    --1、模板设置页面 (src\app\routes\platform-setting\module-setting)
        --(1)、编辑模板信息 (src\app\routes\platform-setting\module-setting\edit-information)
        --(2)、添加分类 (src\app\routes\platform-setting\add-template)
        --(3)、添加明细分类 (src\app\routes\platform-setting\add-detail)
        --(4)、添加模板(src\app\routes\platform-setting\change2template)

 五、相关服务
    --1、路由守卫 (src\app\service\login-guard.service.ts)
    --2、入口相关配置服务 (src\app\service\config.service.ts)
    --3、cookie加密/解密 (src\app\service\common\cookie.service.ts)
    --4、http请求服务 (src\app\service\common\http\http.service.ts)
    --5、报表对外参数接受并相应处理 (src\app\service\foreignSetUrlParams.srevice.ts)
    --6、获取获取i18n中 *.json 数据 (src\app\service\swal\swal.service.ts)
    
    
 六、第三方插件引用
    --1、加密插件(src\app\shared\des.js)
        引用方法：在.angular-cli.json里先引入"./assets/desjs/tripledes.js","./assets/desjs/mode-ecb.js","./assets/desjs/desutil.js" 
        调用：declare let encryptByMD5:any <加密>

##正式环境和测试环境切换需要修改
    --1、入口相关配置服务 (src\app\service\config.service.ts); <--里面有明确注释-->

>    --2、<angular部份>加密函数 (src\assets\desjs\desutil.js) 中 encryptByMD5()
        --(1)、加密key修改 (src\app\service\config.service.ts) 中 encryptKey:string

>   --3、<jsp部份> 加密函数 (report-js\src\Utils.js) 中 returnEncryptStr();
        --(1)、加密key 修改 (report-js\src\Utils.js) 中 returnMD5Key函数;

##本地全局依赖
    --1、node.js   -v 8.9.0+
    --2、angular-cli 1.6.1

##本地启动
    --1、proxy.conf.json 文件配置后端地址 ("target": "http://202.98.157.47:8087") 后端地址
         本地启动命令：ng serve --proxy-config proxy.conf.json --port 10080 --host chartbb.chfcloud.com


#报表设计器部份  <jsp>

 一、相关文件位置
    --1、需要打包的文件 (\report-js);
    --2、html文件  (\report-console\src\main\resources\report-html);
    --3、外部引入库/提取出的文件 (\report-console\src\main\resources\report-asserts);

 二、本地依赖
    --1、webpack-cli -v 4.6.0

 三、打包命令
    --2、npm run webpack

 四、相关服务
    --1、登录超时函数 (report-js\src\Utils.js) 中 overtimeLogin
    --2、清除cookie (report-js\src\Utils.js) 中 clearAllCookie
    --3、防js注入转码 (report-js\src\Utils.js) 中 htmlEncode
    --4、加密参数处理 (report-js\src\Utils.js) 中 returnEncryptStr