Как узнать вашу версию платформы 3V смотри в статье.
Дата выпуска: сентябрь 2022г.
¶ Лицензионный ключ для работы платформы
Теперь необходимо указывать лицензионный ключ в конфигурациях облака/стенда для работы платформы.
При отсутствии лицензионного ключа платформа не будет работать
Пример:
"License": {
"PublicKey": "",
"LicenseKey": "",
"LicenseData": {
"ValidityPeriod": {
"Start": "2022-01-04T00:00:00",
"Duration": {
"Years": 1,
"Months": 0,
"Days": 0
}
},
"CompanyName": "ABC",
"UserLimits": null
}
},
¶ Отправка уведомлений для согласований
Ранее при отсутствии настроек Notifications уведомления приходили ответственным за шаги.
Теперь в таком случае уведомления не приходят.
При настройке уведомлений, у которых явно не заданы получатели, в json-модели согласования должен быть прописан раздел получателей с типом DefaultNotificationsRecipientsModel, в таком случае получатели будут браться из ответственных за шаги.
"recipients": {
"discriminator": "DefaultNotificationsRecipientsModel"
}
¶ Изменение дизайна
Навигатор объектов:
-
Из правой панели исключена кнопка получения ссылки на объект. Кнопка в новом дизайне
перенесена в панель инструментов главного окна навигатора. -
Кнопки для сортировки в режиме просмотра "плитка" и выбора отображаемых столбцов режиме просмотра "список" перенесены в правую часть панели инструментов и располагаются перед кнопками, позволяющими выбрать режим отображения.
Отчеты:
-
Из правой панели убраны неиспользующиеся кнопки. Кнопка для получения ссылки на объект
перенесена в верхнюю панель. -
В верхнюю панель параметров добавлена кнопка "Показать в навигаторе"
-
В верхней панели инструментов, а также в списке, раскрывающемся при нажатии на иконку объекта изменился порядок доступных кнопок. В пользовательском приложении изменились перечень и порядок доступных кнопок
В отчете в пользовательском приложении правая панель настроек, а также кнопки, позволяющие редактировать модель отчета недоступны
¶ Отображение 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.
При наличии коллекции изображений первое из них отображается в полном размере, а остальные под первым в режиме предпросмотра.
Для настройки:
- Добавьте на форму элемент «Галерея изображений» из группы «Прочие» по клику на + .
- Добавьте на форму источник - справочник, в котором хранятся изображения
Изображения отображаются только при наличии в справочнике-источнике отметки, например в "dictionarySourceSelectionMode"
- К элементу галерея изображений добавьте источник для отображения и выберите атрибут, в котором хранятся изображения (тип атрибута файл)
К галерее изображений можно применить следующие настройки:
- Точки навигации (для пролистывания изображений)
- Стрелки навигации (для пролистывания изображений)
- Панель предпросмотра
- Полноэкранный режим (позволяет открыть изображение в полноэкранном режиме при нажатии на соответствующую кнопку)
- Выбрать изображение по умолчанию (указать индекс изображения, начинается с 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. При изменении связей задачи и повторной загрузке данных, в справочник добавятся новые связи задачи, а старые удаленные связи будут удалены в справочнике.
Нам очень важна ваша обратная связь!
Заполни форму обратной связи, если ты нашел ошибку или хочешь рассказать о своем опыте использования документации 3V.
Это помогает нам развиваться и становиться полезнее!