Отображение документов перед подписью на Веб-интерфейсе Пользователя
Веб-интерфейс Пользователя предоставляет Пользователям возможность визуализации
документов перед созданием подписи. Поддерживается просмотр документов следующих
форматов: PDF, XML, ODT.
Также могут быть обработаны документы форматов DOC, DOT, DOCM, DOTM,
DOCX, DOTX, FlatOpc, FlatOpcMacroEnabled, FlatOpcTemplate,
FlatOpcTemplateMacroEnabled, OTT, OOXML, WordML, RTF, HTML, XHTML,
MHTML и TXT, однако в их отношении в рамках проведения оценки влияния требуется
проверять допустимость использования в конечной системе. Подробнее об этом в п. 1.5
документа ЖТЯИ.00096-02 30 01. КриптоПро HSM. Формуляр.
Примечание
Если Веб-интерфейс Сервиса Подписи настроен на использование v2 API, то настройка отображения документов
выполняется на Сервисе Обработки документов. При этом настройки отображения документов заданные на самом
Веб-интерфейсе Сервиса Подписи (команда Get-DssFEConverterPlugin) - игнорируются.
Настройка отображения документов на Сервиса Обработки Документов
Веб-интерфейс Сервиса Подписи считается настроенным на использование v2 API, если задан параметр
DocumentStoreAddress в настройках сервиса (команда Get-DssFeProperties).
Примечание
Настройка отображения документов приведенная ниже относится только к случаю использования v1 API.
Настройка визуализации документов перед созданием ЭП осуществляется при помощи специальных плагинов. Чтобы воспользоваться плагином в КриптоПро DSS, его необходимо сначала зарегистрировать. Работа с плагинами визуализации документов на Веб-интерфейсе Пользователя осуществляется при помощи набора специализированных командлетов.
Плагины, позволяющие визуализировать документы данных форматов, находятся в
директории <Путь установки>\DSS\Plugins\Converters и имеют следующие названия:
DSS.DocumentConverter.PdfStub.dll– отвечает за отображение документов форматаPDF;DSS.DocumentConverter.Word.dll- отвечает за отображение документов форматовDOC,DOT,DOCM,DOTM,DOCX,DOTX,FlatOpc,FlatOpcMacroEnabled,FlatOpcTemplate,FlatOpcTemplateMacroEnabled,XML,ODT,OTT,OOXML,WordML,RTF,HTML,XHTML,MHTML,TXT,PNG,JPG,BMP,JPEG,TIFF,GIF.
Для активации возможности просмотра документов необходимо зарегистрировать
нужные форматы и соответствующие плагины с помощью Windows PowerShell. Для
каждого экземпляра веб-приложения в директории <Путь установки>\Frontend
создается свой собственный конфигурационный файл с именем
<Имя экземпляра веб-приложения>_convert.config.
Пример:
Данный сценарий регистрирует форматы документов, для которых возможен просмотр с помощью установленных плагинов.
Add-DssFEConverterPlugin -FileExtension pdf -Assembly DSS.DocumentConverter.PdfStub.dll
Add-DssFEConverterPlugin -FileExtension doc -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension dot -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension docm -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension dotm -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension docx -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension dotx -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension FlatOpc -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension FlatOpcMacroEnabled -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension FlatOpcTemplate -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin –FileExtension FlatOpcTemplateMacroEnabled -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension xml -Assembly DSS.DocumentConverter.Xml.dll
Add-DssFEConverterPlugin -FileExtension odt -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension ott -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension ooxml -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension WordML -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension rtf -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension html -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension xhtml -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension mhtml -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension txt -Assembly DSS.DocumentConverter.Word.dll
Add-DssFEConverterPlugin -FileExtension png -Assembly DSS.DocumentConverter.Image.dll
Add-DssFEConverterPlugin -FileExtension jpg -Assembly DSS.DocumentConverter.Image.dll
Add-DssFEConverterPlugin -FileExtension bmp -Assembly DSS.DocumentConverter.Image.dll
Add-DssFEConverterPlugin -FileExtension jpeg -Assembly DSS.DocumentConverter.Image.dll
Add-DssFEConverterPlugin -FileExtension tiff -Assembly DSS.DocumentConverter.Image.dll
Внимание!
При возникновении ошибки во время изменения настроек плагин удаляется из списка. Необходимо добавить его заново командой Add-Dss***ConverterPlugin.
Если просмотр загруженного документа поддерживается установленными плагинами и выполнена регистрация в конфигурационном файле, то документ отображается во вкладке «Загрузка документа».
Для поддержки отображения документов особых форматов необходимо реализовать и зарегистрировать соответствующий плагин, отвечающий описанным в Руководстве разработчика требованиям.
Пример настройки кодировки
Плагин DSS.DocumentConverter.Word.dll может неверно определить кодировку в документах типа
xml, txt. В этом случае ее необходимо задать вручную через параметр encoding. Имена кодировок
приведены на сайте IANA. Чаще всего используются значения: UTF-8, UTF-7, UTF-16BE, UTF-16LE,
UTF-16, US-ASCII.
При добавлении плагина:
Add-DssStsConverterPlugin -FileExtension xml -Assembly DSS.DocumentConverter.Xml.dll -Parameters @{ "encoding" = "UTF-8"}
При изменении настроек:
Set-DssStsConverterPlugin -FileExtension xml -Assembly DSS.DocumentConverter.Xml.dll -ClassName CryptoPro.DSS.DocumentConverter.Word.WordConverter -Parameters @{ "encoding" = "UTF-8"}