让对象类型实现接口
接口定义好之后,任何符合形状的对象类型都可以实现它。这一篇给出两条路径:在 Ontology Manager 里手动映射,或在 Pipeline Builder 里配置产出类型。
https://www.palantir.com/docs/foundry/interfaces/implement-interface/
原始标题:Interfaces > Implement an interface
先记住这几条
写在前面
一旦定义完成,任何符合接口定义的对象类型都可以实现该接口。这意味着对象类型必须拥有能满足接口必填属性的属性、能满足所有必填链接类型约束的链接,以及能满足接口上定义的所有必填动作类型约束的动作类型。
用一个对象类型实现接口,表明该对象类型在 Ontology 中是接口的一个具体实例。这一声明为对象类型带来额外的功能,即:
- 针对该接口的 Object Set Service 搜索会返回实现该对象类型的匹配对象。
- 实现该对象类型的对象既可以使用其本地 API 名称(当被当作具体对象类型时),也可以使用接口 API 名称来访问其属性与链接(当被当作接口类型时)。
简而言之,实现一个接口让应用消费方能够通过接口定义与任意及所有实现对象交互。这使得应用代码可以基于接口作为 API 层来编写,而无需应用单独支持每个实现对象类型。此外,通过把接口作为应用 API 层,新对象类型只需实现该应用接口即可被加入应用,无需为了显式支持新对象类型而改动代码。
在 Ontology Manager 中实现
在 Ontology Manager 中实现
按照以下步骤,用一个对象类型实现接口。
1. Select your interface and object type
首先,在 Ontology Manager 中导航到该对象类型,打开 Interfaces(接口) 标签页。选择页面右上角的 + Implement new interface(+ 实现新接口)。

在弹出的对话框中,选择要实现的接口。

或者,导航到接口概览页,在 Implementations(实现) 分区选择 + New(+ 新建)。

然后,选择要实现该接口的对象类型。

2. Map local properties
要实现一个接口,一个对象类型必须声明将现有对象属性映射到接口必填属性的映射。如果某个接口属性被标记为可选(optional),则可以跳过映射。

3. Map link type constraints
如果接口上声明了任何必填的链接类型约束,你必须在该对象类型上为每个必填链接类型约束选择一个满足条件的链接类型。你也可以选择性地为任何非必填链接类型约束提供链接映射。你可以选择已有的链接类型,或新建一个来满足每个约束。

4. Map action type constraints
如果接口上声明了任何必填的动作类型约束,你必须在该对象类型上为每个必填动作类型约束选择一个满足条件的动作类型。你也可以选择性地为任何非必填动作类型约束提供动作映射。
接口实现创建完成后,从对象类型的 Interfaces(接口) 标签页配置参数映射。在将改动保存到 Ontology 之前,你必须将任何必填参数约束映射到具体动作类型上兼容的必填参数。
5. Save changes
选择 Save(保存),将改动应用到你的 Ontology。
在 Pipeline Builder 中实现
在 Pipeline Builder 中实现
按照以下步骤,在 Pipeline Builder 中的对象类型输出上实现一个接口。
1. Open output type configuration
选择你想要实现接口的那个对象类型输出,然后选择 Edit(编辑) 选项。

2. Select the interface to implement
选择 Implement interface(实现接口)。

然后,选择要实现的接口,并选择 Implement and go to mapping(实现并前往映射)。

3. Map local properties
要实现一个接口,一个对象类型必须包含接口的共享属性,或声明将现有对象属性映射到接口共享属性的映射。同时存在于接口和对象类型上的共享属性会被自动映射。任何不在对象类型上的共享属性,都需要你手动输入映射以满足接口定义。

4. Review implemented interfaces
你可以从输出类型配置面板查看该对象类型输出所实现的接口。

Pipeline Builder 目前在实现接口时不支持链接类型约束或动作类型约束的映射。如果你的接口包含必填的链接类型约束或必填的动作类型约束,你必须通过 Ontology Manager 来实现该接口。
延伸阅读 · 相关页面
按主题横向跳转,不必顺着目录一篇篇读。