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