Вычисляемые поля задач — различия между версиями

Текущая версия на 10:33, 24 февраля 2022

Вычисляемое поле это пользовательское поле задачи, которое позволяет вычислять нужное значение, используя данные из различных объектов ПланФикса и стандартные функции системы.

Содержание

1 Настройки вычисляемого поля с типом результата «Число»
2 Настройки вычисляемого поля с типом результата «Строка»
3 Настройки вычисляемого поля с типом результата строка HTML
4 Важно
5 Примеры
6 Полезные ссылки
7 Перейти

Настройки вычисляемого поля с типом результата «Число»

Основная суть вычисляемого поля задается формулой, по которой происходит вычисление его значения:

Вы также можете выбрать формат, в котором будет храниться значение вычисляемого поля:

Настройки вычисляемого поля с типом результата «Строка»

Выводим в поле данные из переменных:

{{Переменная_1}}+{{переменная_2}}

Выводим в поле текст и данные из переменной:

"Название"+" "+"задачи:"+" "+{{Задача.Название}}

Обратите внимание, каждое слово текста и пробелы между ними необходимо брать в двойные кавычки.

Круглые скобки в вычисляемом поле с типом результата «Строка»:

Действует простое правило:

Строка + число + число = строка

В итоге получаем результат сцепления значений "Сумма:", "50" и "70":

А если добавить скобки — числа суммируются:

Строка + (число + число) = строка + сумма чисел = строка

Настройки вычисляемого поля с типом результата строка HTML

Выводим в поле текст и данные из переменной с html-разметкой. HTML-теги берем в двойные кавычки:

"Название"+" "+"задачи:"+" "+"<strong>"+{{Задача.Название}}+"</strong>"

В итоге вычисляемое поле в задаче выглядит так:

В HTML-разметке можно использовать и CSS-стили:

"Название"+" "+"задачи:"+" "+"<span style="+СИМВОЛ(39)+"color:#ff0000; font-weight: bold;"+СИМВОЛ(39)+">"
+{{Задача.Название}}+"</span>"

В итоге вычисляемое поле в задаче c применением CSS-стилей выглядит так:

Важно

Расчет значения вычисляемого поля производится в момент создания задачи. Пересчет значения вычисляемого поля задачи происходит только при изменении значений полей этой задачи, входящих в формулу, по которой считается поле.
В задачах, находящихся в спецстатусе Черновик, расчет вычисляемых полей не производится. Значения будут вычислены в момент перевода задачи в любой из рабочих статусов.
В формулах вычисляемых полей могут использоваться в том числе значения других вычисляемых полей.
Если в формуле используется отсылка к текущему времени или дате, изменение поля, содержащего формулу не вызывает выполнение автоматических сценариев. Это ограничение является частью механизма защиты от зацикливания и нелимитированной нагрузки.
Максимальное количество вычисляемых полей, которые можно добавить в аккаунт, лимитировано пакетом, который вы используете.
При использовании html-разметки помните:
- Кавычки не взаимозаменяемы: строки должны быть в двойных кавычках.
- Если необходимо получить двойные кавычки — используйте функцию СИМВОЛ. " = СИМВОЛ(34).
- Перенос строк внутри строк в кавычках не поддерживается — вводите данные одной строкой.

Примеры

Так можно отображать значение, полученное в вычисляемом поле, в виде гиперссылки:

"<a href="+СИМВОЛ(39)+{{Задача.Поле со ссылкой}}+СИМВОЛ(39)+">Текст ссылки</a>"

Так можно отображать html-таблицы:

"<table border="+"1"+">"+"<caption>"+"Значение"+"</caption>"+"<tr>"+"<th>"+"значение 1"+"</th>"+"<th>"+"значение 2"+"</th>"+"<th>"+"значение 3"+"</th>"+"<th>"+"значение 4"+"</th>"+"</tr>"+"<tr>"+"<th>"+"значение 5"+"</th>"+"<th>"+"значение 6"+"</th>"+"<th>"+"значение 7"+"</th>"+"<th>"+"значение 8"+"</th>"+"</tr>"+"</table>"

Полезные ссылки

Заметка о вычисляемых полях задач в блоге ПланФикса

@@ Строка 2: / Строка 2: @@
 |title=Вычисляемые поля задач
 |titlemode=append
-|keywords=планфикс,вычисляемые поля задач, кастомные поля,
+|keywords=планфикс,вычисляемые поля задач, пользовательские поля
 |description=Вычисляемые поля задач
 }}
-Вычисляемое поле это [[Кастомные (настраиваемые) поля задачи | кастомное (пользовательское) поле задачи]], которое позволяет вычислять нужное значение, используя данные из различных объектов ПланФикса и [[стандартные функции]] системы.
+Вычисляемое поле это [[Пользовательские поля задачи | пользовательское поле задачи]], которое позволяет вычислять нужное значение, используя данные из различных объектов ПланФикса и [[стандартные функции]] системы.
+== Настройки вычисляемого поля с типом результата «Число» ==
-== Настройки вычисляемого поля ==
 Основная суть вычисляемого поля задается формулой, по которой происходит вычисление его значения:
-https://pic.planfix.ru/pf/O2/TAR488.jpg
+https://p.pfx.so/pf/yV/mveH02.png
 Вы также можете выбрать формат, в котором будет храниться значение вычисляемого поля:
-https://pic.planfix.ru/pf/A1/ABUkBv.jpg
+https://p.pfx.so/pf/7L/DWrURO.png
+== Настройки вычисляемого поля с типом результата «Строка» ==
+*Выводим в поле '''данные из переменных''':
+<pre>{{Переменная_1}}+{{переменная_2}}</pre>
+https://p.pfx.so/pf/zt/uyyLz8.png
+*Выводим в поле '''текст и данные из переменной''':
+<pre>"Название"+" "+"задачи:"+" "+{{Задача.Название}}</pre>
+https://p.pfx.so/pf/dD/DYWGSk.png
+Обратите внимание, каждое слово текста и пробелы между ними необходимо брать в двойные кавычки.
+*'''Круглые скобки''' в вычисляемом поле '''с типом результата «Строка»''':
+Действует простое правило:
+ Строка + число + число = строка
+https://p.pfx.so/pf/ad/ys7Wue.png
+В итоге получаем результат сцепления значений "Сумма:", "50" и "70":
+https://p.pfx.so/pf/XQ/sptOww.png
+А если добавить скобки — числа суммируются:
+ Строка + (число + число) = строка + сумма чисел = строка
+https://p.pfx.so/pf/gl/8BTyfc.png
+https://p.pfx.so/pf/Ui/kn0UqS.png
+== Настройки вычисляемого поля с типом результата строка HTML ==
+*Выводим в поле '''текст и данные из переменной с html-разметкой'''. HTML-теги берем в двойные кавычки:
+<pre>"Название"+" "+"задачи:"+" "+"<strong>"+{{Задача.Название}}+"</strong>"</pre>
+https://p.pfx.so/pf/q8/IesbFi.png
+В итоге вычисляемое поле в задаче выглядит так:
+https://p.pfx.so/pf/Z5/ULNeib.png
+*В HTML-разметке можно использовать и CSS-стили:
+<pre>
+"Название"+" "+"задачи:"+" "+"<span style="+СИМВОЛ(39)+"color:#ff0000; font-weight: bold;"+СИМВОЛ(39)+">"
++{{Задача.Название}}+"</span>"
+</pre>
+https://p.pfx.so/pf/VC/TGyWOR.png
+В итоге вычисляемое поле в задаче c применением CSS-стилей выглядит так:
+https://p.pfx.so/pf/2N/ftCbnx.png
 == Важно ==
-*Расчет значения вычисляемого поля производится в момент создания или изменения задачи. Если в формуле используется значение реквизита объекта, упоминаемого в задаче (например, поле из карточки контрагента задачи) и этот реквизит изменится, то значение поля не изменится. Оно будет пересчитано только в момент следующего изменения любого из параметров задачи, которое вызывает событие '''Задача изменена'''. Эту особенность необходимо учитывать, если вы используете реквизиты из вложенных объектов системы.
+*Расчет значения вычисляемого поля производится в момент создания задачи. Пересчет значения вычисляемого поля задачи происходит только при изменении значений полей этой задачи, входящих в формулу, по которой считается поле.
 *В задачах, находящихся в спецстатусе '''Черновик''', расчет вычисляемых полей не производится. Значения будут вычислены в момент перевода задачи в любой из рабочих статусов.
 *В формулах вычисляемых полей могут использоваться в том числе значения других вычисляемых полей.
-*Если в формуле используется отсылка к текущему времени, изменение поля, содержащего формулу не вызывает выполнение [[Автоматические сценарии | автоматических сценариев]]. Это ограничение является частью механизма защиты от зацикливания и нелимитированной нагрузки.
+*Если в формуле используется отсылка к текущему времени или дате, изменение поля, содержащего формулу не вызывает выполнение [[Автоматические сценарии | автоматических сценариев]]. Это ограничение является частью механизма защиты от зацикливания и нелимитированной нагрузки.
 *Максимальное количество вычисляемых полей, которые можно добавить в аккаунт, лимитировано [https://planfix.ru/prices/ пакетом], который вы используете.
+*При использовании html-разметки помните:
+**Кавычки не взаимозаменяемы: строки должны быть в двойных кавычках.
+**Если необходимо получить двойные кавычки — используйте функцию [[Функция СИМВОЛ |СИМВОЛ]]. " = СИМВОЛ(34).
+**Перенос строк внутри строк в кавычках не поддерживается — вводите данные одной строкой.
+== Примеры ==
+*Так можно отображать значение, полученное в вычисляемом поле, в виде гиперссылки:
+ <nowiki>"<a href="+СИМВОЛ(39)+{{Задача.Поле со ссылкой}}+СИМВОЛ(39)+">Текст ссылки</a>"</nowiki>
+https://p.pfx.so/pf/KV/pLjHtb.png
+*Так можно отображать html-таблицы:
+<div style="display: block; padding: 1em; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: black; word-break: break-all; word-wrap: break-word; background-color: #f9f9f9; border: 1px solid #ddd; border-radius: 4px;"><nowiki>"<table border="+"1"+">"+"<caption>"+"Значение"+"</caption>"+"<tr>"+"<th>"+"значение 1"+"</th>"+"<th>"+"значение 2"+"</th>"+"<th>"+"значение 3"+"</th>"+"<th>"+"значение 4"+"</th>"+"</tr>"+"<tr>"+"<th>"+"значение 5"+"</th>"+"<th>"+"значение 6"+"</th>"+"<th>"+"значение 7"+"</th>"+"<th>"+"значение 8"+"</th>"+"</tr>"+"</table>"</nowiki></div>
+https://p.pfx.so/pf/Z1/n8QQ7c.png
@@ Строка 36: / Строка 109: @@
 == Перейти ==
 *[[Вычисляемые поля]]
-*[[Типы кастомных полей]]
+*[[Типы пользовательских полей]]