<< Click to Display Table of Contents >> Объектная модель > Базовое решение Directum RX > Docflow – документооборот > Отметки в PDF Mark – Отметка |
![]() ![]() |
Метаинформация отметок, которые проставляются на документ при преобразовании в PDF. Справочник не отображается в проводнике и в поиске. Наследник от Sungero.CoreEntities.DatabookEntry.
Общий алгоритм работы с метаинформацией отметок:
1.Записи справочника создаются программно, непосредственно перед физическим преобразованием в PDF:
•В действии «Создать PDF с отметками» в карточке документа, в зависимости от выбраных настроек создаются записи для отметки об ЭП и отметок о регистрации;
•В действии «Создать PDF с отметкой о поступлении» в карточке входящего письма.
•В блоке «Преобразование в PDF»;
•В этапе «Преобразование в PDF» в задаче на согласование по регламенту.
2.После этого метаинформация отметок вместе с версией документа упаковывается в структуру-DTO (Data Transfer Object) и передается в изолированную область.
3.В изолированной области в оригинальное содержимое в памяти документа добавляются отметки, проставляемые по тегам.
4.Далее содержимое документа преобразуется в PDF средствами Aspose.
5.На преобразованное в PDF содержимое проставляются отметки по якорям и координатам. В процессе простановки происходит преобразование относительных координат в абсолютные (в сантиметрах от левого верхнего угла) и определяются страницы для простановки.
6.Преобразованное в PDF содержимое сохраняется в PublicBody последней версии или в новую версию, в зависимости от конкретного действия по преобразованию.
7.В справочнике отметок сохраняются физические координаты и информация о странице, на которой она проставлена.
8.Метаинформация отметок, которые не были проставлены из-за ошибок, удаляется из базы.
9.Метаинформация успешно проставленных отметок используется при повторном преобразовании документа в PDF с простановкой отметок по координатам и преобразовании в рамках блока и этапа согласования по регламенту.
Отметка может быть проставлена в содержимое документа следующими способами (в порядке убывания приоритета):
•Теги. Для простановки отметок по тегам используются элементы управления доступные в шаблоне формата docx. При такой простановке оригинальное содержимое документа изменяется в памяти (без сохранения в БД), а визуально для отметки сохраняются стили, шрифты и форматы, используемые в размеченном тегом элементе управления.
•Якорь. При таком способе сначала определяются координаты специального символа-якоря и по ним уже проставляется отметка. Отметка проставляется на уже преобразованное в PDF содержимое и имеет фиксированный стиль отрисовки, не адаптирующийся под документ.
•Координаты. Если у отметки не заполнены теги и не указан якорь, а заполнены только координаты, то она будет проставлена по ним. Отметки по координатам всегда поставляются на преобразованное в PDF содержимое и не адаптируются под стили документа.
Имя свойства |
Отображаемое имя |
---|---|
Дополнительные параметры |
|
Якорь |
|
ИД документа |
|
Вид документа |
|
Имя |
|
Номер страницы |
|
Угол поворота |
|
Тэги |
|
ИД версии |
|
Координата по горизонтали |
|
Координата по вертикали |
ИД документа, для которого создана отметка.
ИД версии документа, для которой создана отметка.
MarkKind (Вид отметки): Sungero.Docflow.MarkKind:
Вид отметки. Используется для получения содержимого отметки и других настроек простановки отметки.
XIndent (Координата по горизонтали): Вещественное:
Координата отметки по горизонтали, отсчитывается от левого края страницы, в сантиметрах. Если значение отрицательное, отсчет ведется от правого края.
Заполняется:
•при создании отметок о регистрации – значением, которое пользователь ввёл в диалоге;
•при создании отметки о поступлении – значением, которое пользователь ввёл в диалоге, умноженным на -1. Умножение на -1 вводится для случаев, когда горизонтальную координату отметки отсчитывают от правого края страницы.
YIndent (Координата по вертикали): Вещественное:
Координата отметки по вертикали, отсчитывается от верхнего края страницы, в сантиметрах. Если значение отрицательное, отсчет ведется от нижнего края.
Заполняется:
•при создании отметок о регистрации – значением, которое пользователь ввёл в диалоге;
•при создании отметки о поступлении – значением, которое пользователь ввёл в диалоге, умноженным на -1. Умножение на -1 вводится для случаев, когда горизонтальную координату отметки отсчитывают от нижнего края страницы.
Символ якоря. Если у отметки не заполнена коллекция Tags, но заполнен якорь, то она добавится по этому якорю. Используется при создании отметок об ЭП.
Список тегов (в терминах MS Word – элементы управления содержимым), по которым будет проставлена отметка. В коробке заполняется:
•значениями Registration Date и Дата регистрации – при создании отметки «Дата регистрации»;
•значениями Registration Number и Регистрационный номер – при создании отметки «Номер регистрации».
Имя свойства |
Отображаемое имя |
---|---|
Тег |
Имя тега, к которому привязан элемент управления содержимым в MS Word
Номер страницы, на которую отметка будет проставлена по координатам. Для отметок на всех страницах принимает значение 0. Для отметок отсчет страниц которых ведется с конца документа принимает отрицательные значения.
Заполняется:
•значением по умолчанию, равным 1 - при создании отметок о регистрации (дата, номер) и отметки о поступлении;
•фактическим значением номера страницы, на которую была проставлена отметка - при обновлении отметок после простановки. Например, для отметок об ЭП это номер страницы, на которой был найден якорь.
RotateAngle (Угол поворота): Вещественное
Угол, на который будет повёрнута отметка в градусах. Принимает значения от 0 до 359. В отметках в стандартной версии не заполняется.
AdditionalParams (Дополнительные параметры): Коллекция
Точка расширения. Позволяет добавить дополнительные свойства, влияющие на вид и положение отметки в документе, например, прозрачность или масштаб.
При добавлении дополнительных свойств необходимо настроить соответствующую обработку этих свойств в изолированной области.
Имя дополнительного свойства.
Значение дополнительного свойства.
Имя. Задаёт отображаемое имя сущности. Заполняется программно при сохранении отметок.
© Компания Directum, 2024 |