Numeric Formulas


Table of Contents:

Operators:

Requirements:

  • Create at least one field of type Text or Numeric to store the results.

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.




Generic Formula

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

  1. Enter your custom formula name.
  2. Enter your mathematical formula. 
    1. Use an "@" symbol to utilize custom Numeric, Text, select, radio button, check boxes, 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 execution plan to run your formula based on  a trigger. You can also add formula to existing trigger
 Watch generic formula tutorial video...



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.
  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. Enter the value you want the field you wish to Increment or Decrement to start at. 
    2. Enter here the hard limit you want to set for the highest value the calculated field can reach.
    3. 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.

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

 Watch increment formula tutorial video...



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.
  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.
    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 the formula
 Watch sub-task rollup to issue formula tutorial video...



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.
  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.
    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.

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


 Watch issue rollup to epic formula tutorial video...



Missing Fields?

If after adding custom fields you wish to use to the project's Create and Edit Screens, they should be available to be used in the formula as long as they are of a compatible custom field type. If the Custom fields do not appear as options when editing the formula then attempt to refresh the available custom fields by; navigating to the top right of the  screen, clicking on the gear icon, and selecting the option "Refresh custom fields". Now the custom fields you've added should be available to use while editing your formulas.

Write into our Support Desk with any questions you have.