Search Box

The Search Box is a powerful CygNet-aware tool for searching facilities or other objects in your CygNet environment. Two search modes are available:

Facility Search

This mode will search all facilities in the specified Facility service and return any matching facility names. Three options are supported when a desired search result is selected:

1. Facility Sender — the search box acts as a facility sender and sends the selected facility to any controls on the screen configured to receive it.
2. Navigation — the search box navigates by facility and links to the selected facility's associated screen. The navigation mode is determined by the Facility navigation mode setting on the screen displaying the search box.
3. Script — an action can be scripted to execute when a facility is selected from the search results.

You can limit the search box to execute a search against a Facility service associated with a current value service (CVS), against a custom filter rule, and against a list of facility properties.

Custom Search

In this mode the search box can be scripted to perform a custom search against any object, for example, a SQL database, a .csv file, even a web site. Further custom actions can be executed when selecting an item in the search results.

Property Inheritance

Property inheritance is a widely used concept in Canvas. The application supports an explicit relationship between screens, objects, and controls, where certain property values, such as SiteService and facility tags, are passed from one element to another via an inheritance framework. Screens, objects, and controls can be configured as property senders or property receivers and provide configuration options where you can explicitly define the source of the SiteService and facility. Depending on how you have your screens, objects, and controls set up, the SiteService and facility may come from any one of the following sources:

• from itself — indicated by selecting <Self> and then explicitly configuring the property
• inherited from the screen — indicated by selecting Screen, which is always present as a sender
• inherited from another control — indicated by selecting the Name of the sending control

Broadcasting

Screens and objects support an additional notification option to broadcast their SiteService and facility selection changes to other open screens running in the Canvas or Canvas View application. If configured, a <Broadcast> option is available to source the screen's SiteService and facility properties from another open screen.

For example, a text tool can be configured to get its facility from the screen and the screen can be configured to get its facility from a tag chooser. Or Screen_A might source its facility from Screen_B, which gets its facility from a tag chooser.

Receiver or Sender

The search box supports property inheritance as a sender of its facility to the screen and to other controls on the screen:

Related Topics