Choosing Integration Object templates for a bidirectional project

Two templates are provided as additional functions for ZIETrans projects that use bidirectional code pages. These templates are:

  • HPubTemplateHODBeanBIDI.Default
  • HPubTemplateHODBeanBIDI.Customize

If you create a ZIETrans project that uses a bidirectional code page, HPubTemplateHODBeanBIDI.Default is used by default when you create an Integration Object. If you wish to add customization to your Integration Objects, modify HPubTemplateHODBeanBIDI.Customize and select it on the ZIETrans Preferences page for use in creating Integration Objects.

These templates enable you to specify whether text output by the Integration Object should be reordered. In addition, the data might be retrieved from an application working in Logical mode and displayed by an application working in Visual mode. Therefore, bidirectional reordering for insert and extract can be controlled separately. The following properties are available:
  • PromptReordering - determines whether data retrieved from a Prompt action should be reordered.
  • ExtractReordering - determines whether data retrieved for an Extract action should be reordered.
  • PromptRTLTextOrientation - determines whether data is sent to ZIETrans Web Services in logical right-to-left when promptReordering is true or, visual right-to-left format if promptReordering is false.
  • ExtractRTLTextOrientation - determines whether data from ZIETrans Web Services is received in logical right-to-left if promptReordering is true or, visual right-to-left format if promptReordering is false.
  • PreventRoundTrip: If ExtractReordering is set to true, LRM markers are inserted in the data to prevent a round-trip problem and achieve correct reordering. However presence of these markers might impact data integrity, for example, if the data is needed to be sent to a system which does not process these markers properly. Setting the property to false turns this feature off.
The following methods are supplied to get and set these properties:
public String getPromptReordering();
public String getExtractReordering();
public String getPreventRoundTrip();
public void setPromptReordering(String value);
public void setExtractReordering(String value);
public void setPreventRoundTrip(String value);
  • public void setPromptRTLTextOrientation(String v)
    • Sets whether data retrieved from a Prompt action should be displayed in right-to-left direction (true) or not (false), where parameter v is either true or false

      Set parameter v to true if the data from a Prompt action has right-to-left direction.

  • public String getPromptRTLTextOrientation()
    • Returns whether data retrieved from a Prompt action should be displayed in right-to-left direction (true) or not (false).
  • public void setExtractRTLTextOrientation(String v)
    • Sets whether data retrieved from an Extract action should be displayed in right-to-left direction (true) or not (false), where parameter v is either true or false:

      Set parameter v to true if the data from an Extract action has right-to-left direction.

  • public String getExtractRTLTextOrientation()
    • Returns whether data retrieved from an Extract action should be displayed in right-to-left direction (true) or not (false)
  • public void setPreventRoundTrip(String v)
    • Sets whether data retrieved from an Extract action can include LRMs (true) or not (false) to achieve a correct reordering, where parameter v is either true or false:

      Set parameter v to allow a usage of these markers.

  • public String getPreventRoundTrip()
    • Returns whether usage of LRMs is allowed (true) or not (false)

where value can be true or false. By default these properties are set to false, so that the Integration Objects behave like those that are created with non-bidirectional templates. However, when you use the ZIETrans Toolkit to create Model 1 or JSF Web pages, or for bottom-up Web services, that are based on Integration Objects that were created with these templates, these values are set to true according to options chosen in the studio GUI.