LANG^DIALOGZ: File Modification for Multiple Languages

LANG^DIALOGZ(): File Modification for Multiple Languages

Description

The LANG^DIALOGZ API is invoked from Programmer mode to modify the user dialog to show file components in a language different than the one used to define the file. It is part of the ongoing initiative to internationalize VA FileMan.

Among the items that you can translate are:

• File name
• Field name
• Help text for a field
• External value of SET OF CODES fields

You can see the translated values using the Standard output of the List File Attributes [DILIST] option.

Format

LANG^DIALOGZ(langnum)

Input Parameter

Example

The sample dialog in Figure 352 illustrates the addition of French language translations to some items in a file. The examples below do not include possible translations of any of the VA FileMan prompts.

During this session, the following fields are translated:

• Name of the file
• Name of two fields
• Help text for one field
• External values of a SET OF CODES for the other field

NOTE: The syntax for entering the translated SET OF CODES is the external values in order, separated by a semicolon.

Figure 352: LANG^DIALOGZ API—Sample User Dialog

    >D LANG^DIALOGZ(4) <Enter> ;4 is ID NUMBER of French in Language File (#.85)

    Modify what File: ZZD TEST FILE1 <Enter> (3 entries)
    FRENCH translation of ZZD TEST FILE1: ZZD FICHIER DE TEST

    Select FIELD: NAME <Enter>
    FRENCH translation of NAME: NOM <Enter>
    Current NAME Field Help Prompt:
      NAME MUST BE 3-30 CHARACTERS, NOT NUMERIC OR STARTING WITH PUNCTUATION
    FRENCH translation of Prompt: NOM EST 3-30 CARACTERES, PAS NUMERIC NI COMMENCEMENT
    AVEC DES SIGNES DE PONCTUATION. <Enter>

    Select FIELD: YES/NO <Enter>
    FRENCH translation of YES/NO: OUI/NON <Enter>
    Current SET values: Y:Yes;N:No;U:Unknown
    FRENCH translation of SET values: ? <Enter>
    YOU MUST ENTER 3 EXTERNAL VALUES, SEPARATED BY SEMICOLONS(;).
    FRENCH translation of SET values: Oui;Non;Inconnu <Enter>
    Select FIELD: <Enter>

The user sees the translated values when the value of DUZ("LANG") is set and the ID NUMBER of a language for which the translations are performed. In the examples in Figure 353, DUZ("LANG")=4.

The complete integration of the translated values is a work in progress. The sample dialog in Figure 353 shows how the translated values are used. Comments are added in callouts to illustrate interesting aspects of the current state of the translation program.

Figure 353: LANG^DIALOGZ API—Sample Translated Editing Dialog

    Select OPTION: ENTER OR EDIT FILE ENTRIES <Enter>


       Translated file name cannot be used here.


    Input to what File: ZZD TEST FILE1 <Enter>


       Translated field name is echoed.


    EDIT WHICH FIELD: ALL// .01 <Enter>         NAME         NOM


       Original field name must be used; translated is echoed.


    THEN EDIT FIELD: YES/NO <Enter>          OUI/NON
    THEN EDIT FIELD: <Enter>


       In editing dialog, translated file and field names used.


    Select ZZD FICHIER DE TEST NOM: EN FRANCAIS <Enter>
      Are you adding 'EN FRANCAIS' as a new ZZD FICHIER DE TEST (the 4TH)? No// Y
    <Enter> (Yes)


       Translated external values for sets of codes are displayed.


    OUI/NON: ? <Enter>
         Choose from:
           1        Oui
           2        Non
           3        Inconnu


       Translated external value is echoed.


    OUI/NON: 2 <Enter>     Non

    Select ZZD FICHIER DE TEST NOM: EN FRANCAIS NUMERO DEUX <Enter>
      Are you adding 'EN FRANCAIS NUMERO DEUX' as
        a new ZZD FICHIER DE TEST (the 5TH)? No// Y <Enter> (Yes)


       Untranslated external value is not accepted.


    OUI/NON: Yes??
         Choose from:
           1        Oui
           2        Non
           3        Inconnu
    OUI/NON: O <Enter> Oui

    Select ZZD FICHIER DE TEST NOM: EN FRANCAIS NUMERO DEUX <Enter>
    NOM: EN FRANCAIS NUMERO DEUX Replace ? <Enter>
         NOM EST 3-30 CARACTERE, PAS NUMERIC NI COMMENCEMENT AVEC DES SIGNES DE
         PONCTUATION.


       Help text is translated.


    NOM: EN FRANCAIS NUMERO DEUX Replace DEUX With TROIS <Enter>
      Replace <Enter>
       EN FRANCAIS NUMERO TROIS
    OUI/NON: Oui// In <Enter> Inconnu

During the Print File Entries dialog, you must use the untranslated values for the file and field names. However, the output shows translated file and field names as well as translated external values for the SET OF CODES.

NOTE: The internal values of the SET OF CODES field remain as originally defined.

Figure 354: LANG^DIALOGZ API—Sample Translated Print File Entries Dialog

    Select OPTION: PRINT FILE ENTRIES <Enter>

    Output from what File: ZZD TEST FILE1 <Enter> (5 entries)
    Sort by: NAME// <Enter>
    Start with NAME: FIRST// <Enter>


       Translated field names are echoed.


    First Print FIELD: .01 <Enter> NAME         NOM
    Then Print FIELD: YES/NO <Enter>            OUI/NON
    Then Print FIELD: INTERNAL(YES/NO) <Enter>
    By 'YES', do you mean ZZD TEST FILE1 'YES/NO'? Yes// <Enter> (Yes)
    Then Print FIELD: <Enter>


       Heading is translated.


    Heading (S/C): ZZD FICHIER DE TEST List Replace <Enter>
    STORE PRINT LOGIC IN TEMPLATE: <Enter>
    DEVICE: HOME// <Enter> TELNET

    ZZD FICHIER DE TEST List                              MAR 11,2013@10:19   PAGE 1
    NOM                             OUI/NON INTERNAL(YES/NO)
    -------------------------------------------------------------------------------

    EN FRANCAIS                            Non     N
    EN FRANCAIS NUMERO DEUX                Oui     Y
    FIRST ENTRY
    SECOND ENTRY
    THIRD ENTRY

DIALOGZ places the translations as shown in Figure 355:

Figure 355: LANG^DIALOGZ API—Translations

    ^DIC(filenumber,"ALANG",LangNum, -- Contains the Translation of the file
    name caption for the indicated language.
    ^DD(filenumber,FieldNum,.008,LangNum -- Contains the Translation of the
    field name caption for the indicated language.