oracle.hsgbu.hdr.hl7.rim

Interface LanguageCommunication

All Superinterfaces:

InfrastructureRoot, Serializable

public interface LanguageCommunication
extends InfrastructureRoot

The language communication capabilities for an Entity.

Examples: A patient who originally came from Mexico may have fluent language capabilities to speak, read and write in Spanish, but only rudimentary capabilities in English. A person from Russia may have the capability to communicate equally well in spoken language in Russian, Armenian or Ukrainian, but prefers to speak in Armenian.

Discussion: While it may seem on the surface that this class would be restricted in usage to only the LivingSubject subtypes, Devices also have the ability to communicate, such as automated telephony devices that transmit patient information to live operators on a triage line or provide automated laboratory results to clinicians.

Rationale: Each Entity with the ability to communicate verbally has differing language and proficiency level. This class specifies the languages with which the entity can communicate, the mode of communication (speak, read, write), the proficiency of that communication, and the Entity's preference.

See Also:

Entity

Summary

Method Summary

Modifier and Type	Method and Description
CE	getLanguageCode() A value representing a language for which the Entity has some level of proficiency for written or spoken communication.
CE	getModeCode() A value representing the method of expression of the language.
BL	getPreferenceInd() An indicator specifying whether or not the language is preferred by the entity for the associated mode.
CE	getProficiencyLevelCode() A value representing the level of proficiency in a language.
void	setLanguageCode(CE code)
void	setModeCode(CE code)
void	setPreferenceInd(BL preferenceInd)
void	setProficiencyLevelCode(CE code)

Methods inherited from interface oracle.hsgbu.hdr.hl7.rim.InfrastructureRoot

getControlAct, getToken, setToken

Method Detail

getLanguageCode

CE getLanguageCode()

A value representing a language for which the Entity has some level of proficiency for written or spoken communication.

Examples: Spanish, Italian, German, English, American Sign, etc.

Discussion: Communication via spoken or written language is not solely restricted to LivingSubjects. Devices that communicate with persons using human language also must specify in which languages they are capable. Automated voice response systems respond to human language and communicate with other devices or persons using human language.

Rationale: Many individuals and devices have the capability to communicate at varying levels in multiple languages. This code specifies a language capability that the entity wishes to make known.

See Also:

Entity

setLanguageCode

void setLanguageCode(CE code)
              throws HDRRimException

Throws:

HDRRimException

getModeCode

CE getModeCode()

A value representing the method of expression of the language.

Examples: expressed spoken, expressed written, expressed signed, received spoken, received written, received signed

setModeCode

void setModeCode(CE code)
          throws HDRRimException

Throws:

HDRRimException

Membership code to be used:

CL_LANGCOM_MODE_CODE

getProficiencyLevelCode

CE getProficiencyLevelCode()

A value representing the level of proficiency in a language.

Examples: excellent, good, fair, poor

setProficiencyLevelCode

void setProficiencyLevelCode(CE code)
                      throws HDRRimException

Throws:

HDRRimException

Membership code to be used:

CL_LANGCOM_PROFICIENCY_LEVEL_CODE

getPreferenceInd

BL getPreferenceInd()

An indicator specifying whether or not the language is preferred by the entity for the associated mode.

setPreferenceInd

void setPreferenceInd(BL preferenceInd)
               throws HDRRimException

Throws:

HDRRimException