XDS标准文档使用指南

1 XDS文档概述
XDS（Cross-Enterprise Document Sharing）的中文意思是跨企业文档共享。XDS通过规范文档位置的元数据获取医疗文档，但不规范临床文档的具体内容。
2 XDS文档结构
在HIE项目中XDS文档是携带附件的SOAP文件（Soap With Attachment）的第一部分。我们将需要传送的文件做为SOAP文件的附件，而不论该文件的类型是什么。实际我们使用的是MIME格式标准。
2.1 文档示例
XDS文档头是标准的SOAP文件。示例如下：
<?xml version="1.0" ?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<rs:SubmitObjectsRequest
xmlns:rs="urn:oasis:names:tc:ebxml-regrep:registry:xsd:2.1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="urn:oasis:names:tc:ebxml-regrep:rim:xsd:2.1"
xmlns:rim="urn:oasis:names:tc:ebxml-regrep:rim:xsd:2.1">

<!—在这里定义XDS的附件元数据-->

</rs:SubmitObjectsRequest>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
完整的携带附件的SOAP文件示例如下：
POST /ebxmlrr/registry/soap HTTP/1.1
Content-Type: multipart/related; type="text/xml"; boundary=---------------------------7d4285f14803b8
SOAPAction: ""
User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)
Host: gunshot.ncsl.nist.gov:8080
Accept: */*
Connection: Keep-Alive
Cache-Control: no-cache
Content-Length: 1318

-----------------------------7d4285f14803b8
Content-Type: text/xml

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<SubmitObjectsRequest xmlns="urn:oasis:names:tc:ebxml-regrep:registry:xsd:2.1">
<LeafRegistryObjectList>
<ExtrinsicObject id="doc_1" mimeType="text/xml"/>
</LeafRegistryObjectList>
</SubmitObjectsRequest>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
-----------------------------7d4285f14803b8
Content-Type: text/xml
Content-Id: <doc_1>

<books>
<book isbn="0345374827"><title>The Great Shark Hunt</title>
<author>Hunter S. Thompson</author></book>
<book><title>Life with Father</title><author>Clarence Day</author></book>
</books>

-----------------------------7d4285f14803b8—
2.2 指向附件的文档标签
通过上面例子我们可以看出，指向附件的标签是<ExtrinsicObject>，我们主要是针对该标签进行操作。事实上，该标签的父标签<LeafRegistryObjectList>是可以拥有多个<ExtrinsicObject>的，也就是说，我们可以携带多个附件。我们目前只需要传输一个附件，以后可以进行扩展，设计时应考虑到扩展问题。
2.3 文档标签<ExtrinsicObject>的属性
我们要记录到索引数据库中的信息全部来自于该标签的属性。
该标签含有的属性是很多的，但是我们并不是需要所有的属性，只取其中一部分，满足我们的需求就可以了。下面列出一些我们需要的属性。
2.3.1 附件文档文件类型（mimeType）
附件文档的文件类型是作为文档标签的属性存在的。它指定的类型都是遵循mime标准的，mine标准详见后面附录信息。
<rim:ExtrinsicObject mimeType="application/pdf"
id="theDocument" objectType= "urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1">
我们需要通过该属性判断上传的数据是否为结构化数据。目前是text/xml为结构化数据。
2.3.2 附件内容的类型（typeCode）
该属性是以文档标签的子标签形式存在的，我们也可以在LocalizedString标签中指定本地化名称，在<ValueList>中指定疾病类型的主标签和副标签。
<rim:Classification
classificationScheme="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a"
classifiedObject="theDocument"
nodeRepresentation="typeCode">
<rim:Name>
<rim:LocalizedString value="typeCodeDisplayName"/>
</rim:Name>
<rim:Slot name="codingScheme">
<rim:ValueList>
<rim:Value>XDS Affinity Domain Specific Value</rim:Value>
</rim:ValueList>
</rim:Slot>
</rim:Classification>
2.3.3 附件创建时间（createTime）
表明该文档在文档源的创建时间。该属性是作为文档标签的子标签存在的。时间使用UTC时间，格式如2009-04-08 13:30:34应该书写为20090408133034。
<rim:Slot name="creationTime">
<rim:ValueList>
<rim:Value>20041225212010</rim:Value>
</rim:ValueList>
</rim:Slot>
2.3.4 附件创建机构（authorInstitution）
该属性是以文档标签的子标签形式存在的。指明了附件文档的上传位置，我们可以在该位置添加区域节点编号和节点编号。
<rim:Classification
classificationScheme="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d"
classifiedObject="theDocument" nodeRepresentation="">
<rim:Slot name="authorInstitution"> <!—可以是多值 -->
<rim:ValueList>
<rim:Value>name of institution</rim:Value>
</rim:ValueList>
</rim:Slot>
</rim:Classification>
2.3.5 附件唯一标识符(UUID)
该属性是以文档标签的自标签形式出现的。指明了该附件存在一个全球唯一标识符。
2.3.6 患者标识符（patientId）
该属性是以文档标签的子标签形式存在的。指明了患者的标识符。
<rim:ExternalIdentifier
identificationScheme="urn:uuid:58a6f841-87b3-4a3e-92fd-a8ffeff98427"
value="6578946^^^&1.3.6.1.4.1.21367.2005.3.7&ISO">
<rim:Name>
<rim:LocalizedString value = "patientId"/>
</rim:Name>
</rim:ExternalIdentifier>
2.3.7 患者信息（patientInfo）

2.3.8 附件的大小（size）
该属性是以文档标签的子标签形式存在的。附件大小指明附件占用磁盘空间的大小。单位为字节（byte）。
<rim:Slot name="size">
<rim:ValueList>
<rim:Value>3654</rim:Value>
</rim:ValueList>
</rim:Slot>
2.3.9 附件源存储位置（URI）
该属性是以文档标签的子标签形式存在的。附件在文档源处的存储位置，如果在文件系统中，可以使用file:///前缀。
<rim:Slot name="URI">
<rim:ValueList>
<rim:Value>http://www.ihe.net</rim:Value>
</rim:ValueList>
</rim:Slot>
3 UUID的使用
通过浏览上面的属性我们可以看出，即便都是以子标签的形式出现，这其中还是有区别的。有的就是直接以名字的形式出现，例如：size，uri，createTime；有的则是以<rim:Classification>标签的形式出现，例如：typecode，authorInstitution；那么它们有什么不同呢？
你可以这样理解，以<rim:Classification>标签出现的，可以认为这是一个属性集合，类似于变成语言中的结构或者类。这些标签和文档标签都使用了UUID，代表了对象类型。
3.1 我们用到的UUID
<!—疾病类型代码:typeCode-->
<ObjectRef id="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a" />
<!—患者标识符:patientId-->
<ObjectRef id="urn:uuid:6b5aea1a-874d-4603-a4bc-96a0a7b38446" />
<!—创建机构:authorInstitution-->
<ObjectRef id="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d" />
<!—文档入口对象:ExtrinsicObject-->
<ObjectRef id="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1" />
3.2 在XDS标准文档中UUID的定义
3.2.1 XDS提交文档集





UUID名称类型在文档源/查询中是否必选
urn:uuid:a54d6aa5-d40d-43f9-88c5-b4633d873bddXDSSubmissionSetClassificationNodeR/R
urn:uuid:a7058bb9-b4e4-4307-ba5b-e3f0ab85e12d
XDSSubmissionSet. author		External Classification SchemeR2/R
urn:uuid:aa543740-bdda-424e-8c96-df4873be8500
XDSSubmissionSet. contentTypeCode		External Classification SchemeR/R
urn:uuid:6b5aea1a-874d-4603-a4bc-96a0a7b38446
XDSSubmissionSet. patientId		External IdentifierR/R
urn:uuid:554ac39e-e3fe-47fe-b233-965d2a147832
XDSSubmissionSet. sourceId		External IdentifierR/R
urn:uuid:96fdda7c-d067-4183-912e-bf5ee74998a8
XDSSubmissionSet. uniqueId		External IdentifierR/R

3.2.2 XDS文档
名称 类型 在文档源/查询中
是否必选
UUID urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1
XDSDocumentEntry ClassificationNode R/R
UUID urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d
XDSDocumentEntry.author External Classification Scheme R2/R
UUID urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a
XDSDocumentEntry.classCode External Classification Scheme R/R
UUID urn:uuid:f4f85eac-e6cb-4883-b524-f2705394840f
XDSDocumentEntry.confidentialityCode External Classification Scheme R/P
UUID urn:uuid:2c6b8cb7-8b2a-4051-b291-b1ae6a575ef4
XDSDocumentEntry.eventCodeList External Classification Scheme O/R
UUID urn:uuid:a09d5840-386c-46f2-b5ad-9c3699a4309d
XDSDocumentEntry.formatCode External Classification Scheme R/R
UUID urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b0bdb91e1
XDSDocumentEntry.healthCareFacilityTypeCode External Classification Scheme R/R
UUID urn:uuid:58a6f841-87b3-4a3e-92fd-a8ffeff98427
XDSDocumentEntry.patientId ExternalIdentifier R/R
UUID urn:uuid:cccf5598-8b07-4b77-a05e-ae952c785ead
XDSDocumentEntry.practiceSettingCode External Classification Scheme R/R
UUID urn:uuid:f0306f51-975f-434e-a61c-c59651d33983
XDSDocumentEntry.typeCode External Classification Scheme R/R
UUID urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab
XDSDocumentEntry. uniqueId ExternalIdentifier R/R
3.2.3 XDS目录
名称 类型 在文档源/查询中
是否必选
UUID urn:uuid:d9d542f3-6cc4-48b6-8870-ea235fbc94c2
XDSFolder ClassificationNode R/R
UUID urn:uuid:1ba97051-7806-41a8-a48b-8fce7af683c5
XDSFolder.codeList External Classification Scheme R2/R
UUID urn:uuid:f64ffdf0-4b97-4e06-b79f-a52b38ec2f8a
XDSFolder.patientId External Identifier R/R
UUID urn:uuid:75df8f67-9973-4fbe-a900-df66cefecc5a
XDSFolder. uniqueId External Identifier R/R
3.2.4 文档间关联关系
名称 类型 在文档源/查询中
是否必选
UUID urn:uuid:917dc511-f7da-4417-8664-de25b34d3def
APND ClassificationNode
UUID urn:uuid:60fd13eb-b8f6-4f11-8f28-9ee000184339
RPLC External Classification Scheme
UUID urn:uuid:ede379e6-1147-4374-a943-8fcdcf1cd620
XFRM External Identifier
UUID urn:uuid:b76a27c7-af3c-4319-ba4c-b90c1dc45408
XFRM_RPLC External Identifier
UUID urn:uuid:8ea93462-ad05-4cdc-8e54-a8084f6aff94
signs External Identifier
3.2.5 其它
名称 类型 在文档源/查询中
是否必选
UUID urn:uuid:10aa1a4b-715a-4120-bfd0-9760414112c8
XDSDocumentEntryStub ClassificationNode
4 HIE项目中文档传输XDS文档
<soap:Envelope xml="urn:oasis:names:tc:ebxml-regrep:rim:xsd:2.1""
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:ns0="urn:oasis:names:tc:ebxml-regrep:registry:xsd:2.1">
<soap:Header/>
<soap:Body>
<SubmitObjectsRequest>
<LeafRegistryObjectList>
<ObjectRef id="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a" />
<ObjectRef id="urn:uuid:6b5aea1a-874d-4603-a4bc-96a0a7b38446" />
<ObjectRef id="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d" />
<ObjectRef id="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1" />
<ExtrinsicObject id="[可以自定义或者采用UUID]" mimeType="[附件类型]" objectType="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1">
<Classification
classificationScheme="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a"
classifiedObject="theDocument"
nodeRepresentation="typeCode">
<Name>
<LocalizedString value="[本地化类型名称]"/>
</Name>
<Slot name="codingScheme">
<ValueList>
<Value>[疾病主类型]</Value>
<Value>[疾病辅类型]</Value>
</ValueList>
</Slot>
</Classification>
<Classification
classificationScheme="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d"
classifiedObject="theDocument" nodeRepresentation="">
<Slot name="authorInstitution">
<ValueList>
<Value>[区域节点编码]</Value>
<Value>[节点编码]</Value>
</ValueList>
</Slot>
</Classification>
<ExternalIdentifier
identificationScheme="urn:uuid:6b5aea1a-874d-4603-a4bc-96a0a7b38446"
value="[患者标识符]">
<Name>
<LocalizedString value = "[本地化患者标识符]"/>
</Name>
</ExternalIdentifier>
<Slot name="creationTime">
<ValueList>
<Value>[创建时间]</Value>
</ValueList>
</Slot>
<Slot name="size">
<ValueList>
<Value>[文件大小]</Value>
</ValueList>
</Slot>
<Slot name="URI">
<ValueList>
<Value>[文件地址位置]</Value>
</ValueList>
</Slot>
</ExtrinsicObject>
</LeafRegistryObjectList>
</SubmitObjectsRequest>
</soap:Body>
</soap:Envelope>
5 参考文件

评论

发表评论

此博客中的热门博文

如何解决在Delphi2009中添加pas组件的问题

过去Delphi7的时代，我们写了很多.pas的单元式组件，用Install Component的方式就可以安装了。但是，在Delphi2009中这个功能被取消了。 如何解决这个问题呢？ 你可以在Delphi2009中New一个Package，然后将你的*.pas文件和相关文件（*.dcu， *.dcr，*.res) 添加到Package中，然后再Build该项目，会产生*.hpp, *.obj, *.bpi, *.lib, *.bpl 等文件。 然后，你就可以在Delphi2009中使用Install package方式安装了。 如果你的.pas文件中没有Register方法，你需要补充它： procedure Register; begin RegisterComponents('MyComponentName', [MyTypeName]); end;
阅读全文

在Delphi中操作Sap对象造成内存增长的原因

曾经在我的一个Delphi开发项目中，我遇到过这样一个问题，困扰了我相当一段时间。 我将SAP对象封装成了类，并在一个线程中调用。也就是说，SAP对象的创建释放全部是通过代码来操作的，不同于直接将SAP控件拖放到窗体上。 线程每执行一次SAP读写操作，内存就增长24K-32K。 关键代码 下面是SAP类的部分关键代码，含有SAP对象的创建和释放。 procedure TSapSvr.Open(FunctionName: string); begin if fConnect.LogOn(0, True) then begin fFunctionName := FunctionName; fFunction := fSapFunctions.Add(FunctionName); end; end; procedure TSapSvr.Close; begin fFunction := Unassigned; fSapFunctions.ReMoveAll(); fConnect.LogOff; end; 我就是在线程中不断的调用Open和Close函数，你能看出问题出在哪里吗？你肯定想不到的。 解决方案 我也是在无意中发现的，不过我现在还不知道原因，告诉你解决的方法吧！那就是将 fSapFunctions.ReMoveAll(); 删除！！！ 结束语 你能告诉我原因吗？ 附件中我提供了我封装的SAP类，分享给大家，如果发现问题，请转送一份文件给我！
阅读全文

杀死团队的七种武器（转）

不管你是一个团队的成员还是带头人，如果你对它已经厌倦了，恨不得大家早点儿散伙，不妨赶紧捡起来下面这七种武器。好吧，也许你是一片好心， 希望改变团队目前垂垂危矣的状况，病急乱投医，随便捡起一把枪，却没搞懂枪口冲着哪个方向，再加上擦枪走火，自行了断，也不是不可能。有的武器介绍之后，还有使用它的进阶技巧。让其成为项目管理、共同协作、职场发展必备之最佳利器。 　　如果当初猪八戒扔掉钉耙，而是拿起来这些的话，也许他早就回高老庄，跟高翠兰一起，从此过上快乐、幸福的生活了。 武器一：贸然加入陌生人 　　团队来了新人，不要介绍他给大家认识，不要让大家知道他的技能和长处。人们会根据他的一些细微行为做出自己的判断，而不是先去深入了解他。 要是新人的兴趣癖好跟大家完全相反，那就再好不过了。 进阶技巧： 　　把两个死对头加入到一个团队中，而且告诉大家他们的技能对于团队来说很重要。这样一来，他们之间的摩擦就会成为加速团队分裂的催化剂。 武器二：限制沟通 　　别让大家谈天，这样会增进他们的感情。不断提醒他们“你们还有活要干！”要是能在办公室里面贴上一个“静”，就再好不过。实际上，如果团队分布在不同的地方， 甚至彼此之间的文化背景都不同，效果就更好了。不到迫不得已，绝不要把一个团队的人安排在一起。不要公布通讯录。让人们的惰性发挥效果，如果想找一个人很麻烦，他就不会找了。 进阶技巧： 　　告诉团队时间紧迫，发邮件也是浪费时间。这样人们就不会发送不必要的信息了。 武器三：分清长幼尊卑 　　最佳的装备给最棒的人。最快的电脑、最好的办公室、额外的假期等等等等，只给这些精英人物。当人们看到有人可以享受特权时，嫉妒暗自滋生。基督教的七宗罪，“嫉妒”跻身其中。更美妙的是，一旦这种致命武器在团队中出现，不用人浇灌，敌意就会不断蔓延。 武器四：打人要打脸 　　每个人都有自己的弱点，找到它！把人们的弱点公开出来，并且使其个人化。要指名道姓！在表达方式上也要无所不用其极：羞辱，责怪等等，不一而足。传播方式，可以通过备忘录、邮件、会议上的发言。用红色的大字体可以加强效果。更棒的是，你还可以散布流言。要想让人信服，不妨在流言中加入一些真相，这就更有效啦。。。 进阶技巧 　　曾经有一个公司的总裁，向全公司发送了一个备忘录，其中责备了软件团队新产品的种种不足。这种做法太牛掰了！这个总裁也就成了公司的杀手，不久之后，公司成功散...
阅读全文