Commit 6e26e485 authored by custom's avatar custom

Merge origin/master into master

parents 5e8d1702 35d40bc6
###字段级通用方法
#### 设置字段必填属性
>Hel.setRequired(id,flag);
>Hls.setRequired(id,flag);
第一个参数id为字段的id,第二个参数flag为true时将该字段设为必填,为false时将该字段设为非必填。
```html
<h:hlsMaskedTextBox id="maskedTextBox"/>
<script><![CDATA[
Hel.setRequired('maskedTextBox',true);
Hls.setRequired('maskedTextBox',true);
]]></script>
```
#### 设置字段只读属性
>Hel.setReadonly(id,flag);
>Hls.setReadonly(id,flag);
第一个参数id为字段的id,第二个参数flag为true时将该字段设为只读,为false时将该字段设为可输入。
```html
<h:hlsMaskedTextBox id="maskedTextBox"/>
<script><![CDATA[
Hel.setReadonly('maskedTextBox',true);
Hls.setReadonly('maskedTextBox',true);
]]></script>
```
......
### 锁屏和解屏
#### 锁屏
>Hel.mask(opts);
>Hls.mask(opts);
其中参数为:
属性名 | 类型 | 含义
-------- | ----- | -----
id| String(选填) | 当前窗口的id,缺省值为body
```
Hel.mask(); //缺省值为body
Hel.mask({
Hls.mask(); //缺省值为body
Hls.mask({
id:'',//传入相应的参数
});
```
......@@ -17,6 +17,6 @@ Hel.mask({
```
Hel.unmask();
Hls.unmask();
```
### 窗口级通用方法
#### 打开功能窗口
>Hel.openMenuWindow(opts);
>Hls.openMenuWindow(opts);
其中参数为:
属性名 | 类型 | 含义
......@@ -14,7 +14,7 @@ documentKey| String | 打开同一个功能时,识别不同单据的唯一标
reflashFlag| String | 关闭该功能菜单时是否刷新父级标志(Y/N)
moduleName| String | 模块名称
```
Hel.openMenuWindow({
Hls.openMenuWindow({
menuCode:'',//传入相应的参数
title:'',
url:'',
......@@ -27,20 +27,20 @@ Hel.openMenuWindow({
```
#### 关闭功能窗口
>Hel.closeMenuWindow(opts);
>Hls.closeMenuWindow(opts);
其中参数为:
属性名 | 类型 | 含义
-------- | ----- | -----
menuCode | String(必填) | 菜单代码
```
Hel.closeMenuWindow({
Hls.closeMenuWindow({
menuCode:''//传入相应的参数
});
```
#### 打开右弹窗口
>Hel.openBarWindow(opts);
>Hls.openBarWindow(opts);
其中参数为:
属性名 | 类型 | 含义
......@@ -51,7 +51,7 @@ size| String(必填) | 右弹窗口的宽度(THIRD/HALF/FULL/任意px像素)
```
<div id="win"></div>
<script><![CDATA[
Hel.openBarWindow({
Hls.openBarWindow({
id:'win',
content:'',
size:''
......@@ -63,7 +63,7 @@ size| String(必填) | 右弹窗口的宽度(THIRD/HALF/FULL/任意px像素)
#### 打开抽屉
> Hel.openBox()函数接收一个对象,对象属性含义如下:
> Hls.openBox()函数接收一个对象,对象属性含义如下:
属性名 | 类型 | 含义
......@@ -80,7 +80,7 @@ function test(e){
...
}
Hel.openBox({
Hls.openBox({
winId:"domId",
functionCode:"CSH200B",
params:{
......
......@@ -4,3 +4,5 @@
前端界面采用kendoUI开源框架,相同的显示效果可以采用多种代码方式来实现,为了规范项目组成员的代码样式,统一编码风格,避免以后维护的工作量,融租易采用封装标签的开发方式,当然如果在项目开发过程中遇到比较复杂的页面通过标签的方式实现不了的功能,需要跟产品组报备,然后采取源生的开发方式。
#### 自定义字体
前端界面字体大小的设置,一般不直接在style中设置font-size,而是选择引入hls-font.css,使用其中的字体样式类来对字体大小进行设置,若是有特殊的需求可以在hls-font.css文件中进行添加,并加上文字描述。
\ No newline at end of file
......@@ -30,7 +30,7 @@
调用js方法
```javascript
Hel.exportExcel=function(opts){
Hls.exportExcel=function(opts){
var contextPath =opts.contextPath,
id=opts.id,
view_model=opts.viewModel,
......@@ -76,7 +76,7 @@ excelService.saveExportInfo(sqlId,iRequest,config,rowMaxNumber);
3. 运行Excel导出程序(获取该程序,请联系部门相关负责人)
```shell
java -jar hel-batch-parent.jar &
java -jar hls-batch-parent.jar &
```
4. Excel导出情况查询
用户若是为管理员身份,则查询全部人的导出情况,否则只显示当前用户的导出数据
......@@ -103,4 +103,4 @@ excel.downloadExcel(filePath, fileName, request, response);
| request | HttpServletRequest | 用户的请求对象 |
| response | HttpServletResponse | 用户的响应对象 |
**下载前,需要检查config.properties文件中的export.offerUrl配置项是否配置正确,且为hel-batch-parent.jar提供的文件下载url**
\ No newline at end of file
**下载前,需要检查config.properties文件中的export.offerUrl配置项是否配置正确,且为hls-batch-parent.jar提供的文件下载url**
\ No newline at end of file
......@@ -154,9 +154,9 @@ databaseChangeLog(logicalFilePath: "patch.groovy") {
---
HEL1.0中采用了全新的基于 excel 的基础数据维护.
HLS1.0中采用了全新的基于 excel 的基础数据维护.
请参考 `hel-db` 中 hls/core/db/data/2016-09-30-init-data.xlsx
请参考 `hls-db` 中 hls/core/db/data/2016-09-30-init-data.xlsx
excel 数据管理的主要特点有:
......@@ -182,9 +182,9 @@ excel 更直观, 便于维护, 所有的基础数据, 只需要维护一份 exce
```java
public static void main(String[] args) throws Exception {
System.setProperty("db.url", "jdbc:mysql://127.0.0.1:3306/hel");
System.setProperty("db.user", "hel_dev");
System.setProperty("db.password", "hel_dev");
System.setProperty("db.url", "jdbc:mysql://127.0.0.1:3306/hls");
System.setProperty("db.user", "hls_dev");
System.setProperty("db.password", "hls_dev");
System.setProperty("db.override", "true");
ExcelDataLoader processor = new ExcelDataLoader();
......
# 新开项目
本章节将引导您从零开始,创建一个可以运行的 Demo 工程。此工程基于HEL融租易标准版,包含一个 demo 实例。
本章节将引导您从零开始,创建一个可以运行的 Demo 工程。此工程基于HLS融租易标准版,包含一个 demo 实例。
## 开发工具准备
- JDK 1.8 及以上
......@@ -25,6 +25,7 @@
> eclipse 中 JRE 的配置需要指定 JDK 目录,不能是 JRE。(maven 需要 JDK)
#### Git 安装
1.[Git 官网 ](https://git-scm.com/download/)下载对应平台的 Git。
......@@ -57,11 +58,11 @@
> Mac, Linux 用户, 请到 http://redis.io 下载源码,编译安装
### 新建项目 (依赖融租易HEL1.0)
### 新建项目 (依赖融租易HLS1.0)
#### 确定项目信息
1. groupId 本项目的代号,比如融租易项目,代号为 hel
2. artifactId 本项目的顶层目录名称,使用项目代号(第一个字母大写) +Parent,如 HelParent
3. package 包名称,使用项目代号 + core ,如 Hel.core
1. groupId 本项目的代号,比如融租易项目,代号为 hls
2. artifactId 本项目的顶层目录名称,使用项目代号(第一个字母大写) +Parent,如 HlsParent
3. package 包名称,使用项目代号 + core ,如 Hls.core
4. archetypeVersion 是指模板项目的版本,可以使用以下版本号
> 1.0-RELEASE
......@@ -70,7 +71,7 @@
`注意` maven-archetype-plugin `2.4`及以下版本可以正常使用下面命令
```
mvn archetype:generate -D archetypeGroupId=hel-custom -D archetypeArtifactId=hel-custom-parent-archetype -D archetypeVersion=1.0-RELEASE -D groupId=hel -D artifactId=HelParent -D package=Hel.core -D version=1.0-RELEASE -D archetypeRepository=https://hel.hand-china.com/nexus/content/repositories/Hel-Releases
mvn archetype:generate -D archetypeGroupId=hls-custom -D archetypeArtifactId=hls-custom-parent-archetype -D archetypeVersion=1.0-RELEASE -D groupId=hls -D artifactId=HlsParent -D package=Hls.core -D version=1.0-RELEASE -D archetypeRepository=https://hls.hand-china.com/nexus/content/repositories/Hls-Releases
```
......@@ -80,12 +81,12 @@ mvn archetype:generate -D archetypeGroupId=hel-custom -D archetypeArtifactId=he
解决方案:
指定使用2.4版本的archetype-plugin插件:
```
mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -D archetypeGroupId=hel-custom -D archetypeArtifactId=hel-custom-parent-archetype -D archetypeVersion=1.0-RELEASE -D groupId=hel -D artifactId=HelParent -D package=Hel.core -D version=1.0-RELEASE -D archetypeRepository=https://hel.hand-china.com/nexus/content/repositories/Hel-Releases
mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -D archetypeGroupId=com.hand.hls -D archetypeArtifactId=hls-custom-parent-archetype -D archetypeVersion=1.0.0-RELEASE -D groupId=com.hand.hls.custom -D artifactId=HlsCustomParent -D package=com.hand.hls.custom -D version=1.0.0-RELEASE -D archetypeRepository=https://hel.hand-china.com/nexus/content/repositories/Hls-Releases
```
> 以下内容所指的 `HelParent` 均指上面命令中的参数 `artifactId` 的值,请按实际情况替换
> 以下内容所指的 `HlsParent` 均指上面命令中的参数 `artifactId` 的值,请按实际情况替换
新的项目目录结构如下:
```
......@@ -96,7 +97,7 @@ mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -D archetypeGr
│ └── src
│ └── main
│ ├── java
│ │ ├── hel
│ │ ├── hls
│ │ │ └── core(前面的包名称)
│ │ │ ├── db(数据表结构,数据初始化入口文件)
│ │ │ │ └── liquibase.groovy
......@@ -115,7 +116,7 @@ mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -D archetypeGr
│ └── src
│ └── main
│ └── java
│ └── hel
│ └── hls
│ └── core
│ └── db
│ ├── data(数据文件)
......@@ -130,7 +131,7 @@ mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -D archetypeGr
> 目前已经测试过支持的数据库有Mysql,Oracle,SqlServer
> 按照[创建数据库](/后端开发/database-init.md)中的步骤创建数据库
> 请修改 `HelParent/core/src/main/java/hel/core/db/liquibase.groovy` 以适配不同的数据库
> 请修改 `HlsParent/core/src/main/java/hls/core/db/liquibase.groovy` 以适配不同的数据库
### 修改项目配置文件
......@@ -138,31 +139,31 @@ mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -D archetypeGr
### 编译整个项目
在 HelParent 目录下执行:
在 HlsParent 目录下执行:
```
mvn clean install -Dmaven.test.skip=true
```
### 初始化数据库表结构及基础数据
在 HelParent 项目录下执行:
在 HlsParent 项目录下执行:
- MySql
- `mvn process-resources -D skipLiquibaseRun=false -D db.driver=com.mysql.jdbc.Driver -D db.url="jdbc:mysql:127.0.0.1:3306/hel?useUnicode=true&characterEncoding=utf8" -Ddb.user=hel_dev -Ddb.password=hel_dev`
- `mvn process-resources -D skipLiquibaseRun=false -D db.driver=com.mysql.jdbc.Driver -D db.url="jdbc:mysql://127.0.0.1:3306/hls_dev?useUnicode=true&characterEncoding=utf8" -Ddb.user=hls_dev -Ddb.password=hls_dev`
- SqlServer
- `mvn process-resources -D skipLiquibaseRun=false -Ddb.user=hel_dev -Ddb.password=hel_dev-D db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver -D db.url="jdbc:sqlserver://127.0.0.1:1433; DatabaseName=hel"`
- `mvn process-resources -D skipLiquibaseRun=false -Ddb.user=hls_dev -Ddb.password=hls_dev-D db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver -D db.url="jdbc:sqlserver://127.0.0.1:1433; DatabaseName=hls"`
- Oracle
- `mvn process-resources -D skipLiquibaseRun=false -D db.driver=oracle.jdbc.driver.OracleDriver -D db.url=jdbc:oracle:thin:@127.0.0.1:1521:hel -Ddb.user=hel_dev -Ddb.password=hel_dev`
- `mvn process-resources -D skipLiquibaseRun=false -D db.driver=oracle.jdbc.driver.OracleDriver -D db.url=jdbc:oracle:thin:@127.0.0.1:1521:hls -Ddb.user=hls_dev -Ddb.password=hls_dev`
- 以上命令中,需要按实际情况修改 url,user,password
### 测试
1. 在 HelParent 工程目录下执行命令(IntelliJ IDEA 用户可以跳过此步骤)
1. 在 HlsParent 工程目录下执行命令(IntelliJ IDEA 用户可以跳过此步骤)
```
mvn eclipse:eclipse
```
2. 将项目工程导入 IDE 工具(Eclipse,IntelliJ IDEA)中,并配置服务(tomcat等)后启动运行。
### 更新HEL依赖
### 更新HLS依赖
[更新项目依赖的HEL版本](project-update.md)
[更新项目依赖的HLS版本](project-update.md)
# 更新项目依赖的HEL版本
# 更新项目依赖的HLS版本
1. 选择希望的版本号
此地址[查看 HEL Release 版本](https://hel.hand-china.com/hel-guide/hel-developer-guide/tags)
此地址[查看 HLS Release 版本](https://hls.hand-china.com/hls-guide/hls-developer-guide/tags)
2. 更改 项目Parent目录中的 pom.xml
* `<hel.version>1.0.0-RELEASE</hel.version>`
* `<hls.version>1.0.0-RELEASE</hls.version>`
3. 更新IDE中的maven依赖:
* `eclipse` 右键点击 HelParent 工程,`Maven``Update Project...`
* `IDEA` :右键点击 HelParent 工程,`Maven``Reimport`(等候下载)
* `eclipse` 右键点击 HlsParent 工程,`Maven``Update Project...`
* `IDEA` :右键点击 HlsParent 工程,`Maven``Reimport`(等候下载)
4. 在Parent目录下执行`mvn clean install`
5. 执行初始化数据库的<a href="project-create.md#liquibase">liquibase 命令</a>
......@@ -14,8 +14,8 @@
初始化数据库表结构及基础数据
> 注意
* 如果项目中过有覆盖过HEL的xml配置文件,更新以后请注意比对有没有变化
* 新建项目默认依赖的是1.0.0-RELEASE版本的HEL,后续更新可能会涉及数据库的变化,请注意同步更新数据库,同步指令如下:`mvn process-resources -D skipLiquibaseRun=false -D db.driver=com.mysql.jdbc.Driver -D db.url=jdbc:mysql://127.0.0.1:3306/hel -Ddb.user=hel_dev -Ddb.password=hel_dev -Ddb.skipUpdateTables=sys_user,sys_function_b`
* 如果项目中过有覆盖过HLS的xml配置文件,更新以后请注意比对有没有变化
* 新建项目默认依赖的是1.0.0-RELEASE版本的HLS,后续更新可能会涉及数据库的变化,请注意同步更新数据库,同步指令如下:`mvn process-resources -D skipLiquibaseRun=false -D db.driver=com.mysql.jdbc.Driver -D db.url=jdbc:mysql://127.0.0.1:3306/hls -Ddb.user=hls_dev -Ddb.password=hls_dev -Ddb.skipUpdateTables=sys_user,sys_function_b`
\ No newline at end of file
......@@ -3,7 +3,7 @@
### 1.打开抽屉
> Hel.openBox()函数接收一个对象,对象属性含义如下:
> Hls.openBox()函数接收一个对象,对象属性含义如下:
属性名 | 类型 | 含义
......@@ -20,7 +20,7 @@ function test(e){
...
}
Hel.openBox({
Hls.openBox({
winId:"domId",
functionCode:"CSH200B",
params:{
......
......@@ -4,7 +4,7 @@
本功能可根据数据表生成相关的dto,mapper impl,service,controller与html,包含相关的增删改查功能。
**网页入口**:http:\/\/localhost:8080\/hel\/generator\/generator.html
**网页入口**:http://localhost:8080/hls/generator/generator.html
## 使用说明:
......
......@@ -5,19 +5,19 @@
1. 服务数据源配置
* 融租易默认使用 JNDI 来配置数据源。数据源的配置独立于项目配置
* 默认使用的 JNDI name 为 `jdbc/hel_dev`
* 默认使用的 JNDI name 为 `jdbc/hls_dev`
* tomcat 需要配置 context.xml:
- Mysql
```
<Resource auth="Container" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/hel" name="jdbc/hel_dev" type="javax.sql.DataSource" username="hel_dev" password="hel_dev"/>
<Resource auth="Container" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/hls" name="jdbc/hls_dev" type="javax.sql.DataSource" username="hel_dev" password="hls_dev"/>
```
- Oracle
```
<Resource auth="Container" driverClassName="oracle.jdbc.driver.OracleDriver" name="jdbc/hel_dev" type="javax.sql.DataSource" url="jdbc:oracle:thin:@127.0.0.1:1521:hel" username="hel_dev" password="hel_dev"/>
<Resource auth="Container" driverClassName="oracle.jdbc.driver.OracleDriver" name="jdbc/hls_dev" type="javax.sql.DataSource" url="jdbc:oracle:thin:@127.0.0.1:1521:hls" username="hls_dev" password="hls_dev"/>
```
- SqlServer
```
<Resource auth="Container" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver" url="jdbc:sqlserver://127.0.0.1:1433; DatabaseName=hel" name="jdbc/hel_dev" type="javax.sql.DataSource" username="hel_dev" password="hel_dev"/>
<Resource auth="Container" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver" url="jdbc:sqlserver://127.0.0.1:1433; DatabaseName=hls" name="jdbc/hls_dev" type="javax.sql.DataSource" username="hls_dev" password="hls_dev"/>
```
* 其他[应用服务器weblogic](/框架功能描述/deployment.md)等,需要按其配置方法 配置 JNDI
......@@ -28,14 +28,14 @@
* 当数据库为 oracle 时
```
db.type=oracle
db.jndiName=java:comp/env/jdbc/hel_dev
db.jndiName=java:comp/env/jdbc/hls_dev
mybatis.identity=SEQUENCE
```
* 当数据库为mysql时
```
db.type=mysql
db.jndiName=java:comp/env/jdbc/hel_dev
db.jndiName=java:comp/env/jdbc/hls_dev
```
* 修改完毕后复制一份放到 resources/profiles/dev (覆盖)
......
......@@ -12,23 +12,23 @@ max_connections=500
```
* 用管理员登陆mysql
* 创建数据库hel_dev
* 创建数据库hls_dev
```sql
create schema hel_dev default character set utf8;
create schema hls_dev default character set utf8;
```
* 创建用户hel_dev,并将密码设置为hel_dev
* 创建用户hls_dev,并将密码设置为hls_dev
```sql
CREATE USER hel_dev@'%' IDENTIFIED BY 'hel_dev';
CREATE USER hel_dev@'localhost' IDENTIFIED BY 'hel_dev';
CREATE USER hls_dev@'%' IDENTIFIED BY 'hls_dev';
CREATE USER hls_dev@'localhost' IDENTIFIED BY 'hls_dev';
```
* 将上面新建的hel_dev权限赋予用户hel
* 将上面新建的hls_dev权限赋予用户hls
```sql
GRANT ALL PRIVILEGES ON hel_dev.* TO hel_dev@'%';
GRANT ALL PRIVILEGES ON hel_dev.* TO hel_dev@'localhost';
GRANT ALL PRIVILEGES ON hls_dev.* TO hls_dev@'%';
GRANT ALL PRIVILEGES ON hls_dev.* TO hls_dev@'localhost';
flush privileges;
```
# 2. 创建数据库-Oracle
......@@ -36,14 +36,14 @@ max_connections=500
* 创建表空间
```sql
CREATE BIGFILE TABLESPACE tbs_perm_hel
DATAFILE 'tbs_perm_hel.dat'
CREATE BIGFILE TABLESPACE tbs_perm_hls
DATAFILE 'tbs_perm_hls.dat'
SIZE 200M
AUTOEXTEND ON NEXT 20M MAXSIZE 500M;
```
```sql
CREATE TEMPORARY TABLESPACE tbs_temp_hel
TEMPFILE 'tbs_temp_hel.dbf'
CREATE TEMPORARY TABLESPACE tbs_temp_hls
TEMPFILE 'tbs_temp_hls.dbf'
SIZE 200M
AUTOEXTEND ON NEXT 20M MAXSIZE 500M;
```
......@@ -51,23 +51,23 @@ max_connections=500
* 创建用户 schema
```sql
CREATE USER hel_dev
IDENTIFIED BY hel_dev
DEFAULT TABLESPACE tbs_perm_hel
TEMPORARY TABLESPACE tbs_temp_hel
QUOTA 200M on tbs_perm_hel;
CREATE USER hls_dev
IDENTIFIED BY hls_dev
DEFAULT TABLESPACE tbs_perm_hls
TEMPORARY TABLESPACE tbs_temp_hls
QUOTA 200M on tbs_perm_hls;
```
* 授权
```sql
GRANT create session TO hel_dev;
GRANT create table TO hel_dev;
GRANT create view TO hel_dev;
GRANT create any trigger TO hel_dev;
GRANT create any procedure TO hel_dev;
GRANT create sequence TO hel_dev;
GRANT create synonym TO hel_dev;
GRANT create session TO hls_dev;
GRANT create table TO hls_dev;
GRANT create view TO hls_dev;
GRANT create any trigger TO hls_dev;
GRANT create any procedure TO hls_dev;
GRANT create sequence TO hls_dev;
GRANT create synonym TO hls_dev;
```
# 3. 创建数据库-sql server
......@@ -75,17 +75,17 @@ max_connections=500
* 创建数据库
```sql
CREATE DATABASE hel_dev COLLATE Chinese_PRC_CI_AS;
CREATE DATABASE hls_dev COLLATE Chinese_PRC_CI_AS;
```
* 创建用户 hel 并授权
* 创建用户 hls 并授权
```sql
sp_addlogin 'hel','hel_dev';
use hel_dev
sp_addlogin 'hls','hls_dev';
use hls_dev
go
sp_adduser 'hel_dev','hel_dev'
sp_adduser 'hls_dev','hls_dev'
go
sp_addrolemember 'db_owner','hel'
sp_addrolemember 'db_owner','hls'
go
```
\ No newline at end of file
......@@ -30,7 +30,7 @@
调用js方法
* 方法一(针对grid)
```javascript
Hel.exportExcel=function(opts){
Hls.exportExcel=function(opts){
var contextPath =opts.contextPath,
id=opts.id,
view_model=opts.viewModel,
......@@ -56,7 +56,7 @@
* 方式二(针对hlsPage)
```javascript
Hel.exportPageExcel({
Hls.exportPageExcel({
contextPath:basePath,
param:{},
controller:"/acr/inf/index/excel/export",
......@@ -102,7 +102,7 @@ Hel.exportPageExcel({
3. 运行Excel导出程序(获取该程序,请联系部门相关负责人)
```shell
java -jar hel-batch-parent.jar &
java -jar hls-batch-parent.jar &
```
4. Excel导出情况查询
用户若是为管理员身份,则查询全部人的导出情况,否则只显示当前用户的导出数据
......@@ -129,4 +129,4 @@ Hel.exportPageExcel({
| request | HttpServletRequest | 用户的请求对象 |
| response | HttpServletResponse | 用户的响应对象 |
**下载前,需要检查config.properties文件中的export.offerUrl配置项是否配置正确,且为hel-batch-parent.jar提供的文件下载url**
\ No newline at end of file
**下载前,需要检查config.properties文件中的export.offerUrl配置项是否配置正确,且为hls-batch-parent.jar提供的文件下载url**
\ No newline at end of file
# 邮件
## 1、邮件账户
#### 菜单路径
系统设置/邮件/邮件账户
#### 功能描述
邮件账户配置页面,用户在此配置用以发送邮件的账户。
#### 使用说明
#### 账户查看界面:
查看所有邮件账户,或通过配置代码和描述搜索相关账户,可对账户进行删除,修改,新建操作。
![](/assets/mail_account_query.png)
#### 账户新建/编辑界面:
点击新建或编辑按钮后弹出,新建一个邮箱账户或者编辑当前账户,填写相关参数点击保存提交修改。(相关参数说明如下)
![](/assets/mail_account_add.png)
#### 参数说明
* 配置代码: 唯一性标识,不可重复。
* 描述: 账户大致描述。
* 邮件服务器:邮箱发件服务器地址。
* 端口: 发件服务器端口号。
* 用户名: 登录邮箱的用户名。
* 密码: 登陆邮箱的授权码。
* 启用白名单: 开启白名单功能。
* 白名单: 填写邮箱地址,开启后只给白名单中包含的邮件地址发送邮件。
> 提示:此处的密码并非邮箱登陆密码,而是邮箱的授权码,具体信息请登录邮箱查看。
## 2、邮件模板
#### 菜单路径
系统设置/邮件/邮件模板
#### 功能描述
用户可在此自定义邮件模板,然后在邮件发送时选取所需模板进行发送。模板内容使用富文本编辑器,满足用户绝大部份需求。
#### 使用说明
#### 模板查看界面:
查看所有邮件模板,或通过模板代码和描述搜索相关模板,可对模板进行删除,修改,新建操作。
![](/assets/mail_model_query.png)
#### 模板新建/编辑界面:
点击新建或编辑按钮后弹出,新建一个邮箱账户或者编辑当前模板,填写相关参数点击保存提交修改。(相关参数说明如下)
![](/assets/mail_model_add.png)
#### 参数说明
* 模板代码: 模板唯一标识,不可重复。
* 描述: 模板大致描述。
* 邮件账户: 发件账户。
* 主题: 邮件主题。
* 内容: 邮件发送内容。
## 3、邮件测试
#### 菜单路径
系统设置/邮件/邮件测试
#### 功能描述
邮件发送测试界面。可通过选取邮件模板方式发送邮件。
#### 使用说明
#### 模板邮件界面:
通过选取邮件模板发送邮件。
![](/assets/mail_test_query.png)
#### 参数说明
* 收件人: 邮件收件人。
* 模板代码: 选取发送邮件所用模板。
* 添加附件: 添加邮件附件。
#### 选取附件界面:
点击添加附件后展开,点击选择附件后查看所有附件,选取相关附件后点击添加按钮将附件加入待发送附件进列表,全部选取成功后点击保存确定待发送附件。
![](/assets/mail_test_add.png)
## 4、邮件状态查询
#### 菜单路径
系统设置/邮件/邮件状态查询
#### 功能描述
查看发送邮件的状态,失败邮件可查看错误原因。
#### 使用说明
可通过账户代码,主题,发送状态过滤邮件,选取相关邮件后可查看错误信息。
![](/assets/mail_state_query.png)
#### 参数说明
* 发送状态: 发送成功(Y) 正在发送(P) 发送失败(F) 待发送(N)。
......@@ -9,7 +9,7 @@
* [1.1 Git 使用](/git-guide.md "git指令")
* [1.2 Maven 使用](/maven.md "maven使用")
* [1.3 开发环境搭建](/project-create.md)
* [1.4 更新项目的HEL依赖版本](/project-update.md)
* [1.4 更新项目的HLS依赖版本](/project-update.md)
* [1.5 Liquibase](/liquibase-use.md)
* II. 项目开发规范
......@@ -69,7 +69,7 @@
* [6.5 Excel导入导出](/框架功能描述/jad.md)
* [6.6 redis安装和部署](/后端开发/redis.md)
* [6.9 工作流开发指南](/后端开发/activiti_demo.md)
* [6.10 邮件](/框架功能描述/mail.md)
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment