|EWS Account (Exchange Web Services)|
Creating a New EWS Account
Getting New Mail and Folder Structure
If you have an Exchange Server account, you can access it from within The Bat! using the EWS (Exchange Web Services) protocol. EWS allows accessing MS Exchange Server 2007 and later versions. There is no need in using additional programs or Outlook’s profile as in the case of MAPI. The program downloads not only emails, but other Exchange items as well, such as calendar events, contacts, tasks and notes.
When you first time access the EWS account, The Bat! imports the downloaded contacts into the corresponding address book automatically. If messages, tasks or calendar events have a reminder, The Bat! creates the respective reminders in the Scheduler as well. All other Exchange items are available just for information purposes.
Creating a New EWS Account
In the "Create New Account" window input your email address and the password for your Exchange account, select "Exchange Web Services" from the dropdown menu and click "Next".
The Bat! will use the Exchange autodiscover service to automatically get setup information from your Exchange server. If your Exchange server is configured properly, The Bat! will retrieve the Exchange Server Endpoint and display its address in the respective field.
If The Bat! finds the endpoint, just click "Next".
If The Bat! does not find the Exchange web services endpoint (the “Exchange Server Endpoint” field remains empty), you can:
(domain/login based login)
Or like this:
(UPN based login)
On the 1st screenshot EWS is accessed by domain name followed by a backslash (\) and logon name.
On 2nd screenshot EWS is accessed by UPN: logon name followed by the "@" symbol and the domain name.
Click the "Test now!" button to make The Bat! search for the Exchange Server Endpoint. Every time the wizard will start a few concurrent tasks trying to find the best solution for you. All endpoints found will be added to the dropdown menu. Animation will be active while searching is in progress.
Note: If you are not sure which user name to use to access your Exchange server, input the same logon credentials you use to access your Exchange account via OWA (Outlook Web Access).
If The Bat! is unable to detect the Exchange Server Endpoint, ask your Exchange administrator to provide you with the Exchange web services endpoint and your credentials as UPN+password or logon+password.
The last solution is to enter the EWS endpoint manually. Remember you can change it in the Transport section of the Account properties at any point later.
If your EWS endpoint was not automatically discovered or is not available, this may mean your Exchange Server administrator has blocked the EWS access. To check this, try to connect to
After successful authentication, you should get the EWS wsdl definition. If you do not get it, contact the Exchange Server administrators and ask them to fix the Exchange Server setup. Another way to get the EWS endpoint is to use the test page provided by Microsoft: https://testconnectivity.microsoft.com
On the Exchange Server tab choose the Connectivity test for Exchange Web Services section, and after testing expand the details till you find the EwsUrl value (internal and external). Once you get this url, input it as the EWS endpoint address in The Bat!
You can manage the security certificates behavior as well. A Security Alert dialog will appear, if your Exchange server uses a self-signed or an expired digital certificate:
You can add it to the local Windows certificate store (View Certificate | Install Certificate | Next | Place all certificates in the following store | Browse | | OK | Next | Finish).
Alternatively, just avoid the message for this account by selecting the appropriate security flag checkbox.
Beware: Use security flags only when you trust the source.
When the autodiscover process is completed, click "Next".
The "Your name" field will display your Exchange account name. If the connection was successful, you will see here the Exchange full name which has been retrieved during the connection procedure. Otherwise "Your name" entered at step 1 will be duplicated.
The second field identifies your new account in The Bat!’s account tree.
The last field shows the default location of the new account folder.
Click "Finish" to add the new account. Once the new account appears in the account tree, The Bat! establishes the connection with the server and downloads folders with their contents.
Getting New Mail and Folder Structure
The Bat! will retrieve all folders with contents (except for the Deletions, Archive and Recoverable folders) during the first connection with the server.
In addition to standard folders, you will also see Calendar, Contacts, Tasks and some other folders that will display MS Exchange items such as calendar events, contacts, notes, activities, RSS feeds, tasks. The Bat! can also download the contents of the Exchange Public Folders. If you have access to an Exchange Public Folder, it will appear in the “All Public Folders” folder in your EWS account.
The program displays all attributes used by Outlook which can be mapped into The Bat!’s functionality and RFC822, such as Subject, From, To, CC, BCC and other headers, flags, attachments, tags, encryption, date and time of creation/receiving, size.
The Bat! can download messages received later than the specified date. When you set up the EWS account you can enable the "get only items later than" option and set the date. The Bat! will not download items received before this day. You can enable this option in the Transport section of the account properties as well.
If you are connected to social media in Outlook (Twitter, Facebook, LinkedIn), folders with the respective contacts will also appear in The Bat!’s account tree (like Exchange contacts extracted from corporate Active Directory). Each Contact item will have an attached personal vCard, a picture and any other attachments you have assigned to the contact.
The Bat! can also download your corporate network contacts. To download such contacts, enable the "load Active Directory contacts" option when you set up the account. You can enable this option later in the properties of your EWS account in the “Transport” section. These contacts appear in the "Active Directory" folder in your EWS account and are automatically imported into the EWS address book. You cannot move or delete these contacts from the Active Directory folder.
When you first time access the EWS account for the first time, The Bat! imports the downloaded contacts into the newly created address book. The name of such address book consists of the account name followed by "[EWS]":
You can change the name of this address book and it will still be connected to your EWS account. If you delete the address book, your contacts will disappear from The Bat!’s interface. However, you can restore them again by importing the .vcf file attached to each Contact item. During the next connection The Bat! will discover that the address book is missing and will create a new one.
If you set a reminder for a message, task or create an appointment in Outlook or OWA, The Bat! creates the respective reminder in the Scheduler once you get this item. The Bat! will remind you about this message/event/task at the specified time.
If you create an item on the Exchange server, The Bat! will download it once you connect to the server. However, items created in The Bat! will not be synced with the server.
Once The Bat! downloads the items, they are stored and preserved unchanged unless you clear the cache of the folder.
If you delete items using the Delete key, they are deleted from the Exchange server.
If you delete items using the alternative deletion (Shift+Delete), they will be deleted from the Exchange server as well (Exchange soft delete mode will be used in this case). Later, if you restore such items using the Folder -> Browse Deleted Messages menu (to restore a deleted message, select it and press the Delete key), they will be stored locally only.
If you delete a message from the Exchange server which you have already downloaded into The Bat!, it will not be deleted from The Bat! If you, however, clear the cache of the folder, then the message will not be available anymore.
If you move or copy messages or other Exchange items into EWS folders, they are uploaded to the respective folders on the server. If you move an element from a folder it is deleted from this folder on the server.
The Bat! syncs the Flagged and Read/Unread flags and receives the Parked flag ("is draft" in Exchange terminology). For example, if you mark a message as read in The Bat!, another email client will also display it as read. The Replied and Forwarded/Redirected flags are not synchronized.
The Bat! syncs message Priority and Sensitivity as well. Sensitivity is displayed as a tag and to change it you need to right-click the message and select it under “Tags”. In most cases, attributes that are currently not supported in The Bat! are shown as tags.
Color groups are not supported.
Folders in The Bat! are displayed in the language set for your account on the server (OWA -> Options -> Regional Settings -> Language -> Save). If you change the language settings, the folder names will change in The Bat! accordingly.
If you rename, move or delete a folder in The Bat!, these changes will be reflected on the server as well. If you create a folder in The Bat!, it will appear on the Exchange server. If the folder structure on the server changes (folders are moved, renamed, deleted or created), The Bat! will reflect these changes as well and update the folder structure.
If you do not want to see a folder in the account tree, however, do not want to delete if from the server, you can change visibility: select the folder, press the Delete key and choose the "Make invisible" option.
To hide a folder, you should also enable the "Maintain list of hidden folders" option in the Account -> Properties -> Transport menu:
If you do not enable this option, hidden folders with their contents will be restored once the folder structure is refreshed (at the next mail retrieval).
Thus, you can check the "Maintain list of hidden folders" box and mark any folder as invisible. You can get the full folder tree again if you uncheck this box and use the “Receive new mail” command. The folder tree will be restored and all missing messages will be received and stored locally.
It is possible to clear cache of the folders by clicking the "Clear cache now" button in the Folder -> Properties -> EWS-Specific menu. After you clear cache The Bat! will download messages anew from the server.