Embedding a new language in MICROS Retail OSCAR POS

The following description deals with:

• Creation of a new Language
• New Entries and Modifications for Texts in a particular Language
• Technical Embedding (init UiText, dofgl.fgl)

For further help go to:

• Fade in / out the Selection panel for Languages in the Program Dispatch
• Embedding new Online Help Texts

Creation of a new language

Open the window System -> User Interface -> Languages.

A new language has to be entered with a free number in the update program Languages. The Name and the appropriate character sets will be defined there, too.

Attention!
Please note that the value for the environment variable "InternalCodePage=0-7" for the conversion of the character set table has to be set up correctly in the file oscar.ini to guarantee that the correct character table for the user interface and the input / output of the connected peripheral devices for the MICROS Retail OSCAR POS applications are supported.

The following value ranges (currently 0 - 7) are permitted – depending on the operating system (UNIX / LINUX / WINDOWS):

• 0 = CP ISO 8859-1 (UNIX / LINUX) /1252 WINDOWS
• 1 = CP ISO 8859-2 (UNIX / LINUX)
• 2 = CP ISO 8859-15 (UNIX / LINUX)
• 3 = WINDOWS 1250 (East Europe)
• 4 = WINDOWS (Turkish)
• 5 = WINDOWS (Baltic)
• 6 = WINDOWS (Cyrillic)
• 7 = WINDOWS (Greek)

The following numbers are occupied or reserved for particular languages:

• 1 German
• 2 English
• 3 French
• 4 Swedish
• 5 Norwegian
• 6 Finnish
• 7 Danish
• 8 Spanish
• 9 reserved
• 10 Dutch
• 11 Hrvatski ( = Croatian)
• 12 Czech
• 13 Slovenian
• 14 Hungarian
• 15 Italian
• 16 Polish
• 17 Portuguese
• 18 Greek
• 19 Icelandic
• 20 Cyrillic
• 21 Crnogorski ( = Montenegro)
• 22 Bosanski ( = Bosnian)
• 23 Srpski = (Serbia)
• 24 Makedonski = (Macedonia) 
• 99 Wizard (reserved)

Notes:

• The number assignment is the exclusive right of MICROS Retail Deutschland GmbH.
• The name of the language must not be changed or modified.

After saving the entries, the formal creation of the language in MICROS Retail OSCAR POS is complete.

---

New Entries and Modifications for Texts in a particular Language

• The language –related texts for forms, form and menu texts are stored in the ASCII files DbText and UiText in the MICROS Retail OSCAR POS application.
• Modifications and new entries in DbText.asc UiText.asc. can be carried out by use of an editor.
  Both files are structured in a way that they contain all existing mask texts (menu entries, field names etc.) sorted by languages.
  
  Example:
  1,CardType ,TABLENAME ,Kartentypen [Deutsch]
  2,CardType ,TABLENAME ,Card types [English]
  3,CardType ,TABLENAME ,Types de Carte [Francais]
  ...
  13,CardType ...
  1,CardUsage ,TABLENAME ,Kartennutzung [Deutsch]
  2,CardUsage ,TABLENAME ,Card Usage [English]
  3,CardUsage ,TABLENAME ,Utilisation Cartes [Francais]
  ...
  13,CardUsage ...
• For every new text, the number with which the language has been recorded in the program Languages must be entered.
  Note:
  Generally, there is the possibility of translating the texts little by little, but with a later "dofgl.fgl", there may be error messages if the system finds missing text numbers. Therefore, it makes sense to duplicate the texts of one language completely and to store them with a new number before translating them little by little.
• Modifications and new entries in the files "UiText.asc" and "DbText.asc" have to be imported in the MICROS Retail OSCAR POS database via the commands "oscar init UiText" and “oscar init DbText". By execution of the command oscar dofgl.fgl <Name of Language> the generation of screen masks, reports etc. takes place.
• If there are only some extensions to texts, the texts can also be updated via the update programs System -> User Interface -> Form Fields, Menu Texts, Menu Fields etc.. The input will usually be valid immediately. Please note that the modifications will be overwritten with the next release / update. This can only be avoided by selecting the Update Mode “never” in the mask Forms. However, this means that possible modifications to the standard versions will not be accepted, too.

Attention!

• If changes have been made (translation of: mask texts, online help etc.), you have to inform the development department in Berlin. Only by this, you can make sure that the modifications will be integrated into the MICROS Retail OSCAR POS standard application and that they will be included in the next release / update.

---

Technical Embedding of the Modifications

• Enter the directory ..\ work and execute the following commands:
• oscar init UiText
  oscar init DbText
  By both commands, the new texts will be imported into the MICROS Retail OSCAR POS database.
  Attention!
  As from version Oscar 3.5 the texts for the standard languages 1 = German, 2 = English and 3 = French are no longer together in files UiText.asc and DbText.asc.
  In the standard version the files UiText.asc and DbText.asc only contain language 2 =English. Languages 1 = German and 3 = French will be provided in separate files and must be added to the files DbText.asc and UiText.asc before a new language is embedded or prior to update. Adding another language must be done with command "oscar addAscFiles". After execution of this command in directory "..\work" the user must then decide which additional language is to be added to the English version. At present only the additional languages German and French are on offer. After the choice has been made, the commands "oscar init UiText" and "oscar init DbText" as well as "oscar dofgl.fgl lang" must be executed.
  
  Example language selection:
  
  Selection of languages to MICROS Retail OSCAR POS database.
  add further languages to English(UK).
  Enter one or more number of the following list.
  Enter the number, separate with comma or
   type 'a' for all,
   blank or nothing, only English (UK) is used.
  
  0) – DE
  1) – FR
• oscar dofgl.fgl <Name of Language>
  Notes:
  "Name of Language" means the name as it is stored in the update program Languages. Make sure the spelling is correct.
  By the command "oscar dofgl.fgl <Name of Language>", a series of FGL files will be executed by which e.g. the screen masks with the modified texts will be generated.
  If you want changes in a screen mask of a particular update program only, you can also run a particular FGL file instead of the common dofgl.fgl command.

• Changes to the screen mask for the program dispatch (update program= Dispatch") would only become effective after you executed the command oscar UiDispatch.fgl <Name of Language>.
• A language which has already been embedded in the system with command "oscar dofgl.fgl Sprache" can only be deleted with the following command:
  
  oscar delfgl.fgl Sprache

---

MICROS Retail Deutschland GmbH
Salzufer 8
D-10587 Berlin

Germany