Назначение

Наносит на PDF-документ штамп, собранный по профилю штампа: текстовые строки, изображения (подписи, логотипы), QR-код, фрагмент отчёта Telerik. Примеры: штамп «В производство работ», QR-код проверки актуальности документа, штамп согласования. Настройка профилей описана в статье Настройки проставления штампов (new).

Сведения о типе действия

ПараметрЗначение
Название в порталеДобавить штамп
Activity в Elsa (обработчик)Добавить штамп (AddStampActivity)
ID типа элемента действия7430e850-7da0-43a3-9392-d43ed781bf74
Проверка условий правилаДа
Поддержка «Исходный элемент(ы) (формула)»Да

Атрибуты действия

АтрибутОбязательныйОписаниеПример
НазваниеДаТекст. Название действия.Штамп «В производство работ»
Профиль штампаДа*Выбор из списка «Профили штампов». Определяет содержимое штампа.В производство работ
Размер штампаДаШирина и высота штампа в пунктах (pt) через «;» или «,». Высота пересчитывается по фактическому содержимому.150;120
Расположение отНетТочка привязки — угол листа, от которого отсчитываются координаты. По умолчанию — правый нижний угол.Правый нижний угол
Расположение штампаДаСмещение X;Y в пунктах от точки привязки (см. таблицу ниже).190;245
Номер страницыНетСтраница, на которую наносится штамп. Если не заполнено — штамп наносится на все страницы. Правила нумерации — ниже.1

* Если профиль не указан, элементы профиля ищутся по самому действию (действие выступает профилем).

Координаты

1 pt = 1/72 дюйма ≈ 0,353 мм; лист A4 — 595 × 842 pt. Координаты рассчитываются по видимой области страницы (CropBox) с учётом поворота страницы.

Точка привязкиX — расстояниеY — расстояние
Левый нижний уголот левого края листа до левого края штампаот нижнего края листа до нижнего края штампа
Левый верхний уголот левого края листа до левого края штампаот верхнего края листа до верхнего края штампа
Правый верхний уголот правого края листа до левого края штампаот верхнего края листа до верхнего края штампа
Правый нижний угол (по умолчанию)от правого края листа до левого края штампаот нижнего края листа до нижнего края штампа

Для правых углов X отсчитывается до левого края штампа, поэтому X должен быть не меньше ширины штампа. Пример: размер 150;120, привязка «Правый нижний угол», расположение 190;245 — штамп займёт полосу от 190 до 40 pt от правого края и от 245 pt от нижнего края вверх.

Номер страницы

ЗначениеСтраница
не заполненовсе страницы документа
N ≥ 1страница N
0первая страница
−Nстраница «всего страниц − N» (−1 — предпоследняя)

Как работает

  1. Проверяются условия правила; определяются целевые элементы.
  2. Если расширение файла целевого элемента не PDF — элемент пропускается без ошибки.
  3. Движок вызывает API модуля Stamp портала (POST stamp/api/stamp/add/{itemId}/{actionId}).
  4. Модуль Stamp строит таблицу штампа по элементам профиля (формулы вычисляются в контексте документа), наносит её на страницы и сохраняет изменённый файл в элемент (атрибут «Файл»).

Вариант: штамп с профилем из этапа процесса

Тип действия с ID d1b55110-1258-4e05-8321-cbdd8acca085 обрабатывается тем же обработчиком, но профиль штампа берётся из атрибута «Профиль штампа» текущего этапа процесса (см. шаблоны этапов), на котором сработало правило. В этом режиме:

Штамп изменяет атрибут «Файл». Если для типа файла настроено правило на изменение «Файла» (например, сброс статуса при новой версии), оно тоже сработает. Исключайте такие срабатывания условием на системного пользователя: Str(Id(This("editor"))) != "00000000-0000-0000-0000-000000000001".

Особенности

См. также