Commit 6fdb949b authored by Danir Tlepov's avatar Danir Tlepov

added new item for description about data_import

parent 7c1fd786
......@@ -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.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment