В структурированном представлении (EXPORT, IMPORT)
Этот оператор создает действие, которое открывает форму в структурированном представлении.
Формат
В этом операторе можно задать формат, в который будут преобразованы данные формы : XML, JSON, DBF, CSV, XLS, после чего сформированный файл(ы) в этом формате записывается в заданное свойство.
Экспорт формы является общим случаем оператора экспорта данных.
Импорт формы
Импорт формы - операция обратная открытию формы в структурированном представлении. Оператор импорта принимает на вход файл(ы) в структурированном формате, после чего разбирает его (их) и записывает полученные данные в свойства заданной формы, таким образом, чтобы при экспорте этой формы назад в импор тируемый формат получить исходный файл.
Так как оператор импорта это по сути "оператор ввода", на импортируемую форму накладываются следующие ограничения:
-
Все объекты формы должны быть числовых или конкретных пользовательских классов, причем группы объектов должны состоять ровно из одного объекта (это ограничение вытекает из того что все используемые форматы это по сути списки, то есть отображения чисел на значения).
-
Свойства на форме и фильтры должны иметь возможность изменения на заданное значение (то есть, как правило, быть первичными). Перед импортом все существующие изменения импортируемых свойств в текущей сессии отменяются.
Фильтры при импорте изменяются на значения по умолчанию классов значений этих фильтров.
При импорте данных в объекты числовых классов используется 0-based нумерация, причем в иерархичных форматах она "сквозная" (то есть когда импорт ируемая группа объектов встречается второй и последующий разы, нумерация объектов в ней начинается с того числа, на котором закончилась предыдущая).
При импорте из XLS и CSV без заголовков (с опцией NOHEADER
), платформа пытается автоматически преобразовать данные к требуемому типу. Если это не удается, в свойство записывается значение NULL
. Импорты из остальных форматов требуют правильные типы. Например, если при импорте из JSON требуется строка, а в JSON будет число (то есть не будет кавычек), платформа выдаст ошибку.
Если при импорте свойство (группа объектов) не найдено, оно игнорируется (то есть его значение остается равным NULL
).
Импорт формы является общим случаем оператора импорта данных.
Язык
Синтаксис оператора открытия формы в структурированном представлении описывается оператором EXPORT
. Для импорта формы используется оператор IMPORT
.