intra-mart Accel Kaiden! プログラミングガイド 第21版 2024-04-01

4.2.2.2.4. 定義

4.2.2.2.4.1. 集計単位を定める

集計単位を定めます。
集計項目の単位には以下があります。
  • 日次集計項目
  • 週次集計項目
  • 締め期間集計項目
  • 月次集計項目
今回は「日次集計項目」と「締め期間集計項目」を作成します。

4.2.2.2.4.2. 集計キーを定める

集計キーを定めます。
今回は日次集計項目の集計キーを「DA_late_early_time_M」、締め期間集計項目を「PA_late_early_time_M」とします。

コラム

集計キーの採番ルールは以下のようになっています。
[集計キー接頭辞(集計単位)] + [集計キー接頭辞(由来)] + “_” + [“集計キー語幹”] + ”_” + [集計キー接尾辞(メジャー)]

集計キー接頭辞(集計単位)
  • D:日次集計
  • W:週次集計
  • P:締め期間集計
  • M:月次集計
集計キー接頭辞(由来)
  • A:集計API内で固定文字列
  • S:勤務状況マスタ由来
  • T:集計タグマスタ由来
  • D:休憩・控除・時間年休大分類マスタ由来
  • M:休憩・控除・時間年休中分類マスタ由来
  • L:休憩・控除・時間年休マスタ由来
  • R:勤務手当マスタ由来
集計キー語幹
  • 集計API固有文字列
  • 勤務状況コード
  • 集計タグコード
  • 休憩・控除・時間年休大分類コード
  • 休憩・控除・時間年休中分類コード
  • 休憩・控除・時間年休コード
  • 勤務手当コード
集計キー接尾辞(メジャー)
  • M:時間(分)
  • D:日数
  • C:回数

コラム

集計の定義を行わなくても、マスタにデータが登録されているだけで勤務情報が入力されると自動的に集計されるものがあります。
  • 勤務状況マスタ
  • 集計タグマスタ(メンテナンス画面なし)
  • 休憩・控除・時間年休大分類マスタ(メンテナンス画面なし)
  • 休憩・控除・時間年休中分類マスタ(メンテナンス画面なし)
  • 休憩・控除・時間年休マスタ

4.2.2.2.4.3. 集計定義を登録する

集計定義の登録を行います。
  • 集計定義マスタ
No. 論理名 物理名 長さ 必須 PK 備考
1 勤務体系カテゴリコード ws_category_cd varchar2 20 Y PK  
2 会社コード company_cd varchar2 100 Y PK ※未使用、拡張用
3 勤務体系コード ws_agreement_cd varchar2 100 Y PK ※未使用、拡張用
4 集計キーID sum_key_id varchar2 100 Y PK  
5 期間コード term_cd varchar2 50 Y PK  
6 開始日 start_date timestamp   Y    
7 終了日 end_date timestamp   Y    
8 集計処理 sum_api_id varchar2 100 Y    
9 処理順序 execute_order number 15,0      
10 集計区分 sum_div varchar2 100 Y    
11 パラメータID parameter_data_id varchar2 100      
日次集計処理と締め期間集計処理の定義を登録します。

コラム

DB上は「勤務体系カテゴリ」「会社」「勤務体系」ごとに定義できることを想定した構造になっていますが、
intra-mart Accel Kaiden! 勤務管理モジュール 標準版は「勤務体系カテゴリ」のみを使用しています。
「会社」「勤務体系」については、拡張用の項目になっています。

コラム

「集計処理+”Calc”」がコンポーネントIDです。

  • 集計定義パラメータマスタ
No. 論理名 物理名 長さ 必須 PK 備考
1 パラメータID parameter_data_id varchar2 100 Y PK  
2 パラメータSEQ parameter_seq number 15,0 Y PK  
3 枝番号 parameter_seq number 18,0 Y PK  
4 パラメータ値 parameter_value varchar2 4000      

  • 集計キー属性マスタ
No. 論理名 物理名 長さ 必須 PK 備考
1 集計キー sum_key varchar2 30 Y PK  
2 属性キー attribute_key varchar2 100 Y PK  
3 属性値 attribute_val varchar2 4000      
4 ソートキー sort_key number 15,0 Y    
集計時に管理者に係る集計値を集計対象から外す場合は、集計キー属性マスタに値を登録します。

コラム

属性キーには「management_ignore_sumkey」を設定してください。
属性値には値を設定しないでください。

  • 集計キー勤務体系カテゴリ別属性マスタ
No. 論理名 物理名 長さ 必須 PK 備考
1 集計キー sum_key varchar2 30 Y PK  
2 属性キー attribute_key varchar2 100 Y PK  
3 勤務体系カテゴリコード ws_category_cd varchar2 20 Y PK  
4 属性値 attribute_val varchar2 4000      
5 ソートキー sort_key number 15,0 Y    
標準の処理で、日次集計値を締め期間内で合計した値を締め期間集計値として自動的に登録します。
(週次、月次では行っていません。)

コラム

今回のように単純な日次集計値の合計でなく、独自に締め期間集計クラスを作成する場合、自動登録処理をスキップする必要があります。
その場合、集計キー勤務体系カテゴリ別属性マスタに値を登録してください。
属性キーには「exclude_simple_sum_daily」を設定してください。
属性値には値を設定しないでください。

-- 集計定義マスタ
insert into k31m_ws_use_sum_api values ('normal', '#default#', 'default', 'daily_late_early_time_sum_keys', 'default', '1900-01-01 00:00:00', '3000-01-01 00:00:00', 'dailyLateEarlyTime', 10, 'daily', '', null, null, null, null, null, null, null, null, null, null, '2014-04-01 00:00:00', 'tutorial2', 1, '2014-04-01 00:00:00', 'tutorial2');
insert into k31m_ws_use_sum_api values ('normal', '#default#', 'default', 'period_late_early_time_sum_keys', 'default', '1900-01-01 00:00:00', '3000-01-01 00:00:00', 'periodLateEarlyTime', 10, 'period', 'periodLateEarlyTimeParam', null, null, null, null, null, null, null, null, null, null, '2014-04-01 00:00:00', 'tutorial2', 1, '2014-04-01 00:00:00', 'tutorial2');

-- 集計定義パラメータマスタ
insert into k31m_ws_sum_api_prm_val values ('periodLateEarlyTimeParam', 1, 1, 30, null, null, null, null, null, null, null, null, null, null, '2014-04-01 00:00:00', 'tutorial2', 1, '2014-04-01 00:00:00', 'tutorial2');

-- 集計キー属性マスタ
insert into k31m_sumkey_att values ('DA_late_early_time_M', 'management_ignore_sumkey', null, 1, null, null, null, null, null, null, null, null, null, null, '2014-04-01 00:00:00', 'tutorial2', 1, '2014-04-01 00:00:00', 'tutorial2');


-- 集計キー勤務体系カテゴリ別属性マスタ
insert into k31m_sumkey_wscat_att values ('DA_late_early_time_M', 'exclude_simple_sum_daily', 'normal', null, 1, null, null, null, null, null, null, null, null, null, null, '2014-04-01 00:00:00', 'tutorial2', 1, '2014-04-01 00:00:00', 'tutorial2');

コラム

固定労働時間制の定義のみを追加する例となっています。
必要に応じて他の勤務体系カテゴリの定義を登録します。

コラム

日次集計のみ管理者を集計対象から外す設定としています。
必要に応じて集計キーを集計キー属性マスタに登録します。