Prise en charge des applications bidirectionnelles

Le présent chapitre explique comment utiliser les fonctions fournies par HATS pour le développement d'applications dans des langues bidirectionnelles. En règle générale, son contenu est applicable aux applications en hébreu et en arabe. Les fonctions qui sont spécifiques pour l'arabe sont décrites séparément.

HATS offre les fonctions suivantes pour la prise en charge des langues bidirectionnelles :

Toutes ces fonctions sont explicitées dans la suite du chapitre.

Remarque :
Il n'y a pas de prise en charge bidirectionnelle des objets d'intégration de portlets standard, des substitutions de variables globales, de la communication entre portlets, des services Web pour les portlets à distance et des composants hôte Styler (attention) et Styler (sélection).

Environnement logiciel

La prise en charge des applications bidirectionnelles nécessite l'environnement suivant :

Utilisation du terminal hôte

Le terminal hôte HATS accepte des séquences de touches Host On-Demand spécifiques aux applications bidirectionnelles. Vous pouvez donc exécuter les fonctions bidirectionnelles ci-après. Les touches de fonction suivantes sont disponibles pour les sessions 3270, 5250 et de terminal virtuel :

Ctrl+L : Couche Latin
Cette combinaison de touches active la couche langue Latin et la zone d'informations opérateur est mise à jour pour afficher de l'anglais.
Ctrl+N : Couche bidirectionnelle
Cette combinaison de touches active la couche langue bidirectionnelle et la zone d'informations système est mise à jour pour afficher une langue bidirectionnelle.
Ctrl+S : Ecran inversé
Si l'écran est orienté de gauche à droite, cette combinaison de touches change l'orientation de l'image de la droite vers la gauche et la couche langue devient bidirectionnelle. Si l'écran est orienté de droite à gauche, cette combinaison de touches inverse l'image en gauche vers droite et la couche langue devient Latin. Cette fonction n'est pas disponible dans les sessions visuelles de terminal virtuel.
Ctrl+F : Zone inversée
Si la zone est orientée de gauche à droite, cette combinaison de touches change l'orientation en droite vers gauche, le curseur se déplace vers l'autre côté de la zone et la couche langue devient bidirectionnelle. Si la zone est orientée de droite vers gauche, cette combinaison de touches change l'orientation en gauche vers droite, le curseur se déplace vers l'autre côté de la zone et la couche langue devient Latin. Cela s'applique uniquement aux sessions 5250.

Les touches de fonction suivantes sont disponibles uniquement pour les sessions 3270 :

Ctrl+P : Insertion
Vous pouvez entrer et éditer du texte dans le sens opposé au sens de la zone.
Ctrl+O : Arrêt de l'insertion
Le mode insertion prend fin et le curseur se place à la fin du segment inséré.
Ctrl+A : Insertion automatique
Vous pouvez saisir du texte bidirectionnel mixte gauche vers droite et droite vers gauche en modifiant la couche langue.

La touche de fonction hôte suivante est disponible pour les sessions 5250 uniquement :

Ctrl+C : Rapprochement
Les données entrées dans un sens de frappe (gauche vers droite ou droite vers gauche) sont concaténées avec les données saisies antérieurement dans le sens inverse. Le sens du curseur devient identique à l'orientation de la zone et la valeur par défaut correspondant à cette orientation est affectée à la couche langue. Si l'écran est actuellement orienté de gauche à droite, le curseur est placé sur la première position indéfinie à droite du texte concaténé. Si l'écran est actuellement orienté de droite à gauche, le curseur est placé sur la première position indéfinie à gauche du texte concaténé.

Les touches de fonction suivantes sont disponibles uniquement pour les sessions de terminal virtuel en arabe :

Ctrl+K : En-tête de colonne
Le mode en-tête de colonne permet d'insérer des blancs entre les colonnes de texte pour que les intitulés en anglais des colonnes de données restent correctement placés.

Les touches de fonction suivantes sont disponibles uniquement pour les sessions de terminal virtuel en hébreu :

Ctrl+D : Sens du curseur
Si le sens du curseur est gauche vers droite, la combinaison de touches Ctrl+D permet de changer ce sens en droite vers gauche, et inversement. Cette fonction n'est admise que pour le texte visuel. Lorsque que le sens du curseur est droite vers gauche, cette combinaison de touches n'a aucune incidence sur l'adressage et le déplacement du curseur, sur l'insertion et la suppression de caractères, ni sur l'effacement au sein d'une ligne ou d'un écran. Les fonctions suivantes sont affectées par le sens du curseur droite vers gauche :
Ctrl+D : Modes jeu de caractères
Cette fonction permet de basculer entre les jeux de caractères à 7 bits et à 8 bits. Si le jeu de caractères en cours est DEC Hebrew (8-bit) ou ISO Hebrew Supplemental (8-bit), le fait d'appuyer sur Ctrl+B modifie le jeu de caractères en cours en Hebrew NRCS (7-bit). Si le jeu de caractères en cours est Hebrew NRCS (7-bit), cette combinaison de touches charge l'un des jeux de caractères à 8 bits en se basant sur la règle suivante :

Restrictions liées au terminal hôte

Les zones de saisie Unicode ne sont pas prises en charge sur le terminal hôte. Il n'est donc pas possible de permuter les langues dans les zones Unicode.

Un texte complexe, contenant à la fois du texte bidirectionnel et des nombres, ne doit pas être utilisé comme critère de reconnaissance d'écran.

Capture d'écrans

Dans les sessions bidirectionnelles, les écrans peuvent être capturés en tant qu'écrans gauche vers droite ou droite vers gauche. Les écrans capturés sont affichés exactement tels qu'ils ont été capturés. Pour capturer un écran droite vers gauche, appuyez sur Ctrl+S (Ecran inversé) dans un écran gauche vers droite et cliquez sur Création de capture d'écran.

Reconnaissance des composants hôte bidirectionnels

En règle générale, l'orientation d'un composant hôte est identique à celle de l'écran. Toutefois, dans certains cas, elle est inversée par rapport à l'orientation générale de l'écran. Lorsqu'un projet HATS utilise une page de codes bidirectionnelle, une case à cocher intitulée Reconnaissance du composant orienté à l'opposé de l'écran est ajoutée à l'assistant Insertion d'un composant hôte et l'assistant de Création de combinaison d'écran. Lorsque vous ajoutez un composant hôte à une transformation, cochez cette case si son orientation est inversée par rapport à celle de l'écran. Le fait de cocher cette case permet à HATS de reconnaître les invites, les touches de fonction, les listes de sélection, les sous-fichiers et les éléments zones d'entrée avec suggestion dont l'orientation est opposée à celle de l'écran.

Vous avez la possibilité d'utiliser du texte bidirectionnel mixte dans les définitions des listes de sélection et des touche de fonction. Cela signifie que des chaînes telles que BIDI1 = BIDI2, où BIDI1 et BIDI2 sont des segments de texte bidirectionnel, peuvent être reconnues comme touches de fonction et listes de sélection.

Par défaut, seuls les composants gauche vers droite peuvent être reconnus dans des écrans par défaut (comme dans une session en anglais). Toutefois, la sélection de la propriété Reconnaissance du composant orienté à l'opposé de l'écran dans l'éditeur Paramètres de projet dans la section Paramètres de rendu sous l'onglet Rendu permet la reconnaissance des composants gauche vers droite et droite vers gauche dans les écrans par défaut.

Par défaut, les composants d'une transformation d'écran sont reconnus en fonction de l'orientation de l'écran uniquement. Au niveau du projet, vous pouvez choisir d'indiquer que HATS doit tenter de reconnaître un composant non reconnu avec l'orientation de l'écran opposée. Pour cela, cochez la case Reconnaissance du composant orienté à l'opposé de l'écran de l'éditeur de projet, dans la section Avancé de l'onglet Rendu sous Rendu par défaut. Si le composant n'est toujours pas reconnu, le rendu est effectué en fonction de la définition du paramètre Utiliser le rendu par défaut en cas d'échec du rendu du composant.

Vous pouvez également spécifier ce paramètre au niveau du composant. Pour cela, cliquez sur le bouton Paramètres avancés de rendu du panneau Options de rendu et cochez la case Reconnaître le composant orienté à l'opposé de l'écran lorsque vous ajoutez un composant à une transformation à l'aide de l'assistant Insertion d'un composant hôte. La valeur de ce paramètre au niveau du composant ne provient pas du paramètre de projet. Le tableau ci-après répertorie les combinaisons possibles de ce paramètre au niveau du projet et du composant et indique le paramètre utilisé. Pour plus d'informations générales, voir Rendu avancé.

Tableau 16. Combinaisons de paramètres de projet et de composant
Paramètre de projet Paramètre de composant Paramètre utilisé
désactivé désactivé composant
désactivé sélectionné composant
sélectionné désactivé projet
sélectionné sélectionné composant

Contrôle de l'orientation des objets fenêtre

Deux cases à cocher spéciales permettent de contrôler la présentation des objets fenêtre lorsqu'une application s'exécute dans WebSphere Application Server. Ce contrôle s'effectue sur :

Ces deux cases à cocher sont les suivantes :

Sur un écran orienté gauche vers droite, lorsque la case à cocher Inverser l'orientation de l'objet fenêtre est sélectionnée, l'orientation de l'image de l'interface graphique est modifiée en droite vers gauche. De même, lorsque la case Texte inversé dans l'objet fenêtre est cochée, l'orientation du texte dans l'image de l'interface graphique est modifiée en gauche vers droite.

Supposons, par exemple, qu'un écran gauche vers droite contienne le texte suivant (les majuscules correspondent à des données bidirectionnelles, et le texte en minuscules, à des données en anglais) :

TEXTE BIDI  pf01=Aide

Lorsque vous personnalisez cet écran comme étant orienté de droite à gauche, il s'affiche comme :

IDIB ETXET   ediA=10fp

Du point de vue de l'utilisateur, tout est correct, à l'exception de la touche de fonction. La touche de fonction est reconnue mais elle s'affiche à l'envers.

Pour que l'écran personnalisé s'affiche correctement, vous devez cocher les cases Inverser l'orientation de l'objet fenêtre et Texte inversé dans l'objet fenêtre lorsque vous insérez le composant hôte correspondant à la touche de fonction.

De cette façon, l'écran s'affiche ainsi :

IDIB ETXET   pf01=help

Lorsque vous remplacez une zone d'entrée de texte par une boîte à liste déroulante dans un projet bidirectionnel, les libellés des options de la boîte à liste déroulante ne sont pas affectés par l'orientation de l'écran. Les libellés apparaîtront toujours au format LTR (gauche vers droite) visuel, sauf si vous cochez la case Texte inversé dans l'objet fenêtre pour cet objet fenêtre. Dans ce cas, les libellés apparaîtront toujours au format RTL (droite vers gauche) visuel.

Le texte peut également être inversé lorsque vous créez des applications HATS bidirectionnelles et que vous copiez et collez plusieurs lignes de texte d'une zone protégée au sein d'une zone d'entrée visuelle. Si vous copiez et collez une ligne à la fois, l'orientation est préservée.

Contrôle de l'alignement des objets fenêtre

Pour configurer un alignement correct des objets fenêtre contenant des éléments de composants HATS, un paramètre Component Alignment est disponible sur les panneaux de configuration HATS suivants :

Outre la configuration du bon alignement des différents objets fenêtre, les paramètres Alignement des champs et Alignement des tableaux sont accessibles dans la boîte de dialogue des paramètres des objets fenêtre de l'assistant des options de rendu pour les objets fenêtre Champ et Tableau.

Les valeurs possibles de ces paramètres sont gauche et droite. Le paramètre Alignement des composants des paramètres projet joue sur l'alignement de tous les objet fenêtre du projet. La valeur définie dans les paramètres du projet devient alors la valeur par défaut pour les assistants de création d'une transformation et de création d'une personnalisation d'écran. L'alignement défini pour un objet fenêtre individuel supplante la valeur indiquée dans le rendu par défaut.

Prise en charge bidirectionnelle des objets fenêtre et des composants personnalisés

Vous devez utiliser les équivalents bidirectionnels lorsque vous personnalisez de nouveaux composants et objets fenêtre, par exemple, dans les projets Web :

import com.ibm.hats.transform.widgets.BIDI.LabelWidgetBIDI

public class newBIDILabel extends LabelWidgetBIDI implements HTMLRenderer

Variables globales

Lorsque des variables globales sont extraites, elles le sont exactement telles qu'elles apparaissent à l'écran, orientation de l'écran en cours incluse. Toute variable globale insérée en tant qu'action d'un événement d'écran est insérée en tenant compte de l'orientation de l'écran.

Dans les applications Web et client enrichi, les données bidirectionnelles provenant de textes statiques et de zones d'entrée sont stockées dans des variables globales en un format visuel dans Rational SDP et les environnements d'exécution.

Lorsque vous utilisez l'assistant Insertion de variable globale pour insérer une valeur de variable globale sous forme de texte statique dans une transformation pour un écran contenant des données bidirectionnelles, vous pouvez insérer une valeur globale dans un format visuel. Sélectionnez cette option pour insérer la valeur de variable globale sous forme de texte statique au format visuel. Décochez cette case pour insérer la valeur sous forme de texte statique au format logique.

Lorsque des variables globales sont extraites de sessions de terminal virtuel logiques, ces dernières sont converties en format visuel. Toutes les variables globales insérées dans une session de terminal virtuel logique sont converties en format logique. La direction de texte est définie selon l'orientation de l'écran.

Remplacement de texte

Lorsque vous utilisez le remplacement de texte dans des sessions bidirectionnelles au niveau d'un projet ou d'une balise de composant HATS, vous disposez de trois autres cases à cocher :

Correspondance sur écran LTR
Cette option permet d'effectuer correctement le remplacement de texte sur des écrans gauche vers droite.
Correspondance sur écran RTL
Cette option permet d'effectuer correctement le remplacement de texte sur des écrans droite vers gauche.
Correspondance avec inversion d'écran
Si vous cochez cette case et que la case Correspondance sur écran LTR est sélectionnée, la chaîne inversée correspond sur un écran droite vers gauche. Lorsque vous cliquez sur le bouton Ecran inversé sur un écran gauche vers droite, les données sont cohérentes.

Si vous cochez cette case et que la case Correspondance sur écran RTL est sélectionnée, la chaîne inversée correspond sur un écran orienté gauche vers droite. Lorsque vous cliquez sur le bouton Ecran inversé sur un écran droite vers gauche, les données sont cohérentes.

Vous devez cocher soit Correspondance sur écran LTR, soit Correspondance sur écran RTL.

Supposons, par exemple, qu'un écran hôte gauche vers droite contienne le texte : NO on. Si vous définissez la fonction de remplacement de texte pour remplacer no par yes et que vous ignorez la casse, les résultats dépendent des cases que vous avez cochées  :

Tableau 17. Options de remplacement de texte bidirectionnel et résultats
Options sélectionnées Ecran LTR Ecran RTL
Correspondance sur écran LTR uniquement yes on no ON
Correspondance sur écran RTL uniquement NO on yes ON
Correspondance sur écran LTR et écran RTL yes on yes ON
Correspondance sur écran LTR et Correspondance avec inversion d'écran yes on no sey
Correspondance sur écran RTL et Correspondance avec inversion d'écran NO sey yes ON
Correspondance sur écran LTR et RTL et Correspondance avec inversion d'écran yes sey yes sey

Règles globales

Lorsque vous utilisez les règles globales au niveau du projet ou de l'écran dans des sessions bidirectionnelles, vous disposez de trois autres cases à cocher (comme pour le remplacement de texte) :

Correspondance sur écran LTR
Cette option permet d'appliquer correctement la règle globale sur des écrans gauche vers droite.
Correspondance sur écran RTL
Cette option permet d'appliquer correctement la règle globale sur des écrans droite vers gauche.
Correspondance avec inversion d'écran
Si vous cochez cette case et que la case Correspondance sur écran LTR est sélectionnée, la chaîne inversée correspond sur un écran droite vers gauche. Lorsque vous cliquez sur le bouton Ecran inversé sur un écran gauche vers droite, les données sont cohérentes.

Si vous cochez cette case et que la case Correspondance sur écran RTL est sélectionnée, la chaîne inversée correspond sur un écran orienté gauche vers droite. Lorsque vous cliquez sur le bouton Ecran inversé sur un écran droite vers gauche, les données sont cohérentes.

Pour plus d'informations, voir tableau 17.

Inversion de l'orientation de l'écran

Dans la définition du bloc de touches application, sur des transformations bidirectionnelles, vous pouvez fournir un bouton Ecran inversé qui s'avérera pratique pour l'utilisateur. Ce bouton apparaît dans le bloc de touches application (pour les applications Web) et dans la barre d'outils de la vue de transformation (pour les applications de client enrichi). Le fait de cliquer sur le bouton change l'orientation de l'écran (opération exécutée sur des systèmes hôte à l'aide la combinaison de touches Alt+Entrée).

Au niveau du projet, vous pouvez ajouter le bouton Ecran inversé dans la section du bloc de touches de l'onglet Rendu dans l'éditeur de projet. Au niveau de la transformation, vous pouvez ajouter le bouton Ecran inversé à l'aide des fonctions Insérer le bloc de touches application dans l'éditeur de transformation.

Lorsque vous créez un nouveau projet HATS et que vous sélectionnez une page de codes bidirectionnelle, deux cases à cocher supplémentaires s'affichent dans le panneau des paramètres de connexion : Activation de l'inversion d'écran pour les écrans non personnalisés et Activation de l'inversion d'écran pour les écrans personnalisés. Ces cases déterminent l'affichage du bouton Ecran inversé proposé sur les différents écrans. Les deux cases sont cochées par défaut. Si vous cochez la première case, la seconde est activée. Vous ne pouvez pas cocher uniquement la seconde case.

Un écran non personnalisé est un écran ne correspondant à aucune personnalisation d'écran. Lorsqu'un écran non personnalisé est affiché par l'utilisateur, il a la même orientation que l'écran précédent. Si le premier écran est non personnalisé, il a une orientation de gauche à droite. Si l'orientation d'écran est modifiée sur un écran précédent, l'écran non personnalisé suivant hérite de cette orientation, qui est réinitialisée par l'écran personnalisé suivant.

L'orientation initiale des écrans personnalisés est celle adoptée lors de leur personnalisation. Pour les écrans personnalisés comme pour les écrans non personnalisés, le fait de cliquer sur le bouton Ecran inversé modifie l'orientation de l'écran. Lors de la reconnaissance d'écrans, un écran inversé est considéré comme étant différent du même écran avant son inversion. Par conséquent, l'activation du bouton Ecran inversé peut se traduire par la non-reconnaissance d'un écran. Si le développeur est sûr que tous les composants hôte apparaissant sur un écran personnalisé sont orientés correctement, il n'a pas besoin d'activer le bouton Ecran inversé pour cet écran. Il est conseillé de désactiver le bouton Ecran inversé pour les écrans personnalisés.

Le fait de mettre le bouton Ecran inversé à disposition de l'utilisateur d'une application en arabe permet à une autre case à cocher de modifier l'orientation du format. Pour plus d'informations, voir Fonctions pour les pages de codes arabes.

Options d'affichage bidirectionnel sur un terminal virtuel

Pour les sessions bidirectionnelles sur terminal virtuel, certaines propriétés bidirectionnelles doivent être définies pour que le terminal fonctionne correctement pour les utilisateurs bidirectionnels. Un bouton Options d'affichage BIDI de terminal virtuel qui s'affiche dans l'écran Paramètres de connexion a été ajouté pour l'accès aux options suivantes :

Type de texte (Hébreu)
Détermine le format des caractères de texte stockés. Sélectionnez Visuel ou Logique. La valeur par défaut est Visuel.
Sens curseur (Hébreu Visuel)
Définit le sens du curseur Gauche vers droite ou Droite vers gauche. Lorsque le sens du curseur est Droite vers gauche, tous les caractères apparaissent dans ce sens parce que le curseur se déplace vers la gauche par défaut après chaque caractère affiché. En règle générale, seules les applications conçues pour recevoir des données orientées de droite à gauche fonctionnent correctement lorsque le sens du curseur a pour valeur Droite vers gauche. La valeur par défaut est Gauche vers droite.
Activation du tri dynamique (Arabe/Hébreu Logique)
Détermine si les segments de caractères dotés d'attributs de texte différents sont triés séparément. Cette fonction est désactivée par défaut.
Affichage des attributs de visualisation (Arabe/Hébreu Logique)
Activé uniquement lorsque le tri dynamique l'est aussi. La valeur par défaut est Oui.

Orientation d'invite

Dans les sessions logiques bidirectionnelles VT, deux boutons d'option (Direction LTR et Direction RTL) permettent au développeur d'application de contrôler l'orientation de la saisie (implicite LTR [gauche vers droite] ou implicite RTL [droite vers gauche]) pour les invites lors de l'enregistrement d'une macro.

L'orientation de saisie par défaut est la direction LTR (gauche vers droite) qui implique que la valeur de l'invite soit au format implicite LTR.

Options bidirectionnelles des requêtes SQL de macro

Vous devez définir des propriétés bidirectionnelles spécifiques dans l'assistant SQL des langues bidirectionnelles (arabe et hébreu). Pour accéder à ces paramètres, cliquez sur le bouton Avancé dans le panneau de l'éditeur de macro avancé. Ce panneau est visible uniquement si votre poste de travail est configuré pour une langue bidirectionnelle. Les paramètres suivants sont disponibles :

Host-File Type
Cette option indique si le fichier hôte doit être sauvegardé au format logique ou visuel. La valeur par défaut est Visuel. (Cette option n'est pas activée pour le pilote JDBC d'AS/400 Toolbox for Java™).
Local-File Type
Cette option indique si les fichiers locaux sont au format logique ou visuel. Par défaut, ils sont au format logique.
Host-File Orientation
Indique si le fichier hôte doit être sauvegardé au format gauche vers droite ou droite vers gauche. La valeur par défaut est gauche vers droite. (Cette option n'est pas activée pour le pilote JDBC à partir d'AS/400 Toolbox for Java.)
Local-File Orientation
Indique si les fichiers locaux sont au format gauche vers droite ou droite vers gauche. La valeur par défaut est gauche vers droite.
Lam-Alef Expansion
Indique le comportement des caractères Lam-Alef. Lorsque des données arabes provenant de l'hôte sont reçues via une instruction de l'assistant SQL, le caractère Lam-Alef est développé en deux caractères, le caractère Lam suivi du caractère Alef, s'il existe un espace après le caractère Lam-Alef.
Lam-Alef Compression
Indique le comportement des caractères Lam-Alef. Lorsque des données arabes sont envoyées à l'hôte via une instruction de l'assistant SQL, les caractères Lam suivis des caractères Alef sont compressés en un seul caractère et un espace est ajouté après le caractère Lam-Alef. Cette option est activée uniquement pour les systèmes en langue arabe. Elle est activée par défaut. (Cette option n'est pas activée pour le pilote JDBC à partir d'AS/400 Toolbox for Java.).
Symmetric Swapping
Indique le comportement des caractères symétriques tels que les crochets. L'inversion de l'écran entraîne le remplacement des caractères directionnels par leurs équivalents. Elle est activée par défaut. (Cette option n'est pas activée pour le pilote JDBC d'AS/400 Toolbox for Java).
Round Trip
Contrôle comment est traité du texte bidirectionnel mélangé à des nombres.
Numerals Shape
Indique le format des caractère numériques dans le fichier hôte au niveau de l'instruction de l'assistant SQL. Le format peut être NOMINAL, NATIONAL ou CONTEXTUAL. Cette option est activée uniquement pour les systèmes en langue arabe. La valeur par défaut est NOMINAL. (Cette option n'est pas activée pour le pilote JDBC d'AS/400 Toolbox for Java).

Prise en charge de l'impression droite vers gauche

Les fichiers bidirectionnels peuvent être des fichiers RTL (droite vers gauche) ou LTR (gauche vers droite). Pour imprimer correctement des données RTL (de droite à gauche), vous devez cocher la case Activation impression RTL qui apparaît dans l'onglet Impression de l'éditeur de connexion pour une connexion bidirectionnelle par défaut 3270E. Les fichiers PDF et non PDF sont pris en charge.

Cette case est cochée si l'impression est activée.

Dans le cas d'applications en arabe, l'activation de l'impression RTL coche également les deux cases suivantes :

Prise en charge des mappes BMS

La prise en charge bidirectionnelle des mappes BMS comprend les éléments ci-après.

  1. Pages de codes bidirectionnelles : lors de l'importation des ensembles de mappes BMS dans des projets bidirectionnels, vous devez utiliser les pages de codes suivantes :
  2. Attributs bidirectionnels : lorsque un ensemble de mappes BMS est importé vers un projet bidirectionnel, un bouton Options bidirectionnelles est disponible. Cliquez sur ce bouton pour définir les attributs bidirectionnels suivants :

Prise en charge des objets d'intégration

La prise en charge des objets d'intégration comprend l'extension du bean Integration Object incluant des propriétés spécifiques à la bidirectionnalité pour permettre des fonctions telles que le tri de texte extrait. Pour plus d'informations, voir le chapitre Using the HATS bidirectional API, dans HATS Web Application Programmer's Guide.

La prise en charge de pages Web incluant des objet d'intégration (de modèle 1 et JSF) comprend la réorganisation correcte en temps réel de données extraites ou insérées ainsi qu'un contrôle complet par le développeur sur l'orientation de l'écran et des commandes d'extraction/insertion grâce à une interface graphique de haut niveau.

La prise en charge comprend les fonctions suivantes :

L'extraction à partir de l'écran hôte peut produire les quatre situations ci-après.

Zone alignée à gauche dans l'écran LTR extrait
L'extraction est effectuée dans un écran LTR, le bouton d'option d'orientation de l'écran et les boutons d'option d'orientation des contrôles sont LTR (par défaut).
Zone alignée à droite dans l'écran LTR extrait
L'extraction est effectuée dans un écran RTL, le bouton d'option d'orientation de l'écran et les boutons d'option d'orientation des contrôles sont RTL (par défaut).
Zone alignée à droite dans l'écran RTL extrait
L'extraction est effectuée dans un écran LTR, le bouton d'option d'orientation de l'écran est LTR et le bouton d'option d'orientation des contrôles est RTL.
Zone alignée à gauche dans l'écran RTL extrait
L'extraction est effectuée dans un écran RTL, le bouton d'option d'orientation de l'écran est RTL et le bouton d'option d'orientation des contrôles est LTR.
Remarque :
L'alignement du texte bidirectionnel dans les tableaux risque de ne pas être correctement rendu si vous utilisez des pages Web JSF. Il s'agit d'une restriction relative à la conception JSF.

Prise en charge de services Web ascendants

En plus de la prise en charge des pages Web de modèle 1 et JSF créées à partir d'objets d'intégration, HATS fournit la prise en charge bidirectionnelle pour les les services Web ascendants créés à partir d'objets d'intégration. Dans ce cas, le service Web hérite de toutes les fonctionnalités bidirectionnelles de l'objet d'intégration. Le service Web est enrichi de nouvelles propriétés. Pour plus d'informations, voir le chapitre Using the HATS bidirectional API, dans HATS Web Application Programmer's Guide. Vous pouvez essayer ces propriétés à l'aide d'outils tels que des pages de test JSP ou l'explorateur de services Web.

Etant donné que les pages JSP générées par HATS Toolkit sont des applications LTR logiques, elles affichent correctement les résultats du service Web seulement si vous définissez l'exécution de l'invite et la réorganisation du texte extrait, et vous devez définir la réorganisation RTL dans les deux cas à False. Sinon, le résultat ne s'affiche pas correctement. Toutefois, vous pouvez choisir de voir le résultat "incorrect", afin de vérifier comment la modification des valeurs des propriétés affecte le service Web.

Si vous désirez voir des résultats corrects de la réorganisation différents de l'affichage LTR avec les pages JSP d'exemple, vous devrez modifier manuellement le fichier Result.jsp généré par HATS Toolkit. A la suite de la ligne contenant la balise <body>, insérez la ligne <div dir=rtl> pour le RTL logique, <bdo dir=ltr> pour le LTR visuel ou <bdo dir=rtl> pour le RTL visuel.

L'utilisation de l'explorateur de services Web n'est pas recommandée pour les cas de réorganisation autres que le LTR logique.

Vous pouvez prédéfinir les valeurs des propriétés spécifiques à la bidirectionnalité et contrôler la possibilité de remplacement de ces valeurs par l'utilisateur. Pour définir ces valeurs, cliquez sur Options BIDI lorsque les fichiers du service sont générés à partir des objets d'intégration. Si l'option qui permet le remplacement des valeurs par l'utilisateur est sélectionnée, les valeurs prédéfinies sont utilisées si null ou des chaînes vides sont utilisés comme paramètres pour les propriétés correspondantes.

Informations pour l'utilisateur

Les applications HATS utilisant des pages de codes bidirectionnelles offrent une zone d'entrée spéciale appelée zone d'entrée visuelle. Contrairement aux zones classiques qui mettent en oeuvre une saisie et une présentation des données logiques, la zone visuelle utilise une saisie et une présentation des données visuelles. Lorsque vous saisissez des données dans une zone visuelle, vous pouvez utiliser les fonctions suivantes :

Alt+Maj : Sélection de la langue
Cette combinaison de touches permet de basculer entre la couche langue Latin et la couche bidirectionnelle.
Alt+Entrée : Ecran inversé
Cette combinaison de touches inverse l'orientation de l'écran.
Maj+Verr. num : Insertion
Vous pouvez entrer et éditer du texte dans le sens opposé à celui de la zone.
Maj+caractère "/" du pavé numérique : Arrêt de l'insertion
Le mode insertion prend fin et le curseur se place à la fin du segment inséré.
Alt+caractère "/" du pavé numérique : Insertion automatique
Vous pouvez saisir du texte bidirectionnel mixte orienté de gauche à droite et de droite à gauche en modifiant la couche langue. L'insertion automatique s'avère particulièrement utile lorsque que vous tapez des chiffres dans des zones droite vers gauche. Les fonctions d'insertion et d'arrêt de l'insertion sont automatiquement activées en fonction de la langue du texte saisi. Dans des zones droite vers gauche, le fait de taper une lettre ou un chiffre en caractères Latin lance automatiquement le mode insertion, sans changement de la langue. Le mode insertion se poursuit tant que d'autres lettres ou chiffres Latin sont saisis ; tout autre type de caractère met automatiquement fin à ce mode. Cette fonction vous permet de taper un texte bidirectionnel comprenant des nombres et des mots Latin sans utiliser les modes insertion et arrêt de l'insertion.

Dans les zones gauche vers droite, le fait de taper un caractère bidirectionnel entraîne la lancement automatique de l'insertion. Si vous tapez un chiffre ou un caractère Latin, ce mode est arrêté automatiquement. L'utilisateur peut ainsi taper un texte en caractères Latin comprenant des mots bidirectionnels en utilisant la couche langue au lieu des modes insertion et arrêt de l'insertion.

Vous pouvez activer ou désactiver initialement le mode d'insertion automatique à l'aide du paramètre Activer initialement le mode d'insertion automatique. Ce paramètre est disponible à deux endroits dans l'éditeur de projet. Sur l'onglet Présentation, cliquez sur le lien vers le thème actuel et utilisez le paramètre Activer initialement le mode d'insertion automatique. Sur l'onglet Autre, sélectionnez la section Paramètres client et utilisez le paramètre Activer initialement le mode d'insertion automatique.

Remarque :
Lorsque le mode d'insertion automatique est utilisé sur une page Web JSF qui fournit une interface à un objet d'intégration, il se peut que vous deviez modifier la taille de la zone manuellement pour entrer un nombre de caractères supérieur à celui autorisé par la zone d'entrée du navigateur par défaut.

Inversion de zone automatique

Alt+5 du pavé numérique
Lorsque l'inversion de zone automatique est activée, toutes les zones, à l'exception des zones de mot de passe, ont le même comportement (décrit précédemment). Dans les écrans droite vers gauche de sessions 3270, l'inversion de zone automatique est le mode de fonctionnement par défaut.

Inversion de zone

Alt+Verr. num
Lorsque l'inversion de zone est activée, l'orientation de la frappe dans la zone en cours (mise en évidence) est modifiée. Si la zone est vide, le curseur est placé sur le côté opposé de la zone. Sinon, la position du curseur ne change pas. L'inversion de zone est active uniquement dans la zone en cours. Ensuite, l'orientation de la frappe reprend sa valeur précédente.

Fonctions du presse-papiers

Les opérations du presse-papiers (copier, coller et couper) à partir de données bidirectionnelles provenant des éditeurs logiques de la plateforme vers les zones visuelles HATS, et à partir des zones visuelles HATS (y compris le texte statique) vers les éditeurs logiques de la plateforme sont activées sur les plateformes Windows®. Les utilisateurs de Windows peuvent employer le presse-papiers pour échanger des données entre HATS et d'autres applications utilisant des données logiques.

Les opérations du presse-papiers d'Internet Explorer sont prises en charge à la fois à partir du menu Edition et à partir des raccourcis clavier (Ctrl+C, Ctrl+X, Ctrl+V).

La prise en charge des données bidirectionnelles du presse-papiers sur les navigateurs Mozilla des plateformes Windows est activée uniquement si ces fonctions sont appelées via les raccourcis clavier.

Zone d'informations opérateur

Outre les informations relatives aux sessions qui s'affichent dans la zone d'informations opérateur, les sessions bidirectionnelles incluent des informations concernant le sens de l'écran et le sens de la saisie, la couche active, l'état du mode d'inversion automatique des zones et l'état du format (dans les sessions en langue arabe).

Les informations relatives à la session bidirectionnelle (clavier) sont présentées dans un format similaire à celui employé sur le système hôte. Pour afficher ces informations dans la zone d'informations opérateur d'une transformation HATS, dans l'éditeur des paramètres du projet, sélectionnez Zone d'informations opérateur dans l'onglet Rendu, puis cochez la case Affichage de la zone d'informations système. Quand la case Affichage de la zone d'informations système de l'éditeur de paramètres du projet est décochée, la zone d'état bidirectionnelle HATS s'affiche dans la barre d'état pour les applications Web, mais ne s'affiche pas pour les applications client enrichi.

Commutation automatique de la couche clavier

Pour les projets Web HATS, cette fonction vous permet de simuler la commutation automatique de la couche de clavier entre les langues bidirectionnelles et latines pour les écrans inversés. La simulation est effectuée via la réaffectation des touches du clavier. Cela force l'insertion de caractères arabes/hébreux ou latins en fonction du sens de la saisie. Par exemple, dans un écran inversé, où la saisie du texte s'effectue de droite à gauche, les caractères arabes/hébreux sont insérés indépendamment de l'état réel de la couche clavier. Pour activer cette fonction, dans l'éditeur des paramètres de projet, dans l'onglet Présentation, cliquez sur le lien du thème actuel et sélectionnez Enable automatic keyboard layer switch. Ce paramètre peut également être sélectionné dans l'éditeur des paramètres de projet dans l'onglet Autre de la section Paramètres client.

Les projets client enrichi HATS se comportent généralement comme si cette fonction était activée.

Remarque :
Les zones de mot de passe et toutes les zones qui ne sont pas basées sur les zones d'entrée visuelles fonctionnent selon la définition du clavier système. La réaffectation des touches du clavier n'est pas effectuée pour ces types de zone.

Prise en charge du format IBM i 5250 Unicode

Le texte bidirectionnel s'affichant dans des zones Unicode utilisées par des systèmes 5250 est affiché et édité à l'aide d'un schéma de tri contextuel (selon le premier caractère mis en évidence) plutôt que selon la zone d'entrée visuelle.

Fonctions pour les pages de codes arabes

Les fonctions suivantes sont spécifiques pour les projets utilisant des pages de codes arabes.

Sens du format

Si vous activez le bouton Ecran inversé des paramètres du bloc de touches application, le bouton Format RTL s'affiche également pour les projets de page de codes arabe. Cliquez sur le bouton Format RTL pour activer ou désactiver l'état du format RTL. Si vous désactivez le format RTL, HATS est informé que l'utilisateur édite un fichier LTR qui ne dépend pas de l'orientation de l'écran. L'activation du format RTL signale à HATS que l'utilisateur édite un fichier RTL (droite vers gauche) indépendant de l'orientation de l'écran. Ainsi, les mêmes données en arabe sont soumises correctement dans les deux orientations d'écran. Vous devez également veiller à désactiver le format RTL avant d'éditer et de soumettre un fichier LTR et à activer le format RTL avant d'éditer et de soumettre un fichier RTL.

Format arabe sélectif

Dans certains cas, vous pouvez avoir besoin d'envoyer des données à l'hôte dans un format spécifique. Pour répondre à ce besoin, une propriété de désactivation de format pour une zone a été ajoutée pour les sessions arabes sous la forme de deux cases à cocher :

Permutation symétrique et permutation numérique

Ces options sont applicables aux sessions 3270 en arabe. Si la permutation symétrique est activée, les caractères à permuter sont permutées dans les écrans droite vers gauche. Si la permutation numérique est activée, les chiffres anglais sont remplacés par des chiffres arabes dans les écrans droite vers gauche et les chiffres arabes, par des chiffres anglais dans les écrans droite vers gauche. Ces paramètres sont définis dans l'onglet Avancé de l'éditeur de connexion dans la section Configuration de paramètres de connexion avancés, facultatifs. Ces paramètres sont identifiés par symmetricSwapEnabled et numericSwapEnabled. Leur valeur peut être "true" ou "false".

Le terminal hôte HATS est affecté par les paramètres de permutation symétrique et numérique.

Désactivation de l'entrée de chiffres Arabic-Western

Lorsque vous créez un projet HATS ou lorsque vous créez ou éditez une connexion HATS et sélectionnez la page de codes arabe 420, le paramètre Désactiver l'entrée de chiffres Arabic-Western dans les écrans RTL s'affiche. Sélectionnez cette option pour désactiver l'entrée de chiffres Arabic-Western et ainsi autoriser uniquement l'entrée de chiffres Arabic-Indic dans les écrans RTL. Vous devez le faire afin que tous les chiffres soient soumis en tant que chiffres Arabic-Western.

Commutation automatique de la couche clavier

Le clavier arabe est composé de deux couches, les dispositions de clavier 101 et 102, qui comportent de légères différences pour certaines touches. Lorsque cette fonction est utilisée, les mappages suivants sont effectués :

Restrictions liées au terminal hôte

Les dispositions de clavier système anglaise et arabe 101 touches sont soumises aux restrictions ci-après :

Ces restrictions disparaissent avec le clavier arabe 102 touches.

Si vous utilisez un clavier arabe 102 touches, vous pouvez être confronté aux restrictions de clavier suivantes :

Pour afficher correctement ces caractères, vous devez activer la couche langue anglaise du clavier.

Captures d'écran

Pour une session arabe avec des écrans capturés de droite à gauche, les parenthèses, les crochets et les chiffres sont affectés par les options de permutation symétrique et de permutation numérique de l'application.

Remarque :
Dans les sessions en langue arabe, le signe de l'euro s'affiche sous la forme d'un carré plein dans les captures d'écran.

Définitions de sessions d'impression en arabe dans System i Access for Web

Voici un récapitulatif des paramètres permettant de présenter correctement les données en arabe dansSystem i Access for Web.

Pour les paramètres globaux :

Rapports SCS :

Rapports AFP :

Autres considérations

Ajouts dans des fichiers HATS

Lorsqu'un projet utilise une page de codes arabe, les fichiers événements d'écran (.evnt) sont dotés d'une balise supplémentaire <orientation>true</orientation> au sein de la balise de description. La valeur "true" indique que l'écran est personnalisé en tant qu'écran droite vers gauche. Sinon, il est personnalisé en tant qu'écran gauche vers droite.

Lorsqu'un projet utilise une page de codes bidirectionnelle, le fichier de connexion (.hco) dispose d'un attribut supplémentaire enableScrRev pour la balise <hodconnection>, qui peut avoir les valeurs suivantes :

(à blanc)
Le bouton Ecran inversé n'est placé sur aucun écran.
NotCustomized
Le bouton Ecran inversé est placé uniquement sur les écrans ne correspondant pas à une personnalisation d'écran.
Customized
Le bouton Ecran inversé est placé sur tous les écrans.

Lorsqu'un projet utilise une page de codes arabe, le fichier de connexion (.hco) dispose d'un attribut supplémentaire disableFldShp pour la balise <hodconnection>, qui peut avoir les valeurs "true" ou "false".

Si l'impression est cochée dans une session 3270, un paramètre printRTLSupport supplémentaire s'affiche dans la balise <classSetttings>. Pour les sessions 3270 en arabe, deux autres paramètres s'affichent pour la permutation symétrique et la permutation numérique : printSymSwapSupport et printNumSwapSupport. Les valeurs "true" ou "false" de tous ces paramètres d'impression sont équivalentes à l'activation ou à la désactivation de la fonction correspondante.

Lorsqu'un projet utilise une page de codes bidirectionnelle, le fichier d'application (.hap) dispose d'attributs supplémentaires pour la balise <replace> au sein de la balise <textReplacement> :

matchLTR
Le texte doit être remplacé lorsque l'orientation d'écran est de gauche à droite.
matchRTL
Le texte doit être remplacé lorsque l'orientation d'écran est de droite à gauche.
matchReverse
Le texte doit être remplacé lorsque l'orientation d'écran est inversée.