CCL Scripts
Your Clinical Office:MPage Edition license includes a number of required and optional CCL scripts. To simplify installation, all CCL scripts that do not require prompt builder functionality have been combined into a single CCL script called 1co_mpage.prg. Other CCL scripts not included in 1co_mpage.prg have been provided in your Clinical Office:MPage Edition distribution as stand-alone CCL scripts to be imported into your domain with Discern Visual Developer.
Clinical Office:MPage Edition has been designed to support multiple concurrent versions on the same domain. The goal is to allow you the ability to upgrade your individual MPages as time permits (or not at all if new functionality is not needed). To accomplish this, if a version of a CCL script changes enough to negatively affect previous versions of Clinical Office, a new version of the CCL script is created with a version number in the filename. For example, with the initial release of version 3 of Clinical Office, The PersonService CCL script, 1co_mpage_person was replaced with 1co3_mpage_person. The original 1co_mpage_person script still exist however it will only be used by versions of Clinical Office older than version 3.
All CCL scripts are compiled at GROUP1 level to ensure that all clients have the access to compile the source code. For the purpose of Clinical Office scripts, GROUP1 vs. GROUP0 (DBA) provides no functional difference.
Stand-Alone CCL Scripts
The following scripts are not part of 1co_mpage.prg.
| Script Name | Purpose |
|---|---|
| 1co_mpage_template.prg | Starter template for creating your own Clinical Office MPage compatible CCL scripts. Detailed instructions are included in the source code as well as in the training materials. |
| 1co_mpage_test.prg | Simple test script for testing Clinical Office payload values in the back-end. |
| 1co_mpage_test_visit.prg | Lets you choose a visit to use when testing your MPage from outside PowerChart. This works if you are testing via the Proxy or through an alternative method such as Discern Visual Developer. * This script will eventually be replaced with functionality directly inside the debugger Activity log component |
| 1co_show_service_dir.prg | This script will reveal the service directory of your Cerner install for the purpose of setting up your Proxy server. |
1co_mpage.prg Content
| Script | Description |
|---|---|
| 1co_convert_blob |
Converts the content of ce_blob results into ASCII text, RTF, PDF or HTML. To use, execute 1co_convert_blob:group1 from within your CCL script. This will generate the following record structure:
record co_blob_events (
1 data[*]
2 event_id = f8
2 original_format_cd = f8
2 original_text = vc
2 converted_text = vc
)
Size co_blob_events and populate the event_id values before calling the convert_blob(format) subroutine. Valid values for format are "AS", "PDF", "RTF" and "HTML". Other than AS (ASCII text) conversion, all other formats will be hex encoded for transport to your MPage. Once converted, the co_blob_events structure will contain both the original_text and converted_text values. |
| 1co_get_patient_list |
Populates a Clinical Office patient_source structure with visits in a Cerner patient list. Execute 1co_get_patient_list:group1 from your CCL script with a valid patient list id as the first parameter. e.g. execute 1co_get_patient_list:group1 '12312312' |
| 1co_mpage_allergy | Allergy Service CCL script. |
| 1co_mpage_apo | Address/Phone/Organization (APO) Service CCL script. |
| 1co_mpage_census_list | Encounter Service loadList script to collect visits by patient census. |
| 1co_mpage_cvlookup | Code Value Service CCL script. |
| 1co_mpage_diagnosis | Diagnosis Service CCL script. |
| 1co_mpage_dm_info | DMInfo Details Custom Service CCL script. |
| 1co_mpage_enc_list | Encounter Service loadList script to collect visits by date range. |
| 1co_mpage_encounter | Encounter Service CCL script. |
|
1co3_mpage_entry Replaces 1co_mpage_entry |
Primary CCL script that handles all Clinical Office:MPage Edition communication and script management. |
|
1co3_mpage_person Replaces 1co_mpage_person |
Person Service CCL script. |
| 1co_mpage_problem | Problem Service CCL script. |
| 1co_mpage_redirect | PrefMaint script name responsible for redirecting to the correct location of your MPage code. |