Figure 287:Archive Options - Value Storage Strategy
- Open a History Trend display by selecting a data item in the I/O Model tree, right clicking and selecting Add item to… > History Trend > Last 10 minutes
Figure 288:Opening a HistoryTrend Display from I/O Item Context Menu
- The HistoryTrend should look similar to the example shown below:
Figure 289:Example HistoryTrend Display
- Using the context menu of objects in the I/O Model panel. Right click on the I/O object and select Add item to… > History Trend . The currently visible display is always the first option in the Add item to... sub-menu. Alternatively you can use the Alt+Enter shortcut
Figure 290:Adding New Items to HistoryTrend Display - Context Menu
- Drag and drop Items into the HistoryTrend display. Select the item you wish to add in the I/O Model panel and drag into the HistoryTrend display, then release the mouse button
Figure 291:Adding New Items to HistoryTrend - Drag and Drop
- Add as many items to the HistoryTrend display as you like. The display should look like the example below with the trend line for each displayed in a different color:
Figure 292:HistoryTrend Display with Multiple Items Added
To remove items from the display, right click on the item in the legend at the bottom of the display. This opens the context menu from where Remove item(s) can be selected. It is possible to select and remove multiple items at a time.
Figure 293:Remove Items from HistoryTrend Display - Context Menu
|#||The number of the trend line|
|State||The visual representation of the current system state of the item being trended. Should be green to indicate that the current data is good.|
|Color||Color of the trend line. Click to select a different color|
|Object Path/Item Name||Path of the Object in the system and the Item name (path cannot be configured, however the item name can be changed in the Object Properties panel)|
|Trend Type||Trend type configuration. Select from the dropdown box to select from multiple options for the trend type display|
|Dash||Dash type configuration. Select any from the dropdown box to change the way the trend line’s dash is displayed|
|Size||Dash size configuration. Select any from the dropdown box to change the line thickness|
|Marker||The marker configuration. Select any from the dropdown menu to change the way the trend line’s marker is displayed|
|Aggregate||The aggregate used to retrieve trend line data from the archive. Select from the dropdown menu to switch between aggregates|
|Curve Fitting||The display options and fitting type for a trend line curve fit. A fit type has to be selected for the curve fitting to be visible|
|Y-Axis||Select Y-Axis position. This option becomes available when a multiple or stacked Y-Axis is selected from the options in the menu bar of the display.|
|Minimal Y-Axis Value||Select how the minimal Y-Axis value is calculated or configure a value of your choice by selecting from the drop down menu|
|Maximal Y-Axis Value||Select how the maximal Y-Axis value is calculated or configure a value of your choice by selecting from the drop down menu|
|Use Range||Select to set the Y-Axis range to the EU range configured in the item's object properties panel|
|Show Limits||Select to show high and low limit lines. These values are taken from the limits set in the Object Properties panel|
|Visible||Select to toggle the item's trend line on/off in the display|
Figure 294:Example of the Trend Configuration Options in HistoryTrend Display
- By holding down the left mouse button and dragging across the are to be zoomed into:
Figure 295:Mouse Zooming in the HistoryTrend
- Release the mouse button to zoom into the selected area. The zooming bars on the bottom and right of the display can be used to navigate around the display.
Figure 296:Mouse Zoomed in Region
- You can repeatedly zoom in on an already zoomed in on area. The zoom bars can also be used to zoom in further on a selected area by holding down the mouse button on either end of the bars and dragging to adjust the size.
- The scroll wheel on the middle of the mouse can also be used to zoom in and out of the HistoryTrend display
- Click the Zoombar button in the menu bar of the HistoryTrend display. This toggles the Horizontal Zoombar on/off.
Zoombar button in HistoryTrend Menu Bar
- This opens the chart preview display underneath the main HistoryTrend display.
Figure 298:Horizontal Zoombar and Preview Window
- Adjust the size of the preview window by holding down the mouse button and dragging the side bars to the desired zoom level. The preview is displayed in the main HistoryTrend display window.
- Drag the preview window horizontally to navigate the HistoryTrend data
Horizontal Zoombar Navigation
- Click the right mouse button to zoom out of the selected area at any time
- Click on the Select Time Period icon in the menu bar of the HistoryTrend display to open the Time Period Setting dialogue
Figure 300:Select Time Period Icon
Figure 301:Time Period Setting Dialogue
- Start Time - Absolute or Relative
- End Time - Absolute or Relative
- Interval - Length of Intervals to be fetched from the archive
Figure 302:Time Period Settings - Absolute Time
- Length Specify the length of each interval from preset list (1 sec, 1 hour, 1 day etc)
- Count Specify the number of requested intervals, the length of the interval will then be calculated
- Advanced Specify interval length in exact time units, number of requested intervals will be calculated
- Default Interval length will automatically be selected based on the requested time period
- Maximum Resolution Interval length will automatically be calculated based on requested time period and available numbers of pixels in the HistoryTrend display area
Figure 303:Moving Time Period in HistoryTrend - "Page" Function
- The trend is zoomed in
- The trend is using a relative start and end time (particularly when the end time is "Now")
Figure 304:Refetch Trend Data
- Click the Start/Pause icon in the menu bar of HistoryTrend display to begin auto-update
Figure 305:Start Auto-Update in History Trend
- Click on the pause icon to pause the HistoryTrend update
Figure 306:Pause Auto-Update
- Click on the icon in the menu bar of HistoryTrend display and select the multiple or stacked option
Figure 307:Multiple Y-Axes Selection
Figure 308:Stacked Y-Axis Display
- Click the add cursor line button in the icon menu bar. The cursor is added and value information displayed in a floating panel
Figure 309:Add Cursor to HistoryTrend Display
- Drag the cursor horizontally across the display to change the values displayed in the floating information panel
- Add another cursor to the display using the button. Both sets of values for each cursor are displayed in the same panel
- Click the Floating Panel icon to change the cursor display options
Figure 310:Cursor Display Options
- Click the Cursor Top detailed icon to have the values for each cursor displayed in separate panels at the top of each cursor. These panels are attached to the cursor and move as the cursor is dragged within the display
Figure 311:Detailed Cursor Option
- Firstly, create a new workspace for this How-to example by selecting System > New Workspace (shortcut Ctrl+N), saving your current workspace if needed.
Figure 312:Create New MassConfig Training Workspace
- Open a new MassConfig display by selecting Open > Mass Config Sheet (shortcut Ctrl+M).
Figure 313:MassConfig Display
- Click on the New Object wizard icon in the main menu bar of the MassConfig display
Figure 314:Open New Object Wizard
- The first step in the Create Object wizard is to choose the type of object, its path and the Model Panel that it will be created in. For this Example select from the drop down menus to create a Folder in the I/O Model. The path will include the object name in your system and, for this example, the MassConfig Training folder is created under the Core object. Click Begin to go to the next step.
Figure 315:Create Object in MassConfig Wizard - Object Type
- In the Common properties step, confirm the object name and add an object description if you wish. The rest of the options can be left as default. Click Finish to add the object to the MassConfig display
Figure 316:MassConfig Wizard - Common Properties
- The object appears in the MassConfig sheet as shown below
Figure 317:First Object in MassConfig Display
- Once present in the MassConfig display, the object properties can be edited before actually creating it on the server side (and in the I/O Model tree). One way is to right click on the object in the MassConfig display to open the context menu and select Edit object. This reopens the wizard where the properties can be edited.
Figure 318:Edit Object in MassConfig Display - Context Menu
- Alternatively, the object properties can be edited directly in the table of the MassConfig display by double clicking on the respective column entry
Figure 319:Edit Properties in MassConfig Display Table
- Click Simulate to check that all the object properties are syntactically correct before executing the object creation
Figure 320:MassConfig Display - Create Object Simulation Result
- The simulation result is displayed in the message box. Successful simulation will be indicated in the message and the object will have a green tick by it in the MassConfig display table.
- Right click on the MassConfig Training folder in the I/O Model tree that you created in the previous example and select AdminàMass Config SheetàSubtree
Figure 321:Adding Subtree to MassConfig Display
- The currently selected folder and all its successors in the tree are added to the MassConfig display. Notice that there are 2 Tabs at the top of the display. One for Folder and one for Generic Item. Each different system:inmation object type is placed under a separate tab (multiple objects of the same type are placed under the same tab).
Figure 322:MassConfig Display - Object Type Tabs
NEW ITEM 7/19/2016 2:19:56 PM
- Open a new MassConfig display, and add the GenericItem created above to it (or create a new Generic Item in the wizard).
- Click the Export to File icon in the menu bar of the MassConfig display (shortcut Ctrl+Shift+E)
Figure 323:MassConfig - Export to File
- The content of the MassConfig display is exported to an .xlsx file which is automatically opened in MS Excel (or whatever the default application for .xlsx files on your system is)
Figure 324:MassConfig Exported to MS Excel
- Copy the second row of the MS Excel worksheet ten times in the rows below
- Rename the Basepath and ObjectName with unique names (or add sequential numbering) so it looks similar to the example below:
Figure 325:Multiple Generic Item Objects in MS Excel worksheet
- Save the MS Excel workbook (default save location is your documents folder), keeping note of the filename and return to the Mass Config display in DataStudio
- Click the import from file icon in the menu bar of the MassConfig Display to bring up the Open file dialogue
Figure 326:Import File into MassConfig Display
- In the Open dialogue, navigate to the MS Excel worksheet file you just saved and click Open. The Extra Items you created in the Excel worksheet will populate the MassConfig display
Figure 327:New Objects in MassConfig Display
- Click Simulate to check if the configuration information is valid. You should see that all changes are successful and a green tick is displayed by each object in the MassConfig display
Figure 328:Successful Simulation of New Objects in MassConfig Display
- Click Apply to create the objects in the I/O Model tree and check in the Object Properties Panel that the GenericItems are generating numeric values
Figure 329:GenericItems Created from MassConfig Display in the I/O Model Tree
A common use of MassConfig is to create duplicate sub-sections of Model trees that might only differ in the name of a root node. This can be achieved quickly and easily by changing the base path of the object paths using the Rebase function.
- Create a namespace with a node folder with children below it (in the example shown the DemoData namespace is used)
- Right-click on the node folder and select Admin > Mass Config Sheet > Subtree from the context menu
Figure 330:Namespace in MassConfig
- Click on the Rebase button in the menu bar to open the Rebase dialog
Rebase button in Menu Bar
- The Rebase dialog displays the longest common path of the objects in the MassConfig sheet in the Base path field. In this case it is the path of the node folder "Examples"
- We will create a new copy of the "Examples" subtree by changing the new base path to "Examples 2"
Figure 332:Rebase Dialog
- The Rebase references checkbox is ticked meaning that the paths of any referenced objects will also be changed to the new base path. A total of 9 references will be changed
- Click Change to make the changes to the paths
- The changed paths are now visible in the MassConfig sheet
Figure 333:Rebase Completed
- Click Close to close the Rebase Dialog and return to the MassConfig sheet
- Before we can create the duplicate tree, we need to change the Object Name of the Examples node
- Click on the Folder (IO) tab in the MassConfig sheet and select the ObjectName field of your top node folder
- Change the ObjectName to match the new base path
Figure 334:Change ObjectName of Node
- Click Apply to create the objects in the MassConfig sheet
- The results of the mass configuration will be displayed and the new "Examples 2" duplicate namespace should be visible in the I/O model
Figure 335:Mass Config results
Figure 336:Mass Operation with No Changes
- The mass operation contained an object, whose properties are 100% identical with an already existing object.
- The Operation mode is set to Upsert