База знаний / Настройки
Создано: 08.07.2020

Как создать свое поле с типом «Список (внешний источник)»

В S2 CRM появился новый тип поля «Список (внешний источник)». Поле выглядит и работает как обычный список, однако пункты не приходится добавлять в настройки CRM руками — они автоматически загружаются и обновляются из указанного вами источника.

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

Обратите внимание:

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

Если у вас уже есть ссылка на ваш JSON файл, можно перейти к настройке поля на стороне CRM. Если ссылки нет, то для проверки работы поля, вы можете воспользоваться нашим тестовым JSON файлом, который мы разместили у себя на сервере.

Перейдите в Настройки и выберите раздел, для которого нужно создать поле. Нажмите Дополнительные поля — +. Установите для поля название. В Тип поля выберите Список (внешний источник).

Заполните обязательные и дополнительные поля для обмена данными. 
Обязательные поля:

  1. Ссылка (URL источника). Указывается ссылка на JSON файл. Используйте свой URL или тот, что мы предложили для теста;

  2. Ключ описания. Поле для названий вариантов из списка. В нашем примере названиям присвоен ключ «name»;

  3. Ключ значения. Поле для значений, которые присваиваются данным в выпадающем списке. Для нашего примера мы использовали ключ «value».

Дополнительные поля:

  1. Json путь. Если вы работаете с JSON-файлом, имеющим несколько уровней вложенности и значения, которые вы хотите загрузить, находятся на втором или более уровне, укажите корректный путь к данным. В нашем случае доступ к данным осуществляется по ключу «colors»; 

  2. Ключ цвета. Поле для присвоения цветов элементам списка. Мы не устанавливали вариантам списка цвета, поэтому оставляем поле пустым; 

  3. Логин и пароль. Поля заполняются, если приложение, которое отдает результат в виде JSON файла, требует аутентификации. Мы в своем примере аутентификацию не использовали, поэтому оставляем поля пустыми.

Нажмите Создать. Поле Список (внешний источник) настроено и готово к использованию. Осталось включить его отображение в таблице раздела и карточке объекта. 

В таблице раздела нажмите  … — Видимость колонок и установите галочку в пункте с названием вашего поля.

В карточке объекта нажмите на иконку настроек и установите галочку в пункте с названием вашего поля. 

Обратите внимание: максимально в одном списке можно вывести 100 значений для отображения, 101 и последующие значения можно отобразить только с помощью поиска в поле