Кастомфилдлинк

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

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

В этом руководстве основное внимание будет уделено использованию этой конечной точки как посредством импорта CSV, так и с использованием JSON через API V5.

1. Компоновка центра управления
2. Ссылки API
3. Руководство по полю CustomFieldLink
   1. Первичные ключи
   2. Обязательные поля
4. Пример набора данных
5. Методология
   1. 1. JSON — импорт
      2. CSV – Импорт

С точки зрения того, как мы можем связать данные настраиваемых полей с тем, что мы видим в Центре управления, мы будем использовать API V5 и Gateway для заполнения как верхней панели «CustomField» для наименования наших настраиваемых полей и ввода данных параметров метки, так и нижней панели «CustomFieldLink» для назначения товаров настраиваемому полю и ввода конкретной информации о формуле, которую затем можно будет вызвать для набора параметров метки на верхней панели.

Чтобы узнать больше об определениях класса «CustomFieldLink», перейдите по следующей ссылке:

Кастомфилдлинк 

Для импорта через конечную точку «CustomFieldLink» первичными ключами являются:

Имя_поля – Уникальное имя для пользовательского поля, которое мы либо добавляем, либо назначаем нашей формуле. Мы можем видеть это выше как «Распределено по».

Код_Товара – Уникальный код формулы товара/продукта, который будет присвоен группе пользовательских полей.

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

Из пользовательского поля:

Field_LabelParameter – Необходимо при создании новой группы пользовательских полей, это параметр, который будет использоваться в метках для вызова пользовательских данных из этой группы. В примере Control Center выше мы видим, что это «DIST».

Значение_по_умолчанию – Значение по умолчанию, которое будет вызвано при использовании параметра label, при условии, что нет специфичного для товара/формулы значения, чтобы переопределить его на нижней панели 'CustomFieldLink'. В примере Control Center выше мы видим, что это 'SG Systems LLC'.

Из CustomFieldLink:

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

Для этой части мы рассмотрим простой пример набора данных с 3 различными формулами продукта, которые мы можем назначить уже созданному «Распределено по», дав каждому из них уникальное сообщение о распределении. Мы также добавим новую группу пользовательских полей под названием «Инструкции по подготовке» с параметром метки «ПРИГОТОВЛЕНИЕ».

Итак, мы добавим в систему следующие данные:

• P006:
  • Распространяется: ABC-дистрибуция.
  • Инструкции по подготовке: Перед использованием вымыть.
• P007:
  • Распространяется: Дистрибьюторы Дэйва
  • Инструкции по подготовке: Перед использованием вымыть.
• P008:
  • Распространяется: Дистрибуция SGS.
  • Инструкции по подготовке: Перед использованием вымыть.

Импорт конечной точки/URI «CustomFieldLink» –

http://host:port/V5-API/api/integrate/import/custom_field_link

Описание конечной точки

Образцы:

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

Итак, обратите внимание, что, поскольку мы создавали группу «Инструкции по подготовке», нам нужно было включить параметр метки в этот импорт. Для группы «Распределено по» нам это не нужно, и мы можем просто сослаться на имя группы в нашем импорте.

Этот образец файла JSON можно загрузить здесь.

И как только мы разместим это в системе, мы увидим, что наши примеры формул были добавлены в группу «Распределено» с их уникальным сообщением в столбце «Данные» нижней панели:

И мы также видим, что наша новая группа была создана с одинаковыми «Инструкциями по подготовке» для всех 3 из них:

Для импорта CSV нам сначала необходимо создать заголовочный файл для нашего импорта.

Имя файла определения заголовка/столбца: «customFieldLink.csvh»

Готовые заголовочные файлы должны быть размещены в: “ \SG Control Center\gateway\import\column_defs”

Импортировать имя файла CSV: «customFieldLink-datetime.csv»

CSV для импорта должны быть размещены в: “ \SG Control Center\шлюз\импорт»

Образцы:

Заголовочный файл:

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

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

Файл импорта CSV:

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

Этот пример файла импорта можно загрузить здесь.

В отличие от импорта JSON, из-за механизма импорта CSV в этом случае нам необходимо включить параметр метки «DIST» для группы «Распределено».

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

А также: