Supported Fields

What Fields Can Be Used in Gadgets?

In general, gadgets can utilize a variety of field types, but the functionality differs depending on whether the fields are used for summing or grouping. Here’s a detailed breakdown:

1. Numeric Fields for Summing:

   • Summable Fields: All numeric fields, whether built-in or custom, can be summed by the gadget. These fields typically include:

     • Time tracking fields (e.g., Original Estimate, Remaining Estimate, Time Spent).

     • Story points (for Agile projects).

     • Cost or financial fields (e.g., Budget, Actual Costs).

     • Custom numeric fields (e.g., any user-defined field that stores numbers).

   The gadget automatically calculates totals for these fields, giving you quick insights into cumulative values, such as total hours worked, total costs, or overall points.

2. Conditional Text Custom Fields (Convertible to Numbers):

   • Some custom text fields, while not inherently numeric, can return values that can be converted to a number, such as integers or decimals (doubles). For example:

     • Fields that store numeric-like data (e.g., quantities or ratings stored as text).

     • Custom formulas that return a numeric value in text format.

   When these fields can be interpreted as numeric values, the gadget can sum them, offering flexibility for fields that aren't strictly numeric but behave as such.

3. Fields for Grouping:

   • Single-Option Custom Fields: These fields, which allow the selection of a single value, can be used to group issues. Common examples include:

     • Single-select dropdowns: Custom fields where users choose one option from a predefined list.

     • Radio buttons: Where users select a single radio button as a response.

     • Single-option buttons: Custom buttons that allow a single choice per issue.

   Grouping fields like these enables the gadget to categorize issues based on specific criteria. For example, you could group by priority (High, Medium, Low), project phase (Development, Testing, Deployment), or any custom category that fits your use case.

Key Benefits:

• Summing numeric fields allows users to track totals, making it easy to calculate things like total time, costs, or points across multiple issues.

• Grouping by single-option fields enables analysis by specific categories, helping to break down data based on defined attributes like priority, status, or custom labels.

• Flexible Custom Fields: The ability to sum fields that return numeric values in a conditional text format adds a layer of versatility, allowing for creative and custom data setups.

Overall, these field capabilities ensure that the gadgets can provide detailed, customizable insights based on both numeric sums and groupings tailored to your project needs.