Templates

Template Configuration

You can establish settings for iNomads templates using Template Configuration Maintenance, which is invoked by using any of the following methods:

Location

Method

From the PxPlus IDE Main Launcher

Expand the Web Deployment category and select iNomads Setup to invoke the iNomads Setup window. Select the Options button.

From a Web browser

Launch iNomads from a Web browser. From the iNomads Application Launchpad window, invoke the iNomads Setup window by either clicking the Admin button or selecting admin from the Transaction drop box. Select the Options button.

From the PxPlus Command prompt

Invoke the iNomads Setup window by entering the following command: RUN "*plus/inomads/admin". Select the Options button.

Template Configuration Maintenance is launched. The name of the template currently selected for maintenance displays in the window header (i.e. "default").

(The display of the template name in the window header was added in PxPlus 2018.)

The options for configuring iNomads templates are presented in a series of 12 tabs: General, Sizing, Overrides, ChkBox, Lists, Folders, Frames, Text, Layout, Tweaks, HTML and Misc. These options represent properties of the iNomads object and are explained in the tables below. These properties are set whenever the iNomads object is instantiated (%iNomads) but can also be set programmatically by referencing them directly.

Example:

%iNomads'Panel_Border=1

The tables below describe the options found on each of the 12 tabs. In each table, the first column displays the actual property name, and the second column displays the corresponding template option with any additional information.

General

Panel position and style

Panel_Align$

Alignment of the panel on the screen.

Setting this defines how the panel will be aligned on the screen.

Panel_Border

Width of the border to include around panel. Setting this to zero will result in no border around the panel.

This is the width of the border around the panel rendering in pixels.

Overlay_Wdws

Overlay windows as opposed to creating popup windows.

When enabled, new panels will overlay the current panel instead of creating a new browser popup window. Overlaying windows improves performance and avoids problems with popup blockers.

Use_Iframes

Use PxPlus 2016 popup overlays to display sub-panels.

When enabled, the system will attempt to use the experimental windows overlay logic based on iFrames.

(This option was added in PxPlus 2016.)

Resizing options

Setwdwsize

Resize the windows on initial load to accommodate the panel size.

If enabled, the system will attempt to grow/shrink the windows to match the size of the panel on the initial load of a panel.

Shrink

Shrink the window to fit size of panel.

If the resize option is enabled (above), this controls whether to shrink the windows, as Windows will always be expanded if required.

Maximize_Browser

Force browser to occupy full screen when 'SHOW'(2) issued.

Note:
Not applicable to all browsers and not a 'true' maximize.

Modal_Close_Child

When running a modal popup window, clicking on the panel windows 'mask' will close the child.

Full_Screen

Force full screen on all resizable panels when loading.

Numeric. When non-zero, forces panels to be maximized when first displayed.

(This option was added in PxPlus 2019.)

 

Sizing

Logical Row and Column size in Pixels

Line_Px

Number of pixels high that each logical line occupies.

The pixel size should be chosen based on the standard text size chosen for the template.

Chr_Px

Number of pixels wide that each logical column occupies.

This value should accommodate the standard text size chosen for the template. If using TABLE rendering, its value must be evenly divisible by COL_PX.

Margins to add to outer edge of your panel

Frame_Width

Pixels to be added to window width to compensate for external margins.

When determining panel sizes, this number of pixels will be added to allow for margin width.

Frame_Height

Pixels to be added to window height to compensate for external margins.

When determining panel sizes, this number of pixels will be added to allow for margin height.

 

Overrides

Colors and Font settings

Use_Fonts

Use application defined font information when displaying text.

Normally, the system uses Style Sheets to control the font of the text. Enabling this option forces iNomads to use Fonts from the panel definition/application code.

Note:
Some standard fixed width fonts such as Courier are always used as defined in the panel/application.

Use_Backcolor

Use application defined background colors when displaying controls/text.

Normally, the system uses Style Sheets to control the background colors. Enabling this option forces iNomads to use Background colors from the panel definition.

Use_Textcolor

Use application defined text colors when displaying controls. Simple text always uses application defined color.

Normally, the system uses Style Sheets to control the text colors. Enabling this option forces iNomads to use Text colors from the panel definition.

Style overrides

Use_Images

Include all static application defined images. Style sheets will provide images. Dynamic images will be included.

Normally, the system uses Style Sheets to provide images. Enabling this option forces iNomads to use Images from the panel definition.

Flat_Img_Btn

Force all Image-only buttons to be 'Flat' (no visible button -- image only).

Lvue_Hilite$

How to handle list view alternate highlighting.

Option is to ignore the setting, 'Use' the colors provided by program, or use the 'StyleSheet' colors.

Use_Fancy_Tip

Use Enhanced tooltips for all TIPs.

Info style Tips are rendered.

Theme$

Assign a Theme.

Themes override text and background colors, font and miscellaneous other visual properties to provide a consistent visual look and feel.

(This option was added in PxPlus 2016.)

 

ChkBox

Check Boxes

Cbx_Use_Css

Don't use standard check boxes. Always use style sheet defined button check boxes.

Normally, the system uses style sheet defined check boxes for Tri-state boxes or those with a background color. Setting this causes the system to use style sheet boxes for all check boxes.

Style sheet generated Check Box contents (Must select Don't use std. above)

Cbx_Css_Val0$

Off text value for text/html within style sheet check boxes (normally blank/empty).

Cbx_Css_Val1$

On text value for text/html within style sheet check boxes (normally check mark).

Cbx_Css_Val2$

3rd state text values for text/html within style sheet check boxes (normally 'X').

 

Lists

List view presentation options

Lvue_Page_Output

Use Paged output for list views.

If enabled, list views and formatted list boxes will be presented as paged output.

Note:
If the list view, list box or grid has fewer than 5 rows, it will only display with a ScrollView using scroll bars (no page numbers across the bottom).

Lvue_Page_Text$

Text to present in front of Page numbers.

Lvue_Send_Cnt

Desired minimum number of items to send when updating screen during initial paint and scrolling.

Leave as zero for all list views to use just what is required.

Height adjustments for List View/Grid

Row_Hi_Pad

The number of pixels in excess of the standard line height for list view rows.

Default is 2 pixels more than line height.

Hdr_Hi_Pad

The number of pixels in excess of the standard line height for list view headers.

Default is 6 pixels more than line height.

Grid_Hi_Pad

The number of pixels in excess of the standard line height for grid rows.

Default is 5 pixels more than line height.

 

Folders

Folder Size and type

Tab_Height

Folder tab height in pixels. Generally this should be between 1.5 and 2 times line height. If zero then 1.5 times line height used.

Use_Webtab

Use Web style vertical tabs for folders as opposed to horizontal tabs.

Default tabs look like folders. Enabling this causes each folder to render vertically.

iNomads unique folder options

Auto_Folder

Folder Auto-invoke option. If enabled, using the arrow keys to change tab will cause folder to be changed immediately.

If disabled, system will require the user to click on folder tab to switch to it.

Special Tweaks for folders

Folder_Factor

Folder height factor. The folder height (in lines) will be multiplied by this value to determine height in HTML (default 0: 1-Without frames, 1.2-With).

If borderless frames are suppressed, we suggest 1; otherwise 1.2.

Folder_Control_Factor

Height multiplication factor to apply to controls over 4 lines high within folders. (Only when using Table rendering).

Setting this will increase the size of controls within Folders in an attempt to compensate for size increase caused by FOLDER_FACTOR (0 = no compensation).

 

Frames

Frame rendering options

Frame_Suppress

Enable suppression of 'Frames' that do not have titles associated with them.

Frames with titles are always displayed in the HTML; however, in some cases, it may be desirable to suppress simple non-titled frames due to overlaps.

Frame_Use_Hr

Use <HR> for single line high frames instead of standard frame display.

Frame will be rendered as a horizontal line.

Frame_Title_Hi

Frame header height override in pixels (0 means use 1 line).

If non-zero, this field specifies the height of a frame header in pixels. Only used in Absolute rendering.

Frame_Bottom_Hi

Frame bottom height to allow for corners etc. in pixels (0 means use 1 line).

If non-zero, this field specifies the height of a frame bottom in pixels. Only used in Absolute rendering.

Single_Frame_Crop

On frames with text (Headers), don't use end frame header formatted cells if frame is 1 line high.

Frame Tweaks

Frame_Btm_Adj

Frame bottom adjustment. Logical number of lines the bottom of a frame will be moved up to compute true bottom.

 

Text

Text message contents for messages display by system

Text_Close$

The text word to be displayed that will 'Close' a window. Default is 'Close' but in multilingual systems you can change this.

Text_Timeout$

Text to display during disconnect countdown when device is left idle too long. Insert ##:## where the countdown is to appear.

Text_Restore$

Text to display when a screen is refreshed due to transmission errors or user sending out of sequence. Also displayed after session rescue.

Text_Relaunch$

The text to be displayed on Application complete screen to relaunch the session.

This text will be displayed with the hyperlink to relaunch the iNomads process. Default is Relaunch.

If this field is blank, relaunch capability is not available.

(This option was added in PxPlus 2019.)

 

Layout

Render_Absolute

Enable absolute rendering as opposed to old-style table base rendering.

Preferred is Absolute over old-style table based. It provides more accurate screen layouts.

Use_Hamburger

Use 3 Line (hamburger ICON) option for menu bar initiation.

If enabled, the system will render a 3 line (&equiv;) option on the panel title to indicate a menu bar.

(This option was added in PxPlus 2016.)

Menu_Hover_Ms

Menu Hover timer.

This defines the number of milli-seconds to hover the mouse over a menu option before it is automatically selected. Default is 1000. If set to 0 (zero), the menu hover has no effect, and the menu option must be manually selected.

(This option was added in PxPlus 2017.)

Table rendering options which are ignored if using absolute rendering

Col_Px

Number of pixels used to define each table column when generating panels.

This defines the resolution used when converting panels to HTML tabular displays. Its value must be an integral factor of CHR_PX, generally 1/2 or 1/3.

Vert_Allowance

Vertical allowance to use when generating HTML. Controls that start within this distance of proceeding control are to be considered on the same line.

If non-zero, controls positions are compared relative prior controls for alignment. If zero, controls are positioned using simple rounding.

Vert_Adj_Method

Use "Original" line spacing algorithm when applying vertical allowance (above).

Vert_Allow_Noframes

Suppress the vertical allowance (above) when rendering frames.

This is only applicable if the vertical allowance is non-zero, otherwise ignored.

Disable_Tr_Height

Don't force table row heights, but allow browser to determine height based on content.

If disabled, this option has been shown to cause random line spacing in FireFox.

Snapto_Lines

Dynamically 'Snap' (align) all controls to standard lines increments.

Set this option to have the system 'Snap' your controls to standard vertical positions.

Hide_Show_Redraw

Refresh screen when hiding/showing controls.

When using a table-based layout, special logic has to be applied to hide controls that occupy same cell. Usually the overlap logic works, but in some instances, it is better to have system just redraw screen on a hide/show.

 

Tweaks

Adjustments based on changes to Style sheet (CSS) and Font from default

Grid_Hi_Adj

The number of pixels higher your style sheet will make grid rows.

Default style sheet increases row height by 1 pixel.

Grid_Wd_Adj

The number of pixels wider your style sheet will make grid columns.

Default style sheet increases width by 1 pixel.

Lvue_Hi_Adj

The number of pixels higher your style sheet will make list view rows.

Default style sheet increases row height by 1 pixel.

Lvue_Wd_Adj

The number of pixels wider your style sheet will make list view columns.

Default style sheet increases width by 1 pixel.

Cbx_Rbt_Adjust

Right justified Check box/Radio Button pixel adjustment.

In NOMADS, the actual placement of right justified Check boxes and Radio Buttons varies based on the font. Use this to apply minor adjustments.

Btn_Sz_Adjust

Amount to adjust button size/position in order to assist alignment.

Buttons beside inputs are often made slightly bigger and positioned slightly above corresponding input field. This adjustment only applies to buttons < 2 lines high.

 

HTML

Ttl_Helpbtn

Include HELP button on title line if help present.

When set and the panel has HELP defined, the system will include a Help button on the titlebar.

(This option was added in PxPlus 2017.)

HTML elements to be used/included in rendering

Meta_Tags$

Additional header META tags to be included in the HTML.

Window_Open$

JavaScript Window.open parameters to use when creating popup windows.

Position and size parameters are generated by the system.

Popup windows suppression

Avoid_Popups

Avoid using popup windows.

If set, system will attempt to avoid using Popup windows to open new browser sessions.

Popup_Pdf_Msg$

Message box text to show when avoiding Popups and viewing .pdf report.

Popup_Msg$

Message box text to show when avoiding Popups and viewing other file/site.

 

Misc

URL settings

Img_Dir$

Image web based URL (In HTML will have "/" appended - Default 'images').

Miscellaneous

Focus_Outline$

Outline to use to highlight current input field. Format is "Color Type Width" such as "Orange solid 1px" or "Invert dotted thin".

Chart_Obj$

Charting object to use. If -none- then no chart will be available. Path must be relative *plus/inomads/add-ons.

Calendar_Qry_Mask$

Mask used to test Query to determine if JavaScript calendar can be used.

If empty, only standard test for the existence of a Query panel with the word 'calendar' is used.

Query_View

Set the default Query View.

Set the default query view for this template. Available selections are:

Default

The setting in %NOMADS'Query_View is used. If %NOMADS'Query_View is not set, the default will be the Toolbar view.

Drop Query

Data is displayed in a Report View list box directly on the current panel. Drop queries load the entire dataset prior to display; therefore, it is advisable to prevent queries that are using large datasets from being displayed as Drop queries by setting this option to Toolbar, Menu or Hybrid.

Toolbar

Standard Query+ display featuring a toolbar to access features.

Menu

Features are accessed by a menu (no toolbar).

Hybrid

This view has an abridged toolbar with the remaining features available in the menu. The layout is somewhat similar to the Classic Query.

Drop Tree

The Drop Tree Query displays data in a Tree View list box directly on the current panel. Drop Tree queries are not recommended for large datasets, as the entire dataset is loaded prior to display. The Drop Tree supports only the Find, Refresh, Print, Filters and Profile features in its right-click popup menu.

To set the query view for all templates, set %NOMADS'Query_View. This is overridden by the Set the default Query View option, which can be overridden at the individual query level. See Query Header Definition.

(Support for setting the default Query View was added in PxPlus 2017.)
(The Drop Query selection was added in PxPlus 2016.)
(The Menu selection was added in PxPlus 2017.)
(The Hybrid selection was added in PxPlus 2017.)
(The Drop Tree selection was added in PxPlus 2021.)

Fkey_Pulldown$

Option to include Function key pull down on Caption line.

A Function key pull down will be included on the caption line to assist on devices without function keys based on the setting of this option.

Rclick_Option$

Option to include Right Mouse click button on Caption line.

When active, a button on the caption line allows the user to indicate the next click submitted to the panel should be considered a Right Mouse click.

Barcode_Option$

Browsers to enable Bar Code Reader Icon on.

Comma separated list of browsers whose caption line allows the user to initiate Bar Code Reader for current input field.

Barcode_Types$

Accepted Bar code that the reader will process (Blank = UPC_A,EAN_13).

Comma separated list of Bar codes that the integrated reader will accept.