Node.js

The Gocodo YourChart Client is available as a Node.js npm package. For access to the source, contact Michael Wasser.

Once installed, the package can be include via

var YourChartClient = require('yourchart')

To create a client, use

var client = new YourChartClient('<Epic MyChart Username>', '<Epic MyChart Password>', '<Epic-specified Organization ID>')

To get an organizations id, you can programatically access an array of all known sites using YourChartClient.sites. Each site will have an orgId which tells the client where to fetch health records from. Each object in the sites array looks like the following example:

{
  serviceUrl: 'https://mychart.swedish.org/MyChartWeb/Wcf/Epic.MyChartMobile/MyChartMobile.svc/',
  name: 'Swedish',
  orgId: '512',
  myChartBranding: 'MyChart',
  myChartUserLabel: 'Username',
  locations: [ 'Washington' ],
  timezone: 'America/Los_Angeles'
}

Once a client is initialized, any of the listed Calls can be used to access patient information. In the node.js client, the names of calls and the properties listed in the resulting Models will be camel-cased versions of themselves. E.g. The call documented as ListPastAppointments becomes listPastAppointments in the node.js client. For each call, the first paramenter will be a hash of both request parameters (key would be the name of the parameter) as well as the request model (key would be requestModel). The second parameter will be a callback with a first parameter communicating error conditions if they exist and null otherwise, and a second parameter with the request’s response model. For example, a call to getAccountDetails may look as follows:

client.getAccountDetails({
  request_model: {
    billingAccountId: "<account id>",
    billingAccountType: <account type>
  }
}, function (err, response) {
  if (err) return console.log('Something bad happened!');

  if (response.isPaperless) {
    console.log("User receives paperless statements!");
  }
});

Calls to authenticate will be automatically made during the first call and its results will be stored in authenticateResponse on the current instance of the client. Manual calls to authenticate will also authorize the client/ store the results for future calls.

Putting it all together:

var YourChartClient = require('yourchart'),
    orgId, client;

// Fetch the orgId of Swedish
orgId = YourChartClient.sites.filter(function (elm) { return elm.name == 'Swedish'; })[0];

// Create a client with a MyChart user's credentials
client = new YourChartClient('<Swedish MyChart username>', '<Swedish MyChart password>', orgId);

// Fetch a list of past appointments
client.listPastAppointments({identifier: 0, index: 0}, function (err, data) {
  if (err) return console.log(err.stack);

  console.log("Past Appointments:");
  console.log("==================");

  // Display results of listing past appointments
  console.dir(data);

  if (typeof data.appointmentList !== undefined && data.appointmentList.length > 0) {
    var appointmentID = data.appointmentList[0].dat;

    // Get details for a specific appointment
    epicClient.getEncounter({identifier: 0, appointment_dat: appointmentID}, function (err, data) {
      if (err) return console.log(err.stack);

      console.log("");
      console.log("First Past Appointment Details:");
      console.log("===============================");

      // Display specific appointment details
      console.dir(data);
    });
  }
});