Official translation unavailable. Translate this page with Google:

Функции служат для работы с данными, назначаемыми объектам этикетки. Они обрабатывают существующие значения из источников данных и сохраняют результат в источниках данных, генерируемых функциями.

Каждую функцию можно напрямую подключить к объекту и использовать ее в качестве другой функции.

Подсказка

Списки всех функций для этикетки или решения представлены в проводнике динамических данных и менеджере динамических данных.

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

UUID-f0074216-815f-0a71-0d86-e1118612e4a1.png

В состав Designer входят следующие типы функций:

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

  • Объединить: осуществляет слияние значений из двух или более источников данных в единое значение.

  • Смещение даты: служит для смещения имеющейся даты.

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

  • VBScript: позволяет выполнять сложные преобразования значений.

  • Выражение VBScript упрощенная версия функции VBScript.

  • Сценарий Python: позволяет выполнять сложные преобразования значений.

  • HIBC: служит для кодирования данных в соответствии со стандартом штрихкода для медико-фармацевтической промышленности.

  • GS1-128: служит для кодирования данных в соответствии со стандартом штрихкода GS-128.

  • ANSI MH10.8.2: служит для кодирования данных в соответствии со стандартом ANSI MH10.8.2-2006.

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

  • Читать из файла: данная функция служит для считывания содержимого из указанного файла и отображения его в объекте.

  • Сообщение NDEF: данная функция позволяет определить формат инкапсуляции сообщения для обмена данными по беспроводной связи ближнего радиуса действия (NFC).

Подмножество

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

В группе элементов О программе представлено описание функции.

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

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

Фиксированная длина: извлечение фиксированного количества символов из источника входных данных.

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

  • Длина: длина извлеченного значения.

Пример 34. Пример:

Входное значение: ABCDE

Смещение: 0

Длина: 3

Значение подмножества:  ABC


Пример 35. Пример:

Входное значение: ABCDE

Смещение: 2

Длина: 3

Значение подмножества:  CDE


Параметр Разделитель используется при извлечении данных, разделенных заданным пользователем символом.

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

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

Подсказка

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

  • Номер поля: номер поля, извлекаемый из источника входных данных.

Пример 36. Пример:

Входное значение: "A", "B", "C", "D"

Разделитель: ,

Ограничитель текста: "

Номер поля: 3

Значение подмножества:  C


Сцепить

Функция Объединить осуществляет слияние значений из двух или более источников данных в единое значение.

В группе элементов О программе представлено описание функции.

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

В группе элементов Параметры вывода указан формат выходного значения.

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

  • Новая строка (CR/LF): символ новой строки.

  • Вставить специальный символ: ввод специального символа.

    Примечание

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

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

    Подсказка

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

Пример 37. Пример:

Значение из источника данных 1: A, B, C, D

Значение из источника данных 2: <пусто>

Значение из источника данных 3: E, F, G

Разделитель: ,

Объединенное значение с пропуском пустых значений и без него: A, B, C, D, E, F, G vs. A, B, C, D,, E, F, G


Примечание

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

Сдвиг даты

Функция Смещение даты определяет количество дней, месяцев и/или лет, которое следует добавить к любой указанной дате или вычесть из нее (это может быть текущая дата или дата в прошлом/будущем).

В группе элементов О программе представлено описание функции.

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

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

Пример:

Текущая дата: 8 марта 2016

Смещение: дни +1; месяцы +1; годы +1

Результат: 7 апреля 2017

В группе элементов Формат вывода указываются выходные данные функции.

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

  • Пример: текущая дата в формате, выбранном с помощью параметра Вывод.

Линейный

Функция Линейный служит для умножения или деления значения из источника входных данных на заданный множитель. Также можно добавить дополнительную величину (Дополнение).

В группе элементов О программе представлено описание функции.

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

Параметры линейной функции:

  • Режим: тип линейной функции.

  • a: множитель функции.

  • b: дополнение функции.

В группе элементов Формат вывода указываются выходные данные функции.

Вывод — формат измененного значения. Параметр еще... служит для открытия дополнительных параметров форматирования:

  • Десятичный знак: символ, разделяющий целую и дробную части десятичного числа.

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

  • Разделитель групп разрядов: служит для указания того, разделяются ли разряды.

  • Разделитель: символ, разделяющий разряды в числе.

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

Пример 38. Пример:

Входное значение: 123

a: 2

b: 20

Выходное значение: 2 * 123 + 20 = 266


Сценарий VBScript

Функция VBScript обеспечивает чтение, запись и выполнение действий с данными из любого подключенного источника данных.

В группе элементов О программе представлено описание функции.

  • Тип функции: отображение выбранного типа создания сценариев.

В группе элементов VBScript находятся параметры для определения сценария.

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

  • Проверить: проверяет и подтверждает синтаксис введенного сценария.

  • Редактор сценариев: открывает редактор, в котором создавать сценарии проще и эффективнее.

Примечание

Результат выполнения сценария следует сохранить в поле «Результат». Значение поля «Результат» вставляется в имя функции. Такая функция доступна в качестве источника динамических данных для использования в дальнейшем.

Пример 39. Пример:

Переменная NAME предоставляет имя и фамилию человека. Функция VBScript должна разделять имена и использовать только имя в качестве результата выполнения функции.

Начальное значение переменной NAME: John Doe

Dim Spc
Spc = InStr(NAME, " ")
if NAME <> "" then
    Result = Mid(NAME, 1, Spc-1)
end if

Результат выполнения функции VBScript: John


Примечание

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

Datevariable.Value == None

Выражение VBScript

Выражение VBScript — это упрощенная версия функции VBScript. Данная функция Designer позволяет:

  • выполнять действия с существующими переменными

  • извлекать вложенные строки

  • выполнять быстрые вычисления

Выражение VBScript сокращает потребность в написании специальных сценариев VBScript. Вместо написания целого сценария достаточно вставить однострочное выражение в поле редактирования, которое подтверждается во время печати.

Подсказка

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

О программе

Выражение VBScript

  • Вставить источник данных: служит для вставки в выражение существующего или нового созданного источника данных.

  • Проверить: служит для проверки и подтверждения синтаксиса введенного сценария.

  • Редактор: поле для написания и редактирования сценария.

Редактор сценариев

NiceLabel 10 предоставляет редактор сценариев, который упрощает и ускоряет создание сценариев Python или VBScript, позволяя избежать ошибок.

UUID-71775a07-f174-df14-34c8-13e31eef6953.png

Способ выбора языков сценариев, которые следует использовать в редакторе сценариев, в NiceLabel Designer Pro и Automation Builder различен :

  • В Designer дважды щелкните рабочую область формы, чтобы открыть раздел Свойства формы >Дополнительные настройки> Язык сценариев формы.

  • В Automation Builder перейдите в раздел Элементы конфигурации, нажмите Правка, чтобы открыть свойства триггера, затем выберите Настройки> Прочее > Сценарии.

Подсказка

NiceLabel 10 использует .NET-вариант языка Python, который называется IronPython. Он работает как полностью совместимая реализация языка сценариев Python, которая также поддерживает методы .NET.

Лента редактора содержит часто используемые команды, которые распределены по нескольким функциональным группам.

  • В группе Буфер обмена предлагаются команды Вырезать, Копировать, Вставить и Удалить.

  • Группа Отменить Вернуть позволяет отменить или повторить действия при редактировании сценария.

  • Группа Файл позволяет загружать сценарии и сохранять их в файлы.

    • Загрузить из файла: загрузка сценария из ранее сохраненного внешнего текстового файла.

    • Сохранить в файл: сохранение редактируемого сценария в текстовый файл.

  • Группа Редактирование позволяет находить и замещать строки в сценарии.

    • Поиск: нахождение расположения введенной строки в сценарии.

    • Заменить: замена строки в сценарии.

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

  • Группа Сценарий: команда Проверить сценарий проверяет синтаксис введенного сценария.

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

Описание элемента предоставляет основную информацию о вставленном элементе сценария.

Список ошибок содержит ошибки, о которых сообщается после выполнения команды Проверить сценарий.

Сценарий Python

Функция Сценарий Python поддерживает даже самые сложные действия с этикеткой или формой.

Подсказка

По сравнению с VBScript эта функция больше подходит для 64-разрядных систем. Она также является более быстрой альтернативой при создании сценариев.

В группе элементов О программе представлено описание функции.

  • Тип функции: отображение выбранного типа создания сценариев.

Сценарий Python

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

  • Проверить: проверяет и подтверждает синтаксис введенного сценария.

  • Редактор сценариев: открывает редактор, в котором создавать сценарии проще и эффективнее.

Пример 40. Пример:

Переменная NAME предоставляет имя и фамилию человека. Функция «Сценарий Python» должна разделять имена и использовать только имя в качестве результата выполнения функции.

Начальное значение переменной NAME: John Doe

name = NAME.Value
Spc = name.find(' ')
if name != '' and Spc != -1:
    Result.Value = name[0:Spc]
else:
    Result.Value = name

Результат выполнения сценария Python: John


HIBC

HIBC — это стандарт штрихкодов, который используется в медико-фармацевтической промышленности согласно директиве организации HIBCC. Данный стандарт поддерживает составные штрихкоды и использование нескольких элементов, таких как коды артикулов, количество и номер партии, в одном штрихкоде.

Подсказка

Дополнительные сведения об этом стандарте см. на веб-сайте HIBCC.

В группе элементов О программе представлено описание функции.

В группе элементов Структура представлены параметры для выбора стандартной версии штрихкода и одного из трех доступных типов штрихкодов HIBC:

  • Версия: выбор версии HIBC. Для открытия этикеток с данными, закодированными с использованием устаревшей версии HIBC, используется версия 2.5. При создании этикетки кодировка осуществляется в зависимости от выбранной версии HIBC — 2.5 или 2.6.

  • Тип: выбор типа структуры данных.

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

    • Вторичная: необязательная структура данных, обозначаемая разделителем «/». Она может иметь переменную (но предварительно заданную) структуру для серийных номеров или номеров партии, количества и срока годности.

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

    • Объединенная: служит для слияния первых двух типов структуры данных в одну структуру.

В группе элементов Определение находятся параметры определения содержимого полей штрихкода HIBC:

Поля первичной структуры данных:

  • ID-код этикетировщика (LIC): назначение и обслуживание поля осуществляется HIBCC. Первым символов этого поля всегда является буква. LIC может использоваться для идентификации этикетировщика с целью разделения подразделений и отделов родительской организации.

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

  • Единица измерения: числовое представление уровня упаковки (от 0 до 9), где 0 — наименьший уровень или «единица использования».

Пример 41. Пример:

Для упаковки единиц использования компания может использовать коробки, коробки в картонной упаковке, а также картонную упаковку в ящике. Одним из способов этикетирования будет следующий: единица использования = 0; коробка = 1; картонная упаковка = 3; ящик = 5.


Поля вторичной структуры данных:

  • Количество: поле двух- или пятизначного числа для описания количества единиц использования в упаковке, идентифицируемого по этикетке со штрихкодом.

  • Формат даты: предпочтительный формат даты для этикетки HIBC. Если этикетка не должна включать дату, выберите один из форматов, который содержит параметр «Без даты».

  • Дата: отображение текущей даты.

  • Партия/Пакет: в это поле можно вводить буквенно-цифровые символы; длина поля может меняться (не более 18 символов). Если это поле не требуется, его можно не заполнять.

  • Серийный номер: в это поле можно вводить буквенно-цифровые символы; длина поля может меняться (не более 18 символов). Если это поле не требуется, его можно не заполнять.

  • Дата изготовления: идентификатор данных в формате ГГГГММДД.

GS1-128

Функция GS1-128 кодирует данные штрихкода с использованием стандарта GS1-128. Данный стандарт поддерживает кодирование текстовых данных, чисел, функций и всего набора 128 символов ASCII.

GS1-128 кодирует данные и определяет их значение с помощью списка идентификаторов приложений (AI). Эти идентификаторы определяют содержимое и длину данных, которые они включают.

AI включают поля данных, в которых содержится фиксированное или переменное количество символов.

Подсказка

Дополнительные сведения о стандарте GS-128 и принципах кодирования данных см. на веб-сайте GS1.

Список доступных AI представлен здесь.

О программе

В поле Идентификаторы приложений отображаются выбранные AI.

Кнопка Редактировать определение функции служит для открытия диалогового окна редактирования идентификаторов. В диалоговом окне Определение функции находятся кнопки Добавить, Удалить, Переместить для выполнения соответствующих действий при редактировании выбранных идентификаторов. В диалоговом окне имеется четыре столбца со свойствами идентификаторов:

  • В столбце Идентификатор указан идентификационный номер AI и его описание.

  • В столбце Значение указано введенное вручную или динамически заданное значение из выбранного источника данных.

    Подсказка

    Столбец Значение позволяет убедиться в том, что значения соответствуют требованиям стандарта GS1-128. Формат значений автоматически корректируется в соответствии с форматом и длиной AI.

    UUID-23567ce5-8cbd-e4da-9c49-cc2f2409c624.png
  • В столбце Параметры указаны дополнительные параметры идентификатора (если имеются).

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

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

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

  • Параметр Создать функцию вывода с неформатированным содержанием служит для создания подчиненной функции, которая использует неформатированные данные, закодированные родительской функцией GS1-128.

  • Имя функции: название новой подчиненной функции.

ANSI MH10.8.2 (ASC)

Функция ANSI MH10.8.2 (ASC) кодирует данные штрихкода с использованием стандарта ANSI MH10.8.2-2006. Данный стандарт содержит ряд идентификаторов данных MH 10/SC 8 и идентификаторов приложений GS1. Он обеспечивает назначение новых идентификаторов данных и определяет корреляцию или сопоставление идентификаторов данных с идентификаторами приложений.

Подсказка

Дополнительные сведения о стандарте ANSI MH10.8.2 (ASC) см. на официальном веб-сайте. ANSI MH10.8.2 входит в стандарт ISO/IEC 15418, который доступен здесь.

В группе элементов О программе представлено описание функции.

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

Кнопка Редактировать определение функции служит для открытия диалогового окна Определение функции. В нем находятся кнопки Добавить, Удалить, Переместить для выполнения соответствующих действий при редактировании выбранных идентификаторов.

В диалоговом окне имеется три столбца со свойствами идентификаторов:

  • В столбце Идентификатор указан сам идентификатор.

  • В столбце Значение указано введенное вручную или автоматически заданное значение из выбранного источника данных.

Примечание

Для каждого столбца Значение применяется ограничение на количество символов. Ограничение (формат) задается стандартом и зависит от выбранного идентификатора.

Синтаксис передаваемых данных для средств автоматического сбора данных высокой емкости

Данная функция поддерживает международный стандарт ISO/IEC FDIS 15434 для синтаксиса средств автоматического сбора данных высокой емкости.

Данный стандарт определяет способ передачи данных в средства автоматического сбора данных высокой емкости (ADC) из информационной системы поставщика, а также способ передачи данных в информационную систему получателя.

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

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

Примечание

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

В группе элементов О программе представлено описание функции.

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

Подсказка

Идентификаторы служат для уникальной идентификации элементов. Чтобы перейти к управлению идентификаторами, нажмите Редактировать определение функции.

В диалоговом окне Определение функции находятся кнопки Добавить, Удалить, а также параметры для выполнения соответствующих действий при редактировании выбранных идентификаторов.

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

Пример 42. Пример:

  • - Конверт формата 02 представляет собой полное сообщение EDI/данные транзакции.

  • - Конверт формата 06 представляет собой данные, закодированные с использованием идентификаторов данных ASC MH 101.


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

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

    • Версия: организация, контролирующая структуру данных.

      Примечание

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

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

Читать из файла

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

В группе элементов О программе представлено описание функции.

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

Параметр Имя файла задает подключение к файлу.

Параметр Кодировка служит для указания типа кодировки для отправленных данных.

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

    Подсказка

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

Сообщение NDEF

Функция Сообщение NDEF позволяет определить формат инкапсуляции сообщения для обмена данными по беспроводной связи ближнего радиуса действия (NFC). Такая связь устанавливается между двумя устройствами NFC или между устройством NFC и меткой.

Подсказка

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

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

Примечание

Результат выполнения этой функции выводится в шестнадцатеричном формате.

В группе элементов О программе представлено описание функции.

В группе элементов Структура сообщения NDEF представлены записи NDEF, которые включены в сообщение.

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

  • Тип записи NDEF: служит для указания типа записи. В Designer доступны следующие стандартные типы записей:

    • URI: содержит символьную строку, которая служит для определения веб-ресурса.

    • Текст: содержит текст с информацией о кодировке текста и коде языка.

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

      Примечание

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

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

    • Другое: тип записи, обеспечивающий шифрование неосновных данных NFC.

      Подсказка

      Чтобы быстро изменить порядок записей в диалоговом окне «Сообщение NDEF», используйте перетаскивание мышью.

      Подсказка

      Подробные описания типов записей NDEF представлены в технических спецификациях на форуме NFC.

  • Определение записи: настройки, определенные стандартом NDEF. Доступные параметры зависят от выбранного типа записи.

Параметр Использовать контейнер возможностей служит для добавления контейнера возможностей в закодированные данные. В контейнере возможностей хранятся данные, которые управляют данными NFC, закодированными в метке или на устройстве. Он указывает устройству NFC, что принятые данные являются сообщением NFC. Включите параметр Использовать контейнер возможностей, если содержимое NFC требуется закодировать в стандартную высокочастотную (HF) метку RFID. Он сигнализирует считывающему устройству о том, что содержимое NFC находится в метке. Определенные метки, совместимые с NFC, уже содержат контейнер возможностей, поэтому нет необходимости включать его в генерируемое содержимое.