Modifying iFrame Blocks on Screens

In the Explorer Tree, locate the object for which you wish to modify a block.

Expand the Template Information object and select the template screen for which you wish to modify a block.
Expand the Group Information object and any sub-groups until you can select the screen for which you wish to modify a block.

Expand the screen and select the block that you wish to modify.
Display the block properties. These will either be displayed in Alphabetical or Logically, depending on the setting of the [Sort Alphabetically/Logically] button. The following instructions are assuming that the properties are sorted logically.
In the Name property, the name entered during block creation is displayed, and can be changed, if desired.
In the Description property, enter the user-defined description for the block.
In the Parent pop-list, if the parent of this block is another block, the parent block is displayed, grayed out. Otherwise, this pop-list is set to (entity root).
In the Type pop-list, the original setting from the block creation will be displayed, and can be changed, if desired. The type can be Standard Block, Tab Block, Chart Block, Bread Crumb, or iFrame. It should be set to iFrame.
In the Mutability pop-list, select whether this block can be modified on screens that are created from this template. This option is ONLY available for template screens.

When set to Fully Mutable, the block is placed on all screens that inherit from this template and can be modified or deleted.
When set to Positionally Mutable, the block is placed on all screens that inherit from this template and can only be moved.
When set the Not Mutable, the block is placed on all screens that inherit from this template and cannot be modified in anyway.

In the HyperLink To property, enter the URL to the external document that you wish to display in this block.

For example, if you wanted to display the NDS Online Help in the block, you would enter http://www.ndsapps.com/webhelp/xephr22/
In the X property, the location in pixels is displayed for the top left corner of this block or field on the X-axis (horizontal) of the layout screen. You can change this number manually, or it will be changed when you are altering the layout with the Designer Tool.
In the Y property, the location in pixels is displayed for the top left corner of this block or field on the Y-axis (vertical) of the layout screen. This value is used in conjunction with the Y Anchor Type setting. You can change this number manually, or it will be changed when you are altering the layout with the Designer Tool.
In the Y Anchor Type pop-list, select the anchor type for this block. Choices are Fixed and Relative to Block..

When set to Fixed, the upper left corner of this block will be placed a fixed number of pixels in relation to the upper left corner of the block's parent. The number of pixels is defined in the Y field for the block.
When set to Relative to Block, the upper left corner of this block will be placed a fixed number of pixels from the bottom edge of the specified block defined in the Y Anchor field. Example: if you want a particular block to appear immediately after another block which happens to be an Expandable block (and therefore you don't know where it will end on the entity).

In the Y Anchor property, select the block or field that will be used to determine the location of the block on the Y-axis. The property is only displayed when the Y Anchor Type pop-list is set to Block.
In the Width property, enter the width for the block in pixels.
In the Height property, enter the height for the block in pixels.
In the Expand Type pop-list, define the size of the block. Choices are Expandable, Fixed No Scroll Bars, and Fixed with Scroll Bars.

When set to Expandable, the block will be at least the size of the Width and Height values, but it can be larger.
When set to Fixed No Scroll Bars, the block will be the exact size defined using the Width and Height values.
When set to Fixed with Scroll Bars, the block will be the exact sized defined using the Width and Height values, but there will be a scroll bar that allows you to scroll up or down within the block or field.
Example: an address block on a report may be fixed size, while the block for the line items on an invoice will be expandable so that all line items will be visible when the report is generated.

In the Hide If property, enter the conditions under which this block will be hidden. The field will be visible on the block when the conditions are met. When an entry is made in this property, the Show If property will be hidden.

When the expression entered in this property evaluates to true, the field will be hidden. The evaluation of the expression occurs when the entity is generated, and not when the user is making modifications to fields on the block. (i.e. This does not "watch" user input in a field and dynamically show a block; everything is locked in when the block is first output).
Example: $$VENDOR.ACTIVE$$ = 'Y'
Hide the block if the value of the active field on the vendor block is set to Y when the block is generated.
Example: starts-with( $$CUST_NO$$, 'NDS')
Hide the block only if the customer number starts with NDS.
The code entered in this field can also include and/or expressions:
And is indicated by two ampersands &&
Or is indicated by two vertical lines ||

Example: ($$XEPHR_ENTITY_NAME$$='MENU')&&($$NEXTMENU$$='MM')
Hide this block if the current entity is the MENU entity and the NEXTMENU global value is set to MM.

Example: ($$CUST_NO$$='NDS')||($$CUST_NO$$='')
Hide this block if the customer number global is set to NDS, or the customer number global is null or doesn't exist.

In the Show If property, enter the conditions under which this block will be displayed. The block will be hidden when the conditions are met. When an entry is made in this property, the Hide If property will be hidden.

When the expression entered in this property evaluates to true, the field will be displayed. The evaluation of the expression occurs when the entity is generated, and not when the user is making modifications to fields on the block. (i.e. This does not "watch" user input in a field and dynamically hide a block; everything is locked in when the block is first output).
Example: $$VENDOR.ACTIVE$$ = 'N'
The block will be displayed when the value of the active field on the vendor block is N when the entity is generated.
Example: number( $$ORDER.TOTAL$$) = 0
Displays the block if the value of the total field on the order block is zero.
The code entered in this field can also include and/or expressions:
And is indicated by two ampersands &&
Or is indicated by two vertical lines ||

Example: ($$XEPHR_ENTITY_NAME$$='MENU')&&($$NEXTMENU$$='MM')
Show this block if the current entity is the MENU entity and the NEXTMENU global value is set to MM.

Example: ($$CUST_NO$$='NDS')||($$CUST_NO$$='')
Show this block if the customer number global is set to NDS, or the customer number global is null or doesn't exist.

In the Show if Empty pop-list, determine whether the block will be displayed when it is empty. When set to true, the block will be displayed on the screen even when it contains no data. When set to false, the block will be hidden when it contains no data.
In the Z Order property, enter a number to define the order in which the block will be generated on the entity. The higher the number, the later the block will be generated. The Z order is specific to the indention level in the entity tree, and is affected by the Y Anchor and Anchor Type properties.

For blocks with a Tab Block as the parent block, this number determines in which order the tabs will be displayed within the tab block.
Set the Swap Rows/Columns property to the desired setting. When set to true, the location of the rows and columns displayed on the chart will be switched. The display differs for each chart type.
Set the Form is for QBE/NEW property to the desired setting. The setting of this property indicates to the system whether the block's defined query should be executed and return the database results to the screen. For new and QBE screens, since we are either entering a query against the database, or inserting a row into the database, we do not want this to happen.

If this block will be displayed on the screen in QBE or New mode, this property should be set to true.

If the block will not be displayed on the screen in QBE or New mode, this property should be set to false. Edit and list blocks should always have this property set to false, even if the block definition contains new rows.
The Created on property displays the date and time on which this block was created and cannot be changed.
The Modified on property displays the date and time on which this block was last changed and cannot be modified.
When all changes have been made, press the [Save] button in the Main Toolbar.

Xephr is a registered trademark of NDS Systems, LC.