SAP CAP Fiori Elements 应用配置 UI 的两种方式以及自定义 index.html

2022-09-09 105

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： SAP CAP Fiori Elements 应用配置 UI 的两种方式以及自定义 index.html

第一种方法

编辑 app 里的 manifest.json 文件：

{
    "_version": "1.32.0",
    "sap.app": {
    ...
    "sap.ui5": {
        ...
        "routing": {
            ...
            "targets": {
                ...
                "RisksObjectPage": {
                    ...
                    "options": {
                        "settings": {
                            "editableHeaderContent": true,
                            "entitySet": "Risks"
                        }
                    }
                }
            }
        },
        ...
}

第二种方法：修改 .cds 文件

给对应的 Fiori Elements 字段(forms 中的)添加 Label，以及 table column 字段添加 header：

using RiskService from './risk-service';
annotate RiskService.Risks with {
    title       @title: 'Title';
    prio        @title: 'Priority';
    descr       @title: 'Description';
    miti        @title: 'Mitigation';
    impact      @title: 'Impact';
}

添加 value help：

annotate RiskService.Mitigations with {
ID @(
    UI.Hidden,
    Common: {
    Text: description
    }
);
description  @title: 'Description';
owner        @title: 'Owner';
timeline     @title: 'Timeline';
risks        @title: 'Risks';
}

SAP CAP 提供了一个本地实现的仿 Fiori Launchpad 的 container：

在一个 CAP Java 应用的 app 文件夹里放置一个自定义 index.html 会怎么样？

首先直接执行 cds watch 是无法工作的。

在应用的 app 文件夹里新建一个 index.html:

重启 SpringBoot 应用，这个 index.html 就生效了：

cds watch 默认在 app 文件夹中查找 index.html 文件。如果 cds watch 找到这样的文件，它会将包含服务链接的默认页面替换为文件夹中的链接。虽然这在许多情况下是有意义的，但出于开发目的，我们坚持使用 CDS 的索引页面并为我们的索引文件提供不同的名称。

但是在 Business Application Studio 环境里测试不通过：

看不到自定义 index.html 里的内容：

另外举一些例子，假设我想在 Fiori Elements List report 的表格控件里，将 table column 的文本进行自定义：

需要修改 web 应用里 fiori-service.cds 文件里对应的注解。

可以使用语法 annotate AdminService.Orders with 后面加实际的注解值。

Object Page 里的 tab 标签：

对应的注解源代码：

Facets                      : [
            {
                $Type  : 'UI.ReferenceFacet',
                Label  : '发货地址',
                Target : '@UI.FieldGroup#ShippingAddress'
            },
            {
                $Type  : 'UI.ReferenceFacet',
                Label  : '明细',
                Target : '@UI.FieldGroup#Details'
            },
            {
                $Type  : 'UI.ReferenceFacet',
                Label  : '{i18n>OrderItems}',
                Target : 'Items/@UI.LineItem'
            },
        ],