|  | Home |

# Messages Client

- Introduction
- Features
- Accounts
- Folders

- Mail List (per folder)
- Virtual Folder Queries and Search

- Message Properties
- Viewing mail
- Writing Messages
- Retrieving messages
- Sending messages
- Dependencies

## Introduction

The Messages example client application enables the user to receive emails from multiple mail servers, using any of the protocols supported by the MessageServer. It also provides the ability to send messages to multiple recipients, with or without attachments.

## Features

Messages provides the following features:

Feature | Description
--- | ---
Send email | Compose and send an email.
Receive email | Connect to a mail server and download emails to the device.
Reply to messages | Reply to a message received via the Messaging Framework.
View an embedded image | View a message with an image either attached or embedded.
View specific messages | Filter the messages viewed. For example, view only messages in the current month.
Search for a message | Search the contents of messages and retrieve valid messages.
Multiple mail servers | View emails sent to multiple mail servers. For example view messages sent to both a work email address and a personal email address.
Save attachments | Receive a message with an attachment save it in their documents for later viewing.

## Accounts

The following account features are available:

Feature | Description
--- | ---
Accounts | Allows creation of an arbitrary number of mail accounts.

Email Protocols

The following email protocols are provided (other protocols can be added to the MessageServer via pluins):

- POP
- IMAP
- SMTP

Delete | Allows a delay of server deletion of email until removed locally from trash.

## Folders

The following folder features are available:

Feature | Description
--- | ---
Folders | supports both standard and virtual folders
Queries | supports creaton of an arbitrary number of virtual folders by adding new queries
Search | facilitates quick searches for email by using the search folder
Mail Account | each mail account is automatically assigned a virtual folder

### Mail List (per folder)

The following mail list features are available:

Feature | Description
--- | ---
Mail view | displays a short description of each mail consisting of status, address, subject and date.
Mail sort | it is possible to select each header file for sorting in either ascending or descending order.
Mail view update | the view is dynamically updated as folder or mail contents changes.
Transfer | it is possible to select messages and to copy or move them to another folder.

### Virtual Folder Queries and Search

The following virtual folder features are available:

Feature | Description
--- | ---
Folder properties | defines the search criteria for mails that appear in a folder.
Search keys | allows case-insensitive pattern matching with support for optional keys in the same field.
Virtual properties | the same mail logically appears in several folders.

## Message Properties

The following message properties can be handled:

Property | Description
--- | ---
Date | this is converted to match your current time zone setting
Attachments | these are only stored as files when you request it
Usability | support exists for most messages conforming to RFC2822 and RFC2045-RFC2049

## Viewing mail

The following features are available:

Feature | Description
--- | ---
URL | clicking on a URL in the mail prompts the application to attempt to open it in the default browser
Addresses | used to compose messages but it is also be possible to add an address/phone number to the address book by clicking on it
Format | quoted text is colored to distinguish it from the body text
Inline | text and image attachments are shown in-line with images being scaled to the screen width
Attachments | it is possible to install/remove mail attachments from the documents tab
Reply | it is possible to reply to or forward the currently viewed message
Status | it is possible to change the status of messages
Plain | the mail is shown in plain mode where the original formatting is kept
Delete | it is possible to delete the currently viewed message

## Writing Messages

The following features are available:

Feature | Description
--- | ---
Fields | it is possible to add SMS `/To/Cc/Bcc/From/Subject/body(text)` and attach files to the mail
Modify | it is possible to make changes as necessary to mails in the Drafts and `Outbox` folder
Auto save | modified drafts are automatically saved unless they are explicitly discarded
Store | draft mails are stored in the Drafts folder and mails ready to send are stored in the `Outbox` folder

## Retrieving messages

The following message retrieval related features are available:

Feature | Description
--- | ---
Retrieve | it is possible to check for new messages in either all accounts or to specify only one account to be checked
Complete messages | messages not downloaded are individually completed
Overview | all new/unseen mail-headers are always downloaded (unless excused in IMAP mailbox settings)
Fast | the current download list is sorted by the size of the mail (small goes first)
Logical | viewing a mail or removing it causes it to be respectively pushed to the front or removed from the download list
Resume | it is possible to cancel downloads and resume them later
Safe | in case of a crash while downloading the client reverts to the state prior to the crash

## Sending messages

The following message sending- related features are available:

Feature | Description
--- | ---
Send | it is possible to send all queued messages in one go.
Authenticate | POP or IMAP authentication is always attempted.
Fallback | sending is attempted even if authentication fails (for whatever reasons).
Single | it is possible to send a single mail instead of all the mails in the Outbox.
Safe | in event of failure no mail in the transfer list is marked as sent.
Sent Folder | all sent mails are automatically be moved to the Sent folder.
Flexible | default SMTP account or reply-to field is used where the from address does not match.
Diverse | it is possible to send a single message with both SMS and email addresses.

## Dependencies

Messages has the following dependencies:

- the Messaging Framework Client Library
- the Messaging Client Utility Library