FIRESTART BPM Suite Integration

Following article describes information about KanBo integration with Prologics FIRESTART BPM SUITE.


Content

1. Prerequisites

2. Installation

3. List of actions

4. First steps

5. Troubleshooting

6. Actions details


Prerequisites

  • KanBo 2.2.0-ca5b78e 2016.04.26
  • KanBo.Client.dll deployed to GAC
  • KanBo Service certificate configured in KanBo web.config (see more here)
  • FireStart 3.00 Build: 300602261 (26.02.2016)

Installation

  1. Download KanBo Actions
  2. Start PROLOGICS FireStart ClienKanBo integration with  Prologics FIRESTART BPM SUITE3.Click Menu in the top left corner and select PreferencesKanBo integration with  Prologics FIRESTART BPM SUITE4.Navigate to Extensions -> Activities5. Click Add / Update on the bottom of the applicationKanBo integration with  Prologics FIRESTART BPM SUITE6.Navigate to location where you extracted downloaded KanBo actions and select them all and click Open button.KanBo integration with  Prologics FIRESTART BPM SUITE7.Within few seconds they should appear in the applicationKanBo integration with  Prologics FIRESTART BPM SUITE8.Deploy KanBo.Client.dll to GAC
    • Run windows command prompt as administrator
    • Type 'cd <filepath>' where <filepath> is a path to 'Helpers' folder, eg.'cd C:\Users\Administrator\Desktop\KanBo Actions\Helpers'
    • Now type 'gacutil -i KanBo.Client.dll'
    • Now after importing actions to FireStart you can use them freely.

List of actions

Board actions

  1. Add Board
  2. Add Chat Message
  3. Add User to Board
  4. Change Board color
  5. Close Board

List actions

  1. Add List
  2. Change List Settings
  3. Move List
  4. Remove List

Card actions

  1. Add Card
  2. Add Checklist
  3. Add Checklist item
  4. Mark Checklist item as complete
  5. Mark Checklist item as incomplete
  6. Add Comment
  7. Add Document
  8. Add Label
  9. Add Note
  10. Add User to Card
  11. Remove User from Card
  12. Get Card
  13. Archive Card
  14. Delete Card
  15. Move Card
  16. Remove Document
  17. Remove Due Date
  18. Remove Note
  19. Set user as responsible
  20. Set Due Date
  21. Transfer Card

First steps

Configure variables with KanBo settings

Each action has to have configured KanBo authentication parameters. To simplify process creation we do recommend to store them in the process variables.

KanBo integration with  Prologics FIRESTART BPM SUITE


Actions configuration

Every added KanBo action has to be configured. Once you move them from actions toolbox select Edit Workflow Bindings after right click.

KanBo integration with  Prologics FIRESTART BPM SUITE


As you can see for most of action parameters we referenced variables. You can also store action output data in the variables and reuse them in other actions.

KanBo integration with  Prologics FIRESTART BPM SUITE



Troubleshooting

PROLOGICS logs location: C:\Program Files\PROLOGICS\PROLOGICS Resources\Logs

Navigate to Workflows in Designers section and select running/finished process. As you can see below in the execution info there was a problem with KanBo list name.

Actions details

Board actions

  1. Add Board
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Required parameter for board creation. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5
    Group title Specify the Groupt title to place new Board.
    Board title Specify Board title.
    Template title Optional parameter to create new board from template.
    Board color Specify board tile color from given color set.
    Board id Optional output parameter to store ID of new board. Can be stored in workflow variable and reused in other actions.
  2. Add Chat Message
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Required parameter for board creation. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5
    Board id Specify the ID of board in which post message in Board Chat.
    Message Compose message. You can also use variables.
    Message id Optional output parameter to store ID of new message. Can be stored in workflow variable and reused in other actions in the future.
  3. Add User to Board
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Required parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5
    Board id Specify the board id to which add users. You can reuse variable from Add Board or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-3
    Users Speficy users to add to board. Use account name. You can provide multiple values separated semicolons e.g.: i:0#.w|developer\duda;i:0#.w|developer\rutkowski;i:0#.w|developer\michalski Users must be added on tha lading page first.
  4. Change Board color
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Required parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5
    Board id Specify the board id in which change tile color. You can reuse variable from Add Board or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-3
    Board color Select desired color.
  5. Close Board
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Board id Specify the board id to close. You can reuse variable from Add Board or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-3

List actions

  1. Add List
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Board id Specify the board id in which create new list. You can reuse variable from Add Board or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-3
    List title Specify new list's title.
    List id Optional output parameter to store ID of new list. Can be stored in workflow variable and reused in other actions.
  2. Change List Settings
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Board id Specify the board id in which change list settings. You can reuse variable from Add Board or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-3
    List title Specify List title in which change settings.
    List color Specify color for new list.
    Igonre due dates Decide whether list should ignore due dates or not. They will not be indicated on cards and timeline.
  3. Move List
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Board id Specify the board id in which move list. You can reuse variable from Add Board or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-3
    List title Specify List title to move It's case sensitive.
    New list position Specify list position e.g. 1.
  4. Remove List
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Board id Specify the board id in which you want delete list. You can reuse variable from Add Board or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-3
    List title Specify List title to delete.

Card actions

  1. Add Card
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Board id Specify the board id in which create new card. You can reuse variable from Add Board or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-3
    List title Specify List title in which place new card. It's case sensitive.
    Card title Provide name for your new card.
    Template title You can optionally specify card template to use.
    Card id Optional output parameter to store ID of new card. Can be stored in workflow variable and reused in other actions.
  2. Add Checklist
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Card id Specify the card id in which create new checklist. You can reuse variable from Add Board or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#card-32442
    Checklist title Specify checklist title to create.
    Chcecklist id Optional output parameter to store ID of new checklist. Can be stored in workflow variable and reused in other actions.
  3. Add Checklist item
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Card id Specify the card id in which create new checklist item. You can reuse variable from Add Card or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#card-32442
    Checklist title Specify Checklist title in which place new item. It's case sensitive.
    Checklist item title Provide name for your new checklist item.
    Card id Optional output parameter to store ID of new checklist item. Can be stored in workflow variable and reused in other actions.
  4. Mark Checklist item as complete
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Card id Specify the card id in which mark checklist item as complete. You can reuse variable from Add Card or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-32442
    Checklist tile Specify Checklist title in which mark element as complete. It's case sensitive.
    Item position Specify item position to check e.g 1.
  5. Mark Checklist item as incomplete
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Card id Specify the card id in which mark checklist item as incomplete. You can reuse variable from Add Card or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-32442
    Checklist tile Specify Checklist title in which mark element as incomplete. It's case sensitive.
    Item position Specify item position to uncheck e.g 1.
  6. Add Comment
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Card id Specify the card id in which post message. You can reuse variable from Add Card or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-32442
    Comment Compose your message. You can also user variables to make it dynamic.
  7. Add Document
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Card id Specify the card id to which add document. You can reuse variable from Add Card or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-32442
    Document title Specify document title to add to card. Document must be already added to board document library.
  8. Add Label
    Activity data Description
    KanBo host url Provide KanBo url without /instances/{ID} part. e.g https://webcon.kanboland.com. We strongly recommend to configure this parameter in workflow variable.
    KanBo instance id Specify KanBo instance id eg. 1. Instance ID can be found in the URL when in KanBo eg. https://kanbo-online-kanbo.azurewebsites.net/intranet/1 We strongly recommend to configure this parameter in workflow variable.
    Certificate path Certificate location on the server e.g. C:\Certs\kanbotestapp.pfx. You can see here how to generate certificate. We strongly recommend to configure this parameter in workflow variable.
    Certificate password Password of your certificate. We strongly recommend to configure this parameter in workflow variable.
    User id Optional parameter to act in a context of user. User ID can be found in the URL of MyBoard e.g https://kanbo-online-kanbo.azurewebsites.net/intranet/1#myboard-5 If you leave this field empty action will be performed in a context of service and you you see name provided in the KanBo web.config <provider id="app" type="AppSignedService" name="Your service">
    Card id Specify the card id to which assign label You can reuse variable from Add Card or take ID form the URL e.g http://kanbo-online-kanbo.azurewebsites.net/intranet/1#board-32442
    Label title Specify document label title to add to card. You can add multiple labels separated by semicolons e.g. Label 1; Label2
  9. Add Note
  10. Add User to Card
  11. Remove User from Card
  12. Get Card
  13. Archive Card
  14. Delete Card
  15. Move Card
  16. Remove Document
  17. Remove Due Date
  18. Remove Note
  19. Set user as responsible
  20. Set Due Date
  21. Transfer Card
Workflows

Is this article helpful for you?