# xkkijunctl 給与計算基準連携停止情報

## Description
- 物理表名:xkkijunctl
- テーブル名称:[基本]給与計算基準連携停止情報
- 业务语义:xkkijun(給与計算基準)の各項目に対して連携更新を停止する制御情報を保持する
- 所属:UPDS-V7 給与システム
- 所在库:updsv7_opho_ci(192.168.1.72:5432,CI 环境)

## Key Facts (实测 2026-08-19 information_schema)
- 物理列数:15 / 行数(CI):0 / 表 0 bytes / 索引 8 kB / 总 8 kB(空表)
- 主键 UNIQUE:xkkijunctl_idx(ccompkb, cqtaikeikb, dgaitong, cshainno, ctableid, ccolumnid)
- 設計書:D:\25.テーブル一覧\10.テーブル定義\30.給与\xkkijunctl.xlsx

## 列结构

| No. | カラム名称 | 物理名 | データ型 | 桁数 | NotNull | 初期値 | インデックス | 備考 |
|-----|-----------|--------|---------|------|---------|--------|------------|------|
| 1 | 会社区分 | ccompkb | varchar | 2 | N | -- | 2 | |
| 2 | 給与体系区分 | cqtaikeikb | varchar | 2 | N | -- | 3 | 00 固定 |
| 3 | 該当年月 | dgaitong | date | -- | N | -- | 6 | 処理月(月末日) |
| 4 | 社員番号 | cshainno | varchar | 10 | N | -- | 4 | |
| 5 | 更新ユーザ)端末ID | cmnclient | varchar | 10 | -- | -- | -- | ログ |
| 6 | 更新ユーザ)会社区分 | cmncomp | varchar | 2 | -- | -- | -- | ログ |
| 7 | 更新ユーザ)ユーザID | cmnuser | varchar | 10 | -- | -- | -- | ログ |
| 8 | 更新ユーザ)更新日時 | dmndate | timestamp | -- | -- | -- | -- | ログ(DB 実 timestamp(0)) |
| 9 | 更新先)テーブルID | ctableid | varchar | 20 | N | -- | 5 | 連携停止対象 テーブルID |
| 10 | 更新先)テーブル名 | ctablenm | varchar | 30 | -- | -- | -- | 冗余表示用 |
| 11 | 更新先)カラムID | ccolumnid | varchar | 20 | N | -- | 1 | 連携停止対象 カラムID |
| 12 | 更新先)項目名 | ccolumnnm | varchar | 30 | -- | -- | -- | 冗余表示用 |
| 13 | 連携更新停止)種別 | cjtoqkb | varchar | 2 | -- | -- | -- | 01:当月のみ, 02:当月以降 |
| 14 | 連携更新停止)名称 | cjtoqnm | varchar | 20 | -- | -- | -- | |
| 15 | 連携更新停止)フラグ | njtoqflg | numeric | 1 | -- | -- | -- | 0:非停止, 1:停止 (DB 実 numeric(1,0)) |

## 業務シナリオ(2026-08-19 用户明确)

xkkijunctl は **xkkijun の管理用 専用表**。ctableid + ccolumnid は xkkijun 系(xkkijun / xkkijunhw 等同型系列)の対象項目を指す。

```
給与計算ロジック起動 (処理月 X, 社員 Y):
  該 xkkijun 行 / 各項目処理:
    SELECT FROM xkkijunctl
      WHERE ccompkb / cqtaikeikb / dgaitong / cshainno  = HEAD PK
        AND ctableid = 'xkkijun'
        AND ccolumnid = 対象項目ID
    IF EXISTS (njtoqflg = 1):
      IF cjtoqkb = '01' AND dgaitong = X:  SKIP (当月停止)
      IF cjtoqkb = '02' AND dgaitong >= X: SKIP (以降停止)
    UPDATE xkkijun SET <col> = ...
```

使用パターン:
- 当月のみ停止: 某社員某処理月の例外(休職/出向調整/給与切替) → cjtoqkb='01' + njtoqflg=1
- 永続停止(以後全月): 退職後、項目廃止等 → cjtoqkb='02' + njtoqflg=1
- 解除: njtoqflg=0
- 項目単位停止: xkkijun の特定列だけ連携停止

## 主键と PK 列順序

- DB 実 PK: xkkijunctl_idx UNIQUE (ccompkb, cqtaikeikb, dgaitong, cshainno, ctableid, ccolumnid)
- xlsx 索引序号 1~6 暗示 PK 参与列: ccolumnid(1), ccompkb(2), cqtaikeikb(3), cshainno(4), ctableid(5), dgaitong(6)

## DB vs xlsx 差异点

| # | DB | xlsx | 差异 |
|---|----|------|------|
| 1 | 主键 6 列 UNIQUE idx | 索引序号 1~6 列 | PK 锁列一致,顺序 xlsx 不固定 |
| 2 | dmndate timestamp(0) | timestamp (無精度) | DB 实施 timestamp(0),xlsx 未标 |
| 3 | no rowid 单独 UNIQUE 索引 | xlsx 未提 rowid | xkkijun 有 rowid UNIQUE,xkkijunctl 没建,不影响 schema |
| 4 | njtoqflg numeric(1,0) | numeric 桁数 1 | 桁数一致,DB 实际 precision(1,0) |
| 5 | 0 行 (空表) | 設計書のみ | 実体空表,数据待投入 |
| 6 | xlsx 第 14 行 标 U | 第 14 行附近 | U 未明确含义,仅一行标注,未作为硬约束读取 |

## Relations
- 上位システム:UPDS-V7 給与システム
- 制御対象:xkkijun / xkkijunhw 系列(同型 PK 头部 4 列)
- PK 头部 4 列 (ccompkb, cqtaikeikb, dgaitong, cshainno) は xkkijun / xkkijunhw / xkkihon 等と同型
- xkkijunctl 自体は 15 列フラット,200 槽位"五花"拡張は無し