123233цв. DIAdem Обработка и анализ данных, генерация отчетов [NI] (2008).. Продукции ni com Штабквартира корпорации National Instruments
 Скачать 1.93 Mb.
|
|
Доступ к объектам в DIAdem NAVIGATOR Объекты в DIAdem NAVIGATOR - внешние хранилища данных, поисковики данных, запросы, результаты поиска, виды браузера и портала данных, а также внутренние данные. В скриптах вы можете генерировать новые объекты и изменять либо удалять существующие. Для доступа к объектам в DIAdem NAVIGATOR используется иерархия объектов. Некоторые подобъекты содержат совокупность одиночных объектов. Вы можете обращаться как к одиночному объекту, так и к совокупности объектов. Используйте утверждение Set, чтобы назначить объекты переменной. Это упрощает доступ к объектам. Объект Navigator – глобальный объект для доступа к внешним хранилищам данных и поисковику данных. Объект Portal - глобальный объект для доступа к виду портала данных. Объект Data - глобальный объект для внутренних данных. Поиск и загрузка внешних данных Используйте объект Navigator для открытия внешних хранилищ данных, для извлечения данных, для загрузки и выбора данных, найденных в результатах поиска и проводнике файлов. Подобъектами объекта Navigator являются внешние хранилища данных, поисковики данных, запросы, результаты поиска и виды браузера. Раздел 6. Автоматизация последовательности действий DIAdem: Система генерации отчетов 91 ni.com В приведенном примере выполняется расширенный поиск групп каналов с именем Weather. Скрипт вводит параметры запроса в интерфейсе DIAdem NAVIGATOR и перечисляет каналы найденных групп каналов на закладке Search Results (Результаты поиска). Dim oMyAdvancedQuery Set oMyAdvancedQuery =_ Navigator.CreateQuery(eAdvancedQuery) Call oMyAdvancedQuery.Conditions._ Add(eSearchChannelGroup,"name", "=", "weather") oMyAdvancedQuery.ReturnType = eSearchChannel Call Navigator.Display.CurrDataProvider._ QueryForm.SetCurrQuery(oMyAdvancedQuery) Call Navigator.Display.CurrDataProvider._ QueryForm.Search() Call WndShow("NAVIGATOR","Open") Чтобы использовать в скрипте быстрый поиск, введите искомый терм в режиме записи DIAdem NAVIGATOR и нажмите NAVIGATOR. Изменение вида портала данных Используйте объект Portal для задания вида портала данных, для отображения групп каналов и выбора каналов. Портал данных можно закрепить у правой границы или перемещать по экрану. Вид структуры и вид списка портала данных – подобъекты объекта Portal. В следующем примере портал данных отображается в виде структуры, а окно свойств уменьшается до 40 процентов от высоты портала данных. После того, как скрипт снимет все выделения, он открывает первую группу каналов для выбора третьего канала в этой группе. Portal.Visible = TRUE Call Portal.Structure.Activate Portal.Ratio = 60 Call Portal.Structure.Selection.RemoveAll Call Portal.Structure._ Expand(Data.Root.ChannelGroups(1)) Call Portal.Structure.Selection._ Add(Data.Root.ChannelGroups(1).Channels(3)) Редактирование внутренних данных Используйте объект Data для редактирования, удаления или воссоздания данных, загруженных в портал данных. Вы можете получать доступ к внутренним данным и их свойствам в скрипте. Вы также можете изменять шаблон для определяемых пользователем свойств или создавать новый шаблон. Наборы данных, группы каналов, каналы, элементы данных, Раздел 6. Автоматизация последовательности действий © National Instruments Ireland Resources Limited 92 DIAdem: Система генерации отчетов свойства и шаблоны для определяемых пользователем свойств являются подобъектами объекта Data. В следующем примере показывается сначала удаление всех данных, загруженных в портал данных, а затем создание группы каналов The MyChnGroup с каналом MyChannel: Dim oMyGrp, oMyChn Call Data.Root.ChannelGroups.RemoveAll Set oMyGrp = Data.Root.ChannelGroups.Add("MyChnGroup") Set oMyChn = oMyGrp.Channels.Add("MyChannel", eR32) Используйте подобъект CustomPropertyTemplate для доступа к шаблону свойств, определяемых пользователем. В следующем примере показано сообщение, создан ли шаблон для свойств, определяемых пользователем: MsgBox(Data.Settings.CustomPropertyTemplate.Active) Доступ к объектам в DIAdem VIEW Главными объектами в DIAdem VIEW являются рабочие листы, области, системы координат, графики, таблицы каналов, видео, трехмерные модели и рисунки. В скриптах вы можете создавать новые объекты и изменять или удалять существующие. Используйте иерархию объектов для доступа к объектам DIAdem VIEW. Глобальный объектом является View, который может включать несколько рабочих листов. Рабочий лист может быть разделен на несколько зон, каждая из которых может содержать систему координат, таблицу каналов, видео, трехмерные модели и рисунки, либо быть пустой. В следующем скрипте удаляются все рабочие листы в DIAdem VIEW и создается новый рабочий лист MySheet. На этом новом рабочем листе скрипт определяет для новой области NewArea двухмерную систему координат и создает в ней график со временем (Time)из канала х и скоростью(Speed) из канала у. Dim oMySheet, oNewArea Call View.Sheets.RemoveAll() Set oMySheet = View.Sheets.Add("NewSheet") Set oNewArea = MySheet.ActiveArea oNewArea.DisplayObjType = "CurveChart2D" Call oNewArea.DisplayObj.Curves._ Add("[1]/Time", "[1]/Speed") Доступ к объектам в DIAdem REPORT Объекты DIAdem REPORT включают системы координат, таблицы и текст. Доступ к объектам в DIAdem REPORT не типовой, как в VBS. Сначала вы должны открыть главный объект, затем подобъект, изменить переменные, а затем закрыть объекты в обратном порядке. В следующем фрагменте Раздел 6. Автоматизация последовательности действий DIAdem: Система генерации отчетов 93 ni.com скрипта приведено изменение цвета графика в двухмерной системе координат. Call GRAPHObjOpen("2DAxis1") Call GRAPHObjOpen("2DObj3_Curve1") D2CURVECOLOR ="Red" Call GRAPHObjClose("2DObj3_Curve1") Call GRAPHObjClose("2DAxis1") Чтобы использовать в скрипте иерархию объектов, щелкните дважды по системе координат, чтобы открыть диалоговое окно Curve and Axis Definition (Определение кривой и оси), и нажмите Доступ к виртуальным приборам LabVIEW Используйте объектно-ориентированный интерфейс скриптов LVRuntime для вызова VI LabVIEW в DIAdem, для передачи значений в VI, выполнения VI и для вызова информации и значений из входных и выходных терминалов для отображения результатов в DIAdem REPORT. Глобальным объектом является LVRuntime, который загружает и запускает VI. Объект VIRuntime осуществляет доступ к свойствам входных и выходных терминалов VI и устанавливает значения этих терминалов. Объекты имеют свойства, которые вы можете использовать для задания поведения объектов, и методы, используемые для выполнения действий. В следующем скрипте вызывается LabVIEW Runtime, загружается VI Test.vi и устанавливается значение входа Input1. Далее скрипт отключается от LabVIEW. Dim sgRunTimeVersionT : sgRunTimeVersionT = "" LVRuntime.Init sgRunTimeVersionT Dim objVI Set objVIVIT = LVRuntime.LoadVI(AutoActPath & "Test") Call objVI.SetControlValue("Input1", "InputValue") Call objVI.Run(true) Set objVI = Nothing LVRuntime.DeInit Для вызова VI LabVIEW в DIAdem с использованием интерфейса LVRuntime, необязательно наличие установленного LabVIEW на вашем компьютере. Установка DIAdem включает LabVIEW-Runtime Engine, который используется для выполнения VI. Чтобы создать VI, обеспечивающий DIAdem специальными функциями, необходимо установить LabVIEW. Раздел 6. Автоматизация последовательности действий © National Instruments Ireland Resources Limited 94 DIAdem: Система генерации отчетов Редактирование каталога единиц измерения Каталог единиц измерения состоит из наборов единиц измерения, физических величин, единиц измерения и ассоциированных символов. В скриптах вы можете создавать новые объекты и редактировать или удалять существующие. Используйте иерархию объектов для доступа к объекту. Используйте объект UnitCatalog для загрузки наборов единиц измерения и добавления физических величин и символов в набор единиц измерения. Если доступен набор единиц измерения Basis, следующий скрипт генерирует новую единицу измерения Velocity, включая символ. Если этот набор единиц измерения недоступен в DIAdem, скрипт вызывает диалоговое окно ввода каталога единиц измерения. Dim oMyUnit If UnitCatalog.Sets.Exists("Basis") Then Set oMyUnit = UnitCatalog.Quantities("velocity")._ Units("meter per second") Call oMyUnit.SymbolAliases.Add("m*s-1") Else Call UnitCatalog.ShowSettingsDlg End If Расширение групп функций и панелей инструментов Вы можете использовать скрипты, чтобы добавлять новые кнопки в интерфейс DIAdem, добавляя функции на панели инструментов или в группы функций, или создавая новые группы функций. Вы можете создавать подгруппы в группах функций. Используйте объект BarManager для доступа к панелям, линейкам и объектам действия при помощи соответствующей иерархии объектов. Вы можете копировать кнопки, создавать новые кнопки, удалять созданные пользователем кнопки и восстанавливать состояние по умолчанию. Вы не можете редактировать или удалять объекты по умолчанию. В следующем скрипте создается новая группа функций My function c новой кнопкой My function на линейке групп DIAdem SCRIPT. Далее скрипт сохраняет определение линейки MyBarManager. Строка кода Call BarManager.Reset() в начале примера удаляет все определенные пользователем кнопки и восстанавливает статус по умолчанию. Call BarManager.Reset() Dim oMyFct, oMyFctBar, oMyFctBarPopup, oMyBar Set oMyFct = BarManager.ActionObjs._ Add("MyFct", "CustomButton") oMyFct.ToolTip = "My function" oMyFct.OnClickCode = "Call MsgBox(""My new function"")" Set oMyFctBar = BarManager.Bars.Add("MyFctBar") Call oMyFctBar.UsedActionObjs.Add(oMyFct) Set oMyFctBarPopup = BarManager.ActionObjs._ Раздел 6. Автоматизация последовательности действий DIAdem: Система генерации отчетов 95 ni.com Add("MyFctPopup", "CustomPopup") oMyFctBarPopup.ToolTip = "My function bar" oMyFctBarPopup.BarID = oMyFctBar.ID BarManager.Bars("SCRGroup").UsedActionObjs._ Add(oMyFctBarPopup) Call BarManager.Save("MyBarManager.bdn") DIAdem сохраняет определения линейки с расширением .bdn в папке, содержащей локальные настройки, например, в файле рабочей области desktop.ddd . Чтобы назначить новый символ новой функции, создайте файл ICO с двумя рисунками размером 18 × 18 и 27 × 27 пиксел и сохраните этот файл в соответствующей подпапке MyBarManager. Связь с другими приложениями Вы можете использовать в скриптах интерфейсы OLE, ODBC/SQL и ASAM- ODS. DIAdem обменивается данными и командами с другими приложениями через интерфейс OLE (связывание и внедрение объектов). DIAdem может быть как клиентом, так и сервером. DIAdem может использовать OLE для доступа к другим приложениям или для доступа к другой копии DIAdem. Обратитесь к справке DIAdem Help и введите термин OLE для получения дополнительной информации. DIAdem читает и записывает в базы данных ODBC (открытый интерфейс взаимодействия с базами данных) через интерфейс ODBC/SQL. Используйте команды SQL (язык структурированных запросов) для доступа к базам данных ODBC. Команды DIAdem SQL могут получить доступ к любой базе данных, зарегистрированной администратором ODBC в MS-Windows, как к источнику данных. Обратитесь к справке DIAdem Help и введите термин ODBC/SQL для получения дополнительной информации. Вы можете использовать интерфейс ASAM-ODS (ASAM Open Data Service) для получение доступа на чтение и запись ASAM-совместимых файлов и баз данных. Откройте службу данных ASAM в качестве интерфейса пользователя для навигации по данным ASAM. DIAdem содержит специальные команды ODS для доступа к данных ASAM. Обратитесь к справке DIAdem Help и введите термин ASAM Data Service для получения дополнительной информации. © National Instruments Ireland Resources Limited 96 DIAdem: Система генерации отчетов А Приложение А. Конфигурирование DIAdem В этом приложении содержится информация о конфигурировании DIAdem, сетевой установке, запуске программы с параметрами и структуре папок DIAdem. Настройки Используйте меню Settings (Настройки) для настройки различных свойств DIAdem. Выберите Options»General (Варианты»Общие)для задания общих свойств DIAdem, таких, как единицы измерения, формат времени или ссылки на канал . – Щелкните по кнопке Select Path (Выбрать путь) для задания папки по умолчанию для сохранения и загрузки данных и документов. Обратитесь к параграфу "Структура папок" для получения дополнительной информации. – Выберите Channel Properties (Свойства канала) для определения, следует ли DIAdem перезаписывать имена каналов и комментарии к ним, когда вычислительные операции сохраняют результаты в оригинальных каналах. – Выберите Data Area (Область данных) для задания настроек управления каналами и управления хранилищами внутренних данных в портале данных. – Выберите Compatibility (Совместимость) для изменения настроек, особенно настроек для работы со скриптами предыдущих версий DIAdem. – Выберите Logfile (Журнал) для определения, записывать ли DIAdem только сообщения об ошибках, или еще и другие сообщения. DIAdem отображает файл журнала в информационной области в DIAdem SCRIPT. Выберите Delete Messages, чтобы удалить содержимое журнала. – Выберите External Editor (Внешний редактор) для определения внешнего редактора, который следует использовать DIAdem при открытии текстовых файлов, таких, как файл журнала. Приложение А. Конфигурирование DIAdem DIAdem: Система генерации отчетов 97 ni.com – Выберите Colors (Цвета) для задания палитры цветов, которую DIAdem предоставляет для выбора цвета графика или цвета заливки. Меню Settings также содержит настройки специальных панелей, например, DataFinder в DIAdem NAVIGATOR, параметров курсора в DIAdem VIEW, или параметры макета в DIAdem REPORT. Из меню вы также можете задать файл по умолчанию, загружаемый в каждой из панелей. Выберите Options»Units (Варианты»Единицы измерения) для открытия каталога единиц измерения, для редактирования или создания единиц измерения, или для загрузки дополнительных наборов единиц измерения. Выберите Options»Extensions (Варианты»Расширения) для регистрации команд пользователя, плагинов данных и расширений GPI. DIAdem сохраняет настройки в файл рабочей области desktop.ddd. Когда пользователь запускает DIAdem, DIAdem проверяет, содержит ли папка с локальными настройками пользователя файл рабочей области. Если папка не содержит файла рабочей области, DIAdem копирует desktop.ddd из папки DIAdem в папку с локальными настройками пользователя. Чтобы сохранить текущие настройки в новом файле, выберите Settings»Options»Save As (Настройки» Варианты»Сохранить как). Чтобы загрузить файл рабочей области, выберите Settings»Options»Load (Настройки» Варианты»Загрузить). DIAdem загружает файл рабочей области и автоматически перезапускается. Вы можете установить разные настройки DIAdem для разных пользователей или разных проектов, сохранив настройки в разных файлах рабочей области и загружая файлы, когда они вам потребуются. Например, чтобы использовать настройки из файла рабочей области MyProject.ddd на другом компьютере, вы должны скопировать все файлы конфигурации MyProject.*, включая вложенную папку MyProject, в папку с локальными настройками на требуемом компьютере. Запуск программы со стартовыми параметрами Вы можете запускать DIAdem с параметрами для предварительного конфигурирования DIAdem, или запустить DIAdem с помощью скрипта. Введите параметры в свойства запуска DIAdem. Чтобы изменить ярлык запуска DIAdem на рабочем столе Windows, щелкните правой кнопкой мыши по иконке DIAdem. Выберите Properties (Свойства) из контекстного меню. Добавьте желаемый параметры в текстовое окно Target (Объект). Используйте параметр /D, чтобы запустить DIAdem с заданным файлом рабочей области проекта. Файл рабочей области содержит настройки DIAdem, такие, как пути к файлам или формат даты. Чтобы загрузить файл рабочей области testrig.ddd при запуске DIAdem, измените команду вызова DIAdem следующим образом: "diadem.exe" "/DC:\diadem\testrig" Приложение А. Конфигурирование DIAdem © National Instruments Ireland Resources Limited 98 DIAdem: Система генерации отчетов Используйте параметр /C, чтобы выполнить команду сразу после запуска DIAdem. Чтобы запустить скрипт MyScript сразу после запуска DIAdem, измените команду вызова следующим образом: "diadem.exe" "/CScriptStart('MyScript.vbs')" Используйте параметр /S для задания локальной системной папки для клиента DIAdem при сетевой установке. Клиент DIAdem ищет системную папку для файлов интерфейса пользователя и системных файлов, требуемых для работы DIAdem. Также DIAdem требует установки USI, поисковика данных (DataFinder) и клиента NILM на локальном компьютере. Чтобы задать системную папку system при запуске DIAdem, измените команду вызова DIAdem следующим образом: "diadem.exe" "/SC:\diadem\system" Вы можете использовать разные параметры в одном вызове, а параметр С - несколько раз. DIAdem обрабатывает команды С слева направо. Например, чтобы запустить приложение на тестовом компьютере, измените команду вызова на следующую: "diadem.exe" "/DC:\diadem\engine1" "/ CScriptStart('MainTest.vbs')" "/ CScriptStart('TestReport.vbs')" Сначала DIAdem загружает файл рабочей области engine1.ddd, с путями проекта и настройками проекта. Затем DIAdem запускает скрипт MainTest , который отображает интерфейс пользователя для теста. Когда вы закроете интерфейс пользователя, DIAdem останавит скрипт MainTest и запустит второй скрипт TestReport. |