Патч 4.1.2 (02.08.2025)

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

1. Во вкладке “Мои замещения” для таблиц “Кого я замещаю” и “Кого я замещаю по типу документа” параметр фильтра “Активно” заменён на “Показывать все замещения”. Теперь по умолчанию отображаются только активные замещения.
2. В web-клиенте при отображении обозревателя свойств в модальном режиме добавлена возможность изменения настроек диалога. Вместо showViewModelDialog используйте вспомогальные методы PropertyGridHelper.showDialog и PropertyGridHelper.showMultipleDialog для отображения диалога с обозревателем свойств.
3. В конструкторе бизнес-процессов в действие “Подписание” и одноимённого этапа в маршрутах добавлена возможность подписания файлов ЭП при вынесении положительного решения (подписания). Подробнее в руководстве разработчика и руководстве администратора.
4. Добавлен вид аватара “Фото”. Подробнее см. Настройки пользователя.
5. В TessaAdmin добавлена возможность удалить последнюю вкладку в типе карточки и в контроле “Вкладки”.
6. Добавлено поле “СНИЛС” в карточку сотрудника.
7. В представлении “Активные процессы” добавлены колонки “Есть ошибки” и “Последняя ошибка”. Параметр представления “Есть ошибки” теперь также доступен для пользователей без административного доступа.
8. В карточке “Настройки электронной подписи” приложенные файлы теперь выводятся с группировкой по категориям, чтобы сразу видеть, является ли файл сертификатом или списком CRL.
9. В конфигурационный файл app.json веб-сервиса web добавлена настройка "StaticFileCacheControl", в которой возможно указать заголовок, возвращаемый для запросов на статические файлы (js-файлы с кодом web-клиента, файлы шрифтов, картинки и др. файлы в подпапке wwwroot веб-сервиса). По умолчанию заголовок не устанавливается (настройка отсутствует, равна null или пустой строке). Описание настройки доступно в документации.
10. В конфигурационные файлы app.json для сервисов web и chronos добавлена настройка "Redis.Normalization", в которой возможно указать строку подключения к другому серверу или базе данных Redis, чем указана в настройке "Redis" (используемой для иного взаимодействия платформы с Redis). В таком случае именно подключение из "Redis.Normalization" будет использовано для кэширования значений в справочниках нормализации. Это не затрагивает взятие блокировок и подписку на события, связанные с нормализацией. Если настройка отсутствует, либо равна null или пустой строке, то используется объект подключения по умолчанию, соответствующий строке из настройки "Redis".
11. В web-клиенте в область предпросмотра были добавлены кнопки переключения файлов: “следующий”, “предыдущий”.

Консольная утилита tadmin

1. Добавлена команда ConvertTypes для конвертации типов .jtype в репозитории с удалением в них настроек, имеющих значения по умолчанию.
2. В файле app.json добавлена настройка "LocalizationPath", в которой возможно указать папку (относительный путь от папки с утилитой или абсолютный путь), содержащую библиотеки локализации в файлах .jlocalization/.jculture (поиск выполняется включая подпапки любой вложенности). По умолчанию указана папка "loc" (относительно папки с утилитой). Создайте эту папку и разместите там библиотеки локализации со строками, которые могут использоваться в разработанных в проекте консольных командах. Такие библиотеки переопределяют и дополняют встроенную локализацию; но если искомые строки отсутствуют в библиотеках из указанных папок, то для них используется встроенная локализация.
3. Добавлен скрипт AnalyzeJson, позволяющий проанализировать, сколько по размеру занимает содержимое отдельных ключей от общего объёма JSON-документа. Это полезно, например, при анализе места, занимаемого различными объектами в метаинформации. Подробнее по использованию скрипта см. в разделе документации Выполнить скрипты .NET с указанными именами.

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

1. .NET 8.0.18
2. CsvHelper 33.1.0
3. HtmlAgilityPack 1.12.2
4. HtmlSanitizer 9.0.886
5. iTextSharp.LGPLv2.Core 3.7.4
6. MailKit 4.13.0
7. Microsoft.CodeAnalysis.CSharp 4.14.0
8. Microsoft.IdentityModel.Protocols.OpenIdConnect 8.13.0
9. Microsoft.NET.Test.Sdk 17.14.1
10. NLog 5.5.1
11. NLog.Web.AspNetCore 5.5.0
12. PDFsharp-wpf 6.2.1
13. SixLabors.ImageSharp.Drawing 2.1.7
14. StackExchange.Redis 2.8.58
15. Swashbuckle.AspNetCore 9.0.3
16. Swashbuckle.AspNetCore.Newtonsoft 9.0.3

Изменения API

1. В web-клиенте в проекте SDK реализована возможность настраивать темы приложения. Подробнее в руководстве разработчика web-расширений.
2. Добавлен контроллер api/v1/user-info, а также добавлена возможность реализации собственных серверных обработчиков IUserInfoHandler для генерации IUserInfo. Ранее была возможность получать нужные значения только путём модификации представления, из которого выбирались данные. В клиентской части были расширены возможности для переопределения и доработки UserInfo. Подробнее в руководстве разработки web-расширений.
3. Аватары расширены для использования в различных объектах системы. Ранее аватар мог быть создан только для пользователя. Подробнее в руководстве разработчика.
4. Для объекта IActionHistoryStrategy изменены методы (в т.ч. методы-расширения) по добавлению и удалению записей в историю действий. В методы более не передаётся CancellationToken для преждевременной отмены. Аналогичные изменения сделаны для методов у объектов IApiAccessTokenActionHistoryStrategy, IConfigurationLogger, IFileContentActionHistoryStrategy, ITokenActionHistoryStrategy.
5. У всех асинхронных методов инвалидации кэшей и значений в кэшах удалён параметр с токеном отмены CancellationToken.
6. У объектов, реализующих интерфейс IStorageCleanable, удалены методы IsEmpty(). При очистке структуры объекта вызовом Clean() пустые коллекции заменяются на null, но пустые объекты внутри коллекций не удаляются. Объекты StorageObject считались пустыми, если они созданы конструктором по умолчанию и имеют все значения свойств, установленные по умолчанию.
7. Добавлен пример в руководство разработчика Дерезервирование номеров при автоматизированном создании карточек.
8. В web-клиенте добавлены методы для StorageAccessor, предназначенные для сериализации и десериализации флаговых перечислений в виде списка имён, с учетом специфики TypesJson: setFlags, setFlagsIfNotDefault, tryConvertFlags, tryConvertFlagsOrDefault.
9. Добавлено API для регистрации сериализаторов, связанных с расширениями, контролами и иными компонентами типов CardType. Пример создания и регистрации сериализаторов для типового решения в папке Tessa.Extensions.Default.Server/TypeSerializers.
10. Добавлен статический метод TypedDictionary.WithOptions(), аналогичный методу TypedList.WithOptions(), для указания настроек при сериализации хэш-таблиц в типизированный JSON. В нём можно указать свойство SelectPlainJsonSerialization, которое позволяет переопределить для указанной хэш-таблицы и всех вложенных объектов, следует ли записывать для них информацию по типам при сериализации. Аналогичная настройка также добавлена для TypedList.WithOptions(). Свойство SelectPlainJsonSerialization функционирует, только если объект TypedJsonConverter создавался как объект, не защищённый от изменения (seal: false); например, предоставив опции TessaSerializer.CreateDefaultSettings(typedJson: true) в возвращаемый контроллером метод await this.TypedJsonAsync(obj, settings: settings).
11. Добавлен класс SuperStreamFixed, который позволяет объединять несколько потоков в один для чтения, аналогично классу SuperStream, но вместо фабрик потоков он получает конкретный список потоков Stream. При этом в конструкторе указывается параметр leaveOpen, значение false в котором определяет, что все переданные потоки не должны быть закрыты вместе с текущим объектом или в процессе чтения из него.

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

1. В web-клиенте исправлена ошибка, из-за которой было невозможно получить фрагменты текущей темы через ThemeManager.getThemeNode.
2. В web-клиенте исправлена ошибка, из-за которой не исчезало всплывающее окно выбора даты в диалоговом окне параметров фильтрации.
3. Для представления “Теги” исправлена работа сабсетов “Персональные теги” и “Общие теги” при использовании СУБД PostgreSQL.
4. Добавлена локализация режимов работы для команды tadmin UpgradeWorkflowProcesses.
5. В web-клиенте исправлена ошибка, из-за которой область предпросмотра в карточках могла отображаться при ширине экрана менее 1200 пикселей.
6. В веб-сервисе jinni исправлено предупреждение об устаревшей зависимости в скрипте unoconv, которое могло приводить к ошибкам во время конвертации файла в pdf. Зависимость setuptools заменена на packaging. Подробнее об установке зависимости см. Предупреждение об отсутствии зависимости packaging в Windows.
7. В web-клиенте исправлено получение ошибок сохранения файлов в карточке.
8. В desktop-клиенте исправлена ошибка, которая возникала при использовании фильтров в контроле “Представление”, если для такого представления был настроен маппинг параметров.
9. Для токенов сессии, созданных по атрибуту [ApiAccessToken] для методов в интеграционных контроллерах, исправлена нормализация имени сотрудника в свойстве ISession.User.Name.
10. Исправлена работа расширения “Очистка связанных полей” в ситуации, когда отслеживаемая колонка находилась в коллекционной секции.
11. В web-клиенте исправлена ошибка, из-за которой некорректно отображался список скрытых вкладок.
12. Улучшено качество изображений аватаров.
13. В web-клиенте исправлена ошибка, из-за которой в иерархических представлениях некорректно выполнялась сортировка групп.
14. Исправлена ошибка, из-за которой в типе карточки “Мои замещения”, в таблице “Кого я замещаю по документам” могли некорректно отображаться вложенные замещения.
15. В web-клиенте исправлена ошибка, из-за которой в ссылочных контролах не учитывалась настройка “Перенос строк”.
16. Исправлена синхронизация AD/LDAP при указании поддомена AD в качестве контроллера домена.
17. Исправлены ошибки при работе узлов master-detail в рабочих местах, где алиас параметра или колонки, указанный в detail-представлении для связи с master-представлением, отсутствовал также в detail-представлении (его наличие важно только в master-представлении).
18. В web-клиенте исправлена ошибка некорректного отображения контролов в полноэкранном режиме на iOS.
19. В web-клиенте исправлена ошибка, из-за которой можно было добавить пустую строку в текстовое поле, которое заполнено максимальным количеством символов.
20. В конструкторе бизнес-процессов исправлена ошибка, из-за которой вносимые процессом изменения карточки не сохранялись при запуске процесса по кнопке с условием в настройках.
21. Исправлена ошибка импорта файла представления, если в названии директорий в пути до него содержались точки.
22. В маршрутах в этапах “Согласование” и “Подписание” исправлена ошибка, из-за которой этап не завершался при отсутствии исполнителей. Ошибка воспроизводилась, если для этапа был разрешён запуск без исполнителей.
23. В web-клиенте исправлена ошибка, в результате которой могла появляться ошибка “The index is not in the allowed range” в обсуждениях на iOS.
24. В web-клиенте в маршрутах исправлена ошибка при формировании заголовка окна с параметрами этапа.
25. Исправлен скрипт upgrade.sh, используемый в Docker (совместно с Alpine Linux), для учёта аргументов -cs и -db, переданных в скрипт, а также для использования совместно с СУБД MS SQL Server.
26. В desktop-клиенте в маршрутах исправлено формирование заголовков окон развёрнутых текстовых полей.
27. В методе KrDocumentStateManager.SetStateAsync исправлена ошибка, из-за которой не изменялось состояние в карточке документа в секции DocumentCommonInfo. Ошибка возникала, если при выполнении метода в карточке отсутствовала секция DocumentCommonInfo.
28. Исправлено нефункционировавшее исправление структуры секций в настройках сотрудника (диалог “Мои настройки” и вкладка с настройками в карточке “Сотрудник”). Это могло приводить к проблемам при отображении настроек, сохранённых на предыдущей версии системы, где отсутствовали настройки, появившиеся в новой версии.
29. В web-клиенте добавлена обработка переноса строк во всплывающих подсказках.
30. Исправлена ошибка, которая возникала при миграции с версии платформы 3.6 на 4.1.
31. В web-клиенте на iOS убрали возможность экспорта нескольких поисковых запросов согласно политике безопасности браузера.
32. В web-клиенте в диалоговом окне “Ошибка” шрифт в поле “Подробно” изменён на моноширный.
33. Исправлена отправка почты посредством низкоуровневого API IMailService.PostMessageAsync, где в MailInfo добавлены файлы, но не указаны строки локализации в коллекции MailInfo.Localization.
34. В web-клиенте увеличено количество отображаемых строк в поле “Подробно” в диалоговом окне “Ошибка”.
35. В маршрутах исправлена ошибка, из-за которой могла не сохраняться новая карточка документа или сателлита, добавленная в IKrScope. Ошибка возникала, если карточка не содержала изменений.
36. Улучшено функционирование системы при возникновении преждевременной отмены операций по токенам CancellationToken.
37. В web-клиенте убран повторный запрос на получение карточки при переходе на вкладку с открытым сателлитом карточки задания.
38. В web-клиенте исправлено закрытие сателлита карточки документа (ранее не закрывалось) при помощи горячих клавиш Ctrl+Shift+F4 и Ctrl+Shift+Alt+F4.
39. Исправлена ошибка резервирования номеров документов, когда номер оставался выделенным после отката транзакции на создание карточки.
40. В web-клиенте заголовок диалогового окна получил возможность растягиваться по ширине.
41. В web-клиенте добавлен отступ между заголовком и панелями кнопок.
42. Если при чтении конфигурации произошла ошибка, связанная с открытием файла на чтение (конфигурационного файла, файла сертификата или иного файла), то система повторяет операцию до 10 раз, ожидая между попытками 200 мс. Это учитывает возможную проблему при редактировании файла конфигурации app.json для сервиса web.
43. В web-клиенте исправлена ошибка отображения индикатора истечения сессии: ранее аватар перекрывал данный индикатор.
44. Исправлена ошибка, когда номер карточки не мог дерезервироваться при её создании, если любое другое расширение CardNewExtension добавило ошибку уже после резервирования номера.
45. В web-клиенте исправлен баг в случае открытия нескольких карточек, имеющих виртуальный файл, при просмотре этого файла отображался контент ранее открытого виртуального файла.
46. В web-клиенте исправлена ошибка, в результате которой индикатор обязательного поля мог переноситься на следующую строку в отрыве от заголовка.
47. Оптимизирован размер сериализуемых типов .jtype в файлах и в метаинформации, передаваемой на клиент. Значения по умолчанию для настроек контролов, блоков, расширений и других объектов более не записываются. Версия формата метаинформации не изменена.
48. Оптимизировано чтение настроек из карточки “Настройки электронной подписи” при выполнении действий, связанных с ЭП: подписание файлов и проверка подписи.
49. Исправлена редкая ошибка при изменении библиотеки схемы для референсной колонки (внутри комплексной). Ошибка появилась с версии 4.1.0 и содержала текст: Value cannot be null. (Parameter 'info.GetValueOrDefault<SchemeType>(nameof(this.Type))').
50. Исправлено добавление файла в desktop-клиенте с указанием категории, когда представление, получающее категории, не возвращает третью колонку с порядковым номером. Актуально, например, для файлов в карточке настроек “Настройки электронной подписи”.
51. В web-клиенте исправлена ошибка, приводящая к отображению диалоговых окон ошибок КриптоПро в Safari на macOS.
52. В текст сообщения об ошибке компиляции C#-скрипта для группы ссылок и типа группы ссылок добавлен текст произошедшей ошибки и её источник.
53. В web-клиенте исправлена ошибка, из-за которой для контролов “Метка” и “Текст” не применялся указанный className.
54. Исправлено формирование имени виртуального файла, созданного по шаблону с включённым признаком “Конвертировать в PDF”, если в имени шаблона файла используется плейсхолдер.
55. В конструкторе бизнес-процессов в действиях “Согласование”, “Подписание” и “Настраиваемое задание” исправлена ошибка, из-за которой не работали флаги: “Редактировать карточку” и “Редактировать любые файлы”.
56. Оптимизирована метаинформация, загружаемая web-клиентом. Размер метаинформации, возвращаемой для типового решения, сокращён более чем в 2 раза (при условии её сжатия по алгоритму Brotli, которое настроено по умолчанию).
57. Оптимизирована загрузка фонового изображения с сервера в web-клиенте в части нагрузки на сервер.
58. Оптимизирована работа системы, связанная с получением информации по доменным именам (DN) для IP-адресов в запросах к веб-сервису (используется при открытии сессии, при записи в историю действий и др.). В памяти процесса реализовано кэширование со сроком жизни в 1 час для каждого IP-адреса.
59. В конструкторе бизнес-процессов в действии “Управление заданием” убрана возможность создания привязки для поля “Тип управления”.
60. В web-клиенте исправлена ошибка, из-за которой выпадающие списки могли располагаться не по центру.
61. Исправлена ошибка доступа, возникающая при проверке расширенных настроек доступа по токену со всеми правами, выданному серверными расширениями.
62. Оптимизировано выполнение цепочек расширений IExtensionContainer.
63. В web-клиенте для контрола “Предпросмотр файлов” исправлена ошибка, из-за которой он мог не растягиваться по ширине в диалоговом окне.
64. В web-клиенте исправлена ошибка, в результате которой при изменении размеров окна браузера была возможность перекрыть область представлений.
65. В web-клиенте исправлена ошибка, приводящая к некорректной ширине области представлений при изменении ширины дерева рабочего места.
66. В web-клиенте в карточке “Сотрудник” исправлена ошибка во всплывающей подсказке для флага “Наследовать календарь”.
67. При отправке уведомлений исправлена загрузка контента приложенных файлов в случае, если для них отдельно указан идентификатор карточки, но не указан её тип.
68. В уведомлениях по обсуждениям исправлены возможные ошибки при добавлении вложенных изображений в случае, если для уведомлений используются расширения, прикладывающие дополнительные файлы.
69. В обсуждениях исправлено прикладывание изображений в уведомлениях при упоминании сотрудников.
70. При повторном запуске процедуры распознавания файла система теперь корректно обновляет карточку операции OCR и показывает диалог мониторинга процесса.
71. Исправлено удаление файлов из корзины плагином RemoveDeletedFiles. Ошибка появилась в версии 4.1.0.
72. В web-клиенте исправлена ошибка, приводившая к отображению кнопок разворота для контролов внутри контрола “Контейнер” при наведении курсора на него.

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

1. Все файлы типов .jtype перевыгружены для минимизации их размеров. Версия формата метаинформации не изменена. После обновления веб-сервиса системы (или используя отдельный сервис web, обновлённый до актуальной версии) вызовите команду конвертации всех типов для папки конфигурации с типами в вашем репозитории, указав параметры подключения к вашему серверу: tadmin ConvertTypes PathToRepository/Configuration/Types -a:server_address -u:admin -p:admin. При этом типы не импортируются, конфигурация на сервере никак не изменяется. На сервере, к которому выполняется подключение, не требуется наличие определённых типов и настроек, веб-сервис используется только для выполнения логики сериализации типов.
2. Рассмотрите возможность по установке настройки "StaticFileCacheControl", равной строке "public,max-age=604800", в конфигурационном файле app.json веб-сервиса web. Это включит кэширование статических файлов web-клиента (на срок в одну неделю - значение 604800 в секундах), и тем самым оптимизирует сетевой трафик и разгрузит веб-сервис при открытии или обновлении вкладки браузера с web-клиентом, что актуально при работе в системе большого количества пользователей.

Изменения API при обновлении

1. Метод StorageObject.SetNullIfEmptyEnumerable заменён на SetNullIfEmptyCollection, который теперь учитывает только пустые коллекции ICollection. Замените его при использовании в объектах проектного решения, наследуемых от StorageObject.
2. Метод ForumResponse.Empty() удалён из серверного API форумов. Используйте конструктор по умолчанию new ForumResponse().
3. Добавлен обязательный параметр CardServiceType в метод создания NumberExtensions.CreateContextAsync и конструктор контекста NumberContext.
4. Модифицировано возвращаемое значение метода IOperationRepository.StartAsync, которое теперь возвращает флаг bool, указывающий на успешность запуска операции. Аналогичное изменение внесено в контроллер REST API по маршруту api/v1/operations/{id}/start.
5. Из объекта CardTask удалены свойства: ProcessKind, ProcessName, ProcessID. Теперь эту информацию можно получить из свойства CardTask.Info по ключам: CardHelper.TaskProcessKindKey, CardHelper.TaskProcessNameKey и CardHelper.TaskProcessIDKey.
6. У методов IExtensionContainer.ResolveExecutorAsync и TryResolveExecutorAsync удалён параметр CancellationToken.
7. В web-клиенте более недоступна информация по всем таблицам-перечислениям cardMetadata.enumerations (доступна метаинформация только по нескольким служебным таблицам). Если в коде расширений web-клиента для проектного решения использовались данные таблиц-перечислений, то реализуйте передачу необходимых данных через расширения на инициализацию приложения: на сервере расширение ServerInitializationExtension, зарегистрированное как .WhenApplications(ApplicationIdentifiers.WebClient), записывает информацию в context.Response.Info (пример KrWebServerInitializationExtension.cs); а на клиенте расширение ApplicationExtension получает их из context.response.info и записывает в отдельный объект-синглтон (пример forumClientInitializationExtension.ts).
8. Изменено указание префиксов ключей в коде расширений .NET. Вместо CardHelper.SystemKeyPrefix используйте StorageHelper.SystemKeyPrefix. Вместо StorageHelper.UserKeyPrefix используйте CardHelper.UserKeyPrefix. Для проверки того, что ключ начинается с префикса, вызовите метод StorageHelper.HasPrefix(key, prefix) (где key - проверяемый ключ; prefix - проверяемый префикс) - используйте его вместо методов IsSystemKey(key) и IsUserKey(key) (которые присутствовали в CardHelper и StorageHelper). Значения констант и функциональность методов не изменились, только способ их использования.
9. У метода IDbmsProvider.GetDbmsAsync() удалён параметр cancellationToken. Интерфейс реализуется в IDbScope, поэтому для вызовов dbScope.GetDbmsAsync() также удалите параметр cancellationToken.

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

1. Представления:

   • ActiveWorkflows

   • RoleDeputiesManagementDeputized

   • RoleDeputiesManagementDeputizedByDocTypes

   • TagCards

   • UsersDetails (удалено)

2. Таблицы:

   • AvatarCache (добавлена)

   • KrSigningActionFileCategoriesVirtual (добавлена)

   • KrSigningActionHiddenFileCategoriesVirtual (добавлена)

   • KrSigningActionVirtual

   • KrSigningStageSettingsFileCategoriesVirtual (добавлена)

   • KrSigningStageSettingsHiddenFileCategoriesVirtual (добавлена)

   • KrSigningStageSettingsVirtual

   • KrSigningTaskOptions

   • PersonalRoles

   • UserAvatarCache (удалена)

3. Миграции:

   • Platform

4. Типы:

   • AvatarUserSettings

   • File

   • KrSigning

   • KrSigningAction

   • KrSigningStageTypeSettings

   • PersonalRole

   • SignatureSettings

   • SignFilesDialog (добавлен)

   • TemplateFile

   • ViewExtensions

   • WorkflowTaskControlAction

5. Изменены библиотеки локализации.