Загрузка клиентов из файла CSV
Примечание
Если у вас уже подготовлен файл загрузки данных в формате CSV, то переходите к разделу ниже «Загрузка (импорт) клиентов».
Если у вас имеется список клиентов, например, в какой-либо учетной системе, или файле Excel, то можно загрузить этих клиентов в веб-сервис «Точки СВ». Для этих целей нужно предварительно подготовить файл загрузки данных в формате CSV.
Формат файла CSV
Имеется возможность загружать клиентов (импортировать) в веб-сервис «Точки СВ» из файла в формате CSV. CSV — это текстовый файл, описывающий табличные данные в виде строк с символами-разделителями. Описание формата CSV можно посмотреть в этой статьеopen in new window. Важно, чтобы файл CSV был в кодировкеopen in new window UTF-8 или UTF-16. Формат CSV поддерживается следующими программным обеспечением (ПО):
- Microsoft Excel;
- Google Таблицы — рекомендуется использовать именно это ПО.
Рекомендуется использовать именно Google Таблицы, т.к. это ПО при экспорте в формат CSV выгружает файл сразу в кодировке UTF-8.
Предупреждение
Не рекомендуется использовать ПО Microsoft Excel для выгрузки файлов в формат CSV, т.к. оно выгружает файл в устаревшей кодировке Win-1251. Т.е. такой файл потребуется дополнительно конвертировать в кодировку UTF-8 или UTF-16.
Структура CSV-файла загрузки клиентов
CSV-файл загрузки клиентов состоит из значений в следующей последовательности. Обратите внимание на примеры значений — они выполнены по правилам описания значений в формате CSV:
- Разделителем значений колонок является символ запятой (,).
- Значения, содержащие зарезервированные символы (двойная кавычка и запятая, новая строка) обрамляются двойными кавычками ("). Если в значении встречаются кавычки — они представляются в файле в виде двух кавычек подряд.
N | Название колонки | Описание | Пример значения |
---|---|---|---|
1. | ID | Идентификатор клиента в формате UUIDopen in new window (может быть пустым). | 123e4567-e89b-12d3-a456-426655443322 |
2. | NAME | Название клиента. | Магазин ""Продукты 24"" |
3. | COMMENTS | Описание клиента (может быть пустым). | Розничные продажи |
4. | ADDRESS | Адрес клиента. | "Москва, ул. Онежская 19" |
5. | PHONE | Контактные телефоны. | "+7 999 000-00-00, +7 999 000-00-01" |
6. | LATITUDE | Широта (может быть пустым). | 55.852283 |
7. | LONGITUDE | Долгота (может быть пустым). | 37.518407 |
8. | RADIUS | Радиус зоны посещения в метрах. | 50 |
9. | SUBDIVISION | Название подразделения, за которым закреплен клиент (может быть пустым). См. после таблицы примечание. | Северный округ (САО) |
10. | LIST | Название списка клиентов (может быть пустым). См. после таблицы примечание. | Список клиентов агента Иванова |
Примечание
Если требуется, чтобы клиент был привязан к нескольким подразделениям или к нескольким спискам, то нужно в CSV-файле этого клиента указать несколько раз с разными названиями подразделений или списков. Или же создать несколько CSV-файлов, например, по одному на каждое подразделение и последовательно эти файлы загрузить.
Предупреждение
Порядок колонок в файле менять нельзя — порядок должен быть указан таким же, как описано в таблице выше.
Если в файле не указано значение в колонке ID, то сервер при загрузке файла сопоставляет клиентов из файла с уже имеющимися на сервере по наименованию (колонка NAME). Если наименования совпадают, то данные такого клиента на сервере обновляются. Если наименования различаются, то клиент загружается на сервер как новый. Но это правило действует только если не указано значение в колонке ID.
При загрузке клиентов с указанными значениями подразделений (параметр в таблице SUBDIVISION) сервер сначала ищет указанное подразделение по названию у себя в базе данных. Если такое подразделение не находится, то оно автоматически создаётся и клиент привязывается к этому подразделению. Аналогичное поведение при указанном значении списков (параметр в таблице LIST).
Данные на сервер из файла всегда загружаются в режиме обновления для однозначных значений клиентов (это все колонки кроме SUBDIVISION и LIST) и в режиме дополнения для списочных значений (колонки SUBDIVISION и LIST). Т.е. если сначала загрузить на сервер клиента со значением SUBDIVISION, например Подразделение N 1
, а после загрузить этого же клиента со значением SUBDIVISION Подразделение N 2
, то клиент будет в итоге привязан к двум подразделениям Подразделение N 1
и Подразделение N 2
.
Пример файла загрузки клиентов
Ниже приводится пример файла загрузки клиентов. После загрузки этого файла на сервер в веб-сервисе появляется 5 клиентов, распределенных по подразделениям «Подразделение Москва» и «Подразделение Подольск». При этом дополнительно внутри каждого подразделения создаются списки клиентов «Список Розница» и «Список Косметика».
Данный файл можно скачать по этой ссылке: https://takwot.com/files/test/clients.csvopen in new window.
ID,NAME,COMMENTS,ADDRESS,PHONE,LATITUDE,LONGITUDE,RADIUS,SUBDIVISION,LIST
9ABCDFBA-9E94-11E7-80E8-0014D1110CD1,"Магазин ""Мастер ремонта"" ИП Востриков",Стройматериалы в розницу,"г. Москва, ул. Онежская 19",+7 988 000-00-01,55.852283,37.518407,50,Подразделение Москва,Список Розница
F51BECE0-67BD-11E8-80E4-0014D1110CD2,"Магазин ""Большой ремонт""",Стройматериалы в розницу,"г. Москва, Ковров переулок 8",+7 988 000-00-02,,,50,Подразделение Москва,Список Розница
AB403468-FFD8-11E6-80E2-0014D1110CD3,"ТК ""Сибирь"", ООО ""Стройкомплект"", Вольский",Стройматериалы оптом,"г. Подольск, Рабочая ул. 26",+7 988 000-00-03,55.434114,37.558823,50,Подразделение Подольск,Список Розница
E4EEF013-D610-11E5-80D4-0014D1110CD4,"Магазин ""Мастер ОК"", ИП Кошкина",Стройматериалы в розницу,"г. Подольск, ул. Дружбы 17",,55.429777,37.557691,50,Подразделение Подольск,Список Розница
70EF791E-F4DB-11E6-80E2-0014D1110CD5,"Магазин ""Альянс Косметик"", Давыдов",,"г. Москва, ул. Покровка 48",,55.763295,37.654817,50,Подразделение Москва,Список Косметика
2
3
4
5
6
Строка в заголовками в CSV-файле (ID, NAME и т.д.) может отсутствовать, но значения должны быть указаны обязательно в том порядке, как они указаны в таблице выше.
Загрузка (импорт) клиентов из файла CSV
Формат CSV
Описание формата CSV смотрите выше.
Чтобы начать загрузку клиентов из файла CSV нужно:
1. Открыть справочник клиентов.
2. В открывшемся окне нажать на кнопку «Создать клиента»:
3. Далее в открывшемся окне создания клиента нажать на кнопку «Создать массово из csv-файла»:
4. В открывшемся окне нажмите на кнопку «Выберите файл» и затем выберите подготовленный CSV-файл. После этого у вас в нижней части окна будут выведены клиенты из выбранного файла:
5. Убедитесь, что в окне показаны корректные данные (идентификаторы клиентов не показываются для удобства просмотра). Выберите один из вариантов обработки конфликтов — когда загружаемые клиенты уже частично или полностью есть в базе данных на сервере:
- Отменить всю транзакцию — загрузка файла будет полностью отменена как только будет обнаружен такой же клиент в базе данных.
- Пропускать — уже имеющиеся в базе данных клиенты не будут обновляться данными из файла.
- Обновлять — уже имеющиеся в базе данных клиенты будут обновляться новыми данными из файла.
После выбора подходящего варианта нажмите на кнопку «Загрузить».
По завершении корректной загрузки данных будет показано сообщение:
Если же произошли какие-либо какие-либо ошибки при загрузке файла будет показано окно с информацией об ошибке.
Нажав на кнопку «Подробно» в этом окне можно увидеть более подробное описание ошибки. Например, такая ошибка выводится, если в файле был указан идентификатор клиента в неправильном формате: