Business rules

• The leftmost part of the workspace list definitions for you to work with. Double-click <Create new definition> to add a new definition—see Adding a definition. Open a definition for editing by double-clicking it or dragging it into the editor.

• An icon to the left of a definition’s name identifies the kind of definition it is, if it is incomplete (a work in progress), or if it contains errors:

  

• Unsaved definitions are marked with an asterisk (*).
• Filters allow you to limit the definitions listed to those that match one or more of: name; label; and which properties are used or set. Enter text at <Type here: filter by NAME> (case sensitive) or drag labels or properties into their respective fields. Click to remove a filter.
• You can rename a definition by slowly double-clicking its name and entering the new one.
• You can remove selected definitions from the list by pressing Delete and confirming the deletion. Removing an active definition from the list does not immediately delete it from SmartSpace. To delete an active definition from your system, you must publish a new version of your definitions. See Publishing definitions.

The editor provides a multi-tabbed workspace in which you can edit definitions. Choose a definition, by double-clicking it or dragging it into the workspace, and it is opened in its own tab in the editor.

Each definition is based on a template which provides a framework that is shown in the editor and into which you drag elements such as keywords and properties. See Building definitions for an example of the process.

• When you drag an element, valid slots are highlighted in the editor and you can only drop the element into a valid slot.
• Color-coded prompts indicate what can be dragged or entered in a slot.
• Error messages, described below, also provide help in creating correct definitions.
• Some slots require you to enter a value; other slots provide you with a dropdown of possible entries (double-click to open the dropdown).
• You can drag elements out of a slot and into the area around a definition (the scratchpad). You can also open extra tabs to provide additional scratchpads.
• You can copy between tabs by using Ctrl+C and Ctrl+V, and elements can be duplicated by holding down Ctrl and dragging them.
• You can use Ctrl+Z to undo Ctrl+Y to redo drag actions.
• Drag unwanted elements into the trash can to delete them (Ctrl+Z cancels a deletion).
• Comments can be added to annotate a definition or keywords within it—see Adding comments to your definitions.
• Apply label(s) to definitions to categorize them—see Organizing definitions.
• You can zoom in and out by using either Ctrl+mouse wheel or Ctrl+Plus sign and Ctrl+Minus sign.

As you build longer and more complex definitions, selecting the correct block of syntax to move can become tricky. The following hints should help you select and move the right elements:

• Clicking unselected syntax selects the smallest possible element (you will see the dotted highlight appear around it).
• Subsequent clicks at the same point expand the selection.
• When the largest possible element is selected, a subsequent click cycles back to the smallest element.
• Only selected syntax is dragged out.

When you have finished, you can close individual tabs by clicking the close button beside their titles or use the Close all tabs button to clear the editor. When you close a tab, anything in the scratchpad is lost. Changes to a definition that you wish to keep must be saved before you close SmartSpace Config (you will be warned if you have unsaved changes), and any new or changed definitions you want to make active in SmartSpace must be published. See Publishing definitions.

While you are editing a definition, SmartSpace monitors it for completeness and validity—and displays descriptive error messages in real time. Click an error message and the error is highlighted in the definition:

You can save an incomplete definition (or one with errors) but you cannot publish it.

Error messages are also displayed for duplicate definitions in the same dataset if:

• Multiple "whenever" rules maintain the same property

• Multiple event handlers or timeout definitions are semantically identical

Click Check all definitions to display a message indicating the status of the definitions. If the definitions are not OK, the number of incomplete definitions or definitions which contain errors is displayed.

The toolbox contains a list of keywords that you use along with properties to construct definitions. When you drag a keyword into the editor the possible slots into which it can be dropped are highlighted. Different keywords are available for different definitions. See Keywords for definitions for descriptions and availability.

The list of properties includes all simple and complex properties created in the Types and objects workspace, and also any Ubisense types supplied with the features you have licensed (see Types and objects for Ubisense types).

When you drag a property into the editor, the valid slots into which the property can be dropped are highlighted.

Filters allow you to limit the properties listed to those that match one or more of: name, type, and argument. Enter text at <Type here: filter by NAME> (case sensitive) or drag labels or properties into their respective fields. Click to remove a filter.

You can organize definitions and make them easier to locate by creating and applying labels to them. See Organizing definitions. Labels are also used to identify items for inclusion in modules for export as described in Managing definitions.