11. 12. Referral module (newly established module in Version 2.3)
Introduction

The referral module is described as mmlRe:ReferralModule. For easier use, an unstructured, flat form was adopted for the elements included in this module. Since the referral module considers MML as a higher-level standard, the provisions included in the MML specification apply to the referral module as well.

Overview

The referral module specifies a data exchange method for linking hospitals and local clinics, based on letters of referral. Although letters of referral are documents offering clinical information written in Form 6, the form of each referral letter issued by a given medical facility may differ slightly from Form 6. Here, based on Form 6, the minimum data sets for data exchange are defined and presented. The minimum data sets refer to the minimum vocabularies used for definitions for letters of referral in the newly established module in MML. When a letter of referral is actually written, for example, the patient information module already defined in MML is used for patient information. More specifically, an element group defined by the mmlPi:PatientModule is used for patient information such as name, birth date/year, address, and telephone number, etc.

Data such as images, test results, and prescriptions that may be attached to letters of referral are already classified by the mmlCm:medicalRole in the MML common format, the external reference format. For these data, it is recommended that external files viewed from the MML instance be referred to, similarly using the mmlCm:extRef element of the external reference format. On the other hand, it is possible to standardize the mmlRe:testResults with XML by using the test history information module. Furthermore, as for prescriptions, it is possible to describe the mmlRe:medication in a different CLAIM module, which is a data exchange method for linking electronic medical charts and clinical accounting systems. Using this module also makes it possible to standardize the element with XML.

Similarly, for the creator of a letter of referral, the mmlCi:CreatorInfo in the MML common format (Creator information format) is used to match the creator information in the referral module instance with the actual creator of the letter. The mmlPsi:PersonalizedInfo in the MML common format (Personal information format) is used for the medical institution and department of the doctor who creates the letter of referral.

Namespace declaration

Namespace declaration of this module is as follows.

xmlns:mmlRe="http://www.medxml.net/MML/ContentModule/Referral/1.0"

Specification of the document header information (docInfo) specific to this module

docInfo

The "referral" value from table MML0005 is specified in the contentModuleType attribute.

title

A title that indicates the content of the referral letter should be entered.

For the generationPurpose attribute, the "consult" value from table MML0007 must be specified.

confirmDate

This is the referral module creation date.

mmlCi:CreatorInfo

The document creator in the referral module is the writer of a letter of referral. The persons who introduces the patient (mmlRe:referFrom) and writes the letter (mmlCi:CreatorInfo) may not be the same due to the use of a substitute writer, for instance.

extRefs

The mmlCm:extRef element in the referral module is described. The element should be repeated only the same number of times as the number of external link information items.

content

Only a single referral module should be entered in a single content.

Element list

 

Element

Attribute

Data type

Occurrence

Table

1

mmlRe:ReferralModule

 

 

 

 

1.1.

mmlPi:PatientModule

 

 

 

 

1.2.

mmlRe:occupation

 

string

?

 

1.3.

mmlRe:referFrom

 

 

 

 

1.3.1

mmlPsi:PersonalizedInfo

 

 

 

 

1.4.

mmlRe:title

 

string

 

 

1.5.

mmlRe:greeting

 

string

?

 

1.6.

mmlRe:chiefComplaints

 

string

 

 

1.7.

mmlRe:clinicalDiagnosis

 

string

?

 

1.8.

mmlRe:pastHistory

 

string

?

 

1.8.1.

mmlCm:extRef

 

 

*

 

1.9.

mmlRe:familyHistory

 

string

?

 

1.9.1.

mmlCm:extRef

 

 

*

 

1.10.

mmlRe:presentIllness

 

string

 

 

1.10.1.

mmlCm:extRef

 

 

*

 

1.11.

mmlRe:testResults

 

string

?

 

1.11.1.

mmlCm:extRef

 

 

*

 

1.12.

mmlSm:clinicalCourse

 

 

?

 

1.13.

mmlRe:medication

 

string

?

 

1.13.1.

mmlCm:extRef

 

 

*

 

1.14.

mmlRe:referPurpose

 

string

 

 

1.15.

mmlRe:remarks

 

string

?

 

1.15.1.

mmlCm:extRef

 

 

*

 

1.16.

mmlRe:referToFacility

 

 

 

 

1.16.1.

mmlFc:Facility

 

 

 

 

1.16.2.

mmlDp:Department

 

 

?

 

1.17.

mmlRe:referToPerson

 

 

?

 

1.17.1.

mmlPsi:PersonalizedInfo

 

 

 

 

1.18.

mmlRe:referToUnknownName

 

string

?

 

Occurrence; blank: 1 appearance without fail, ?: 0 or 1 appearance, +: 1 or more appearances, *: 0 or more appearances

#REQUIRED: Required attribute, #IMPLIED: Omissible attribute

Element explanation

1.mmlRe:ReferralModule

Description: referral module. A single act of a creation of a referral letter by a single doctor is described in a single module.

Omission: not allowed

1.1.mmlPi:PatientModule

Description: patient information, such as name, birth date/year, address, and telephone number. Refer to the MML module (Patient information module) for the structure.

Omission: not allowed

1.2.mmlRe:occupation

Description: occupation

Omission: allowed

Document layout: use of XHTML is allowed.

1.3. mmlRe:referFrom

Description: parent element for the input of information on a person who introduces a patient.

Omission: not allowed

1.3. 1. mmlPsi:PersonalizedInfo

Description: person who introduces a patient. Refer to the mmlPsi:PersonalizedInfo in the MML common format (Personal information format) for the structure.

Omission: not allowed

1.4. mmlRe:title

Description: title of a letter, such as letters of referral, clinical information offering forms, etc. This element has been set up on the assumption of test request forms in future.

Omission: not allowed

1.5. mmlRe:greeting

Description: greetings

Omission: allowed

Document layout: use of XHTML is allowed.

Example:

<mmlRe:greeting>

Dear Doctor: Thank you for the professional medical care services that you provide to patients.<xhtml:br/>

At this time, I would like to refer the following patient to you.<xhtml:br/>

I sincerely appreciate your taking time from your busy schedule to examine this patient.

</mmlRe:greeting>

 

1.6.mmlRe:chiefComplaints

Description: chief complaint

Omission: not allowed

Document layout: use of XHTML is allowed.

1.7.mmlRe:clinicalDiagnosis

Description: diagnosis. Within this element, diagnoses are written in an unstructured form using XHTML. If a structured diagnosis is required, a diagnosis record information module is created separately and linked with the referral module by the groupId.

Omission: allowed

Document layout: use of XHTML is allowed.

1.8.mmlRe:pastHistory

Description: past history. This can be present together with text data (#PCDATA) and the mmlCm:extRef.

Omission: allowed

Document layout: use of XHTML is allowed.

1.8.1.mmlCm:extRef

Description: external reference. When a figure or graph is attached, the MML common format (External reference format) is used.

Repetition: allowed. If multiple external references are available, the element should be repeated the number of times.

1.9.mmlRe:familyHistory

Description: family history. This can be present together with text data (#PCDATA) and the mmlCm:extRef.

Omission: allowed

Document layout: use of XHTML is allowed.

1.9.1.mmlCm:extRef

Description: external reference. When a figure or table is attached, the MML common format (External reference format) is used.

Repetition: allowed. If multiple external references are available, the element should be repeated the number of times.

1.10. mmlRe:presentIllness

Description: progress of condition. This can be present together with text data (#PCDATA) and the mmlCm:extRef.

Omission: not allowed

Document layout: use of XHTML is allowed.

1.10.1.mmlCm:extRef

Description: external reference. When a figure or table is attached, the MML common format (External reference format) is used.

Repetition: allowed. If multiple external references are available, the element should be repeated the number of times.

1.11.mmlRe:testResults

Description: test result. This can be present together with text data (#PCDATA) and the mmlCm:extRef.

Omission: allowed

Document layout: use of XHTML is allowed.

1.11.1.mmlCm:extRef

Description: external reference. When a figure, graph, or table is attached, the MML common format (External reference format) is used.

Repetition: allowed. If multiple external references are available, the element should be repeated the number of times.

1.12. mmlSm:clinicalCourse

Description: progress of treatment. Refer to the mmlSm:clinicalCourse of the MML module (Clinical summary information module) for the structure.

Omission: allowed

1.13.mmlRe:medication

Description: current prescription. This can be present together with text data (#PCDATA) and the mmlCm:extRef.

Omission: allowed

Document layout: use of XHTML is allowed.

1.13.1.mmlCm:extRef

Description: external reference. When a figure, file, or table is attached, the MML common format (External reference format) is used.

Repetition: allowed. If multiple external references are available, the element should be repeated the number of times.

1.14.mmlRe:referPurpose

Description: purpose of referral

Omission: not allowed

Document layout: use of XHTML is allowed.

1.15. mmlRe:remarks

Description: remarks. This can be present together with text data (#PCDATA) and the mmlCm:extRef.

Omission: allowed

Document layout: use of XHTML is allowed.

1.15.1.mmlCm:extRef

Description: external reference. When a figure, file, or table is attached, the MML common format (External reference format) is used.

Repetition: allowed. If multiple external references are available, the element should be repeated the number of times.

1.16.mmlRe:referToFacility

Description: consulted medical institution name. A parent element for the input of facility information.

Omission: not allowed

1.16.1. mmlFc:Facility

Description: consulted medical institution. Refer to the mmlFc:Facility in the MML common format (Facility information format) for the structure.

Omission: not allowed

1.16.2. mmlDp:Department

Description: consulted medical department. Refer to the mmlDp:Department in the MML common format (Medical department information format) for the structure.

Omission: allowed

1.17.mmlRe:referToPerson

Description: consulted doctor's name. A parent element for the input of name information.

Omission: allowed

1.17.1. mmlPsi:PersonalizedInfo

Description: consulted doctor. Refer to the mmlPsi:PersonalizedInfo in the MML common format (Personal information format) for the structure.

1.18. mmlRe:referToUnknownName

Description: unspecified consulted doctor

Omission: allowed


© 2003. All rights reserved