Configuration of the dynamic ribbon tabs is done via the Features tab in Configure the explorer. This article explains where to configure the feature and provides an explanation of all of the available configuration elements. Links to configuration examples are also provided.
<ItemRibbonTabConfig> <Contexts> <Context caption="context1" color="Black"/> </Contexts> <ItemTabs> <ItemTab caption="tab-caption" context="context1"> <RibbonGroups> <RibbonGroup caption="group1"> <ItemView name="TestSpecConnectRequirements"/> <ItemView name="Overview" visibility="Dynamic" hideIfDisabled="true"/> <ItemView name="Coverage" configId="1"/> <ItemView name="Coverage" configItem="x1234123412341234"/> <MultiButton> <ItemView name="Overview"/> <SecondaryItemView name="Overview"/> </MultiButton> <MultiButton> <ItemView name="Parts"/> <SecondaryItemView name="Overview" locked="true" orientation="right"/> </MultiButton> <OpenItem id="x1234123412341234" caption="" treeSettings=""/> <TreeSettings name="Requirements"/> </RibbonGroup> </RibbonGroups> </ItemTab> </ItemTabs> </ItemRibbonTabConfig>
Note: To refresh an existing configuration that has been modified, log out and back in to the swExplorer. If a new version of a config item button is created, click Save to refresh the ribbon button for users.
<ItemView> defines a link to a view, i.e., config item views (grids, graphs, reports, etc.), configurable multi-instance built-in views (Coverage, Clone item, etc.), standard views (Attachments, Overview, etc.), extension views (FaultTreeGraph, HazardIdentification, etc.). All views can be found listed on the Item views tab in Configure the explorer:
- name: the name of the view (or Extension view). Enter the Name value as seen on the Item views tab of Configure the explorer. This is required.
|Config Item Type||Name to be used in ItemView|
|Configurable XML generators||XML|
|Note: For extensions: the extension dll file must be located in the swExplorerExtensions directory in order for it to appear in the list.|
- configId: required for multi-instance configurable item views only. Enter the configuration id attribute for the view. This can be found in the view's configuration:
- configItem: required for config item views, e.g., chart, grid, graph, report, etc., only. Enter one of two possible values:
- The xID of the config item. Example: "x34000000000877C5". Note that if this is used, the ItemView button will always point to that version of the config item. If a new version is made of the config item, the button configuration would need be updated to include the new ID if the button needs to be updated. Or,
- The Ref id of the config item. It consists of the SID of the configured type along with the defined id for the config item. This option will automatically point the button to the latest version of the config item.
If "configitem" is misspelled, the configuration will not apply properly until the misspelling is corrected.
|Note: The Item ribbon tab metadata must be installed if you will be using Ref id for config item views.|
- visibility: defines the dynamic behavior of an ItemView button (and indirectly the ribbon group, item tab and context). This is optional. There are three possible values:
- Ignore: the item view will not be activated by item selection. Activation will instead depend on activation of other views or item links in the same ribbon group. If a group includes only one or more buttons with visibility="Ignore", then the group will not be visible.
- Always: the item view and ribbon group will always be available.
- Dynamic: activation of the item view will depend on the specific view and the item being selected in the item structure tree, according to standard view activation (default).
- hideIfDisabled: defines if the button should be hidden if it is not active. This is optional. If not used, inactive buttons display with gray text by default. Adding hideIfDisabled="true" will hide the button itself. If there are no other buttons in the ribbon group, the ribbon group will be hidden as well. See Creating Item View Buttons for item view button configuration examples. example configurations for visibility.
- locked: When using a configurable graph in an <ItemView> configuration, you can use this attribute to specify if the graph will be locked or not upon loading. This is optional. Valid values are "true" or "false". The default value is "false".
<OpenItem> defines a button that can open a specific item.
- id: the SystemWeaver item ID of the item that will be opened. Example: "x04000000000375CF"
- caption: label text that will be used for the OpenItem button. If not used, the text will be the name of the item according to the id attribute.
- treeSettings: defines which structure tree view setting should be used when the item is opened. This is optional. Enter the name of the tree setting. To use the Default setting, you must specify it, i.e., treeSettings="Default". If not specified, the behavior is the same as using Ctrl+O to open the item. If the item is already open, it will become the active page without any setting changes.
<TreeSettings> offers fast selection of a tree view setting. If multiple tree settings are used, they will work as "radio buttons", i.e., if one is selected the other will be de-selected.
- name: the name of a tree setting. The name appears as the label of the button.
<MultiButton> loads two views simultaneously. In the below example, a configurable graph is defined for the left-side pane and a configurable report is defined for the right-side pane.
See Configuring a Multi-Button for an explanation of tags and attributes and a configuration example.
<MergeButton> enables users to navigate through a structure without having to click on multiple view buttons to change the view. The view updates each time they select a new item type for which there is a definition included in the MergeButton configuration.
See Configuring a Merge Button for an explanation of tags and attributes and a configuration example.
Item ribbon tab configuration examples can be found here.