Импорт и экспорт данных
В приложение на платформе можно импортировать файлы. Для этого используется структура FileUpload из папки System.
Предусмотрена возможность импортировать данные в структуру из табличного файла. Необходимо сделать следующее:
Создать структуру с полями, соответствующими заголовкам столбцов в файле.
Перейти в структуру, нажать кнопку импорт.
Настроить параметры импорта и загрузить файл.
После загрузки появится сообщение о количестве созданных и обновленных объектов.
При отсутствии колонки ID, он будет сгенерирован автоматически. При необходимости его можно указать в импортируемом файле.
Источник данных. Можно выбрать .csv файл, либо вставить данные из буфера данных (в таком случае появляется поле для ввода)
Разделитель полей. Между полями может быть выставлены символы: ";", "\t", ",", "|".
Формат даты. Все форматы указаны далее по тексту в этой главе.
Послать событие после импорта.
Приоритет. По умолчанию установлена галочка "низкий", чтобы не создавать излишнюю нагрузку на платформу. Процесс закрузки объектов идёт медленнее.
Валидация данных. При импорте можно проводить валидацию на соответствие типов данных.
Помимо визуальной составляющей, в окне импорта есть ссылка на объект системной структуры ImportInformation, который создаётся автоматически с началом загрузки данных. Там указано состояние счётчиков, статус процесса.
Из структуры можно экспортировать как все данные, так и выборочные объекты. При выгрузке всей структуры стоит обратить внимание на колчество выгружаемых строк. По умолчанию это 10000 объектов и если у вас их больше, то выгрузятся не все. Этот параметр позволяет ускорить процесс экспорта.
Галочка "No limit" снимает ограничение на выгрузку. Предусмотрена выгрузка в двух форматах .csv и .xls.
Обратите внимание
В редакторах таблиц, таких как Excel развита собственная система форматирования данных. Так, например, при открытии в экселе файла с массивом [-1,-2,-3,-4], вы увидите число -10. Чтобы корректно открыть файл с данными в Excel, используйте вкладку Данные — Импортировать csv (если вы экспортировали данные из структуры в csv формате).
Для импорта дат, формат которых отличается от принятого в платформе, предусмотрена возможность задать маску этих дат в поле "Формат даты".
Чтобы импортировать дату 25/12/2019, необходимо указать маску dd/MM/y
Все принятые обозначения в таблице ниже:
Символ | Значение | Тип | Маска | Пример |
G | Эра | Текст | G.dd.MM.yyyy | AD.31.12.1999 |
C | Век эры (>=0) | Число | CC.dd.MM.yyyy | 20.31.12.1909 |
Y | Год эры (>=0) | Год | Y | 1996 |
w | Номер недели в году | Число | ww | 27 |
e | День недели | Число | e | 2 |
E | День недели | Текст | E | Tuesday; Tue |
y | Год | Год | y | 1996 |
D | День в году | Число | D | 189 |
M | Месяц в году | Месяц | MMMM MM | July 07 |
d | День месяца | Число | dd | 31 |
a | Половина дня | Текст | a a | AM PM |
H | Час дня (0~23) | Число | H | 0 |
k | Часы дня (1~24) | Число | kk | 23 |
m | Минута | Число | mm | 36 |
s | Секунда | Число | ss | 25 |
S | Доля секунды | Число | SSS | 783 |
z | Временная зона | Текст | z | Pacific Standard Time; PST |
Z | Cмещение часового пояса / идентификатор | Зона | Z | -0800; -08:00; America/Los_Angeles |
' | Выход из режима текста | Ограничитель | | |
'' | Кавычка | Литера | ' | |
Часто используемый механизм переноса данных между приложениями — структура EXPORT_IMPORT_ALL_DATA.
Её нет при создании приложения и для переноса данных (именно данных структур, а не их названий, сценариев и других сущностей) требуется её создать.
Экспортируются данные с помощью кнопки "Экспорт", по завершению операции будет предложено скачать архивный файл формата _export_1548331376583.zip.
Для импорта данных в другом приложении требуется также создать структуру EXPORT_IMPORT_ALL_DATA. И в ней по кнопке "Импорт" выбираем созданный ранее архив, загружаем, и данные перенесены!
