添加值帮助
ABAP RESTful 应用程序编程模型 › 开发 › 开发 UI 特定 › 添加值帮助
利用 CDS 中值帮助的实施,最终用户可以从用户界面上的输入字段的预定义清单中选择值。
为什么以及何时使用值帮助
您可以在 CDS 数据层中为 UI 上的任何输入字段(例如,事务场景中的选择字段、参数或可写入字段)定义值帮助。当必须从预定义值集中获取输入字段的值时,值帮助非常有用。调用值帮助时,将显示值帮助提供者中的所有可用值。在输入字段中选择按钮
或按 F4 键时,该按钮将显示在 UI 上。最终用户可以按相关信息进行过滤以识别正确的值。这样可以更轻松地找到所需的值,尤其是当值本身包含少量标识信息或不包含标识信息(例如,标识编号)时。
示例
为了帮助最终用户输入正确的客户标识来创建新预订,应用程序开发人员定义了值帮助,使用户可以输入值帮助提供者中的名称或任何其他元素以帮助查找正确的编号。在这种情况下,值帮助提供者视图是管理客户信息的 CDS 视图。如下所示,最终用户正在搜索特定客户标识。值帮助提供按客户姓氏过滤,以便最终用户可以从可用条目中进行选择。然后,将客户标识字段的值传输到相应的输入字段。
展开下图以查看在 Fiori 元素 UI 上调用值帮助的过程。
如何实施值帮助?
值帮助在 CDS 中定义,并在元素或参数上添加注释,其值帮助对话框将显示在 UI 上。注释 @Consumption.valueHelpDefinition 允许您在不实施关联的情况下引用值帮助提供者。您只需将 CDS 实体分配为值帮助提供者,并在注释 中为映射提供元素。值帮助提供者的所有字段都显示在 UI 上。选择值帮助提供者的其中一个条目时,参考元素的值将传输到输入字段。
提示
建议在数据定义中实施值帮助注释。尽管这是与 UI 相关的功能,但您不应在元数据扩展中实施。
对于值帮助的缺省实施,您可以使用包含输入字段 元素所需值的任何 CDS 实体。无需将 CDS 实体显式定义为值帮助提供者。但是,值帮助提供者必须针对 OData 服务公开才能使用值帮助。
备注
评估在值帮助提供者中维护的任何注释。这意味着还会显示值帮助提供者视图的关联实体、值帮助和文本关联,并可在值帮助中使用。这意味着您可以在值帮助中具有值帮助。
