email-IncomingAccount

Property	Value	Description
Hostname	mail.name.com, where name varies depending on the host.	The name specified by the email provider.
Port	number	The number of the port that the system associates with the email account. Typically, the incoming email account number is 110. If you leave the setting at its default value of minus one (-1), the IncomingAccount searches for and uses a valid port.
Account	text	This is the name of a specific account that is authorized to access the mail server identified by `Hostname`. For example, if you are using an email account named "joejones@acme.com" on the host described above, the account name is simply "joejones". The Hostname in this case could be "mail.acme.com".
Password	text	This is the login credential for the email account specified by the provider.
Pollrate	hours: minutes: seconds	Specifies how often the account executes a send action. Increasing the pollrate value increases the time between polls. During the time between polls, emails may be queued (up to the max queue size) until the next poll time. At the next poll time all queued emails are sent.
Enabled	`true` or `false`	Activates and deactivates use of the function.
Status	text	Read-only field. Indicates the condition of the component at last polling. {ok} indicates that the component is polling successfully. {down} indicates that polling is unsuccessful, perhaps because of an incorrect property. {disabled} indicates that the `Enable` property is set to `false`. fault indicates another problem.
Last Poll Success, Last Poll Failure	hours and minutes	Each of these properties displays the time of the last polling success and failure, respectively.
Last Poll Failure Cause	read-only	Displays an error message to indicate the reason for the polling failure.
Debug	Boolean property	Turns debug mode on and off. When on, and the station sends or receives email, the system displays detailed information using the platform’s standard Application Director view.
Use start Tls	`true` or `false` (default)	This property allows you to enable and disable communication security. The option must be set to `true` or `false` according to the instructions provided by the email provider. NOTE: Use Ssl and Use Start Tls are mutually exclusive. Both may be false. To provide secure email, set one property to true, and the other false. Do not enable or disable the Use Ssl or Use Start Tls properties without configuring the Port.
Store	email retrieval standards	Selects the email retrieval standard. Use the option supported by your mail server: Imap Pop3
Delivery Policy	various	Provides a list of options that control how the incoming email account handles incoming emails at the mail server. `Delete` causes the account to remove all emails from the mail server when it checks the account to retrieve new email. This happens even if the emails are already marked as read by another email client. `Mark As Read` sets all emails to the read state when the account checks to retrieve new email from the server. `Mark as Unread` sets all emails to the unread state when the account checks to retrieve new email from the server
Use Ssl	`true` or `false` (default)	This encrypts the connection before it is opened. The encryption automatically uses either SSL v3 or TLS (depending on email server requirements). The option must be set to `true` or `false` according to the instructions provided by the email provider. NOTE: Use Ssl and Use Start Tls are mutually exclusive. Both may be false. To provide secure email, set one property to true, and the other false. Do not enable or disable the Use Ssl or Use Start Tls properties without configuring the Port.

Hostname

mail.name.com, where name varies depending on the host.

The name specified by the email provider.

Port

number

The number of the port that the system associates with the email account. Typically, the incoming email account number is 110. If you leave the setting at its default value of minus one (-1), the IncomingAccount searches for and uses a valid port.

Account

text

This is the name of a specific account that is authorized to access the mail server identified by Hostname. For example, if you are using an email account named "joejones@acme.com" on the host described above, the account name is simply "joejones". The Hostname in this case could be "mail.acme.com".

Password

text

This is the login credential for the email account specified by the provider.

Pollrate

hours: minutes: seconds

Specifies how often the account executes a send action. Increasing the pollrate value increases the time between polls. During the time between polls, emails may be queued (up to the max queue size) until the next poll time. At the next poll time all queued emails are sent.

Enabled

true or false

Activates and deactivates use of the function.

Status

text

Read-only field. Indicates the condition of the component at last polling.

{ok} indicates that the component is polling successfully.
{down} indicates that polling is unsuccessful, perhaps because of an incorrect property.
{disabled} indicates that the Enable property is set to false.
fault indicates another problem.

Last Poll Success, Last Poll Failure

hours and minutes

Each of these properties displays the time of the last polling success and failure, respectively.

Last Poll Failure Cause

read-only

Displays an error message to indicate the reason for the polling failure.

Debug

Boolean property

Turns debug mode on and off. When on, and the station sends or receives email, the system displays detailed information using the platform’s standard Application Director view.

Use start Tls

true or false (default)

This property allows you to enable and disable communication security. The option must be set to true or false according to the instructions provided by the email provider.

NOTE: Use Ssl and Use Start Tls are mutually exclusive. Both may be false. To provide secure email, set one property to true, and the other false. Do not enable or disable the Use Ssl or Use Start Tls properties without configuring the Port.

Store

email retrieval standards

Selects the email retrieval standard. Use the option supported by your mail server:

Imap
Pop3

Delivery Policy

various

Provides a list of options that control how the incoming email account handles incoming emails at the mail server.

Delete causes the account to remove all emails from the mail server when it checks the account to retrieve new email. This happens even if the emails are already marked as read by another email client.
Mark As Read sets all emails to the read state when the account checks to retrieve new email from the server.
Mark as Unread sets all emails to the unread state when the account checks to retrieve new email from the server

Use Ssl

true or false (default)

This encrypts the connection before it is opened. The encryption automatically uses either SSL v3 or TLS (depending on email server requirements). The option must be set to true or false according to the instructions provided by the email provider.

NOTE: Use Ssl and Use Start Tls are mutually exclusive. Both may be false. To provide secure email, set one property to true, and the other false. Do not enable or disable the Use Ssl or Use Start Tls properties without configuring the Port.

email-IncomingAccount

Figure 6. Incoming Account Property Sheet

Related Links