node-ews

A simple JSON wrapper for the Exchange Web Services (EWS) SOAP API

npm install node-ews

Updates in version 2.0.x

• Removed xml2js dependancy and using XML parser built into soap library
• Removed async dependancy and library now returns promises
• Changed constructor setup
• Added optional "options" to constructor that is passed to soap library
• Host config now allows specifying http or https urls
• Replaced customized ntlm library with httpntlm

About

A extension of node-soap with httpntlm to make queries to Microsoft's Exchange Web Service API work.

Features:

• Assumes NTLM Authentication over HTTPs
• Connects to configured EWS Host and downloads it's wsdl file so it might be concluded that this is "fairly" version agnostic
• After downloading the wsdl file, the wrapper dynamically exposes all EWS SOAP functions
• Attempts to standardize Microsoft's wsdl by modifying the file to include missing service name, port, and bindings
• This DOES NOT work with anything Microsoft Documents as using the EWS Managed API.

Example 1: Get Exchange Distribution List Members Using ExpandDL

https://msdn.microsoft.com/EN-US/library/office/aa564755.aspx

var EWS = require('node-ews');

// exchange server connection info
var username = '[email protected]';
var password = 'mypassword';
var host = 'https://ews.domain.com';

// disable ssl verification
var options = {
//  rejectUnauthorized: false,
//  strictSSL: false
};

// initialize node-ews
var ews = new EWS(username, password, host, options);

// define a ews query on Public Distribution List by email
var ewsFunction = 'ExpandDL';
var ewsArgs = {
  'Mailbox': {
    'EmailAddress':'[email protected]'
  }
};

// query ews, print resulting JSON to console
ews.run(ewsFunction, ewsArgs)
  .then(result => {
    console.log(JSON.stringify(result));
  })
  .catch(err => {
    console.log(err.message);
  });

Example 2: Setting OOO Using SetUserOofSettings

https://msdn.microsoft.com/en-us/library/office/aa580294.aspx

var EWS = require('node-ews');

// exchange server connection info
var username = '[email protected]';
var password = 'mypassword';
var host = 'https://ews.domain.com';

var options = {
  // rejectUnauthorized: false,
  // strictSSL: false
};

// initialize node-ews
var ews = new EWS(username, password, host, options);

var ewsFunction = 'SetUserOofSettings';
var ewsArgs = {
  'Mailbox': {
    'Address':'[email protected]'
  },
  'UserOofSettings': {
    'OofState':'Enabled',
    'ExternalAudience':'All',
    'Duration': {
      'StartTime':'2016-08-22T00:00:00',
      'EndTime':'2016-08-23T00:00:00'
    },
    'InternalReply': {
      'Message':'I am out of office.  This is my internal reply.'
    },
    'ExternalReply': {
      'Message':'I am out of office. This is my external reply.'
    }
  }
};

// query ews, print resulting JSON to console
ews.run(ewsFunction, ewsArgs)
  .then(result => {
    console.log(JSON.stringify(result));
  })
  .catch(err => {
    console.log(err.stack);
  });