Документация для разработчиков
Недоступно в редакциях: Стандарт, Старт

Импорт местоположений

В этом разделе

  • Закладка "Импорт местоположений"
  • Закладка "Очистить список местоположений"
  • Пример файла для загрузки местоположений
  • Важно! Если вы используете старую схему местоположений, то описание страницы импорта смотрите здесь.

    Страница Импорт местоположений (Магазин > Настройки > Местоположения > Импорт местоположений) предназначена для импорта местоположений, а также для быстрой очистки всего списка местоположений.

    Закладка "Импорт местоположений"

    ПолеОписание
    Выбор источника местоположений
    Источник местоположенийВыбирается источник загрузки местоположений:
    • с удаленного сервера - при этом необходимо отметить нужные вам страны для загрузки;
    • из файла - следует указать файл с помощью кнопки Добавить файл, а также заранее вручную должны быть созданы необходимые типы местоположений и внешние сервисы.
    Выбор дополнительных данных
    *Почтовые индексы (ZIP-коды)При отмеченной опции в систему будет добавлен внешний сервис ZIP (если он не был добавлен ранее) и будут загружены почтовые индексы для местоположений.
    *Коды Яндекс.МаркетПри отмеченной опции в систему будет добавлен внешний сервис YAMARKET (если он не был добавлен ранее) и будут загружены коды Яндекс.Маркет для местоположений.
    Выбор параметров импорта местоположений
    *Загружать местоположения доУказывается до какого включительно типа местоположений загружать местоположения стран в систему.
    *Набор местоположенийВыбирается набор местоположений, который нужно загрузить:
    • стандартный - только крупные регионы и города России;
    • расширенный - полный импорт с учетом мелким городов, сел и т.д.
    *Не загружать округаПри отмеченной опции местоположения типа Округ не будут загружаться в систему. Таким образом, местоложения типа Область будут дочерними непосредственно для местоположений типа Страна.
    Удалить все существующие местоположенияПри отмеченной опции все существующие местоположения будут удалены.
    Длина шага, секундыУказывается длина одного шага загрузки местоположений в секундах.
    *Поддерживать структурную целостностьПри отмеченной опции будет поддерживаться структурная целостность местоположений. Таким образом, если некоторое местоположение А уже есть в системе, а затем импортируется более крупное по отношению к нему местоположение Б, то автоматически имеющееся местоположение А будет привязано к новому местоположению Б.
    Кнопка Начать импорт
    Кнопка служит для запуска процесса импорта местоположений в систему.

    * - данные параметры доступны только при загрузке местоположений с сервера.


    Закладка "Очистить список местоположений"

    Расположенная на закладке кнопка Удаление всех местоположений служит для очистки всей базы местоположений из системы.


    Пример файла для загрузки местоположений

    Важно! Файл должен быть создан в кодировке UTF-8.

    CODE;PARENT_CODE;TYPE_CODE;NAME.RU.NAME;EXT.YAMARKET.0;EXT.ZIP.0
    kl00001;;REGION;Калининградская область;10857;
    kl00011;kl00001;CITY;Калининград;22;236020
    kl00021;kl00001;SUBREGION;Гусевский район;;
    kl00022;kl00021;CITY;Гусев;20138;238050
    kl00031;kl00001;SUBREGION;Балтийский район;;
    kl00032;kl00031;CITY;Приморск;20578;238510
    kl00033;kl00031;CITY;Балтийск;10858;238520
    kl00041;kl00001;SUBREGION;Зеленоградский район;;
    kl00042;kl00041;CITY;Зеленоградск;20139;238326
    kl00051;kl00001;SUBREGION;Краснознаменский район;;
    kl00052;kl00051;CITY;Краснознаменск;20140;238730
    kl00061;kl00001;SUBREGION;Неманский район;;
    kl00062;kl00061;CITY;Неман;20141;238710
    kl00071;kl00001;SUBREGION;Гвардейский район;;
    kl00072;kl00071;CITY;Неман;20136;238210
    kl00081;kl00001;SUBREGION;Багратионовский район;;
    kl00082;kl00081;CITY;Багратионовск;20135;238420

    В первой строке указываются названия колонок. Первые три колонки являются обязательными. Первая колонка - CODE - символьный код местоположения, затем идет колонка PARENT_CODE - символьный код родительского местоположения. Следующая колонка - TYPE_CODE - тип местоположения.

    Примечание: необходимые типы местоположений должны быть созданы заранеее.

    Следующие колонки - это колонки NAME.LANG.NAME с названием местоположения для языка LANG (где LANG - это идентификатор языка в системе). В файле обязательно должна быть колонка NAME.RU.NAME, а колонки для остальных языков интерфейса задавать не обязательно (названия для других языков будут сгенерированы автоматически).

    Затем идут колонки для созданных в системе внешних сервисов - EXT.CODE.N, где CODE - код внешнего сервиса, а N - номер колонки (нумерация начинается с нуля) для значения внешнего сервиса с кодом CODE (для местоположения может быть задано несколько значений каждого внешнего сервиса).

    В остальных строках файла указываются значения загружаемых данных.


    Смотрите также



    Пользовательские комментарии

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

    Для этого нужно всего лишь авторизоваться на сайте

    Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

    Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
    © «Битрикс», 2001-2019, «1С-Битрикс», 2019
    Наверх