Text Replacement
The Text Replacement tab displays a table in which you can specify the original protected host screen text that you want to replace, together with the text, HTML content (Web-only), or image to use as the replacement. Also shown is whether the text search is case-sensitive and whether regular expression support is being used. Click the Add button to create new text replacement parameters.
You can either select the text you want to replace from the selection window, or type in the text in the Replace text box.
If the Case sensitive check box is selected, it will only search for exact text that you entered in the Replace text box.
To replace with text, type in the text you want replaced in the window below.
If you enter HTML code (Web-only), ZIETrans will highlight it in red allowing you to know whether your code is valid.
- Caption
- The text that you want to appear on the rendered buttons or links
- Action key
- The host AID key to send to the host when the buttons or links are clicked.
- Style class (Web-only)
- The cascading stylesheet (CSS) class name that controls the appearance of the buttons or links. The default for buttons is 'ZIETransBUTTON'. The default for links is 'ZIETransLINK'
You can also replace text with images by clicking the Image radio button and selecting one from the drop-down list, or clicking the Import button.
Replace: ([\.\-|_\w]+)@([\-\_\.\w]+)
With: <a href="mailto:$1@$2" class="ZIETransLINK">$1@$2</a>
would
result in the following replacement, which converts an e-mail
address on a host screen to a link.
Original host screen text: user@company.com
Replacement text:
<a href="mailto:user@company.com" class="ZIETransLINK">user@company.com</a>
You can add, modify, or remove any text replacement specifications by using the buttons to the right of the table of values. The text can be replaced at the project level, rendering item level, transformation level as well as the component level.
- Care should be taken when using text replacement. Text replacement with a disparate number of characters in the strings can cause changes in the GUI representation of the screen. Depending on the widget used for presenting a region of a screen, text on a line of the screen can be contracted, expanded, or forced to a new line. Also, it is generally not efficient to replace strings consisting of a single character or text that has protected fields between it.
- By default, text replacement truncates strings that are longer
than the text being replaced. Sometimes the text is truncated to maintain
the layout of the original host screen on the transformation.
Truncation only occurs on text rendered using the field widget (or
in some cases of the table widget).
To enable text replacement of short strings with longer strings, you can add a source setting, truncateToPreserveLength. The values for this setting are true and false. The default value when the setting is not specified is true, which has no effect on your project. Specifying false enables the longer text replacement. To use this setting, you must not be using default rendering. If you use default rendering, the setting is ignored.
The truncateToPreserveLength setting is a project level setting. It affects all text replacements in the project. If you use this setting, verify that all of your renderings appear as you want them and that any alignment issues that might arise are not problems.
To enable the setting for the entire project, open the source view of the application.hap file. Locate the class for the transform, and add the highlighted setting as shown in the following example:<class name="com.ibm.hats.transform"> <setting name="truncateToPreserveLength" value="false" /> </class>
- Using the selection text window can be very helpful but the actual text which appears in the Replace field is what will actually be replaced. Text replacement cannot be applied across multiple lines or non-protected fields. You cannot select and replace multiple lines of text by using the preview field.
- To replace text with images when the ZIETrans application is accessed through a proxy server, you must configure the ZIETrans application to use the proxy server. For instructions see Configuring ZIETrans applications to use a proxy server.