自定义补贴规则

如何使用自定义补贴规则

1. boss里开启补贴自动计算
2. 点击【设置】-【角色与权限】，为需要设置补贴规则的管理员增加“补贴规则”权限‘补贴规则’
3. 具有“补贴规则”权限的管理员，点击【设置】-【补贴规则】，可以新建并上传补贴规则代码（由于每家公司的补贴规则不同，规则代码通常需要联系每刻进行定制化开发，需要收费）
4. 点击【设置】-【单据与流程】，在具体需要用到补贴自动计算的报销单中，选择补贴规则使用。
5. 效果：员工填写对应的单据时，可以自动计算补贴（点击提单时如果未计算过会提示是否计算）

如何开发自定义补贴规则

对象信息

以下对象都在包com.maycur.sdk.rule.domain里 本地开发maven引用如下，具体版本见 http://s1.maycur.cc:5000/content/groups/public/com/maycur/ng-rule-sdk/

<dependency>
    <groupId>com.maycur</groupId>
    <artifactId>ng-rule-sdk</artifactId>
    <version>1.0.0-SNAPSHOT</version>
</dependency>

DateTime指org.joda.time.DateTime

Reimburse（单据）

Employee（员工）

RTRoute（部门信息）

Residence（常驻地）

CustomFormValue（自定义表单内容）

Expense（费用）

ExpenseStandResult（按条件汇总后的费控标准信息）

DistDetailExecResult（费控标准明细信息）

UserAmtVaryUsage（费控金额信息）

MonetaryAmount

ExpenseAllocation（费用分摊）

AllowanceStandardInfo（补贴信息）

AllowanceStandard（补贴标准）

TravelRoute（行程）

TravelPartnerInfo(参与人信息组)

TravelPartner(参与人信息)

ClassPosition(职级信息)

Attendance（考勤信息）

RuleScheduleValue（节假日信息列表）

ScheduleValue（节假日信息）

补贴结果

补贴结果存入AllowanceResult对象

AllowanceResult（补贴结果）

备注：

1）如果费用表单的消费城市范围是区间，可以通过result.setDeparture(), result.setDestination 或者allowanceService.copyLocationFromTravelRoute()该方法设置补贴的消费地点
2）如果费用表单的消费城市范围不是区间，可以通过setConsumeLocation(), 或者下面一个参数的构造方法设置补贴消费地点的值

构造器

  ○ AllowanceResult(DateTime date, String bizCode, BigDecimal amount,String baseCcy, String collectionCcy)
  ○ AllowanceResult(DateTime date, String bizCode, BigDecimal amount,String baseCcy, String collectionCcy, String consumeLocation)
  ○ AllowanceResult(DateTime startDate, DateTime endDate, String bizCode, BigDecimal amount,String baseCcy, String collectionCcy)
  ○ AllowanceResult(DateTime startDate, DateTime endDate, String bizCode, BigDecimal amount,String baseCcy, String collectionCcy，String destination)

自定义字段相关赋值方法（bizCode填写字段对应的业务编码）

  ○ void setTextCustomObject(String bizCode, String value)  文本类型字段赋值
  ○ void setNumberCustomObject(String bizCode, BigDecimal value) 数字类型字段赋值
  ○ void setAmountCustomObject(String bizCode, MonetaryAmount monetaryAmount) 金额类型字段赋值 
  ○ void setOptionCustomObject(String bizCode, String value) 选项类型字段赋值（选项值使用业务编码）

其他

    //针对申请单申请明细配置为“需要在行程下填写申请明细”模式时，使用该方法支持将生成的补贴费用挂在对应行程下。
  ○ setTravelRouteCode($travelRouteCode);  //&travelRouteCode：取值为行程code。

注：使用时间或时间区间对应的补贴类型要设置对应的消费时间格式，不然无法带入。

MonetaryAmount提供一个MonetaryAmount(BigDecimal amount, String currency)构造器

工作区里存在的对象

1、Reimburse 单据信息

drl可以使用的全局对象

1、AllowanceService 提供如下方法

    /**
     *  根据费用的开始结束时间计算出差天数（不考虑时分秒)
     */
    List<DateTime> getTripDiffDays(Expense expense);

    /**
     * 根据行程的开始结束时间计算出差天数（不考虑时分秒)
     */
    List<DateTime> getTripDiffDays(TravelRecord record)

    /**
     * 判断两个时间是否是同一天
     */    
    boolean isSameDay(DateTime startDate,DateTime endDate)

    /**
     * 根据补贴类型和日期汇总补贴
     */
    List<AllowanceResult> getSumAllowancesGroupByAllowanceType(List<AllowanceResult> dailyAllowances)

    /**
     * 根据日期获取对应的补贴标准
     */
    BigDecimal getAllowanceStandard(DateTime date, AllowanceStandardInfo standardInfo) 

    /**
     * 根据日期获取对应的目的地补贴标准
     */
    BigDecimal getDestinationAllowanceStandard(DateTime date, AllowanceStandardInfo standardInfo) 

    /**
     * 根据日期获取对应的参与人出发地补贴标准
     */
    BigDecimal getPartnerAllowanceStandard(DateTime date, List<AllowanceStandardInfo> standardInfos,TravelPartner travelPartner,String ruleBizCode) 

    /**
     * 根据日期获取对应的参与人目的地补贴标准
     */
    BigDecimal getDestinationPartnerAllowanceStandard(DateTime date, List<AllowanceStandardInfo> standardInfos,TravelPartner travelPartner,String ruleBizCode) 


    /**
     * 根据日期获取对应的补贴标准币种
     */
    String getAllowanceStandardCcy(DateTime date, AllowanceStandardInfo standardInfo) 


    /**
     * 根据日期获取对应的目的地补贴标准币种
     */
    String getDestinationAllowanceStandardCcy(DateTime date, AllowanceStandardInfo standardInfo) 


    /**
     * 拷贝费用上的地址信息到补贴上
     */
    void copyLocationFromExpense(Expense expense, AllowanceResult allowanceResult) 


    /**
     * 拷贝行程上的地址信息到补贴上
     */
      void copyLocationFromTravelRoute(TravelRoute travelRoute, AllowanceResult allowanceResult) 

    /**
     * 获取员工的第一个常驻地编码
     */
    String getEmployeePlaceFullCode(Employee employee) 

    /**
     * 获取指定自定义字段的值
     */
    String getCustomFormValue(List<CustomFormValue> customFormValues, String bizCode) 


    /**
     * 获取指定rulBizCode的补贴标准金额
     * @param standardInfos 补贴标准List
     * @param dateTime      时间
     * @param ruleBizCode   补贴标准
     * @param isDestination 是否是目的地
     * @return
     */
    BigDecimal getAllowanceStandardAmountByCodeAndTime(List<AllowanceStandardInfo> standardInfos, DateTime dateTime, String ruleBizCode, boolean isDestination)


    /**
     * 取重复行程天数的就高或者就低标准
     * @param dateTime 重复的日期
     * @param ruleBiCode
     * @param destination 是否取目的地的标准
     * @param high 是否就高
     * @return
     */
    BigDecimal getAmountByDateTime(List<TravelRoute> travelRoutes, DateTime dateTime, String ruleBiCode, boolean destination, boolean high)


    /**
     * 判断出差地点是否是常驻地
     * @param employee 员工信息
     * @param travelRoute 行程信息
     * @param isDestination 是否校验目的地
     * @param isContain 是否完全检验 | 非完全校验 即地址编码 包含关系
     * @return
     */
    boolean isResidence(Employee employee, TravelRoute travelRoute, boolean isDestination, boolean isContain) 


    /**
     * 判断指定日期是否是节假日
     * @param optionCode 节假日表code
     * @param dateTime yyyy-MM-dd
     * @param ruleScheduleValue
     * @return
     */
    boolean isSchedule(String optionCode, String dateTime, RuleScheduleValue ruleScheduleValue)

    /**
     * 判断指定日期是否是周六周末
     * @param dateTime yyyy-MM-dd
     * @return
     */
    public static boolean isDayOfWeek(String dateTime) 

    /**
     * 按照人+日期+格子分组后的费控标准信息
     * @param expenses
     * @return
     */
    public ExpenseStandResult getKeyByFinalDimCodes(List<Expense> expenses)


    /**
     * 按照人+日期+规则分组后的费控标准信息
     * @param expenses
     * @return
     */
    public ExpenseStandResult getKeyByRuleCode(List<Expense> expenses)

2、Logger 日志 引用路径如下

import org.slf4j.Logger;
import com.maycur.sdk.rule.service.AllowanceService;

示例

根据员工住宿生成补贴，根据补贴标准配置生成对应金额的补贴，最后一天不产生补贴

package rules;

import com.maycur.sdk.rule.domain.Expense;
import com.maycur.sdk.rule.domain.Reimburse;
import com.maycur.sdk.rule.domain.AllowanceStandardInfo;
import com.maycur.sdk.rule.domain.MonetaryAmount;
import com.maycur.sdk.rule.domain.result.AllowanceResult;
import com.maycur.sdk.rule.service.AllowanceService;
import org.joda.time.DateTime;
import java.util.Map;
import java.util.List;
import java.math.BigDecimal;

global AllowanceService allowanceService;

dialect  "mvel"

rule "default"
    when
        Reimburse($expenses:expenses)
        $expense : Expense(typeCode=="2001_01",$baseCcy:baseCcy,$collectionCcy:collectionCcy,$endDate:endDate, $allowanceStandardInfos:allowanceStandardInfos) from $expenses
        $allowanceStandardInfo: AllowanceStandardInfo() from $allowanceStandardInfos
        $consumeTime : DateTime() from $expense.days()
        not (eval($endDate == $consumeTime))
    then
        AllowanceResult result = new AllowanceResult($consumeTime,"2023_01",allowanceService.getAllowanceStandard($consumeTime,$allowanceStandardInfo),$baseCcy,$collectionCcy);
        result.setTextCustomObject("C1","1");
        result.setTextCustomObject("C2","2");
        result.setNumberCustomObject("C3", new BigDecimal(3));
        result.setAmountCustomObject("C4", new MonetaryAmount(new BigDecimal(4), "CNY"));
        allowanceService.copyLocationFromExpense($expense, result);
        insert(result);

end

使用时间区间的例子

package rules;

import com.maycur.sdk.rule.domain.Expense;
import com.maycur.sdk.rule.domain.Reimburse;
import com.maycur.sdk.rule.domain.result.AllowanceResult;
import org.joda.time.DateTime;
import java.util.Map;
import java.util.List;
import java.math.BigDecimal;
import com.maycur.sdk.rule.service.AllowanceService;
import com.maycur.sdk.rule.domain.TravelRoute;
import com.maycur.sdk.rule.domain.AllowanceStandardInfo;
import com.maycur.sdk.rule.domain.MonetaryAmount;
import org.joda.time.DateTime;
import org.slf4j.Logger;

global AllowanceService allowanceService;



dialect  "mvel"

rule "default"
    salience 2
    when
        Reimburse($travelRoutes:travelRoutes,$baseCcy:baseCcy,$collectionCcy:collectionCcy)
        $travelRoute : TravelRoute($endDate:new DateTime(endDate.getYear(),endDate.getMonthOfYear(),endDate.getDayOfMonth(),0,0,0),$startDate:new DateTime(startDate.getYear(),startDate.getMonthOfYear(),startDate.getDayOfMonth(),0,0,0),$allowanceStandardInfos:allowanceStandardInfos) from $travelRoutes;
        $consumeTime : DateTime() from allowanceService.getTripDiffDays($travelRoute);
        $allowanceStandardInfo: AllowanceStandardInfo() from $allowanceStandardInfos
        $result:AllowanceResult(bizCode == "2023_10")
        not (eval($endDate == $consumeTime))
    then
        BigDecimal standard = allowanceService.getAllowanceStandard($consumeTime,$allowanceStandardInfo);
        $result.setAmount($result.getAmount().add(standard));
        update($result);
end

rule "生成补贴"
    salience 10
    when
        Reimburse($travelRoutes:travelRoutes,$baseCcy:baseCcy,$collectionCcy:collectionCcy)
        $travelRoute : TravelRoute($endDate:new DateTime(endDate.getYear(),endDate.getMonthOfYear(),endDate.getDayOfMonth(),0,0,0),$startDate:new DateTime(startDate.getYear(),startDate.getMonthOfYear(),startDate.getDayOfMonth(),0,0,0),$allowanceStandardInfos:allowanceStandardInfos) from $travelRoutes;
    then
        AllowanceResult result = new AllowanceResult($startDate,$endDate,"2023_10",BigDecimal.ZERO,$baseCcy,$collectionCcy);
        allowanceService.copyLocationFromTravelRoute($travelRoute, result);
        insert(result);
end

修改记录

2020-05-13：初稿
2020-07-03：员工对象增加一些字段，费用、行程上增加对应的补贴标准信息，补贴结果对象增删字段（构造器有变化），AllowanceService增加三个新方法
2020-08-05：补贴结果增加对选项类型的自定义字段的处理
2020-08-20：增加根据日期获取对应的目的地补贴标准
2020-09-01：补贴结果增加时间区间
2020-10-10：增加获取补贴标准币种的方法
2021-05-27：新增单据级参与人信息，新增申请单补贴，申请单补贴和报销单公用一个rule-sdk
2021-06-03：新增单据、行程参与人补贴标准信息，allowanceService新增获取参与人标准的方法，同时旧方法也可用于获取参与人标准（入参不同），更新rule-sdk版本到1.06
2021-06-09：补贴支持访问外部系统发起http请求HttpURLConnection
2021-08-30：新增allowanceResult，目的地构造方法；更新获取参与人补贴标准的方法；更新sdk版本到1.0.7
2021-11-04：补贴行程信息优化排序，优先按照行程开始日期进行排序
2022-01-12:    sdk 增加一些常用方法抽取，更新sdk 版本到1.0.8
2022-01-25：费用增加是否含早字段
2022-02-11：费用新增分摊表单信息，更新sdk 版本到1.0.9
2022-05-13：行程增加travelRouteCode字段，用于申请单补贴单独在行程下显示
2022-06-09：行程新增出发地和目的地名称
2023-01-03：补贴新增节假日表信息，以及isSchedule 判断是否是节假日的方法， sdk版本到1.1.1
2023-04-01：补贴新增费控标准信息，sdk版本更新到1.1.2
2023-04-23：迁移openapi文档