Доп. настройки

Тонкая настройка

Вы можете редактировать файл конфигурации с помощью нашего встроенного блокнота ( меню Пуск > Программы > Sign > Configuration ) или в любом удобном для вас текстовом редакторе. Настройки приложения хранятся в текстовом файле 'Sign.ini' в windows (ANSI) кодировке.

Файл конфигурации может содержать:

пустые строки
комментарии - от символа ";" (точка с запятой) до конца строки
значения параметров - строки вида "имя = значение"
объекты/инструкции - записи вида "имя (параметр 1, ..., параметр N)"

Имена параметров не чувствительны к регистру символов. Значения параметров, в описании которых в круглых скобках перечислены все возможные варианты значений, также не чувствительны к регистру.
Значения параметров могут, а в некоторых случаях (например, если строка содержит запятую) должны быть заключены в кавычки.

Список параметров со значениями по умолчанию:

; Диалоговое окно с индикатором прогресса выполнения программы
ProgressDialog = no ; (yes, no) или (true, false) или (1, 0)

; Сколько дней будут храниться выходные файлы в папке 'Out'.

DaysToKeep = 1

; При значении "no", документы не будут подписываться автоматически.
AutoSign = yes ; (yes, no)

; Тип выходного файла.
FileType = pdf ; (pdf, tiff, jpeg)

; Версия PDF
. ( PDF 1.2 - Acrobat 3.x, PDF 1.3 - Acrobat 4.x, PDF 1.4 - Acrobat 5.x, PDF 1.5 - Acrobat 6.x, PDF 1.6 - Acrobat 7.x, PDF 1.7 - Acrobat 8.x и выше )
PdfVersion = 1.4

; При значении "no" PDF документ будет без текстового слоя.
PdfWithText = yes ; (yes, no)

; Свойства PDF документа
PdfTitle = ""
PdfAuthor = ""
PdfSubject = ""
PdfKeywords = ""

; Разрешение (количество точек на дюйм) вставляемых в документ графических элементов. Параметр применяется только к тем 'картинкам', в свойствах(хранимых в заголовках графических файлов) которых отсутствует данное значение (например, потеряно после обработки графическим редактором).
Resolution = 200

; Параметр управляет прозрачностью фона вставляемых 'картинок'. Все цвета в диапазоне RGB(MaskColor..255, MaskColor..255, MaskColor..255) будут невидимы. Например, при MaskColor = 255 'прозрачным' будет только белый цвет.
MaskColor = 230

; Параметр указывает на позицию подписи по отношению к имени владельца. Например, вы указали значение "left". Если программа найдет свободное место слева и справа от имени, то поставит подпись слева. Если место окажется только с одной стороны, подпись встанет туда. При отсутствии места под подпись поиск продолжится в направлении вверх/вниз. Но в случае, если программа обнаружит рядом с именем линию, состоящую из символов подчеркивания и имеющую достаточную длину, то 'распишется' на ней.
При отсутствующем параметре (или значении) программа сама попробует определить правильную позицию.

SgnPosition = ; (left, right, top, bottom)

; Символ подчеркивания. Линия из этих символов рядом с именем указывает на место подписания.
SgnLinesChar = "_"

; Место печати на документе. Через запятую перечисляются 'слова', указывающие на это самое место (например, "м.п." , "мп"). При отсутствующем параметре (или значении) поиск специально выделенного места для печати производится не будет.
PlaceOfSeal = ""

Объекты и инструкции.

Так как основной задачей программы является вставка в определенные места документов графических элементов (и текстовых строк), то для управления этим процессом были введены следующие объекты:

Document() - обрабатываемый документ
Image() - вставляемый графический элемент
Text() - вставляемый текст
Position() - место в документе для вставки
Insert() - инструкция, указывающая программе куда и что вставлять

Параметрами в объектах могут быть объекты. Все параметры обязательно разделяются запятыми.
А теперь подробнее об объектах и их параметрах.

Параметры документа:

Title - слово или фраза, входящие в заголовок документа, посылаемого на печать.
Text - фраза, содержащаяся в тексте документа. Параметров с таким именем может быть несколько.

Title и Text являются определяющими параметрами/свойствами, которые идентифицируют подписываемый документ. Параметры ниже будут применены только к этим документам.

AutoSign - см. выше.
FileName - Имя выходного файла. При отсутствующем параметре (или значении) имя берется из заглавия посланного на печать документа.

Далее пойдут параметры, с помощью которых можно подкорректировать автоматическое подписание документов. Например, в некоторых документах программа ставит лишние подписи или не совсем правильно располагает их.


SgnItem - Если имена владельцев подписей встречаются в тексте документа несколько раз с помощью этого параметра можно указать которые из них (по счету) участвуют в подписании. Отсчет идет слева направо, потом сверху вниз. При отрицательном значении отсчет идет в обратном порядке. Например, при значении -1(минус один) будут рассматриваться только 'последние' имена.
SgnCount - количество подписей в документе. Решает задачу с лишними подписями (см. выше), оставляя в конце документа только заданное количество.
SgnShiftX - сдвиг подписей по горизонтали в миллиметрах.
SgnShiftY - сдвиг подписей по вертикали в миллиметрах.

; Данному объекту соответствует любой документ (нет параметров Title и Text)
Document( AutoSign = yes )

; Подписанные счета будут сохраняться в файлы с именем 'Invoice'. Данному объекту будут соответствовать только те документы, у которых в тексте присутствуют обе фразы из Text.
Document( Text = "Счет №", Text = "на оплату", FileName = Invoice )

; Здесь мы не только задаем свойства определенному типу документов, но и присваиваем имя этому объекту. Далее мы будем использовать именованную ссылку на данный объект в качестве параметра.
Счет = Document( Title = Счет, FileName = "Invoice", AutoSign = no )

Параметры графического элемента:

File - имя (или часть имени) графического файла. Файл должен находиться в папке с образцами (Stamps). Является определяющим параметром/свойством.

Type - тип графического файла. Возможные варианты значений - (Signature, Seal, Picture).
(Подпись, Печать, Произвольное изображение).

Resolution - Разрешение (количество точек на дюйм) картинки. Значение dpi в заголовке BMP файла игнорируется.
Word - слово или фраза в тексте документа, указывающие место вставки подписи.
Параметров с таким именем может быть несколько.
Если в описании подписи присутствует
Word, то имя файла в поиске 'мест вставки' участвовать не будет (см. пример ниже).

; Подпись босса.
Босс = Image( File = "подпись босса" , Word = "John Smith", Word = "J. Smith" )

Параметры текста:

Text - строка, вставляемая в документ.
FontName - имя шрифта
Size - размер шрифта
Color - цвет строки (например, Red или FF0000 или '255,0,0' )
Angle - угол в градусах

ВНИМАНИЕ! Описание объектных данных может располагаться на нескольких строках.

; Пример текста со значениями по умолчанию в комментариях.
Text(
 Text = "Пример текста ",
 FontName = Arial, ; Times New Roman
 Size = 24, ; 10
 Color = Red, ; Black
 Angle = 15 ; 0
)

Параметры объекта 'Position':

Page - номер страницы в документе. При отрицательном значении отсчет идет с последней страницы в обратном порядке (см. пример ниже).
X - смещение по горизонтали в миллиметрах.
Y - смещение по вертикали в миллиметрах.
Если координаты (
X, Y) абсолютные (отсутствуют параметры Word и Image), то отсчет идет от левого верхнего угла страницы вправо и вниз. Кроме чисел абсолютные координаты могут принимать следующие значения:
X - (Left, Center, Right)
Y - (Top, Center, Bottom, EndText)

Word - слово или фраза в тексте документа.
Image - графический элемент (например, подпись), вставляемый в документ автоматически.
Item - если в документе найдено несколько одинаковых элементов (Word или Image), то данный параметр указывает на один из них. Возможны отрицательные значения как в Page.
X, Y - координаты относительно найденного элемента (Word, Image).

; Правый верхний угол на последней странице.
Position( Page = -1 , X = right ) ; Отсутствующая координата принимает нулевое значение

; На каждой странице (нет параметра Page) в центре по горизонтали и 15мм ниже последней текстовой строчки.
Position( X = center , Y = endtext+15 )

; 5мм левее и 10мм выше последнего слова 'подпись' в тексте документа.
Position( Word = 'подпись', Item = -1, X = -5, Y = -10 )

Инструкция 'Insert' и её параметры в примерах:

; Результат этой инструкции - логотип в правом верхнем углу (с отступом в 5 мм) на первой странице любого посланного на подпись документа.
Insert(
 Document( ), ; Любой документ. Если параметр будет отсутствовать, результат будет тот же.
 Image(
  File = 'logo.bmp',
  Resolution = 96,
  Type = Picture ; Произвольное изображение
 ), ; Не забываем про запятые между параметрами.
 Position( X = right-5, Y = top+5, Page = 1 )
)

; Программа 'распишется' за босса на предпоследней 'линии' в тексте счета.
Insert(
 Счет , ; Документ, описанный выше
 Босс , ; Графический элемент, описанный выше
 Position( Word = '___________', Item = -2 )
)

; Если 'письма' подписываются корректно, но не хватает печати, инструкция поможет поставить её около первой по счету подписи.
Insert(
 Document( Title = Письмо ),
 Image( File = печать ),
 Position(
  Image( ), ; Объекту соответствуют все вставляемые автоматом 'картинки'
  Item = 1, ; Отсчет идет слева направо, потом сверху вниз
  Y = -5, ; Сдвиг на 5 мм вверх относительно найденной 'картинки'
  X = -25 ; Сдвиг на 25 мм влево относительно найденной 'картинки'
 )
)

; Надпись внизу каждой страницы.
Insert(
 Document( Title = Копия ),
 Text( Text = "Копия", Color = Red, Size = 8),
 Position( X = center, Y = bottom-10 )
)