Configuring EMS to work with Exchange Online (Office 365) or Exchange 2013 is the same as configuring EMS to work with a 2007/2010 Exchange environment that is hosted on your network. See this page for setting up impersonation on Exchange Online (Office 365). If you need additional assistance setting this up please contact email@example.com.
- After following the installation instructions, access the Integration with Exchange configuration area by opening a browser and entering the following:
(replace [ServerName] with the name of your web server)
- Go the Account Info tab.
- Select your email system in the Provider dropdown using the instructions provided on the page.
- Check the box “.. utilize AutoDiscover to locate the best Client Access Server for the user…”
Note: If you do not check this box, you must fill in the Url to Exchange Web Services field.
- Within the Authentication Information section, enter your Integration with Exchange Account User Name and Password. The User Name should be prefixed with your domain (example – YourDomain\Integration with Exchange Account, or Integration with Exchange Account@YourDomain)
Tip: Make a note of this URL for use later in this topic.
- (Optional) The “Use application pool identity…” option allows you to set the Integration with Exchange Account credentials at the Application Pool level instead of storing the credentials in the EMS database. See the Additional Information section for more information about this option. If this option is selected, you must check the box to use Impersonation.
- If you selected “Exchange Web Services” as your Provider, select the checkbox if the account specified has Exchange Impersonation access to all mailboxes in your Exchange mailbox store.
- Select the Authentication Type:
- Anonymous – No authentication
- Specify Account – Relies on a custom account (not the Integration with Exchange Account) that you create and manage. Please contact Customer Support (or a member of the Professional Services group if you are working with one) to discuss the configuration process for this option.
- Default Credentials – Relies on security context of EMS application calling the Integration with Exchange Web Service. If using this option, Integrated Windows Authentication should be enabled for the Integration with Exchange Web Service.
- For MS Exchange 2007/2010 environments, click Save. Go to Step 1
Note: When testing Integration with Exchange, the email account that is being used (either on the Test Settings tab or in the "Testing Integration with Exchange" section below) MUST exist in the Exchange environment being tested. If you are testing Integration with Exchange in a development environment please verify that a mailbox for the email being used exists in that domain/environment.
- Click Test Configuration. If any errors are encountered, please verify your configuration. Otherwise, your Integration with Exchange configuration is complete.
In order to test your configuration, you will need to log into EMS Web App with a user account (configured with the user’s primary email address) belonging to a Everyday Application Process Template (within the EMS client application) that has the Enable Integration to Microsoft Exchange option checked.
- Log into EMS Web App. Begin making a reservation and selecting a room.
- Select the Add to my calendar checkbox. If this option is not available, please verify (within the EMS client application) that your user account belongs to a Everyday User Process Template that has the Allow Invitations option checked.
- Find and add an attendee using the Find Attendee field.
- Complete necessary information on the Details tab and click Submit Reservation.
- Verify that an appointment was added to your Outlook Calendar and that your attendee received an invitation.
The options on the Message tab (as reached above in Step 2) below guide you in further configuring your integration.
- Message To Append
Message appended to the bottom of the appointment body. This message is seen by all users.
- To view the details of this reservation click the below link
Message added to the appointment body, above a link that takes a user to a view-only EMS Web App page for the appointment. This message is seen by all users.
- If you are the meeting organizer click the below link to edit the reservation
Message added to the appointment body, above a link that takes the meeting organizer to the EMS Web App Reservation Summary page for that reservation. This message is seen by all users, but only the meeting organizer can access the Reservation Summary page to make changes.
- Allow Attachments
Allows users to add attachments within EMS Web App when making an appointment.
- Maximum Attachment Size
If attachments are allowed, set the maximum file size allowed for an attachment.
Concept: The default installation allows file attachments up to 4MB. If your implementation needs file attachments that are larger, follow the two procedures below:
Note: File sizes larger than 2GB are not allowed at this time.
By default, Exchange Integration attachments will only accept files 4MB or less. If your implementation needs to allow files of larger sizes to be attached to reservations, the following config updates will be required, both in EMS Web App and in the Exchange Integration Web Service.
Important: The maximum file size is 2GB.
- In the <system.webServer> section, include this xml node:
<requestLimits maxAllowedContentLength="51200000"/> <!--maxAllowedContentLength in bytes, 50MB=51200000-->
- In the <httpRuntime element, add these highlighted attributes with the end result looking like this:
<httpRuntime targetFramework="4.5" requestLengthDiskThreshold="2147483644" maxRequestLength="51200" /> <!—-requestLengthDiskThreshold in bytes, & maxRequestLength in KB, 50MB-->
- Under the <appSettings> look for the “MaximumUploadSizeInBytes” key. Update this value to the number of bytes allowed. For instance, 50MB would look like this:
<add key="MaximumUploadSizeInBytes" value="52428800000"/> <!—- in bytes50MB-->
By default Exchange Integration attachments will only accept files 4MB or less. If your implementation needs to allow for Exchange message attachments larger than 4MB, the config updates above will need to be applied in the Exchange Integration Web Service.
Note: Due to the size of the xml sent, we recommend adding 5MB to the desired file upload size. (i.e., if you want to allow a max of 20MB files, calculate a total of 25MB worth of Kilobytes and bytes.
In addition to these web.config settings above, a web administrator will need to update the file size in the Exchange Integration Web Service as follows:
- Navigate to the Exchange Integration Web Service/PAMConfig.aspx
- Click the Message tab
- Update the Maximum Attachment Size text box and Save.
Warning: for Externally Exposed Web App sites
If your EMS Web App site is externally exposed, some of the web.config settings above could make the site vulnerable to DoS site attacks. We highly recommend setting network-level protection to prevent DoS attacks.