Help & Support
Follow

LeanKit Integration Service [NO LONGER SUPPORTED] - Overview & Guide

Please note that this Integration Service is no longer supported by LeanKit and no further updates will be made.

Users can download the latest source code from Github, and even make changes, but no further updates will be made by LeanKit, and no support will be provided. The GitHub repository can be found at https://github.com/LeanKit/LeanKit.IntegrationService

Instead of the Integration Service, customers can now integrate LeanKit with a broad range of enterprise applications via our integrations hub, powered by Tasktop. This enables customers to manage all of their integrations in a single place and provides fully automated, bi-directional synchronization with existing systems.

You can learn more about LeanKit Integrations, powered by Tasktop here.

 

Table of Contents

Overview

The LeanKit Integration Service synchronizes items between a Target system and LeanKit.

  • Supported Target systems: Visual Studio Team Services (VSTS), Microsoft Team Foundation Server (TFS), Atlassian JIRA, and GitHub
  • Runs as a Windows service, or from command line for testing
  • One Target + one LeanKit account per instance
  • Multiple Target projects / LeanKit boards per instance
  • Map any status in the Target system to any lane on a LeanKit board
  • Monitors the Target system, looking for new items and updates
  • When new items are added to the Target system, new cards are added to LeanKit
  • Monitors LeanKit boards for card moves and updates
  • When new cards are added to LeanKit, new items are added to the Target system (optional)
  • Supports state workflow (e.g. Active > Resolved > Closed)
  • Target system query to check for new/updated items can be fully customized
  • Synchronizes the following equivalent fields: title, description, priority, card type, tags, assigned to, due date, and card size.

LeanKitIntegrationOverview_150.png

 

Requirements

Before installing and configuring the Integration Service, make sure the computer meets minimum requirements. The Integration Service requires a PC running Windows 7, Windows Server 2008, or later, and the Microsoft .NET Framework 4.5.

Requirements for Visual Studio Team Services (VSTS) and Microsoft Team Foundation Server (TFS)

Install the TFS 2013 Object Model Client

The LeanKit Integration Service supports VSTS and TFS versions 2010, 2012, 2013, and 2015. Regardless of the version used as the Target, the Team Foundation Server 2013 Object Model client must be installed.

Enable alternate credentials for Visual Studio Team Services

To connect to VSTS, you will need to create and enable "alternate credentials" for the VSTS account used to query and update work items in VSTS.

  • Sign in to the VSTS account you are integrating, such as https://your-account.visualstudio.com
  • In the top-right corner, click on your account name and then select My Profile
  • Select the Credentials tab
  • Click the Enable alternate credentials and set password link
  • Enter a password. It is suggested that you choose a unique password here (not associated with any other accounts)
  • Click Save Changes

Requirements for JIRA

The minimum version of JIRA supported is 5.0.

Update Card ID Settings in LeanKit

To function properly, the LeanKit boards that are synchronized with the LeanKit Integration Service need to have “Card ID” support enabled. The LeanKit Integration Service uses this feature to store the correlating item ID from the Target system.

  1. Sign in to your LeanKit account.
  2. Navigate to the board you will be synchronizing with your Target system.
  3. Click the Configure Board Settings icon (see the following image).
  4. Click the Card ID Settings tab.
  5. Click Display external card ID field in card edit dialog.
  6. Click Enable header (optional) and choose Display text from external card ID field.
  7. Click Save and Close.

image21.gif

leankit-card-id-settings.gif

 

Installation

Download the LeanKit Integration Service .zip file here.

Extract the LeanKit Integration Service into a folder on the computer where the service will be installed.

Open an Administrator command prompt, and change the current directory to where the Integration Service is extracted.

Running from the Command-Line

To run the Integration Service as a command-line application, simply run the executable. Type IntegrationService.exe and press ENTER.

image22.gif

Running the LeanKit Integration Service from the command-line is useful for watching the activity between the Target system and LeanKit.

image00.gif

Installing as a service

Open a command prompt as an administrator, and type the following:

> IntegrationService.exe install

The service will be installed and started immediately. By default, the Integration Service runs as the local service account.

image17.gif

Installing more than one instance of the service

First, create separate folders for each instance, and copy all the files for the Integration Service into each folder. Next, open a command prompt as an administrator, and type the following for each instance, replacing [instance_name] with the desired instance name:

> IntegrationService.exe install /instance:[instance_name]

The service will be installed using the service name plus the instance name, and started immediately.

Upgrading

  1. Download and extract latest version of the LeanKit Integration Service into a separate folder.
  2. Make a backup of the following files, for safe keeping: config-live.jsonconfig-edit.json, and IntegrationService.exe.config.
  3. Stop the existing Integration Service, if it is running.
  4. Copy and overwrite all the files from the latest LeanKit Integration Service.
  5. Restart the LeanKit Integration Service.

Uninstalling

Open a command prompt as an administrator, and type the following:

> IntegrationService.exe uninstall

image18.gif

Uninstalling a named instance

Open a command prompt as an administrator, and type the following:

> IntegrationService.exe uninstall /instance:[instance_name]

Changing the default configuration port number

Locate and open the file IntegrationService.exe.config in a text editor. Find the application setting “ConfigurationSitePort” and change the value to the desired port number. Save the file, and restart the service.

<?xml version="1.0" encoding="utf-8"?>
<configuration> 
  <appSettings> 
    <add key="ConfigurationSitePort" value="8090" />
  </appSettings> 
  ... 
</configuration>

 

Configuration

The LeanKit Integration Service includes a web-based management application for configuring the connections and mappings between one or more projects in a Target system and one or more LeanKit boards.

Launching the configuration management application

  1. Open a web browser on the machine where the LeanKit Integration Service is installed.
  2. Browse to http://localhost:8090/

By default, the web interface for managing the LeanKit Integration Service is available at http://localhost:8090/. To change the port number (8090), see Changing the default configuration port number.

Connecting to your LeanKit account

The first time you access the LeanKit Integration Service configuration application, you will be prompted to connect to your Leankit account. The LeanKit account user must have permission to access, create, and update cards with the boards you wish to integrate with your Target system.

  1. Enter your account name. Your account name can be found in the URL you use to access your LeanKit account.
  2. Enter your account email address.
  3. Enter your password.
  4. Click Connect.

image14.gif

Once you successfully connect to your LeanKit account, click Next: Connect To Target to continue.

image09.gif

Connecting to your Target system

  1. Choose the type of Target system you are connecting to. Choices are TFS, JIRA, GitHub Issues, and GitHub Pull Requests.

    Note: If you are connecting to Visual Studio Team Services, choose TFS. You must also enable alternate credentials.

  2. Enter your host address.

    If required for self-hosted TFS or JIRA, change the host prefix from https:// to http://

    For Visual Studio Team Services or TFS, also include the name of the project collection.

    For GitHub, enter only the name of the account or organization associated with the desired repository.

  3. Enter your account user name.

    Note: For JIRA, you must use your account username instead of your email address.Your username can be found by going to your account Profile.

  4. Enter your password.
  5. Click Connect.

image12.gif

Once you successfully connect to your Target system, click Next: Check Global Settings to continue.

image02.gif

Global settings

Check Target for updates every [____] milliseconds. By default, the LeanKit Integration Service will check the Target system every 60,000 milliseconds (60 seconds) for new changes.

Synchronize items created after: [____]. By default, the LeanKit Integration Service will check only items created after January 1, 2013.

Once you updated or verified these global settings, click Next: Configure Boards and Projects to continue.

image15.gif

Mapping a Target project to a LeanKit board

  1. On the left, select a LeanKit board.
  2. On the right, select a Target project from the drop-down list.
  3. Click Configure… to continue.

image01.gif

image24.gif

Choose how LeanKit cards are created

Under the Selection tab, choose the project statuses and Target item types that you wish to synchronize with your LeanKit board.

Note: For Visual Studio Team Services or TFS accounts, you may also select a project Iteration Path to further refine the items that are selected for synchronization.

image16.gif

Using a custom Target query

The LeanKit Integration Service supports custom queries for selecting items from the Target system to synchronize with your LeanKit board. When you select Custom Query, the Simple Selection area will be hidden, and a text box will appear where you may enter a custom query.

image07.gif

Using a custom query for Visual Studio Team Services or TFS

The LeanKit Integration Service supports custom Work Item queries. You may enter any valid Work Item query. Your Work Item query must include the following:

[System.ChangedDate] > '{0}'

This is a placeholder used to filter items in the query to only those that have changed since the last date and time Work Items were found for synchronization.

The default Work Item query used by the LeanKit Integration Service is:

[System.TeamProject] = '<ProjectName>' 
  AND [System.IterationPath] UNDER '<ProjectName>\\<IterationName>' 
  AND ([System.State] = '<First State Selected>' 
       OR [System.State] = '<Second State Selected>' OR ... ) 
  AND ([System.WorkItemType] <> '<First Excluded Type Selected>' 
       AND [System.WorkItemType] <> '<Second Excluded Type Selected>' AND ...) 
  AND [System.ChangedDate] > '{0}'

A full explanation of the query capabilities available for Visual Studio Team Services and TFS is beyond the scope of this documentation. Please consult your Work Item query documentation.

Using a custom query for JIRA

The LeanKit Integration Service supports custom queries with JIRA using the JIRA Query Language (JQL). You may enter any valid JQL. Your custom JIRA query must include the following:

updated > '{0}'

This is a placeholder used to filter items in the query to only those that have changed since the last date and time JIRA issues were found for synchronization.

The default JIRA query used by the LeanKit Integration Service is:

project='<Project Name>' 
and (status='<First Selected Status>' or status='<Second Selected Status>' [or <additional statuses>]) 
and updated > '{0}' 
order by created asc

A full explanation of the query capabilities available for JIRA is beyond the scope of this documentation. Please consult your JIRA Query Language documentation.

Using a custom query for GitHub

The LeanKit Integration Service does not support custom queries for GitHub. Please use the Simple Selection option.

Assign Target project item statuses to LeanKit board lanes

Under the Lanes and States tab, click on a LeanKit board lane, and then select the Target project item statuses (states) that are appropriate for that lane. When new Target items are created or updated, a LeanKit card will be created in, or optionally moved to, the equivalent lane on the board. As cards are moved to different lanes, the associated Target item will be updated to the equivalent status.

In the following example, we are choosing Target item states “New,” “Ready,” and “To Do” to be assigned (mapped) to the LeanKit “To Do” lane.

image19.gif

Note: All statuses checked on the Selection tab must be mapped to a lane. The required statuses will remain highlighted until they have been added.

To remove an assigned status from a lane, click the ‘X’ next to the status.

Adding a custom state workflow

In some cases, a Target project may not allow an item’s state to move directly from state to another in one step. These projects enforce a “state workflow” that an item must progress through. You can add one or more workflows to each LeanKit lane to express the order of states an item must go through to match the equivalent state of the lane.

To add a new workflow:

  1. Select the appropriate lane.
  2. Check the box for Build Workflow.
  3. Select each state, in the correct order.
  4. Click the check mark icon when finished.

image05.gif

Note: The order of states and workflows added to a lane will be the same order the LeanKit Integration Service will attempt to set a Target system’s item state when updating.

Map Target item types to LeanKit card types

Under the Card Types tab, you can customize how the Target project’s item types are mapped to LeanKit card types.

To create a new card type mapping:

  1. Click the Add button.
  2. Choose a LeanKit card type from the first drop-down list.
  3. Choose a Target item type from the second drop-down list.
  4. Click the check mark icon to save.

image10.gif

To remove a card type mapping, click the ‘X’ icon next to the listed mapping.

Synchronization options

Under the Options tab, you can customize how the LeanKit Integration Service will keep the Target project and LeanKit board synchronized.

Create a new corresponding LeanKit card: When enabled, a new LeanKit card will be created each time a new item is created in the Target system that matches the selection criteria.

Create a new corresponding Target item: When enabled, a new Target item will be created each time a new LeanKit card is added to the board being monitored.

Update Cards: When enabled and a Target item is updated, the associated LeanKit card will be updated (e.g. Title, Description, or Due Date). This does not apply to changes to Target item state (see next).

Move Cards when State changes: When enabled and a Target item’s state is updated, the associated LeanKit card will be moved to the equivalent lane (if mapped).

Update Target Items: When enabled and a LeanKit card is updated or moved, the associated Target item will be updated (e.g. Title, Description, or Due Date).

When creating LeanKit cards, tag the card with the Target system: When enabled and a new card is created, the card will be tagged with the name of the Target system (e.g. TFS or JIRA). This is useful when integrating more than one Target system with a single LeanKit board.

image13.gif

Saving a configuration

Whenever you make changes to a LeanKit board to Target project mapping, please be sure to click the Save button to save your changes.

image11.gif

Activating and restarting the LeanKit Integration Service

The Activate… tab is used to review and enable changes to your configuration. After creating or updating a Target system and LeanKit board configuration, you must activate the new configuration before the LeanKit Integration Service will recognize those changes. A summary report is displayed of all the Target system project to LeanKit board mappings and configured options. After reviewing this report, click the Activate Now button to restart the service and enable the new or updated configuration.

image08.gif

Removing a Target system project to LeanKit board mapping

  1. If not already selected, click on the Board Configuration tab.
  2. On the left, click the LeanKit board and Target project mapping you wish to remove.
  3. On the right, click on the Options tab.
  4. At the bottom, click on Remove Mapping….
  5. Click Remove to confirm.
  6. Click on the Activate… tab.
  7. Click Activate Now to restart the service with the new configuration.

Note: Removing a mapping will stop items from being synchronized. However, it will not remove any items that have been created in LeanKit or the Target system as a result of the previous configuration.

image04.gif

 

Troubleshooting

Common Issues

When running the LeanKit Integration Service the first time, you see:

IntegrationService has Stopped Working

-or-

System.BadImageFormatException

This could be caused by not having the Microsoft .NET Framework 4.5 installed. Please see Requirements.

When trying to access the management application with your browser, you see:

ERR_CONNECTION_RESET

This may be due to a local firewall issue. You may need to either allow port 8090, or change the port number to something that is allowed by your local firewall, e.g. 8080. See Changing the default configuration port number.

When trying to connect to LeanKit, you see:

Could not connect to LeanKit. Please verify your credentials.

This could be due to the Integration Service being installed behind a proxy server. To configure the Integration Service to use a proxy server, edit IntegrationService.exe.config, and update the following configuration section just before the closing </configuration> tag. It should look something like:

<system.net>
<defaultProxy>
<proxy bypassonlocal="true" usesystemdefault="true" />
</defaultProxy>
</system.net>

Add a "useDefaultCredentials" setting.

<system.net>
<defaultProxy useDefaultCredentials="true">
<proxy bypassonlocal="true" usesystemdefault="true" />
</defaultProxy>
</system.net>

Or, if more granular control of the proxy is required, it could look something like:

<system.net>
<defaultProxy enabled="true" useDefaultCredentials="false">
<proxy usesystemdefaults="true" proxyaddress="http://192.168.1.10:3128" bypassonlocal="true" />
</defaultProxy>
</system.net>

For more proxy help, please review the documentation on .NET proxy configuration.

Viewing the logs

The LeanKit Integration Service logs all informational and error messages to the [InstallPath]/Log folder. A log file can assist in troubleshooting connection or synchronization issues. Each day’s logs will be stored in a file with the name [yyyyMMdd].txt.

Customize logging

The LeanKit Integration Service uses log4net, a very flexible open-source logging utility that can log activity to a variety of outputs. For example, log4net can be configured to log to a database such as SQL Server or Oracle, or send an email whenever an error occurs.

To customize how logs are generated, locate and edit the logging.config file found in the folder where the LeanKit Integration Service is installed. There are many examples provided in the log4net documentation.

 

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request

Comments

  • Avatar
    Andrew Gillan

    Is there a way to create multiple mappings between a TFS Team Project and a board?  I would like to be able to map the Area to horizontal swimlanes representing each Area in the Team Project.

  • Avatar
    David Neal

    @Andrew - Yes, it is possible to have multiple mappings between TFS Projects and LeanKit boards. In this case, you would need to set up multiple instances of the Integration Service, each with its own mapping. You would need to be careful with selecting states, project iterations, or use a custom TFS query, so that the instances of the Integration Service are not competing for the same work items to synchronize with LeanKit. Hope this helps!

     

  • Avatar
    Isaac Johnston

    Listing GitHub integration service on http://leankit.com/compare-editions/ is very deceptive as there is no indication you have to download and continuously run a local service.

    Not only is this inconvenient but it is impossible for us as the service is Windows-only. We have an explicit security policy that only permits using Mac workstations and Linux-based servers for anything that has access to company data.

    Come on LeanKit this needs to be part of what you provide on your own servers. This is supposed to be a SaaS after all!

  • Avatar
    Paul Davis

    I'm trying to setup multiple instances (one for TFS and one for github). I created two folders on the server for each instance. I updated the config for each to 8090 and 8091 respectively. I then ran: IntegrationService.exe install -instance "TFS" and IntegrationService.exe install -instance "github". I am able to connect to both 8090 and 8091. If I change the configuration for one, it's changed for both. I end up with both 8090 and 8091 being connected to TFS. What am I doing wrong?

  • Avatar
    David Neal

    @Paul - I wonder if the browser may be caching some of the configuration information. You might try starting your browser in "private" or "incognito" mode, configure one instance, then close and start a new private browser to configure the other instance. Or, you could try two different browsers, such as Firefox and Chrome. Let me know if this helps.

  • Avatar
    Martin Kelly

    As you guys are also using Zendesk, is there any chance you will release an integration?  It would also be great to hear how you are using Leankit to monitor and track issues reported to you via Zendesk.

  • Avatar
    David Neal

    Hi Martin,

    Yes, you can do this today using our Zapier integration. We use this ourselves to create cards from new support tickets that come to us from Zendesk.

  • Avatar
    David Neal

    @Isaac - Yes, our Integration Service is a Windows-based service that you must download and install locally. To support organizations that have TFS or JIRA installed locally, it required us to build a stand-alone application that could run in a customer's environment in order to communicate between the target system and LeanKit. Thanks for the feedback, and we'll definitely consider a SasS-only solution for those that are using hosted services such as GitHub.

  • Avatar
    Martin Kelly

    David one issue I have noticed with the Zapier integration is that it monitors a view in Zendesk.  If a new ticket comes into Zendesk and one of our staff change the ticket status before the "zap" runs, the ticket doesn't get picked up.  Do you have a process to manage that so new tickets ALWAYS get created in Leankit ?

  • Avatar
    Eamonn O'Connell

    A windows service written in .NET? Are there developers who still use Windows and don't work for Microsoft?

  • Avatar
    DiomexSoftware

    We've set up the TFS Integration but we have two smal Problems...

    ...when we assign a Card to a user, the realted TFS-Entity is not assigned to the related TFS-user

    ...we have mapped TFS-Tasks to a Special cardtype that is used as Task (subentities from another Task) but when we ad such a Card in leadkit the coresponding TFS-Task is not created ("outer" Card ist a TFS backlog item, "inner" Card should be a TFS-Task that is assigned to the related TFS-Backlogitem)

    ..is this possible? If yes... how?

  • Avatar
    Tom van Baarle

    I am very interested to go ahead with the integration service, but I had a few questions:

    • can we setup integration with a trial account or is a premium account required?

    • is the TFS backlog priority field taken into account for sorting tickets within one lane?

    • is it possible to establish mapping between TFS states and lane - horizontal swimlane combinations?  e.g. I want a board for our ops team, with bugs in one horizontal swimlane and change requests in another swimlane.

    • can a ticket be moved from one board (with mapping A) to another board (with mapping B)?  Main use case: ticket must flow from one team to another.  In TFS, we use (sub)areas for this purpose.

    • is it technically possible to map a target system ticket to multiple boards (assuming no simultaneous updates)? Just to understand how the integration works.

    Tx!

  • Avatar
    David Neal

    @DiomexSoftware:

    Correct. We currently do not synchronize back to TFS the assigned user. When a card is first created, we will attempt to assign the card to the same user the Work Item is assigned to, but we don't synchronize back changes to assigned users.

    If I understand you correctly, it sounds like you are referring to our task board feature in LeanKit where you can one or more task cards contained inside a card. We currently do not support synchronizing cards on task boards, only top-level cards.

  • Avatar
    David Neal

    @Tom:

    • Yes, a the Integration Service can be tested with a trial account.
    • The TFS work item priority is mapped to a Card's priority, but we do not automatically sort cards in a lane based on priority
    • Yes, it is possible to map different TFS Work Item types to specific horizontal swim lanes on a board. To do this, you would need to set up separate instances of the LeanKit Integration Service, one for each swim lane.
    • It is possible to move cards from one board to another. If you have mappings set up for each board, then changes to the card should continue to synchronize with TFS. 
    • Yes, it is possible to have the same target item synchronized with multiple boards in LeanKit. However, as you mentioned, you would not want to have two-way synchronization enabled on more than one board.
  • Avatar
    Jelle Vlassenbroeck

    We just started using this integration with Jira, but is it  possible there are still some issues?

    • If I exclude specific issue types (issues, inquiries, not relevant for dev team) they are synchronized to leankit nonetheless and mapped to card type 'Task', which is the default card type on the board.
    • Changes such as Card/issue type and assignee do not seem to get updated after an initial sync.

    Card/issue type and assignee are important to have displayed correctly on our kanban at all times. Ideally we would like to change them in Leankit or JIRA. All other issue updates will be done directly in JIRA.

  • Avatar
    Tom van Baarle

    Hi David,

     

    Some additional questions:

    • do you have any additional documentation on setting up multiple instances of the integration service?

    • can we setup two instances which map to the same horizontal swimlane of a board?  E.g. one sync of bugs based a a specific area; sync of PBI's based on another area. The reason for having two instances would be that we have one lane in which we divide bugs and PBI's over two horizontal swimlanes. In all other lanes, we want the bugs and PBI's to reside in the same horizontal swimlane.

  • Avatar
    David Neal

    @Tom - The two things you need to know when installing multiple instances of the Integration Service is changing the default configuration port number for each service, and, if you are installing as a Windows Service, using unique instance names for each instance. See "Installing more than one instance of the service" under Installing as a service.

    Yes, you should be able to set up two instances that map to the same horizontal swimlane on a board.

  • Avatar
    Tom van Baarle

    Another question: some TFS items are not synced initially, but only after a subsequent udpate within TFS.  Any idea what could cause this issue?

  • Avatar
    Tom van Baarle

    Yet another question:

    [System.ChangedDate] > '{0}' 

    Can we somehow 'override" this parameter?  I mean: use another timestamp as the starting point for initial syncing,

  • Avatar
    David Neal

    @Tom - As the Integration Service runs, it keeps track of the last query date in a file named "localstore.json." If you make modifications to your configuration, and want the service to "start over" with older work items, you'll need stop the service, delete the "localstore.json" file, and start the service again. The Integration Service will use the global setting "Synchronize items created after:" to perform it's initial query of TFS. Afterwards, it only queries for items that have changed since the last query, to make processing more efficient and prevent churn.

  • Avatar
    David Neal

    Hi Jelle,

    There are some limitations to synchronizing assigned users and card types beyond the initial synchronization of a JIRA issue.

    Could you open a support ticket with regards to your JIRA integration? You can do so by sending us an email using the address on the http://support.leankit.com home page.

  • Avatar
    Mo Karvan

    Hi, 

    I Completed all the steps successfully before "Mapping a Target project to a LeanKit board", the "Board Configuration" doesn't show any boards, it is empty, I looked at the logs, no error message. 

     

     

     

  • Avatar
    Derek Comartin

    Hey David,

    Syncing from LeanKit to VSO was working without issues then out of nowhere no new cards created in LeanKit are being created in VSO.

    When I create a card in VSO, I do see in the log:

     

    IntegrationService.Targets.TargetBase - Received board changed event for board [XXX]

    IntegrationService.Targets.TargetBase - Checking for updated cards.

    IntegrationService.Targets.TargetBase - Checking for added cards.

    IntegrationService.Targets.TargetBase - No Card Move Events detected event for board [XXX]

  • Avatar
    David Neal

    @Mo Karvan - I will open a support ticket to help you with this issue.

  • Avatar
    David Neal

    @Derek Comartin - I will open a support ticket to help you with this issue.

  • Avatar
    R Erwin

    Two questions:

    1. If a card is created in LeanKit, can the integration service set a specific field on a TFS Work Item when it is created? I have a custom Team field in my query so I want to set it to match the team using the board?

    2. If I have a lot of cards which existed in LeanKit before the integration service was setup, is there a way to trigger the Work Item creation event for them? An update doesn't appear to be enough.

    Thanks,

    Richard

  • Avatar
    David Neal

    @Richard

    1. There isn't any logic in the Integration Service to update a custom field in TFS. However, it would be possible to download the source code from our GitHub repository and add this feature.

    2. The only event that currently triggers creating a Work Item (when 2-way synchronization is enabled) is when a card is created. One work-around that may work is to first move the cards to another board. Then, with the Integration Service running, move the cards back to the original board. I've not tested this, but just looking at the way we handle board move events, it might create the desired results.

    https://github.com/LeanKit/LeanKit.IntegrationService

  • Avatar
    Andy Wall

    I have a question in relation to LeanKit - JIRA integration. In card types, I have it configured so Sub-Task = Sub-Task. My expectation was that the following would occur based upon my configuration:
    1) I create a JIRA task, it creates a corresponding LeanKit card
    2) I create a LeanKit card, it creates a corresponding JIRA task.
    3) If I create a sub-task to the JIRA ticket, it would create a sub-task under the corresponding LeanKit card.
    4) If I create a sub-task under a LeanKit card, it would create a sub-task under the corresponding JIRA task.

    The actual action is the following:
    1) If sub-task is created in JIRA, brand new LeanKit card of type Sub-Task is created with no parent card.
    2) If sub-task is created under parent LeanKit card, nothing happens in JIRA.

    Is this expected behaviour or is this a bug?

    Thanks

  • Avatar
    David Neal

    Hi Andy,

    The current Integration Service does not support taskboards. So, the behavior you describe is currently how the integration works. Cards will always be created without parent cards, and any cards created on a taskboard will not be synchronized back to the target system.

    The source code for the Integration Service is available at https://github.com/LeanKit/LeanKit.IntegrationService, in case you are interested in customizing it to fit your specific needs.

  • Avatar
    Tom van Baarle

    Hi David, when I uncheck the option 'Update cards', the checked action 'move cards' no longer seems to work... TFS state changes no longer trigger a lane change. Any thoughts on this one? Or is move cards an option that can only be used when update cards is checked? Would be a real bummer. Tx!