Пользовательские команды

COMMENT

При создании командных файлов рекомендуется добавлять комментарии к командам. Это поможет определить, что делает сценарий, если вам потребуется проанализировать код по прошествии некоторого времени. Используйте точку с запятой (;) в начале строки. Весь текст за точкой с запятой рассматривается как комментарий и не обрабатывается.

CLEARVARIABLEVALUES

Эта команда сбрасывает значения переменных до значений по умолчанию.

CREATEFILE

Эта команда создает текстовый файл. Используйте текстовый файл для сообщения стороннему приложению о начале или завершении процесса печати в зависимости от того, куда вы поместили команду. Используйте синтаксис UNC для сетевых ресурсов. Дополнительные сведения см. в разделе Доступ к сетевым общим ресурсам.

DELETEFILE

Удаляет указанный файл. Используйте синтаксис UNC для сетевых ресурсов. Дополнительные сведения см. в разделе Доступ к сетевым общим ресурсам.

EXPORTLABEL

Эта команда автоматизирует команду «Экспорт в принтер», доступную в конструкторе этикеток. Этикетка экспортируется напрямую в принтер и сохраняется в памяти принтера для автономной печати. Пользователь вызывает этикетку с помощью клавиатуры принтера или путем отправки командного файла на принтер. Это же можно сделать с помощью действия Сохранить этикетку в память принтера.

Дополнительные сведения об автономной печати см. в разделе Использование режима печати с сохранением и восстановлением.

IGNOREERROR

Эта команда указывает, что следующие ошибки в файле JOB не должны приводить к завершению процесса печати:

LABEL

Эта команда открывает этикетку для печати. Если этикетка уже загружена, повторное открытие не выполняется. Имя может включать путь. Заключите имя этикетки в двойные кавычки, если имя или путь содержит пробелы. Используйте синтаксис UNC для сетевых ресурсов. Дополнительные сведения см. в разделе Доступ к сетевым общим ресурсам.

Необязательное имя_принтера указывает принтер, для которого открывается этикетка. Используйте этот параметр, если нужно переопределить имя принтера, сохраненное в шаблоне этикетки. Если драйвер для указанного имени принтера не установлен или недоступен, команда выдает ошибку.

MESSAGEBOX

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

PORT

Эта команда переопределяет порт, заданный в драйвере принтера, и перенаправляет печать в файл. Если путь или имя файла содержит пробелы, заключите значение в двойные кавычки ("). Используйте синтаксис UNC для сетевых ресурсов. Дополнительные сведения см. в разделе Доступ к сетевым общим ресурсам.

Параметр APPEND является необязательным. По умолчанию файл перезаписывается. Используйте этот параметр, чтобы добавить данные в существующий файл.

После использования команды PORT в файле JOB она действует до следующей команды PORT или до конца файла (в зависимости от того, что наступит раньше). Если использовать команду PRINTER после выполнения команды PORT, настройка PORT перезапишет порт, заданный для выбранного принтера. Чтобы использовать именно тот порт, который был задан для выбранного принтера, необходимо использовать другую команду PORT с пустым значением: PORT = "".

PRINT

Эта команда запускает процесс печати.

PRINTER

Эта команда переопределяет принтер, заданный в файле этикетки. Если имя принтера содержит пробелы, заключите его в двойные кавычки (").

Используйте имя принтера, отображаемое в строке состояния конструктора этикеток. Имена принтеров обычно совпадают с именами в разделе «Принтеры и факсы» на панели управления, но иногда это не так. При использовании сетевого принтера его имя может иметь вид \\server\share.

PRINTJOBNAME

Эта команда указывает имя задания печати, отображаемое в диспетчере очереди печати Windows. Если имя содержит пробелы или запятые, заключите значение в двойные кавычки (").

SESSIONEND

Эта команда закрывает поток печати. Также см. SESSIONSTART.

SESSIONPRINT

Эта команда печатает текущую указанную этикетку и добавляет ее в текущий открытый поток сеансовой печати. Можно использовать несколько команд SESSIONPRINT одну за другой и объединить указанные этикетки в одном потоке печати. Поток не будет закрыт, пока вы не закроете его с помощью команды SESSIONEND. Значение параметров количества и пропуска такое же, как в NiceCommand PRINT. Также см. команду SESSIONSTART.

SESSIONSTART

Эта команда запускает сеансовый тип печати.

Три команды сеансовой печати ( SESSIONSTART, SESSIONPRINT, SESSIONEND) используются вместе. При использовании команды PRINT данные для каждой этикетки передаются на принтер в виде отдельного задания печати. Чтобы объединить данные для нескольких этикеток в один поток печати, используйте команды сеансовой печати. Для этого введите команду SESSIONSTART, а затем требуемое количество команд SESSIONPRINT. Последовательность завершается командой SESSIONEND.

Используйте эти команды для оптимизации процесса печати этикеток. Печать этикеток из одного задания печати выполняется намного быстрее, чем печать этикеток из нескольких заданий печати.

Следуйте приведенным ниже правилам, чтобы не допускать прерывания сеансовой печати.

SET

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

Если значение содержит пробелы или запятые, заключите текст в двойные кавычки ("). Также см. TEXTQUALIFIER.

Чтобы присвоить многострочное значение, используйте \r\n для кодирования символа новой строки. \r заменяется CR (возврат каретки), а \n заменяется LF (перевод строки).

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

SETPRINTPARAM

Эта команда позволяет более точно настроить параметры принтера непосредственно перед печатью. Можно настроить следующие параметры ( имя_параметра):

TEXTQUALIFIER

Ограничитель текста — это символ, который встраивает значение данных, назначенное переменной. Если значение данных содержит пробелы, оно должно быть заключено в ограничители текста. Ограничителем текста по умолчанию является символ двойной кавычки ("). Поскольку двойная кавычка также используется для обозначения дюймов, иногда бывает трудно передать данные со знаком дюймов через файлы JOB. Можно использовать две двойные кавычки для кодирования одной двойной кавычки или использовать TEXTQUALIFIER.

Пример