概要

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 パーツはデータを読み込めません。

📝 注
サイトに同じ名前のリストが既にある場合、製品はそのリストをそのまま使用し、上書きも修復も行いません。列はリストの作成時にのみ追加されるため、手動で作成して列が不足しているリストは不完全なままです。

「サイト コンテンツ」ページに表示される製品サイトの 6 つのリスト

「サイト コンテンツ」ページに表示される製品サイトの 6 つのリスト

Absences リスト

My Absences で作成された申請は、それぞれ 1 行になります。従業員は Web パーツを通じてのみ変更します。

列内容
Title従業員名と不在の種類から作られる読みやすいラベル
Employee従業員 (ユーザー列)。My Absences は「自分の申請」を探すためにこの列を使用しません
EmployeeEmailテキストで保存した従業員のメール アドレス。Web パーツはこの列で照合するため、入力されたままにしておく必要があります
TypeIdAbsenceTypes リストにある不在の種類の項目 ID
TypeName申請を送信した時点で作成された種類名のコピー
StartDate, EndDate初日と最終日 (日付のみ)
StartHalf, EndHalfはい/いいえ: 初日または最終日を半日として数えるかどうか
WorkingDays申請を送信した時点で計算された勤務日数
AbsenceStatusPending、Approved、Rejected、Cancelled のいずれか
Approver申請を判断する人
Substitute申請で指定された代理者 (ある場合)
RequestComment従業員のコメント
DecisionComment, DecisionDate承認者の返信と判断した日付

Substitutions リスト

列内容
Title「不在の人 → 代理者」という読みやすいラベル
AbsentUser, Substitute不在の人と、その代わりを務める人
StartDate, EndDate期間。職務の引き継ぎでは終了日を空のままにできます
KindTemporary または Handover
SubstitutionStatusPending、Accepted、Declined、Cancelled のいずれか
Scope責任範囲のテキスト (Web パーツでは「責任範囲」と表示されます)
AbsenceId関連する申請の ID。申請に紐付いていない代理では 0

3 つのマスター リストの列については、それぞれの保守方法を説明する記事に記載しています。AbsenceTypes は KB10352. 不在の種類を追加して構成する方法、Balances は KB10353. 年間付与日数と繰越日数を設定する方法、Holidays は KB10354. 祝日を追加する方法、Settings のキーは KB10355. 勤務週の設定方法、KB10356. 代替承認者の設定方法、KB10357. マイナス残日数を許可する方法を参照してください。

複数の申請が登録された Absences リスト

複数の申請が登録された Absences リスト

誰が何を編集するか

  • 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

注目の記事

List Filter Online でのグループ化、並べ替え、集計

Vitextra List Filter Online Web パーツの Sort、Group By、Totals 設定のリファレンスです。2 レベルの並べ替え、列ヘッダーからのユーザーによる並べ替え、最大 2 つの列によるグループ化、Count、Average、Maximum、Minimum、Sum、Standard Deviation、Variance の各関数、集計が表示される場所、Excel へのエクスポート方法について説明します。

41 3 分
カスケード フィルター: 選択済みの他のフィルターによるドロップダウン オプションの絞り込み

Vitextra List Filter Online Web パーツの Cascading filters オプションが、ドロップダウン フィルター コントロールの選択肢を、選択済みの他のフィルターに一致するアイテムに存在する値のみに絞り込む仕組みを説明します。オプションの有効化、シナリオ例、動作の詳細、パフォーマンス上の考慮事項、制限事項について解説します。

47 2 分
カスタム画像をタイル アイコンとして使用する

Vitextra Smart Tiles Web パーツで、タイルのアイコンを独自の画像に置き換える方法を説明します。Custom image オプション、画像 URL の入力またはサイトのドキュメント ライブラリからの画像の選択、画像の要件、サイズ、アイコンに戻すための画像の削除について解説します。

40 1 分

共有