Как узнать вашу версию платформы 3V смотри в статье.
Дата выпуска: июль 2022г.
¶ Изменение логики выполнения действия "Установить значение в элемент"
Ранее, если отметка в поле выставлялась с помощью действия "Установить значение в контрол" (CalculateControlValueAction), то не выполнялись пересчет зависимых источников от этого поля и выполнение действий, привязанных на изменение значения этого поля. С текущей версии установка значения таким образом будет вызывать все действия указанные выше.
¶ Использование pg-provider в виде библиотеки
Строка подключения к данным показателей перемещена в конфигурационные файлы.
Что бы не возникало ошибок, необходимо в СonfigMaps: 'calculation.json' и 'engine.json' добавить строки подключения к показателям (так, как они выглядят в pg-provider.json):
"DatabaseSearchPath": "indicators",
"Namespaces": {}
¶ API для сервиса справочников
Для работы с данными справочника реализованы более удобные методы API на создание/редактирование, удаление и чтение данных.
¶ Импорт множественных связанных атрибутов
Добавлена возможность экспорта и импорта справочника со множественными связанными атрибутами.
- Экспорт производится по кнопке "Экспорт шаблона с данными", которая находится в выпадающем списке "Экспорт".
- Импорт производится по клику на иконку справочника в левом верхнем углу и выборе пункта "импорт". Импорт работает как по ключу так и по наименованию.
¶ Возможность выполнять фильтрацию данных на стороне сервиса справочников
Для внешних справочников добавлена опция - всегда выполнять фильтрацию данных на стороне сервиса справочников, чтобы не реализовывать все опции фильтрации на стороннем сервисе. Для этого в JSON добавлена настройка "applyFiltersInPlace": true.
Данная возможность позволит строить сложные фильтры к таким справочникам, например:
Ранее такую фильтрацию можно было настроить только для кэшированных внешних справочников, если внешний справочник не кэшируемый то логику фильтрации нужно было передавать в сервис коннектор. Этот флаг позволяет этого не делать.
Важно! Включать флаг нужно только для небольших справочников, потому что в момент обращения к нему все данные справочника будут переданы в сервис справочников и отфильтрованы там.
¶ Возможность перемещения справочников показателя в строки
В конструкторе отчетов во вкладке 'Столбцы', для справочников, расположенных в показателе, добавлена возможность перемещения в область строк.
Для этого:
- откройте конструктор отчета
- перейдите в область "Столбцы"
- выделите необходимый справочник показателя
- откройте его контекстное меню по клику на кнопку "..."
- в раскрывшемся списке выберите элемент "Переместить в строки".
При перемещении работает тот же функционал что и при добавлении справочника в строки
- Справочник помещается в строках (отметка копируется из шапки)
- В столбцы в конец добавляется атрибут "Наименование"
- Во всех показателях этот справочник отображается синим цветом
¶ Стилизация для компонента Text and titles
В конструкторе форм, на вкладку стилей 
добавлены свойства для компонента ‘Текст и заголовки’ (trv-text) для изменения его оформления.
По умолчанию настройки имеют пустые значения. Свойства необходимо задавать строкой, или же выбрать вариант из списка.
Реализована возможность задавать следующие свойства:
Свойства
| Пример | Название в конструкторе | Тип поля | Допустимые значения |
|---|---|---|---|
| "background-color": "#c53636" | Цвет фона | выбор цвета (color-picker) | string |
| "color": "#c53636" | Цвет текста | выбор цвета (color-picker) | string |
| "font-family": "Tahoma" | Шрифт | список | |
| "font-size": 12px | Размер шрифта | строка | string |
| "font-style": "italic" | Начертание шрифта | строка | string |
| "font-weight": "bold" | Начертание шрифта (насыщенность) | строка | string |
| "line-height": 10px | Междустрочный интервал | строка | string |
| "opacity": 50% | Прозрачность | строка | string |
| "text-align": "left" | Выравнивание по горизонтали | список | center (по центру) justify (по ширине) left (по левому краю) right (по правому краю) |
| "text-decoration": "underline" | Подчеркивание | список | underline (подчеркнутый) line-through (перечеркнутый) overline (линия над текстом) |
| "text-transform": "lowercase" | Регистр | список | capitalize (Первый символ заглавный) lowercase (Все символы строчные) uppercase (Все символы прописные) |
| "vertical-align": "top" | Выравнивание по вертикали | список | baseline (По базовой линии) top (По верхнему краю) bottom (По нижнему краю) middle (По середине) sub (Как подстрочный) super (Как надстрочный) text-bottom (По нижнему краю строки) text-top (По верхнему краю строки) |
¶ Конструирование параметров формы
Настройка параметров формы теперь осуществляется по кнопке "Параметры" в верхней панели формы. Блок "Параметры", находящийся в левом дереве исключен.
В шапке формы отображаются все имеющиеся параметры, значение которых можно изменять, после чего форма перестроится и будет отображена в соответствии с выбранными параметрами.
Для параметров могут быть заданы следующие свойства:
- Наименование параметра
- Тип параметра: справочник, строка, число, логический, дата)
- В случае если тип "справочник", то необходимо указать связанный справочник
- Множественное или одиночное значение
- Видимость на панели параметров
- Значение по умолчанию (в зависимости от типа данных параметра)
Если флаг "Скрывать на панели параметров" выключен, то параметр формы будут отображен не только в режиме редактирования, но и в режиме просмотра при открытии формы в навигаторе объектов и пользовательском приложении.
Окно создания/редактирования параметров работает по аналогии с окном параметров в отчетах.
Подробнее
- Есть возможность в качестве параметра добавить справочник путем "перетаскивания" из дерева объектов в панели слева.
- Для параметров с типом "Справочник" в правой части окна отображаются вкладки: Свойства, Элементы (для задания фильтра на элементы параметра).
- Для параметров с другими типами поле для задания значения по умолчанию располагается на вкладке "Свойства"
- При создании параметра типа "Справочник" создается параметр с дискриминатором DictionaryParameterDto, при создании параметра с другим типом, создается параметр с дискриминатором TypedValueParameterDto, если для параметра не задается тип, то создается параметр с дискриминатором SimpleValueParameterDto.
- SimpleValueParameterDto - остается для поддержки текущих параметров, которые уже созданы в существующих формах.
Посмотреть настройку
¶ Новый компонент "Интерактивная карта"
Добавлен новый компонент "Интерактивная карта".
При добавлении интерактивной карты в форму она располагается на географической карте-подложке OSM – OpenStreetMap. Подложка рисуется автоматически при создании объекта, её можно приближать до конкретного места улицы или дома.
Также как и для обычной карты в источнике данных для интерактивной карты могут содержаться:
- Наименование объекта
- Точки и полигоны в формате geoJSON
- Иконки для точек
- Хинты
Функционал интерактивной карты:
- Отображение точек и полигонов: при добавлении источника с geoJSON и задании слоев на карте появляется отрисовка полигонов и точек (по аналогии с обычной картой).
- Стили: при добавлении стилей карта раскрашивается в зависимости от стиля, также можно задать пользовательские иконки точек.
- Если заполнено свойство common, то стили из данного свойства применяются ко всем объектам слоя.
- Если заполнено свойство byObject, то стили для каждого объекта получаются из указанного столбца и к каждому объекту применяется свой стиль.
- Если заполнены оба свойства, то они оба учитываются, но у свойства byObject приоритет выше.
- Хинты с поддержкой HTML: При наличии в модели заполненного свойства hints с указанным индексом столбца, они отображаются для каждого объекта.
Индексы столбцов (с данными geoJson и подсказками):
a. скрытые столбцы в отчете также необходимо считать за столбец;
b. если есть какие-то динамические данные, например необходимо вывести показатель с календарем по столбцам и кол-во периодов уже зависит от параметра отчета, то такие стобцы необходимо распологаться в отчете в конце, либо не выводить, а сворачивать по календарю, при необходимости данных для стилей. Данная логика требуется, так как индексы столбцов всегда зафиксированы, а при смене отметки параметра индекс будет меняться
Посмотреть настройку
¶ Возможность задавать итераторы по отметке
В конструкторе методик добавлена возможность создавать папки. При создании папки автоматически добавляется элемент «Итераторы» для возможности задать итеративный расчет и сдвиг отметки итератора по определенному измерению.
Итератор позволяет задать внутри методики однотипные расчеты данных, но с необходимым сдвигом как приемника, так и операнда вдоль определенного измерения. При запуске расчета, итеративная формула рассчитывается итеративно по шагам из элементов справочника-итератора.
Папки могут иметь вложенность, то есть дочерние папки или формулы.
В область итераторов можно переносить справочники из репозитория. Если справочник содержится в перечне итераторов, то при добавлении формулы с данным справочником для него появляется вкладка свойства, а на ней флаг "Использовать отметку итератора" включенный по умолчанию. Выбор элементов в таком случае становится недоступным.
В область итераторов можно переносить справочники из приемника, при этом из справочников приемника справочник не удаляется, однако также автоматически выставляется флаг "Использовать отметку итератора", выбор элементов становится недоступным, но записывается в фильтр итератора.
Посмотреть настройку
¶ Возможность переноса показателя с данными
Добавлена возможность переноса показателей обновлением на другой стенд платформы с данными.
- В момент формирования обновления добавлена возможность включить в обновление все элементы (данные) показателя.
- При установке сформированного обновления добавлена возможность выбрать - устанавливить показатель с данными или без.
¶ Возможность копирования показателя с данными
Добавлена возможность копировать показатели с имеющимися в них данными. При копировании открывается окно, в котором необходимо выбрать, как 'вставить' показатель: с данными или без.
¶ Схема процессов согласования
Добавлена схема, отображающая настроенный процесс согласования.
Для открытия схемы необходимо нажать на кнопку "Показать схему" в верхней панели согласования.
На схеме:
- Состояния процессов отображаются в виде прямоугольных блоков с названием состояния внутри. У состояния, которое является начальным выводится подпись "Начало". Для состояний, которые являются завершающими, из которых нет настроенных шагов, выводится подпись "Конец".
- Ниже наименования выводится регламент, заданный у состояния.
- Шаги рисуются стрелками от состояния к состоянию, в соответствии с заданными настройками в шаблоне процесса. Наименование шага выводится подписью у стрелки.
- Если для состояния заданы подпроцессы, то они показываются пунктирной линией от соответствующего состояния и выводятся в прямоугольных блоках друг за другом (если подпроцессов несколько).
Посмотреть настройку
¶ Проверка наличия прав пользователя на работу с приложением
При попытке авторизоваться в приложении при отсутствии доступа к нему, открывается страница с уведомлением об отстутствии прав.
При нажатии на кнопку "Вернуться на страницу авторизации" будет осуществлен выход и открыта страница авторизации.
¶ Возможность стилизации кнопки "Выход"
Реализована возможность изменить стиль кнопки "Выход" в пользовательском приложении.
Для этого добавлены следующие настройки:
| Настройка | Описание | Тип |
|---|---|---|
| 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.
Это помогает нам развиваться и становиться полезнее!