init
This commit is contained in:
guanxiangwei
@@ -0,0 +1,164 @@
|
||||
# 画面設計書 QCL00030 退職後一括更新（給与） — 02_一括更新対象職員一覧の取得SQL
|
||||
|
||||
## 1. SQL 全景
|
||||
|
||||
```
|
||||
SELECT
|
||||
CSHAINNO, -- 職員番号
|
||||
CNAMEKNJ, -- 漢字氏名
|
||||
BKYK_CDE, -- 部局コード
|
||||
BKYK_NME, -- 部局名称
|
||||
DTAISHA, -- 退職年月日
|
||||
CMNUSER, -- 更新ユーザ
|
||||
DMNDATE, -- 更新年月日
|
||||
NJINJIFLG, -- 人事クリア
|
||||
NQYOCALCFLG -- 給与計算フラグ
|
||||
FROM (
|
||||
SELECT
|
||||
A.CSHAINNO, A.CNAMEKNJ, A.BKYK_CDE, A.BKYK_NME, A.DTAISHA,
|
||||
L.CMNUSER, L.DMNDATE,
|
||||
DECODE(J.CSHAINNO, NULL, NULL, '済') NJINJIFLG,
|
||||
A.NQYOCALCFLG,
|
||||
ROW_NUMBER() OVER(PARTITION BY A.CSHAINNO ORDER BY L.DMNDATE DESC) RID
|
||||
FROM XKKIHON A
|
||||
LEFT JOIN (
|
||||
SELECT CSHAINNO FROM DJND7500LOG
|
||||
WHERE CCOMPKB = 入力パラメータ「会社区分」
|
||||
AND CTEIINKB = 入力パラメータ「定員区分」
|
||||
GROUP BY CSHAINNO
|
||||
) J
|
||||
ON J.CSHAINNO = A.CSHAINNO
|
||||
LEFT JOIN UCLR1000LOG L
|
||||
ON L.CCOMPKB = A.CCOMPKB
|
||||
AND L.CSHAINNO = A.CSHAINNO
|
||||
AND L.DTAISHA = A.DTAISHA
|
||||
WHERE
|
||||
A.CCOMPKB = 入力パラメータ「会社区分」
|
||||
AND A.CQTAIKEIKB = 入力パラメータ「体系区分」
|
||||
AND A.DGAITONG = 入力パラメータ「該当年月」
|
||||
AND A.NQSHOYOKB = 入力パラメータ「給与賞与区分」
|
||||
AND A.NQSHOYOSEQ = 0
|
||||
AND A.DTAISHA >= 入力パラメータ「開始退職年月日」
|
||||
AND A.DTAISHA <= 入力パラメータ「終了退職年月日」
|
||||
AND (
|
||||
(入力パラメータ「定員区分」='1' AND A.CTEIINKB = '1')
|
||||
OR (入力パラメータ「定員区分」<>'1' AND A.CTEIINKB <> '1')
|
||||
)
|
||||
)
|
||||
WHERE RID = 1
|
||||
```
|
||||
|
||||
## 2. 業務位置づけ
|
||||
|
||||
- 機能 ID: QCL00030 退職後一括更新（給与）
|
||||
- 用途: 「退職後一括更新」実行画面の一覧グリッド表示用 SELECT
|
||||
- 入力: 会社区分 / 体系区分 / 該当年月 / 給与賞与区分 / 定員区分 / 開始退職年月日 / 終了退職年月日
|
||||
- 出力: 当該会社/処理月の退職者一覧（職員番号/氏名/部局/退職日/更新者/更新日時/人事クリア済フラグ/給与計算フラグ）
|
||||
- 後続: 一覧確認後にユーザが「一括更新実行」押下 → 03_給与一括更新実行SQL が本一覧の CSHAINNO 群に対して走る
|
||||
|
||||
## 3. 結合 3 表の物理構造
|
||||
|
||||
| エイリアス | 物理表 | 行粒度 | 主役役割 |
|
||||
|---|---|---|---|
|
||||
| A | XKKIHON | 社員×処理月×給与賞与 | 退職者抽出の母集団 |
|
||||
| J | DJND7500LOG | 社員単位（GROUP BY 済） | 人事クリア済フラグ生成源 |
|
||||
| L | UCLR1000LOG | 社員×処理月×退職日 | 給与クリア実行の最新履歴（操作者/日時）|
|
||||
|
||||
### XKKIHON（情報スキーマ実測 2026-08-20）
|
||||
- NOT NULL: ccompkb(2), cqtaikeikb(2), dgaitong(date), nqshoyokb, nqshoyoseq, cshainno(10)
|
||||
- dtaisha(date) は NULLABLE — 同処理月内に同社員の複数 dtaisha 存在を許容
|
||||
- cteiinkb(varchar 10) — 他表は varchar(1) だが比較上は問題なし
|
||||
|
||||
### DJND7500LOG（情報スキーマ実測）
|
||||
- ヘッダ 3 列 NOT NULL: ccompkb, cteiinkb, cshainno
|
||||
- cnameknj / bkyk_cde / bkyk_nme は冗長表示用（NULLABLE）
|
||||
- tsyk_dte / dtsyk_dte 等の他カラムは本 SQL では未参照
|
||||
- nclearflg01〜40: 人事系クリア対象 40 槽位フラグ
|
||||
|
||||
### UCLR1000LOG（情報スキーマ実測）
|
||||
- ヘッダ 4 列 NOT NULL: ccompkb, cqtaikeikb, cteiinkb, cshainno
|
||||
- dtaisha(date) NULLABLE
|
||||
- nclearflg_s01〜s40: 給与支給 40 槽位、nclearflg_k01〜k40: 給与控除 40 槽位（合計 80 槽位五花）
|
||||
- njinjiflg は存在するが本 SQL では参照しない（L.CMNUSER/L.DMNDATE のみ使用）
|
||||
|
||||
## 4. SELECT 各列の意味
|
||||
|
||||
| 列 | 物理列 | 業務 semantic |
|
||||
|---|---|---|
|
||||
| CSHAINNO | A.CSHAINNO | 一覧キー（後続更新SQL の絞り込みキー）|
|
||||
| CNAMEKNJ | A.CNAMEKNJ | 表示用氏名 |
|
||||
| BKYK_CDE | A.BKYK_CDE | 表示用部局コード |
|
||||
| BKYK_NME | A.BKYK_NME | 表示用部局名称 |
|
||||
| DTAISHA | A.DTAISHA | 退職年月日 — 期間絞り込み対象 |
|
||||
| CMNUSER | L.CMNUSER | 給与クリア実行の最終操作者 |
|
||||
| DMNDATE | L.DMNDATE | 給与クリア実行の最終操作日時 |
|
||||
| NJINJIFLG | DECODE(J.CSHAINNO, NULL, NULL, '済') | 人事クリア済フラグ（後述）|
|
||||
| NQYOCALCFLG | A.NQYOCALCFLG | 給与計算フラグ（給与計算実行済か）|
|
||||
|
||||
## 5. NJINJIFLG（DECODE）の意味
|
||||
|
||||
```sql
|
||||
DECODE(J.CSHAINNO, NULL, NULL, '済') NJINJIFLG
|
||||
```
|
||||
|
||||
- 副問合せ J は DJND7500LOG の存在チェック専用 — CSHAINNO 列だけを GROUP BY で取る
|
||||
- J.CSHAINNO = NULL → 人事クリア未実行 → 出力 NULL
|
||||
- J.CSHAINNO に値あり → 人事クリア実行済 → 出力 '済'
|
||||
- 一覧画面で「済」表示行はグレーアウト → 二重クリア防止 UI
|
||||
- DECODE は Oracle 関数。本番 Oracle 想定、CI 検証時は PostgreSQL
|
||||
|
||||
## 6. ROW_NUMBER() による一意化
|
||||
|
||||
```sql
|
||||
ROW_NUMBER() OVER(PARTITION BY A.CSHAINNO ORDER BY L.DMNDATE DESC) RID
|
||||
WHERE RID = 1
|
||||
```
|
||||
|
||||
- UCLR1000LOG は同社員で複数回クリア実行履歴が残り得る（再退職処理/修正実行）
|
||||
- 1 社員に対して複数行が JOIN されるのを防ぐため、最新 DMNDATE 行のみ採用
|
||||
- xkkihon.dtaisha が NULLABLE な点とも整合（同処理月内の同社員複数 dtaisha は RID=1 で代表 1 行に集約）
|
||||
|
||||
## 7. WHERE 句 9 条件の意味
|
||||
|
||||
| # | 条件 | 業務 semantic |
|
||||
|---|---|---|
|
||||
| 1 | A.CCOMPKB = 会社区分 | 会社ロック（ログイン所属会社）|
|
||||
| 2 | A.CQTAIKEIKB = 体系区分 | 給与体系（一般/再任用/特地等）固定絞り込み |
|
||||
| 3 | A.DGAITONG = 該当年月 | 退職処理を行う処理月（月末日） |
|
||||
| 4 | A.NQSHOYOKB = 給与賞与区分 | 0=給与、1=賞与 |
|
||||
| 5 | A.NQSHOYOSEQ = 0 | 通常明細のみ。賞与明細（1〜n）は退職処理対象外 |
|
||||
| 6 | A.DTAISHA BETWEEN 開始/終了 | 画面で指定した退職日範囲内のみ抽出 |
|
||||
| 7 | 定員区分 OR 条件 | 一般職／一般以外 の母集団切替（次節）|
|
||||
|
||||
## 8. 定員区分 OR 条件 — 設計の核
|
||||
|
||||
```sql
|
||||
AND (
|
||||
(入力パラメータ「定員区分」='1' AND A.CTEIINKB = '1')
|
||||
OR (入力パラメータ「定員区分」<>'1' AND A.CTEIINKB <> '1')
|
||||
)
|
||||
```
|
||||
|
||||
- 定員区分='1' = **一般職員** → cteiinkb='1' のみ抽出
|
||||
- 定員区分<>'1' = **一般以外**（再任用/特地/嘱託等）→ cteiinkb<>'1' を抽出
|
||||
- 業務 background: 一般職 と 一般以外で 退職後の社会保険/住民税/共済等の継続/停止が異なるため、一括更新バッチを分けて流す必要がある
|
||||
- 画面では「一般職一括更新」「一般以外一括更新」を別ボタンで起動する設計
|
||||
|
||||
## 9. 全体処理フロー（01〜04 接続）
|
||||
|
||||
```
|
||||
[01_対象項目取得] UCLR1000MST → クリア対象項目マスタ（40 槽位）
|
||||
↓ ccompkb, cteiinkb 共通
|
||||
[02_対象職員一覧] XKKIHON + DJND7500LOG + UCLR1000LOG ← 本 SQL
|
||||
↓ cshainno 群
|
||||
[03_一括更新実行] UCLR1000LOG に INSERT（実行履歴） + xkkihon の各項目を CLEAR（NULL 化）
|
||||
↓ 槽位一致
|
||||
[04_クリア対象項目] UCLR1000MST × UCLR1000LOG × xkkihon → クリア実行
|
||||
```
|
||||
|
||||
## 10. 補足事項
|
||||
|
||||
- DECODE / ROW_NUMBER / 副問合せ 等は Oracle 方言。本番は Oracle、CI は PostgreSQL（updsv7_opho_ci）で動作確認
|
||||
- ORDER BY なし — 一覧表示順は画面/MyBatis 側の default-sort で制御する設計
|
||||
- LIMIT/OFFSET なし — 一覧表示件数の paging は呼び側責務
|
||||
- DJND7500LOG 副問合せは CSHAINNO のみ取得 — 槽位フラグ（nclearflg01〜40）は本 SQL では判定材料にしない（「存在するか」だけ）
|
||||
Reference in New Issue
Block a user