This guide will explain step by step, how to add a Manual Parameter in OnPing. Manual Parameters are used for a number of functions in OnPing, for example creating events for event tables, to set up dispatch callouts, and setting thresholds for alarms. Manual parameters are located locally on Lumberjacks. The parameters are not being âpulledâ from an external source.
Step 1: Select Lumberjack and Location #
First, select the desired Lumberjack for the new parameter. Next, navigate to the âDriver Add Linksâ panel on the Dashboard. In this example the dashboard is labeled âDemo Video Dashboardâ.
In the event that the âDriver Add Linksâ panel is not available in the dashboard, please contact the system admin or OnPing support for additional information.
Once inside the âDriver Add Linksâ panel, scroll to and click the âmanual entry parametersâ link. If âmanual entry parametersâ is not available, it may also be called âsingle well parameterâ.
This will add a new parameter and a new panel named âNew Exampleâ. Select the company for this new parameter. In this example, the company name is âPlow Demoâ.
Select the Site for the new parameter. In this example, the site is named âOil and Gas Demoâ.
Next, select the Location for the site âOil and Gas Demoâ. In this example, there are no locations available.
Add a new location by navigating to the blue â+ New Locationâ button at the top left of the panel screen.
By convention, this type of data is called âSCADA Dataâ because these parameters are only available in the SCADA system (Supervisory control and data acquisition). These parameters are found locally and do not exist on an external device.
Name the new location. In this example the name of the new location is named âSCADA Dataâ.
Next, type in the Lumberjack ID into the URL text bar. This number can be found on the physical Lumberjack unit. In this example, the URL or Lumberjack ID is â10.7.9.153â.
Following the URL entry, select the company assigned to this new location in the table âLocationâ (to the right of the âInformationâ table). In this example, the company selected is âPlow Demoâ.
Select the Site for the new location. In this example the site âOil and Gas Demoâ is selected.
Select the Group for permissions to be available to this new location. In this example the group âplowDemoUsersâ is selected. Note: the group with the lowest ranking permissions should be selected. All groups above that group will also have permissions to the new location information.
Now that all the information is imported and selected, click the green âAddâ button at the bottom left of the New Location window.
An OnPing notification will appear at the bottom right of the screen to confirm that the new location has been saved successfully.
Now there is a location available to add the new parameters to.
Step 2: Add Parameter #
Navigate to the âDemo Video Dashboardâ dashboard and select the âManual Entry Driver Controlâ panel.
Add the new parameter to the dashboard by clicking the gray âEdit Dashboardâ button at the top right of the panel window.
Next click the blue â+ Widgetâ button.
A dropdown window will appear displaying the available widgets to add to the dashboard. Scroll to the âControllersâ list and click the blue âAddâ button to the right of âManualâ.
Once the new âManualâ widget has been added, exit edit dashboard mode by clicking the gray âExit Edit Dashboardâ at the top right of the panel window.
Again, select the company, site and location. In this example, the location is the new location created in Step 1 named âSCADA Dataâ.
A dropdown window will appear displaying the Parameter ID information. In this example, there are no parameters created. To create a parameter, click the blue âEditâ button in the âParameter IDâ window.
Next, click the blue â+ New Parameterâ button.
As stated in the summary, these parameters can be used for a number of different functions. Enter the name of the new parameter by typing into the âDescriptionâ text bar next to the âParameter IDâ. In this example, a threshold parameter will be created named âPressure Thresholdâ.
Next, insert the value for the new parameter. In this example, the value is â5.0â.
Click the green âSaveâ button to save the new parameter.
Step 3: Configure Parameter #
Now that the new parameter(s) are saved, navigate to the âInfo Tableâ panel on the dashboard.
On the âInfo Tableâ panel, click the wrench iconfrom the toolbar at the top right of the window.
A toolbar will dropdown displaying customizing options. Click the blue âEdit Table Contentsâ button on the toolbar at the top left of the window.
Once in Edit Table Mode, click the blue âPIDâ button under the âSetpointâ table.
Next, click the pencil icon to the left of the âPIDâ button to open additional customization options. Again, click the blue âPIDâ button but this time, under the âValueâ table.
Select the Company, Site, and Location from Step 1. In this example, the company is âPlow Demoâ, the site is âOil and Gas Demoâ and the location is âSCADA Dataâ
A dropdown window will appear displaying all available parameters. Select the parameter created in Step 2.
Click the blue âUpdateâ button at the top left of the âInfo Tableâ window.
Once the info table has been updated, save the table by clicking the green âSave Custom Tableâ button at the top left of the window.
The parameter is now configured in the table.
Step 4: Implement Parameter in Event Table #
Now that the parameter is configured, assign the parameter. In this example, the new parameter will be used to trigger an event. An âEventâ in OnPing is the equivalent to a value being saved to the OnPing historian. Navigate to the top right of the dashboard window and click the gray âEdit Dashboardâ button.
Next, click the blue â+ Widgetâ button to add an Event Table widget.
Under the âTablesâ list, click the blue âAddâ button to the right of âEvent Tableâ to add it to the dashboard.
To add an event to the new event table, click the pencil icon as shown below:
Again, select the Company, Site and Location. In this example, the company is named âPlow Demoâ, the Site is named âOil and Gas Demoâ and the Location is named âSCADA Dataâ.
Click the checkbox to the left of the parameter desired. In this example, the new parameter âPressure Thresholdâ created in Step 2 is selected. Click the green âConfirm Parametersâ button at the top left of the parameters window.
Once the parameters are confirmed, decide how many events will be displayed by entering the number in the âDisplay Lastâ text bar to the right of the Info Tableâ window.
In this example, 10 events will be displayed.
Next, select the information desired for display by clicking the checkbox next to the option. In this example, âShow Resultâ, âLast Update Dateâ and âLast Update Timeâ are selected for display. Once all the desired information is selected, click the green âSaveâ button just above the information options table.
An OnPing notification will appear displaying that the âEvent Table has been saved successfullyâ.
While remaining in âEdit Dashboardâ mode, name the event table. In this example the event table is named âExample Manual Parameterâ.
Once the event table has been named, click the blue âSaveâ button from the toolbar at the top right of the Dashboard window.
Another OnPing notification will appear stating that the âDashboard has saved successfullyâ
Now click the gray âExit Edit Dashboardâ button from the toolbar at the top right of the Dashboard window.
This completes the creation, configuration and assignment of parameters in OnPing.
Step 5: Update Parameter Value in HMI (Optional) #
To further test that the parameter is updating accordingly, manually change the value and refresh. In this example, the setpoint â5â will be changed to â6â. To change the setpoint, click the text â5â.
Click the blue âWrite Valueâ button that appears.
Manually change the value from â5â to â6.0â and click the green âWriteâ bottom just under the value text bar.
Refresh the browser window and notice that the new setpoint has been updated to â6â.
This table does not execute instant feedback. For quicker updates and feedback, add an HMI widget to the panel. Once in the HMI (Human Machine Interface) widget, click the green arrow at the top left of the HMI window to add a label.
Under âGeneralâ, click the blue âLabelâ icon to add a label to the HMI.
On the right side of the HMI window, additional options for customizing the new label will appear. Select the parameter created in Step 2 by clicking the âUse value from parameterâ button to the right of the label text box.
Navigate to the desired parameter by selecting the Company, Site and Location. This will open the parameters available to be assigned to the new label. Click the checkbox to the left of the desired parameter to select. Then click the green âConfirm Parameterâ button at the top of the parameters window.
Now that the parameter has been assigned to the label, save the new label.
The label will now display the new parameter value in the HMI and will be updated as soon as the value changes. This eliminates the need to refresh the browser window as the value is being displayed in real-time.