Описание
Импортировать коллекцию объектов из файла с заданным именем.
Определение
| Visual Basic |
|---|
Public Function ImportObjects( _ ByVal FileName As String, _ ByVal rootForImport As TDMSObject, _ ByVal Mode As Variant _ ) As TDMSObjects |
Параметры
- FileName
Полное имя файла (должен иметь расширение *.dat), содержащего коллекцию объектов для импорта.
- rootForImport
- Mode
- Режим замены объектов при совпадении GUID.
Заметки
1. Файл импорта имеет расширение *.dat и содержит некоторый набор объектов, ранее экспортированных из базы данных TDMS (с составом, файлами и ролями или без них). Импорт выполняется в указанный раздел Дерева объектов TDMS.
2. При выполнении импорта может оказаться, что уникальные идентификаторы (GUID) некоторых объектов совпадают с уже существующими в текущей настройке. В таком случае возможны варианты - пропуск, замена, создание версии или создание новых объектов; данная настройка выполнения импорта задается константой TDMSReplaceMode.
3. Перед выполнением импорта необходимо убедиться что типы импортируемых объектов определены в настройке. Если хотя бы один их типов не существует (даже для объектов состава), импорт будет отменен с выдачей сообщения об ошибке. Ни одного объекта из файла импортировано фактически не будет.
4. Если роли, назначенные для импортируемых объектов, не определены в настройке, импорт будет выполнен без сообщения об ошибке, однако информация будет потеряна. Таким образом, перед выполнением импорта желательно убедиться, что все требуемые для импортируемых объектов роли существуют в настройке.
5. Если файлы импортируемых объектов не найдены в процессе импорта (папка с файлами, принадлежащими импортируемым объектам, была перемещена или удалена), то импорт будет выполнен с выдачей сообщения для каждого "потерянного" файла. Объекты будут созданы, однако информация об их файловом составе будет утрачена.
6. Операция импорта может быть также выполнена через пользовательский интерфейс (Файл -> Импорт... -> Импорт объектов). Единственное отличие состоит в том, что при выполнении операции через интерфейс можно импортировать объекты из файла выборочно.
7. По окончаниии импорта генерируется последовательность событий Object_Imported для каждого из импортированных объектов, затем событие Import_Completed.
8. Вызывать метод могут только администраторы TDMS и системный администратор.