动作·接口(Actions on Interfaces)
接口(interface)让"一次定义、作用于所有实现它的对象"成为可能。这一篇讲如何在动作里使用接口: 接口动作规则与接口引用参数,以及它们的能力边界。
https://www.palantir.com/docs/foundry/action-types/actions-on-interfaces/
原始标题:Action types · Actions on interfaces
一句话速览
动作·接口(Actions on Interfaces):接口(interface)让"一次定义、作用于所有实现它的对象"成为可能。这一篇讲如何在动作里使用接口:接口动作规则与接口引用参数,以及它们的能力边界。
一句话:一次定义,作用于所有实现该接口的对象
创建适用于某个接口下全部对象的"通用动作"。
你可以创建通用动作(generic actions),作用于你选定的某个接口(interface)下的所有对象。 换句话说:只要一个对象类型实现了该接口,这个动作就能用在它身上。
接口层面还有两个相关概念:接口动作类型约束(interface action type constraints)描述"实现该接口的对象类型应当用具体动作类型满足的能力"—— 它是一个接口级的"动作契约";而动作规则(action rules)描述动作类型被提交时真正执行的编辑。目前前者是本体管理器里的建模/映射功能,并非终端用户应用或 SDK 的调用面。
两种用法:接口动作规则 + 接口引用参数
从动作内部使用接口,主要有两种方式。
怎么创建一个接口动作类型
本体管理器里,从 New 菜单选 Action type。
提示:点击每条可展开更多细节。
各类规则能干啥、注意啥
Create / Modify / Delete / 创建链接 / 删除链接。
| 规则类型 | 能力 / 注意点 |
|---|---|
| Create | 会自动生成"Object type"参数让用户选要创建的类型。没有主键就无法创建——接口与 Create 规则都要包含可用作主键的接口属性。 |
| Modify | 可改任意实现接口的对象;生成"interface reference"参数。但主键不可被修改,否则提交失败(如把 Bug 的 Title 当主键又被改)。 |
| Delete | 可用 interface reference 参数指定要删除的对象。 |
| Create link | 基于接口链接约束创建链接;若约束在"两接口之间",源/目标都自动生成为接口引用参数。一个对象类型上若有多个具体链接实现会失败。 |
| Delete link | 基于接口链接约束删除链接;若对象类型上有多个具体链接实现,会尝试删除全部。 |
权限与局限:先想清楚再建
提交条件对实现接口的所有类型"一视同仁"。
- 接口动作规则遵循与对象动作类型相同的权限模型。
- 动作日志(action logs)暂不支持接口动作。
- 接口上的动作不能与函数(functions)一起使用。
提交前务必想清楚:哪些用户有权在所有实现类型上创建 / 修改 / 删除对象。
动手:接口形状判定
点击左侧卡片,判断它是否适合用"接口动作规则"实现。
一页带走
延伸阅读 · 相关页面
按主题横向跳转,不必顺着目录一篇篇读。
常见问题速答 · FAQ
关于「动作·接口(Actions on Interfaces)」,读者最常问的几个问题。