PARTIE 3 STRUCTURE PRESENTATION ELEMENT CALCULÉ

Transcription

1 PARTIE 3 STRUCTURE PRESENTATION ELEMENT CALCULÉ mardi, 14 mai,

2 Structure d un formulaire... 3 L utilisation des données... 5 L utilisation des tables... 5 L utilisation des éléments liés... 6 Le filtrage des données... 6 Le tri des enregistrements... 6 Présentation de l information... 7 Placement des composantes module... 7 Le titre du bloc... 9 Le titre de la fenêtre... 9 Le nombre d enregistrements affichés... 9 Le style d affichage des enregistrements L ordonnancement des éléments L affichage des éléments Regroupement des éléments Élément non lié (Unbound item)

3 Structure d un formulaire Le module de type écran (Screen) de Developer Forms correspond à un module Form de l outil Form Builder de la suite Oracle Developer. Pour être un module Developer Form, la propriété Module type doit être à Default et le la propriété Language doit être à Oracle Forms. La structure d un module est déterminée en fonction des tables qui doivent y être manipulées. L utilisation d une table peut être utilisée soit comme table de base (Base Table) afin de modifier ou visionner les données de la table ou soit pour ajouter de l information dans le bloc de base (Lookup Table). Chaque composante module représente un bloc dans le formulaire et elle ne peut contenir qu une seule utilisation de table de base. Les structures de base permises pour les formulaires sont les suivantes : maître-détail (Masterdetail), bloc de base (base table) avec une table lookup. Un bloc maître est toujours placé au-dessus de son bloc esclave. Une table lookup est toujours placée à la droite de la table de base. 3

4 Structure d un formulaire M odule Developer Form Lookup Maître-esclave Clients Locals Employes Clients Locals Lookup enchaîné Equipements Locals Employes 4

5 L utilisation des données L utilisation des données est définie par des tables et des colonnes de la base de données, elle consiste à identifier les actions qui peuvent être effectuées sur les enregistrements. Elle doit être définie pour chacune des utilisations de table des composantes du module. L utilisation des tables Les opérations permises sur les enregistrements d une table de base sont définies par la composante module. Il n est pas nécessaire de définir les actions pour l utilisation d une table lookup puisque celle-ci peut avoir accès en mode lecture seulement. Il n est pas permis de modifier la table sur laquelle l objet est basé. Pour ce faire, vous devez supprimer l utilisation de la table et la recréer avec la nouvelle table. Pour modifier les actions permises sur une table de base L onglet Operations de la boîte de dialogue Edit Module Component permet de spécifier les actions permises sur une table. Cochez la case Insert si de nouveaux enregistrements peuvent être créés Update si les enregistrements peuvent être modifiés Delete si les enregistrements peuvent être supprimés Dans le groupe Allow query, cochez la case Yes si l utilisateur peut saisir des critères, sinon cochez la case No. Pour créer l utilisation d une table L utilisation d une table de base est créée à partir du type d élément Module component alors que l utilisation d une table lookup est créée à partir du type d élément Table Usage. Le système valide au fur et à mesure le type de table qui peut être créé. Par exemple, il ne permettra pas de créer une table lookup si la table de base ne contient pas de clé étrangère. Lors de la création d une nouvelle utilisation de table, le système vous guide à l aide d assistant à travers toutes les étapes. Il est possible de créer automatiquement les tables lookup d une table de base lorsque vous créez une nouvelle composante module. Pour ce faire, vous devez cochez les tables désirées dans la liste Lookup table usage de l assistant Module Component Data Wizard. De plus, vous pouvez définir les propriétés d affichage suite à la création de la composante module en sélectionnant la deuxième option de la dernière page de l assistant. 5

6 L utilisation des éléments liés Rappelons qu un élément lié correspond à une colonne de l utilisation d une table. La définition concernant les éléments liés est l équivalent de la définition de l utilisation des propriétés au niveau de la fonction. Pour sélectionner les éléments liés L onglet Items de la boîte de dialogue Table usage permet de sélectionner les colonnes de la table qui seront utilisées par le module. Les éléments listés dans la colonne de gauche sont disponibles pour le module et ceux listés dans la colonne de droite sont utilisés par le module. Lorsqu il y a un crochet dans la case placée à côté de l élément, cela signifie que la colonne sera affichée dans le formulaire. Pour spécifier l utilisation des éléments liés L onglet Operations de la boîte de dialogue Table usage permet de spécifier les opérations qui pourront être effectuées sur chacun des items sélectionnés (onglet Items). Les opérations permises sont : Query pour saisir un critère d interrogation ; Insert pour insérer un valeur dans la colonne ; Update pour modifier la valeur de la colonne. Même si toutes les opérations sont affichées pour l utilisation d une table lookup, seulement l opération Query est permise. Si les opérations Insert et Update sont cochées pour un élément d une table lookup, le système enlèvera cette propriété lors de la génération du formulaire. Si vous avez associé une séquence à la clé primaire d une table, ne cochez pas l opération Insert pour la colonne correspondante. Également, si la clé primaire n est pas modifiable, ne cochez pas l opération Update de cette colonne. Si ces cases sont cochées, le système modifiera les propriétés lors de la génération du formulaire. Pour spécifier une valeur obligatoire L onglet Optional de la boîte de dialogue Table usage permet de spécifier si la valeur de l élément est obligatoire ou non. Par défaut, les colonnes définies avec une contrainte d intégrité Not null sont affichées dans la fenêtre de droite. Si vous désiriez rendre obligatoire la valeur d une colonne optionnelle pour un formulaire spécifique, vous pouvez transférer cette colonne de la fenêtre de gauche à la fenêtre de droite. Le filtrage des données Le filtrage des données peut être effectué pour chacune des utilisations de table. Tout comme dans une requête SELECT, le filtrage se fait à l aide de la clause Where. À partir de la boîte de dialogue Edit Table Usage, saisir la condition dans la boîte de texte de l onglet Where. Ne pas inscrire le mot réservé «WHERE», il sera généré automatiquement par le système. Le tri des enregistrements La spécification du tri des enregistrements, soit la clause Order by, se fait uniquement à partir de la fenêtre des propriétés. Vous devez saisir un chiffre correspond à la séquence de tri dans la propriété Order by sequence de la colonne (élément lié). La propriété Sort order permet de spécifier un tri ascendant ou descendant. 6

7 Présentation de l information Placement des composantes module Le placement des composantes module est l équivalent d un canevas dans un formulaire. Rappelons-nous que le canevas est comme une page dans un document, il permet de placer les objets du formulaire. Les différents types de canevas supportés par Oracle Forms, sont : Intégrale/Content : La plupart des canevas utilisés sont de ce type. Il occupe toute la fenêtre à laquelle il est associé. Cependant, ce qui est vu à l écran est en fonction de la grandeur de la fenêtre. Lorsque plusieurs canevas sont reliés à la même fenêtre, seulement un des canevas peut être visionné à la fois. Cependant, il est possible d assigner une fenêtre différente pour chaque canevas, de sorte à ce que l on puisse visionner plusieurs canevas en même temps. Empilée/Stacked : Contrairement au type de canevas que l on vient de voir, le canevas empilé n occupe pas toute la fenêtre, il est affiché par-dessus. Barre d outils/toolbar : Le type de canevas Barre d outils/toolbar est similaire à une barre d outils que l on voit dans les applications Windows. Elle contient les boutons fréquemment utilisés par l utilisateur. Onglet/tab : Le type de canevas onglet permet d afficher sur un même canevas plusieurs pages d information connexes. Comme les canevas empilés, le canevas onglet est affiché sur un canevas intégral. La spécification du type de placement se fait à partir de l onglet Placement de la boîte de dialogue Edit Module Component (ou de l assistant Module Component Display Wizard). Selon la valeur sélectionnée dans la liste Placement of the module component, un nouveau canevas et/ou une nouvelle fenêtre seront créés. Pour créer un canevas de type Barre d outils/toolbar, vous devez sélectionner un canevas intégral et utiliser une composante module sans utilisation de table afin d obtenir un bloc de contrôle. Vous pouvez également modifier directement sur le diagramme le placement des composantes modules. Le format du canevas est défini dans les cases X et Y du même onglet ou de l onglet Size lorsque vous utilisez un canevas empilé. Consultez les préférences Layout Windows et Layout Canvas pour modifier l apparence des fenêtres et des canevas. 7

8 Présentation de l inform ation Placement des composantes module New content canvas Same content canvas New content canvas New stacked canvas 8

9 Le titre du bloc Le titre du bloc est spécifié dans la case Title de l onglet Name de la boîte de dialogue Edit Module Component. Si la valeur est à nulle, il n y aura pas de titre affiché pour le bloc. La préférence BLKTLJ permet de spécifier le type d alignement pour le titre du bloc. Le titre de la fenêtre Le titre de la fenêtre est spécifié dans la case Window title de l onglet Name de la boîte de dialogue Edit window. Les préférences WINHSB et WINVSB permettent de spécifier l affichage d une barre de défilement horizontale ou verticale. Le nombre d enregistrements affichés La propriété Number of rows displayed permet de spécifier le nombre de rangées à afficher. Lorsque l option Maximum est sélectionnée, le système détermine alors le nombre maximal de rangées qu il peut afficher à l écran. Si la deuxième option est sélectionnée, alors le système affichera exactement le nombre de rangées que vous avez indiqué. Présentation de l inform ation Nombre d enregistrements 9

10 Le style d affichage des enregistrements Il arrive souvent que l ensemble des éléments d une composante module ne peuvent pas tous s afficher sur la même ligne. La propriété Overflow style de l onglet Display de la boîte de dialogue Edit Module Component permet de spécifier le style qui sera utilisé pour afficher les colonnes. Les différents styles sont : Wrap line : Pour afficher les colonnes d une même rangée sur plusieurs lignes. C est le défaut du générateur. Les autres styles d affichage utilisent les éléments qui ont été définis dans le contexte. Dans un formulaire, le contexte correspond à un ou plusieurs éléments qui sont toujours affichés à l écran. Habituellement, on identifie les éléments significatifs pour l utilisateur afin qu il puisse identifier un enregistrement. La propriété Context de l élément permet de l inclure dans le contexte. Cet élément est accessible à partir de l onglet Context de la boîte de dialogue Edit table usage ou de l onglet ou de l onglet Display de la boîte de dialogue Edit bound item. Par défaut, le contexte est composé des éléments faisant partie de la clé primaire. Les styles d affichage suivants sont surtout utilisés pour les blocs multirangées. Spread table : Pour afficher un enregistrement sur une même ligne. Les colonnes qui ne font pas partie du contexte sont affichées dans une fenêtre avec une barre de défilement. Les colonnes de contexte sont à l extérieur de la fenêtre et elles sont toujours visibles à l écran. Overflow Area Right : Permet d afficher le contexte sur plusieurs lignes et le débordement, soit les autres colonnes, sur une seule rangée placée dans une fenêtre à la droite. L information affichée dans la fenêtre correspond à l enregistrement sélectionné dans le contexte. Overflow Area Below : Même chose que le style d affichage Overflow Area Right sauf que le détail du contexte est affiché en dessous. L affichage des colonnes doit être ordonnancé en fonction des éléments qui composent le contexte. Pour afficher plusieurs éléments dans le contexte, vous devez mettre la préférence OFADFT à No. Les préférences suivantes permettent de modifier l aspect visuel d un affichage multirangées : ITMIPG pour contrôler l espace libre entre les éléments d un même enregistrement. PAGIBS pour contrôler l espace libre entre les blocs. BLKTLM pour fixer la marge du titre des blocs. CURREC pour mettre en surbrillance l enregistrement en cours. SPRBEV pour contrôle la transition entre le contexte et le débordement des colonnes. Les préférences suivantes permettent de modifier l aspect visuel du contexte : CONDEC pour fixer le contour des blocs. CONHDS et CONFTS pour spécifier l espace libre entre l entête et le pied de page. CONTLM et GRPTLM pour fixer les marges des titres des groupes et du contexte. 10

11 Présentation de l inform ation Style d affichage Overflow area below Contexte Overflow area right Wrap line Spread table 11

12 L ordonnancement des éléments La façon la plus rapide pour modifier l ordonnancement des colonnes est à partir du diagrammeur en mode Display view. On fait tout simplement glisser l élément à l endroit désiré. Vous pouvez également modifier l ordonnancement des colonnes à partir de l onglet Displayed items de la boîte de dialogue Module Component Display Wizard. Présentation de l inform ation Ordonnancement des éléments Onglet Displayed items de la boîte de dialogue Module Component Display Wizard Diagrammeur 12

13 L affichage des éléments La définition la plus détaillée que l on retrouve pour les éléments est à partir de la boîte de dialogue Edit bound item : Onglet Definition La case Default value permet de spécifier une valeur de défaut pour la colonne. Évitez de spécifier une valeur de défaut si la valeur de la colonne n est pas obligatoire. Présentation de l inform ation Affichage des éléments Valeur de défaut 13

14 Onglet Display La case Prompt permet de spécifier le libellé de l élément. Le type de données utilisé pour afficher la valeur de l élément est spécifié dans la case Display type. Ce type de données peut être différent de celui défini dans le dictionnaire de données. Si une liste de valeur a été définie pour la colonne dans le design de la base de données, vous pouvez sélectionner un type d élément graphique, tels Radio group, Check box, Popup list, afin de rendre l interface plus conviviale. La case Show meaning permet de spécifier la valeur qui sera affichée à l écran. La largeur et le nombre de ligne occupées par l élément sont spécifiés dans les cases Width et Height. La case Allignment permet de spécifier l alignement des valeurs de la colonne. Le format d affichage est spécifié dans la case Format mask. Rappelons les principaux formats d affichage pour une colonne. Type de Masque Description données Chaîne de X Tous les types de caractères Caractères 9 Caractère numérique seulement A Caractère alphabétique seulement FM Chaîne non fixe "caractères" Les caractères entre les apostrophes (double quotes) sont copiés tels quels. Numé- 9 Détermine le nombre de chiffres à afficher rique 0 placé devant Affiche les 0 du début (leading zeros) 0 placé après Affiche les 0 de la fin $ Affiche le signe $ devant le chiffre B N affiche pas les 0 du début MI Affiche le signe négatif après la valeur négative PR Affiche une valeur négative entre <>, ou. Affiche les symboles «,» ou «.» à cet position "caractères" Les caractères entre les apostrophes (double quotes) sont copiés tels quels. Date Y, YY, YYY, YYYY Affiche de nombre de positions correspondantes pour l année MM Affiche le mois en chiffre MON Affiche les trois premiers caractères du mois MONTH Nom du mois DD Affiche le jour du mois DY Affiche le nom du jour abrégé DAY Affiche le jour de la semaine / ou, ou. ou : ou - Le caractère est inséré à cette position "caractères" Les caractères entre les apostrophes (double quotes) sont copiés tels quels. L onglet Item Details de la boîte de dialogue Module Component Display Wizard permet de spécifier le libellé et le type de données utilisé pour afficher la valeur de l élément. L onglet Display de la boîte de dialogue Edit table usage présente les mêmes propriétés. On peut également y spécifier la largeur et le nombre de lignes occupées par l élément. 14

15 Présentation de l inform ation Affichage des éléments Libellé (Prompt) Type de données d affichage (Display type) Présentation de l inform ation Affichage des éléments Espace occupé (Width et Height) Alignement Format d affichage Chaîne de caractère Numérique Date 15

16 Regroupement des éléments Un regroupement d éléments (Group item) permet de regrouper physiquement sur le formulaire les éléments qui font partie du groupe. Les regroupements sont créés à partir de l onglet Item groups de la boîte de dialogue Module Component Display Wizard. La case Stacked permet de spécifier si les regroupements d une même composante module seront empilés. Un regroupement empilé est l équivalent d une fenêtre popup dans un formulaire Oracle Forms. L onglet Items and groups de la même boîte de dialogue permet d inclure les éléments à l intérieur d un groupe. Les éléments liés et non liés de toutes les utilisations de table d une même composante module peuvent faire partie d un même groupe. Sur le diagrammes les regroupements sont visibles uniquement en mode présentation (Display view). Présentation de l inform ation Regroupement des éléments Mode présentation 16

17 Élément non lié (Unbound item) Les éléments non liés (Unbound item) permettent de calculer ou de dériver une valeur à partir des colonnes de la base de données ou des autres éléments du module. Les types d éléments non liés sont les suivants : Fonction client (Client side function) : Pour faire appel à une fonction enregistrée dans un unité de programme du formulaire en cours ou d une bibliothèque. Le nom de la fonction et les paramètres d entrée sont définis sur l onglet Client side function. Calculé (Computed) : Permet de calculer un sommaire à l aide d une des fonctions de groupe, tels COUNT, AVG, SUM, MIN et MAX. Le sommaire peut être effectué sur un des éléments de n importe quelle composante module du même module. Lorsqu une autre composante module est utilisée, vous devez alors préfixer le nom de l élément avec le nom du module. L élément non lié calculé est souvent utilisé pour calculer un sommaire sur le bloc détail et de l afficher dans le bloc parent. Par exemple, le total de la commande, le nombre d équipements dans un local, etc. Personnalisé (Custom) : Ce type est utilisé pour modifier la logistique de l interface de contrôle bouton. Expression SQL (SQL Expression) : Ce type est similaire à l élément calculé, à l exception qu il s applique sur une seule rangée. Les fonctions SQL sont également permises ainsi que les opérateurs arithmétiques. Fonction serveur (Server side implementation) : Pour faire appel à une fonction enregistrée dans la base de données. Les propriétés d affichage des éléments non liés sont similaires à celles des élément liés. 17

18 Élém ents non liés Pour calculer ou dériver une valeur Type Fonction client (Client side function) Calculé (Computed) Personnalisé (Custom) Expression SQL (SQL Expression) Fonction serveur (Server side implementation) Élém ents non liés Calculé (Computed) 18