Патч 3.6.0.9 (17.07.2022)¶

Добавление и изменение функциональности¶

Улучшена поддержка запуска desktop-приложений TESSA в ОС Linux под Wine. Подробнее описано в разделе документации Запуск desktop-приложений TESSA на Linux с использованием Wine.
В руководство разработчика добавлен раздел Разработка в ОС Linux, в котором описывается настройка рабочего места под управлением ОС Linux и инициализация репозитория для ведения разработки проектных решений на платформе TESSA.
Реализована поддержка автоматизации Microsoft UI Automation для приложения TessaClient. Добавлена возможность запускать автоматизированные тесты UI с использованием библиотеки Winium. Обратитесь к разделу руководства.
В сборку добавлено приложение SchemeEditor в 32-разрядном варианте в папку Applications/SchemeEditor32.
Во всплывающей подсказке файла теперь отдельно отображается информация о дате, времени и сотруднике, который последним изменил контент файла, а также о дате, времени и сотруднике который последним изменил атрибуты файла (имя, категория и т.п.).
В карточку “Тип условия” добавлено поле с описанием карточки.
В типы карточек с настройками сотрудника добавлена поддержка работы с настройками, хранящимися в физических секциях. Физические секции больше не сериализуются в настройки сотрудника, а сохраняются непосредственно в физическую секцию карточки сотрудника.
В элементе управления “Представление” улучшен вывод информации об ошибках, произошедших при загрузке данных.
В форумах (обсуждениях) и в контроле “Текст с форматированием” на панель инструментов добавлены кнопки для выравнивания текста.
В форумах (обсуждениях) и в контроле “Текст с форматированием” на панель инструментов добавлена кнопка “Вставить моноширинный текст”, которая вставляет обрамлённый моноширинный текст внутри текущего блока.
В web-клиенте увеличена высота текстового поля “Результат” окна “Показать подробности”.
В desktop-клиенте для форумов (обсуждений) и элемента управления “Текст с форматированием” в контекстное меню приложенного файла добавлены пункты “Открыть для чтения” и “Предпросмотр”. Меню теперь также открывается по нажатию левой кнопки мыши.
В форумах (обсуждениях) добавлено отображение даты отправки сообщения для всех стандартных служебных сообщений, а также для любого сообщения с типом MessageType.Custom.
В форумах (обсуждениях) и в контроле “Текст с форматированием” добавлена возможность прикладывать внешние ссылки для использования внутри текста без отображения их в нижней части элемента управления.
В файл app.json сервиса Chronos добавлена настройка ChronosSyncTimeout, устанавливающая таймаут при запуске Chronos, когда используемый им глобальный объект синхронизации занят другим процессом или не был корректно освобождён.
В маршруты в этап “Диалог” добавлен параметр “Не предупреждать при закрытии диалога без изменений”, позволяющий отключить предупреждение при закрытии диалога без изменений по кнопке закрытия окна. Флаг влияет только на диалоги, для которых указано значение параметра Время жизни диалога как Запрос.
В конструктор бизнес-процессов в действие “Диалог” добавлен параметр “Не предупреждать при закрытии диалога без изменений”, позволяющий отключить предупреждение при закрытии диалога без изменений по кнопке закрытия окна. Флаг влияет только на диалоги, для которых указано значение параметра Время жизни диалога как Запрос.
В файле app.json Chronos переименована настройка AdSync.UseSSL на AdSync.UseSsl. Исправлять конфигурационный файл не требуется, т.к. при отсутствии настройки с новым названием выполняется парсинг настройки с предыдущим названием.
В форумах (обсуждениях) добавлен хоткей Ctrl+R для быстрого обновления топика.

Новые версии библиотек¶

CsvHelper 28.0.1
DocumentFormat.OpenXml 2.17.1
HtmlAgilityPack 1.11.43
HtmlSanitizer 7.1.542
Kerberos.NET 4.5.174
LiteDB 5.0.12
MailKit 3.3.0
NLog.Web.AspNetCore 4.15.0
Npgsql 5.0.14
StackExchange.Redis 2.6.48
Swashbuckle.AspNetCore 6.3.2

Изменения API¶

В web-клиенте для расширений TreeItemExtension и WorkplaceViewComponentExtension добавлена возможность переопределять метод finalized.
В IWorkflowEngineContext добавлен метод GetMainCardSatelliteAsync, позволяющий получить карточку сателлита и сохранить её в области видимости карточек для обработки в процессе Workflow Engine.
В web-клиенте для элемента управления “Текст с форматированием” и “Обсуждения” добавлено свойство spellcheck, позволяющее включить/выключить стандартную проверку орфографии браузера. Свойство доступно в RichTextBoxViewModel.spellcheck и ForumViewModel.spellcheck соответственно.
В метод IForumProvider.AddTopicAsync добавлен опциональный параметр authorAction, позволяющий управлять тем, требуется ли добавлять автора в участники создаваемого топика и подписывать его на уведомления.
Добавлена возможность отображать диалоги, основанные на типе карточки “Диалог”, с фоном аналогичному фону карточек. В делегат CreateDialogFormFuncAsync добавлен опциональный параметр formCreationOptions. По умолчанию равен FormCreationOptions.None, что значит то, что форма создается стандартным образом. Установка параметра, как FormCreationOptions.AlwaysCreateTabbedForm означает, что любая форма будет создана как ITabbedFormViewModel без видимости вкладок, что отображается как форма с полупрозрачной подложкой с обводкой. В web-клиенте в функцию createDialogForm добавлен параметр с аналогичным поведением.
Добавлен интерфейс ISourceProviderLinker, механизм, который cвязывает между собой ресурсы, представляющие собой источник контента или директорий через провайдеры ISourceContentProvider или ISourceDirectoryProvider, с возможностью создания нового ресурса в качестве связанного, а также перезаписи данных из связанного ресурса в изначальный.
В метод ICardUIManager.ProcessTemplateResponseAsync добавлен параметр cardModelModifierActionAsync, позволяющий изменить созданную модель представления карточки после инициализации UI.
Изменена сигнатура методов CardUIHelper.TryCreateFromTemplateAsync и CardUIHelper.TryCreateFromTemplateResponseAsync. Параметры modifyCardActionAsync, modifyEditorActionAsync и displayValue удалены, вместо них нужно использовать свойства CardModifierActionAsync, CardEditorModifierActionAsync и DisplayValue параметра options. У метода CardUIHelper.TryCreateFromTemplateResponseAsync удалён параметр workspaceName. Для изменения заголовка рабочего места используйте свойство CardEditorModifierActionAsync параметра options.
Изменена сигнатура метода UIExtensions.CreateFromTemplateAsync. Изменён тип параметра options с OpenCardOptions на CreateCardOptions. Параметры templateInfo, modifyCardActionAsync и modifyEditorActionAsync удалены, вместо них нужно использовать свойства Info, CardModifierActionAsync и CardEditorModifierActionAsync параметра options.
Для интерфейса IFilePreviewManager добавлен метод PreviewRequiresConversionAsync, который определяет, нужно ли использовать конвертацию в pdf для предпросмотра файла.
В объекте IKrVirtualFileManager добавлен метод GetSuggestedFileNameAsync для получения предпочитаемого имени виртуального файла для указанного в шаблоне имени версии. Также метод FillCardWithFilesAsync теперь возвращает результат локализации, вместо его передачи через параметр.
В маршрутах в IKrScope.GetMainCardAsync добавлена возможность получения карточки сателлита по его идентификатору из кэша, если он был туда помещён с помощью одного из методов: IKrScope.GetKrSatelliteAsync, IKrScope.TryGetKrSatelliteAsync, IKrScope.CreateSecondaryKrSatelliteAsync, IKrScope.GetSecondaryKrSatelliteAsync.
В методы сериализации и десериализации настроек InitializationExtensionHelper.SerializeSettingsFromSectionsByTypeAsync и InitializationExtensionHelper.DeserializeSettingsToSectionsByTypeAsync добавлен параметр virtualSectionsOnly, который определяет, что должны сериализоваться/десериализоваться только виртуальные секции. Также из метода InitializationExtensionHelper.DeserializeSettingsToSectionsByTypeAsync, принимающего настройки в виде Dictionary<string, object>, удалён неиспользуемый параметр typedJson.
В API тестов в объект ValidationResultItemValidator добавлены методы: CheckMessage, CheckObjectName, CheckObjectType, CheckFieldName и CheckDetails. Они позволяют упростить проверку соответствующих значений объекта IValidationResultItem и вывести ожидаемые значения при её нарушении.
Для desktop-приложений в следующие классы UI добавлена возможность программного управления фокусом: ClientQuickSearchViewModel, CurrentPageViewModel, OptionalPagingButton, QuickSearchViewModel, ShowContextMenuButtonViewModel, ClearFilterButton, FilterButton, NextPageButton, PreviousPageButton, RefreshButton, ViewControlToolbarButtonViewModel, ExpandAllButtonViewModel.
В web-клиенте добавлена функция localize, удобным образом выполняющая локализацию. Примеры использования: localize('$Something'); localize('{$Something} else'); localize('{$Hello}, {0}', userName). Поддерживается вызов как tag function. Импорт в коде расширений: import { localize } from 'tessa/localization'. Подробное описание в руководстве разработчика.

Исправления и оптимизации¶

В web-клиенте исправлена ошибка, из-за которой пункт контекстного меню “Активировать” в таблице маршрутов был доступен всегда.
В конструкторе бизнес-процессов оптимизирована загрузка карточек сателлитов.
Исправлена поддержка кодов серверов ServerCode, содержащих нестандартные символы для ссылок, например, русскоязычный текст.
В web-клиенте исправлена ошибка, не позволявшая выгружать диаграммы посредством тайлов “Выгрузить все данные” и “Выгрузить текущую страницу”.
В web-клиенте исправлена ошибка в контроле “Дата и время”, из-за которой нельзя было устанавливать дату вручную на мобильных устройствах.
Общие оптимизации производительности для серверных компонентов и desktop-приложений.
В web-клиенте в форумах (обсуждениях) исправлена ошибка подсчета символов сообщения, из-за которой текст цитаты учитывался при подсчете.
В web-клиенте исправлена ошибка, приводящая к некорректной работе анимации контекстного меню в браузере Mozilla Firefox.
Оптимизировано получение основного сателлита с помощью метода IKrScope.GetKrSatelliteAsync.
Исправлено избыточное создание основного сателлита для новой основной карточки при расчёте возможности полного пересчёта процесса.
В форумах (обсуждениях) исправлена ошибка, не позволяющая супермодератору сохранить или открыть файл из обсуждения, если он не входит в список участников топика.
В форумах (обсуждениях) больше не отправляется служебное сообщение об изменении списка участников, если фактического изменения не было.
При загрузке карточки больше не загружается информация о кнопках локальных вторичных процессов маршрутов в случае, если карточка загружается в серверных расширениях.
В API клиентских тестов исправлено выполнение повторной расширенной инициализации.
Стратегия перерасчета замещений DeputiesSyncStrategy теперь кэширует стандартный логгер, используемый при отсутствии логгера в запросе.
Оптимизирована проверка прав при сохранении карточки с измененными файлами.
WorkflowEngineStoreExtension не будет создавать очередь действий с Workflow при каждом сохранении карточки.
Card.RemoveAllButChanged будет обнулять поля Card.Files и Card.Tasks в случае, если не было изменений. Это актуально для методов Card.TryGetFiles и Card.TryGetTasks, которые возвращают null в случае, если эти поля не были заданы.
В desktop-клиенте в форумах (обсуждениях) исправлена ошибка, когда обычный участник топика мог добавить модератора в участники этого топика.
В desktop-клиенте для элемента управления “Текст с форматированием” исправлена ошибка, которая в некоторых случаях приводила к некорректному определению наличия изменений в карточке.
Оптимизировано создание карточек ролей при условии, что заполнено поле Roles.TimeZoneID.
Оптимизировано потребление памяти в классе Tessa.Cards.ComponentModel.CardLoader, используемом при загрузке данных карточки.
В web-клиенте исправлена ошибка, приводящая к закрытию окна диалога поисковых запросов при удалении запроса.
В web-клиенте исправлена ошибка отображения блока с настройкой “Заголовки слева” внутри элемента управления “Контейнер”.
При загрузке карточки документа проверка наличия ознакомления будет пропущена в случае, если карточка загружается в серверных расширениях.
В редакторе схемы данных исправлена ошибка создания и изменения внешнего ключа таблицы в ситуации, когда автоматически сформированное имя внешнего ключа оказывалось слишком длинным.
В web-клиенте исправлена ошибка, приводящая к отсутствию расчета положения вложенных уровней контекстного меню.
В web-клиенте исправлена ошибка, из-за которой активированные этапы маршрута выделялись серым цветом.
Исправлен запуск web-клиента, если у одного из рабочих мест, доступных пользователю, указана настройка “Где отображать узел”, равная “Tessa Client”.
В конструкторе бизнес-процессов исправлено название сохраняемых в историю действий объектов.
В обработчике шаблонов бизнес-процессов исправлена ошибка получения задания по идентификатору, возникающая в ситуации, если обработка процесса идёт вне сохранения карточки.
При сохранении карточки сотрудника добавлена очистка пробелов из начала и конца значения поля E-mail.
В редакторе схемы данных убрано автоматическое удаление ссылочной колонки при удалении этой колонки из первичного ключа.
Исправлена ошибка отправки уведомлений в ситуации, когда в теле или заголовке уведомления используются методы для получения данных из плейсхолдеров.
В web-клиенте исправлена ошибка, приводящая к отсутствию ограничения высоты ячеек колонки “Результат” вкладки “История заданий”.
В методах ICardEditorModel.CreateCardAsync и ICardEditorModel.OpenCardAsync исправлена ошибка, из-за которой нельзя было заменить модель представления с помощью параметра cardModelModifierActionAsync.
Исправлена ошибка в экспорте карточек, при которой могли быть потеряны данные, если экспортируемая карточка перезаписывала существующую.
В команде tadmin ConvertCards исправлена ошибка, при которой могли быть потеряны данные, если конвертируемые файлы перезаписывали существующие.
В desktop-клиенте исправлена ошибка при загрузке карточки настроек, к которой приложено большое количество файлов. Например, если к карточке “Настройки электронной подписи” приложить 30 файлов сертификатов.
Исправлено получение метаинформации по карточкам настроек из кэша, если единственным изменением в карточке было добавление файла. Например, к карточке “Настройки электронной подписи” был добавлен файл сертификата.
Оптимизировано первое сохранение карточек, использующих проектные номера.
В маршрутах и редакторе бизнес-процессов исправлена ошибка, из-за которой не обрабатывался параметр “Имя диалога (для расширений)” этапа и действия “Диалог”.
В конструкторах классов CardEditorCreationContext и CardEditorOpeningContext исправлена передача значения параметра cancellationToken в базовый класс.
Исправлена ошибка, из-за которой в метаданных представления настройка SelectionMode не работала.
В конструкторе бизнес-процессов снятие блокировок на обработку экземпляров бизнес-процессов теперь происходит при завершении транзакции.
В web-клиенте исправлены отступы блоков, вложенных в список, и шрифт моноширинного блока в элементах управления “Текст с форматированием” и “Обсуждения”.
В desktop-клиенте в форумах (обсуждениях) исправлена ошибка, приводившая к появлению лишних переносов строки, при копировании многострочного текста из web-клиента.
В desktop-клиенте в форумах (обсуждениях) и элементе управления “Текст с форматированием” исправлено некорректное определение размера шрифта в текущей позиции курсора.
Восстановлена работоспособность сворачивания и разворачивания групп в древовидном представлении при использовании режима выделения “Ячейка”.
В маршрутах в этапе “Задача” исправлена ошибка, из-за которой не завершался этап при отзыве задания верхнего уровня, если в параметрах этапа был установлен флаг “Вернуть после завершения”.
В конструкторе бизнес-процессов в действии “Выполнение задачи” исправлена ошибка, из-за которой не завершалось действие при отзыве задания верхнего уровня, если в параметрах действия был установлен флаг “Вернуть после завершения”.
В desktop-клиенте для контрола “Представление” исправлено выполнение представления в контексте UIContext, что позволяет обращаться к текущей карточке из клиентского перехватчика представления, задействованного в контроле.
Исправлен механизм увеличения номера версии конфигурации при сохранении и удалении системных типов карточек, влияющих на метаинформацию, когда ранее версия могла не увеличиваться, несмотря на то, что сохранение или удаление было выполнено.
В web-клиенте исправлено использование параметров фильтрации представлений, у которых в схеме данных указан тип Decimal или Currency.
В desktop-клиенте отступ области с заданиями в карточке привязан к положению начала контента под вкладками (актуально, когда вкладки скрыты или занимают несколько строк).
В конструкторе бизнес-процессов оптимизировано удаление процесса при завершении обработки.
Исправлена работа процедур KrPermissionsObtainReadersLock и KrPermissionsObtainWritersLock для PostgreSQL, когда при параллельной работе запрос на снятие блокировки ожидал завершение выполнения этих процедур.
Исправлена ошибка в кэше рабочих мест, которая приводила к тому, что без перезапуска пула приложений доступный набор рабочих мест мог определяться некорректно.
Исправлена локализация имён виртуальных файлов, приложенных к отправляемому письму. В типовом решении это актуально для файла “Лист согласования”.
Оптимизировано выполнение расширения KrCheckStageRowModifiedStoreExtension.
В маршрутах исправлена проверка наличия изменений в этапах вложенного процесса.
В маршрутах оптимизирована проверка порядка следования этапов.
В web-клиенте исправлена ошибка, приводящая к игнорированию настройки “Заголовки слева” в блоках карточки.
В web-клиенте в тулбаре диалоговых окон исправлены ссылки на карточки.
В web-клиенте исправлена ошибка в работе заданий, в которых был добавлен контрол “Список файлов”.
В web-клиенте в контроле “Список файлов”, добавленном на форму задания, исправлена некорректная группировка по категориям копий файлов.
В контроле “Список файлов” добавлен сброс фильтров при добавлении нового файла.
В TessaAdmin в редакторе локализации исправлена работа кнопки “Обновить все библиотеки локализации с сервера”.
В контроле “Представление” исправлено некорректное отображение выделенных ячеек.
В маршрутах в этапе “Задача” исправлена передача названий сохраняемых объектов в историю действий.
В конструкторе бизнес-процессов для действия “Выполнение задачи” исправлена передача названий сохраняемых объектов в историю действий.
В маршрутах добавлена строка локализации для ключа сообщения о результате валидации DefaultValidationKeys.RecalcWithChanges.
В маршрутах исправлена ошибка, из-за которой происходило некорректное выполнение процесса. Ошибка воспроизводилась, если перед запуском процесса маршрут был пересчитан и изменён в карточке документа, после чего шаблон этапов был удалён или исключён по условию.
Оптимизировано выполнение расширения KrStagePermissionsNewGetExtension при получении информации о шаблонах этапов.
В маршрутах исправлена ошибка, из-за которой можно было изменять параметры этапа созданного по шаблону, если это было запрещено в шаблоне или группе этапов.
Исправлено сообщение об ошибке при попытке удаления сателлита по запросу с клиента.
Исправлена ошибка сериализации KrToken при проверке прав на доступ к представлению “История заданий”.
Исправлено удаление карточки, содержащей задание, назначенное на удалённую роль.
В конструкторе бизнес-процессов в действии “Согласование” исправлена ошибка при изменении отображаемого порядка следования согласующих после добавления или удаления дополнительных согласующих.
В конструкторе бизнес-процессов в действии “Согласование” исправлено удаление дополнительных согласующих при удалении основных согласующих.
В desktop-клиенте добавлено обнуление свойства ICardModel.ClosingRequest при закрытии диалога с карточкой.
В desktop-клиенте при первом сохранении карточки, для которой был выделен номер, теперь не отправляется запрос на дерезервирование номера.
В контроле “Представление” в desktop-клиенте исправлена ошибка ArgumentNullException при создании GetDataResponse конструктором без параметров.
Исправлена возможность скопировать тип диалога в TessaAdmin через контекстное меню на типе.
В web-клиенте исправлена ошибка, приводящая к некорректному отображению описания колонок диаграмм.
Исправлена ошибка, возникающая при отображении элемента управления “Представление” и приводящая к исключению в случае, если в выводимом представлении было некорректно задано отображаемое имя колонки.
Во всплывающей подсказке (popup) контролов “Ссылка”, “Список” и ссылочных параметров фильтрации в представлениях исправлен вывод колонок типа Time, содержащих только время.
В маршрутах исправлено некорректное определение того, был ли изменён порядок для вручную добавленного этапа. Ошибка воспроизводилась, если после добавления этапа, перед изменением его порядка, не выполнялось сохранение карточки.
В web-клиенте в элементе управления “Текст с форматированием” исправлен ряд ошибок, предотвращавших корректный ввод текста при работе с программной клавиатурой в Android.
В таблице ActionHistory исправлен индекс по колонкам ApplicationID+Modified.
В маршрутах исправлена ошибка В маршруте отсутствуют этапы, выполняемые при запуске процесса (вторичный процесс "<Название вторичного процесса>", ID ="<Идентификатор вторичного процесса>"). при запуске асинхронного локального вторичного процесса. Ошибка воспроизводилась, если процесс содержал этапы, и во всех из них был установлен флаг “Не показывать в маршруте”.
В маршрутах исправлена ошибка при загрузке карточки, если при её выполнении были исключены секции (CardGetRestrictionFlags.RestrictSections).
Расширение WorkflowTilesNewGetExtension не будет пытаться получить список тайлов WorkflowEngine при создании карточки файла.
При перезапуске сервиса Chronos в Linux исправлено освобождение объектов синхронизации, некорректно освобождённых на предыдущем запуске, что могло приводить к зависанию.
Исправлена ошибка, из-за которой при сохранении условий некорректно сериализовались настройки коллекционных секций, если в них не было строк.
Оптимизирована регистрация ряда серверных расширений в IUnityContainer.
Исправлено выполнение методов расширений ***Finally (например, ICardStoreExtension.AfterRequestFinally), где методы последующих классов расширений перестают выполняться, когда срабатывает токен отмены операции context.CancellationToken.
Исправлено параллельное открытие нескольких диалоговых окон из объекта IAdvancedCardDialogManager, запрошенного из Unity.
В файлах app.json для Chronos и веб-сервиса исправлен парсинг необязательных настроек AdSync.Port, AdSync.TimeoutMilliseconds, AdSync.ConnectionAttemptCount, AdSync.ConnectionAttemptIdle, а также для группы LDAP исправлен парсинг настроек ConnectionAttempt и ConnectionAttemptIdle.
В web-клиенте исправлена ошибка, приводящая к отсутствию реакции скролла представлений при нажатии клавиш “вверх” и “вниз”.

Обновление на новую сборку¶

Добавлена поддержка дистрибутивов Linux ALT Linux 10.0 и Astra Linux Special Edition 1.7.1. Полный список поддерживаемых дистрибутивов (с которыми тестировалась платформа) доступен в разделе документации Системные требования для серверов Linux.
Во всех файлах проектов расширений .csproj включается файл Tessa.targets, в котором указано свойство LangVersion 9. В текущей реализации это соответствует версии C# 9.0. Укажите значения в ваших проектах расширений, если актуально получить языковые возможности последней доступной версии C# при разработке расширений.
Метод WorkflowEngineContextExtension.TryGetKrSatelliteCardAsync переименован в WorkflowEngineContextExtension.GetKrSatelliteAsync. Переименуйте места вызова метода в проектном решении.
В настройки сотрудника в PersonalRoleSatellite.Settings теперь сериализуются и десериализуются только виртуальные секции из типов карточек с настройками. Если для настроек сотрудника использовались физические секции и они должны сериализоваться в настройки сотрудника, то эти секции необходимо сделать виртуальными.
Изменены сигнатуры методов CardUIHelper.TryCreateFromTemplateAsync, CardUIHelper.TryCreateFromTemplateResponseAsync и UIExtensions.CreateFromTemplateAsync. Перечень изменений содержится в разделе с описанием API. Актуализируйте использование методов в проектном решении.
Исправлены опечатки в методах GetCardTaskDialogAcionResult и SetCardTaskDialogAcionResult. Переименуйте места вызова методов в проектах.

Изменения конфигурации при обновлении¶

Таблицы:
- ActionHistory
- ConditionTypes
- DeletedTaskRoles
- KrDialogStageTypeSettingsVirtual
- KrWeRolesVirtual
- WeDialogAction
Процедуры:
- KrPermissionsObtainReadersLock
- KrPermissionsObtainWritersLock
Типы:
- ConditionType
- FilePreviewDialog (добавлен)
- KrApprovalAction
- KrDialogStageTypeSettings
- ServerInstance
- WorkflowDialogAction
Изменены библиотеки локализации.