Ideagen Boards admin guide
Who is this article for?
Product and project team admins
Access to a User Acceptance Testing (UAT) area is required.
The Ideagen Boards modules are used by Product and Projects teams to track requirements, configuration changes and bugs as products are implemented. The solution consists of the following modules:
The primary modules users interact with are the Board Item and Board Requirement modules. Admins define the necessary Board Titles (boards) and Board Projects and may create Board Categories, Board Releases and additional Board Status objects as necessary.
All Board modules support platform search and reporting with default filters, default columns and record prints configured. All modules work consistently in the Miramar and Classic UI.
An initial set of statuses and categories are provided as a data package and an initial set of reports and dashboards are provided as a reports package.
Entering Requirements & Items
Users should be directed to the help articles Adding a Requirement using Ideagen Boards and Adding an Item using Ideagen Boards for step-by-step guides for creating each object. For more information on Board reporting see Using Board Reporting.
Board Requirement (XXX-MLDBR)
Documents requirements that can be associated with Board Items. One primary requirement plus any number of additional requirements may be added. Users can create requirements from the Create New menu, or directly from the Primary Requirement field or requirements grid in a Board Item.
The Board Requirement module has the following features:
- Supports a custom requirement number for referencing the requirement outside the system, separate from the system-generated identifier
- Tracks the requirement name and description, plus the rationale (why it exists) and source (where it came from)
- Records acceptance criteria
- Builds a requirement hierarchy using parent requirement and requirement level
- Classifies the requirement by requirement type and category
- Tracks priority, criticality and complexity
- Tracks status (Active or Inactive). Inactive requirements cannot be selected on Board Items
- Tracks the revision of a requirement that changes after initial approval
- Tracks verification method and verification status
- Records sign-off by (a person or team) and the sign-off date
- Tracks comments in the comments log and the number of comments added
- Assigns the project or project phase the requirement belongs to
- Records external project and external requirement references, if used
- Shows the number of associated Board Items and how many are closed, supporting traceability reporting
Requirements can be created and are visible to users with the Ideagen Board Participant and Ideagen Board Admin roles.
Board Item (XXX-MLDBI)
Each board (Board Title module) can be configured to track elements such as priority, category, due dates, etc. If those items are not needed, they can be disabled reducing complexity for the end users when creating and managing Board Items.
The Board Item module has the following features:
- Assigns a unique identifier (BI-YYYY-NNNN) and tracks the item title, details and board
- Tracks the requester and request date
- Tracks the last user to update the item and the update date
- Tracks the date closed
- Tracks the item status and who is responsible (Ideagen or Customer) for it in its current state
- Tracks a reportable activity log of status changes, including who made each change and the responsibility at that time
- Tracks the total number of responsibility changes over the life of the item
- Tracks comments in the comments log and the number of comments added. Requirement comments are not included and should be added to the requirement itself
- Provides last comment and last comment by header fields for reporting
- Provides a comment log header field that consolidates all comments and can be added to table reports for export at project closeout
- Tracks a primary requirement and any additional requirements, if enabled
- Tracks the project or project phase and the release the item belongs to, if enabled
- Tracks the category, priority and assigned to person, if enabled
- Tracks the applicable module, if enabled
- Tracks the level of effort, if enabled
- Tracks the due date, estimated hours and actual hours, if enabled. When both hours fields are used, hour variance (actual minus estimated) is calculated automatically. These fields are visible to admins only when viewing an item, but all users can see them in search and reporting
- Tracks dependent items (child items), if enabled
- Tracks related items, linking an item to other items that are connected but not parent or child, with a count available for reporting
- Tracks an external ticket reference, if enabled. Project, board and requirement external references are also available for reporting
- Retains a legacy type (Bug, Regression, Requirement or Scope Change) for historical items. The field is hidden unless it has a value
- Stores most fields at the header level, which improves reporting. All child levels remain reportable
- Supports data import and export of header fields
- Allows items to be reassigned to another board (see Post Setup Tasks for how values are handled)
- Supports custom Create New shortcut menus for each board (see Post Setup Tasks)
Items can be created and are visible to users with the Ideagen Board Participant and Ideagen Board Admin roles.
Defining additional Reference Data
The following reference data is used by the Boards modules.
Making the most out of Ideagen Boards
Once the boards have been installed see the article Making the most of Ideagen Boards for guidance on how to structure the boards for maximum impact.
Board Title (XXX-MLDBT)
Defines the name, description and settings for each board. One or many boards can be created for users to track individual items using the Board Item module. Boards may be created in any categorization but are usually created by module, product or project phase.
Sort order: Controls the order of boards in the Board selection pick list of the Board Item. Boards without a sort order appear alphabetically after the ordered boards.
Status: Sets the board as Active or Inactive. Inactive boards cannot be selected on Board Items and are excluded from Board Item search filters.
External Tracking Reference: Optionally ties the board to an external identifier, such as a Jira, Microsoft Project or Kantata reference. The value is carried into every item created on the board.
The Board Item Settings tab controls which details are tracked per board. Most options are Yes (available) or Required (available and required).
Options Accessible by Participants & Admins include:
- Use Projects: No Selection hides the Project field. Yes shows it and allows changes. Required shows it as a required field. Use Assigned Project sets a non-modifiable project on every item.
- Default or Specified Project: Optionally sets a default project users can change, or specifies the assigned project for all items created by the board title. New Projects may be created from the triple dots menu.
- Use Dependent Items: Allows the creation of child items in a Dependent Items grid. If Allow Parent Changes is selected, child items may change their parent association from the parent field of the child item.
- Use Category: Allows the categories to be assigned per board item.
- Category: If left blank all “Item” categories are available. If a “top-level” category, called a category classification, is selected only sub-categories of that classification may be selected per board item.
- Use Priority: Allows for a priority to be set per board item.
- Default Priority: If Use Priority is set to Yes or Required, pre-fills the priority on all new items. Users can change it.
- Use Requirements tracking: Displays a Primary requirement field. A selected primary requirement is added automatically to the Requirements grid, where users can add additional requirements.
- Use Level of Effort: Allows for a level of effort to be set per board item.
- Use Releases: Allows the user to associate the item with a release. Only releases from the item's selected project are shown. This option is available only when Use Projects is enabled.
- Use Assigned to: Allows a named assignee to be associated to the board item. The system will attempt to send the assignee an email, but the email may be blocked in test areas.
- Use External Ticket Reference: Allows an external ticket reference (for example a Jira key) to be recorded per item.
- Use Applicable Module: Allows tracking of a related module per item. Requires the Module Info module.
- Applicable Modules Grid: If Use Applicable Module is selected, select the modules that users can pick from, at least one is required. One of the added modules can be assigned as the default selection.
The following Items are Accessible by Admins Only when working in Board Items, however in Search and reporting all users can see this information.
- Use Due Date: Allows the item to have a due date. Dates must be today or in the future.
- Due Date Offset: Sets the number of days after the item was created to default on the due date to. If left blank, no due date is defaulted.
- Use Number of Estimated Hours: Allows for the tracking of estimated hours.
-
Use Number of Actual Hours: Allows for the tracking of actual hours.
NOTE: If both estimated and actual hours are tracked, a non-modifiable field called Hour Variance will appear in the item. Variance = Actual Hours - Estimated Hours, a Positive variance indicates the task took longer than estimated (over budget on time). A Negative variance indicates the task took less time than estimated (under budget on time). - Use Quick Comment: Used to quickly add a board item comment. This feature is primarily used with search grid mode mass editing from a grid mode search.
The Board Status Tab allows for only specific statuses to be used in Board Items. Leaving the grid blank allows all active statuses to be used in the Item.
Statuses are best shared across boards. Restrict them per board only for unusual cases (see Making the most of Ideagen Boards).
Visible only to users with the Ideagen Board Admin role.
Board Status (XXX-MLDBS)
Defines the statuses a Board Item moves through as the item is worked to completion. A default list of status objects has been provided for import.
One status may be set as the initial status used for all newly created board items. One or more statuses may be marked as a closed status, meaning the board item is not modifiable once set, except by users with the Ideagen Board Admin role.
Sort order is used to sort the status list in the item.
Status sets the status as Active or Inactive. Inactive statuses cannot be selected on Board Items.
Responsibility (Ideagen, Customer or Closed) is required for each status. It is recorded on the item and in its activity log.
Closed status and Closed responsibility are separate by design. A closed status locks the item because no further project work will be done on it, but its responsibility can still be Ideagen or Customer, for example when the item is parked for a future project.
A Board Title may limit the statuses available on a given board.
Visible only to users with the Ideagen Board Admin role.
Board Category (XXX-MLDBC)
Defines categories that can be associated with Board Items or Board Requirements. A sample list of categories has been provided for import, but each implementation may customize both lists.
Type is used to identify the category as an item category or a requirement category.
Sort order is used to sort the category hierarchy within each type.
Status sets the category as Active or Inactive. Inactive categories cannot be selected on new records.
Parent sets the position of a category in the hierarchy. Leave it blank to create a top-level classification.
The following is the recommended structure for both item and requirement categories:
- Classification: The first level of the hierarchy, groups categories into buckets such as Configuration, Discovery, UAT, etc.
- Parent: The second level of the hierarchy defines categories within each classification. For example, in the "Configuration" classification: Initial Setup, Customization, QA, etc.
- Child: The third level of the hierarchy defines sub-categories within each parent. For example, in the "Customization" parent: Field Behaviors, Help Text, Workflow Assignments, etc.
Visible only to users with the Ideagen Board Admin role.
Board Project (XXX-MLDBP)
Defines projects, or project phases, that can be associated with Board Titles, Board Items and Board Requirements.
Parent builds a Project > Project Phase hierarchy. Set the parent of a phase to its project.
External Project Reference ties the project or phase to an external entry, such as a Microsoft Project or Kantata task. The value is carried forward and is reportable on Board Items and Board Requirements.
Status sets the project as Active or Inactive. Inactive projects cannot be selected on new records.
Visible only to users with the Ideagen Board Admin role.
Always create at least one Project
Create at least one project and assign all boards to it. If additional projects are added later, this keeps boards and items cleanly organized.
Board Release (XXX-DWBRL)
Defines releases used to group Board Items into a release (or sprint) with an associated release date. Each release must be associated with a project, and only releases from the item's selected project are shown on a Board Item.
Status sets the release as Active or Inactive. Inactive releases cannot be selected on new records.
Changing a release date
Changes to the release date will update all board items associated with the release to reflect the new release date on the item.
Visible only to users with the Ideagen Board Admin role.
Initial Setup
- Create 2 new Subscriber roles from Administration (Gear icon) > Subscriber Roles screen
- Ideagen Board Admin (Code: XXX-IBA)
- Ideagen Board Participant (Code: XXX-IBP)
- No additional options need to be selected for these roles.
- Load the Module package (Ideagen Boards Module Package.zip) into the area from the Module Developer (<> Icon) > Import screen
- Match roles and assign the reporting authorities to the area, as necessary.
- NOTE: The modules are designed to use the Debug role as well.
- NOTE: If upgrading from a prior version, the existing roles (DevonWay Board Admins XXX-DBA and DevonWay Boards Participants XXX-DBP) can be used. Simply map the roles to the module roles when importing.
- Match roles and assign the reporting authorities to the area, as necessary.
- Once the modules have been loaded, log out and back in to make the subscriber roles available to be granted. Assign yourself to both roles, then log out and back in again for the changes to take effect.
- Load the Data Package (Ideagen Boards Data Package.zip) into the area from the Module Developer (<> Icon) > Import screen. (See Using Board Reporting for a complete list of dashboards and reports).
- Load the Reports and Dashboards Package (Ideagen Boards Reports and Dashboard Package.zip) into the area from the Module Developer (<> Icon) > Import screen.
- Reassign the Imported Reports and Charts to the Board Admin user from the Users Admin Screen.
- Load the Board Requirements Traceability Matrix SSRS Report
- Open the "Board Requirements Traceability Matrix.rdl" file in a text editor, replace all instances of "PSOL" with the Company code for the area you are importing into, save the file.
- Load the SSRS report (Admin Gear > Reports and Charts) Click New, upload the .rdl file and click Save.
- Select the report in the list, assign the report to the Ideagen Board Participant role.
Module Dependencies
The Applicable Module feature has a dependency on the Module Info module used by many products. All Modules have a dependency on the Person and Team modules.
Upgrading from a Prior Version
Newer versions contain all previous version enhancements, so you can upgrade directly to the current version from any earlier one. Complete the steps below in order. Steps that apply to a specific version say so.
- Check the installed version. Open the "Board Title" module in Module Developer (<> Icon) and review the version in the developer notes.
- Prepare for your starting version
-
Upgrading from version 3.1 or earlier: Board Title settings changed from check boxes to pick-lists in version 3.1, so each Board Title needs its settings updated after the upgrade. Before you import, copy the current settings:
- Run a search against the Board Title module.
- Switch to Table view.
- Export to Excel and keep the file until the upgrade is complete.
- After the upgrade, open each Board Title and match settings according to your export file.
- Upgrading from version 3.2: No export is needed. After the upgrade, open each Board Title that uses a default project and set Use Projects to Use Assigned Project to keep the project fixed on every item.
- Upgrading from version 3.2.1 or later: No additional preparation is needed.
-
Upgrading from version 3.1 or earlier: Board Title settings changed from check boxes to pick-lists in version 3.1, so each Board Title needs its settings updated after the upgrade. Before you import, copy the current settings:
- Load the Module package (Ideagen Boards Module Package.zip) into the area from the Module Developer (<> Icon) > Import screen, as described in Initial Setup.
- Match roles and assign the reporting authorities to the area, as necessary.
- NOTE: The existing roles (DevonWay Board Admins XXX-DBA and DevonWay Boards Participants XXX-DBP) can be used. Simply map the roles to the module roles when importing.
- Match roles and assign the reporting authorities to the area, as necessary.
- Do not load the Data Package. It is for new installs only. It contains the default statuses and categories, and loading it into an existing area would duplicate or overwrite the ones already there.
- Update the Board Statuses
- Run a search against the Board Status module and switch to Table view.
- Review the Responsibility column. Every status, including the default statuses, needs a Responsibility of Ideagen, Customer or Closed. Set a value on any status that is blank.
- Rename the status "DevonWay Review" to "Ideagen Review".
- Assign a project to each Board Release. Releases now require a Project, and a release without one will not appear on Board Items.
- Run a search against the Board Release module and switch to Table view.
- Review the Project column. Every Release needs an assigned Project.
- Load the Reports and Dashboards Package (Ideagen Boards Reports and Dashboard Package.zip) into the area from the Module Developer (<> Icon) > Import screen, and reassign the imported Reports and Charts to the Board Admin user, as described in Initial Setup.
- Run all Board Requirements through Dirty Objects so the reporting fields added in version 3.3 are populated
- Go to Admin (Gear icon) > Query Builder.
-
Run the following query. Replace XXX with your company code. The ObjectID field name is case sensitive.
SELECT ObjectID FROM vXXXDevonWayBoardRequirement - Select Refeed Dirty Objects.
- Review from the Activity Dashboard. Once all Board Requirements are processed move to the next step.
- Run all Board Items through Dirty Objects so the reporting fields added in version 3.3 are populated including updates to the Activity Log.
-
Run the following query in Query Builder. Replace XXX with your company code. The ObjectID field name is case sensitive.
SELECT ObjectID FROM vXXXMLDevonWayBoardItems - Select Refeed Dirty Objects.
- Review from the Activity Dashboard.
-
- Load the Board Requirements Traceability Matrix SSRS Report following the same steps as Initial Setup.
Post Setup Tasks
- Grant users who will need to access the boards the Ideagen Board Participant role, and board administrators the Ideagen Board Admin role.
- Consider creating a customized Create New Menu group with shortcuts to each board.
- Only users with the admin role can see Due Date, Estimated Hours, Actual Hours and Hour Variance on an item, if enabled by the board (see Board Title). These fields remain visible in search and reporting.
- A Migrated Line ID field is available for importing prior board IDs into the new modules. When populated, this field is displayed in the upper right corner of the item and can be edited by admins.
- The Comment Log header field (see Board Item) can be added to search reports for project closeout export.
- When an item is moved to another board that doesn’t track a field such as priority or estimated hours, those values are NOT cleared to prevent accidental data loss.
- Users with the admin role can use Quick Comment to add comments to board items from the multi record edit search view (see Board Title).
Revision History
Newer versions contain all previous version enhancements.
Version 3.3 (10/1/2026) - Current Version
- Board Category module:
- Updated Modal Layout
- Updated help and Instruction text
- Board Item module:
- Added an external ticket reference field
- Added reportable project, board and requirement external references
- Added responsibility and responsibility change count fields
- Modified the Activity log for better reportability and added responsibility tracking (applies to historical records)
- Modified the comments log to remove requirement comments - those should now be added to the requirement directly
- Updated screen layouts including:
- Moved optional tracking fields to a right-hand panel
- Added a new reporting region on the Record Info tab
- Updated help and Instruction text
- Board Project module:
- Added external project reference field
- Updated help and Instruction text
- Board Release module:
- Added a required Project association (only releases from the selected project will be shown in board Items)
- Updated help and Instruction text
- Board Requirement module:
- Added an external requirement tracking field
- Added reporting fields
- Updated print layouts
- Updated screen layouts including a new reporting region on the Record Info tab
- Updated help and Instruction text
- Board Status module:
- Added a required Responsibility field (Ideagen, Customer or Closed)
- Updated help and Instruction text
- Board Title module:
- Added an external tracking reference field
- Updated print layouts
- Updated help and Instruction text
- Reporting:
- Added and updated dashboards
- Board Item Status (Updated) - enhanced item status reports
- Board Requirement Status (New) - requirement tracking reports including items not assigned to a requirement and requirements with no items assigned
- Board Overview Metrics (New) - Single glance status metrics for items and requirements
- New SSRS report - Board Requirements Traceability Matrix
- NOTE: Hyperlinks in the SSRS report are for Miramar UI only
- Added and updated dashboards
Version 3.2.1 (9/18/2026)
- Board Title module:
- Added more control over project behavior in related Board Items.
- Added settings for a new external ticket reference field
- Added small screen layout
- Board Item module:
- Enforces settings from the associated Board Title.
- Updated Project selection and behaviors
- Added an external ticket reference field
- Board Project module:
- Added Parent field to support project hierarchy (Project > Project Phase)
- Help text updates
- Added external project reference field
- Board Requirement module:
- Added support for project hierarchy
- Added additional fields for requirement tracking and categorization
- Added small screen layout
- Help text updates
- Board Status module
- Added status responsibility field
- Help text updates
- All other modules:
- Help text updates
Version 3.2 (7/30/2026)
- Board Item module:
- Added Date Closed reportable field.
- Inactive board titles are now excluded from search filters in addition to the Board pick-list.
- Added Calendar date property to the Due Date field.
- All Modules:
- Added Module color and icons to all modules
- Bug fixes and help text updates
Version 3.1 (9/4/2025)
- Board Title settings were transitioned to pick-lists from checkboxes (Enabled > Yes / Required)
- Module names changed from "DevonWay Board XXX" to "Board XXX"
- Category changed from "DevonWay Boards" to "Ideagen Boards"
- Board Item identifier changed to BI-YYYY-NNNN
Version 3.0 (11/13/2024) - Initial Version
- Modules are named "DevonWay Board XXX"
- Module Category is "DevonWay Boards"
- Board title settings are Check boxes not pick-lists