Настройка фильтра JSON

Official translation unavailable. Translate this page with Google:

Фильтр JSON

Подробную информацию о фильтрах в целом см. в разделе Описание фильтров.

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

Примечание

В Automation можно использовать все типы данных JSON. Подробнее о доступных типах данных JSON см. здесь.

Несмотря на то что вы можете задать структуру файла JSON вручную, NiceLabel рекомендует импортировать структуру из полученных файлов JSON.

Порядок импорта структуры файла JSON:

  1. Выберите Фильтры данных и Редактировать для фильтра JSON.

  2. Нажмите Структура > Импорт структуры данных. Перейдите к требуемому файлу JSON и нажмите Открыть.

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

Примеры данных JSON см. в разделе Данные JSON.

Задание полей JSON

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

Порядок задания полей JSON:

  1. Выберите элемент и задайте для его параметра Использование значение Значение переменной.

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

  3. Элемент используется в качестве имени выходного поля.

  4. Значения выбранного элемента выделяются в разделе «Предпросмотр данных».

    UUID-9f0f03fd-7076-59f2-c647-ba1f51e713b0.png

Определение повторяющихся элементов в фильтре JSON

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

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

  1. Выберите элемент и определите его как блок данных.

  2. Включите параметр Повторяющийся элемент.

UUID-8cd03b89-bc59-8a9a-0f71-cb27d3d850d8.png

Если фильтр содержит определение элементов, заданных как блок данных/повторяющийся элемент, действие Использовать фильтр данных отображает повторяющиеся элементы с вложенными заполнителями. Все действия, вложенные в такие заполнители, выполняются только для блоков данных на этом уровне.

Определение области задания JSON

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

UUID-8cd03b89-bc59-8a9a-0f71-cb27d3d850d8.png

Примечание

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