Files
updsv7-rag/標準版/給与システム/entity/xcshoyo_[賞与計算制御情報].md
T

59 lines
4.7 KiB
Markdown

# xcshoyo [コントロール]賞与計算制御情報 — xlsx vs DB 対照
- xlsx: /mnt/d/25.テーブル一覧/10.テーブル定義/30.給与/xcshoyo.xlsx
- DB: updsv7_opho_ci (192.168.1.72:5432) / public.xcshoyo
- 改訂履歴: 7.0.0 新規作成 (2023-10-04 NSC) — 改訂なし
## 1. 全体対数
| 区分 | 項目 | 値 |
|---|---|---|
| 列数 | xlsx | 13 |
| 列数 | DB | 13 |
| 列差 | DB のみ | 0 |
| 列差 | xlsx のみ | 0 |
| 行数 | DB | 0 行 (CI 環境、表は空) |
| 表サイズ | DB | 16 kB (内 0 bytes は本体、残り索引) |
| 主キー | xcshoyo_idx UNIQUE | (ccompkb, cqtaikeikb, dyymm, nseq) |
| 補助索引 | xcshoyo_idx_2 | (ccompkb, cqtaikeikb, dyymm, dsikyngp) — 支給年月日検索用 |
## 2. 業務身份
- **UPDS-V7 給与システムの「賞与計算制御情報」** — 期末/勤勉/一般賞与などの賞与計算バッチ(QCAL2011 プロシージャ等)の実行可否・実行状態を PK 単位(会社×体系×処理月×回数)で管理する小さい親テーブル
- 1 つの処理月の中で複数回(nseq=1, 2, ...)実行可能(再作成/追加のみのシナリオ用)
- 主要利用箇所(例):
- 画面 KCL00120「期末勤勉手当計算準備」3.4.2 存在チェック → 当月の制御情報が既にあれば再作成フラグで挙動分岐
- 画面 KCL00120 3.5 賞与計算制御情報作成 (DELETE → INSERT)
- 画面 KCL00120 3.6 賞与計算制御情報更新 (フラグ=9 で完了マーク)
## 3. カラム対照(13 列 全一致)
| No | カラム名 | カラムID | xlsx型 | xlsx桁 | xlsx制約 | DB型 | DB桁 | NOT NULL | xlsx idx | 用途 |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 会社区分 | ccompkb | varchar | 2 | N | varchar | 2 | YES | 1 | PK候補 |
| 2 | 給与体系区分 | cqtaikeikb | varchar | 2 | N | varchar | 2 | YES | 2 | PK候補 (00固定) |
| 3 | 処理月 | dyymm | date | - | N | date | - | YES | 3 | PK候補 (YYYY/MM) |
| 4 | SEQ | nseq | numeric | 1 | N | numeric | 1,0 | YES (default 0) | 4 | PK候補 (同一処理月内の実行回数) |
| 5 | 更新ユーザ)端末ID | cmnclient | varchar | 10 | - | varchar | 10 | NO | - | 更新ログ |
| 6 | 更新ユーザ)会社区分 | cmncomp | varchar | 2 | - | varchar | 2 | NO | - | 更新ログ |
| 7 | 更新ユーザ)ユーザID | cmnuser | varchar | 10 | - | varchar | 10 | NO | - | 更新ログ |
| 8 | 更新ユーザ)更新日時 | dmndate | timestamp | - | - | timestamp | - | NO | - | 更新ログ |
| 9 | 賞与基準年月 | dkijun | date | - | - | date | - | NO | - | 賞与計算の基準年月 (支給年月と異なる場合あり) |
| 10 | 支給年月日 | dsikyngp | date | - | - | date | - | NO | 3 | 賞与の支給日 (xcshoyo_idx_2 索引列) |
| 11 | 確定済フラグ | nkakuteiflg | numeric | 1 | - | numeric | 1,0 | NO (default 0) | - | xlsx 備考: 0:未 / 1:済 |
| 12 | (xlsx: 非常勤の準備処理FLG) | ntaishokb1 | numeric | 1 | - | numeric | 1,0 | NO (default 0) | - | xlsx 備考: 0:未 / 1:今回処理 / 9:準備処理済 — **画面 KCL00120 概要では「フラグ1(定員内)」と記載され名称不一致、xlsx 備考が正** |
| 13 | (名称未記載) | ntaishokb2 | numeric | 1 | - | numeric | 1,0 | NO (default 0) | - | xlsx カラム名・備考とも空欄、用途不明 |
## 4. 主キー
- UNIQUE INDEX: xcshoyo_idx (ccompkb, cqtaikeikb, dyymm, nseq) — 4 列複合キー
- xlsx H列「インデックス」記載: ccompkb=1, cqtaikeikb=2, dyymm=3, nseq=4 → 順序含め DB と完全一致
- nseq のみ DB で `DEFAULT 0` あり、xlsx には初期値記載なし
## 5. 観察事項
1. **ntaishokb1 の業務名不一致** — 画面設計書 KCL00120 業務概要(`画面設計書_KCL00120_期末勤勉手当計算準備_業務概要.md`)71 行付近では「フラグ1(定員内)」と記載されているが、xlsx カラム備考(No.12)は「非常勤の準備処理FLG 0:未 1:今回処理 9:準備処理済」と全く逆の意味で記載されている。xlsx 備考は「非常勤の準備処理FLG」の方が xkkihon.CTEIINKB の対応(画面 3.2.1A/B 定員内 vs 3.2.1C/D 非常勤)と整合する。**要確認**。
2. **ntaishokb2 はカラム名・備考とも未記載** — xlsx No.13 行はカラム名セルが空。テーブルとして存在するが用途不明。KCL00120 概要では「フラグ2(非常勤)」と記載、xlsx は完全空欄。**要確認**。
3. **CI 環境では表が空** — 0 行のためサンプルデータなし。実環境(運用/開発)でどのような nseq/dkijun 値で運用されているかは要確認。
4. **xcshoyo_month.xlsx が同フォルダに存在** — 別表。本ドキュメントの対象外。