Метаинформация отметок, которые проставляются на документ при преобразовании в 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 содержимое и не адаптируются под стили документа.

DocumentId (ИД документа):

ИД документа, для которого создана отметка.

VersionId (ИД версии):

ИД версии документа, для которой создана отметка.

MarkKind (Вид отметки): Sungero.Docflow.MarkKind:

Вид отметки. Используется для получения содержимого отметки и других настроек простановки отметки.

XIndent (Координата по горизонтали): Вещественное:

Координата отметки по горизонтали, отсчитывается от левого края страницы, в сантиметрах. Если значение отрицательное, отсчет ведется от правого края.

Заполняется:

•при создании отметок о регистрации – значением, которое пользователь ввёл в диалоге;

•при создании отметки о поступлении – значением, которое пользователь ввёл в диалоге, умноженным на -1. Умножение на -1 вводится для случаев, когда горизонтальную координату отметки отсчитывают от правого края страницы.

YIndent (Координата по вертикали): Вещественное:

Координата отметки по вертикали, отсчитывается от верхнего края страницы, в сантиметрах. Если значение отрицательное, отсчет ведется от нижнего края.

Заполняется:

•при создании отметок о регистрации – значением, которое пользователь ввёл в диалоге;

•при создании отметки о поступлении – значением, которое пользователь ввёл в диалоге, умноженным на -1. Умножение на -1 вводится для случаев, когда горизонтальную координату отметки отсчитывают от нижнего края страницы.

Anchor (Якорь): Строка (250):

Символ якоря. Если у отметки не заполнена коллекция Tags, но заполнен якорь, то она добавится по этому якорю. Используется при создании отметок об ЭП.

Tags (Теги): Коллекция:

Список тегов (в терминах MS Word – элементы управления содержимым), по которым будет проставлена отметка. В коробке заполняется:

•значениями Registration Date и Дата регистрации – при создании отметки «Дата регистрации»;

•значениями Registration Number и Регистрационный номер – при создании отметки «Номер регистрации».

Tag (Тег): Строка (250)

Имя тега, к которому привязан элемент управления содержимым в MS Word

Page (Номер страницы): Целое

Номер страницы, на которую отметка будет проставлена по координатам. Для отметок на всех страницах принимает значение 0. Для отметок отсчет страниц которых ведется с конца документа принимает отрицательные значения.

Заполняется:

•значением по умолчанию, равным 1 - при создании отметок о регистрации (дата, номер) и отметки о поступлении;

•фактическим значением номера страницы, на которую была проставлена отметка - при обновлении отметок после простановки. Например, для отметок об ЭП это номер страницы, на которой был найден якорь.

RotateAngle (Угол поворота): Вещественное

Угол, на который будет повёрнута отметка в градусах. Принимает значения от 0 до 359. В отметках в стандартной версии не заполняется.

IsStamped (Размещена): Логическое

Признак, что отметка уже размещена на документе:

•пока документ не преобразован – свойство не заполнено;

•если документ уже преобразован – свойство заполнено значение True.

Используется для работы редактора отметок.

AdditionalParams (Дополнительные параметры): Коллекция

Точка расширения. Позволяет добавить дополнительные свойства, влияющие на вид и положение отметки в документе, например, прозрачность или масштаб.

При добавлении дополнительных свойств необходимо настроить соответствующую обработку этих свойств в изолированной области.

Name (Имя): Строка (250)

Имя дополнительного свойства.

Value (Значение): Текст

Значение дополнительного свойства.

Name (Имя): Строка (250)

Имя. Задаёт отображаемое имя сущности. Заполняется программно при сохранении отметок.

© Компания Directum, 2025