АллергенСсылка
Ваш путеводитель по интеграции V5!
Конечную точку импорта «AllergenLink» можно использовать для быстрого назначения товаров аллерген группы в рамках прослеживаемости V5.
В этом руководстве основное внимание будет уделено использованию этой конечной точки как посредством импорта CSV, так и с использованием JSON через API V5.
Содержание
1. Группы аллергенов по умолчанию
База данных V5 по умолчанию содержит ряд наиболее распространенных групп аллергенов, но эта конечная точка может быть использована для создания дополнительных, если это необходимо. Стандартные группы аллергенов, которые включены, можно увидеть на снимке экрана ниже:
Эта конечная точка не предназначена для использования в целях создания товаров, это всегда следует делать через «Товар' конечная точка.
2. API-ссылки
Чтобы узнать больше об определениях для «AllergenLink» и связанных с ним классах базы данных, перейдите по следующей ссылке:
3. Полевое руководство AllergenLink
3.1. Первичные ключи
Для обеих методологий импорта первичными ключами являются:
Аллерген_Аллерген – название группы аллергенов (например, пшеница, глютен и т. д.).
Код_Товара – Уникальный код товара, который будет присвоен группе аллергенов.
3.2. Дополнительные поля
Другие параметры, которые мы можем добавить из класса базы данных «Аллерген», следующие:
Allergen_TextColor – Позволяет вводить число RGB для назначения цвета группе аллергенов. Обратите внимание, что это должно быть одинаково для всех товаров в одной группе аллергенов. Также обратите внимание, что при импорте цветов с использованием этого метода числа RGB не нужно разделять запятыми (например, 219 125 33 вместо 219, 125, 33).
4. Пример набора данных
В этой статье мы рассмотрим простой пример набора данных, включающий 5 ингредиентов, которые могут использоваться в процессе производства:
Итак, здесь мы назначим следующие группы аллергенов по умолчанию для этих товаров. Для импорта CSV мы также назначим цвета текста в то же время:
- Мучной – Пшеница (красный) и глютен (фиолетовый)
- Сыр – Молочный (желтый)
- яйца – Яйцо (зеленое)
- Соевые бобы – Соя (синяя)
- Миндаль – Орехи (оранжевые)
5. Методология
5.1. JSON — Импорт
Конечная точка/URI импорта «AllergenLink» –
http://host:port/V5-API/api/integrate/import/allergen_link
Образцы:
Используя конечную точку «AllergenLink», мы можем структурировать файл импорта для вышеуказанных дополнений следующим образом:
Этот образец файла JSON можно загрузить здесь.
И как только мы разместим это в системе, мы увидим, что все наши товары были отнесены к правильной группе аллергенов, в данном случае миндаль отнесен к категории «Орехи».
5.2. CSV – Импорт
Для импорта CSV нам сначала необходимо создать заголовочный файл для нашего импорта.
Имя файла определения заголовка/столбца: «allergenLink.csvh»
Готовые заголовочные файлы должны быть размещены в: “ \SG Control Center\gateway\import\column_defs”
Импортировать имя файла CSV: «allergenLink-datetime.csv»
CSV для импорта должны быть размещены в: “ \SG Control Center\шлюз\импорт»
Образцы:
Заголовочный файл:
Пример файла заголовка можно увидеть ниже. Здесь мы будем назначать наши товары определенным группам аллергенов, а также добавлять цвет к группам:
Для получения дополнительной информации о том, как мы структурируем эти файлы, см. главная страница интеграции. Этот образец заголовочного файла можно загрузить здесь.
Файл импорта CSV:
Затем мы можем использовать определенный порядок точек данных в заголовке для структурирования нашего файла импорта. Обратите внимание, что эта первая строка может быть проигнорирована Центром управления и, таким образом, может быть сохранена в файле при отправке на импорт. Пример импорта на основе наших требований выше будет выглядеть следующим образом:
Обратите внимание, что нам не нужны запятые, которые обычно разделяют значения RGB. Этот пример файла импорта можно загрузить здесь.
Затем мы можем поместить этот файл в нашу папку импорта, как определено выше, и после завершения импорта мы сразу увидим, что цвета текста группы аллергенов были обновлены:
И если мы рассмотрим каждую группу, то увидим, что желаемые нами аллергены были добавлены:
