Fiori elements 特性全集演示 · 对象页 · 标题区域

项目

内容

官方仓库

SAP-samples/fiori-elements-feature-showcase

业务场景

用一套可运行的应用演示 Fiori elements 的每一种表格、表单与页面特性

技术栈

SAP Fiori elements for OData V4、SAPUI5、注解(annotation)、灵活编程模型

对应课程

UX405、UX406、UX410、UX400

对应路径

第 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;

labels.cds

标题区域字段组分面

搜索词:#HeaderFieldGroup

字段组可以作为标题区域的一部分。

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)

搜索词:#ProgressIndicator

把「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,
        },
    },
);
子弹微型图表

搜索词:#microChartBullet

子弹图包含一个度量,并将其与一个或多个其他度量比较(例如把实际值与目标值对比)。「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,
    },
    ...
);
径向微型图表

搜索词:#microChartRadial

径向微型图表显示单个百分比值。 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,
    },
    ...
);
柱状微型图表

搜索词:#microChartColumn

柱状图使用垂直条形比较同一维度的各个值。 图表底部显示的数值是该维度的边界值,图表上方的数值是计量属性的边界值。

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 微型图表

搜索词:#microChartHarvey

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
    },
    ...
);
堆叠条形微型图表

搜索词:#microChartStackedBar

堆叠条形图使用垂直条形比较同一维度的各个值。 图表底部显示的数值是该维度的边界值,图表上方的数值是计量属性的边界值。

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
    },
);
比较微型图表

搜索词:#microChartComparision

比较图使用三个水平条形比较同一维度的各个值。如果该维度中定义了更多值,它们只会显示在工具提示中。 左侧显示的数值表示每个数据点的维度值,右侧的数值是实际值。如果显示了计量单位,该单位来自第一个被绘制的数据点。

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 文件中。

自定义操作(对象页标题区域)

搜索词:"CustomActionOPHeader"

对象页上的自定义操作在 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',
                    ...
                },
            ],
        },
        ...
    ],
);

外部导航

搜索词:"ExternalNavigation"

外部导航在 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"
                    }
                },
                ...
            },
            ...
        }
    }
},