added new item for description about data_import

introduction_guide/description.rst

@@ -145,3 +145,68 @@ Cправочник "Стадии договора"
 .. _`Почему в фильтрах отображаются не все поля карточки?`: faq.html#id9
 
 .. _`Я добавил новое поле в карточку, а оно не отображается в фильтрах. Почему?`: faq.html#id11
+
+Импорт данных
+~~~~~~~~~~~~~~~
+
+Функция импорта, реализованная в продукте, универсальная и позволяет 
+загружать данные из Excel в любой реестр Synergy.
+
+Импорт работает со следующими компонентами формы:
+
+* текстовые однострочные и многострочные поля;
+* числовые поля;
+* дата/время;
+* справочники (выпадающий список, выбор вариантов, переключатель 
+  вариантов);
+* ссылка на реестр.
+
+Требования к файлу Excel:
+
+#. Формат файла: ``*.xls``.
+#. Первая строка файла - заголовки; далее - строки для импорта в 
+   записи реестра.
+
+   .. note:: 1 строка в Excel = 1 запись реестра.
+
+#. Столбцы, которые **не нужно** импортировать обозначить заголовком 
+   ``no``.
+#. Остальные заголовки должны содержать в себе точный код поля 
+   формы (например, ``crm_form_account_main_adress``).
+#. Для корректного импорта чисел значение поля в файле должно быть 
+   в числовом формате.
+#. Для корректного импорта дат значение поля в файле должно быть 
+   в формате даты.
+#. Для корректного импорта справочников значение поля в файле должно 
+   точь-в-точь совпадать с его "наименованием" у справочника.
+#. Для корректного импорта нескольких значений в компонент выбора 
+   вариантов (чекбокс) в файле их нужно прописать в одной ячейке 
+   через ``;`` с пробелом.
+#. Желательно избегать содержания в файле спец.символов json: ``"``, 
+   ``\``, ``\b``, ``\t`` и т.д.
+
+Использование:
+
+#. Заполнить код формы и код реестра, в который будет проводиться 
+   импорт. Коды можно взять в конфигураторе.
+#. Заполнить логин и пароль пользоваться, от имени которого будут 
+   выполняться все запросы. Пользователь должен иметь права на все 
+   реестры (куда происходит импорт и если в файле имеются ссылки на 
+   прочие реестры).
+#. Если импортируемые записи необходимо запустить по маршруту, 
+   требуется поставить галочку "Активировать импортированные записи".
+#. Если присутсвуют ссылки на реестр **обязательно** нужно заполнить 
+   поле для поиска в формате:
+
+   ``(код компонента на форме, куда производится импорт):(код компонента на форме, на которую указывает компонент ссылки на реестр, по которому должен производится поиск)``
+
+   Для каждой ссылки на реестр необходимо через запятую с пробелом 
+   необходимо указать подобные пары.
+#. При поиске записей для ссылок на реестр может найтись несколько 
+   записей реестра. Укажите в соотвествующем пункте действия на этот 
+   случай. Если не найдена ни одна запись, значение останется пустым.
+#. Выберите заранее подготовленный файл ``*.xls`` и нажмите на кнопку 
+   "Импортировать". Импорт начнет в нескольких потоках обрабатывать 
+   переданные записи. Следить за процессом можно через логи системы 
+   Synergy.
+