FHIR 中文版

1.12.7 资源定义-正规定义

1.12.7.1 Resource

Resource
基数	1..1
Invariants	Defined on this element Inv-1: 如果资源内嵌在其他资源之中,它不应该包含任何叙述性文本 (xpath: not(parent::f:contained and f:text)) Inv-2:如果资源内嵌在其他资源之中,它不应该包含内嵌资源(xpath: not(parent::f:contained and f:contained)) Inv-3: 如果资源内嵌在其他资源之中,应在另外的资源中引用它 (xpath: exists(for $id in f:contained//@id return $id[not(descendant::f:reference/@value=concat(‘#’, $id))]))
Resource.extension
定义	可以用来表示不属于资源基础定义一部分的额外信息.为了使得扩展安全可控,有一套严格的扩展定义和使用管理机制.尽管允许开发人员自定义扩展,扩展定义应满足一系列要求.
基数	0..
数据类型	Extension
别名	extensions; user content
备注	无论是机构层面还是区域层面定义的扩展,任何系统,项目或标准都能够使用这些扩展.正是利用扩展才使得FHIR标准保持简单化.
Resource.modifierExtension
定义	可以用来表示不属于资源基础定义一部分的额外信息,修饰包含它的元素含义通常,用来表示否定或者限定.为了使得扩展安全可控,有一套严格的扩展定义和使用管理机制.尽管允许开发人员自定义扩展,扩展定义应满足一系列要求.要求系统在处理资源时检查扩展修饰符.
基数	0..
数据类型	扩展
别名	extensions; user content
备注	无论是机构层面还是区域层面定义的扩展,任何系统,项目或标准都能够使用这些扩展.正是利用扩展才使得FHIR标准保持简单化.
Resource.language
定义	资源所使用的主体语言.
基数	0..1
数据类型	code
备注	用以支持索引和访问 (典型的,从文本到语音的转换会用到 language tag). 叙述性文本中html language tag 也适用于叙述性文本.资源中的language tag 可以用作规定从数据中生成的其他展现方式所使用的语言. 并非所有内容都要使用这种语言,不宜认为Resource.language会自动应用到叙述性文本当中.如果规定了语言,也宜在html的div元素中作出规定(参考HTML5中有关xml:lang 和 html lang 属性关系的信息).
Resource.text
定义	供人读的叙述性文本,包含了资源的摘要信息,可以用来表示资源的内容.叙述性文本毋须包含所有结构化数据,但至少要包含足够的信息,人如果只是看这些叙述性文本,要能够确保 "临床安全" 资源定义中可能会定义应该在叙述性文本中包含哪些内容才能够确保临床安全 .
基数	0..1
数据类型	Narrative
别名	narrative; html; xhtml; display
备注	内嵌的资源不包含叙述性文本.非内嵌的资源宜包含叙述性文本
Invariants	对该元素的影响 Inv-1: 如果资源内嵌在其他资源之中,它不应该包含任何叙述性文本 (xpath: not(parent::f:contained and f:text))
Resource.contained
定义	脱离了包含它们的资源无法单独存在的资源 - 没有单独的标识,也没有单独的事务范围.
基数	0..
数据类型	Resource
别名	inline resources; anonymous resources; contained resources
备注	当内容能够标识的时候不允许这样使用,因为一旦丢失了标识信息,要想重新恢复是非常困难的

1.12.7.2 ResourceReference

ResourceReference
资源	一个资源对另一个资源的引用.
基数	1..1
Invariants	该元素中所定义的 Inv-1: 如果资源是內联的,应包含一个本地引用.(xpath: not(starts-with(f:reference/@value, ‘#’)) or exists(ancestor::a:content/f:/f:contained/f:[@id=substring-after(current()/f:reference/@value, ‘#’)]\|/f:/f:contained/f:[@id=substring-after(current()/f:reference/@value, ‘#’)]))
ResourceReference.reference
定义	对一个location的引用,可以通过location定位其他的资源.可以是相对引用,也就是相对于服务的根URL,或者是指向能够找到资源location的绝对引用.引用可以是存在不同版本的.如果不是指向FHIR Restful服务器的引用,宜认为是针对某个版本的.内部的局部引用指向内嵌式资源.
基数	0..1
数据类型	string
备注	采用绝对URL是一种稳定的可扩展的方式,适合于云端/web应用,而相对/逻辑引用是一种灵活的方式更适合于封闭的系统. . 尽管是首选,绝对URL毋须指向 FHIR RESTful 服务器.如果url满足"/[type]/@[id]" 的结构,可以认为它指向的就是 FHIR RESTful 服务器.
Invariants	对该元素的影响 Inv-1: 如果资源是內联的,应包含一个本地引用.(xpath: not(starts-with(f:reference/@value, ‘#’)) or exists(ancestor::a:content/f:/f:contained/f:[@id=substring-after(current()/f:reference/@value, ‘#’)]\|/f:/f:contained/f:[@id=substring-after(current()/f:reference/@value, ‘#’)]))
ResourceReference.display
定义	Plain text narrative that identifies the resource in addition to the resource reference.
基数	0..1
数据类型	string
备注	一般而言,它与所引用资源的Resource.text不同.它的目的在于表示引用的是什么,而非完整的描述资源.

1.12.7.3 Narrative

Narrative
定义	供人可读的格式化文本,包括图片.
基数	1..1
Narrative.status
定义	叙述性文本的状态-完全是生成的还是是由人编写的,它可能包含额外的一些数据.
基数	1..1
绑定	NarrativeStatus: Unstated: http://hl7.org/fhir/narrative-status (The status of a resource narrative)
数据类型	code
Narrative.div
定义	叙述性文本实际的内容,简化版的XHTML.
基数	1..1
数据类型	xhtml
备注	html 元素的内容就是一部分包含了在7-11和15最基本格式化元素element元素的内容就是一部分XHTML,包含了在HTML4.0标准第7-11和15章中所描述的最基本格式化元素, <a> 元素 (要么是 name 要么是 href), images和内嵌式的 stylesheets. XHTML内容可能不包含head, a body, external stylesheet references, scripts, forms, base/link/xlink, frames, iframes and objects.
Invariants	该元素中所定义的 Inv-1: 叙述性文本应只包含HTML4.0标准第7-11章(除了第9章第四部分)和第15章中所描述的基本的html格式化元素, <a> elements (either name or href), images 和内嵌式样式表属性 (xpath: not(descendant-or-self::[not(local-name(.)=(‘a’, ‘abbr’, ‘acronym’, ‘b’, ‘big’, ‘blockquote’, ‘br’, ‘caption’, ‘cite’, ‘code’, ‘colgroup’, ‘dd’, ‘dfn’, ‘div’, ‘dl’, ‘dt’, ‘em’, ‘h1’, ‘h2’, ‘h3’, ‘h4’, ‘h5’, ‘h6’, ‘hr’, ‘i’, ‘li’, ‘ol’, ‘p’, ‘pre’, ‘q’, ‘samp’, ‘small’, ‘span’, ‘strong’, ‘table’, ‘tbody’, ‘td’, ‘tfoot’, ‘th’, ‘thead’, ‘tr’, ‘tt’, ‘ul’, ‘var’))])) Inv-2: 叙述性文本应包含非空格内容 (xpath: descendant::text()[normalize-space(.)!=’’] or descendant::html:img[@src]) Inv-3: 叙述性文本应只包含HTML4.0标准第7-11章(除了第9章第四部分)和第15章中所描述的基本的html格式化属性, <a> 元素 (either name or href), images和内嵌式样式表属性 (xpath: not(descendant-or-self::/@*[not(name(.)=(‘abbr’, ‘accesskey’, ‘align’, ‘alt’, ‘axis’, ‘bgcolor’, ‘border’, ‘cellhalign’, ‘cellpadding’, ‘cellspacing’, ‘cellvalign’, ‘char’, ‘charoff’, ‘charset’, ‘cite’, ‘class’, ‘colspan’, ‘compact’, ‘coords’, ‘dir’, ‘frame’, ‘headers’, ‘height’, ‘href’, ‘hreflang’, ‘hspace’, ‘id’, ‘lang’, ‘longdesc’, ‘name’, ‘nowrap’, ‘rel’, ‘rev’, ‘rowspan’, ‘rules’, ‘scope’, ‘shape’, ‘span’, ‘src’, ‘start’, ‘style’, ‘summary’, ‘tabindex’, ‘title’, ‘type’, ‘valign’, ‘value’, ‘vspace’, ‘width’))]))

1.12.7.4 Extension

Extension
定义	可选的扩展元素 - 所有资源中都存在.
基数	1..1
应用场景	以结构化的方式来添加扩展使得FHIR保持简化.
Extension.url
定义	extension code 定义的来源- 逻辑名称或者是URL
基数	1..1
数据类型	uri
备注	定义可能直接指向计算机化的或者是供人可读的 extensibility codes定义,或者可能是其他标准中所声明的一个逻辑URI, 这是定义扩展的资源规范的理想情况,#后面跟的就是扩展的code
Extension.value[x]
定义	扩展的取值 - 可能是一个资源或者是某个经过约束的数据类型 (参考标准中的 Extensibility).
基数	0..1
数据类型	*