循序渐进 · 教学 · 接口(二)
在 Ontology Manager 里创建接口
跟着步骤在 Ontology Manager 里新建一个接口,并可选地为它添加链接类型和动作类型约束。
本文来源 · Source
内容整理自 Palantir Foundry 官方文档:
https://www.palantir.com/docs/foundry/interfaces/create-interface/
原始标题:Interfaces > Create an interface
https://www.palantir.com/docs/foundry/interfaces/create-interface/
原始标题:Interfaces > Create an interface
★
先记住这几条
① 创建入口是 Ontology Manager
接口在本体管理器里创建。
② 属性映射是核心动作
接口定义哪些属性,后面由对象类型映射过去。
③ 链接类型约束是可选的
接口可以约束链接,但不是必须。
④ 动作类型约束也是可选的
可以声明实现该接口的对象要支持哪些动作。
0
写在前面
按照以下步骤,在 Ontology Manager 中创建一个新的接口。
- 首先,通过左侧面板上方的 Ontologies(本体) 下拉菜单,确认你正在处理所选择的 Ontology。
- 创建新接口,可以任选以下任一方式:
- 在页面右上角,选择 New > Interface(新建 > 接口)。
- 在左侧面板 Resources(资源) 分区下,选择 Interfaces > + New interface(接口 > + 新建接口)。然后在 Interfaces 页面中,从屏幕右上角选择 New interface(新建接口)。
- 创建向导的第一页提供关于接口的说明。选择 Next(下一步)。

- 输入接口的显示名称和 API 名称。你也可以选择性地填写接口描述,并选择一个合适的图标。

- 为接口添加属性。你可以在接口本地定义属性(推荐),也可以使用共享属性。对于每个属性,选择它是必填(required)还是可选(optional)。

对于必填属性,任何实现该接口的对象类型都必须提供从本地属性到接口属性的映射。对于可选属性,实现时可以不提供映射。可选属性在构建 Marketplace 包时很有用——你可以在不引入难以解决的升级阻碍的前提下,对接口进行迭代。
- 选择一个项目用于保存该接口,然后选择 Create(创建)。

- 回到 Ontology Manager,在右上角选择 Save(保存) 以将改动应用到你的 Ontology。
1
创建接口链接类型(可选)
创建接口链接类型(可选)
要点:给接口加上链接约束,让实现它的对象类型也满足链接要求。
如果你想让该接口链接到另一个接口或对象类型,可以可选地为其添加接口链接类型。

- 在左侧面板选择 Link type constraints(链接类型约束)。
- 然后在右上角选择 Create new link type constraint(新建链接类型约束)。

如果某个建模场景要求接口链接类型,那么任何实现该接口的对象类型都必须新增或复用一条满足该接口链接类型约束的链接类型。
2
创建接口动作类型约束(可选)
创建接口动作类型约束(可选)
要点:约束实现接口的对象类型必须支持哪些动作。
如果你想让接口定义跨实现对象类型的预期动作能力,可以可选地为其添加接口动作类型约束。

- 在左侧面板选择 Action type constraints(动作类型约束)。
- 选择 Create new(新建)。
- 添加约束元数据,选择是否要求实现,并配置参数约束。

如果某个建模场景要求接口动作类型约束,那么任何实现该接口的对象类型都必须将该约束映射到一条满足约束的具体动作类型。
延伸阅读 · 相关页面
按主题横向跳转,不必顺着目录一篇篇读。
常见问题速答 · FAQ
关于「在 Ontology Manager 里创建接口」,读者最常问的几个问题。
创建接口链接类型(可选)是什么?
给接口加上链接约束,让实现它的对象类型也满足链接要求。如果你想让该接口链接到另一个接口或对象类型,可以可选地为其添加接口链接类型。
创建接口动作类型约束(可选)是什么?
约束实现接口的对象类型必须支持哪些动作。如果你想让接口定义跨实现对象类型的预期动作能力,可以可选地为其添加接口动作类型约束。