Adding Blocks to Screens

  1. In the Explorer Tree, locate the object to which you wish to add a block.  

  1. There are options in adding a block to the screen at this point.

  1. The Adding New Block screen will be displayed.

  2. In the Create block similar to pop-list, if you wish to create the block based on an existing block on the screen, select the desired block here.  Otherwise, select (none).  This option is only available if you are adding the block to an entity and not another block.

  3. In the Block Name property, enter the name of the new block that you are adding to the screen.

  4. In the Block Type pop-list, select the desired type.  Choices are Standard Block, Tab Block, Chart Block, Bread Crumb, iFrame, Basic Drag Drop, and Cascading Menu

  5. The choices displayed are dependent upon the block type selected.

Standard Block
  1. In the Query Type property, select the type of query for the block.  Choices are:

  1. In the Datasource property, select the desired datasource or (use default).  

    Selecting (use default) will allow the block to be used with any datasource, and data brought in will be determined by the screen's or template's datasource.

    If Xephr Service was selected, this pop-list will only list the datasources that provide Xephr services.
    If Xephr Interconnect was selected, this pop-list will only list the Xephr Interconnect datasources.

  2. If Simple Query was selected, in the Table pop-list, select the database table/view on which to base the block.

  1. If Xephr Service was selected, in the Table pop-list, select the Xephr Service method on which to base the block.  Choices are determined by the datasource selected.

  2. If Xephr Interconnect was selected, in the Interconnect Entity pop-list, select the published entity on which to base the block.  Choices are determined by the published entities on the datasource selected.

  3. Set the Create Heading flag to determine if a heading will be created for this block.  When this checkbox is set to on, an additional non-database label field is created in which the heading can be entered for the block.

  4. If Xephr Interconnect was selected, in the Target Login property, enter the user ID that will be used to access the published entity.

  5. If Xephr Interconnect was selected, in the Target Password property, enter the password that will be used to access the published entity.

  6. Select the mode(s) in which this block will be displayed for this screen.  There are four flags here, one for each mode - QBE, List, Edit, New.  

    For each mode in which you wish the block to be displayed, set the flag to on.  For each mode in which you do not wish the block to be displayed, set the flag to off.

  7. Select the scheme for the new block.  Choices are Form and List.  

    Form scheme indicates that label fields and database column fields will be created within the same block and listed from the top to the bottom of the screen.  

    List scheme indicates that label fields and database column fields will be created in different blocks and listed from the left to the right of the screen.  

    In general, if only one record will be displayed in the block on the screen, select the Form radio button.  If multiple records will be displayed in the block on the screen, select the List radio button.

  8. Click on the Next button in the bottom right of the screen to continue.

  9. The information displayed next is dependent on the setting of the Query Type property.

Not From Query
  1. Since none of the fields will be created from the database, the Adding New Labels screen will be displayed.

  2. To add a new label, click on the Add button.

  3. In the field that appears under the Fields section, enter the name of the Label and press the Enter key on your keyboard.

  4. Repeat until you have entered all desired labels.

  5. To delete a label that you have created, click on the desired label and press the Delete button.

  6. When all desired labels have been entered, click on the Next button on the bottom right of the screen.

  7. The labels will be added to the block.  

  8. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Simple Query
  1. A list of the columns in the selected table will be displayed.

  2. Set the Key Required flag to the desired setting.  This flag defaults to on, which indicates that at least one column that is selected must have the Key flag set to on.  The Next button cannot be pressed until the key column is selected or this flag is set to off.

  3. For each column, indicate whether the column is a primary key for the view by setting the Key flag to on or off.  

    To set the Key flag for all displayed columns, left-click once on the gray Key column header.

  4. For each column, indicate whether the column will be included as a field on this block by setting the Field flag to on or off.

    To set the Field flag for all displayed columns, left-click once on the gray Field column header.

  5. For each column, indicate whether a label should be created for the field on this block by setting the Label flag to on or off.

    To set the Label flag for all displayed columns, left click once on the gray Label column header.

  6. For each column, in the Display As pop-list, select the desired setting to display the data for this column.  Choices are:

  1. For each column, in the Style pop-list, select the field style to be applied, or leave the setting at (from parent) to have the field style defined at the block level.  

  2. For each column, in the Format pop-list,  select the format mask for this field from the list of pre-defined format masks.  

    Date fields must have a format mask entered.  Format masks can only be applied to date, currency, and numeric fields.  

    For more information, see the Format Masks section.

  3. In the Filters property, enter the filters used to restrict the information returned by the select statement for the block, if appropriate.  This is also referred to as the where clause.  The statement begins with the word WHERE.  

    Format: WHERE column (comparison) value AND column (comparison) value
    For example: WHERE qty_on_hand > 0 AND stock_um in ('FT','IN')

  4. In the Ordering and Grouping property, enter any code to be executed after the filters, such as the order by or group by.

    Format: ORDER BY column, column, column
    Format: GROUP BY column, column, column
    For example: ORDER BY description, stock_um, qty_on_hand desc

  5. Click on the Next button in the bottom right of the screen to continue.

  6. The next step is to set up the order of the columns for the block. Using the Move Up and Move Down buttons, arrange the columns to be in the order that you wish them to be displayed on the block.

  7. Press the Next button at the bottom right of the screen to continue.

  8. The next step is to create additional joins if there are multiple blocks on the screen.  If you wish to create joins, set the Create Join flag to on.

    Additional properties will be displayed to allow you to define the joining column.

    In the From Column property, select the column on the child block that will be joined to the parent block.

    In the To Block property, select the block that contains the column to which the from column will be joined.

    In the To Column property, select the column to which you are joining the from column.

    The join will be added to the block when the block is created.  Joins are created as equal joins automatically.

    For more information on joins, see the Joining Data on Blocks section.

  9. Click on the Next button at the bottom right of the screen to continue.

  10. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Complex Query
  1. In the Select Statement property, enter the select statement for your database query, beginning with the word SELECT.  The select statement lists the columns in the table or view from which the data will be returned.  

    All columns selected from the database need to be explicitly named.

    Format: SELECT column, column, column, column FROM view
    For example: SELECT item_no, description, stock_um, qty_on_hand FROM item_master_uvw

  2. In the Filters property, enter the filters used to restrict the information returned by the select statement for the block, if appropriate.  This is also referred to as the where clause.  The statement begins with the word WHERE.  

    Format: WHERE column (comparison) value AND column (comparison) value
    For example: WHERE qty_on_hand > 0 AND stock_um in ('FT','IN')

  3. In the Ordering and Grouping property, enter any code to be executed after the filters, such as the order by or group by.

    Format: ORDER BY column, column, column
    Format: GROUP BY column, column, column
    For example: ORDER BY description, stock_um, qty_on_hand desc

  4. Click on the Next button in the bottom right of the screen to continue.

  5. A list of the columns in the selected table will be displayed.

  6. Set the Key Required flag to the desired setting.  This flag defaults to on, which indicates that at least one column that is selected must have the Key flag set to on.  The Next button cannot be pressed until the key column is selected or this flag is set to off.

  7. For each column, indicate whether the column is a primary key for the view by setting the Key flag to on or off.  

    To set the Key flag for all displayed columns, left-click once on the gray Key column header.

  8. For each column, indicate whether the column will be included as a field on this block by setting the Field flag to on or off.

    To set the Field flag for all displayed columns, left-click once on the gray Field column header.

  9. For each column, indicate whether a label should be created for the field on this block by setting the Label flag to on or off.

    To set the Label flag for all displayed columns, left click once on the gray Label column header.

  10. For each column, in the Display As pop-list, select the desired setting to display the data for this column.  Choices are:

  1. For each column, in the Style pop-list, select the field style to be applied, or leave the setting at (from parent) to have the field style defined at the block level.  

  2. For each column, in the Format pop-list,  select the format mask for this field from the list of pre-defined format masks.  

    Date fields must have a format mask entered.  Format masks can only be applied to date, currency, and numeric fields.  

    For more information, see the Format Masks section.

  3. Press the Next button at the bottom right of the screen to continue.

  4. The next step is to set up the order of the columns for the block. Using the Move Up and Move Down buttons, arrange the columns to be in the order that you wish them to be displayed on the block.

  5. Press the Next button at the bottom right of the screen to continue.

  6. The next step is to create additional joins if there are multiple blocks on the screen.  If you wish to create joins, set the Create Join flag to on.

    Additional properties will be displayed to allow you to define the joining column.

    In the From Column property, select the column on the child block that will be joined to the parent block.

    In the To Block property, select the block that contains the column to which the from column will be joined.

    In the To Column property, select the column to which you are joining the from column.

    The join will be added to the block when the block is created.  Joins are created as equal joins automatically.

    For more information on joins, see the Joining Data on Blocks section.

  7. Click on the Next button at the bottom right of the screen to continue.

  8. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Xephr Service
  1. A list of the columns for the selected Xephr method will be displayed.

  2. For each column, indicate whether the column is a primary key for the view by setting the Key flag to on or off.  

    To set the Key flag for all displayed columns, left-click once on the gray Key column header.

  3. For each column, indicate whether the column will be included as a field on this block by setting the Field flag to on or off.

    To set the Field flag for all displayed columns, left-click once on the gray Field column header.

  4. For each column, indicate whether a label should be created for the field on this block by setting the Label flag to on or off.

    To set the Label flag for all displayed columns, left click once on the gray Label column header.

    You cannot set the Label flag to on unless the Field flag is also set to on for that column.

  5. Click on the Next button in the bottom right of the screen to continue.

  6. The next step is to set up the order of the columns for the block. Using the Move Up and Move Down buttons, arrange the columns to be in the order that you wish them to be displayed on the block.

  7. Press the Next button at the bottom right of the screen to continue.

  8. The next step is to create additional joins if there are multiple blocks on the screen.  If you wish to create joins, set the Create Join flag to on.

    Additional properties will be displayed to allow you to define the joining column.

    In the From Column property, select the column on the child block that will be joined to the parent block.

    In the To Block property, select the block that contains the column to which the from column will be joined.

    In the To Column property, select the column to which you are joining the from column.

    The join will be added to the block when the block is created.  Joins are created as equal joins automatically.

    For more information on joins, see the Joining Data on Blocks section.

  9. Click on the Next button at the bottom right of the screen to continue.

  10. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Xephr Interconnect
  1. A list of the columns in the selected entity will be displayed.

  2. For each column, indicate whether the column is a primary key for the view by setting the Key flag to on or off.  

    To set the Key flag for all displayed columns, left-click once on the gray Key column header.

  3. For each column, indicate whether the column will be included as a field on this block by setting the Field flag to on or off.

    To set the Field flag for all displayed columns, left-click once on the gray Field column header.

  4. For each column, indicate whether a label should be created for the field on this block by setting the Label flag to on or off.

    To set the Label flag for all displayed columns, left click once on the gray Label column header.

  5. For each column, in the Display As pop-list, select the desired setting to display the data for this column.  Choices are:

  1. For each column, in the Style pop-list, select the field style to be applied, or leave the setting at (from parent) to have the field style defined at the block level.  

  2. For each column, in the Format pop-list,  select the format mask for this field from the list of pre-defined format masks.  

    Date fields must have a format mask entered.  Format masks can only be applied to date, currency, and numeric fields.  

    For more information, see the Format Masks section.

  3. Click on the Next button in the bottom right of the screen to continue.

  4. The next step is to set up the order of the columns for the block. Using the Move Up and Move Down buttons, arrange the columns to be in the order that you wish them to be displayed on the block.

  5. Press the Next button at the bottom right of the screen to continue.

  6. The next step is to create additional joins if there are multiple blocks on the screen.  If you wish to create joins, set the Create Join flag to on.

    Additional properties will be displayed to allow you to define the joining column.

    In the From Column property, select the column on the child block that will be joined to the parent block.

    In the To Block property, select the block that contains the column to which the from column will be joined.

    In the To Column property, select the column to which you are joining the from column.

    The join will be added to the block when the block is created.  Joins are created as equal joins automatically.

    For more information on joins, see the Joining Data on Blocks section.

  7. Click on the Next button at the bottom right of the screen to continue.

  8. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Tab Block
  1. Tab blocks are used to contain other blocks and display them in tabular format.  

  2. In the Selected Style property, select the style to apply to a tab when it is the active tab.

  3. In the Un-Selected Style property, select the style to apply to a tab when they are inactive.

  4. Click on the Next button at the bottom right of the screen to continue.

  5. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Chart Block
  1. In the Query Type property, select the type of query for the block.  Choices are:

  1. In the Datasource property, select the desired datasource or (use default).  

    Selecting (use default) will allow the block to be used with any datasource, and data brought in will be determined by the screen's or template's datasource.

    If Xephr Service was selected, this pop-list will only list the datasources that provide Xephr services.
    If Xephr Interconnect was selected, this pop-list will only list the Xephr Interconnect datasources.

  2. If Simple Query was selected, in the Table pop-list, select the database table/view on which to base the block.

  3. If Xephr Service was selected, in the Table pop-list, select the Xephr Service method on which to base the block.  Choices are determined by the datasource selected.

  4. If Xephr Interconnect was selected, in the Interconnect Entity pop-list, select the published entity on which to base the block.  Choices are determined by the published entities on the datasource selected.

  5. If Xephr Interconnect was selected, in the Target Login property, enter the user ID that will be used to access the published entity.

  6. If Xephr Interconnect was selected, in the Target Password property, enter the password that will be used to access the published entity.

  7. In the Chart Type pop-list, select the type of chart that will be displayed in this block.  See the Chart Block section for more information on each of these charts.  Choices are as follows:

  1. In the Chart Title property, enter the title for this chart block.

  2. Set the Create Heading flag to determine if a heading will be created for this block.  When this checkbox is set to on, an additional non-database label field is created in which the heading can be entered for the block.

  3. Select the mode(s) in which this block will be displayed for this screen.  There are four flags here, one for each mode - QBE, List, Edit, New.  

    For each mode in which you wish the block to be displayed, set the flag to on.  For each mode in which you do not wish the block to be displayed, set the flag to off.

  4. Click on the Next button in the bottom right of the screen to continue.

  5. The information displayed next is dependent on the setting of the Query Type property.

Not From Query
  1. Since none of the fields will be created from the database, the Adding New Labels screen will be displayed.

  2. To add a new label, click on the Add button.

  3. In the field that appears under the Fields section, enter the name of the Label and press the Enter key on your keyboard.

  4. Repeat until you have entered all desired labels.

  5. To delete a label that you have created, click on the desired label and press the Delete button.

  6. When all desired labels have been entered, click on the Next button on the bottom right of the screen.

  7. The labels will be added to the block.  

  8. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Simple Query
  1. A list of the columns in the selected table will be displayed.

  2. For each column, indicate whether the column is a primary key for the view by setting the Key flag to on or off.  

    To set the Key flag for all displayed columns, left-click once on the gray Key column header.

  3. For each column, in the Used As pop-list, select one of the following:

  1. In the Filters property, enter the filters used to restrict the information returned by the select statement for the block, if appropriate.  This is also referred to as the where clause.  The statement begins with the word WHERE.  

    Format: WHERE column (comparison) value AND column (comparison) value
    For example: WHERE qty_on_hand > 0 AND stock_um in ('FT','IN')

  2. In the Ordering and Grouping property, enter any code to be executed after the filters, such as the order by or group by.

    Format: ORDER BY column, column, column
    Format: GROUP BY column, column, column
    For example: ORDER BY description, stock_um, qty_on_hand desc

  3. Click on the Next button on the bottom right of the screen to continue.

  4. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Complex Query
  1. In the Select Statement property, enter the select statement for your database query, beginning with the word SELECT.  The select statement lists the columns in the table or view from which the data will be returned.  

    All columns selected from the database need to be explicitly named.

    Format: SELECT column, column, column, column FROM view
    For example: SELECT item_no, description, stock_um, qty_on_hand FROM item_master_uvw

  2. In the Filters property, enter the filters used to restrict the information returned by the select statement for the block, if appropriate.  This is also referred to as the where clause.  The statement begins with the word WHERE.  

    Format: WHERE column (comparison) value AND column (comparison) value
    For example: WHERE qty_on_hand > 0 AND stock_um in ('FT','IN')

  3. In the Ordering and Grouping property, enter any code to be executed after the filters, such as the order by or group by.

    Format: ORDER BY column, column, column
    Format: GROUP BY column, column, column
    For example: ORDER BY description, stock_um, qty_on_hand desc

  4. Click on the Next button in the bottom right of the screen to continue.

  5. A list of the columns in the selected table will be displayed.

  6. For each column, indicate whether the column is a primary key for the view by setting the Key flag to on or off.  

    To set the Key flag for all displayed columns, left-click once on the gray Key column header.

  7. For each column, in the Used As pop-list, select one of the following:

  1. Click on the Next button on the lower right of the screen to continue.

  2. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Xephr Service
  1. A list of the columns for the selected Xephr method will be displayed.

  2. For each column, indicate whether the column is a primary key for the view by setting the Key flag to on or off.  

    To set the Key flag for all displayed columns, left-click once on the gray Key column header.

  3. For each column, in the Used As pop-list, select one of the following:

  1. Click on the Next button on the lower right of the screen to continue.

  1. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Xephr Interconnect
  1. A list of the columns in the selected published entity will be displayed.

  2. For each column, in the Used As pop-list, select one of the following:

  1. Click on the Next button on the bottom right of the screen to continue.

  2. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Bread Crumb Block
  1. In the Query Type property, select the type of query for the block.  Choices are:

  1. In the Datasource property, select the desired datasource or (use default).  

    Selecting (use default) will allow the block to be used with any datasource, and data brought in will be determined by the screen's or template's datasource.

    If Xephr Interconnect was selected, this pop-list will only list the Xephr Interconnect datasources.

  2. If Simple Query was selected, in the Table pop-list, select the database table/view on which to base the block.

  3. If Xephr Interconnect was selected, in the Interconnect Entity pop-list, select the published entity on which to base the block.  Choices are determined by the published entities on the datasource selected.

  4. Set the Create Heading flag to determine if a heading will be created for this block.  When this checkbox is set to on, an additional non-database label field is created in which the heading can be entered for the block.

  5. If Xephr Interconnect was selected, in the Target Login property, enter the user ID that will be used to access the published entity.

  6. If Xephr Interconnect was selected, in the Target Password property, enter the password that will be used to access the published entity.

  7. In the Separator Type property, select Text or Image.  The separator type determines what character or image will be used to separate the values in the bread crumb block.

  8. In the Separator property, if you selected Text, enter the separator character.  If you selected Image, enter the file path to the desired image from the Xephr server.

  9. In the Body Style property, select the style to be applied to the block.  The default is (from parent) allowing the style to be determined from the screen properties.

  10. In the Non-Editable Field Style property, select the style to be applied to labels and display only field on this block.  The default is (from parent) allowing the style to be determined from the Non-Editable Field Style applied to the screen.

  11. In the Link Style property, select the link style that defines the styles that will be used for hyperlinks on this block.  The default is (from parent) allowing the style to be determined from the screen properties.

  12. Select the mode(s) in which this block will be displayed for this screen.  There are four flags here, one for each mode - QBE, List, Edit, New.  

    For each mode in which you wish the block to be displayed, set the flag to on.  For each mode in which you do not wish the block to be displayed, set the flag to off.

  13. Click on the Next button in the bottom right of the screen to continue.

  14. The information displayed next is dependent on the setting of the Query Type property.

Not From Query
  1. Since none of the fields will be created from the database, the Adding New Labels screen will be displayed.

  2. To add a new label, click on the Add button.

  3. In the field that appears under the Fields section, enter the name of the Label and press the Enter key on your keyboard.

  4. Repeat until you have entered all desired labels.

  5. To delete a label that you have created, click on the desired label and press the Delete button.

  6. When all desired labels have been entered, click on the Next button on the bottom right of the screen.

  7. The labels will be added to the block.  

  8. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Simple Query
  1. A list of the columns in the selected table will be displayed.

  2. Set the Link flag to on for the column that will be displayed as the link on the bread crumb block.  Only one column can have this flag set to on.

  3. Set the Support flag to on for any columns that need to be included on the block to support the link column.  The column selected as the Link column cannot have the Support flag set to on.

  4. In the Filters property, enter the filters used to restrict the information returned by the select statement for the block, if appropriate.  This is also referred to as the where clause.  The statement begins with the word WHERE.  

    Format: WHERE column (comparison) value AND column (comparison) value
    For example: WHERE qty_on_hand > 0 AND stock_um in ('FT','IN')

  1. In the Ordering and Grouping property, enter any code to be executed after the filters, such as the order by or group by.

    Format: ORDER BY column, column, column
    Format: GROUP BY column, column, column
    For example: ORDER BY description, stock_um, qty_on_hand desc

  2. Click on the Next button in the bottom right of the screen to continue.

  3. The next step is to set up the order of the columns for the block. Using the Move Up and Move Down buttons, arrange the columns to be in the order that you wish them to be displayed on the block.

  4. Click on the Next button at the bottom right of the screen to continue.

  5. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Complex Query
  1. In the Select Statement property, enter the select statement for your database query, beginning with the word SELECT.  The select statement lists the columns in the table or view from which the data will be returned.  

    All columns selected from the database need to be explicitly named.

    Format: SELECT column, column, column, column FROM view
    For example: SELECT item_no, description, stock_um, qty_on_hand FROM item_master_uvw

  2. In the Filters property, enter the filters used to restrict the information returned by the select statement for the block, if appropriate.  This is also referred to as the where clause.  The statement begins with the word WHERE.  

    Format: WHERE column (comparison) value AND column (comparison) value
    For example: WHERE qty_on_hand > 0 AND stock_um in ('FT','IN')

  3. In the Ordering and Grouping property, enter any code to be executed after the filters, such as the order by or group by.

    Format: ORDER BY column, column, column
    Format: GROUP BY column, column, column
    For example: ORDER BY description, stock_um, qty_on_hand desc

  4. Click on the Next button in the bottom right of the screen to continue.

  5. A list of the columns in the selected table will be displayed.

  6. Set the Link flag to on for the column that will be displayed as the link on the bread crumb block.  Only one column can have this flag set to on.

  7. Set the Support flag to on for any columns that need to be included on the block to support the link column.  The column selected as the Link column cannot have the Support flag set to on.

  8. Press the Next button at the bottom right of the screen to continue.

  9. The next step is to set up the order of the columns for the block. Using the Move Up and Move Down buttons, arrange the columns to be in the order that you wish them to be displayed on the block.

  10. Click on the Next button at the bottom right of the screen to continue.

  11. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Xephr Interconnect
  1. A list of the columns in the selected published entity will be displayed.

  2. Set the Link flag to on for the column that will be displayed as the link on the bread crumb block.  Only one column can have this flag set to on.

  3. Set the Support flag to on for any columns that need to be included on the block to support the link column.  The column selected as the Link column cannot have the Support flag set to on.

  4. Click on the Next button in the bottom right of the screen to continue.

  5. The next step is to set up the order of the columns for the block. Using the Move Up and Move Down buttons, arrange the columns to be in the order that you wish them to be displayed on the block.

  6. Click on the Next button at the bottom right of the screen to continue.

  7. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

iFrame Block
  1. iFrame blocks are used to display external documents within the block.

  2. Click on the Next button at the bottom right of the screen to continue.

  3. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Basic Drag Drop Block
  1. Basic Drag Drop blocks are used to display the data in multiple columns, and allow the user to drag and drop the record from one column to another.  See the Basic Drag Drop Blocks section for more information about this type of block and its requirements.

  2. In the Query Type property, select the type of query for the block.  Choices are:

  1. In the Datasource property, select the desired datasource or (use default).  

    Selecting (use default) will allow the block to be used with any datasource, and data brought in will be determined by the screen's or template's datasource.

    If Xephr Interconnect was selected, this pop-list will only list the Xephr Interconnect datasources.

  2. The Table pop-list will be displayed if Simple Query or Xephr Service was selected as the query type.

    If Simple Query was selected, select the database table/view on which to base the block.
     

  3. The Interconnect Entity, Target Login, and Target Password properties are displayed if Xephr Interconnect was selected as the query type.

    In the Interconnect Entity pop-list, select the published entity on which to base the block.  Choices are determined by the published entities on the datasource selected.

    In the Target Login property, enter the user ID that will be used to access the published entity.

    In the Target Password property, enter the password that will be used to access the published entity.

  4. In the Number of Containers property, enter the total number of containers that will be displayed in the block, between which the records can be moved.

  5. In the Container Id Column property, enter the column from the complex query, or select the column from the table that is used to store the container ID for the record.  The container ID determines in which container the record will be placed when the block is loaded, and is updated when records are moved between containers.

  6. In the X Column property, enter the column from the complex query, or select the column from the table that is used to store the location in pixels of the top left corner of the record on the X axis (horizontal) of the container to which the record has been assigned.

  7. In the Y Column property, enter the column from the complex query, or select the column from the table that is used to store the location in pixels of the top left corner of the record on the Y axis (vertical) of the container to which the record has been assigned.

  8. Set the Collapsible flag to the desired setting.  When this flag is set to on, at runtime the detail block can be collapsed so that the entire detail block is hidden or can be expanded and displayed. When this flag is set to off, the detail block cannot be hidden and expanded, and will always be displayed.

  9. If the Collapsible flag is set to on, set the Initial State property to the desired setting.  When set to Collapsed, the records will be loaded on the block with the detail block collapsed and hidden.  When set to Expanded, the records will be loaded on the block with the detail block expanded and displayed.

  10. Select the mode(s) in which this block will be displayed for this screen.  There are four flags here, one for each mode - QBE, List, Edit, New.  

    For each mode in which you wish the block to be displayed, set the flag to on.  For each mode in which you do not wish the block to be displayed, set the flag to off.

  11. Click on the Next button in the bottom right of the screen to continue.

  12. The information displayed next is dependent on the setting of the Query Type property.

Simple Query
  1. A list of the columns in the selected table will be displayed.

  2. For each column, indicate whether the column is a primary key for the view by setting the Key flag to on or off.  

    To set the Key flag for all displayed columns, left-click once on the gray Key column header.

  3. For each column, indicate whether the column will be included as a field on the header block by setting the Header flag to on or off.  Fields selected for the header block cannot be included on the detail block.

    To set the Header flag for all displayed columns, left-click once on the gray Header column header.  

  4. For each column, indicate whether the column will be included as a field on the detail block by setting the Detail flag to on or off.  Fields selected for the detail block cannot be included on the header block.

    To set the Detail flag for all displayed columns, left-click once on the gray Detail column header.

  5. For each column, indicate whether a label should be created for the field on this block by setting the Label flag to on or off.

    To set the Label flag for all displayed columns, left click once on the gray Label column header.

  6. For each column, in the Style pop-list, select the field style to be applied, or leave the setting at (from parent) to have the field style defined at the block level.  

  7. For each column, in the Format pop-list,  select the format mask for this field from the list of pre-defined format masks.  

    Date fields must have a format mask entered.  Format masks can only be applied to date, currency, and numeric fields.  

    For more information, see the Format Masks section.

  8. In the Filters property, enter the filters used to restrict the information returned by the select statement for the block, if appropriate.  This is also referred to as the where clause.  The statement begins with the word WHERE.  

    Format: WHERE column (comparison) value AND column (comparison) value
    For example: WHERE qty_on_hand > 0 AND stock_um in ('FT','IN')

  9. In the Ordering and Grouping property, enter any code to be executed after the filters, such as the order by or group by.

    Format: ORDER BY column, column, column
    Format: GROUP BY column, column, column
    For example: ORDER BY description, stock_um, qty_on_hand desc

  10. Click on the Next button in the bottom right of the screen to continue.

  11. The next step is to set up the order of the columns for the block. Using the Move Up and Move Down buttons, arrange the columns to be in the order that you wish them to be displayed on the blocks.

  12. Press the Next button at the bottom right of the screen to continue.

  13. The next step is to create additional joins if there are multiple blocks on the screen.  If you wish to create joins, set the Create Join flag to on.

    Additional properties will be displayed to allow you to define the joining column.

    In the From Column property, select the column on the child block that will be joined to the parent block.

    In the To Block property, select the block that contains the column to which the from column will be joined.

    In the To Column property, select the column to which you are joining the from column.

    The join will be added to the block when the block is created.  Joins are created as equal joins automatically.

    For more information on joins, see the Joining Data on Blocks section.

  14. Click on the Next button at the bottom right of the screen to continue.

  15. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Complex Query
  1. In the Select Statement property, enter the select statement for your database query, beginning with the word SELECT.  The select statement lists the columns in the table or view from which the data will be returned.  

    All columns selected from the database need to be explicitly named.

    Format: SELECT column, column, column, column FROM view
    For example: SELECT item_no, description, stock_um, qty_on_hand FROM item_master_uvw

  2. In the Filters property, enter the filters used to restrict the information returned by the select statement for the block, if appropriate.  This is also referred to as the where clause.  The statement begins with the word WHERE.  

    Format: WHERE column (comparison) value AND column (comparison) value
    For example: WHERE qty_on_hand > 0 AND stock_um in ('FT','IN')

  3. In the Ordering and Grouping property, enter any code to be executed after the filters, such as the order by or group by.

    Format: ORDER BY column, column, column
    Format: GROUP BY column, column, column
    For example: ORDER BY description, stock_um, qty_on_hand desc

  4. Click on the Next button in the bottom right of the screen to continue.

  5. A list of the columns in the selected table will be displayed.

  6. For each column, indicate whether the column is a primary key for the view by setting the Key flag to on or off.  

    To set the Key flag for all displayed columns, left-click once on the gray Key column header.

  7. For each column, indicate whether the column will be included as a field on the header block by setting the Header flag to on or off.  Fields selected for the header block cannot be included on the detail block.

    To set the Header flag for all displayed columns, left-click once on the gray Header column header.  

  8. For each column, indicate whether the column will be included as a field on the detail block by setting the Detail flag to on or off.  Fields selected for the detail block cannot be included on the header block.

    To set the Detail flag for all displayed columns, left-click once on the gray Detail column header.

  9. For each column, indicate whether a label should be created for the field on this block by setting the Label flag to on or off.

    To set the Label flag for all displayed columns, left click once on the gray Label column header.

  10. For each column, in the Style pop-list, select the field style to be applied, or leave the setting at (from parent) to have the field style defined at the block level.  

  11. For each column, in the Format pop-list,  select the format mask for this field from the list of pre-defined format masks.  

    Date fields must have a format mask entered.  Format masks can only be applied to date, currency, and numeric fields.  

    For more information, see the Format Masks section.

  12. Press the Next button at the bottom right of the screen to continue.

  13. The next step is to set up the order of the columns for the block. Using the Move Up and Move Down buttons, arrange the columns to be in the order that you wish them to be displayed on the block.

  14. Press the Next button at the bottom right of the screen to continue.

  15. The next step is to create additional joins if there are multiple blocks on the screen.  If you wish to create joins, set the Create Join flag to on.

    Additional properties will be displayed to allow you to define the joining column.

    In the From Column property, select the column on the child block that will be joined to the parent block.

    In the To Block property, select the block that contains the column to which the from column will be joined.

    In the To Column property, select the column to which you are joining the from column.

    The join will be added to the block when the block is created.  Joins are created as equal joins automatically.

    For more information on joins, see the Joining Data on Blocks section.

  16. Click on the Next button at the bottom right of the screen to continue.

  17. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

Xephr Interconnect
  1. A list of the columns in the selected entity will be displayed.

  2. For each column, indicate whether the column is a primary key for the view by setting the Key flag to on or off.  

    To set the Key flag for all displayed columns, left-click once on the gray Key column header.

  3. For each column, indicate whether the column will be included as a field on the header block by setting the Header flag to on or off.  Fields selected for the header block cannot be included on the detail block.

    To set the Header flag for all displayed columns, left-click once on the gray Header column header.  

  4. For each column, indicate whether the column will be included as a field on the detail block by setting the Detail flag to on or off.  Fields selected for the detail block cannot be included on the header block.

    To set the Detail flag for all displayed columns, left-click once on the gray Detail column header.

  5. For each column, indicate whether a label should be created for the field on this block by setting the Label flag to on or off.

    To set the Label flag for all displayed columns, left click once on the gray Label column header.

  6. For each column, in the Style pop-list, select the field style to be applied, or leave the setting at (from parent) to have the field style defined at the block level.  

  7. For each column, in the Format pop-list,  select the format mask for this field from the list of pre-defined format masks.  

    Date fields must have a format mask entered.  Format masks can only be applied to date, currency, and numeric fields.  

    For more information, see the Format Masks section.

  8. Click on the Next button in the bottom right of the screen to continue.

  9. The next step is to set up the order of the columns for the block. Using the Move Up and Move Down buttons, arrange the columns to be in the order that you wish them to be displayed on the block.

  10. Press the Next button at the bottom right of the screen to continue.

  11. The next step is to create additional joins if there are multiple blocks on the screen.  If you wish to create joins, set the Create Join flag to on.

    Additional properties will be displayed to allow you to define the joining column.

    In the From Column property, select the column on the child block that will be joined to the parent block.

    In the To Block property, select the block that contains the column to which the from column will be joined.

    In the To Column property, select the column to which you are joining the from column.

    The join will be added to the block when the block is created.  Joins are created as equal joins automatically.

    For more information on joins, see the Joining Data on Blocks section.

  12. Click on the Next button at the bottom right of the screen to continue.

  13. At this point a new screen is displayed.  If you wish to add another block, set the Add Block or Labels flag to on and press the Next button.  

  1. Otherwise, press the Finish button in the bottom right of the screen.

 

Xephr is a registered trademark of NDS Systems, LC.

Copyright © 2007 NDS Systems LC.