Step 5: Expand or Modify your Integration

Expanding the Scale of Your Integration

You've already configured your integration, and it's running great!  Now you'd like to increase the scale by adding additional projects from each of your repositories to your integration landscape, or by adding additional fields to your mapping.  No problem - you can make these updates in just a few clicks!

Below, we've included some tips and tricks on how to effectively scale your integration, as well as information on what to expect when you make modifications to your integration configuration after the integration has been activated.

Adding Projects

In order to add additional projects from one or more of your repositories to your integration landscape, simply navigate to each collection, and add additional projects as desired.  Once that's saved, navigate to the integration, click on 'Artifact Routing' and route the projects appropriately - either creating new routes or adding to existing routes.  

Once the new projects have been added and routed, Tasktop will detect the artifacts contained within the new project(s) at the change detection interval (configured on the Settings page) and flow data according to the configuration that you have already set.

On the Collection Configuration Screen:

Add Projects to Collection

On the Artifact Routing Screen (in the Integrations section):
Add Projects to New Routes:

Click 'Route More Projects'

Select Project

Click 'Connect'

Artifact Routes are Created

Add Projects to Existing Routes:

Click the numerical link on the right side of the pill to add additional projects to that route:

Click Numerical Link

Highlight the project you'd like to add, click 'Selected>' and then 'Done.'

Select New Project

You will now see the updated number of projects, and the additional project's name listed in the pill:

Project is Added to Route

(lightbulb) Note: Depending on how you set up your artifact routing, you may need to configure conditional artifact routing.  This will be relevant if you route to more than one target project (as you will need to identify criteria by which the integration can determine which project to flow the artifact to).  You can learn more about conditional artifact routing  here.

Adding or Editing Fields

If you'd like to add, remove, or edit a field in your model, Tasktop allows you to do so even after the Integration has been run.  Once the field has been added to your model, navigate to your relevant collections and map that field as needed. You can then edit the field flow frequency from the integration's field flow screen.

If you add a new field to your integration's field flow, the field will be synced automatically for newly created artifacts. Tasktop will detect these changes according to the change detection interval.

(warning) Note that if you add or edit a new field mapping on an integration that has already begun running,  Tasktop will not automatically apply those new field mappings to artifacts that had already been synced and that were created before that mapping had been added unless/until that field specifically changes on the artifacts.  However, if you'd like to automatically sync the data in those fields for all artifacts, you can click the 'process all artifacts' button on the field flow page.  This will make it such that upon the next change detection interval, a full scan will be run.  This means that all artifacts in the collection will be scanned for synchronization, and any fields that are eligible based on your field flow configuration will be updated.

On the New Model Screen:

Add New Field to Model

On the Collection Field Mapping Screen:

Add Field Mapping

Fields are Mapped

On the Integration Field Flow Screen

Click 'Process All Artifacts'

After clicking 'Process All Artifacts,' you will be prompted to choose the side from which to initiate changes:

Choose Side to Initiate Changes

This will process all artifacts in the source collection upon the next change detection interval, and flow any eligible field updates to the target collection.