This chapter describes:
A separate chapter, “Customizing the SDA”, describes the options available to customize and extend the SDA.
The Basic XML Structure of an SDA Document
The major sections in an SDA document are as follows:
<Container> <Patient/> <Encounters/> <AdvanceDirectives/> <Alerts/> <Allergies/> <Appointments/> <Problems/> <Diagnoses/> <Documents/> <LabOrders/> <RadOrders/> <OtherOrders/> <Medications/> <Vaccinations/> <Observations/> <PhysicalExams/> <Procedures/> <FamilyHistories/> <IllnessHistories/> <SocialHistories/> <CustomObjects/> <Referrals/> <ClinicalRelationships/> <ProgramMemberships/> <MemberEnrollments/> <MedicalClaims/> <GenomicsOrders/> <CarePlans/> <HealthConcerns/> <Goals/> <SocialDeterminants/> </Container>
The following rules apply to an SDA document:
There is a single <Patient>.
<Patient> is required and must be the first section that appears (after properties of the <Container> such as <Action>, <EventDescription>, or <SendingFacility>, see the class reference for specific details).
All sections other than <Patient> are optional.
All sections other than <Patient> may contain multiple entries, for example:
<Procedures> <Procedure> ... </Procedure> <Procedure> ... </Procedure> </Procedures>Copy code to clipboard
The <Encounters> section, if included, must appear directly after the <Patient> section.
All other sections may appear in any order.
Any entry may optionally reference an encounter number. In this case, <Encounters> must be included and must contain an <Encounter> with that <EncounterNumber>.
Some sections may also include an <ActionCode> or <ActionScope> to indicate that some action relative to persistence should be performed. In HealthShare Unified Care Record, these elements direct the system to perform some action when it stores the SDA, while in InterSystems IRIS for Health, you can direct that some action be taken against persisted SDA. For example, an <ActionCode> of D deletes a matching entry from the Unified Care Record. See the class reference for specific details relevant to each SDA section.
The Patient in SDA
The HS.SDA3.Patient class represents the patient. This class contains properties that store information such as the following:
Demographic information and other basics, for example: name, a list of addresses, gender, marital status, race, religion, and so on
The following table shows the properties of HS.SDA3.Patient. Some of these properties are simple (for example, strings), some are complex objects which contain properties of their own, and some are lists of complex objects:
|Simple Property||Complex Object||List of Complex Objects|
*A <Patient> SDA section may include an <ActionCode>. An <ActionCode> of D instructs HealthShare Unified Care Record to delete a patient with the matching MRN. An <ActionCode> of R instructs Unified Care Record to replace an existing patient with this patient, based on MRN. See the class reference for specific details.
Encounters in SDA
An encounter encompasses all of the medical information related to a specific medical incident. The HS.SDA3.Encounter class represents a medical encounter of a patient. Other sections in the SDA, representing orders, procedures, exams and the like can refer to the encounter number, and thus be tied together.
The following table shows the properties of HS.SDA3.Encounter, some of which are simple (for example, strings), some of which are complex objects (containing properties of their own), and some of which are lists of complex objects:
|Simple Property||Complex Object||List of Complex Objects|
*An encounter may also include an <ActionCode> directing HealthShare Unified Care Record to take an action. Possible values include:
D = Delete
E = Delete if Empty
C = Clear All
R = Replace
See the class reference for specific details of the <ActionCodes> for an encounter.
For More Information on SDA Classes
To access the class reference for the SDA classes:
Either click on the “Class Reference” link in the HealthShare cube, or navigate to host:port/csp/documatic/%25CSP.Documatic.cls, where host is the name of the machine on which your installation is running, and port is the web server port. For example, http://localhost:57772/csp/documatic/%25CSP.Documatic.cls.
Log in, if required.
Using the drop-down list at the top of the left-hand pane, change to the HSLIB namespace.
Clear the Percent Classes check box to reduce visual clutter.
You may also view the XML document structure for any SDA class:
In the Management Portal, select an Edge Gateway namespace and navigate to Home > Interoperability > Interoperate > XML > XML Schema Structures.
In the HS.SDA3 schema, select the name of the class whose structure you want to view.
To navigate through the HS.SDA3 XML schema, you may find it easiest to select Container, and then drill down from there.
The “CDA and SDA Annotations” feature provides an alternate view into the SDA class structure.
Creating an SDA Stream from SDA Objects
This section describes a methodology that will accommodate an SDA of any size. Rather than instantiate an entire patient record as an SDA object (which in the context of HealthShare Unified Care Record may contain thousands of encounters), the approach described here instantiates only the individual sections, and then constructs the SDA stream manually. If you are certain that your SDA is small, then you can instantiate the entire SDA as an object and write the stream directly.
If you have a set of SDA objects and you wish to combine them to produce an SDA stream, use the following methodology:
Instantiate a new stream.
Write the <Container> opening tag to the stream.
For the Patient object, which must come first, use the ToQuickXML() method of the SDA object to write the object to the stream as XML.
For subsequent objects, which should be grouped by type (Encounter, LabOrder etc.), use the StartXMLList() method of the SDA object to write the opening tag for the collection, for example, <Encounters>. Remember that <Encounters>, if included, must come directly after <Patient>.
Use the ToQuickXML() method to write each object of that type to the stream.
When finished with a collection of a particular type, use the EndXMLList() method to write the closing tag for the collection.
Repeat for other collections.
When finished, write the </Container> closing tag.