Введение

Очень часто возникает необходимость уже имеющиеся данные о клиентах загрузить в базу R-Keeper CRM с целью их дальнейшего использования.

Для этих целей используется программа импорта TXT_to_CRM.exe.  Данная утилита позволяет импортировать данные из подготовленного файла (txt/csv) базу R-Keeper CRM.

Файл TXT_to_CRM можно скачать с FTP-сервера по адресу ftp://ftp.ucs.ru/R-Keeper.CRM/other/TXT_to_CRM7.zip

Внимание! Рекомендуем конвертер(TXT_to_CRM.exe) копировать в выделенную папку на диске либо папку дистрибутива \\R-Keeper CRM\Database\DataMigration\FileToCS5\. При копировании  на рабочий стол возможны проблемы с работой!

Подготовка файла

В импортируемом файле первой строкой обязательно должна идти строка формата данных, содержащая перечисление параметров и символ-разделитель ";", например:

Client_Name;Card_Code_EM_Marin;Summ_1;Summ_2;Group_Name
TEXT

означает, что разделителем параметров будет являться ";" и параметры идут в следующем порядке:
1 - имя клиента
2 - номер карты в формате Card_Code_EM_Marin
3 - сумма для 1 счета
4 - сумма для 2 счета
5 - название группы, в которую перенесутся карты и владельцы карт
В заголовке импортируемого файла предусматривается работа со следующими параметрами:

  • CLIENT_NAME;
  • CLIENT_NAME_F;
  • CLIENT_NAME_M;
  • CLIENT_NAME_L;
  • CARD_CODE;
  • CARD_CODE_EM_MARIN;
  • CARD_CODE_HEX;
  • CARD_STATUS;
  • CARD_OFFERED;
  • CARD_EXPIRED;
  • DISPATCH;
  • EXTERNAL_CODE;
  • SOURCE;
  • NOTES;
  • BIRTHDAY;
  • TEL_1;
  • TEL_2;
  • ADDRESS;
  • COUNTRY;
  • CITY;
  • STREET;
  • HOUSE;
  • ENTRY;
  • FLOOR;
  • APARTMENTS;
  • ENTRY_CODE;
  • DOPINFO;
  • BUILDING;
  • EMAIL;
  • SUMM_1;
  • SUMM_2;
  • SUMM_3;
  • SUMM_4;
  • SUMM_5;
  • SUMM_6;
  • GROUP_NAME;
  • CARRIER_DATA;
  • PASSWORD;
  • COMMENT;
  • GENDER

Адресная часть:

  • COUNTRY;
  • CITY;
  • STREET;
  • HOUSE;
  • ENTRY;
  • FLOOR;
  • APARTMENTS;
  • ENTRY_CODE;

  • BUILDING

    Важно!

    Если необходимо заполнить адрес в карте клиента, то поля адреса должны быть обязательно с цифровым суффиксом: COUNTRY1;CITY1;STREET1;HOUSE1

    Суффикс может быть от 1 до 20, т.е. максимум 20 строк адресов.

    Например, для импорта адреса № 14 необходимо записать наименования полей как: COUNTRY14;CITY14;STREET14;HOUSE14;ENTRY14;FLOOR14;APARTMENTS14;ENTRY_CODE14;BUILDING14.

Описание параметров

CLIENT_NAME - полное имя клиента
CLIENT_NAME_F - имя клиента
CLIENT_NAME_M - отчество клиента
CLIENT_NAME_L - фамилия клиента
GENDER - пол. В файле загрузки необходимо использовать М \ Ж
CARRIER_DATA - информация о магнитной ленте
TEL_1 - номер 1 телефона 
TEL_2 - номер 2 телефона 
ADDRESS - адрес, адрес заносится обычной строкой (формат произвольный) в список контактов
EMAIL - EMail
EXTERNAL_CODE - внешний код (20 символов), должен быть задан у владельца, для осуществления перепривязки ему указанной карты
COMMENT - комментарий к операции начисления на счет
BIRTHDAY - день рождения (YYYY-MM-DD)
NOTES - дополнительная информация (255 символов)
SOURCE - источник (60 символов)
SUMM_1 - сумма, которая будет перенесена в созданный счет (тип счет "SUMM1")
SUMM_2 - сумма, которая будет перенесена в созданный счет (тип счет "SUMM2")
SUMM_3 - сумма, которая будет перенесена в созданный счет (тип счет "SUMM3")
SUMM_4 - сумма, которая будет перенесена в созданный счет (тип счет "SUMM4")
SUMM_5 - сумма, которая будет перенесена в созданный счет (тип счет "SUMM5")
SUMM_6 - сумма, которая будет перенесена в созданный счет (тип счет "SUMM6")
COMMENT - комментарий к транзакции
GROUP_NAME - название группы (с таким названием в карточной системе будут созданы группа карт и группа владельцев)
CITY - город
DISPATCH - контакт подписан на рассылку (чекбокс на закладке "Контакты" в профиле владельца)
CARD_OFFERED - дата выдачи карты
CARD_EXPIRED - дата окончание действия карты
CARD_CODE_HEX - номер карты в hex
CARD_CODE - номер карты (Int64)
CARD_CODE_EM_MARIN - номер карты в формате EM-Marin (123.45678)
PASSWORD - пароль карты
CARD_STATUS - статус карты (есть mapping в Config.ini)

Есть возможность конвертации статуса карты, для чего в Config.ini нужно добавить секцию:

[Card_Status]
;оригинал=статус карты в CRM (1 - активна; 2 - неактивна; 4 - заблокирована)
1=1
0=2
2=4

Ограничение на поля TEL_1, TEL_2, ADDRESS и EMAIL - 255 символов

Поля расположенные в профиле владельца на вкладке Адреса:
COUNTRY - страна
CITY - город
STREET - улица
HOUSE - дом
BUILDING - строение/корпус
APARTMENT - квартира
ENTRY_CODE - код домофона
DOPINFO - поле "Дополнительно" на вкладке "Адрес" в профиле владельца.
FLOOR - этаж

Фрагмент содержимого файла test_import.txt:

Client_Name;Card_Code;TEL_1;TEL_2;EMAIL;ADDRESS;Summ_1;Summ_2;Group_Name
Тест Тест Тест;150;84951112231;89261112233;mail@mail.ru;г.Москва,ул.Почтовая,20;1000;2000;niama
<..>.
TEXT

Настройки в r_keeper CRM

Настройки касаются справочной информации, которую необходимо ввести в Редакторе карт.

Проверить и отредактировать при необходимости следующие справочники:

  • - типы счетов (пункт меню Справочники > Типы счетов);
  • - типы неплательщиков (пункт меню Справочники > Типы неплательщиков);
  • - типы контактов (пункт меню Справочники > Типы контактов). Адрес при импорте будет импортироваться в один из созданных типов контактов, например Адрес;
  • - желательно использовать отдельный классификатор ПО для выгрузки; к данному классификатору ПО привязать типы счетов с разрешением операций начисления/списания.

Запуск TXT_to_CRM.exe

Есть 2 вида запуска программы:

  • В простом режиме

  • В режиме запуска с параметрами

1. Запуск программы в простом режиме

При запуске программы в простом режиме - без каких-либо параметров, возможность перепривязки карт и автоматического импорта отсутствует, что дает защиту от случайных нежелательных действий.  В простом режиме доступно только редактирование данных владельцев карт.

Для запуска программы в простом режиме, необходимо просто запустить TXT_to_CRM.exe.

2. Запуск программы с параметрами

2.1 Запуск с ключом  /TRANSFER

Дает возможность запуска программы в режиме перепривязки карт от одного владельца к другому, для этого в текстовом файле должно быть заполнено поле EXTERNAL_CODE;
После запуска с данным параметром выдается два предупредительных сообщения (см. рис. 2 и рис. 3) и только в случае положительного ответа на оба, утилита запускается в режиме перепривязки карт. Только в данном режиме будет доступно поле Идентификатором является (см. рис. 4, п.4).


2.2 Запуск с  ключом /AUTO

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

При автоматической загрузке используются настройки из файла Config.ini. Файл создается после сохранения настроек конфигурации в программе, запущенной без ключа /AUTO.

Примечание

Примечание: для сохранения настроек в файл необходимо запустить программу без ключа /AUTO, настроить параметры конфигурации и сохранить настройки - кнопка Config save. В дальнейшем для загрузки данные будут браться из файла, указанного в Config.ini в параметре File_Name. 

2.3 Запуск с ключом /SAVECARDTOCARRIERDATA или /SC2CD

Запуская  программу с параметром /SAVECARDTOCARRIERDATA или /SC2CD, программа перед обработкой номера карты, копирует его (номер карты) в поле CARRIER_DATA. При этом значение из импортируемого файла в поле CARRIER_DATA игнорируется.

Настройка параметров импорта в TXT_to_CRM.exe

Рис.4

 Описание основных функциональных элементов (согласно рис.4):

(1) Позволяет выбрать  загружаемый файл импорта данных, указать ip адрес и порт подключения запущенного сервера авторизации, а так же указать классификатор ПО, настроенный для импорта в редакторе CRM. Файл должен иметь структуру согласно п.2

(2) Кнопки Config load / Config save используются для сохранения и загрузки конфигурации из файла(config.ini).

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

После редактирования всех доступных параметров сохраняем их в файл нажатием на кнопку Config save (будет создан файл Config.ini).

(3) Управляющий элемент, позволяющий задать группу CRM, куда будет произведен импорт данных.

(4) Управляющий элемент, доступный в режиме работы программы  с ключом  /Transfer (см.п.4.2.1), позволяющий задать идентификатор, для  перепривязки нужно выбрать внешний код владельца (external_code).

(5) Список типов счетов CRM на которые будет происходить импорт сумм из загруженного файла. Для каждого типа счета есть возможность установки флага обнуления  перед импортом суммы и флага включения свойства автоперехода.

После задания всех необходимых параметров, процесс переноса данных запускается нажатием кнопки Import data, а ход выполнения отображается в строке прогресса.

Примечание

Примечание: в последних версиях появилась возможность выбора кодировки файла и автосоздание заголовка

Рис. Выбор кодировки файла и использование заголовка