Fiori elements 特性全集演示 · 对象页 · 标题区域
项目 |
内容 |
|---|---|
官方仓库 |
|
业务场景 |
用一套可运行的应用演示 Fiori elements 的每一种表格、表单与页面特性 |
技术栈 |
SAP Fiori elements for OData V4、SAPUI5、注解(annotation)、灵活编程模型 |
对应课程 |
|
对应路径 |
第 3 条 开发 SAPUI5 应用 |
为什么值得做:Fiori elements 的能力边界靠文档很难建立直觉。 这个仓库把特性做成可点开的界面,点一下就知道某个注解会产生什么效果。
动手要点:
把应用跑起来,逐个对照
annotations.cds—— 改一个注解,刷新看变化。这个「改注解看效果」的循环,是掌握 Fiori elements 最快的路径。
本页内容抓取自官方仓库 SAP-samples/fiori-elements-feature-showcase,共收录 1 篇官方文档(README 与 docs)。原仓库内容版权归 SAP SE,遵循其许可证。
Header Area Object Page
INFO: 建议使用 SAP Fiori tools——它是 SAP Business Application Studio 与 Visual Studio Code 的一组扩展——通过 Application Modeler 工具来配置应用。
搜索词:"anchorBarVisible"
默认情况下,对象页的标题区域与锚点栏(anchor bar)都是启用的。两者都可以通过 SAP Fiori tools 或在 manifest.json 中禁用。
"RootEntityObjectReport": {
...
"options": {
"settings": {
...
"content": {
"header": {
"anchorBarVisible": true,
"visible": true,
...
},
...
}
}
}
},
标题与副标题
搜索词:#HeaderInfo
对象页的标题与副标题通过注解 @UI.HeaderInfo 定义。
annotate srv.RootEntities with @(
UI.HeaderInfo :{
TypeName : '{i18n>RootEntities}',
TypeNamePlural : '{i18n>RootEntities.typeNamePlural}',
Title : {
$Type : 'UI.DataField',
Value : field,
},
Description : {
$Type : 'UI.DataField',
Value : '{i18n>RootEntities}',
},
ImageUrl : imageUrl,
TypeImageUrl : 'sap-icon://sales-order',
},
);
layouts_RootEntities.cds。 「TypeName」即标题,显示在对象页标题栏中 SAP Logo 的旁边。 如果所有实体都显示在父对象页的表格中,就会显示「TypeNamePlural」(本示例中并非这种情况)。 对象页的「Title」显示在实际标题区域的左侧,以粗体呈现。在 SAP 后端系统中,它应当显示与语言相关的产品文本。 「Description」位于「Title」下方,在 SAP 后端系统中通常显示产品标题。 如果提供了可选的「ImageUrl」属性,图片将显示在「Title」与「Description」的左侧。如果没有为「ImageUrl」提供 URL,但定义了「TypeImageUrl」,则改为显示后者。
动态标题或副标题
搜索词:#ODataConcat
可以在 @UI.HeaderInfo 注解中为「Title」与「Description」值使用表达式,把多个属性拼接在一起。
annotate service.ChildEntities1 with @(
UI.HeaderInfo : {
...
Description : {
Value : ('Using odata.concat - Field: ' || field),
},
...
},
);
在本示例中,一个字符串被拼接到 'field' 属性的值上。也可以实现使用「$If」的更复杂场景,例如:
annotate service.ChildEntities1 with @(
UI.HeaderInfo : {
...
Description : {
Value : ('Using odata.concat - Field: ' || (field = 'child entity 1' ? field : 'Other child entities')),
},
...
},
);
标题区域分面
搜索词:#HeaderFacets
标题区域分面(header facet)是一组分面,显示在对象页的标题区域中。UI.ReferenceFacet 与 UI.CollectionFacet 都受支持。这些分面添加到 @UI.HeaderFacets 注解中。collection facet 必须带有 ID,才能正常工作。
annotate srv.RootEntities with @(
UI.HeaderFacets : [
{
$Type : 'UI.ReferenceFacet',
Target : '@UI.DataPoint#fieldWithPrice',
},
{
$Type : 'UI.CollectionFacet',
Facets : [
...
],
},
...
],
)
纯文本
搜索词:#PlainText
把普通数据字段加入字段组,再让该字段组作为 reference facet 的目标,即可显示纯文本。
annotate srv.RootEntities with @(
UI.HeaderFacets : [
...
{
$Type : 'UI.ReferenceFacet',
Target : '@UI.FieldGroup#plainText',
Label : '{i18n>plainText}'
},
],
);
annotate srv.RootEntities with @(
UI.FieldGroup #plainText : {
Data : [
{Value : description}
]
},
);
layouts_RootEntities.cds
此外,字段组中所用的实体属性必须加上 @UI.MultiLineText 注解。
description @UI.MultiLineText;
标题区域字段组分面
字段组可以作为标题区域的一部分。
annotate srv.RootEntities with @(
UI.HeaderFacets : [
...
{
$Type : 'UI.ReferenceFacet',
Target : '@UI.FieldGroup#HeaderData',
Label : '{i18n>HeaderData}'
},
...
],
);
标题区域中字段组的 data 属性支持普通 UI.DataField 与 UI.DataFieldForAnnotation 两种类型。通过 DataFieldForAnnotation 可以显示联系人快速视图卡片。只需把键作为数据字段添加,即可显示快速视图分面。这两种实现方式与把它们作为 line item 添加到列表报表中的方式完全相同。
annotate srv.RootEntities with @(
...
UI.FieldGroup #HeaderData : {
Data : [
{Value : field},
{Value : fieldWithCriticality, Criticality : criticality_code},
{Value : fieldWithUoM},
{Value : association2one_ID},
{
$Type : 'UI.DataFieldForAnnotation',
Target : 'contact/@Communication.Contact',
Label : '{i18n>contact}',
},
]
},
...
);
自定义字段
INFO: 建议使用 SAP Fiori tools——它是 SAP Business Application Studio 与 Visual Studio Code 的一组扩展——通过 Application Modeler 工具来配置应用。
搜索词:"CustomFieldHeaderOP"
借助扩展点,可以向已有字段组添加自定义字段。为此需要调整 manifest.json 文件。
"RootEntityObjectReport": {
...
"options": {
"settings": {
...
"controlConfiguration": {
...
"@com.sap.vocabularies.UI.v1.FieldGroup#HeaderData": {
"fields": {
"CustomFieldHeaderOP": {
"label": "{i18n>validityPeriodOP}",
"template": "sap.fe.showcase.lrop.ext.CustomField-DateRange",
"position": {
"placement": "After",
"anchor": "DataField::field"
}
}
}
}
},
...
}
}
},
在 control configuration 下,通过向「fields」属性添加字段来扩展已有字段组。template 是 XML 片段的路径。position.placement 可以取「Before」或「After」。字段组的其他数据字段可以用作锚点。
地址分面
搜索词:#AddressFacet
实体的 @Communication.Address 注解可以直接显示。为此会使用该注解的 label 属性,因此 label 属性需要完整格式化。换行可以通过 '\n' 实现。
annotate srv.RootEntities with @(
UI.HeaderFacets : [
...
{
$Type : 'UI.ReferenceFacet',
Target : 'contact/@Communication.Address',
Label : '{i18n>Address}'
},
...
],
);
annotate srv.Contacts with @(
...
Communication.Address : {
...
label : addressLabel,
...
}
);
在本示例中,label 通过 service.js 文件中的 CAP 函数生成。
数据点
搜索词:#DataPoint
数据点(data point)表示单个数据值。通常是数字,但也可以是文本,例如状态值。
annotate srv.RootEntities with @(
UI.HeaderFacets : [
...
{
$Type : 'UI.ReferenceFacet',
Target : '@UI.DataPoint#progressIndicator',
},
...
],
);
如果数据点是数字,可以覆盖默认的标度(scale)与精度(precision)。更多信息见 SAP Fiori elements 文档。
支持以下类型的数据点:Rating(评分)、Progress(进度)与 Key value(键值)。数据点支持通过 @Common.QucikInfo 注解添加工具提示。工具提示可以是字符串,也可以是属性路径。
评分(Rating)
搜索词:#RatingIndicator
把「Visualization」属性设为「#Rating」,数据点就会显示为填充的星形。「TargetValue」属性设置星形的最大数量。 「Value」属性是填充的星形数量。介于 x.25 与 x.74 之间的值显示为半颗星。
annotate srv.RootEntities with @(
UI.DataPoint #ratingIndicator : {
Value : starsValue,
TargetValue : 4,
Visualization : #Rating,
Title : '{i18n>ratingIndicator}',
},
);
进度(Progress)
把「Visualization」属性设为「#Progress」,数据点就会显示为一个外层带容器的条形。「TargetValue」属性是最大值。如果值大于或等于目标值,容器即被填满。 此外还可以定义 criticality,它会改变条形与容器的颜色。
annotate srv.RootEntities with @(
UI.DataPoint #progressIndicator : {
Value : integerValue,
TargetValue : 100,
Visualization : #Progress,
Title : '{i18n>progressIndicator}',
Criticality: criticality,
},
);
键值(Key value)
搜索词:#KeyValue
未指定「Visualization」属性时,键值数据点就是默认的数据点。
annotate srv.RootEntities with @(
...
UI.DataPoint #fieldWithPrice : {
Value : fieldWithPrice,
Title : '{i18n>fieldWithPrice}',
},
);
微型图表分面
搜索词:#OPMicroChart
微型图表分面(micro chart facet)由标题、副标题、Microchart 控件与页脚组成。
支持以下 Microchart 控件:Area、Bullet、Radial、Column、Line、Harvey、Stacked bar 与 Comparison 微型图表。
微型图表通过 @UI.Chart 注解定义,该注解随后作为 @UI.HeaderFacets 注解中某个 ReferenceFacet 的目标。
annotate srv.RootEntities with @(
UI.HeaderFacets : [
...
{
$Type : 'UI.ReferenceFacet',
Target : '@UI.Chart#radialChart',
},
...
],
);
分面的标题是 @UI.Chart 注解的「Title」属性,副标题是图表的「Description」属性。
如果数据点的「Value」属性是带计量单位的字段,该单位将显示在页脚中。
目前 @UI.Chart 注解不支持导航属性,图表的「MeasureAttributes」属性必须是数据点。@UI.DataPoint 一般支持「Criticality」与「CriticalityCalculation」属性,但不同微型图表类型的支持情况有所不同。
如果数据点的值标注了计量单位,该单位将显示为微型图表分面的页脚。
annotate srv.ChartDataEntities {
integerValueWithUoM @Measures.Unit : uom_code;
}
annotate srv.ChartDataEntities @(
UI.DataPoint #lineChartWidth : {
Value : integerValueWithUoM,
MinimumValue : 0,
MaximumValue : 100,
Criticality : criticality_code,
},
);
在以下示例中,所有用到的属性都是必填的。
面积微型图表
搜索词:#microChartArea
面积微型图表是一种趋势图,用于提供指定维度下实际值与目标值的信息。 图表底部显示的数值是该维度的边界值,图表上方的数值是计量属性的边界值。
annotate service.ChartDataEntities with @(
UI.Chart #areaChart : {
Title : '{i18n>areaChart}',
Description : '{i18n>ThisIsAMicroChart}',
ChartType : #Area,
Dimensions : [
dimensions,
],
Measures : [
integerValue,
],
MeasureAttributes : [
{
$Type : 'UI.ChartMeasureAttributeType',
Measure : integerValue,
Role : #Axis1,
DataPoint : '@UI.DataPoint#areaChart',
},
],
},
...
);
数据点的 criticality 计算是必填的,因为每个值都会连同其阈值区间(error、warning、acceptance 与 good)一起显示。
annotate service.ChartDataEntities with @(
UI.DataPoint #areaChart : {
Value : integerValue,
TargetValue : targetValue,
CriticalityCalculation :{
ImprovementDirection : #Target,
ToleranceRangeLowValue : areaChartToleranceLowerBoundValue,
ToleranceRangeHighValue : areaChartDeviationUpperBoundValue,
DeviationRangeLowValue : areaChartDeviationLowerBoundValue,
DeviationRangeHighValue : areaChartDeviationUpperBoundValue,
},
},
);
子弹微型图表
子弹图包含一个度量,并将其与一个或多个其他度量比较(例如把实际值与目标值对比)。「Criticality」与「CriticalityCalculation」都受支持,但如果两者同时给出,「Criticality」会覆盖「CriticalityCalculation」。子弹图不支持 criticality 取值 5(新条目)。 measures 属性虽然是必填的,但对图表没有影响。
annotate srv.RootEntities with @(
UI.Chart #bulletChart : {
Title : '{i18n>bulletChart}',
Description : '{i18n>ThisIsAMicroChart}',
ChartType : #Bullet,
Dimensions : [
dimensions
],
Measures : [
integerValue,
],
MeasureAttributes : [
{
$Type : 'UI.ChartMeasureAttributeType',
Measure : integerValue,
Role : #Axis1,
DataPoint : '@UI.DataPoint#bulletChart',
},
],
},
...
);
要正确渲染图表,需要「MinimumValue」属性。「Value」是实际的条形。预测值(forecast value)是背景中不透明度较低的条形,目标值(target value)则是深色的线。
annotate srv.RootEntities with @(
...
UI.DataPoint #bulletChart : {
Value : integerValue,
TargetValue : targetValue,
ForecastValue : forecastValue,
Criticality : criticality_code,
MinimumValue : 0,
},
...
);
径向微型图表
径向微型图表显示单个百分比值。 measures 属性虽然是必填的,但对图表没有影响。
annotate srv.RootEntities with @(
...
UI.Chart #radialChart : {
Title : '{i18n>radialChart}',
Description : '{i18n>ThisIsAMicroChart}',
ChartType : #Donut,
Measures : [
integerValue,
],
MeasureAttributes : [
{
$Type : 'UI.ChartMeasureAttributeType',
Measure : integerValue,
Role : #Axis1,
DataPoint : '@UI.DataPoint#radialChart',
},
],
},
...
);
百分比值是「Value」与「TargetValue」的比值。
annotate srv.RootEntities with @(
...
UI.DataPoint #radialChart : {
Value : integerValue,
TargetValue : targetValue,
Criticality : criticality_code,
},
...
);
计量单位的标签不会渲染,因为图表显示的是百分比值。「Criticality」与「CriticalityCalculation」都受支持,但如果两者同时给出,「Criticality」会覆盖「CriticalityCalculation」。
折线微型图表
搜索词:#microChartLine
折线图把一系列数据点显示为一条线。底部数值是该维度的边界值。左上方的值是第一个 measure 属性的最小值,右上方的值是最后一个 measure 属性的最大值。显示的计量单位来自第一条记录。
annotate service.ChartDataEntities with @(
...
UI.Chart #lineChart : {
Title : '{i18n>lineChart}',
Description : '{i18n>ThisIsAMicroChart}',
ChartType : #Line,
Measures : [
integerValueWithUoM,
targetValue,
],
Dimensions : [
dimensions,
dimensions
],
MeasureAttributes : [
{
$Type : 'UI.ChartMeasureAttributeType',
Measure : integerValueWithUoM,
Role : #Axis2,
DataPoint : '@UI.DataPoint#lineChartWidth',
},
{
$Type : 'UI.ChartMeasureAttributeType',
Measure : targetValue,
Role : #Axis2,
DataPoint : '@UI.DataPoint#lineChartDepth',
},
],
},
...
);
建议只使用一个度量;如果需要更多,最多使用三个度量。 如果「Criticality」属性包含路径,则由最后一个数据点的「Criticality」属性值决定线条的颜色。
annotate service.ChartDataEntities with @(
...
UI.DataPoint #lineChartWidth : {
Value : integerValueWithUoM,
Criticality : criticality_code,
},
UI.DataPoint #lineChartDepth : {
Value : targetValue,
Criticality : criticality_code,
},
...
);
柱状微型图表
柱状图使用垂直条形比较同一维度的各个值。 图表底部显示的数值是该维度的边界值,图表上方的数值是计量属性的边界值。
annotate service.ChartDataEntities with @(
...
UI.Chart #columnChart : {
Title : '{i18n>columnChart}',
Description : '{i18n>ThisIsAMicroChart}',
ChartType : #Column,
Measures : [
integerValue
],
Dimensions : [
dimensions
],
MeasureAttributes : [
{
$Type : 'UI.ChartMeasureAttributeType',
Measure : integerValue,
Role : #Axis1,
DataPoint : '@UI.DataPoint#dataPointForChart',
}
]
},
...
);
「Criticality」与「CriticalityCalculation」都受支持,但如果两者同时给出,「Criticality」会覆盖「CriticalityCalculation」。
annotate service.ChartDataEntities with @(
...
UI.DataPoint #dataPointForChart : {
Value : integerValue,
Criticality : criticality_code
},
);
Harvey 微型图表
Harvey 图把单个度量值与一个最大值对照绘制。
annotate srv.RootEntities with @(
...
UI.Chart #harveyChart : {
Title : '{i18n>harveyChart}',
Description : '{i18n>ThisIsAMicroChart}',
ChartType : #Pie,
Measures : [
fieldWithPrice
],
MeasureAttributes : [
{
$Type : 'UI.ChartMeasureAttributeType',
Role : #Axis1,
Measure: fieldWithPrice,
DataPoint : '@UI.DataPoint#harveyChart',
}
]
},
);
对于语义着色,仅支持「Criticality」属性。
annotate srv.RootEntities with @(
...
UI.DataPoint #harveyChart : {
Value : fieldWithPrice,
MaximumValue : fieldWithUoM,
Criticality : criticality_code
},
...
);
堆叠条形微型图表
堆叠条形图使用垂直条形比较同一维度的各个值。 图表底部显示的数值是该维度的边界值,图表上方的数值是计量属性的边界值。
annotate service.ChartDataEntities with @(
...
UI.Chart #stackedBarChart : {
Title : '{i18n>stackedBarChart}',
Description : '{i18n>ThisIsAMicroChart}',
ChartType : #BarStacked,
Measures : [
integerValue
],
Dimensions : [
dimensions
],
MeasureAttributes : [
{
$Type : 'UI.ChartMeasureAttributeType',
Measure : integerValue,
Role : #Axis1,
DataPoint : '@UI.DataPoint#dataPointForChart',
}
]
},
...
);
「Criticality」与「CriticalityCalculation」都受支持,但如果两者同时给出,「Criticality」会覆盖「CriticalityCalculation」。
annotate service.ChartDataEntities with @(
...
UI.DataPoint #dataPointForChart : {
Value : integerValue,
Criticality : criticality_code
},
);
比较微型图表
比较图使用三个水平条形比较同一维度的各个值。如果该维度中定义了更多值,它们只会显示在工具提示中。 左侧显示的数值表示每个数据点的维度值,右侧的数值是实际值。如果显示了计量单位,该单位来自第一个被绘制的数据点。
annotate service.ChartDataEntities with @(
...
UI.Chart #comparisonChart : {
Title : '{i18n>comparisonChart}',
Description : '{i18n>ThisIsAMicroChart}',
ChartType : #Bar,
Measures : [
integerValue
],
Dimensions : [
dimensions
],
MeasureAttributes : [
{
$Type : 'UI.ChartMeasureAttributeType',
Measure : integerValue,
Role : #Axis1,
DataPoint : '@UI.DataPoint#dataPointForChart',
}
]
},
);
对于语义着色,仅支持「Criticality」属性。
annotate service.ChartDataEntities with @(
...
UI.DataPoint #dataPointForChart : {
Value : integerValue,
Criticality : criticality_code
},
);
标题区域自定义分面
INFO: 建议使用 SAP Fiori tools——它是 SAP Business Application Studio 与 Visual Studio Code 的一组扩展——通过 Application Modeler 工具来配置应用。
搜索词:"CustomHeaderFacet"
通过扩展点可以向标题区域添加自定义分面。在 Feature Showcase 中,Item1 对象页带有一个自定义标题区域分面。分面本身是一个 XML 片段,通过 manifest.json 文件添加。
"childEntities1ObjectPage": {
...
"options": {
"settings": {
...
"content": {
"header": {
"facets": {
"CustomHeaderFacet": {
"template": "sap.fe.showcase.lrop.ext.CustomHeaderFacet-ProcessFlow",
"templateEdit" : "sap.fe.showcase.lrop.ext.CustomHeaderFacet-Edit",
"stashed": false,
"title": "{i18n>customHeaderFacet}",
"position": {
"placement": "After",
"anchor": "FacetWithPercent"
},
"flexSettings": {
"designtime": "not-adaptable-visibility"
}
}
}
}
}
}
}
},
「template」属性是 XML 片段的路径。「stashed」属性指定该分面是直接可见,还是一开始不可见、之后可以通过关键用户适配(key user adaptation)功能添加。「position.anchor」属性是锚点分面的 ID。「flexSettings」属性指定关键用户在调整 UI 时有哪些选项。 「templateEdit」属性是片段的路径,该片段在编辑模式下显示。必须使用「sap.ui.layout.FormElement」来组织内容,因为 FormElement 会显示在 FormContainer 内部。 更多信息见 SAP Fiori elements 文档
对象页操作
搜索词:#OPHeaderAction
对象页的操作一般通过 @UI.Identification 注解引用,该注解是一个由数据字段组成的数组。操作以 UI.DataFieldForAction 的形式引用。criticality 仅支持 0(正常)、1(红色)与 3(绿色)这三个值。对于 bound action,会传入对象页内容;对于 unbound action,则不传入上下文。导航操作同样可行。
annotate srv.RootEntities with @(
...
UI.Identification : [
{
$Type : 'UI.DataFieldForAction',
Action : 'LROPODataService.changeCriticality',
Label : '{i18n>changeCriticality}',
Criticality : criticality_code,
},
...
],
);
示例位于 layouts_RootEntities.cds 文件中。
自定义操作(对象页标题区域)
对象页上的自定义操作在 manifest.json 文件中添加,位置为「options」->「settings」->「content」->「header」->「actions」。
"RootEntityObjectReport": {
...
"options": {
"settings": {
...
"content": {
"header": {
...
"actions" : {
"CustomActionOPHeader" : {
"press": "sap.fe.showcase.lrop.ext.CustomActions.messageBox",
"enabled": "{= ${ui>/editMode} === 'Editable'}",
"visible" : true,
"text": "{i18n>CustomActionOPHeader}"
}
}
},
...
}
}
}
},
自定义操作本身见「Custom Actions」一节。
从标题区域分面导航
搜索词(以下关键词均可在官方仓库中搜索到示例):"targetSections"、#InboundNav、"ExternalNavigation"
可以为标题区域中的数据点、评分与进度指示器或微型图表分面定义页内导航或外部导航,这样分面标签就会渲染为链接。
页内导航
搜索词(以下关键词均可在官方仓库中搜索到示例):"targetSections"、#InboundNav
对于页内导航,标题区域分面带有「navigation」属性。「sectionId」定义对象页的哪个分区是目标;如果该分区包含子分区,「subsectionId」定义其中的哪个子分区。如果未指定子分区 ID,则路由到第一个子分区。 分区 ID 由应用 ID + "--fe::FacetSection::" 再加上分区本身的 ID 组成。
"RootEntityObjectReport": {
...
"options": {
"settings": {
...
"controlConfiguration": {
...
"@com.sap.vocabularies.UI.v1.DataPoint#progressIndicator":{
"navigation":{
"targetSections":{
"sectionId": "sap.fe.showcase.lrop::RootEntityObjectReport--fe::FacetSection::chartData",
"subSectionId": "sap.fe.showcase.lrop::RootEntityObjectReport--fe::FacetSubSection::advancedChartData"
}
}
},
...
},
...
}
}
},
annotate srv.RootEntities with @(
UI.Facets : [
...
{
$Type : 'UI.CollectionFacet',
Label : '{i18n>chartData}',
ID : 'chartDataCollection',
Facets : [
...
{
$Type : 'UI.ReferenceFacet',
Target : '@UI.FieldGroup#advancedChartData',
ID : 'advancedChartData',
...
},
],
},
...
],
);
外部导航
外部导航在 manifest.json 文件中分两处实现。 首先,需要把目标应用添加到「crossNavigation」->「outbounds」属性中。 在本示例中,「ExternalNavigation」是限定符(qualifier)。
"sap.app": {
...
"crossNavigation": {
"outbounds": { )
"ExternalNavigation": {
"semanticObject": "FeatureShowcaseOrder",
"action": "manage"
}
}
}
},
其次,要提供外部导航的标题区域分面需要「navigation」属性。「outbound」指向限定符,也就是导航的目标。
"RootEntityObjectReport": {
...
"options": {
"settings": {
...
"controlConfiguration": {
...
"@com.sap.vocabularies.UI.v1.DataPoint#ratingIndicator":{
"navigation":{
"targetOutbound": {
"outbound": "ExternalNavigation"
}
}
},
...
},
...
}
}
},
切换标题区域字段的可编辑性
INFO: 建议使用 SAP Fiori tools——它是 SAP Business Application Studio 与 Visual Studio Code 的一组扩展——通过 Application Modeler 工具来配置应用。
搜索词:"editableHeaderContent"
默认情况下,对象页的标题区域在编辑模式下可编辑。不过,在 manifest.json 文件中加上注解 "editableHeaderContent": false 即可改变这一行为,使标题区域在编辑模式与显示模式下都不可编辑。
"RootEntityObjectReport": {
...
"options": {
"settings": {
"editableHeaderContent": false,
...
}
}
},
添加子页
INFO: 建议使用 SAP Fiori tools——它是 SAP Business Application Studio 与 Visual Studio Code 的一组扩展——通过 Application Modeler 工具来配置应用。
搜索词:"childEntities1ObjectPage"
要添加子页,manifest.json 文件中需要两个对象。 首先需要添加一条额外的路由,用它指定目标。
"routing": {
"routes": [
...
{
"pattern": "RootEntities({key})/ChildEntities1({key2}):?query:",
"name": "childEntities1ObjectPage",
"target": "childEntities1ObjectPage"
},
],
...
},
其次需要指定目标。
"routing": {
...
"targets": {
...
"childEntities1ObjectPage": {
"type": "Component",
"id": "childEntities1ObjectPage",
"name": "sap.fe.templates.ObjectPage",
"options": {
"settings": {
...
"entitySet": "ChildEntities1",
...
}
}
},
...
}
},
要移除子页,需要删除对应的路由与目标。 要实现实际的导航,必须把导航路由的名称作为「route」引用。'childEntities1' 是对象页实体集中子实体的属性名。
"RootEntityObjectReport": {
...
"options": {
"settings": {
...
"navigation": {
"childEntities1": {
"detail": {
"route": "childEntities1ObjectPage"
}
},
...
},
...
}
}
},