Déployer les Fonts, Icones, et Images avec Forms Services 11G 1. Le fichier Registry.dat Le fichier Registry.dat permet de gérer les correspondances de font entre celles utilisées pour le développement dans les applications (form builder items et label properties fonts (name, size, weight) et celles utilisées pour le déploiement (Forms Services font java) Vous pouvez gérer le paramétrage depuis la page Fonts and Icon Mapping accessible depuis le menu de Forms dans Fusion Middleware Control : ou directement en éditant le fichier registry.dat (préalablement sauvegardé), accessible depuis : <formsapp_directory>\config\forms\registry\oracle\forms\registry par exemple : d:\oracle\middleware\user_projects\domains\classicdomain\config\forms\regis try\oracle\forms\registry Déployer les Fonts, Icones, et Images avec Forms Services 11G 1
2 Gérer les Polices Vous pouvez changer la police et le paramétrage de police par défaut pour la applications forms dans le fichier Registry.dat. Les quatre premiers paramètres suivants représentent la valeur par défaut à utiliser quand aucune police n'est spécifiée dans l'application : Paramètre Valeur par défaut default.fontmap.defaultfontname Dialog Représente la font par défaut Java. default.fontmap.defaultsize 900 Représente la taille de la font par défaut. A noter que La taille est multipliée par 100 (par exemple, une taille de font à 10pt à la valeur 1000). default.fontmap.defaultstyle default.fontmap.defaultweight PLAIN Représente le style de font par défaut PLAIN ou ITALIC. PLAIN Représente l'épaisseur de font par défaut, PLAIN ou BOLD. Les deux derniers paramètres représentent les correspondances de police application et java à associer quand les polices pour les items et les labels sont spécifiées dans l'application : default.fontmap.appfontnames Courier New,Courier,courier,System,Terminal,Fixedsys,Times, Times New Roman,MS Sans Serif,Arial Représente une liste séparée par une virgule d'entrées de police dans l'application. default.fontmap.javafontnames MonoSpaced,MonoSpaced,MonoSpaced,Dialog,MonoSpaced, Dialog,Dialog,Serif,Serif,Dialog,SansSerif Représente une liste séparée par une virgule d'entrées de police Java. Certaines polices ne sont pas supportées en Java. Les polices utilisées en développement (spécifiques à la plate-forme utilisée) listées dans le paramètre default.fontmap.appfontnames correspondent à une police utilisée en déploiement (java) listée dans le paramètre default.fontmap.javafontnames. Par exemple la police utilisée dans le développement de l'application Courier New correspond à une police java MonoSpaced utilisée dans le déploiement. Si une police utilisée dans l'application ne trouve pas sa correspondance de font dans les paramètres Déployer les Fonts, Icones, et Images avec Forms Services 11G 2
3 Déployer les icones de l'application Lorsque les applications Oracle Forms application sont déployées, les fichiers icones utilisés pour les boutons doivent être au format Web JPG ou GIF (GIF est le format par défaut). Par défaut, les icones sont recherchés dans le répertoire relatif à DocumentBase (forms par défaut). c'est à dire que DocumentBase recherche les images dans le répertoire relatif au répertoire base où l'application démarre le fichier HTML. Comme le fichier de démarrage HTML est affiché dynamiquement par le Forms servlet, le répertoire Forms webapp devient le document base. Le répertoire Forms webapp est localisé sous $DOMAIN_HOME/servers/WLS_FORMS/tmp/_WL_user/formsapp_11.1.2/<rando m string>/war. Par exemple si une application définit l'emplacement des icones pour un bouton à myapp/<iconname>, alors l'icône est recherche dans le répertoire forms/myapp. Pour changer l'emplacement par défaut, définissez le paramètre imagebase à codebase dans le fichier de configuration web (formsweb.cfg). Vous pouvez aussi changer la valeur du paramètre default.icons.iconpath du fichier Registry.dat placé dans le répertoire $DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsap p_11.1.2/config/forms/registry/oracle/forms/registry. Définir le paramètre imagebase à codebase permet à Oracle Forms de rechercher dans le répertoire forms/java les fichiers icones. Utilisez ce paramétrage si vos images sont stockés dans un fichier Java archive. Changer l'emplacement des images dans le fichier de configuration Registry.dat est utile pour stocker les images à un emplacement indépendant de toute application et de l'installation Oracle Forms. 3.1 Stocker les icones dans un fichier Java Archive Si une application utilise beaucoup d'images icones, il est recommandé de stocker les icones dans un fichier Java archive et de définir la valeur imagebase à codebase. Les fichiers icones peuvent être compressées dans une Java archive avec la commande Jar de n'importe quel Java Software Development Kit (Java SDK). Par exemple, la commande jar -cvf myico.jar *.gif package tous les fichiers avec une extension.gir dans une archive nommée myico.jar. Poru que Oracle Forms puisse accéder aux fichier icones stockés dans cette archive, l'archiev doit être stockée dans le répertoire forms/java. Le nom de l'archive doit aussi être référencé dans le tag archive utilisé dans la section de configuration nommée du fichier formsweb.cfg. Quand l'application initiale démarre, les fichiers icones sont téléchargés et stockés de manière permanente sur le client jusqu'à ce le fichier archive change. Note: Les icones par défaut de Oracle Forms (par exemple les icones présents sur la barre de menu par défaut ne nécessite pas de déploiement puisqu'ils sont inclus dans le fichier frmall.jar. (N'oubliez donc pas de conserver cet archive au démarrage de l'applet dans le paramètre Archive=) Déployer les Fonts, Icones, et Images avec Forms Services 11G 3
3.2 Ajouter, Modifier et supprimer les Icon Mappings Utilisez Fusion Middleware Control pour ajouter les modifications d'icones au fichier Registry.dat utilisé par l'application. Pour ajouter le paramétrage des icones : 1. Depuis le menu Forms Font and Icon Mapping. 2. Cliquez sur Add.. 3. Entrez le nom, la valeur et un commentaire optionnel. 4. Cliquez sur Create pour créer le mapping. 5. Cliquez sur Apply pour sauvegarder les modifications. Pour modifier le paramétrage des icones : 1. Changez le nom et la valeur de mapping. Par exemple, o Modifiez le paramètre iconpath en spécifiant l'emplacement des icones : default.icons.iconpath=/mydir (pour un chemin absolu) ou default.icons.iconpath=mydir (pour un chemin relatif, à partir du répertoire DocumentBase ) o Modifiez le paramètre iconextension : default.icons.iconextension=gif ou default.icons.iconextension=jpg 2. Cliquez sur Apply pour sauvegarder et activer les modifications. Pour supprimer le paramétrage des icones : 1. Depuis la région Font and Icon Mapping, sélectionnez le paramétrage à supprmier. 2. Cliquez sur Delete. 3. Cliquez sur Apply pour sauvegarder ou Revert pour annuler les modifications. Pour référencer le fichier: Dans une section de configuration nommée du fichier formsweb.cfg, modifiez la valeur du paramètre serverapp et définissez la valeur de l'emplacement et le nom du fichier de l'application. Par exemple: [my_app] ServerApp=/appfile/myapp (pour un chemin absolu) ou [my_app] ServerApp=appfile/myapp (pour un chemin relatif au répertoire CodeBase ) Le tableau ci-dessous décrit où placer les icones de l'application : Déployer les Fonts, Icones, et Images avec Forms Services 11G 4
Emplacement Quand Comment DocumentBase Par défaut. Pour les Applications avec peu d'icones ou pas d'icones personnalisés. Java Archives Registry.dat Pour les Applications qui utilisent beaucoup d'icones personnalisées. Pour les Applications qui utilisent des icones personnalisées stockées à un emplacement différent de l'installation Oracle Forms (par exemple un autre serveur) utile pour faire d'autres changements au fichier Registry.dat comme le font mapping. Stocker les icones dans le répertoire forms webapp Ou un répertoire relatif à lui Le répertoire de forms webapp's est sous $DOMAIN_HOME/servers/WLS_FORMS/tmp/_WL_user/ formsapp_11.1.2/<random string>/war. Définissez ImageBase à codebase, créez un fichier Java archive pour les icones, et ajoutez le fichier archive dans le paramètre archive dans formsweb.cfg. Copiez Registry.dat et changez le paramètre ServerApp dans formsweb.cfg. 4 Images Splash screen et Background Quand vous déployez vos applications, vous avez la possibilité de spécifier une image splash screen (affichée pendant la connexion) ou une image background. Ces images sont définies dans le fichier HTML ou vous pouvez utiliser le fichier de configuration web formsweb.cfg : <PARAM NAME="splashScreen" VALUE="splash.gif"> <PARAM NAME="background" VALUE="back.gif"> L'emplacement par défaut des images est le répertoire DocumentBase contenant le fichier basehtml. Note: Déployer les Fonts, Icones, et Images avec Forms Services 11G 5
Les formats Image pour les splash screens les icones sont des formats supportés par java.awt.image. Pour plus d'informations se reporter à java.awt.image, Java Advanced Imaging (JAI) API sur http://www.oracle.com/technetwork/java/index.html. 5 Les fichiers personnalisés Jar contenant les icones et Images A chaque fois que vous utilisez une icône ou une image (pour un splash screen ou background), une demande HTTP est envoyée au serveur Web. Pour réduire l'aller/retour HTTP entre le client et le serveur, vous avez la possiblité de stocker vos icones et images dans un fichier Java archive (Jar). Utilisez cette technique uniquement si un aller-retour est nécessaire pour télécharger le fichier Jar. 5.1 Créer un fichier Jar pour les Images Le Java SDK a un exécutable appelé jar. Cet utilitaire permet de stocker des fichiers dans une archive Java. Pour plus d'information, voir http://www.oracle.com/technetwork/java/index.html. Par exemple : jar cvf myico.jar Splash.gif Back.gif icon1.gif Cette commande stocke trois fichiers (Splash.gif, Back.gif, icon1.gif) dans un fichier Jar nommé myico.jar. 5.2 Utiliser les fichiers stockés dans un fichier Jar Le chemin de recherche par défaut pour les icones et les images est relatif à documentbase. Cependant quand vous utilisez un fichier Jar pour ces fichiers, le chemin de recherche doit être relatif au répertoire codebase, le répertoire qui contient l'applet Java. Pour utiliser les icones et images d'un fichier Jar, vous devez spécifier le chemin de recherche relatif à codebase en utilisant le paramètre imagebase dans le fichier formsweb.cfg ou fichier HTML. Ce paramètre accepte deux valeurs : : documentbase le chemin de recherche est relatif au répertoire documentbase. Si aucune valeur n'est spécifiée pour imagebase, la valeur de documentbase est utilisée. codebase le chemin de recherche est relatif au répertoire codebase, qui donne la possibilité d'utiliser des fichiers Jar. Dans cet exemple, vous utilisez un fichier JAR contenant les icones et vous spécifiez que le chemin de recherche est relatif à codebase. Si le paramètre imagebase n'est pas défini, le chemin de recherche est documentbase et les icones ne sont pas extraites du fichier Jar. Par exemple (formsweb.cfg): archive=frmall.jar, icons.jar imagebase=codebase 6 Chemin de recherche pour les icones et les images Le chemin de recherche des icones et images dépend de : Ce que vous spécifiez dans votre fichier d'application (pour les icones) De ce que vous spécifiez dans les paramètres splashscreen et background de votre fichier de configuration web Forms ou du fichier HTML (pour les images). Déployer les Fonts, Icones, et Images avec Forms Services 11G 6
De ce que vous spécifiez sur le paramètre imagebase dans le fichier de configuration Web ou fichier HTML (pour les icones et les images). Forms Services recherche les icones suivant ce que vous spécifiez. Par exemple, supposons : host est le nom de la machine. DocumentBase est l'url pointant sur le fichier HTML. codebase est l' URL pointant à l'emplacement du fichier class de démarrage (comme spécifié dans le fichier formsweb.cfg ou fichier HTML ). mydir est l' URL pointant vers le répertoire des icones et images. 6.1 DocumentBase Le chemin de recherche par défaut pour les icones et images est relatif à DocumentBase. Dans ce cas, vous ne spécifiez pas le paramètre imagebase : Chemin de recherche pour les Icones Emplacement default iconpath=mydir (spécifié dans le fichier de l'application) iconpath=/mydir (spécifié dans le fichier de l'application) Chemin de recherche utilisé par Forms Services http://host/documentbase http://host/documentbase/mydir (chemin relatif) http://host/mydir (chemin absolu) Chemin de recherche pour les Images Emplacement file.gif (spécifié par exemple dans formsweb.cfg en tant que splashscreen=file.gif) mydir/file.gif /mydir/file.gif Chemin de recherche utilisé par Forms Services http://host/documentbase/file.gif http://host/documentbase/mydir/file.gif (chemin relatif) http://host/mydir/file.gif (chemin absolu) Déployer les Fonts, Icones, et Images avec Forms Services 11G 7
6.2 codebase Utilisez le paramètre imagebase=codebase pour activer la recherche des icones et des images dans un fichier Jar : Chemin de recherche des icones utilisé par Forms Services Emplacement spécifié default iconpath=mydir (spécifié dans le fichier de l'application) iconpath=/mydir (spécifié dans le fichier de l'application) Chemin de recherche utilisé par Forms Services http://host/codebase ou racine du fichier Jar http://host/codebase/mydir ou le répertoire mydir dans le fichier Jar (chemin relatif) http://host/mydir (chemin absolu) Aucun Jar utilisé. Chemin de recherche des Images utilisé par Forms Services Emplacement spécifié file.gif mydir/file.gif (spécifié dans le fichier HTML ) /mydir/file.gif (spécifié dans le fichier HTML) Chemin de recherche utilisé par Forms Services http://host/codebase/file.gif ou racine du fichier Jar http://host/codebase/mydir/file.gif ou dans le répertoire mydir du fichier Jar (chemin relatif) http://host/mydir/file.gif (chemin absolu) Aucun Jar utilisé. Déployer les Fonts, Icones, et Images avec Forms Services 11G 8