货币上限
跟踪受管事件的实际、估计、承诺和总费用，并对参与者的费用实施支出限制。货币上限是用户创建受管事件参与者记录或支出参与者记录时适用的客户级别限制。
所需的 Edition
| 适用于：Lightning Experience |
| 适用于：具有Life Sciences Cloud、Life Sciences Cloud for Customer Engagement加载项许可证和Life Sciences Customer Engagement受管软件包的Enterprise 和 Unlimited Edition。 |
先决条件
- 激活货币上限触发器处理程序。
- 要查看与参与者账户相关的所有有效货币上限，请将医疗服务使用情况跟踪器 Lightning 应用程序生成器组件添加到客户记录页面。
货币上限的工作原理
Monetary Cap 计算三个支出存储桶的费用金额：
- 估计费用：预计用于一项或多项活动的金额。
- 承诺费用：为一个或多个活动批准的金额。
- 实际费用：已为一项或多项活动支出的金额。
在事件进行时，系统会将实际费用与估计和承诺费用之和的较高者作为运行总计。一旦事件结束，系统将仅考虑实际费用。
每个参与者客户都有提供商活动目标限制记录中定义的支出限制。每当参与者添加到事件，或者创建、更新或删除费用时，系统会自动重新计算上限总额，并对照该限制进行检查。只有类型标记为包含在上限中的费用才会计入限制。
当超出限制时，系统会以两种方式之一响应，这取决于上限的配置方式：
- 错误：该操作被阻止，并显示一则错误消息，阻止添加参与者或记录费用。
- 警告：允许该操作，但会创建受管事件参与者差异记录，并显示一条警告消息。
总费用计算
根据受管事件的状态计算总费用。
如果受管事件完成，即状态代表结束状态，总费用等于实际费用。
总计 = 实际
如果受管事件未完成，即状态代表草稿状态，则总费用是实际费用和估计加上承诺费用的最大值。
总计 = 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 的条件 JSON 中定义的控制字段已更新但仍满足条件，处理器会重新计算上限。如果在 ProviderActivityMeasureType 的标准 JSON 中定义的控制字段已更新但不符合条件，处理器将从上限总数中删除贡献。
- 如果标记为包含在上限中的费用被删除，处理程序会重新计算费用并删除费用的条目。仅计算类型标记为“包含在上限中”的费用。
批处理作业
- 针对货币上限计算费用：当批量上载数据时，触发器处理程序是该批处理作业根据最新的客户数据重新计算费用。
- 根据活动计划类型共享提供商活动目标：与类型为事件管理限制的活动计划关联的提供商活动目标与客户一致的区域共享。对于与其他类型的活动计划关联的目标，作业会根据活动计划的共享设置共享目标。
离线移动同步
Monetary Caps 在移动设备上处理离线货币上限违规的方式与在 Web 上不同。
在 Web 上，当销售代表尝试添加已超出货币上限限制或处于上限的参与者时，系统会阻止该操作。
在移动设备上，当销售代表离线尝试相同操作时，系统不会阻止该操作。参与者成功添加到其他事件，但会创建相关的受管事件参与者差异记录。当移动设备与 Web 同步时，数据将与主系统共享。
货币上限设置
设置激活货币上限所需的记录和配置，包括活动计划、提供商活动目标、具有阻止和警告条件的评测类型以及费用类型。
先决条件
设置任务（管理员）
- 使用定义的时间段，创建活动计划，类型为事件管理限制。计划应处于活动状态。
- 为添加到区域模式的客户创建提供商活动目标。将目标与活动计划关联。
- 为块（错误）和警告（警告）场景创建提供商活动评测类型。这表示在计算货币上限时需要检查的条件。
- 对于块场景，通过运行以下代码配置提供商活动评测类型：
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 结构。将提醒类型选择为警告。
- 对于块场景，通过运行以下代码配置提供商活动评测类型：
- 创建提供商活动目标评测，与事件管理限制类型的提供商活动目标关联。添加为货币上限块场景创建的提供商活动评测类型。
设置任务（销售代表）
为使货币上限正常工作，销售代表必须设置基本事件管理记录。
- 创建受管事件。确保受管事件的开始日期和结束日期在活动计划的时间段内。
- 为与区域一致的客户创建受管事件参与者。
- 创建费用，并添加您创建的受管事件和相关费用类型。
创建提供商活动目标限制
创建与目标评测关联的提供商活动目标限制。设置客户在与客户关联的所有事件中使用的货币限制。
所需的 Edition
| 所需用户权限 | |
|---|---|
| 配置提供商活动目标限制： | 生命科学商业管理员权限集 |
系统允许用户记录超出提供商活动目标中设置的货币限制的实际费用，并创建受管事件参与者差异记录作为警告。
如果提供商活动评测类型的“警报类型”字段设置为“错误”，则系统会阻止将参与者添加到其他事件（如果其金额限制已到上限或已超出）。
如果提供商活动评测类型的“警报类型”字段设置为“警告”，系统将允许将参与者添加到另一个事件中，即使他们的货币限制已经上限或已经超出。
- 从应用程序启动程序中，查找并选择提供商活动目标限制。
- 单击新建。
-
对于提供商活动评测类型，选择货币上限评测类型。
选择您为块或警告场景创建的提供商活动评测类型。
- 选择提供商活动目标。
- 输入金额作为货币限制。该金额由客户在所有事件中使用。
- 保存更改。
创建费用参与者
为了帮助用户跟踪费用上限，请将费用与参与者相关联。
所需的 Edition
| 所需用户权限 | |
|---|---|
| 要创建支出参与者： | 事件管理权限集 |
- 从应用程序启动程序中，查找并选择费用参与者。
- 为记录添加名称。
-
选择支出记录。
此字段捕获特定类别的实际总支出。
- 对于参与者，首先选择受管事件参与者，然后选择您为其创建费用的相应参与者记录。
- 输入参与者的实际费用。
- 保存更改。
活动计划记录共享规则
了解有关如何与用户（例如事件组织者）共享活动计划的更多信息。
活动计划记录共享规则
默认情况下，活动计划和提供商活动目标不会与非管理员用户共享，例如销售代表。要与销售代表共享这些记录，请运行基于活动计划类型的共享提供商活动目标作业。系统创建生命科学商业自动共享类型的提供商活动目标共享记录和活动计划共享记录，并与与参与者客户一致的区域共享。
先决条件
在运行“基于活动计划类型的共享提供商活动目标”作业之前，请将提供商活动目标和活动计划共享设置从“由父级控制”更改为“专用”。您可以在“设置”中找到共享设置。
共享的工作方式
如果活动计划已存在，将共享设置从父级控制更改为专用也会更改关联提供商活动目标、目标评测和目标限制的共享访问权限。为确保访问权限不会丢失，批处理作业会根据活动计划类型共享活动计划、提供商活动目标和相关记录。
如果活动计划类型是事件管理限制，批处理作业会与与客户一致的区域共享提供商活动目标和活动计划。
如果活动计划类型不是事件管理限制，则批处理作业会根据父级活动计划共享共享提供商活动目标、关联的目标评测和目标限制。
当共享提供商活动目标时，所有相关的活动计划对象（例如提供商活动目标评测、提供商活动目标限制）都会相应地共享。
共享如何适用于手动共享
此外，为确保提供商活动目标继承手动与用户共享的现有活动计划的共享设置，请在“客户参与度设置”中打开“在工作流中包含所有共享类型的记录”切换。
启用后，此设置会考虑所有生命科学流程的所有共享类型，包括手动共享。在关闭时，生命科学工作流仅考虑生命科学商业自动共享共享类型。
在打开“在工作流中包含所有共享类型的记录”切换按钮后运行“基于活动计划类型的共享提供商活动目标”批处理作业时，该批处理作业会复制提供商活动目标共享设置中的所有共享类型，包括手动共享。
在切换关闭时，批处理作业仅复制提供商活动目标共享设置的生命科学商业自动共享共享类型设置。有关更多信息，请查看为贵组织准备客户参与受管软件包。
货币上限客户合并
了解事件管理如何使用客户合并功能计算上限数据重叠的参与者的货币限额。
客户合并功能使用两阶段合并流程来合并具有相同活动计划的提供商活动目标评测记录的赢得客户和失去客户。有关更多详细信息，请查看客户合并。
在第一阶段，客户合并功能会合并两个客户的目标评测。目标评测应属于货币上限限制类别，并应与事件管理限制类型的相同活动计划相关联。
合并的影响如下。
- 将删除亏损客户的目标评测。
- 赢得客户的总费用金额是赢得客户和失去客户的费用金额的总和。
- 在 ProviderActivityGoalMeasure.AdditionalInformation 中存储为 JSON 的上限数据现在包含来自这两个事件的费用详细信息。
- 亏损客户的参与者仍然与其客户相关联，但费用被合并到赢得客户的上限中。
在第二阶段，如果客户的费用币种相同，客户合并会直接将估计、承诺和实际费用相加。
如果客户有不同的币种，客户合并会获取失败参与者客户费用的历史汇率，并将其转换为赢得客户的币种，并更新赢得客户的总费用。
合并的影响如下。
- 亏损客户的费用会使用历史交易汇率转换为赢得客户的币种。
- 赢得客户的总费用金额是赢得客户和失去客户的费用金额的总和，包括转换后的金额。
- 上限数据（存储在提供商活动目标评测的其他信息字段中）也包含审计跟踪的兑换率。
