Email Integration, create items via email
1. Setup
1.1 Select Subdomain
When you access this page first time you will get an empty screen, prompting you to select "Subdomain" for your organization. This subdomain has to be unique.
1.2 Define Project Keys
Project keys are unique values to identify each project. once you define the project key you will get unique email address to create issues and user stories.
2. Type of items
You can create 3 type of items via email- Issues
- User Stories
- Epics
3. Format to create items
There are 2 modes to create items.3.1 Basic Mode - with title, description & attachments
- Create new email
- Subject of email will be Issue Title
- Body of email will be Issue Details
- Attachment in email will be added to Issue attachment.
- send email to project unique email address for issues, e.g., teslog+issue@myorg.yodizemail.com
3.2 Advanced Mode - with more information
In Advanced mode you can use following notations to assign responsible, sprint, release, tags and few other things.- assigned-to: <user first-name/user login email address>
- status: <status label>
- priority: <priority label>
- severity: <severity label>
- release: <release label/release id e.g RL-48>
- sprint:<sprint label/sprint ids e.g SP-23>
- tags: <comma separated e.g aa,bb,cc>
- stories:<comma separated ids e.g US-1,US-3> (only valid for Epic to associate existing stories)
- .. These two dots are very important to write to tell system that attributes area is finished. Everything written after ".." will be added to Details section.
3.2.3. Example email
In screen shot below you can see the email created with parameters
Important Points
- Only users who are part of yodiz project will be able to create items via email. If somebody sends email to project unique email address and that person email doesn't exist in Yodiz then an auto-reply email message will be returned to user that they must be part of Yodiz project to create items.
- It is not possible to edit existing items via email at the moment, but we are planning to introduce this feature in near future. So do let us know your feedback.