Difference between revisions of "Board Manager Business Process Workflow"

From Hornbill
Jump to navigation Jump to search
 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
+
{{Breadcrumb|[[Main Page|Home]] > [[Administration]] > [[Board Manager Administration |Board Manager]] > Business Process Workflow|Board Manager}}
−
__NOTOC__[[Main Page|Home]] > [[Administration]] > [[Board Manager Administration |Board Manager]] > Business Process Workflow
+
 
−
</div>
 
 
{|style="width: 100%"
 
{|style="width: 100%"
 
|- valign="top"
 
|- valign="top"
Line 16: Line 15:
  
 
== Related Articles ==
 
== Related Articles ==
 +
:* [[Board Manager]]
 
:* [[Business Process Designer]]
 
:* [[Business Process Designer]]
 
:* [[Request Variables]]
 
:* [[Request Variables]]
Line 61: Line 61:
 
|- valign="top"
 
|- valign="top"
 
|style="width:700px"|
 
|style="width:700px"|
−
[[File:bpmaddcommenttoboard.png|thumb|link=https://wiki.hornbill.com/images/9/9e/Bpmaddcommenttoboard.png|Add Comment to a Board]]
+
[[File:bpmremoverequestfromboard.png|thumb|link=https://wiki.hornbill.com/images/0/07/Bpmremoverequestfromboard.png|Add Card to a Board]]
 
==== Add Card To Board ====
 
==== Add Card To Board ====
 
Use this node to manually add a card to a Board at the required stage in a process.
 
Use this node to manually add a card to a Board at the required stage in a process.
Line 74: Line 74:
 
:: The name of the lane from the above specified board to which the card will be added
 
:: The name of the lane from the above specified board to which the card will be added
 
:* '''Lane Column'''
 
:* '''Lane Column'''
−
:: The column within a lane which the new card will be added to, if not specified the card will be added to the first column in the lane
+
:: The column within a lane which the new card will be added to, if not specified the card will be added to the first column in the lane. This option expects a zero based index to the column, so the supplied value should the column number minus 1.
 
:* '''Order'''
 
:* '''Order'''
 
:: The position the card will appear in on the lane of the board, if not specified the card will appear at the top of the lane.  You can use the '''Get Lane Information''' option to get the next available position for a card on the lane
 
:: The position the card will appear in on the lane of the board, if not specified the card will appear at the top of the lane.  You can use the '''Get Lane Information''' option to get the next available position for a card on the lane
Line 97: Line 97:
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="addRequestToBoard"></div>
 
<div id="addRequestToBoard"></div>
−
* Add Request to Board
+
* Get Card Information
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
Line 103: Line 103:
 
|- valign="top"
 
|- valign="top"
 
|style="width:700px"|
 
|style="width:700px"|
−
[[File:bpmaddrequesttoboard.png|thumb|link=https://wiki.hornbill.com/images/9/96/Bpmaddrequesttoboard.png |Add Request to Board]]  
+
[[File:bpmaddrequesttoboard.png|thumb|link=https://wiki.hornbill.com/images/9/96/Bpmaddrequesttoboard.png |Get Card Information]]  
−
==== Add Request to Board ====
+
==== Get Card Information ====
−
This operation will automatically add a request to a selected Service Manager Board or move a request from one list to another. This particularly works well on a Board where users have been given View Access only and the BPM takes control of all the card movements.
+
This Hornbill Automation retrieves the details about a card on a board. This includes the lane that the card resides in on the board, the progress made on the card, the order of the card on the board and other useful properties. This node can be used once at the beginning of a Workflow stage and does not need to be used each time you want to move or remove a card in a stage.
 +
 
 
==== Options ====
 
==== Options ====
−
:* '''Request Id'''
 
−
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
 
 
:* '''Board'''
 
:* '''Board'''
−
:: The name of the Service Manager Board on which the Request card will be added
+
:: This is a mandatory option and is needed to identify the board that the card resides in.
−
:* '''List'''
+
:* '''Lane'''
−
:: The name of the list from the above specified board to which the Request card will be added
+
:: This option can be set with name of the lane that the card resides in. This is optional and should only be set when a card with the same key appears with two different types on the same board. In Service Manager,
 +
:* '''Key'''
 +
:: The key identifier for the card. For example in Service Manager, the Id of a Request is the key identifier.
 
<br>
 
<br>
 
<br>
 
<br>
Line 123: Line 124:
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div id="AddUniqueIdForAnchor"></div>
 
<div id="AddUniqueIdForAnchor"></div>
−
* Remove Request from Board
+
* Move Card on Board
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
Line 129: Line 130:
 
|- valign="top"
 
|- valign="top"
 
|style="width:700px"|
 
|style="width:700px"|
−
[[File:bpmremoverequestfromboard.png|thumb|link=https://wiki.hornbill.com/images/0/07/Bpmremoverequestfromboard.png|Remove Request from Board]]  
+
[[File:bpmremoverequestfromboard.png|thumb|link=https://wiki.hornbill.com/images/0/07/Bpmremoverequestfromboard.png|Move Card on Board]]  
−
==== Remove Request from Board ====
+
==== Move Card on Board ====
−
Use this option to remove a Request from a Service Manager Board at a specific stage in a process.   
+
Use this option to move a card between lanes on a board.   
 
==== Options ====
 
==== Options ====
−
:* '''Request Id'''
+
:* '''card Id'''
−
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
+
:: This is a mandatory setting and is needed to identify which card to move on the board.  You can get the card id by first having a '''Get Card Information''' node in the stage on the process, and using the output param as a variable for this field using the variable picker
−
:* '''Board'''
+
:* '''Lane'''
−
:: The name of the Service Manager Board from which the Request card will be removed.
+
:: The name of the lane on the board which you wish to move the card into
 +
:* '''Order'''
 +
:: The position the card will appear in on the lane, if not specified it will appear at the top of the lane
 
<br>
 
<br>
 
<br>
 
<br>
Line 145: Line 148:
 
<!-- ************************************************END OF OPERATION DOCUMENTATION************************************************** -->
 
<!-- ************************************************END OF OPERATION DOCUMENTATION************************************************** -->
  
−
==Lane==
 
−
Use the Boards nodes to automatically add, move or remove a Request from an existing Board. Requests can be added to one or multiple Boards in Service Manager, and can be moved between Lists on specified Boards automatically.
 
−
 
−
<!-- ******************************************************************************************* -->
 
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
−
<div id="AddCommentToBoard"></div>
+
<div id="AddUniqueIdForAnchor"></div>
−
* Add Comment To Board
+
* Remove Card from Board
−
<div class="mw-collapsible-content">
 
−
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
−
::{|
 
−
|- valign="top"
 
−
|style="width:700px"|
 
−
[[File:bpmaddcommenttoboard.png|thumb|link=https://wiki.hornbill.com/images/9/9e/Bpmaddcommenttoboard.png|Add Comment to a Board]]
 
−
==== Add Comment To Board ====
 
−
Use this node to manually add a Comment card to a Service Manager Board at the required stage in a process.
 
−
==== Options ====
 
−
:* '''Board'''
 
−
:: The name of the Service Manager Board on which the Comment card will be added
 
−
:* ''' List '''
 
−
:: The name of the list from the above specified board to which the Comment card will be added
 
−
:* '''Comment'''
 
−
:: The actual comment, as it will appear on the card on the Board.
 
−
|}
 
−
</div>
 
−
</div>
 
−
</div>
 
−
<!-- **************************************END OF OPERATION DOCUMENTATION***************************************************** -->
 
−
 
 
−
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
−
<div id="addRequestToBoard"></div>
 
−
* Add Request to Board
 
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
Line 181: Line 156:
 
|- valign="top"
 
|- valign="top"
 
|style="width:700px"|
 
|style="width:700px"|
−
[[File:bpmaddrequesttoboard.png|thumb|link=https://wiki.hornbill.com/images/9/96/Bpmaddrequesttoboard.png |Add Request to Board]]  
+
[[File:bpmremoverequestfromboard.png|thumb|link=https://wiki.hornbill.com/images/0/07/Bpmremoverequestfromboard.png|Remove Card From Board]]  
−
==== Add Request to Board ====
+
==== Remove Card From Board ====
−
This operation will automatically add a request to a selected Service Manager Board or move a request from one list to another.  This particularly works well on a Board where users have been given View Access only and the BPM takes control of all the card movements.
+
Use this option to remove a card from a specific board
 
==== Options ====
 
==== Options ====
−
:* '''Request Id'''
+
:* '''card Id'''
−
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
+
:: This is a mandatory setting and is needed to identify which card to remove on the board.  You can get the card id by first having a '''Get Card Information''' node in the stage on the process, and using the output param as a variable for this field using the variable picker
−
:* '''Board'''
+
:::* It is possible that a card resides on different boards, and will therefore have different card id's for each board. As such you will need to obtain the card id for the board you wish to remove the card from
−
:: The name of the Service Manager Board on which the Request card will be added
+
:* '''Remove Completely'''
−
:* '''List'''
+
:: The default is false, and the card will be '''archived''', if set to '''true''' the card will be completely removed from the board and will not be able to be manually un-archived.
−
:: The name of the list from the above specified board to which the Request card will be added
 
 
<br>
 
<br>
 
<br>
 
<br>
Line 197: Line 171:
 
</div>
 
</div>
 
</div>
 
</div>
−
<!-- **************************************END OF OPERATION DOCUMENTATION***************************************************** -->
+
<!-- ************************************************END OF OPERATION DOCUMENTATION************************************************** -->
  
 +
==Lane==
 +
Use the Lane operation to get information about the card position and order in the lane, in order to have the information available when using other operations like '''Add to Board''' and '''Move on Board''' if you want to add a card to the next position on a lane, as appose to always adding it to the top.
 +
<!-- ******************************************************************************************* -->
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:700px">
−
<div id="AddUniqueIdForAnchor"></div>
+
<div id="GetLaneInformation"></div>
−
* Remove Request from Board
+
* Get Lane Information
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
 
<div style="border:1px solid #e6e6e6; background:#f2f2f2; width:99%; padding:4px; margin-bottom:10px;">
Line 207: Line 184:
 
|- valign="top"
 
|- valign="top"
 
|style="width:700px"|
 
|style="width:700px"|
−
[[File:bpmremoverequestfromboard.png|thumb|link=https://wiki.hornbill.com/images/0/07/Bpmremoverequestfromboard.png|Remove Request from Board]]  
+
[[File:bpmaddcommenttoboard.png|thumb|link=https://wiki.hornbill.com/images/9/9e/Bpmaddcommenttoboard.png|Get Lane Information]]
−
==== Remove Request from Board ====
+
==== Get Lane Information====
−
Use this option to remove a Request from a Service Manager Board at a specific stage in a process.
+
Use this node to obtain the next card position and order on a given lane on a board.  Once this node has been used, you can use the output params from it via the variable picker to insert new cards on to boards and lanes using the '''Add to Board''' and '''Move on Board''' operations.
 
==== Options ====
 
==== Options ====
−
:* '''Request Id'''
 
−
:: This is a mandatory setting that uses a variable to hold the Request Id of the request that is using this BPM.  This should be set to ''Auto''.
 
 
:* '''Board'''
 
:* '''Board'''
−
:: The name of the Service Manager Board from which the Request card will be removed.
+
:: The name of the Board on which the lane exists
−
<br>
+
:* '''Lane'''
−
<br>
+
:: The name of the lane against which you wish to obtain the information
 
|}
 
|}
 
</div>
 
</div>
 
</div>
 
</div>
 
</div>
 
</div>
−
<!-- ************************************************END OF OPERATION DOCUMENTATION************************************************** -->
+
<!-- **************************************END OF OPERATION DOCUMENTATION***************************************************** -->
−
 
 
  
 
[[Category:Board Manager]]
 
[[Category:Board Manager]]

Latest revision as of 19:26, 10 November 2021

Home > Administration > Board Manager > Business Process Workflow Index

Introduction

The Board Manager Business Process Workflows are used to automate the creation, movement and management of Boards, Lists and Cards.

Board Manager options can be used in other Hornbill Applications through the Business Process Designer.

  • Use the Automated Tasks node, and find the Board Manager options under the Application drop down.

Related Articles

Board

Use the Board node get Board Information

  • Get Board Information
Get Board Information

Get Board Information

Use this node to retrieve information about a specific Board

Options

  • Application
The name of the Application the Board belongs too - Mandatory
  • Entity
The name of the list from the above specified board to which the Comment card will be added
  • Entity ID
The actual comment, as it will appear on the card on the Board.
  • Board
The name of the board you wish to get information about

Card

Use the Cards nodes to automatically add, move, get info or remove a CARD from an existing Board. Cards can be added to one or multiple Boards in Service Manager, and can be moved between Lists on specified Boards automatically.

  • Add Card To Board
Add Card to a Board

Add Card To Board

Use this node to manually add a card to a Board at the required stage in a process.

Options

  • Application
Optionally choose which application the card you want to add to the board originates from. The benefit of doing this, is it will automatically define and populate the values for the Title, Content, Link, Card Type options below. If you want to manually set these values for the card you are adding, then leave this option as Auto otherwise it will overwrite any manually entered values in the other options mentioned previously.
  • Key
The Key identifier for the new card, in the case of Service Manager requests this will be Requestid
  • Board
The name of the Board on which the card will be added
  • Lane
The name of the lane from the above specified board to which the card will be added
  • Lane Column
The column within a lane which the new card will be added to, if not specified the card will be added to the first column in the lane. This option expects a zero based index to the column, so the supplied value should the column number minus 1.
  • Order
The position the card will appear in on the lane of the board, if not specified the card will appear at the top of the lane. You can use the Get Lane Information option to get the next available position for a card on the lane
  • Value
A value for the card, for example scrum points, cost
  • Progress
A numerical value between 0-100 to represent the progress to completion on the card
  • Title
The title of the card on the board. This value will be ignored if the Application option is populated
  • Content
The content of the card on the board. This value will be ignored if the Application option is populated
  • Link
This will allow you to open in a pop up or other tab if configured. This value will be ignored if the Application option is populated
  • Card Type
The type of the new card, there are various card types to choose from, please review these on the Card Types wiki page. This value will be ignored if the Application option is populated
  • Get Card Information
Get Card Information

Get Card Information

This Hornbill Automation retrieves the details about a card on a board. This includes the lane that the card resides in on the board, the progress made on the card, the order of the card on the board and other useful properties. This node can be used once at the beginning of a Workflow stage and does not need to be used each time you want to move or remove a card in a stage.

Options

  • Board
This is a mandatory option and is needed to identify the board that the card resides in.
  • Lane
This option can be set with name of the lane that the card resides in. This is optional and should only be set when a card with the same key appears with two different types on the same board. In Service Manager,
  • Key
The key identifier for the card. For example in Service Manager, the Id of a Request is the key identifier.



  • Move Card on Board
Move Card on Board

Move Card on Board

Use this option to move a card between lanes on a board.

Options

  • card Id
This is a mandatory setting and is needed to identify which card to move on the board. You can get the card id by first having a Get Card Information node in the stage on the process, and using the output param as a variable for this field using the variable picker
  • Lane
The name of the lane on the board which you wish to move the card into
  • Order
The position the card will appear in on the lane, if not specified it will appear at the top of the lane



  • Remove Card from Board
Remove Card From Board

Remove Card From Board

Use this option to remove a card from a specific board

Options

  • card Id
This is a mandatory setting and is needed to identify which card to remove on the board. You can get the card id by first having a Get Card Information node in the stage on the process, and using the output param as a variable for this field using the variable picker
  • It is possible that a card resides on different boards, and will therefore have different card id's for each board. As such you will need to obtain the card id for the board you wish to remove the card from
  • Remove Completely
The default is false, and the card will be archived, if set to true the card will be completely removed from the board and will not be able to be manually un-archived.



Lane

Use the Lane operation to get information about the card position and order in the lane, in order to have the information available when using other operations like Add to Board and Move on Board if you want to add a card to the next position on a lane, as appose to always adding it to the top.

  • Get Lane Information
Get Lane Information

Get Lane Information

Use this node to obtain the next card position and order on a given lane on a board. Once this node has been used, you can use the output params from it via the variable picker to insert new cards on to boards and lanes using the Add to Board and Move on Board operations.

Options

  • Board
The name of the Board on which the lane exists
  • Lane
The name of the lane against which you wish to obtain the information
Retrieved from "https://wiki.hornbill.com/index.php?title=Board_Manager_Business_Process_Workflow&oldid=28258"