ここでは、任意の項目に対して営業時間の計算を行う方法について説明します。
＜目次＞
| 目次 |
|---|
操作方法
1．ビルドメニューを表示します。 ビルドメニューを表示する操作については、「コンフィグレーションに使用するメニュー(Classic)」を参照してください。
2．ビルドメニューで、[開発]-[カスタムメタデータ型]をクリックします。
...
1．設定画面を表示します。 設定画面を表示する操作については、「コンフィグレーションに使用するメニュー」を参照してください。
2．クイック検索より「カスタムメタデータ型」と検索します。検索結果から「カスタムメタデータ型」をクリックします。
...
3．[営業時間の追加設定]の[レコードの管理]をクリックします。
...
営業時間の追加設定の登録項目
...
営業時間の追加設定の、登録項目を以下に示します。
| 警告 |
|---|
各登録項目に記述するAPI参照名には接頭辞に"SMOC__"は付けないでください。 |
項目 | 説明 | 必須 |
|---|---|---|
表示ラベル | 営業時間の追加設定一覧に表示する、わかりやすい名前を指定してください。 例：営業時間の計算結果 | 〇 |
営業時間の追加設定名 |
営業時間の追加設定一覧に表示する、わかりやすい一意の名前を指定してください。 例：businessHoursCalcResults_1 ※入力文字は半角英数字に限られますが、記号はアンダースコアのみ使用可能です。 | 〇 | |
対象オブジェクト | 使用するオブジェクトを、API参照名で指定します。 例：ox_obj_incident__c API参照名の確認方法については、「オブジェクトの項目のAPI参照名とデータ型を確認する」を参照してください。 | 〇 |
計算方法 |
計算方法を指定します。指定した計算方法に対する、[計算元項目1]、[計算元項目2]、[対象項目]に指定できる項目型をあわせて説明します。
任意の日時と日時の間の差分時間を計算する場合任意の日時と日時の間の差分時間を計算する場合（詳細はこちら） 以下のいずれかを指定してください。
| 〇 | |||
任意の日時と日時の間の差分日数を計算する場合（詳細はこちら）
| ||||
任意の日時から、一定の時間が経過した日時を計算する場合（詳細はこちら） 以下のいずれか指定してください。
| ||||
対象項目 | 計算結果を出力する項目を、API参照名で指定します。 指定可能な型については、[計算方法]の説明を参照してください。 例：target__c API参照名の確認方法については、「オブジェクトの項目のAPI参照名とデータ型を確認する」を参照してください。 | 〇 | ||
計算元項目1 | 計算に使用する1番目の項目を、API参照名で指定します。 指定可能な型については、[計算方法]の説明を参照してください。 例：startDateTime__c API参照名の確認方法については、「オブジェクトの項目のAPI参照名とデータ型を確認する」を参照してください。 | 〇 | ||
計算元項目2 | 計算に使用する2番目の項目を、API参照名で指定します。 指定可能な型については、[計算方法]の説明を参照してください。 例：endDateTime__c API参照名の確認方法については、「オブジェクトの項目のAPI参照名とデータ型を確認する」を参照してください。 | 〇 | ||
数値項目に負数を許可 | 任意の日時から、一定の時間が経過した日時を計算する場合に、数値項目2に負数を入力可能にします。 例：タスクの対応期限-2日を中間報告日として設定 |
※デフォルトでは、組織の営業時間が考慮されて計算されます。レコードに営業時間を関連付けた場合は、関連付けた営業時間が優先されます。
営業時間計算例
...
営業時間の追加設定の、各計算方法を示します。
| アンカー | ||||
|---|---|---|---|---|
|
| 注意 |
|---|
任意の日時と日時の間の差分時間計算に対しての項目の型は以下のように設定する必要があります。
|
...
※[計算元項目2]は、[計算元項目1]よりも後の日時となるように指定してください。 |
| 情報 |
|---|
以下のような設定をした場合の計算例を示します。
以下の図が計算結果となります。  |
計算方法 | 説明 |
|---|---|
[日時項目2-日時項目1→日] |
[計算元項目2]と、[計算元項目1]の間の期間を、日単位で計算します。 計算内容：36(時間) × 1/24(日) = 1.5 対象項目には「1.5」と表示されます。 | |
[日時項目2-日時項目1→時] |
[計算元項目2]と、[計算元項目1]の間の期間を、時間単位で計算します。 対象項目には「36」と表示されます。※時間で表示されるため、そのまま表示されます。 | |
[日時項目2-日時項目1→分] |
[計算元項目2]と、[計算元項目1]の間の期間を、分単位で計算します。 計算内容：36(時間) × 60(分) = 2160 対象項目には「2160」と表示されます。 |
| アンカー | ||||
|---|---|---|---|---|
|
| 注意 |
|---|
任意の日時と日時の間の差分日数計算に対しての項目の型は以下のように設定する必要があります。
※[計算元項目2]は、[計算元項目1]よりも後の日時となるように指定してください。 |
| 情報 |
|---|
以下のような設定をした場合の計算例を示します。 パターン1：営業時間内～営業時間内
|
...
以下の図が計算結果となります。  パターン2：営業時間内～営業時間外
以下の図が計算結果となります。  パターン3：営業時間外～営業時間内
以下の図が計算結果となります。  |
計算方法 | 説明 |
|---|---|
[日時項目2-日時項目1→営業日数]：(営業時間を反映する) | [計算元項目2]と、[計算元項目1]の間の期間の営業時間がまたがれたときカウントします。対象項目には以下のように表示されます。 パターン1：営業時間内～営業時間内（9:00~17:00）：4 パターン2：営業時間内～営業時間外（9:00~18:00）：5 パターン3：営業時間外～営業時間内（18:00~10:00）：3 |
[日時項目2-日時項目1→営業日数]：(営業時間を反映しない) | [計算元項目2]と、[計算元項目1]の間の期間の営業日がまたがれたときカウントします。対象項目には以下のように表示されます。 パターン1：営業時間内～営業時間内（9:00~17:00）：4 パターン2：営業時間内～営業時間外（9:00~18:00）：4 パターン3：営業時間外～営業時間外（18:00~21:00）：4 |
| アンカー | ||||
|---|---|---|---|---|
|
| 注意 |
|---|
任意の日時から、一定の時間が経過した日時の計算に対しての項目の型は以下のように設定する必要があります。
|
...
| 情報 |
|---|
以下のような設定をした場合の計算例を示します。
|
...
計算方法 | 説明 |
|---|---|
[日時項目1+数値項目2(日)→日時] |
[ |
計算元項目2] |
の値を[ |
計算元項目1]の値を営業時間を考慮し日単位で足します。 計算内容：2024/7/3 9:00 + 7(日) = 2024/7/10 9:00 対象項目には「2024/7/10 9:00」と表示されます。 |
[日時項目1+数値項目2(時)→日時] |
[ |
計算元項目2] |
の値を[ |
計算元項目1] |
[日時項目1+数値項目2(分)→日時]：[計算元項目1]の日時から、[計算元項目2]に指定した分数が経過した日時を計算します。
の値を営業時間を考慮し時間単位で足します。 計算内容：2024/7/3 9:00 + 7(時) = 2024/7/03 16:00 対象項目には「2024/7/03 16:00」と表示されます。 |
[日時項目1+数値項目2( |
分)→日時] |
| 注意 |
|---|
営業時間の設定により、計算後に1日より多く加算されることがあります。 |
〇
計算結果を出力する項目を、API参照名で指定します。
[ |
API参照名の確認方法については、「オブジェクトの項目のAPI参照名とデータ型を確認する」を参照してください。
〇
計算元項目1
計算に使用する1番目の項目を、API参照名で指定します。
指定可能な型については、[計算方法]の説明を参照してください。
API参照名の確認方法については、「オブジェクトの項目のAPI参照名とデータ型を確認する」を参照してください。
〇
計算元項目2
計算に使用する2番目の項目を、API参照名で指定します。
指定可能な型については、[計算方法]の説明を参照してください。
API参照名の確認方法については、「オブジェクトの項目のAPI参照名とデータ型を確認する」を参照してください。
〇
数値項目に負数を許可
任意の日時から、一定の時間が経過した日時を計算する場合に、数値項目2に負数を入力可能にします。
例：タスクの対応期限-2日を中間報告日として設定
| 警告 |
|---|
各登録項目に記述するAPI参照名には接頭辞に"SMOC__"は付けないでください。 |
計算元項目2]の値を[計算元項目1]の値を営業時間を考慮し分単位で足します。 計算内容：2024/7/3 9:00 + 7(分) = 2024/7/03 9:07 対象項目には「2024/7/03 9:07」と表示されます。 |
参考情報
...
営業時間を設定する場合は、マニュアル「運用管理ガイド 組織の営業時間を登録する」を参照してください。
休日を設定する場合は、マニュアル「運用管理ガイド 組織の営業時間に休日を設定する」を参照してください。
営業時間が9:00~17:00の場合、17:00は営業時間内には含まれません。