SAP Fiori Elements SemanticKey 的语法

annotation 本地文件的 xml 片段如下：

<Annotations Target="SEPMRA_PROD_MAN.SEPMRA_C_PD_ProductType" xmlns="http://docs.oasis-open.org/odata/ns/edm">
                <Annotation Term="Common.SemanticKey">
                    <Collection>
                        <PropertyPath>Product</PropertyPath>
                    </Collection>
                </Annotation>
            </Annotations>

下面是逐行解释。

• <Annotations> 标签用于包含一组注解。注解用于增强 OData 服务的元数据，它们可以用于描述如何在 Fiori 用户界面中展示数据。
• Target 属性指定了这组注解的目标。在这种情况下，目标是 SEPMRA_PROD_MAN.SEPMRA_C_PD_ProductType，这是 OData 服务中的一个实体类型。这意味着这组注解用于描述如何处理这个实体类型的数据。
• xmlns 属性定义了这个 XML 文档的 XML 命名空间。在这里，它是 OData 的 EDM (Entity Data Model) 命名空间，这表明这个文档遵循 OData 的 EDM 规范。

然后是 <Annotation> 标签：

<Annotation Term="Common.SemanticKey">
    ...
</Annotation>

• <Annotation> 标签用于定义一个注解。在这里，这个注解的 Term 属性是 Common.SemanticKey，这表示这个注解用于定义实体类型的语义键。
• 语义键是一种特殊的键，它定义了实体的唯一性。在 Fiori 用户界面中，语义键用于在相关实体之间建立链接，以及在导航和搜索中识别实体。

最后是 <Collection> 和 <PropertyPath> 标签：

<Collection>
    <PropertyPath>Product</PropertyPath>
</Collection>

• <Collection> 标签用于定义一个集合。在这里，它包含了语义键的所有属性。
• <PropertyPath> 标签用于定义一个属性路径。在这里，它是 Product，这意味着 Product 属性是该实体类型的语义键的一部分。

总的来说，这段 XML 的含义是：在 SEPMRA_PROD_MAN.SEPMRA_C_PD_ProductType 实体类型中，Product 属性被定义为语义键的一部分。这意味着在 Fiori 用户界面中，Product 属性将用于在相关实体之间建立链接，以及在导航和搜索中识别实体。