Field Service のカスタムトリガ

Field Service パッケージには、Salesforce オブジェクトに対するトリガが用意されています。各トリガは、さまざまな条件をチェックし、検出された内容に基づいてタスクを実行します。カスタムオブジェクトに対して実行されるトリガと、標準オブジェクトに対して実行されるトリガがあります。

割り当て済みリソース

行動

この���ブジェクトのすべてのトリガはカレンダー同期機能の一部です。同期機能については、Trailblazer Community のナレッジ記事番号 000316720 を参照してください。

Before Insert:

After Update:

このファイルの名前は FSL__TR004_Event_BeforeUpdate ですが、更新後にのみ起動します。

• 次の項目のいずれか 1 つ以上が変更された場合、このトリガはそれに従って Salesforce レコードの [所有者 ID]、[件名]、[場所]、[開始日時]、[終了日時] を更新します。
• [FSL__Event_Type__c] 項目が変更されていて新しい値が有効である場合、このトリガは、その値に従って Salesforce レコードを作成します。

After Delete:

このファイルの名前は FSL__TR004_Event_BeforeDelete ですが、削除後にのみ起動します。

• [FSL__Event_Type__c] 項目がサービス予定の [カレンダーの行動種別] 設定と一致し、サービスが更新されていない場合、このトリガは、そのサービスに関連する割り当て済みリソースを削除します。このトリガは、サービス予定のスケジュールを解除します。
• [FSL__Event_Type__c] 項目がリソース不在の [カレンダーの行動種別] 設定と一致している場合、このトリガは、関連する不在を削除します。

ガントチャート検索条件

After Insert:

After Update:

ガントチャートパレット

After Insert:

After Update:

地図の多角形

Before Insert:

• 指定された項目に多角形の最小および最大の緯度と経度を設定します。

Before Update:

業務時間

Before Delete:

最適化リクエスト

Before Insert:

• [FSL__Text_Status__c] テキスト項目に [FSL__Status__c] ピックリスト項目の値を設定します。[FSL__Text_Status__c] は、外部 ID としてマークされたテキスト項目であり、クエリパフォーマンスを高めるために使用されます。

Before Update:

• [FSL__Status__c] ピックリスト項目の [処理中] から [キュー] への変更を禁止します。このトリガは、状況を [処理中] に戻します。
• [FSL__Status__c] 値が [中止] のレコードが [完了] に変更されないことを検証します。変更される場合、このトリガは状況の変更を禁止して、エラーをスローします。
• 状況が [中止] に変更される場合、このトリガは次の条件を確認します。
  • 変更が最適化ユーザによって引き起こされたものではない。
  • 最適化要求が自動終了機能によって中止されていない。自動終了機能とは、カスタム設定の定義よりも長い時間に渡って特定の状況に留まっている要求を終了する機能です。
  • ユーザが自分のプロファイルまたはいずれかの権限セットで「Abort_Optimization_Request」カスタム権限を持っている。

上記の条件がすべて満たされていれば、要求は中止されます。

リソース不在

Before Insert:

• 地理位置情報値 (緯度と経度) のスケールを小数位 6 桁に変更します。
• リソース不在の [日時] 項目から秒とミリ秒を削除します。
• 地理位置情報値に基づいて [InternalSLRGeolocation] 項目 (緯度と経度) に値を入力します。[InternalSLRGeolocation] 項目は、番地レベルのルーティングと予測ルート計算で使用します。

After Insert:

• 挿入されたリソース不在の種別が「使用不可」である場合:
  • 複数日サービス予定がリソース不在の影響を受け、サービス予定が 1 つしか存在しない場合、このトリガは所要時間を更新します。
  • 組織で [重複を解消] が有効化されていて [移動トリガ] が無効化されている場合、このトリガは [重複を解消] をコールします。
  • 組織で移動トリガが有効化されていて、ステップ 1 で複数日予定が更新されていない場合、このトリガは、不在の開始日と終了日と同じスケジュールのすべてのサービスの移動を再計算します。
  • カレンダー同期機能が有効化されている場合、このトリガはリソース不在に対してカレンダーの行動を作成します。
• そうでない場合、このトリガは何もしません。

Before Update: (「Before Insert」と同じコンテンツ)

• 地理位置情報値 (緯度と経度) のスケールを小数位 6 桁に変更します。
• リソース不在の [日時] 項目から秒とミリ秒を削除します。
• 地理位置情報値に基づいて [InternalSLRGeolocation] 項目 (緯度と経度) に値を入力します。[InternalSLRGeolocation] 項目は、番地レベルのルーティングと予測ルート計算で使用します。地理位置情報値の変更は確認しません。Before Insert トリガの場合と同じように更新します。

After Update:

• 更新されたリソース不在の種別が「使用不可」である場合:
  • 複数日サービス予定がリソース不在の変更による影響を受け、サービス予定が 1 つしか存在しない場合、このトリガは所要時間を更新します。
  • 組織で [重複を解消] が有効化されていて [移動トリガ] が無効化されている場合、このトリガは [重複を解消] をコールします。
  • 組織で移動トリガが有効化されていて、ステップ 1 で複数日予定が更新されていない場合、このトリガは、不在の開始日と終了日と同じスケジュールのすべてのサービスの移動を再計算します。
  • カレンダー同期機能が有効化されている場合、このトリガはリソース不在に対してカレンダーの行動を作成します。
• そうでない場合、このトリガは何もしません。

Before Delete:

• 一致するカレンダーの行動が存在する場合は削除します。詳細は、カレンダー同期のナレッジ記事を参照してください。

After Delete:

• 削除されたリソース不在の種別が「使用不可」である場合:
  • 複数日サービス予定がリソース不在の削除による影響を受け、サービス予定が 1 つしか存在しない場合、このトリガは所要時間を更新します。
  • 組織で [重複を解消] が有効化されていて [移動トリガ] が無効化されている場合、このトリガは [重複を解消] をコールします。
  • 組織で移動トリガが有効化されていて、ステップ 1 で複数日予定が更新されていない場合、このトリガは、不在の開始日と終了日と同じスケジュールのすべてのサービスの移動を再計算します。

スケジュールポリシー

Before Insert:

• 組織でこの機能が有効化されている場合にのみ、[移動モード] チェックボックスがオンであることを検証します。
• 組織で高度な最適化が有効化されている場合にのみ、[全日最適化] チェックボックスがオンであることを検証します。

After Insert:

• 基本時間ルールの最早開始時刻と期日が存在しない場合は作成します。
• スケジュールポリシー作業ルール連結オブジェクトを作成して、これらの作業ルールを挿入されたポリシーに割り当てます。

Before Update:

• 組織でこの機能が有効化されている場合にのみ、[移動モード] チェックボックスがオンであることを検証します。
• 組織で高度な最適化が有効化されている場合にのみ、[全日最適化] チェックボックスがオンであることを検証します。

Before Delete:

• 削除されたレコードが予定の予約アクションのデフォルトスケジュールポリシーではないことを検証します。
• 組織でこの機能が有効化されている場合にのみ、[移動モード] チェックボックスがオンであることを検証します。
• 組織で高度な最適化が有効化されている場合にのみ、[全日最適化] チェックボックスがオンであることを検証します。
• 最早開始時刻と期日のスケジュールポリシー作業ルール連結オブジェクトを削除します。

スケジュールポリシー作業ルール

Before Insert:

• 重複がないことを検証します。つまり、同じポリシーで特定の作業ルールを参照しているスケジュールポリシー作業ルールが 1 つしか存在しないことを検証します。
• 同じポリシーに存在する拡張一致ルールが 2 つ以下であることを検証します。2 つ存在する場合は、異なるリンクオブジェクトを参照していることを確認してください。
• 件数種別が CustomValue の件数ルールが 4 つ以内であることを検証します。
• すべての [件数ルール] 項目が有効であることを検証します。

Before Update:

Before Insert と同じです。

Before Delete:

• 最早開始時刻と期日基本ルールに関連したスケジュールポリシー作業ルールレコードの削除を禁止します。
• スケジュールポリシーを削除すると、この検証がパスされ、関連するすべてのスケジュールポリシー作業ルールが削除されます。

サービス予定

Before Insert:

After Insert:

Before Update:

After Update:

Before Delete:

サービス内容

Before Insert:

Before Update:

Before Insert と同じです。

サービスリソース

Before Insert:

• [効率] 項目が空白ではない場合、このトリガは値が有効な範囲内 (0.1 ～ 10) であるかを確認します。そうでない場合、このトリガは挿入を禁止して、[効率] 項目の横にエラーを表示します。
• [ServiceCrewId] 項目が空白である場合、このトリガは同じサービスクルーを参照しているサービスリソースレコードが他にないか確認します。ある場合は、トリガはエラーをスローして挿入を禁止します。

After Insert:

• 組織で場所に基づいた共有が有効化されている場合、このトリガは、[RelatedRecordId] 項目で指定されているユーザに対して ServiceResourceShare オブジェクトを作成します。場所に基づいた共有が無効である場合、このトリガは何もしません。特定のレコードに対して [RelatedRecordId] 項目が空白である場合 (例: 種別がクルーであるサービスリソース)、このトリガはそのレコードに対して共有レコードを作成しません。

Before Update:

• [IsCapacityBased] チェックボックスがオフからオンに変更されると、このトリガは、そのリソースにリンクされているセカンダリサービステリトリーメンバーを除いて、サービステリトリーメンバーが 1 人しかいないことを検証します。そうでない場合、このトリガはエラーをスローして更新を禁止します。
• [効率] 項目が空白ではない場合、このトリガは値が有効な範囲内 (0.1 ～ 10) であるかを確認します。そうでない場合、このトリガは更新を禁止して、[効率] 項目の横にエラーを表示します。
• [IsCapacityBased] チェックボックスがオンである場合、このトリガは、このサービスリソースにサービスクルーメンバーレコードがないことを検証します。そうでない場合、このトリガはエラーをスローして更新を禁止します。
• [ServiceCrewId] 項目が変更され、新しい値が空白ではない場合、このトリガは、そのサービスクルーを参照している既存のサービスリソースレコードが存在しないことを確認します。そうでない場合、このトリガはエラーをスローして更新を禁止します。

After Update

• RelatedRecordId が更新時に変更され、組織で場所に基づいた共有が有効化されている場合、このトリガは、サービスリソースのすべての手動共有レコード (ユーザが作成したレコードを含む) を削除し、新しい関連ユーザに対して ServiceResourceShare オブジェクトを作成します。いずれかの手動共有オブジェクトの削除に失敗した場合、このトリガはそれらのオブジェクトをいずれも削除しません。

サービスリソース業務量

トリガ名は TR012_CapacityAfterUpdate ですが、挿入前と更新前にのみ起動します。

Before Insert:

• 月間業務量が月の初日に定義されていることを検証します。
• 同じ所要時間種別の業務量が互いに重複していない (つまり、リソースと日付を共有していない) ことを検証します。
• [期間] 項目と [終了日] 項目が有効であることを検証します。
• 業務量内でスケジュールされているサービスの所要時間に従って [MinutesUsed__c] 項目を更新します。
• [CapacityInWorkItems] 項目が空白ではない場合、このトリガは、業務量内でスケジュールされているサービス数で [Work_Items_Allocated__c] 項目を更新します。
• [HoursInUse__c] 項目は、[MinutesUsed__c] に基づいた数式項目です。この項目はそれに従って更新されます。
• 1970 年 1 月 1 日 00:00:00 (GMT) を起点としたミリ秒数で [最後に更新されたエポック] 項目を更新します。

Before Update:

• 月間業務量が月の初日に定義されていることを検証します。
• 同じ所要時間種別の業務量が重複していない (つまり、リソースと日付を共有していない) ことを検証します。
• [期間] 項目と [終了日] 項目が有効であることを検証します。
• [TimePeriod]、[StartDate]、[CapacityInHours]、[CapacityInWorkItems]、[ServiceResourceId] のいずれか 1 つ以上の項目が更新されているかどうかを検証します。
• これらの項目のいずれかが変更された場合、このトリガは、業務量内でスケジュールされているサービスの所要時間に従って [MinutesUsed__c] 項目を更新します。
• [CapacityInWorkItems] 項目が空白ではない場合、このトリガは、業務量内でスケジュー���されているサービス数で [Work_Items_Allocated__c] 項目を更新します。
• [HoursInUse__c] 項目は、[MinutesUsed__c] に基づいた数式項目です。この項目はそれに従って更新されます。
• 1970 年 1 月 1 日 00:00:00 (GMT) を起点としたミリ秒数で [最後に更新されたエポック] 項目を更新します。

サービスリソーススキル

Before Insert:

Before Update:

Before Insert と同じです。

サービステリトリー

Before Insert:

• [テリトリー名の重複を有効化] カスタム設定がオフ (デフォルト) の場合、このトリガは挿入されたテリトリーの名前が重複していないことを確認します。
• テリトリーに地理位置情報がある場合、このトリガは内部の番地レベルのルーティングの地理位置情報の値を入力します。

After Insert:

• [サービステリトリー共有を有効化] 設定が有効化されている場合、このトリガはテリトリーと同じ名前の公開グループが存在しなければ、テリトリーの名前で新しい公開グループを作成し、そのグループの共有レコードを作成します。
• テリトリーに親グループがある場合は、テリトリーの公開グループを上位テリトリーの公開グループのグループメンバーとして追加します。
• [サービスの自動分類を有効化] カスタム設定がオン (デフォルト) である場合、このトリガは、上位テリトリーと、すべてのテリトリーの最上位テリトリー値に従って [FSL__TerritoryLevel__c] 項目を設定します。この項目は、階層内におけるテリトリーのレベルを表し、多角形のアルゴリズムで使用されます。

Before Update:

• [テリトリー名の重複を有効化] カスタム設定がオフ (デフォルト) で、[名前] 項目が変更された場合、このトリガは更新されたテリトリーの名前が重複していないことを確認します。
• テリトリーに地理位置情報がある場合、このトリガは内部の番地レベルのルーティングの地理位置情報の値を入力します。

After Update:

• [名前] 項目または [所有者] 項目が変更された場合、このトリガはそれに応じてテリトリーの公開グループを更新します。
• [上位テリトリー] 項目が変更された場合、このトリガは上位テリトリーの公開グループを更新して、新しい階層に従ってすべてのレコードの [FSL__TerritoryLevel__c] 項目値を再計算します。

Before Delete:

• サービステリトリーの公開グループを削除します。
• 新しい階層に従って下位テリトリーの [FSL__TerritoryLevel__c] 項目を更新します。

サービステリトリーメンバー

Before Insert:

• サービステリトリーメンバーの [日時] 項目から秒を削除します。
• 日付の競合を確認します。同じ日付のプライマリまたは再配置サービステリトリーメンバーが存在する場合、このトリガは失敗します。
• 同じ日付のサービステリトリーメンバーが存在し、作成されたサービステリトリーメンバーが同じサービステリトリー内に存在する場合、このトリガは失敗します。
• 作成されたサービステリトリーメンバーレコードに地理位置情報 (緯度と経度) が含まれている場合、このトリガは [FSL__InternalSLRGeolocation__Latitude__s] 項目と [FSL__InternalSLRGeolocation__Longitude__s] 項目に値を入力します。これらの項目は、番地レベルのルーティングで使用されます。
• コントラクターに対する種別が再配置のサービステリトリーメンバーの作成を禁止します。
• セカンダリサービステリトリーメンバーを除いて、コントラクターに対する複数のサービステリトリーメンバーの作成を禁止します。

Before Update:

• 日付の競合を確認します。同じ日付のプライマリまたは再配置サービステリトリーメンバーが存在する場合、このトリガは失敗します。
• 同じ日付のサービステリトリーメンバーが存在し、作成されたサービステリトリーメンバーが同じサービステリトリー内に存在する場合、このトリガは失敗します。
• 更新されたサービステリトリーメンバーレコードに地理位置情報 (緯度と経度) が含まれている場合、このトリガは [FSL__InternalSLRGeolocation__Latitude__s] 項目と [FSL__InternalSLRGeolocation__Longitude__s] 項目に値を入力します。これらの項目は、番地レベルのルーティングで使用されます。
• コントラクターに対する種別が再配置またはプライマリの複数のサービステリトリーメンバーの作成を禁止します。
• コントラクターに対する (セカンダリサービステリトリーメンバーを除いた) 複数のサービステリトリーメンバーの作成を禁止します。

スキル要件

すべてのトリガが空白であること。

時間の連動関係

After Insert:

• サービス予定間で重複する連動関係の作成を禁止します。
• 作成された時間の連動関係チェーンへの [すぐ後に続く] 連動関係種別の追加を禁止します。
• 作成された時間の連動関係に従って、既存のチェーンにサービス予定を追加します。必要であれば、このトリガは作成された時間の連動関係に従って 2 つのチェーンをマージします。

Before Update:

• 同じ 2 つのサービス予定を持つ時間の連動関係がすでに存在する場合に、時間の連動関係の更新を禁止します。
• 作成された時間の連動関係チェーンへの [すぐ後に続く] 連動関係種別の追加を禁止します。

After Delete:

• 削除された時間の連動関係に従って、2 つの連動関係を分割します。たとえば、チェーン A に SerA→ SerB → SerC → SerD → SerE が含まれ、削除された時間の連動関係が SerC → SerD であれば、このトリガはチェーンを SerA → SerB → SerC と SerD → SerE の 2 つに分割します。

時間枠

Before Insert:

Before Update:

ユーザテリトリー

作業指示

Before Insert:

• [AccountId] 項目が空白ではなく、[VisitingHoursId] 項目が空白である場合、このトリガは関連する取引先の業務時間 ID を [VisitingHoursId] 項目に入力します。

Before Update:

• [AccountId] 項目または [VisitingHoursId] 項目が変更され、[AccountId] 項目が空白ではなく、[VisitingHoursId] 項目が空白である場合、このトリガは関連する取引先の業務時間 ID を [VisitingHoursId] 項目に入力します。
• [FSL__Prevent_Geocoding_For_Chatter_Actions__c] 項目の値が True である場合、このトリガは住所の変更時に発生する Data.com の地理位置情報のクリーンアップを無効化し、[FSL__Prevent_Geocoding_For_Chatter_Actions__c] 項目の値を False に戻します。

作業指示品目

すべてのトリガが空白であること。

作業ルール

Before Update:

• 作業ルールが対応可能状況ルールであり、[固定間隔] チェックボックスがオフである場合、このトリガは最小ギャップの設定を禁止します。
• 作業ルールが対応可能状況ルールであり、「休憩と移動」トリガが無効化されている場合、このトリガは休憩時間の設定を禁止します。
• 作業ルールが Boolean を照合ルールであり、[リソースのプロパティ] 項目が空白である場合、このトリガは作業ルールの更新を禁止します。
• 作業ルールが時間ルールであり、[スケジュール済み開始時刻] の値が [到着期間の開始/終了] と等しいかそれより前である場合、このトリガは時間ルールの更新を禁止します。
• 作業ルールが拡張一致ルールまたはカウントルールである場合、このトリガは無効な項目値によるルールの更新を禁止します。
• 組織に基本時間ルールが存在しないか、または変更されている場合、このトリガは有効な基本時間ルール (許容最早開始ルールと期日ルール) を作成します。

Before Delete:

• 基本時間ルール (許容最早開始ルールと期日ルール) の削除を禁止します。