| Tip |
|---|
Role required: admin. |
Email account is the set of options that is responsible for the configuration of email processing. It can be a pre-configured account with the SMTP protocol (for sending emails), POP3 protocol (for receiving emails), and IMAP protocol (for receiving emails).
Use the simple.email.smtp.active property to enable or disable email sending from the account.
To set it up, complete the steps below:
- Navigate to System Properties → All Properties.
- Find the simple.email.smtp.active property record using the list search boxesand open it.
- In the Value field, enter true to enable email sending, or false to disable it.
- Click Save or Save and Exit to apply the changes.
The email account configuration includes the following steps:
Creating an email account Anchor creating an email account creating an email account
| creating an email account | |
| creating an email account |
| Tip |
|---|
It is recommended to configure email accounts within the Simple application due to the fact that Email Properties are located in this application. The email tuning will become easier if necessary properties and email accounts share the same application. |
To create an email account, complete the following steps:
- Navigate to the System Mailboxes → Email Accounts.
- Click New and fill in the fields.
- Click Save or Save and Exit to apply changes.
Email Account form fields
| Field | Mandatory | Description | ||
|---|---|---|---|---|
| Name | Y | Specify the displayed account name. | ||
| Type | Y | Define the account type, based on a specific protocol. Available options:
| ||
| From | Y | Sender address to be displayed in the From field of the message.
| ||
| Server | Y | Specify the hostname of the server used for the mail processing. | ||
| Login | Y | Server user login. | ||
| Password | Y | Server user password. | ||
| Email user label | N | Descriptive user label. | ||
| Active | N | Select this checkbox to activate the account. | ||
| Enable debug | N | Select this checkbox to have more extended logs. This will help to indicate issues while configuring email settings. | ||
| Port | Y | Specify the port that the server will be running on. | ||
| Enable SSL | N | Select this checkbox to enable SSL encryption. | ||
| Enable TLS | N | Select this checkbox to enable TLS encryption. | ||
| Disable certificate validation | N | Select this checkbox to allow connecting to the email server without checking the certificate. Disable Certificate Validation is unselected by default.
|
The simple.email.test.user property allows specifying a test email address for email debugging. After set up, all mail sent from the instance will be redirected to this address.
To set it up, complete the steps below:
- Navigate to System Properties → All Properties.
- Find the simple.email.test.user property record using the list search boxesand open it.
- In the Value field, enter the text you need.
- Click Save or Save and Exit to apply changes.
Test connection Anchor test connection test connection
| test connection | |
| test connection |
When you finish configuring the email account.
To test the connection, please follow these steps:
- Select the Enable Debug checkbox and click Save.
- Scroll down to the Related Links area (above the Related Lists area).
- Click the Test Connection link.
- If the connection is set, make the created account default.
In the Log (sys_log) table, you can track the operation processing:
- Navigate to System Logs → Main Log.
- Apply this filter: Source is Email Logger.
- Open a record if needed.
Main Log form fields
Field | Mandatory | Description |
|---|---|---|
| Source | Y | The source from where the message was produced (IMAP Authorization, SMTP Authorization, Incoming mail, and others). |
| Level | Y | Message category:
|
| Message | N | The message containing information about the |
| Username | N | The name of a user who created the log or the system if it was created automatically. |
| Created by | Y | Information about who has created the record. |
| Created at | Y | This field stores information about the date and time of record creation. |
In our example, we set up an IMAP email account. In the screenshot below:
- IMAP authorization session has been set up.
- After the successful authorization, the list of email IDs was called from the server.
- The call was processed, and the list was received.
If connection fails, a warning message appears:
In this case, check logs to find the error cause. To perform this, navigate to System Logs → Main Log and make a log selection based on the criteria below:
- Source = Email Logger
AND - Level = Error
Use Condition Builder to build an appropriate filter. An example of the error record is given below:
Default email account Anchor default email account default email account
| default email account | |
| default email account |
To start using the created email account, set your email accounts as default ones. The system will insert them automatically into every letter, incoming or outgoing.
To do this, complete the following steps:
- Navigate to the System Mailboxes → Email Accounts.
- Open the record you need.
Find the email account ID in the address bar (it is a long number sequence), and copy it to the clipboard.
Section 
- Navigate to the System Properties → All Properties.
- Find the default.email.account.send property using the search box.
- In the Value field, paste the email account ID from the clipboard.
- Click Save or Save and Exit.
/
SimpleOne provides an automatic system of managing emails.
The email check is performed once a minute automatically. Incoming emails are registered automatically.
To read your inbox, please navigate to System Mailboxes → Incoming Emails. Use the filtering functionality and the Condition Builder to make the selection of emails you need.
| Tip |
|---|
Every email is represented as a table record. The original email is attached to the record in .eml format. If any other files were attached to the original letter, they will also be attached to the record. |
The message content in HTML based on the rich text format. The following features are available:
- Headings
- Text effects
- Text aligning
- Text and background coloring
- Font sizes
- Media uploading
- Numbered and bulleted lists
- Tables and blocks
- Hyperlinks.
The message status. Available choice options:
- Ready – the message is ready for further processing.
- Attaching – this state is used during the incoming letter processing, before attachments are downloaded. After it is done, the state changes to Ready.
- In Process – the message is in delivery process now.
- Processed – the message was handled correctly.
- Failed – message delivering was unsuccessful for some reasons.
- Ignored – the message is inactive and will be ignored by the mail server.
| Info |
|---|
The Ignored state is set when email sender and email recipient are the same. Saying more precisely, when email address in the email address in the sender profile is equal to the email address in the To field in email. To get this goal, set the Send Self attribute in the notification rule. For more information, please refer to the Notifications article. |
The type of new message. Available choice options:
- New
- Forward
- Reply
- Delivery
- Calendar.
Email direction (Incoming).
This field is populated automatically with the reference to the sender account.
The system user specified as a sender indicated that a letter was created as a result of the system event processing.
For more information, please refer to the Notifications article.| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|