Important Information: By reading this Help page, you will get to know how to manage the Admin Settings in the Old Board Layout. If you want to manage the same in the New Board layout, see this Help page.
As an Account Admin, you can define important settings in SwiftKanban for the enterprise from the Settings view. The settings are inherited onto the boards such as Card Types with the configuration and links, Master Lists, Board Templates, and Admin Policy (optional settings for application behavior).
To define the settings for the enterprise, go to Admin > Settings from the Main menu.
The Settings enlists the card types existing in the organization. Other than the default card types i.e. Issues, Defects, and User Stories, an organization can define their own Card Types based on their business need.
The actions that can be performed through Side toolbar are:
- Create Card Type
- Delete Card Type
- Master Lists
- Card Type Links
- Admin Policy
- Card Designer
- Custom Common Field
- Broadcast Message
- Enable/Disable Planned Dates for Card Types
The List view displays the default card types along with the attributes such as Short Code, Card Color, etc. You can sort the card types in ascending/descending order by clicking the arrow on the Card Name or Short Code column.
- Create your own Card Type
- Add and Modify Attributes of a Card Type
- Design Card Sticky
- Delete a Card Type
- Define Master Lists
- Defining Links Between Card Types
- Working with Admin Policies
- Custom Common Fields on the Card View
- Create Kanban Board Templates
- Add Broadcast Message
- Filtering by Custom Common Field
- Bulk update to Enable/Disable Planned Dates for Card Types
Create your own Card Type
The iForms (Intelligent Forms) with a drag-drop interface helps to capture any additional business attributes specific to your business. You can define your specific Class of Service (CoS) definitions, Sizing parameters or other custom attributes for each Card Type.
To create a card type see Define Card Types.
Add and Modify Attributes of a Card Type
To add and modify attributes of a card type, see the Define Card Types section.
You can also add attribute values to a list of attribute values. For example, You may want to add an attribute value, UI Enhancement to an attribute User Story Classification in the User Story card type. See Define Master Lists.
Go to the Card Designer view by navigating to Admin > Settings > Card Designer.
You can select the Card Designer based on New or Old Card layout. To move to any of them, click the Toggle icon.
Design Card Sticky
The card designer allows you to configure more attributes and icons compared to the old card designer with a better look and feel. The first row of the card shows fixed attributes like the Card ID, Title, Profile Pic, Options, and three flags and actions. The second and the third row show the attributes that are selected in Card Attribute on the right side of the window. The last row shows the flags and icons.
To view an attribute with its values, select it in the Attributes menu. To hide it, clear the selection. To change the order, just drag the attribute and drop it between the two attributes as you want. Make the changes once the previous change is saved successfully.
To view actions and flags on a card, select the checkboxes in the top and bottom icon toolbar. The Actions are shown on the first half of the last row of the card. The Flags are shown on the second half of the last row of the card. A total of 8 flags and actions can be shown in this row (four flags and four actions). The bottom icons can be shown by selecting them in the bottom toolbar whereas the top icons can be shown by selecting them in the top toolbar.
Note that the default enterprise settings are inherited onto the board. However, if the board has changed the configuration, the changes will reflect for the board, overriding the enterprise settings. For example, if the Admin has hidden the ‘Rank’ for the Enterprise and the attribute is seen on the board, it means that it is not hidden on that board. The change made in the enterprise will not be inherited into an existing board unless the changes are made to the board.
You can delete a card type only if it is not used on any board i.e. you have not created a card of the card Type in your backlog or on the board.
Define Master Lists
Master Lists are used to create a field, which will contain certain attributes related to this field. There are a few default Master Lists such as Class Of Service with values such as Expedite, Fixed Delivery Date, Standard Class, and Intangible Class.
To know more about how to create, update and use the mapping feature of the master list, click here.
Creating Order for List of Values
To display the LOVs in fields in the order you want, double-click the Position cell and enter the position value for that attribute value. Similarly, you can reorder the attribute values to appear in the fields of card types.
Card Type Links feature lets you link card types to indicate dependencies/relationships. Thus, when cards are created on the board, only cards of these card types can be linked to each other based on these settings. For example, by linking a user story to a defect, you can later, trace the origin of a user story and understand the defect which led to the development of that feature.
Defining links between cards can be interpreted as one-way or two-way dependencies depending on the context of the cards. These links can be defined in a loosely-coupled manner for greater flexibility between cards in the same board or cards across different boards, or across Lanes.
Tips: We have an exciting in-app Learning Enabler, called Challenges that would help you learn and create links between card types interactively. Please navigate to Help & Support > Challenges from the top level menu and try out the Challenges.
Linking Across Card Types
The capability to define the link between different card types greatly helps to create dependencies/links between different work-items such as Features and user stories, defects and user stories, and so on. Teams can track the flow from feature level to the task level and gain a wider insight into progress.
The Linking cards feature in SwiftKanban enables linking across Kanban Boards. At the Portfolio level, stakeholders can track investment themes brought on the board through the Planning Board and Execution board.
For example, a team tracks Epics on a Planning Board and other teams execute the Features and User Stories on an Execution Board. You can create links from Epics to the Features or Users Stories on the Execution Board. Similarly, you create links from Features and User Stories to Epics on the Planning Board.
Linking Card Types Across Lanes
Teams, who track Features and User Stories on the same board but on different Lanes, can create links between Features and User Stories. This helps to track the Feature execution in the same view.
Defining Links Between Card Types (Other Links View)
SwiftKanban allows you to define links between card types in a very intelligible interface. You can add and remove the links and interpret the links easily.
Go to Admin > Settings> and click the Card Type Links icon on the toolbar. In the Other Links view, choose a card type from the list.
The Other Links view displays the card in the center. If links are already set it displays the links to the card types at the backdrop with the selected card type, highlighted.
For example, in the image below, you can see:
- Upward Links: The Defect card is linked to User Stories, Defects, and Issues card types on the left. This is an upward link from the Defects card type to these card types. Subsequently, when a Defect is linked upward to a user story on a board, it indicates that the User Story has originated from the Defect.
- Downward Links: That Defect card type is also linked on the right to a Defects card type. This is a downward link to the Defect card type. So, when a defect is linked downward to a Defect, it indicates that the Defect was a result of another defect.
You can add and remove links to the card types and define links that can be used across boards in your enterprise.
Note that you will be able to add upward/downward links only if those card types are not linked upward/downward. You can add links only to the card selected in the Choose Card Type list and cannot create links further to the linked card types. To create further links, select that card type in th Choose Card Type list and then add links.
To add an upward link to a card type:
- Choose the card type from the list.
- Click the Add upward link icon on the card type. In the card type list, select the card type that you want to link and click the Save icon. To link multiple card types, use CTRL + click to select multiple card types. The list displays only those card types that are not yet linked upward.
The card type is displayed on the left connected from the Defect card type.
To add a downward link to a card type:
- Choose the card type from the list.
- Click the Add downward link icon. In the new card type link, select the card type that you want to link and click the Save icon. To link multiple card types, use CTRL + click to select multiple card types. The list displays only those card types that are not yet linked downward.
The card type is displayed on the right connected from the Defect card type.
To remove the upward or downward link from the selected card type, click the Delete upward/downward link icon (x) on the card type that you want to disconnect.
After you have defined links between card types, the team members can link cards according to the settings. For example, f there is no upward link defined from a Defect card type to a User Story card type, team members will not be able to link user stores to defects upward.
Note: SwiftKanban lets you define of a parent-child relationship between different card types. This can be useful in situations where a larger (or parent) cards needs to be broken down into several smaller (or child) cards for better planning and execution. This entire Card Hierarchy approach in SwiftKanban is through a highly visual interface that enables linking new child cards and existing cards to parent cards.
The Custom Common Field enables you to customize the information for a task in the Card View by adding the custom fields in the card.
It gives you the flexibility to customize the attributes of the card. Depending on the requirement the customization can be done at the Admin level as well as at the Board level.
Using the Custom Common Field feature, you can perform the following configuration related to custom fields:
- At an Admin level, add a custom field, which is common across all card types. You can also set the field type, input method, icon, and other details for that Custom Common Field.
- At a board level, take a call whether you want to show that custom field on the Card View. So, you have a choice of showing that field in one board and hiding in another
Adding Custom Common Fields at the Admin Level
Tips: We have an exciting in-app Learning Enabler, called Challenges that would help you learn and add the custom common fields at the Admin level interactively. Please navigate to Help & Support > Challenges from the top level menu and try out the Challenges.
These Custom Common Fields which are created at the Admin level can be shared across all the boards.
- Click the Menu iconthat is present at the top of the Kanban board, go to Admin > Settings.
- Click the Custom Common Field icon The Custom Common Fields page is displayed.
- To create a common field, click the Create Common Field icon from the Side toolbar.
- In the new field, enter the following details:
|Field Label||Name of the Custom Common field|
Note: It is not visible to the user under Card View.
|Mandatory||Decide whether you want compulsory input for that particular field.|
|Disabled||Hide the field from the card by selecting Yes from the drop-down. By default, it will be No.|
|Input Method||Manual Entry of values|
|Master List||Once you select the Input Method as a Static List, this field will be activated, and the dropdown values will display all the Master Lists. Select the desired Master List from the drop-down and set its Default Value.|
|Default Value||Based on the Master List you have selected, the related default values will be displayed as a drop-down value. Select the most appropriate default value.|
|Include in List View||If you want to add fields in Card List View, then select Yes from the drop-down.|
|Field Icon||It is a symbol or indicator that will help you identify a particular field. Click the edit view under Field Icon to get a list of icons. Select any one icon from the list that will best define your field.|
- After adding each Custom Field, click on the Save icon from the Side toolbar.
Adding Custom Common Fields at the Board Level
You can share the Custom Fields which are created at the board level across all card types for those particular boards.
- Click the Workspace icon and select the desired board.
- From the Side toolbar, click the Board Editior icon.
- To open the Card Designer, click the Card Designer icon from the Side toolbar.
- From the list of Custom Fields select the desired fields by clicking the checkbox. Now the selected fields will be displayed across all the card types for that particular board.
Converting Card Type Specific Fields to Custom Common Fields
This feature helps you mark the existing custom fields as Custom Common Fields.
You can create your own fields for each Card field editor, depending on the requirement. If you require a particular field in all the Card Types, then you can add with the help of the Custom Common Field icon as mentioned above. But if you already have created a field for few Card Types and now you decide to add the same field for remaining Card Types then the Add as Custom Common Field icon will solve the issue.
For example, you have 10 Card Types, of which you have added a custom field of field type: Integer to six Card Types. Now you have decided to add this field as a Common Field for all Card Types (including the ones that will be created in the future).
To achieve this, add the same custom field to the remaining four Card Types, then go to Custom Common Fields Page and from the toolbar, click the Add as Custom Common Field icon.
The Add as Custom Common Field icon is available only when the same field (with the same field label and same field type) is added on all Card Types.
- To add fields into Card Field editor, go to Admin and click the Settings option.
- Double click the Card Type to add custom fields.
- Under Layout, scroll down till the end and click the plus icon to add a new row, now drag required custom fields from the Available Fields Types section.
- Once you have added the field types under the Layout tab, you will get the attributes related to that particular fields to type under Settings. Add Field Label and Field Type.
Note: For each Card Type, the Field Label and Field Type should be the same.
- Go to Click the Menu icon that is present at the top of the Kanban board, go to Admin > Settings.
- Click the Custom Common Field icon.
- To convert fields into Custom Common Fields, click on Add as Custom Common Field icon.
Note: Irrespective of a field being enabled or disabled at the Admin level, a custom common field is always visible in the Card Designer at the Board level. However, to edit the values of the same common field, you need to enable it at the Admin level.
The Custom Common Field is available in the Board Filter if the Input Method is Static List for the respective field.
You can also filter cards under All Cards Section, as per the custom common fields.
Add Broadcast Message
The Broadcast Message feature helps to keep the entire team aware of important announcements. Only the admin has permission to broadcast a message.
- Go to Admin >> Settings
- Click the Broadcast Message icon on the Side toolbar at the left.
- Add your message in the Broadcast Message dialogue box and click Submit.
- All users of the account on login will be able to view this message at the right bottom of the screen.
Note: The broadcasted message persists on the screen till you don’t remove the message from the Broadcast Message dialogue box and click Submit.
Bulk update to Enable/Disable Planned Dates for Card Types
To enable or disable the Planned Start Date and Planned Finished Date for card types that are used to track the Planned duration in the Agile Program Management dashboard, perform the following steps:
- Go to Admin >> Settings
- Click the Planned Dates for Card Types icon on the Side toolbar at the left.
- Select the card types for which you want to enable to Planned Start Date and Planned Finished Date fields and click Submit.
- To disable the Planned Start Date and Planned Finished Date fields for the card types in bulk, unselect the card types and click Submit.