jp.co.slcs.kaiden.v2.product_labormgr.foundation.manager.leave.impl

クラス LeaveManagerImpl

java.lang.Object

jp.co.slcs.kaiden.v2.base.foundation.manager.AbstractGenericManager<LeaveManagerDto>

jp.co.slcs.kaiden.v2.product_labormgr.foundation.manager.leave.impl.LeaveManagerImpl

すべての実装されたインタフェース:

LeaveManager

public class LeaveManagerImpl
extends AbstractGenericManager<LeaveManagerDto>
implements LeaveManager

休暇マネージャの実装.

本APIは、主にデータベース操作を行いますが、より業務的な機能を付加した操作を提供します。
使用する際には、LeaveManagerDtoクラスまたはそのリストをパラメータとして渡すと、
LeaveManagerDtoクラスまたはそのリストが戻り値として返却されます。
(一部例外あり。各APIを参照。)

作成者:

Sumitomo Life Information Systems Co.,Ltd.

ネストされたクラスのサマリー

クラスから継承されたネストされたクラス/インタフェース jp.co.slcs.kaiden.v2.base.foundation.manager.AbstractGenericManager

AbstractGenericManager.KeywordsSearchFilterImpl

インタフェースから継承されたネストされたクラス/インタフェース jp.co.slcs.kaiden.v2.product_labormgr.foundation.manager.leave.LeaveManager

LeaveManager.AdjustLeaveDto, LeaveManager.AppendLeaveDto, LeaveManager.EditLeaveDto, LeaveManager.ExcludeLeaveActionDto, LeaveManager.KaidenAdjustLeaveOutTermException, LeaveManager.LeaveActionResultDto, LeaveManager.LeaveBalanceDto, LeaveManager.RemoveLeaveDto, LeaveManager.TakeLeaveDayDto, LeaveManager.TakeLeaveHourDto, LeaveManager.TakeLeaveHourUpperDto

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
CompanySettingsHelper	companySettingsHelper CompanySettingsHelper.
DateHelper	dateHelper DateHelper.
IdentifierHelper	identifierHelper IdentifierHelper.
jp.co.slcs.kaiden.v2.product_labormgr.foundation.model.service.K31tLeaveActResultService	k31tLeaveActResultService K31tLeaveActResultService.
jp.co.slcs.kaiden.v2.product_labormgr.foundation.model.service.K31tLeaveActService	k31tLeaveActService K31tLeaveActService.
jp.co.slcs.kaiden.v2.product_labormgr.foundation.model.service.K31tLeaveService	k31tLeaveService K31tLeaveService.
PropertyHelper	propertyHelper PropertyHelper.

クラスから継承されたフィールド jp.co.slcs.kaiden.v2.base.foundation.manager.AbstractGenericManager

contextHelper, dtoClass, systemLocaleHelper

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
LeaveManagerImpl()

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	adjustLeave(LeaveManager.AdjustLeaveDto adjust) 休暇調整.
void	adjustLeave(LeaveManager.AdjustLeaveDto adjust, boolean isRefreshBalance) 休暇調整.
void	appendLeave(LeaveManager.AppendLeaveDto append) 休暇付与.
void	appendLeave(LeaveManager.AppendLeaveDto append, boolean isRefreshBalance) 休暇付与.
protected <T extends KaidenDto> List<T>	complementEndDateForDisp(Class<T> clazz, List<T> dataList) 終了日を前日に設定.
protected <T extends KaidenDto> T	complementEndDateForDisp(Class<T> clazz, T data) 終了日を前日に設定.
void	editLeave(LeaveManager.EditLeaveDto edit) 休暇編集.
void	editLeave(LeaveManager.EditLeaveDto edit, boolean isRefreshBalance) 休暇編集.
List<LeaveManager.TakeLeaveHourUpperDto>	getTakeLeaveHourUpper(String userCd, String companyCd, Timestamp periodStartDate, Timestamp periodEndDate) 時間年休取得上限情報を返却.
List<ValidateDefsDto>	getValidateDefsDtoList4AdjustLeave() 休暇調整時の検証定義リストを返却します.
List<ValidateDefsDto>	getValidateDefsDtoList4AppendLeave() 休暇付与時の検証定義リストを返却します.
List<ValidateDefsDto>	getValidateDefsDtoList4EditLeave() 休暇編集時の検証定義リストを返却します.
List<ValidateDefsDto>	getValidateDefsDtoList4RemoveLeave() 休暇削除時の検証定義リストを返却します.
boolean	isGrantedLeave(String userCd, String companyCd, String leaveTypeCd, Timestamp searchCriteriaDate) 検索基準日時点で休暇が付与されているか判定.
void	leaveCancel(String userCd, String companyCd, Timestamp targetDate) 対象日のすべての休暇（日）、休暇（時間）を取り消し.
void	leaveCancel(String userCd, String companyCd, Timestamp targetDate, boolean isRefreshBalance) 対象日のすべての休暇（日）、休暇（時間）を取り消し.
void	leaveCancelBatch(String userCd, String companyCd, Timestamp startDate, Timestamp endDate) 対象日の範囲すべての休暇（日）、休暇（時間）を取り消し.
void	refreshBalance(String userCd, String companyCd) 休暇残日数・残時間数の再計算.
void	removeLeave(LeaveManager.RemoveLeaveDto remove) 休暇削除.
void	removeLeave(LeaveManager.RemoveLeaveDto remove, boolean isRefreshBalance) 休暇削除.
LeaveManagerDto	select(LeaveManagerDto criteria, AuthorityCriteriaDto authCriteria) 主キー検索.
List<LeaveManager.LeaveActionResultDto>	selectActionHistory(String userCd, String companyCd, String leaveId, AuthorityCriteriaDto authCriteria) 休暇取得アクション履歴を返却.
List<LeaveManager.LeaveActionResultDto>	selectActionHistoryIgnoreAuthCompany(String userCd, String companyCd, String leaveId) 休暇取得アクション履歴を返却（認可無視）.
List<LeaveManager.ExcludeLeaveActionDto>	selectExcludeLeaveAction(String userCd, String companyCd, String leaveTypeCd, AuthorityCriteriaDto authCriteria) どの休暇にも紐づけできなかった休暇アクション一覧を返却.
List<LeaveManager.ExcludeLeaveActionDto>	selectExcludeLeaveActionIgnoreAuthCompany(String userCd, String companyCd, String leaveTypeCd) どの休暇にも紐づけできなかった休暇アクション一覧を返却（認可無視）.
LeaveManagerDto	selectIgnoreAuthCompany(LeaveManagerDto criteria) 主キー検索（認可設定無視）.
List<LeaveManagerDto>	selectList(LeaveManagerDto criteria, AuthorityCriteriaDto authCriteria, List<OrderDto> order) 汎用検索.
List<LeaveManagerDto>	selectListIgnoreAuthCompany(LeaveManagerDto criteria, List<OrderDto> order) 汎用検索（認可設定無視）.
Map<String,Object>	selectListKeywordFilter(LeaveManagerDto criteria, List<OrderDto> order, KeywordsCriteriaDto keywordsCriteria, AuthorityCriteriaDto authCriteria) キーワード検索.
Map<String,Object>	selectListKeywordFilterIgnoreAuthCompany(LeaveManagerDto criteria, List<OrderDto> order, KeywordsCriteriaDto keywordsCriteria) キーワード検索（認可設定無視）.
List<LeaveManagerDto>	selectListWithReference(LeaveManagerDto criteria, List<OrderDto> order, AuthorityCriteriaDto authCriteria) 参照検索.
List<LeaveManagerDto>	selectListWithReferenceIgnoreAuthCompany(LeaveManagerDto criteria, List<OrderDto> order) 参照検索(認可設定無視).
List<Map<String,Object>>	selectUserLeaveBalance(String userCd, String companyCd, Timestamp criteriaDate) 特定ユーザの休暇残を返却.
Map<String,Object>	selectUserLeaveListKeywordFilter(LeaveManagerDto criteria, List<OrderDto> order, KeywordsCriteriaDto keywordsCriteria, AuthorityCriteriaDto authCriteria) ユーザマスタ起点：キーワード検索.
Map<String,Object>	selectUserLeaveListKeywordFilterIgnoreAuthCompany(LeaveManagerDto criteria, List<OrderDto> order, KeywordsCriteriaDto keywordsCriteria) ユーザマスタ起点：キーワード検索（認可設定無視）.
void	takeLeaveOfDay(LeaveManager.TakeLeaveDayDto takeLeaveDay) 休暇取得.
void	takeLeaveOfDay(LeaveManager.TakeLeaveDayDto takeLeaveDay, boolean isRefreshBalance) 休暇取得.
void	takeLeaveOfHour(LeaveManager.TakeLeaveHourDto takeLeaveHourDto) 時間休取得.
void	takeLeaveOfHour(LeaveManager.TakeLeaveHourDto takeLeaveHourDto, boolean isRefreshBalance) 時間休取得.
List<KaidenValidateResult>	validate4AdjustLeave(Map<String,Object> data, Map<String,String> surfaces) 休暇調整時のバリデーション.
List<KaidenValidateResult>	validate4AppendLeave(Map<String,Object> data, Map<String,String> surfaces) 休暇付与時のバリデーション.
List<KaidenValidateResult>	validate4EditLeave(Map<String,Object> data, Map<String,String> surfaces) 休暇編集時のバリデーション.
List<KaidenValidateResult>	validate4RemoveLeave(Map<String,Object> data, Map<String,String> surfaces) 休暇削除時のバリデーション.

クラスから継承されたメソッド jp.co.slcs.kaiden.v2.base.foundation.manager.AbstractGenericManager

_getFilterTargetFields, delete, deleteBatch, getCount, getCount, getCount, getCountBySql, getCountBySql, getCountBySql, getCriteria4Sql, getCriteria4SqlParmitCompany, getCriteria4SqlParmitCompany, getPkCriteria4Sql, getPkCriteria4SqlParmitCompany, insert, insertBatch, parameterCheck, selectBeanMapListBySql, selectBeanMapListBySqlFilter, selectBeanMapListBySqlFilter, selectBeanMapListBySqlFilterIgnoreAuthority, selectBeanMapListBySqlIgnoreAuthority, selectByPk, selectByPk4Update, selectByPkIgnoreAuth4Update, selectByPkIgnoreAuthority, selectBySql, selectBySql, selectBySqlFilter, selectBySqlFilter, selectBySqlIgnoreAuthority, selectBySqlIgnoreAuthority, selectList, selectListByFilter, selectListByKeywords, selectListByKeywordsFilter, selectListByKeywordsIgnoreAuthority, selectListBySqlFilter, selectListBySqlFilterIgnoreAuthority, selectListIgnoreAuthority, setFilterTargetField, update, update, updateBatch, updateBatch, updateBySqlFile, updateBySqlFile, updateBySqlFile, updateIncludesBatch, validAccessAuthority, validAccessAuthority

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

k31tLeaveService

@Autowired
public jp.co.slcs.kaiden.v2.product_labormgr.foundation.model.service.K31tLeaveService k31tLeaveService

K31tLeaveService.

k31tLeaveActService

@Autowired
public jp.co.slcs.kaiden.v2.product_labormgr.foundation.model.service.K31tLeaveActService k31tLeaveActService

K31tLeaveActService.

k31tLeaveActResultService

@Autowired
public jp.co.slcs.kaiden.v2.product_labormgr.foundation.model.service.K31tLeaveActResultService k31tLeaveActResultService

K31tLeaveActResultService.

dateHelper

@Autowired
public DateHelper dateHelper

DateHelper.

identifierHelper

@Autowired
public IdentifierHelper identifierHelper

IdentifierHelper.

propertyHelper

@Autowired
public PropertyHelper propertyHelper

PropertyHelper.

companySettingsHelper

@Autowired
public CompanySettingsHelper companySettingsHelper

CompanySettingsHelper.

コンストラクタの詳細

LeaveManagerImpl

public LeaveManagerImpl()

メソッドの詳細

select

public LeaveManagerDto select(LeaveManagerDto criteria,
                              AuthorityCriteriaDto authCriteria)

主キー検索.

定義:

select インタフェース内 LeaveManager

パラメータ:

criteria - 検索条件

authCriteria - 認可判定条件

戻り値:

検索結果

関連項目:

MasterManager#select(KaidenDto, AuthorityCriteriaDto)

selectIgnoreAuthCompany

public LeaveManagerDto selectIgnoreAuthCompany(LeaveManagerDto criteria)

主キー検索（認可設定無視）.

定義:

selectIgnoreAuthCompany インタフェース内 LeaveManager

パラメータ:

criteria - 検索条件

戻り値:

検索結果

関連項目:

MasterManager#selectIgnoreAuthCompany(KaidenDto)

selectList

public List<LeaveManagerDto> selectList(LeaveManagerDto criteria,
                                        AuthorityCriteriaDto authCriteria,
                                        List<OrderDto> order)

汎用検索.

定義:

selectList インタフェース内 LeaveManager

パラメータ:

criteria - 検索条件

authCriteria - 認可判定条件

order - ソート項目

戻り値:

検索結果

関連項目:

MasterManager#selectList(KaidenDto, AuthorityCriteriaDto, List)

selectListIgnoreAuthCompany

public List<LeaveManagerDto> selectListIgnoreAuthCompany(LeaveManagerDto criteria,
                                                         List<OrderDto> order)

汎用検索（認可設定無視）.

定義:

selectListIgnoreAuthCompany インタフェース内 LeaveManager

パラメータ:

criteria - 検索条件

order - ソート項目

戻り値:

検索結果

関連項目:

MasterManager#selectListIgnoreAuthCompany(KaidenDto, List)

selectListWithReference

public List<LeaveManagerDto> selectListWithReference(LeaveManagerDto criteria,
                                                     List<OrderDto> order,
                                                     AuthorityCriteriaDto authCriteria)

参照検索.

定義:

selectListWithReference インタフェース内 LeaveManager

パラメータ:

criteria - 検索条件

order - ソート順

authCriteria - 認可判定条件

戻り値:

検索結果

関連項目:

MasterManager#selectListWithReference(KaidenDto, List, AuthorityCriteriaDto)

selectListWithReferenceIgnoreAuthCompany

public List<LeaveManagerDto> selectListWithReferenceIgnoreAuthCompany(LeaveManagerDto criteria,
                                                                      List<OrderDto> order)

参照検索(認可設定無視).

定義:

selectListWithReferenceIgnoreAuthCompany インタフェース内 LeaveManager

パラメータ:

criteria - 検索条件

order - ソート順

戻り値:

検索結果

関連項目:

MasterManager#selectListWithReferenceIgnoreAuthCompany(KaidenDto, List)

selectListKeywordFilter

public Map<String,Object> selectListKeywordFilter(LeaveManagerDto criteria,
                                                  List<OrderDto> order,
                                                  KeywordsCriteriaDto keywordsCriteria,
                                                  AuthorityCriteriaDto authCriteria)

キーワード検索.

定義:

selectListKeywordFilter インタフェース内 LeaveManager

パラメータ:

criteria - 検索条件

order - ソート順

keywordsCriteria - キーワード条件

authCriteria - 認可判定条件

戻り値:

キーワード検索結果

関連項目:

MasterManager#selectListKeywordFilter(KaidenDto, List, KeywordsCriteriaDto, AuthorityCriteriaDto)

selectListKeywordFilterIgnoreAuthCompany

public Map<String,Object> selectListKeywordFilterIgnoreAuthCompany(LeaveManagerDto criteria,
                                                                   List<OrderDto> order,
                                                                   KeywordsCriteriaDto keywordsCriteria)

キーワード検索（認可設定無視）.

定義:

selectListKeywordFilterIgnoreAuthCompany インタフェース内 LeaveManager

パラメータ:

criteria - 検索条件

order - ソート順

keywordsCriteria - キーワード条件

戻り値:

キーワード検索結果

関連項目:

MasterManager#selectListKeywordFilterIgnoreAuthCompany(KaidenDto, List, KeywordsCriteriaDto)

selectUserLeaveListKeywordFilter

public Map<String,Object> selectUserLeaveListKeywordFilter(LeaveManagerDto criteria,
                                                           List<OrderDto> order,
                                                           KeywordsCriteriaDto keywordsCriteria,
                                                           AuthorityCriteriaDto authCriteria)

ユーザマスタ起点：キーワード検索.

検索条件で利用できるフィールドは以下の通り

フィールド	値	必須/任意・他
searchCriteriaDate	検索基準日	必須
leaveTypeCd	休暇種別コード	必須
localeId	ロケールID	必須
companyCd	会社コード	任意
userCd	ユーザコード	任意
userName	ユーザ名	任意 ※部分一致検索
departmentCompanyCd	組織検索会社コード	任意 ※ 組織検索会社コード・組織セットコード・組織コードは同時に設定が必要
departmentSetCd	組織セットコード	任意 ※ 組織検索会社コード・組織セットコード・組織コードは同時に設定が必要
departmentCd	組織コード	任意 ※ 組織検索会社コード・組織セットコード・組織コードは同時に設定が必要
includeUnder	下位組織含む	任意 ※ 組織検索会社コード・組織セットコード・組織コードと同時に設定が必要

返却される値は以下の通り

フィールド	値
userCd	ユーザコード
userName	ユーザ名
balanceDays	休暇残日数
balanceHours	休暇残時間数

定義:

selectUserLeaveListKeywordFilter インタフェース内 LeaveManager

パラメータ:

criteria - 検索条件

order - ソート順

keywordsCriteria - キーワード条件

authCriteria - 認可判定条件

戻り値:

キーワード検索結果

関連項目:

MasterManager#selectListKeywordFilter(KaidenDto, List, KeywordsCriteriaDto, AuthorityCriteriaDto)

selectUserLeaveListKeywordFilterIgnoreAuthCompany

public Map<String,Object> selectUserLeaveListKeywordFilterIgnoreAuthCompany(LeaveManagerDto criteria,
                                                                            List<OrderDto> order,
                                                                            KeywordsCriteriaDto keywordsCriteria)

ユーザマスタ起点：キーワード検索（認可設定無視）.

定義:

selectUserLeaveListKeywordFilterIgnoreAuthCompany インタフェース内 LeaveManager

パラメータ:

criteria - 検索条件

order - ソート順

keywordsCriteria - キーワード条件

戻り値:

キーワード検索結果

関連項目:

LeaveManager.selectListKeywordFilter(LeaveManagerDto, List, KeywordsCriteriaDto, AuthorityCriteriaDto), MasterManager#selectListKeywordFilterIgnoreAuthCompany(KaidenDto, List, KeywordsCriteriaDto)

selectExcludeLeaveAction

public List<LeaveManager.ExcludeLeaveActionDto> selectExcludeLeaveAction(String userCd,
                                                                         String companyCd,
                                                                         String leaveTypeCd,
                                                                         AuthorityCriteriaDto authCriteria)

どの休暇にも紐づけできなかった休暇アクション一覧を返却.

定義:

selectExcludeLeaveAction インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

leaveTypeCd - 休暇種別コード

authCriteria - 認可判定条件

戻り値:

どの休暇にも紐づけできなかった休暇アクション一覧

selectExcludeLeaveActionIgnoreAuthCompany

public List<LeaveManager.ExcludeLeaveActionDto> selectExcludeLeaveActionIgnoreAuthCompany(String userCd,
                                                                                          String companyCd,
                                                                                          String leaveTypeCd)

どの休暇にも紐づけできなかった休暇アクション一覧を返却（認可無視）.

定義:

selectExcludeLeaveActionIgnoreAuthCompany インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

leaveTypeCd - 休暇種別コード

戻り値:

どの休暇にも紐づけできなかった休暇アクション一覧

validate4AppendLeave

public List<KaidenValidateResult> validate4AppendLeave(Map<String,Object> data,
                                                       Map<String,String> surfaces)

休暇付与時のバリデーション.

以下のバリデーションを行います。

項目名	検証内容
ユーザコード	必須、マスタ存在確認
会社コード	必須、マスタ存在確認
休暇種別コード	必須、項目マスタ存在確認桁
付与日数	必須、小数（3、1）、正規表現（小数点数が0もしくは5のみ）、数値範囲（0.5-999.5）
開始日	必須、日付（システム期間内）
終了日	必須、日付（システム期間内）、開始日・終了日大小チェック
実行ユーザコード	必須、マスタ存在確認

定義:

validate4AppendLeave インタフェース内 LeaveManager

パラメータ:

data - バリデーション対象データ

surfaces - バリデーションエラー用サーフェス

戻り値:

バリデーション結果

appendLeave

public void appendLeave(LeaveManager.AppendLeaveDto append)
                 throws KaidenDuplicationEntryException

休暇付与.

引数に対するバリデーション（LeaveManager.validate4AppendLeave(Map, Map)を事前に行ってください。

残日数・残時間数の再計算を即時行います

定義:

appendLeave インタフェース内 LeaveManager

パラメータ:

append - 付与情報

例外:

KaidenDuplicationEntryException - 同一開始日ですでに休暇が登録されている

appendLeave

public void appendLeave(LeaveManager.AppendLeaveDto append,
                        boolean isRefreshBalance)
                 throws KaidenDuplicationEntryException

休暇付与.

引数に対するバリデーション（LeaveManager.validate4AppendLeave(Map, Map)を事前に行ってください。

定義:

appendLeave インタフェース内 LeaveManager

パラメータ:

append - 付与情報

isRefreshBalance - falseを指定すると、残日数・残時間数の再計算を行いません。
別途 LeaveManager.refreshBalance(String, String)を実行する必要があります。

例外:

KaidenDuplicationEntryException - 同一開始日ですでに休暇が登録されている

validate4AdjustLeave

public List<KaidenValidateResult> validate4AdjustLeave(Map<String,Object> data,
                                                       Map<String,String> surfaces)

休暇調整時のバリデーション.

以下のバリデーションを行います。

項目名	検証内容
ユーザコード	必須、マスタ存在確認
会社コード	必須、マスタ存在確認
休暇ID	必須
調整日数	いずれか0でない（調整日数、調整時間数）、小数（3、1）、正規表現（小数点数が0もしくは5のみ）、数値範囲（-999.5-999.5）
調整時間数	いずれか0でない（調整日数、調整時間数）、整数（2ケタ）、数値範囲（-99-99）
調整適用日	必須、日付（システム期間内）
調整理由	必須、日付（システム期間内）、開始日・終了日大小チェック
実行ユーザコード	必須、マスタ存在確認

定義:

validate4AdjustLeave インタフェース内 LeaveManager

パラメータ:

data - バリデーション対象データ

surfaces - バリデーションエラー用サーフェス

戻り値:

バリデーション結果

adjustLeave

public void adjustLeave(LeaveManager.AdjustLeaveDto adjust)
                 throws KaidenNotFoundTargetDataException,
                        LeaveManager.KaidenAdjustLeaveOutTermException

休暇調整.

引数に対するバリデーション（LeaveManager.validate4AdjustLeave(Map, Map)を事前に行ってください。

残日数・残時間数の再計算を即時行います

定義:

adjustLeave インタフェース内 LeaveManager

パラメータ:

adjust - 調整内容

例外:

KaidenNotFoundTargetDataException - 調整対象の休暇が見つからない

LeaveManager.KaidenAdjustLeaveOutTermException - 調整適用日が有効期間内にない

adjustLeave

public void adjustLeave(LeaveManager.AdjustLeaveDto adjust,
                        boolean isRefreshBalance)
                 throws KaidenNotFoundTargetDataException,
                        LeaveManager.KaidenAdjustLeaveOutTermException

休暇調整.

引数に対するバリデーション（LeaveManager.validate4AdjustLeave(Map, Map)を事前に行ってください。

定義:

adjustLeave インタフェース内 LeaveManager

パラメータ:

adjust - 調整内容

isRefreshBalance - falseを指定すると、残日数・残時間数の再計算を行いません。
別途 LeaveManager.refreshBalance(String, String)を実行する必要があります。

例外:

KaidenNotFoundTargetDataException - 調整対象の休暇が見つからない

LeaveManager.KaidenAdjustLeaveOutTermException - 調整適用日が有効期間内にない

validate4RemoveLeave

public List<KaidenValidateResult> validate4RemoveLeave(Map<String,Object> data,
                                                       Map<String,String> surfaces)

休暇削除時のバリデーション.

以下のバリデーションを行います。

項目名	検証内容
ユーザコード	必須、マスタ存在確認
会社コード	必須、マスタ存在確認
休暇ID	必須
調整理由	必須、最大文字数（1000文字）
実行ユーザコード	必須、マスタ存在確認

定義:

validate4RemoveLeave インタフェース内 LeaveManager

パラメータ:

data - バリデーション対象データ

surfaces - バリデーションエラー用サーフェス

戻り値:

バリデーション結果

removeLeave

public void removeLeave(LeaveManager.RemoveLeaveDto remove)

休暇削除.

残日数・残時間数の再計算を即時行います

定義:

removeLeave インタフェース内 LeaveManager

パラメータ:

remove - 削除対象の休暇

removeLeave

public void removeLeave(LeaveManager.RemoveLeaveDto remove,
                        boolean isRefreshBalance)

休暇削除.

定義:

removeLeave インタフェース内 LeaveManager

パラメータ:

remove - 削除対象の休暇

isRefreshBalance - falseを指定すると、残日数・残時間数の再計算を行いません。
別途 LeaveManager.refreshBalance(String, String)を実行する必要があります。

validate4EditLeave

public List<KaidenValidateResult> validate4EditLeave(Map<String,Object> data,
                                                     Map<String,String> surfaces)

休暇編集時のバリデーション.

以下のバリデーションを行います。

項目名	検証内容
ユーザコード	必須、マスタ存在確認
会社コード	必須、マスタ存在確認
休暇ID	必須
終了日	必須、日付（システム期間内）、開始日・終了日大小チェック
調整理由	必須、最大文字数（1000文字）
実行ユーザコード	必須、マスタ存在確認

定義:

validate4EditLeave インタフェース内 LeaveManager

パラメータ:

data - バリデーション対象データ

surfaces - バリデーションエラー用サーフェス

戻り値:

バリデーション結果

editLeave

public void editLeave(LeaveManager.EditLeaveDto edit)
               throws KaidenNotFoundTargetDataException

休暇編集.

引数に対するバリデーション（LeaveManager.validate4EditLeave(Map, Map)を事前に行ってください。

残日数・残時間数の再計算を即時行います

定義:

editLeave インタフェース内 LeaveManager

パラメータ:

edit - 編集対象の休暇

例外:

KaidenNotFoundTargetDataException - 編集対象の休暇が見つからない

editLeave

public void editLeave(LeaveManager.EditLeaveDto edit,
                      boolean isRefreshBalance)
               throws KaidenNotFoundTargetDataException

休暇編集.

引数に対するバリデーション（LeaveManager.validate4EditLeave(Map, Map)を事前に行ってください。

定義:

editLeave インタフェース内 LeaveManager

パラメータ:

edit - 編集対象の休暇

isRefreshBalance - falseを指定すると、残日数・残時間数の再計算を行いません。
別途 LeaveManager.refreshBalance(String, String)を実行する必要があります。

例外:

KaidenNotFoundTargetDataException - 編集対象の休暇が見つからない

leaveCancel

public void leaveCancel(String userCd,
                        String companyCd,
                        Timestamp targetDate)

対象日のすべての休暇（日）、休暇（時間）を取り消し.

未設定フィールドがある場合KaidenIllegalParametersExceptionがスローされます。
指定された日に休暇を取得していない場合は何もしません。

残日数・残時間数の再計算を即時行います。

定義:

leaveCancel インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

targetDate - targetDate 対象日

leaveCancel

public void leaveCancel(String userCd,
                        String companyCd,
                        Timestamp targetDate,
                        boolean isRefreshBalance)

対象日のすべての休暇（日）、休暇（時間）を取り消し.

未設定フィールドがある場合KaidenIllegalParametersExceptionがスローされます。
指定された日に休暇を取得していない場合は何もしません。

パラメータで残日数・残時間数の再計算の実行有無が選択可能です。

定義:

leaveCancel インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

targetDate - targetDate 対象日

isRefreshBalance - falseを指定すると、残日数・残時間数の再計算を行いません。別途 LeaveManager.refreshBalance(String, String) を実行する必要があります。

leaveCancelBatch

public void leaveCancelBatch(String userCd,
                             String companyCd,
                             Timestamp startDate,
                             Timestamp endDate)

対象日の範囲すべての休暇（日）、休暇（時間）を取り消し.

未設定フィールドがある場合KaidenIllegalParametersExceptionがスローされます。
指定された日に休暇を取得していない場合は何もしません。

残日数・残時間数の再計算を行いません。
別途 LeaveManager.refreshBalance(String, String) を実行する必要があります。

定義:

leaveCancelBatch インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

startDate - 対象の範囲（From）

endDate - 対象の範囲（To）

takeLeaveOfDay

public void takeLeaveOfDay(LeaveManager.TakeLeaveDayDto takeLeaveDay)

休暇取得.

未設定フィールドがある場合およびLeaveManager.TakeLeaveDayDto.leaveDaysが0の場合にはKaidenIllegalParametersExceptionがスローされます。

残日数・残時間数の再計算を即時行います

残日数・残時間数の再計算を行う設定で、 takeLeaveOfDay(TakeLeaveDayDto, boolean) を実行します。

定義:

takeLeaveOfDay インタフェース内 LeaveManager

パラメータ:

takeLeaveDay - 休暇取得情報

takeLeaveOfDay

public void takeLeaveOfDay(LeaveManager.TakeLeaveDayDto takeLeaveDay,
                           boolean isRefreshBalance)

休暇取得.

未設定フィールドがある場合およびLeaveManager.TakeLeaveDayDto.leaveDaysが0の場合にはKaidenIllegalParametersExceptionがスローされます。

下記内容で休暇アクションテーブルにデータを登録します。

論理名	物理名	設定元	設定内容
ユーザコード	userCd	パラメータ	userCd
会社コード	companyCd	パラメータ	companyCd
休暇種別コード	leaveTypeCd	パラメータ	leaveTypeCd
アクションid	actionId	固定値	自動採番
休暇アクションコード	leaveActionCd	固定値	80
休暇id	leaveId	固定値	Null
増減日	incdecDate	パラメータ	targetDate
1日当たり時間年休数	leaveHourPerDay	パラメータ	leaveHourPerDay
休暇日数	leaveDays	固定値	leaveDays * -1
休暇時間数	leaveHours	パラメータ	Null
変更前開始日	startDateEditFrom	固定値	Null
変更前終了日	endDateEditFrom	固定値	Null
変更後開始日	startDateEditTo	固定値	Null
変更後終了日	endDateEditTo	固定値	Null
備考	note	固定値	Null
アクション日時	actionTs	固定値	システム日付
実行ユーザコード	actionUserCd	パラメータ	actionUserCd
予備項目A～J	extensionA～J	固定値	Null

パラメータisRefreshBalanceがtrueの場合、休暇アクション登録後に休暇残日数・残時間数の再計算を行います。

定義:

takeLeaveOfDay インタフェース内 LeaveManager

パラメータ:

takeLeaveDay - 休暇取得情報

isRefreshBalance - falseを指定すると、残日数・残時間数の再計算を行いません。
別途 LeaveManager.refreshBalance(String, String)を実行する必要があります。

takeLeaveOfHour

public void takeLeaveOfHour(LeaveManager.TakeLeaveHourDto takeLeaveHourDto)

時間休取得.

残日数・残時間数の再計算を即時行います

残日数・残時間数の再計算を行う設定で、 takeLeaveOfHour(akeLeaveDayDto, boolean)を実行します。

定義:

takeLeaveOfHour インタフェース内 LeaveManager

パラメータ:

takeLeaveHourDto - 休暇（時間休）取得情報

takeLeaveOfHour

public void takeLeaveOfHour(LeaveManager.TakeLeaveHourDto takeLeaveHourDto,
                            boolean isRefreshBalance)

時間休取得.

未設定フィールドがある場合およびLeaveManager.TakeLeaveHourDto.leaveHoursが0の場合にはKaidenIllegalParametersExceptionがスローされます。

下記内容で休暇アクションテーブルにデータを登録します。

論理名	物理名	設定元	設定内容
ユーザコード	userCd	パラメータ	userCd
会社コード	companyCd	パラメータ	companyCd
休暇種別コード	leaveTypeCd	パラメータ	leaveTypeCd
アクションid	actionId	固定値	自動採番
休暇アクションコード	leaveActionCd	固定値	90
休暇id	leaveId	固定値	Null
増減日	incdecDate	パラメータ	targetDate
1日当たり時間年休数	leaveHourPerDay	パラメータ	leaveHourPerDay
休暇日数	leaveDays	固定値	Null
休暇時間数	leaveHours	パラメータ	leaveHours * -1
変更前開始日	startDateEditFrom	固定値	Null
変更前終了日	endDateEditFrom	固定値	Null
変更後開始日	startDateEditTo	固定値	Null
変更後終了日	endDateEditTo	固定値	Null
備考	note	固定値	Null
アクション日時	actionTs	固定値	システム日付
実行ユーザコード	actionUserCd	パラメータ	actionUserCd
予備項目A～J	extensionA～J	固定値	Null

パラメータisRefreshBalanceがtrueの場合、休暇アクション登録後に休暇残日数・残時間数の再計算を行います。

定義:

takeLeaveOfHour インタフェース内 LeaveManager

パラメータ:

takeLeaveHourDto - 休暇（時間休）取得情報

isRefreshBalance - falseを指定すると、残日数・残時間数の再計算を行いません。
別途 LeaveManager.refreshBalance(String, String)を実行する必要があります。

refreshBalance

public void refreshBalance(String userCd,
                           String companyCd)

休暇残日数・残時間数の再計算.

定義:

refreshBalance インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

selectActionHistory

public List<LeaveManager.LeaveActionResultDto> selectActionHistory(String userCd,
                                                                   String companyCd,
                                                                   String leaveId,
                                                                   AuthorityCriteriaDto authCriteria)

休暇取得アクション履歴を返却.

休暇アクションコードが「'80'：休暇取得（日）」、または、「'90'：休暇取得（時間）」のデータを取得します。

本メソッドのパラメータは検索条件として下記の通り使用します。

論理名	物理名	必須/任意	条件
ユーザコード	userCd	必須	完全一致
会社コード	companyCd	必須	完全一致
休暇ID	localeId	必須	完全一致

ソート順は下記となります。

1. 増減日(昇順)
2. 休暇アクションコード(昇順)
3. 休暇ID(昇順)

定義:

selectActionHistory インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

leaveId - 休暇Id

authCriteria - 認可判定条件

戻り値:

休暇アクション履歴

selectActionHistoryIgnoreAuthCompany

public List<LeaveManager.LeaveActionResultDto> selectActionHistoryIgnoreAuthCompany(String userCd,
                                                                                    String companyCd,
                                                                                    String leaveId)

休暇取得アクション履歴を返却（認可無視）.

休暇アクションコードが「'80'：休暇取得（日）」、または、「'90'：休暇取得（時間）」のデータを取得します。

本メソッドのパラメータは検索条件として下記の通り使用します。

論理名	物理名	必須/任意	条件
ユーザコード	userCd	必須	完全一致
会社コード	companyCd	必須	完全一致
休暇ID	localeId	必須	完全一致

定義:

selectActionHistoryIgnoreAuthCompany インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

leaveId - 休暇Id

戻り値:

休暇アクション履歴

complementEndDateForDisp

protected <T extends KaidenDto> List<T> complementEndDateForDisp(Class<T> clazz,
                                                                 List<T> dataList)

終了日を前日に設定.

型パラメータ:

T - DTO型

パラメータ:

clazz - クラス

dataList - 対象データ

戻り値:

変更後データ

complementEndDateForDisp

protected <T extends KaidenDto> T complementEndDateForDisp(Class<T> clazz,
                                                           T data)

終了日を前日に設定.

型パラメータ:

T - DTO型

パラメータ:

clazz - クラス

data - 対象データ

戻り値:

変更後データ

getValidateDefsDtoList4AppendLeave

public List<ValidateDefsDto> getValidateDefsDtoList4AppendLeave()

休暇付与時の検証定義リストを返却します.

返却内容は下記の通りです。

ユーザコード	必須、マスタ存在確認
会社コード	必須、マスタ存在確認
休暇種別コード	必須、マスタ存在確認
付与日数	必須、小数(整数部3桁、小数部1桁)、数値範囲(0～999.5)、カスタム(小数部は0、または5のみ許容)
開始日	必須、日付（システム期間内）
終了日	必須、日付（システム期間内）、開始日以降
実行ユーザコード	必須、マスタ存在確認

定義:

getValidateDefsDtoList4AppendLeave インタフェース内 LeaveManager

戻り値:

バリデート実行クラス用パラメータDTOリスト

getValidateDefsDtoList4EditLeave

public List<ValidateDefsDto> getValidateDefsDtoList4EditLeave()

休暇編集時の検証定義リストを返却します.

返却内容は下記の通りです。

ユーザコード	必須、マスタ存在確認
会社コード	必須、マスタ存在確認
休暇ID	必須、皆伝コード、100桁
終了日	必須、日付（システム期間内）、開始日以降
調整理由	必須、1000桁
実行ユーザコード	必須、マスタ存在確認

定義:

getValidateDefsDtoList4EditLeave インタフェース内 LeaveManager

戻り値:

バリデート実行クラス用パラメータDTOリスト

getValidateDefsDtoList4AdjustLeave

public List<ValidateDefsDto> getValidateDefsDtoList4AdjustLeave()

休暇調整時の検証定義リストを返却します.

返却内容は下記の通りです。

ユーザコード	必須、マスタ存在確認
会社コード	必須、マスタ存在確認
休暇ID	必須、皆伝コード、100桁
調整後日数	必須、小数(整数部3桁、小数部1桁)、数値範囲(0～999.5)、カスタム(小数部は0、または5のみ許容)
調整後時間数	必須、整数(2桁)、数値範囲(0～99)
調整適用日	必須、日付（システム期間内）
調整理由	必須、1000桁
実行ユーザコード	必須、マスタ存在確認

定義:

getValidateDefsDtoList4AdjustLeave インタフェース内 LeaveManager

戻り値:

バリデート実行クラス用パラメータDTOリスト

getValidateDefsDtoList4RemoveLeave

public List<ValidateDefsDto> getValidateDefsDtoList4RemoveLeave()

休暇削除時の検証定義リストを返却します.

返却内容は下記の通りです。

ユーザコード	必須、マスタ存在確認
会社コード	必須、マスタ存在確認
休暇ID	必須
調整理由	必須、1000桁
実行ユーザコード	必須、マスタ存在確認

定義:

getValidateDefsDtoList4RemoveLeave インタフェース内 LeaveManager

戻り値:

バリデート実行クラス用パラメータDTOリスト

selectUserLeaveBalance

public List<Map<String,Object>> selectUserLeaveBalance(String userCd,
                                                       String companyCd,
                                                       Timestamp criteriaDate)

特定ユーザの休暇残を返却.

特定ユーザの検索基準日時点の休暇残数を取得します。

戻り値には下記項目を保持します。

KEY	内容	備考
userCd	ユーザコード
companyCd	会社コード
leaveTypeCd	休暇種別コード
balanceDays	休暇残日数
balanceHours	休暇残時間数

定義:

selectUserLeaveBalance インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

criteriaDate - 検索基準日

戻り値:

休暇残

以下の形式を持ちます

• userCd
• companyCd
• leaveTypeCd
• balanceDays
• balanceHours

getTakeLeaveHourUpper

public List<LeaveManager.TakeLeaveHourUpperDto> getTakeLeaveHourUpper(String userCd,
                                                                      String companyCd,
                                                                      Timestamp periodStartDate,
                                                                      Timestamp periodEndDate)

時間年休取得上限情報を返却.

特定ユーザが指定期間内に取得した時間年休の合計時間数、及び期間内での取得可能な上限時間数を返却します。
尚、期間内での上限時間数判定は休暇付与が行われた日付を境に行うため、指定期間内に休暇付与が行われた日付を含む場合は複数レコードに分けて返却されます。
また、判定期間内に複数の勤務体系に所属している場合で、且つ、1日当たりの時間数が勤務体系間で異なるケースの場合のみ、
時間年休取得上限最大時間数（単位：分）、 時間年休取得上限最小時間数（単位：分）の2つに値をセットします。
(それ以外の場合は時間年休取得上限最小時間数（単位：分）はNullとなります。)

定義:

getTakeLeaveHourUpper インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

periodStartDate - 締め期間開始日

periodEndDate - 締め期間終了日

戻り値:

時間年休取得上限情報

isGrantedLeave

public boolean isGrantedLeave(String userCd,
                              String companyCd,
                              String leaveTypeCd,
                              Timestamp searchCriteriaDate)

検索基準日時点で休暇が付与されているか判定.

定義:

isGrantedLeave インタフェース内 LeaveManager

パラメータ:

userCd - ユーザコード

companyCd - 会社コード

leaveTypeCd - 休暇種別コード

searchCriteriaDate - 検索基準日

戻り値:

休暇が付与されている：true、休暇が付与されていない：false