TN 1208 Adding Query to an OMI application

Description

This article from InSource shows how to add Historian Client Query to an OMI application. While this has been technically possible since the 2017 version of the product , starting with 2020 you no longer need Visual Studio to accomplish this. Windows Forms (WinForms) and Windows Presentation Foundation (WPF) .NET controls can now be imported as OMI Apps (WPF User Control Libraries) into a Galaxy through the System Platform IDE.

Things to note:

• To qualify for import as an OMI App, the App should contain at least one WPF FrameworkElement Class control (System.Windows.FrameworkElement).
• Before importing .NET control(s), the assembly file (.dll) and all other dependency files should be organized in a single folder, which can optionally include subfolders.
• Everything in the folder will be imported as part of the new OMI App. 

• Author: Mario Meza
• Published: 12/21/2021
• Applies to: Application Server 2020 and above

Details

In Windows file explorer, navigate to C:\Program Files (x86)\Common Files\ArchestrA

Locate the aaHistClientQueryControl.dll and copy it. 

Create a new folder named whatever you want the resulting App to be named in Application Server. In this instance the directory is called QueryApp.

Paste the aaHistClientQueryControl.dll in the QueryApp folder.

In the IDE from the file menu select

Galaxy > Import > ArchestrA Apps...

Browse to the location of the QueryApp directory containing the aaHistClientQueryControl.dll . Once selected click OK.

Wait for the import to complete.

Once complete you should see an OMI App in the Graphic Toolbox with 001 appended to the name of the imported directory. 

In the example my app is called QuerryApp001.

Open your OMI View App and locate QueryApp001 in the Toolbox.

Drag the aaQueryControl to an empty pane in your layout, in this example Pane3. Once the app is placed select Preview.

You can now access Query from your OMI Application.