To integrate Test Collab with Assembla, you should have Assembla API key and API key secret ready with you.
Here are the steps to get your API key and API key secret, in case you do not know:
- Access the profile page after logging into Assembla,
- Click on API applications & sessions
- On the resultant page you will be able to see the API key and API key secret.
Configuring application wide integration settings for Assembla in Test Collab:
Navigate to Main Dashboard > Settings > Issue Manager and provide the API key and API key secret (in place of password) after selecting Assembla from the drop down available on the issue manager integration settings page.
You also have an option of allowing the reported issue to be resolved automatically when the related test case passes by checking "Resolve reported issues when a failed test case is marked as passed". When you check this you will be prompted to provide the status code that Assembla uses for resolved issues, you need to enter the same for "Status code for resolved".
Project wise integration settings
When it comes to project wise setting for Assembla, you will get the list of fields that are important for configuration. The list includes :
- Project Id
- Assignee Id
For fields like Project Id and Assignee Id lists of options will automatically be fetched from Assembla on the basis of credentials provided by you during configuring application wide settings. For Priority, you may provide any of the following values -
- Highest (1)
- High (2)
- Normal (3)
- Low (4)
- Lowest (5)
All custom fields introduced for Assembla project will be listed automatically in the fields drop down, the fields can be selected and their values can be provided.
Most of the fields are straight forward, for some field types special values are expected.
Due Date(For field name either due-date or due_date can be used)- Date in format YYYY-MM-DD
Other date / date time- DateTime in format YYYY-MM-DD HH:MM ; or Date in format YYYY-MM-DD
Checkbox- yes or no
List- Same as the value provided while defining custom field in Assembla
Team List- A unique ID for the team member that can be fetched by using inspect element option for drop down shown next to assignee and copying the "value" for user you want to include.
Numeric- Any valid number
You can also add other fields including any custom field using "Add user defined field" from the drop down, clicking this you will get a text box in place of drop down to enter the name of the field.
A completed project specific issue manager setting form for Assembla would look like this.
Once the values for all fields have been provided you can save and test the settings by creating a sample issue in Assembla.
External references: https://api-docs.assembla.cc/content/ref/ticket_fields.html