添加字段标签和描述

ABAP RESTful 应用程序编程模型 › 开发 › 开发 UI 特定 › 添加字段标签和描述

最终用户文本(例如字段标签或字段描述)取自相应元素绑定的 ABAP 字典数据元素 - 除非您使用 CDS 注释重新定义文本。与技术元素名称不同,抬头文本、字段标签和描述与语言相关。例如,字段“航空公司”将具有语言相关标签“航空公司代码”。

必须翻译此类文本。因此,CDS 开发基础架构能够从源代码中提取它们,并将提取的文本传输到相应交付包的实际翻译基础架构。

相关注释

标注

影响

@EndUserText.label: '<text>'

此注释用于为 CDS 视图的元素(标签文本)定义可翻译语义短文本(最多 60 个字符)。

@EndUserText.quickInfo: '<text>'

注释定义一个人工可读的 <text>,提供有关元素的附加信息。快速信息用于辅助功能提示或鼠标悬停功能。

记住

源代码中指定的 <text> 应由使用 CDS 源代码的原始语言的文本组成,并将翻译成所需语言。

示例

以下列表演示了在视图和元素(字段)级别使用 @EndUserText 注释:

  ...
  @EndUserText.label: 'Overview of available flights'  -- Annotation at the view level

  DEFINE VIEW <CDS_view> as Flights {
	...

	-- Annotation at the field level
	@EndUserText: { label:  'Airline Code',
	quickinfo: 'Code to identify which airline operates the flight' }
	carrier_id as CarrierID;
	...

提示

在 CDS 源代码编辑器中按 F1 以获取 @EndUserText 注释上的扩展帮助内容!

备注

如果使用贴标签注释 @UI,将主要对其进行评估。这意味着,它们将覆盖使用 @EndUserText 注释提供的文本。

OData 元数据

要验证标签和描述的附加信息是否正确推送到 OData 服务,您可以检查 OData 元数据文档。如果在 CDS 视图中维护 @UI 和 @EndUserText,这也有助于找出使用哪些标签信息。

如果未使用 UI 注释,则上述示例的 OData 元数据文档应包含在下图中标记的注释:

来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译

← 开发 UI 特定 · 添加值帮助 →