.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