1. Top
  2. yamori
  3. Files
  4. docs
  5. src
  6. サポートされるファイル
  7. 付与上書きログ.md
yamori

有給休暇計算を主目的とした簡易勤怠管理システム

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16
  17. 17
  18. 18
  19. 19
  20. 20
  21. 21
  22. 22
  23. 23
  24. 24
  25. 25
  26. 26
  27. 27
  28. 28
  29. 29
  30. 30
  31. 31
  32. 32
  33. 33
  34. 34
  35. 35
  36. 36
  37. 37
  38. 38
  39. 39
  40. 40
  41. 41
  42. 42
  43. 43
  44. 44
  45. 45
  46. 46
  47. 47
  48. 48
  49. 49
  50. 50
  51. 51
  52. 52
  53. 53
  54. 54
  55. 55
  56. 56
  57. 57
  58. 58
  59. 59
  60. 60
  61. 61
  62. 62
  63. 63
  64. 64
  65. 65
  66. 66
  67. 67
  68. 68
  69. 69
  70. 70
  71. 71
  72. 72
  73. 73
  74. 74
  75. 75
  76. 76
  77. 77
  78. 78
  79. 79
  80. 80
  81. 81
  82. 82 
<!--
SPDX-License-Identifier: AGPL-3.0-only
Copyright 2025 Shota FUJI

This program is free software: you can redistribute it and/or modify it under the terms
of the GNU Affero General Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along
with this program.  If not, see <http://www.gnu.org/licenses/>.
-->

付与上書きログファイルでは自動的に計算される年次有給休暇の付与を手動で上書きすることができます。

例えば、

- Yamori を導入する時点での年次有給休暇の残日数に調整する場合
- 8 割出勤を満たさなかったが一定日数付与する場合
- 何らかの理由で付与日をずらす必要がある場合

などに、特定の日付の付与をなかったことにすることや、逆に本来付与日ではない日に付与を行ったことにできます。

!!! example "例"

    | 社員 ID | 日付       | 付与日数 |
    | ------- | ---------- | -------- |
    | A01     | 2025-07-01 | 0        |
    | A01     | 2025-07-08 | 10       |

[社員 ID](#社員-id) と[日付](#日付)が同じ行が存在する場合は処理が中断されます。
過去の上書きログに変更を行う場合は、対象の行を直接更新してください。

## 読み込み条件

ファイル名もしくは Excel ブックのシート名に `付与上書き` という文字列が*含まれている*場合、そのファイルもしくはシートを付与上書きログとして読み込みます。
書式が異なる・不正なデータが存在する場合は処理が中断されます。

## 列の種類

付与上書きログの列は全て必須です。
列の順番は問いません。

### 社員 ID

[社員マスタ](./社員マスタ.md) で定義した社員 ID です。
存在しない社員 ID が見つかった場合は処理結果ログに警告として出力されます。

社員 ID として扱われる列名は[社員マスタ#社員 ID](./社員マスタ.md#社員-id) を参照してください。

### 日付

上書きする対象の日付です。
日付のほかに、 `n回目` (例: `2回目`) とすることで `n` 回目の通常付与を行う日を指定することができます。

<!-- TODO: 日付の書式に関する独立したページを作る -->

日付として扱われる列名は以下のとおりです。

- 日付
- 上書き日
- 対象日

### 付与日数

上書きする日数です。
数値、もしくは `n日` (例: `10日`) という指定ができます。

通常付与日を 0日で上書きすると、その通常付与がなかったことになります。
付与のない日付に 0日を指定しても何も起きませんが、入力ミスの可能性を考慮して処理結果ログに警告として出力されます。

負数の入力はエラーとなり処理が中断されます。
年次有給休暇の行使実績を[勤怠記録](./勤怠記録.md)に入力する、過去の付与日を 0日として上書きするなどしてください。

付与日数として扱われる列名は以下のとおりです。

- 付与日数
- 日数
- 上書き日数