Insert Host Component

With the Insert Host Component wizard, you select the screen from which you want to extract a host component. You also select a region on the screen from which to extract a host component by drawing a rectangle around the text. Place your cursor at any point on the screen, click and hold the left mouse button, and move the cursor to another location on the screen to draw the rectangle. The fields at the bottom of the wizard show the starting and ending row and column numbers of the rectangle. You can also enter the row and column numbers by typing the numbers in the fields.

You can highlight certain fields on your host screen by selecting the different options beside Highlight fields. If you want to see where the input fields are defined on the screen, select the Input check box. If you want to see what fields are protected, select the Protected check box. If you want to highlight any hidden fields, select the Hidden check box. To modify the colors of the input, protected or hidden fields highlighting, see Using ZIETrans preferences. When you have selected the starting and ending row and column numbers of the screen, click Next to display the rendering options for the host components found in the selected region.

ZIETrans provides host components and widgets. You can select one of the host components and widgets provided or you can create your own custom host components and widgets. For more information about host components and widgets see Component and widget descriptions and settings.

Click one of the components in the Components list. The Component Preview window displays the component if it is found in the screen region. If you want to use text replacement for the component, click the Text Replacement icon to the right of the component list to open and edit the settings. For more information about text replacement, see Text Replacement.

You select the widget to use to render the host component from the widgets in the corresponding Widgets list. When you select a widget, the Widget Preview window displays how the widget is displayed in the final Web page. A larger widget preview is available if you click the Widget preview in large window icon (the magnifying glass).

You can override the default project-level settings for individual instances of components and widgets by clicking the Component Settings and Widget Settings icons to the right of the Components and Widgets lists. The default project-level settings for components and widgets are configured using the Rendering tab of the project editor. See Rendering for more information.

Click the Advanced settings for rendering icon to the right of the Widgets list to specify advanced rendering options. The project-level default advanced rendering settings are configured using the Rendering tab of the project editor. See Rendering for more information.

For ZIETrans Web projects, clicking Full page preview shows all the components on the page along with the associated template. This preview shows the page as it will appear to the user.
Note: When you insert a ZIETrans component into a free layout table of a transformation, the Full page preview function in the Insert Host Component wizard always shows the new component at the top of the free layout table. The preview can be misleading, the component will be inserted at the right location inside the table once you click Finish in the wizard.
To see a full page preview, use the preview functions located in one of the following areas of the ZIETrans Toolkit:
  • Screen capture editor preview tab
  • Host terminal preview tab
  • Screen customization wizard / Select actions panel preview button
  • New transformation wizard / Rendering options panel preview button.

For information about the settings that can be customized with the Insert Host Component wizard, see Component and widget settings. The widgets that are available depend on the selected host components. Table 1 lists the existing ZIETrans host components and their corresponding widgets.

If ZIETrans does not find the component in the screen region, the Component Preview window displays the message No component_name components where found in the specified region, where component_name is the component selected in the Components list. If this message is displayed, you might have selected a region that does not contain the complete component, or you might need to use the Component Settings dialog to modify the settings of the component to match the way your host application displays the component. For example, you might have a Command Line component in the region, but your command line uses the token >>> instead of ==>. You can change the token attribute of the Command Line component to look for a command line with the correct token.

Click Finish when you have made your component and widget selections.