概要
Vitextra Absence & Coverage の 3 つの Web パーツ (My Absences、Team Absence Calendar、Substitutions) は、すべてのデータを 1 つのサイト (製品サイト) にある 6 つの標準 SharePoint リストに保存します。このサイトはお客様自身の Microsoft 365 テナントに属しているため、不在申請、残日数、代理の情報がテナントの外に出ることはなく、外部サービスに保存されることもありません。外部サービスへの呼び出しはライセンスの確認だけです。
この記事は、管理者、人事担当者、サイト所有者向けのリファレンスです。どのようなリストがあるか、それぞれに何が入っているか、重要な列の意味、どのリストを誰が編集することを想定しているか、データを保全するためのルールを説明します。
6 つのリストの概要
リストは、サイトを初めて選択したときに自動的に作成されます (KB10324. Absence & Coverage の Web パーツをページに追加してサイトを選択する方法を参照してください)。これらはサイトのナビゲーションに表示されない通常のカスタム リストです。サイト コンテンツから開いてください。
| リスト | 保存する内容 | Web パーツでの必要性 | 編集する人 |
|---|---|---|---|
AbsenceTypes | 不在の種類のカタログ: 名前、色、承認、非公開、半日、年間付与日数 | 必要 | 人事担当者またはサイト所有者がリスト上で直接編集 |
Absences | 不在申請 1 件につき 1 行。状態、承認者、勤務日数を含みます | 必要 | 従業員と承認者が Web パーツ経由で編集 |
Substitutions | 代理 1 件につき 1 行。一時的な代理または職務の引き継ぎです | 必要 | 従業員とマネージャーが Web パーツ経由で編集 |
Balances | 人と不在の種類ごとの年間付与日数と繰越日数 | 任意 | 人事担当者がリスト上で直接編集 |
Holidays | 勤務日として数えない祝日と会社の休日 | 任意 | 人事担当者がリスト上で直接編集 |
Settings | キーと値のペアで保存される製品設定 | 任意 | サイト所有者がリスト上で直接編集 |
Balances、Holidays、Settings が存在しない、または空の場合、Web パーツは既定値を使用して動作を続けます。必須の 3 つのリストのいずれかが存在しない場合、Web パーツはデータを読み込めません。
📝 注
サイトに同じ名前のリストが既にある場合、製品はそのリストをそのまま使用し、上書きも修復も行いません。列はリストの作成時にのみ追加されるため、手動で作成して列が不足しているリストは不完全なままです。

Absences リスト
My Absences で作成された申請は、それぞれ 1 行になります。従業員は Web パーツを通じてのみ変更します。
| 列 | 内容 |
|---|---|
Title | 従業員名と不在の種類から作られる読みやすいラベル |
Employee | 従業員 (ユーザー列)。My Absences は「自分の申請」を探すためにこの列を使用しません |
EmployeeEmail | テキストで保存した従業員のメール アドレス。Web パーツはこの列で照合するため、入力されたままにしておく必要があります |
TypeId | AbsenceTypes リストにある不在の種類の項目 ID |
TypeName | 申請を送信した時点で作成された種類名のコピー |
StartDate, EndDate | 初日と最終日 (日付のみ) |
StartHalf, EndHalf | はい/いいえ: 初日または最終日を半日として数えるかどうか |
WorkingDays | 申請を送信した時点で計算された勤務日数 |
AbsenceStatus | Pending、Approved、Rejected、Cancelled のいずれか |
Approver | 申請を判断する人 |
Substitute | 申請で指定された代理者 (ある場合) |
RequestComment | 従業員のコメント |
DecisionComment, DecisionDate | 承認者の返信と判断した日付 |
Substitutions リスト
| 列 | 内容 |
|---|---|
Title | 「不在の人 → 代理者」という読みやすいラベル |
AbsentUser, Substitute | 不在の人と、その代わりを務める人 |
StartDate, EndDate | 期間。職務の引き継ぎでは終了日を空のままにできます |
Kind | Temporary または Handover |
SubstitutionStatus | Pending、Accepted、Declined、Cancelled のいずれか |
Scope | 責任範囲のテキスト (Web パーツでは「責任範囲」と表示されます) |
AbsenceId | 関連する申請の ID。申請に紐付いていない代理では 0 |
3 つのマスター リストの列については、それぞれの保守方法を説明する記事に記載しています。AbsenceTypes は KB10352. 不在の種類を追加して構成する方法、Balances は KB10353. 年間付与日数と繰越日数を設定する方法、Holidays は KB10354. 祝日を追加する方法、Settings のキーは KB10355. 勤務週の設定方法、KB10356. 代替承認者の設定方法、KB10357. マイナス残日数を許可する方法を参照してください。

誰が何を編集するか
AbsencesリストとSubstitutionsリストには、サインインしているユーザーの権限で Web パーツが書き込みます。作成、承認、却下、キャンセル、代理の承諾と辞退はすべて My Absences と Substitutions で行います。これらの行をリスト ビューで編集しないでください。KB10358. 不在はリストビューではなく Web パーツで編集する理由を参照してください。AbsenceTypes、Balances、Holidays、Settingsはマスター データです。このバージョンには管理用の Web パーツがないため、人事担当者またはサイト所有者がリスト上で直接編集します。
アクセス許可とデータの保存場所
Web パーツを使用する従業員には、製品サイトに対する Member (edit) アクセスが必要です。Web パーツは、サインインしているユーザー自身の権限でリストを読み書きするためです。テナント管理者が 1 回だけ承認する Microsoft Graph のアクセス許可 User.Read.All は、プロファイル、上長、直属の部下、写真などの人に関するデータにのみ使用され、リストには使用されません。
❗ 重要
サイトの編集アクセスを持つ全員が、リストを開いて行を読むことができます。非公開に設定された不在の種類の行も例外ではありません。カレンダーの非公開ルールが詳細を隠すのは Web パーツ内だけで、項目レベルのアクセス許可はこのバージョンには含まれていません。厳格な機密性が必要な場合は、製品サイトにアクセスできる人を制限してください。KB10345. 非公開の不在の種類:同僚にカレンダーで見える内容を参照してください。
内部名を変更しない
Web パーツは列を内部名で読み書きします。内部名は上の表に記載した名前です。そのため、次の点に注意してください。
- これらの列の名前変更、削除、型の変更は行わないでください。リスト自体の名前も変更しないでください。
- 独自の列を追加することはできます。Web パーツはそれらを無視します。ただし必須にはしないでください。Web パーツはそれらの列を指定せずに行を作成するため、SharePoint がその行を拒否します。
- 独自の列の選択肢は追加できますが、製品が解釈する
Category、AbsenceStatus、Kind、SubstitutionStatusの選択肢は変更しないでください。
💡 ヒント
リストを変更する前に、リストをエクスポートするか、サイトのコピーを作成してください。リスト同士がどのように連携するかは、KB10350. 不在申請と代理の連携の仕組みで確認できます。
読み取り上限
Web パーツは 1 回のクエリで限られた数の行だけを読み込みます。通常の運用では、この上限は会社の必要量をはるかに上回っていますが、大規模な環境では把握しておくと役立ちます。
| データ | 上限 |
|---|---|
| 不在の種類 | 200 |
| 1 人の 1 年分の残日数の行 | 200 |
| 要求した期間内の祝日 | 500 |
| 設定の行 | 100 |
| My Absences での自分の申請 | 500 |
| カレンダーの表示期間内の申請 | 2000 |
| 承認待ちの申請 | 200 |