The issue by e-mail settings are found in User menu > Company settings > Advanced settings.
This feature allows issues to be added to the system by mailing them to a special mailbox at your mail server.
The mailbox is checked automatically at 1 minute intervals, and received messages are copied from the mailbox and added as issues to a default project for adding issues, when there is no project name indicated in the body of the email. To indicate a project name other than the default project, simply surround The Sender address on any particular message is used to identify the user who has submitted the issue. If a given address is not included in the list of enabled users’ addresses, the user specified as Default issue creator is taken to have submitted the issue. In other words, anyone can send a message at the given address and the message will be added as an issue. If the issue is submitted by a Birdview user who has no permission to add issues to the target project, it will be added on behalf of the default issue creator.
Target project to add issues submitted by e-mail to
To determine which project a submitted issue should be added to, Birdview checks out the message’s subject and body for the first text string it encounters, given in angle brackets (<Project Name>), treating it as not case-sensitive while comparing it with project names stored in the system. If no angle brackets are there in the message, or no available project name matches the string, the project specified as Default project for issues in the settings is used.
Naming the issue
The subject of the e-mail by which the issue is sent becomes the name of the issue being added.
Cases when an issue by e-mail is not added
An issue will NOT be added to the system in cases as follows:
- the user who is submitting the issue is disabled (as in the case when the user was initially specified as Default issue creator in the settings and later became disabled), and
- the user has had the ‘Add Issues’ permission disabled in its role in relation to the project it is submitting the issue to. In this case the issue will be added to the default project for issues by the default issue creator.
You can test connection by clicking on the "Test connection settings" button. Successful testing results in ‘Connection to POP3 server was established successfully’ message. Otherwise, you will get an error message. Re-check your settings and try again.
An example of Issue by e-mail settings is given in the illustration: