SYSTEM OBJECTS

LANGUAGES

Each language supported by the Linkcare platform encoded in ISO 639-1 encoding

Currently, the language choices associated with an active session can be retrieved calling session_get_language_list ()

DESCRIPTIONS

Descriptions are strings used by the system as part of the User Interface. They are defined for each of the supported languages.

ROLES

Is the set of roles that may be associated by a user within a program and center.

The predefined system roles are:

Professional roles

#PRO_DOCTOR

#PRO_NURSE

#PRO_PHISIO

#PRO_SOCIAL

#PRO_CONTRACTOR

Management roles

#MNG_CASE

#MNG_ASSIST

#MNG_SUPERV

Administration roles

#ADMIN_SYS

#ADMIN_CTR

#ADMIN_LIB

Case role

#CASE

CODES

The system CODES are encoding standard values that can be used for disease description. Linkcare currently support three kind of code sets:

Languages

A table of languages in ISO 639-1 encoding

Countries

A table oc country codes in ISO-3166 encoding

Locales

The locales table is a coding system defining the languages and language variants for each country. A locale code is composed of two arguments separated by an hyphen.

The first argument is a valid Language Code. These codes are the lower-case two-letter codes as defined by ISO-639-1. You can find a full list of these codes at a number of sites like here.

The second argument to both constructors is a valid ISO Country Code. These codes are the upper-case two-letter codes as defined by ISO-3166. You can find a full list of these codes at a number of sites like here

ICD - International Classification of Diseases

According to its publisher, the United Nations-sponsored World Health Organization , ICD is "the standard diagnostic tool for epidemiology, health management and clinical purposes."

The ICD code set information can be found at http://www.who.int/classifications/icd/

Currently, Linkcare is ready to support two versions of ICD codes: ICD 9 and ICD 10.

MDC – Major Diagnosis Categories

MDC codes are formed by dividing all possible principal diagnoses (from ICD-9-CM) into 25 mutually exclusive diagnosis areas.

Current MDC set is as follows:

STG - Program Stage Categories

Describe program categories (Enrollment, Discharge, Admission, ...)

STGS - Program Stage Subcategories

Describe task categories Enrollment (Clinical Record Review, Clinical Evaluation,... )

TSK - Task Categories

Describe task categories (Revision, Visit, Home, Tele, Patient, Group )

FORM_CODE - Form Code

Describe form codes ( SF36,...)

SYSTEM FORM_CODES

Are predefined system form templates:

#NOTE

Is a form containing a NOTE text edit data field. The #NOTES for is automatically associated to most system TASKS that change the admission state

#DIAGNOSES

Is a form composed by an ICD-9 coded main diagnose plus a list of secondary ICD-9 coded diagnoses

#DOCUMENT

Is a form template composed by

doc type (doc type combo)

date (date)

description (text)

remarks (text)

SYSTEM TASKS

System tasks are predefined tasks that are not defined by library activities, but associated to certain actions related with admission status workflow. To retrieve a choice list of available system tasks, call action_list () passing the “MNGR” (Case Manager) as the action type.

The tasks available to call will depend on the admission status:

If no admission is passed, a #XENROLL task is the only choice, and will show a list or PROGRAMS

If the admission is in PRE-ADMISSION status, #XJOIN task is the only choice and will show a list of PROTOCOLS, plus a “NEW PROTOCOL” option and a “#XREJECT” task.

If the admission status is ACTIVE, a choice of #REPORT, #XDISCHARGE, #XREJECT or #XPAUSE system tasks are returned.

If the admission status is PAUSED, a choice of #RESUME or #XREJECT system tasks are returned

“#XENROLL:PROGRAM”

Is a task to insert a new admission related by a case. After inserting a ENROLL task a new admission is inserted related by the active CENTER, into the referenced PROGRAM by calling admission_insert (),a call to task_insert () passing #XENROLL will add an ENROLL task including all PROGRAM associated forms, plus a #DIAGNOSES system form. When all ENROLL forms associated with the program are closed, the admission date is set and the admission status is set to PRE-ADMISSION.

“#XJOIN:PROTOCOL”

Is a task to associate an admission to a protocol. A list of protocols choices can be obtained by calling action_list (). The calling admission_join () the admission is associated to the selected PROTOCOL. Then, calling task_insert () passing #XJOIN will include the forms associated with the protocol plus the ADMISSION CHECK LIST. When all JOIN forms are closed, the tasks defined for the protocol are inserted into the admission ready to be programed. The admission status is set to ACTIVE.

If no protocol is passed together with the #XJOIN task, an empty PRIVATE protocol is created.

Admission tasks to be added to the protocol can be selected by calling action_list () passing a “CASE”, “CALL”, “TELE”, “CARE”, “MSG” task category.

“#XDISCHARGE”

Is a task that to discharge an admission. Calling task_insert() passing #XDISCHAGE inserts a DISCHARGE task with the associated DISCHARGE REPORT and the DISCHARGE CHECK LIST. When all DISCHARGE forms are closed the admission discharge date is set and the admission status changes to “DISCHARGED”.

“#XREJECT”

Is a task to reject an admission. A #XREJECT task can be inserted by calling task_insert () passing #XREJECT. A REJECT task is also automatically generated when a REJECT field type in a form is set to TRUE and the form is closed.

A REJECT task always includes a #NOTES system form to add comments to the rejection. After the rejection form is closed the admission status changes to REJECTED.

“#XPAUSE”

Is a task to pause an admission. A #XPAUSE task can be inserted by calling task_insert () passing #XPAUSE.

A PAUSE task always includes a #NOTES system form to add comments to the pause. After the pause form is closed the admission status changes to PAUSED, and all uncompleted tasks are also paused.

“#XRESUME”

Is a task to resume a paused admission. A #XRESUME task can be inserted by calling task_insert () passing #XRESUME.

A RESUME task always includes a #NOTES system form to add comments to the pause. After the resume form is closed the admission status changes to ACTIVE, and all paused tasks must be rescheduled.

“#XREPORT”

Is a task to create an admission’s follow up report using the protocol’s or program’s report template. A #XREPORT task can be inserted by calling task_insert () passing #XREPORT.