This page is part of the FHIR Specification (v0.06: DSTU 1 Ballot 2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

Resource XdsEntry - Formal Definitions 3.18.4

The formal definitions for the elements in the xdsentry resource. Also available as an XML file.

XdsEntry
DefinitionAn entry in an XDS registry
Control1..1
XdsEntry.url
DefinitionA URL that is used to access the document content directly. If this is not provided, the document may be found be searching the repositoryId for the documentId
Control0..1
Typeuri
XdsEntry.repositoryId
DefinitionThe globally unique identifier of the repository where the document is stored, assigned by the Document Repository. This unique identifier for the Document Repository may be used to identify and connect to the specific Document Repository where the document is stored once its metadata has been retrieved from a Document Registry
Control0..1
Typeuri
CommentsThis repositoryUniqueId is intended to respond to the following types of usage: The means to reference the Document Repository where this XDS document is stored. The repositoryUniqueId represents an immutable id for the Document Repository. The means to ensure that a XDS Document is retrieved from the appropriate Document Repository.
XdsEntry.mimeType
DefinitionMIME type of the document in the Repository.
Control1..1
Typestring
XdsEntry.format
DefinitionCode globally uniquely specifying the format of the document. Along with the typeCode, it should provide sufficient information to allow any potential XDS Document Consumer to know if it will be able to process the document. The formatCode shall be sufficiently specific to ensure processing/display by identifying a document encoding, structure and template (e.g., for a CDA Document, the fact that it complies with a CDA schema, possibly a template and the choice of a content-specific style sheet).
Control1..1
TypeCoding
CommentsFormat codes may be specified by multiple organizations. Format codes defined by ITI shall have names with the prefix urn:ihe:iti:. Format codes defined by other IHE domains shall have names with the prefix urn:ihe:’domain initials’: Format codes defined by the Affinity Domain shall have names with the prefix urn:ad:’name of affinity domain’: Affinity Domains shall be unique. The prefixes described here are not assumed to be exhaustive.
XdsEntry.class
DefinitionThe code specifying the particular kind of document (e.g., Prescription, Discharge Summary, Report). It is suggested that the XDS Affinity Domain draws these values from a coding scheme providing a coarse level of granularity (about 10 to 100 entries). Shall have a single value.
Control1..1
TypeCoding
XdsEntry.type
DefinitionThe code specifying the precise kind of document (e.g., Pulmonary History and Physical, Discharge Summary, Ultrasound Report).
Control1..1
TypeCoding
CommentsIt is suggested that the XDS Affinity Domain draw these values from a coding scheme providing a fine level of granularity.
XdsEntry.title
DefinitionRepresents the title of the document.
Control0..1
Typestring
CommentsClinical documents often do not have a title, and are collectively referred to by the display name of the classCode (e.g., a "consultation" or "progress note"). Where these display names are rendered to the clinician, or where the document has a unique title, the title component shall be used. Max length, 128 chars
XdsEntry.documentId
DefinitionThe globally unique identifier assigned by the document creator to this document. This unique identifier may be used in the body of other XDS Documents to reference this document.
Control1..1
Typeuri
CommentsThe length of Unique Identifier shall not exceed 128 bytes. The structure and format of this Id shall be consistent with the specification corresponding to the format attribute. (e.g., for a DICOM standard document a 64 character numeric UID, for an HL7 CDA format a serialization of the CDA Document id extension and root in the form oid#extension, where OID is a 64 digits max, and the ID is a 16 UTF-8 char max). If the oid is coded without the extension then the '^' character shall not be included. This uniqueId is intended to provide the means to reference this XDS document from within the content of another document. Neither the XDS Registry nor the Repository is aware of such references, but the Document Sources and Consumers are
XdsEntry.availability
Definitiondeprecated documents can be included in some responses
Control1..1
Typecode from XdsEntryAvailability
CommentsThis attribute is always set to Approved as part of the submission of new XDS Documents. It may be changed to Deprecated under the primary responsibility of the Document Source with possible patient supervision. Although XDS supports the ability to delete documents, there is no such state as “the Document Entry is removed” (only an audit trail is kept if such a deletion is allowed).
XdsEntry.confidentialityCode
DefinitionThe code specifying the level of confidentiality of the XDS Document. These codes are specific to an XDS Affinity Domain.
Control1..1
TypeCoding
CommentsEnforcement and issues related to highly sensitive documents are beyond the scope of XDS (see security section). confidentialityCode is part of a codification scheme and value set enforced by the Document Registry.
XdsEntry.created
DefinitionRepresents the time the author created the document in the Document Source
Control1..1
Typeinstant
XdsEntry.event
DefinitionThis list of codes represents the main clinical acts, such as a colonoscopy or an appendectomy, being documented. In some cases, the event is inherent in the typeCode, such as a "History and Physical Report" in which the procedure being documented is necessarily a "History and Physical" act.
Control0..*
TypeCoding
CommentsAn event can further specialize the act inherent in the typeCode, such as where it is simply "Procedure Report" and the procedure was a "colonoscopy". If one or more eventCodes are included, they shall not conflict with the values inherent in the classCode, practiceSettingCode or typeCode, as such a conflict would create an ambiguous situation. This short list of codes is provided to be used as “key words” for certain types of queries.
XdsEntry.hash
DefinitionHash key of the XDS Document itself
Control0..1
Typestring
CommentsThis value is computed by the Document Repository and used by the Document Registry for detecting the improper resubmission of XDS Documents. If present, shall have a single value. If this attribute is received in a Provide & Register Document Set-b [ITI-41] transaction, it shall be verified by the repository with the actual hash value of the submitted document; an XDSRepositoryMetadataError shall be returned on mismatch.
XdsEntry.size
DefinitionSize in bytes of the byte stream that was provided in the Register and Provide Transaction and stored by the XDS Document Repository. This value is computed by the Document Repository and included in the Register Documents Set Transaction.
Control0..1
Typestring
CommentsIf this attribute is received in a Provide & Register Document Set-b [ITI-41] transaction, it shall be verified by the repository with the actual size of the submitted document; an XDSRepositoryMetadataError shall be returned on mismatch.
XdsEntry.language
DefinitionSpecifies the human language of character data in the document. The values of the attribute are language identifiers as described by the IETF (Internet Engineering Task Force) RFC 3066.
Control0..1
Typestring
CommentsThis value may further be restricted by the registry according to XDS Affinity Domain specific policy.
XdsEntry.folder
DefinitionFolders that this document is registered in
Control0..*
TypeResource(XdsFolder)
XdsEntry.patientId
DefinitionThe patientId represents the subject of care of the document. This identifier shall be from the Assigning Authority Domain supporting the XDS Affinity Domain in which the Document Registry operates.
Control1..1
TypeIdentifier
CommentsThe system is the "Authority Domain Id" (enforced by the Registry), and the identifier is an Id in the above domain.
XdsEntry.sourcePatientId
DefinitionThe sourcePatientId represents the subject of care medical record Identifier (e.g., Patient Id) in the local patient Identifier Domain of the Document Source.
Control0..1
TypeIdentifier
CommentsThe system is the "Authority Domain Id" (enforced by the Registry), and the identifier is an Id in the above domain. This sourcePatientId is not intended to be updated once the Document is registered (just as the Document content and metadata itself will not be updated without replacing the previous document). As this sourcePatientId may have been merged by the source actor, it may no longer be in use within the Document Source (EHR-CR). It is only intended as an audit/checking mechanism and has occasional use for Document Consumer Actors.
XdsEntry.patientInfo
DefinitionThis is a reference to the demographics information of the person to whose medical record this document belongs, as the Document Source knew it at the time of Submission. This information typically includes: the patient first and last name, sex, and birth date
Control0..1
TypeResource(Person)
CommentsThe Clinical XDS Affinity Domain policies may require more or less specific information and format. This patient information is not intended to be updated once the Document is registered (just as the Document content and metadata itself will not be updated without replacing the previous document). As sourcePatientInfo may have been updated by the source actor, it may no longer be in use within the Document Source (EHR-CR). It is only intended as an audit/checking mechanism and has occasional use for Document Consumer actors.
XdsEntry.author
DefinitionRepresents the humans and/or machines that authored the document
Control1..*
XdsEntry.author.name
DefinitionRepresents the name of the human and/or machine that authored the document within the authorInstitution
Control0..1
TypeHumanName
CommentsThe document author may be the patient itself
XdsEntry.author.id
DefinitionRepresents the id of the human and/or machine that authored the document within the authorInstitution
Control0..1
TypeIdentifier
XdsEntry.author.role
DefinitionA code that represents the role of the author with respect to the patient when the document was created.
Control0..*
Typestring
XdsEntry.author.specialty
DefinitionRepresents a specific specialty within a healthcare facility under which the human and/or machines authored the document
Control0..*
Typestring
XdsEntry.author.institution
DefinitionRepresents a specific healthcare facility under which the human and/or machines authored the document. A specific case is that of homecare.
Control0..*
XdsEntry.author.institution.id
Definitionid of facility
Control0..1
TypeIdentifier
XdsEntry.author.institution.name
Definitionname of facility
Control0..1
Typestring
XdsEntry.author.contact
DefinitionRepresents the telecommunications address (e.g. email) of the document author, intended to assist with automated routing of other messages intended for the document author
Control0..*
TypeContact
XdsEntry.authenticator
DefinitionRepresents a participant who has legally authenticated or attested the document within the authorInstitution. Legal authentication implies that a document has been signed manually or electronically by the legalAuthenticator.
Control0..1
XdsEntry.authenticator.id
Definitionid of authenticator
Control0..1
TypeIdentifier
XdsEntry.authenticator.name
Definitionname of authenticator
Control0..1
TypeHumanName
XdsEntry.facilityType
DefinitionThis code represents the type of organizational setting of the clinical encounter during which the documented act occurred
Control0..1
TypeCoding
CommentsIn some cases, the setting of the encounter is inherent in the typeCode, such as "Diabetes Clinic Progress Note". healthcareFacilityTypeCode shall be equivalent to or further specialize the value inherent in the typeCode; for example, where the typeCode is simply "Clinic Progress Note" and the value of healthcareFacilityTypeCode is "private clinic". The value shall not conflict with the value inherent in the typeCode, as such a conflict would create an ambiguous situation
XdsEntry.practiceSetting
DefinitionThe code specifying the clinical specialty where the act that resulted in the document was performed (e.g., Family Practice, Laboratory, Radiology).
Control1..1
TypeCoding
CommentsIt is suggested that the XDS Affinity Domain draws these values from a coding scheme providing a coarse level of granularity (about 10 to 100 entries)
XdsEntry.homeCommunity
DefinitionA globally unique identifier for a community.
Control0..1
Typeuri
XdsEntry.service
DefinitionRepresents the time of the service being documented took place (clinically significant, but not necessarily when the document was produced or approved).
Control1..1
CommentsThis may be the same as the encounter time in case the service was delivered during an encounter. Encounter time is not coded in XDS metadata but may be coded in documents managed by XDS. Note: Other times, such as document creation or approval are to be recorded, if needed, within the document.
XdsEntry.service.start
DefinitionStart time
Control1..1
TypedateTime
XdsEntry.service.stop
DefinitionStop time
Control0..1
TypedateTime
XdsEntry.comments
DefinitionComments associated with the Document.
Control0..1
Typestring
Comments Free form text with an XDS Affinity Domain specified usage.
To DoShould this be removed? It is effectively for extensions
XdsEntry.extension
DefinitionSee Extensions
Control0..*
TypeExtension
RIM Mapping[varies]
XdsEntry.text
DefinitionText summary of resource (for human interpretation)
Control1..1
TypeNarrative

This is an old version of FHIR retained for archive purposes. Do not use for anything else
Implementers are welcome to experiment with the content defined here, but should note that the contents are subject to change without prior notice.
© HL7.org 2011 - 2012. FHIR v0.06 generated on Tue, Dec 4, 2012 00:04+1100. License