Вы можете редактировать файл конфигурации с помощью нашего встроенного блокнота ( меню Пуск > Программы > 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 )
)