通貨上限
管理対象イベント全体の実際の経費、推定経費、コミット済み経費、合計経費を追跡し、参加者の経費に支出制限を適用します。金額制限は、ユーザーが管理行動関係者レコードまたは経費関係者レコードを作成するときに適用される取引先レベルの制限です。
必要なエディション
| 使用可能なインターフェース: Lightning Experience |
| 使用可能なエディション: Life Sciences Cloud、Life Sciences Cloud for Customer Engagementアドオン ライセンス、Life Sciences Customer Engagement管理パッケージが付属するEnterprise EditionおよびUnlimited Edition。 |
前提条件
- 金額上限トリガーハンドラーを有効にします。
- 関係者の取引先に関連するすべての有効な上限金額を表示するには、Utilization Tracker Lightning アプリケーションビルダーコンポーネントを取引先レコードページに追加します。
マネタリーキャップのしくみ
金額制限では、次の 3 つの経費バケットの経費金額が計算されます。
- 推定経費: 1 つ以上の活動に対して支出が予測される金額。
- Committed expenses (達成予測経費): 1 つ以上の活動で承認された金額。
- 実際の経費: 1 つ以上の活動ですでに支出されている金額。
行動が進行中の場合、実際の経費のうち、推定経費と確定経費の合計が高い方を総計として計算します。行動が終了すると、実際の経費のみが考慮されます。
各関係者取引先には、提供者活動目標制限レコードで定義された支出制限があります。参加者が行動に追加されるか、経費が作成、更新、削除されるたびに、上限合計が自動的に再計算され、その制限に対してチェックされます。種別が [上限に含まれる] とマークされている経費のみが制限に含まれます。
制限に違反すると、上限の設定方法に応じて次の 2 つの方法のいずれかで応答します。
- エラー: アクションがブロックされ、エラーメッセージが出力され、参加者の追加や経費の記録ができません。
- 警告: このアクションは許可されますが、警告メッセージと共に管理イベント関係者の不一致レコードが作成されます。
経費総額の計算
経費の合計は、管理イベントの状況に基づいて計算されます。
管理対象イベントが完了した場合、つまり状況が完了状態を表す場合、総経費は実際の経費と等しくなります。
合計 = 実績
管理対象イベントが完了していない場合、つまり状況がドラフト状態を表す場合、合計経費は、実際の経費の最大額と推定 + 確定した経費の合計になります。
合計 = MAX(実績、推定 + 達成予測)
上限データは、提供者活動目標基準の追加情報項目に JSON 形式で保存され、[達成予測経費金額]、[実績経費金額]、[推定経費金額]、[経費総額] 項目に積み上げ集計されます。
次のコードは、金額の上限の例です。
{"1POXJOO0000002L4AU":{"isFinalValue":true,"isFinal":true,"estimatedMap":
{},"estimated":{},"committedMap":{},"committed": {},"actualMap":
{"1Z6XJ0000000iAjOAI":{"rate": 1.0,"amount":200.0},"1Z6XJ00000001970AA":
{"rate":1.0,"amount": 100.0}},"actual":{"1Z6XJ0000000iAjOAI":
{"rate": 1.0,"amount":200.0},"1Z6XJ00000001970AA":
{"rate": 1.0, "amount":100.077}}}}上限は、管理イベントが最終状態 (つまり、クローズまたはクローズ) になった後にのみ計算されます。最終的な状況は、イベント管理組織レベル設定の [完了したイベント状況] 項目に基づいて決定されます。換算レートは通貨に基づいて自動的に更新されます。
トリガーハンドラー
- ExpenseParticipantMonetaryCapsHandler
- 経費関係者が作成されると、ハンドラーは経費合計を再計算します。金額上限が [アラート種別] で [エラー] に設定されていて、新しい合計が金額上限を超えた場合、ハンドラーは経費関係者の作成をブロックします。[アラート種別] が [警告] の場合、金額制限を超えていても、ハンドラーは経費関係者の作成を許可しますが、警告も表示されます。経費種別が [上限に含まれる] とマークされている参加者のみが計数されます。
- 経費関係者の金額が更新されると、ハンドラーは新しい金額に基づいて上限合計を再計算します。上限金額の [アラート種別] が [エラー] に設定されている場合、ハンドラーは上限を超える金額の増加をブロックします。[アラート種別] が [警告] の場合、金額制限を超えても、ハンドラーは金額の増加を許可します。使用率が低下するため、現在の合計がすでに上限を超えている場合でも、制限なしで減少が許可されます。金額以外の項目を変更すると、再計算は一切トリガーされません。
- 経費関係者が削除されると、ハンドラーは上限合計を再計算して、削除された金額を削除します。関係者を削除すると常に上限が減少するため、削除は常に許可されます。
- MngEventPartMonetaryCapsHandler
- 新しい参加者が行動に追加されると、ハンドラーはその提供者の支出上限にすでに達しているかどうかを確認します。[アラート種別] が [エラー] の金額上限が設定されている場合、ハンドラーは追加を制限します。[アラート種別] で [警告] として金額の上限が設定されている場合、ハンドラーは警告付きで上限を許可します。
- 関係者取引先が変更されると (取引先から取引先へ、取引先からエキスパートへ、またはエキスパートから取引先へ)、ハンドラーは新旧両方の関係者の上限を再計算します。取引先がユーザーとスワップされた場合、その取引先の金額の上限のみが削減されます。非取引先種別 (ユーザー、取引先責任者) 間のスワップは効果がありません。
- MngEventMonetaryCapsHandler
- 管理イベントの状況が更新されると、トリガーハンドラーはすべての参加者の金額上限を再計算します。状況が対象状況 (ドラフトまたは完了) 以外の場合、ハンドラーは経費エントリを削除し、行動は追跡されなくなります。
- 管理イベントの開始日が関連付けられた活動計画の期間外に更新されると、ハンドラーは経費エントリを削除します。行動日が活動計画期間内にある場合、ハンドラーは新しい期間に基づいて経費を再計算します。
- 管理イベントが削除されると、ハンドラーは関連するすべての貢献を金額の上限制限から削除します。
- ExpenseMonetaryCapsHandler
- 経費の日付が更新された場合、ハンドラーは新しい日付に基づいて上限合計を再計算します。新しい日付が設定された期間外の場合、経費は上限に含まれなくなります。
- ProviderActivityMeasureType の Criteria JSON で定義された制御項目のいずれかが更新されても条件を満たしている場合、ハンドラーは上限を再計算します。ProviderActivityMeasureType の Criteria JSON で定義された制御項目のいずれかが更新されても条件を満たしていない場合、ハンドラーは貢献度を上限合計から削除します。
- [上限に含まれる] とマークされた経費が削除された場合、ハンドラーは経費を再計算し、その経費のエントリを削除します。種別が [上限に含まれる] とマークされている経費のみが計数されます。
一括処理ジョブ
- Calculate Expenses Against Monetary Caps (上限金額に対する経費の計算): データを一括でアップロードする場合、トリガーハンドラーは最新の取引先データに基づいて経費を再計算する一括処理ジョブです。
- Share Provider Activity Goals Based on Activity Plan Type (活動計画種別に基づく提供者活動目標の共有): [Event Management Limit (行動管理制限)] 種別の活動計画に関連付けられた提供者活動目標を取引先と連携したテリトリーと共有します。他の種別の活動計画に関連付けられた目標の場合、ジョブは活動計画の共有設定に従って目標を共有します。
オフラインモバイル同期
マネタリーキャップでは、モバイルと Web で異なる方法でオフラインのマネタリーキャップ違反を処理します。
Web では、営業担当が上限金額を超えているか上限に達している参加者を追加しようとすると、アクションがブロックされます。
モバイルでは、営業担当がオフライン中に同じアクションを試行しても、アクションはブロックされません。参加者は他のイベントに正常に追加されますが、関連する管理イベント参加者の不一致レコードが作成されます。モバイルを Web と同期すると、データはメインシステムと共有されます。
金額上限の設定
活動計画、提供者の活動目標、ブロック条件と警告条件を含む基準種別、経費種別など、金銭的上限を有効化するために必要なレコードと設定を定義します。
前提条件
- イベント管理の組織レベルの管理コンソール設定で、状況の最終値を示す [完了したイベントの状況] 項目を設定します。この設定は、イベントが終了したことを確認し、各参加者の実費を計算するために提供者活動目標基準で使用されます。
- テリトリー階層にテリトリーを作成します。ユーザー (営業担当) をテリトリーに追加し、関係者を表す取引先をテリトリーに割り当てます。詳細については、「Set Up Sales Territories for Life Sciences Cloud」を参照してください。
- 経費種別を作成します。[Expense Availability Type (経費の対応可能状況種別)] が [Managed Event (管理イベント)] であり、経費種別の開始日と終了日が活動計画の期間内にあることを確認します。[キャップに含める] チェックボックスをオンにします。詳細は、「経費管理」を参照してください。
設定タスク (システム管理者)
- [Event Management Limit (イベント管理の制限)] 種別の活動計画を、定義された期間で作成します。計画が有効になっている必要があります。
- テリトリーモデルに追加されたアカウントのプロバイダー活動目標を作成します。目標を活動計画に関連付けます。
- ブロック (エラー) および警告 (警告) シナリオの提供者活動基準種別を作成します。これは、金銭の上限を計算するときに確認する必要がある条件を表します。
- ブロックシナリオでは、次のコードを実行して提供者活動基準種別を設定します。
ProviderActivityMeasureType pamt = new ProviderActivityMeasureType( DeveloperName = 'PAMTMonetaryCaps', MasterLabel = 'PAMTMonetaryCaps', Category = 'MonetaryCapLimit', IsActive = true, ActivityObject = 'ExpenseParticipant', Criteria = '{"contextCondition":{"conditions":[{"field":"MngEvent.Status","operator":"In","value":"Draft;Completed"}]},"utilizationTypes":{"estimated":{"conditions":[{"field":"MngEvent.Status","operator":"In","value":"Draft;Completed"}]},"committed":{"conditions":[{"field":"MngEvent.Status","operator":"In","value":"Draft;Completed"}]},"actual":{"conditions":[{"field":"MngEvent.Status","operator":"In","value":"Draft;Completed"}]}}}', AlertType = 'Warning' ); insert pamt; - 同様に、同じ詳細と JSON 構造を使用して、警告シナリオのメタデータ設定を作成します。アラート種別として [警告] を選択します。
- ブロックシナリオでは、次のコードを実行して提供者活動基準種別を設定します。
- [Event Management Limit (イベント管理の制限)] 種別のプロバイダー活動目標に関連付けられたプロバイダー活動目標基準を作成します。金銭的上限ブロックシナリオ用に作成されたプロバイダー活動基準種別を追加します。
設定タスク (営業担当)
金銭的な上限を機能させるには、営業担当は基本的な行動管理レコードを設定する必要があります。
- 管理イベントを作成します。管理イベントの開始日と終了日が活動計画の期間内であることを確認します。
- テリトリーに合わせて取引先の管理イベント関係者を作成します。
- 経費を作成し、作成した管理イベントと関連経費種別を追加します。
提供者活動目標制限の作成
目標基準に関連付けられた提供者活動目標制限を作成します。取引先が関連付けられているすべてのイベントで取引先が使用する金額制限を設定します。
必要なエディション
| 必要なユーザー権限 | |
|---|---|
| 提供者活動の目標制限を設定する | 「ライフサイエンス商業管理者」権限セット |
ユーザーは、警告として作成された管理イベント参加者の不一致レコードを使用して、提供者活動目標で設定された金額制限を超える実際の経費を記録できます。
提供者活動基準種別の [アラート種別] 項目が [エラー] に設定されている場合、参加者の金額制限がすでに上限に達しているか超過している場合、別の行動への参加者の追加がブロックされます。
提供者活動基準種別の [アラート種別] 項目が [警告] に設定されている場合、金額制限がすでに上限に達しているか超過していても、別の行動に参加者を追加できます。
- アプリケーションランチャーで、[Provider Activity Goal Limits]を見つけて選択します。
- [新規] をクリックします。
-
[提供者活動基準種別] で、金額上限基準種別を選択します。
ブロックまたは警告シナリオ用に作成した提供者活動基準種別を選択します。
- 提供者の活動目標を選択します。
- 金額を金額制限として入力します。この金額は、すべてのイベントで取引先によって使用されます。
- 変更内容を保存します。
経費関係者の作成
ユーザーが経費の上限を追跡できるようにするには、経費を関係者に関連付けます。
必要なエディション
| 必要なユーザー権限 | |
|---|---|
| 経費関係者を作成する | 「行動管理」権限セット |
- アプリケーションランチャーで、[Expense Participants (経費関係者)] を見つけて選択します。
- レコードの名前を追加します。
-
経費レコードを選択します。
この項目は、特定のカテゴリで実際に支出された経費の合計を取得します。
- [関係者] では、まず [管理イベント関係者] を選択し、経費を作成する対応する関係者レコードを選択します。
- 参加者に発生した実際の経費を入力します。
- 変更内容を保存します。
活動計画レコード共有ルール
イベント主催者などのユーザーと活動計画を共有する方法について説明します。
活動計画レコード共有ルール
デフォルトでは、活動計画と提供者の活動目標は営業担当などのシステム管理者以外のユーザーと共有されません。これらのレコードを営業担当と共有するには、[Share Provider Activity Goals Based on Activity Plan Type (活動計画種別に基づいて提供者の活動目標を共有)] ジョブを実行します。[Life Sciences Commercial Auto Share (ライフサイエンスの商業自動共有)] 種別の [Provider Activity Goal Share (提供者活動目標の共有)] レコードと [Activity Plan Share (活動計画の共有)] レコードが作成され、関係者取引先に合わせてテリトリーと共有されます。
前提条件
[Share Provider Activity Goals Based on Activity Plan Type (活動プラン種別に基づいて提供者の活動目標を共有)] ジョブを実行する前に、提供者の活動目標と活動プランの共有設定を [Controlled by Parent (親によって制御)] から [Private (非公開)] に変更します。共有設定は [設定] にあります。
共有のしくみ
活動計画がすでに存在する場合、共有設定を [親が管理] から [非公開] に変更すると、関連付けられた提供者活動目標、目標基準、目標制限の共有アクセス権も変更されます。アクセス権が失われないように、一括処理ジョブでは活動プラン種別に基づいて活動プラン、提供者活動目標、および関連レコードが共有されます。
活動計画種別が [行動管理の制限] の場合、一括処理ジョブは提供者の活動目標と活動計画を取引先と連携するテリトリーと共有します。
活動計画種別が [行動管理の制限] 以外の場合、一括処理ジョブは親活動計画の共有に基づいて提供者活動目標、関連付けられた目標基準、目標制限を共有します。
提供者活動目標が共有されると、それに応じて提供者活動目標基準、提供者活動目標制限など、関連付けられたすべての活動計画オブジェクトが共有されます。
手動共有での共有のしくみ
また、提供者活動目標が、手動でユーザーと共有していた既存の活動計画の共有設定を継承するようにするには、[Life Sciences for Customer Engagement Setup (カスタマーエンゲージメント設定のライフサイエンス)] の [Include Records of All Sharing Types in Workflows (ワークフローにすべての共有種別のレコードを含める)] 切り替えを有効にします。
この設定を有効にすると、すべてのライフサイエンスプロセスのすべての共有種別 (手動共有を含む) が考慮されます。無効にすると、ライフサイエンスワークフローでは [Life Sciences Commercial Auto Share (ライフサイエンスの商業自動共有)] 共有種別のみが考慮されます。
[Include Records of All Sharing Types in Workflows (ワークフローにすべての共有種別のレコードを含める)] 切り替えがオンになった後に [Share Provider Activity Goals Based on Activity Plan Type (活動計画種別に基づいて提供者の活動目標を共有)] 一括処理ジョブを実行すると、手動共有を含むすべての共有種別が提供者の活動目標共有設定に複製されます。
切り替えが無効になっている場合、一括処理ジョブでは提供者活動目標の共有設定の Life Sciences Commercial Auto Share 共有種別設定のみが複製されます。詳細は、「Get Your Org Ready for the Customer Engagement Managed Package (Customer Engagement 管理パッケージに対する組織の準備)」を参照してください。
上限取引先マージ
上限データが重複する参加者の金銭的制限を計算するために行動管理で取引先マージ機能がどのように使用されているかについて説明します。
取引先のマージ機能では、2 フェーズの統合プロセスを使用して、同じ活動計画の提供者活動目標基準レコードを持つ成立取引先と不成立取引先をマージします。詳細は、「Account Merge」を参照してください。
フェーズ 1 では、取引先のマージ機能で両方の取引先の目標基準がマージされます。目標基準は [金額上限制限] カテゴリであり、[行動管理制限] 種別の同じ活動計画に関連付けられている必要があります。
マージの影響は次のとおりです。
- 不成立の取引先の目標基準が削除されます。
- 成立取引先の経費総額は、成立取引先と不成立取引先の経費金額を合計したものです。
- ProviderActivityGoalMeasure.AdditionalInformation に JSON として保存されている上限データに、両方のイベントの経費の詳細が含まれるようになりました。
- 不成立の取引先の参加者はその取引先にリンクされますが、経費は勝者の上限に統合されます。
フェーズ 2 では、取引先に同じ通貨の経費がある場合、取引先マージで推定経費、確定経費、実績経費が直接合計されます。
取引先の通貨が異なる場合、取引先マージでは、不成立の参加者取引先の経費の過去の換算レートを取得して成立取引先の通貨に変換し、成立取引先の経費合計を更新します。
マージの影響は次のとおりです。
- 不成立の取引先の経費は、過去の取引レートを使用して成立の取引先の通貨に換算されます。
- 成立取引先の経費総額は、成立取引先と不成立取引先の経費金額を合計したもので、換算後の金額が含まれます。
- 提供者活動目標基準の [追加情報] 項目に保存される上限データには、監査履歴の換算レートも含まれます。
