fluent-cerner-js

A modern API for interacting with MPages in the Cerner Millennium application which have access to the Discern Native functions and COM objects. Modern Typescript wrapper functions were created without thoughtfullness to enhance the productivity of software engineers tasked with building out MPage solutions. This software is in it's alpha stage and should be used with caution. Additionally, it doesn't cover a full set of the Cerner Millennium application's functionality. It is a work in progress.

Environment	CI	Publish
Production
Development		Not Applicable

Contributors

If you'd like to become a contributor, please contact the primary author.

• Travis Nesbit, MD (geekmdtravis) - Primary Author
• Daniel "Danny" Lara, MD (dl2github)

API In Action

Place Orders

Placing orders through the MPAGES_EVENT fuction with the ORDERS directive, simplified. Just provided the patient ID, encounter ID, and an array of orders.

const orders: Order[] = [
  { action: 'new order', id: 32461245 },
  { action: 'new order', id: 12341243 },
];
const { eventString } = await submitOrdersAsync(91294, 123424, orders);

Make a CCL Query

Make a requestion for a JSON object from a CCL end-point. Just pass the CCL program name (often referenced as the URL) and the parameters as an array of either strings or numbers.

const {
  data,
  status,
  result,
} = await makeCclRequestAsync('1_GET_VITALS_DT_RNG', [
  391414,
  1234124,
  '2022-01-01',
  '2022-12-31',
]);

Note: This project exposes the function makeCclRequestAsync through easy-ccl-request and is a peer dependency. This function is used to make AJAX calls to CCL end-points. If you choose to use this function, you will need to install the peer dependency. This decision was made since makeCclRequestAsync is being leveraged in a number of different packages and I wanted to offer it as a stand-alone package without bringing in the entire fluent-cerner-js package, which itself is dependent on a limited set of dependencies. Please see the package.json file for the current version of easy-ccl-request to see the supported versions.

Open a Chart Level Tab

Open a tab at the chart level. Just provide the patient ID, encounter ID, and the tab name.

await openPatientTabAsync(12341, 197777, 'Orders');

More

There are many more funcionalties listed below.

Utility Map

Discern	fluent-cerner-js	Description
APPLINK	openApplicationAsync	Opens a file, URL, executable, shell executable, or application object
	↳ openOrganizerTabAsync	Opens a tab at the organizer level.
	↳ openPatientTabAsync	Opens a tab at the patient level.
	↳ openWebsiteByUrlAsync	Opens a URL in a new window from PowerChart.
CCLEVENT	(no support planned)	Evoke special solution-specific events from within a web page.
CCLLINK	(no support planned)	Link CCL reports within a given MPage.
CCLLINKPOPUP	(no support planned)	Link CCL reports, launch in a new Internet Explorer® pop-up.
CCLNEWSESSIONWINDOW	(will review)	Open a link (a URL) in a new Discern Output Viewer window.
DiscernObjectFactory("CINFOBUTTONLINK")	(will review)	Communicate information between MPages and the Infobutton service.
DiscernObjectFactory("DISCHARGEPROCESS")	launchDischargeProcessAsync	Launch the discharge process module.
DiscernObjectFactory("DYNDOC")	—	Create new Dynamic Documentation notes and modify existing ones.
	↳ createNewDocumentAsync	Create a new document, launching the DYNDOC modal.
	↳ addAddendumToDocumentAsync	Add an addendum to an existing document.
DiscernObjectFactory("KIACROSSMAPPING")	(will review)	Map a nomenclature from one nomenclature terminology set to another.
DiscernObjectFactory("ORDERS")	(no support planned)	Launch the MOEW and execute orders-related actions.
DiscernObjectFactory("PATIENTEDUCATION")	launchPatientEducationAsync	Launches patient education.
DiscernObjectFactory("PEXAPPLICATIONSTATUS")	(will review)	Provides a means to decide if a given MPage is in view.
DiscernObjectFactory("PEXSCHEDULINGACTIONS")	manageAppointmentAsync	Launch various Cerner Scheduling functions.
DiscernObjectFactory("PMLISTMAINTENANCE")	(planned)	Launch the patient list maintenance dialog.
DiscernObjectFactory("POWERFORM")	launchPowerFormAsync	Launch a PowerForm.
DiscernObjectFactory("POWERNOTE")	launchPowerNoteAsync	Launch a PowerNote.
DiscernObjectFactory("POWERORDERS")	—	Interact with the PowerOrders MOEW dialog from within an MPage.
	↳ submitPowerOrdersAsync	Submit PowerPlan orders.
DiscernObjectFactory("PREGNANCY")	(planned)	Launch dialogs used for managing an active pregnancy
DiscernObjectFactory("PVCONTXTMPAGE")	getValidEncountersAsync	Gets an array valid encounter ID's for a given patient.
DiscernObjectFactory("PVFRAMEWORKLINK")	(will review)	Communicate infomration ot the Win32 components of PowerChart.
DiscernObjectFactory("PVPATIENTFOCUS")	(planned)	Set and clear a patient's focus within the Powerchart framework.
DiscernObjectFactory("PVPATIENTSEARCHMPAGE")	(planned)	Launch the patient search dialogue.
DiscernObjectFactory("PVVIEWERMPAGE")	(planned)	Launch various result viewers for docs, reminders, and more.
DiscernObjectFactory("TASKDOC")	(planned)	Launch the task documentation dialog or to launch the print labels dialog.
MESSAGING	(planned)	Register, unregister, send, and receive messages between MPages.
MPAGE_EVENT("ALLERGY",...)	(planned)	Allergy conversation will be launched.
MPAGE_EVENT("CLINICALNOTE",...)	launchClinicalNoteAsync	Launch a clinical note.
MPAGE_EVENT("POWERFORM",...)	(will review)	PowerForm conversation will be launched.
MPAGE_EVENT("POWERNOTE",...)	launchClinicalNoteAsync	PowerNote conversation will be launched.
MPAGE_EVENT("ORDERS",...)	submitOrdersAsync	Submits one or more orders to MOEW.
MPAGES_SVC_EVENT	(planned)	Launch the Discern MPages Web Service.
MPAGES_OVERRIDE_REFRESH	(planned)	Change the behavior of the MPage when a refresh event is received.
MPAGES_OVERRIDE_PRINT	(planned)	Change the behavior of the MPage when a print event is received.
Patient List Navigation	(no support planned)	—
↳PCEdgeActivatePatArrows	(no support planned)	Activates the pateint navigation buttons.
↳PCEdgePatNavSetCallback	(no support planned)	Set a handler callback func for when navigation arrows are pressed.
PCUPDATEREFRESHTIME	(no support planned)	Update the refresh button to show how long ago the data was updated.
XMLCclRequest	makeCclRequestAsync	Makes an AJAX call to a CCL end-point.