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