Импорт и экспорт данных

Импорт файла

В приложение на платформе можно импортировать файлы. Для этого используется структура FileUpload из папки System.

Импорт данных из файла

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

  1. Создать структуру с полями, соответствующими заголовкам столбцов в файле.

  2. Перейти в структуру, нажать кнопку импорт.

  3. Настроить параметры импорта и загрузить файл.

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

При отсутствии колонки 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_IMPORT_ALL_DATA.

Её нет при создании приложения и для переноса данных (именно данных структур, а не их названий, сценариев и других сущностей) требуется её создать.

Экспортируются данные с помощью кнопки "Экспорт", по завершению операции будет предложено скачать архивный файл формата _export_1548331376583.zip.

Для импорта данных в другом приложении требуется также создать структуру EXPORT_IMPORT_ALL_DATA. И в ней по кнопке "Импорт" выбираем созданный ранее архив, загружаем, и данные перенесены!