CDS（Core Data Service）Annotation 常用属性

##1. 设置fiori报表抬头信息

1. 抬头信息

@UI: {
  headerInfo: {
    typeName: 'クロスプラントメンテナンス',
    typeNamePlural: 'クロスプラントメンテナンス',
    description: { value: 'Product' },
    title: {										//抬头信息文本
      type: #STANDARD,
      value: 'Location',
      label: 'クロスプラントメンテナンス'
    }
  },
  presentationVariant: [ { sortOrder: [{ by: 'Product',direction: #ASC },		//抬头搜索排序条件
                                       { by: 'Location',direction: #ASC },
                                       { by: 'LocationType',direction: #ASC } ] } ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

2. 行信息（分组、颜色信息、隐藏显示信息）

  @UI.facet: [
  {
    id: 'bp_Tab1',
    purpose: #STANDARD,
    type: #FIELDGROUP_REFERENCE,
    label: '一般情報',
    targetQualifier:'bp_Info1',
    position: 10
  },
   {
      id: 'bp_inc2',									//include页签 association对象
      purpose: #STANDARD,
      type: #LINEITEM_REFERENCE,
      hidden: #(CUSGENERALHID),				//指派到隐藏属性
      label: '得意先会社コード',   //Customer Master (Company Code)
      targetElement:   '_CustomerCompanyData',		//with association
      position: 90
    },]
 
  @UI: {
    fieldGroup:[{ qualifier:'bp_Info1', position:1 }]		//字段指派到分组
  }
  Type;

// with action		
  @UI: {
    lineItem: [
        { position: 20, importance: #HIGH, criticality: 'StatusCrt', criticalityRepresentation:#WITHOUT_ICON }	//定义按钮
       ,{ type: #FOR_ACTION, dataAction: 'applyWorkFlow', label: '申請', position: 1 }
       ,{ type: #FOR_ACTION, dataAction: 'withdrawWorkFlow', label: '申請取消' ,position: 2 }
       ,{ type: #FOR_ACTION, dataAction: 'aproWorkFlow', label: '承認' ,position: 3}
       ,{ type: #FOR_ACTION, dataAction: 'rejtWorkFlow', label: '却下' ,position: 4}
       ,{ type: #FOR_ACTION, dataAction: 'simulation', label: '同期テスト' ,position: 5}
     ],
    identification: [
       { importance: #HIGH, label: '申請',  dataAction: 'applyWorkFlow',type: #FOR_ACTION,  position: 1 }
       ,{ importance: #HIGH, label: '申請取消', dataAction: 'withdrawWorkFlow',  type: #FOR_ACTION, position: 2 }
       ,{ importance: #HIGH, label: '承認' , dataAction: 'aproWorkFlow', type: #FOR_ACTION,  position: 3}
       ,{ importance: #HIGH, label: '却下' ,  dataAction: 'rejtWorkFlow', type: #FOR_ACTION,  position: 4}
       ,{ importance: #HIGH, label: '同期テスト' ,  dataAction: 'simulation', type: #FOR_ACTION,  position: 5}  ],
    fieldGroup:[ { qualifier:'headerGroup1', position:20} ],
    selectionField: [ { position: 50 } ],
    textArrangement: #TEXT_ONLY
  }
  Status;
   @UI: { fieldGroup:[{ qualifier:'headerGroup7', position:102, type: #WITH_URL, url: 'Url' }]  } //URL字段
  Url;
  
  @UI: {
     fieldGroup:[{ qualifier:'bp_Info2', position:7  , criticality: 'NameOrg1Crt', criticalityRepresentation:#WITHOUT_ICON}]		//应用颜色字段
  }
  NameOrg1;
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

  virtual NameOrg1Crt        : abap.char( 10 ),
          @ObjectModel.virtualElementCalculatedBy: 'ABAP:ZCL_MDE0017' //Interface View定义虚拟颜色属性字段并绑定到UI字段上&定义颜色处理类

          @ObjectModel.virtualElementCalculatedBy: 'ABAP:ZCL_MDE0016'
  virtual cusGeneralHid      : abap_boolean, //隐藏属性
1
2
3
4
5

3. Search Help 多选

      @Consumption:{valueHelpDefinition:[{ entity: { name: 'ZI_MD_WORKFLOWUSER_VH',element: 'Bname' } }],
                    filter: { multipleSelections: true, selectionType: #SINGLE }
       }
1
2
3

4. Search Help Binding Field（字段关联搜索）

  @Consumption.valueHelpDefinition: [{ entity: { name: 'I_GLAccountStdVH', element: 'GLAccount' },
               additionalBinding:   [{ element: 'CompanyCode',localElement: 'COMPANYCODE' }],useForValidation:true }]
1
2

5. List box

• 定义搜索帮助视图
• 注释文本视图：@ObjectModel.dataCategory: #TEXT
• 设置结果集类型：@ObjectModel.resultSet.sizeCategory: #XS
• 注释语言字段：@Semantics.language: true
• 注释依赖于语言的文本字段：@Semantics.text: true
  
• 绑定List搜索帮助到字段
  

          @ObjectModel.text.element: ['OperationName']
          @Consumption.valueHelpDefinition: [{ entity: {name: 'ZI_MD_WORKFLOWOPERATION_VH', element: 'Operation' },useForValidation:true }]
1
2

6. Muti Line Text（长文本输入）

  @UI.multiLineText: true
  ApplyReason;
1
2

7. Date Time

• 绑定日期时间属性
  

      @Semantics.systemDateTime.createdAt: true
      @Semantics.user.createdBy: true
      @Semantics.systemDateTime.lastChangedAt: true
      @Semantics.user.lastChangedBy: true
1
2
3
4

8. Text Label（覆盖UI显示文本，不建议使用）

@EndUserText.label: 'XX'
1

9. UI隐藏字段

  @UI.hidden: true
  definitionId;
1
2

10. 绑定ID字段和Text

• 创建ID文本表值视图
  
• 关联字段描述的字段名@ObjectModel.text.element: [‘ApproveStepText’]：
• 注释系统该字段将用作描述：@Semantic.text: true
• 带语言引用：_ApproveStep[Language = $session.system_language ].ApproveStepText as ApproveStepText
  
• 设置ID值和文本值显示类型
• @UI.textArrangement: #TEXT_ONLY
  • 文本在前：TEXT_FIRST
  • 文本在后： TEXT_LAST
  • 仅显示文本：#TEXT_ONLY
  • 分离模式：TEXT_SEPARATE
    
    

11. 搜索帮助界面字段控制

• 隐藏搜索帮助字段
  • @Consumption.valueHelpDefault.display:false
• 隐藏搜索帮助搜索框
  • @Consumption.filter.hidden:true

12. 聚合搜索帮助

          @Consumption.valueHelpDefinition: [ {entity: { name: 'ZI_MAINTAINEDPLANTVIEW_NONE_VH', element: 'Werks'},
                                                        label: 'Plant Value Help',
                                                        qualifier : 'PlantValueHelp'},
                                               { entity: { name: 'ZI_MAINTAINEDPLANTVIEW_VH', element: 'Werks'},
                                                        label: 'Plant Value Help Ref Material',
                                                        additionalBinding: [{ element: 'Matnr',localElement: 'Matnr' }]}]
          Werks,
1
2
3
4
5
6
7