Foglight 5.9.1 - Web Component Guide

Searching for Definitions

The Module Contents pane on the Definitions dashboard shows the dashboards that you can access based on your user permissions. Every dashboard can include one or more preconfigured views, queries, functions, files, icons, associations, renderers, types, type mappings, unit mappings, and tasks. The search feature allows you to search for various dashboard definitions contained in one or more selected modules, such as functions, queries, renderers, tasks, types, and views.

Selecting All Definitions in the Module List pane allows you to search for components across all modules and all definition types. Selecting a specific module limits the component search to that module and any of its child modules, if they exist.

There are two modes for searching: by typing the desired text into the search box (simple mode), or by specifying one or more search rules (advanced mode).

In simple mode, the following definition elements are searched:

In advanced mode, you specify one or more search rules, and indicate if you want one or all rules to return a match. The following elements can be searched for in a rule:

TIP: The User Preferences setting, Show deprecated definitions, indicates if deprecated entities are considered in a search. However, if a rule in an advanced search uses the Deprecated field, the Show deprecated definitions setting is ignored, and the search results include definitions that match the rule with the Deprecated field.

TIP: To search through all definitions, select All Definitions.

a	In the Module Contents pane, in the Search Definitions box, click .

6

Click .

7	To clear the search results, click .

4	In the Module Contents pane, in the Search Definitions box, click .

•	To add or remove rules form the search, in the Advanced Search dialog box, use the Delete Rule and Add Rule buttons , as required.

TIP: The search box shows Advanced Filter On, indicating that the entries in Module Contents pane are retrieved by an advanced search.

8	To clear the search results, click .

Definitions Page for a View

The following commands are available for working with existing views in the Definitions area:

TIP: To find out which conversion options are available for a particular view component, select it in the Module Contents pane. If a Convert To button appears in the Definitions Pane, the selected component is enabled for conversion. To find out to which view components you can convert the selected component, click Convert To and review the options in the menu that appears.

These commands are available in edit mode:

You can find these functions in the Definitions pane in Configuration > Definitions.

Select the My Definitions node containing your view from the Module List pane, select the view you want to modify, then click Edit () in the Definitions Pane toolbar.

NOTE: For more information, see “Definitions Pane Settings Tabs” on page 44.

To save a view, the name field and required properties must be defined. Ensure that the view you want to save is in the Definitions Pane, and then select Save () from the Definitions Pane toolbar.

Ensure that the view you want to delete is in the Definitions Pane, and then select Remove () from the Definitions Pane toolbar. A dialog box is displayed asking you to confirm the deletion. You can only delete views for which you have the proper permissions. You cannot delete a view if there are references to it. A public view cannot be deleted because modules from other cartridges that are not currently loaded might reference it. It is possible to delete a public view by forwarding. The view is deleted, but it remains as a pointer to the newer replacement view.

Ensure that the view you want to copy is in the Definitions Pane, and then select Copy > Deep from the Definitions Pane toolbar.

Deep copying a view copies the selected view and the related entities, including any localized strings that are referenced using that view to the current module. References to public definitions in the same module as the view being deep copied are copied as well (unless copies of such already exist in the target module). References to public definitions in other modules are not copied.

It takes into account:

The Convert To button allows you to convert one view component to another without the trouble of copy and replace operations.

For example, if a Rows Layout component is configured and then you decide a Grid Layout is more appropriate, simply convert the Rows Layout component to a Grid Layout. The types of view components that you can convert to depend on the selected component. For example, a Rows Layout can be converted to a Columns Layout, Splitter Layout, or Grid Layout, while a Grid Layout can only be converted to a Rows Layout or Columns Layout. Additional conversion options may be available.

TIP: To find out which conversion options are available for a particular view component, select it in the Module Contents pane, in the Definitions Pane click Convert To, and review the options in the menu that appears.

When the conversion is complete, the converted component should be verified to ensure it displays as expected. For example, when a layout is converted, check if the child views are laid out properly.

View Commands in the Definitions Area

The following commands are available for working with existing views in the Definitions area:

TIP: To find out which conversion options are available for a particular view component, select it in the Module Contents pane. If a Convert To button appears in the Definitions Pane, the selected component is enabled for conversion. To find out to which view components you can convert the selected component, click Convert To and review the options in the menu that appears.

These commands are available in edit mode:

You can find these functions in the Definitions pane in Configuration > Definitions.

Select the My Definitions node containing your view from the Module List pane, select the view you want to modify, then click Edit () in the Definitions Pane toolbar.

NOTE: For more information, see “Definitions Pane Settings Tabs” on page 44.

To save a view, the name field and required properties must be defined. Ensure that the view you want to save is in the Definitions Pane, and then select Save () from the Definitions Pane toolbar.

Ensure that the view you want to delete is in the Definitions Pane, and then select Remove () from the Definitions Pane toolbar. A dialog box is displayed asking you to confirm the deletion. You can only delete views for which you have the proper permissions. You cannot delete a view if there are references to it. A public view cannot be deleted because modules from other cartridges that are not currently loaded might reference it. It is possible to delete a public view by forwarding. The view is deleted, but it remains as a pointer to the newer replacement view.

Ensure that the view you want to copy is in the Definitions Pane, and then select Copy > Deep from the Definitions Pane toolbar.

Deep copying a view copies the selected view and the related entities, including any localized strings that are referenced using that view to the current module. References to public definitions in the same module as the view being deep copied are copied as well (unless copies of such already exist in the target module). References to public definitions in other modules are not copied.

It takes into account:

The Convert To button allows you to convert one view component to another without the trouble of copy and replace operations.

For example, if a Rows Layout component is configured and then you decide a Grid Layout is more appropriate, simply convert the Rows Layout component to a Grid Layout. The types of view components that you can convert to depend on the selected component. For example, a Rows Layout can be converted to a Columns Layout, Splitter Layout, or Grid Layout, while a Grid Layout can only be converted to a Rows Layout or Columns Layout. Additional conversion options may be available.

TIP: To find out which conversion options are available for a particular view component, select it in the Module Contents pane, in the Definitions Pane click Convert To, and review the options in the menu that appears.

When the conversion is complete, the converted component should be verified to ensure it displays as expected. For example, when a layout is converted, check if the child views are laid out properly.

Nested Views in the Add View Dialog of a Container

You have the option when adding views to a container of choosing Select existing view or Create a nested view. Many Nested views are private views that are contained only in the specific container.

When creating a nested view, the Context tab allows the user to define additional context for the nested component. All context inputs of the nested view are read-only.

A context input of a nested view might be converted to an optional, implicit context input. This can happen if the nested view has an action configured that has flow context mapping that is used for input which causes an implicit (optional) context input to be created.