# 一个取消报名动作需要说清什么？

本站原创中文讲解 · 合成语音 · 非官方认证课程

## 先做判断

点一次取消，究竟允许改变哪些事实？

## 定义动作与执行一次动作

动作类型描述允许的一组修改，提交一次动作则是在特定输入下尝试执行。用取消报名举例，先定义目标报名、取消原因和状态变化，再检查此时是否允许执行。这是我们的教学案例，不是官方课程的逐字翻译。

## 提交条件和编辑权限

在 Palantir 中，能修改动作定义，与能在某组参数下提交动作，是不同的权限问题。提交条件可以结合当前用户和参数中的业务信息。不要因为页面显示了一个按钮，就认为执行端已经允许这次操作。

## 不要扩大事务的承诺

官方把动作描述为一次事务，但涉及外部支付系统时，不能自行推断成跨系统原子完成。我们仍要分别说明本体内状态变化、外部请求结果，以及超时未知时如何核对与恢复。

## 运行一条失败路径

在本站实操中，先用只读角色提交，观察拒绝；再切换模拟操作员，连续取消两次，检查只释放一个名额。最后模拟退款失败，核对取消状态仍保留。实际 Foundry 环境还需要按具体数据源和权限配置验证。

## 把概念说清楚

先写动作契约：谁可调用、输入什么、何时允许、改变什么、返回什么以及失败时如何说明。涉及外部系统时，明确哪些变化已完成、哪些仍在等待。

## 案例推演

取消报名将报名置为取消并释放名额；是否发起退款由独立政策决定。重复请求使用业务幂等标识，避免重复释放名额或重复退款。

## 检查一个常见误区

按钮隐藏不能代替执行权限。契约也不是文档写完就成立，必须用拒绝、重复、失败与恢复用例验证真实执行端。

## 暂停，完成你的作品

写一页取消契约，至少覆盖无权限、已取消、退款失败三个异常。

## 验收与下一步

权限是否在执行端检查；重复执行是否安全；取消与退款是否区分。

资料依据（2026-09-16核验）：
- [Palantir · Action types](https://www.palantir.com/docs/foundry/action-types/overview/)
- [Palantir · Submission criteria](https://www.palantir.com/docs/foundry/action-types/submission-criteria)
- [Palantir · Permissions](https://www.palantir.com/docs/foundry/action-types/permissions)