FHIR场景下如何调用PlanDefinition的$apply生成CarePlan
PlanDefinition $apply 操作生成CarePlan实操指引
前置要求
- 已提交的PlanDefinition实例状态必须为
active,且已配置完成活动定义、触发逻辑等核心字段 - 所用FHIR服务器支持PlanDefinition资源的$apply操作,FHIR R4及以上版本的标准实现均默认兼容该操作
标准请求示例
请求方法与路径:POST [FHIR服务器基地址]/PlanDefinition/[你的PlanDefinition实例ID]/$apply
请求头必填项:
- Content-Type:
application/fhir+json
请求体示例:
{ "resourceType": "Parameters", "parameter": [ { "name": "subject", "valueString": "Patient/[目标患者实例ID]" }, { "name": "encounter", "valueString": "Encounter/[关联就诊实例ID,非必填]" }, { "name": "practitioner", "valueString": "Practitioner/[责任医师实例ID,非必填]" } ] }
核心参数说明
subject为必填参数,取值为目标患者资源的相对引用路径,用于绑定生成的CarePlan对应的服务对象- 可根据业务场景补充可选参数:比如传入
period指定CarePlan的生效时间范围,传入data携带用于决策的额外临床数据 - 若需要生成草稿状态的CarePlan,可额外添加
status参数,取值设为draft即可
返回结果说明
调用成功后服务器会直接返回生成的CarePlan资源实例,核心内容会自动从原PlanDefinition继承:
- CarePlan的
instantiatesCanonical字段会自动关联你调用的PlanDefinition实例地址 - PlanDefinition中定义的所有
action节点会自动转换为CarePlan的activity字段内容 - 你传入的患者、就诊等关联参数会自动填充到CarePlan的对应关联字段中
常见问题排查
- 返回404错误时,先检查传入的PlanDefinition实例ID是否真实存在,且实例状态为
active - 返回422参数错误时,先检查必填的
subject参数是否正确传入,且对应的患者ID在服务器中真实存在 - 生成的CarePlan缺失活动内容时,检查原PlanDefinition的
action字段是否配置了符合FHIR规范的活动定义
内容的提问来源于stack exchange,提问作者code tutorial
相关产品推荐
相关产品推荐

