关于HAPI-FHIR中扩展元素设置isSummary及Patient.identifier切片的咨询

嘿，针对你在Patient.identifier上配置切片和自定义扩展的需求，我来分享一些关键的注意点和优化建议，帮你确保扩展能正常显示：

1. 先确认切片的基础配置正确性 #

• 确保你的Patient.identifier切片严格遵循FHIR规范定义：每个切片必须通过sliceName明确命名（比如healthCardNumber和caseRecordNumber），同时为每个切片绑定唯一的system值（例如健康卡号用特定的OID或机构自定义URL），这样FHIR服务器和客户端才能准确区分不同的标识符切片。

2. 细化isSummary标记的配置 #

你已经在扩展相关元素上标记了isSummary=true，这里需要再核对几个细节：

• 扩展根元素的isSummary：必须在自定义扩展的Extension资源本身设置isSummary=true，而不仅仅是扩展内部的子元素；
• 扩展子元素的isSummary：如果你的扩展包含子元素（比如类似data-absent-reason的valueCode），也要给这些子元素加上isSummary=true标记，确保摘要视图能完整返回扩展的内容；
• 服务器端支持：部分FHIR服务器需要在Profile的配置中明确启用自定义扩展的摘要支持，建议检查服务器的文档，确认是否需要额外配置才能识别这些标记。

3. 对齐标准扩展的语义（可选优化） #

既然你的自定义扩展作用类似FHIR标准的data-absent-reason，如果场景允许，直接复用标准扩展会更省心——标准扩展已经被大部分FHIR工具和服务器支持，不需要额外配置就能正常显示。如果必须使用自定义扩展，建议在扩展的定义文档中明确说明其语义和使用场景，避免客户端解析时出现歧义。

4. 测试验证步骤 #

可以通过以下方式验证扩展是否正常显示：

• 发送带有_summary=true参数的Patient查询请求，检查返回的资源中是否包含健康卡号切片下的自定义扩展；
• 用FHIR验证工具检查你的资源实例是否符合Profile的定义，确保isSummary标记没有遗漏或配置错误；
• 查看服务器日志，排查是否存在扩展解析或摘要过滤相关的错误信息。

内容的提问来源于stack exchange，提问作者Ross Shnaper