Отображение документа в формате DTBS

КриптоПро DSS предоставляет Пользователям возможность отображения специально подготовленных документов на Веб-интерфейсе Пользователя перед созданием подписи или шифрованием документа.

DTBS-документ представляет собой XML-документ, сформированный в соответствии со следующей схемой:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema targetNamespace="http://www.cryptopro.ru/schemas/2014/08/dtbs"
    elementFormDefault="qualified"
    xmlns:xs="http://www.w3.org/2001/XMLSchema"
    xmlns:dtbs="http://www.cryptopro.ru/schemas/2014/08/dtbs"
>
    <xs:element name="dtbs" type="dtbs:dtbsType" />
    <xs:complexType name="dtbsType">
        <xs:sequence>
            <xs:element ref="dtbs:row" minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
        <xs:attribute name="unattendedSign" type="xs:boolean">
            <xs:annotation>
                <xs:documentation>
                    Если 'true', то документ подписывается без отображения и
                    подтверждения пользователем. В этом случае элементы row
                    должны отсутствовать.
                </xs:documentation>
            </xs:annotation>
        </xs:attribute>
    </xs:complexType>

    <xs:element name="row" type="dtbs:rowType" />
    <xs:complexType name="rowType">
        <xs:sequence>
            <xs:element name="name" type="xs:string">
                <xs:annotation>
                    <xs:documentation>
                        Название ключевого поля с XML-документом, который необходимо отобразить
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="value" type="xs:string">
                <xs:annotation>
                    <xs:documentation>
                        Значение ключевого поля с XML-документом, который необходимо отобразить
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
        </xs:sequence>
    </xs:complexType>
</xs:schema>

Отображение DTBS-документов возможно также в мобильном приложении myDSS, если на Центре Идентификации настроены соответствующие плагины. Плагин, позволяющий отобразить эту информацию, находится в директории <Путь установки>\DSS\Plugins\Converters и называется DSS.DocumentConverter.Dtbs.dll.

Работа с плагином производится при помощи специальных командлетов. При добавлении плагина необходимо также задать настройки, перечисленные в таблице ниже. Эти настройки задаются внутри параметра Parameters типа Hashtable:

@{paramName1=paramValue1; paramName2=paramValue2;…;paramNameN=paramValueN}

, где paramNamei, paramValuei – название и значение параметра соответственно.

Параметры плагина DSS.DocumentConverter.Dtbs.dll

Параметр Описание
PageSetup.LeftMargin Отступ в документе слева.
PageSetup.TopMargin Отступ в документе сверху.
PageSetup.RightMargin Отступ в документе справа.
PageSetup.BottomMargin Отступ в документе снизу.
PageSetup.PageHeight Высота страницы документа.
PageSetup.PageWidth Ширина страницы документа.
PageSetup.PaperSize Размеры отображаемого документа. Данный параметр позволяет выбрать стандартные размеры по обозначению формата из таблицы ниже. Для ввода пользовательских параметров используется значение Custom.
PageSetup.Gutter Расстояние между строками.
xslt Путь к файлу с XSLT-преобразованием. Опциональный параметр.

Стандартные размеры документов

Формат бумаги Размеры
А3 297x420мм
А4 210x297мм
А5 148x210мм
В4 250x353мм
В5 176x250мм
Executive 7.25x10.5”
Folio 8x13”
Ledger 11x17”
Legal 8.5x14”
Letter 8.5x11”
EnvelopeDL 110x220мм
Quarto 8x10”
Statement 8.5x5.5”
Tabloid 11x17”
Paper10x14 10x14”
Paper11x17 11x17”
Custom При выборе данного размера необходимо самостоятельно задать размеры страницы при помощи параметров из таблицы выше.

Пример регистрации плагина для отображения документов формата XML:

Add-DssFeConverterPlugin -FileExtension dtbs -Assembly DSS.DocumentConverter.Dtbs.dll -Parameters @{ "PageSetup.LeftMargin"="10"; "PageSetup.PageWidth"="350"; "PageSetup.TopMargin"="10"; "PageSetup.PageHeight"="100"; "PageSetup.RightMargin"="10"; "PageSetup.PaperSize"="Custom"; "PageSetup.BottomMargin"="0"; "PageSetup.Gutter"="0"}
Примечание

Расширение, указанное в параметре –FileExtension при регистрации плагина, и расширение файла отображаемого документа должны совпадать.

Пример содержимого документа, который необходимо отобразить:

<?xml version="1.0" encoding="utf-8"?>
<dtbs xmlns="http://www.cryptopro.ru/schemas/2014/08/dtbs">
    <row>
        <name>Наименование документа</name>
        <value>Платёжное поручение</value>
    </row>
    <row>
        <name>Банк получателя</name>
        <value>АКБ "Рога и копыта"</value>
    </row>
    <row>
        <name>Счёт получателя</name>
        <value>40781032100000000000</value>
    </row>
    <row>
        <name>Сумма платежа</name>
        <value>100 RUB</value>
    </row>
</dtbs>

Отображение документа:

visualizationXML.png