Une définition de document localisée est une définition de document traduite dans une autre langue que celle dans laquelle elle a été créée à l’origine. Lors de l’installation d’ABBYY FlexiCapture, vous pouvez sélectionner une langue de l’interface utilisateur. Si une définition de document est disponible dans la langue de l’interface utilisateur sélectionnée, FlexiCapture utilise cette version localisée.
Lors de la localisation d’une définition de document, les éléments suivants sont traduits :
- les libellés de champ, les boutons et le texte du formulaire de données
- les noms de champ dans la boîte de dialogue où les enregistrements du jeu de données sont ajoutés et modifiés
- les noms de champ dans la boîte de dialogue où le fournisseur associé à un lot d’entraînement peut être modifié
- les libellés de champ affichés à l’utilisateur lorsqu’il spécifie des régions qui n’ont pas été détectées automatiquement
- les libellés de champ dans la boîte de dialogue de recherche dans la base de données appelée depuis l’éditeur de documents
- les noms de colonne dans la liste déroulante affichée dans la boîte de dialogue de recherche dans la base de données
- les noms de règle affichés à l’opérateur lorsque des erreurs de règle se produisent
- les messages des scripts utilisateur (par exemple, les messages affichés par les règles de script, les paramètres d’exportation et les gestionnaires d’événements)
Un utilisateur qui modifie une définition de document travaille toujours avec les valeurs d’origine non localisées. Un opérateur travaillant dans l’éditeur de documents voit les valeurs localisées affichées dans la langue de son interface utilisateur.
Le processus de localisation
Les définitions de document sont localisées en trois étapes :
- Les identifiants des chaînes à localiser sont exportés dans un fichier texte.
- Le texte localisé est fourni pour chaque identifiant de chaîne dans le fichier texte.
- Le texte localisé et les identifiants correspondants (appelés collectivement la localisation) sont importés du fichier texte dans la définition de document.
La localisation est importée uniquement dans une définition de document qui contient des chaînes avec les identifiants utilisés dans la localisation.
Le fichier de localisation
Le fichier de localisation est un fichier TXT qui contient une liste de chaînes localisées. Les chaînes de ce fichier sont triées selon le type d’élément d’interface dans lequel elles apparaissent (libellés des champs, nom de Document Definition, messages système et messages de script), puis par ordre alphabétique de leur nom. La boîte de dialogue Localization Options propose des commandes permettant de créer et de gérer des fichiers de localisation.
Exemple de chaîne non encore traduite dans un fichier de localisation :
Dans cet exemple, BANK_CODE est l’identifiant de la chaîne. Aucun autre champ de la définition de document ne peut avoir le même identifiant. Cet identifiant est généré automatiquement de l’une des deux manières suivantes : à partir du nom du champ ou à l’aide du modèle FC_<number of the field>.
L’identifiant est suivi d’une virgule, puis de la chaîne affichée à l’utilisateur, entre guillemets (Bank code). Cette chaîne est celle qui est traduite lors de la localisation.
Lorsque la chaîne est traduite puis réimportée dans la définition de document, un délimiteur de commentaire (deux barres obliques), suivi de la chaîne d’origine (Bank Code), est automatiquement ajouté après la chaîne localisée. La chaîne d’origine est la chaîne par défaut affichée aux utilisateurs qui modifient la définition de document.
La chaîne ci-dessus se présente comme suit une fois localisée en russe :
Syntaxe du fichier de localisation
Localiser une définition de document avec un fichier de localisation
Création d’un fichier de localisation
Ouvrir Localization Options
Dans le Document Definition Editor, cliquez sur Document Definition → Localization → Localization Options.
Sélectionner une langue et exporter
Sélectionnez une langue pour laquelle vous souhaitez créer un fichier de localisation (les langues sans fichier de localisation ont le statut Nonlocalized), puis cliquez sur le bouton Export.
Enregistrer le fichier
Dans la boîte de dialogue qui s’ouvre, indiquez le dossier et le nom du fichier de localisation.
Édition d’un fichier de localisation
Traduire les chaînes
Ouvrez le fichier de localisation dans un éditeur de texte et traduisez les chaînes.
Enregistrer le fichier
Enregistrez le fichier. Assurez-vous qu’il est encodé en Unicode.
Importer un fichier de localisation dans une Document Definition
Ouvrir Localization Options
Dans le Document Definition Editor, cliquez sur Document Definition → Localization → Localization Options.
Sélectionner une langue et importer
Sélectionnez la langue pour laquelle vous souhaitez importer un fichier de localisation, puis cliquez sur le bouton Import.
Indiquer le fichier
Indiquez le chemin d’accès au fichier de localisation dans la boîte de dialogue qui s’ouvre. Le statut de la langue devient Localized.
Enregistrer la Document Definition
Enregistrez la Document Definition.
Après l’importation d’un fichier de localisation, le formulaire de données du Document Definition Editor contient toujours le texte par défaut (non localisé). Le texte localisé apparaît uniquement dans l’éditeur de documents.
Les utilisateurs de Project Setup Station ne peuvent afficher le texte localisé que lors du test des Document Definitions, et uniquement si la langue de localisation est sélectionnée comme langue d’interface d’ABBYY FlexiCapture. Si une chaîne localisée est plus longue que la chaîne d’origine, les champs du formulaire de données se déplacent pour s’y adapter.
Supprimer une localisation
Ouvrir Localization Options
Dans le Document Definition editor, cliquez sur Document Definition → Localization → Localization Options.
Sélectionner la langue
Sélectionnez la langue de la localisation à supprimer. Les langues pour lesquelles une localisation est disponible ont le statut Localized.
Supprimer la localisation
Supprimez la localisation. Le statut de la langue devient Nonlocalized.
Localiser les messages des scripts utilisateur
Vous pouvez localiser les messages des scripts utilisateur, notamment ceux des règles de script et des gestionnaires d’événements. Les messages de script localisés s’affichent lorsque la langue d’interface correspondante est sélectionnée dans ABBYY FlexiCapture.
Créer des identifiants de message
Dans le Document Definition editor, cliquez sur Document Definition → Localization → Localizable Script Messages. Dans la boîte de dialogue qui s’ouvre, cliquez sur Add pour créer un identifiant pour chaque message et définir son texte par défaut. Utilisez Edit pour modifier un message ou Delete pour en supprimer un.
Fournir le texte localisé
Référencer les identifiants dans votre script
Appeler des messages localisés à partir de scripts
Pour récupérer un message à partir d’un script utilisateur, utilisez l’objet FCTools.LocalizedStrings. Cet objet utilise la méthode IProperties.
L’exemple de code suivant renvoie un message localisé ayant pour identifiant MY_MESSAGE_1 :