Форматтеры

Примечание

В форматтерах могут использоваться вычисляемые атрибуты

Настройки

Перейти в раздел администрирования > Журналы > найти необходимый журнал > действие Редактировать. Перейти в Дополнительно

Выберите форматтер из списка заполните ключ-значение:

Важно

Если форматер не указан в списке ниже вероятно он еще не мигрировал или ассоциируется с другим новым

Типы

AssocFormatter

Тип: assoc

Конфигурация:

Ключ	Значение
sourceId	Идентификатор ассоциации
openInBackground	Открыть в новой ecos вкладке
openNewBrowserTab	Открыть в новой вкладке браузера

ActionFormatter

Тип : action

Конфигурация:

Ключ	Значение
type	<тип действия>
actionId	<id типа действия>

Предполагается в строке журнала наличие id или recordRef - ref записи, необходимый для выполнения действия

BooleanFormatter

Тип: bool

Конфигурация:

Простой форматтер, который отдает «Да» или «Нет» в ячейке

ColoredFormatter

Тип: colored

Конфигурация:

Ключ	Значение
color	Цвет в формате HEX
defaultColor	Цвет по умолчанию в формате HEX
textHidden	Флаг, который отвечает за перенос строк в ячейке

DateFormatter

Тип: date

Конфигурация:

Ключ	Значение
format	Временной формат (по умолчанию „DD.MM.YYYY“)

DateTimeFormatter

Тип: datetime

Конфигурация:

Ключ	Значение
format	Временной формат (по умолчанию „DD.MM.YYYY HH:mm“)
relative	Флаг, который будет осчитывать время которое прошло

DefaultFormatter

Тип: default

Конфигурация:

Всегда отдает строковое значение, которое получили из значения атрибута. Если ячейка имеет булево значение, то отдает «Да» или «Нет»

FileNameFormatter

Тип: filename

Конфигурация:

Всегда отдает ссылку на документ вида:

<a href="${URL.DASHBOARD}?recordRef=${row.id}" target="_blank" rel="noopener noreferrer">
  <icon />
  { НАЗВАНИЕ ЯЧЕЙКИ}
</a>

HtmlFormatter

Тип: html

Конфигурация:

Ключ	Значение
html	Строка с html кодом

LinkFormatter

Тип: link

Добавлена возможность строить ссылки по шаблону с использованием переменных (атрибутов записи/полей журнала). Link форматтер используется для ячеек журнала с использованием полей (колонок) в качестве переменных.

Шаблон адреса ссылки задается в параметрах форматтера для столбца в конфигурации журнала (Форматтер для колонки).

Пример шаблона ссылки:

urlTemplate: "https://example.com/path?var1=${columnId1}&var2=${columnId2}"

где columnId1 и columnId2 - колонки журнала.

В качестве наименования ссылки используется значение ячейки. Если значения нет, то наименование = url.

Ссылка не отображается, если ячейка журнала редактируемая (если в ячейку вводятся данные).

Например:

Выбрать форматтер Ссылка (1) и указать:

• ключ (2) – url,

• значение (3) - ${$computed.url}

Указать:

• id (4) – url,

• type (5) – value.

В конфигурации указать:

• ключ (6) – value,

• значение (7) - https://enterprise-alfresco.ecos24.ru/${?id}&${?disp}

В журнале выглядит следующим образом:

По клику на наименование будет открываться ссылка.

NumberFormatter

Тип: Number

Конфигурация:

Ключ	Описание
mask	маска, где {value} — само число
locales	какую локаль для форматирования использовать. От нее зависит как будут разделяться тысячи и дробные числа. (Точкой, запятой или пробелом) По умолчанию текущая локаль.
maximumFractionDigits	сколько чисел после запятой
decimalSeparator	как отделяются дробные числа. По умолчанию зависит от локали
thousandSeparator	как разделяются тысячи. По умолчанию зависит от локали.

Пример:

mask: {value} руб.
locales: ru
maximumFractionDigits: 16
decimalSeparator: .
thousandSeparator: ,

Например:

Ключ	Описание
mask	{value} руб
maximumFractionDigits	2
decimalSeparator	.
thousandSeparator	_

ScriptFormatter

Тип: script

Конфигурация:

Ключ	Значение
fn	формат function в функцию передаются параметры fn(p1, p2, p3, p4, p5, p6, p7) p1 - Records p2 - _ lodash p3 - t p4 - vars - переменные из конфигурации p5 - cell - ячейка p6 - row - строка p7 - index -строка формат string (eval) в конфигурацию передается тело функции
vars	формат Object Дополнительные переменные, функции и т.п., что может пригодиться при исполнении функции. Пробрасывается в p4 (объект со вспомогательными функциями и переменными)

Пример использования:

{
      type: 'script',
      config: {
            fn: function(cell, rec, col, data, rowIndex, utils) {
              return data ? data.replace(":", "_") : null;
            }
      }
    }

Если есть необходимость вызвать другой форматтер, например LinkFormatter:

   {
         type: 'script',
         config: {
               fn: function(cell, rec, col, data, rowIndex, utils) {
                 const type = data ? data.replace(":", "_") : null;

                 return {
                       row: data,
                       cell: utils.lodash.get(window, ['Citeck.messages.global', `property.samwf_caseType.${type}.title`], cell),
                       type: 'link'
                 };
               }
         }
       }

! В форматер передается функция **t** - для локализации значений, которая не работает на формах, т.к. у нее свой словарь; внутри компонента формы следует использовать функцию формы ``instance.i18next.t``

WorkflowPriorityFormatter

Тип: workflowPriority

Конфигурация:

Ключ	Значение