Welcome to the Mavenlink Integrations Changelog! This is where you can see a summary of changes that our Product Development Team has made to our Integrations Platform.
December 20th, 2018
Jira Integration
Support for the creator of the Jira comment
There is now a scenario option to add the Jira username to the synced Mavenlink post. Appended to the Mavenlink post will be the name of the Jira user who made the originating comment on the synced Jira issue. To take advantage of this new capability, edit your Jira scenario and select 'Yes' for the new option Include Comment Creators.
Your newly synced Mavenlink posts will look like the below example, with the Jira user's name being appended to the beginning of the comment text.
October 16th, 2018
Jira Integration
Support for token-based authentication
We now support token-based authentication for our Jira Services. In December, Jira is sunsetting support for user-based credentials when accessing their system via the API. To ensure your integration keeps running smoothly, you will need to edit your JIRA Services on the Integrations Platform to use a token. Quick and easy instructions can be found here.
Support for Jira Components
You can sync Jira Components to a custom field on the corresponding Mavenlink task using the new Additional Fields section of the scenario.
To add a field pair mapping, select the Add Field Pair button
Select to map the JIRA components to a Mavenlink custom task field of type text or multi-choice.
Note: If a component value is synced that does not exist in the other system, it will not be synced.
Currently, component is the only additional field we support. Look out for a future release where we allow additional fields to be synced.
To remove the field pair mapping, select the '-' button to the right of the pair.
October 10th, 2018
Flat File Integration
Multiple Global Services
You now have the ability to use different file servers for each of your flat file integration scenarios. For example, if your expense file for import needs to be located on one SFTP file server and your time entry file for export needs to be located on a different SFTP file server, the scenarios can now account for this.
In the Services page, you can now create a Global Account Service for each of your FTP, SFTP and S3 file servers.
For your integration scenario, select which file server type and the name of the file service you want the scenario to use.
August 8th, 2018
JIRA Integration
Subtask time without the subtask
You now have the option to bring JIRA subtask time over to Mavenlink without syncing the subtask. The time will be added to the Mavenlink task that is synced to the JIRA parent issue.
To take advantage of this new functionality, in your JIRA scenario, set the ‘Include Jira Subtasks’ option to ‘No’ and set both the ‘Include Jira Issue Time Entries’ and the new ‘Include Jira Subtask Time Entries’ options to ‘Yes’.
July 23th, 2018
JIRA Integration
Support for Tempo
If you are using the Tempo add-on for JIRA, the Platform needs to connect to Tempo in order to obtain the name of the user who submitted a time entry. To do this, you will need to update your JIRA Service definitions with a Tempo token. For guidance on creating a Tempo token, please refer to your Tempo documentation.
If you are not using the Tempo add-on, leave the Tempo Token field blank.
July 19th, 2018
NetSuite Integration
Mavenlink Approved Expense Report to NetSuite Expense Reports Scenario:
We have added the ability to send the Mavenlink expense report approver to a designated custom field on the NetSuite expense report. This allows your finance team to see who on the project approved the expenses.
June 22nd, 2018
Integration Platform Performance Improvements
Scenario Management:
Integration scenarios that are generating errors higher than a 60% error rate will be automatically disabled. In this case, an exception will be logged indicating that the scenario breached the acceptable error threshold and you will receive an email alerting you to the problem. If your scenario has been disabled due to a high error count, you will need to review the errors in the Exceptions page and address them. Once addressed, you can re-enable the scenario.
In the new User Email Settings page of the Platform, you can opt out of receiving this email in the future.
June 11th, 2018
NetSuite Integration
NetSuite Job to Mavenlink Project Scenario:
We have added a few additional enhancements to this scenario.
1) You can now indicate which NetSuite jobs should be synced as Mavenlink projects using a custom checkbox field on the NetSuite job. On your scenario, enter the field id of the NetSuite job custom field in the new field pictured below. For NetSuite jobs that have this field checked, a Mavenlink project will be created. If the field is unchecked, no Mavnelink project will be created.
If this field is not filled out, the scenario will pick up all new NetSuite jobs and create Mavenlink projects for them as it does today.
2) You can send additional NetSuite job field values to the synced Mavenlink project using the new Additional Fields section of the scenario.
To add a field pair mapping, select the Add Field Pair button
You can select to map a custom Netsuite job field to a Mavenlink custom project field or a native NetSuite job field to a Mavenlink custom project field. Enter the NetSuite field id and the Mavenlink custom field name.
To remove a field pair mapping, select the '-' button to the right of the pair.
Mavenlink Approved Expense Reports to NetSuite Expense Reports Scenario:
We have added the ability to send your expense receipts to NetSuite. Select 'Yes' on the new Sync Expense Receipts option. Then enter the internal id for the file cabinet folder in NetSuite that you would like the receipts to be copied to.
Note: NetSuite has a maximum allowable size of 10MB. Any receipt that is uploaded to Mavenlink that exceeds this size will fail during sync with an exception stating:
The data you are uploading exceeds the maximum allowable size of 10.0 MB. Please change your selection and try again |
In this case, the expense will need to be edited and a smaller size file uploaded. The expense report will need to be resubmitted for approval before the integration scenario can pick it up for processing.
May 9th, 2018
Integration Platform Improvements
Service Management:
You can now edit your Service definition so if your JIRA password changes, just select the Edit button for each of your JIRA Services and enter the new password. Your scenarios will automatically pick up the new Service changes.
Some Service definition fields are not editable. These fields are part of the unique identifier for the integration and cannot be changed for an existing integration. If a new Service is created for an existing integration but with a different value for one of these unique identifier fields, the Platform will consider the integration to be new and will treat all objects in the source and target system as new.
March 5th, 2018
Integration Platform Performance Improvements
Scenario Management:
Integration scenarios that are generating errors higher than a 40% error rate will be automatically disabled. In this case, an exception will be logged indicating that the scenario breached the acceptable error threshold. If your scenario has been disabled due to a high error count, you will need to review the errors in the Exceptions page and address them. Once addressed, you can re-enable the scenario.
February 15th, 2018
Integration Platform Performance Improvements
We have made several improvements to our platform to ensure it keeps scaling as our offerings grow.
Logs Page:
- The page links of the Logs page were causing performance issues for integrations containing a large number of logs. We have removed the ability to navigate to a specific page using page links and changed the number of logs returned to 100 per page. You can still navigate to a specific page of the logs by changing the page number in the URL (/logs?page=2).
- A date and time filter has been added so you can narrow your search down quickly. The default filter is the last 24 hours.
Events Page:
- A date and time filter has been added so you can narrow your search down quickly.The default filter is the last 24 hours.
Exceptions Page:
- The calculation for the number of occurrences of an exception was causing performance issues for integrations with a large number of errors of that type. For exceptions that exceed 500 occurrences, we are now showing '500+' rather than calculating out the specific number of occurrences.
August 30, 2017
JIRA Integration
For the Project and Sprint Two Way scenarios, sending the Mavenlink Task's Due Date to JIRA is now optional. To not send the Due Date to JIRA, unselect the 'Include Due Date' option on your scenario. For JIRA Projects and Boards that do not have Due Date configured on the Issue, this option should be turned off so the Issue Update events to JIRA do not fail.
July 11, 2017
Event Payload Filter
From the Integration Platform Event page, you can now filter your event listing based on specific text in the event payloads. This allows you to identify all events for a given user, project, task etc. While only a small part of the payload is visible from the Event page, the filter will search the entire contents of the payloads and return those that contain the text entered in the Payload Filter field.
The event payload contains the data that is used as part of the synchronization. Depending on the system and scenario, the contents of the payload can differ.
Note: The search is a LIKE statement so it is case sensitive and you can use wild cards like %. The text you enter is automatically wrapped in %s so if you enter 'Scott%Smith', it is submitted as '%Scott%Smith%'. For more information on other expressions you can use in your search, click here.
May 16, 2017
JIRA
- Auto invite JIRA users to your ML project when their time is entered against a JIRA Issue or Sub-task
- Allow for syncing Mavenlink Tasks at all 5 levels to JIRA Issues if JIRA Sub-tasks are not part of the synchronization definition.
- When a new JIRA Issue is created, the synchronization will create a new ML Task at the top level. It can then be moved to any other level in the project and the synchronization will keep it in sync with its JIRA Issue without moving it from its new location.
- The exception to this is the Sprint scenarios where the level 1 Mavenlink Tasks represent a Board's sprints and backlog. The second level of Tasks represent the JIRA Issues.
April 12, 2017
Log Acknowledgement: This rarely used feature is being replaced as it was causing performance issues on the Platform. In its place is a new indicator in the menu bar when there has been one or more new exceptions since the last time you visited the page. The exceptions are ordered with the latest at the top so you can see right away which new issues need to be addressed.
March 10, 2017
Mapping Sets
You are no longer able to delete a mapping set if it is being used by an integration scenario. We had instances of customers with invalid scenarios running and generating errors since they had unknowingly deleted a mapping set that the scenario was using. You will now need to update any scenario to use a different mapping set before you will be allowed to delete one.
March 6, 2017
Integration Platform Exceptions View
The Exception View is a new way of reviewing your integration errors that allows you to quickly identify what the issue is, possible resolution and re-emit all the related failed events once a resolution has been applied. Each Integration’s events and logs are now grouped by the error message so that once that error is addressed, all events can be processed again using the Re-emit button for the exception. Previously, the error message was buried as one of the many event logs for each event that failed. Now it is surfaced as the exception and all events and logs related to it are linked and therefore viewable in its context.
The number of events that failed due to an exception is found in the Occurrences column. To drill down to the logs and events that failed, click View for the given exception.
Once you have addressed the issue that caused the error, you can select the action to re-emit all the events that failed. For exceptions that can be ignored, you can dismiss the exception. Selecting Dismiss will only remove the exception from the view. The related events and logs are removed.
To have the Exception View turned on for your Integration Platform account, please email support@mavenlink.com
February 17, 2017
JIRA
Do you want to map your Jira Bugs and Stories to Mavenlink Issues and Tasks quickly and easily?
You no longer need to create separate mapping sets and scenarios for your Mavenlink Issues vs. Tasks. Now you can have one Type Mapping Set and one Status Mapping Set that contain all your Issue Type Statuses as well as your Task Type Statuses and your scenarios will use the correct status during synchronization.
What do you need to do to take advantage of this new enhancement?
If your current scenarios are working as desired, you’re all set. If you are creating new scenarios, you can update your Status Mapping Set to include both Task and Issue Statuses. Your scenarios using this Mapping Set will work for all Tasks, Milestones, Deliverables and Issues. You will notice in the Status Mapping Set, you can now easily see which statuses are specific to Mavenlink Issues.
January 1, 2017
JIRA
For Agile/Scrum Boards:
- We have a new Scenario called “Board - Sprints - 1 way” that allows you to push all your Scrum Board activity to your corresponding Mavenlink Project. Sprints and Backlogs are captured as parent tasks in your Mavenlink project. Additional project work can be managed in Mavenlink and this work is kept out of your JIRA project.
- The start date of a Sprint is reflected in your Mavenlink project.
- When a Sprint is closed in JIRA, Mavenlink is updated accordingly. The Sprint is marked complete and tasks not done are moved to the Backlog or next open Sprint.
- The Epic that your Issue is assigned is captured in the corresponding Task using a Mavenlink custom field. Insights reports allow you to analyze the time spent per Epic.
July 13, 2016
JIRA
Good News: Our JIRA integration has some new features that will help you improve your collaboration between your teams and give your project managers more visibility into the work being done in JIRA.
For both project- and board-based integrations:
- Jira sub-tasks can now be captured in a Mavenlink subtask and kept in sync.
- Time logged in Jira can now be captured as time in the corresponding Mavenlink task.
- Comments made in the JIRA Issue and Subtask are captured as posts in the corresponding Mavenlink task. Posts made in the Mavenlink task are then copied to the JIRA Issue and Subtask so two way communication is completely coordinated.
- Fixed Versions and JIRA ID for your Issues can now be captured in the corresponding Mavenlink Tasks using Mavenlink’s custom fields.
For Agile/Scrum Boards:
- We have a new Scenario called “Board - Sprints - 2 way” that allows you to keep your Scrum Board in sync with your corresponding Mavenlink Project. Sprints and Backlogs are captured as parent tasks in your Mavenlink project.
- The start date of a Sprint is reflected in your Mavenlink project.
- When a Sprint is closed in JIRA, Mavenlink is updated accordingly. The Sprint is marked complete and tasks not done are moved to the Backlog or next open Sprint.
- The Epic that your Issue is assigned to can now be captured in the corresponding Task using a Mavenlink custom field.
All of these new features are options that you can turn on for your existing scenarios using the Integration Platform. For more information, read more here or speak with your Account Executive or Client Success Manager, or email support@mavenlink.com.
