.CONVERT TRANSLATE

This subroutine converts a string from one language to another.

Usage:

      PASS         <trans_text>               FIELD            SHARE? Y
      PASS         <trans_error>              FIELD            SHARE? Y
      PASS         <source_text>              FIELD            SHARE? N
      PASS         <from_lang>                FIELD            SHARE? N
      PASS         <to_lang>                  FIELD            SHARE? N
      PASS         <trans_type>               FIELD            SHARE? N
      PASS         <trans_app_id>             FIELD            SHARE? N
      PASS         <trans_ver_id>             FIELD            SHARE? N
      SUBR     --- .CONVERT TRANSLATED              DETACHED     END? N  FAIL 0
      *        Check for errors
      IF       --- .CONVERT TRANSLATE         NE

Description:

This subroutine converts a string from one language to another. The first five parameters are required, if any are missing the subroutine will CANCEL. The <trans_type>, <trans_app_id> and <trans_ver_id> parameters are optional. The translation uses the Dictionaries and Translations you have entered in the applications. Note that this routine should be invoked via SUBR with a RELATED or DETACHED invocation to ensure none of your fields are changed.

<trans_text> is the translated version of <source_text> (Required). This must be PASSed with Share "Y" to return the value.

<trans_error> contains any addiitonal error messages from the translation (Required). This must be PASSed with Share "Y" to return the value.

<source_text> is the text you want translated (Required).

<from_lang> is the language ID that identifies <source_text> (Required). This must be a valid language code as defined in Appx System Administration.

<to_lang> is the languge Id you want <source_text> translated to (Required). This must be a valid language code as defined in Appx System Administration.

<trans_type> is the type of translation desired (Optional). Must be one of Field, Token, Clause, Message or Text. Defaults to Field if not PASSed, or is blank.

<trans_app_id> is the Application Id whose dictionaries should be used for the translation (Optional). Defaults to the current application if not PASSed, or is blank.

<trans_ver_id> is the Version Id whose dictionaries should be used for the translation (Optional). Defaults to the current version if not PASSed, or is blank.

If <trans_text> is too small to contain the converted text, --- .CONVERT TRANSLATE will contain 'Data was truncated'.

Comments:

Read what other users have said about this page or add your own comments.

-- JeanNeron - 2012-02-04