- Tab: Auto, Allow, Empty, Change, & Hide

Automatic Tab View

As discussed in the previous section, when you run a tabbed operation you will only see the tabbed

layout when viewing a single row from the results. Normally, when your query returns a single row

WOW will take you directly to the tabbed view for that row instead of displaying a list view containing

a single row. However, this behavior can be overridden setting theautomaticTabView property to false:

Tabs {

defaultTab: C_HISTORY;

maxTabsPerLine: 7;

automaticTabView: false;

}

In this case, after running a tabbed operation, the results will always be displayed in a list view, even if there

is only a single row to display. You can still click on the View Details link (the magnifying glass) for any row to

view that row in a tabbed view. The automaticTabView property is specified in the tabbed operation, not the

tab data operations.

Allowing Tab Display

Sometimes, you may want the results of an operation to be displayed inside of a tab, but the details of that

operation to be displayed outside of a tab. Using the allowInTab property you can specify exactly when an

operation is allowed to be displayed in a tab:

Tabs {

allowInTab: results;

}

There are 4 settings for this property:

• • always – Displays both the results and details in a tab.

  • details – Only the details (not the results) should be displayed in a tab.

  • never – Neither the details nor results should be displayed in a tab.

  • results – Only the results (not the details) should be displayed in a tab.

Unlike all other properties in the Tabs property group, the allowInTab property must be specified in the tab

data operation, and not the tabbed operation.

Empty Tab Results

When a tabbed operation is run and there are no results, WOW can either display an empty table of the results,

or can leave the results section of the screen here is blank.

Here is a tabbed search example that hides empty results:

The hideWhenEmpty property controls which method WOW uses to display empty tab results. When hideWhenEmpty

is true, WOW will not display any results; if it is false then an empty Row Collection will be displayed. If the

hideWhenEmpty property is not specified, it defaults to the same value as the automaticTabView property.

You can also define a message to display to the user when there are no results using the emptyMessage property.

Tabs {

hideWhenEmpty: true;

emptyMessage: There is no information available for the month/year that you have selected;

}

Changing Tab Field Order

On each field descriptor there is a display order. Fields with the lowest display order will get listed first.

The exact behavior is:

• 1. Find the field with the lowest display order.

  2. Put that field and any other fields within the same field set together then get the next lowest field set and

     1. display those.

NOTE: In the FD Manager, there is an operation on the left called "display properties" that will allow you to set the

display order and field set from an updateable table so you do not have to go into each FD one at a time.

Hiding Search Parameters

There are times when you may want the search parameters for the Tab Parent operation to only be displayed long

enough to perform the search successfully. Using the alwaysShowSearch property, you can specify whether the

search parameters should continue to be displayed (default behavior), or if they should be removed to provide more

space for displaying the results from the Tab Parent operation:

Tabs {

alwaysShowSearch: false;

}

There are 2 settings for this property:

• • true – Always show the search parameters in the Tab Parent operation. This is the default value if this

    • property is omitted.

  • false – Once the Tab Parent operation successfully shows a record (row), hide the search parameters.

The alwaysShowSearch property is specified in the tabbed operation, not the tab data operation.