含附加绑定的值帮助
ABAP RESTful 应用程序编程模型 › 开发 › 开发 UI 特定 › 添加值帮助 › 含附加绑定的值帮助
预设过滤条件可以通过值帮助的附加绑定建立。
上下文
您可以使用附加绑定,在源视图和值帮助提供者之间定义多个绑定条件。然后通过附加绑定自动过滤值帮助。它仅建议与附加绑定匹配的条目。此附加绑定可以是其他元素或参数。这些需要存在于源视图和值帮助提供者视图中。在值帮助提供者中选择条目时,两个绑定元素的值都将传输到源 CDS 视图的输入字段。
示例
在我们的预订场景中,我们可以在字段 ConnectionID 上应用具有附加绑定的值帮助。值帮助提供者是管理连接的视图。此值帮助提供者不仅包含连接标识字段,还包含同样位于消费者视图中的承运方标识字段。我们可以建立第二个绑定条件,以便值帮助提供者仅显示与预先选择的承运商标识的连接。
过程
为用作值帮助提供者的 CDS 视图创建数据定义。它必须包含具有源视图中输入字段的可用值的字段。此外,它必须包含为其建立附加绑定的字段。
值帮助提供者视图包含定义了映射条件的连接标识和承运商标识。
define view /DMO/I_Connection_VH as select from /dmo/connection { key carrier_id, key connection_id, airport_from_id, airport_to_id, departure_time, arrival_time, distance, distance_unit }
在 CDS 源视图中,将以下注释添加到要在 UI 上提供值帮助的元素。
@Consumption.valueHelpDefinition: [{ entity: {name: 'entityRef', element: 'elementRef'} , additionalBinding: [{ element: 'elementRef' | parameter: 'paramRef', localElement: 'elementRef' | localParameter: 'paramRef', usage: #FILTER | #RESULT | #FILTER_AND_RESULT }] }]
附加绑定为同一目标值帮助提供者实体上的值帮助定义第二个条件,用于过滤值帮助结果列表和/或返回所选值帮助记录中的值。可以为附加元素或参数定义附加绑定。根据 usage 中提供的值,附加绑定充当过滤器、结果或过滤器和结果条件:
#Filter:localElement或localParameter中引用的元素或参数的值用作值帮助的过滤器。值帮助仅显示过滤后的结果。备注
对于本地元素的数字数据类型,如果本地元素为空,则始终针对 0(初始值)过滤值帮助。
*
#Result:*使用值帮助提供的值填充localElement或localParameter中引用的元素或参数。创建实例时,可以使用此选项填充各种字段。#Filter_and_Result:值帮助在两个方向上都有效。它过滤值帮助并接管相应字段的值。如果未指定使用类型,
#Filter_and_Result为缺省值。
以下代码示例显示
/DMO/I_Booking中元素ConnectionID上 注释的用法。它分别参考值帮助提供者视图 (/DMO/I_Connection_VH) 和在值帮助提供者视图中提供可能值 (connection_id) 的元素,以及使用者视图和值帮助提供者视图中元素CarrierID和carrier_id上的匹配条件。define view /DMO/I_Booking_VH as select from /dmo/booking {… @Consumption.valueHelpDefinition: [{ entity: {name: '/DMO/I_Connection_VH' , element: 'connection_id' }, additionalBinding: [{ localElement: 'CarrierID', element: 'carrier_id', usage: #Filter }] }] connection_id as ConnectionID, … }
结果
在选择字段中选择 F4 将打开搜索掩码,最终用户可以显示值帮助提供者中的所有可用条目或按字段(例如,目标机场)进行过滤。如果已在消费者视图中填充承运方标识,则会按该值对值帮助提供者进行预过滤。在值帮助中选择条目会将连接标识和承运方标识传输到 CDS 消费者视图。
OData 服务的元数据显示以下属性的值帮助实施:
为其实施值帮助的 CDS 源视图中的属性 (
sap:value-list="standard")值帮助提供者实体类型 (
sap:value-list="true")值帮助提供者实体在
Annotations属性中标记为Target。值列表枚举值帮助提供者中为值帮助 (Annotation Term="Common.ValueList") 公开的每个属性。在映射条件中定义的元素标记为内向和外向参数
Record Type="Common.ValueListParameterInOut"。
限制
如果将值帮助提供者与源视图相关联,则值帮助提供者视图的元数据不具有
sap:value-list="true"。因此,请求<service_url>/$metadata?sap-value-list=<service_namespace>.<entity>Type/<element>(其中<element>是在 CDS 视图的注释@Consumption.ValueHelpDefinition中引用的元素)不起作用。调用值帮助时这可能会导致问题。为避免此冲突,请分离值帮助提供者视图中与其他相关视图(例如文本提供者视图)不一致的值帮助信息。
来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译
← 简单值帮助 · 定义元数据驱动的 UI 的 CDS 注释 →
