勤務カレンダー時間計算

概要

mindzie は現在、フィルター、計算機、エンリッチメントオペレーターにおいて 勤務カレンダー対応の期間計算 をサポートしています。有効にすると、期間計算は夜間、週末、祝日などの非稼働時間を除外し、生のカレンダー時間ではなく正確な営業時間を測定します。

仕組み

標準カレンダー時間と勤務カレンダー時間の違い

シナリオ	カレンダー時間	勤務カレンダー時間（平日9時〜17時）
月曜16時から火曜10時	18時間	2時間（1時間：月曜＋1時間：火曜）
金曜15時から月曜9時	66時間	2時間（金曜15時〜17時のみ）
祝日のアクティビティ	カウントされる	除外される

「勤務カレンダーを使用」オプション

イベントログに勤務カレンダーが設定されている場合、期間関連の編集画面に新しいチェックボックスが表示されます：

[x] 勤務カレンダーを使用（営業時間のみ）

有効にすると、勤務カレンダーに定義された夜間、週末、祝日が期間から除外されます。

重要： このオプションはイベントログに勤務カレンダーが設定されている場合のみ表示されます。オプションが表示されない場合は、まず「勤務カレンダー設定」エンリッチメントを追加して営業時間を定義してください。

勤務カレンダーの設定方法

勤務カレンダー対応の期間計算を利用するには、イベントログに勤務カレンダーを設定する必要があります：

1. ノートブック／分析を開く
2. エンリッチメントブロックを追加
3. 勤務カレンダー設定 オペレーターを選択
4. 勤務時間を設定（例：9:00 AM - 5:00 PM）
5. 勤務日を設定（例：月曜〜金曜）
6. 必要に応じて祝日を追加
7. ノートブックを実行

設定完了後、すべての期間編集画面に「勤務カレンダーを使用」オプションが表示されます。

対応コンポーネント

以下のコンポーネントで「勤務カレンダーを使用」オプションに対応しています：

フィルター

フィルター	説明
ケース期間	初回から最終イベントまでの合計期間でケースをフィルター
アクティビティ間時間	2つの特定アクティビティ間の期間でケースをフィルター

計算機

計算機	説明
選択イベント間の時間	2種類のイベント間の期間統計を計算
アクティビティまでの時間	ケース開始から特定アクティビティまでの期間を計算

エンリッチメントオペレーター

オペレーター	説明
アクティビティ間の期間	2つのアクティビティ間の時間でケース属性を作成
属性からアクティビティまでの期間	日付属性からアクティビティまでの期間を計算
ケース属性からアクティビティ時間までの期間	ケース属性から複数のアクティビティ発生までの期間を計算
アクティビティから現在時刻までの時間差	アクティビティから現在時刻までの経過時間を計算
現在時刻からの時間差	日付属性から現在時刻までの経過時間を計算
イベント時間差	2つのイベントレベルの日付／時間属性間の期間を計算

動作詳細

三状態ロジック

勤務カレンダー使用設定は三状態ロジックを使用しています：

値	動作
未チェック	カレンダー時間を強制（勤務カレンダー設定があっても無視）
チェック済み	勤務カレンダー時間を強制（営業時間のみ使用）
デフォルト（明示的に設定しない場合）	ログのデフォルト設定に従う

フォールバック処理

勤務カレンダー使用が有効でもログに勤務カレンダーが設定されていない場合、計算は静かに標準カレンダー時間へフォールバックします。これにより後方互換性が保たれ、エラーが防止されます。

設定の永続化

勤務カレンダー使用設定はフィルター、計算機、エンリッチメントオペレーターの設定と共に保存されます。既存ブロックを編集した際は、前回の設定値が復元されます。

利用シナリオ

実際の処理時間の測定

シナリオ： チームが請求書処理にどれくらいかかっているか測定したいが、生のカレンダー時間には夜間や週末が含まれている。

解決策：

1. 平日9時から17時の勤務カレンダーを設定
2. 「アクティビティ間の期間」エンリッチメントで勤務カレンダー使用を有効化
3. 期間は実際の勤務時間を反映する

SLA遵守の監視

シナリオ： SLAは4営業時間以内に顧客対応が必要で、4カレンダー時間ではない。

解決策：

1. サポート営業時間に合わせた勤務カレンダーを設定
2. 「アクティビティから現在時刻までの時間差」を勤務カレンダー使用で計算
3. 4時間を超えたケースをフィルターまたはアラート

正確な経過時間レポート

シナリオ： ケースの滞留期間を報告したいが、週末は経過時間から除外したい。

解決策：

1. 勤務カレンダーを設定
2. 「現在時刻からの時間差」を勤務カレンダー使用で計算
3. 経過時間は営業時間のみを反映

技術メモ

• 勤務カレンダー計算は中央に WorkingCalendarCalculator クラスを使用
• すべての期間計算は有効時にこの計算機を経由
• 勤務カレンダーは SuperLog オブジェクトに保存
• 日毎に異なる勤務時間や祝日対応など複雑なカレンダーに対応可能

関連ドキュメント

• フィルター概要
• 計算機概要
• エンリッチメント概要