Description des fichiers d'Up ! Natural Language Support

Introduction

La langue choisie correspond à la variable environnement UPS_LANGUAGE. Sa valeur est l'une des suivantes :

A chaque module peut être associé un fichier Nls. En ce cas, le fichier Nls porte le même nom que le module. Up ! Natural Language Support se charge de la gestion de ces fichiers, en particulier leur chargement et leur exploitation au travers des API présentées dans ce manuel. Ces fichiers Nls comportent différentes sections classifiant les informations.

Les fichiers Nls doivent accessibles via la variable environnement obligatoire UPS_NLS qui n'a pas de valeur par défaut. Cette variable contient une liste de répertoires séparés par un caractère point-virgule : ou deux-points : selon la plate-forme. A chaque répertoire cité dans la valeur de cette variable, Up ! Natural Language Support adjoint le sous-répertoire correspondant à la langue de la configuration de l'utilisateur.

Une section d'un fichier Nls comporte une succession d'entrées identifiées par des mots-clé immuables quelle que soit la langue choisie. Les mots-clés doivent être deux à deux distincts pour une section. A chaque mot-clé est associé un texte correspondant à la traduction dans la langue de l'utilisateur. Voici les sections supportées :

• Api.
  Toutes les traductions correspondant aux Application Program Interfaces d'Up ! Virtual Business Machine ou d'Up ! Virtual Technical Machine sont rangées dans cette section.
  
• CallParametre.
  Toutes les traductions correspondant aux noms des paramètres des procédures, des fonctions ou des méthodes sont rangées dans cette section.
  
• Environment.
  Toutes les traductions correspondant aux variables environnement d'Up ! Virtual Business Machine ou d'Up ! Virtual Technical Machine sont rangées dans cette section.
  
• Help.
  Toutes les traductions correspondant aux aides contextuelles sont rangées dans cette section.
  
• Instruction.
  Toutes les traductions correspondant aux instructions d'Up ! 5GL ou à ses extensions sont rangées dans cette section.
  
• Message.
  Toutes les traductions correspondant aux messages sont rangées dans cette section.
  Le format du texte doit respecter la convention suivante :
  • Le message comporte au plus cinq paramètres numérotés de 1 à 5 modélisé par %s dans le message.
  • L'en-tête du message comporte six chiffres de 0 à 5. 0 symbolise le nom du module ayant envoyé le message ; 1 à 5 symbolisent les cinq paramètres du message. Les six chiffres dans l'en-tête du message spécifie dans quel ordre doivent être passés les paramètres afin de formater le message correctement.
  • Le texte du message dans la langue du pays comportant le symbole %s pour chaque paramètre.
• Miscellanous.
  Toutes les traductions non autrement classifiables sont rangées dans cette section.
  
• ModuleParameter.
  Toutes les traductions correspondant aux noms des paramètres des modules rangées dans cette section.
  
• Rule.
  Toutes les traductions correspondant aux noms des règles d'analyse sémantique ou d'expertise métier dans cette section.
  
  

Il est possible de partager un fichier de ressources linguistiques entre plusieurs modules d'un même application, voire entre plusieurs applications. Cela s'effectue au moyen d'un thésaurus, qui n'est pas rattaché à un module particulier.

Les thésaurus sont conservés dans le répertoire ${UPS_HOME}/upsnls/${UPS_LANGUAGE}. Le thésaurus sélectionné est celui indiqué par le paramètre thesaurus.

Exemple

[Miscellaneous]
Oui=oui
Vrai=vrai
Groupe=groupe

[Message]
CreationImpossible=012345Erreur %s-1 : Impossible de créer '%s'.
SuppressionImpossible=012345Erreur %s-2 : Impossible d'effacer '%s'.
ChangementRepertoireImpossible=012345Erreur %s-3 : Impossible de changer de répertoire dans '%s'.
RepertoireCourantImpossible=012345Erreur %s-4 : Impossible de lire le répertoire courant.
RenommageImpossible=012345Erreur %s-5 : Impossible de renommer '%s' en '%s'.
ExecutionImpossible=012345Erreur %s-6 : Impossible d'exécuter '%s' : %s.
ChangementDroitDAccesImpossible=012345Erreur %s-7 : Impossible de changer les droits de '%s'.
LireDroitDAccesImpossible=012345Erreur %s-8 : Impossible de lire les droits de '%s'.
AlarmeImpossible=012345Erreur %s-9 : Impossible de poser une alarme.
LireCaracteristiquesImpossible=012345Erreur %s-10 : Impossible de lire les caracteristiques de '%s'.
ArretImpossible=012345Erreur %s-11 : Impossible d'arrêter le processus '%s'.
LireCodeRetourImpossible=012345Erreur %s-12 : Impossible de lire le code-retour du processus '%s'.
LireTempsImpossible=012345Erreur %s-13 : Impossible de lire les temps d'exécution du processus.
CopieImpossible=012345Erreur %s-14 : Impossible de copier '%s' en '%s'.

[Api]
Ecran=Ecran
FichierListe=FichierListe
ProcessusListe=ProcessusListe
UniteListee=UniteListee