Configure the Dropdown Command and Navigation Properties

Scenario
You want to configure a dropdown command control so that it can set a binary value data point’s Alarm Value property to Active or Inactive from within your graphic.

NOTE:
if you create a command control element in a symbol instead of on a graphic, follow the steps below, replacing the Target and any other hard-coded references with * substitutions in the Evaluation Editor. For more information, see Symbol Property Substitutions.

  • You have reviewed the Command and Navigation Properties section and have a full understanding of the fields and the options available to you for configuring the command control.
  • You have drawn a dropdown control and configured the Command Control properties.
  1. Select the drop-down control on the canvas, and from the Property View (Dropdown Control Properties), expand the Command and Navigation properties group.
  1. In the Target field, drag a designated data point from System Browser. If the target’s designation does not specify a property, the default property is targeted. Otherwise you must specify the property by typing a period (.) and then the property name after you drag the data point into the Target field, for example: CCProject.LogicalView:Logical.PXRack.B.Block.Hcrv;.Property_Name
  • For this example, drag the binary value data point and at the end of the path, type .Alarm_Value. The Target path should like this: System1.ManagementView.[custom path].BV1;.Alarm_Value
    NOTE: If you have the data point selected in System Browser, or you have selected a symbol instance of the data point on the canvas, the data point information is displayed in the Operations and Extended Operations tab, from there drag the property you want to target into the Target field. The property name is added automatically.
  1. From the Command Name drop-down menu, select or type the command Name that you want to apply to the property. The Command Name must match the Name of the command in the Models and Functions Command Configuration section. This field is case-sensitive.
  1. In the Parameter field, do one of the following:
  • Select the value from the drop-down menu.
    NOTE:     For a stand-alone command control, if you have multiple parameters, only one parameter receives the value from the control itself and all other parameter values must be hard-coded.
  • For this example, delete everything but the parameter name, which in this case is: Value.
  1. For dropdown controls, commands are sent by selecting the value from the dropdown control. The Trigger drop-down menu is irrelevant for the dropdown control.
  1. (Optional) In the Description field, type a brief description of the command that will appear in the tooltip.
  1. From the Cursor drop-down menu, select the cursor preference that you want to display when the command is active.
  1. Check the Command Trigger check box to enable the command control to initiate and send a command.
  1. To disable the command control, select the Disabled check box, and from the Disabled Style drop-down menu, select how the disabled command control displays when disabled.
  • For example, if the selected data point is Out_of_Service and the command is disabled, the selected Disabled Style will be active at runtime.
  1. The Extended Tooltip check box is selected by default. It displays the following command object details: Target, Command Name, and Parameter. If enabled, the extended tooltip is added to any existing tooltips configured for the element.
  1. Click Save As .