Embedding a new language in MICROS Retail OSCAR POS
The following description deals with:
For further help go to:
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 (LINUX / WINDOWS):
- 0 = CP ISO 8859-1 LINUX /1252
WINDOWS
- 1 = CP ISO 8859-2 LINUX
- 2 = CP ISO 8859-15 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.
- 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.
- 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