Данные и подключение

Official translation unavailable. Translate this page with Google:

Открыть документ/программу

Это действие предоставляет интерфейс для взаимодействия с внешним приложением и открывает его с помощью командной строки.

Внешние приложения могут выполнить дополнительную обработку и вернуть результат в NiceLabel 10. Это действие позволяет установить связь с любым сторонним программным обеспечением, которое может выполнять дополнительную обработку данных или получать данные. Внешнее программное обеспечение может предоставить ответ с данными, сохранив их в файл, откуда их можно считать в переменные.

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

C:\Applications\Processing.exe [variable1] [variable2]
UUID-5d28e5a1-7881-3792-3aca-f065586a3897.png

Примечание

Если это действие используется в решениях NiceLabel 10, оно позволяет открывать веб-страницы или создавать сообщения электронной почты прямо на основе форм. См. раздел «Создание гиперссылок и отправка сообщений электронной почты в форме» руководства пользователя NiceLabel 10.

В группе Файл задается открываемый файл.

  • Имя файла: местоположение и имя файла или приложения, которые требуется открыть.

    Имя выбранного файла может быть жестко запрограммировано, чтобы каждый раз использовался один и тот же файл. Если задано только имя файла без пути, используется папка с файлом конфигурации NiceLabel Automation (.MISX). Можно использовать относительную ссылку на имя файла, в которой в качестве корневой папки используется папка с файлом .MISX.

    Источник данных: позволяет указать имя файла переменной. Выберите переменную, содержащую путь к файлу и/или имя файла, или объедините несколько переменных для формирования имени файла. Дополнительные сведения см. в разделе «Использование составных значений» руководства пользователя NiceLabel Automation.

    Примечание

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

В группе Опции выполнения задаются сведения об открытии программы.

  • Скрыть окно: делает окно открытой программы невидимым. Так как NiceLabel 10 выполняется в собственном сеансе как служебное приложение, оно не может взаимодействовать с рабочим столом, даже если выполняется с привилегиями текущего пользователя. Компания Microsoft по соображениям безопасности заблокировала это взаимодействие в Windows Vista и более новых операционных системах.

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

    Подсказка

    Установите этот флажок, если последующее действие зависит от результата внешнего приложения.

Сохранить данные в файл

Информация об уровне продукта

Automation Builder Для работы функций требуется NiceLabel LMS Enterprise или NiceLabel LMS Pro.

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

В группе Файл задается открываемый файл.

  • Имя файла: местоположение файла, который должен быть открыт в этом действии.

    Путь к файлу и имя файла можно жестко запрограммировать, чтобы каждый раз использовался один и тот же файл. Если задано только имя файла без пути, используется папка с файлом конфигурации NiceLabel Automation (.MISX). Можно использовать относительную ссылку на имя файла, в которой в качестве корневой папки используется папка с файлом .MISX.

    Источник данных: позволяет указать имя файла переменной. Выберите переменную, содержащую путь к файлу и/или имя файла, или объедините несколько переменных для формирования имени файла. Дополнительные сведения см. в разделе «Использование составных значений» руководства пользователя NiceLabel Automation.

Если файл уже существует, параметры обрабатываются группой Если файл существует.

  • Перезаписать файл: перезапись существующих данных новыми данными. Старое содержимое утрачивается.

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

В группе Содержимое задается, какие данные записываются в указанный файл.

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

  • Пользовательский: содержимое сохраняется в том виде, в котором оно предоставлено в текстовой области. Допускаются фиксированные значения, значения переменных и специальные символы. Чтобы ввести переменные и специальные символы, нажмите кнопку со стрелкой справа от текстовой области. Дополнительные сведения см. в разделе «Объединение значений в объекте» руководства пользователя NiceLabel Automation.

  • Кодирование: тип кодировки отправленных данных. Автом. — автоматическое определение кодировки. При необходимости выберите предпочтительный тип кодировки в выпадающем списке.

Считать данные из файла

Информация об уровне продукта

Описанное свойство доступно в NiceLabel LMS Enterprise и NiceLabel LMS Pro.

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

Обычно модуль Automation Builder получает данные для печати этикеток с помощью триггера. Например, если используется триггер файла, содержимое файла триггера автоматически считывается и может быть проанализировано фильтрами. Однако фильтры можно обойти, чтобы получить некоторые внешние данные. Выполнив это действие и сохранив данные в переменной, к данным можно применить любые доступные действия.

Это действие полезно в следующих случаях:

  • Если данные, полученные триггером, необходимо объединить с данными, хранящимися в файле.

Предупреждение

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

  • Когда требуется обмен данными между триггерами. Один триггер готовит данные и сохраняет их в файл (используя действие Сохранить данные в файл), другой триггер считывает данные.

В группе Файл задается файл, содержимое которого должно быть считано.

  • Имя файла: местоположение файла, который должен быть считан в этом действии.

    Путь к файлу и имя файла можно жестко запрограммировать, чтобы каждый раз использовался один и тот же файл. Если задано только имя файла без пути, используется папка с файлом конфигурации NiceLabel Automation (.MISX). Можно использовать относительную ссылку на имя файла, в которой в качестве корневой папки используется папка с файлом .MISX.

    Источник данных: позволяет указать имя файла переменной. Выберите переменную, содержащую путь к файлу и/или имя файла, или объедините несколько переменных для формирования имени файла. Дополнительные сведения см. в разделе «Использование составных значений» руководства пользователя NiceLabel Automation.

    Примечание

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

В группе Содержимое задаются сведения, относящиеся к содержимому файла.

  • Переменная: переменная, в которой сохраняется содержимое файла. Следует определить хотя бы одну переменную (существующую или создаваемую).

  • Кодирование: тип кодировки отправленных данных. Автом. — автоматическое определение кодировки. При необходимости выберите предпочтительный тип кодировки в выпадающем списке.

    Примечание

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

В группе Повтор при ошибке определяется, как должно продолжиться выполнение действий, если указанный файл становится недоступным.

Подсказка

Модуль Automation Builder может не получить доступ к файлу, если он заблокирован другим приложением. Если приложение по-прежнему записывает данные в выбранный файл, удерживая его заблокированным в монопольном режиме, в это время никакое другое приложение не может его открыть, даже для чтения. Другие возможные причины повторных попыток выполнения действий: файл не существует (еще), папка не существует (еще), или у пользователя службы нет прав доступа к файлу.

  • Попытки повтора: определяет количество повторных попыток доступа к файлу. Если задано значение 0, повторные попытки не предпринимаются.

  • Интервал повторных попыток: временной интервал между отдельными попытками в миллисекундах.

Удалить файл

Информация об уровне продукта

Описанное свойство доступно в NiceLabel LMS Enterprise и NiceLabel LMS Pro.

Это действие удаляет выбранный файл с диска.

Модуль NiceLabel Automation работает как служба под заданной учетной записью Windows. У учетной записи должны быть разрешения на удаление выбранного файла в указанной папке.

В группе Файл задаются сведения о файле.

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

    Путь к файлу и имя файла можно жестко запрограммировать, чтобы каждый раз использовался один и тот же файл. Если задано только имя файла без пути, используется папка с файлом конфигурации NiceLabel Automation (.MISX). Можно использовать относительную ссылку на имя файла, в которой в качестве корневой папки используется папка с файлом .MISX.

    Параметр Источник данных позволяет указать имя файла переменной. Выберите или создайте переменную, содержащую путь к файлу и/или имя файла, или объедините несколько переменных для формирования имени файла. Дополнительные сведения см. в разделе «Использование составных значений» руководства пользователя NiceLabel Automation.

    Примечание

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

Выполнить инструкцию SQL

Информация об уровне продукта

Automation Builder Для работы функций требуется NiceLabel LMS Enterprise или NiceLabel LMS Pro.

Это действие отправляет SQL-команды подключенному серверу SQL и собирает результаты. Используются команды SELECT, INSERT, UPDATE и DELETE.

Действие «Выполнить инструкцию SQL» выполняется для достижения двух целей, описанных ниже.

  • Получить дополнительные данные из базы данных: в модуле Automation Builder триггер получает данные для печати этикетки, но не все необходимые значения. Например, триггер получает значения для переменных Product ID и Description, но не для переменной Price. Значение для переменной Price приходится искать в базе данных SQL.

    Пример SQL-кода:

    SELECT Price FROM Products
    WHERE ID = :(Product ID)

    ID — это поле в базе данных, Product ID — переменная, определенная в триггере.

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

    Пример SQL-кода:

    Задание полю таблицы AlreadyPrinted значения True для обрабатываемой в данный момент записи.

    UPDATE Products
    SET AlreadyPrinted = True
    WHERE ID = :(Product ID)

    Или удаление текущей записи из базы данных, так как она больше не нужна.

    DELETE FROM Products
    WHERE ID = :(Product ID)

    ID — это поле в базе данных, Product ID — переменная, определенная в триггере.

Примечание

Чтобы использовать значение переменной в инструкции SQL, необходимо перед ее именем вставить двоеточие (:). Это указывает на то, что следом идет имя переменной.

Важно

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

Используйте те же имена для переменных с запросами, которые определены для полей базы данных, например:

Поле базы данных: food_products_1c.ProdCode

Переменная с запросом на этикетке: ProdCode

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

В группе Подключение к БД задается соединение с базой данных, которое используется для данной инструкции.

Подсказка

Чтобы можно было отправить предложение SQL в базу данных, настройте соединение с базой данных. Нажмите кнопку Задать и следуйте указаниям на экране. Можно подключиться к источнику данных, которым можно управлять с помощью команд SQL, поэтому нельзя использовать текстовые (CSV) файлы или файлы Excel.

В группе Инструкция SQL задается инструкцию или запрос SQL, которые требуется выполнить.

Подсказка

Инструкциям на языке DML (Data Manipulation Language — язык управления данными) разрешено выполнять запросы к существующим таблицам базы данных.

Используйте стандартные инструкции SQL, такие как SELECT, INSERT, DELETE и UPDATE, включая объединения, функции и ключевые слова. Инструкции на языке DDL, используемые для создания баз данных и таблиц (CREATE DATABASE, CREATE TABLE) или для их удаления (DROP TABLE), не допускаются.

  • Тест: открывает раздел Предпросмотр данных. При моделировании выполнения (выбрано по умолчанию) тестируется выполнение инструкций SQL. Нажмите Выполнить, чтобы запустить моделирование.

    Подсказка

    Раздел Предпросмотр данных позволяет протестировать выполнение инструкции SQL на реальном наборе данных. Чтобы защитить данные от случайного обновления, обязательно установите флажок Моделировать выполнение. Будут выполнены инструкции INSERT, DELETE и UPDATE. Это позволяет получить обратную связь о том, сколько записей будет затронуто. Затем все операции будут обращены.

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

  • Вставить источник данных: вставляет в инструкцию SQL предварительно определенные или создаваемые переменные.

  • Экспорт/импорт: позволяет экспортировать SQL-инструкции во внешний файл и экспортировать их из него.

  • Режим выполнения: указывает явный режим выполнения инструкций SQL.

    Подсказка

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

    • Автоматически: автоматическое определение действия.

    • Возвращает набор записей (ВЫБРАТЬ): получает набор данных с записями.

    • Не возвращает набор записей (ВСТАВИТЬ, УДАЛИТЬ, ОБНОВИТЬ): эта настройка используется, если выполняется запрос, который не возвращает записи. Вставьте новые записи, удалите или обновите существующие записи. Результат — ответ о состоянии, в котором указано количество строк, затронутых вашим запросом.

  • Время ожидания выполнения: позволяет задать временную задержку отправки команд серверу SQL. Используйте время ожидания выполнения при отправке нескольких последовательных команд SQL, обработка которых требует длительного времени.

    Введите запрошенное время ожидания в секундах. Время ожидания выполнения по умолчанию: 60 с. Если требуется, чтобы время ожидания задал поставщик базы данных, введите 0 с.

Группа Результат позволяет настроить способ хранения результата инструкции SQL и задать итерацию действия.

  • Сохранить данные в переменную: выбор или создание переменной для хранения результата инструкции SQL. Эта настройка зависит от выбранного режима выполнения.

    • Результат выполнения инструкции SELECT. Выполнение инструкции SELECT дает в результате набор записей. Получаемое текстовое содержимое имеет формат CSV. В первой строке указаны имена полей, возвращаемых в результате. В следующих строках содержатся записи.

      Примечание

      Чтобы извлечь значения из возвращенного набора данных и использовать их в других действиях, задайте и выполните действие «Использовать фильтр данных» для содержимого этой переменной (это действие доступно в Automation Builder).

    • Результат выполнения инструкций INSERT, DELETE и UPDATE. Инструкции INSERT, DELETE и UPDATE выдают в результате число, указывающее количество затронутых записей в таблице.

  • Повторить для каждой записи. Если это разрешено, новое действие «Для каждой записи» добавляется автоматически. Все вложенные действия повторяются для каждой записи, возвращенной с помощью инструкции SQL.

    Примечание

    Автоматическое сопоставление включено. Невозможно удалить действие «Для каждой записи».

    Поле базы данных: food_products_1c.ProdCode

    Переменная с запросом на этикетке: ProdCode

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

  • Попытки повтора: указывает количество попыток подключения к серверу базы данных.

  • Интервал повторных попыток: указывает временной интервал между отдельными повторными попытками.

Пример 65. Пример

Вам может потребоваться напечатать этикетки с данными из своей базы данных food_products_1c, но только те, которые содержат записи со стандартным значением поля UseBy.

Для этого необходимо определить значение UseBy с помощью переменной ProdUser. В этом случае значение ProdUser равно «3».

После печати каждой этикетки NiceLabel записывает значения из базы данных в текстовый файл на вашем диске. Используйте следующие действия:

UUID-a1e224b3-86fe-ca30-7a64-e0d749b9e2ae.png
UUID-bb85b16f-5c88-d990-f2c4-31e95428959a.png

Печатаются только этикетки, в которых значение UseBy равно «3», и значения записываются в текстовый файл:

UUID-637fe74b-7603-a307-be15-a9e8afba04f5.png

Послать данные на порт TCP/IP

Это действие отправляет данные любому внешнему устройству, которое принимает соединение TCP/IP с предварительно заданным номером порта.

Функция Послать данные на порт TCP/IP устанавливает соединение с устройством, отправляет данные и разрывает соединение. Соединение и обмен данными управляются подтверждением связи между клиентом и сервером, которое происходит при инициации или завершении TCP-соединения.

В группе Настройки подключения задаются сведения о подключении.

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

    Примечание

    Эта возможность доступна в NiceLabel Automation.

    Необходимые условия для использования функции Отправить отправителю:

    • Удаленная сторона не закрывает канал связи после доставки сообщения.

    • Действие «Послать данные на порт TCP/IP» используется в триггере сервера TCP/IP.

    • Не выбирайте для события выполнения в триггере «Сервер TCP/IP» вариант При отключении клиента.

  • Назначение (IP-адрес:порт): адрес назначения и порт сервера TCP/IP. Жестко запрограммируйте параметры соединения и используйте фиксированное имя хоста или IP-адрес либо используйте переменные параметры подключения, нажав стрелку вправо и выбрав предварительно определенную переменную. Дополнительные сведения см. в разделе «Объединение значений в объекте» руководства пользователя NiceLabel Automation.

    Пример 67. Пример

    Если переменная hostname предоставляет имя сервера TCP/IP, а переменная port — номер порта, введите следующий параметр для места назначения:

    [hostname]:[port]


  • Задержка перед разъединением: после доставки данных продлевает соединение с целевым сокетом на заданные промежутки времени. Некоторым устройствам требуется больше времени на обработку данных. Введите значение задержки вручную или нажимайте на стрелки, чтобы увеличить или уменьшить его.

  • Сохранить отклик данных в переменную: выбирает или создает переменную, в которой сохраняется ответ сервера. Все данные, полученные от сервера TCP/IP, после истечения задержки перед разъединением сохраняются в этой переменной.

В группе Содержимое задается содержимое, отправляемое серверу TCP/IP.

Подсказка

Используйте фиксированное содержимое, сочетание фиксированного содержимого и содержимого переменной или только содержимое переменной. Чтобы ввести содержимое переменной, нажмите кнопку со стрелкой справа от области данных и вставьте переменную из списка. Дополнительные сведения см. в разделе «Объединение значений в объекте» руководства пользователя NiceLabel Automation.

  • Данные: содержимое, отправляемое за пределы системы.

  • Кодирование: тип кодировки отправленных данных. Автом. — автоматическое определение кодировки. При необходимости выберите предпочтительный тип кодировки в выпадающем списке.

Отправить данные на последовательный порт

Это действие отправляет данные последовательному порту. Оно используется для связи с внешними устройствами, подключаемыми к последовательным портам.

Подсказка

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

В группе Порт задается последовательный порт.

  • Имя порта: имя порта, к которому подключается внешнее устройство. Это может быть аппаратный COM-порт или виртуальный COM-порт.

В группе Настройки порта задаются дополнительные параметры подключения к порту.

  • Бит в секунду: скорость, с которой внешнее устройство обменивается данными с ПК. Этот параметр также часто называют скоростью передачи данных. Выберите значение в выпадающем меню.

  • Биты данных: количество бит данных в каждом символе. В новых устройствах почти повсеместно используются 8 бит данных. Выберите значение в выпадающем меню.

  • Паритет: метод обнаружения ошибок в передаче. Наиболее распространенная настройка четности — «нет», при этом обнаружение ошибок обрабатывается протоколом связи (контроль потока). Выберите значение в выпадающем меню.

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

  • Контроль потока: последовательный порт может использовать сигналы интерфейса для приостановки и возобновления передачи данных.

В группе Содержимое задается содержимое, отправляемое последовательному порту.

Подсказка

Допускаются фиксированное содержимое, сочетание фиксированного содержимого и содержимого переменной или только содержимое переменной. Чтобы ввести содержимое переменной, нажмите кнопку со стрелкой справа от области данных и вставьте переменную из списка. Дополнительные сведения см. в разделе «Объединение значений в объекте» руководства пользователя NiceLabel Automation.

  • Данные: содержимое, отправляемое за пределы системы.

Читать данные из последовательного порта

Это действие собирает данные, полученные через последовательный порт (RS-232), и сохраняет их в выбранной переменной. Это действие используется для связи с внешними устройствами, подключаемыми к последовательным портам.

В группе Порт задается последовательный порт.

  • Имя порта: имя порта, к которому подключается внешнее устройство. Это может быть аппаратный COM-порт или виртуальный COM-порт.

В группе Настройки порта задаются дополнительные параметры подключения к порту.

  • Бит в секунду: скорость, с которой внешнее устройство обменивается данными с ПК. Этот параметр также часто называют скоростью передачи данных.

  • Биты данных: указывает количество бит данных в каждом символе. В новых устройствах почти повсеместно используются 8 бит данных.

  • Паритет: указывает метод обнаружения ошибок в передаче. Наиболее распространенная настройка четности — «нет», при этом обнаружение ошибок обрабатывается протоколом связи (контроль потока).

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

  • Контроль потока: последовательный порт может использовать сигналы интерфейса для приостановки и возобновления передачи данных.

Пример 70. Пример

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


Группа Опции содержит следующие настройки:

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

  • Отправить данные инициализации: указывает строку, которая отправляется выбранному последовательному порту перед чтением данных. Эта настройка позволяет действию инициализировать устройство, чтобы получить возможность предоставлять данные. Данную настройку также можно использовать для отправки устройству определенного вопроса и получения определенного ответа. Нажмите кнопку со стрелкой, чтобы ввести специальные символы.

В группе Извлечение данных задается способ извлечения заданных частей полученных данных.

  • Начальная позиция: начальная позиция извлечения данных.

  • Конечная позиция: конечная позиция извлечения данных.

В группе Результат определяется переменная для сохранения данных.

  • Сохранить данные в переменную: выбор или создание переменной для сохранения полученных данных.

Отправить данные на принтер

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

Модуль NiceLabel Automation использует установленный драйвер принтера в режиме сквозной передачи для того, чтобы иметь возможность отправлять данные целевому порту, такому как порт LPT, COM, TCP/IP или USB, к которому подключен принтер.

Примечание

Возможный сценарий. Данные, полученные триггером, должны быть распечатаны на одном сетевом принтере, но в разных шаблонах этикеток (файлы этикеток .NLBL). Принтер может принимать данные с различных рабочих станций и обычно печатает задания в порядке получения. Модуль Automation Builder отправляет каждый шаблон этикетки в отдельном задании печати, что позволяет другой рабочей станции вставлять свое задание между заданиями, созданными в нашем собственном модуле Automation Builder. Вместо того, чтобы отправлять принтеру каждое задание отдельно, объедините все задания с этикетками (используя действие Перенаправление печати в файл) и отправьте принтеру одно большое задание печати.

Группа Принтер позволяет выбрать принтер.

  • Имя принтера: имя принтера, которому отправляются данные. Выберите имя принтера в раскрывающемся списке локально установленных драйверов принтеров. Введите пользовательское имя принтера или задайте его динамически, используя существующую или создаваемую переменную.

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

  • Использовать данные, полученные триггером: используются данные, полученные триггером. В этом случае требуется, чтобы полученный поток печати использовался в качестве входных данных фильтра. Ваша цель — перенаправить поток принтеру без каких-либо изменений. Того же результата можно достигнуть, включив внутреннюю переменную DataFileName и воспользовавшись содержимым файла, на который она ссылается. Дополнительные сведения см. в разделе «Использование составных значений» руководства пользователя NiceLabel Automation.

  • Имя файла: путь к файлу и имя файла, содержащего поток печати. Содержимое указанного файла отправляется принтеру. Выберите Источник данных, чтобы задать имя файла динамически с помощью значения переменной.

  • Переменная: переменная (существующая или новая), содержащая поток печати.

  • Пользовательский: задает пользовательское содержимое, отправляемое принтеру. Допускаются фиксированное содержимое, сочетание фиксированного содержимого и содержимого переменной или только содержимое переменной. Чтобы ввести содержимое переменной, нажмите кнопку со стрелкой справа от области данных и вставьте переменную из списка. Дополнительные сведения см. в разделе «Объединение значений в объекте» руководства пользователя NiceLabel 10.

Запрос HTTP

Информация об уровне продукта

Automation Builder Для работы функций требуется LMS Enterprise.

Это действие отправляет данные целевому веб-серверу, используя выбранный метод HTTP. Допускаются схемы HTTP и HTTPS URI.

В вычислительной модели «клиент — сервер» протокол HTTP работает как запросно-ответный протокол. В этом действии NiceLabel 10 действует как клиент, взаимодействующий с удаленным сервером. Это действие отправляет серверу выбранное сообщение запроса HTTP. Сервер возвращает ответное сообщение, которое может содержать информацию о состоянии завершения запроса, а также может содержать в своем теле запрошенное содержимое.

В группе Настройки подключения задаются параметры подключения.

Примечание

Это действие поддерживает интернет-протокол версии 6 (IPv6).

  • Назначение: адрес, порт и путь назначения веб-сервера.

    Подсказка

    Если веб-сервер по умолчанию работает через порт 80, пропустите номер порта. Жестко запрограммируйте параметры подключения и используйте фиксированные имя узла или IP-адрес. Используйте значение переменной, чтобы задать эту опцию динамически. Дополнительные сведения см. в разделе «Использование составных значений» руководства пользователя NiceLabel Automation.

    Пример 73. Пример

    Если переменная hostname предоставляет имя веб-сервера, а переменная port — номер порта, можно ввести следующее место назначения:

    [hostname]:[port]


  • Метод запроса: доступные методы запроса.

  • Время ожидания: время ожидания (мс) установления соединения с сервером и получения ответа.

  • Сохранить ответ о состоянии в переменную: переменная для сохранения кода состояния, полученного от сервера.

    Подсказка

    Код состояния в диапазоне 2XX — это код успешного завершения. Распространенному ответу «OK» соответствует код 200. Коды 5XX — это ошибки сервера.

  • Сохранить отклик данных в переменную: переменная для сохранения кода состояния, полученного от сервера.

Группа Проверка подлинности позволяет защитить соединение с веб-сервером.

  • Включить обычную проверку подлинности: позволяет вводить необходимые учетные данные для подключения к веб-серверу. Имя пользователя и пароль могут быть фиксированными или предоставляться с помощью переменной.

Примечание

При обычной проверке подлинности HTTP (BA) используются статические стандартные заголовки HTTP. Механизм BA не защищает конфиденциальность передаваемых учетных данных. При передаче они просто кодируются по алгоритму Base64, но не шифруются и не хешируются. Обычную проверку подлинности следует использовать в соединениях по протоколу HTTPS.

  • Отображать пароль: снимается маскировка символов пароля.

В группе Содержимое задается содержимое, отправляемое веб-серверу.

  • Данные: содержимое, отправляемое за пределы системы. Допускаются фиксированное содержимое, сочетание фиксированного содержимого и содержимого переменной или только содержимое переменной. Чтобы ввести содержимое переменной, нажмите кнопку со стрелкой справа от области данных и вставьте переменную из списка. Дополнительные сведения см. в разделе «Объединение значений в объекте» руководства пользователя NiceLabel 10.

  • Кодирование: тип кодировки отправленных данных.

    Подсказка

    Автом. — автоматическое определение кодировки. При необходимости выберите предпочтительный тип кодировки в выпадающем списке.

  • Тип: свойство Content-Type сообщения HTTP. Если тип не выбран, по умолчанию используется application/x-www-form-urlencoded. Если подходящего типа нет в списке, задайте собственный тип или переменную, которая будет задавать тип динамически.

Определенными HTTP-серверами (особенно для служб REST) запрашиваются дополнительные заголовки HTTP.

  • Дополнительные заголовки: жестко запрограммированные заголовки или заголовки, полученные из значений переменных. Чтобы получить доступ к переменным, нажмите маленькую кнопку со стрелкой справа от текстовой области. Дополнительные сведения см. в разделе «Объединение значений в объекте» руководства пользователя NiceLabel 10.

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

    Заголовки HTTP необходимо вводить, используя следующий синтаксис:

    header field name: header field value

    Например, при использовании имен полей заголовков Accept, User-Agent и Content-Type может применяться следующий синтаксис:

    Accept: application/json; charset=utf-8
    User-Agent: Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.63 Safari/537.36
    Content-Type: application/json; charset=UTF-8

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

    Примечание

    Введенные заголовки HTTP переопределяют заголовки, которые уже заданы в свойствах данного действия, такие как Content-Type.

Веб-служба

Информация об уровне продукта

Automation Builder Для работы функций требуется LMS Enterprise.

Веб-служба — это метод связи между двумя электронными устройствами или экземплярами программного обеспечения. Веб-служба определяется как стандарт обмена данными. В ней формат XML используется для тегирования данных, протокол SOAP — для передачи данных, а язык WSDL — для описания доступных служб.

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

После импорта WSDL-кода и добавления ссылки в веб-службу ее методы перечисляются в поле со списком Метод.

Примечание

Через веб-службу можно передавать простые типы, такие как строка, целочисленное значение, логическое значение, но не сложные типы. Язык WSDL должен содержать только одну привязку.

Примечание

Вы планируете печать этикеток продуктов. Ваш триггер получит только часть необходимых данных. Например, триггер получает значения для переменных Product ID и Description, но не для переменной Price. Информация о ценах доступна в отдельной базе данных, доступ которой осуществляется посредством вызова веб-службы. Веб-служба определяет данную функцию, используя определение WSDL. Например, на вход функции поступает переменная Product ID, а на выходе выдается переменная Price. Действие «Веб-служба» отправляет Product ID веб-службе. Это действие выполняет внутренний поиск в своей базе данных и в качестве результата предоставляет соответствующую переменную Price. Действие сохраняет результат в переменной, которую можно использовать в этикетке.

В группу Определение веб-службы входят следующие настройки:

Примечание

Это действие поддерживает интернет-протокол версии 6 (IPv6).

  • WSDL: местоположение WSDL-определения.

    WSDL обычно предоставляется веб-службой. В обычном случае требуется ввести ссылку на WSDL и нажать Импорт, чтобы считать определение. Если при получении WSDL от веб-ресурса возникают проблемы, сохраните WSDL в файл и введите путь с именем файла, чтобы загрузить из него методы. NiceLabel 10 автоматически обнаруживает факт использования удаленной веб-службой документа или синтаксиса RPC и определяет, соответствует ли обмен данными требованиям.

  • Адрес: адрес публикации веб-службы.

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

    Допускаются фиксированное содержимое, сочетание фиксированного содержимого и содержимого переменной или только содержимое переменной. Чтобы ввести содержимое переменной, нажмите кнопку со стрелкой справа от области данных и вставьте переменную из списка. Дополнительные сведения см. в разделе «Объединение значений в объекте» руководства пользователя NiceLabel 10.

  • Метод: методы (функции), доступные выбранной веб-службе. Список автоматически заполняется WSDL-определением.

  • Параметры: входные и выходные переменные для выбранного метода (функции).

    Входящие параметры ожидают входных данных. В целях тестирования и устранения неполадок можно ввести фиксированное значение и просмотреть предварительный результат на экране. Обычно для входящего параметра выбирается переменная. Значение этой переменной будет использоваться как входной параметр. Исходящий параметр предоставляет результат выполнения функции. Необходимо выбрать переменную, в которой будет храниться результат.

  • Время ожидания: время ожидания, после которого устанавливается соединение с сервером.

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

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

  • Показать пароль: открывает маскированные символы полей Имя пользователя и Пароль.

    Сведения о соображениях безопасности можно найти в разделе «Защита доступа к своим триггерам» руководства пользователя NiceLabel Automation.

Поле Предпросмотр данных позволяет осуществить тестовое выполнение веб-службы.

  • Если нажать кнопку Выполнить, вызывается веб-служба.

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