Calculated task fields: Difference between revisions

From Planfix
Jump to: navigation, search
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 10: Line 10:
*[[#Formula Calculation — "String" Result|Formula Calculation — "String" Result]]
*[[#Formula Calculation — "String" Result|Formula Calculation — "String" Result]]
*[[#Calculated field with a "Text with variables" result type.|"Text with Variables"]]
*[[#Calculated field with a "Text with variables" result type.|"Text with Variables"]]
==Formula Calculation — "Number" Result==
==Formula Calculation — "Number" Result==
The fundamental aspect of the calculated field is determined by the formula used to calculate its value:
The fundamental aspect of the calculated field is determined by the formula used to calculate its value:


https://s.pfx.so/pf/HX/hdtaLu.jpg
https://s.pfx.so/pf/ny/Oqca8q.jpg


You can also choose the format in which the value of the calculated field will be stored:
You can also choose the format in which the value of the calculated field will be stored:


https://s.pfx.so/pf/nn/KKBp05.jpg
https://s.pfx.so/pf/nn/KKBp05.jpg
== Formula Calculation — "String" Result ==
== Formula Calculation — "String" Result ==
*Output '''data from variables''' to the field:
*Output '''data from variables''' to the field:
Line 31: Line 28:


https://s.pfx.so/pf/hf/Vfya7g.jpg
https://s.pfx.so/pf/hf/Vfya7g.jpg


Please note that text and spaces must be enclosed in double quotes.
Please note that text and spaces must be enclosed in double quotes.


*'''Round brackets''' in calculates field with '''"String" result type''':
*'''Round brackets''' in calculates field with '''"String" result type''':
Line 50: Line 45:


https://s.pfx.so/pf/7h/6hMkLl.jpg
https://s.pfx.so/pf/7h/6hMkLl.jpg


https://s.pfx.so/pf/Y9/PH1157.jpg
https://s.pfx.so/pf/Y9/PH1157.jpg
== Calculated field with a "Text with variables" result type. ==
== Calculated field with a "Text with variables" result type. ==
Text with variables has the following capabilities:
Text with variables has the following capabilities:
Line 62: Line 55:
**Display on a new line.
**Display on a new line.
**Add a table, link or Planfix object using the corresponding editor buttons.
**Add a table, link or Planfix object using the corresponding editor buttons.
=== Example № 1 ===
=== Example № 1 ===


Line 70: Line 61:


https://s.pfx.so/pf/6L/ciLw1Z.jpg
https://s.pfx.so/pf/6L/ciLw1Z.jpg
=== Example № 2 ===
=== Example № 2 ===


https://s.pfx.so/pf/Hs/RQmLtk.jpg
https://s.pfx.so/pf/Hs/RQmLtk.jpg


https://s.pfx.so/pf/8t/7RPJ0Y.jpg
https://s.pfx.so/pf/8t/7RPJ0Y.jpg
== Important ==
== Important ==
*The value of the calculated field is calculated when a task is created. The value of the calculated task field is only recalculated if the values of the fields of this task, which are contained in the formula by which the field is calculated, are changed.
*The value of the calculated field is calculated when a task is created. The value of the calculated task field is only recalculated if the values of the fields of this task, which are contained in the formula by which the field is calculated, are changed.
Line 88: Line 75:
**If you need double quotes — use the [[CHAR Function|SYMBOL]] function." = SYMBOL(34).
**If you need double quotes — use the [[CHAR Function|SYMBOL]] function." = SYMBOL(34).
**Using line breaks within quote strings is not supported — enter the data in one string.
**Using line breaks within quote strings is not supported — enter the data in one string.
== Useful links ==
== Useful links ==
*[[Variables in Text|Text with Variables]]
*[[Variables in Text|Text with Variables]]


== Go To ==
== Go To ==
*[[Types of custom fields]]
*[[Types of custom fields]]
*[[Feature Description]]
*[[Feature Description]]

Latest revision as of 14:25, 15 November 2024

A calculated field is a custom task fields that lets you calculate a value, using data from various Planfix objects and standard Planfix functions.

Formula Calculation — "Number" Result

The fundamental aspect of the calculated field is determined by the formula used to calculate its value:

Oqca8q.jpg

You can also choose the format in which the value of the calculated field will be stored:

KKBp05.jpg

Formula Calculation — "String" Result

  • Output data from variables to the field:
{{variable_1}}+{{variable_2}}

6C0Me2.jpg

  • Output text and data from variable to the field:
"Task Name:"+" "+{{Task.Name}}

Vfya7g.jpg

Please note that text and spaces must be enclosed in double quotes.

  • Round brackets in calculates field with "String" result type:

A simple rule applies:

string + number + number = string

B2P3HN.jpg

As the result, we get the concatenation of "Sum: ", "50" and "70":

NjT2kw.jpg

And if you add brackets — the numbers are summed:

string + (number + number) = string + sum of numbers = string

6hMkLl.jpg

PH1157.jpg

Calculated field with a "Text with variables" result type.

Text with variables has the following capabilities:

  • You can immediately get an idea of how the field will roughly look.
  • The values will replace the variables.
  • You can apply formatting from the built-in editor:
    • Change appearance
    • Display on a new line.
    • Add a table, link or Planfix object using the corresponding editor buttons.

Example № 1

qBPwjI.jpg


ciLw1Z.jpg

Example № 2

RQmLtk.jpg

7RPJ0Y.jpg

Important

  • The value of the calculated field is calculated when a task is created. The value of the calculated task field is only recalculated if the values of the fields of this task, which are contained in the formula by which the field is calculated, are changed.
  • In tasks with a draft status, calculated fields are not calculated. The values are calculated when the task is changed to one of the working statuses.
  • Formulas for calculated fields can contain values from other calculated fields.
  • If a reference to the current time or date is used in the formula, changing the field containing the formula does not trigger the execution of scripts. This limitation is part of the mechanism to protect against looping and unlimited load.
  • The maximum number of calculated fields that can be added to the account is limited by the plan you are using.
  • If you are using HTML markup, remember:
    • If you need double quotes — use the SYMBOL function." = SYMBOL(34).
    • Using line breaks within quote strings is not supported — enter the data in one string.

Useful links


Go To