Low-code дизайнер > Управление приложением / Импорт данных

Импорт данных

Инструмент импорта позволяет загружать электронные таблицы Excel и файлы формата .csv в приложения ELMA365. Таким образом вы можете быстро добавить большой объём данных в систему.

начало внимание

По умолчанию загружать данные могут Все пользователи. О том, как ограничить доступ к импорту, читайте в статье «Доступ к данным приложения».

конец внимание 

Вы также можете массово добавить или обновить элементы приложения, используя скрипты. Подробнее об этом читайте в статье «Массовые действия с элементами приложений в скрипте».

Чтобы начать импорт, выполните следующие шаги:

1.  Создайте приложение, в котором будут храниться данные.

Чтобы корректно импортировать данные в приложение, вам нужно добавить на его форму поля, которые могут хранить эти данные. Предположим, вы хотите загрузить в ELMA365 свою клиентскую базу. Данные клиентов хранятся в виде таблицы .xlsx, которая содержит такие столбцы, как название компании, телефон, адрес электронной почты, контактное лицо, реквизиты. Чтобы выполнить импорт, необходимо предварительно создать приложение и добавить на его форму поля соответствующих типов: Строка (для переноса названия), Номер телефона, Электронная почта, ФИО, Текст.

импорт данных 1

Если в импортируемом документе присутствует системное поле Статус, в приложении необходимо настроить статусы.

2. Сгенерируйте шаблон приложения.

Шаблон нужен для того, чтобы привести загружаемый файл в соответствие с требованиями для импорта.

Чтобы загрузить шаблон себе на компьютер, в правом верхнем углу страницы приложения нажмите на значок import и выберите опцию Импорт Данных. В открывшемся окне выберите тип шаблона в зависимости от того, какой файл вы планируете импортировать: .xlsx или .csv.

импорт данных 2

3. Приведите импортируемый файл в соответствие с шаблоном.

Шаблон содержит таблицу, каждый столбец которой соответствует полю приложения. Для каждого столбца приводится пример данных, которые могут в нём содержаться.

импорт данных 3

Вы можете скопировать название столбцов в импортируемый файл либо заполнить шаблон вашими данными. Требования к импортируемым данным приведены в таблице:

Тип поля

Формат данных в шаблоне

Примечание

Пример значения в шаблоне

Название

текст


счёт-фактура

Строка

текст


заказ

Число

целое или дробное число

в формате, предустановленном в столбце шаблона

27.37

Выбор
«да/нет»

true или false

true — истина

false — ложь

Текстовое значение: Включено,
в шаблоне: true

Дата/время

дата и время

в формате, предустановленном в столбце шаблона

04.07.1977 13:27

Категория

текст

значение категории (название, а не код), которое присваивается полю при импорте

Например, категория Способ
доставки имеет три значения: Самовывоз, Курьер и Почта.
Нам нужно импортировать заказ,
который доставляется курьером.
Для этого в шаблоне импорта
в строке с данными заказа
в колонке Способ доставки
следует указать Курьер

Деньги

целое или дробное число


125.6

Учётная запись


импорт не поддерживается


Номер телефона

целое число


89125554433

Электронная почта

текст

в формате имя@домен

name@example.com

Файлы

название файла[идентификатор файла]

импортировать можно только идентификатор файла, загруженного в ELMA365. Он отобразится в адресной строке браузера, если нажать на имя файла

file1[fd2af6d9-3e95-4896-9604-250929347acb]

Изображение

название изображения[идентификатор изображения

импортировать можно только идентификатор изображения, загруженного в ELMA365. Он отобразится в адресной строке браузера, если нажать на имя изображения.

image1[fd2af6d9-3e95-4896-9604-250929347acb]

Ф.И.О.

текст

первое слово интерпретируется как фамилия, второе — как имя, последующие — как отчество

Петров Иван Александрович

Ссылка

текст ссылки


https://elma365.com/ru

Таблица

[{"rows":[{"код столбца":{"код ячейки":"значение ячейки"}}],"result":{"__count":количество строк в таблице},"view":""}]

Строка, где перечисляются все ячейки таблицы с их значениями.

В параметре result укажите количество строк.

Параметр view оставьте без значения. Он заполнится автоматически, если для таблицы настроено представление по шаблону.

Например, запись для таблицы
с колонками Аккаунт и
Имя клиента, состоящей
из двух строк:

[{“rows”:[{“account”:{“login”:“@example”},“name”:{“lastname”:“Петров”,“firstname”:
“Петр”,“middlename”:“Петрович”}},
{“account”:{“login”:“@example1”},
“name”:{“lastname”:“Иванов”,
“firstname”:
“Иван”,“middlename”:“Иванович”}}],
"result":{"__count":2},"view":""}]

Пользователи

[идентификатор пользователя]

чтобы узнать идентификатор пользователя, перейдите в Администрирование > Пользователи и нажмите на учётную запись пользователя. Идентификатор отобразится в адресной строке браузера.

[29cadb73-8246-4f3d-9992-87a4a1ad20cf]

Приложение

[идентификатор элемента приложения]

элемент должен относиться к приложению, с которым связано поле.

[12f05b18-5559-40cb-b138-97b8d0233f4c]

4. Загрузите подготовленный файл с данными в систему.

После того как вы приведёте импортируемый файл в соответствие с шаблоном, вернитесь в интерфейс ELMA365. Нажмите на значок import в правом верхнем углу страницы приложения и выберите опцию Импорт Данных. В открывшемся окне загрузите импортируемый файл.

Также здесь вы можете отметить опцию Игнорировать обработчики событий. Она отключает на время импорта все обработчики событий, настроенные в разделе Администрирование > Модули. Это позволит уменьшить нагрузку на систему, если обработчик срабатывает при добавлении новых элементов, например, выводит уведомления или запускает бизнес-процесс.

Нажмите Импортировать, а затем Закрыть. После этого данные появятся в приложении.

import_gif

Обратите внимание, на скорость импорта влияет количество элементов приложения, а также количество индексов, расположенных в базе данных PostgreSQL. Индексы создаются в БД для каждого свойства приложения, для которого включена опция Поиск и сортировка по полю. Если вы хотите импортировать большой объём данных, рекомендуем включать опцию после переноса приложения.

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

Используя импорт файлов, вы можете обновить данные сразу в нескольких элементах приложений. Для этого экспортируйте файл из существующего приложения, отметив опцию Экспортировать системную информацию, и внесите изменения в значения полей. После этого импортируйте файл обратно в приложение. Все изменённые элементы приложения обновятся.

Обратите внимание, если в системном поле Статус вы укажете идентификатор (status: id), которого нет в приложении, элементу присвоится начальный статус.

import-status

Если вы экспортируете файл без системной информации, при импорте изменённого файла в приложение добавятся новые элементы.

Импорт нескольких значений

Вы можете импортировать несколько значений в одно поле ELMA365. В этом случае следует использовать запятую (,) в качестве разделителя.

начало примера

Пример:

company@example1.com, company@example2.com — позволяет добавить два адреса электронной почты в одно поле.

конец примера

Таким способом можно загрузить данные в поля следующих типов: Число, Категория, Номер телефона, Электронная почта, Ссылка, Пользователи, Приложение.

Возможные ошибки при импорте

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

импорт данных 4

Внесите исправления и продолжите импорт.