CombositeHatsureiDataService

combositeの発令データを取得するサービス

警告

※ 既にインスタンス化されているものが提供されるのでcombositeDataService.hatsureiDataを使用してアクセスしてください。

詳しくは例を参照してください。

Combositeの仕様上の注意点

退職発令の注意点

※ Combositeでは退職発令を登録した場合、以下2種類の退職発令データが登録されます。

1. 発令日当日は在籍状況区分：在籍中の退職発令データ
2. 発令日翌日以降は在籍状況区分：退職済の退職発令データ

退職済みの従業員を、在籍状況区分「退職済」で管理しています。
在職中の従業員に限定して発令データを取得する場合は、在籍状況区分「在職中」で絞り込んでください。

  // 従業員ID：FM001275が2025/01/01退職した場合
  const employeeIdList = ['FM001275'] // 退職発令が登録された従業員ID
  const baseDate = '2025/01/01'

  // hatsureiDataList には以下の両方が含まれます:
  // 1. 在籍中の退職発令データ
  // 2. 退職済の退職発令データ
  const hatsureiDataList = await combositeDataService.HatsureiData.readByEmployeeIdAndBaseDate(employeeIdList, baseDate)

在籍中の発令データに限定して発令データを取得するには、在籍状況区分「在籍中」で絞り込んでください。

※ Combositeでは退職済みの従業員を、在籍状況区分「退職済」で管理しています。
在職中の従業員に限定して発令データを取得する場合は、在籍状況区分「在職中」で絞り込んでください。

利用例

async function main() {
  const employeeIdList = ['FM001275', 'FM001276']
  const baseDate = '2025/01/01'
  const hatsureiDataList = await combositeDataService.HatsureiData.readByEmployeeIdAndBaseDate(employeeIdList, baseDate)

  // 発令データを在職中のみに絞り込み
  const targetHatsureiDataList = hatsureiDataList.filter((hatsureiData) => {
      return hatsureiData.zaisekiJokyoKubun == entity.ZaisekiJokyoKubun.ZAISHOKUCHU
  })
}

兼務発令の注意点

※ Combositeでは兼務発令を登録した場合、従業員、日付ごとに本務と兼務の複数の発令データが登録されます。

  // 職種：製品開発の従業員ID：FM001275が2025/01/01から職種：品質管理を兼務する場合
  const employeeIdList = ['FM001275'] // 兼務発令が登録された従業員ID
  const baseDate = '2025/01/01'

  // hatsureiDataList には以下の両方が含まれます:
  // 1. 本務発令データ（本務兼務区分：本務） 職種：製品開発
  // 2. 兼務発令データ（本務兼務区分：兼務） 職種：品質管理
  const hatsureiDataList = await combositeDataService.HatsureiData.readByEmployeeIdAndBaseDate(employeeIdList, baseDate)

本務の発令データに限定して発令データを取得するには、本務兼務区分「本務」で絞り込んでください。

利用例

async function main() {
  const employeeIdList = ['FM001275', 'FM001276']
  const baseDate = '2025/01/01'
  const hatsureiDataList = await combositeDataService.HatsureiData.readByEmployeeIdAndBaseDate(employeeIdList, baseDate)

  // 発令データを本務のみに絞り込み
  const targetHatsureiDataList = hatsureiDataList.filter((hatsureiData) => {
      return hatsureiData.honmuKenmuKubun == entity.HonmuKenmuKubun.HONMU
  })
}

Extends

• CombositeHatsureiDataProviderServiceBase<CombositeDataOperator>

Methods

readByEmployeeId()

readByEmployeeId(employeeIdList): Promise<HatsureiDataEntity[]>

従業員IDから発令データを取得する

Parameters

Parameter	Type	Description
employeeIdList	string[]	従業員ID

Returns

Promise<HatsureiDataEntity[]>

HatsureiDataEntity[] 発令データの配列

Example

利用例

async function main() {
  const employeeIdList = ['FM001275', 'FM001276']
  const response = await combositeDataService.HatsureiData.readByEmployeeId(employeeIdList)
}

await main()

Inherited from

CombositeHatsureiDataProviderServiceBase.readByEmployeeId

---

readByEmployeeIdAndBaseDate()

readByEmployeeIdAndBaseDate(employeeIdList, baseDate): Promise<HatsureiDataEntity[]>

従業員IDと日付から発令データを取得する

Parameters

Parameter	Type	Description
employeeIdList	string[]	従業員ID
baseDate	string	日付 (yyyy/MM/dd)

Returns

Promise<HatsureiDataEntity[]>

HatsureiDataEntity[] 発令データの配列

Example

利用例

  const employeeIdList = ['FM001275', 'FM001276']
  const baseDate = '2025/01/01'
  const response = await combositeDataService.HatsureiData.readByEmployeeIdAndBaseDate(employeeIdList, baseDate)

Inherited from

CombositeHatsureiDataProviderServiceBase.readByEmployeeIdAndBaseDate

---

readByEmployeeIdAndHatsureiKubun()

readByEmployeeIdAndHatsureiKubun(employeeIdList, hatsureiKubun): Promise<HatsureiDataEntity[]>

従業員IDと発令区分から発令データを取得する

Parameters

Parameter	Type	Description
employeeIdList	string[]	従業員ID
hatsureiKubun	HatsureiKubun	発令区分

Returns

Promise<HatsureiDataEntity[]>

HatsureiDataEntity[] 発令データの配列

Example

利用例

  const employeeIdList = ['FM001275', 'FM001276']
  const hatsureiKubun = HatsureiKubun.KOYO
  const response = await combositeDataService.HatsureiData.readByEmployeeIdAndHatsureiKubun(employeeIdList, hatsureiKubun)

Inherited from

CombositeHatsureiDataProviderServiceBase.readByEmployeeIdAndHatsureiKubun