Difference: 0LASubrConvertTranslate (5 vs. 6)

Revision 62017-07-13 - JeanNeron

Line: 1 to 1

META TOPICPARENT	name="APPXRuntimeSubroutineAPI"

.CONVERT TRANSLATE

Line: 14 to 14

PASS <trans_type> FIELD SHARE? N PASS <trans_app_id> FIELD SHARE? N PASS <trans_ver_id> FIELD SHARE? N

Added:

>
>

SET --- .CONVERT TRANSLATE =

SUBR --- .CONVERT TRANSLATE DETACHED END? N FAIL 0

- Check for errors IF --- .CONVERT TRANSLATE NE

Line: 36 to 37

<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.

Added:

>
>

Text: One or more paragraphs. If a translation is not found for the entire block of text, it will be broken down into paragraphs, then sentences, then clauses, then words. In each case it will look for a translation of that paragraph, sentences or clause. The word level translation depends on the setting of the 'Translate Words' on the from Language record.
Clause: One or more words or phrases within a sentence. If a translation is not found, word level translation will be attempted, based on the 'Translate Words' on the from Language record.
Token: A TOKEN field or an ALPHA field with table values consisting of a word or a phrase which requires an exact match with an entry in the dictionary.
Message: Text from the system MESSAGE file requires an exact match with an entry in the dictionary.
Field: One or more phrases and words which requires an exact match with an entry in the dictionary.

Changed:

<
<

Text:One or more paragraphs
Clause:One or more words or phrases within a sentence
Token:A TOKEN field or an ALPHA field with table values consisting of a word or a phrase which requires an exact match with a Token entry in the dictionary.
Message:Text from the system MESSAGE file requires an exact match with a Message entry in the dictionary.
Field:One or more phrases and words.

>
>

Token, Message and Field all follow the same rules for translating, i.e., they look for an exact match. If a match is not found, the text will be added to the Application Dictionary under the specified <trans_type>.

<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.

Line: 50 to 52

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

Changed:

<
<

Note that this routine will return the <source_text> in the <trans_text> field if it is unable to translate <source_text>. In other word, you will always get something back from this routine, either the translated text, or as best a translation as possible. This is especially true if you are translating text which contain paragraphs or sentences. The translation routine always starts with the largest block of text and works it's way down until it has attempted everything. If it can find a match for the enter block of text, it will return that. If not, it will then look for matches of the paragraphs in the text. If it can find a match for the paragraph, it will return that. If not, it will look for matches at the sentence level. If it still cannot find a match, it will attempt to translate individual words, depending on the "Translate Words" setting on the <from_lang> file. Thus the result returned could be a mix of the original text and the portions that were able to be translated.

>
>

In all cases, if a translation is not found in the Application Dictionary, then the System Dictionary will be checked. If a translation is still not found, the text will be added to the Application Dictionary.

Note that this routine will return the <source_text> in the <trans_text> field if it is unable to translate <source_text>. In other words, you will always get something back from this routine, either the translated text, or as best a translation as possible. This is especially true if you are using the 'Text' <trans_type>. The translation routine always starts with the largest block of text and works it's way down until it has attempted everything. If it can find a match for the entire block of text, it will return that. If not, it will then look for matches of the paragraphs in the text. If it can find a match for the paragraph, it will return that. If not, it will look for matches at the sentence level. If it still cannot find a match, it will attempt to translate individual words, depending on the "Translate Words" setting on the <from_lang> file. Thus the result returned could be a mix of the original text and the portions that were able to be translated.

Comments:

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

It appears that the fields <trans_app_id> and <trans_ver_id> are indeed required, as it doesn't always seem to default properly to the currently running application/version.

Changed:

<
<

-- AlKalter - 2014-10-01

<--/commentPlugin-->

>
>

-- AlKalter - 2014-10-01

<--/commentPlugin-->

-- JeanNeron - 2012-02-04 \ No newline at end of file

View topic | History: r8 < r7 < r6 < r5 | More topic actions...