{"id":219,"date":"2018-01-24T18:41:08","date_gmt":"2018-01-24T18:41:08","guid":{"rendered":"http:\/\/servoycomponents.dreamhosters.com\/?p=219"},"modified":"2021-10-13T22:30:29","modified_gmt":"2021-10-13T22:30:29","slug":"exchange-plugin","status":"publish","type":"post","link":"https:\/\/servoycomponents.com\/components\/plugins\/exchange-plugin","title":{"rendered":"Exchange Plugin"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_text_separator title=&#8221;OVERVIEW&#8221; i_icon_fontawesome=&#8221;fa fa-home&#8221; i_color=&#8221;custom&#8221; add_icon=&#8221;true&#8221; el_id=&#8221;overview&#8221; i_custom_color=&#8221;#126790&#8243;][vc_column_text]The Exchange Plugin for Servoy makes it possible to integrate\u00a0<strong>2-way communication\u00a0<\/strong>with a Microsoft Exchange Server\u00ae.<\/p>\n<p>When you or your (Corporate) client uses Microsoft Exchange\u00ae as a solution for\u00a0<strong>Calendaring\u00a0<\/strong>,\u00a0<strong>E-mail\u00a0<\/strong>etc. the Exchange Plugin is your friend.<br \/>\nYou can realize the benefits of improved operational integration and corporate transparency at a sustainable cost.<\/p>\n<p>The Plugin enables you to work with:<\/p>\n<ul class=\"square\">\n<li><strong>Appointments<\/strong><\/li>\n<li><strong>Meetings<\/strong><\/li>\n<li><strong>E-Mail<\/strong><\/li>\n<li><strong>Tasks<\/strong><\/li>\n<li><strong>Contacts<\/strong><\/li>\n<li><strong>Public Contacts<\/strong><\/li>\n<li><strong>Create folders<\/strong><\/li>\n<\/ul>\n<p>[\/vc_column_text][vc_column_text css=&#8221;.vc_custom_1516819078033{border-left-width: 2px !important;padding-left: 10px !important;border-left-color: #1e73be !important;border-left-style: solid !important;border-radius: 1px !important;}&#8221;]The Exchange Plugin is based on the Java Exchange Connector (JEC) libraries by\u00a0<a href=\"http:\/\/www.javaexchangeconnector.com\/\" target=\"_blank\" rel=\"external noopener\">NetComps LTD\u00a0<\/a>.<\/p>\n<p>The JEC libraries support MS Exchange 2000, 2003 (see FAQ for more details).<\/p>\n<p>The ExchangeWS Plugin supports MS Exchange 2007, 2010 and 2013 and is based on the Exchange Web Services (EWSJ) libraries by\u00a0<a href=\"http:\/\/www.javaexchangeconnector.com\/\" target=\"_blank\" rel=\"external noopener\">NetComps LTD\u00a0<\/a>.[\/vc_column_text][vc_text_separator title=&#8221;BENEFITS&#8221; i_icon_fontawesome=&#8221;fa fa-lightbulb-o&#8221; i_color=&#8221;custom&#8221; add_icon=&#8221;true&#8221; el_id=&#8221;benefits&#8221; i_custom_color=&#8221;#126790&#8243;][vc_column_text]When your (clients) business communication relies on Microsoft Exchange Server\u00ae and you need access to that information the Exchange Plugin will disclose &#8216;the Microsoft Exchange world&#8217; for your solution.[\/vc_column_text][vc_text_separator title=&#8221;COMPATIBILITY&#8221; i_icon_fontawesome=&#8221;fa fa-chain-broken&#8221; i_color=&#8221;custom&#8221; add_icon=&#8221;true&#8221; el_id=&#8221;compatibility&#8221; i_custom_color=&#8221;#126790&#8243;][vc_column_text]<\/p>\n<div>\n<div id=\"compatibility\" class=\"section scrollspy\">\n<div class=\"content\">\n<table class=\"compatibilityt\">\n<thead>\n<tr>\n<th><img loading=\"lazy\" decoding=\"async\" src=\"\/wp-content\/uploads\/2018\/01\/servoy.gif\" width=\"16\" height=\"16\" \/><\/th>\n<th><img loading=\"lazy\" decoding=\"async\" src=\"\/wp-content\/uploads\/2018\/01\/javavm.gif\" width=\"16\" height=\"16\" \/><\/th>\n<th>Smart client<\/th>\n<th>Headless client<\/th>\n<th>Web client<\/th>\n<th>Mobile client<\/th>\n<th>NG client<\/th>\n<th id=\"mac\"><\/th>\n<th id=\"windows\"><\/th>\n<th id=\"linux\"><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>8.0+<\/td>\n<td>1.6+<\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<td>&#8211;<\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<\/tr>\n<tr>\n<td>7.0+<\/td>\n<td>1.6+<\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<td>&#8211;<\/td>\n<td>n\/a<\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<\/tr>\n<tr>\n<td>6.1+<\/td>\n<td>1.6+<\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<td>n\/a<\/td>\n<td>n\/a<\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<td class=\"compat_check\"><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n<\/div>\n<p>[\/vc_column_text][vc_text_separator title=&#8221;DOCUMENTATION&#8221; i_icon_fontawesome=&#8221;fa fa-code&#8221; i_color=&#8221;custom&#8221; add_icon=&#8221;true&#8221; el_id=&#8221;documentation&#8221; i_custom_color=&#8221;#126790&#8243;][vc_column_text]We\u00a0<strong>published\u00a0<\/strong>our\u00a0<strong><a href=\"http:\/\/software.servoycomponents.com\/documentation\/exchange\/exchange.html\">API Specifications\u00a0<\/a><\/strong>for the Exchange Plug-in as a future and current reference.<\/p>\n<p>After downloading the Exchange Plug-in using our Components Manager a sample solution {servoy_root}\/solutions\/it2be-examples\/it2be-exchange.servoy is installed.<br \/>\nYou can import the sample solution into Servoy Developer and you will have some (basic) code examples of how to use the Exchange Plug-in.[\/vc_column_text][vc_text_separator title=&#8221;FAQ&#8221; i_icon_fontawesome=&#8221;fa fa-question-circle&#8221; i_color=&#8221;custom&#8221; add_icon=&#8221;true&#8221; el_id=&#8221;faq&#8221; i_custom_color=&#8221;#126790&#8243;][vc_toggle title=&#8221;Where does the license file go for WAR deployments?&#8221; open=&#8221;true&#8221;]For WAR deployments, make sure you are on the latest version of the plugin and install the JEC License file at: ${SERVOY_USER_HOME}\/ServoyComponents\/jeclicense[\/vc_toggle][vc_toggle title=&#8221;How does the Exchange Plugin communicate with Exchange Server?&#8221;]The Exchange Plugin makes use of the JEC and EWSJ libraries of Netcomps LTD.<br \/>\nYou can find more information about the company and its products\u00a0<a href=\"http:\/\/www.javaexchangeconnector.com\/\" target=\"_blank\" rel=\"external noopener\">here\u00a0<\/a>.[\/vc_toggle][vc_toggle title=&#8221;What Exchange versions are supported by the Exchange Plugin?&#8221;]The Exchange Plugin supports Exchange Server 2000 and 2003.<br \/>\nThe ExchangeWS Plugin supports exchange 2007, 2010 and 2013.<\/p>\n<p>We recommend the Exchange Plugin for Exchange 2000 and 2003.<br \/>\nWe recommend the ExchangeWS Plugin for 2007, 2010 and 2013.[\/vc_toggle][vc_toggle title=&#8221;What protocol is used by the Exchange Plugin and what is its architecture?&#8221;]The Exchange Plugin is based on the JEC libraries.<\/p>\n<p>JEC Uses WEBDAV\/HTTP to communicate with exchange, which means that the Exchange server OWA (Outlook Web Access) need to be on.<br \/>\nRegarding the Architecture, JEC uses ApacheHTTPClient and a modified version Jakarta Slide to Support Microsoft WEBDAV Exchange API (which is not standard WEBDAV).[\/vc_toggle][vc_toggle title=&#8221;What protocol is used by the ExchangeWS Plugin and what is its architecture?&#8221;]The ExchangeWS Plugin is based on the EWSJ libraries.<\/p>\n<p>EWSJ Uses EWS\/HTTP to communicate with Exchange.<br \/>\nRegarding the Architecture: EWSJ does not rely on any Web Services library, which gives the Plugin much more flexibility when implementing Exchange operations and busting performance.[\/vc_toggle][vc_toggle title=&#8221;Exactly what Exchange types are supported?&#8221;]- Emails are supported (including getting attachments, send with attachments and save draft);<br \/>\n&#8211; Events are fully supported;<br \/>\n&#8211; Contacts Get, Add, Edit, Delete, Filter and Public folders.<br \/>\n&#8211; Tasks are fully supported.<br \/>\n&#8211; i18n for all types is supported.[\/vc_toggle][vc_toggle title=&#8221;Does the Exchange Plugin Support SSL and what authentication schemes are supported?&#8221;]JEC and EWSJ support SSL and also partially support self signed certificates.<br \/>\nBasic, digest, NTLM (Windows Integrated) and FBA authentication schemes are supported.<br \/>\nNTLM v2 is not supported.[\/vc_toggle][vc_toggle title=&#8221;Is there a way to get the exchange ID of an existing item?&#8221;]When you do not know the exchange ID of an existing mail (or any other Exchange Item) you can retrieve a set of items and iterate over them.<br \/>\nYou can validate the property of your choice against the value you have and, when they are the same, you can retrieve the UniqueId or UID.[\/vc_toggle][vc_toggle title=&#8221;What is the ChangeKey (ExchangeWS only)?&#8221;]The ChangeKey is the unique ID used to track items when they need to be changed.<br \/>\nIt is mainly of importance for recurring events.[\/vc_toggle][vc_toggle title=&#8221;What is a Server license?&#8221;]A Server license is a license that allows you to use the Exchange Plugin on only one machine.<\/p>\n<p>It is likely that you or your client will have 2 NICS installed on that machine.<br \/>\nOne for internal use and one for external use.<\/p>\n<p>You are allowed to use one internal and one external ip\/domain per Server license.[\/vc_toggle][vc_toggle title=&#8221;What is the difference between UniqueId and UID (Exchange Plugin only)?&#8221;]The UniqueId can change when the name changes (in some cases but but it is impossible to tell when).<\/p>\n<p>The UID will stay unique.<\/p>\n<p>The UniqueId is what is returned when you save an item.<\/p>\n<p>Currently the UniqueId is used when you want to retrieve a certain item.<\/p>\n<p>A future version of the bean will support doing the same using the UID.<br \/>\nThe reason that they are both used is that with recurring events the UID is always the same. For that a UniqueId is used.[\/vc_toggle][vc_toggle title=&#8221;Am I allowed to switch my Server License from our production server to our backup server?&#8221;]Running on 2 servers is not allowed with only one license (see article &#8216;What is a Server license&#8217;).<\/p>\n<p>To run on a second server, or to add a backup server you need an additional Server license.<br \/>\nAll IP addresses and or domain names will be added to one license file to avoid too many issues.[\/vc_toggle][vc_toggle title=&#8221;Is my license valid for the Exchange Plugin as well as the ExchangeWS Plugin&#8221;]Yes, it is, as long as you have a maintenance subscription.<\/p>\n<p>You can use the license with both Plugins but only on the same server(s) that you have the license for.<\/p>\n<p>This does not apply to the JEC and EWSJ libraries.<br \/>\nThere is an upgrade fee for moving from JEC to EWSJ.<br \/>\nYou can go to\u00a0<a href=\"http:\/\/www.javaexchangeconnector.com\/\" target=\"_blank\" rel=\"external noopener\">http:\/\/www.javaexchangeconnector.com\u00a0<\/a>for more information.[\/vc_toggle][vc_toggle title=&#8221;I have a Server license but we moved our server, can I get another license?&#8221;]When you bought one Server license, you are limited to the use of the Exchange Plugin for only one server (see article &#8216;What is a Server license&#8217;).<\/p>\n<p>As a result, you can not simply move the server license to another domain name or IP address.<br \/>\nYou need to buy a new license from our shop.<\/p>\n<p>When you move your server frequently or when you need a solution for more than one client we can make you an offer for a &#8216;Site license&#8217; (unlimited deployment).[\/vc_toggle][vc_toggle title=&#8221;How can I debug the Exchange Plugin&#8221;]When you start to work with the Exchange and\/or ExchangeWS Plugin it is good to have additional information about what you are doing.<br \/>\nOr you need to debug an issue and JEC or IT2BE ask you for additional information.<\/p>\n<p>When this is the case please follow the below instructions for changing the properties file.<\/p>\n<ol class=\"decimal\">\n<li>Close Servoy (very important otherwise your changes will not be used and overwritten).<\/li>\n<li>Locate the &#8216;servoy.properties&#8217; file.<\/li>\n<li>Open the file.<\/li>\n<li>Move to the lines that start with &#8216;log4j.&#8217;.<\/li>\n<li>Insert the following below lines:<br \/>\nlog4j.logger.com.it2be=DEBUG<br \/>\nlog4j.rootLogger=WARN<br \/>\nlog4j.category.jec.utils.AppLogger=DEBUG, stdout<br \/>\nlog4j.logger.httpclient.wire=DEBUG<br \/>\nlog4j.logger.jec.httpclient3=DEBUG<\/li>\n<li>Change the line &#8216;log4j.debug=false&#8217; into &#8216;log4j.debug=true&#8217;.<\/li>\n<li>Restart Servoy<\/li>\n<\/ol>\n<p>This should give you much more output in the log file than you had before.<br \/>\nDon&#8217;t forget to at least change back &#8216;log4j.debug=true&#8217; into &#8216;log4j.debug=false&#8217; or you will have too much logging output.[\/vc_toggle][vc_toggle title=&#8221;I cannot use the Component with Servoy Developer or an Application Server.&#8221;]Open the Servoy Administration Website (e.g. localhost:8080\/servoy-admin\/ for a default Servoy Developer installation). Move to &#8216;Servoy Server Home&#8217; -&gt; &#8216;Smart Client Settings&#8217; and add\u00a0<strong>it2be.ExchangeService\u00a0<\/strong>to &#8216;servoy.application_server.trustedRemotePlugins&#8217; (you can use a comma as separator).<br \/>\nThis should allow the Component to work.[\/vc_toggle][vc_text_separator title=&#8221;RELEASE NOTES&#8221; i_icon_fontawesome=&#8221;fa fa-code-fork&#8221; add_icon=&#8221;true&#8221; el_id=&#8221;release_notes&#8221;][vc_tta_tabs][vc_tta_section title=&#8221;Exchange&#8221; tab_id=&#8221;1550611782349-7cb55a40-55cb&#8221;]<pre class=\"mfn-code\">\n<!-- iframe plugin v.5.0 wordpress.org\/plugins\/iframe\/ -->\n<iframe loading=\"lazy\" src=\"https:\/\/servoycomponents.com\/update\/exchange.release.notes\" width=\"100%\" height=\"300\" scrolling=\"yes\" class=\"iframe-class\" frameborder=\"0\"><\/iframe>\n<\/pre>\n[\/vc_tta_section][vc_tta_section title=&#8221;Exchange WS&#8221; tab_id=&#8221;1550611782372-64d21cc1-adc6&#8243;]<pre class=\"mfn-code\">\n<!-- iframe plugin v.5.0 wordpress.org\/plugins\/iframe\/ -->\n<iframe loading=\"lazy\" src=\"https:\/\/servoycomponents.com\/update\/exchange.ws.release.notes\" width=\"100%\" height=\"300\" scrolling=\"yes\" class=\"iframe-class\" frameborder=\"0\"><\/iframe>\n<\/pre>\n[\/vc_tta_section][\/vc_tta_tabs][vc_text_separator title=&#8221;BUY NOW&#8221; i_icon_fontawesome=&#8221;fa fa-credit-card&#8221; i_color=&#8221;custom&#8221; add_icon=&#8221;true&#8221; el_id=&#8221;buynow&#8221; i_custom_color=&#8221;#126790&#8243;][vc_row_inner][vc_column_inner width=&#8221;1\/2&#8243;]<div class=\"pricing-box  pricing-box-box\"><div class=\"plan-header\"><h2 class=\"title\">Server<\/h2><div class=\"price\"><sup class=\"currency\">$<\/sup><span>700<\/span><sup class=\"period\"><\/sup><\/div><hr class=\"hr_color\" \/><p class=\"subtitle\"><big>One server &amp; IP\/Domain based<\/big><\/p><\/div><div class=\"plan-inside\"><span class=\"pi-content\"><\/p>\n<ul>\n<li>+35% p\/y<br \/>\nmaintenance fee<\/li>\n<\/ul>\n<p><\/span><\/div><div class=\"plan-footer\"><a href=\"https:\/\/subscriptions.zoho.com\/subscribe\/ecd30e00d022efa2293b765c8525987479bc88ff48c14354ad482bf477cf719e\/exchange-plugin-server\" class=\"button button_theme has-icon\"  title=\"Free Trial\"><span class=\"button_icon\"><i class=\"icon-credit-card\" aria-hidden=\"true\"><\/i><\/span><span class=\"button_label\">Free Trial<\/span><\/a><\/div><\/div>\n[\/vc_column_inner][vc_column_inner width=&#8221;1\/2&#8243;]<div class=\"pricing-box  pricing-box-box\"><div class=\"plan-header\"><h2 class=\"title\">Unlimited<\/h2><div class=\"price\"><sup class=\"currency\">$<\/sup><span>1400<\/span><sup class=\"period\"><\/sup><\/div><hr class=\"hr_color\" \/><p class=\"subtitle\"><big>Unlimited Servers<\/big><\/p><\/div><div class=\"plan-inside\"><span class=\"pi-content\"><\/p>\n<ul>\n<li>+35% p\/y<br \/>\nmaintenance fee<\/li>\n<\/ul>\n<p><\/span><\/div><div class=\"plan-footer\"><a href=\"https:\/\/subscriptions.zoho.com\/subscribe\/ecd30e00d022efa2293b765c8525987479bc88ff48c14354ad482bf477cf719e\/exchange-plugin-unlimited\" class=\"button button_theme has-icon\"  title=\"Free Trial\"><span class=\"button_icon\"><i class=\"icon-credit-card\" aria-hidden=\"true\"><\/i><\/span><span class=\"button_label\">Free Trial<\/span><\/a><\/div><\/div>\n[\/vc_column_inner][\/vc_row_inner][vc_column_text css=&#8221;.vc_custom_1516819731760{border-left-width: 2px !important;padding-left: 10px !important;border-left-color: #ee6e73 !important;border-left-style: solid !important;border-radius: 1px !important;}&#8221;]<span class=\"title red-text uppercase\">IMPORTANT\u00a0<\/span><br \/>\nThe Exchange Plugin is based on the Java Exchange Connector (JEC) libraries.<br \/>\nThe ExchangeWS Plugin is based on the Exchange Web Services (EWSJ) libraries.<\/p>\n<p>Without a valid (trial) license for the JEC or EWSJ libraries the Exchange Plugins will operate in trial mode or not at all.<br \/>\nA license for the JEC and EWSJ libraries can be bought from\u00a0<a title=\"More information\" href=\"http:\/\/www.javaexchangeconnector.com\/\" target=\"_blank\" rel=\"noopener\">NetComps LTD\u00a0<\/a>.[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>When you or your (Corporate) client uses Microsoft Exchange as a solution for Calendaring, E-mail etc. the Exchange Plug-in is your friend.<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[],"_links":{"self":[{"href":"https:\/\/servoycomponents.com\/wp-json\/wp\/v2\/posts\/219"}],"collection":[{"href":"https:\/\/servoycomponents.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/servoycomponents.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/servoycomponents.com\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/servoycomponents.com\/wp-json\/wp\/v2\/comments?post=219"}],"version-history":[{"count":11,"href":"https:\/\/servoycomponents.com\/wp-json\/wp\/v2\/posts\/219\/revisions"}],"predecessor-version":[{"id":654,"href":"https:\/\/servoycomponents.com\/wp-json\/wp\/v2\/posts\/219\/revisions\/654"}],"wp:attachment":[{"href":"https:\/\/servoycomponents.com\/wp-json\/wp\/v2\/media?parent=219"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/servoycomponents.com\/wp-json\/wp\/v2\/categories?post=219"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/servoycomponents.com\/wp-json\/wp\/v2\/tags?post=219"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}