В данном блоке вы найдете функциональные возможности платформы 3V, которых ранее нельзя было добиться с помощью настроек в json модели или прочими способами
¶ Новые функции
- Добавлена функция
"RandomGuid()"для генерации guid. - Добавлена функция
"RandomInt()"для генерации целых чисел.
¶ Заполнение атрибутов справочников по умолчанию
При создании элемента справочника через API учитываются настройки "DefaultValue" и "DefaultValueExpression", если для вновь созданного элемента не было задано значение
- Использование API на создание элемента в рамках пользовательских функций в приложении.
- Использование действий "CreateNewDictionaryElementAction" в формах.
¶ Возможность обновить отчет после закрытия модальной формы при переходе по гиперссылке
Реализована возможность обновлять данные отчета после закрытия модaльной формы.
Данное поведение можно настроить путем выставления свойства "RefreshAfterModalWindow": true в json отчета внутри блока hyperlinkOptions для необходимой гиперссылки.
По умолчанию данное свойство выключено ("RefreshAfterModalWindow": false).
Если пользователь редактировал данные в самом отчете, то при нажатии на подобную ссылку появится окно с предупреждением, хочет ли он продолжить, так как его отредактированные данные не сохранятся при закрытии модального окна.
¶ Контекстное меню
В навигаторе для всех объектов реализовано контекстное меню. Оно доступно при клике правой кнопкой мыши на объект, меню которого необходимо открыть.
Кнопка "Скопировать ссылку на объект" теперь имеет новый дизайн 
и перенесена из верхней панели инструментов навигатора в контекстное меню.
¶ Импорт-экспорт отчетов и показателей
Реализованы возможности импорта и экспорта данных в отчете и показателе. Благодаря данной функции можно выгрузить шаблон в формате xls, заполнить данными и загрузить заполненные данные из xls обратно в отчет/показатель.
В отчетах, показателях и справочниках в верхней и боковой панелях настроек добавлены функции импорта и экспорта.
Для экспорта добавлены новые настройки:
- Экспорт шаблона
- Экспорт шаблона с данными
Добавлять новые записи в экспортированный документ возможно только для справочников и показателей. Для отчетов возможно только изменять/записывать данные в уже имеющиеся строки
Если отчет был заполнен данными, при импорте они заменятся на те, что записаны в импортируемрм файле.
При импорте данных в показатель, откроется модально окно с возможностью выбора:
- Очищать показатель перед загрузкой
- Обновлять текущие записи
- Добавлять новые записи
При наличии параметров, отчет экспортируется с установленными параметрами, а также при загрузке данные будут загружены по соответствующим параметрам
Данные из виртуального показателя экспортируются, но не импортируются в него.
¶ Загрузка файлов как объекта платформы
Реализована возможность загружать файлы любого расширения как отдельные объекты платформы.
Для загрузки файла:
- Нажмите на кнопку "Создать" в главном окне навигатора
- В раскрывшемся списке выберите пункт "Загрузить файл"
- Выберите файл, который необходимо загрузить.
Или перетащите файл в окно навигатора объектов.
Наименование созданному объекту задается автоматически, в соответствии с наименованием загруженного файла.
При необходимости наименование объекта можно изменить в правой панели свойств.
В поиске для данных объектов добавлен тип "Файл", который осуществляет поиск всех файлов независимо от их расширения.
При нажатии на объект с типом "Файл", он скачается автоматически, за исключением изображений и видео (gif, png, jpeg, svg, mp4..), а также pdf файлов, которые откроются на предпросмотр. Скачать файл можно также по клику на соответствующий пункт в контекстном меню или же на кнопку 
в верхней панели.
При изменении файла нет необходимости удалять предыдущую версию и загружать новую, можно обновить файл. Для этого необходимо открыть контекстное меню, щелкнув по объекту правой кнопкой мыши и выбрать "Загрузить новую версию".
Также доступна история изменений файла. Открыть её можно через контекстное меню объекта или же по клику на кнопку 
в правой панели настроек.
¶ Возможность добавления нескольких файлов в атрибут справочника
Реализована возможность загрузки нескольких файлов в одну ячейку с типом данных "файл".
Для этого:
- В конструкторе для атрибута с типом "файл" выберите возможность множественной отметки
- По клику на ячейку загрузите файл
- Для загрузки дополнительного файла нажмите на троеточие в нужной ячейке и в раскрывшемся меню нажмите на кнопку "Загрузить файл"
При добавлении нескольких файлов в одну ячейку, в ней отображаются не названия файлов, а их количество.
При нажатии на кнопку скачивания в ячейке, все расположенные в ней файлы будут скачаны архивом. Также каждый файл можно скачать отдельно, выбрав скачивание в раскрывающемся меню ячейки.
¶ Единая модель расчета
Выполнены доработки для единой модели расчета, а именно:
- Удален тип формул "агрегация" в конструкторе, так как данный тип не поддерживается в ЕМР.
- Введена версионность формул. Теперь несколько человек могут править емр по разным формулам. При редактировании одной и той же формулы разными пользователями будет возникать ошибка о не совпадении версии.
- Реализована возможность создания папок для формул ЕМР, а также возможность отображения приемников формул.
Для отображения приемников формул добавлен флаг "Показывать приемники формул". При включении данного флага отображаются объекты, в которых использованы формулы ЕМР.
¶ Проверка на изменение структуры отчета при его восстановлении
При работе с открытым отчетом после бездействия, он строится заново, вследствие чего могут возникнуть проблемы, например, при изменении иерархии, так как структура открытого отчета может не совпадать со структурой восстановленного.
После бездействия, при дальнейших операциях с отчетом проверяется актуальность структуры, и если структура поменялась, то автоматически загрузится новая структура и появится соответствующее уведомление.
Также в конфигурационный файл добавлена настройка "showReportIsDead" (по умолчанию выключена). При включении данной настройки на вкладке с отчетом в нижней панели инструментов будет отображаться предупреждение о долгом бездействии пользователя.
¶ Возможность выполнения действия при изменении состояния согласования
Для компонента "согласование" при смене состояния (нажатии на кнопку или пункт выпадающего списка компонента) реализована возможность выполнения действий:
- Открытие модального окна
- Открытие ссылки
- Выполнение пользовательского метода
- Экспорт
- Расчет методики
Если же действие должно выполняться только на определенном состоянии, то необходимо добавить проверку на id состояния через выражение типа "EntryExpressionWorkflowContainsStatesBooleanParameter". И это выражение добавить в "enableExpressionId" у действия.
¶ Парольная аутентификация в планировщике
Теперь в Swagger UI можно добавить не только авторизацию через конфиденциального клиента (ConfidentialClientAuthenticationSettingsDto), но парольную авторизацию (PasswordAuthenticationSettingsDto), что позволит задавать логин/пароль пользователя-администратора, а не сервисной учетной записи.
¶ Возможность задания фиксированных значений для запуска подпроцессов согласования
Для настройки запуска подпроцесса с заданными константными значениями необходимо в json основного процесса в настройке связи параметров - parameterMappings, задать конструкцию с указанием идентификатора параметра подпроцесса для которого задаются значения (subProcessParameterId) и перечнем значений (value).
Пример настроенного подпроцесса и заданных настроек связи: задана связь параметра основного процесса с параметром подпроцесса, а для второго параметра подпроцесса зафиксированы значения 1,2,3, с которыми будет совершаться запуск подпроцесса.
Пример
"subProcesses": [
{
"workflowId": 333074,
"name": "Подпроцесс",
"parameterMappings": [
{
"parentProcessParameterId": 1,
"discriminator": "SubProcessParentParameterMappingModel",
"subProcessParameterId": 1
},
{
"value": [
1,
2,
3
],
"discriminator": "SubProcessConstantParameterMappingModel",
"subProcessParameterId": 2
}
],
"subProcessNameTemplate": null
}
],
При запуске подпроцесса без фиксированных значений откроется модальное окно для выбора значений, при запуске с фиксированными значениями процесс запустится автоматически.
¶ Лицензионный ключ для работы платформы
Теперь необходимо указывать лицензионный ключ в конфигурациях облака/стенда для работы платформы.
При отсутствии лицензионного ключа платформа не будет работать
Пример:
"License": {
"PublicKey": "",
"LicenseKey": "",
"LicenseData": {
"ValidityPeriod": {
"Start": "2022-01-04T00:00:00",
"Duration": {
"Years": 1,
"Months": 0,
"Days": 0
}
},
"CompanyName": "ABC",
"UserLimits": null
}
},
¶ Отображение html, svg содержимого в виде стилизованных элементов
При настройке стилизации элементов справочника, например, следующим образом:
<span style="background-color: #E2DCFF; border-radius: 4px; padding: 4px 6px;">Настройка</span>
Или же при записи изображения в svg формате в качестве элемента справочника:
<svg width="16" height="20" viewBox="0 0 16 20" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M8 20C9.1 20 10 19.1 10 18H6C6 19.1 6.9 20 8 20ZM14 14V9C14 5.93 12.37 3.36 9.5 2.68V0.5H6.5V2.68C3.64 3.36 2 5.92 2 9V14L0 16V17H16V16L14 14ZM12 15H4V9C4 6.52 5.51 4.5 8 4.5C10.49 4.5 12 6.52 12 9V15Z" fill="#5B5C62"/>
</svg>
При использовании элементов таких справочников в списках на форме (элементы "Раскрывающийся список" и "Выбор из списка") или отчете в качестве параметра, выводятся не код, а стилизованные элементы.
¶ Частичное обновление справочников
В сервисе обновлений при установке справочников добавлена новая опция - частичное обновление, в рамках него можно выбрать, что делать с атрибутами, которых нет в справочнике приемнике, пропускать или добавлять.
Расширено меню действий при установке обновления:
- Заменить модель (Значение по умолчанию. Производится полная замена модели справочника-приемника на модель справочника в обновлении)
- Обновление без добавления новых атрибутов (изменяются свойства только тех атрибутов, которые есть и в обновлении и в справочнике приемнике, соответствие производится по идентификатору, коду, типу атрибута и типу данных).
- Обновление с добавлением новых атрибутов (работает по аналогии с пунктом 2, но также добавляются атрибуты, которые есть в обновлении, но отсутствуют в справочнике приемнике)
Соответствие атрибутов справочников определяется по по идентификатору, коду, типу атрибута и типу данных атрибута.
Если соответствие установлено, то обновляются все настройки атрибутов из справочника-источника, и значения атрибутов обновляются в соответствии с настройками переноса элементов справочника.
Если соответствие не установлено, то можно выбрать:
- не устанавливать атрибуты по которым не найдено соответствие в справочник-приемник (пункт 2)
- устанавливать атрибуты по которым не найдено соответствие в справочник приемник (пункт 3)
При обновлении модели атрибуты в справочнике приемнике не удаляются, могут только обновляться и дополняться.
¶ Установка внешних справочников в виде стандартных объектов
Реализована возможность при установке обновления заменять все внешние справочники на соединении с типом Link в обновлении на обычные с той же структурой.
Соединения, на которые ссылаются внешние справочники, в таком случае не устанавливаются.
Для выбора способа установки обновления с внешними справочниками на соединении с типом Link в менеджере обновлений добавлен флаг "Устанавливать ссылочниые объекты как редактируемые".
¶ Новые функции для создания формул
Для работы с датами добавлены новые функции:
TruncToMonth(date)- возвращает дату: первый день месяца переданной датыTruncToQuarter(date)- возвращает дату: первый день квартала переданной датыTruncToYear(date)- возвращает дату: первый день года переданной даты
Примеры:
TruncToMonth(02.08.2022) = 01.08.2022
TruncToQuarter(02.08.2022) = 01.07.2022
TruncToYear(02.08.2022) = 01.01.2022
Для работы с коллекциями:
Intersect([0], [1])- вычисление пересечения последовательностей, то есть общих для обоих наборов элементов.Except([0], [1])- вычисление разности двух последовательностейDistinct([0])- удаление дубликатов из последовательностиForEach([0], [1])- первый параметр коллекция, второй параметр выражение которое будет применяться к каждому элементу коллекции (по аналогии с CountIfExpression), на выходе новая коллекция с измененными значениями
Для работы со строками:
ToLower([0])- преобразование строки к нижнему региструToUpper([0])- преобразование строки к верхнему региструDoubleToString([0], [1]<, [2], [3]>)- преобразование вещественного числа ([0]), к строке в формате ([1]), с возможностью задать разделитель целой и дробной части [2] и знака валюты [3] для валютных форматов. Параметры [2] и [3] опциональные, если не заданы, возьмутся от настроек сервисаIntToString([0], [1]<, [2], [3]>)- преобразование целого числа ([0]), к строке в формате ([1]), с возможностью задать разделитель целой и дробной части [2] и знака валюты [3] для валютных форматов. Параметры [2] и [3] опциональные, если не заданы, возьмутся от настроек сервиса. Также поддерживаются значения типа long (bigint)
Посмотреть настройку
¶ Новый компонент "Блок-схема"
Блок-схема — графическая модель, описывающая алгоритмы или процессы, в которых отдельные шаги или элементы изображаются в виде блоков различной формы, соединённых между собой линиями, указывающими направление последовательности.
Блок-схема строится на основании отчета, в котором указываются входные и выходные блоки, а также подписи для стрелок, отображающих переход, при необходимости.
Для добавления блок-схемы на форму:
- Добавьте элемент "Блок-схема" из блока "Графики"
- Добавьте источник для блок-схемы - отчет
- В свойствах элемента "Блок-схема" укажите следующие данные:
Свойства
| Наименование | Описание |
|---|---|
| Наименование | Меняет название в левом дереве. Заголовка не добавляет |
| Направление схемы | слева направо/справа налево/сверху вниз/снизу вверх |
| Данные выходных блоков | Индекс столбца отчета с выходными данными, начинается с 0 |
| Данные входных блоков | Индекс столбца отчета с входными данными, начинается с 0 |
| Данные подписей потока | Индекс столбца отчета с подписями потока, начинается с 0. Если есть входной и выходной блок, но нет подписи, то отображается переход (стрелка) без подписи |
| Источник отображения данных | источник данных - отчет |
На вкладке стилей возможно задать оформление блоков, подписей потока и стрелок:
СSS стили
| Блоки | |
| "color": "#c53636" | Цвет текста. Блоки |
| "font-size": 12px | Размер шрифта. Блоки |
| "font-family": "Tahoma" | Шрифт. Блоки |
| "font-weight": "bold" | Начертание шрифта (насыщенность). Блоки |
| "text-decoration": "underline" | Подчеркивание. Блоки |
| "text-transform": "lowercase" | Регистр. Блоки |
| "line-height": 10px | Междустрочный интервал. Блоки |
| "text-align": "left" | Выравнивание по горизонтали. Блоки |
| "vertical-align": "top" | Выравнивание по вертикали. Блоки |
| "opacity": 50% | Непрозрачность. Блоки |
| "background-color": "#c53636" | Цвет фона. Блоки |
| "border": "4px outset #fc3", | Граница. Блоки |
| Подписи потоков | |
| "color": "#c53636" | Цвет текста. Подписи стрелок |
| "font-size": 12px | Размер шрифта. Подписи стрелок |
| "font-family": "Tahoma" | Шрифт. Подписи стрелок |
| "font-weight": "bold" | Начертание шрифта (насыщенность). Подписи стрелок |
| "text-decoration": "underline" | Подчеркивание. Подписи стрелок |
| "text-transform": "lowercase" | Регистр. Подписи стрелок |
| "line-height": 10px | Междустрочный интервал. Подписи стрелок |
| "text-align": "left" | Выравнивание по горизонтали. Подписи стрелок |
| "vertical-align": "top" | Выравнивание по вертикали. Подписи стрелок |
| "opacity": 50% | Непрозрачность. Подписи стрелок |
| "background-color": "#c53636" | Цвет фона. Подписи стрелок |
| "border": "4px outset #fc3" | Граница. Подписи стрелок |
| Стрелки | |
| "color": "#c53636" | Цвет стрелок. Стрелки |
Наличие данных во входном и выходном блоках обязательно. Если стрелка пришла "из пустоты" или ушла "в пустоту", т.е. отсутствуют данные в входном или выходном блоке, то будет отображен пустой блок в/из которого будет стрелка.
Посмотреть настройку
¶ Новый компонент "Галерея изображений"
Добавлен новый компонент "Галерея изображений", позволяющий отображать изображения на форме в виде коллекции из источника - справочника.
Для отображения поддерживаются следующие форматы: JPEG, GIF, PNG, BMP, SVG.
При наличии коллекции изображений первое из них отображается в полном размере, а остальные под первым в режиме предпросмотра.
Для настройки:
- Добавьте на форму элемент «Галерея изображений» из группы «Прочие» по клику на + .
- Добавьте на форму источник - справочник, в котором хранятся изображения
- К элементу галерея изображений добавьте источник для отображения и выберите атрибут, в котором хранятся изображения (тип атрибута файл)
К галерее изображений можно применить следующие настройки:
- Точки навигации (для пролистывания изображений)
- Стрелки навигации (для пролистывания изображений)
- Панель предпросмотра
- Полноэкранный режим (позволяет открыть изображение в полноэкранном режиме при нажатии на соответствующую кнопку)
- Выбрать изображение по умолчанию (указать индекс изображения, начинается с 0)
- Настроить автопрокрутку (указать время переключения в секундах)
Свойства настройки стилей компонента "Галерея изображений"
| Свойство | Значение по умолчанию | Допустимые значения |
| Ширина | 800px | auto, px, % |
| Максимальная ширина | - | auto, px, % |
| Минимальная ширина | - | auto, px, % |
| Высота | 600px |
auto, px, % |
| Максимальная высота | - | auto, px, % |
| Минимальная высота | - | auto, px, % |
| - |
auto, px, % |
|
| - |
auto, px, % |
|
| 100% |
auto, px, % |
|
| - |
auto, px, % |
|
| - |
auto, px, % |
|
| 100% |
auto, px, % |
При невозможности открыть файл из источника, например, при недопустимом формате, будет отображено уведомление о невозможности загрузить изображение.
¶ Возможность использования сквозных параметров
Сквозные параметры – это способ передачи изменений (параметров), сделанных внутри формы, за пределы этой формы. Сквозные параметры позволяют открыть форму с теми параметрами, которые были выбраны в другой форме.
В текущей сессии сохраняются в значения приходящих параметров формы по их коду (если код задан), а при открытии других форм добавляются в набор параметров для открытия.
При смене значений параметров формы они подставляются в адресную строку.
Передача выбранной отметки в параметрах из формы в форму:
- Добавьте параметры на формы и укажите у параметров, между которыми должна происходить передача отметки, одинаковый строковый код (свойство code у параметра).
- На форму добавьте источник, у которого отметка будет приходить из параметра, либо первый доступный элемент, если из параметра при открытии системы ничего не придет ("dictionarySourceSelectionMode": "ParameterValueOrSelectFirst"/ "ParameterValue")
- При изменении значения поля - отметка возвращается в параметр.
- Далее на форме сохраняется пользовательская отметка параметров. При переходе из формы в форму в пользовательском приложении между параметрами с одинаковым кодом (code) передается выбранная отметка.
Посмотреть настройку
¶ Открытие формы с параметром - ранее созданным объектом
Данные настройки также применимы для формы объекта, например, формы создания договора. При сохранении формы после заполнения данных и обновления страницы, текущий параметр подставится в адресную строку и форма откроется с параметром - ранее созданным объектом.
Для этого на форму добавьте источник, у которого отметка будет приходить из параметра "dictionarySourceSelectionMode": "ParameterValue"
Описанная функциональность не будет работать при использовании фильтра по параметру
Пример:
"discriminator": "EntryParameterFilter",
¶ Открытие объектов по прямой ссылке в пользовательском приложении
Реализована возможность открывать объекты - отчеты и формы по прямой ссылке в приложении. В таком случае на странице браузера отображается только сам объект без меню и других объектов пользовательского приложения.
Для формирования такой ссылки необходимо заменить стандартную ссылку на пользовательское приложение следующим образом:
Формы:
Стандартная ссылка: https://app.3v-cloud.com/app/#/forms/FORM_CONTRACTS
Ссылка на объект без меню: https://app.3v-cloud.com/app/#/f/FORM_CONTRACTS
Отчеты:
Стандартная ссылка: https://app.3v-cloud.com/app/#/pivot/REPORT_1
Ссылка на объект без меню: https://app.3v-cloud.com/app/#/p/REPORT_1
Ссылка на отчет без меню и верхней панели настроек: https://app.3v-cloud.com/app/#/u/REPORT_1
¶ Проверка количества пользователей по лицензионному ключу
Реализована возможность ограничивать общее количество пользователей через лицензионный ключ. В платформе лицензия указывается в настройках приложения и проверяется при чтении этих настроек из конфигурационных файлов.
- Возможность ограничивать общее количество пользователей. За это отвечает свойство
License.LicenseData.UserLimits.TotalUserLimit. При достижении указанного лимита становится невозможным создание новых пользователей. - Возможность ограничивать количество пользователей, входящих в системные роли. За это отвечает свойство
License.LicenseData.UserLimits.RolesLimits. В этом свойстве хранится набор ограничений. Каждое ограничение состоит из двух полей:
Roles- набор типов системных ролей. Если пользователь входит хотя бы в одну из указанных ролей - он будет учитываться в этом ограничении.UserLimit- ограничение на количество пользователей, входящих в роли. При достижении лимита становится невозможным добавлять пользователей ни в одну из ролей.
- Два режима работы - пользователи считаются в рамках каждого приложения отдельно или суммарно во всех приложениях. За выбор режима отвечает свойство
License.LicenseData.UserLimits.IsLimitsCumulative(true - пользователи считаются суммарно во всех приложениях, false - пользователи считаются в каждом приложении отдельно).
¶ Data Manager. Частичная очистка данных перед загрузкой
Реализована возможность предочищать данные перед добавлением новых записей по определенным полям и тем значениям, которые пришли из источника. То есть будет произведена очистка записей, если их нет в источнике данных.
Кейс "загрузка связей задач в справочник":
Имеется задача со связями (связанными задачами), которые были загружены в справочник через DM. При изменении связей задачи и повторной загрузке данных, в справочник добавятся новые связи задачи, а старые удаленные связи будут удалены в справочнике.
¶ Отображение html содержимого в виде стилизованных элементов
При настройке стилизации элементов связанного справочника, например, следующим образом:
<span style="background-color: #E2DCFF; border-radius: 4px; padding: 4px 6px;">Настройка</span>
В справочнике или отчете, построенном на данном справочнике, выводится не html-код, а стилизованные элементы.
¶ Единая модель расчета
Добавлена возможность создавать единую модель расчета (ЕМР) для приложения, которая позволит делать вычисления связанными друг с другом.
Появляется новый способ производить расчеты над данными, в рамках всего приложения.
Поддерживаются цепочки расчетов данных: При наличии зависимых друг от друга данных перерасчет при их изменении будет производиться автоматически.
В левую панель меню навигатора объектов добавлена вкладка "Единая модель расчета". Все формулы, вхоядщие в ЕМР возможно увидеть на данной вкладке.
Добавлять расчеты в ЕМР возможно как из отчета, так и из бокового меню.
Формулы добавляемые в отчет, по умолчанию добавляются в ЕМР. Для добавления формулы только в сам отчет необходимо поставить флаг в редакторе формул "Формула отчета".
Формулы, добавленные для виртуального показателя всегда добавляются только в отчет.
Результаты расчетов отобразятся после обновления отчета.
Если пользователь редактирует данные показателя, и в то же время другой пользователь изменил и сохранил данные этого показателя, то первому пользователю поступит оповещение о том, что данные изменены и он может решить, обновить или сохранить текущие данные.
Добавлять и редактировать формулы единой модели расчёта могут только пользователи с правами редактора и адинистратора.
Оповещения об изменения данных в отчётах будут приходить только другим пользователям и только если у них в объекте отображены неактуальные данные.
Кейс: необходимо посчитать аннуитетный платеж по кредиту и оценить, насколько велика кредитная нагрузка для клиента.
Данные по клиенту и кредиту расположены в двух отдельных показателях.
С помощью ЕМР возможно расчитать аннуитетный платеж по кредиту и использовать размер платежа по кредиту в ином показателе - "Кредитная нагрузка", рассчитав кредитную нагрузку.
Для расчета создан отчет с необходимыми данными по двум показателям и настроены формулы для соответствующего расчета по ячейкам.
Также вычисления можно создавать на вкладке "Единая модель расчета", если нет необходимости выносить данные в единый отчет.
При изменении входных параметров - тела кредита, процентной ставки или срока кредита, величина кредитной нагрузки пересчитается автоматически.
Текущие ограничения единой модели расчетов
- Формулы единой модели расчёта можно добавлять только на хранимые показатели и использовать в качестве операндов другие хранимые показатели. Использование атрибутов справочников в расчетах недоступно.
- В ЕМР можно добавлять только формулы с типом "выражение", без типа "агрегация". Агрегация данных для операнда возможна.
- Связь атрибутов операнда и приемника пока не поддерживается.
- Накопительные итоги и транформация отметки операнда не поддерживается.
- При расчёте формул ЕМР доступ по сегментам на показатели не учитывается.
- На показатель может быть только один тип формул, формулы отчёта или формулы ЕМР. Если на показатель есть и формула отчёта и формула в ЕМР, то приоритет отдается формуле ЕМР, а формула отчёта будет игнорироваться.
- Уведомления об изменения данных показателей будут приходить только при включенных вебсокетах
. По умолчанию вебсокеты включены. - Зацикливание расчётов сейчас не прерывается.
Планы по развитию единой модели расчетов
- Возможность масштабирования сервиса ЕМР для обработки большого количества данных
- Использование атрибутов справочников в расчетах ЕМР
- Отслеживание используемых формул ЕМР внутри открытого отчета (окно с перечислением всех используемых в отчете формул)
- Трансформация отметки при использовани расчетов ЕМР
- Связь атрибутов оперенда и приемника
¶ Ограничение на ввод числовых значений
Добавлена возможность задать ограничения на ввод числовых значений с помощью конструктора.
Для того, чтобы задать ограничения:
- Откройте отчёт
- Перейдите в конструктор на вкладку ‘Столбцы’
- Выберите необходимый для ограничения атрибут или показатель
- В правой панели настроек выберите вкладку ‘Формат’
- Задайте ограничения, выставив минимальное и максимальное значения
- Нажмите готово и сохраните изменения
При вводе числового значения, выходящего за пределы заданных ограничений, оно подсвечивается красным цветом и не позволяет сохранить изменения.
¶ Ввод данных для ячейки с форматом времени
- Изменена логика подстановки времени в ячейку с типом "Дата" и форматом "HH:mm".
Ранее при двойном клике на ячейку автоматически устанавливалось значение 00:00. В текущей версии выставляется текущее время.
- Добавлена возможность ввода секунд и миллисекунд в ячейку с заданным форматом. Пикер данных для ввода времени в таком случае поддерживает выбор часов и минут, а секунды и миллисекунды необходимо вводить вручную.
¶ Возможность сворачивания/разворачивания данных отчета в форме
Реализована возможность сворачивать и разворачивать данные отчета, расположенного на форме по аналогии с инструментом в самом отчете с помощью кнопки.
Для реализации данной возможности рекомендуются следующие действия:
- Добавьте на форму элемент "Контекстное меню"
- В контекстное меню добавьте пункт меню с заголовком "Развернуть все" и в её JSON-модель следующие настройки:
"pivotDataSourceId": 1,
"bType": "expandPivot",
- В контекстное меню добавьте пункт меню с заголовком "Свернуть все" и в её JSON-модель следующие настройки:
"pivotDataSourceId": 1,
"bType": "collapsePivot",
- Сохраните изменения.
¶ Кластеризация точек интерактивной карты
Реализована возможность группировки точек, находящихся рядом друг с другом, и представления их на карте в виде единой точки, отображающей количество объектов, которые она объединяет.
По мере масштабирования карты пользователем, кластеры разбиваются на отдельные точки.
Для настройки кластеризации необходимо в json слоя карты добавить настройки:
"clustering": {
"enabled": true,
"markersDistance": 30,
"clustersMinDistance": 0
},
- markersDistance - Расстояние, в пределах которого объекты будут сгруппированы вместе.
- clustersMinDistance - Минимальное расстояние между кластерами. Не может быть больше заданного расстояния.
При настройке кластеризации с учетом типов точек, каждый тип добавляется на карту отдельным слоем. Настройки кластеризации в данном случае задаются для каждого слоя отдельно.
¶ Фильтрация элементов карты
Добавлена возможность фильтровать элементы карты. Для этого на форме необходимо создать фильтр, а затем к источнику формы - отчету добавить соответствующую настройку.
Подробнее о настройке фильтрации отчета можно прочитать здесь.
¶ Домашняя папка пользователя
Добавлена возможность выбрать папку пользователя, которая будет открываться по умолчанию в системном навигаторе.
Выбрать папку можно:
- в контекстном меню папок в левом дереве по кнопке "Домашняя страница"
- в правом меню свойств объекта
К папке можно быстро перейти нажав на текст "Навигатор" над левым деревом объектов.
Объекты создаваемые на главной странице будут создаваться и храниться в папке пользователя.
¶ Возможность создания нескольких приложений в рамках одной платформы
Реализована возможность создания нескольких приложений в рамках одной платформы (реалма).
При попытке авторизации в одном из приложений, определяется наличие обязательной для этого приложения роль. Если этой роли у пользователя нет - открывается страница с уведомлением об отсуствии прав.
Для настройки данной возможности необходимо изменить конфигурационные файлы
- в разделе auth выставить "sendNamespaceHeader": true
- в разделе auth.multipleNamespaces задать "urlSearchPattern" - определяет неймспейс по URL-адресу. По умолчанию данное свойство работает только для доменного имени сайта (хост). Если требуется обработка полного URL-адреса, нужно дополнительно задать "fullUrlSearch": true в auth.multipleNamespaces.
¶ Изменение ролевой модели
Добавлена новая роль, создающаяся по умолчанию - Пользователь "User". Для пользователей с данной ролью доступна возможность видеть все объекты и редактировать данные, но не доступны следующие возможности:
- Создание/удаление объектов
- Редактирование объектов (конструкторы, JSON)
- Перенос объектов обновлением
Для роли обозреватель (Viewer) недоступно редактирование показателей. Пользователь с данной ролью может получить права на чтение или редактирование данных конкретного показателя с помощью флагов в панели прав доступа:
- "Чтение всех данных"
- "Редактирование всех данных".
При отсутствии у пользователя прав на редактирование недоступны следующие кнопки:
- Добавить элемент (в справочнике и отчете)
- Удалить элемент (в справочнике и отчете)
- Вырезать/вставить данные (в отчете)
¶ Установка базовых объектов при создании приложения
При создании приложения в личном кабинете, после его активации (статус приложения "Active") в приложении по умолчанию создаются папки:
- Мои объекты приложения
- Преднастроенные объекты
Мои объекты приложения (содержит папки для создания объектов приложения)
- Данные: показатели, соединения, справочники
- Формы и отчеты
- Процессы
- Методики расчета
- Прочие объекты
Преднастроенные объекты (не требуют настройки, содержат базовые объекты)
- Меню приложения
- Аудит
- Роли и пользователи приложения
- Планировщик
- Права и объекты приложения
- Процессы
- Комментирование
- Уведомления
- Шаблоны форм
- Служебные файлы
¶ Локализация личного кабинета
Произведена локализация личного кабинета на русский язык.
¶ Импорт множественных связанных атрибутов
Добавлена возможность экспорта и импорта справочника со множественными связанными атрибутами.
- Экспорт производится по кнопке "Экспорт шаблона с данными", которая находится в выпадающем списке "Экспорт".
- Импорт производится по клику на иконку справочника в левом верхнем углу и выборе пункта "импорт". Импорт работает как по ключу так и по наименованию.
¶ Новый компонент "Интерактивная карта"
Добавлен новый компонент "Интерактивная карта".
При добавлении интерактивной карты в форму она располагается на географической карте-подложке OSM – OpenStreetMap. Подложка рисуется автоматически при создании объекта, её можно приближать до конкретного места улицы или дома.
Также как и для обычной карты в источнике данных для интерактивной карты могут содержаться:
- Наименование объекта
- Точки и полигоны в формате geoJSON
- Иконки для точек
- Хинты
Функционал интерактивной карты:
- Отображение точек и полигонов: при добавлении источника с geoJSON и задании слоев на карте появляется отрисовка полигонов и точек (по аналогии с обычной картой).
- Стили: при добавлении стилей карта раскрашивается в зависимости от стиля, также можно задать пользовательские иконки точек.
- Если заполнено свойство common, то стили из данного свойства применяются ко всем объектам слоя.
- Если заполнено свойство byObject, то стили для каждого объекта получаются из указанного столбца и к каждому объекту применяется свой стиль.
- Если заполнены оба свойства, то они оба учитываются, но у свойства byObject приоритет выше.
- Хинты с поддержкой HTML: При наличии в модели заполненного свойства hints с указанным индексом столбца, они отображаются для каждого объекта.
Посмотреть настройку
¶ Возможность задавать итераторы по отметке
В конструкторе методик добавлена возможность создавать папки. При создании папки автоматически добавляется элемент «Итераторы» для возможности задать итеративный расчет и сдвиг отметки итератора по определенному измерению.
Итератор позволяет задать внутри методики однотипные расчеты данных, но с необходимым сдвигом как приемника, так и операнда вдоль определенного измерения. При запуске расчета, итеративная формула рассчитывается итеративно по шагам из элементов справочника-итератора.
Папки могут иметь вложенность, то есть дочерние папки или формулы.
В область итераторов можно переносить справочники из репозитория. Если справочник содержится в перечне итераторов, то при добавлении формулы с данным справочником для него появляется вкладка свойства, а на ней флаг "Использовать отметку итератора" включенный по умолчанию. Выбор элементов в таком случае становится недоступным.
В область итераторов можно переносить справочники из приемника, при этом из справочников приемника справочник не удаляется, однако также автоматически выставляется флаг "Использовать отметку итератора", выбор элементов становится недоступным, но записывается в фильтр итератора.
Посмотреть настройку
¶ Возможность переноса показателя с данными
Добавлена возможность переноса показателей обновлением на другой стенд платформы с данными.
- В момент формирования обновления добавлена возможность включить в обновление все элементы (данные) показателя.
- При установке сформированного обновления добавлена возможность выбрать - устанавливить показатель с данными или без.
¶ Схема процессов согласования
Добавлена схема, отображающая настроенный процесс согласования.
Для открытия схемы необходимо нажать на кнопку "Показать схему" в верхней панели согласования.
На схеме:
- Состояния процессов отображаются в виде прямоугольных блоков с названием состояния внутри. У состояния, которое является начальным выводится подпись "Начало". Для состояний, которые являются завершающими, из которых нет настроенных шагов, выводится подпись "Конец".
- Ниже наименования выводится регламент, заданный у состояния.
- Шаги рисуются стрелками от состояния к состоянию, в соответствии с заданными настройками в шаблоне процесса. Наименование шага выводится подписью у стрелки.
- Если для состояния заданы подпроцессы, то они показываются пунктирной линией от соответствующего состояния и выводятся в прямоугольных блоках друг за другом (если подпроцессов несколько).
Посмотреть настройку
¶ Возможность стилизации кнопки "Выход"
Реализована возможность изменить стиль кнопки "Выход" в пользовательском приложении.
Для этого добавлены следующие настройки:
| Настройка | Описание | Тип |
|---|---|---|
| LOGOUT_BUTTON_CSS | Оформление кнопки выхода | css |
| LOGOUT_BUTTON_IMAGE | Иконка для кнопки выхода | base64 или svg |
| LOGOUT_BUTTON_IMAGE_CSS | Оформление иконки для кнопки выхода | css |
| LOGOUT_BUTTON_TEXT | Текст для кнопки выхода | строковый (текст) |
Пример настройки LOGOUT_BUTTON_CSS
color: #166BDD;
display: flex;
gap: 10px;
justify-content: center;
align-items: center;
opacity: 1!important;
font-style: normal;
font-weight: 400px;
font-size: 16px;
line-height: 20px;
Пример настройки LOGOUT_BUTTON_IMAGE
<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M10.877 5.375L13.502 8L10.877 10.625" stroke="#166BDD" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M6.5 8H13.5" stroke="#166BDD" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M7.5 13.5H3C2.86739 13.5 2.74021 13.4473 2.64645 13.3536C2.55268 13.2598 2.5 13.1326 2.5 13V3C2.5 2.86739 2.55268 2.74021 2.64645 2.64645C2.74021 2.55268 2.86739 2.5 3 2.5H7.5" stroke="#166BDD" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"/>
</svg>Пример настройки LOGOUT_BUTTON_IMAGE_CSS
width: 16px; height: 16px;
¶ Возможность копирования показателя с данными
Добавлена возможность копировать показатели с имеющимися в них данными. При копировании открывается окно, в котором необходимо выбрать, как 'вставить' показатель: с данными или без.
Нам очень важна ваша обратная связь!
Заполни форму обратной связи, если ты нашел ошибку или хочешь рассказать о своем опыте использования документации 3V.
Это помогает нам развиваться и становиться полезнее!