Create almost any numeric formula using mathematical expressions.


Generic Formula

Generic formula is a free style ( custom) calculation for doing numeric calculation. This format allows you to create calculations based on mathematical order of operations (PEDMAS or BODMAS) using fields from your Jira issue. Abacus also allows static values.

Create a simple or complex numeric formula using custom fields or static numbers.

  1. Enter your custom formula name.

  2. Enter your mathematical formula. Type an "@" symbol to callout system or custom fields from your Jira instance. You can also create /wiki/spaces/A2/pages/3284434950 if necessary from this section. These fields can be numeric, text, select, radio button, check boxes or multi select within your formula.

  3. Select a result field for the calculation of your formula.

    1. The optional field allows you to round the result to the nearest whole number either up or down.

  4. The "Save Formula" button saves the formula once you are finished editing it.

  5. Create an execution plan to run your formula based on a trigger. You can also add formula to an existing trigger


Increment Formula

Increment a field positively through addition or by a factor. Decrement through subtraction.

  1. Enter your custom formula name.

  2. Select the Text or Numeric custom field you wish to Increment or Decrement. You can also create /wiki/spaces/A2/pages/3284434950 if necessary from this section.

  3. Enter the quantity you wish to increment or decrement by. This can be a positive or negative number.

    1. Examples (exclude the brackets) 

      1. Increment [ + 1.5 ]

      2. Increment by a factor [ * 1.5 ] 

      3. Decrement [ -1.5 ]

  4. Show or hide the optional fields described below.

    1. Start at value: enter the value you want the field you wish to Increment or Decrement to start at. This can be used in the car when your result field does not have a pre-defined default value.

    2. Upper limit: enter here the hard limit you want to set for the highest value the calculated field can reach.

    3. Lower limit: enter here the hard limit you want to set for the lowest value the calculated field can reach.

  5. Use the "Save Formula" button to save the formula once you are finished editing it.

  6. Create an execution plan to run your formula based on a trigger. You can also add formula to an existing trigger

Point to note for step 3 above: if you do not add an increment/decrement and save your formula, Abacus will append an increment by default.

Note:

If the custom field being referenced does not have a default value and the formula does not have a start value the calculation will not run.

If the custom field being referenced has a default value and the formula has a start value, the start value will be used during formula calculation.





Sub-Task Rollup to Issue

Summation or averaging of numeric fields in Sub-Tasks and storage of the resulting value within parent ticket.

  1. Enter your custom formula name.

  2. Select the custom Sub-Task field you want to roll up into the parent issue. You can also create /wiki/spaces/A2/pages/3284434950 if necessary from this section. These fields can be numeric, text, select, radio button or check boxes.

  3. Select the mathematical function you want to perform on this field

    1. Either Summation or Averaging

  4. Select a result field for the calculation of your formula. You can also create /wiki/spaces/A2/pages/3284434950 if necessary from this section. These fields can be numeric or text.

    1. The optional field allows you to round the result to the nearest whole number either up or down.

  5. The "Save Formula" button saves the formula once you are finished editing it.

  6. Create an execution plan to run your formula based on a trigger. You can also add formula to an existing trigger



Issue Rollup to Epic

Summation or averaging of numeric fields in epically linked tickets and storage of the resulting value in the Epic.

  1. Enter your custom formula name.

  2. Select the custom issue field you want to roll up into the Epic issue. You can also create /wiki/spaces/A2/pages/3284434950 if necessary from this section. These fields can be numeric, text, select, radio button or check boxes.

  3. Select the mathematical function you want to perform on the field.

    1. Either Summation or Averaging.

  4. Select a result field for the calculation of your formula. You can also create /wiki/spaces/A2/pages/3284434950 if necessary from this section. These fields can be numeric or text.

    1. The optional field allows you to round the result to the nearest whole number either up or down.

  5. The "Save Formula" button saves the formula once you are finished editing it.

  6. Create an execution plan to run your formula based on a trigger. You can also add formula to an existing trigger

An "Epic Link" field is required for the calculation to run on the child tickets.




Custom Fields

  • Abacus will not calculate empty Custom Fields because JIRA will send a null value for empty fields. We do not want to assume a value since everyone has a preference. For that reason, either use the Edit issue Action to set a field before calculating or set a default value for the field in your custom field configuration

  • Do not use Alpha characters as defaults values.


Please write to our Support Desk with any questions you may have.