Présentation de la documentation

Graphics Builder comprend un système d'aide en ligne clair fournissant des informations sur des concepts, des références et des instructions.

Pour démarrer et utiliser correctement Graphics Builder :

1	Passez en revue les Aperçus produit pour obtenir des informations générales sur chacun des composants Graphics Builder :

•	Choisissez Aide [image] Aperçu produit.

2	Parcourez les Assistants pour apprendre à effectuer les tâches les plus courantes :

•	Choisissez Aide [image] Assistants.

3	Consultez les manuels en ligne ou papier :

•	Choisissez Aide [image] Manuels.

4	Accédez aux rubriques d'aide :

•	Pour consulter le sommaire et l'index, choisissez Aide [image] Rubriques d'aide.

•	Pour obtenir l'aide contextuelle, appuyez sur [Aide] (touche F1 sur la plupart des plates-formes).

•	Pour connaître les commandes associées aux touches dans Form Builder, choisissez Aide [image] Aide sur touches ou appuyez sur [Afficher touches] (Ctrl-K sur la plupart des plates-formes).


Création d'objets arc

Pour créer un objet arc :

1	Sélectionnez l'outil Arc dans la palette d'outils.

2	Faites-le glisser en diagonale sur la présentation pour définir l'arc de votre choix, puis relâchez.

Pour dessiner l'arc d'un cercle, maintenez la touche Maj enfoncée tout en faisant glisser.


Création d'objets ellipse

Pour créer un objet ellipse :

1	Sélectionnez l'outil Ellipse dans la palette d'outils.

2	Faites-le glisser en diagonale sur la présentation pour définir l'ellipse de votre choix, puis relâchez.

Pour dessiner un cercle, maintenez la touche Maj enfoncée tout en faisant glisser.


Création d'objets forme libre

Pour créer un objet forme libre :

1	Sélectionnez l'outil Forme libre dans la palette d'outils.

2	Faites-le glisser sur la présentation pour définir la forme libre de votre choix, puis relâchez.

La forme libre ne peut pas être contrainte.


Création d'objets ligne

Pour créer un objet ligne :

1	Sélectionnez l'outil Ligne dans la palette d'outils.

2	Sélectionnez le point de départ de votre choix, faites glisser jusqu'au point de fin de votre choix, puis relâchez.

Pour tracer une ligne horizontale, verticale ou à 45°, maintenez la touche Maj enfoncée tout en faisant glisser dans la direction de votre choix.


Création d'objets polygone

Pour créer un objet polygone :

1	Sélectionnez l'outil Polygone dans la palette d'outils.

2	Sélectionnez l'endroit choisi pour le premier sommet, puis sélectionnez le sommet suivant, et ainsi de suite. Pour terminer le tracé du polygone, cliquez deux fois sur le dernier sommet.

Une ligne relie le premier et le dernier sommets.

Pour tracer un segment horizontal, vertical ou à 45°, maintenez la touche Maj enfoncée tout en définissant un sommet. Contraindre un sommet est sans effet sur les sommets suivants.


Création d'objets lignes polygonale
Création d'objets ligne polygonale

Pour créer un objet ligne polygonale :

1	Sélectionnez l'outil Ligne polygonale dans la palette d'outils.

2	Sélectionnez l'endroit choisi pour le premier sommet, puis sélectionnez le sommet suivant, et ainsi de suite.

Contrairement à l'objet polygone, si vous ne reliez pas manuellement le premier et le dernier sommet, aucune ligne ne les relie.

Pour tracer un segment horizontal, vertical ou à 45°, maintenez la touche Maj enfoncée tout en définissant un sommet.


Création d'objets ligne polygonale
Création d'objets rectangle

Pour créer un objet rectangle :

1	Sélectionnez l'outil Rectangle dans la palette d'outils.

2	Faites-le glisser en diagonale sur la présentation pour définir le rectangle de votre choix, puis relâchez.

Pour tracer un carré, maintenez la touche Maj enfoncée tout en faisant glisser.


Création d'objets rectangle arrondi

Pour créer un objet rectangle arrondi :

1	Sélectionnez l'outil Rectangle arrondi dans la palette d'outils.

2	Faites-le glisser en diagonale sur la présentation pour définir le rectangle arrondi de votre choix, puis relâchez.

Pour tracer un carré arrondi, maintenez la touche Maj enfoncée tout en faisant glisser.


Création de formes par programme

  Rubriques connexes

Pour créer des formes par programme :

  Utilisez les procédures internes PL/SQL Graphics Builder.

L'exemple ci-dessous crée un grand rectangle de couleur qui servira de fond à d'autres objets et graphiques :

PROCEDURE create_background IS
  the_back   OG_OBJECT;
  rect_pos   OG_POINT;
  rect_ht    NUMBER;
  rect_wi    NUMBER;
BEGIN
/*Définir la position de départ du rectangle*/
  rect_pos.x:=.5*OG_INCH;
  rect_pos.y:=.5*OG_INCH;
/*Définir la hauteur et la largeur du rectangle*/
  rect_ht:=6*OG_INCH;
  rect_wi:=4*OG_INCH;
/*Créer l'objet rectangle arrondi*/
  the_back:=OG_MAKE_RRECT(rect_pos, rect_ht, rect_wi);
/*Définir la couleur et le motif de remplissage du premier plan de l'objet*/
  OG_SET_FFCOLOR(the_back, 'color 25');
  OG_SET_FILLPAT(the_back, 'gray50');
END;


A propos des symboles

Vous pouvez utiliser des symboles comme éléments décoratifs d'une présentation, ou indiquer des symboles qui seront utilisés comme types de tracé dans un modèle de champ de graphique.


Sélection de symboles dans la palette Symboles

Pour sélectionner un symbole dans la palette Symboles :

1	Ouvrez la palette Symboles en sélectionnant son icône dans la palette d'outils.

La palette s'ouvre et affiche les symboles disponibles.

2	Sélectionnez le symbole que vous voulez utiliser.

La palette se ferme et le symbole apparaît dans l'icône de palette Symbole. Le symbole est appliqué à tout objet symbole sélectionné et aux nouveaux objets symbole que vous placez sur la présentation à l'aide de l'outil Symbole. La sélection reste en vigueur pendant tout l'affichage, jusqu'à ce qu'il soit à nouveau modifié.

Vous ne pouvez pas modifier les symboles disponibles.


Insertion de symboles dans la présentation

Pour insérer un symbole dans la présentation :

1	Sélectionnez l'outil Symbole dans la palette d'outils.

2	Sélectionnez l'endroit où vous voulez que le symbole apparaisse.

Le symbole sélectionné dans la palette Symboles apparaît dans la présentation.


Création de symboles par programme

  Rubriques connexes

Pour créer des symboles par programme :

  Utilisez la procédure interne OG_MAKE_SYMBOL de Graphics Builder.

Par exemple :

PROCEDURE make_sym IS
  place  OG_POINT;
BEGIN
  place.x:=1*OG_INCH;
  place.y:=2*OG_INCH;
  OG_MAKE_SYMBOL(place, 5, OG_MEDIUM_SYMSIZE);
END;


A propos des textes et des champs de texte

  Rubriques connexes

Graphics Builder propose deux objets permettant d'ajouter du texte à un affichage : les objets texte et les objets champ texte. Ces objets permettent d'exécuter les opérations suivantes :

•	Création d'objets texte

•	Création d'objets texte par programme

•	Edition d'objets texte

•	Création d'objets champ texte

•	Définition des propriétés de tout l'objet texte ou de tout le champ texte

•	Définition des propriétés d'un objet texte partiel ou d'un champ objet texte par défaut

•	Vous pouvez utiliser des objets texte pour fournir aux utilisateurs des titres, des éléments graphiques d'étiquettes ou leur communiquer des instructions. Utilisez les objets champ texte pour leur fournir des zones d'entrée dans lesquelles ils pourront entrer du texte lors de l'exécution.


Création manuelle d'objets texte

Pour créer un objet texte :

1	Sélectionnez l'outil Texte dans la palette d'outils.

2	Pour créer une boîte englobante contenant le curseur texte dans la présentation, exécutez l'une des opérations décrites ci-dessous :

Sélectionnez l'endroit où vous voulez que l'objet texte commence. Le texte n'est renvoyé à la ligne suivante que lorsque vous appuyez sur la touche Retour.

Avec la souris, délimitez une zone de texte dont les limites horizontales forceront automatiquement le passage à la ligne. Si nécessaire, la zone sera agrandie verticalement en fonction de la longueur du texte à saisir.

3	Tapez le texte. Utilisez la touche Retour pour entrer un saut de ligne obligatoire.

4	Lorsque vous avez terminé, cliquez à l'extérieur de la présentation de l'objet texte pour sortir du mode texte.

Notez que si vous créez un objet texte sans y entrer de texte, l'objet est automatiquement supprimé. Pour créer un objet texte vide, commencez par le créer avec du texte, puis éditez-le et supprimez le texte. Vous ne pouvez créer un objet texte vide que s'il a une boîte englobante fixe.


Création d'objets texte par programme

  Exemple	  Rubriques connexes

Pour créer des objets texte par programme :

1	Créez l'objet texte.

2	Créez et insérez un élément de texte composé dans l'objet texte principal.

•	Un élément texte composé représente une ligne de texte dans l'objet texte. L'élément texte composé peut contenir une ou plusieurs chaînes de texte (éléments texte simples).

•	Sauf indication contraire, le premier élément texte composé est inséré au point index zéro (0) de l'objet texte.

3	Créez un élément texte simple à insérer dans l'objet texte composé créé précédemment.

Un élément texte simple est une chaîne de texte qui sera insérée dans la ligne créée par l'élément texte composé.

4	Insérez l'élément texte simple dans l'élément texte composé. Insérez-les un à un, chacun à un point index particulier dans l'élément texte composé.

5	Répétez les étapes 3 et 4 jusqu'à ce que le texte de votre choix soit entré dans l'objet texte.

Vous pouvez définir la taille, la police et l'espacement de chaque élément texte simple ou de la totalité de l'objet texte.


Exemple : Création d'objets texte par programme

L'exemple ci-dessous crée un objet texte au point (1", 1") de la présentation et contient deux objets texte composés (lignes de texte). Le premier objet texte composé contient un élément (une chaîne) texte simple, le second deux éléments texte simple. Ces deux lignes de texte sont en police Times 12, comme indiqué ci-dessous :

Ligne 1.

Ligne 2.

PROCEDURE make_text IS
   text_obj   OG_OBJECT;
   text_pos   OG_POINT;
   smp_rec    OG_SMPTEXT_ATTR;
 BEGIN
/* Définir les propriétés d'origine de l'objet texte */
   text_pos.x:=OG_INCH;
   text_pos.y:=OG_INCH;

/* Créer l'objet texte */
   text_obj:=OG_MAKE_TEXT(text_pos);

 /* Insérer un nouvel élément texte composé dans l'objet texte
      à la position index 0 */
    OG_INSERT_CMPTEXT(text_obj, 0);

/* Définir l'enregistrement texte simple correspondant à la chaîne de texte de votre choix.*/
    smp_rec.str:='Voici la ligne 1.';
    smp_rec.mask:=OG_STR_SMPTEXTA;

/* Insérer un nouvel élément texte simple à l'index 0
      dans l'élément texte composé de l'objet texte
      à l'index 0, en utilisant l'enregistrement texte simple défini.*/
    OG_INSERT_SMPTEXT(text_obj, smp_rec, 0, 0);

/* Insérer un nouvel élément texte composé dans l'objet texte
     à l'index 1 */
    OG_INSERT_CMPTEXT(text_obj, 1);

/* Modifier la chaîne de texte de l'enregistrement texte simple. */
    smp_rec.str:='Et maintenant';

/* Insérer un nouvel élément texte simple à l'index 0
      de l'élément texte composé de l'objet texte
      à l'index 1, en utilisant l'enregistrement texte simple défini.*/
    OG_INSERT_SMPTEXT(text_obj, smp_rec, 1, 0);

/* Modifier la chaîne de texte de l'enregistrement texte simple.*/
    smp_rec.str:=' ligne 2.';

/* Insérer un nouvel élément texte simple à l'index 1
      de l'élément texte composé de l'objet texte
      à l'index 1, en utilisant l'enregistrement texte simple défini.*/
    OG_INSERT_SMPTEXT(text_obj, smp_rec, 1, 1);

/*Définir la police et la taille des caractères de l'objet texte*/
   OG_SET_FONT_PTSIZE(text_obj, '12');
   OG_SET_FONT_TYPEFACE(text_obj, 'Times');
END;


Création d'objets champ texte

Pour créer un objet champ texte :

1	Sélectionnez l'outil Champ texte dans la palette d'outils.

2	Faites-le glisser sur la présentation pour définir une boîte englobante rectangulaire, puis relâchez.

  Pour créer un champ texte carré, maintenez la touche Maj enfoncée tout en faisant glisser.

  Pour entrer un texte par défaut dans le champ texte :

3	Sélectionnez l'outil Texte dans la palette d'outils.

4	Sélectionnez l'objet champ texte. Un curseur de texte apparaît à l'endroit où vous avez cliqué.

5	Frappez le texte.

6	Lorsque vous avez terminé, cliquez sur la présentation, à l'extérieur de l'objet champ texte, pour sortir du mode texte.

Lors de l'exécution, le champ texte contient le texte par défaut que les utilisateurs pourront modifier.


Import d'un dessin

Pour importer un dessin :

1	Choisissez Editer [image] Importer [image] Dessin pour afficher la boîte de dialogue Import.

2	Indiquez la source des données du fichier en sélectionnant le bouton d'option Base de données ou Système de fichiers.

3	Entrez le nom du fichier/module dans le champ correspondant, ou sélectionnez Parcourir pour afficher la boîte de dialogue de fichiers de votre système d'exploitation ou la boîte de dialogue Base de données dans laquelle vous pouvez sélectionner le fichier/module.

4	Sélectionnez le type de format de dessin dans la liste déroulante Format.

5	Sélectionnez OK pour importer le fichier de dessin.

Le fichier importé apparaît dans la présentation.

Remarque : Si vous avez groupé des objets dans un fichier, puis converti le fichier en format CGM, les objets ne seront plus groupés.

Graphics Builder accepte les fichiers de dessin enregistrés en format CGM ou les fichiers graphiques, provenant d'autres applications Oracle, et enregistrés en format Oracle. Sauf indication contraire, Graphics Builder importe le dessin dans la couche active.


Import d'une image

Pour importer une image :

1	Choisissez Editer [image] Importer [image] Image pour afficher la boîte de dialogue Import.

2	Indiquez la source des données du fichier en sélectionnant le bouton d'option Base de données ou Système de fichiers.

3	Entrez le nom du fichier/module dans le champ correspondant ou sélectionnez Parcourir pour afficher la boîte de dialogue de fichiers de votre système d'exploitation ou la boîte de dialogue Base de données dans laquelle vous pouvez sélectionner le fichier/module.

4	Sélectionnez le type de format d'image dans la liste déroulante Format.

5	Sélectionnez OK pour importer le fichier de dessin.

Le fichier importé apparaît dans la présentation.


Import de dessins à l'aide de PL/SQL

  Rubriques connexes

Pour importer un dessin à l'aide de PL/SQL :

  Utilisez la procédure interne OG_IMPORT_IMAGE de Graphics Builder.

L'exemple ci-dessous importe une image dans la couche active de la fenêtre active :

PROCEDURE import_the_image IS
   the_image   OG_OBJECT;
   the_layer   OG_LAYER;
BEGIN
  the_layer:=OG_GET_LAYER('layer1');
  OG_ACTIVATE_LAYER(the_layer);
  the_image:=OG_IMPORT_IMAGE('my_image',OG_FILESYSTEM,
    OG_TIFF_IFORMAT);
END;


A propos des sons

Les sons permettent d'attirer l'attention de l'utilisateur sur des événements spécifiques, lors de l'exécution, par exemple, lorsque les données d'un graphique descendent en dessous d'un certain seuil, le déclenchement de l'alarme devant être commandé par programme, à l'aide de PL/SQL.


Enregistrement de sons

Pour enregistrer un son dans le Navigateur d'objet :

1	Dans le Navigateur d'objet, sélectionnez le sous-noeud Sons et choisissez le bouton Créer ou Navigateur [image] Créer. S'il n'existe pas de son dans l'affichage en cours, cliquez deux fois sur le noeud Sons, dans le Navigateur, pour afficher un nouveau son dans la boîte de dialogue Lecteur de son.

Un nouveau son (appelé au départ soundx) est créé, et la boîte de dialogue Lecteur de son s'affiche.

2	Pour enregistrer le nouveau son, sélectionnez Enregistrement.

3	Lorsque l'enregistrement est terminé, sélectionnez Stop.

4	Sélectionnez OK pour accepter le nouveau son et fermer la boîte de dialogue.

Le son est ajouté à votre affichage. Vous pouvez y accéder en utilisant la procédure interne PL/SQL OG_PLAY_SOUND.


Enregistrement de sons par programme

  Rubriques connexes

Pour enregistrer un son par programme :

  Utilisez la procédure interne Graphics Builder OG_RECORD_SOUND.

L'exemple ci-dessous affiche la boîte de dialogue de son dans l'affichage runtime et permet à l'utilisateur d'enregistrer un nouveau son.

PROCEDURE record_attention IS
   warn_sound   OG_SOUND;
BEGIN
   warn_sound:=OG_GET_SOUND('avertissement');
   IF NOT OG_ISNULL(warn_sound) THEN
      OG_RECORD_SOUND(warn_sound);
   END IF;
END;


Import de sons

Pour importer des sons :

1	Choisissez Editer [image] Importer [image] Son pour afficher la boîte de dialogue Import de son.

2	Sélectionnez le bouton d'option Système de fichiers ou Base de données pour indiquer la source du fichier.

3	Entrez le nom du fichier dans le champ Fichier ou sélectionnez Parcourir pour afficher une liste des fichiers que vous pouvez choisir.

4	Sélectionnez le format du fichier son dans la liste déroulante Format.

5	Sélectionnez OK pour accepter la boîte de dialogue et importer le son.

Le son est ajouté à votre affichage. Vous pouvez y accéder en utilisant la procédure interne PL/SQL OG_PLAY_SOUND.

Un fichier son existant peut être importé soit du système de fichiers, soit de la base de données.


Import d'affichages

Pour importer un affichage :

1	Choisissez Editer [image] Importer [image] Affichage pour afficher la boîte de dialogue Import d'affichage.

2	Indiquez le nom et l'emplacement de l'affichage, si vous voulez ou non que les couches actives de chaque affichage soient fusionnées, et la façon de régler les conflits de noms.

3	Sélectionnez Importer pour accepter la boîte de dialogue et importer l'affichage.

Vous pouvez importer dans votre affichage en cours un affichage stocké dans le système de fichiers ou dans une base de données, ce qui vous permet de copier le contenu d'un affichage dans un autre et de combiner les deux affichages.


A propos des couches

La boîte de dialogue Couches - paramètres vous permet d'exécuter toutes les opérations sur les couches. Pour l'afficher, choisissez Outils [image] Couches dans le menu. De nombreuses opérations peuvent également être exécutées à l'aide du Navigateur d'objet, notamment :

•	Création de nouvelles couches

•	Changement de nom de couche

•	Activation de couches

•	Activation d'une couche à l'aide de PL/SQL

•	Masquage et affichage de couches

•	Masquage et affichage de couches à l'aide de PL/SQL

•	Modification de l'ordre des couches

•	Suppression de couches

La couche active est votre couche de travail et est toujours affichée. Cependant, vous pouvez créer plusieurs couches qui seront affichées avec la couche active, ou masquer plusieurs couches. Lorsque vous créez un nouvel affichage, il ne contient qu'une couche, appelée couche 0, qui est donc, par défaut, la couche active.

PL/SQL vous permet de manipuler les couches existantes lors de l'exécution. La couche active est la seule permettant une interaction avec tous les utilisateurs, mais vous pouvez la modifier à l'aide de PL/SQL, selon l'endroit où vous voulez que l'entrée utilisateur ait lieu. Vous pouvez également masquer, afficher et modifier l'ordre d'empilement des couches, pour masquer totalement ou partiellement certains objets.

Par exemple, votre présentation peut apparaître sous la forme d'une surface unique.

Mais elle peut également se composer de plusieurs couches.

Vous pouvez définir un nombre quelconque de couches qui seront affichées ou masquées, à un moment ou à un autre. La couche active doit toujours être affichée.


Création de nouvelles couches

Pour créer une nouvelle couche :

1	Sélectionnez l'objet couche dans le Navigateur d'objet.

2	Choisissez le bouton Créer ou Navigateur [image] Créer pour afficher la boîte de dialogue Couches - paramètres.

Vous pouvez également choisir Outils [image] Couches dans le menu.

3	Sélectionnez Nouveau. La liste Couches existantes comporte une nouvelle couche, appelée couchex, où x est un numéro d'instance qui est incrémenté d'une unité chaque fois qu'une couche est créée. Cette couche devient également la couche active.

4	Sélectionnez OK pour confirmer les modifications et fermer la boîte de dialogue Couches - paramètres.

Si la présentation est répartie en plusieurs vues, la nouvelle couche est ajoutée à toutes les vues. Cependant, elle ne devient la couche active que dans la vue active.


A propos des affichages

Une application créée avec Graphics Builder porte le nom d'affichage. Un affichage peut contenir différents composants, dont les données extraites d'une source par interrogation, des éléments graphiques et des fonctions de comportement comme la hiérarchisation vers le bas ou la mise à jour permanente.

Les affichages de Graphics Builder (affichés dans Builder) se composent des éléments suivants :

graphiques

objets graphiques

dessins importés

sons

couches

sauts de page

informations de copyright


Graphiques

Les graphiques sont des représentations schématiques que vous pouvez créer dans un affichage pour représenter visuellement des données.


Objets graphiques

Les objets sont les éléments visuels de votre présentation. Les objets graphiques sont des éléments visuels que vous créez à l'aide des outils de dessin de Graphics Builder ou que vous importez dans vos affichages.


Dessins importés

Vous pouvez non seulement créer des dessins dans Graphics Builder, mais importer des fichiers de dessins et d'images d'applications tierces.


Sons

Si votre système comporte une fonction de sonorisation, vous pouvez créer des enregistrements audio à utiliser dans vos affichages.


Couches

Chaque présentation d'affichage se compose d'une ou de plusieurs surfaces distinctes appelées couches. Les couches permettent de masquer les objets que vous ne voulez afficher que dans des cas particuliers. Par exemple, vous pouvez placer sur une couche un bouton que l'utilisateur sélectionne pour afficher un objet d'une autre couche. De même, vous pouvez vouloir masquer une couche afin de pouvoir afficher ses objets dans une fenêtre autre que la fenêtre Présentation principale.


Sauts de page

Les sauts de page sont des lignes noires continues qui apparaissent dans la présentation et représentent chacune une limite de page imprimée. La taille des pages est déterminée par les paramètres de la boîte de dialogue Configuration de l'imprimante.

Les sauts de page, qui apparaissent uniquement dans Builder, ne sont pas visibles lorsque l'affichage est exécuté ou imprimé.


Informations de copyright

Les informations de copyright vous permettent d'ajouter à un affichage que vous avez créé des informations diverses (votre nom et la date de dernière mise à jour, par exemple). Ces informations sont utiles aux autres utilisateurs qui ne peuvent recevoir que l'affichage Runtime, mais veulent avoir un complément d'information (par exemple, le nom de l'auteur et la date de création).


A propos de la création des affichages

Chaque fois que vous appelez Builder, un nouvel affichage appelé à l'origine Disp1 apparaît automatiquement, de façon à vous faciliter la tâche.

Pour indiquer qu'aucun affichage initial n'est créé lorsque vous lancez Graphics Builder, choisissez Outils [image] Options outils pour afficher la feuille de propriété Options outils. Choisissez l'onglet Préférences. Dans le bloc Démarrage, sélectionnez Pas d'affichage dans la liste déroulante Ouvrir. Sélectionnez Enregistrer pour enregistrer ce paramètre dans votre fichier de préférences.


Création d'un nouvel affichage

Pour créer un nouvel affichage :

  Dans le Navigateur d'objet, sélectionnez le noeud Affichages, puis sélectionnez le bouton Créer de la barre d'outils.

Un nouvel affichage apparaît dans son propre Editeur de présentation. Son nom par défaut est Dispx, où x est un numéro d'instance qui est incrémenté d'une unité à chaque création d'un affichage pendant la session en cours.

Si aucun affichage n'est ouvert, cliquez deux fois sur le noeud Affichages du Navigateur pour en créer un.


A propos des graphiques

Un graphique apparaît dans la présentation sous la forme d'un seul objet, mais se compose en réalité de trois éléments :

•	Interrogation

•	Région de graphique

•	Modèle de graphique

Pour créer des composants de graphiques dans l'Editeur de présentation, indiquez une interrogation et un modèle de graphique à utiliser, puis définissez la région de graphique dans la présentation. Vous pouvez également créer par programme des composants de graphique en utilisant PL/SQL.

Par exemple, vous pouvez définir par programme une interrogation, sélectionner un modèle de graphique, transformer un champ en bouton, ou "détacher" un champ en le définissant séparément du reste du graphique. Vous pouvez également utiliser PL/SQL pour définir les propriétés graphiques des champs en définissant leur type de motif, leur couleur ou leur type de ligne. Vous pouvez alors définir une condition, comme une valeur de seuil spécifique pour une catégorie de données, sous laquelle doit être appliquée une propriété. Lors de l'exécution, Graphics Builder appliquera les propriétés aux champs indiqués, en fonction des catégories de données ou des conditions en vigueur.


A propos des interrogations

Une interrogation est une instruction SQL SELECT ou un fichier dont Graphics Builder a besoin pour extraire les données d'un graphique. Un graphique ne peut pas être associé à plusieurs interrogations à la fois. Lorsque vous dessinez un graphique, Graphics Builder utilise les données de l'interrogation en cours si vous n'en indiquez pas d'autres.


A propos des modèles de graphique

Un modèle de graphique définit le format d'un graphique et ses différentes propriétés. Un graphique ne peut être associé qu'à un modèle de graphique à la fois. Cependant, vous pouvez exécuter sur un modèle de graphique les actions indiquées ci-dessous, puis utiliser ce modèle pour appliquer des propriétés à plusieurs graphiques.

•	Indication des propriétés des cadres d'axe

•	Indication des propriétés discrètes et continues, et d'axes de date

•	Déplacement de légende

•	Définition des lignes de référence

•	Indication des formats de nombre et de date

•	Indication des propriétés de texte et de ligne

•	Indication des couleurs et des motifs

Chaque modèle de graphique peut être associé à un ou à plusieurs modèles de champ, qui définissent les propriétés des différents champs (barres, colonnes, secteurs ou lignes, par exemple).


A propos des types de graphique

Le tableau ci-dessous décrit les différents types de graphique que vous pouvez créer, ainsi que des suggestions d'utilisation :

Colonne	Ce type de graphique permet de comparer des ensembles de plages de données verticalement. Par exemple, utilisez un graphique en colonnes pour afficher les ventes trimestrielles correspondant à chaque vendeur.
Secteur	Utilisez ce type de graphique pour comparer les ratios ou les pourcentages de parties d'un tout, par exemple, les ventes annuelles par département ou par trimestre.
Barre	Utilisez ce type de graphique pour comparer des ensembles de plages de données horizontalement, par exemple, des chiffres d'affaire mensuels.
Table	Utilisez ce type de graphique pour afficher des données sous forme de tableaux, par exemple, l'organigramme des employés.
Trait	Utilisez ce type de graphique pour afficher les modifications verticales d'un ensemble de données spécifiques, par exemple, pour évaluer les modifications quotidiennes ou horaires de la valeur d'un stock.
Nuage de points	Utilisez ce type de graphique pour afficher les données le long de deux axes de valeurs. Les graphiques en nuage de points sont parfaits pour l'affichage d'écarts type. Par exemple, vous utiliserez ce type de graphique pour tracer la courbe d'âges et de salaires de vos employés. S'il existe une corrélation entre les deux ensembles de données, les points se trouveront relativement proches les uns des autres. En revanche, un ou plusieurs points en dehors du groupe indiquent une disparité de salaires.
Combiné	Utilisez ce type de graphique pour regrouper plusieurs types de tracé (colonnes et lignes par exemple), pour afficher les ventes quotidiennes, avec un tracé de type ligne correspondant à un récapitulatif des données.
Haut - bas	Utilisez ce type de graphique pour afficher les champs de valeurs qui correspondent au maximum, au minimum et à la clôture (c'est-à-dire aux prix des actions). A chaque ligne de votre interrogation correspond sur le graphique une plage haut-bas.
Double - Y	Ce type de graphique offre deux axes Y indépendants sur lesquels les données sont tracées. Chaque axe des Y peut correspondre à une série de valeurs particulières. Par exemple, vous pouvez utiliser un axe pour représenter les recettes et le second pour représenter le chiffre d'affaire et tracer les deux pour une période donnée.
Gantt	Utilisez ce type de graphique pour afficher des ensembles de données de projet sur une durée donnée. Les graphiques de Gantt sont généralement utilisés pour afficher les dates butoirs d'un projet.


A propos des graphiques à axes

  Exemple

La plupart des graphiques que vous pouvez créer dans Graphics Builder sont des graphiques à axes, c'est-à-dire des graphiques sur lesquels le traçage des données dépend de l'endroit où elles se trouvent sur les bords du graphique, appelés axes. Les graphiques à colonnes, à barres et à traits sont tous des graphiques à axes. Un graphique à axes peut contenir deux ou trois axes, de différents types :

•	discret

•	continu

•	date

Notes d'utilisation : Si vous créez des graphiques à axes, les libellés des axes X et Y sont dérivés des noms de colonne attribués à la table dans votre interrogation. Vous pouvez soit personnaliser ces libellés d'axe en utilisant la fenêtre de propriété Axe, soit indiquer un alias de nom de colonne dans votre interrogation. Si vous avez l'intention d'utiliser des modèles de graphique, vous aurez intérêt à attribuer des libellés d'axe personnalisés dans votre interrogation.


Exemple : attribution de libellés d'axe personnalisés dans les interrogations

/*L'exemple ci-dessous explique comment personnaliser des
**libellés d'axe en indiquant un alias de nom de colonne
**dans l'interrogation.
*/

select warehouse_id "ID entrepôt ",
amount_in_stock "Niveaux des stocks"
from s_inventory


A propos des axes discrets

Un axe discret est un axe qui trace des valeurs distinctes à des intervalles fixes. Ces valeurs ne sont pas associées mathématiquement. Les données (indépendantes) de catégorie sont généralement tracées le long de cet axe, également appelé axe de catégorie.

Par exemple, vous pouvez tracer des noms d'employés sur un axe discret. Cependant, vous ne pouvez pas tracer de graphique de leurs salaires (puisque les valeurs monétaires sont liées par un rapport mathématique, l'une étant supérieure à l'autre).


A propos des axes continus

Un axe continu est un axe qui trace des valeurs associées mathématiquement. L'axe commence à une valeur et se poursuit jusqu'à ce qu'il atteigne une autre valeur. L'intervalle de traçage dépend de l'endroit où se situent les valeurs des données entre les limites supérieure et inférieure de l'axe. Des données dépendant des valeurs sont généralement tracées le long de cet axe, également appelé axe de valeurs.

Par exemple, vous pouvez tracer la courbe de salaires des employés le long d'un axe continu, mais vous ne pouvez pas y tracer les noms des employés.


A propos des axes de date

Un axe de date est un axe sur lequel sont tracées des valeurs de date. L'axe commence à une date et se poursuit jusqu'à ce qu'il atteigne une autre date. (A cet égard, un axe de date peut être comparé à un axe continu, bien que Graphics Builder traite différemment ces deux types d'axe.) L'intervalle de traçage dépend de l'endroit où se situent les valeurs de données entre les limites inférieure et supérieure de l'axe.

Par exemple, vous pouvez tracer la courbe des dates d'embauche des employés le long d'un axe de date.


Création d'un graphique à partir d'une nouvelle interrogation dans l'Editeur de présentation

Pour créer un graphique :

1	Choisissez Fichier [image] Connecter pour vous connecter à une base de données si vous ne l'êtes pas encore.

2	Sélectionnez l'outil Graphique de la palette d'outils, puis sélectionnez la présentation ou délimitez une région pour le graphique.

Vous pouvez également choisir Graphique [image] Créer un graphique dans le menu.

Si vous ne délimitez pas une région pour le graphique, Graphics Builder utilise une taille par défaut.

Si votre affichage contient déjà des interrogations, la boîte de dialogue Assistant graphique s'affiche. Si votre recherche ne contient pas d'interrogation, la boîte de dialogue Nouvelle interrogation apparaît.

Pour créer une interrogation :

3	Si l'Assistant graphique apparaît, sélectionnez le bouton d'option Nouvelle interrogation, puis sélectionnez OK pour afficher le boîte de dialogue Nouvelle interrogation.

4	Entrez une instruction SQL SELECT dans le champ Instruction SQL ou sélectionnez un autre type d'interrogation.

5	Sélectionnez Exécuter pour exécuter l'interrogation.

Vous pouvez visualiser les données retournées dans la page de propriété Données.

Pour indiquer les propriétés du graphique :

6	Sélectionnez OK pour fermer la fenêtre de propriété Nouvelle interrogation et afficher la fenêtre de propriété Graphique.

7	(Facultatif)  Entrez le nom et le titre de votre graphique.

8	Sélectionnez un type et un sous-type de graphique.

9	Sélectionnez OK pour créer le graphique.

Le graphique est défini dans l'Editeur de présentation. L'objet graphique apparaît dans le Navigateur d'objet. La région graphique est la région couverte par le graphique. Les étiquettes de graduation et la légende peuvent dépasser les limites de cette région.

Vous pouvez maintenant manipuler l'objet graphique (par sélection, déplacement, redimensionnement, suppression, etc.) comme vous le feriez pour tout autre objet de la présentation, ou modifier ses propriétés.


Création d'un graphique à partir d'une interrogation existante

Pour créer un graphique à partir d'une interrogation existante :

1	Dans l'Editeur de présentation, sélectionnez l'outil Graphique de la palette d'outils, puis sélectionnez la présentation, ou délimitez une région pour le graphique.

Vous pouvez également choisir Graphique [image] Créer un graphique dans le menu.

Si vous ne délimitez pas de région de graphique, Graphics Builder utilise une taille par défaut.

La boîte de dialogue Assistant graphique apparaît.

2	Dans la liste déroulante Interrogation existante, sélectionnez une interrogation.

3	Sélectionnez OK pour accepter la boîte de dialogue et afficher la fenêtre de propriété Graphique.

4	(En option)  Entrez le nom et le titre de votre graphique.

5	Sélectionnez un type et un sous-type de graphique.

6	Sélectionnez OK pour créer le graphique.

Le graphique est défini dans l'Editeur de présentation. L'objet graphique apparaît dans le Navigateur d'objet. La région graphique est la région couverte par le graphique. Les étiquettes de graduation et la légende peuvent dépasser les limites de cette région.

Vous pouvez maintenant manipuler l'objet graphique (par sélection, déplacement, redimensionnement, suppression, etc.) comme vous le feriez pour tout autre objet de la présentation, ou modifier ses propriétés.


Création d'un graphique par programme

Pour créer un graphique par programme :

1	Si nécessaire, définissez le modèle que vous voulez utiliser.

2	Créez l'interrogation que vous voulez utiliser.

3	Créez l'unité de programme PL/SQL.  Exemple


Exemple : Création d'un graphique par programme

/* L'exemple ci-dessous part du principe que le modèle
**et l'interrogation ont déjà été définis. Il exécute
**l'interrogation indiquée et stocke les résultats
**en interne.
*/

PROCEDURE create_chart IS
/* Déclarer les variables */
   the_chart      OG_OBJECT;
   ch_pos         OG_POINT;
   ch_hy          NUMBER;
   ch_wi          NUMBER;
   the_query      OG_QUERY;
   the_template   OG_TEMPLATE;
   indep_field    OG_FIELD;
   dep_field      OG_FIELD;
BEGIN
/* Extraire le modèle et l'interrogation qui ont déjà été
      définis dans Builder */                               the_template:=OG_GET_TEMPLATE('template0');
   the_query:=OG_GET_QUERY('query0');
/*Définir la position du graphique en coordonnées X/Y*/
  ch_pos.x:=0*OG_INCH;
  ch_pos.y:=0*OG_INCH;
/*Définir la hauteur et la largeur du graphique */
  ch_ht:=3*OG_INCH;
  ch_wi:=3*OG_INCH;
/* Créer le graphique */
  the_chart:=OG_MAKE_CHART(chpos, ch_ht, ch_wi,
the_template, the_query);
/* Définir un champ pour NOME  */
  indep_field.field_type:=OG_INDEPENDENT;
  indep_field.colname:='ENAME';
/* L'insérer dans le graphique à la position 0 */
  OG_INSERT_FIELD(the_chart, indep_field, 0);
/* Définir un champ pour SAL */
  dep_field.field_type:=OG_DEPENDENT;
  dep_field.colname:='SAL';
  dep_field.ftname:='column';
/* L'insérer dans le graphique à la position 2 */
  OG_INSERT_FIELD(the_chart, dep_field, 1);
/* Définir un champ pour COMM */
  dep_field.field_type:=OG_DEPENDENT;
  dep_field.colname:='COMM';
  dep_field.ftname:='column';
/* L'insérer dans le graphique à la dernière position */
  OG_INSERT_FIELD(the_chart, dep_field, OG_LAST);
/* Exécuter l'interrogation pour la première fois*/
  OG_EXECUTE_QUERY(the_query);
/* Mettre le graphique à jour afin que les informations concernant
      le nouveau champ et l'interrogation entrent en vigueur */
  OG_UPDATE_CHART(the_chart, OG_ALL_CHUPDA);
END;


Création d'une interrogation pendant la création d'un graphique

  Rubriques connexes

Pour créer une interrogation pendant la création d'un graphique :

1	Choisissez Graphique [image] Créer un graphique.

Vous pouvez également sélectionner l'outil Graphique dans la palette d'outils de l'Editeur de présentation, puis sélectionner la zone d'affichage, ou délimiter une région pour le graphique.

S'il n'existe pas d'interrogation, la boîte de dialogue Nouvelle interrogation s'affiche. S'il en existe, la boîte de dialogue Assistant graphique apparaît.

2	Si l'Assistant graphique apparaît, sélectionnez le bouton d'option Nouvelle interrogation et sélectionnez OK pour afficher la fenêtre de propriété Nouvelle interrogation.

3	Entrez une instruction SQL SELECT dans le champ Instruction SQL ou sélectionnez un autre type d'interrogation.

4	Sélectionnez Exécuter pour exécuter l'interrogation.

Vous pouvez visualiser les données retournées dans la page de propriété Données.

5	Sélectionnez OK pour fermer la fenêtre de propriété Nouvelle interrogation et afficher la fenêtre de propriété Graphique.

Sélectionnez vos options graphiques et sélectionnez OK pour créer le graphique.

La création d'interrogations lors de la création d'un graphique regroupe deux actions en une seule, afin que vous puissiez créer rapidement un graphique sans avoir à définir votre interrogation séparément. Lorsque vous avez créé la nouvelle interrogation avec votre graphique, les deux objets figurent dans le Navigateur d'objet.


A propos de l'indication des données d'un graphique

Chaque colonne de l'interrogation contient des données de catégorie ou de valeur. Vous devez établir la correspondance entre ces données et les éléments de votre graphique pour créer une représentation de données significative. Pour cela, tenez compte de trois éléments :

•	Classement des données

•	Correspondance de champs

•	Filtrage de données


A propos de la classification des données

Les données provenant des colonnes de votre interrogation peuvent être classées de deux façons :

•	par catégorie

•	par valeur

Le type de données détermine la façon dont elles peuvent être affichées dans un graphique.


A propos des catégories

Une catégorie est une donnée à laquelle est associée une valeur. Par exemple, si vous voulez connaître les salaires des différents employés, la catégorie sera le nom de l'employé. Vous pourrez alors tracer un graphique du salaire de chaque employé (c'est-à-dire la valeur de chaque catégorie).

Les colonnes d'une interrogation qui contient des catégories sont généralement appelées indépendantes, car la catégorie ne dépend pas d'autres données. Pour reprendre l'exemple ci-dessus, le nom de l'employé ne dépend pas d'une autre donnée.

Les catégories sont généralement tracées le long d'un axe discret ou d'un axe de date, qui peut alors être appelé "axe de catégorie".


A propos des valeurs

Une valeur est une donnée qui est associée à une catégorie. Par exemple, la quantité 5000 doit être associée à un produit spécifique (qui est la catégorie).

Les colonnes d'une interrogation qui contient des valeurs sont souvent appelées dépendantes, car la valeur dépend d'une autre donnée. Pour reprendre l'exemple ci-dessus, connaître la quantité 5000 n'a d'intérêt que si vous connaissez également le produit auquel cette quantité fait référence. La valeur de la quantité dépend du produit concerné.

Les valeurs sont généralement tracées le long d'un axe continu, qui peut donc être appelé "axe de valeur".


A propos de la correspondance des champs

La correspondance des champs est l'opération qui vous permet d'indiquer les colonnes de l'interrogation à inclure dans le graphique, la façon dont les colonnes seront représentées sous la forme de champs de graphique, et l'ordre dans lequel les champs sont tracés. La correspondance de champs implique également l'association de champs de données de valeur (dépendants) et de modèles de champ de type colonne ou barre.

Lorsque vous créez pour la première fois un graphique, la correspondance des champs est établie automatiquement par Graphics Builder, en fonction de la façon et de l'ordre dont les colonnes apparaissent dans la page Données de la propriété de l'interrogation et du modèle de champ en cours. Pour modifier les options par défaut, sélectionnez le graphique, ouvrez sa fenêtre de propriété et modifiez les paramètres dans les pages Valeurs et Catégories.

Lorsque vous créez un graphique pour la première fois, Graphics Builder établit la correspondance entre les colonnes de l'interrogation et les catégories et les valeurs tracées dans le graphique. Cependant, vous devez modifier les colonnes de catégories et de valeurs chaque fois que vous modifiez les informations qu'utilise le graphique - particulièrement lorsque vous exécutez l'une des opérations suivantes :

•	ajout ou suppression d'un champ de données dans le graphique

•	modification de l'ordre de traçage des champs de données

•	modification des noms de colonne par ajout d'alias dans l'interrogation

•	suppression d'une colonne de l'interrogation

•	ajout d'une sous-catégorie au graphique

•	changement de nom ou suppression d'un modèle de champ

•	ajout d'un modèle de champ à utiliser


Attribution de colonnes de catégorie et de valeur

Pour attribuer des colonnes de catégorie et de valeur :

1	Cliquez deux fois sur le graphique pour afficher la fenêtre de propriété Graphique.

2	Sélectionnez l'onglet Catégories pour afficher la page de propriété Catégories, ou sélectionnez l'onglet Valeurs pour afficher la page de propriété Valeurs.

3	Modifiez les options de la manière suivante :

•	Pour effectuer un ajout à la liste des catégories ou des valeurs du graphique, sélectionnez une colonne dans la liste Colonnes d'interrogation, puis sélectionnez Insérer.

•	Pour modifier l'ordre de traçage des catégories et des valeurs de graphique, sélectionnez la colonne de catégories ou de valeurs, puis sélectionnez Sommet (haut de liste) Base (Bas de liste) Haut (passage à l'élément précédent) ou Bas (passage à l'élément suivant).

•	Pour supprimer une colonne de catégorie ou de valeur de sa liste, sélectionnez la colonne, puis sélectionnez Supprimer. La suppression d'une colonne de catégorie ou de valeur de la liste ne supprime pas la colonne de l'interrogation.

•	Pour associer une colonne de valeurs de graphique à un modèle de champ, sélectionnez la colonne de valeur dans la liste, puis choisissez un modèle de champ dans la liste déroulante Modèle de champ.

4	Sélectionnez OK pour appliquer les modifications et fermer la fenêtre de propriété Graphique.


Création d'un graphique ventilé

Pour créer un graphique ventilé :

1	Créez un graphique à colonnes ou à barres ou ouvrez la fenêtre de propriété Graphique d'un graphique à colonnes ou à barres existant.

2	Choisissez l'onglet Catégories pour afficher la page de propriété Catégories.

3	Assurez-vous que la liste Catégories ne comporte qu'une catégorie.

4	Sélectionnez une sous-catégorie dans la liste déroulante Sous-catégories.

5	Sélectionnez OK pour appliquer les modifications et fermer la fenêtre de propriété Graphique, ou sélectionnez Appliquer pour appliquer les modifications sans fermer la fenêtre de propriété Graphique.


A propos des relations de hiérarchisation vers le bas

Graphics Builder vous permet d'établir des relations de hiérarchisation vers le bas entre des graphiques "maître" et "détail" d'un affichage. Pour établir une relation de hiérarchisation vers le bas entre des graphiques, procédez de la manière suivante :

Lors de l'exécution, les utilisateurs peuvent sélectionner un élément du graphique maître pour exécuter une "hiérarchisation vers le bas" jusqu'aux informations détaillées concernant cet élément. Par exemple, dans un graphique à secteurs concernant les dépenses de chaque département d'une entreprise, sélectionnez un secteur pour afficher des informations détaillées sur ce département.

Les relations de hiérarchisation vers le bas sont basées sur des paramètres. Le graphique maître définit la valeur du paramètre et le graphique de détail utilise cette valeur dans son interrogation. Lorsque l'utilisateur sélectionne un élément du graphique maître, Graphics Builder :

•	détermine la valeur de donnée représentée par l'élément du graphique

•	attribue la valeur à un paramètre

•	exécute l'interrogation détail qui fait référence au paramètre

•	met à jour le graphique détail

Vous pouvez modifier les relations de hiérarchisation vers le bas. Par exemple, vous pouvez demander qu'une interrogation différente soit exécutée ou définir la valeur de paramètres à une colonne différente. La modification d'une relation de hiérarchisation vers le bas ne demande pas plus de programmation que la création de la relation de hiérarchisation vers le bas entre deux graphiques.


Création d'une relation de hiérarchisation vers le bas entre deux graphiques

Pour créer une relation de hiérarchisation vers le bas entre deux graphiques :

1	Sélectionnez le graphique maître - c'est-à-dire le graphique qui "pilotera" l'action de hiérarchisation vers le bas.

2	Sélectionnez l'élément de graphique que vous voulez utiliser pour déterminer la valeur du paramètre étiquette de graduation, secteur, etc.

N'oubliez pas que le paramètre représenté par l'élément graphique sera utilisé dans l'interrogation du graphique détail. Le paramètre établit la relation maître-détail.

3	Ouvrez la fenêtre de propriété de l'élément graphique que vous avez sélectionné. (Cliquez deux fois sur un élément de graphique sélectionné, ou choisissez Propriétés dans le menu instantané, ou bien choisissez Outils [image] Propriétés.)

4	Choisissez l'onglet Hiérarchisation vers le bas pour afficher la page de propriété correspondante.

5	Sélectionnez Nouveau pour créer un nouveau paramètre.

La boîte de dialogue Paramètres apparaît.

6	Acceptez le nom de paramètre par défaut, PARAMn, ou entrez un nouveau nom dans le champ Nom.

7	Dans la liste déroulante Types, sélectionnez un type de données (CHAR, NUMBER ou DATE).

Le type de données que vous sélectionnez pour le paramètre doit correspondre au type de données de la colonne que représentera le paramètre.

8	(Facultatif)  Entrez la valeur initiale du paramètre dans le champ Valeur initiale.

9	Sélectionnez OK pour accepter le nouveau paramètre.

La boîte de dialogue Paramètres se ferme et vous revenez à la fenêtre de propriété Objet.

10 Dans la liste déroulante A la valeur de, sélectionnez le nom de colonne qui représente l'élément graphique que vous avez sélectionné comme source de valeur du paramètre.

11 Dans la liste déroulante Exécuter l'interrogation, sélectionnez l'interrogation qui mettra à jour le graphique détail de hiérarchisation vers le bas.

12 Sélectionnez Editer pour pouvoir ajouter le paramètre à l'interrogation.

La fenêtre de propriété Interrogation apparaît.

13 Editez l'interrogation en ajoutant le paramètre que vous avez créé. Exemple

14 Sélectionnez OK pour accepter les modifications de l'interrogation et revenir à la fenêtre de propriété Objet.

15 Sélectionnez OK pour accepter la procédure de hiérarchisation vers le bas.

16 Enregistrez et exécutez l'affichage pour tester la procédure. Essayez de sélectionner l'élément graphique de votre graphique maître et vérifiez le résultat de la mise à jour du graphique détail par l'utilisation des données de l'interrogation résultante.

Notez que la procédure ci-dessus n'implique pas de code PL/SQL. Vous pouvez utiliser la fenêtre de propriété Objet pour créer un événement de hiérarchisation vers le bas pour tout objet de votre affichage.


Exemple : ajout d'un paramètre à une interrogation

/*Pour éditer une interrogation en ajoutant un paramètre que vous avez créé, vous pouvez ajouter
**une clause WHERE à l'interrogation existante de la manière suivante :
*/

WHERE colonne1 := :PARAM0


Modification d'une relation de hiérarchisation vers le bas

Pour modifier une relation de hiérarchisation vers le bas :

1	Ouvrez la fenêtre de propriété Objet de l'élément graphique qui pilote la procédure de hiérarchisation vers le bas.

2	Sélectionnez l'onglet Hiérarchisation vers le bas pour afficher la fenêtre de propriété Hiérarchisation vers le bas.

3	Sélectionnez vos nouvelle options.

4	Sélectionnez OK pour accepter la nouvelle relation de hiérarchisation vers le bas et fermer la fenêtre de propriété Objet.

Si vous voulez modifier le paramètre lui-même, vous pouvez soit accéder au paramètre sur la fenêtre de propriété Objet en sélectionnant Editer pour afficher la boîte de dialogue Paramètres, soit passer par le Navigateur d'objet.


A propos de l'Interpréteur

  Rubriques connexes

Graphics Builder utilise les caractéristiques et les fonctionnalités de Procedure Builder - et précisément l'Interpréteur - pour vous permettre de déboguer les unités de programme PL/SQL utilisées dans vos affichages.

Pour exécuter des opérations Procedure Builder, utilisez les menus, les éditeurs et les boîtes de dialogue de commande, ou entrez des commandes dans la ligne de commande de l'Interpréteur.

L'interpréteur, qui est l'espace central de débogage de Procedure Builder, se présente sous la forme d'une fenêtre qui vous permet de définir, d'afficher et de déboguer vos unités de programme PL/SQL à l'aide d'une ligne de commande.

L'Interpréteur peut se présenter de deux façons différentes, en fonction du contexte dans lequel Procedure Builder est appelé :

•	modal,

•	sans mode.

Lorsque vous entrez des commandes dans la ligne de commande, vous pouvez utiliser la commande Nouvelle invite dans le menu instantané, pour abandonner la commande et afficher une nouvelle invite PL/SQL dans la fenêtre Interpréteur.

Vous pouvez enregistrer toutes les entrées et les sorties de l'Interpréteur dans un fichier journal, si vous voulez conserver une trace de votre session de débogage.


A propos des composants de l'Interpréteur

Les cinq composants principaux de l'Interpréteur sont les suivants :

barre de menu (sans mode uniquement)

barre de contrôle

fenêtre source

fenêtre du Navigateur

fenêtre de l'Interpréteur

Les deux types d'interpréteur ont des fonctions identiques. Cependant, comme les menus ne sont pas accessibles dans les fenêtre modales, l'Interpréteur modal contient des boutons qui permettent d'accéder aux fonctions accessibles par des menus dans l'Interpréteur sans mode.

Des menus instantanés contenant différentes commandes courantes sont proposés par les différentes fenêtres.

Pour une description plus détaillée de l'Interpréteur, reportez-vous au chapitre "Working with the Interpreter", dans Procedure Builder Developer's Guide.


Barre de menu (sans mode uniquement)

Affiche les commandes de menu permettant d'exécuter la plupart des tâches.


Barre de contrôle

Contient les boutons que vous pouvez utiliser comme accélérateurs de la plupart des tâches.


Fenêtre source

Vous permet d'afficher le source d'une unité de programme et de définir des actions de débogage.


Fenêtre du Navigateur

Affiche la hiérarchie des objets de la session en cours (noeuds de débogage, uniquement dans l'Interpréteur modal).

Dans l'Interpréteur sans mode, le Navigateur peut être masqué.


Fenêtre de l'Interpréteur

Offre une ligne de commande dans laquelle vous pouvez entrer les éléments PL/SQL et les commandes Procedure Builder de votre choix.


Affichage de l'Interpréteur modal

Pour afficher l'Interpréteur modal :

  L'Interpréteur modal est proposé automatiquement par Graphics Builder pendant l'exécution d'une application (par exemple, pendant la simulation d'exécution d'un affichage, Graphics Builder détecte un point d'interruption que vous avez défini dans une unité de programme). Lors de l'ouverture de l'Interpréteur modal, l'exécution de l'application et de son code PL/SQL est suspendue jusqu'à ce que vous fermiez la fenêtre de l'Interpréteur modal.


Affichage de l'Interpréteur sans mode

Pour afficher l'Interpréteur sans mode :

  Choisissez Outils [image] Interpréteur PL/SQL

L'Interpréteur sans mode s'affiche. Par défaut, il ne contient pas la fenêtre du Navigateur. Vous pouvez accéder aux actions de débogage que vous sélectionnez dans l'Editeur sans mode par les objet du Navigateur d'objet de Graphics Builder.

Vous pouvez également accéder à la fenêtre du Navigateur en choisissant Affichage [image] Fenêtre du Navigateur dans le menu.

Vous pouvez appeler l'Interpréteur sans mode, soit dans Graphics Builder, soit pendant la simulation d'exécution.


A propos du débogage des affichages

  Rubriques connexes

La détection de la source de l'erreur dépend généralement de l'erreur elle-même et des conditions dans lesquelles elle s'est produite. Si vous avez des unités de programme imbriquées, utilisez la première de la séquence pour rechercher la source de l'erreur.

Soit, par exemple, une procédure bouton A qui appelle l'unité de programme B qui appelle l'unité de programme C. S'il se produit une erreur pendant l'exécution de l'une de ces unités de programme, avec génération d'une exception PL/SQL, vous pouvez sélectionner l'unité de programme A pour recherche la source de l'erreur.

Si vous ne savez pas immédiatement comment résoudre le problème, définissez une action de débogage qui vous permettra de localiser la source du problème. Par exemple, l'unité de programme posant problème peut contenir des appels à des sous-programmes, des boucles ou d'autres expressions de contrôle rendant difficile la localisation de la source exacte du problème.

Les actions de débogage vous permettent de contrôler et/ou d'interrompre l'exécution des unités de programme PL/SQL. Ces actions sont de deux types :

•	points d'interruption,

•	déclencheurs de débogage.

En outre, vous pouvez utiliser le package DEBUG pour indiquer différentes tâches de débogage comme la définition d'un point d'interruption, la suspension de l'exécution de l'unité de programme et le retour du contrôle à l'Interpréteur, la recherche et la définition de valeurs de variables et de paramètres, ou l'interprétation de commandes PL/SQL.

Vous pouvez définir des actions de débogage dans Graphics Builder ou dans le débogueur, en fonction de la complexité de vos unités de programme et de l'affichage lui-même.


A propos des tests de votre affichage en simulation d'exécution

  Rubriques connexes

La façon la plus simple de tester votre affichage consiste à utiliser le mode de simulation d'exécution de Graphics Builder (également appelé débogueur). A partir de Graphics Builder, vous pouvez exécuter votre affichage et le tester dans une fenêtre de débogage distincte, ce qui accélère l'opération, et revenir à Graphics Builder pour exécuter les modifications nécessaires.

Lorsque vous testez un affichage en simulation d'exécution, Graphics Builder réduit au minimum toutes les autres fenêtres ouvertes, à l'exception du Navigateur d'objet.


A propos de la définition des actions de débogage dans Graphics Builder

Si vous définissez des actions de débogage dans Graphics Builder puis exécutez votre affichage, l'Interpréteur modal apparaît automatiquement lorsque le programme atteint une action de débogage (un déclencheur de débogage, par exemple). Lorsque l'Interpréteur modal s'affiche, l'exécution de votre affichage et de son code PL/SQL est suspendue jusqu'à ce que vous fermiez l'Interpréteur.

Lors de la définition d'actions de débogage dans l'Interpréteur, prenez en compte les deux possibilités suivantes :

•	vous voulez définir une action de débogage sur un déclencheur d'ouverture d'affichage qui est activé dès que l'affichage est exécuté,

•	vous voulez conserver l'action de débogage pour une utilisation ultérieure.

Si vous définissez une action de débogage dans Graphics Builder, puis modifiez l'unité de programme et la recompilez, vous devrez parfois modifier l'action de débogage pour changer son emplacement source. Les actions de débogage sont associées à des numéros de ligne dans le code source des unités de programme.


A propos de la définition d'actions de débogage dans le débogueur

La définition d'actions de débogage dans le débogueur vous permet de déboguer à la volée dans l'Interpréteur sans mode.

Lorsque vous fermez l'affichage dans le débogueur, toutes les actions de débogage que vous avez définies dans les unités de programme sont perdues. Si vos actions de débogage se composent uniquement de points d'interruption et de déclencheurs de débogage simples, vous ne devriez pas avoir de problèmes.

Si vous déboguez vos unités de programme directement dans le débogueur, vos modifications ne sont pas reportées dans Graphics Builder.


A propos de l'utilisation des points d'interruption

Le type le plus courant d'action de débogage est le point d'interruption. Les points d'interruption permettent de contrôler pas-à-pas l'exécution des unités de programme.

Graphics Builder suspend l'exécution de l'unité de programme juste avant d'atteindre la ligne dans laquelle le point d'interruption est indiqué. Vous pouvez alors utiliser les fonctions de Procedure Builder pour inspecter/ou modifier l'état du programme (c'est-à-dire les valeurs des variables). Après quoi, vous pouvez reprendre l'exécution du programme en utilisant les commandes GO ou STEP, ou y mettre fin prématurément en utilisant la commande RESET.

Soit, par exemple, une procédure contenant une boucle de comptage qui appelle une fonction et incrémente la valeur d'une variable locale. Pour être certain que la variable reçoit la valeur correcte pour chaque cycle de la boucle, vous pouvez placer un point d'interruption dans la ligne directement après l'affectation de la variable. Lorsque le programme atteint le point d'interruption et interrompt la procédure, vous pouvez examiner la trace de la pile d'appels dans le Navigateur pour vérifier la valeur de la variable, puis utiliser la commande STEP pour passer au prochain point d'interruption.


A propos de l'utilisation des déclencheurs de débogage

  Rubriques connexes

Les déclencheurs de débogage sont une forme plus générale d'action de débogage. Un déclencheur de débogage associe un bloc de code PL/SQL à une ligne spécifique du code source dans une unité de programme.

Graphics Builder exécute un déclencheur de débogage immédiatement avant d'atteindre la ligne dans laquelle le déclencheur de débogage est indiqué. Vous pouvez attribuer un déclencheur de débogage qui devra être activé dans l'un ou l'autre des cas suivants :

•	lorsqu'il atteint une seule ligne d'une unité de programme (par exemple, l'emplacement source en cours, ligne 5, ligne 23, etc.),

•	chaque fois que l'Interpréteur prend le contrôle (c'est-à-dire lorsqu'il suspend l'exécution d'un programme en raison de la détection d'un point d'interruption, d'une exécution pas-à-pas d'un programme, etc.),

•	chaque fois qu'une ligne source PL/SQL est exécutée.

Les déclencheurs de débogage sont particulièrement utiles pour définir des points d'interruption conditionnels. Vous pouvez générer l'exception DEBUG.BREAK à partir du corps du déclencheur. Par exemple, le déclencheur de débogage représenté ci-dessous établit un point d'interruption conditionnel à la ligne 10 de ma_proc, qui ne sera atteint que si la variable locale NUMBER mon_sal est supérieur à 5000 :

PL/SQL> .trigger proc ma_proc line 10 is
     +> IF DEBUG.GETN('mon_sal') > 5000 THEN
     +>   RAISE DEBUG.BREAK;
     +> END IF;


A propos de l'utilisation des niveaux de débogage

  Rubriques connexes

Lorsqu'une action de débogage interrompt l'exécution d'un programme, l'Interpréteur prend le contrôle et définit ce qu'on appelle un niveau de débogage. A un niveau de débogage, vous pouvez entrer des commandes et des instructions PL/SQL pour connaître et modifier l'état de l'unité de programme interrompue, et en reprendre l'exécution.

Comme un code PL/SQL, entré de manière interactive à un niveau de débogage, peut lui-même être interrompu (par exemple, par la rencontre d'un autre point d'interruption), les niveaux de débogage peuvent être imbriqués. Les niveaux étant numérotés, vous pouvez les distinguer facilement les uns des autres. Le niveau imbriqué le plus profondément a le numéro le plus élevé. La numérotation commence à zéro, ce qui correspond au niveau extérieur.

Le niveau zéro, ou niveau extérieur, est généralement appelé niveau supérieur. A ce niveau n'est associé aucun état de programme, puisque c'est le niveau auquel les unités de programme sont appelées à l'origine. L'interruption d'un code appelé à partir du niveau supérieur crée le niveau de débogage 1. De même, l'interruption d'un code appelé à partir du niveau de débogage 1 crée un niveau de débogage 2 et ainsi de suite.

L'invite de commande de l'Interpréteur indique le niveau de débogage en cours. Lorsque l'Interpréteur passe à un niveau autre que le niveau supérieur, l'invite comporte un préfixe qui contient le numéro du niveau de débogage en cours. Par exemple, l'invite de commande de l'Interpréteur au niveau de débogage 1 s'affiche de la manière suivante :

 (debug 1)PL/SQL>

Vous pouvez utiliser la commande RESET pour rendre le contrôle à un niveau de débogage extérieur sans poursuivre l'exécution au niveau de débogage en cours.


A propos du contrôle de l'exécution des unités de programme

Une fois que vous avez étudié et/ou modifié l'état du programme à la suite d'une action de débogage, vous pouvez, pour contrôler l'exécution de l'unité de programme :

exécuter pas-à-pas l'unité de programme

reprendre l'exécution

annuler l'exécution de l'unité de programme


A propos de la journalisation des entrées et des sorties de l'Interpréteur

Procedure Builder vous permet d'enregistrer les entrées et les sorties de l'Interpréteur lorsque vous déboguez des unités de programme. Une fois la journalisation activée, les commandes entrées dans l'Interpréteur, et les messages de sortie de l'Interpréteur qui en résultent, sont placés dans un fichier journal (ou ajoutés en fin de fichier) jusqu'à ce que vous désactiviez ou arrêtiez la journalisation.


A propos des options de journalisation de la ligne de commande

Vous pouvez contrôler la journalisation en entrant dans l'Interpréteur l'une des commandes suivantes :

•	LOG

•	DISABLE (Journalisation)

•	ENABLE (Journalisation)

Pour plus d'informations sur ces commandes et sur les autres commandes de Procedure Builder, reportez-vous à l'aide en ligne.


A propos de la correction des erreurs

  Rubriques connexes

Vous pouvez corriger les erreurs dans le débogueur ou dans Graphics Builder. Si vous corrigez les erreurs et recompilez les unités de programme dans le débogueur, vos modifications ne sont pas automatiquement reflétées dans Graphics Builder. Si vous apportez de nombreuses modifications à des unités de programme du débogueur, vous devrez synchroniser les unités de programme du débogueur avec celles de Graphics Builder. Si vous apportez vos modifications dans Graphics Builder, n'oubliez pas d'enregistrer et d'exécuter à nouveau votre affichage pour vérifier que vos modifications ont bien résolu le problème.


A propos de la synchronisation des unités de programme

Si vous avez corrigé vos erreurs PL/SQL dans le débogueur, vous devez synchroniser le contenu des unités de programme modifiées dans le débogueur avec le contenu des unités de programme de Graphics Builder. La synchronisation remplace les unités de programme de Graphics Builder par celles du débogueur.


A propos des exceptions non gérées

Si Graphics Builder détecte une erreur pendant la simulation d'exécution, il émet un message d'erreur accompagné d'un numéro de message. Notez le numéro du message d'erreur et les conditions dans lesquelles il est apparu. Etait-ce lors de l'ouverture de l'affichage ? Après une tentative de hiérarchisation vers le bas ou après avoir sélectionné un graphique ou un bouton ?

Pour plus d'informations sur les messages d'erreur de Graphics Builder, reportez-vous à la section Résolution de problèmes.

Le message d'erreur OG-00637 indique que le programme a détecté une exception PL/SQL non traitée. Notez le numéro de l'exception figurant dans le message d'erreur, car il vous permettra de savoir où trouver le texte qui indique la cause possible de l'erreur.

Graphics Builder offre un certain nombre d'exceptions PL/SQL intégrées pour les erreurs survenant dans les procédures, les fonctions ou les types de données Graphics Builder. Les exceptions intégrées dans Graphics Builder sont documentées, par numéros et noms, dans Graphics Builder Reference Manual.


Test de votre affichage en simulation d'exécution

  Rubriques connexes

Pour tester votre affichage en simulation d'exécution :

1	Sélectionnez l'outil Exécuter dans le Navigateur d'objet ou dans l'Editeur de présentation, ou choisissez Fichier [image] Exécuter pour exécuter l'affichage actif.

Si vous avez ouvert plusieurs affichages, sélectionnez, dans le Navigateur, l'objet affichage correspondant à l'affichage que vous voulez exécuter, puis sélectionnez l'outil Exécuter.

Si l'affichage n'a pas été enregistré récemment, Graphics Builder crée un fichier temporaire de l'état actuel de l'affichage et l'exécute. Si vous n'avez jamais enregistré l'affichage, un message vous demande de le faire avant que Graphics Builder l'exécute.

Si aucun affichage n'est ouvert dans Graphics Builder, un message vous demande d'en sélectionner un.

La version Runtime de l'affichage sélectionné est ouverte dans une fenêtre distincte du débogueur de Graphics Builder.

2	Testez les relations de descente de niveau ou les procédures bouton, pour vous assurer qu'elles se comportent correctement. Si vous avez des horloges actives, assurez-vous qu'elles fonctionnent et donnent un résultat correct.

Si votre affichage fonctionne en simulation d'exécution, vous pouvez alors générer votre affichage sans problèmes. Cependant, si vous avez apporté d'autres modifications à votre affichage avant de le générer, vous avez intérêt à l'exécuter à nouveau pour tester vos modifications.


Recherche d'erreurs

  Rubriques connexes

Pour rechercher les erreurs :

1	Développez le noeud nom_affichage<debug> dans le Navigateur d'objet.

2	Cliquez deux fois sur l'unité de programme pour l'afficher dans l'Editeur d'unité de programme.

Si vous recherchez une erreur dans une suite d'unités de programme imbriquées, ouvrez la première unité de programme de la séquence. Par exemple, si l'erreur s'est produite lorsque l'utilisateur a sélectionné un bouton, ouvrez la procédure bouton associée.

Les erreurs de compilation associées à cette unité de programme s'affichent dans la fenêtre située sous la source de l'unité de programme. Si vous travaillez sur des unités de programme imbriquées, la dernière unité de programme appelée avant l'apparition de l'erreur s'affiche en haut de la pile des erreurs.


Définition de points d'interruption

Pour définir un point d'interruption :

1	Choisissez Outils [image] Interpréteur PL/SQL pour afficher l'Interpréteur PL/SQL.

2	Dans le Navigateur, sélectionnez l'unité de programme que vous voulez déboguer.

L'unité de programme s'affiche dans la fenêtre Source de l'Interpréteur. Chaque ligne est numérotée.

3	Cliquez deux fois sur la ligne dans laquelle vous voulez définir le point d'interruption. Le point d'interruption est inséré.

Vous pouvez également définir un "déclencheur d'interruption" pour un point d'interruption. Ce type de déclencheur est un bloc PL/SQL qui s'exécute chaque fois que le point d'interruption est atteint. Ce bloc peut contenir une commande de Procedure Builder qui doit s'exécuter chaque fois que le point d'interruption est atteint.

Vous pouvez utiliser la commande BREAK de la fenêtre de l'Interpréteur pour insérer un point d'interruption à une ligne source spécifique.


Définition de déclencheurs de débogage

Pour définir un déclencheur de débogage :

1	Choisissez Outils [image] Interpréteur PL/SQL pour afficher l'Interpréteur PL/SQL.

2	Dans le Navigateur, sélectionnez l'unité de programme que vous voulez déboguer.

L'unité de programme s'affiche dans la fenêtre Source de l'Interpréteur. Chaque ligne est numérotée.

3	Sélectionnez la ligne dans laquelle vous voulez placer le déclencheur de débogage.

4	Choisissez Déclencheur dans le menu instantané ou Déboguer [image] Déclencheur pour afficher la boîte de dialogue Déclencheur PL/SQL.

5	Entrez le corps du déclencheur dans le champ Corps du déclencheur.

6	Sélectionnez OK pour accepter le déclencheur et fermer la boîte de dialogue.

Pour plus d'informations sur la création des déclencheurs de débogage, reportez-vous à l'aide en ligne de Procedure Builder.


Exécution pas-à-pas de l'unité de programme

Pour exécuter pas-à-pas l'unité de programme :

  Utilisez la commande STEP pour exécuter de manière incrémentielle l'unité de programme interrompue. Le contrôle est rendu à l'Interpréteur après l'exécution de l'ensemble d'instructions indiqué. La commande STEP comporte quatre variantes qui permettent de reprendre momentanément l'exécution d'un programme interrompu.

Pour appeler la commande STEP, choisissez un des boutons de la barre de contrôle ou entrez la commande dans la ligne de commande de l'Interpréteur.


Reprise de l'exécution d'une unité de programme

Pour reprendre l'exécution d'une unité de programme :

  Utilisez la commande GO pour reprendre indéfiniment l'exécution d'un programme - c'est-à-dire jusqu'à ce que la séquence d'instructions en cours d'exécution prenne fin ou qu'elle soit à nouveau interrompue par une action de débogage. Pour appeler la commande GO, choisissez le bouton Commencer dans la barre de contrôle ou entrez la commande dans la ligne de commande de l'Interpréteur.


Annulation de l'exécution d'une unité de programme

Pour annuler l'exécution d'une unité de programme :

  Utilisez la commande RESET pour rendre le contrôle à un niveau de débogage extérieur, sans poursuivre l'exécution au niveau de débogage en cours. RESET arrête donc l'exécution aux niveaux de débogage en cours (et éventuellement supérieurs).

Pour appeler la commande RESET, choisissez le bouton Réinitialiser dans la barre de contrôle ou entrez la commande dans la ligne de commande de l'Interpréteur.


Activation d'un fichier journal

Pour activer un fichier journal :

1	Choisissez Déboguer [image] Journal pour afficher la boîte de dialogue Journalisation d'interpréteur.

2	Entrez un chemin d'accès au répertoire et un nom de fichier journal dans le champ Nom, ou sélectionnez Chercher pour ouvrir la boîte de dialogue Fichier de votre système d'exploitation, dans laquelle vous pouvez sélectionner un fichier journal.

3	Pour ajouter le journal en cours à un fichier journal existant, sélectionnez la case à cocher Ajouter.

4	Sélectionnez OK pour accepter vos modifications et fermer la boîte de dialogue.


Désactivation d'un fichier journal

Pour désactiver un fichier journal :

1	Choisissez Déboguer [image] Journal pour afficher la boîte de dialogue Journalisation d'Interpréteur.

2	Sélectionnez la case à cocher Désactivé.

3	Sélectionnez OK pour accepter vos modifications et fermer la boîte de dialogue.


Affichage d'un fichier journal

Pour afficher le contenu d'un fichier journal existant :

  Choisissez Déboguer [image] Journal d'Interpréteur pour afficher l'explorateur Journalisation de l'Interpréteur.

ou

1	Choisissez Déboguer [image] Journal pour afficher la boîte de dialogue Journalisation d'Interpréteur.

2	Sélectionnez  la case à cocher Afficher journal.

3	Sélectionnez OK pour accepter vos modifications et fermer la boîte de dialogue.

L'explorateur Journalisation d'Interpréteur apparaît.


Synchronisation d'unités de programme

Pour synchroniser des unités de programme :

  Choisissez Edition [image] Synchroniser unités de programme dans le menu.


Packages de Procedure Builder

  Rubriques connexes

Aux procédures, fonctions et types de données PL/SQL incorporés dans Graphics Builder, viennent s'ajouter les packages PL/SQL intégrés de Procedure Builder, qui contiennent de nombreux éléments PL/SQL auxquels vous pouvez faire référence pendant le débogage de vos unités de programme.

DDE	ORA_PROF
DEBUG	TEXT_IO
LIST	TOOL_ENV
OLE2	TOOL_ERR
ORA_FFI	TOOL_RES
ORA_NLS


DDE

Offre un support dynamique d'échange de données.


DEBUG

Fournit les procédures, fonctions et exceptions de débogage des unités de programme PL/SQL.


LIST

Fournit les procédures, fonctions et exceptions permettant de créer et de tenir à jour des listes de chaînes de caractères (CARCHAR2), de façon à créer des tableaux avec PL/SQL version 1.


OLE2

Offre un API PL/SQL permettant de créer et de manipuler des attributs d'objets d'automatisation OLE2 et d'y accéder.


ORA-FFI

Offre une interface publique pour l'appel des fonctions étrangères (C) à partir de PL/SQL.


ORA-NLS

Permet d'extraire des informations de haut niveau sur l'environnement de la langue utilisée.


ORA-PROF

Fournit les procédures, fonctions et exceptions vous permettant d'affiner vos unités de programme PL/SQL (c'est-à-dire d'étudier le temps nécessaire à l'exécution d'un élément spécifique de code).


TEXT-IO

Offre les éléments qui vous permettent de lire et d'écrire des informations dans des fichiers.


TOOL-ENV

Vous permet d'effectuer des opérations interactives avec les variables d'environnement.


TOOL-ERR

Vous permet d'accéder à la pile d'erreurs créée par d'autres packages intégrés comme DEBUG, et de la manipuler.


TOOL-RES

Vous permet d'extraire des ressources de chaîne d'un fichier de ressources afin d'améliorer la portabilité du code PL/SQL en isolant toutes les données textuelles dans le fichier de ressources.


A propos des composants de l'Editeur de présentation

L'Editeur de présentation est la principale zone de travail de Graphics Builder. C'est là que vous dessinez la présentation de votre affichage en créant et en modifiant des objets graphiques (lignes, polygones, rectangles, texte, etc.).

Chaque affichage contient une seule présentation, et une présentation appartient à un seul affichage.

Les composants de l'Editeur de présentation sont les suivants :

présentation

barre d'outils

objets

règles

grille

vues

palette d'outils

ligne d'état


A propos de la présentation

La présentation est l'endroit où vous pouvez créer, modifier ou supprimer des objets. Les objets y figurent à l'emplacement exact où ils doivent apparaître lors de l'exécution de l'affichage. Dans l'Editeur de présentation, vous pouvez modifier la taille, la forme, la couleur et d'autres propriétés graphiques des objets, et voir immédiatement le résultat de l'opération.


A propos de la barre d'outils

La barre d'outils est une barre horizontale, en haut de l'Editeur de présentation, qui comporte des boutons permettant d'exécuter des commandes de menu courantes telles que Enregistrer, Exécuter, Couper, Copier et Coller.

Pour afficher le nom d'un outil de la barre d'outils, faites passer la souris sur un bouton. Le nom de l'outil apparaît sous la forme d'un message instantané, et l'outil est brièvement décrit dans la ligne d'état.


A propos des objets graphiques

Parmi les objets graphiques que vous pouvez créer et modifier dans la présentation figurent les arcs, les graphiques, les images, les lignes, les polygones, les rectangles, les rectangles arrondis, les symboles et les objets texte.


A propos des règles

Les règles, affichées à gauche et en haut de la présentation, peuvent être utilisées comme référence lorsque vous redimensionnez ou positionnez des objets. Pour les afficher ou les masquer, choisissez Affichage [image] Règles. Par défaut, les règles sont affichées.

Les marqueurs de règle sont des lignes qui apparaissent dans les deux types de règle et se déplacent horizontalement et verticalement selon le déplacement du curseur dont ils facilitent le positionnement.

Un guide est une ligne en pointillé qui apparaît dans la présentation, parallèlement à une règle et peut servir de point de référence lorsque vous redimensionnez ou positionnez des objets. Les guides, qui apparaissent uniquement dans la présentation du Builder, ne sont pas visibles lors de l'exécution ou de l'impression de l'affichage.

Pour afficher ou masquer les guides, choisissez Affichage [image] Guides. Par défaut, les guides sont affichés.


A propos de la grille de présentation

La grille de présentation se compose d'une série de lignes en pointillé, horizontales et verticales, équidistantes, que vous pouvez utiliser comme référence lorsque vous redimensionnez ou positionnez des objets. Vous pouvez définir l'intervalle auquel les lignes de la grille doivent apparaître, en fonction de l'unité de mesure des règles. Les lignes de la grille, qui apparaissent uniquement dans la présentation du Builder, ne sont pas visibles lors de l'exécution ou de l'impression de l'affichage.

Pour afficher ou masquer la grille, choisissez Affichage [image] Grille. Par défaut la grille est affichée.

La grille magnétique est une fonction qui oblige le curseur à s'aligner sur la grille lorsque vous le positionnez à proximité d'une ligne de la grille. Elle vous offre une plus grande précision et un meilleur contrôle lorsque vous dimensionnez ou positionnez des objets. Vous pouvez définir le nombre de "points magnétiques" entre chaque paire de lignes de la grille, auxquels le curseur passera.

Pour activer ou désactiver la grille magnétique, choisissez Affichage [image] Grille magnétique. Par défaut, la grille magnétique est désactivée.


A propos des vues

Une vue est une partie de la présentation qui ne concerne qu'une petite section de votre affichage. Au départ, chaque présentation est affichée sous la forme d'une vue maximum, mais vous pouvez créer jusqu'à quatre vues, concernant chacune un objet, une partie d'objet ou une couche différente. En outre, chaque vue peut avoir ses propres couche, règle ou grille et options de grossissement.

Chaque vue est indépendante des autres et a ses propres options (unités de règles, visibilité de la grille, grossissement, etc.). Chaque vue peut également faire défiler la présentation de façon indépendante.

La vue que vous utilisez à un moment donné porte le nom de vue "active". Lorsqu'une vue est active, ses barres de défilement sont activées.

Les modifications que vous apportez à la règle, à la grille et aux autres paramètres sont appliquées uniquement à la vue active. Les modifications que vous apportez aux objets qui apparaissent dans la présentation se répercutent sur toutes les vues qui concernent cette partie de la présentation.


A propos de la palette d'outils

Les outils que vous utilisez pour dessiner et modifier les objets de la présentation apparaissent dans la palette d'outils sous la forme d'icônes séparées. Pour utiliser un outil, vous devez l'activer. Pour cela :

•	pour n'effectuer qu'une opération, sélectionnez son icône. Lorsque vous avez exécuté l'opération, l'outil par défaut redevient actif.

•	pour exécuter plusieurs opérations, cliquez deux fois sur son icône. La totalité de l'icône est mise en évidence et l'outil reste actif jusqu'à ce que vous en activiez un autre.

Il ne peut y avoir qu'un outil actif à la fois. L'outil Sélectionner est l'outil par défaut.

Pour afficher le nom d'un outil de la palette d'outils, faites passer la souris sur un bouton. Le nom de l'outil apparaît sous la forme d'un message instantané et une brève description de l'outil apparaît dans la ligne d'état.


A propos de la ligne d'état

La ligne d'état contient les informations suivantes :

•	position absolue de la souris (indiquée dans l'unité de règle sélectionnée) ;

•	distance de déplacement de la souris (indiquée dans l'unité de règle sélectionnée) ;

•	angle de rotation ;

•	niveau de zoom.

Les informations qui apparaissent dans la ligne d'état sont fonction de l'outil utilisé et de l'action exécutée :

Outil	Action	Informations d'état

Chaque outil	déplacement de la souris	coordonnées x, y du curseur, niveau de zoom
Arc, Ellipse, Rectangle, Rectangle arrondi	création d'objet	coordonnées x, y de la position de départ du curseur ; largeur et hauteur de l'objet ; niveau de zoom
Forme libre	création d'objet	coordonnées x, y du curseur ; niveau de zoom
Ligne	création d'objet	coordonnées x, y du curseur ; longueur de ligne ; angle de rotation (à partir de l'horizontale) ; niveau de zoom
Grossir	sélection avec la souris	niveau de zoom
Polygone, ligne polygonale	création d'objet	coordonnées x, y du curseur ; angle de rotation (à partir de l'horizontale) ; niveau de zoom
Pivoter	déplacement de l'objet	distance horizontale et verticale à partir de la position d'origine ; niveau de zoom
Pivoter	rotation d'objet	angle de rotation à partir de la position d'origine ; niveau de zoom
Sélectionner	déplacement de l'objet	distance horizontale et verticale à partir de la position d'origine ; niveau de zoom


Définition des préférences

Pour définir vos préférences :

1	Choisissez Outils [image] Options outils pour afficher la feuille de propriété Options outils.

2	Indiquez vos préférences (unité de sortie de son, algorithme de compression d'image, taille de page, etc.).

3	Vous pouvez appliquer les options à la session en cours seulement ou à la session en cours et à toutes les sessions suivantes :

•	Pour définir vos préférences uniquement pour la session en cours, sélectionnez OK. Les définitions restent en vigueur jusqu'à ce que la session en cours soit terminée. Certaines définitions prennent effet immédiatement alors que d'autres ne prennent effet qu'à la prochaine création ou ouverture d'un affichage.

•	Pour définir vos préférence pour la session en cours et pour toutes les sessions suivantes, sélectionnez Enregistrer. Vos définitions sont enregistrées dans votre fichier de préférences de Graphics Builder et restent en vigueur pour les sessions ultérieures.

Vous pouvez personnaliser la présentation afin de pouvoir créer et manipuler plus facilement des objets. Les préférences que vous définissez sont enregistrées dans un fichier de préférences local du système de fichiers.


Indication d'une taille de présentation

Pour indiquer la taille d'une présentation :

1	Choisissez Affichage [image] Options d'affichage [image] Présentation pour afficher la boîte de dialogue Paramètres de présentation.

2	Indiquez les options de taille de présentation et d'orientation de page.

3	Sélectionnez OK pour confirmer les paramètres et fermer la boîte de dialogue Paramètres de présentation.

Les paramètres ne restent en vigueur que pendant la session Builder en cours.


Affichage de la totalité de la présentation

Pour afficher la totalité de la présentation :

  Choisissez Affichage [image] Ajuster à la fenêtre.

L'agrandissement diminue pour que la totalité de la présentation soit visible.


Augmentation de l'agrandissement

Pour augmenter l'agrandissement :

1	Sélectionnez l'outil Agrandir dans la palette d'outils.

2	Sélectionnez l'endroit de la présentation que vous voulez agrandir.

L'agrandissement est multiplié par 2 (les objets apparaissent deux fois plus gros). Pour doubler à nouveau cet agrandissement, répétez les étapes ci-dessus. Vous ne pouvez pas agrandir une présentation plus de 16 fois.

Les objets peuvent sembler plus grands, mais leur taille réelle ne change pas.


Diminution de l'agrandissement

Pour diminuer l'agrandissement :

1	Sélectionnez l'outil Agrandir dans la palette d'outils.

2	Maintenez la touche Maj enfoncée et sélectionnez l'endroit de la présentation que vous voulez diminuer.

L'agrandissement est diminué de moitié (les objets apparaissent deux fois moins grands). Pour diminuer à nouveau l'agrandissement de moitié, répétez les étapes ci-dessus. Vous avez atteint la réduction maximum lorsque la totalité de la présentation est visible.

Les objets peuvent sembler plus petits, mais leur taille réelle ne change pas.


Zoom avant sur le centre de la présentation

Pour effectuer un zoom avant sur le centre de la présentation :

  Choisissez Affichage [image] Zoom avant.

La vue est agrandie deux fois.


Zoom arrière sur le centre de la présentation

Pour effectuer un zoom arrière sur le centre de la présentation :

  Choisissez Affichage [image] Zoom arrière.

La vue est divisée par deux.


Retour à l'agrandissement normal

Pour revenir à l'agrandissement normal :

  Choisissez Affichage [image] Taille normale.

L'agrandissement et les objets reprennent leur taille normale.


Indication de paramètres de règle et de grille

Pour indiquer les paramètres des règles et de la grille :

1	Choisissez Affichage [image] Options d'affichage [image] Règle pour afficher le boîte de dialogue de paramètres de règle.

2	Indiquez les paramètres de règles et de grille de votre choix (par exemple, l'unité de mesure à utiliser, l'espacement des grilles, etc.).

3	Sélectionnez OK pour confirmer vos paramètres et fermer la boîte de dialogue de paramètres de règle.

Les paramètres ne restent en vigueur que pendant la session en cours. Les règles et les grilles ne sont pas visibles lors de l'exécution.

Lorsque vous changez l'unité de mesure des règles, celles-ci sont mises à jour en conséquence. En outre, lorsque vous agrandissez une partie de la présentation ou que vous faites défiler l'écran pour afficher une nouvelle partie de la présentation, les règles sont mises à jour en conséquence.


Utilisation des guides

Pour utiliser les guides :

 Sélectionnez la règle horizontale ou verticale et faites glisser le guide à la position de votre choix. Relâchez le bouton de la souris lorsque le guide se trouve à l'endroit voulu.


Déplacement des guides

Pour déplacer le guide :

 Sélectionnez le guide et faites-le glisser jusqu'à sa règle d'origine.

Une fois positionné, vous pouvez le déplacer en le faisant glisser à un nouvel emplacement. Vous pouvez placer sur la présentation autant de guides que vous le souhaitez.


Utilisation de la grille magnétique

Pour utiliser la grille magnétique :

  Choisissez Affichage [image] Grille magnétique.

La grille magnétique est activée ou désactivée, selon le paramètre préalablement choisi. Les paramètres ne restent en vigueur que pendant la session Builder en cours. Lorsque vous activez la grille magnétique, les nouveaux objets que vous créez, déplacez ou redimensionnez s'alignent sur les points magnétiques définis dans la boîte de dialogue de paramètres de règle.


Création de vues

Pour créer des vues :

  Utilisez les barres de partage qui se trouvent, au départ, à droite de la barre de défilement horizontale et sous la barre de défilement verticale.

Pour afficher une barre de partage, cliquez ici.

Les vues, qui apparaissent uniquement dans la présentation du Builder, ne sont pas visibles lorsque vous exécutez ou imprimez l'affichage.

Pour diviser la présentation en plusieurs vues :

  Utilisez les barres de partage horizontal ou vertical de la barre de défilement pour créer deux, trois ou quatre vues :

  Pour créer deux vues, faites glisser la barre de partage horizontal ou vertical à un nouvel emplacement. Cette opération crée deux vues sur un axe, qui ont chacune leur propre barre de partage sur le second axe.

  Pour créer trois vues, créez-en deux, puis partagez l'une d'entre elles en utilisant sa barre de partage sur le second axe.

  Pour créer quatre vues, commencez par en créer deux, puis partagez-les en utilisant leur barre de partage sur le second axe.

Les vues ne restent en vigueur que pendant la session Builder en cours et ne sont pas visibles lors de l'exécution.


Activation de vues

Pour activer une vue :

 Sélectionnez la vue, qui est mise en évidence.

Pour travailler sur une vue, vous devez l'activer. Vous ne pouvez activer qu'une vue à la fois.


Redimensionnement de vues

Pour redimensionner une vue :

  Faites glisser la barre de partage horizontal ou vertical jusqu'à sa nouvelle position.


Suppression de vues

Pour supprimer une vue :

  Faites glisser ses barres de partage jusqu'à leur position d'origine sur les barres de défilement.


Indication d'options de dessin

Pour indiquer des options de dessin :

1	Choisissez Format [image] Options de dessin, puis l'une des options suivantes : Général, Arc, Texte, Rectangle arrondi ou Image.

La boîte de dialogue correspondant à l'option que vous avez sélectionnée s'affiche.

2	Indiquez les options de votre choix.

Vos sélections restent en vigueur pendant l'affichage en cours, jusqu'à ce que vous les modifiiez.

Vous pouvez indiquer des options par défaut à appliquer automatiquement à certains objets lorsque vous les dessinez sur la présentation. Par exemple, vous avez le choix entre les options de texte suivantes : alignement, boîte englobante variable, polices variables et renvoi à la ligne.


A propos des composants du Navigateur d'objet

Le Navigateur d'objet offre une vue hiérarchique de tous les affichages ouverts et de tous les objets qu'ils contiennent et auxquels ils font référence.

Les composants du Navigateur d'objet sont les suivants :

zone d'affichage des noeuds

barre d'outils

indicateur de position

champ Rechercher


A propos de la zone d'affichage des noeuds

La zone d'affichage des noeuds est le principal composant du Navigateur d'objet. C'est dans cette zone que tous les objets que vous pouvez utiliser sont classés en ordre hiérarchique.


A propos de la barre d'outils

La barre d'outils contient les commandes classiques qui figurent également dans le menu Navigateur ou Fichier, comme Enregistrer, Exécuter, Créer, Supprimer, Développer et Réduire.


A propos de l'indicateur de position

L'indicateur de position indique le nom de l'objet sélectionné dans la zone d'affichage des noeuds.


A propos du champ Rechercher

Le champ Rechercher vous permet de rechercher un objet dans le Navigateur en entrant le nom partiel ou complet de l'objet.


A propos de la hiérarchie des objets

La plupart des objets de la hiérarchie du Navigateur reçoivent automatiquement un ou plusieurs sous-objets par défaut, selon le type d'objet. Ces sous-objets par défaut sont de deux types :

•	attribution

•	référence

Par exemple, chaque objet graphique contient des sous-objets d'attribution pour une procédure bouton, un déclencheur d'interrogation d'exécution et une fonction de définition de paramètres. Chaque unité de programme contient des sous-objets de référence pour les références qu'elle contient et des références de l'unité de programme elle-même.

Les sous-objets par défaut de la première couche d'objets du noeud Affichage sont représentés ci-après :

Noeud	Objet	Sous-objets par défaut

Présentation	Couchex	Procédure bouton : Aucune (ou nom) Exécution d'interrogation : Aucune (ou nom) Définition de paramètre : Aucune (ou nom)
Modèles	modèlex	Référence par
Interrogations	interrogationx	Déclencheur exéc personnalisé : Aucun (ou nom) Déclencheur post-exéc : Aucun (ou nom) Horloge : Aucune (ou nom) Référencé par
Paramètres	PARAMx	Référencé par
Horloges	horlogex	Procédure horloge : Aucune (ou nom) Référencé par
Unités de programme	nom	Références de spécification Référencé par
Ces sous-objets par défaut sont conçus pour vous aider à garder la trace des références croisées entre les différents objets de votre affichage. Plus précisément, entre des objets et des unités de programme, des graphiques et des modèles, des paramètres et des objets qui attribuent leurs valeurs, etc.

Par exemple, si vous définissez une procédure de hiérarchisation vers le bas sur un objet graphique pour définir la valeur de PARAM0, le noeud Définir paramètre de l'objet graphique sera défini à PARAM0. De même, le noeud Référencer par de PARAM0 sera défini à nom_objet.


Développement de noeuds

Pour développer un noeud et afficher sa première couche de sous-objets :

1	Sélectionnez un noeud contenant des sous-objets.

2	Sélectionnez Développer ou choisissez Navigateur [image] Développer pour afficher la première couche de sous-objets du noeud.

Vous pouvez également vous contenter de sélectionner le signe + du noeud mis en évidence pour développer la première couche des sous-objets.

Pour développer un noeud et afficher tous ses sous-objets :

1	Sélectionnez un noeud réduit.

2	Sélectionnez Développer tout ou choisissez Navigateur [image] Développer tout pour afficher tous les sous-objets du noeud.


Réduction de noeuds

Pour réduire un noeud :

1	Sélectionnez le noeud développé.

2	Sélectionnez Réduire ou choisissez Navigateur [image] Réduire. Les sous-objets du noeud sont masqués.

Le noeud réduit est précédé d'un signe + mis en évidence.

Vous pouvez également vous contenter de sélectionner le signe - du noeud mis en évidence pour réduire la première couche des sous-objets.

Pour réduire un noeud et masquer tous ses sous-objets :

1	Sélectionnez un noeud développé.

2	Sélectionnez Réduire tout ou choisissez Navigateur [image] Réduire tout pour masquer tous les sous-objets.


Recherche d'objets

Pour rechercher des objets :

1	Entrez le nom, complet ou partiel, de l'objet que vous voulez rechercher dans le champ Rechercher.

Dès que vous commencez la saisie, Graphics Builder lance une recherche incrémentielle vers l'avant, à partir du début du Navigateur d'objet. La recherche se poursuit jusqu'à ce que vous arrêtiez la saisie.

Graphics Builder développe les noeuds nécessaires pour afficher sa position en cours pendant la recherche.

2	Sélectionnez Recherche avant ou sur Recherche arrière selon que vous voulez rechercher la prochaine occurrence ou l'occurrence précédente des critères de recherche dans le Navigateur d'objet.

A l'heure actuelle, vous ne pouvez pas indiquer de caractères génériques dans le champ Rechercher.


A propos de la préparation d'un affichage à intégrer

Avant d'intégrer un affichage Graphics Builder dans une application conçue sous un outil différent, vous devez préparer votre environnement et votre affichage afin que les outils soient utilisés de façon optimale. Les différents points à prendre en compte sont les suivants :

•	emplacement des modules

•	remplissage des colonnes d'interrogation à l'aide d'une source externe

•	dimensionnement de l'affichage

•	exécution de l'affichage

•	réception des paramètres de texte

•	réception des données

•	création de la présentation


A propos du remplissage des colonnes d'interrogation à l'aide d'une source externe

Lorsque vous intégrez un graphique Graphics Builder dans un autre produit Oracle comme Form Builder ou Report Builder (inclus dans Reports Developer), le graphique utilise les données de l'interrogation du produit appelant tant que les colonnes de l'interrogation utilisées pour créer le graphique et celles utilisées dans l'interrogation du produit d'appel correspondent. Utilisez la page de propriété Schémas de l'interrogation pour créer des colonnes ayant les mêmes noms que l'interrogation utilisée par le produit appelant.

Comme le graphique que vous créez sera uniquement appelé par un autre produit Oracle, vous pouvez utiliser une interrogation personnalisée pour créer un graphique "vide". Ce graphique recevra des données lorsqu'il sera appelé par le produit appelant. Définissez ensuite les propriétés du graphique comme d'habitude, en attribuant des données de catégorie, de valeur, etc.

Le graphique apparaîtra vide (sans données) dans la présentation.

Lorsque l'affichage Graphics Builder est appelé par l'autre produit, l'interrogation du produit appelant remplace l'interrogation personnalisée et, les noms de colonnes étant identiques, le graphique est tracé en fonction de vos spécifications.


A propos de la localisation des modules

Lorsque Graphics Builder est appelé pour exécuter un affichage intégré, il doit pouvoir le trouver. Pour cela, il explore les fichiers dans l'ordre suivant :

1	Le chemin d'accès au répertoire précédant le nom du fichier, le cas échéant.

2	Votre répertoire "courant" ou "de travail", déterminé par votre système d'exploitation.

3	Le chemin indiqué par la variable d'environnement GRAPHICS30_PATH.

4	Le chemin indiqué par la variable d'environnement ORACLE_PATH.

Assurez-vous que vous avez indiqué explicitement l'emplacement de votre affichage ou que vos variables d'environnement de chemin d'accès sont correctement définies(l'une d'entre elles marquant l'emplacement de votre affichage).


A propos du dimensionnement de l'affichage

Lorsqu'un affichage apparaît dans une application, il n'a pas forcément la même taille que dans Graphics Builder. Lorsque vous intégrez un affichage, vous devez décider si vous voulez le couper ou le mettre à l'échelle, ou créer un affichage ayant exactement la taille de la présentation de l'application.

Comme les composants d'Oracle utilisent le même système de définition graphique, vous pouvez demander à Form Builder de mettre l'affichage à l'échelle ou de le couper en fonction de la taille de la région d'affichage cible. Report Builder (inclus dans Reports Developer) met automatiquement l'affichage à la taille de la région dans laquelle il doit être intégré.

Les affichages dont vous demandez la mise à l'échelle n'ont pas les mêmes caractéristiques que ceux que vous coupez. Les affichages mis à l'échelle peuvent parfois apparaître déformés. La taille des affichages coupés est calculée à partir de l'angle supérieur gauche de la zone d'affichage (coordonnées 0,0). Cela étant, si vous déplacez vos objets d'affichage par rapport au bord supérieur et au bord gauche de l'Editeur de présentation de Graphics Builder, cet espace "libre" est inclus dans la version coupée de l'affichage.

Pour éviter les déformations d'affichage ou les espaces vides, vous pouvez :

•	Faire passer le contenu de l'affichage dans l'angle supérieur gauche de l'Editeur de présentation.

•	Utiliser Affichage [image] Options d'affichage [image] Présentation pour afficher la boîte de dialogue correspondante dans laquelle vous pouvez indiquer la taille de l'affichage.


A propos de l'exécution de l'affichage

D'autres produits Oracle peuvent appeler les exécutables Runtime ou Batch de Graphics Builder.


A propos de la réception de paramètres de texte

  Rubriques connexes

Un produit qui appelle un affichage Graphics Builder peut transmettre des valeurs initiales aux paramètres définis dans l'affichage. Ces valeurs de paramètres sont toujours transmises sous forme de données de type CHAR.

Lorsque vous créez un paramètre dans Graphics Builder, vous devez indiquer le type des données dans la boîte de dialogue Paramètres. Graphics Builder convertit implicitement la valeur de paramètre CHAR entrant en données du type indiqué pour le paramètre.

Si vous voulez transmettre une date du produit appelant à Graphics Builder, indiquez le format de date entrant dans la fenêtre de propriété Affichage. Par exemple, pour la valeur 04-JUL-92 à Graphics Builder, assurez-vous que le champ Format de date de paramètre de la fenêtre de propriété Affichage contient DD-MON-YY.


A propos de la réception des données

  Rubriques connexes

Lorsque vous intégrez un affichage Graphics Builder dans un autre produit Oracle, Graphics Builder peut utiliser les données de ce produit à la place des siennes.

Lorsque vous créez le graphique dans Graphics Builder, cochez Mettre à jour le graphique sur exécution de l'interrogation, dans la page de propriété Données de la fenêtre de propriété Graphique. Le graphique sera mis à jour à l'aide des nouvelles données lors de l'exécution de l'interrogation sur le produit appelant.

Assurez-vous que l'interrogation utilisée par le produit appelant contient les mêmes noms de colonne que l'interrogation Qui a servi à créer le graphique, afin que Graphics Builder sache comment traiter les données qui lui sont envoyées. Par exemple, soit un affichage contenant un graphique ayant comme catégorie ENAME et comme valeur SAL.

Si Form Builder utilise des données dont les colonnes s'appellent EMPLOYEE et SALARY, le graphique ne trouve pas les colonnes qu'il recherche.

Si vous avez utilisé des alias dans votre interrogation Graphics Builder, vous voudrez peut-être les supprimer par souci de clarté. Dans ce cas, affectez des étiquettes d'axe personnalisées en utilisant la fenêtre de propriété Axe.


A propos de la création de la présentation

Après avoir appelé Graphics Builder, Report Builder (inclus dans Reports Developer) reçoit toujours le contenu de la présentation après l'exécution de l'affichage, alors que Form Builder reçoit le contenu de la présentation indiquée dans la procédure OG.OPEN.


A propos de l'intégration d'affichages dans des applications Forms

  Rubriques connexes

Vous pouvez intégrer des affichages dans des applications Forms :

•	par l'assistant Graphique de Form Builder

•	par des procédures internes PL/SQL

Pour intégrer un nouveau graphique dans une application Forms, utilisez l'assistant Graphique de Form Builder qui vous explique, étape par étape, comment créer un graphique simple.

Pour intégrer un affichage existant ou complexe, créez votre élément graphique manuellement et attachez-lui la bibliothèque OG.PLL. Cette bibliothèque regroupe des routines PL/SQL intégrées, conçues spécialement pour la transmission de données entre des applications Forms et des affichages. Elle contient des procédures et des fonctions de transmission de données, d'événements de souris et de commandes PL/SQL, ainsi que de déclenchement et de déconnexion d'affichages intégrés lors de l'exécution. Vous pouvez intégrer des procédures internes OG.PLL dans des déclencheurs d'applications Forms qui envoient des informations et des commandes à l'affichage intégré lorsqu'ils sont activés par des événements qui surviennent dans l'application Forms.


Utilisation de l'assistant Graphique pour créer des graphiques dans les applications Forms

  Rubriques connexes

Pour créer des graphiques dans les applications Forms à l'aide de l'assistant Graphique :

1	Dans la présentation Form Builder, choisissez Outils [image] Assistant Graphique ou sélectionnez le bouton Assistant Graphique de la barre d'outils.

2	Sélectionnez un rectangle de la présentation et faites-le glisser. La taille du rectangle que vous créez détermine la taille de l'objet graphique créé.

3	Dans la boîte de dialogue Nouvel objet graphique, sélectionnez Utiliser l'Assistant Graphique.

4	Sur la page Bienvenue de l'assistant Graphique, sélectionnez Suivant, puis suivez les conseils de l'assistant pour créer votre graphique.


Création manuelle d'objets graphiques dans Form Builder

  Rubriques connexes

Pour créer manuellement un graphique dans une application Forms :

1	Dans la présentation Form Builder, sélectionnez l'outil Elément graphique de la palette d'outils.

2	Sélectionnez un rectangle de la présentation et faites-le glisser. La taille du rectangle que vous créez détermine la taille de l'objet graphique créé.

3	Dans la boîte de dialogue Nouvel objet graphique, sélectionnez Créer un nouveau graphique manuellement.


Intégration d'affichages existants dans des applications Forms

  Rubriques connexes

Pour intégrer un affichage existant dans une application Forms :

1	Créez manuellement un objet graphique.

2	Attachez la bibliothèque OG.PLL au module d'application Forms.

3	Créez un ou plusieurs déclencheurs d'application Forms utilisant la procédure OG.OPEN de la bibliothèque OG.PLL pour charger l'affichage existant.

4	(Facultatif)  Utilisez la bibliothèque OG.PLL des procédures internes pour automatiser l'affichage.


A propos de l'utilisation de PL/SQL pour intégrer un affichage dans une application Forms

  Rubriques connexes

Pour intégrer un affichage dans une application Forms, utilisez la procédure en package OG.OPEN de la bibliothèque OG.PLL.

Vous pouvez inclure la procédure OG.OPEN dans un certain nombre de déclencheurs différents. Par exemple, le déclencheur When-New-Form-Instance charge l'affichage lors de la création de l'application Forms, alors que le déclencheur When-Button-Pressed charge l'affichage lorsque l'utilisateur sélectionne le bouton approprié. Si l'affichage se trouve dans un bloc qui n'est pas actif lorsque le déclencheur comprenant OG.OPEN est activé, l'affichage est chargé, mais le bloc ne reçoit pas le point d'insertion et l'affichage n'apparaît pas immédiatement.

Une fois que Form Builder a appelé l'exécutable Graphics Builder approprié et chargé l'affichage, il reste en mémoire jusqu'à ce qu'il soit explicitement fermé. Graphics Builder ne recharge pas un affichage ouvert. Pour tester les modifications apportées à l'objet graphique, commencez par fermer l'affichage en appelant la procédure interne OG.CLOSE dans un déclencheur (OG.CLOSE figure dans la bibliothèque OG.PLL.)

Pour sortir de Graphics Builder, utilisez la procédure interne OG_QUIT contenue dans un autre déclencheur comme Post-Block ou Post-Form. La différence entre OG_QUIT et OG.OPEN et OG.CLOSE est que cette procédure ne fait pas partie de la bibliothèque OG.PLL incluse dans Form Builder, mais est un sous-programme intégré de Graphics Builder. En tant que telle, elle doit être transmise à Graphics Builder pour être interprétée, ce qui est exécuté par la procédure OG.INTERPRET de la bibliothèque OG.PLL. Utilisez OG.INTERPRET pour transmettre à Graphics Builder toute chaîne PL/SQL valide à exécuter.


A propos de la bibliothèque OG.PLL

Le niveau d'intégration entre l'application Forms et un graphique dépend du niveau de communication que vous créez entre Graphics Builder et Form Builder. Pour que Form Builder puisse "parler" à Graphics Builder, utilisez la bibliothèque OG.PLL.

Form Builder comporte cette bibliothèque qui est un package regroupant plusieurs procédures et fonctions qui permettent de communiquer avec un affichage.

Généralement, pour permettre la communication entre Form Builder et Graphics Builder, vous devez inclure une ou plusieurs procédures et fonctions OG.PLL dans un ou plusieurs déclencheurs d'application Forms, afin que les opérations exécutées dans l'application Forms transmettent des informations et des commandes à l'affichage intégré.


A propos de l'activation de l'affichage

Vous pouvez sensibiliser votre affichage aux actions de l'utilisateur. La méthode la plus simple consiste à utiliser les sous-programmes en package OG.MOUSEDOWN et OG.MOUSEUP qui figurent dans la bibliothèque OG.PLL pour informer un affichage d'un événement de souris.

Lorsque l'utilisateur exécute l'opération pour laquelle vous avez créé un déclencheur, le déclencheur transmet les informations directement à Graphics Builder, qui réagit comme si l'événement de souris s'était produit dans Graphics Builder Runtime.

Ce déclencheur n'a pas à être attaché à un événement de souris. Si vous voulez que les utilisateurs atteignent un affichage de hiérarchie vers le bas en appuyant sur un bouton, créez ce bouton dans la présentation de Form Builder et attachez un déclencheur When-Button-Pressed comprenant la procédure appropriée.

Les sous-programmes OG.MOUSEUP et OG.MOUSEDOWN vous permettent de contrôler totalement les informations envoyées de l'application Forms à l'affichage. (Par exemple, pour que l'utilisateur appuie sur un bouton de l'application Forms au lieu d'utiliser la souris, vous avez également la possibilité de transmettre à l'affichage toutes les informations nécessaires - y compris les coordonnées, le clic simple ou double, l'action sur le bouton 1 ou le bouton 2 - et Graphics Builder traitera ces informations comme un événement de souris réel.

La valeur par défaut de tous les arguments signalant des événements de la souris est constituée par les informations réellement transmises par la souris.


A propos de la transmission de PL/SQL à l'affichage

Lorsque vous intégrez un affichage Graphics Builder dans une application Form Builder, vous pouvez utiliser la procédure OG.INTERPRET pour demander à l'affichage d'exécuter une partie de code PL/SQL spécifique. Ce code PL/SQL, qui peut aller d'une procédure interne Graphics Builder à une fonction ou à une procédure créée par l'utilisateur à une commande d'une ligne, doit être transmis sous la forme d'une chaîne de caractères. Ces chaînes doivent être placées entre guillemets et comporter les point-virgules de fin nécessaires.

En utilisant OG.INTERPRET, vous pouvez exécuter des unités de programme Graphics Builder à partir de l'application Forms. Cette solution vous permet non seulement de modifier les données sur lesquelles repose un graphique, mais également d'utiliser des unités de programme PL/SQL dans l'affichage pour exécuter des opérations dynamiques comme le changement de couleur d'une barre de graphique ou le déplacement d'un objet.


A propos de l'échange de données entre l'application Forms et l'affichage

  Rubriques connexes

Outre l'envoi d'actions de la souris ou de code PL/SQL à un affichage intégré, vous pouvez également transférer des informations soit de l'application Forms à l'affichage, soit de l'affichage à l'application Forms. Utilisez la fonction OG.GETCHARPARAM, inlcuse dans la bibliothèque OG.PLL, qui fournit également OG.GETNUMPARAM pour les paramètres dont les valeurs sont des nombres.

Pour transmettre des données, vous pouvez utiliser deux types de paramètres :

•	Paramètres de texte

•	Paramètres de données

L'affichage peut alors utiliser les informations pendant les mises à jour.


A propos des paramètres de texte

Les paramètres de texte contiennent des valeurs provenant de variables ou de constantes. Ils font référence à des paramètres système prédéfinis, des paramètres définis par l'utilisateur, des variables de lien ou des variable lexicales. A chaque paramètre de texte correspondent une clé (ou nom) et une valeur.

Les paramètres système prédéfinis ont des noms (ou clés) fixes, et sont généralement indiqués dans la ligne de commande qui appelle l'outil. Par exemple, PRINT est une clé de paramètre et `yes' une valeur possible ; USERID est une clé et `scott/tiger@t:london:payroll' une valeur valide.

Les paramètres définis par l'utilisateur, généralement pendant la phase de développement d'une application, permettent aux utilisateurs de mieux contrôler les actions des modules auxquels ils s'appliquent. Pour plus d'informations sur la création des paramètres dans une application Forms, reportez-vous à votre documentation Form Builder.

Les paramètres définis par l'utilisateur transmis d'un produit à l'autre, sont tout d'abord convertis en données de type CHAR. Cependant, le produit appelé peut, soit convertir implicitement les valeurs en données du type voulu, soit vous permettre de les considérer comme des valeurs d'un autre type (par exemple, en utilisant les fonctions de conversion PL/SQL comme TO_DATE, TO_NUMBER, etc.).

Pour plus d'informations sur la conversion des types de données par une fonction de conversion, reportez-vous à PL/SQL User's Guide and Reference.


A propos des paramètres de données

Les paramètres de données sont des groupes d'enregistrements que vous pouvez transmettre de Form Builder à Graphics Builder, sous forme de tableaux. Vous pourrez exécuter cette opération pour les raisons suivantes :

•	Si l'affichage crée et exécute dynamiquement une interrogation en fonction d'une action de l'utilisateur dans l'application Forms, vous pouvez fournir à Graphics Builder les résultats de cette action utilisateur.

•	Si l'affichage utilise des données que Form Builder a déjà extraites, vous pouvez éviter que ce produit ait à extraire à nouveau les données.

•	Si l'application Forms a créé un groupe d'enregistrement non validé que vous voulez afficher.

Comme avec les paramètres de texte, à chaque paramètre de données correspondent une clé et une valeur. La valeur d'un paramètre de données indique le nom de l'interrogation Form Builder transmise à l'affichage. La clé d'un paramètre de données indique le nom de l'interrogation, auquel il est rendu égal dans le produit appelé.

Lorsque vous transmettez des données de Form Builder à Graphics Builder, assurez-vous que vous exécutez d'abord l'interrogation dans Form Builder.


A propos de la création et du remplissage de listes de paramètres

  Rubriques connexes

Pour transmettre des informations à un affichage, Form Builder utilise une liste de paramètres, c'est-à-dire une série de paires de clés et de valeurs de paramètre. (Il est obligatoire d'attribuer à une liste de paramètres un paramètre isolé.) Chaque information à transmettre doit être définie comme paramètre, puis ajoutée à une liste de paramètres. Le type de paramètre que vous créez dépend des informations que vous voulez transférer. Les listes de paramètres sont toujours transmises sous la forme de littéraux en chaîne.

Pour vous permettre de créer et de manipuler des listes de paramètres et les paramètres qu'elles contiennent, Form Builder offre plusieurs fonctions et procédures intégrées :

•	CREATE_PARAMETER_LIST (fonction) pour créer une liste de paramètres

•	GET_PARAMETER_LIST (fonction) pour lire une liste de paramètres

•	DESTROY_PARAMETER_LIST (fonction) pour détruire une liste de paramètres

•	ADD_PARAMETER (procédure) pour ajouter un paramètre

•	SET_PARAMETER_ATTR (procédure) pour définir l'attribut d'un paramètre

•	GET_PARAMETER_ATTR (procédure) pour lire l'attribut d'un paramètre

•	DELETE_PARAMETER (procédure) pour supprimer un paramètre

Pour Graphics Builder, ces fonctions et procédures  font partie du package TOOL_INT. Lorsque vous les utilisez, faites précéder leur nom de TOOL_INT., par exemple, TOOL_INT.GET_PARAMETER_LIST.


A propos de l'appel de Graphics Builder à partir d'une application Forms

Une fois que vous avez créé et rempli la liste de paramètres, appelez Graphics Builder et transmettez-lui la liste des paramètres en utilisant l'une des procédures ci-dessous, fournies dans OG.PLL :

•	OG.OPEN

•	OG.INTERPRET

•	OG.MOUSEDOWN

•	OG.MOUSEUP

•	OG.REFRESH


Utilisation de Graphics Builder pour créer des affichages à utiliser dans des applications Forms

  Rubriques connexes

Pour créer un affichage Graphics Builder à utiliser dans des applications Forms :

  Créez un affichage Graphics Builder de la manière habituelle.

Pour créer un affichage Graphics Builder de hiérarchie vers le bas à utiliser dans des applications Forms :

  Créez un affichage de hiérarchie vers le bas de la manière habituelle.


Dessin d'une zone de graphique

Pour dessiner une zone de graphique :

  Sélectionnez l'outil Elément graphique dans la palette d'outils de Form Builder et tracez une région dans la présentation de l'application Forms. Renommez la zone de graphique dans la fenêtre Propriétés ou conservez le nom par défaut.


Création de déclencheurs pour ouvrir et fermer l'affichage

  Exemples

Pour créer des déclencheurs destinés à ouvrir et à fermer l'affichage :

1	Attachez la bibliothèque OG.PLL à votre application Forms. Cette bibliothèque contient le package OG, composé des sous-packages que vous utiliserez pour la communication entre Form Builder et Graphics Builder.

Pour plus d'informations sur l'attachement de bibliothèques dans Form Builder, reportez-vous à votre documentation Form Builder.

2	Créez un déclencheur qui utilise la procédure OG.OPEN pour charger l'affichage Graphics Builder.

3	Si nécessaire, créez un déclencheur qui utilise la procédure OG.CLOSE pour fermer l'affichage. Vous pouvez également utiliser OG.INTERPRET pour envoyer une commande de sortie à Graphics Builder.

Pour plus d'informations sur la création de déclencheurs dans Form Builder, reportez-vous à votre documentation Form Builder.


Exemples : ouverture et fermeture d'affichages

Exemple : OG.OPEN

Le déclencheur When-New-Form-Instance ci-dessous ouvre l'affichage inv_disp.ogd dans la zone de graphique `CHART_AREA1', met l'affichage à l'échelle en fonction de l'espace qui lui est affecté dans la présentation Form Builder, et rafraîchit automatiquement l'affichage (valeur par défaut : REFRESH=TRUE). Aucune liste de paramètres n'est transmise.

OG.OPEN('inv_disp.ogd', 'CHART_AREA1', clip=FALSE);

Exemple : OG.CLOSE

Le déclencheur Post-Form ci-dessous ferme l'affichage inv_disp.ogd dans la zone de graphique 'CHART_AREA1'. Il n'accepte que deux paramètres : nom_affichage et nom_élément_graphique.

OG.CLOSE('inv_disp.ogd', 'CHART_AREA1');

Là non plus, vous n'êtes pas obligé d'utiliser le déclencheur Post-Form. Sélectionnez le déclencheur qui est le mieux adapté à la fermeture de l'affichage lorsque vous voulez le fermer.

Exemple : OG.INTERPRET

Le déclencheur Post-Form ci-dessous utilise la procédure interne OG_QUIT de Graphics Builder pour sortir de Graphics Builder :

OG.INTERPRET('inv_disp.ogd', 'CHART_AREA1', 'og_quit;');

Notez le point-virgule qui suit immédiatement "og_quit". Lors de la transmission du code PL/SQL par OG.INTERPRET, vous ne devez pas oublier le point-virgule de fin. Vous n'êtes pas non plus obligé d'utiliser le déclencheur Post-Form. Sélectionnez le déclencheur qui est le mieux adapté à la sortie de l'affichage lorsque vous voulez en sortir.


Création de déclencheurs pour transmettre des événements de souris

  Exemples

Pour créer des déclencheurs destinés à transmettre des événements de souris :

  Créez  dans Form Builder un déclencheur qui comporte le sous-programme en package OG.MOUSEDOWN ou OG.MOUSEUP provenant de la bibliothèque OG.PLL.


Exemple : Création d'un déclencheur destiné à transmettre un événement de souris

Exemple :  OG.MOUSEDOWN

Le déclencheur When-Mouse-Click ci-dessous active l'affichage inv_disp.ogd :

OG.MOUSEDOWN('inv_disp.ogd', 'CHART_AREA1');

La procédure de l'exemple ci-dessus n'utilise que deux arguments : nom_affichage et nom_zone_graphique. Les deux procédures acceptent plusieurs autres arguments, y compris les coordonnées x et y supposées pour la sélection avec la souris, le bouton de souris utilisé, le nombre de fois où l'utilisateur enfonce ce bouton, une liste de paramètres, etc.


Création de déclencheurs pour transmettre du code PL/SQL

  Exemples

Pour créer des déclencheur destinés à transmettre du code PL/SQL :

  Lorsque vous utilisez le sous-programme en package OG.INTERPRET pour appeler une unité de programme Graphics Builder à partir de Form Builder, vous devez transmettre l'unité de programme et les éventuels arguments nécessaires sous la forme d'une valeur de chaîne. En d'autres termes, l'unité de programme que vous exécutez doit être placée entre apostrophes.


Exemples : Création de déclencheurs destinés à transmettre du code PL/SQL

Exemple 1 :  Utilisation de OG.INTERPRET pour appeler une procédure

L'exemple ci-dessous, inclus dans un déclencheur When-Button-Pressed, appelle la procédure 'set_timers' :

OG.INTERPRET('inv_disp.ogd', 'CHART_AREA1',
'set_timers;');

Notez l'inclusion du point-virgule de fin.

Exemple 2 :  Utilisation de OG.INTERPRET pour créer une chaîne

Si l'unité de programme que vous appelez dans Graphics Builder implique la transmission d'arguments par Form Builder, utilisez l'opérateur de chaînage pour créer la valeur de chaîne nécessaire. L'exemple ci-dessous demande à Graphics Builder d'exécuter l'unité de programme "set_param" avec un argument fourni par l'un des champs de texte sous la forme :

OG.INTERPRET ('inv_disp.ogd', 'CHART_AREA1', 'set_param('|| TO_CHAR(:BLOCK1.category_cbox) || ');');

Exemple 3 :  Utilisation de OG.INTERPRET pour créer une chaîne complexe

Voyons maintenant un exemple légèrement plus complexe de création d'une chaîne en utilisant l'opérateur de chaînage :

OG.INTERPRET('inv_disp.ogd', 'CHART_AREA1',
'set_timer(' ||
 TO_NUM(:BLOCK2.values_plist) ||
 ','  ||
 TO_NUM(:BLOCK3.more_cbox) ||
 ');');

En fractionnant l'appel de sous-programme ci-dessus en éléments séparés (par un opérateur de chaînage), vous voyez :

'set_timer('	contient le nom de la procédure et la parenthèse	d'ouverture entre apostrophes.

TO_NUM(:BLOCK2.	Contient le paramètre provenant de Form Builder, converti en données de type NUMBER

values_plist)	datatype.  Cet argument est demandé par la procédure set_timer.

','	Contient la virgule qui sépare les deux arguments fournis.

TO_NUM(:BLOCK3.	Contient le paramètre fourni par Form Builder converti en données de type NUMBER.

more_cbox)	datatype.  C'est le second argument de la procédure	set_timer.

');'	Contient les parenthèses et le point-virgule de fin de	procédure, entre apostrophes.

Graphics Builder voit la chaîne résultante :

set_timer(x,y);

dans laquelle les arguments x et y sont les valeurs numériques transmises par l'application Forms et converties en données de type NUMBER.


Création de déclencheurs pour transmettre des données

  Exemples

Pour créer des déclencheurs destinés à transmettre des données :

  Lors de la transmission de données d'une application Forms à un affichage, n'oubliez pas que l'application Forms peut à la fois extraire des valeurs de paramètres de l'affichage et transmettre des paramètres de texte et de données à l'affichage. Cependant, elle ne peut extraire qu'une valeur de paramètre par interrogation, alors qu'elle ne peut transmettre que des listes de paramètres.


Exemples : Création de déclencheurs pour transmettre des données

Exemple 1 : Lecture d'une valeur de paramètre

La fonction ci-dessous, dans un déclencheur When-Button-Pressed, extrait la valeur du paramètre d'affichage Graphics Builder param1 et l'attribue au champ de texte 'TEXT_ITEM1' dans l'application Forms :

:BLOCK1.TEXT_ITEM1 := OG.GETCHARPARAM

('inv_disp.ogd', 'CHART_AREA1', 'param1');

Exemple 2 : Transmission d'un paramètre

La fonction ci-dessous comporte le texte d'un déclencheur Post-Query de niveau bloc qui peut être utilisé pour transmettre à Graphics Builder un numéro de département qui servira lors de la construction de l'affichage sal_chart.

PROCEDURE pass_param IS
pl   ParamList  /*Type de données de la liste de paramètres*/
BEGIN

/*Créer la liste paramètres appelée "ma liste param".*/
pl := Create_Parameter_List('ma_liste_param');

/*Ajouter à la liste un paramètre de texte fournissant une valeur

**au paramètre 'dept_num' que Graphics Builder attend.*/
Add_Parameter(pl, 'num_dépt', TEXT_PARAMETER,
TO_CHAR(:dept.deptno));

/*Appeler Graphics Builder pour remplir l'élément graphique.*/
OG.REFRESH('sal_chart', 'dept.chart_item', pl);

/*Détruire la liste de paramètres*/
Destroy_Parameter_List(pl);

END

Exemple 3 : Transmission de groupes d'enregistrements

L'exemple suivant contient le texte d'un déclencheur Post-Query de niveau bloc utilisé pour transmettre des données Graphics Builder. Dans cet exemple, Form Builder émet une interrogation et stocke les données résultantes dans un groupe d'enregistrements. Un paramètre de données est utilisé pour transmettre le groupe d'enregistrements à Graphics Builder qui utilise les données pour construire l'affichage sal_chart.

Procedure pass_data is
pl_id  PARAMLIST;
rg_id  RECORDGROUP := Find_Group('chart_data');
qry    VARCHAR(2000);
stat   NUMBER;

BEGIN
/*Préparer une interrogation dans une chaîne en fonction de la dernière
**clause WHERE émise.*/
qry := 'SELECT ename, sal FROM emp '||
   substr(:system.last_query,instr(:system.last_query,
'WHERE'))||' order by empno';

/*Vérifier si le groupe d'enregistrements existe déjà;
**s'il n'existe pas, le créer.*/
IF Id_Null(rg_id) THEN
rg_id := CREATE_GROUP_FROM_QUERY('chart_data', qry);
END IF;

/*Comme le groupe d'enregistrements contient peut-être d'anciennes
**données, les effacer et les remplacer par la nouvelle
**interrogation */
DELETE_GROUP_ROW(rg_id, all_rows);
stat := POPULATE_GROUP_WITH_QUERY(rg_id, qry);

/*Créer une liste de paramètres */
pl_id := CREATE_PARAMETER_LIST('pl_chart_data');

/*Ajouter un paramètre de données ayant le même nom que l'interrogation dans l'affichage*/
Add_Parameter(pl_id,'query0',DATA_PARAMETER,'chart_data');

/*Rafraîchir un affichage déjà ouvert en utilisant les nouvelles données*/
OG.REFRESH('sal_chart','dept.chart_item',pl_id);

*/Détruire la liste de paramètres*/
DESTROY_PARAMETER_LIST

END


Création et remplissage de listes de paramètres

  Rubriques connexes

Pour créer une liste de paramètres :

1	Choisissez les informations que vous voulez transmettre.

2	Créez la liste de paramètres à l'aide de la procédure interne correspondant à votre outil.

3	Ajoutez des éléments à la liste. Cette procédure requiert les arguments suivants :

   Nom de votre liste de paramètres

  Nom du paramètre que vous voulez ajouter

  Type du paramètre que vous voulez ajouter (texte ou données)

  Valeur du paramètre que vous voulez ajouter

Si vous transmettez une ligne de commande ou des options d'exécutable, n'oubliez pas d'indiquer le mot-clé d'option de ligne de commande comme nom de paramètre. Pour connaître toutes les options d'exécutable valides, reportez-vous à la documentation concernant le produit.


Exécution de l'application Forms

Pour exécuter l'application Forms :

  Assurez-vous que les déclencheurs que vous avez créés se compilent correctement et sélectionnez Fichier [image] Exécuter.


A propos de l'intégration d'affichages dans des états

  Rubriques connexes

Pour intégrer des affichages dans des états, deux méthodes sont possibles :

•	par l'assistant Graphique de Report Builder (inclus dans Reports Developer)

•	manuellement

Pour créer un nouveau graphique dans un état, utilisez l'assistant Graphique de Report Builder (inclus dans Reports Developer), qui vous explique en détail comment créer un graphique simple.

Pour intégrer dans un état un affichage complexe ou existant, créez un objet graphique dans la présentation de l'état et utilisez la Palette de propriétés de l'objet graphique pour définir les propriétés de l'affichage.

Vous pouvez définir un affichage qui recevra des données directement de l'état dans lequel il est intégré, et non d'une base de données. Cette fonction vous permet d'intégrer des affichages qui reflètent des données récapitulatives ou filtrées provenant d'états.


Entrer ici la légende relative à la nouvelle rubrique
Un affichage complexe est un affichage interactif, qui contient plusieurs interrogations ou inclut des objets et des graphiques.


Utilisation de l'assistant Graphique pour créer un graphique dans un état

  Rubriques connexes

Pour créer un graphique à partir d'un état à l'aide de l'assistant Graphique :

1	Dans la vue Assistant interactif de Report Builder ou Modèle de présentation (inclus dans Reports Developer), choisissez Outils [image] Assistant graphique ou sélectionnez le bouton Assistant Graphique de la barre d'outils.

2	Suivez les instructions fournies par l'assistant pour créer votre graphique.


Intégration dans un état d'un affichage existant

  Rubriques connexes

Pour intégrer dans un état un affichage existant :

1	Dans la vue Modèle de présentation de Report Builder (inclus dans Reports Developer), sélectionnez l'outil Graphique de la palette d'outils.

2	Sélectionnez un rectangle et faites-le glisser pour créer un objet graphique. La taille du rectangle que vous créez détermine la taille de l'objet graphique créé.

3	Cliquez deux fois sur le nouvel objet graphique pour afficher sa Palette de propriétés.

4	Sous le noeud Graphique, définissez la propriété Nom de fichier graphique au nom du fichier contenant votre affichage.

5	Si vous voulez transmettre à l'affichage des paramètres de l'état, établissez la correspondance entre les colonnes ou les paramètres de l'état et les paramètres de l'objet graphique.

6	Si l'affichage utilise plusieurs interrogations ou si vous voulez transmettre directement des valeurs de donnée de l'état à l'affichage, établissez la correspondance entre les propriétés des colonnes de l'objet graphique et l'état.


Transmission de paramètres d'un état à un affichage intégré

  Rubriques connexes

Pour transmettre des paramètres d'un état à un affichage :

1	Cliquez deux fois sur l'objet graphique intégré pour afficher sa Palette de propriétés.

2	Dans la Palette de propriétés, sous le noeud Graphique, sélectionnez le champ Paramètres et colonnes pour afficher les pages de propriété Paramètres et Colonnes.

3	Sélectionnez l'onglet Paramètres.

4	Dans la liste Colonne de l'état, sélectionnez les colonnes ou les paramètres de l'état qui correspondent aux paramètres de l'affichage. Sélectionner une colonne ou un paramètre d'un état veut dire qu'il y a, dans l'affichage, un paramètre correspondant et que ce paramètre extraira sa valeur de l'instance appropriée de la colonne d'état sélectionnée.

5	Dans le champ Paramètre graphique, entrez le nom du paramètre graphique auquel correspond la colonne ou le paramètre de l'état.

6	Sélectionnez OK.


Transmission de valeurs de données d'un état à un affichage intégré

  Rubriques connexes

Pour transférer des valeurs de données d'un état à un affichage :

1	Cliquez deux fois sur l'objet graphique intégré pour afficher sa Palette de propriétés.

2	Dans la Palette de propriétés, sous le noeud Graphique, sélectionnez le champ Paramètres et colonnes pour afficher les propriétés des paramètres et des colonnes.

3	Sélectionnez l'onglet Colonne.

4	Dans le champ Interrogation graphique, entrez le nom de l'interrogation d'affichage. Si vous voulez que l'affichage reflète les données ou les récapitulatifs filtrés de l'état, sélectionnez une interrogation dont la source de données (SQL ou fichier) retourne des colonnes de données qui correspondent aux colonnes ou aux paramètres que vous voulez transmettre à partir de l'état.

5	Dans le champ Groupe d'état, choisissez dans la liste déroulante le groupe d'états qui contient les données et les paramètres utilisés par l'interrogation que vous avez indiquée dans le champ Interrogation graphique.

6	Dans la liste Colonne d'état, indiquez les colonnes de l'état qui correspondent aux colonnes de l'affichage. Les colonnes de l'état que vous sélectionnez fourniront les valeurs des colonnes d'affichage correspondantes. Entrez dans le champ Colonne graphique les noms des colonnes d'affichage correspondantes.

7	Sélectionnez OK.


Création d'une destination hyperlien pour un affichage intégré dans un état

Pour ajouter une destination hyperlien à un affichage intégré dans un état :

1	Dans la vue Aperçu interactif ou Modèle de présentation de Report Builder (inclus dans Reports Developer), cliquez deux fois sur l'objet graphique pour afficher sa Palette de propriétés.

2	Sous le noeud Lien graphique, définissez la destination Hyperlien graphique à un identificateur de l'objet graphique.


Dimensionnement d'affichages pour applications de conteneur OLE

Pour dimensionner un affichage pour une application de conteneur OLE :

1	Faites passer les objets de votre affichage dans l'angle supérieur gauche de l'Editeur de présentation, en laissant suffisamment de blanc pour que l'affichage soit lisible.

2	Choisissez Affichage [image] Options d'affichage [image] Présentation pour afficher la boîte de dialogue Paramètres de présentation.

3	Entrez la taille (horizontale et verticale) de la présentation.

4	Sélectionnez OK pour accepter la taille de la présentation et fermer la boîte de dialogue.

La taille sera limitée aux dimensions que vous avez définies. Assurez-vous que la région que vous désignez dans votre application conteneur OLE est suffisante pour la taille de l'affichage.

Lorsque vous incorporez un affichage Graphics Builder dans une application de conteneur OLE, vous incorporez en fait une image de l'affichage. Comme les applications de serveur OLE n'utilisent pas le même système de définition graphique que Graphics Builder, elles ne peuvent pas mettre l'image d'un affichage Graphics Builder à l'échelle de la région définie.


Intégration d'un affichage dans une application de conteneur OLE

Pour intégrer un affichage dans une application de conteneur OLE :

1	Créez l'affichage dans Graphics Builder.

2	Dessinez une zone graphique dans votre application de conteneur OLE.

3	Définissez les propriétés de l'affichage inclus.

Pour savoir comment inclure un objet de Serveur OLE, reportez-vous à la documentation concernant l'application du conteneur OLE.


A propos de l'export d'affichages sous forme d'images

Vous pouvez exporter des objets Graphics Builder (isolés ou groupés) dans un certain nombre de formats d'image dont GIF, JPEG, BMP, TIFF et PICT. Pour exporter des objets sous la forme d'images, vous avez le choix entre trois possibilités :

•	utiliser l'option de menu Export d'image de Graphics Builder lorsque vous exportez des images statiques d'affichage, destinées à être utilisées dans des pages Web, des documents Word, des présentations, etc.,

•	utiliser la procédure interne PL/SQL OG_EXPORT_IMAGE PL/SQL, lorsque vous exportez des affichages interactifs, destinés à être utilisés dans des applications Web,

•	utiliser la ligne de commande de Graphics Builder lorsque vous générez en mode batch des affichages provenant de scripts de shell.


Export d'une image à l'aide de l'option de menu Exporter image

Pour exporter une image à l'aide de l'option de menu Exporter image :

1	Sélectionnez l'objet isolé ou l'objet de groupe que vous voulez exporter, soit en sélectionnant cet objet dans l'Editeur de présentation, soit en le sélectionnant dans le Navigateur d'objet.

2	Choisissez Editer [image] Exporter [image] Image pour afficher la boîte de dialogue Export d'image.

3	Sélectionnez le bouton d'option Base de données ou Fichier pour indiquer si vous voulez exporter votre image dans un fichier ou une base de données. Si vous l'exportez dans un fichier, entrez le chemin d'accès au fichier devant recevoir l'image, ou sélectionnez Parcourir pour sélectionner un fichier

4	Dans la liste déroulante Format, sélectionnez le format d'image du fichier d'export.

5	Dans la liste déroulante Type de données, sélectionnez le type de données de l'image.

6	Dans la liste déroulante Compression, Graphics Builder indique les types de compression acceptables pour le type de format d'image que vous avez sélectionné dans la fenêtre déroulante Format. Acceptez le type de compression par défaut indiqué par Graphics Builder ou sélectionnez-en un dans la fenêtre déroulante. Bien que le type de compression par défaut de certains formats d'image soit "aucun", vous devez indiquer un type de format proposé par la fenêtre déroulante si vous exportez un objet qui n'est pas une image, ou un groupe d'objets. Pour plus d'informations sur l'indication de la compression de chaque type de format, reportez-vous à PL/SQL Built-in Reference.

7	Si vous exportez en format JPEG, sélectionnez une spécification de qualité dans la fenêtre déroulante Qualité.

8	Sélectionnez OK.


Export d'une image à l'aide de PL/SQL

  Exemple

Pour exporter une image à l'aide de PL/SQL :

  Utilisez la procédure interne OG_EXPORT_IMAGE.


Exemple :  og_export_image

 /* Pour exporter un affichage complexe sous la forme d'un fichier GIF,
**en vue de sa publication dans une page Web : la procédure ci-dessous
**exporte l'affichage ouvert sous la forme de l'image
**"test.gif."
*/

PROCEDURE
BEGIN
   og_export_image('c:\test.gif', OG_FILESYSTEM,
OG_GIF_IFORMAT,og_root_object,
OG_LZWHDIFF_ICOMPRESSION);
END


Export d'une image à l'aide de la ligne de commande Graphics Builder

  Exemple

Pour exporter une image à l'aide de la ligne de commande Graphics Builder :

  Exécutez l'affichage à exporter sous la forme d'une image en utilisant G30Run, et indiquez le nom de l'image comme argument du paramètre d'export d'image.


Exemple : Export d'une image à l'aide de la ligne de commande Graphics Builder

 /*Cet exemple fournit un exemple d'argument de ligne de commande d'export
**vers image. Il exécute l'affichage test.ogd et l'exporte
**dans l'image "test.gif."
*/

G30run openfile=C:\test.ogd userid=scott/tiger exportimage=C:\test.gif
Quit=yes


A propos du package TOOL_INT

  Rubriques connexes

Les conditions préalables à l'appel d'autres produits Oracle à partir d'un affichage de Graphics Builder sont similaire à celles de l'affichage à partir d'un autre produit. Cependant, au lieu d'utiliser, par exemple, les procédures en package que Form Builder fournit dans la bibliothèque OG.PLL, vous utilisez le package intégré TOOL_INT.

Avec ce package, vous pouvez transmettre des informations à un autre produit et appeler cet autre produit à partir de votre affichage.


A propos de la communication synchrone

Lorsque Graphics Builder appelle un autre produit en mode synchrone, l'exécution de l'affichage Graphics Builder est suspendue jusqu'à la fin de l'exécution du produit appelé.

Pour transmettre des données à un autre produit, vous devez appeler ce produit en mode synchrone,

pour les raisons suivantes :

•	l'utilisateur doit entrer des valeurs dans Form Builder avant de poursuivre,

•	la transmission de données d'interrogation à Report Builder (inclus dans Reports Developer) et l'exécution d'un état en fonction des données de cette interrogation sont obligatoires.


A propos de la communication asynchrone

Lorsque Graphics Builder appelle un autre produit en mode asynchrone, l'exécution de l'affichage Graphics Builder se poursuit normalement, à la suite de l'appel de la procédure PL/SQL qui appelle l'autre produit. Graphics Builder et le produit appelé s'exécutent donc simultanément.

Vous ne pouvez pas transmettre des données à un autre produit si vous l'appelez en mode asynchrone.

Vouz pouvez vouloir appeler un autre produit en utilisant cette procédure pour :

•	Générer un état Report Builder sur une autre unité, une imprimante par exemple.

•	Pour permettre à l'utilisateur de visualiser un document Oracle Book pendant l'exécution de l'affichage.

Si vous voulez transmettre un paramètre de données de Graphics Builder à un autre produit, vous devez appeler ce produit en mode de communication synchrone.


A propos des modes d'exécution

Graphics Builder peut appeler un autre produit Oracle selon deux modes d'exécution :

•	runtime

•	batch

Le comportement, dans chacun de ces modes, est fonction du produit appelé par Graphics Builder. En outre, certains produits Oracle peuvent ne pas accepter un mode d'exécution particulier. Pour plus d'informations, reportez-vous à la documentation sur le produit que vous voulez appeler.


Transfert d'informations à d'autres produits
Transmission d'informations à d'autres produits

  Exemples

Pour transmettre des informations à d'autres produits :

  Utilisez des paramètres de texte et de données, comme décrit dans Echange de données entre l'application Forms et l'affichage.


Exemple : Transmission d'informations de Graphics Builder à d'autres produits

Un affichage Graphics Builder doit appeller Report Builder (inclus dans Reports Developer) avec les paramètres suivants :

Nom	Valeur

USERID	scott/tiger
DESTYPE	printer
COPIES	2
my_param	67
En outre, vous voulez que l'état de Report Builder soit fondé sur les données fournies par Graphics Builder. Si l'interrogation définie dans votre état s'appelle 'Q_1' et celle définie dans votre affichage 'query0'.

La procédure ci-dessous crée une liste de paramètres, appelée `my_plist', à laquelle elle ajoute les paramètres ci-dessus :

PROCEDURE create_plist IS
   the_list   tool_int.paramlist;

BEGIN
   the_list:=TOOL_INT.CREATE_PARAMETER_LIST('my_plist');
   TOOL_INT.ADD_PARAMETER(the_list, 'userid',
         TOOL_INT.TEXT_PARAMETER, 'scott/tiger');
   TOOL_INT.ADD_PARAMETER(the_list, 'destype',
         TOOL_INT.TEXT_PARAMETER, 'printer');
   TOOL_INT.ADD_PARAMETER(the_list, 'copies',
         TOOL_INT.TEXT_PARAMETER, '2');
   TOOL_INT.ADD_PARAMETER(the_list, 'my_param',
         TOOL_INT.TEXT_PARAMETER, '67');
   TOOL_INT.ADD_PARAMETER(the_list, 'Q_1',
         TOOL_INT.DATA_PARAMETER, 'query0');
END;


 Partage d'une session de connexion

  Exemples

Pour partager une session de connexion :

  Transmettez les informations de connexion que vous avez fournies avec Graphics Builder à l'autre produit, sous la forme d'un paramètre. Lorsque vous appelez un autre produit à partir de Graphics Builder, vous pouvez alors partager votre session de connexion avec le produit appelé, ce qui peut être intéressant pour supprimer la boîte de dialogue de connexion.

Form Builder, Report Builder (inclus dans Reports Developer) et Oracle Book utilisent tous l'option d'exécutable USERID pour créer une connexion à une base de données. Graphics Builder stocke ses informations de connexion sous la forme de propriétés de l'application. Vous pouvez utiliser la fonction intégrée de propriété OG_GET_ATTR pour extraire ces informations, puis les inclure dans une liste de paramètres sous la forme d'un paramètre de texte.


Exemple :  Partage d'une session de connexion

La procédure ci-dessous explique comment transmettre une chaîne de connexion à la base de données distante de Graphics Builder à Report Builder (inclus dans Reports Developer).

PROCEDURE run_form IS
  rept_list  tool_int.paramlist;
  uname      VARCHAR2;
  pword      VARCHAR2;
  cnxn       VARCHAR2;
BEGIN
/*créer la liste des paramètres*/
  rept_list:=TOOL_INT.CREATE_PARAMETER_LIST('list1');

/*rechercher les informations de connexion OG*/
  uname:=OG_GET_AP_USERNAME;
  pword:=OG_GET_AP_PASSWORD;
  cnxn:=OG_GET_AP_CONNECTION;

/*ajouter les informations de connexion OG à la liste des paramètres*/
  TOOL_INT.ADD_PARAMETER (form_list, 'userid',
TOOL_INT.TEXT_PARAMETER, uname || '/' ||
pword || '@' || cnxn);
/*transmettre à Report Builder la liste des paramètres avec les informations de connexion*/
  TOOL_INT.RUN_PRODUCT(TOOL_INT.REPORTS, 'inventory.rpt',
TOOL_INT.ASYNCHRONOUS, TOOL_INT.RUNTIME, rept_list)
END;


Appel d'un autre produit à partir de Graphics Builder

Pour appeler un produit :

  Utilisez la procédure TOOL_INT.RUN_PRODUCT. Cette procédure demande les arguments suivants :

•	Le nom du produit que vous appelez.

•	L'application Forms, l'état ou le document du produit.

•	Le mode de communication dans lequel le produit doit être appelé.

•	Le mode de l'exécutable de produit à utiliser.

•	Le nom de la liste de paramètres à transmettre au produit.


Appel de Form Builder à partir de Graphics Builder

  Exemples

Pour appeler Form Builder à partir de Graphics Builder :

  Vous pouvez appeler Form Builder à partir de Graphics Builder pour afficher une application Forms contenant des données d'interrogation provenant de l'affichage. N'oubliez pas que lorsque vous transmettez des données d'un produit à un autre, vous devez appeler le produit en mode synchrone.


Exemple : Appel de Form Builder à partir de Graphics Builder

La procédure ci-dessous appelle une application runtime Form Builder et lui fournit les données d'interrogation provenant de l'affichage.

PROCEDURE open_form (the_form IN VARCHAR2) IS
  form_list  tool_int.paramlist;
  uname      VARCHAR2;
  pword      VARCHAR2;
  cnxn       VARCHAR2;
BEGIN
/*créer la liste de paramètres*/
  form_list:=TOOL_INT.CREATE_PARAMETER_LIST('list2');
  uname:=OG_GET_AP_USERNAME;
  pword:=OG_GET_AP_PASSWORD;
  cnxn:=OG_GET_AP_CONNECTION;

/*Ajouter un paramètre à la liste de paramètres*/
  TOOL_INT.ADD_PARAMETER (form_list, 'userid',
TOOL_INT.TEXT_PARAMETER, uname || '/' ||
pword || '@' || cnxn);

/*Transmettre à Form Builder la liste de paramètres*/
  TOOL_INT.RUN_PRODUCT(TOOL_INT.FORMS, 'the_form',
TOOL_INT.ASYNCHRONOUS, TOOL_INT.RUNTIME, form_list);
END;


Appel de Report Builder à partir de Graphics Builder
Appel de Report Builder (inclus dans Reports Developer) à partir de Graphics Builder

  Exemples

Pour appler Report Builder à partir de Graphics Builder:

  Définissez un déclencheur qui appelle Report Builder en mode batch et imprime un état prédéfini. Vous pouvez également appeler Report Builder runtime pour afficher un état.


Exemple : Appel de Report Builder à partir de Graphics Builder

L'exemple ci-dessous comporte une procédure qui crée une liste de paramètres à transmettre à Report Builder (inclus dans Reports Developer), puis appelle Report Builder pour exécuter l'état inventory.rep. En outre, la procédure comporte le paramètre de texte d'argument d'exécutable USERID pour supprimer la boîte de dialogue de connexion de Report Builder.

PROCEDURE print_inv_rep IS
  rep_list  tool_int.paramlist;
BEGIN
/*créer une liste de paramètres*/
  rep_list:=TOOL_INT.CREATE_PARAMETER_LIST('list2');

/*ajouter l'option d'exécutable USERID à la liste*/
  TOOL_INT.ADD_PARAMETER (rep_list, 'userid',
TOOL_INT.TEXT_PARAMETER, 'scott/tiger');

/*ajouter le paramètre de donnée d'interrogation à la lite*/
  TOOL_INT.ADD_PARAMETER (rep_list, 'Q_inv',
TOOL_INT.DATA_PARAMETER, 'query_inv');

/*appeler le mode Batch de Report Builder pour imprimer l'état*/
  TOOL_INT.RUN_PRODUCT(TOOL_INT.REPORTS, 'inventory.rep',
TOOL_INT.SYNCHRONOUS, TOOL_INT.BATCH,
TOOL_INT.FILESYSTEM, rep_list);
END;

L'exécution de l'affichage Graphics Builder est suspendue jusqu'à ce que Report Builder ait fini d'imprimer l'état.

Pour plus d'informations sur les options d'exécutable de Report Builder, reportez-vous à votre documentation Report Builder.


Appel de Oracle Book à partir de Graphics Builder

  Exemples

Pour appeler Oracle Book à partir de Graphics Builder:

  Vous pouvez associer une procédure qui appelle une instance de Oracle Book runtime par action sur un bouton de votre affichage. Si votre document Oracle Book comporte des cibles hypertexte, vous pouvez indiquer que le document soit ouvert à un emplacement cible spécifique, grâce à l'argument d'exécutable TARGET.


Exemple : Appel de Oracle Book à partir de Graphics Builder

La procédure bouton ci-dessous ouvre un document Oracle Book appelé help.obd au nom cible "start" :

PROCEDURE OGBUTTONPROC0(buttonobj IN og_object, hitobj
 IN og_object, win IN og_window, eventinfo IN og_event)IS
  book_list  tool_int.paramlist;
BEGIN
/*créer une liste de paramètres*/
  book_list:=TOOL_INT.CREATE_PARAMETER_LIST('list1');

/*ajouter l'option d'exécutable de cible à la liste*/
  TOOL_INT.ADD_PARAMETER (book_list, 'target',
TOOL_INT.TEXT_PARAMETER, 'start');

/*ouvrir Oracle Book au nom cible indiqué ci-dessus*/
  TOOL_INT.RUN_PRODUCT(TOOL_INT.BOOK, 'help.obd',
TOOL_INT.ASYNCHRONOUS, TOOL_INT.RUNTIME,
TOOL_INT.FILESYSTEM, book_list);
END;

Pour connaître les autres arguments d'exécutable que vous pouvez transmettre à Oracle Book runtime lorsque vous l'appelez, reportez-vous à votre documentation Oracle Book.


Enregistrement d'affichages dans le système de fichiers

Pour enregistrer un affichage dans le système de fichiers :

1	Choisissez Fichier [image] Enregistrer sous [image] Système de fichiers pour afficher la boîte de dialogue de fichiers de votre système.

2	Donnez à l'affichage un nom de fichier unique.

Vous pouvez conserver le nom par défaut de Graphics Builder ou le remplacer par un nom unique.

3	Acceptez la boîte de dialogue pour enregistrer l'affichage.

Le contenu de l'Editeur de présentation et des autres fenêtres de l'affichage est enregistré tel que vous l'avez quitté.


Enregistrement d'affichages dans la base de données

Pour enregistrer un affichage dans la base de données :

1	Choisissez Fichier [image] Enregistrer sous [image] Base de données pour afficher la boîte de dialogue correspondante.

2	Entrez dans le champ Nom un nom d'affichage unique.

3	Sélectionnez Enregistrer pour enregistrer l'affichage.

Le contenu de l'Editeur de présentation et des autres fenêtres de l'affichage est enregistré tel que vous l'avez quitté

Vous devez être connecté à la base de données et avoir les autorisations appropriées pour enregistrer des affichages dans la base de données. En outre, les tables Graphics Builder doivent être configurées dans votre base de données. Pour plus d'informations, interrogez votre administrateur de bases de données.


Annulation des modifications apportées aux affichages

Pour annuler les modifications apportées à un affichage :

 Choisissez Fichier [image] Rétablir pour annuler les dernières modifications.

Vous revenez à la dernière version enregistrée de votre affichage.


Changement de noms d'affichage dans le système de fichiers

Pour changer le nom d'un affichage dans le système de fichiers :

 Utilisez la commande de votre système d'exploitation pour renommer un affichage stocké sous la forme d'un fichier. Vous devez avoir pour cela les autorisations appropriées.

Pour la marche à suivre pour renommer vos fichiers, reportez-vous à la documentation de votre système d'exploitation.


Changement de noms d'affichage dans la base de données

Pour renommer un affichage stocké dans la base de données :

1	Choisissez Fichier [image] Administration [image] Renommer [image] Afficher pour afficher la boîte de dialogue correspondante.

2	Indiquez l'ancien nom et le nouveau nom de l'affichage.

3	Sélectionnez Renommer pour appliquer le nouveau nom.

Vous pouvez renommer un affichage stocké dans la base de données si vous l'avez créé ou si vous avez l'autorisation d'y accéder.


A propos du changement de noms, de la suppression et de l'accès à des modèles de graphiques exportés
A propos du changement de noms, de la suppression de modèles de graphique exportés et de l'autorisation d'accès à ces modèles

Pour renommer et supprimer des modèles de graphique exportés et pour autoriser l'accès à ces modèles :

 La marche à suivre est la même que pour les affichages.


Autorisation et révocation de droits d'accès aux affichages du système de fichiers

Pour autoriser et retirer l'accès à un affichage du système de fichiers :

 Certains systèmes d'exploitation permettent aux utilisateurs d'accorder des autorisations de lecture, d'écriture et d'exécution de fichiers individuels. Pour plus d'informations sur la façon de définir ce type d'autorisation sur votre système d'exploitation, reportez-vous à la documentation de votre système d'exploitation ou interrogez votre administrateur système.


Autorisation et révocation de droits d'accès aux affichages dans la base de données

Pour autoriser et retirer l'accès à un affichage stocké dans la base de données :

1	Choisissez Fichier [image] Administration [image] Accès [image] Afficher pour afficher la boîte de dialogue correspondante.

Cette boîte de dialogue contient la liste de tous les affichages stockés dans la base de données et auxquels vous avez accès.

2	Sélectionnez un affichage dans la liste.

3	Sélectionnez OK pour afficher la boîte de dialogue Accès au module.

Cette boîte de dialogue contient la liste des utilisateurs qui ont accès à l'affichage.

4	Entrez dans le champ Utilisateur l'ID utilisateur de base de données de la personne à qui vous voulez accorder l'autorisation d'accès.

5	Sélectionnez Ajouter pour ajouter son nom à la liste Accès.

6	Sélectionnez le nom utilisateur de la personne dont vous voulez révoquer l'autorisation d'accès dans la liste Accès.

7	Sélectionnez Supprimer pour supprimer le nom de l'utilisateur de la liste Accès

8	Sélectionnez OK pour accepter vos modifications et fermer la boîte de dialogue Accès au module.

Les autorisations d'accès sont mises à jour pour votre affichage.

Vous pouvez accorder à un autre utilisateur une autorisation d'accès (lecture/écriture/exécution) à un affichage que vous avez créé et stocké dans la base de données. Cependant, l'utilisateur doit également avoir accès aux tables de la base de données de Graphics Builder. Pour plus d'informations, interrogez votre administrateur de bases de données.


Gestion des sons externes

Pour gérer les sons externes :

 La marche à suivre pour renommer et supprimer des sons et pour accorder des autorisations d'accès à ces sons, dans le système de fichiers ou dans une base de données, est la même que pour les affichages.

Les sons que vous avez créés dans Builder ou importés dans l'affichage sont considérés comme internes à l'affichage. Ceux qui sont stockés dans le système de fichiers ou la base de données sont considérés comme externes à l'affichage. L'emplacement du son détermine les méthodes à utiliser pour accorder ou révoquer des autorisations d'accès, renommer ou supprimer un son.


Gestion des dessins

Pour gérer des dessins :

 La marche à suivre pour renommer et supprimer des dessins et pour accorder des autorisations d'accès à ces dessins est la même que pour les affichages.


Export de dessins

Pour exporter un dessin :

1	Si vous exportez une image, sélectionnez-la. Si vous exportez la totalité de l'affichage sous la forme d'un dessin, Graphics Builder incorpore automatiquement tous les dessins dans les couches visibles de l'affichage.

2	Choisissez Editer [image] Exporter, puis sélectionnez le type de dessin à exporter.

Par exemple, pour exporter les objets que vous avez dessinés dans Graphics Builder, choisissez Dessin. La boîte de dialogue d'exploitation s'affiche.

3	Indiquez les options de votre choix, comme le format de fichier dans lequel exporter le dessin, le nom et l'emplacement du fichier, etc.

4	Sélectionnez OK pour confirmer les informations et fermer la boîte de dialogue.

Le dessin est exporté à l'emplacement que vous avez indiqué.

Vous pouvez exporter une image d'un affichage, ou toutes les couches visibles de l'affichage sous forme d'un dessin. Vous pouvez exporter des dessins dans le système de fichier ou dans une base de données. Si vous avez groupé des objets d'un affichage, ces objets ne conserveront pas leurs propriétés groupées une fois qu'ils seront exportés dans un fichier CGM.


Export de dessins à l'aide de PL/SQL

  Rubriques connexes

Pour exporter des dessins à l'aide de PL/SQL :

 Utilisez la procédure interne OG_EXPORT_DRAWING.

Exemple d'export du contenu d'une couche dans un fichier CGM :

PROCEDURE export_the_drawing IS
   the_layer   OG_OBJECT;
BEGIN
   the_layer:=OG_GET_LAYER('couche0');
   OG_EXPORT_DRAWING('mon_dessin', OG_FILESYSTEM,
     OG_CGM16_DFORMAT, the_layer);
END;


Gestion des palettes de couleurs

Pour gérer les palettes de couleurs :

 La marche à suivre pour renommer et supprimer des palettes de couleurs et pour accorder des autorisations d'accès à ces palettes est la même que pour les affichages. De même, les procédures d'importation et d'exportation de palettes de couleurs sont les mêmes que celles applicables aux dessins.


Suppression d'affichages dans le Navigateur d'objet

Pour supprimer un affichage dans le Navigateur d'objet :

1	Sélectionnez l'objet d'affichage dans le Navigateur d'objet.

2	Sélectionnez Supprimer ou choisissez Navigateur [image] Supprimer.

Un message d'alerte vous demande de confirmer la suppression.

3	Sélectionnez Oui pour confirmer.

L'affichage est supprimé.

Vous pouvez supprimer un affichage ouvert dans le Navigateur d'objet, quel que soit l'endroit où il est stocké. Vous devez avoir les autorisations d'accès appropriées pour supprimer un affichage. Si vous n'avez pas les autorisations d'écriture dans un fichier ou d'accès à une base de données, vous ne pouvez pas supprimer l'affichage.


Suppression d'affichages du système de fichiers

Pour supprimer des affichages du système de fichiers :

 Vous pouvez utiliser les commandes de votre système d'exploitation pour supprimer un affichage stocké sous la forme d'un fichier. Pour supprimer l'affichage, vous devez avoir les autorisations d'accès au fichier correspondant.

Pour savoir comment supprimer des fichiers, reportez-vous à la documentation de votre système d'exploitation.


Suppression d'affichages de la base de la données

Pour supprimer un affichage stocké dans la base de données :

1	Choisissez Fichier [image] Administration [image] Supprimer [image] Afficher pour afficher la boîte de dialogue de suppression de la base de données.

2	Indiquez le nom de l'affichage.

3	Sélectionnez Supprimer pour supprimer l'affichage de la base de données.

Vous pouvez supprimer un affichage stocké dans la base de données si vous l'avez créé ou si vous avez l'autorisation d'y accéder.


A propos des propriétés de graphique

Les propriétés de graphique définissent les options du graphique dans son ensemble, et notamment le modèle de graphique et l'interrogation qui lui sont associés. Les propriétés de graphique, accessibles par la fenêtre de propriété Graphique sont organisées de la manière suivante :

Graphique

Données

Catégories

Valeurs

PL/SQL

En général, vous définissez des propriétés de graphique en sélectionnant le graphique, en ouvrant sa feuille de propriété et en choisissant les options que vous voulez définir. Vous pouvez également définir la plupart de ces options par programme, en utilisant PL/SQL.


Comprend le nom, le titre, le type et le modèle du graphique.


Comprend les propriétés liées à l'interrogation, comme la fonction de filtre d'interrogation et la plage de données à tracer.


Comprend les catégories de graphique et les sous-catégories à tracer dans le graphique. Les données (indépendantes) des catégories sont tracées à des intervalles fixes. Les données des catégories ne sont pas considérées comme étant liées mathématiquement et sont généralement tracées le long de ce que l'on appelle l'axe discret.


Comprend les valeurs de graphique et les modèles de champ associés. Les données (dépendantes) des valeurs commencent généralement à une valeur et continuent jusqu'à une autre valeur. Les données de valeur sont considérées comme étant mathématiquement liées et sont généralement tracées le long de ce que l'on appelle l'axe continu.


Comprend les événements de souris et les procédures associées pour le graphique.


Lecture et modification des propriétés de graphique par l'Editeur de présentation

Pour accéder aux propriétés d'un graphique par l'Editeur de présentation :

  Cliquez deux fois sur le graphique dans l'Editeur de présentation, ou

  Sélectionnez le graphique dans l'Editeur de présentation, puis choisissez la commande Propriétés dans le menu instantané.

Vous pouvez indiquer une interrogation différente et un modèle de graphique à associer à un graphique, ainsi que d'autres options applicables au graphique dans son ensemble. Par exemple, vous pouvez indiquer le nom d'un graphique pour pouvoir y faire référence par programme ou associer un graphique à une procédure bouton.

Pour modifier les propriétés d'un graphique par l'Editeur de présentation :

1	Cliquez deux fois sur le graphique pour afficher la fenêtre de propriété Graphique.

2	Indiquez les options de votre choix.

3	Sélectionnez OK pour appliquer les modifications et fermer la fenêtre de propriété Graphique, ou Appliquer pour appliquer vos modifications au graphique sans fermer la fenêtre de propriété Graphique.


Lecture et modification des propriétés de graphique par le Navigateur d'objet

Pour accéder aux propriétés d'un graphique par le Navigateur d'objet :

  Cliquez deux fois sur l'objet graphique dans le Navigateur d'objet, ou

  Sélectionnez l'objet graphique dans le Navigateur d'objet, puis choisissez la commande Propriétés dans le menu instantané, ou

  Sélectionnez l'objet graphique dans le Navigateur d'objet et choisissez Outils [image] Propriétés.

Vous pouvez indiquer une interrogation différente et un modèle de graphique à associer à un graphique, ainsi que d'autres options applicables au graphique dans son ensemble. Par exemple, vous pouvez indiquer le nom d'un graphique pour pouvoir y faire référence par programmation ou associer un graphique à une procédure bouton.

Pour modifier les propriétés d'un graphique par le Navigateur d'objet :

1	Cliquez deux fois sur le graphique pour afficher la fenêtre de propriété Graphique.

2	Indiquez les options de votre choix.

3	Cliquez sur OK pour appliquer les modifications et fermer la fenêtre de propriété Graphique, ou cliquez sur Appliquer pour appliquer vos modifications au graphique sans fermer la fenêtre de propriété Graphique.


Définition des valeurs de ligne de base

Pour définir une valeur de ligne de base :

1	Sélectionnez le graphique ou un objet du graphique, son titre par exemple.

2	Choisissez la commande Cadre dans le menu instantané ou Graphique [image] Cadre pour afficher la fenêtre de propriété Cadre.

3	Sélectionnez l'onglet Cadre d'axe pour afficher la page de propriété Cadre d'axe.

4	Définissez la valeur de la ligne de base de votre choix.

5	Sélectionnez OK pour appliquer les modifications au graphique.


Définition des propriétés de barre et de colonne

Pour définir les propriétés de barre et de colonne :

1	Sélectionnez le graphique ou l'un de ses objets.

2	Choisissez la commande Cadre dans le menu instantané ou Graphique [image] Cadre pour afficher la fenêtre de propriété Cadre.

3	Si nécessaire, sélectionnez l'onglet Cadre pour afficher la page de propriété Cadre.

4	Choisissez l'une des options de profondeur, taille de l'ombre ou direction de l'ombre.

5	Sélectionnez OK pour appliquer la modification et fermer la fenêtre de propriété Cadre.

L'affichage de cette modification dans le cadre du graphique ou le modèle de champ dépend du type de graphique que vous avez sélectionné.


Définition des propriétés de légende

Pour définir les propriétés de légende :

1	Sélectionnez le graphique ou un objet du graphique, son titre par exemple.

2	Choisissez la commande Cadre dans le menu instantané ou Graphique [image] Cadre pour afficher la fenêtre de propriété Cadre.

3	Indiquez les options de votre choix.

4	Sélectionnez OK pour appliquer les modifications au cadre et fermer la fenêtre de propriété Cadre.


Déplacement de la légende

Pour déplacer la légende :

1	Sélectionnez le cadre de la légende et faites-le glisser à son nouvel emplacement.

2	Si nécessaire, choisissez Mettre à jour dans le menu instantané ou Graphique [image] Mettre à jour graphique pour mettre à jour la présentation du graphique.


A propos de l'ajout, de l'édition et de la suppression de lignes de référence

Vous pouvez ajouter au cadre du graphique une ligne de référence qui représente une valeur significative, après quoi, vous pouvez éditer les propriétés de cette ligne de référence ou la supprimer du graphique. Vous pouvez la déplacer en éditant sa valeur dans la fenêtre de propriété Ligne de référence.


Ajout de lignes de référence

Pour ajouter une ligne de référence :

1	Sélectionnez le graphique ou l'un de ses objets.

2	Choisissez la commande Lignes de référence dans le menu instantané ou Graphique [image] Lignes de référence pour afficher la fenêtre de propriété Ligne de référence.

S'il n'existe pas de ligne de référence, un message d'alerte vous demande si vous voulez en créer une. Si vous sélectionnez Oui, une nouvelle ligne de référence est automatiquement créée dans la fenêtre de propriété Ligne de référence.

3	Sélectionnez Nouveau dans la fenêtre de propriété pour créer une nouvelle ligne de référence.

4	Acceptez le libellé et la valeur de la légende par défaut ou modifiez leurs paramètres.

5	Sélectionnez OK pour tracer la nouvelle ligne de référence sur le cadre du graphique et fermer la fenêtre de propriété Ligne de référence.


Edition des propriétés de ligne de référence

Pour éditer les propriétés d'une ligne de référence :

1	Sélectionnez le graphique ou l'un de ses objets.

2	Choisissez la commande Lignes de référence dans le menu instantané ou choisissez Graphique [image] Lignes de référence pour afficher la fenêtre de propriété Ligne de référence.

3	Dans la liste déroulante Ligne de référence, choisissez la ligne dont vous voulez éditer les propriétés.

4	Indiquez les options de votre choix.

5	Sélectionnez OK pour appliquer les modifications à la ligne de référence et fermer la fenêtre de propriété Ligne de référence.


Suppression de lignes de référence

Pour supprimer une ligne de référence :

1	Sélectionnez le graphique ou l'un de ses objets.

2	Choisissez la commande Lignes de référence dans le menu instantané ou choisissez Graphique [image] Lignes de référence pour afficher la fenêtre de propriété Ligne de référence.

3	Dans la liste déroulante Ligne de référence, choisissez la ligne que vous voulez supprimer.

4	Sélectionnez Supprimer.

Un message d'alerte vous demande de confirmer la suppression.

5	Sélectionnez Oui pour confirmer.

6	Sélectionnez OK pour appliquer les modifications et fermer la fenêtre de propriété Ligne de référence.


A propos de l'indication des propriétés de cadre d'axe

Vous pouvez modifier l'aspect des graphiques à axes en utilisant la fenêtre de propriété Cadre. Les propriétés que vous pouvez modifier sont les suivantes : valeurs de ligne de base, largeur de catégorie, profondeur, taille de l'ombre et direction de l'ombre. Vous pouvez indiquer la profondeur, la taille de l'ombre et sa direction. En outre, vous pouvez utiliser la fenêtre de propriété Cadre pour masquer ou afficher la légende. Vous pouvez également demander que la légende soit masquée ou répartie sur plusieurs colonnes.


A propos de l'indication des propriétés d'axe

Pour les graphiques à axes, les propriétés d'axe comprennent des options propres au type d'axe que vous sélectionnez : discret, continu ou de date.

En outre, vous pouvez indiquer pour un axe des libellés personnalisés et définir les propriétés des repères de graduation et des étiquettes de graduation utilisés dans le graphique, ou indiquer des paramètres de grille.


Indication des propriétés d'axe discret, continu ou de date

Pour indiquer les propriétés d'axe discret, continu et ou date :

1	Sélectionnez le graphique ou l'un des ses objets, un axe par exemple.

2	Choisissez la commande Axe dans le menu instantané, ou Graphique [image] Axes pour afficher la fenêtre de propriété Axe.

3	Dans la liste déroulante Axe, choisissez un axe (par exemple, X, Y1) dont vous voulez modifier les propriétés.

4	Indiquez les options de votre choix, type de données, direction de l'axe, paramètres des repères de graduation et des étiquettes de graduation, par exemple.

Sélectionnez les onglets affichés en haut de la fenêtre de propriété pour passer d'une page de propriété à l'autre.

5	Sélectionnez OK pour appliquer les modifications à l'axe sélectionné.


A propos de la mise à jour des graphiques

Lorsque les données de la fenêtre de propriété Interrogation changent ou que vous avez modifié les éléments ou l'une des fonctions d'un graphique, vous devez mettre le graphique à jour. Procédez de l'une des trois façons suivantes :

•	automatiquement,

•	manuellement,

•	à l'aide de PL/SQL.

Vous pouvez utiliser PL/SQL pour mettre des graphiques à jour en indiquant des déclencheurs d'horloge qui seront exécutés aux intervalles indiqués.


A propos des graphiques dynamiques et des graphiques en forme de dessin

  Rubriques connexes

Un graphique dynamique est un graphique lié à une source de données. Au départ, tous les graphiques sont dynamiques, car Graphics Builder doit avoir des données pour les dessiner. Tout graphique dynamique peut être mis à jour lors de la réexécution ou de la modification de son modèle. Lorsque vous mettez un graphique à jour, Graphics Builder lit le contenu de la page de propriété Données et de l'Editeur de modèle de graphique et redessine le graphique en fonction des nouvelles informations.

Vous pouvez également transformer le graphique en un objet statique.


A propos du changement de nom des graphiques

  Rubriques connexes

Graphics Builder vous permet de changer le nom d'un graphique en deux endroits :

•	dans le Navigateur d'objet,

•	dans la fenêtre de propriété Graphique.

Si vous renommez un graphique référencé dans une unité de programme PL/SQL, vous devez modifier ces références en fonction du nouveau nom.


A propos de la suppression de graphiques

  Rubriques connexes

Si vous voulez supprimer totalement un graphique que vous avez créé, et non l'entrer dans le presse-papiers du système, vous pouvez le faire dans :

•	le Navigateur d'objet,

•	le menu.

Si vous supprimez un graphique référencé dans des unités de programme PL/SQL, vous devez modifier ces références en conséquence.

Notez également que la suppression d'un graphique ne supprime pas l'interrogation utilisée pour le créer, ni les modèles de graphique utilisés pour ce graphique. Vous pouvez les supprimer séparément ou les réutiliser.


Mise à jour automatique de graphiques

Pour mettre automatiquement à jour vos graphiques :

  Dans la page de propriété Données de la fenêtre de propriété Graphique, activez Mettre à jour le graphique sur exécution de l'interrogation en sélectionnant sa case à cocher.

Votre graphique est mis à jour chaque fois que l'interrogation est exécutée.


Mise à jour manuelle de graphiques

Pour mettre manuellement à jour vos graphiques :

1	Sélectionnez le graphique que vous voulez mettre à jour.

2	Choisissez Mettre à jour dans le menu instantané ou Graphique [image] Mettre à jour graphique.

Graphics Builder redessine le graphique en fonction des dernières informations.


Mise à jour de graphiques à l'aide de PL/SQL

Pour mettre à jour des graphiques en utilisant PL/SQL :

  Utilisez un déclencheur d'horloge.

La procédure ci-dessous illustre l'utilisation d'un déclencheur d'horloge :

/*Affecter la procédure ci-dessous à un
**déclencheur d'horloge qui sera exécuté à l'intervalle
**indiqué. Cet exemple met à jour le graphique indiqué en fonction
**des nouveaux résultats de l'interrogation
**ou des nouvelles propriétés appliquées
**aux éléments du graphique.
*/

PROCEDURE my_timer IS
   my_query   og_query;
   my_chart   og_object;
BEGIN
   my_query:=og_get_query('emp_query');
   my_chart:=og_get_object('emp_chart');
   og_execute_query(my_query);
   og_update_chart(my_chart, OG_ALL_CHUPDA);
END;


Conversion de graphiques en dessin

Pour convertir un graphique dynamique en un dessin statique :

1	Sélectionnez le graphique que vous voulez convertir en dessin.

2	Choisissez Graphique [image] Conversion vers dessin.

Graphics Builder convertit le graphique en un objet de groupe composé de formes que vous pouvez manipuler individuellement. En tant qu'objet de dessin, le graphique ne peut plus être mis à jour.


Changement de noms de graphique dans le Navigateur d'objet

Pour renommer un graphique dans le Navigateur d'objet :

1	Sélectionnez l'objet graphique que vous voulez renommer.

2	Faites passer le pointeur de la souris sur le nom du graphique.

Le curseur prend la forme d'un éditeur de texte.

3	Sélectionnez une fois le nom pour positionner le curseur et passer en mode Edition.

Si vous voulez remplacer la totalité du nom, sélectionnez le nom pour le mettre en évidence, puis entrez le nouveau nom.


Changement de noms de graphique dans la fenêtre de propriété Graphique

Pour renommer un graphique dans la page de propriété Graphique :

1	Ouvrez la fenêtre de propriété du graphique.

2	Editez le nom du graphique dans le champ Nom.

3	Sélectionnez OK pour appliquer le nouveau nom et fermer la fenêtre de propriété du graphique.


Suppression de graphiques dans le Navigateur d'objet

Pour supprimer un graphique dans le Navigateur d'objet :

1	Sélectionnez l'objet graphique dans le Navigateur.

2	Sélectionnez Supprimer ou choisissez Navigateur [image] Supprimer dans le menu.

Un message d'alerte vous demande de confirmer la suppression.

3	Sélectionnez Oui pour confirmer.


Suppression de graphiques à l'aide du menu

Pour supprimer un graphique en utilisant le menu :

1. 	Dans l'Editeur de présentation, sélectionnez le graphique à supprimer.

2. 	Choisissez Edition [image] Effacer.


A propos de la modification d'objets

  Rubriques connexes

La modification de la plupart des objets s'effectue dans leurs fenêtres de propriété. Vous pouvez accéder à la fenêtre de propriété ou à la boîte de dialogue de type d'objet de trois façons différentes :

•	dans le Navigateur d'objet, cliquez deux fois sur l'icône de l'objet à éditer, ou

•	sélectionnez l'objet et choisissez la commande Propriétés dans le menu instantané, ou

•	sélectionnez l'objet et choisissez Outils [image] Propriétés.

Le type d'objet que vous éditez détermine les événements qui se produiront et la façon dont vous devez procéder.


A propos de la sélection d'objets dans le Navigateur d'objet

Vous pouvez également sélectionner un seul ou plusieurs objets en indiquant leur nom de noeud dans le Navigateur d'objet, en fonction de l'opération que vous voulez effectuer sur les objets sélectionnés. La sélection d'un noeud de nom d'objet dans le navigateur d'objet sélectionne également l'objet dans l'Editeur de présentation.

La sélection d'objets dans le Navigateur d'objet peut être intéressante si vos objets sont très petits ou très proches et difficiles à sélectionner dans l'Editeur de présentation.

Si vous sélectionnez un objet qui est membre d'un groupe, le programme sélectionne l'objet de groupe qui se trouve au début de son arborescence de groupe. Pour sélectionner plusieurs objets, tout en maintenant enfoncée la touche Majuscules, cliquez sur chacun d'entre eux. Lorsque l'outil de sélection est actif, il suffit de sélectionner les objets et de les faire glisser. Pour redimensionner des objets, faites glisser leurs points de contrôle.


A propos des règles de portée

Pour la sélection d'objets, Graphics Builder applique certaines règles de portée, qui sont effectuées au moment de la sélection des objets. Ces règles sont les suivantes :

1	L'outil de sélection vous permet de sélectionner uniquement les objets qui appartiennent au même groupe que les objets sélectionnés. Pour sélectionner un objet d'un autre groupe - ou un objet qui ne fait partie d'aucun groupe - vous avez le choix entre deux possibilités :

Commencer par désélectionner tous les objets en sélectionnant une partie non occupée de la présentation, puis sélectionner l'autre objet de la manière habituelle.

Choisir l'un des éléments dans le sous-menu Réorganisation [image] Opérations sur des groupes pour ajouter un objet à un groupe existant.

2	Vous ne pouvez sélectionner plusieurs objets que s'ils appartiennent au même groupe (c'est-à-dire s'ils ont le même père immédiat).


Sélection d'objets isolés ou groupés

Pour sélectionner un objet isolé ou un objet d'un groupe :

1	Choisissez l'outil de sélection dans la palette d'outils.

2	Sélectionnez l'objet.

Vous pouvez également faire glisser une région autour de l'objet pour le sélectionner.

Pour sélectionner un objet isolé ou un objet de groupe alors que d'autres objets sont déjà sélectionnés :

1	Choisissez l'outil de sélection dans la palette d'outils.

2	Appuyez sur Maj et cliquez pour sélectionner l'objet.

Vous pouvez également maintenir la touche Maj enfoncée tout en faisant glisser une région autour de l'objet pour le sélectionner.

3	Répétez l'opération pour chaque objet à sélectionner.


Sélection de plusieurs objets

Pour sélectionner plusieurs objets :

1	Sélectionnez l'outil de sélection dans la palette d'outils.

2	Faites glisser une région autour des objets pour les sélectionner ou sélectionnez-les un à un en cliquant avec la souris tout en appuyant sur la touche Maj, après avoir sélectionné le premier objet.


Sélection d'objets isolés dans des objets de groupe

Pour sélectionner uniquement un objet dans un objet de groupe :

1	Choisissez l'outil de sélection dans la palette d'outils.

2	Sélectionnez l'objet de groupe.

Vous pouvez également faire glisser une région autour de l'objet de groupe pour le sélectionner.

3	Sélectionnez l'objet fils.

Lorsque vous utilisez l'outil de sélection pour sélectionner un objet faisant partie d'un groupe, vous sélectionnez le groupe de niveau le plus élevé auquel cet objet appartient.

Pour sélectionner un objet d'un groupe alors que d'autres objets du même groupe sont déjà sélectionnés :

1	Choisissez l'outil de sélection dans la palette d'outils.

2	Sélectionnez l'objet de groupe.

Vous pouvez également, tout en maintenant la touche Maj enfoncée, faire glisser une région autour de l'objet de groupe pour le sélectionner.

3	Sélectionnez un objet fils.

4	Tout en maintenant la touche Maj enfoncée, cliquez sur un second objet fils du groupe.

5	Répétez l'étape 4 pour chaque objet fils à sélectionner.

Vous ne pouvez sélectionner simultanément plusieurs objets que s'ils ont le même père.


Sélection de tous les objets

Pour sélectionner tous les objets de la présentation :

  Choisissez Edition [image] Sélectionner tout.

Tous les objets de la couche active sont sélectionnés.


Sélection d'objets dans le Navigateur d'objet

Chaque objet énuméré dans le Navigateur se compose de trois parties, de gauche à droite :

indicateur de sous-objet

icône de type

nom

Pour sélectionner un objet dans le Navigateur d'objet :

 Sélectionnez le nom ou l'icône de type d'objet dans le Navigateur d'objet.

Notez que la sélection d'un objet existant (par exemple, SAL_bars), dans le Navigateur d'objet sélectionne les objets correspondants dans l'Editeur de présentation.

Notez également que le nom de l'objet sélectionné apparaît dans la barre de titre de la fenêtre du Navigateur d'objet, pour que vous sachiez quel est l'objet sélectionné.

Pour sélectionner plusieurs objets dans le Navigateur, maintenez la touche Maj enfoncée tout en sélectionnant une icône de type d'objet.


Indicateur de sous-objet

Le signe plus (+) en évidence indique que vous pouvez développer cet objet pour afficher ses sous-objets. Inversement, un signe plus (+) inactif indique que l'objet n'a pas de sous-objet et ne peut pas être développé. Le signe moins indique que l'objet est déjà développé.


Icône de type

Indique le type d'objet : couche, graphique, élément de graphique, forme, etc.


Nom

Nom par défaut attribué par Graphics Builder, ou nom que vous avez personnalisé.


Désélection d'objets

Pour désélectionner des objets :

  Pour désélectionner tous les objets sélectionnés, sélectionnez une zone vierge de la présentation.

  Pour désélectionner l'un des objets sélectionnés, cliquez sur l'objet tout en maintenant la touche Maj enfoncée.


Déplacement d'objets isolés ou groupés

Pour déplacer un objet isolé ou un objet de groupe :

1	Sélectionnez l'objet que vous voulez déplacer.

2	Cliquez dans la boîte englobante de l'objet et faites-le glisser à son nouvel emplacement.

Pour conserver la position d'un objet par rapport à l'axe horizontal ou vertical, maintenez la touche Maj enfoncée tout en le faisant glisser horizontalement ou verticalement.

Vous pouvez également déplacer un objet pixel par pixel en utilisant les touches de déplacement du curseur.


Déplacement de plusieurs objets

Pour déplacer plusieurs objets :

1	Sélectionnez les objets que vous voulez déplacer.

2	Cliquez dans la boîte englobante d'un objet sélectionné et faites-le glisser à son nouvel emplacement. Tous les autres objets sélectionnés seront déplacés.


Réorganisation d'objets dans le Navigateur d'objet

Pour réorganiser un objet dans le Navigateur d'objet :

 Sélectionnez l'objet et faites-le glisser à son nouvel emplacement dans la hiérarchie des objets.

Cette opération ne modifie que "l'ordre" des objets dans la hiérarchie du Navigateur. Pour modifier l'emplacement physique de l'objet dans la présentation, vous devez déplacer l'objet dans l'Editeur de présentation.

Dans le Navigateur, les objets sont énumérés dans l'ordre dans lequel ils ont été créés.


Alignement d'objets

Pour aligner des objets :

1	Sélectionnez les objets que vous voulez aligner.

2	Choisissez Réorganisation [image] Aligner objets pour afficher la boîte de dialogue  Paramètres d'alignement.

3	Indiquez les paramètres d'alignement de votre choix : sur le bord supérieur ou inférieur, le côté droit, le côté gauche ou le centre. Vous pouvez également demander que les objets soient alignés les uns par rapport aux autres ou sur la grille.

4	Sélectionnez OK pour confirmer les paramètres d'alignement et aligner les objets.

Pour aligner des objets en utilisant les paramètres d'alignement en cours :

1	Sélectionnez les objets que vous voulez aligner.

2	Choisissez Réorganisation [image] Répéter alignement.

Les objets sont alignés en fonction des paramètres de la boîte de dialogue Paramètres d'alignement.

Les paramètres d'alignement que vous indiquez restent en vigueur jusqu'à ce qu'ils soient modifiés. Vous pouvez définir vos paramètres d'alignement une seule fois, puis les réutiliser aussi souvent que nécessaire.


Modification de l'ordre de la pile

Pour modifier l'ordre de la pile :

1	Sélectionnez les objets que vous voulez déplacer.

2	Choisissez le menu Réorganisation, puis effectuer une des opérations suivantes :

•	Pour faire passer un ou plusieurs objets devant l'objet qui se trouve directement au-dessus, choisissez Déplacement avant.

•	Pour faire passer un ou plusieurs objets derrière l'objet qui se trouve directement au-dessus, choisissez Déplacement arrière.

•	Pour faire passer un objet devant tous les autres, choisissez Passer au premier plan.

•	Pour faire passer un objet derrière tous les autres, choisissez Passer en arrière-plan.


Déplacement d'objets par programme

  Rubriques connexes

Pour déplacer un objet par programme :

  Utilisez la procédure interne OG_MOVE.

L'exemple ci-dessous fait passer l'objet indiqué à une autre position dans la présentation :

PROCEDURE move_inventory(invent_obj IN og_object) IS

   distance   OG_POINT;
BEGIN
   distance.x:=(3*OG_INCH);
   distance.y:=(3*OG_INCH);
   OG_MOVE(invent_obj, distance);
END;


Copie d'objets

Pour copier des objets :

1	Sélectionnez les objets à copier.

2	Sélectionnez Copier ou Edition [image] Copier, ou choisissez la commande Copier dans le menu instantané.

Graphics Builder stocke les objets dans le presse-papiers.


Découpage d'objets

Pour couper des objets :

1	Sélectionnez les objets à supprimer.

2	Choisissez la commande Couper dans le menu instantané ou sélectionnez Couper, ou  bien choisissez Edition [image] Couper.

Graphics Builder supprime les objets de la présentation et les stocke dans le presse-papiers.


Effacement d'objets

Pour effacer des objets :

1	Sélectionnez les objets à supprimer.

2	Choisissez la commande Effacer dans le menu instantané ou Edition [image] Effacer.

Graphics Builder supprime les objets de la présentation sans modifier le contenu du presse-papiers.

Les objets supprimés ne peuvent pas être rappelés.


Effacement d'objets par programme

  Rubriques connexes

Pour effacer des objets par programme :

  Utilisez le sous programme PL/SQL intégré OG_DESTROY.

L'exemple ci-dessous supprime ("détruit") de l'affichage runtime la fenêtre indiquée :

PROCEDURE destroy_USA IS
   the_window   OG_WINDOW;
BEGIN
   the_window:=OG_GET_WINDOW('USA_window');
   OG_DESTROY(the_window);
END;


Collage d'objets

Pour coller des objets :

  Sélectionnez Coller ou choisissez Edition [image] Coller.

Graphics Builder colle dans la présentation les objets stockés dans le presse-papiers, au même endroit que les originaux. L'objet est sélectionné et vous pouvez le déplacer.

Si vous collez directement un objet sur l'objet d'origine, vous ne verrez l'objet d'origine que lorsque vous déplacerez la copie.


Duplication d'objets

Pour dupliquer des objets dans la présentation :

1	Sélectionnez les objets à dupliquer.

2	Choisissez Edition [image] Dupliquer.

Graphics Builder duplique les objets dans la présentation, légèrement décalés par rapport à la position de l'original.

Vous pouvez effectuer plusieurs duplications de l'objet sélectionné à l'origine en continuant à choisir
Edition [image] Dupliquer.


Duplication d'objets par programme

  Rubriques connexes

Pour dupliquer des objets par programme :

  Utilisez le sous-programme intégré OG_CLONE.

L'exemple ci-dessous crée un objet identique à l'objet indiqué :

PROCEDURE dup_object(my_old_object IN og_object) IS
   my_new_object   OG_OBJECT;
BEGIN
   my_new_object:=OG_CLONE(my_old_object);
END;


Suppression d'objets

Pour supprimer des objets :

  Coupez les objets ou effacez-les de la présentation. Couper supprime les objets et les stocke dans le presse-papiers pour vous permettre deles coller ailleurs. Effacer supprime les objets sans modifier le contenu du presse-papiers.

En outre, vous pouvez supprimer des objets à partir du Navigateur d'objet.


Suppression d'objets à partir du Navigateur d'objet

  Rubriques connexes

Pour supprimer un objet à partir du Navigateur d'objet :

1	Sélectionnez l'objet à supprimer.

2	Sélectionnez Supprimer ou choisissez Navigateur [image] Supprimer.

Un message d'alerte vous demande de confirmer la suppression.

3	Sélectionnez Oui pour confirmer.

Si vous supprimez un objet référencé dans une unité de programme, vous devez éditer l'unité de programme pour qu'elle reflète la suppression.


Définition de la taille des symboles

Pour définir la taille des symboles :

1	Sélectionnez l'objet symbole.

2	Choisissez Format [image] Symbole pour afficher un sous-menu d'options.

3	Choisissez Grand, Moyen ou Petit.

La taille que vous sélectionnez s'applique à l'objet symbole sélectionné. Le paramètre reste en vigueur pour l'affichage en cours jusqu'à ce qu'il soit modifié de nouveau.


Redimensionnement d'objets

Pour redimensionner des objets :

  Faites glisser l'un de leurs quatre points de contrôle au nouvel emplacement. La façon dont vous faites glisser le point de contrôle détermine le changement de taille de l'objet.

Pour conserver le rapport d'aspect d'un objet, maintenez la touche Maj enfoncée tout en faisant glisser le point de contrôle jusqu'à sa nouvelle position.


Redimensionnement d'objets isolés ou groupés

Pour redimensionner un objet isolé ou un objet de groupe :

1	Sélectionnez l'objet que vous voulez redimensionner.

2	Sélectionnez un point de contrôle et faites-le glisser à son nouvel emplacement.


Redimensionnement de plusieurs objets

Pour redimensionner plusieurs objets:

1	Sélectionnez les objets à redimensionner.

2	Sélectionnez le point de contrôle d'un objet sélectionné et faites-le glisser à son nouvel emplacement.

Tous les autres objets sélectionnés changeront de taille par rapport à cet objet.


Choix d'une même taille pour plusieurs objets

Pour que plusieurs objets aient la même taille :

1	Sélectionnez les objets à redimensionner.

2	Choisissez Réorganisation [image] Définir taille objets pour afficher la boîte correspondante.

3	Indiquez les options à utiliser pour que les objets soient redimensionnés en fonction de l'objet le plus grand ou le plus petit, ou utilisez une moyenne, pour la largeur, la hauteur ou la largeur et la hauteur, et l'unité de mesure choisie.

4	Sélectionnez OK pour redimensionner les objets en fonction de vos paramètres et fermer la boîte de dialogue Définir taille objets.


Redimensionnement d'objets par programme

  Rubriques connexes

Pou redimensionner des objets par programme :

  Utilisez le sous-programme PL/SQL intégré OG_SCALE.

Dans l'exemple ci-dessous, la procédure bouton double la taille de l'objet indiqué :

PROCEDURE double(buttonobj IN og_object, hitobj IN
 og_object, win IN og_window, eventinfo IN og_event) IS
   anchor OG_POINT;
   newpt  OG_POINT;
   oldpt  OG_POINT;
BEGIN
   anchor.x:=OG_INCH;
   anchor.y:=OG_INCH;
   oldpt.x:=OG_INCH+1;
   oldpt.y:=OG_INCH+1;
   newpt.x:=OG_INCH+2;
   newpt.y:=OG_INCH+2;
   OG_SCALE(hitobj, anchor, oldpt, newpt);
END;


Remise en forme d'objets

Pour remettre des objets en forme, faites glisser leurs sommets à leur nouvelle position. Notez que les points de contrôle que vous voyez lors de la remise en forme d'un objet ne sont pas les mêmes que ceux que vous voyez lorsque vous sélectionnez un objet. L'outil de remise en forme donne des résultats différents selon les objets :

Objet	Remise en forme

arc	donne à l'angle de balayage une valeur autre que 90° (valeur par défaut)
polygones et lignes polygonales	fait passer un sommet à sa nouvelle position
lignes	fait passer le point de départ ou le point de fin à sa nouvelle position
ellipses, rectangles, rectangles arrondis	fait passer un sommet à sa nouvelle position
objets dessinés à la main	fait passer un point à sa nouvelle position
images	découpe l'image
La remise en forme d'ellipses, de rectangles et de rectangles arrondis ne diffère de l'utilisation de l'outil de sélection que si vous avez demandé que l'objet pivote de sorte que les points de contrôle sélectionnés ne coïncident plus avec les points de contrôle de remise en forme.

Pour remettre un objet en forme :

1	Sélectionnez l'objet à remettre en forme.

2	Sélectionnez l'outil de remise en forme dans la palette d'outils.

Le passage du point de contrôle aux sommets de l'objet dépend du type d'objet.

3	Sélectionnez l'un des sommets et faites-le glisser à sa nouvelle position.

Les résultats de l'outil de remise en forme dépendent des types d'objets.


A propos de la rotation d'objets

L'outil de rotation permet de faire pivoter un ou plusieurs objets dans la direction de votre choix. La rotation s'effectue par rapport au centre de l'objet.

Certains systèmes n'acceptent pas la rotation de texte. Pour plus d'informations, reportez-vous à la documentation de votre système d'exploitation.


Rotation d'un seul objet ou de plusieurs objets

Pour faire pivoter un ou plusieurs objets :

1	Sélectionnez l'outil de rotation de la palette d'outils.

2	Sélectionnez un point de contrôle de l'objet ou des objets à faire pivoter, et faites-le glisser dans la direction choisie pour la rotation.


Rotation d'objets de groupe

Pour faire pivoter des objets d'un groupe :

1	Choisissez l'outil de sélection de la palette d'outils.

2	Sélectionnez l'objet groupe.

Vous pouvez également faire glisser une région autour de l'objet groupe pour le sélectionner.

3	Sélectionnez l'objet fils.

Tout en maintenant la touche Maj enfoncée, cliquez sur plusieurs objets fils du groupe pour les sélectionner.

4	Sélectionnez l'outil de rotation de la palette d'outils.

5	Sélectionnez un point de contrôle de l'objet ou des objets à faire pivoter, et faites-le glisser dans la direction choisie pour la rotation.


Rotation d'objets par programme

  Rubriques connexes

Pour faire pivoter des objets par programme :

  Utilisez le sous-programme PL/SQL intégré OG_ROTATE.

L'exemple ci-dessous fait pivoter, dans le sens inverse des aiguilles d'une montre, l'objet indiqué, du nombre de degrés indiqué.

PROCEDURE rotate_needle (degrees IN NUMBER,
 center_pt IN og_point) IS
   the_needle     OG_OBJECT;
BEGIN   the_needle:=og_get_object('Aiguille 1');
   OG_ROTATE(the_needle, center_pt, degrees);
END;


A propos des opérations de groupe

Vous pouvez regrouper plusieurs objets pour les manipuler en bloc. Les objets qui appartiennent à un groupe sont les objets fils, dont le groupe est le père. Vous pouvez également grouper plusieurs objets groupe. Le groupe résultant sera composé de sous-groupes.


Groupement d'objets

Pour grouper des objets :

1	Sélectionnez les objets que vous voulez grouper.

2	Choisissez Réorganisation [image] Grouper.

Les objets sont groupés.


Sélection du groupe père

Pour sélectionner le groupe père :

  Choisissez Réorganisation [image] Opérations sur des groupes [image] Sélectionner père.

Le groupe père est sélectionné.


Sélection d'objets fils

Pour sélectionner des objets fils :

  Choisissez Réorganisation [image] Opérations sur des groupes [image] Sélectionner fils.

Les objets fils de l'objet groupe sont sélectionnés.


Ajout et suppression d'objets fils

Pour ajouter ou supprimer des objets fils :

1	Sélectionnez l'objet groupe et l'objet que vous voulez ajouter, ou sélectionnez l'objet fils que vous voulez supprimer.

2	Choisissez Réorganisation [image] Opérations sur des groupes, puis exécutez l'une des opérations suivantes :

•	Pour ajouter un objet à l'objet groupe, sélectionnez Ajouter au groupe.

•	Pour supprimer un objet fils de l'objet groupe, sélectionnez Supprimer du groupe.


Ajout et suppression d'objets fils par programme

  Rubriques connexes

Pour ajouter et supprimer des objets fils par programme :

  Utilisez les sous-programmes PL/SQL intégrés OG_DELETE_CHILD et OG_INSERT_CHILD.

L'exemple ci-dessous supprime un objet fils d'un objet groupe et l'insère dans un autre objet groupe :

PROCEDURE move_prod(warehouse1 IN og_object, warehouse2 IN
 og_object, prod_index IN NUMBER) IS
   oldpt.x:=OG_INCH+1;
   oldpt.y:=OG_INCH+1;
   newpt.x:=OG_INCH+2;
   newpt.y:=OG_INCH+2;
   OG_SCALE(hitobj, anchor, oldpt, newpt);
   the_prod  og_object;
BEGIN
   the_prod:=OG_GET_CHILD(warehouse1, prod_index);
   OG_DELETE_CHILD(warehouse1, prod_index, 1);
   OG_INSERT_CHILD(warehouse2, the_prod, OG_LAST);
END;


Dégroupage d'objets

Pour dégrouper des objets :

1	Sélectionnez l'objet groupe.

2	Choisissez Réorganisation [image] Séparer.

Les objets groupés sont séparés.


Changement de noms d'objet

  Rubriques connexes

Pour renommer un objet :

1	Cliquez deux fois sur l'objet ou le groupe objet pour afficher la fenêtre de propriété Objet.

Vous pouvez également sélectionner l'objet ou le groupe objet et choisir la commande Propriétés dans le menu instantané, ou sélectionner l'objet et choisir Outils [image] Propriétés.

2	Entrez un nom dans le champ Nom.

3	Sélectionnez OK pour accepter le nouveau nom et fermer la fenêtre de propriété Objet.

Une fois que vous avez créé un objet, vous pouvez lui donner un nom en utilisant la fenêtre de propriété Objet. Vous pouvez également donner directement un nom à un objet dans le Navigateur d'objet en sélectionnant le nom de l'objet et en l'éditant en conséquence.

Si vous envisagez d'utiliser vos objets dans des unités de programme PL/SQL, attribuez à chacun d'eux un nom unique pour pouvoir y faire référence facilement.

Si vous changez les noms des objets référencés dans des unités de programme PL/SQL, vous devez modifier ces références en conséquence.


Changement de noms d'objet dans le Navigateur d'objet

  Rubriques connexes

Pour renommer un objet dans le Navigateur d'objet :

1	Sélectionnez l'objet à renommer.

2	Faites passer le pointeur de la souris sur le nom de l'objet.

Le curseur passe d'un pointeur à un éditeur de texte.

3	Sélectionnez une fois sur le nom pour positionner le curseur et passer en mode édition.

Vous pouvez renommer tout objet que vous avez créé dans une présentation d'affichage, couches, interrogations, objets graphiques, paramètres, horloges, sons, graphiques et modèles de graphique par exemple. Pour remplacer la totalité du nom, sélectionnez le nom pour le mettre en évidence, puis entrez le nouveau nom. Notez que si vous renommez un objet référencé dans une unité de programme, vous devez modifier également ces références en conséquence.

Vous ne pouvez renommer une unité de programme PL/SQL qu'à partir de l'Editeur d'unité de programme.


Partage d'objets entre affichages

Pour partager un objet entre plusieurs affichages :

1	Dans le Navigateur d'objet, sélectionnez l'interrogation, le paramètre, l'horloge, le son ou l'unité de programme à déplacer.

2	Maintenez le bouton de sélection enfoncé sur l'objet et faites glisser cet objet verticalement à son nouvel emplacement. Le curseur prend la forme d'une croix et une ligne horizontale en pointillés indique l'emplacement actuel du noeud de l'objet dans le Navigateur.

3	Relâchez le bouton de la souris pour poser l'objet, en veillant à ce qu'il se trouve dans le noeud correct dans la hiérarchie des objets (c'est-à-dire que les interrogations doivent être amenées sous le noeud Interrogation, etc.).

Vous pouvez également déplacer des interrogations, des unités de programme, des paramètres, des horloges et des sons d'un affichage ouvert à un autre, également ouvert. Vous pouvez également transférer des unités de programme dans des bibliothèques ouvertes ou attachées, ou à partir de celles-ci.

Notez que lorsque vous transférez une unité de programme d'un affichage à un autre, elle perd son état compilé et doit être recompilée dans son nouveau contexte.


Modification de références d'objet dans des unités de programme

Pour modifier des références d'objet dans des unités de programme :

1	Cliquez deux fois sur l'unité de programme qui fait référence à l'objet pour afficher l'unité de programme dans l'Editeur d'unité de programme.

2	Choisissez Edition [image] Rechercher/remplacer pour afficher la boîte de dialogue Recherche/Remplacement.

3	Entrez l'ancien nom de l'objet dans le champ Rechercher.

Vous pouvez demander que la recherche fasse la différence entre les majuscules et les minuscules, ou utiliser une expression normale pour la recherche.

4	Entrez le nouveau nom de l'objet dans le champ Remplacer par.

5	Sélectionnez Remplacer tout pour remplacer toutes les occurrences de l'ancien nom d'objet par le nouveau nom dans l'unité de programme en cours.

Pour rechercher et remplacer un nom dans toutes les unités de programme de l'emplacement de travail en cours (c'est-à-dire le noeud Unités de programme, ou un noeud de bibliothèque ouverte), choisissez Editer [image] Rechercher/remplacer tout.


A propos de l'application de couleurs et de motifs

  Rubriques connexes

Les procédures permettant d'appliquer des couleurs et des motifs à des composants du cadre du graphique sont les mêmes que celles applicables aux objets.


L'affichage Trait/Remplissage/Texte affiche le motif utilisé pour le bord, le remplissage et le texte ainsi que les couleurs sélectionnées. Chaque objet que vous créez utilisera ces paramètres tant que vous n'en indiquerez pas d'autres.


Définition des couleurs des objets

Pour définir les couleurs des objets :

1	Sélectionnez les objets ou les éléments graphiques auxquels vous voulez appliquer une couleur.

2	Sélectionnez la Palette de couleurs de remplissage pour sélectionner une couleur d'arrière-plan pour l'objet ou sélectionnez la Palette de couleurs de ligne pour sélectionner une couleur de premier plan pour la bordure de l'objet.

La palette de couleurs appropriée s'affiche.

Vous pouvez "détacher" la palette de couleurs et la déplacer dans l'Editeur de présentation en sélectionnant l'option Palette détachable et en faisant glisser la barre de titre de la palette.

3	Sélectionnez une couleur de la palette.

La palette se ferme et la couleur est appliquée aux objets sélectionnés et aux nouveaux objets que vous dessinez dans la présentation. La couleur apparaît également dans la partie appropriée de la boîte de texte Trait/Remplissage/Texte et reste en vigueur pour l'affichage en cours jusqu'à ce qu'elle soit modifiée à nouveau.

Si votre système accepte la couleur, vous pouvez appliquer des couleurs à la partie intérieure (remplissage) et à la bordure (trait) d'un objet.


Définition des motifs de remplissage

Pour définir le motif de remplissage :

1	Sélectionnez les objets auxquels vous voulez appliquer le motif.

2	Sélectionnez la Palette de couleurs de remplissage.

3	Choisissez la commande Motifs dans le menu de la Palette de couleurs de remplissage pour afficher la Palette de motifs.

4	Sélectionnez le motif à appliquer à l'objet.

Le motif est appliqué aux objets sélectionnés et aux nouveaux objets que vous dessinez dans la présentation. Il apparaît aussi dans la partie remplissage de la boîte de dialogue Trait/Remplissage/Texte et reste en vigueur pour l'affichage en cours jusqu'à ce qu'il soit modifié à nouveau.

5	Fermez la Palette de motifs.

Vous pouvez appliquer différents motifs au remplissage des objets. Pour les objets texte, vous pouvez appliquer des motifs au remplissage de la boîte englobante, mais non aux caractères eux mêmes. Pour les graphiques, vous pouvez appliquer des motifs au modèle de graphique.


Définition des couleurs de motif

Pour définir les couleurs d'un motif :

1	Sélectionnez un ou plusieurs objets ou éléments graphiques auxquels vous voulez appliquer les couleurs du motif de premier plan et d'arrière-plan.

Si vous ne sélectionnez pas d'objet, les définitions ne s'appliqueront pas à des objets existants, mais resteront en vigueur pour les nouveaux objets que vous créerez, jusqu'à ce qu'elles soient modifiées.

2	Sélectionnez la Palette de couleurs de remplissage.

3	Choisissez la commande Motifs dans le menu de la Palette de couleurs de remplissage.

La Palette de motifs indique les paramètres de premier plan et d'arrière-plan en vigueur. Vous pouvez la déplacer dans la présentation pour améliorer la visibilité.

4	Sélectionnez la palette de couleurs déroulante correspondant à la couleur de premier plan (côté gauche) ou d'arrière-plan (côté droit).

La palette correspondante s'ouvre et indique les couleurs disponibles sur votre système.

5	Sélectionnez la couleur que vous voulez appliquer au premier plan ou à l'arrière-plan du motif.

La palette de couleurs de premier plan ou d'arrière-plan de motifs se ferme et les modifications sont reportées dans la Palette de motifs. En outre, la couleur est appliquée aux objets sélectionnés, et dans la partie remplissage de la boîte de dialogue Trait/Remplissage/Texte.

6	Fermez la Palette de motifs ou sélectionnez une autre couleur.

La sélection reste en vigueur pour l'affichage en cours jusqu'à ce qu'elle soit à nouveau modifiée.

La partie sombre d'un motif est appelée élément de premier plan, et la partie claire élément d'arrière-plan. Si votre système accepte la couleur, vous pouvez appliquer différentes couleurs aux éléments de premier plan et d'arrière-plan du motif de remplissage en cours.


Définition de la couleur du texte

  Rubriques connexes

Pour définir la couleur du texte :

1	Sélectionnez l'objet texte ou l'élément graphique auquel vous voulez appliquer une couleur.

2	Sélectionnez l'icône de la Palette de couleurs de texte dans l'Editeur de présentation, pour afficher la Palette de couleurs de texte.

Vous pouvez "détacher" la palette de couleurs et la déplacer dans l'Editeur de présentation en sélectionnant l'option Palette détachable et en faisant glisser la barre de titre de la palette.

3	Sélectionnez une couleur de la palette.

La palette se ferme et la couleur est appliquée aux objets sélectionnés et aux nouveaux objets que vous dessinez dans la présentation. La couleur apparaît également dans la partie appropriée de la boîte de texte Trait/Remplissage/Texte et reste en vigueur pour l'affichage en cours jusqu'à ce qu'elle soit modifiée à nouveau.

Vous pouvez non seulement définir les couleurs et les motifs de la boîte englobante d'un objet texte, mais aussi sélectionner les couleurs du texte lui-même. Pour le texte des graphiques, vous pouvez appliquer des couleurs dans le modèle de graphique ou sélectionner directement l'élément graphique dans l'Editeur de présentation.

Pour lier une couleur d'élément de graphique à votre source de données, appliquez une couleur aux éléments graphiques en utilisant un déclencheur de format.


Suppression de motifs et de couleurs de remplissage des objets

Pour supprimer les motifs et les couleurs de remplissage des objets :

1	Sélectionnez les objets ou les éléments graphiques dont vous voulez restaurer ou supprimer la couleur ou les motifs.

2	Sélectionnez la Palette de couleurs de remplissage.

Vous pouvez "détacher" la palette de couleurs et la déplacer dans l'Editeur de présentation en sélectionnant l'option Palette détachable et en faisant glisser la barre de titre de la palette.

3	Sélectionnez l'option Pas de remplissage pour supprimer la sélection de couleur ou de motif en cours.

La palette se ferme et la couleur de remplissage est restaurée pour les objets sélectionnés et les nouveaux objets que vous tracez dans la présentation. La couleur apparaît également dans la partie appropriée de la boîte Trait/Remplissage/Texte et reste en vigueur pour l'affichage en cours jusqu'à ce que vous la changiez à nouveau.

Le motif et les couleurs que vous sélectionnez pour un objet restent en vigueur jusqu'à ce que vous les restauriez.


Modification de la couleur d'un objet par programme

  Rubriques connexes

Pour modifier la couleur d'un objet par programme :

  Utilisez l'un des sous-programmes PL/SQL intégrés qui modifient la couleur, comme OG_SET_FFCOLOR.

L'exemple ci-dessous utilise la procédure interne de propriété graphique OG_SET_FFCOLOR pour définir la propriété de remplissage de premier plan de l'objet indiqué :

PROCEDURE color_country(country_name) IS
   my_object    OG_OBJECT;
BEGIN
   my_object:=OG_GET_OBJECT(country_name);
   OG_SET_FFCOLOR(country_name, 'color 72');
END;


Edition des palettes de couleurs

Pour éditer une palette de couleurs :

1	Choisissez Format [image] Palette de couleurs pour afficher la boîte de dialogue Palette de couleurs.

Si cet élément de menu n'existe pas, assurez-vous que Mode couleur est défini à Modifiable dans la fenêtre de propriété Options outils - par défaut. S'il n'est pas défini, fermez l'affichage et rouvrez-le pour que le nouveau paramètre Mode couleur prenne effet.

2	Sélectionnez une couleur à éditer.

3	Sélectionnez Editer.

La boîte de dialogue d'édition de couleurs de votre système s'affiche.

4	Editez la couleur en suivant la procédure correspondant à votre système.

5	Acceptez la boîte de dialogue pour revenir à la boîte de dialogue Palette de couleurs.

6	Pour renommer la couleur, entrez un nouveau nom dans le champ Couleur courante et sélectionnez Renommer.

7	Sélectionnez OK pour fermer la boîte de dialogue Palette de couleurs.

Si votre système accepte la couleur, vous pouvez éditer la palette de couleurs de votre affichage. Vous pouvez également importer et exporter des palettes de couleurs.


Masquage des bordures d'un objet

Pour masquer les bordures d'un objet :

1	Sélectionnez les objets ou les éléments graphiques dont vous voulez supprimer la bordure.

2	Sélectionnez la Palette de couleurs de ligne.

Vous pouvez "détacher" la palette de couleurs et la déplacer dans l'Editeur de présentation en sélectionnant l'option Palette détachable et en faisant glisser la barre de titre de la palette.

3	Sélectionnez l'option Pas de ligne pour masquer la bordure.

La palette se ferme et la couleur de ligne est restaurée pour les objets sélectionnés et les nouveaux objets que vous dessinez dans la présentation. La couleur, ou l'absence de couleur, apparaît également dans la partie appropriée de la boîte d'affichage Trait/Remplissage/Texte et reste en vigueur pour l'affichage en cours jusqu'à ce qu'elle soit à nouveau modifiée.


Définition des propriétés de ligne

Pour définir les propriétés de ligne :

1	Sélectionnez la ou les lignes.

2	Choisissez dans le menu Format l'une des commandes suivantes :

•	Trait	pour afficher un sous-menu de largeurs de trait.

•	Tiret	pour afficher un sous-menu de styles de tiret

•	Flèche	pour afficher un sous-menu de styles de flèche.

3	Indiquez les options de votre choix.

Les propriétés que vous sélectionnez s'appliquent à l'objet ligne. Les définitions restent en vigueur pour l'affichage en cours jusqu'à ce qu'elles soient à nouveau modifiées.


Définition des propriétés de bord

  Rubriques connexes

Pour définir les propriétés de bord :

1	Sélectionnez les objets.

2	Choisissez Format [image] Trait pour définir la largeur ou Format [image] Relief pour afficher une liste d'options de relief.

Si vous voulez définir une option de relief pour le bord de l'objet, définissez une largeur de ligne d'au moins 2 points.

3	Indiquez les options de votre choix.

Les propriétés que vous sélectionnez s'appliquent aux bords des objets sélectionnés. Les définitions restent en vigueur pour l'affichage en cours jusqu'à ce qu'elles soient à nouveau modifiées.


A propos de l'indication des formats de nombre et de date

Vous pouvez définir les formats de nombre et de date aux emplacements suivants, en fonction de vos besoins :

•	Editeur de présentation

•	Modèle de graphique

•	Fichier de préférences

Définissez les formats de nombre et de date dans l'Editeur de présentation si vous voulez définir directement ces formats dans un graphique spécifique.

Définissez les formats de nombre et de date dans le Modèle de graphique si vous voulez définir ces formats pour un modèle de graphique spécifique.

Définissez les formats de nombre et de date dans le Fichier préférences si vous voulez appliquer les formats à tous les graphiques et à tous les paramètres de Graphics Builder, ou si vous utilisez des données de date provenant de fichiers externes, comme des fichiers PRN. Cette option garantit que les dates référencées dans ces fichiers externes seront copiées correctement dans les dates du graphique. Si vous n'indiquez pas de format de date correspondant, dans votre fichier de préférences, Graphics Builder considère la date externe comme des données de type caractère.


Définition des propriétés de la totalité de l'objet texte ou du champ texte

  Rubriques connexes

Pour définir les propriétés de la totalité de l'objet texte ou du champ texte :

1	Sélectionnez l'objet texte ou le champ texte.

2	Choisissez Format [image] Police, Interlignage ou Justification pour afficher un sous-menu ou une boîte de dialogue d'options (polices).

3	Indiquez les options de votre choix.

Les propriétés que vous sélectionnez s'appliquent à l'objet texte et au champ texte.

4	Lorsque vous avez terminé, sélectionnez la présentation, à l'extérieur de l'objet texte, pour désélectionner l'objet texte ou le champ texte.


Définition des propriétés d'un objet texte partiel ou d'un texte de champ texte par défaut

Pour définir les propriétés de texte d'un objet texte partiel ou d'un texte de champ texte par défaut :

1	Sélectionnez l'outil Texte de la Palette d'outils.

2	Sélectionnez l'objet texte ou le champ texte dans lequel vous voulez modifier des propriétés.

Le curseur texte apparaît à l'endroit où vous avez cliqué.

3	Glissez sur le texte que vous voulez modifier.

4	Choisissez Format [image] Police, Interlignage ou Justification pour afficher un sous-menu d'options.

5	Indiquez les options de votre choix.

Les propriétés que vous sélectionnez s'appliquent au texte.

6	Lorsque vous avez terminé, sélectionnez la présentation, à l'extérieur de l'objet texte ou du champ texte, pour sortir du mode Texte et désélectionner le texte.


Définition de formats de nombre et de date dans votre fichier de préférences

Pour définir les formats de nombre et de date dans votre fichier de préférences :

1	Choisissez Outils [image] Options outils pour afficher la fenêtre de propriété Options outils.

2	Sélectionnez Nombre ou Date pour afficher la boîte de dialogue Format de nombre ou Format de date.

3	Entrez le format de date ou de nombre de votre choix dans le champ Format.

Pour plus d'informations sur les formats valides, reportez-vous à Oracle7 Server SQL Language Reference Manual.

4	Sélectionnez Ajouter pour ajouter le format à la liste.

5	Sélectionnez OK pour accepter les modifications que vous avez apportées à la liste de formats et fermer la boîte de dialogue.

6	Sélectionnez Enregistrer pour enregistrer vos paramètres dans votre fichier de préférences ou OK pour les enregistrer uniquement pour la session en cours.

Lorsque vous créez un graphique, le format utilisé est le dernier qui a été ajouté à la liste.


Définition de formats de nombre et de date dans l'Editeur de présentation

Pour définir les formats de nombre et de date directement dans le graphique dans l'Editeur de présentation :

1	Sélectionnez l'élément graphique dont vous voulez modifier le format de date ou de nombre.

Tous les éléments sont sélectionnés.

2	Choisissez Format de nombre ou Format de date dans le menu instantané, ou Format [image] Nombre ou Format [image] Date pour afficher la boîte de dialogue  Format de nombre ou Format de date.

3	Sélectionnez Date ou Nombre pour afficher respectivement la boîte de dialogue Format de date ou Format de nombre.

Le format de nombre ou de date en cours apparaît dans le champ Format.

4	Vous pouvez éditer le format en cours, en sélectionner un autre dans la liste, ou entrer un nouveau format et l'ajouter à la liste. Pour ajouter de façon permanente un format à la liste, reportez-vous ci-dessus à la section consacrée à la définition des formats de nombre et de date dans votre fichier de préférences.

5	Sélectionnez OK pour accepter les modifications que vous avez apportées à la liste de formats et fermer la boîte de dialogue.

Vos modifications sont reportées sur tous les graphiques qui utilisent le modèle que vous avez édité.

Pour plus d'informations sur les formats valides, reportez-vous à Oracle7 Server SQL Language Reference Manual.


Définition de formats de nombre et de date dans le modèle de graphique

Pour définir les formats de nombre et de date dans le modèle de graphique :

1	Choisissez Outils [image] Modèles pour afficher l'Editeur de modèles de graphique.

2	Sélectionnez le modèle pour lequel vous voulez définir un format de nombre ou de date dans la liste déroulante Modèles.

Le modèle apparaît dans la présentation de l'éditeur.

3	Sélectionnez l'élément de modèle de graphique qui représente le format de nombre ou de date que vous voulez définir.

4	Choisissez Format [image] Nombre ou Format [image] Date pour afficher la boîte de dialogue Format de nombre ou Format de date.

La format de nombre ou de date en cours apparaît dans le champ Format.

5	Vous pouvez éditer le format en cours, en sélectionner un autre dans la liste, ou entrer un nouveau format et l'ajouter à la liste.

Pour ajouter de façon permanente un format à la liste, reportez-vous ci-dessus à la section consacrée à la définition des formats de nombre et de date dans votre fichier de préférences.

6	Sélectionnez OK pour accepter les modifications que vous avez apportées à la liste de formats et fermer la boîte de dialogue.

7	Fermez l'éditeur de Modèles de graphique.

Vos modifications sont reportées sur tous les graphiques qui utilisent le modèle que vous avez édité.

Pour plus d'informations sur les formats valides, reportez-vous à Oracle7 Server SQL Language Reference Manual.


Edition d'objets texte

Pour éditer des objets texte :

1	Sélectionnez l'outil Texte de la Palette d'outils.

2	Cliquez sur l'objet texte à l'endroit où vous voulez commencer la saisie ou l'édition.

Le curseur de texte apparaît à l'endroit où vous avez cliqué.

3	Entrez ou éditez le texte.

Vous pouvez glisser sur le bloc de texte que vous voulez sélectionner.

4	Lorsque vous avez terminé, sélectionnez la présentation, en dehors de l'objet texte, pour sortir du mode texte.


Lecture et édition de sons

Pour lire ou éditer un son :

1	Cliquez deux fois sur un son pour afficher la boîte de dialogue Lecteur de son.

2	Lisez un son ou enregistrez sur le son existant en choisissant respectivement les boutons Lecture ou Enregistrement.

Vous pouvez également utiliser les boutons Avance rapide et Retour rapide ou la barre de défilement pour trouver une position dans le fichier de son.

3	Sélectionnez OK pour fermer la boîte de dialogue Lecteur de son.


Lecture de sons par programme

  Rubriques connexes

Pour lire des sons par programme :

  Utilisez la procédure PL/SQL interne OG_PLAY SOUND et la fonction OG_GET_SOUND.

L'exemple ci-dessous exécute le son indiqué sur l'unité de sortie indiquée dans vos préférences :

PROCEDURE warning IS
   the_sound   OG_SOUND;
BEGIN
   the_sound:=OG_GET_SOUND('warning_snd');
   OG_PLAY_SOUND(the_sound);
END;


Export de sons

Pour exporter des sons :

1	Sélectionnez l'objet son dans le Navigateur.

2	Choisissez Edition [image] Exporter [image] Son pour afficher la boîte de dialogue  Export de son.

3	Indiquez les options de votre choix : nom de fichier et emplacement, format de fichier et compression à utiliser pour l'export du son, etc.

4	Sélectionnez OK pour confirmer les informations et fermer la boîte de dialogue.

Le son est exporté à l'emplacement que vous avez indiqué.


Changement de noms de son interne

  Rubriques connexes

Pour renommer un son interne :

1	Sélectionnez l'objet son que vous voulez renommer.

2	Amenez le pointeur de la souris sur le nom du son.

Le curseur passe d'un pointeur à un éditeur de texte.

3	Sélectionnez une fois le nom pour positionner le curseur et passer en mode édition.

Pour remplacer la totalité du nom, sélectionnez le nom pour le mettre en évidence, puis entrez le nouveau nom.

Les sons que vous avez créés dans Builder ou importés dans l'affichage sont considérés comme internes. Les sons stockés dans le système de fichiers ou dans la base de données sont considérés comme externes. L'emplacement du son détermine les méthodes que vous utilisez pour accorder et révoquer des autorisations d'accès, et pour renommer ou supprimer le son.

Si vos renommez un son que vous avez référencé dans une unité de programme PL/SQL, vous devez changer toutes les références en conséquence.


Suppression de sons internes

Pour supprimer un son interne :

1	Sélectionnez l'objet son à supprimer.

2	Sélectionnez Supprimer ou choisissez Navigateur [image] Supprimer.

3	Choisissez Oui pour confirmer la suppression.

Le son est supprimé de l'affichage.

Les sons que vous avez créés dans Builder ou importés dans l'affichage sont considérés comme internes. Les sons stockés dans le système de fichiers ou dans la base de données sont considérés comme externes. L'emplacement du son détermine les méthodes que vous utilisez pour accorder et révoquer des autorisations d'accès, et pour renommer ou supprimer le son.


A propos des paramètres

Les paramètres sont le plus souvent utilisés dans des relations de hiérarchisation vers le bas, où ils représentent la valeur d'un élément graphique ou le nom d'un objet graphique de votre affichage. Le paramètre est alors utilisé dans une interrogation ou une unité de programme PL/SQL pour piloter l'action indiquée.

Les paramètres peuvent être également utilisés dans des unités de programme PL/SQL multiples, des variables globales par exemple.

Ils peuvent notamment être utilisés pour :

•	représenter la valeur d'un élément graphique dans une relation de hiérarchisation vers le bas,

•	représenter le nom d'un objet graphique dans une relation de hiérarchisation vers le bas ou une procédure bouton,

•	stocker une valeur dans une unité de programme PL/SQL,

•	stocker une valeur de chaîne, comme une clause WHERE, à utiliser dans une interrogation.


A propos des composants de paramètre

Chaque paramètre que vous créez se compose des éléments suivants :

nom

type

valeur initiale


Nom

Nom que vous utiliserez dans vos instructions SQL ou PL/SQL, pour faire référence aux paramètres.


Type

Type des données de la valeur que représente le paramètre. Les entrées valides, dans la liste instantanée, sont Number, Char et Date.


Valeur initiale

(Facultatif) Valeur attribuée au paramètre lorsque vous exécutez l'affichage pour la première fois. La valeur entrée ici peut être remplacée par une valeur attribuée manuellement ou par programme.


A propos de la création de paramètres

Pour créer des paramètres, utilisez boîte de dialogue Paramètres. Vous pouvez créer des paramètres avant de les utiliser, ou les créer dans d'autres tâches comme l'établissement de relations de hiérarchisation vers le bas.

Pour créer une variable globale d'un type autre que NUMBER, CHAR ou DATE -- par exemple, de l'un des types de procédures internes PL/SQL Graphics Builder -- vous pouvez créer un package définissant ces variables. Pour plus d'informations sur les packages PL/SQL, reportez-vous à PL/SQL User's Guide and Reference.

Une fois que vous avez créé un paramètre, vous pouvez y faire référence dans des unités de programme, des interrogations SQL ou des procédures de hiérarchisation vers le bas.


Création de paramètres autonomes à l'aide du Navigateur d'objet

Pour créer un paramètre autonome à l'aide du Navigateur d'objet :

1	Sélectionnez le noeud Paramètres dans le Navigateur d'objet.

2	Sélectionnez le bouton Créer ou choisissez Navigateur [image] Créer dans le menu pour afficher la boîte de dialogue Paramètres.

S'il n'existe pas encore de paramètres, cliquez deux fois sur le noeud Paramètres pour afficher la boîte de dialogue Paramètres.

Le nouveau paramètre, appelé au départ paramx, est de type Char.

3	Définissez le nom, le type et la valeur initiale du nouveau paramètre.

4	Sélectionnez OK pour accepter les définitions du nouveau paramètre et fermer la boîte de dialogue.


Création de paramètres autonomes à l'aide du menu

Pour créer un paramètre autonomes à l'aide du menu :

1	Choisissez Outils [image] Paramètres pour afficher la boîte de dialogue Paramètres.

2	Sélectionnez le bouton Nouveau pour créer un nouveau paramètre.

Le nouveau paramètre, appelé au départ paramx, est de type Char.

3	Définissez le nom, le type et la valeur initiale du paramètre.

4	Sélectionnez OK pour accepter les définitions du nouveau paramètre et fermer la boîte de dialogue.


Création de nouveaux paramètres dans la page de hiérarchisation vers le bas

  Rubriques connexes

Pour créer un nouveau paramètre dans la page de hiérarchisation vers le bas :

1	Cliquez deux fois sur un objet de votre affichage auquel vous voulez attribuer des valeurs de paramètres ((élément graphique, etc.) pour afficher la fenêtre de propriété Objet.

Vous pouvez également sélectionner l'objet et choisir la commande Propriétés dans le menu instantané, ou choisir Outils [image] Propriétés  pour afficher la fenêtre de propriété Objet.

2	Choisissez l'onglet Hiérarchisation vers le bas pour afficher la page de propriété Hiérarchisation vers le bas.

3	Sélectionnez Nouveau, à droite du champ Définir paramètre, pour afficher la boîte de dialogue Paramètres.

4	Définissez le type et la valeur initiale du paramètre.

5	Sélectionnez OK pour accepter les définitions du nouveau paramètre et fermer la boîte de dialogue.

6	Définissez les champs A la valeur de et Exécuter interrogation dans la page de propriété Hiérarchisation vers le bas.

7	Sélectionnez OK pour accepter la relation de hiérarchisation vers le bas.


Création de nouveaux paramètres par référence

Pour créer un nouveau paramètre par référence :

1	Dans une interrogation  SQL ou une unité de programme PL/SQL, entrez une référence à un nom de paramètre unique. Par exemple :

:object := OG_GET_OBJECT (circle1);

2	Sélectionnez OK pour exécuter votre interrogation ou Compiler pour compiler votre unité de programme.

3	Un message d'alerte vous indique que le paramètre auquel vous faites référence n'existe pas et vous demande si vous voulez le créer.

4	Sélectionnez Oui pour confirmer et afficher la boîte de dialogue Paramètres.

5	Définissez le type et la valeur initiale du paramètre.

6	Sélectionnez OK pour accepter les définitions du nouveau paramètre et fermer la boîte de dialogue.

7	Sélectionnez OK pour réexécuter votre interrogation ou Compiler pour recompiler votre unité de programme.

Si vous créez une instruction SQL SELECT ou une unité de programme PL/SQL et que vous décidiez d'utiliser un paramètre, faites simplement référence à un nom de paramètre nouveau et unique, comme si le paramètre existait. Lorsque vous tenterez d'exécuter l'opération ou de compiler l'unité de programme, Graphics Builder vous demandera de créer le nouveau paramètre et affichera la boîte de dialogue Paramètres.


Changement de noms de paramètre dans le Navigateur d'objet

Pour renommer un paramètre dans le Navigateur d'objet :

1	Sélectionnez l'objet paramètre que vous voulez renommer.

2	Sélectionnez une fois le nom pour positionner le curseur et passer en mode Edition.

Si vous voulez remplacer le nom en totalité, sélectionnez le nom pour le mettre en évidence, puis entrez le nouveau nom.

3	Si vous avez fait référence au paramètre dans une instruction SQL SELECT, une unité de programme PL/SQL ou une relation de hiérarchisation vers le bas, modifiez ces références en fonction du nouveau nom du paramètre.


Changement de noms de paramètre dans la boîte de dialogue Paramètres

Pour renommer un paramètre dans la boîte de dialogue Paramètres :

1	Ouvrez la boîte de dialogue Paramètres.

2	Sélectionnez le paramètre à renommer dans la liste déroulante Nom.

3	Editez le nom.

4	Sélectionnez OK pour accepter le nouveau nom et fermer la boîte de dialogue Paramètres.

5	Si vous avez fait référence au paramètre dans une instruction SQL SELECT, une unité de programme PL/SQL ou une relation de hiérarchisation vers le bas, modifiez ces références en fonction du nouveau nom du paramètre.


Edition de paramètres à l'aide du Navigateur d'objet

Pour éditer un paramètre à l'aide du Navigateur d'objet :

1	Cliquez deux fois sur l'objet paramètre pour afficher la boîte de dialogue Paramètres.

Vous pouvez également sélectionner l'objet paramètre et choisir la commande Propriétés dans le menu instantané, ou choisir Outils [image] Propriétés.

2	Modifiez les paramètres

3	Sélectionnez OK pour accepter les modifications et fermer la boîte de dialogue.


Edition de paramètres à l'aide du menu

Pour éditer un paramètre à l'aide du menu :

1	Choisissez Outils [image] Paramètres pour afficher la boîte de dialogue Paramètres.

2	Choisissez le nom du paramètre à modifier dans la liste déroulante Paramètres.

3	Modifiez les paramètres.

4	Sélectionnez OK pour accepter les modifications et fermer la boîte de dialogue.


A propos des références aux paramètres

Graphics Builder comporte deux types de référence de paramètres :

•	référence de liaison,

•	référence lexicale.

Notez que bien que les noms de paramètres soient indiqués entièrement en majuscules dans la boîte de dialogue Paramètres, le programme ne fait pas la différence entre les majuscules et les minuscules lorsque vous les utilisez dans vos instructions SQL ou PL/SQL.

Si vous faites référence à un paramètre qui n'existe pas, un message d'alerte vous demande si vous voulez le créer. Si vous répondez oui, la boîte de dialogue Paramètres s'affiche.


A propos de l'attribution de valeurs à des paramètres

Vous pouvez attribuer des valeurs à des paramètres de quatre façons différentes :

•	Au départ, dans la boîte de dialogue Paramètres.

•	Dans des unités de programme PL/SQL.

•	En fonction d'une action utilisateur.

•	Comme arguments des exécutables Runtime ou Batch.

Lors de l'exécution, les valeurs des paramètres remplacent leurs références dans les instructions SQL SELECT ou les unités de programme PL/SQL.


A propos de l'attribution de valeurs de paramètre en fonction d'une action utilisateur

  Rubriques connexes

Vous pouvez lier une valeur de paramètre à un objet de votre affichage -- par exemple, un élément graphique -- et laisser à l'utilisateur le soin de définir la valeur du paramètre en sélectionnant un objet d'affichage dans l'affichage Runtime. Les deux applications possibles sont les suivantes :

•	création d'une relation de hiérarchisation vers le bas,

•	utilisation de procédures bouton d'objet.


Création d'une référence de lien

Pour créer une référence de lien :

 Entrez deux-points(:) immédiatement avant le nom du paramètre. Comme vous pouvez créer des paramètres à la volée, il n'est pas nécessaire de définir le paramètre avant d'y faire référence.

Par exemple, dans l'instruction SQL SELECT ci-dessous, my_param représente une valeur de la colonne ENAME dans la table EMP :

select ename, sal
from emp
where ename = :mon_param

Utilisez une référence de lien pour remplacer une seule valeur, comme une chaîne de caractères, une valeur numérique ou une date dans les instructions SQL SELECT ou les unités de programme PL/SQL.


Création d'une référence lexicale

Pour créer une référence lexicale :

 Pour créer une référence lexicale à un paramètre ou à une colonne, entrez une perluète (&) immédiatement avant le nom du paramètre ou de la colonne. Fournissez la valeur initiale de chaque référence lexicale, car aucune définition par défaut n'est indiquée.

Par exemple, pour utiliser un paramètre représentant une clause WHERE dans une instruction SELECT, commencez par définir le paramètre et entrez la clause WHERE dans le champ de valeur initiale.

Puis, créez votre instruction SELECT :

select ename, sal
from emp
&mon_param

Vous pouvez également attribuer la valeur par programme, puis exécuter l'interrogation en fonction de la nouvelle valeur et mettre à jour le graphique associé :

PROCEDURE set_param (name IN VARCHAR2, qry IN OG_QUERY) IS
  the_chart  OG_OBJECT;
BEGIN
  :my_param:='WHERE ENAME = '||name;
  OG_EXECUTE_QUERY(qry);
  the_chart:=OG_GET_CHART('graph0');
  OG_UPDATE_CHART(the_chart, OG_ALL_CHUPDA);
END;

Si vous voulez que des références lexicales remplacent des noms de colonne dans une instruction SELECT, créez une référence lexicale distincte pour chacune des colonnes concernées. Donnez à chaque colonne un alias pour que Graphics Builder puisse établir correctement la correspondance entre les champs. Indiquez en outre le même nombre d'éléments lors de l'exécution que vous en avez indiqués dans l'instruction.

Par exemple :

select &param1 ONE, &param2 TWO
from &tablename
&where_clause

Utilisez une référence lexicale comme colonne de réserve d'une chaîne de texte composé dans une instruction SQL SELECT. Vous pouvez utiliser des références lexicales pour remplacer les clauses apparaissant après SELECT, FROM, WHERE, GROUP BY, ORDER BY, HAVING, CONNECT BY et START WITH.

Vous ne pouvez utiliser comme paramètre lexical qu'un paramètre de type Char. En outre, les références lexicales ne sont pas autorisées dans une instruction PL/SQL.


Attribution d'une valeur initiale à un paramètre

  Rubriques connexes

Pour attribuer une valeur initiale à un paramètre :

 Entrez une valeur dans le champ Valeur initiale.


Attribution d'une valeur à un paramètre à l'aide de PL/SQL

  Rubriques connexes

Pour attribuer une valeur à un paramètre à l'aide de PL/SQL :

 Faites référence au paramètre et attribuez-lui une valeur comme vous le feriez pour toute autre variable.

Par exemple, pour attribuer au paramètre DNO la valeur 10, vous pouvez inclure dans une procédure l'instruction :

:DNO := 10;

Vous pouvez attribuer aux paramètres une valeur absolue, comme une chaîne numérique ou une chaîne de texte, ou leur attribuer des valeurs relatives en utilisant d'autres variables, paramètres et opérateurs.

Si, par exemple, vous avez défini un paramètre, appelé mon_num, de type Number, vous pouvez écrire dans une instruction PL/SQL :

PROCEDURE double IS
BEGIN
  :mon_num := :mon_num*2;
END;

qui définira mon_num à deux fois sa valeur précédente.


Attribution de valeurs de paramètre dans la ligne de commande

  Rubriques connexes

Pour attribuer des valeurs de paramètre dans la ligne de commande :

 Ajoutez l'attribution de paramètre comme dernier argument de la chaîne de commande. La valeur indiquée pour le paramètre remplace la valeur initiale du paramètre, définie dans la boîte de dialogue Paramètres.

L'exemple suivant illustre la façon d'attribuer des valeurs aux paramètres param1 (type NUMBER) et param2 (type DATE):

g30des openfile=chart1 param1=29 param2='02-OCT-94'

Les paramètres sont globaux, alors que les variables ne peuvent être utilisées que dans l'unité de programme dans laquelle elles sont définies. Si vous voulez utiliser la variable en dehors de l'unité de programme, remplacez-la par un paramètre.


Utilisation de procédures bouton d'objet pour définir des valeurs de paramètre

Pour définir une procédure bouton d'objet :

1	Cliquez deux fois sur l'objet graphique auquel vous voulez définir la valeur du paramètre.

Vous pouvez également sélectionner l'objet, puis choisir Propriétés dans le menu instantané, ou choisir Outils [image] Propriétés.

2	Choisissez l'onglet Descendre d'un niveau pour afficher la page de hiérarchisation vers le bas.

3	Sélectionnez un paramètre dans la liste instantanée Définir paramètres ou sélectionnez Nouveau pour créer un nouveau paramètre.

4	Entrez le nom du paramètre dans le champ Nom.

Tout comme un graphique de hiérarchisation vers le bas, une procédure bouton est activée par l'utilisateur dans l'affichage Runtime. Cependant, au lieu de sélectionner un élément graphique pour piloter l'action, l'utilisateur sélectionne un objet graphique.

La valeur Nom d'objet est définie comme étant de type CHAR. Si vous avez défini le paramètre comme étant d'un autre type, vous devez utiliser la fonction de conversion TO_CHAR lorsque vous faites référence au paramètre dans une interrogation ou une unité de programme PL/SQL. Pour plus d'informations sur TO_CHAR, reportez-vous à PL/SQL User's Guide and Reference.

Vous pouvez alors utiliser le paramètre dans toute unité de programme de l'affichage.


Suppression de paramètres dans le Navigateur d'objet

Pour supprimer un paramètre dans le Navigateur d'objet :

1	Sélectionnez l'objet paramètre dans le Navigateur.

2	Sélectionnez le bouton Supprimer ou choisissez Navigateur [image] Supprimer dans le menu.

3	Dans le message d'alerte, sélectionnez Oui pour confirmer.

4	Si vous avez fait référence au paramètre dans une instruction SQL SELECT, une unité de programme PL/SQL ou une relation de hiérarchisation vers le bas, changez ces références pour qu'elles reflètent la suppression.


Suppression de paramètres de la boîte de dialogue Paramètres

Pour supprimer un paramètre de la boîte de dialogue Paramètres :

1	Choisissez Outils [image] Paramètres pour afficher la boîte de dialogue Paramètres.

2	Sélectionnez le nom du paramètre à supprimer dans la liste déroulante Paramètres.

3	Sélectionnez Supprimer.

4	Dans le message d'alerte, sélectionnez Oui pour confirmer.

5	Sélectionnez OK pour fermer la boîte de dialogue Paramètres.

6	Si vous avez fait référence au paramètre dans une instruction SQL SELECT, une unité de programme PL/SQL ou une relation de hiérarchisation vers le bas, changez ces références pour qu'elles reflètent la suppression.


Ouverture d'un affichage

Pour ouvrir un affichage :

1	Choisissez Fichier [image] Ouvrir pour afficher la boîte de dialogue Filtre.

2	Sélectionnez le bouton d'option approprié :

•	Système de fichiers, si l'affichage est enregistré dans un fichier,

•	Base de données, si l'affichage est enregistré dans la base de données.

3	Sélectionnez la case à cocher Affichages ou Tous les fichiers, puis sélectionnez OK.

4	Sélectionnez un affichage à ouvrir, puis sélectionnez OK.


Préparation des affichages en vue de leur exécution

  Rubriques connexes

Pour préparer un affichage en vue de son exécution :

Indiquez la dimension de la présentation :

1	Choisissez Affichage [image] Options d'affichage [image] Présentation dans le menu.

2	Modifiez la taille Horizontale et Verticale par défaut dans le champ Taille.

3	Choisissez le bouton d'option Pouces ou Centimètres.

4	Sélectionnez OK pour accepter les paramètres de taille de la présentation et fermer la boîte de dialogue.

Les paramètres de taille sont appliqués à la présentation de votre affichage. Vous pouvez utiliser ces paramètres pour déterminer la taille de la fenêtre dans laquelle apparaît l'affichage.

Définition des propriétés de la fenêtre par défaut :

Par défaut, Graphics Builder ouvre chaque affichage dans une fenêtre appelée Présentation principale. Vous pouvez modifier les propriétés de la fenêtre par défaut suivantes :

•	position de la présentation lors de l'exécution,

•	tailles horizontale et verticale de la fenêtre,

•	nom de la fenêtre.

Si vous voulez définir des propriétés pour la fenêtre par défaut, utilisez un déclencheur d'affichage de la manière suivante :

PROCEDURE OGTRIGGERPROC0 IS
  the_win    OG_WINDOW;
  win_pos    OG_POINT;
  win_wid    NUMBER;
  win_ht     NUMBER;
BEGIN
  the_win:=OG_GET_WINDOW('Présentation principale');

/*Définir la position de la fenêtre*/
  win_pos.x:=1*OG_INCH;
  win_pos.y:=.5*OG_INCH;

/*Définir la propriété de position de la fenêtre*/
  OG_SET_POSITION(the_win, win_pos);

/*Définir la taille de la fenêtre */
  win_wid:=4*OG_APP.HSCREEN_RES;
  win_ht:=5*OG_APP.VSCREEN_RES;

/*Définir la propriété de taille de la fenêtre*/
  OG_SET_WINDOW_SIZE(the_win, win_wid, win_ht);

/*Attribuer un nom à la fenêtre */
  OG_SET_WINDOW_NAME(the_win, 'Commencer ici');
END;

Lorsqu'il est ouvert dans Graphics Builder Runtime, l'affichage apparaît dans une fenêtre de 4x5 avec le titre 'Commencer ici' à la position de coordonnées (1, 0,5).

Indication des unités de présentation :

Définissez les tailles horizontale et verticale de la fenêtre de présentation en utilisant les constantes HSCREEN_RES et VSCREEN_RES de OG_APP qui sont semblables à OG_INCH, mais utilisées exclusivement pour les dimensions des fenêtres.

Les résolutions des présentations horizontale et verticale sont toujours égales. Les constantes OG_APP.HSCREEN_RES et OG_APP.VSCREEN_RES représentent le nombre d'unités de présentation (en pixels) d'un pouce horizontal et d'un pouce vertical, respectivement. Cette unité de mesure garantit que votre fenêtre d'affichage se présente de façon identique, quelle que soit la résolution de l'écran utilisée.

Utilisez le type de données intégrées OG_POINT PL/SQL pour représenter les coordonnées (x.y) de la présentation. La valeur (0,0) représente l'angle supérieur gauche de l'affichage. Ces coordonnées sont exprimées en unités de présentation.


A propos de la génération des affichages

Lorsque vous générez une version runtime d'un affichage, elle ne contient que les éléments nécessaires pour son exécution avec les exécutables Graphics Builder Runtime ou Batch. Par exemple, un affichage généré ne contient pas de code source PL/SQL.


Génération d'un affichage

Pour générer un affichage :

1	Choisissez Fichier [image] Administration [image] Générer [image] Système de fichiers ou Base de données, en fonction de l'endroit où l'affichage doit être enregistré.

2	Entrez le nom du fichier d'affichage runtime ou acceptez le nom par défaut.

Les affichages de Graphics Builder runtime utilisent par défaut le suffixe de fichier .ogr.

3	Sélectionnez OK pour générer une version runtime de l'affichage.


A propos du test des affichages

  Rubriques connexes

Dans Builder, vous pouvez tester l'exécution de votre affichage en accédant au débogueur de Graphics Builder. Lorsque vous sélectionnez un affichage qui doit s'exécuter dans le débogueur, Graphics Builder exécute la version stockée de l'affichage. Si votre affichage est ouvert dans Builder, vous devez donc veiller à enregistrer vos dernières modifications avant de l'exécuter.


Exécution d'un affichage ouvert

Pour exécuter un affichage ouvert :

1	Sélectionnez l'objet d'affichage dans le Navigateur.

2	Sélectionnez le bouton Exécuter dans la barre d'outils pour ouvrir l'affichage dans la fenêtre Présentation principale du débogueur de Graphics Builder, qui simule l'exécution runtime de votre affichage.

3	Choisissez Fichier [image] Fermer pour fermer le débogueur lorsque vous avez terminé.

Si vous modifiez un affichage dans Builder pendant qu'il est ouvert dans le débogueur, les modifications ne seront visibles dans le débogueur que lorsque vous enregistrerez l'affichage et que vous le réexécuterez. Si vous éditez des unités de programme PL/SQL dans le débogueur, vous pouvez incorporer vos modifications dans Builder en utilisant Edition [image] Synchroniser les unités de programme.


Exécution d'un affichage fermé

Pour exécuter un affichage fermé :

1	Choisissez Fichier [image] Exécuter pour afficher la boîte de dialogue Filtre.

2	Sélectionnez les paramètres de la boîte de dialogue, puis sélectionnez OK pour ouvrir la boîte de dialogue Ouverture depuis la base ou la boîte de dialogue de fichiers de votre système d'exploitation.

3	Sélectionnez un affichage dans la liste résultante.

4	Acceptez la boîte de dialogue pour la fermer et exécuter l'affichage sélectionné.

5	L'affichage est ouvert dans la fenêtre Présentation principale du débogueur de Graphics Builder, qui simule l'exécution de votre affichage.

6	Choisissez Fichier [image] Fermer pour fermer le débogueur lorsque vous avez terminé.


Impression d'affichages

Pour imprimer un affichage :

1	Choisissez Fichier [image] Imprimer pour afficher la boîte de dialogue d'impression de votre système.

2	Indiquez les options d'impression appropriées pour votre système.

3	Acceptez la boîte de dialogue pour lancer l'impression.

Si votre affichage contient plusieurs couches, seules celles qui sont affichées sont imprimées.


Configuration des pages à imprimer

Pour configurer les pages à imprimer :

1	Choisissez Fichier [image] Configuration de l'imprimante pour afficher la boîte de dialogue de configuration d'imprimante de votre système.

2	Indiquez les options d'impression de votre système.

3	Acceptez la boîte de dialogue.

Les paramètres restent en vigueur pendant toute la session Graphics Builder en cours.


A propos du chaînage d'affichages

La procédure PL/SQL interne OG_OPEN_DISPLAY permet d'ouvrir un affichage à partir d'un autre. Dans ce cas, vous pouvez soit garder l'affichage d'origine ouvert, soit le fermer.

Si vous décidez d'ouvrir un nouvel affichage et de fermer l'affichage d'origine, vous devez vous assurer que le sous-programme OG_CLOSE_DISPLAY est le dernier de la pile, afin d'être certain que tous les autres sous-programmes ont fini de s'exécuter lorsque le sous-programme de fermeture d'affichage est appelé. Les sous-programmes figurant après OG_CLOSE_DISPLAY ne seront pas appelés. Lorsque le sous-programme OG_CLOSE_DISPLAY s'exécute, le déclencheur de fermeture d'affichage, s'il existe, est exécuté.

Par exemple :

PROCEDURE next_display IS
  next_disp  OG_DISPLAY;
  old_disp   OG_DISPLAY;
BEGIN
  next_display:=OG_OPEN_DISPLAY('more.ogd', OG_FILESYSTEM);
  old_disp:=OG_GET_DISPLAY('plan.ogd');
  OG_CLOSE_DISPLAY(old_disp);
END;


A propos de la création de packages

  Rubriques connexes

Un package est un ensemble de procédures, de fonctions, de types de données, de variables et d'autres éléments PL/SQL liés, stockés sous la forme d'un objet dans la base de données. Les affichages peuvent partager des variables globales stockées dans un package dans la mesure où tous les affichages concernés ont la même connexion à la base de données.

Lorsqu'un affichage est déconnecté, l'état du package est réinitialisé. Pour être certain que vos affichages maintiennent leur connexion à la base de données, utilisez la procédure PL/SQL OPEN_DISPLAY interne pour ouvrir un affichage à partir d'un autre.

Le package que vous créez doit contenir les définitions de variables et les sous-programmes de manipulation des variables (c'est-à-dire les procédures de définition de la valeur des variables et les fonctions permettant d'extraire cette valeur). Vous pouvez faire référence à la variable et aux sous-programmes associés dans tout affichage qui partage la connexion à la base de données.

L'exemple ci-après porte sur une spécification de package et un corps qui contient une variable globale bar et deux sous-programmes :

PACKAGE foo IS
  bar  VARCHAR2;
  PROCEDURE set_bar (txt VARCHAR2);
  FUNCTION get_bar return VARCHAR2;
 END;

PACKAGE BODY foo IS
  PROCEDURE set_bar (txt VARCHAR2) IS
    BEGIN
      foo.bar:=txt;
    END;

  FUNCTION get_bar RETURN VARCHAR2 IS
    BEGIN
      return foo.bar;
    END;
END;

Lorsque vous avez créé le package, vous pouvez faire référence à la variable globale et manipuler sa valeur d'un affichage à l'autre, en utilisant les sous-programmes stockés. Par exemple :

PROCEDURE set_param IS
BEGIN
/*attribuer le paramètre local 'param' à la valeur de la
variable globale bar*/

  :param:=foo.get_bar;

/*changer la valeur de bar pour la prochaine
référence*/

  foo.set_bar('objet1');
END;

Pour plus d'informations sur la création de packages PL/SQL, reportez-vous à PL/SQL User's Guide and Reference.


A propos des fenêtres

Dans Graphics Builder, les fenêtres peuvent être utilisées comme zone de travail et comme zone d'affichage.

Dans Builder, les fenêtres sont des zones de travail rectangulaires qui contiennent des éléments d'interface Graphics Builder : éditeurs, tables et explorateurs. Vous pouvez ouvrir plusieurs fenêtres, mais il ne peut y avoir qu'une fenêtre active à la fois.

La configuration par défaut de la fenêtre définit le nombre et la position des fenêtres qui apparaissent lorsque vous ouvrez un affichage. Par défaut, la fenêtre Editeur de présentation est la seule fenêtre ouverte. Cependant, vous pouvez modifier la configuration et l'enregistrer comme nouvelle configuration par défaut, en utilisant la boîte de dialogue Préférences.

Vous pouvez également créer des fenêtres par programme pour présenter des objets dans différentes zones de la présentation, lors de l'exécution. Par défaut, les objets d'un affichage apparaissent dans la fenêtre Présentation principale. PL/SQL vous permet de créer d'autres fenêtres dans lesquelles vous pouvez présenter des objets. Vous pouvez également définir la taille et la position d'une fenêtre, et le moment où elle doit être ouverte ou fermée.


A propos du contrôle de la visibilité des fenêtres

Vous pouvez contrôler davantage les fenêtres utilisant votre application Runtime, à l'aide des options suivantes :

Masquer	Pour masquer momentanément une fenêtre que vous risquez de vouloir réafficher ultérieurement.
Afficher	Pour afficher une fenêtre précédemment masquée.
Détruire	Pour fermer une fenêtre dont vous n'avez plus besoin. Il peut s'agir d'une fenêtre qui a été ouverte à partir d'un affichage existant.
Remarque : Vous ne pouvez pas détruire la fenêtre Présentation principale par défaut. Pour détruire ce type de fenêtre, utilisez OG_CLOSE_DISPLAY, sinon utilisez OG_HIDE_WINDOW.


A propos de l'utilisation des couches avec des fenêtres

Si votre affichage contient plusieurs couches, vous pouvez activer, masquer et afficher une couche sur plusieurs fenêtres, ce qui équivaut à ouvrir un autre affichage. Chaque couche peut être présentée dans une fenêtre distincte, pour que l'utilisateur puisse voir plusieurs couches d'un même affichage.

Vous pouvez manipuler des couches d'une fenêtre à l'autre en utilisant les procédures internes PL/SQL OG_ACTIVATE_LAYER, OG_HIDE_LAYER et OG_SHOW_LAYER. Chacune de ces procédures a un argument d'identificateur de fenêtre facultatif. Si vous n'indiquez pas d'identificateur de fenêtre spécifique pour la procédure, Graphics Builder exécute l'action indiquée sur chaque fenêtre dans laquelle figure la couche.

Les utilisateurs ne peuvent agir sur la fenêtre de la couche active. N'oubliez pas que vous ne pouvez pas masquer la couche active. Vous devez commencer par activer une nouvelle couche, puis masquer l'ancienne.

L'exemple suivant porte sur une unité de programme qui active une seconde couche de l'affichage dans une nouvelle fenêtre :

PROCEDURE activate_layer IS
  new_layer   OG_LAYER;
  old_layer   OG_LAYER;
  new_window  OG_WINDOW;
BEGIN
  new_layer:=OG_GET_LAYER('couche1');
  old_layer:=OG_GET_LAYER('couche0');
  new_window:=OG_GET_WINDOW('Détails');
  OG_ACTIVATE_LAYER(new_layer, new_window);
END;


Utilisation des redirections de base de données

Pour utiliser des redirections de base de données

1	Utilisez la procédure PACK_MESSAGE pour ajouter des informations au tampon local de messages.

2	Utilisez la procédure SEND_MESSAGE pour indiquer la redirection qui sera utilisée pour la transmission des informations dans le tampon de messages.

3	Utilisez la procédure RECEIVE_MESSAGE pour recevoir le message sur la redirection indiquée.

4	Utilisez la procédure UNPACK _MESSAGE pour accéder aux informations stockées dans le tampon.

La procédure suivante condense une valeur de variable dans un tampon de messages, puis envoie le contenu du tampon au serveur en utilisant une redirection appelée 'la_redirection".

PROCEDURE pass_var (my_var NUMBER) IS
 stat  NUMBER;
BEGIN
  DBMS_PIPE.PACK_MESSAGE(my_var);
  stat:=DBMS_PIPE.SEND_MESSAGE('la_redirection', 30, 8192);
END;

Remarque : A l'heure actuelle, Graphics Builder ne reconnaît pas les valeurs par défaut des arguments des spécifications des sous-programmes stockés. Bien que DBMS_PIPE.SEND_MESSAGE fournisse des valeurs par défaut pour ses arguments TIMEOUT et MAXPIPESIZE, vous devez donc fournir des valeurs explicites.

La procédure suivante peut être exécutée à partir d'un second affichage qui partage la même connexion à la base de données :

PROCEDURE get_var IS
  my_var  NUMBER;
  stat    NUMBER;
BEGIN
/*Recevoir la redirection du serveur */
  stat:=DBMS_PIPE.RECEIVE_MESSAGE('la_redirection', 30);
/*Décompresser les informations stockées dans la redirection et les stocker dans my_var*/
  DBMS_PIPE.UNPACK_MESSAGE(my_var);
/*Utiliser la valeur de la variable pour exécuter une opération*/
  use_variable(my_var);
END;

Pour plus d'informations sur le package DBMS_PIPE, reportez-vous à Oracle7 Server Application Developer's Guide.


Création de nouvelles fenêtres

Pour créer une nouvelle fenêtre :

 Utilisez la fonction PL/SQL intégrée OG_MAKE_WINDOW pour créer une nouvelle fenêtre. Elle permet de créer plusieurs fenêtres pour un affichage runtime, et donc d'afficher des couches différentes d'un affichage dans des fenêtres différentes, ou de chaîner des affichages en en ouvrant un à partir d'un autre.

Par exemple :

PROCEDURE make_win IS
  nu_win   OG_WINDOW;
  win_pos  OG_INCH;
  win_wid  NUMBER;
  win_ht   NUMBER;
BEGIN
  win_pos.x:=0*OG_INCH;
  win_pos.y:=0*OG_INCH;
  win_wid:=7*OG_APP.VSCREEN_RES;
  win_ht:=6*OG_APP.HSCREEN_RES;

  nu_win:=OG_MAKE_WINDOW(win_pos, win_wid, win_ht);
  OG_SET_NAME(nu_win, 'Graphique détail');
END;


Masquage des barres de défilement de fenêtre

Pour masquer les barres de défilement de fenêtre :

 Utilisez l'enregistrement d'attribut PL/SQL intégré OG_SCROLLBARS_WINDOWA.

Par exemple :

PROCEDURE make_window IS
  the_window  OG_WINDOW;
  windo_attr  OG_WINDOW_ATTR;
BEGIN
  windo_attr.name:='Stock';
  windo_attr.scrollbars:=FALSE;
  windo_attr.width:=4*OG_APP.HSCREEN_RES;
  windo_attr.height:=5*OG_APP.VSCREEN.RES;
  windo_attr.mask:=OG_NAME_WINDOWA+
OG_SCROLLBARS_WINDOWA+
OG_SIZE_WINDOWA;
  the_window:=OG_MAKE(windo_attr);
END;

Vous ne pouvez pas modifier les enregistrements d'attributs d'une fenêtre existante. Si vous voulez masquer les barres de défilement d'une fenêtre, vous devez masquer ou détruire cette fenêtre et en créer une nouvelle. Notez que vous ne pouvez pas détruire la fenêtre d'origine par défaut, appelée 'Présentation principale'.

Si vous voulez masquer les barres de défilement de la fenêtre initiale de votre affichage d'exécution, vous devez créer un déclencheur d'ouverture d'affichage qui crée une nouvelle fenêtre, sans barre de défilement, et masque la fenêtre 'Présentation principale'.


Masquage de fenêtres

Pour masquer une fenêtre :

 Utilisez la procédure PL/SQL interne OG_HIDE_WINDOW, qui vous permet de masquer temporairement une fenêtre, et de la réafficher ultérieurement.

L'exemple suivant porte sur une procédure bouton activée lorsqu'un utilisateur sélectionne un élément de graphique.

PROCEDURE OGBUTTONPROC0 (buttonobj IN og_object, hitobj IN og_object, win IN og_window, eveninfo IN og_event) IS
  curr_window  OG_WINDOW;
BEGIN
  curr_window:=OG_GET_WINDOW('Présentation principale');
  OG_HIDE_WINDOW('Présentation principale');
END;


Affichage de fenêtres

Pour afficher une fenêtre :

 Utilisez la procédure PL/SQL interne OG_SHOW_WINDOW.

Par exemple :

PROCEDURE show_window IS
  back_window  OG_WINDOW;
BEGIN
  back_window:=OG_GET_WINDOW('Détails');
  OG_SHOW_WINDOW(back_window);
END;


Destruction de fenêtres

Pour détruire des fenêtres :

 Utilisez la procédure PL/SQL interne OG_DESTROY, qui vous permet de détruire les fenêtres que vous avez créées avec OG_MAKE_WINDOW ou OG_MAKE(Window). OG_DESTROY ferme la fenêtre sans que son contenu soit modifié.

Pour fermer toutes les fenêtres associées à un affichage, utilisez la procédure PL/SQL interne OG_CLOSE_DISPLAY.

Remarque : Vous ne pouvez pas détruire une fenêtre 'Présentation principale' par défaut.

La procédure suivante détruit une fenêtre :

PROCEDURE close_window (the_window IN og_window) IS
BEGIN
  OG_DESTROY(the_window);
END;


A propos des modèles de graphique

Un modèle de graphique définit le format d'un graphique et ses différentes propriétés. Un graphique ne peut être associé qu'à un modèle de graphique à la fois. Cependant, vous pouvez exécuter sur un modèle de graphique les actions indiquées ci-dessous, puis utiliser ce modèle pour appliquer les propriétés à plusieurs graphiques.

•	Indiquer les propriétés d'encadrement d'axe

•	Indiquer les propriétés d'axe discret, continu et de date

•	Déplacer la légende

•	Définir des lignes de référence

•	Indiquer des formats de nombre et de date

•	Indiquer des propriétés de texte et de ligne

•	Indiquer des couleurs et des motifs

Chaque modèle de graphique peut être associé à un ou à plusieurs modèles de champ qui définissent les propriétés des champs (barres, colonnes, secteurs ou lignes).

Graphics Builder offre 56 modèles de graphique par défaut, répartis en 10 catégories.(barres, lignes et secteurs). Lorsque vous créez un graphique d'un type et d'un sous-type particuliers, Graphics Builder copie le modèle de graphique par défaut associé à ce type. Vous pouvez personnaliser cette copie, mais vous ne pouvez pas modifier les modèles de graphique par défaut eux-mêmes.

Lorsque Graphics Builder copie le modèle pour que vous puissiez l'utiliser, il lui attribue le nom modèlex, où x est une valeur numérique qui est incrémentée chaque fois que vous créez un nouveau modèle de graphique pour l'affichage en cours. Lorsque vous avez personnalisé un modèle de graphique, vous pouvez l'attribuer à plusieurs graphiques en le sélectionnant dans la liste déroulante Modèles de la fenêtre de propriétés Graphique pendant la création du graphique.

Pour personnaliser des modèles de graphique, utilisez l'Editeur de modèle de graphique.


A propos des composants d'un modèle de graphique

Les composants d'un modèle de graphique se répartissent en deux catégories principales :

•	Encadrements de graphique

•	Modèles de champ


A propos des encadrements de graphique

Les encadrements de graphique regroupent des composants de la structure de base du graphique, comme son étiquette d'axe, ses polices et la position de ses légendes. Un modèle de graphique ne peut avoir qu'un encadrement.

Lorsque vous sélectionnez un modèle de graphique pour la première fois, l'encadrement du graphique est ce qui apparaît dans l'Editeur de modèle de graphique par défaut.


A propos des modèles de champ

Les modèles de champ regroupent les composants qui déterminent comment les données (dépendantes) de valeurs sont représentées sous la forme de champs de graphique, comme des barres ou des lignes. Un modèle de graphique a au moins un modèle de champ par défaut, mais vous pouvez en créer d'autres, pour les associer à différentes valeurs de graphique (colonnes d'interrogation).

Vous pouvez visualiser un modèle de champ lorsque l'encadrement du graphique est affiché dans l'Editeur de modèle de graphique en choisissant le bouton d'option du modèle Champ en haut de l'éditeur.


A propos des propriétés de modèle de graphique

Les propriétés de modèle de graphique définissent l'aspect et le comportement de l'encadrement du graphique et des composants du modèle de champ. Les propriétés applicables et la façon dont vous les définissez dépendent du type de modèle de graphique. En général, vous définissez les propriétés de modèle de graphique dans l'Editeur de modèle de graphique en sélectionnant un composant, en ouvrant sa fenêtre de propriétés ou le menu Format, et en choisissant les options qui vous intéressent.


A propos de l'Editeur de modèle de graphique

Chaque affichage ne contient qu'un éditeur de Modèle de graphique. Bien que vous puissiez définir plusieurs modèles de graphique dans un même affichage, vous ne pouvez en visualiser ou en modifier qu'un à la fois dans l'Editeur de modèle de graphique.

Notez que l'Editeur de modèle de graphique, comme l'Editeur de présentation, vous permet de définir plusieurs vues en faisant glisser les barres de partage dans l'angle inférieur droit. Cette opération vous permet d'afficher un modèle de graphique dans une vue, et ses modèles de champ dans une autre.

Les différents composants de l'Editeur de modèle de graphique sont les suivants :

Editeur d'encadrement

Editeur de modèle de champ

Palette d'outils


A propos de l'Editeur d'encadrement

L'Editeur d'encadrement est l'endroit où vous sélectionnez et modifiez des éléments de l'encadrement du graphique. L'encadrement détermine la structure de base du graphique, et n'a que peu de rapport avec les données qui seront tracées. L'aspect de l'encadrement dans l'éditeur représente la façon dont le graphique apparaîtra lorsqu'il sera créé. Vous pouvez modifier la police, la couleur et les autres propriétés graphiques des éléments de l'encadrement et voir immédiatement le résultat. Vous pouvez également déplacer la légende (le cas échéant) en faisant glisser sa boîte (et non le texte) jusqu'à son nouvel emplacement.


A propos de l'Editeur de modèle de champ

L'Editeur de modèle de champ est l'endroit où vous sélectionnez et modifiez les éléments des modèles de champ du graphique. Un modèle de champ détermine la façon dont un ensemble de données apparaîtra sur le graphique. Lorsque vous créez un graphique, vous devez associer des colonnes de l'interrogation à des modèles de champ spécifiques. Les propriétés graphiques des modèles de champ déterminent la façon dont les données seront tracées sur le graphique.


A propos de la Palette d'outils de l'Editeur de modèle de graphique

La Palette d'outils de l'Editeur de modèle de graphique contient un outil de sélection ainsi que des indicateurs d'affichage de lignes, de remplissage de texte, une palette de couleurs de ligne, une palette de couleurs de remplissage (une palette de motifs), une palette de couleurs de texte et des palettes de symboles.


A propos de la sélection d'un modèle de graphique

Si vous sélectionnez Outils [image] Modèles dans le menu sans commencer par sélectionner un graphique, l'Editeur de modèle de graphique apparaît avec le modèle de graphique en cours. Le modèle de graphique en cours est celui qui était sélectionné en dernier dans l'Editeur de modèle de graphique. Vous pouvez sélectionner un autre modèle par défaut ou un modèle de graphique personnalisé qui deviendra le modèle de graphique "en cours".


A propos de la personnalisation de modèles de graphique

  Rubriques connexes

Avant d'éditer l'encadrement de graphique du modèle de graphique en cours, assurez-vous qu'il est affiché dans l'Editeur de modèle de graphique, afin que vous puissiez vérifier vos modifications :

  Dans l'Editeur de modèle de graphique, sélectionnez le bouton d'option Encadrement pour afficher l'encadrement du graphique.

Pour personnaliser les propriétés d'axe et d'encadrement d'un modèle de graphique, procédez comme pour personnaliser les propriétés d'axe et d'encadrement d'un graphique.

Lorsque les sections ci-dessous font référence à des options de menu et à des outils, utilisez les options de menu et les outils de l'Editeur de modèle de graphique.

Vous pouvez non seulement personnaliser les propriétés d'encadrement et d'axe du modèle, mais aussi un ou plusieurs modèles de champ que vous utiliserez avec le modèle de graphique.


A propos de la gestion des modèles de graphiques exportés
A propos de la gestion des modèles de graphique exportés

Lorsque vous avez créé et personnalisé un modèle de graphique, vous pouvez utiliser le Navigateur d'objet ou l'Editeur de modèle de graphique pour l'exporter dans le système de fichiers ou dans la base de données, afin de pouvoir l'utiliser dans d'autres affichages.

Vous pouvez importer un modèle de graphique préalablement exporté du Navigateur d'objet ou de l'Editeur de modèle de graphique.


Création d'un modèle de graphique

Pour créer un modèle de graphique :

1	Dans le Navigateur d'objet, sélectionnez le noeud Modèles, puis le bouton Créer dans la barre d'outils.

2	Acceptez le type de graphique par défaut (à colonnes) ou choisissez un autre type et sous-type de graphique dans le menu Type.

3	Acceptez le nom de modèle de graphique par défaut (modèlex) ou éditer le nom en choisissant Modèle [image] Renommer pour afficher la boîte de dialogue de changement de modèle.

4	Personnalisez les propriétés d'encadrement et d'axe de graphique comme vous le désirez.

5	Choisissez Fichier [image] Fermer pour fermer l'Editeur de modèle de graphique lorsque vous avez terminé.

Vous pouvez créer un modèle de graphique personnalisé avant de créer des graphiques. Lorsque vous avez créé (et personnalisé) un modèle de graphique, vous pouvez l'attribuer à des graphiques de la fenêtre de propriétés Graphique en sélectionnant le nom du modèle dans la liste déroulante Modèles.

En outre, vous pouvez exporter un modèle de graphique dans le système de fichiers ou dans la base de données afin de pouvoir l'utiliser dans d'autres affichages.


Sélection d'un modèle de graphique par défaut

Pour sélectionner un modèle de graphique par défaut :

1	Choisissez Outils [image] Modèles pour afficher l'Editeur de modèle de graphique.

2	Sélectionnez un type de graphique (secteurs, par exemple) dans le menu Type.

3	Choisissez l'un des modèles de graphique affichés dans le sous-menu correspondant à ce type de graphique.

L'encadrement du graphique du modèle de graphique par défaut que vous avez sélectionné apparaît dans l'Editeur de modèle de graphique. Il reste le modèle de graphique en cours jusqu'à ce que vous en créiez ou en éditiez un autre.

4	Fermez l'Editeur de modèle de graphique en choisissant Fichier [image] Fermer.

Ce type de graphique est désormais le modèle de graphique en cours. Lorsque vous sélectionnez Outils [image] Modèles dans le menu, ce modèle de graphique apparaît dans l'Editeur de modèle de graphique.


Sélection d'un modèle de graphique personnalisé

Pour sélectionner un modèle de graphique personnalisé :

1	Choisissez Outils [image] Modèles pour afficher l'Editeur de modèle de graphique.

2	Dans l'Editeur de modèle de graphique, sélectionnez la liste déroulante Modèles pour afficher une liste des modèles personnalisés.

3	Choisissez l'un des modèles pour qu'il s'affiche dans l'Editeur de modèle de graphique.

Ce modèle reste le modèle de graphique en cours jusqu'à ce que vous en créiez  ou en éditiez un autre.

4	Fermez l'Editeur de modèle de graphique en choisissant Fichier [image] Fermer.

Ce type de graphique est désormais le modèle de graphique en cours. Lorsque vous sélectionnez Outils [image] Modèles dans le menu, ce modèle de graphique apparaît dans l'Editeur de modèle de graphique.


Import d'un modèle de graphique

Pour importer un modèle de graphique :

1	Sélectionnez le noeud Modèles dans le Navigateur d'objet ou choisissez Outils [image] Modèles pour afficher l'Editeur de modèle de graphique.

2	Choisissez Edition [image] Importer [image] Modèle pour afficher la boîte de dialogue d'import.

3	Sélectionnez le nom de fichier ou de module et son emplacement.

4	Sélectionnez OK pour importer dans l'affichage en cours le modèle de graphique indiqué.


Export d'un modèle de graphique

Pour exporter un modèle de graphique :

1	Sélectionnez l'objet Modèle dans le Navigateur d'objet ou sélectionnez le graphique que vous voulez exporter dans la liste déroulante Modèles de l'Editeur de modèle de graphique.

2	Choisissez Edition [image] Importer [image] Modèle pour afficher la boîte de dialogue d'export.

3	Sélectionnez les options d'export, telles que l'emplacement et le nom de fichier ou de module.

4	Sélectionnez OK pour exporter le modèle et fermer la boîte de dialogue d'exportation.


Changement de nom d'un modèle de graphique

Pour renommer un modèle de graphique dans le Navigateur d'objet :

1	Sélectionnez l'objet modèle de graphique à renommer.

2	Faites passer le pointeur de souris sur le nom du modèle de graphique.

Le curseur passe d'un pointeur à un éditeur de texte.

3	Sélectionnez une fois le nom pour positionner le curseur et passer en mode Edition.

Si vous voulez remplacer la totalité du nom, sélectionnez le nom pour le mettre en évidence, puis entrez le nouveau.

Pour renommer un modèle de graphique dans l'Editeur de modèle de graphique :

1	Sélectionnez le modèle de graphique que vous voulez renommer dans la liste déroulante Modèles.

Le modèle de graphique apparaît dans la présentation de l'éditeur.

2	Choisissez Modèle [image] Renommer pour afficher la boîte de dialogue de changement de nom de modèle.

3	Cliquez sur le nom du nouveau modèle dans le champ Nom de modèle.

4	Sélectionnez OK pour appliquer le nouveau nom et fermer la boîte de dialogue.

Remarque : Si vous renommez un modèle de graphique auquel vous avez fait référence dans des unités de programme PL/SQL, vous devez également modifier ces références en conséquence.


Suppression d'un modèle de graphique

Pour supprimer un modèle de graphique du Navigateur d'objet :

1	Sélectionnez l'objet de modèle de graphique dans le Navigateur d'objet.

2	Sélectionnez le bouton Supprimer ou choisissez Navigateur [image] Supprimer dans le menu.

3	Dans la boîte de message d'alerte, sélectionnez Oui pour confirmer.

Pour supprimer un modèle de graphique de l'Editeur de modèle de graphique :

1	Sélectionnez le modèle de graphique à supprimer dans la liste déroulante Modèles.

2	Choisissez Modèle [image] Supprimer.

Un message d'alerte vous demande de confirmer la suppression.

3	Sélectionnez Oui pour confirmer.

Remarque : Si vous supprimez un modèle de graphique auquel vous avez fait référence dans des unités de programme PL/SQL, vous devez également modifier ces références en conséquence.


A propos de la création, de la modification et de l'attribution de modèles de champ

Vous pouvez créer plusieurs modèles de champ pour un modèle de graphique si vous voulez attribuer des propriétés différentes aux champs de colonne de valeur. Chaque modèle de champ peut être attribué à un champ de colonne différent, à plusieurs champs de colonne de valeur, ou rester inutilisé jusqu'à ce que vous en ayez besoin. Les propriétés de champ comprennent différentes options (type de tracé, style de ligne, rotation d'étiquettes, etc.), qui sont fonction du type de graphique.

Lorsque vous avez créé un modèle de champ et l'avez personnalisé, vous pouvez l'attribuer à une colonne de valeur du graphique.


A propos de l'application de couleurs et de motifs à des modèles de champ

Pour appliquer des couleurs et des motifs à des modèles de champ, procédez comme pour les objets, mais utilisez les palettes de couleurs de l'Editeur de modèle de graphique au lieu de celles de l'Editeur de présentation. Les palettes de couleurs se comportent de la même manière.


Ajout d'un modèle de champ

Pour ajouter un modèle de champ :

1	Choisissez Modèles de champ dans le menu instantané ou choisissez Modèles [image] Modèles de champ pour afficher la fenêtre de propriétés Modèles de champ.

2	Sélectionnez Nouveau pour créer un nouveau modèle de champ, appelé au départ ftempx.

Vous pouvez renommer le nouveau modèle de champ ou conserver le nom par défaut.

3	Choisissez l'onglet Champ d'axe pour définir les propriétés des modèles de champ de graphique à axes.

4	Sélectionnez OK pour appliquer le nouveau modèle de champ et fermer la boîte de dialogue Modèles de champ.

Pour afficher un modèle de champ dans votre graphique, vous devez l'associer à une colonne de valeur.


Edition d'un modèle de champ

Pour éditer un modèle de champ :

1	Avant d'éditer un modèle de champ du modèle de graphique en cours, assurez-vous qu'il est affiché dans l'Editeur de modèle de graphique afin de pouvoir vérifier vos modifications.

2	Dans l'Editeur de modèle de graphique, sélectionnez le bouton d'option de modèle Champ pour afficher le modèle de champ en cours.

3	Sélectionnez dans la liste déroulante le modèle de champ à éditer.


Indication des propriétés d'un modèle de champ

Pour indiquer les propriétés d'un modèle de champ :

1	Sélectionnez l'objet graphique ou le graphique.

2	Choisissez la commande Modèles de champ dans le menu instantané ou choisissez Graphique [image] Modèles de champ pour afficher la fenêtre de propriété Modèles de champ.

3	Choisissez l'onglet Champ axe pour afficher la page de propriété Champ d'axe.

4	Indiquez les options de votre choix.

5	Sélectionnez OK pour appliquer les modifications au modèle de champ et fermer la fenêtre de propriété Modèle de champ.


Attribution d'un modèle de champ

Pour attribuer un modèle de champ :

1	Sélectionnez le graphique dans l'Editeur de présentation ou le Navigateur d'objet.

2	Choisissez Propriétés dans le menu instantané ou choisissez Outils [image] Propriétés pour afficher la fenêtre de propriété Graphique.

3	Choisissez l'onglet Valeurs pour afficher la page de propriété Valeurs du graphique.

4	Dans la liste Valeurs de graphique, sélectionnez la colonne de valeurs à laquelle vous voulez attribuer un modèle de champ.

5	Sélectionnez le modèle de champ dans la liste déroulante Modèles de champ.

6	Sélectionnez OK pour appliquer vos modifications et fermer la fenêtre de propriété Graphique.


Suppression d'un modèle de champ

Pour supprimer un modèle de champ :

1	Sélectionnez un objet graphique ou le graphique.

2	Choisissez la commande Modèles de champ dans le menu instantané ou choisissez Graphique [image] Modèles de champ pour afficher la fenêtre de propriété Modèle de champ.

3	Sélectionnez le modèle de champ à supprimer dans la liste déroulante Modèles de champ.

4	Sélectionnez Supprimer.

Un message d'alerte vous demande de confirmer la suppression.

5	Sélectionnez Oui pour confirmer.

6	Sélectionnez OK pour accepter les modifications et fermer la fenêtre propriété Modèle de champ

Si vous avez créé un graphique contenant une colonne de valeurs associée au modèle de champ supprimé, vous devez associer la colonne de valeurs à un autre modèle de champ avant de le supprimer.


A propos de PL/SQL

PL/SQL est une extension procédurale de SQL qui offre des éléments de programmation comme des boucles, des expressions conditionnelles et des procédures. L'utilisation de PL/SQL dans Graphics Builder vous permet d'avoir un plus grand contrôle sur le fonctionnement de vos affichages, de les rendre plus réactifs aux données en cours, aux actions de l'utilisateur et aux autres conditions existant lors de l'exécution. Vous pouvez utiliser PL/SQL dans vos affichages pour :

•	Créer et manipuler les objets, par exemple, animer un objet afin qu'il semble se déplacer sur la présentation.

•	Contrôler l'ordre d'exécution des opérations, par exemple, faire apparaître une couche particulière si l'utilisateur sélectionne un objet.

•	Contrôler la synchronisation des opérations, par exemple, provoquer le déclenchement d'une action à des intervalles particuliers.

•	Provoquer l'exécution conditionnelle d'opérations, par exemple, calculer les valeurs des données courantes et afficher différents objets en fonction des résultats.

•	Définir et interpréter des actions utilisateur, par exemple, afficher un message d'erreur si un utilisateur entre une instruction non valide.


A propos de la résolution de noms identiques

Si vous faites des références à des éléments PL/SQL comportant des noms en double, Graphics Builder les recherche dans l'ordre suivant :

1	Parmi les éléments suivants, sans ordre prédéfini :

•	unités de programme locales enregistrées avec un affichage,

•	procédures internes PL/SQL STANDARD,

•	procédures internes Graphics Builder.

2	Bibliothèques attachées.

3	Sous-programmes stockés.


A propos de l'indication des informations de coordonnées et de taille

La plupart des éléments intégrés font référence à des valeurs numériques qui indiquent une position sur la présentation, ou aux dimensions d'un objet, ou vous demandent d'y faire référence,. L'unité de mesure que vous devez utiliser pour ces valeurs porte le nom d'unité de présentation.

Les unités de présentation permettent de disposer d'un système de mesure cohérent pour les applications Graphics Builder qui peuvent s'exécuter sur différentes unités d'affichage, ayant chacune sa propre résolution d'affichage. Par exemple, 1 pouce sur une unité ayant une résolution d'écran de 72 lignes/pouce n'équivaut pas à 1 pouce sur une unité ayant une résolution d'écran de 90 lignes/pouce. Par contre, la résolution de présentation de Graphics Builder est la même sur tous les systèmes. En indiquant toutes vos mesures en unités de présentation, vous êtes certain que vos présentations restent cohérentes d'une unité d'affichage à l'autre.

Variable globale intégrée OG_INCH

Graphics Builder comporte une variable globale, appelée OG_INCH, qui est égale au nombre d'unités de présentation par pouce.

Par exemple, pour définir une région rectangulaire de trois pouces de haut et deux pouces de large, vous pouvez déclarer une variable locale :

   my_rect   OG_RECTANGLE;

vous pouvez alors utiliser la variable locale OG_INCH, comme dans les instructions suivantes :

   my_rect.height := 3 * OG_INCH;
   my_rect.width := 2 * OG_INCH;

Nous vous conseillons de ne pas déterminer et utiliser la valeur littérale de cette variable globale dans vos applications. Pour être certain que votre affichage s'exécute correctement dans la version actuelle et la future version de Graphics Builder, il est conseillé d'utiliser la variable globale intégrée prise en charge.


A propos des références aux objets Graphics Builder par utilisation d'identificateurs d'objets
A propos des références aux objets Graphics Builder par utilisation d'identificateurs d'objet

La plupart des sous-programmes intégrés vous permettent d'exécuter des opérations sur les objets Graphics Builder, une interrogation, par exemple, grâce à OG_EXECUTE_QUERY. Ces sous-programmes demandent que vous indiquiez l'objet que vous voulez manipuler.

Au lieu de faire référence à un objet par son nom, de nombreuses procédures internes, fonctions et types de données demandent l'utilisation d'un identificateur (c'est-à-dire d'un pointeur) de l'objet. Par exemple, pour exécuter une interrogation, vous devez transmettre l'identificateur de l'interrogation à OG_EXECUTE_QUERY :

PROCEDURE getdata IS
  query_handle  OG_QUERY;
BEGIN
  query_handle := OG_GET_QUERY('interrogation0');
  OG_EXECUTE_QUERY(query_handle);
END;

Lectures d'identificateurs d'objet

Graphics Builder comporte un ensemble de fonctions intégrées permettant d'obtenir l'identificateur d'un objet. Chacune de ces fonctions retourne une valeur d'un type de données spécifique, qui est fonction du type d'objet dont elle extrait l'identificateur.

Le tableau suivant fournit la liste des objets Graphics Builder dont vous pouvez lire les identificateurs, les fonctions utilisées pour les lire, et le type de données de la valeur de retour :

Type d'objet	Fonction	Type de données de retour

Axe	OG_GET_AXIS	OG_AXIS
Procédure bouton	OG_GET_BUTTONPROC	OG_BUTTONPROC
Modèle de graphique	OG_GET_TEMPLATE	OG_TEMPLATE
Affichage	OG_GET_DISPLAY	OG_DISPLAY
Modèle de champ	OG_GET_FTEMP	OG_FTEMP
Objet graphique	OG_GET_OBJECT	OG_OBJECT
Couche	OG_GET_LAYER	OG_LAYER
Interrogation	OG_GET_QUERY	OG_QUERY
Ligne de référence	OG_GET_REFLINE	OG_REFLINE
Son	OG_GET_SOUND	OG_SOUND
Horloge	OG_GET_TIMER	OG_TIMER
Fenêtre	OG_GET_WINDOW	OG_WINDOW
Pourquoi utiliser des identificateurs ?

L'utilisation d'identificateurs à la place de noms permet d'améliorer l'efficacité : chaque fois que vous faites référence à un élément en indiquant son nom, Graphics Builder doit rechercher, dans tous les éléments existants de ce type, celui dont le nom correspond à celui que vous avez indiqué. Cette approche, extrêmement longue, est utilisée par les fonctions énumérées ci-dessus pour trouver l'élément indiqué. Cependant, une fois l'élément trouvé, le système crée un identificateur qui pointe directement sur cet élément. Grâce à l'identificateur, Graphics Builder n'a pas à rechercher le nom de l'élément chaque fois que vous y faites référence.

La meilleure façon de "stocker" les identificateurs consiste à utiliser des variables. Déclarez les variables que vous utiliserez au début de votre unité de programme, en leur donnant un nom et un type de données.

Vous pouvez alors attribuer la variable à la valeur retournée par la fonction. Pour reprendre l'exemple ci-dessus, la variable "query_handle" est déclarée comme étant de type OG_QUERY, qui est le type de données retourné par la fonction OG_GET_QUERY.

La première ligne de la procédure attribue la variable query_handle à la valeur retournée par la fonction OG_GET_QUERY. Vous pouvez alors utiliser la variable query_handle à tout endroit de l'unité de programme qui demande l'identificateur d'objet pour l'interrogation stockée dans la variable.


A propos des unités de programme

Les unités de programme sont des structures de code que vous pouvez créer en utilisant PL/SQL. Vous pouvez utiliser Graphics Builder pour écrire des unités de programme PL/SQL, ou utiliser votre propre éditeur et importer ou exporter des unités de programme.

Dans Graphics Builder; vous pouvez utiliser deux types d'unités de programme PL/SQL :

•	sous-programmes

•	packages

Après avoir utilisé le Navigateur d'objet pour créer une unité de programme ou y accéder, vous pouvez éditer cette unité de programme à l'aide d'un éditeur d'unités de programme PL/SQL. Utilisez l'éditeur pour écrire et déboguer votre code.

Pour plus d'informations sur l'utilisation de l'éditeur, reportez vous à "Using the Program Unit Editor" dans le chapitre "Working with PL/SQL Constructs" de Procedure Builder Developer's Guide.


A propos des sous-programmes

Les sous-programmes sont des procédures et des fonctions PL/SQL que vous pouvez créer dans Graphics Builder.

Une procédure permet d'exécuter les séquences d'actions indiquées. Par exemple, une procédure peut mettre à jour un graphique en fonction de nouvelles données. Vous pouvez créer deux types spéciaux de procédure Graphics Builder :

Procédure bouton	Procédure, associée à un objet ou à une couche, qui est exécutée lorsqu'un événement de souris spécifique se produit lors de l'exécution : bouton souris relâché/enfoncé, ou mouvement souris bouton relâché/enfoncé.
Procédure déclencheur	Procédure qui est exécutée lorsqu'un déclencheur est activé. Exemples de déclencheurs : ouverture de l'affichage, fermeture de l'affichage, écoulement d'un intervalle de temps donné, exécution d'une interrogation.
Une fonction permet d'exécuter une séquence d'actions spécifique, puis de retourner une valeur. Par exemple, une fonction peut calculer et retourner la taxe sur les ventes d'un article. Vous pouvez créer une fonction de filtre d'interrogation, qui est un type spécial de fonction Graphics Builder, qui filtre les données retournées par une interrogation et n'introduit dans le graphique que des valeurs qui répondent à une condition précise.


A propos des packages

Un package regroupe des procédures, des fonctions, des types de données, des variables, des constantes, des exceptions, des curseurs et d'autres éléments PL/SQL logiquement liés. Les éléments définis dans un package sont généralement appelés "en package" : fonctions en package, procédures en package, etc. Lorsque vous faites référence à un élément PL/SQL en package, vous devez faire précéder chaque occurrence du nom de l'élément du nom du package suivi d'un point (.).


A propos du chargement d'unités de programme dans des affichages

Dans certains cas, vous préférerez charger des unités de programme individuelles dans un affichage plutôt que d'attacher la bibliothèque PL/SQL dans laquelle une unité de programme est stockée. Le chargement des unités de programme individuelles n'est pas plus intéressant, sur le plan des performances, que l'attachement des bibliothèques.

Pour déterminer si vous devez charger des unités de programme au lieu d'attacher des bibliothèques, utilisez les critères suivants :

•	Vos bibliothèques sont très volumineuses et vous risquez d'avoir des problèmes de place.

•	Le transfert de votre affichage impliquerait que vous changiez tous les noms de chemins d'accès qui pointent sur la bibliothèque.

•	Votre affichage ne demande que quelques unités de programme et est plus facile à tenir à jour sans la bibliothèque attachée.


A propos des procédures internes PL/SQL

  Rubriques connexes

Graphics Builder comporte des extensions du langage PL/SQL qui sont utilisées spécifiquement pour la personnalisation du comportement des applications Graphics Builder. Ces éléments, appelés procédures internes, sont mis en oeuvre sous la forme d'extensions du package PL/SQL STANDARD.

Graphics Builder offre les types d'éléments intégrés suivants :

•	types de données,

•	variables globales,

•	sous-programmes,

•	exceptions.

Comme les procédures internes de Graphics Builder sont conçues pour vous permettre de contrôler par programme les caractéristiques et les fonctionnalités spécifiques, elles ne peuvent être utilisées que lors de la définition d'affichages Graphics Builder.

Vous pouvez utiliser toute procédure interne PL/SQL dans vos propres unités de programme, mais vous ne pouvez pas éditer les procédures internes elles-mêmes.


A propos des exceptions

Les exceptions permettent de détecter ou de localiser le succès ou l'échec d'unités de programme PL/SQL (par exemple, pour afficher une erreur si un utilisateur demande une action non valide lors d'une exécution). Les exceptions sont de deux types :

Exceptions définies par l'utilisateur	Dans Graphics Builder, vous pouvez déclarer, générer et gérer vos propres exceptions. Pour plus d'informations à propos des exceptions, reportez-vous à PL/SQL User's Guide and Reference.
Exceptions pré-définies	De nombreuses exceptions ont été pré-définies pour pouvoir être utilisées dans Graphics Builder. Pour exécuter une opération sur une exception pré-définie, vous devez écrire un gestionnaire d'exceptions. Ce type de gestionnaire définit les instructions qui sont exécutées lorsque certaines conditions ou exceptions sont générées dans une unité de programme PL/SQL. Lorsqu'une exception est générée, l'exécution normale s'arrête et le contrôle est transmis au gestionnaire d'exception approprié.


A propos de la création d'unités de programme

Pour créer des unités de programme :

1	Recherchez les procédures internes Graphics Builder dont vous avez besoin pour exécuter une action.

2	Recherchez dans les procédures les arguments que vous devez fournir,

sous la forme soit d'identificateurs retournés par les fonctions, soit d'arguments fournis à l'unité de programme que vous définissez, soit de valeurs absolues, en fonction de la définition de la procédure.

3	Déterminez, le cas échéant, les fonctions intégrées de Graphics Builder dont vous avez besoin pour extraire les arguments nécessaires.

4	Déterminez les variables que vous devrez définir pour stocker les valeurs retournées par les fonctions.


Création d'unités de programme

  Exemple

Pour créer des unités de programme :

1	Sélectionnez le noeud Unités de programme dans le Navigateur d'objet.

2	Sélectionnez le bouton Créer ou choisissez Navigateur [image] Créer pour afficher la boîte de dialogue Nouvelle unité de programme.

S'il n'existe pas encore d'unités de programme, cliquez deux fois sur le noeud Unités de programme pour en créer une nouvelle.

3	Sélectionnez le type d'unité de programme que vous voulez créer, entrez le nom d'unité de programme et sélectionnez OK.

l'Editeur d'unité de programme PL/SQL s'affiche, avec le nom de votre unité de programme dans le champ Nom.

4	Définissez votre unité de programme.

5	Sélectionnez Compiler pour compiler l'unité de programme.

6	Réglez les erreurs éventuelles.

Votre unité de programme ne doit comporter aucune erreur pour pouvoir être compilée correctement et utilisée dans votre affichage.

7	Sélectionnez Fermer pour fermer l'Editeur d'unité de programme lorsque vous avez terminé.


Exemple : création d'une unité de programme

Comme vous voulez créer une unité de programme qui active une couche de l'affichage, vous utiliserez la procédure interne PL/SQL OG_ACTIVATE_LAYER de Graphics Builder. Cette procédure demande un argument de type de données intégrées OG_LAYER. Pour obtenir cette valeur de type de données, utilisez la fonction OG_GET_LAYER et déclarez une variable de type de données OG_LAYER pour stocker la valeur retournée dans OG_GET_LAYER.

Pour revenir sur les étapes précédentes, créez la procédure suivante :

PROCEDURE act_layer IS
/*Déclarer la variable devant recevoir le retour de la fonction */
  the_layer  OG_LAYER;
BEGIN
/*Utiliser la fonction pour attribuer la valeur de la variable */
  the_layer:=OG_GET_LAYER('couche1');
/*Utiliser la valeur de la variable comme argument de la procédure */
  OG_ACTIVATE_LAYER(the_layer);
END;


Edition d'unités de programme

Pour éditer une unité de programme PL/SQL :

 Cliquez deux fois sur l'objet unité de programme que vous voulez éditer ou sélectionnez l'unité de programme et choisissez Propriétés dans le menu instantané. L'Editeur d'unité de programme s'affiche et indique la source de l'unité de programme

Editez l'unité de programme si nécessaire. Si vous éditez une unité de programme compilée, vous devez la recompiler après l'avoir modifiée.


Compilation d'unités de programme individuelles

Pour compiler des unités de programme individuelles :

1	Cliquez deux fois sur l'unité de programme, dans le Navigateur d'objet, pour ouvrir l'éditeur d'unité de programme.

Vous pouvez également choisir Outils [image] Unités de programme pour afficher l'Editeur d'unité de programme, puis choisir l'unité de programme dans la liste déroulante Nom.

La barre d'état Unité de programme indique si l'unité de programme a été correctement compilée.

2	Sélectionnez Compiler pour lancer l'opération.

Les erreurs éventuelles sont signalées dans l'Editeur d'unité de programme, sous le corps de l'unité de programme elle-même. Vous pouvez cliquer deux fois sur une erreur pour passer à sa source dans le corps de l'unité de programme.

Pour plus d'informations sur la compilation des unités de programme, reportez-vous au chapitre "Working with PL/SQL Constructs", dans Oracle Procedure Builder Developer's Guide.


Compilation d'unités de programme en mode Batch

Pour compiler par lots des unités de programme en mode Batch :

1	Choisissez Fichier [image] Compiler pour compiler en mode Batch les unités de programme non compilées de l'affichage, ou choisissez Fichier [image] Compiler tout pour (re)compiler toutes les unités de programme de l'affichage. La commande Compiler tout impose la recompilation des unités de programme déjà compilées.

La boîte de dialogue Compiler comporte un indicateur d'avancement et un champ défilable indiquant les erreurs de compilation.

2	Pour exécuter des opérations interactives pendant la compilation, vous pouvez choisir les boutons suivants :

•	Interrompre	Interrompt la compilation.

•	Reprendre	Reprend la compilation en mode Batch après une interruption.

•	OK	Accepte et ferme la boîte de dialogue Compiler.

•	Annuler	Annule la compilation en mode Batch.

•	Atteindre erreur	Localise l'erreur de compilation sélectionnée et ouvre l'unité de programme associée à l'emplacement de l'erreur.

3	Lorsque vous avez terminé, sélectionnez OK pour fermer la boîte de dialogue Compiler.


Recompilation d'unités de programme

Le code PL/SQL compilé n'est pas portable d'un système à l'autre. Pour préparer un affichage en vue de son utilisation sur un autre système, vous devez donc recompiler votre code source sur ce système.

 Choisissez Fichier- [image] Compiler tout pour (re)compiler chaque unité de programme de l'affichage.


Changement de noms d'unité de programme

  Rubriques connexes

Pour renommer une unité de programme :

1	Cliquez deux fois sur l'objet unité de programme pour afficher l'Editeur d'unité de programme.

2	Editez l'unité de programme pour en changer le nom.

3	Recompilez l'unité de programme.

Si vous changez le nom d'une unité de programme référencée dans d'autres unités de programme, vous devez éditer ces références afin qu'elles reflètent le nouveau nom. Lorsque vous recompilez l'unité de programme renommée, les autres unités de programme qui y font référence perdent leur état compilé et apparaissent dans le Navigateur d'objet avec un astérisque (*).


Chargement d'unités de programme dans les affichages

Pour charger une unité de programme dans un affichage :

 Sélectionnez l'unité de programme de bibliothèque et faites-la glisser sous le noeud Unités de programme de l'affichage.

Lorsque vous relâchez le bouton de la souris, l'unité de programme est automatiquement copiée dans l'affichage. Si l'affichage comporte déjà une unité de programme ayant le même nom et le même type, un message d'alerte vous demande de confirmer le remplacement de l'ancienne unité de programme par la nouvelle.


Suppression d'unités de programme PL/SQL

  Rubriques connexes

Pour supprimer une unité de programme du Navigateur d'objet :

 Sélectionnez l'objet unité de programme et le bouton Supprimer ou choisissez Navigateur [image] Supprimer. Sélectionnez Oui pour confirmer.

Pour supprimer une unité de programme de l'éditeur d'unité de programme :

1	Cliquez deux fois sur l'objet unité de programme ou choisissez Unités de programme dans le menu instantané, ou encore choisissez Outils [image] Editeur d'unité de programme pour afficher l'éditeur d'unité de programme.

2	Si nécessaire, sélectionnez l'unité de programme que vous voulez supprimer dans la liste déroulante Nom.

3	Sélectionnez Supprimer pour supprimer l'unité de programme.

Un message d'alerte vous demande de confirmer la suppression.

4	Sélectionnez Oui pour confirmer.

5	Sélectionnez Fermer pour fermer l'éditeur d'unité de programme.

Si vous supprimez une unité de programme à laquelle d'autres font référence, vous devez supprimer ces références et recompiler les unités de programme pour qu'elles reflètent la modification apportée.


Contrôle de cohérence

Pour contrôler la cohérence :

1	Choisissez Fichier-->Vérifier la cohérence pour afficher la boîte de dialogue Contrôleur de cohérence.

Graphics Builder recherche les incohérences et les signale dans le champ d'affichage de message.

2	Lorsque vous avez terminé, sélectionnez OK pour fermer la boîte de dialogue.

Si vous avez utilisé PL/SQL dans votre affichage, vous aurez peut-être intérêt à rechercher les incohérences éventuelles entre les unités de programme et les références à ces unités de programme. Exemple d'incohérence : une référence à une procédure de déclencheur dont la création a échoué.


A propos des bibliothèques

Les bibliothèques PL/SQL constituent une solution pratique au stockage des unités de programme PL/SQL, fréquemment utilisées, que vous souhaitez réutiliser à l'avenir.

Ces bibliothèques se composent d'ensembles d'unités de programme PL/SQL que vous créez dans Graphics Builder. A la différence des unités de programme isolées que vous pouvez stocker avec les affichages, les bibliothèques PL/SQL sont stockées dans la base de données ou dans le système de fichiers et peuvent être utilisées par plusieurs utilisateurs dans plusieurs affichages. Pour faire référence à des bibliothèques PL/SQL dans Graphics Builder, vous devez les attacher à vos affichages en utilisant le Navigateur d'objet. En outre, vous pouvez accorder des droits d'accès aux bibliothèques que vous avez créées aux utilisateurs de votre choix.

Vous pouvez faire plusieurs fois référence à des bibliothèques PL/SQL dans un même affichage, ou les partager avec d'autres modules d'une application.

Pour plus d'informations sur l'utilisation des bibliothèques PL/SQL, reportez-vous à "Using PL/SQL Libraries", dans le chapitre "Working with PL/SQL Constructs" de Procedure Builder Developer's Guide.


A propos des autorisations et des suppressions d'autorisations d'accès aux bibliothèques

Vous pouvez accorder et retirer des droits d'accès aux autres utilisateurs, qui peuvent à leur tour accorder des droits d'accès à d'autres, ou renommer et modifier la bibliothèque PL/SQL.


Création de bibliothèques

Pour créer une bibliothèque PL/SQL :

1	Sélectionnez le noeud Bibliothèques dans le Navigateur d'objet.

2	Sélectionnez le bouton Créer ou choisissez Navigateur [image] Créer.

Le système crée une nouvelle bibliothèque ouverte, appelée au départ LIB_xxx.

3	S'il n'y a pas de bibliothèques ouvertes, vous pouvez cliquer deux fois sur le noeud Bibliothèques du Navigateur pour en créer une.

Lorsque vous avez créé une bibliothèque, vous pouvez y ajouter des unités de programme ou en créer de nouvelles, destinées à y être stockées.


Ouverture de bibliothèques

Pour ouvrir une bibliothèque :

1	Sélectionnez Fichier [image] Ouvrir pour afficher la boîte de dialogue Filtre.

2	Sélectionnez Bibliothèques ou Tous les fichiers dans le champ Affichage.

3	Sélectionnez le bouton d'option Base de données ou Système de fichiers dans le champ Accès objets, en fonction de l'endroit où est stockée la bibliothèque.

4	Sélectionnez OK pour confirmer vos sélections.

Si votre bibliothèque est stockée dans le système de fichiers, la boîte de dialogue de fichier de votre système s'affiche. Si votre bibliothèque est stockée dans la base de données, la boîte de dialogue Ouverture depuis la base s'affiche.

5	Indiquez le nom de la bibliothèque à ouvrir et acceptez la boîte de dialogue pour ouvrir la bibliothèque.

Les bibliothèques utilisent le suffixe de fichier .pll, ce qui les distingue des autres fichiers.


Ajout d'unités de programme existantes à des bibliothèques ouvertes

Pour ajouter une unité de programme existante à une bibliothèque ouverte :

1	Dans le Navigateur d'objet, développez les sous-noeuds de la bibliothèque ouverte que vous voulez modifier.

2	Sélectionnez l'unité de programme que vous voulez ajouter depuis le noeud Affichages.

3	Sélectionnez l'icône de l'unité de programme et faites-la glisser sous le sous-noeud Unités de programme de la bibliothèque ouverte.

Lorsque vous relâchez le bouton de la souris, l'unité de programme est automatiquement copiée dans la bibliothèque ouverte. Si celle-ci contient déjà une unité de programme ayant le même nom et le même type, un message d'alerte vous demande de confirmer le remplacement de l'ancienne unité de programme par la nouvelle.


Création de nouvelles unités de programme dans une bibliothèque ouverte

Pour créer une nouvelle unité de programme dans une bibliothèque ouverte :

1	Sélectionnez le sous-noeud Unités de programme sous le noeud de la bibliothèque ouverte dans le Navigateur d'objet.

2	Sélectionnez le bouton Créer, ou choisissez Navigateur [image] Créer pour afficher la boîte de dialogue Nouvelle unité de programme.

Si la bibliothèque ne comporte pas encore d'unité de programme, cliquez deux fois sur le sous-noeud Unités de programme du Navigateur pour afficher la boîte de dialogue Nouvelle unité de programme.

3	Entrez le nom de la nouvelle unité de programme.

4	Sélectionnez le type de la nouvelle unité de programme

5	Sélectionnez OK pour accepter la boîte de dialogue Nouvelle unité de programme et afficher l'éditeur d'unité de programme.

6	Définissez la nouvelle unité de programme.

7	Sélectionnez Compiler pour compiler la nouvelle unité de programme.

8	Sélectionnez Fermer pour fermer l'éditeur d'unité de programme.

Votre nouvelle unité de programme apparaît sous le sous-noeud Unités de programme de la bibliothèque.


Suppression d'unités de programme d'une bibliothèque ouverte

Pour supprimer une unité de programme d'une bibliothèque ouverte :

1	Développez les sous-noeuds de la bibliothèque ouverte que vous voulez modifier.

2	Sélectionnez l'unité de programme que vous voulez supprimer de la bibliothèque.

3	Sélectionnez le bouton Supprimer ou choisissez Navigateur [image] Supprimer.

Un message d'alerte vous demande de confirmer la suppression.

4	Sélectionnez Oui pour confirmer.


Enregistrement de bibliothèques

Pour enregistrer une bibliothèque :

1	Sélectionnez la bibliothèque ouverte que vous voulez enregistrer.

2	Sélectionnez Enregistrer ou choisissez Fichier [image] Enregistrer ou Fichier [image] Enregistrer sous pour afficher la boîte de dialogue Enregistrer bibliothèque.

Utilisez la commande Enregistrer sous uniquement si vous sauvegardez la bibliothèque pour la première fois.

3	Indiquez le nom de la bibliothèque et l'endroit où elle doit être enregistrée : système de fichiers ou base de données.

4	Sélectionnez OK pour enregistrer la bibliothèque.

Les bibliothèques reçoivent automatiquement le suffixe de fichier .pll si elles sont enregistrées dans le système de fichiers.


Attachement de bibliothèques à des affichages

Pour attacher une bibliothèque à un affichage :

1	Dans le Navigateur d'objet, sélectionnez le noeud Bibliothèques attachées (dans le noeud Affichage).

2	Sélectionnez le bouton Créer ou choisissez Navigateur [image] Créer pour afficher la boîte dialogue Attacher bibliothèque.

S'il n'y a pas encore de bibliothèque attachée, cliquez deux fois sur le noeud Bibliothèques attachées du Navigateur pour afficher la boîte de dialogue Attacher bibliothèque.

3	Entrez le nom de la bibliothèque que vous voulez attacher.

4	Sélectionnez Attacher pour attacher la bibliothèque.

Si vous fournissez un nom de chemin d'accès (c'est-à-dire si la bibliothèque n'est pas stockée dans votre répertoire en cours ou votre répertoire de travail), un message vous demande de supprimer le nom du chemin d'accès. Si vous ne le supprimez pas, Graphics Builder recherche la bibliothèque uniquement dans le chemin d'accès dont vous avez indiqué le nom. Si vous décidez de répartir votre affichage, Graphics Builder peut ne pas trouver la bibliothèque.

Si vous décidez de supprimer le nom du chemin d'accès, Graphics Builder cherchera la bibliothèque dans le chemin suivant :

•	le répertoire en cours ou le répertoire de travail de l'utilisateur,

•	le répertoire indiqué par la variable d'environnement "path" de Graphics Builder,

•	le répertoire indiqué par la variable d'environnement "path" d'Oracle.

Vous pouvez attacher une bibliothèque spécifique à un affichage pour utiliser le contenu de cette bibliothèque dans l'affichage. En affichant la bibliothèque à l'affichage, vous êtes certain que la bibliothèque et son contenu accompagneront l'affichage (runtime). La bibliothèque attachée n'est pas statique, c'est-à-dire ne représente un "cliché" de la bibliothèque au moment où vous l'attachez, mais est plutôt un lien à la bibliothèque, qui reçoit toutes les mises à jour que vous apportez à cette dernière.

Vous ne pouvez pas attacher de bibliothèques ouvertes. Si celle que vous voulez attacher est ouverte, fermez-la, puis attachez-la. Vous pouvez attacher plusieurs bibliothèques à un affichage.


Détachement de bibliothèques des affichages

Pour détacher une bibliothèque d'un affichage :

1	Sélectionnez la bibliothèque à détacher sous le noeud Bibliothèques attachées du Navigateur d'objet.

2	Sélectionnez le bouton Supprimer ou choisissez Navigateur [image] Supprimer.

Un message d'alerte vous demande de confirmer l'opération.

3	Sélectionnez OK pour détacher la bibliothèque.


Autorisation et révocation de droits d'accès aux bibliothèques du système de fichiers

Pour accorder et révoquer des droits d'accès aux bibliothèques du système de fichiers :

 Certains systèmes d'exploitation permettent aux utilisateurs d'accorder les droits de lecture, d'écriture et d'exécution de fichiers individuels. Pour plus d'informations sur la définition des autorisations d'accès aux fichiers, sur votre système d'exploitation, reportez-vous à la documentation de votre système d'exploitation ou interrogez votre administrateur système.


Autorisation et révocation de droits d'accès aux bibliothèques de la base de données

Pour accorder et révoquer des droits d'accès aux bibliothèques de la base de données :

1	Choisissez Fichier [image] Administration [image] Accès [image] Bibliothèque pour afficher la boîte de dialogue Accès au module de la base.

Cette boîte de dialogue contient la liste de toutes les bibliothèques stockées dans la base de données à laquelle vous avez accès.

2	Sélectionnez une bibliothèque de la liste.

3	Sélectionnez OK pour afficher la boîte de dialogue Accès au module de la base.

Cette boîte de dialogue contient une liste des utilisateurs qui ont accès à la bibliothèque.

4	Pour autoriser l'accès à la bibliothèque, entrez dans le champ Utilisateur le nom de l'utilisateur de la base de données auquel vous voulez accorder le droit d'accès.

5	Sélectionnez Ajouter pour ajouter le nom de l'utilisateur à la liste Accès.

6	Pour retirer un droit d'accès à un utilisateur de la liste Accès, sélectionnez le nom de l'utilisateur dans la liste.

7	Sélectionnez Supprimer pour supprimer le nom de l'utilisateur de la liste Accès.

8	Sélectionnez OK pour accepter vos modifications et fermer la boîte de dialogue Accès au module.

Les autorisations d'accès à votre bibliothèque sont mises à jour. Vous pouvez accorder à un autre utilisateur des droits d'accès (en lecture/écriture/exécution) à la bibliothèque que vous avez créée et stockée dans la base de données. Cependant, l'utilisateur doit également avoir accès aux tables de base de données de Graphics Builder. Pour plus d'informations, consultez votre administrateur de bases de données.


Changement de noms de bibliothèques stockées dans le système de fichiers

Pour renommer des bibliothèques stockées dans le système de fichiers

 Vous pouvez utiliser les commandes de votre système d'exploitation pour renommer une bibliothèque stockée dans le système de fichiers. Vous devez avoir les autorisations appropriées d'accès au fichier pour pouvoir le renommer.

Pour savoir comment renommer des fichiers, reportez-vous à la documentation de votre système d'exploitation.


Changement de noms de bibliothèques stockées dans la base de données

Pour renommer une bibliothèque stockée dans la base de données :

1	Choisissez Outils [image] Interpréteur PL/SQL pour afficher l'Interpréteur PL/SQL.

2	Dans la ligne de commande de l'Interpréteur, entrez la commande RENAME de la manière suivante :

PL/SQL> .RENAME LIB bibliothèque1 TO bibliothèque2

Si vous n'avez pas créé de bibliothèque vous-même et si la bibliothèque est stockée dans la base de données, vous devez avoir l'autorisation d'accès GRANT pour la renommer. Si la bibliothèque est stockée dans le système de fichiers, vous devez avoir les autorisations d'accès aux fichiers.


Suppression de bibliothèques du système de fichiers

Pour supprimer des bibliothèques du système de fichiers :

 Vous pouvez utiliser les commandes de votre système d'exploitation pour supprimer une bibliothèque stockée sous la forme d'un fichier. Pour supprimer un fichier, vous devez avoir les autorisations appropriées d'accès au fichier.

Pour en savoir plus sur la suppression de fichiers, reportez-vous à la documentation de votre système d'exploitation.


Suppression de bibliothèques de la base de données

 Pour supprimer une bibliothèque de la base de données :

1	Choisissez Outils [image] Interpréteur PL/SQL pour afficher l'Interpréteur PL/SQL.

2	Dans la ligne de commande Interpréteur, entrez la commande suivante :

PL/SQL> .DELETE LIBRARY bibliothèque;

où bibliothèque est le nom de la bibliothèque à supprimer.

3	Fermez l'Interpréteur PL/SQL.


A propos de l'ordre d'exécution des déclencheurs

Les déclencheurs sont des procédures PL/SQL activées à des intervalles spécifiques pendant l'exécution. Ils permettent d'améliorer vos affichages par l'ajout de boutons, de mettre dynamiquement en forme vos graphiques "à la volée" et d'effectuer automatiquement des mises à jour et des validations. Graphics Builder exécute toutes les procédures de déclencheurs, associées à un affichage, dans un ordre particulier. La connaissance de cet ordre d'exécution peut vous être utile lors du développement de vos affichages.

Les événements qui peuvent se produire -- ou qui se produisent -- sont, dans l'ordre indiqué :

•	activation du déclencheur d'ouverture d'affichage,

•	exécution d'interrogation,

•	mise à jour de graphique,

•	exécution d'horloge,

•	exécution de bouton,

•	activation du déclencheur de fermeture d'affichage.


A propos de l'activation du déclencheur d'ouverture d'affichage

Un déclencheur d'ouverture d'affichage est activé au moment indiqué par son nom : immédiatement après l'exécution d'un affichage (ouvert pendant l'exécution). Les déclencheurs d'ouverture d'affichage sont les premiers à être activés.


A propos de l'exécution d'une interrogation

  Rubriques connexes

Les opérations constituant l'exécution d'une interrogation sont les suivantes, dans l'ordre indiqué :

1	L'interrogation est exécutée automatiquement lors de l'ouverture d'un affichage si l'option  Exécuter à l'ouverture de l'affichage est définie pour l'interrogation. Par défaut, cette option est activée, et l'interrogation est alors exécutée immédiatement après l'activation du déclencheur d'ouverture d'affichage.

Si l'option Exécuter à l'ouverture de l'affichage n'est pas activée, l'exécution de l'interrogation n'a lieu que lorsque la procédure interne OG_EXECUTE_QUERY est appelée.

2	S'il existe, le déclencheur post-exécution est activé immédiatement après l'exécution de l'interrogation.

3	Si elle existe, la fonction de filtre d'interrogation est exécutée immédiatement après l'activation du déclencheur post-exécution. Le filtre d'interrogation ne limite pas l'apparition des données extraites dans la fenêtre de propriété Interrogation, mais détermine le sous-ensemble des données qui sera utilisé pour le tracé du graphique.


A propos des mises à jour de graphiques

  Rubriques connexes

La mise à jour regroupe les événements décrits ci-après, exécutés dans l'ordre indiqué :

1	Les mises à jour sont effectuées automatiquement après l'exécution d'une interrogation si l'option Mettre à jour le graphique sur exécution de l'interrogation est définie pour le graphique. Par défaut, cette option est activée et le graphique est mis à jour immédiatement après l'exécution des procédures d'exécution d'interrogation.

Si l'option Mettre à jour le graphique sur exécution de l'interrogation n'est pas activée, le graphique n'est mis à jour que lorsque la procédure interne OG_UPDATE_CHART est appelée.

2	S'il existe, le déclencheur de format est activé à la dernière étape de la mise à jour du graphique, immédiatement avant le tracé du graphique.

Vous pouvez utiliser des déclencheurs de format pour effectuer des mises en forme conditionnelles (couleur, par exemple) pour un élément de graphique.


A propos de l'exécution des horloges

  Rubriques connexes

L'exécution de l'horloge regroupe les événements décrits ci-après, exécutés dans l'ordre indiqué :

1	Si l'interrogation est associée à une horloge (par l'option Exécuter sur horloge de la page Options de la fenêtre de propriété Interrogation), l'interrogation est exécutée automatiquement à l'expiration du délai. Par défaut, cette option n'est pas activée.

Cependant; si elle est activée, l'exécution de l'interrogation peut, à son tour, entraîner une mise à jour de graphique.

2	La procédure d'horloge est exécutée en même temps que l'exécution de l'interrogation facultative (décrite ci-dessus), à l'expiration du délai. Si aucune interrogation ne doit être exécutée lors de l'expiration du délai, le seul événement qui se produit est la procédure d'horloge.

Les horloges peuvent être activées automatiquement lorsque l'affichage est exécuté, ou activées par programme à partir d'une unité de programme PL/SQL, par utilisation de la procédure PL/SQL interne OG_ACTIVATE_TIMER.


A propos de l'exécution des boutons

  Rubriques connexes

L'exécution des boutons regroupe les événements décrits ci-après, exécutés dans l'ordre indiqué :

1	En cas de détection d'un événement de souris sur un élément graphique qui agit comme un bouton (par exemple, un secteur) dans une relation de hiérarchisation vers le bas, Graphics Builder attribue une valeur de colonne à un paramètre en utilisant la colonne et le paramètre indiqués dans la page Descendre d'un niveau de la fenêtre de propriété de l'élément du graphique.

2	En cas de détection d'un événement de souris sur un élément graphique qui agit comme un bouton (par exemple, un secteur) dans une relation de hiérarchisation vers le bas, Graphics Builder exécute l'interrogation de graphique détail indiquée dans la page de hiérarchisation vers le bas de la fenêtre de propriété de l'élément du graphique.

3	En cas de détection d'un événement de souris sur un objet bouton quelconque, la procédure bouton (si elle existe) de cet objet est exécutée.

L'exécution d'une interrogation peut à son tour déclencher une mise à jour du graphique.


A propos de l'activation du déclencheur de fermeture d'affichage

Un déclencheur de fermeture d'affichage est activé immédiatement avant la fermeture de l'affichage. Les déclencheurs de fermeture d'affichage sont les derniers à être activés.


A propos de la référence à un déclencheur

Pour chaque type de déclencheur, un noeud d'affectation/de référence correspondant apparaît dans le Navigateur d'objet. Ces noeuds représentent les éventuelles procédures qui sont attribuées à un déclencheur particulier.

Vous pouvez attribuer une unité de programme existante à un déclencheur en sélectionnant l'objet unité de programme dans le Navigateur et en le faisant glisser directement sous l'un des noeuds d'attribution de déclencheur. Lorsque vous relâchez le bouton de la souris, le nom de l'unité de programme apparaît avec le noeud du déclencheur.

Le tableau suivant indique les noeuds d'attribution de procédure de déclencheur associés à ces objets dans le Navigateur:

Type de déclencheur	Noeud objet dans le Navigateur

Ouverture d'affichage	Affichage
Post-exécution	Interrogation
Format	Elément de graphique
Horloge	Interrogation, Horloge
Bouton	Objet, Elément de graphique, Couche, etc.
Fermeture d'affichage	Affichage
Vous pouvez à tout moment cliquer deux fois sur l'un des noeuds de déclencheur pour créer une nouvelle procédure de déclencheur en utilisant l'éditeur d'unité de programme, ou éditer la procédure de déclencheur attribuée.


A propos de l'utilisation de déclencheurs d'ouverture d'affichage

  Rubriques connexes

Un déclencheur d'ouverture d'affichage exécute une procédure PL/SQL lorsque l'affichage est exécuté pour la première fois. Par exemple, vous pouvez définir un déclencheur d'ouverture d'affichage définissant la valeur initiale de l'affichage, en exécutant des interrogations et en créant des graphiques, en activant des horloges, etc.


Création de déclencheurs d'ouverture d'affichage

  Exemple	   Rubriques connexes

Pour créer un déclencheur d'ouverture d'affichage :

1	Cliquez deux fois sur l'objet ouverture d'affichage, dans le Navigateur, pour afficher l'éditeur d'unité de programme.

L'éditeur d'unité de programme qui s'affiche contient un modèle de procédure de déclencheur par défaut (appelé au départ OGTRIGGERPROCx).

2	Renommez la procédure de déclencheur ou conservez le nom par défaut, puis entrez le corps de la procédure.

3	Sélectionnez Compiler pour compiler l'unité de programme.

En cas d'erreur, corrigez et recompilez.

4	Sélectionnez Fermer pour fermer l'éditeur d'unité de programme.


Exemple : déclencheur d'ouverture d'affichage

PROCEDURE open_disp IS
  old_layr  OG_LAYER;
  nu_layr   OG_LAYER;
  the_qry   OG_QUERY;
BEGIN
  old_layer:=OG_GET_LAYER('couche_base');
  nu_layer:=OG_GET_LAYER('bouton_couche');
  the_qry:=OG_GET_QUERY('interro0');
  OG_ACTIVATE_LAYER(nu_layr);
  OG_HIDE_LAYER(old_layr);
  OG_EXECUTE_QUERY(the_qry);
END:


Modification des références à des procédures de déclencheur d'ouverture d'affichage

Pour modifier une référence à une procédure de déclencheur d'ouverture d'affichage :

1	Choisissez Outils [image] Afficher pour ouvrir la fenêtre de propriété Affichage.

2	Sélectionnez une procédure de déclencheur dans la liste déroulante Déclencheur d'ouverture ou sélectionnez Aucun si vous ne souhaitez aucun comportement lorsque l'affichage est ouvert.

3	Sélectionnez OK pour appliquer la modification et fermer la boîte de propriété Affichage.

Graphics Builder vous permet de créer plusieurs procédures de déclencheur et d'attribuer celle que vous voulez à un déclencheur d'ouverture d'affichage pendant le développement de votre affichage.


A propos de l'utilisation des déclencheurs post-exécution

  Rubriques connexes

Les déclencheurs post-exécution sont des procédures PL/SQL associées à des interrogations. Ils sont activés immédiatement après l'exécution de l'interrogation qui leur est associée.


Création de déclencheurs post-exécution

  Exemple

Pour créer un déclencheur post-exécution :

1	Cliquez deux fois sur l'objet post-exécution, sous l'objet interrogation, dans le Navigateur.

L'Editeur d'unité de programme qui apparaît contient un modèle de procédure de déclencheur par défaut (appelé au départ OGQUERYPROCx).

2	Renommez la procédure de déclencheur ou conservez le nom par défaut, puis entrez le corps de la procédure.

3	Sélectionnez Compiler pour compiler l'unité de programme

En cas d'erreur, corrigez  et recompilez.

4	Sélectionnez Fermer pour fermer l'éditeur d'unité de programme.


Exemple : déclencheur post-exécution

PROCEDURE post_exec IS
  the_timer  OG_TIMER;
BEGIN
  the_timer:=OG_GET_TIMER('contrôler_stock');
  OG_ACTIVATE_TIMER(the_timer);
END:


Modification des références à des déclencheurs post-exécution

Pour modifier une référence à un déclencheur post-exécution :

1	Cliquez deux fois sur un objet interrogation du Navigateur, ou sélectionnez l'interrogation et choisissez la commande Propriétés dans le menu instantané pour afficher la fenêtre de propriété Interrogation.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation de l'interrogation en cours.

2	Sélectionnez l'onglet Options pour afficher la page de propriétés Options.

3	Sélectionnez une procédure de déclencheur post-exécution dans la liste déroulante Déclencheurs post-exécution, ou sélectionnez Aucune si vous ne voulez aucun comportement de post-exécution.

4	Sélectionnez OK pour appliquer la modification et fermer la fenêtre de propriété Objet.

Graphics Builder vous permet de créer plusieurs procédures de déclencheur post-exécution et de les attribuer facilement à toute interrogation de votre affichage.


A propos de l'utilisation des déclencheurs de format

  Rubriques connexes

Un déclencheur de format est une procédure PL/SQL associée à un élément de graphique. Les déclencheurs de format sont exécutés immédiatement avant le tracé de l'élément de graphique, pour que vous puissiez modifier dynamiquement les attributs de mise en forme de l'élément. Par exemple, vous pouvez définir un déclencheur de format destiné à colorer en vert les barres d'un graphique, en cas de dépassement d'une certaine valeur.


Création de déclencheurs de format

  Exemple	  Rubriques connexes

Pour créer un déclencheur de format :

1	Cliquez deux fois sur l'élément de graphique que vous voulez mettre en forme, ou sélectionnez l'élément de graphique et choisissez la commande Propriétés du menu instantané, pour afficher la fenêtre de propriété Objets de l'élément de graphique.

2	Sélectionnez Nouveau, à droite de la liste déroulante Déclencheur de format.

L'éditeur d'unité de programme qui apparaît contient un modèle de procédure de déclencheur de format par défaut (appelé au départ OGFORMATTRIGx).

3	Renommez la procédure de déclencheur de format ou conservez le nom par défaut, puis entrez le corps de la procédure.

4	Sélectionnez Compiler pour compiler l'unité de programme.

En cas d'erreur, corrigez et recompilez.

5	Sélectionnez Fermer pour fermer l'éditeur d'unité de programme.


Exemple : déclencheur de format

PROCEDURE format_point (elem IN og_object, query IN
og_query) IS
  st_price  NUMBER;
BEGIN
  st_price:=OG_GET_NUMCELL(query, OG_NEWDATA, 'prix_vente');
 IF st_price > 200 THEN
   OG_SET_BFCOLOR (elem, 'rouge');
 END IF;
END:


Modification des références à des déclencheurs de format

Pour modifier une référence à un déclencheur de format :

1	Cliquez deux fois sur l'élément de graphique, ou sélectionnez l'élément et choisissez la commande Propriétés du menu instantané, pour afficher la fenêtre de propriété Objets de l'élément de graphique.

2	Sélectionnez une procédure de déclencheur de format dans la liste déroulante Déclencheur de format ou sélectionnez Aucun si vous ne voulez pas de mise en forme spéciale.

3	Sélectionnez OK pour appliquer la modification et fermer la fenêtre de propriété Objet.

Graphics Builder vous permet de créer plusieurs procédures de déclencheur de format et d'y accéder facilement à partir de toute fenêtre de propriété d'élément de graphique.


A propos des déclencheurs d'horloge

  Rubriques connexes

Une horloge exécute une procédure de déclencheur PL/SQL à chaque occurrence d'un intervalle de temps indiqué. Par exemple, vous pouvez définir une horloge qui est activée toutes les minutes et exécute une procédure PL/SQL mettant un graphique à jour.


Création de déclencheurs d'horloge

  Exemple	  Rubriques connexes

Pour créer un déclencheur d'horloge :

1	Sélectionnez le noeud Horloges dans le Navigateur d'objet.

2	Sélectionnez le bouton Créer ou choisissez Navigateur [image] Créer pour afficher la boîte de dialogue Déclencheurs d'horloge.

S'il n'existe pas d'horloge, cliquez deux fois sur le noeud Horloges du Navigateur pour afficher une nouvelle horloge par défaut dans la boîte de dialogue Déclencheurs d'horloge. Cette boîte de dialogue affiche les paramètres par défaut d'une nouvelle horloge (appelée au départ timerx).

Vous pouvez également sélectionner Outils [image] Horloges etNouveau pour créer une nouvelle horloge.

3	Si vous voulez créer une nouvelle procédure, sélectionnez Nouveau, à droite de la liste déroulante Procédure.

L'éditeur d'unité de programme qui apparaît contient un modèle de procédure de déclencheur par défaut (appelé au départ OGTRIGGERPROCx).

4	Renommez la procédure de déclencheur ou conservez le nom par défaut, puis entrez le corps de la procédure.

5	Sélectionnez Compiler pour compiler la nouvelle procédure.

6	Sélectionnez Fermer pour fermer l'éditeur d'unité de programme et revenir à la boîte de dialogue Déclencheurs d'horloge.

7	Si vous voulez attribuer une unité de programme existante, sélectionnez-la dans la liste déroulante Procédure.

8	Modifiez le nom et l'intervalle de l'horloge, si nécessaire.

Utilisez la case à cocher Activer pour déterminer si l'horloge sera activée automatiquement au moment de l'exécution de l'affichage (cochée) ou activée à partir d'une autre unité de programme PL/SQL (non cochée).

Vous pouvez aussi utiliser la procédure PL/SQL interne OG_ACTIVATE_TIMER de Graphics Builder pour activer l'horloge à partir d'une autre unité de programme. Par exemple, vous pouvez vouloir autoriser l'utilisateur à activer l'horloge en appuyant sur un bouton après d'exécution de l'affichage.


Exemple : déclencheur d'horloge

PROCEDURE check_stock IS
  the_query  OG_QUERY;
  the_chart  OG_OBJECT;
BEGIN
  the_query:=OG_GET_QUERY('val_stock');
  the_chart:=OG_GET_CHART('stock');
  OG_EXECUTE_QUERY(the_query);
  OG_UPDATE_CHART(the_chart, OG_ALL_CHUPDA);
END:


Modification des références à des procédures de déclencheur d'horloge

Pour modifier une référence à un déclencheur d'horloge :

1	Cliquez deux fois sur l'horloge que vous voulez modifier, ou choisissez Outils [image] Horloges pour afficher la boîte de dialogue Déclencheurs d'horloge.

2	Sélectionnez une procédure dans la liste déroulante Procédures, ou sélectionnez Aucun si vous ne souhaitez exécuter aucune opération lorsque le délai expire.

3	Sélectionnez OK pour appliquer la modification et fermer la boîte de dialogue Déclencheurs d'horloge.

Cette solution vous permet d'attribuer facilement à une horloge existante une procédure PL/SQL stockée dans l'affichage.


A propos des procédures bouton

A tout objet que vous créez ou importez dans Graphics Builder peut être attribuée une procédure bouton (couches, objets graphiques, éléments de graphique, symboles et objets texte notamment). Les procédures bouton sont exécutées lorsqu'un "événement de souris" donné (par exemple, bouton souris enfoncé) impliquant l'objet associé est détecté.

Les boutons et les procédures bouton demandent une attention particulière :

•	événements de souris,

•	objets activés sur événements,

•	spécification de procédure bouton,

•	création de procédures bouton,

•	modification de références à des procédures bouton.

Comme les boutons sont appelés automatiquement et ne retournent pas de valeurs, les fonctions bouton ne sont pas prises en charge. (Toutes les références à un "objet" dans l'exposé sur les boutons doivent être considérées comme étant une référence à "un objet ou à une couche".)


A propos des événements de souris

Graphics Builder reconnaît les événements de souris suivants :

Evénement	Description

bouton souris enfoncé	détecté lorsque le bouton de la souris est enfoncé
bouton souris relâché	détecté lorsque le bouton de la souris est relâché
mouvement souris bouton enfoncé	détecté lorsque la souris se déplace pendant que le bouton est enfoncé
mouvement souris bouton relâché	détecté lorsque la souris se déplace lorsque le bouton est relâché (peut être détecté uniquement par une couche).


A propos des objets d'activité événement
A propos des objets activés sur événements

L'événement de bouton de souris enfoncé est le plus important, car il détermine l'objet qui devient l'objet "activé sur événements". Cet objet "reçoit" l'événement de bouton de souris enfoncé et tous les événements ultérieurs jusqu'au prochain événement de bouton de souris enfoncé (qui détermine alors un nouvel objet activé sur événements).

Seul un objet auquel est associée une procédure et qui est défini pour recevoir au moins un événement de souris peut devenir l'objet activé sur événements. (Vous pouvez définir la procédure d'un objet et les événements de votre choix soit dans sa boîte de dialogue Propriétés, soit par PL/SQL.) Notez qu'il n'est pas nécessaire qu'un événement soit défini pour recevoir un événement de bouton de souris enfoncé pour qu'il devienne un objet activé sur événements.

Lorsque Graphics Builder détecte un événement de bouton de souris enfoncé, il utilise, pour trouver le premier objet correspondant aux critères ci-dessus, la stratégie de recherche suivante :

•	premier objet (de la couche active) pointé par la souris,

•	groupe père du premier objet de la couche (notez que vous pouvez attribuer une procédure à un objet groupe qui est appelé lorsque l'utilisateur sélectionne l'un de ses fils, dans la mesure où il n'a pas été attribué de procédure particulière aux fils, qui aurait alors priorité),

•	le père du père, et ainsi de suite, en remontant dans l'arborescence de groupes du premier objet,

•	la couche active.

Le premier objet que rencontre Graphics Builder et qui correspond aux critères indiqués devient l'objet activé sur événements. Si Graphics Builder ne trouve aucun objet qualifié, l'événement de bouton de souris enfoncé n'est pas pris en compte. Notez que vous pouvez rendre la couche active couche "activé sur événements" en sélectionnant un point de la présentation qui n'est pas occupé par un objet résidant sur cette couche.

Lorsque l'objet activé sur événements a été choisi, Graphics Builder vérifie que l'objet est défini pour recevoir des événements de bouton de souris enfoncé. Dans l'affirmative, il reçoit l'événement de bouton de souris enfoncé qui l'a rendu objet activé sur événements, et la procédure est exécutée. Cette procédure se répète pour tous les événements détectés ultérieurement, et n'appelle la procédure que pour les événements que l'objet doit par définition recevoir.

Lorsque Graphics Builder détecte un événement de bouton de souris relâché, l'objet d'activé d'événement est "désactivé". Il ne reçoit plus d'événements de souris tant qu'il n'est pas réactivé par un événement de bouton de souris enfoncé.

Remarque spéciale sur les couches

Une couche peut recevoir deux événements de plus qu'un objet : bouton de souris enfoncé et bouton de souris relâché. Si la couche active a une procédure associée et est définie pour recevoir l'un de ces événements, cette opération sera exécutée lorsqu'aucun objet n'est objet "activé sur événements".


A propos des spécifications de procédure bouton

  Exemple	  Rubriques connexes

Une procédure bouton doit avoir exactement quatre arguments spécifiques. Lorsque vous en créez une, Graphics Builder fournit la spécification de procédure par défaut suivante :

PROCEDURE proc_name
  (buttonobj  IN  og_object,
   hitobj     IN  og_object,
   win        IN  og_window,
   eventinfo  IN  og_event) IS

où

nom_proc	Indique le nom de la procédure. Graphics Builder fournit un nom par défaut unique, que vous pouvez modifier.
Objbouton	Indique l'identificateur de l'objet d'activité d'événement (c'est-à-dire l'objet auquel est associée cette procédure bouton).
Objcible	Indique l'identificateur du premier objet de la couche active sur lequel pointe la souris lorsque l'événement est détecté. Cet identificateur peut être différent de buttonobj si l'objet que l'utilisateur sélectionne est un fils d'un groupe auquel est associée une procédure bouton ; dans ce cas buttonobj est l'objet groupe et hitobj est le fils.
Fenêtre	Indique l'identificateur de la fenêtre dans laquelle l'objet d'activité d'événement est devenu un objet d'activité d'événement.
Infoévénement	Indique un enregistrement contenant des informations sur l'événement de souris qui a appelé cette procédure. Ce champ est de type intégré Graphics Builder OG_EVENT.
Vous pouvez utiliser l'argument eventinfo de la procédure bouton pour que la procédure exécute différentes opérations sur différents événements. Notez qu'une procédure bouton est appelée par tout événement qu'elle doit par définition recevoir. Si les opérations de la procédure ne sont régies par aucune condition, toutes les instructions qui ne sont pas limitées à une condition spécifique sont exécutées.


Exemple : procédure bouton -- déplacement d'un objet

La procédure bouton décrite ci-après déplace de deux pouces l'objet bouton, vers la droite et vers le bas, lorsqu'elle reçoit un événement de bouton de souris enfoncé, puis fait pivoter l'objet de 45 degrés (en utilisant comme centre de rotation la position de la souris) lors de la réception d'un événement de bouton de souris relâché. Notez que même si l'objet bouton peut aussi être défini pour recevoir des événements de bouton de souris enfoncé et si ces événements appellent la procédure, ils ne sont pas pris en compte.

PROCEDURE move_and_rotate(buttonobj IN og_object, hitobj IN og_object, win IN og_window, eventinfo IN og_event) IS
  move_offset  OG_POINT;
BEGIN
  IF eventinfo.event_type=OG_MOUSE_DOWN THEN
    move_offset.x := 2 * OG_INCH;
    move_offset.y := 2 * OG_INCH;
    OG_MOVE(buttonobj, move_offset);
  ELSIF eventinfo.event_type=OG_MOUSE_UP THEN
    OG_ROTATE(buttonobj, eventinfo.mouse_position, 45);
  END IF;
END;


Création de procédures bouton

  Exemple

Pour créer une procédure bouton :

1	Cliquez deux fois sur l'objet, ou sélectionnez l'objet et choisissez Outils [image] Propriétés pour afficher la fenêtre de propriété Objet.

2	Si l'objet n'a pas de nom, entrez-en un dans le champ Nom.

3	Sélectionnez Nouveau, à droite de la liste déroulante Procédure.

L'Editeur d'unité de programme qui apparaît contient un modèle de procédure bouton par défaut (appelé au départ OGBUTTONPROCx).

4	Renommez la procédure bouton ou acceptez le nom par défaut, puis entrez le corps de la procédure.

5	Sélectionnez Compiler pour compiler l'unité de programme.

En cas d'erreur, corrigez et recompilez.

6	Sélectionnez Fermer pour fermer l'Editeur d'unité de programme.


Exemple : procédure bouton -- arrêt de l'horloge

PROCEDURE stop_plot (buttonobj IN og_object, hitobj IN
og_object, win IN og_object) IS
  the_timer  OG_TIMER;
BEGIN
  the_timer:=og_get_timer('ctrlstock');
  OG_DEACTIVATE_TIMER(the_timer);
END;


Modification de références à des procédures bouton
Modification des références à des procédures bouton

 Pour modifier une référence à une procédure bouton :

1	Cliquez deux fois sur l'objet, ou sélectionnez l'objet et choisissez Outils [image] Propriétés pour afficher la fenêtre de propriété Objet.

2	Sélectionnez une procédure bouton de la liste déroulante Procédure, ou sélectionnez Aucun si aucun comportement de bouton ne doit être utilisé.

3	Sélectionnez OK pour appliquer la modification et fermer la fenêtre de propriété Objet.

Graphics Builder vous permet de créer plusieurs procédures bouton et d'y accéder facilement à partir de la fenêtre de propriété d'un objet pendant le développement de vos affichages.


A propos de l'utilisation des déclencheurs de fermeture d'affichage

  Rubriques connexes

Un déclencheur de fermeture d'affichage exécute une procédure PL/SQL lors de la fermeture de l'affichage au stade de l'exécution. Vous pouvez par exemple définir un déclencheur de fermeture de l'affichage qui imprimera l'affichage ou validera les modifications apportées à la base de données.

Notez que l'affichage ne sera réellement fermé que lorsque la procédure de déclencheur de fermeture d'affichage aura fini de s'exécuter.


Création de déclencheurs de fermeture d'affichage

  Exemple	  Rubriques connexes

Pour créer un déclencheur de fermeture d'affichage :

1	Dans le Navigateur d'objet, cliquez deux fois sur l'icône de déclencheur de fermeture, ou choisissez Outils [image] Affichage pour afficher la fenêtre de propriété Affichage.

2	Sélectionnez Nouveau, à droite de la liste déroulante Déclencheur de fermeture.

L'Editeur d'unité de programme qui apparaît contient un modèle de procédure de déclencheur par défaut (appelé au début OGTRIGGERPROCx).

3	Renommez la procédure ou conservez le nom par défaut, puis entrez le corps de la procédure.

4	Sélectionnez Compiler pour compiler l'unité de programme.

En cas d'erreur, corrigez et recompilez.

5	Sélectionnez Fermer pour fermer l'Editeur d'unité de programme.


Exemple : déclencheur de fermeture d'affichage

PROCEDURE close_disp IS
  the_sound  OG_SOUND;
BEGIN
  the_sound:=OG_GET_SOUND('exécution');
  OG_PLAY_SOUND(the_sound);
END;


Modification des références à des procédures de déclencheur de fermeture d'affichage

Pour modifier une référence à un déclencheur de fermeture d'affichage :

1	Choisissez Outils [image] Affichage pour ouvrir la fenêtre de propriété Affichage.

2	Sélectionnez une procédure de déclencheur dans la liste déroulante Déclencheur de fermeture, ou sélectionnez Aucun si aucun comportement de bouton ne doit être utilisé.

3	Sélectionnez OK pour appliquer la modification et fermer la fenêtre de propriété Affichage.

Graphics Builder vous permet de créer plusieurs procédures de déclencheur et d'en affecter une facilement en tant que déclencheur de fermeture d'affichage pendant le développement de vos affichages.


A propos des interrogations

Les interrogations sont des instructions SQL SELECT ou des fichiers que vous pouvez utiliser pour extraire des données pour un affichage. Dans la plupart des cas, vous utiliserez les interrogations pour extraire des données destinées à des graphiques, mais vous pouvez également exécuter des interrogations par programme et utiliser les données pour créer et modifier des objets.

Que vos interrogations soient créées lors de la création d'un graphique, ou séparément, vous avez intérêt à donner à chacune d'entre elles un nom unique et représentatif. Graphics Builder attribue à chaque interrogation que vous créez le nom par défaut queryn. L'utilisation de noms significatifs peut faciliter la recherche de l'interrogation dans le Navigateur d'objet, ou la sélection d'une interrogation dans une liste déroulante lors de la création d'un graphique.


Connexion à la source des données

Pour vous connecter à la source des données :

1	Choisissez Fichier [image] Connecter pour afficher la boîte de dialogue Connexion.

Pour pouvoir interroger une source de données, vous devez y être connecté. Vous pouvez alors créer une instruction SQL SELECT pour extraire les données.

2	Entrez votre nom utilisateur et votre mot de passe. (Votre mot de passe ne s'affiche pas lorsque vous l'entrez.) Si vous ne savez pas exactement quel nom utilisateur ou quel mot de passe utiliser, consultez votre administrateur de sources de données.

Laissez le champ Bases de données en blanc, à moins que vous ne vous connectiez à une source de données éloignée. Dans ce cas, vous devrez entrez le protocole de communication SQL*Net, le noeud de source de données et le nom de base de données, séparés par des signes deux-points. Par exemple :

t:paris:paye

Ou, pour une source de données ODBC :

ODBC:paris:paye

Vous pouvez indiquer une chaîne de connexion par défaut qui sera utilisée pour toutes les connexions.

1	Sélectionnez Connecter.

Si la connexion à la source de données est établie, la boîte de dialogue Connexion se ferme. Si vous recevez un message d'erreur, consultez votre administrateur de sources de données et vérifiez que vous utilisez l'identification de connexion et la spécification de sources de données correctes.


A propos de la création d'interrogations

Graphics Builder vous propose les options de création d'interrogation suivantes :

création d'une instruction SQL SELECT

définition de fichiers comme interrogations

création d'interrogations lors de la création d'un graphique

création d'une interrogation à l'aide de PL/SQL

Le choix de la méthode dépend de votre source de données. Pour une base de données, vous utiliserez une instruction SQL SELECT. Pour un fichier (une feuille de calcul, par exemple), vous utiliserez la totalité du fichier comme interrogation. En outre, vous pouvez créer des interrogations personnalisées en utilisant une combinaison d'instructions SQL et de code PL/SQL.

Lorsque vous exécutez une interrogation, Graphics Builder extrait l'ensemble de colonnes de données indiqué, ainsi que leurs lignes, et les place dans la page de propriété Données de la fenêtre de propriété Interrogation. La page de propriété Données contient toujours les données extraites de l'interrogation en cours. Lorsque vous créez un graphique, Graphics Builder utilise les données provenant de l'interrogation en cours, à moins que vous n'en indiquiez d'autres.


A propos de l'utilisation d'interrogations SQL externes

Si vous avez des interrogations SQL stockées dans des fichiers, vous pouvez utiliser l'une des options suivantes :

•	référence aux interrogations SQL externes

•	import d'interrogations SQL externes

Pour plus d'informations sur les instructions SQL SELECT et la façon de les stocker dans des fichiers texte, reportez-vous à Oracle7 Server SQL Language Reference Manual.


Création d'instructions SQL SELECT

Pour créer une interrogation d'instruction SQL SELECT :

1	Sélectionnez le noeud Interrogations dans le Navigateur d'objet et sélectionnez Créer ou choisissez Navigateur [image] Créer pour afficher la fenêtre de propriété Interrogation.

S'il n'existe pas d'interrogation, cliquez deux fois sur le noeud Interrogations du Navigateur pour afficher la fenêtre de propriété Interrogation.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation, puis sélectionner Nouveau pour créer une nouvelle interrogation.

Le nom par défaut est queryx, où x est un numéro d'instance incrémenté d'une unité chaque fois qu'une nouvelle interrogation est créée pendant la session en cours.

2	Conservez le nom par défaut ou entrez-en un nouveau dans le champ Nom.

3	Entrez une instruction SQL SELECT dans le champ Instruction SQL.

Pour plus d'informations sur les instructions SQL SELECT, reportez-vous à Oracle7 Server SQL Language Reference Manual.

4	Sélectionnez Exécuter pour exécuter l'interrogation.

Les données apparaissent dans la page de propriété Données.

5	Sélectionnez OK ou Fermer pour fermer la fenêtre de propriété Interrogation.

L'interrogation reste l'interrogation en cours tant que vous n'avez pas créé ou édité une autre interrogation.

Si vous voulez créer vos interrogations immédiatement et vos graphiques ultérieurement, utilisez cette méthode. Avec la fenêtre de propriété Interrogation, vous pouvez créer simultanément plusieurs interrogations.


Définition de fichiers comme interrogations

Pour indiquer qu'un fichier est une interrogation :

1	Sélectionnez le noeud Interrogations dans le Navigateur d'objet et sélectionnez Créer ou choisissez Navigateur [image] Créer pour afficher la fenêtre de propriété Interrogation.

S'il n'existe pas d'interrogation, cliquez deux fois sur le noeud Interrogations du Navigateur pour afficher la fenêtre de propriété Interrogation.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation, puis sélectionner Nouveau pour créer une nouvelle interrogation.

Le nom par défaut est queryx où x est un numéro d'instance incrémenté d'une unité chaque fois qu'une nouvelle interrogation est créée pendant la session en cours.

2	Conservez le nom par défaut ou entrez-en un nouveau dans le champ Nom.

3	Sélectionnez un type de fichier dans la liste déroulante Type d'interrogation.

4	Sélectionnez Rechercher pour afficher la boîte de dialogue de fichiers de votre système.

5	Sélectionnez un fichier valide et acceptez la boîte de dialogue.

Graphics Builder entre, dans le champ de nom de fichier, le chemin d'accès au répertoire et le nom de fichier.

Si votre fichier contient des dates, reportez-vous à Définition des formats de date pour les interrogations de fichiers.

6	Sélectionnez Exécuter pour exécuter l'interrogation.

Les données s'affichent dans la page de propriété Données.

7	Sélectionnez OK ou Fermer pour fermer la fenêtre de propriété Interrogation.

L'interrogation reste l'interrogation en cours tant que vous n'avez pas créé ou édité une autre interrogation.

Les formats de fichiers qui peuvent être utilisés comme interrogations sont SYLK, WKS ou PRN.


Création d'une interrogation à l'aide de PL/SQL

  Rubriques connexes

Pour créer une interrogation à l'aide de PL/SQL :

 Utilisez les paramètres et les procédures internes PL/SQL de Graphics Builder pour créer et exécuter les interrogations par programme. Par exemple, si vous voulez utiliser un paramètre pour définir par programme une clause WHERE pour l'interrogation, vous pouvez créer une interrogation (interro0) comprenant une référence lexicale à un paramètre de type CHAR. (the_param).

La procédure décrite ci-dessous définit la valeur du paramètre en fonction de l'argument fourni, puis exécute l'interrogation et met à jour le graphique associé :

PROCEDURE add_param (the_name IN VARCHAR2) IS
  query  OG_QUERY;
  the_chart  OG_OBJECT;
BEGIN
  :the_param:='WHERE nome = '|| the_name;
  query:=OG_GET_QUERY('interro0');
  OG_EXECUTE_QUERY(query);
  the_chart:=OG_GET_CHART('nom_graphique');
  OG_UPDATE_CHART(the_chart, OG_ALL_CHUPDA);
END;

Vous pouvez également créer la totalité de l'interrogation par programme en utilisant la fonction OG_MAKE_QUERY. Par exemple :

FUNCTION make_ch RETURN og_query IS
BEGIN
  query:=OG_MAKE_QUERY(OG_SQL_QTYPE, 'select nome,
sal from emp');
END;

Lorsque vous avez créé une interrogation en utilisant la fonction ci-dessus, vous pouvez exécuter l'interrogation résultante pour créer un graphique.


Référence à des interrogations SQL externes

  Rubriques connexes

Pour faire référence à une interrogation externe :

1	Sélectionnez le noeud Interrogations dans le Navigateur d'objet et sélectionnez Créer ou choisissez Navigateur [image] Créer pour afficher la fenêtre de propriété Interrogation.

S'il n'existe pas d'interrogation, cliquez deux fois sur le noeud Interrogations du Navigateur pour afficher la fenêtre de propriété Interrogation.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation, puis sélectionner Nouveau pour créer une nouvelle interrogation.

2	Sélectionnez Fichier SQL externe dans la liste déroulante Type.

Les champs Fichier et Parcourir sont activés.

3	Entrez le nom et l'emplacement du fichier SQL dans le champ Fichier ou sélectionnez Parcourir pour afficher la boîte de dialogue de fichiers de votre système d'exploitation.

4	Sélectionnez le fichier SQL auquel vous voulez faire référence et acceptez la boîte de dialogue de fichiers pour la fermer.

Graphics Builder stocke l'emplacement du chemin d'accès dans ce fichier.

5	Sélectionnez Exécuter pour exécuter l'interrogation dans le fichier externe.

6	Sélectionnez OK pour fermer la fenêtre de propriété Interrogation.

La référence à un fichier d'interrogation externe dans Graphics Builder fournit un lien à ce fichier au lieu d'inclure l'interrogation dans l'affichage. Utilisez cette méthode si vous ne voulez pas éditer l'interrogation, ou l'inclure dans l'affichage.

Si vous répartissez l'affichage lors de l'exécution, vous devez également répartir le fichier d'interrogation externe afin que Graphics Builder puisse le trouver pour l'exécuter.


Import d'interrogations SQL externes

Pour importer une interrogation SQL externe :

1	Sélectionnez le noeud Interrogations dans le Navigateur d'objet et sélectionnez Créer ou choisissez Navigateur [image] Créer pour afficher la fenêtre de propriété Interrogation.

S'il n'existe aucune interrogation, cliquez deux fois sur le noeud Interrogations dans le Navigateur pour afficher la fenêtre de propriété Interrogation.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation, puis sélectionner Nouveau pour créer une nouvelle interrogation.

2	Sélectionnez le curseur dans le champ Instruction SQL.

3	Sélectionnez Importer SQL pour afficher la boîte de dialogue de fichiers de votre système.

4	Sélectionnez un fichier texte contenant une instruction SQL SELECT et acceptez la boîte de dialogue.

Graphics Builder importe dans le champ Instruction SQL l'instruction SQL stockée dans le fichier.

5	Sélectionnez Exécuter pour exécuter l'interrogation importée.

6	Sélectionnez OK pour fermer la boîte de dialogue.

Lorsque l'interrogation est importée, vous pouvez l'éditer, si nécessaire.


Export d'interrogations dans des fichiers texte

Pour exporter une interrogation dans un fichier texte :

1	Cliquez deux fois sur l'objet Interrogation que vous voulez modifier, ou sélectionnez l'objet Interrogation dans le Navigateur d'objet et choisissez la commande Propriétés dans le menu instantané.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation de l'interrogation en cours.

2	Si nécessaire, sélectionnez une autre interrogation dans la liste déroulante Interrogation.

3	Sélectionnez le curseur dans le champ Instruction SQL.

4	Sélectionnez Exporter SQL pour afficher la boîte de dialogue de fichiers de votre système.

5	Sélectionnez le fichier texte qui devra contenir l'instruction SQL et acceptez la boîte de dialogue.

6	Sélectionnez OK pour fermer la fenêtre de propriété Interrogation.

Graphics Builder exporte l'instruction SQL dans le fichier indiqué.

Lorsque vous avez créé une instruction SQL dans Graphics Builder, vous pouvez exporter cette interrogation dans un fichier texte pour pouvoir l'utiliser dans d'autres produits Oracle. Pour réutiliser une interrogation dans Graphics Builder, faites-la glisser d'un affichage à l'autre dans le Navigateur d'objet.


A propos de la création d'interrogations personnalisées

Les interrogations personnalisées vous permettent de créer des colonnes et de les remplir de données en utilisant uniquement PL/SQL ou une combinaison de SQL et de PL/SQL.

Vous pouvez remplir les colonnes des interrogations en utilisant une procédure d'exécution personnalisée ou une source externe. Lorsque vous avez créé une interrogation personnalisée, vous pouvez y faire référence lors de la création d'un graphique.


A propos du remplissage de colonnes d'interrogation à l'aide d'une source externe

Lorsque vous incluez un graphique Graphics Builder dans un autre produit Oracle comme Form Builder ou Report Builder (livré avec Reports Developer), le graphique utilise les données de l'interrogation du produit appelant dans la mesure où correspondent les colonnes de l'interrogation utilisées pour créer le graphique et les colonnes utilisées dans l'interrogation du produit appelant.

Si le graphique que vous créez ne doit être appelé que par un autre produit Oracle, vous pouvez utiliser une interrogation personnalisée pour créer un graphique "vide". Ce graphique recevra des données lorsqu'il sera appelé par le produit appelant. Utilisez la page de propriété Schéma d'interrogation personnalisée pour créer des colonnes ayant le même nom que l'interrogation utilisée par le produit appelant, puis définissez les propriétés du graphique de la manière habituelle, en lui attribuant une catégorie et des données de valeurs, etc.

Le graphique apparaîtra vide dans la présentation.

Lorsque l'affichage Graphics Builder est appelé par un autre produit, l'interrogation du produit appelant remplace l'interrogation personnalisée et, comme les noms de colonne sont identiques, le graphique est dessiné en fonction de vos spécifications.

Dans ce cas, il n'est pas nécessaire de créer une procédure d'exécution personnalisée pour remplir les colonnes de données.


Création de colonnes d'interrogation personnalisée

Pour créer des colonnes d'interrogation personnalisée :

1	Sélectionnez le noeud Interrogations dans le Navigateur d'objet et sélectionnez Créer ou choisissez Navigateur [image] Créer pour afficher la fenêtre de propriété Interrogation.

S'il n'existe pas d'interrogation, cliquez deux fois sur le noeud Interrogations du Navigateur pour afficher la fenêtre de propriété Interrogation.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation, puis sélectionner Nouveau pour créer une nouvelle interrogation.

Le nom par défaut est queryx, où x est un numéro d'instance incrémenté d'une unité chaque fois qu'une nouvelle interrogation est créée pendant la session en cours.

2	Conservez le nom par défaut ou entrez-en un nouveau dans le champ Nom.

3	Sélectionnez Personnalisé dans la liste déroulante Type d'interrogation.

4	Choisissez l'onglet Schéma pour afficher la page de propriété Schéma.

5	Sélectionnez Nouvelle colonne pour créer une colonne.

6	Modifiez le nom, le type et les autres paramètres, le cas échéant.

Continuez à créer toutes les colonnes devant constituer le graphique.

7	Créez une procédure d'exécution personnalisée pour remplir les colonnes de données ou sélectionnez Fermer pour fermer la fenêtre de propriété Interrogation.


Remplissage de colonnes d'interrogation à l'aide d'une procédure d'exécution personnalisée

  Exemple

Pour créer une procédure d'exécution personnalisée :

1	Cliquez deux fois sur l'objet Interrogation (personnalisé) que vous voulez modifier ou  sélectionnez l'objet Interrogation dans le Navigateur d'objet et choisissez la commande Propriétés dans le menu instantané.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation de l'interrogation en cours.

2	Si nécessaire, sélectionnez une autre interrogation dans la liste déroulante Interrogation.

3	Choisissez l'onglet Options pour afficher la page de propriété Options.

4	Sélectionnez un déclencheur d'exécution personnalisée dans la liste déroulante ou sélectionnez Nouveau pour créer une nouvelle procédure d'exécution personnalisée.

L'éditeur d'unité de programme apparaît avec une procédure de modèle OGQUERYPROC0.

5	Editez la procédure de modèle pour remplir les colonnes personnalisées.

Utilisez les procédures internes OG_SET_xxxCELL et OG_APPEND_ROW PL/SQL.

6	Sélectionnez OK pour appliquer vos modifications et fermer la fenêtre de propriété Interrogation.

Vous pouvez enregistrer et exécuter votre affichage, ou choisir Graphique [image] Mettre à jour graphique pour tester la procédure d'exécution personnalisée.


Exemple : Utilisation d'une procédure d'interrogation personnalisée

La procédure ci-dessous est un exemple de procédure d'exécution personnalisée qui repose sur la création de trois colonnes dans la page de propriété Schéma. La colonne Nom est de type CHAR, la colonne Salaire de type NUMBER et la colonne Embauche de type DATE.

Graphics Builder tient à jour une ligne de tampon, ou ligne virtuelle de la table. Vous remplissez cette ligne virtuelle en utilisant OG_SET_xxxCELL, puis ajoutez la ligne virtuelle à la table en utilisant OG_APPEND_ROW. Notez que comme il n'y a qu'une ligne virtuelle, vous ne pouvez remplacer qu'une ligne de la table à la fois.

PROCEDURE fill_columns (query IN og_query)IS

/* Définir les données de la première ligne*/
  OG_SET_CHARCELL(query, 'Nom', 'Smith');
  OG_SET_NUMCELL(query, 'Salaire', '50000');
  OG_SET_DATECELL(query, 'Embauche', '12-NOV-88');

/* Ajouter la ligne de données à la table*/
  OG_APPEND_ROW(query);

/* Définir les données de la ligne suivante*/
  OG_SET_CHARCELL(query, 'Nom', 'Jones');
  OG_SET_NUMCELL(query, 'Salaire', '55000');
  OG_SET_DATECELL(query, 'Embauche', '19-AVR-92');

/* Ajouter la ligne de données à la table*/
  OG_APPEND_ROW(query);

END;


Accès aux interrogations à l'aide du Navigateur d'objet

Pour accéder à une interrogation à l'aide du Navigateur d'objet

1	Cliquez deux fois sur l'objet Interrogation dans le Navigateur pour afficher la fenêtre de propriété Interrogation de cette interrogation, ou sélectionnez l'objet Interrogation et choisissez la commande Propriétés dans le menu instantané.

2	Une fois que la fenêtre de propriété Interrogation est ouverte, vous pouvez sélectionner d'autres interrogations à modifier dans la liste déroulante Interrogation.


Accès aux interrogations à l'aide du menu

Pour accéder aux interrogations à l'aide du menu :

1	Choisissez Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation.

2	Sélectionnez l'interrogation dans la liste déroulante Interrogation.

Exécutez l'opération voulue.

Cette méthode ouvre la fenêtre de propriété Interrogation pour l'interrogation en cours. Une fois cette fenêtre ouverte, vous pouvez sélectionner une autre interrogation dans la liste déroulante Interrogation. L'interrogation en cours est celle qui a été créée ou modifiée en dernier dans la fenêtre de propriété Interrogation.


Modification d'interrogations

Pour modifier une interrogation :

1	Cliquez deux fois sur l'objet Interrogation que vous voulez modifier ou sélectionnez-le dans le Navigateur et choisissez la commande Propriétés dans le menu instantané.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation de l'interrogation en cours.

2	Si nécessaire, sélectionnez une autre interrogation dans la liste déroulante Interrogation.

3	Editez l'interrogation en procédant de la manière suivante :

 Si l'interrogation est une instruction SQL SELECT, éditez cette instruction dans le champ Instruction SQL.

 Si l'interrogation repose sur un fichier, la boîte de dialogue de fichiers de votre système s'affiche. Sélectionnez un fichier et acceptez la boîte de dialogue. Editez le fichier si nécessaire.

4	Sélectionnez Exécuter pour réexécuter l'interrogation.

Les nouvelles données s'affichent dans la page de propriété Données.

5	Sélectionnez OK pour fermer la fenêtre de propriété Interrogation.

L'interrogation reste l'interrogation en cours aussi longtemps que vous n'en avez pas créé ou édité une autre.


Modification d'interrogations à l'aide du Navigateur d'objet

Pour modifier une interrogation à l'aide du Navigateur d'objet :

 Sélectionnez l'objet Interrogation puis choisissez l'un des boutons du Navigateur d'objet comme Créer ou Supprimer, ou choisissez une option dans le menu Navigateur.


Changement de noms d'interrogation dans le Navigateur d'objet

Pour renommer une interrogation dans le Navigateur d'objet :

1	Sélectionnez l'objet Interrogation que vous voulez renommer.

2	Sélectionnez une fois le nom pour positionner le curseur et passer en mode édition.

Si vous voulez remplacer la totalité du nom, sélectionnez le nom pour le mettre en évidence, puis entrez le nouveau nom.

Utilisez cette méthode pour renommer rapidement une ou plusieurs interrogations directement dans le Navigateur d'objet. Si vous voulez visualiser le contenu de l'interrogation avant de la renommer, utilisez la méthode de menu décrite ci-dessous.

3	Si l'interrogation est référencée dans des unités de programme PL/SQL ou dans des relations de descente de niveau, changez toutes les références pour refléter le nouveau nom de l'interrogation.


Changement de noms d'interrogation dans la fenêtre de propriété Interrogation

Pour renommer une interrogation dans la fenêtre de propriété Interrogation :

1	Cliquez deux fois sur l'objet Interrogation que vous voulez modifier, ou sélectionnez l'objet Interrogation dans le Navigateur d'objet et choisissez la commande Propriétés dans le menu instantané.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation de l'interrogation en cours.

2	Si nécessaire, sélectionnez une autre interrogation dans la liste déroulante Interrogation.

3	Entrez le nouveau nom de l'interrogation dans le champ Nom.

4	Sélectionnez OK pour appliquer le nouveau nom et fermer la fenêtre de propriété Interrogation.

Utilisez cette méthode si vous voulez visualiser le contenu de l'interrogation avant de la renommer.

5	Si l'interrogation est référencée dans des unités de programme PL/SQL ou dans des relations de descente de niveau, changez toutes les références pour refléter le nouveau nom de l'interrogation.


Définition des formats de date des interrogations de fichiers

Pour définir les formats de date des interrogations de fichiers :

1	Cliquez deux fois sur l'objet Interrogation que vous voulez modifier, ou sélectionnez l'objet Interrogation dans le Navigateur d'objet et choisissez la commande Propriétés dans le menu instantané.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation de l'interrogation en cours.

2	Si nécessaire, sélectionnez une autre interrogation dans la liste déroulante Interrogation.

3	Choisissez l'onglet Options pour afficher la page de propriété Options.

4	Entrez un format de date dans le champ Format de date, ou choisissez Liste et sélectionnez un format existant dans la boîte de dialogue Format de date.

Pour plus d'informations sur les formats valides, reportez-vous à Oracle7 Server SQL Language Reference Manual.

5	Sélectionnez OK pour accepter la boîte de dialogue et revenir à la fenêtre de propriété Interrogation.

6	Sélectionnez Exécuter pour réexécuter une interrogation et tracer les données en fonction du nouveau format.

Si vous interrogez un fichier (SYLK, WKS ou PRN) qui comprend des dates que Graphics Builder doit reconnaître comme des dates et non comme des caractères individuels, vous devez indiquer des formats de date dans la fenêtre de propriété Interrogation.

Ces formats de date sont utilisés uniquement pour les dates de la page de propriété Données de la fenêtre de propriété Interrogation. Pour les graphiques, vous pouvez définir les formats de date dans les éditeurs de présentation ou de modèle de graphique.


A propos de l'exécution des interrogations

Vous pouvez exécuter des interrogations :

•	automatiquement lors de l'ouverture d'un affichage

•	à des intervalles spécifiques

•	en utilisant PL/SQL


A propos du filtrage des données de graphique

Lorsque vous voulez limiter le volume des données tracées dans un graphique, vous filtrez les données en indiquant une clause WHERE dans votre interrogation (par exemple, "WHERE DEPTNO = :DNO"). Cependant, cette méthode implique qu'à chaque graphique soit attribuée une interrogation unique. En outre, la réexécution d'une interrogation chaque fois que son graphique est mis à jour peut pénaliser les performances de votre graphique.

Pour éviter ce problème, vous pouvez créer un filtre d'interrogation pour un graphique. Les filtres d'interrogation sont des fonctions PL/SQL qui limitent le volume des données tracées dans un graphique. Comme il est possible d'attribuer à chaque graphique un filtre d'interrogation qui lui est propre, une interrogation unique - exécutée une seule fois - peut fournir des données utilisées par plusieurs graphiques.

La fonction de filtre d'interrogation lit chaque ligne de votre interrogation et l'évalue en fonction de la ou des conditions que vous définissez dans le filtre d'interrogation lui-même. Chaque ligne qui correspond à la ou aux conditions est tracée ; inversement chaque ligne qui ne correspond pas à la ou aux conditions n'est pas tracée, mais reste dans la page de propriété Données de la fenêtre de propriété Interrogation.


Création d'un filtre d'interrogation

  Rubriques connexes	  Exemple

Pour créer un filtre d'interrogation :

1	Choisissez la condition que vous voulez définir pour les données de l'interrogation.

Vous pouvez vouloir définir une limite maximum pour une colonne, comparer les valeurs de plusieurs colonnes ou sélectionner une plage spécifique de données autorisées.

2	Cliquez deux fois sur le graphique pour afficher la fenêtre de propriété Graphique.

3	Sélectionnez l'onglet Données pour afficher la page de propriété Données.

4	Sélectionnez le bouton Nouveau qui apparaît à droite de la liste déroulante Fonction filtre.

L'Editeur d'unité de programme PL/SQL qui s'affiche propose un modèle de fonction de filtre interrogation par défaut (appelé initialement OGQUERYFILTER0).

Vous devez fournir une condition fondée sur une ou plusieurs colonnes de votre interrogation.

5	Définissez les conditions de filtrage.

6	Sélectionnez Compiler dans l'Editeur d'unité de programme pour compiler le filtre d'interrogation.

Si vous détectez des erreurs, corrigez-les et effectuez une recompilation. Le filtre d'interrogation doit être correctement compilé pour pouvoir être utilisé.

7	Sélectionnez Fermer pour fermer l'Editeur d'unité de programme.

8	Sélectionnez OK pour fermer la fenêtre de propriété Graphique.

Vous pouvez choisir Graphique [image] Mettre à jour graphique pour visualiser le résultat de la fonction de filtre d'interrogation sur votre graphique.

Bien que l'interrogation sélectionne chaque ligne de la table, le filtre garantit que seules certaines lignes sont utilisées pour le tracé du graphique.

Pour plus d'informations sur la définition de conditions à l'aide de PL/SQL, reportez-vous à "Control Structures" dans PL/SQL User's Guide and Reference.


Utilisation des fonctions de filtre d'interrogation

  Rubriques connexes

Pour utiliser des fonctions de filtre d'interrogation :

1	Cliquez deux fois sur le graphique ou sélectionnez le graphique auquel vous voulez ajouter un filtre d'interrogation (soit dans l'Editeur de présentation, soit dans le Navigateur d'objet) et choisissez la commande Propriétés dans le menu instantané.

Vous pouvez également choisir Outils [image] Propriétés pour afficher la fenêtre de propriété Graphique.

2	Choisissez l'onglet Données pour afficher la page de propriété Données.

3	Sélectionnez une fonction de filtre d'interrogation dans la liste déroulante Fonctions de filtre ou sélectionnez Nouveau pour créer un nouveau filtre d'interrogation.

4	Sélectionnez OK pour appliquer vos modifications et fermer la fenêtre de propriété Graphique.

Vous pouvez utiliser  Graphique [image] Mettre à jour graphique pour tester la fonction de filtre d'interrogation.

En utilisant Graphics Builder, vous pouvez créer une interrogation qui pourra être attribuée à plusieurs graphiques. En créant une fonction de filtre d'interrogation pour un graphique, vous pouvez limiter le volume de données tracées sur le graphique (par exemple, à tous les salaires supérieurs à 5 000) sans devoir réexécuter votre interrogation.

En outre, si vous envisagez de créer plusieurs graphiques utilisant la même source de données, vous pouvez créer une interrogation générique et utiliser des filtres d'interrogation pour déterminer les données tracées. Dans ce cas, le filtre d'interrogation exécutera la même fonction qu'une clause WHERE, mais en ne nécessitant l'exécution que d'une interrogation du serveur, puisque le filtre fournit les données côté client, ce qui optimise les performances.


Exécution d'interrogations lors de l'ouverture d'un affichage

Pour exécuter une interrogation lors de l'ouverture d'un affichage :

1	Cliquez deux fois sur l'objet Interrogation que vous voulez modifier ou sélectionnez  l'objet dans le Navigateur d'objet et choisissez la commande Propriétés dans le menu instantané.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation de l'interrogation en cours.

2	Si nécessaire, sélectionnez une autre interrogation dans la liste déroulante Interrogation.

3	Choisissez l'onglet Options pour afficher la page de propriété Options.

4	Activez Exécuter à l'ouverture de l'affichage en sélectionnant sa case à cocher.


Exécution d'interrogations à des intervalles spécifiques

Pour exécuter une interrogation à des intervalles spécifiques :

1	Cliquez deux fois sur l'objet Interrogation que vous voulez modifier ou sélectionnez  l'objet dans le Navigateur d'objet et choisissez la commande Propriétés dans le menu instantané.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation de l'interrogation en cours.

2	Si nécessaire, sélectionnez une autre interrogation dans la liste déroulante Interrogation.

3	Choisissez l'onglet Options pour afficher la page de propriété Options.

4	Activez Exécuter sur horloge en sélectionnant sa case à cocher.

5	Sélectionnez une horloge dans la liste déroulante ou sélectionnez Nouveau pour créer une nouvelle horloge.


Exécution d'interrogations à l'aide de PL/SQL

  Rubriques connexes

Pour exécuter une interrogation à l'aide de PL/SQL :

 Utilisez les sous-programmes intégrés PL/SQL OG_EXECUTE_QUERY et OG_UPDATE_CHART.

L'exemple suivant exécute l'interrogation indiquée et met à jour le graphique associé :

PROCEDURE every_30_secs IS
   query   OG_QUERY;
   the_chart   OG_OBJECT;
BEGIN
   query:=OG_GET_QUERY('interro_emp');
   the_chart:=OG_GET_OBJECT('graph_emp');
   OG_EXECUTE_QUERY(query);
   OG_UPDATE_CHART(the_chart, OG_ALL_CHUPDA);
END;


Suppression d'interrogations dans le Navigateur d'objet

Pour supprimer une interrogation dans le Navigateur d'objet :

1	Sélectionnez l'objet Interrogation que vous voulez supprimer.

2	Sélectionnez Supprimer dans le Navigateur d'objet ou choisissez Navigateur [image] Supprimer.

Un message d'alerte vous demande de confirmer la suppression.

3	Sélectionnez Oui pour confirmer.

Utilisez cette méthode pour supprimer rapidement une ou plusieurs interrogations du Navigateur d'objet. Si vous voulez visualiser l'interrogation avant de la supprimer, utilisez la méthode de la fenêtre de propriété Interrogation décrite ci-dessous.


Suppression d'interrogations dans la fenêtre de propriété Interrogation

Pour supprimer une interrogation dans la fenêtre de propriété Interrogation :

1	Cliquez deux fois sur l'objet Interrogation que vous voulez supprimer ou sélectionnez-le dans le Navigateur d'objet et choisissez la commande Propriétés dans le menu instantané.

Vous pouvez également choisir Outils [image] Interrogations pour afficher la fenêtre de propriété Interrogation pour l'interrogation en cours.

2	Si nécessaire, sélectionnez une autre interrogation dans la liste déroulante Interrogation.

3	Sélectionnez Supprimer.

Un message d'alerte vous demande de confirmer la suppression.

4	Sélectionnez Oui pour confirmer.

Utilisez cette méthode si vous voulez visualiser le contenu d'une interrogation avant de la supprimer.


A propos du changement de nom de couches

  Rubriques connexes

Vous pouvez renommer une couche à deux endroits différents :

•	dans la boîte de dialogue Couches - paramètres

•	dans le Navigateur d'objet

Si vous renommez une couche à laquelle vous avez fait référence dans une unité de programme PL/SQL, vous devez changer toutes les références en conséquence.


Activation de couches

Pour activer une couche :

1	Cliquez deux fois sur l'objet couche dans le Navigateur pour afficher la boîte de dialogue Couches - paramètres.

Vous pouvez également sélectionner l'objet couche dans le Navigateur et choisir la commande Propriétés du menu instantané, ou choisir Outils [image] Propriétés dans le menu.

2	Sélectionnez une couche dans la liste Couches existantes.

3	Sélectionnez Activer.

La couche figure dans le champ Couche active. Si la couche était masquée précédemment, elle est affichée.

4	Sélectionnez OK pour confirmer les modifications et fermer la boîte de dialogue Couches - paramètres.

Pour utiliser une couche, vous devez l'activer. Il n'est possible d'activer qu'une couche à la fois.


Activation d'une couche à l'aide de PL/SQL

  Rubriques connexes

Pour activer une couche à l'aide de PL/SQL :

 Utilisez le sous-programme intégré PL/SQL OG_ACTIVATE_LAYER.

L'exemple suivant active la couche indiquée dans la fenêtre indiquée :

PROCEDURE activate_a_layer(layer_num IN NUMBER, the_window
 IN og_window) IS
   layer_name   VARCHAR2(6);
   the_layer    OG_LAYER;
BEGIN
   layer_name:='couche'||TO_CHAR(layer_num);
   the_layer:=OG_GET_LAYER(layer_name);
   OG_ACTIVATE_LAYER(the_layer, the_window);
END;


Changement de nom d'une couche dans la boîte de dialogue Couches - paramètres

Pour renommer une couche dans la boîte de dialogue Couches - paramètres :

1	Cliquez deux fois sur l'objet couche dans le Navigateur pour afficher la boîte de dialogue Couches - paramètres.

Vous pouvez également sélectionner l'objet couche dans le Navigateur et choisir la commande Propriétés dans le menu instantané, ou choisir Outils [image] Propriétés dans le menu.

2	Sélectionnez la couche dans la liste Couches existantes.

La couche apparaît dans le champ Renommer.

3	Entrez le nouveau nom de la couche dans le champ Renommer.

4	Sélectionnez Renommer.

Dans la liste Couches existantes, le nouveau nom remplace l'ancien.

5	Sélectionnez OK pour confirmer les changements et fermer la boîte de dialogue Couches - paramètres.


Changement de nom d'une couche dans le Navigateur d'objet

Pour renommer une couche dans le Navigateur d'objet :

1	Sélectionnez l'objet couche que vous voulez renommer.

2	Faites passer le pointeur de la souris sur le nom de la couche. Le curseur passe d'un pointeur à un éditeur de texte.

3	Sélectionnez une fois le nom pour positionner le curseur et passer en mode d'édition. Si vous voulez remplacer la totalité du nom, sélectionnez le nom pour le mettre en évidence, puis entrez le nouveau nom.


Masquage et affichage de couches

Pour masquer ou afficher une couche :

1	Cliquez deux fois sur l'objet couche dans le Navigateur pour afficher la boîte de dialogue Couches - paramètres.

Vous pouvez également sélectionner l'objet couche dans le Navigateur et choisir la commande Propriétés dans le menu instantané, ou choisir Outils [image] Propriétés dans le menu.

2	Sélectionnez la couche dans la liste Couches existantes.

3	Sélectionnez Masquer/Afficher.

 Si la couche était masquée, un signe plus (+) apparaît devant la couche, pour indiquer qu'elle est désormais affichée.

 Si la couche était affichée, un signe moins (-) apparaît devant la couche, pour indiquer qu'elle est désormais masquée.

 Vous pouvez masquer toute couche affichée sauf la couche active. Pour masquer la couche active, vous devez commencer par en activer une autre.

4	Sélectionnez OK pour confirmer les modifications et fermer la boîte de dialogue Couches - paramètres.

Vous pouvez masquer ou afficher le nombre de couches de votre choix. Vous ne pouvez pas masquer la couche active. Si vous voulez masquer une couche active, vous devez commencer par en activer une autre.


Masquage et affichage de couches à l'aide de PL/SQL

  Rubriques connexes

Pour masquer et afficher des couches à l'aide de PL/SQL

 Utilisez les sous-programmes intégrés PL/SQL OG_HIDE_LAYER et OG_SHOW_LAYER.

Le premier exemple masque la couche indiquée, et le second l'affiche :

PROCEDURE make_layer1_invis(the_window) IS
   my_layer   OG_LAYER;
BEGIN
   my_layer:=OG_GET_LAYER('couche1');
   OG_HIDE_LAYER(my_layer, the_window);
END;

PROCEDURE make_layer_visible(the_window) IS
   my_layer   OG_LAYER;
BEGIN
   my_layer:=OG_GET_LAYER('couche1');
   OG_SHOW_LAYER(my_layer, the_window);
END;


Réorganisation de couches

Pour réorganiser des couches :

1	Cliquez deux fois sur l'objet couche dans le Navigateur pour afficher la boîte de dialogue Couches - paramètres.

Vous pouvez également sélectionner l'objet couche dans le Navigateur et choisir la commande Propriétés dans le menu instantané, ou choisir Outils [image] Propriétés dans le menu.

2	Sélectionnez la couche que vous voulez déplacer dans la liste Couches existantes.

3	Choisissez les boutons Haut (pour remonter d'une couche), Bas (pour descendre d'une couche), Sommet (pour passer au somme de la pile) ou Base (pour passer à la base de la pile).

La couche passe à sa nouvelle position dans la pile.

4	Sélectionnez OK pour confirmer les changements et fermer la boîte de dialogue Couches - paramètres.


Suppression de couches

Pour supprimer une couche :

1	Cliquez deux fois sur l'objet couche dans le Navigateur pour afficher la boîte de dialogue Couches - paramètres.

Vous pouvez également sélectionner l'objet couche dans le Navigateur et choisir la commande Propriétés dans le menu instantané, ou choisir Outils [image] Propriétés dans le menu.

2	Sélectionnez la couche à supprimer dans la liste Couches existantes.

3	Sélectionnez Supprimer.

4	Sélectionnez Oui pour confirmer le message d'alerte qui apparaît.

La couche est supprimée de la liste Couches existantes.

5	Sélectionnez OK pour confirmer les changements et fermer la boîte de dialogue Couches - paramètres.

La couche et ses objets sont supprimés de l'affichage. Vous pouvez supprimer des couches non actives, qu'elles soient affichées ou masquées. La suppression d'une couche supprime également tous les objets qu'elle contient. Vous ne pouvez pas supprimer la couche active. Si vous voulez supprimer la couche active, vous devez commencer par en activer une autre.


A propos des sorties utilisateur

Une sortie utilisateur est un programme que vous écrivez et que vous liez dans les fichiers exécutables Graphics Builder. Vous pouvez ainsi appeler vos programmes L3G à partir de Graphics Builder. Utilisez des sorties utilisateur pour transférer le contrôle de Graphics Builder à un programme que vous avez écrit pour exécuter une fonction particulière, puis rendre le contrôle à Graphics Builder.

Les sorties utilisateur peuvent exécuter les tâches suivantes :

•	transmettre les données à Graphics Builder à partir de fichiers texte du système d'exploitation

•	manipuler des données de type LONG RAW

•	prendre en charge des blocs PL/SQL

•	gérer des unités en temps réel (une imprimante, par exemple)

Vous pouvez utiliser des sorties utilisateur pour d'autres opérations, pour exécuter des traitements mathématiques par exemple. Cependant, Oracle conseille d'exécuter ces tâches avec PL/SQL dans Graphics Builder, car PL/SQL est portable et les sorties utilisateur ne le sont pas.

Remarque : Les différents types de sortie utilisateur ne peuvent pas tous exécuter la totalité des tâches décrites. Certaines ne peuvent être exécutées qu'avec des sorties utilisateur du Précompilateur ORACLE.


A propos des sorties utilisateur du Précompilateur ORACLE

Une sortie utilisateur du Précompilateur ORACLE comprend l'interface du Précompilateur ORACLE qui vous permet d'écrire un sous-programme dans l'un des langages hôte (Ada, C, COBOL, FORTRAN, Pascal, PL/l) et d'incorporer des commandes SQL. La sortie utilisateur peut également accéder aux paramètres ORACLE (par des commandes SQL incorporées) et Graphics Builder.

Cela étant, vous écrirez la plupart de vos sorties utilisateur sous la forme de sorties utilisateur du Précompilateur ORACLE. Pour plus d'informations sur l'interface du Précompilateur ORACLE, reportez-vous à Programmer's Guide to the ORACLE Precompilers.

Vous pouvez également écrire une sortie utilisateur qui combine l'interface du Précompilateur ORACLE et l'OCI.

Remarque : Seuls certains systèmes d'exploitation acceptent la totalité des langages indiqués. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.


A propos des sorties utilisateur OCI (ORACLE Call Interface)

Une sortie utilisateur OCI comprend l'interface ORACLE Call Interface qui vous permet d'écrire un sous-programme contenant des appels à ORACLE.

Une sortie utilisateur qui ne comprend que l'OCI (et non l'interface du Précompilateur ORACLE) ne peut pas accéder aux paramètres de Graphics Builder. Pour plus d'informations sur l'OCI, reportez-vous à Programmer's Guide to the ORACLE Call Interface.

Vous pouvez également écrire une sortie utilisateur qui combine l'interface du Précompilateur ORACLE et l'OCI.


A propos des sorties utilisateur non ORACLE

Une sortie utilisateur non ORACLE ne comprend ni l'interface du Précompilateur ORACLE ni l'OCI. Par exemple, ce type de sortie utilisateur peut être écrit entièrement en C. Par définition, une sortie utilisateur non ORACLE ne peut accéder ni aux paramètres de Graphics Builder ni à ORACLE.


A propos de l'écriture d'une sortie utilisateur

  Rubriques connexes

La présente section est consacrée aux étapes de base de l'écriture d'une sortie utilisateur du Précompilateur ORACLE. (Elle concerne particulièrement les sorties utilisateur du Précompilateur ORACLE, car c'est le type de sortie utilisateur que vous utiliserez le plus fréquemment. Elle peut accéder aux paramètres et aux variables de Graphics Builder, et aux données de la base de données ORACLE, et c'est le type que ORACLE conseille pour la plupart des tâches.)

Pour écrire une sortie utilisateur, vous devez connaître :

•	les fonctions prises en charge (et notamment la façon dont Graphics Builder lit et transmet des arguments, et dont vous pouvez générer des erreurs à partir de la sortie utilisateur)

•	la syntaxe d'un appel à une sortie utilisateur transmise (c'est-à-dire, la façon dont se présente l'appel lorsque le programme de sortie utilisateur le reçoit)

Remarque : Les détails sur la façon d'écrire et de mettre en oeuvre une sortie utilisateur ont été omis, car ils sont fonction du système d'exploitation que vous utilisez et du langage dans lequel vous avez choisi d'écrire la sortie utilisateur.


A propos de la mise en oeuvre des sorties utilisateur

En général, la mise en oeuvre d'une sortie utilisateur implique plusieurs opérations :

•	création d'une table IAPXTB et insertion dans cette table du nom de chaque sortie utilisateur (à raison d'une ligne par sortie utilisateur).

•	génération d'un fichier source à partir de la table IAPXTB.

•	compilation du fichier source IAPXTB et du programme que vous avez écrit, puis lien des modules objet résultants avec G30DES, G30RUN et/ou G30BAT.


Ecriture d'une sortie utilisateur

Pour écrire une sortie utilisateur :

1	Créez votre affichage sans sortie utilisateur.

2	Choisissez les sorties utilisateur dont vous avez besoin.

3	Ecrivez la sortie utilisateur dans l'un des langages de programmation hôte.

4	Mettez en oeuvre la sortie utilisateur, ce qui implique les étapes suivantes :

 Création d'une table IAPXTB et insertion de chaque nom de sortie utilisateur (à raison d'une ligne par sortie).

 Génération d'un fichier source à partir de la table IAPXTB.

 Compilation du fichier source IAPXTB et du programme que vous avez écrit, puis lien à G30DES, G30RUN et/ou G30BAT.

5	Création de l'objet Graphics Builder et de l'appel à la sortie utilisateur (suivi des arguments que vous voulez transmettre).

Remarque : Certains détails sur la mise en oeuvre des sorties utilisateur sont propres au système d'exploitation que vous utilisez. Pour plus d'informations sur la marche à suivre, reportez-vous à la documentation de Graphics Builder de votre système d'exploitation.


Création de la table IAPXTB

Pour créer la table IAPXTB :

 Pour pouvoir mettre en oeuvre une sortie utilisateur (sur un système d'exploitation quelconque), vous devez avoir le programme GENXTB et l'application Forms GENXTB. Pour plus d'informations sur la façon de se les procurer, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

Utilisez le programme GENXTB pour créer la table IAPXTB, qui est la table de base qui sera utilisée par l'application Forms GENXTB. Pour plus d'informations sur la façon d'utiliser le programme GENXTB, reportez-vous à la documentation Graphics Builder de votre système d'exploitation. Si vous ne possédez pas Form Builder, créez une table IAPXTB vous-même en utilisant SQL*Plus. Pour tous détails sur la façon de créer des tables, reportez-vous à SQL*Plus User's Guide and Reference.

La table IAPXTB contient la liste de toutes les sorties utilisateur que vous lierez à Graphics Builder. Chaque colonne de cette table est décrite ci-dessous :

Nom de la colonne	Description	Utilisation

XTB$XNM	NOM	Cette colonne indique le nom de la sortie  utilisateur (qui n'est pas obligatoirement  celui du fichier qui contient la sortie  utilisateur). Notez que certains langages  hôte font la distinction entre les majuscules  et les minuscules.
XTB$XTY	TYPE	Cette colonne indique le langage dans  lequel la sortie utilisateur est écrite.
XTB$REM	REMARQUES	Cette colonne indique une chaîne de  texte qui décrit le but de la sortie  utilisateur. Cette chaîne ne peut pas avoir  plus de 80 caractères de long.
XTB$CRE	CREATION	Cette colonne indique la date à laquelle  vous avez créé un enregistrement dans la  table IAPXTB. Lorsque vous validez un  enregistrement, l'application Forms  GENXTB entre automatiquement une valeur  dans cette colonne.
XTB$MOD	MODIFICATION	Cette colonne indique la date à laquelle  vous avez modifié pour la dernière fois un  enregistrement de la table IAPXTB. Lorsque  vous validez un enregistrement,  l'application Forms GENXTB entre  automatiquement une valeur dans cette colonne.

La table doit contenir les noms de toutes les sorties utilisateur que vous voulez utiliser. Par exemple, si vous avez déjà une table comportant les sorties utilisateur Form Builder, vous devez ajouter les sorties utilisateur Graphics Builder en package (dont aucune n'est fournie à l'heure actuelle) et les nouvelles sorties utilisateur que vous créez.

Utilisez l'application Forms GENXTB, qui est une application Forms de Form Builder, pour insérer les descriptions de vos sorties utilisateur dans la table IAPXTB. Si vous n'avez pas Form Builder, utilisez SQL*Plus pour insérer les lignes. (Pour tous détails sur la façon d'insérer des lignes dans une table, reportez-vous à SQL*Plus User's Guide and Reference.)

Vous devez entrer dans la table IAPXTB une ligne par nom de sortie utilisateur. (Cette condition doit être respectée pour les sorties utilisateur du Précompilateur ORACLE, qu'une sortie utilisateur soit dans un fichier qui sera précompilé et compilé seul, ou avec plusieurs autres sorties utilisateur.) En outre, vous devez tenir à jour toutes les sorties utilisateur de production d'un système dans une même table IAPXTB.

Le processus de mise en oeuvre d'une sortie utilisateur est propre au système d'exploitation utilisé. Pour toute information sur la marche à suivre, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

Remarque :

Vous devez stocker les versions texte de vos sorties utilisateur dans une table IAPXTB distincte, au cas où la table serait accidentellement détruite.


Génération du fichier source IAPXTB

Pour générer le fichier source IAPXTB :

 Utilisez le programme GENXTB pour lire les informations dans la table IAPXTB et générer son fichier source. Ce fichier source est le fichier de point d'entrée dont vous aurez besoin pour lier vos sorties utilisateur.

Remarque : La mise en oeuvre d'une sortie utilisateur est propre au système d'exploitation utilisé. Pour plus d'informations sur la marche à suivre, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.


Compilation du fichier source et du programme

Pour compiler le fichier source et le programme :

 Compilez le fichier source IAPXTB et votre programme de sortie utilisateur. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation. Liez ensuite le fichier objet IAPXTB résultant aux exécutables G30DES, G30RUN et/ou G30BAT.

Remarque : La mise en oeuvre d'une sortie utilisateur est propre au système d'exploitation utilisé. Pour plus d'informations sur la marche à suivre, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.


Ecriture d'un appel à une sortie utilisateur

Pour écrire un appel à une sortie utilisateur :

Vous pouvez appeler la sortie utilisateur à partir de tout point d'entrée vous pouvez entrer dans PL/SQL à partir de Graphics Builder . Utilisez la syntaxe suivante :

Syntaxe:	og_user_exit('nom_sortie_utilisateur [liste_arguments]');

où :

nom_sortie_utilisateur	Indique le nom de la sortie utilisateur à laquelle vous transférez le contrôle. Ce nom peut avoir la longueur de votre choix. (Sur certains systèmes d'exploitation, il est cependant limité à 6 caractères. Interrogez votre administrateur système.)

liste_arguments	Peut contenir les noms des paramètres arbitraires que vous voulez transmettre à la sortie utilisateur. La liste d'arguments peut avoir la longueur de votre choix.

Remarque : La syntaxe ci-dessus doit être incorporée dans une procédure déclencheur ou un bouton PL/SQL.

Exemples :

Vous avez écrit une sortie utilisateur (appelée INTEGRAL) qui calcule la superficie sous une courbe, en fonction de deux points de la courbe. Vous avez quatre paramètres Graphics Builder (appelés POINT1X, POINT1Y, POINT2X et POINT2Y) dont les valeurs contiennent les coordonnées x et y des deux points. Votre appel de sortie utilisateur peut se présenter de la manière suivante :

og_user_exit('integral point1x point1y point2x point2y');

Enfin, vous voulez que le programme de sortie utilisateur retourne (EXEC TOOLS SET) la superficie calculée dans un paramètre Graphics Builder appelé SUPERFICIE. Pour cela, il suffit d'écrire la sortie utilisateur devant DEFINIR (SET) la valeur du paramètre SUPERFICIE.

Règles :

1	Les noms de sortie utilisateur doivent respecter les conventions de votre système d'exploitation et du langage hôte. N'oubliez pas que ces règles peuvent impliquer le respect de la distinction entre majuscules et minuscules.

2	Le nom de la sortie utilisateur ne peut pas avoir plus de 10 caractères de long (6 sur certains systèmes d'exploitation). La longueur maximum de la liste d'arguments est de 230 caractères. Les espaces sont pris en compte.

Remarque : Ces limites peuvent dépendre du système d'exploitation utilisé. Interrogez votre administrateur système.

3	Les arguments doivent être séparés uniquement par des espaces. Si deux arguments de la liste des arguments sont séparés par plusieurs espaces, Graphics Builder supprime les espaces supplémentaires avant de transmettre la chaîne à la sortie utilisateur.

Par exemple, l'appel :

'quota 10 20     Q4'

est transmis à la sortie utilisateur sous la forme :

'quota 10 20 Q4'

4	Pour faire référence à des guillemets littéraux, dans une liste d'arguments, utilisez \". La barre oblique \ sera supprimée avant la transmission de l'argument.


Recherche des erreurs de sortie utilisateur dans PL/SQL

Pour rechercher des erreurs de sortie utilisateur dans PL/SQL :

 Utilisez les exceptions suivantes :

OG_USEREXIT_FAILURE_ERROR

OG_USEREXIT_FATAL_ERROR

L'exception OG_USEREXIT_FAILURE_ERROR est générée lorsque la sortie utilisateur retourne FAILURE ; et l'exception OG_USEREXIT_FATAL_ERROR lorsque la sortie utilisateur retourne FATAL.

Exemple :

Vous avez une sortie utilisateur appelée MASORTIE, et vous voulez savoir si elle a échoué. Votre sortie utilisateur peut se présenter de la manière suivante :

BEGIN
  og_user_exit('masortie');
EXCEPTION
  WHEN og_userexit_failure_error THEN
    og_quit;
  WHEN og_userexit_fatal_error THEN
    og_quit;
END;


A propos du stockage de fichiers Graphics Builder

Certains systèmes permettent (ou imposent) d'ajouter des extensions à la fin des noms de fichier lorsque vous les enregistrez. Dans ces cas, Graphics Builder suggère les extensions suivantes :

Extension	Type de fichier	Créé par

.afc	son AIFF-c	export d'un son
.bmp	image BMP	export d'une image
.cgm	dessin CGM	export d'un dessin
.cht	modèle de graphique	export d'un modèle de graphique
.jpg	image JFIF	export d'une image
.odf	dessin Oracle Format	export d'un dessin
.ogd	fichier Graphics Builder	enregistrement d'un affichage
.ogr	fichier Runtime Graphics Builder	génération d'un affichage
.oif	image Oracle Format	export d'une image
.osf	son Oracle Format	export d'un son
.pal	palette de couleurs	export d'une palette de couleurs
.pcx	image PCX	export d'une image
.pic	image PICT	export d'une image
.pll	bibliothèque PL/SQL	enregistrement d'une bibliothèque PL/SQL
.pls	unité de programme PL/SQL	export d'un texte source PL/SQL
.tif	image TIFF	export d'une image


A propos de la recherche de fichiers

 Rubriques connexes

Lorsque vous faites référence à un fichier en utilisant des sous-programmes intégrés PL/SQL, Graphics Builder effectue sa recherche dans l'ordre suivant :

1	Chemin d'accès précédant le nom du fichier (par exemple, C:\images\produit.tif), s'il existe.

2	Chemin d'accès que votre système d'exploitation considère comme le chemin "courant". Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

3	Chemin d'accès indiqué par la variable d'environnement GRAPHICS30.

4	Chemin d'accès indiqué par la variable d'environnement ORACLE_HOME.


A propos des extensions de fichiers et de l'ordre de recherche

 Rubriques connexes

Les noms de fichier que vous indiquez dans les sous-programmes intégrés PL/SQL de Graphics Builder peuvent avoir des extensions. Dans l'affirmative, Graphics Builder recherche d'abord le fichier correspondant exactement au nom indiqué.

Si vous avez indiqué un nom de fichier sans extension, Graphics Builder commence par rechercher le fichier correspondant exactement au nom indiqué. S'il ne le trouve pas, il ajoute l'extension appropriée à ce type de fichier, puis reprend sa recherche.

Par exemple, si vous importez une image TIFF et que vous indiquiez que le fichier s'appelle bougie, Graphics Builder commence par rechercher le fichier portant ce nom puis, s'il ne le trouve pas, recherche le fichier bougie.tif.


A propos du transfert de documents entre des fichiers et la base de données

Vous pouvez transférer entre des fichiers et la base de données les types de document suivants :

affichages

autres modules


Transfert d'affichages entre le système de fichiers et la base de données

Pour transférer à la base de données un affichage stocké dans un fichier :

1	Dans Builder, choisissez Fichier [image] Ouvrir.

2	Choisissez Fichier [image] Enregistrer sous [image] Base de données.

Vous pouvez alors supprimer le fichier de votre système de fichiers en utilisant les commandes du système d'exploitation.

Pour transférer dans un fichier un affichage stocké dans la base de données :

1	Dans Builder, choisissez Fichier [image] Ouvrir.

2	Choisissez Fichier [image] Enregistrer sous [image] Système de fichiers.

Vous pouvez alors supprimer la version base de données du module en choisissant Fichier [image] Administration [image] Supprimer.


Transfert d'autres documents entre le système de fichiers et la base de données

Pour transférer un autre document entre le système de fichiers et la base de données :

 Importez-le dans un affichage, puis exportez-le. Cette procédure permet de transférer les documents suivants :

•	modèles de graphique

•	palettes de couleurs

•	dessins

•	images

•	bibliothèques PL/SQL

•	sons


Suppression de documents

Pour supprimer un document d'un fichier :

 Utilisez les commandes appropriées du système d'exploitation.

Pour supprimer un module de la base de données :

  Choisissez Fichier [image] Administration [image] Supprimer [image] <type_module>.


A propos des exécutables

Les exécutables sont des fichiers binaires que vous utilisez pour appeler des composants Builder, Runtime et mode Batch. Ils sont représentés soit par des noms en un seul mot que vous entrez (avec les mots-clés) sur une ligne de commande système, soit par des icônes que vous appelez à partir du bureau. Au départ, ils doivent figurer dans le dossier ou dans le sous-répertoire bin .

Les exécutables de Graphics Builder sont les suivants :

G30BAT	Permet de lancer un fichier exécutable ou un fichier Builder dans un environnement non-bitmap, pour que la sortie de l'affichage puisse être dirigée vers une imprimante, un fichier ou une base de données.

G30RUN	Permet d'exécuter un affichage stocké dans un fichier Builder ou un fichier exécutable.

G30DES	Permet d'appeler Graphics Builder pour que vous puissiez créer, modifier et tester des affichages.


Règles de syntaxe de la ligne de commande

  Rubriques connexes

Lorsque vous appelez un exécutable dans la ligne de commande, il se présente généralement sous la forme :

nom_exécutable mot_clé1=valeur1 mot_clé2=valeur2 ...

Chaque mot_clé=valeur est appelé argument. Pour éviter d'alourdir le programme, vous pouvez ne pas entrer à chaque fois les mots-clés.

Les règles de syntaxe applicables à tous les exécutables Graphics Builder sont les suivantes :

1	Le signe égal d'un argument ne doit être ni précédé ni suivi d'un espace.

2	Les arguments doivent être séparés par un ou plusieurs espaces ; ils ne peuvent pas être séparés par des virgules.

3	Les valeurs des arguments peuvent être entre guillemets simples ou doubles. Celà dépend du système utilisé. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

4	La partie mot_clé= de tous les arguments peut être entrée indifféremment en majuscules ou en minuscules. La partie valeur de tous les arguments en revanche, sauf USERID, PRINT, COPIES, CLOSE et QUIT, peut devoir être entrée soit en majuscules, soit en minuscules, selon le système d'exploitation utilisé. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

5	Les mots-clés peuvent parfois être omis.

6	Toutes les références de fichier peuvent avoir des noms de chemin complet.

7	Les valeurs indiquées dans la ligne de commande ont priorité sur les valeurs par défaut de Builder ou de Runtime. Par exemple, si le nom d'imprimante par défaut est `imprimante1' et si vous appelez Builder à partir de la ligne de commande en indiquant PRINTER=`imprimante2', l'affichage sera imprimé sur `imprimante2'.

De même, les valeurs indiquées explicitement dans un exécutable ont priorité sur les valeurs de la ligne de commande. Par exemple, si vous appelez Builder et indiquez le nom de l'imprimante dans la ligne de commande, vous pouvez remplacer cette valeur de l'imprimante en la changeant dans Builder.


Utilisation des mots-clés

La partie mot_clé= de chaque argument est facultative tant que les arguments sont entrés dans l'ordre indiqué par la syntaxe. Si vous omettez un argument, vous devez indiquer les mots-clés après l'argument que vous avez omis.

Par exemple, si un exécutable a quatre arguments et que vous vouliez n'indiquer que le premier, le deuxième et le quatrième, vous pouvez omettre les mots-clés des deux premiers, mais vous devez indiquer celui du quatrième argument puisque vous ne l'entrez pas dans l'ordre prévu par la syntaxe.

Exemples (valides) :

Exemples de séquences de lignes de commandes valides :

     g30des openfile=mon_affichage print=yes userid=scott/tigre

     g30des mon_affichage scott/tiger print=yes

Dans le second exemple, le mot-clé PRINT est obligatoire puisqu'il y a un mot-clé non utilisé entre USERID et PRINT.

Exemple (non valide) :

Exemple de séquence de ligne de commande non valide :

     g30des scott/tiger openfile=mon_affichage

Cet exemple n'est pas valide parce que "scott/tiger" n'est pas entré à l'endroit prévu et ne comporte pas le mot-clé USERID.


Listes de valeurs

La plupart des mots-clés permettent d'indiquer plusieurs valeurs. Par exemple, OPENFILE et OPENDB acceptent une liste de valeurs qui indiquent que l'exécutable ouvrira plusieurs affichages :

     g30des openfile=(d1,d2,d3)

Cette règle vous permet de n'écrire qu'une instruction de ligne de commande pour plusieurs affichages. Par exemple, vous pouvez ouvrir plusieurs affichages, les exporter dans des fichiers CGM et les imprimer en n'écrivant qu'une instruction de ligne de commande.

La liste de valeurs doit être précédée et suivie de parenthèses, et les valeurs séparées par des virgules. Notez que certains systèmes imposent des règles spéciales d'utilisation de parenthèses et de virgules dans la ligne de commande. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

Correspondance de valeurs

Lorsque vous n'ouvrez qu'un affichage et que vous indiquez d'autres mots-clés dans la ligne de commande, Graphics Builder exécute les opérations indiquées par les autres mots-clés sur l'affichage qui est ouvert. Par exemple, si vous indiquez à la fois OPENFILE et PRINT dans une instruction de ligne de commande, Graphics Builder ouvre le fichier indiqué et l'imprime :

     g30des openfile=d1 print=yes

Si vous utilisez une liste de valeurs pour ouvrir plusieurs affichages à partir de la ligne de commande et que vous entriez aussi une liste de valeurs pour d'autres mots-clés, Graphics Builder établit la correspondance des valeurs des mots-clés avec les affichages ouverts, en fonction de leur position dans leurs listes de valeurs. Par exemple :

     g30des openfile=(d1,d2,d3) print=(yes,no,yes)

Dans cet exemple, Graphics Builder ouvre les trois affichages, mais n'imprime que d1 et d3.

Si vous utilisez à la fois OPENFILE et OPENDB pour ouvrir des affichages, ceux qui sont ouverts par OPENFILE auront priorité lorsqu'ils seront comparés à d'autres valeurs de mots-clés. Par exemple :

     g30des opendb=(d1,d2) openfile=d3 print=(yes,no,yes)

Dans cet exemple, d3 et d2 sont imprimés, mais d1 ne l'est pas.

Vous ne pouvez pas donner la valeur "nul" à un mot-clé. Par exemple, vous ne pouvez pas ouvrir trois affichages et ne générer que le premier et le troisième :

     g30des openfile=(d1,d2,d3) generatefile=(g1,,g3)  --non valide

L'absence de la seconde valeur dans la liste de valeurs GENERATEFILE générera une erreur.

Valeurs de remplacement

Si la liste de valeurs d'un mot-clé comporte moins de valeurs que d'affichages ouverts, Graphics Builder remplace les valeurs manquantes soit par la dernière valeur indiquée pour le mot-clé, soit par sa valeur par défaut. L'effet de ce remplacement est indiqué ci-après dans la description de chaque mot-clé.

Si la liste de valeurs d'un mot-clé comporte davantage de valeurs que d'affichages ouverts, les valeurs excédentaires ne sont pas prises en compte.

Exemples :

Exemples d'instructions de ligne de commande :

1	g30run openfile=d1 print=yes copies=2 exportcgm=fichier_cgm quit=yes

Graphics Builder exécute l'affichage d1, en imprime deux copies sur votre imprimante par défaut, l'exporte dans le fichier CGM fichier_cgm, puis quitte.

2	g30run openfile=(d1,d2) userid=(scott/tiger,steve/lion)

Graphics Builder exécute l'affichage d1 en utilisant le nom utilisateur/mot de passe de base de données scott/tiger, et d2 en utilisant le nom utilisateur/mot de passe de base de données steve/lion.

3	g30des openfile=(d1,d2) print=yes

Graphics Builder ouvre et imprime une copie de d1 et de d2 sur votre imprimante par défaut. Notez que le mot-clé PRINT utilise la dernière valeur indiquée (yes) pour remplacer les valeurs manquantes.

4	g30des openfile=(d1,d2) opendb=d3 generatefile=(g1,g2) print=(no,no,yes) 	close=(yes,yes)

Graphics Builder ouvre, génère et ferme d1 ; ouvre, génère et ferme d2 ; et ouvre, imprime et ferme d3. Notez que le mot-clé GENERATEFILE ne remplace pas les valeurs manquantes et que le mot-clé CLOSE utilise la dernière valeur indiquée (yes) pour remplacer les valeurs manquantes.


Login explicite
Connexion explicite

Vous pouvez vous connecter explicitement à la base de données en utilisant le mot-clé USERID pour un exécutable, en sélectionnant Fichier [image] Connexion dans les exécutables Builder or Runtime ou en sélectionnant Connexion dans la boîte de dialogue de l'Editeur d'instructions SQL de Builder.

USERID

Permet d'indiquer votre nom utilisateur et votre mot de passe ORACLE avec un protocole SQL*Net facultatif.

Options :	La valeur de ce mot-clé doit prendre l'une des formes suivantes :

nom_utilisateur/mot_de_passe

nom_utilisateur/mot_de_passe@node

Et, si vous souhaitez vous connecter à une source de données autre que Oracle :

nom_utilisateur/mot_de_passe@ODBC:source_de_données[:nom_bd]

Si vous utilisez l'option nom_utilisateur/mot_de_passe@ODBC:source_de_données[:nom_bd] pour vous connecter à une base de données ODBC, sans indiquer de nom de base de données (nom_bd), la base de données en cours est utilisée.


Connexion automatique

La fonction de connexion automatique d'ORACLE vous permet de vous connecter à Graphics Builder sans indiquer explicitement un nom utilisateur et un mot de passe. Vous pouvez utiliser cette fonction avec tous les exécutables de Graphics Builder. Pour plus d'informations sur l'utilisation de cette fonction, reportez-vous à Oracle7 Server Administrator's Guide.

Lorsque vous utilisez cette option, ORACLE fait appel à une connexion par défaut (par exemple, OPS$) pour associer votre nom utilisateur ORACLE à votre nom utilisateur de système d'exploitation. Pour appeler une procédure de connexion automatique, vous avez le choix entre plusieurs possibilités :

•	Appeler un exécutable à partir de la ligne de commande en utilisant le mot-clé USERID. Si vous n'indiquez pas de nom utilisateur et de mot de passe explicite, vous demandez à Graphics Builder de tenter une connexion automatique.

•	Laisser vides les champs Nom utilisateur et Mot de passe de la boîte de dialogue Connexion.

Lorsque vous utilisez cette option, vous pouvez accéder à une base de données éloignée en entrant @node après le mot-clé USERID ou node dans le champ Base de données de la boîte de dialogue Connexion.


Connexion à distance

SQL*Net vous permet d'indiquer une base de données éloignée (c'est-à-dire non installée sur votre ordinateur local). Lorsque vous utilisez la fonction de connexion à distance, la base de données éloignée est transparente pour vous : Graphics Builder se comporte de la même façon, qu'il accède à un noeud situé à un endroit quelconque du pays ou à la base de données de votre ordinateur local.

Syntaxe :	nom_pilote:nom_noeud:nom_db

où :

nom_pilote	indique le pilote que vous voulez utiliser pour accéder à l'unité éloignée (c'est-à-dire t:, d: ou, pour une source de données autre que Oracle, ODBC:). Le paramètre par défaut dépend du système.

nom_noeud	indique le noeud de réseau éloigné qui contient la base de données cible (par exemple, london).

nom_bd	indique le nom de la base de données (par exemple, rds).

Pour plus d'informations sur SQL*Net, reportez-vous à Oracle Network Manager Administrator's Guide.

Exemple

Pour exécuter un affichage de la base de données INV du noeud 'london', vous pouvez entrer :

g30run openfile=invent.ogd userid=scott/tiger@D:london:INV


Fichiers journal

Sur certains systèmes, les messages d'erreur de démarrage peuvent être écrits dans une ligne de commande. Sur d'autres, Graphics Builder crée dans un répertoire temporaire un fichier journal destiné à recevoir les messages de démarrage. Chaque exécutable a son propre fichier journal, comme décrit ci-dessous :

Exécutable	Nom du fichier journal

G30DES	godes.log
G30RUN	gorun.log
G30BAT	gobat.log
Le répertoire temporaire dans lequel sont stockés ces fichiers est propre au système. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.


G30DES

L'exécutable G30DES permet d'appeler Graphics Builder, dans lequel vous créez et tenez à jour vos affichages.

Syntaxe :     g30des [[mot_clé=]valeur ]...

où les arguments valides pour mot_clé=valeur sont les suivants :

OPENFILE={fichier|(fichier1,fichier2,...)}

USERID={chaîne_connexion|(chaîne_connexion1,chaîne_connexion2,...)}

OPENDB={nom_affichage|(nom_affichage1,nom_affichage2,...)}

PRINT={{YES|NO}|({YES|NO},{YES|NO},...)}

COPIES={n|(n1,n2,...)}

PRINTER={nom_imprimante|(nom_imprimante1,nom_imprimante2,...)}

PRINTFILE={fichier|(fichier1,fichier2,...)}

EXPORTFILE={fichier|(fichier1,fichier2,...)}

EXPORTCGM={fichier|(fichier1,fichier2,...)}

EXPORTBIT={{16|32}|({16|32},{16|32},...)}

EXPORTDB={nom_dessin|(nom_dessin1,nom_dessin2,...)}

EXPORTIMAGE={fichier}

GENERATEFILE={fichier|(fichier1,fichier2,...)}

GENERATEDB={nom_affichage|(nom_affichage1,nom_affichage2,...)}

SAVEFILE={fichier|(fichier1,fichier2,...)}

SAVEDB={nom_affichage|(nom_affichage1,nom_affichage2,...)}

CLOSE={{YES|NO}|({YES|NO},{YES|NO},...)}

QUIT={YES|NO}

CMDFILE=fichier

LOGFILE=fichier

MODULE={fichier|(fichier1,fichier2,...)}

param={valeur|(valeur1,valeur2,...)}


OPENFILE

Permet d'indiquer le nom du fichier qui contient l'affichage à ouvrir.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


USERID

Permet d'indiquer la chaîne de connexion de votre base de données.

Options :	Entrez une chaîne de connexion de base de données valide.

Valeur par défaut :	Aucune, si la connexion automatique n'est pas activée.

Valeur de remplacement :	Dernière chaîne de connexion indiquée.

Si l'option Connexion au démarrage est cochée et que vous indiquiez ici une chaîne de connexion, la boîte de dialogue Connexion n'apparaîtra pas.


OPENDB

Permet d'indiquer le nom de l'affichage, stocké dans une base de données, qui est à ouvrir. Vous devez aussi vous connecter à une base de données en utilisant un argument USERID.

Options :	Entrez un nom d'affichage valide.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


PRINT

Permet d'indiquer si l'affichage qui a été ouvert par OPENFILE ou OPENDB doit être imprimé, dès son ouverture, sur une imprimante définie par un argument PRINTER.

Options :	yes indique que l'affichage sera imprimé.

Valeur par défaut :	no indique que l'affichage ne sera pas imprimé.

Valeur de remplacement :	Dernière valeur indiquée.


COPIES

Permet d'indiquer le nombre de copies de l'affichage à imprimer.

Options :	Entrez un entier valide.

Valeur par défaut :	1

Valeur de remplacement :	1


PRINTER

Permet d'indiquer le nom de l'imprimante sur laquelle l'affichage sera imprimé.

Options :	Entrez un nom d'imprimante valide. Pour plus d'informations, reportez-vous à la documentation de votre système.

Valeur par défaut :	Le nom de l'imprimante par défaut de votre système.

Valeur de remplacement :	Dernière valeur indiquée ; si aucune valeur n'a été indiquée, l'imprimante par défaut de votre système.


PRINTFILE

Permet d'indiquer le nom du fichier dans lequel l'affichage sera imprimé en format PostScript.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTFILE

Permet d'indiquer le nom du fichier vers lequel l'affichage sera exporté sous la forme d'une image en format Oracle. Toutes les couches, visibles ou masquées, seront exportées.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTCGM

Permet d'indiquer le nom du fichier vers lequel l'affichage sera exporté sous la forme d'une image en format CGM. Toutes les couches, visibles ou masquées, seront exportées.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTBIT

Permet d'indiquer le format d'un affichage exporté dans un fichier CGM.

Options :	16 bits indique l'utilisation d'un espace de coordonnées sur deux octets.

32 bits indique l'utilisation d'un espace de coordonnées sur quatre octets.

Valeur par défaut :	16

Valeur de remplacement :	16


EXPORTDB

Permet d'indiquer le nom sous lequel l'affichage sera exporté vers la base de données sous la forme d'un dessin en format Oracle. Vous devez également vous connecter à une base de données en utilisant un argument USERID. Toutes les couches, visibles ou masquées, seront exportées.

Options :	Entrez un nom valide.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTIMAGE

Permet d'indiquer le nom sous lequel l'affichage sera exporté vers une image dans le format indiqué par l'extension de fichier. Toutes les couches, visibles ou masquées, seront exportées.

Options :	Entrez un nom de fichier valide, ayant l'une des extensions suivantes :
.gif 	pour exporter l'affichage vers un fichier GIF
.jpg 	pour exporter l'affichage vers un fichier JPEG
.bmp 	pour exporter l'affichage vers un bitmap
.tif 	pour exporter l'affichage vers un fichier TIFF
.pict	pour exporter l'affichage vers un fichier PICT

Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


GENERATEFILE

Permet d'indiquer le nom du fichier dans lequel l'affichage sera généré. Lorsque ce mot-clé est utilisé, Graphics Builder compile tous les programmes PL/SQL de l'affichage. En cas d'erreurs de compilation, les messages correspondants seront écrits dans le fichier indiqué par LOGFILE, et l'affichage résultant généré ne sera pas complet.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


GENERATEDB

Permet d'indiquer le nom sous lequel l'affichage sera généré et stocké dans la base de données. Vous devez également vous connecter à une base de données en utilisant un argument USERID. Lorsque ce mot-clé est utilisé, Graphics Builder compile tous les programmes PL/SQL de l'affichage. En cas d'erreurs de compilation, les messages correspondants seront écrits dans le fichier indiqué par LOGFILE, et l'affichage résultant généré ne sera pas complet.

Options :	Entrez un nom d'affichage valide.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


SAVEFILE

Permet d'indiquer le nom du fichier dans lequel l'affichage sera enregistré.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


SAVEDB

Permet d'indiquer le nom sous lequel l'affichage sera enregistré dans la base de données. Vous devez également vous connecter à une base de données en utilisant un argument USERID.

Options :	Entrez un nom d'affichage valide.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


CLOSE

Permet d'indiquer si l'affichage sera fermé lorsque Graphics Builder aura fini de le traiter.

Options :	yes indique que l'affichage sera fermé.

no indique que l'affichage ne sera pas fermé.

Valeur par défaut :	no

Valeur de remplacement :	no


QUIT

Permet d'indiquer si Graphics Builder devra quitter lorsqu'il aura fini de traiter tous les affichages ouverts.

Options :	yes indique que Graphics Builder devra quitter.

no indique que Graphics Builder ne devra pas quitter.

Valeur par défaut :	no

Valeur de remplacement :	N/A


CMDFILE

Permet d'indiquer un fichier texte qui contient des arguments de ligne de commande G30DES valides. Ce paramètre vous permet d'indiquer de nombreux arguments ou un ensemble d'arguments standards sans avoir à les entrer chaque fois que vous utilisez Graphics Builder.

Ce fichier peut ne contenir que des arguments qui seraient des valeurs dans une seule ligne de commande. Les arguments peuvent être séparés par des espaces ou des retours ligne.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


LOGFILE

Permet d'indiquer un fichier texte dans lequel Graphics Builder écrira les messages d'erreur ne pouvant pas figurer dans une alerte. Ces erreurs comprennent les erreurs ne provenant pas de Graphics Builder ainsi que celles qui apparaissent lorsque Graphics Builder tente de traiter les arguments de votre ligne de commande.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


MODULE

Est un synonyme du mot-clé OPENFILE.


param

Permet d'indiquer le nom d'un paramètre qui a été défini dans votre affichage. La valeur d'un paramètre indiqué ici remplacera la valeur initiale du paramètre défini dans la table de paramètres de l'affichage.

Options :	Entrez un paramètre qui est défini dans la table de paramètres de votre affichage et une valeur valide pour le type de données de ce paramètre.

Valeur par défaut :	Les paramètres et les valeurs définis dans la table de paramètres de l'affichage.

Valeur de remplacement :	La dernière valeur indiquée.

Les valeurs de paramètre peuvent être indiquées entre guillemets simples ou doubles, selon les caractéristiques de votre système. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

Exemples :

1	g30des openfile=d1 param1=26 param2=`Anniversaire' param3=`14-JUIL-96'

2	g30des openfile=(d1,d2,d3) param4=(5,6)

Dans cet exemple, param4 aura la valeur 5 dans d1, et 6 dans d2 et d3.


G30RUN

Utilisez l'exécutable G30RUN pour exécuter un affichage à partir de la ligne de commande.

Syntaxe :     g30run [[mot_clé=]valeur ]...

où les arguments valides pour mot_clé=valeur sont les suivants :

OPENFILE={fichier|(fichier1,fichier2,...)}

USERID={chaîne_connexion|(chaîne_connexion1,chaîne_connexion2,...)}

OPENDB={nom_affichage|(nom_affichage1,nom_affichage2,...)}

PRINT={{YES|NO}|({YES|NO},{YES|NO},...)}

COPIES={n|(n1,n2,...)}

PRINTER={nom_imprimante|(nom_imprimante1,nom_imprimante2,...)}

PRINTFILE={fichier|(fichier1,fichier2,...)}

EXPORTFILE={fichier|(fichier1,fichier2,...)}

EXPORTCGM={fichier|(fichier1,fichier2,...)}

EXPORTBIT={{16|32}|({16|32},{16|32},...)}

EXPORTDB={nom_dessin|(nom_dessin1,nom_dessin2,...)}

EXPORTIMAGE={fichier}

CLOSE={{YES|NO}|({YES|NO},{YES|NO},...)}

QUIT={YES|NO}

CMDFILE=fichier

LOGFILE=fichier

MODULE={fichier|(fichier1,fichier2,...)}

EXECPLSFILE={fichier}

ORACLE_STARTUP={YES|NO}

param={valeur|(valeur1,valeur2,...)}


OPENFILE

Permet d'indiquer le nom du fichier qui contient l'affichage à ouvrir. Les programmes PL/SQL non compilés seront compilés, puis l'affichage sera exécuté. En cas d'erreurs de compilation, les messages d'erreur seront écrits dans le fichier indiqué par LOGFILE et l'exécution de l'affichage sera abandonnée.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


USERID

Permet d'indiquer la chaîne de connexion de votre base de données.

Options :	Entrez une chaîne de connexion de base de données valide.

Valeur par défaut :	Aucune, si la connexion automatique n'est pas activée.

Valeur de remplacement :	Dernière chaîne de connexion indiquée.

Si l'option Connexion au démarrage est cochée et que vous indiquiez ici une chaîne de connexion, la boîte de dialogue Connexion n'apparaîtra pas.


OPENDB

Permet d'indiquer le nom de l'affichage à ouvrir, affichage stocké dans une base de données. Vous devez aussi vous connecter à une base de données en utilisant un argument USERID. Les programmes PL/SQL non compilés seront compilés, puis l'affichage sera exécuté. En cas d'erreurs de compilation, les messages d'erreur seront écrits dans le fichier indiqué par LOGFILE, et l'exécution de l'affichage sera abandonnée.

Options :	Entrez un nom d'affichage valide.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


PRINT

Permet d'indiquer si l'affichage qui a été ouvert par OPENFILE ou OPENDB doit être imprimé sur une imprimante définie par un argument PRINTER. L'affichage sera imprimé lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	yes indique que l'affichage sera imprimé.

no indique que l'affichage ne sera pas imprimé.

Valeur par défaut :	no

Valeur de remplacement :	Dernière valeur indiquée.


COPIES

Permet d'indiquer le nombre de copies de l'affichage à imprimer.

Options :	Entrez un entier valide.

Valeur par défaut :	1

Valeur de remplacement :	1


PRINTER

Permet d'indiquer le nom de l'imprimante sur laquelle l'affichage sera imprimé lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	Entrez un nom d'imprimante valide. Pour plus d'informations, reportez-vous à la documentation de votre système.

Valeur par défaut :	Le nom de l'imprimante par défaut de votre système.

Valeur de remplacement :	La dernière valeur indiquée ; si aucune valeur n'a été indiquée, l'imprimante par défaut de votre système.


PRINTFILE

Permet d'indiquer le nom du fichier dans lequel l'affichage sera imprimé en format PostScript lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTFILE

Permet d'indiquer le nom du fichier vers lequel l'affichage sera exporté sous la forme d'un dessin en format Oracle. Toutes les couches, visibles ou masquées, seront exportées lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTCGM

Permet d'indiquer le nom du fichier vers lequel l'affichage sera exporté sous la forme d'un dessin en format CGM. Toutes les couches, visibles ou masquées seront exportées lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif..

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTBIT

Permet d'indiquer le format d'un affichage exporté vers un fichier CGM.

Options :	16 bits indique l'utilisation d'un espace de coordonnées sur deux octets.

32 bits indique l'utilisation d'un espace de coordonnées sur quatre octets.

Valeur par défaut :	16

Valeur de remplacement :	16


EXPORTDB

Permet d'indiquer le nom sous lequel l'affichage sera exporté vers la base de données sous la forme d'un dessin en format Oracle. Vous devez également vous connecter à une base de données en utilisant un argument USERID. Toutes les couches, visibles ou masquées, seront exportées lorsque le déclencheur d'affichage aura fini de s'exécuter.

Options :	Entrez un nom valide.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTIMAGE

Permet d'indiquer le nom sous lequel l'affichage sera exporté vers une image dans le format indiqué par l'extension de fichier. Toutes les couches, visibles ou masquées, seront exportées.

Options :	Entrez un nom de fichier valide, ayant l'une des extensions suivantes :
.gif 	pour exporter l'affichage vers un fichier GIF
.jpg 	pour exporter l'affichage vers un fichier JPEG
.bmp 	pour exporter l'affichage vers un bitmap
.tif 	pour exporter l'affichage vers un fichier TIFF
.pict	pour exporter l'affichage vers un fichier PICT

Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


CLOSE

Permet d'indiquer si l'affichage sera fermé lorsque Graphics Builder aura fini de le traiter.

Options :	yes indique que l'affichage sera fermé.

no indique que l'affichage ne sera pas fermé.

Valeur par défaut :	no

Valeur de remplacement :	no


QUIT

Permet d'indiquer si Graphics Builder devra quitter lorsqu'il aura fini de traiter tous les affichages ouverts.

Options :	yes indique que Graphics Builder devra quitter.

no indique que Graphics Builder ne devra pas quitter.

Valeur par défaut :	no

Valeur de remplacement :	N/A


CMDFILE

Permet d'indiquer un fichier texte qui contient des arguments de ligne de commande G30RUN valides. Ce paramètre vous permet d'indiquer de nombreux arguments, ou un ensemble d'arguments standards, sans avoir à les entrer chaque fois que vous utilisez Graphics Builder.

Ce fichier peut ne contenir que des arguments qui seraient des valeurs dans une seule ligne de commande. Les arguments peuvent être séparés par des espaces ou des retours ligne.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


LOGFILE

Permet d'indiquer un fichier texte dans lequel Graphics Builder écrira les messages d'erreur ne pouvant pas figurer dans une alerte. Ces erreurs comprennent les erreurs ne provenant pas de Graphics Builder ainsi que celles qui apparaissent lorsque Graphics Builder tente de traiter les arguments de votre ligne de commande.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


MODULE

Est un synonyme du mot-clé OPENFILE.


EXECPLSFILE

Permet d'indiquer le nom d'un fichier texte contenant soit un bloc anonyme PL/SQL soit une procédure nommée, à exécuter lors du démarrage de l'affichage.

Options :	Tout nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


ORACLE_STARTUP

Permet d'indiquer si Graphics Builder devra exécuter le déclencheur OPEN_DISPLAY lors du démarrage. Utilisé avec l'option de ligne de commande EXECPLSFILE, ORACLE_STARTUP permet de remplacer l'action exécutée par le déclencheur OPEN_DISPLAY par une autre.

Options :	yes indique que Graphics Builder exécutera le déclencheur OPEN_DISPLAY.

no indique que Graphics Builder supprimera l'exécution du déclencheur OPEN_DISPLAY.

Valeur par défaut :	yes

Valeur de remplacement :	N/A


param

Permet d'indiquer le nom d'un paramètre qui a été défini dans votre affichage. La valeur d'un paramètre indiqué ici remplacera la valeur initiale du paramètre défini dans la table de paramètres de l'affichage.

Options :	Entrez un paramètre qui est défini dans la table de paramètres de votre affichage et une valeur valide pour le type de données de ce paramètre.

Valeur par défaut :	Les paramètres et les valeurs définis dans la table de paramètres de l'affichage.

Valeur de remplacement :	Dernière valeur indiquée.

Les valeurs de paramètres peuvent être indiquées entre guillemets simples ou doubles, selon les caractéristiques de votre système. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

Exemples :

1	g30run openfile=d1 param1=26 param2=`Anniversaire' param3='14-JUIL-96'

2	g30run openfile=(d1,d2,d3) param4=(5,6)

Dans cet exemple, param4 aura la valeur 5 dans d1, et 6 dans d2 et d3.


G30BAT

L'exécutable G30BAT permet d'exécuter un affichage en mode batch, à partir d'un terminal bitmap ou non-bitmap. Cet exécutable ne quitte pas automatiquement lorsque le traitement est terminé. Si votre affichage est unique, indiquez OG_QUIT dans un déclencheur CLOSE_DISPLAY. Si votre affichage est intégré dans une application Forms, vous pouvez imposer la sortie du mode batch Graphics Builder en incluant un appel à OG_INTERPRET à partir d'un déclencheur Forms et en laçant la chaîne PL/SQL "og_quit;".

Syntaxe :     g30bat [[mot_clé=]valeur ]...

où les arguments valides pour mot_clé=valeur sont les suivants :

OPENFILE={fichier|(fichier1,fichier2,...)}

USERID={chaîne_connexion|(chaîne_connexion1,chaîne_connexion2,...)}

OPENDB={nom_affichage|(nom_affichage1,nom_affichage2,...)}

PRINT={{YES|NO}|({YES|NO},{YES|NO},...)}

COPIES={n|(n1,n2,...)}

PRINTER={nom_imprimante|(nom_imprimante1,nom_imprimante2,...)}

PRINTFILE={fichier|(fichier1,fichier2,...)}

EXPORTFILE={fichier|(fichier1,fichier2,...)}

EXPORTCGM={fichier|(fichier1,fichier2,...)}

EXPORTBIT={{16|32}|({16|32},{16|32},...)}

EXPORTDB={nom_dessin|(nom_dessin1,nom_dessin2,...)}

EXPORTIMAGE=[fichier]

CMDFILE=fichier

LOGFILE=fichier

MODULE={fichier|(fichier1,fichier2,...)}

EXECPLSFILE={fichier}

ORACLE_STARTUP={YES|NO}

SHOWTOOLBAR={YES|NO}

SESSIONID={nnnnnn.nnnnnn}

param={valeur|(valeur1,valeur2,...)}


OPENFILE

Permet d'indiquer le nom du fichier qui contient l'affichage à ouvrir. Les programmes PL/SQL non compilés seront compilés, puis l'affichage sera exécuté. En cas d'erreurs de compilation, les messages d'erreur seront écrits dans le fichier indiqué par LOGFILE et l'exécution de l'affichage sera abandonnée.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


USERID

Permet d'indiquer la chaîne de connexion de votre base de données.

Options :	Entrez une chaîne de connexion de base de données valide.

Valeur par défaut :	Aucune, si la connexion automatique n'est pas activée.

Valeur de remplacement :	La dernière chaîne de connexion indiquée.

Si l'option Connexion au démarrage est cochée et que vous indiquiez ici une chaîne de connexion, la boîte de dialogue Connexion n'apparaîtra pas.


OPENDB

Permet d'indiquer le nom de l'affichage à ouvrir, affichage dans une base de données. Vous devez aussi vous connecter à une base de données en utilisant un argument USERID. Les programmes PL/SQL non compilés seront compilés, puis l'affichage sera exécuté. En cas d'erreurs de compilation, les messages d'erreur seront écrits dans le fichier indiqué par LOGFILE et l'exécution de l'affichage sera abandonnée.

Options :	Entrez un nom d'affichage valide.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


PRINT

Permet d'indiquer si l'affichage qui a été ouvert par OPENFILE ou OPENDB doit être imprimé sur l'imprimante définie par un argument PRINTER. L'affichage sera imprimé lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	yes indique que l'affichage sera imprimé.

no indique que l'affichage ne sera pas imprimé.

Valeur par défaut :	no

Valeur de remplacement :	Dernière valeur indiquée.


COPIES

Permet d'indiquer le nombre de copies de l'affichage à imprimer.

Options :	Entrez un entier valide.

Valeur par défaut :	1

Valeur de remplacement :	1


PRINTER

Permet d'indiquer le nom de l'imprimante sur laquelle l'affichage sera imprimé lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	Entrez un nom d'imprimante valide. Pour plus d'informations, reportez-vous à la documentation de votre système.

Valeur par défaut :	Le nom de l'imprimante par défaut de votre système.

Valeur de remplacement :	La dernière valeur indiquée ; si aucune valeur n'a été indiquée, l'imprimante par défaut de votre système.


PRINTFILE

Permet d'indiquer le nom du fichier dans lequel l'affichage sera imprimé en format PostScript lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTFILE

Permet d'indiquer le nom du fichier vers lequel l'affichage sera exporté sous la forme d'un dessin en format Oracle. Toutes les couches, visibles ou masquées, seront exportées lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTCGM

Permet d'indiquer le nom du fichier vers lequel l'affichage sera exporté sous la forme d'un dessin en format CGM. Toutes les couches, visibles ou masquées, seront exportées lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTBIT

Permet d'indiquer le format d'un affichage exporté vers un fichier CGM.

Options :	16 bits indique l'utilisation d'un espace de coordonnées sur deux octets.

32 bits indique l'utilisation d'un espace de coordonnées sur quatre octets.

Valeur par défaut :	16

Valeur de remplacement :	16


EXPORTDB

Permet d'indiquer le nom sous lequel l'affichage sera exporté vers la base de données sous la forme d'undessin en format Oracle. Vous devez également vous connecter à une base de données en utilisant un argument USERID. Toutes les couches, visibles ou masquées, seront exportées lorsque le déclencheur d'ouverture d'affichage aura fini de s'exécuter.

Options :	Entrez un nom valide.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


EXPORTIMAGE

Permet d'indiquer le nom sous lequel l'affichage sera exporté vers une image dans le format indiqué par l'extension de fichier. Toutes les couches, visibles ou masquées, seront exportées.

Options :	Entrez un nom de fichier valide, ayant l'une des extensions suivantes :
.gif 	pour exporter l'affichage vers un fichier GIF
.jpg 	pour exporter l'affichage vers un fichier JPEG
.bmp 	pour exporter l'affichage vers un bitmap
.tif 	pour exporter l'affichage vers un fichier TIFF
.pict	pour exporter l'affichage vers un fichier PICT

Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	Aucune.


CMDFILE

Permet d'indiquer un fichier texte qui contient des arguments de ligne de commande G30BAT valides. Ce paramètre vous permet d'indiquer de nombreux arguments, ou un ensemble d'arguments standards, sans avoir à les entrer chaque fois que vous utilisez Graphics Builder.

Ce fichier peut ne contenir que des arguments qui seraient des valeurs dans une seule ligne de commande. Les arguments peuvent être séparés par des espaces ou des retours ligne.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


LOGFILE

Permet d'indiquer un fichier texte dans lequel Graphics Builder écrira les messages d'erreur ne pouvant pas figurer dans une alerte. Ces erreurs comprennent les erreurs ne provenant pas de Graphics Builder ainsi que celles qui apparaissent lorsque Graphics Builder tente de traiter les arguments de votre ligne de commande.

Options :	Entrez un nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


MODULE

Est un synonyme du mot-clé OPENFILE.


EXECPLSFILE

Permet d'indiquer le nom d'un fichier texte contenant soit un bloc anonyme PL/SQL soit une procédure nommée à exécuter lors du démarrage de l'affichage.

Options :	Tout nom de fichier valide. Vous devez indiquer un chemin d'accès absolu ou relatif.

Valeur par défaut :	Aucune.

Valeur de remplacement :	N/A


ORACLE_STARTUP

Permet d'indiquer si Graphics Builder devra exécuter le déclencheur OPEN_DISPLAY lors du démarrage. Utilisé avec l'option de ligne de commande EXECPLSFILE, ORACLE_STARTUP permet de remplacer l'action exécutée par le déclencheur OPEN_DISPLAY par une autre.

Options :	yes indique que Graphics Builder exécutera le déclencheur OPEN_DISPLAY.

no indique que Graphics Builder supprimera l'exécution du déclencheur OPEN_DISPLAY.

Valeur par défaut :	yes

Valeur de remplacement :	N/A


SHOWTOOLBAR

Permet d'activer ou de désactiver la barre d'outils Graphics Web.

Options:	yes indique d'afficher la barre d'outils Graphics Web.

no indique de ne pas afficher la barre d'outils Graphics Web.

Valeur par défaut :	yes, si aucun autre paramètre n'est inclus dans l'URL ; no, si d'autres paramètres sont inclus dans l'URL

Valeur de remplacement :	N/A

REMARQUE : Ce mot-clé n'est valide qu'à l'ouverture d'un affichage sur le Web, via un URL soumis par la cartouche Graphics Web.


SESSIONID

Identificateur unique pour l'instance d'un affichage Graphics visualisé via la cartouche Graphics Web.

Options:	Tout ID de session alphanumérique généré par la cartouche Graphics Web. Par exemple

sessionid=000001.091032

Valeur par défaut:	N/A

Valeur de remplacement :	N/A ; cet ID est généré par la cartouche Graphics Web.

REMARQUE : Ce mot-clé n'est valide qu'à l'ouverture d'un affichage sur le Web, via un URL soumis par la cartouche Graphics Web.


param

Permet d'indiquer le nom d'un paramètre qui a été défini dans votre affichage. La valeur d'un paramètre indiqué ici remplacera la valeur initiale du paramètre indiqué dans la table de paramètres de l'affichage.

Options :	Entrez un paramètre qui est défini dans la table de paramètres de votre affichage, et une valeur valide pour le type de données de ce paramètre.

Valeur par défaut :	Les paramètres et les valeurs définis dans la table de paramètres de l'affichage.

Valeur de remplacement :	Dernière valeur indiquée.

Les valeurs de paramètres peuvent être indiquées entre guillemets simples ou doubles, selon les caractéristiques de votre système. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

Exemples :

1	g30bat openfile=d1 param1=26 param2=`Anniversaire' param3=`14-JUIL-96'

2	g30bat openfile=(d1,d2,d3) param4=(5,6)

Dans cet exemple, param4 aura la valeur 5 dans d1, et 6 dans d2 et d3.


A propos des scripts SQL

Graphics Builder est livré avec plusieurs scripts SQL qui vous permettent d'effectuer rapidement des tâches d'administration de base de données qui demanderaient beaucoup plus de temps autrement. Ces scripts SQL vous permettent :

•	de créer les tables de base de données utilisées pour stocker des modules dans la base de données

•	d'accorder à un utilisateur l'accès à ces tables

•	de révoquer l'accès d'un utilisateur à ces tables

Pour exécuter un des scripts SQL, lancez SQL*Plus, connectez-vous à votre base de données, puis entrez :

START nom_script

où :

nom_script	Indique le nom du script que vous voulez exécuter.

Pour connaître la liste de ces scripts et savoir comment les utiliser, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

Pour plus d'informations sur l'utilisation de SQL*Plus, reportez-vous à SQL*Plus User's Guide and Reference.


A propos des fichiers d'installation

Les fichiers d'installation sont des scripts SQL utilisés pour installer Graphics Builder. Pour connaître la liste des fichiers d'installation à utiliser pour installer Graphics Builder, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.


A propos des fichiers de démonstration

Certains fichiers de démonstration sont livrés avec Graphics Builder. Il peut s'agir soit de fichiers Graphics Builder soit de scripts SQL. Les fichiers Builder sont des fichiers binaires portables qui contiennent des définitions d'affichage. Les scripts SQL créent les exemples de table de base de données utilisés dans Graphics Builder Developer's Guide.


A propos des fichiers d'administration

 Rubriques connexes

Les fichiers d'administration sont des scripts SQL qui vous permettent d'effectuer des tâches administratives plus facilement et plus rapidement.


A propos des fichiers de préférences

Les options de préférences sont stockées dans un fichier texte de votre système de fichiers. Graphics Builder accepte les fichiers de préférences suivants :

•	fichier de préférences utilisateur	contient les préférences d'un utilisateur

•	fichier de préférences global	contient les préférences utilisées en l'absence de fichier de préférences utilisateur

Il est possible que votre système ne prenne pas en charge préférences utilisateur et préférences globales. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

Format de fichier

Les entrées du fichier de préférences ont généralement le format suivant :

préférence = valeur

où :

préférence	Indique le nom de la préférence.

valeur	Indique la valeur de la préférence. Il peut s'agir d'une chaîne de caractères ou d'un nombre ; les chaînes qui contiennent des blancs doivent être entre guillemets doubles.

Options supplémentaires

Aux préférences que vous pouvez indiquer dans la boîte de dialogue Préférences, vous pouvez ajouter d'autres valeurs que vous entrez directement dans le fichier de préférences. Vous pouvez indiquer :

variables d'environnement

préférence Keep_Password


A propos des variables d'environnement

Que votre système d'exploitation prenne en charge ou non les variables d'environnement, vous pouvez en définir certaines en entrant leurs noms et leurs valeurs dans votre fichier de préférences.

Remarque : Vous ne pouvez indiquer que des variables définies par l'utilisateur et des variables non nécessaires à l'installation et à l'exécution de Graphics Builder.

Exemple

Pour définir la variable d'environnement GRAPHICS30, qui pointe sur un répertoire contenant des fichiers d'images, entrez dans votre fichier de préférences :

GRAPHICS30 = C:\montruc\images


A propos de Keep_ password

L'option Keep_password permet d'indiquer si Graphics Builder garde en mémoire le mot de passe de l'utilisateur actuel de la base de données pendant l'exécution de l'affichage.

Les valeurs valides sont les suivantes :

•	Yes	indique que Graphics Builder garde le mot de passe en mémoire.

•	No	indique que Graphics Builder ne garde pas le mot de passe en mémoire.

Vous pouvez vouloir garder le mot de passe en mémoire pour pouvoir appeler un autre produit et lui donner le même nom utilisateur et le même mot de passe.

Vous pouvez ne pas vouloir garder le mot de passe en mémoire si vous estimez qu'il constitue un risque pour la sécurité.

Pour définir cette option, vous devez l'entrer directement dans le fichier des préférences ; elle ne peut pas être entrée dans la boîte de dialogue Préférences.

Exemple

Si vous voulez établir cette préférence pour que Graphics Builder garde en mémoire le mot de passe de l'utilisateur, vous pouvez entrer dans votre fichier de préférences :

OracleGraphics.Keep_Password = Yes


Menu Réorganisation

La présente section décrit les options du menu Réorganisation de Graphics Builder :

Passer au premier plan

Passer en arrière-plan

Déplacer vers l'avant

Déplacer vers l'arrrière

Aligner objets

Répéter alignement

Définir taille objets

Répéter dimensionnement

Grouper

Séparer

Opérations sur des groupes


Passer au premier plan

Permet de déplacer un objet dans son groupe (ou dans sa couche) et de le placer devant tout autre objet de ce groupe (ou de cette couche). L'objet le plus en avant est toujours dessiné en dernier et recouvre les autres objets qui partagent le même espace dans la présentation.


Passer en arrière-plan

Permet de déplacer un objet dans son groupe (ou dans sa couche) et de le placer derrière tout autre objet de ce groupe (ou de cette couche). L'objet le plus éloigné est toujours dessiné en premier, et peut être partiellement masqué par les objets qui se trouvent devant lui et qui partagent le même espace dans la présentation.


Déplacement avant
Déplacer vers l'avant

Permet de déplacer un objet dans son groupe (ou dans sa couche) et de le placer devant l'objet qui se trouve immédiatement derrière. Un objet qui se trouve devant un autre est dessiné par-dessus et peut le masquer partiellement si ceux-ci partagent le même espace dans la présentation.

Vous devrez parfois déplacer plusieurs fois un objet vers l'avant si l'objet qui le masque dans la présentation ne se trouve pas immédiatement devant lui dans leur groupe (ou leur couche).


Déplacement arrière
Déplacer vers l'arrière

Permet de déplacer un objet dans son groupe (ou dans sa couche) et de le placer derrière l'objet qui se trouve immédiatement devant. Un objet qui se trouve derrière un autre est dessiné en dessous, et peut être masqué partiellement si ceux-ci occupent le même espace dans la présentation.

Vous devrez parfois déplacer plusieurs fois un objet vers l'arrière si l'objet qui le masque dans la présentation ne se trouve pas immédiatement derrière lui dans leur groupe (ou leur couche).


Aligner objets

Permet de positionner les objets sélectionnés dans la présentation, les uns par rapport aux autres ou par rapport à la grille. Les paramètres d'alignement indiqués deviennent les paramètres par défaut d'alignement des objets par la commande Répéter alignement.

Options de la boîte de dialogue

Mutuel

Permet d'indiquer que les objets sélectionnés doivent être alignés les uns par rapport aux autres.

Sur la grille

Permet d'indiquer que le ou les objets sélectionnés doivent être alignés par rapport aux points magnétiques de la grille. Il n'est pas nécessaire que l'option Grille magnétique soit active.

Horizontal

Permet d'indiquer la façon dont vous voulez aligner horizontalement les objets sélectionnés. Vous avez  le choix entre les options suivantes :

Aucun	Permet d'indiquer que les positions horizontales des objets ne changent pas.

A gauche	Permet d'indiquer que les objets sélectionnés doivent être déplacés de sorte que le côté gauche de chaque objet soit aligné sur le côté gauche de l'objet sélectionné le plus à gauche.

A doite	Permet d'indiquer que les objets sélectionnés doivent être déplacés de sorte que le côté droit de chaque objet soit aligné sur le côté droit de l'objet sélectionné le plus à droite.

Centrer	Permet d'indiquer que les objets sélectionnés doivent être déplacés de sorte que le point médian de chaque objet soit aligné sur une position horizontale qui est la moyenne de tous leurs points médians.

Répartir	Permet d'indiquer que les objets sélectionnés doivent être déplacés de sorte qu'il y ait autant d'espace horizontal entre les différents objets, les objets situés le plus à gauche et le plus à droite conservant chacun leur position horizontale d'origine.

Empiler	Permet d'indiquer que les objets sélectionnés doivent être déplacés de sorte que le côté gauche de chaque objet soit aligné sur le côté droit de l'objet se trouvant immédiatement à sa gauche, l'objet situé le plus à gauche conservant sa position d'origine.

Vertical

Permet d'indiquer la façon dont vous voulez aligner  verticalement les objets sélectionnés. Vous avez le choix entre les options suivantes :

Aucun	Permet d'indiquer que les positions verticales des objets ne changeront pas.

Sur haut	Permet d'indiquer que les objets sélectionnés doivent être déplacés de sorte que le sommet de chaque objet soit aligné sur le sommet de l'objet sélectionné le plus haut.

Sur bas	Permet d'indiquer que les objets sélectionnés doivent être déplacés de sorte que la base de chaque objet soit alignée sur la base de l'objet sélectionné le plus bas.

Centrer	Permet d'indiquer que les objets sélectionnés doivent être déplacés de sorte que le point médian de chaque objet soit aligné sur une position verticale qui est la moyenne de tous leurs points médians.

Répartir	Permet d'indiquer que les objets sélectionnés doivent être déplacés de sorte qu'il y ait autant d'espace vertical entre les différents objets, les objets situés le plus haut et le plus bas conservant chacun leur position verticale d'origine.

Empiler	Permet d'indiquer que les objets sélectionnés doivent être déplacés de sorte que le sommet  de chaque objet soit aligné sur la base de l'objet se trouvant immédiatement au-dessus de lui, l'objet le plus haut conservant sa position d'origine.


Répéter alignement

Permet d'aligner les objets sélectionnés en utilisant les paramètres d'alignement en cours, indiqués dans la boîte de dialogue Alignement d'objet.


Définir taille objets

Permet de redimensionner les objets sélectionnés les uns par rapport aux autres. Les paramètres de dimensionnement indiqués deviennent les paramètres par défaut pour le dimensionnement d'objets à l'aide de la commande Répéter dimensionnement.

Options de la boîte de dialogue

Largeur

Permet d'indiquer la façon dont vous voulez changer la largeur des objets sélectionnés. Vous avez le choix entre les options suivantes :

Identique	Permet d'indiquer que la largeur des objets ne changera pas.

Plus petit	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa largeur soit égale à la largeur de l'objet sélectionné le moins large.

Plus grd	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa largeur soit égale à la largeur de l'objet sélectionné le plus large.

Moyen	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa largeur soit égale à la largeur moyenne de tous les objets sélectionnés.

Personnalisé	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa largeur soit égale à la largeur personnalisée que vous avez entrée ici. L'unité de mesure de cette valeur est indiquée par le bouton d'option Unités.

Hauteur

Permet d'indiquer la façon dont vous voulez changer la hauteur des objets sélectionnés. Vous avez le choix entre les options suivantes :

Identique	Permet d'indiquer que la hauteur des objets ne changera pas.

Plus petit	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa hauteur soit égale à la hauteur de l'objet sélectionné le moins haut.

Plus grd	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa hauteur soit égale à la hauteur de l'objet sélectionné le plus haut.

Moyen	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa hauteur soit égale à la hauteur moyenne de tous  les objets sélectionnés.

Personnalisé	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa hauteur soit égale à la hauteur personnalisée que vous avez entrée ici. L'unité de mesure de cette valeur est indiquée par le bouton d'option Unités.

Unités

Permet d'indiquer les unités des valeurs de largeur personnalisée et de hauteur personnalisée.


Répéter dimensionnement

Permet de redimensionner les objets sélectionnés en utilisant les paramètres de dimensionnement en cours, indiqués dans la boîte de dialogue Définir taille objets.


Grouper

Permet de consolider tous les objets sélectionnés en un objet de groupe. Les huit points de contrôle de l'objet de groupe deviennent visibles pour indiquer qu'il s'agit maintenant d'un seul et même objet.


Séparer

Permet de dissocier l'objet de groupe sélectionné.

L'objet de groupe sélectionné est détruit. Tous les fils qui le composent remontent d'un niveau dans l'arborescence, mais restent par ailleurs inchangés. Chaque fils occupe alors le même niveau que son ancien père dans l'arborescence et devient le nouveau fils de son ancien grand-père.


Opérations sur des groupes

Permet de contrôler les opérations de groupage, de sélection et de modification d'objets de groupe. Cette commande affiche un sous-menu dans lequel vous pouvez indiquer l'opération que vous voulez effectuer sur le groupe :

Sélectionner père

Sélectionner fils

Ajouter au groupe

Supprimer du groupe


Sélectionner père

Permet de sélectionner le groupe père de l'objet sélectionné. Si l'objet sélectionné n'est pas membre d'un groupe (et n'a donc pas de père), une erreur se produit.


Sélectionner fils

Permet de sélectionner tous les fils de l'objet de groupe sélectionné. Pour ne sélectionner alors que l'un de ses fils, sélectionnez celui-ci. Si le fils que vous voulez sélectionner est un autre objet de groupe, sélectionnez l'un de ses fils pour le sélectionner. Si l'objet sélectionné au départ n'est pas un groupe (et n'a donc pas de fils), une erreur se produit.


Ajouter au groupe

Permet de faire de l'unique objet sélectionné un fils de l'objet de groupe sélectionné. Vous devez avoir au moins deux objets sélectionnés, et l'un d'eux doit être un objet de groupe ; sinon, une erreur se produit.


Supprimer du groupe

Permet de supprimer l'unique objet sélectionné ou l'objet de groupe sélectionné de son groupe père, et de le remonter d'un niveau dans l'arborescence. Cet objet devient alors l'égal de son ancien père, et un fils de son ancien grand-père. Si l'objet sélectionné n'est pas membre d'un groupe (et n'a donc pas de père), une erreur se produit.


 Menu Graphique

La présente section décrit les options du menu Graphique de Graphics Builder :

Créer un graphique

Cadre

Axes

Modèles de champ

Lignes de référence

Mettre à jour graphique

Conversion vers dessin


Créer un graphique

Permet de céer un graphique.

S'il n'y a pas d'interrogations, vous êtes invité à en créer une dans la boîte de dialogue Nouvelle interrogation.

S'il en existe, vous êtes invité à en choisir ou à en créer une dans la boîte de dialogue Assistant graphique.

Lorsque vous avez indiqué une interrogation, vous voyez apparaître la fenêtre de propriétés de graphique.


Cadre

Permet de modifier les propriétés de cadre du graphique sélectionné.

Sélectionnez la page de propriétés des options que vous voulez définir :

Page de propriétés de cadre

Permet de définir les paramètres de profondeur, d'ombre et de légende.

Page de propriétés de cadre d'axe (graphique à axes uniquement)

Permet de définir la ligne de base, la largeur de catégorie et les propriétés de second axe des Y.

Page de propriétés de cadre de secteurs  (graphique à secteurs uniquement)

Permet de définir la représentation des secteurs, les étiquettes, la définition des "autres" secteurs, et d'autres propriétés.

Page de propriétés de cadre de tableau (graphique de type tableau uniquement)

Permet de définir l'étiquette, la grille, le nombre de lignes et de colonnes, et d'autres propriétés.


Axes

Permet de modifier les propriétés des axes du graphique sélectionné.

Sélectionnez la page de propriétés des options que vous voulez définir :

Page de propriétés d'axes

Permet de définir l'étiquette, la position, l'orientation, la graduation, la grille et d'autres propriétés.

Page de propriétés d'axe continu

Permet de définir le maximum, le minimum, le pas et l'échelle.

Page de propriétés d'axe de date

Permet de définir le maximum, le minimum, le pas, l'étiquette et d'autres propriétés

Page de propriétés d'axe discret

Permet de définir le nombre maximum et minimum de catégories.


Modèles de champ

Permet de modifier les propriétés des modèles de champ gugraphique sélectionné.

Sélectionnez la page de propriétés des options que vous voulez définir :

Page de propriétés de champ

Permet de définir le nom des modèles de champ et le schéma de rotation des couleurs et des motifs.

Page de propriétés d'axes de champ

Permet de définir le type de tracé, le style de ligne, l'orientation d'étiquette, l'ajustement de courbe et d'autres propriétés.


Lignes de référence

Permet de modifier les propriétés des lignes de référence du graphique sélectionné.

Options de la fenêtre de propriétés

Ligne de référence

Sélectionnez la ligne de référence à modifier. Toutes les lignes de référence qui existent dans le modèle de graphique sélectionné apparaissent dans la liste.

Légende

Permet d'indiquer le texte qui identifie la ligne de référence dans la légende.

Valeur

Permet d'indiquer la valeur de référence à laquelle la ligne de référence apparaît.

Axe de référence

Permet d'indiquer à quel axe la valeur de référence est comparée pour déterminer sa position.

Nouvelle

Permet de créer une nouvelle ligne de référence pour le modèle de graphique sélectionné.

Supprimer

Permet de supprimer la ligne de référence du modèle de graphique sélectionné.


Mettre à jour graphique

Permet de recréer le graphique sélectionné en fonction de l'interrogation et du modèle de graphique qui lui sont associés et qui peuvent avoir changé depuis que le graphique a été dessiné pour la dernière fois.

Vous ne pouvez mettre un graphique à jour que s'il est dynamique. Si vous le convertissez en dessin en utilisant la commande Conversion vers dessin, vous ne pouvez plus le mettre à jour.


Conversion vers dessin

Permet de changer un graphique dynamique qui peut être mis à jour en graphique statique qui ne peut pas être mis à jour.

Vous devez considérer un graphique statique comme n'importe quel autre objet de groupe ; vous pouvez sélectionner ses fils, éditer des objets isolés, etc. N'oubliez pas cependant que le graphique ne peut plus être mis à jour en fonction de son interrogation ou de son modèle. En fait, Graphics Builder cesse de le considérer comme un graphique.

Il n'est pas possible de convertir un graphique statique en graphique dynamique. Cependant, si l'interrogation et le modèle existent toujours, vous pouvez recréer le graphique.


Menu Edition

La présente section décrit les options du menu Edition de Graphics Builder :

Annuler

Couper

Copier

Coller

Supprimer

Dupliquer

Sélectionner tout

Sélectionner objet

Réduire la résolution

Synchroniser les unités de programme

Rechercher/remplacer


Annuler

Permet d'annuler l'effet de la dernière opération que vous avez effectuée. Par exemple, si vous avez supprimé accidentellement un objet, Annuler le restitue.

Notez que certaines opérations (comme l'enregistrement d'un affichage) ne peuvent pas être annulées. Dans ce cas, l'option du menu est inactive.

Vous ne pouvez pas sélectionner Annuler dans une boîte de dialogue. Pour annuler les modifications effectuées dans une boîte de dialogue, sélectionnez les boutons Annuler ou Fermer de la boîte de dialogue sans tenir compte de vos modifications.


Couper

Permet de supprimer le texte ou les objets sélectionnés et de les stocker dans le Presse-papiers. Vous pouvez alors utiliser l'option de menu Coller pour placer le contenu du Presse-papiers dans un autre emplacement de votre affichage.

Chaque nouvelle opération Couper écrase le précédent contenu du Presse-papiers. Lorsque vous annulez une opération Couper, le précédent contenu du Presse-papier n'est pas restauré.


Copier

Permet de stocker le texte ou les objets sélectionnés dans le Presse-papiers, sans les supprimer (ce que fait Couper). Vous pouvez alors utiliser l'option de menu Coller pour placer le contenu du Presse-papiers dans un autre emplacement de votre affichage.

Chaque nouvelle opération Copier écrase le précédent contenu du Presse-papiers. Une opération Copier ne peut pas être annulée.


Coller

Permet de placer le contenu du Presse-papiers (c'est-à-dire le dernier objet ou le dernier texte que vous avez coupé ou copié) dans la présentation de la fenêtre en cours.

Si le Presse-papiers est vide, ou s'il n'est pas possible d'effectuer une opération Coller (par exemple, il n 'est pas possible de coller un rectangle dans une zone de texte), l'option de menu Coller est inactive.

Une opération Coller est sans effet sur le contenu du Presse-papiers. Vous pouvez coller plusieurs fois le contenu du Presse-papiers.


Supprimer

Permet de supprimer le texte ou les objets sélectionnés sans les stocker dans le Presse-papiers (ce que fait Couper).

Une opération Supprimer est sans effet sur le contenu du Presse-papiers.


Dupliquer

Permet de faire une copie exacte de l'objet ou des objets sélectionnés.

Une copie de l'objet ou des objets sélectionnés apparaît dans la présentation, légèrement décalée par rapport à l'original. L'original est désélectionné et la copie, sélectionnée.

Une opération Dupliquer est sans effet sur le contenu du Presse-papiers.


Sélectionner tout

Permet de sélectionner tous les objets de la présentation.

Si aucun objet n'est sélectionné lorsque vous choisissez Sélectionner tout, chaque objet de la couche active de la présentation est sélectionné.

Si un objet est sélectionné lorsque vous choisissez Sélectionner tout, tous les noeuds de l'objet ayant le même père immédiat dans son arborescence sont sélectionnés.


Sélectionner objet

Permet de sélectionner ou de désélectionner un objet graphique nommé.

Options de la boîte de dialogue

Nom

Nom de l'objet à sélectionner ou à désélectionner.

Sélectionner

Permet de sélectionner l'objet indiqué.

Désélectionner

Permet de désélectionner l'objet indiqué ou de le supprimer de la sélection en cours (le cas échéant).


Réduire la résolution

Permet de donner à l'image sélectionnée la résolution la plus faible possible pour l'afficher précisément à sa taille réelle. Graphics Builder ne tient pas compte des informations excédentaires sur la résolution.

Si vous redimensionnez une image pour qu'elle soit plus petite, l'opération par défaut est le maintien de la résolution d'origine de l'image. Cependant l'image réduite peut être affichée avec une résolution plus faible que celle de l'original, sans perte de qualité. Réduire la résolution d'une image redimensionnée permet de réduire la place nécessaire en mémoire pour traiter l'image, ainsi que la place occupée en mémoire par la sauvegarde de l'affichage.

Vous ne pouvez pas augmenter la résolution d'une image. Cela étant, si vous diminuez la taille d'une image, réduisez sa résolution, puis lui redonnez sa taille d'origine, l'image sera de moins bonne qualité.


Synchroniser les unités de programme

Permet de remplacer l'état des unités de programme dans l'affichage du Designer par l'état des unités de programme dans le débogueur d'exécution. Vous pouvez alors tester vos unités de programme lors de l'exécution, les modifier pour atteindre le résultat voulu, puis réincorporer les modifications dans l'affichage du Designer.

Cette option de menu n'est disponible que pendant la simulation d'exécution.

Attention : Toutes les unités de programme de l'affichage du Designer sont écrasées par leurs équivalents runtime. Les unités de programme du Designer qui sont supprimées pendant la simulation d'exécution sont également supprimées de l'affichage du Designer.


Rechercher/remplacer

Permet de rechercher et de remplacer du texte dans les unités de programme PL/SQL. Cette commande n'est valide que dans un éditeur d'unités de programme.

Options de la boîte de dialogue

Rechercher

Permet d'indiquer le texte que vous voulez rechercher dans l'unité de programme. Pour rechercher une expression normale, entrez-la ici et sélectionnez la case à cocher Expression normale.

Remplacer par

Permet d'indiquer le texte qui remplacera le texte trouvé.

Expression normale

Permet d'indiquer si le texte à rechercher est une expression normale. Pour plus d'informations sur les expressions normales, reportez-vous au Procedure Builder Developer's Guide.

Distinction maj/min

Permet de trouver uniquement le texte dont les majuscules et les minuscules correspondent exactement à celles du texte à rechercher.

Rechercher

Permet de rechercher et de mettre en évidence la prochaine occurrence du texte à rechercher.

Remplacer

Permet de remplacer la sélection en cours par le texte de remplacement, et recherche la prochaine occurrence du texte à rechercher.

Remplacer tout

Remplace toutes les occurrences du texte à rechercher par le texte de remplacement, sans s'arrêter sur chaque occurrence ni la mettre en évidence. Seul le texte qui se trouve sous le curseur est modifié.


 Menu Fichier

La présente section décrit les options du menu Fichier de Graphics Builder :

Nouveau

Ouvrir

Fermer

Enregistrer

Enregistrer sous

Rétablir

Importer

Exporter

Exécuter

Compiler

Compiler tout

Vérifier la cohérence

Connecter

Déconnecter

Administration

Imprimer

Configuration de l'imprimante (mise en page)

Liste des derniers fichiers ouverts

Quitter


Nouveau

Permet de créer un nouvel affichage ou une nouvelle bibliothèque PL/SQL.

Cette option de menu affiche le sous-menu suivant :

Affichage	Permet de créer un nouvel affichage. Un noeud associé au  nouvel affichage apparaît dans le Navigateur d'objet, tandis que s'affiche l'éditeur de présentation de l'affichage.

Bibliothèque	Permet de créer une nouvelle bibliothèque PL/SQL. Un noeud de la nouvelle bibliothèque apparaît sous le noeud Ouvrir bibliothèques dans le Navigateur d'objet.


Ouvrir

Permet d'extraire un affichage stocké dans un fichier ou dans la base de données.

Vous pouvez avoir plusieurs affichages ouverts simultanément, mais vous ne pouvez pas ouvrir plusieurs fois un même affichage au cours d'une session Graphics Builder.

Options de la boîte de dialogue

Accès objets

Permet d'indiquer l'emplacement de l'affichage à ouvrir. La sélection de Base de données affiche la  boîte de dialogue Ouverture depuis la base. La sélection de Système de fichiers affiche la boîte de dialogue Ouverture de fichier de votre système.

Affichage

Permet d'indiquer le type de fichier ou de module à visualiser lorsque vous en sélectionnez un en vue de l'ouvrir.


Fermer

Permet d'annuler l'affichage en cours.

Si l'affichage n'a pas été enregistré depuis qu'il a été modifié, une boîte de dialogue apparaît. Vous pouvez alors choisir d'enregistrer les modifications, de ne pas en tenir compte ou d'annuler l'opération de fermeture.


Enregistrer

Permet de stocker dans un fichier ou dans la base de données l'affichage en cours, en fonction des règles suivantes :

•	Si l'affichage a déjà été enregistré au cours de la session, il est enregistré sous le même nom et au même emplacement qu'avant.

•	Si l'affichage a été ouvert mais n'a pas été enregistré, il est enregistré sous le même nom et au même emplacement que lors de son ouverture.

•	Si l'affichage n'a pas encore été enregistré, la boîte de dialogue Enregistrement dans apparaît. Vous pouvez alors indiquer l'emplacement de l'affichage en mémoire.


Enregistrer sous

Permet de stocker l'affichage en cours sous un nouveau nom et à un nouvel emplacement.

Cette option de menu affiche les options de sous-menu ci-après.

Base de données

Permet d'afficher la boîte de dialogue Enregistrement dans la base.

Système de fichiers

Permet d'afficher la boîte de dialogue Enregistrement de fichier de votre système.

Si l'affichage n'a encore jamais été enregistré, l'option par défaut de Enregistrer sous est l'enregistrement de l'affichage sous le nom "Dispx" (où x est un nombre quelconque). Autrement, l'option par défaut est le nom sous lequel l'affichage a été ouvert ou enregistré en dernier.


Rétablir

Permet d'annuler toutes les modifications apportées à l'affichage ; ce dernier retrouve l'état dans lequel il se trouvait lorsqu'il a été enregistré ou ouvert en dernier.

Les règles applicables à cette opération sont les suivantes.

•	Si l'affichage a déjà été enregistré au cours de la session en cours, il retrouve l'état dans lequel il se trouvait lorsqu'il a été enregistré en dernier.

•	Si l'affichage a été ouvert mais n'a pas été enregistré, il retrouve l'état dans lequel il se trouvait lorsqu'il a été ouvert.

•	Si l'affichage n'a pas encore été enregistré, aucune modification n'est prise en compte et il retrouve son état initial.


Importer

Permet d'incorporer dans l'affichage en cours un module stocké dans un fichier ou dans la base de données.

Sélectionnez l'option de menu correspondant à l'objet que vous voulez importer.

Affichage

Permet de fusionner dans l'affichage en cours un affichage enregistré dans une base de données ou un fichier. Cette commande affiche la boîte de dialogue Import d'affichage.

Dessin

Permet de placer un dessin dans la présentation en cours. Cette commande affiche la boîte de dialogue Import.

Image

Permet de placer une image bitmap dans la présentation en cours. Cette commande affiche la boîte de dialogue Import d'image.

Son

Permet de créer un nouveau son à partir de celui qui est stocké dans la base de données ou dans le système de fichiers. Cette commande affiche la boîte de dialogue Import de son.

Texte

Permet de placer le texte d'un fichier dans un éditeur d'unités de programme PL/SQL. Cette commande affiche la boîte de dialogue Ouverture de fichier de votre système.

Modèle

Permet d'incorporer dans l'affichage en cours un modèle de graphique stocké dans une base de données ou dans un fichier. Cette commande affiche la boîte de dialogue Import.

Palette de couleurs

Permet de remplacer la palette de couleurs en cours par une autre. Cette option de menu n'est active que si le mode de la palette de couleurs de l'affichage est Modifiable, comme indiqué dans la boîte de dialogue Options outils. Cette commande affiche la boîte de dialogue Import.


Exporter

Permet de stocker dans un fichier ou dans la base de données un module de l'affichage en cours.

Les options du sous-menu Exporter sont décrites ci-après :

Dessin

Permet de stocker dans un fichier ou dans la base de données le contenu des couches affichées. Cette commande affiche la boîte de dialogue Export.

Image

Permet de stocker dans un fichier ou dans la base de données l'image sélectionnée. Cette commande affiche la boîte de dialogue Export d'image.

Son

Permet de charger un son dans l'affichage en cours. Cette commande affiche la boîte de dialogue Export de son.

Texte

Permet de placer le texte d'un fichier dans un éditeur d'unités de programme PL/SQL. Cette commande affiche la boîte de dialogue Enregistrement de fichier de votre système.

Modèle

Permet de stocker dans un fichier ou dans la base de données un modèle de graphique de l'affichage en cours. Cette commande affiche la boîte de dialogue Export.

Palette de couleurs

Permet de stocker dans un fichier ou dans la base de données la palette de couleurs de l'affichage en cours. Cette commande affiche la boîte de dialogue Export.


Exécuter

Permet d'exécuter un affichage en mode de simulation d'exécution. Ce mode simule l'exécution de l'affichage et vous permet de localiser les erreurs de logique de votre code PL/SQL.

Lorsque vous exécutez un affichage, Graphics Builder effectue une compilation par lots de tous les codes PL/SQL qu'il contient. S'il ne s'est produit aucune erreur (de compilation ou autre), la fenêtre Présentation principale de l'affichage apparaît.


Compiler

Permet de compiler toutes les unités de programme de l'affichage qui n'ont pas encore été compilées et d'afficher la boîte de dialogue Compilation. Les unités de programme déjà compilées restent inchangées.


Compiler tout

Permet de recompiler toutes les unités de programme de l'affichage, qu'elles aient ou non déjà été compilées, et d'afficher la boîte de dialogue Compilation. Les unités de programme déjà compilées sont tout d'abord invalidées, puis recompilées.


Vérifier la cohérence

Permet de vérifier la cohérence des différentes parties de votre affichage. Par exemple, une procédure bouton dont la liste de paramètres a été accidentellement supprimée se compilera correctement, mais ne fonctionnera pas correctement lorsque l'affichage sera exécuté. Une vérification de cohérence vous signale le problème.

Une vérification de cohérence génère un ou plusieurs des messages ci-après :

Pas d'erreur de cohérence.

Cause :	L'affichage ne contient pas d'erreur de cohérence.

Action :	Aucune.

 <type_déclencheur>: Procédure `<nom_proc>' non trouvée.

Cause :	Vous avez désigné comme déclencheur une unité de programme PL/SQL, mais Graphics Builder n'a pas pu trouver de procédure de ce nom.

Action :	Vérifiez que :

•	vous avez défini et compilé la procédure nommée dans la boîte de dialogue du déclencheur ;

•	vous avez indiqué un nom correct dans la boîte de dialogue du déclencheur et dans l'en-tête de la procédure ;

•	l'unité de programme que vous avez associée au déclencheur est une procédure (et non une fonction ou un package).

<type_déclencheur>: La procédure `<nom_proc> doit être déparamétrée.

Cause :	La procédure PL/SQL que vous avez associée au déclencheur implique que des arguments lui soient passés lorsqu'elle est appelée. Comme Graphics Builder appelle les procédures de déclencheur sans argument, cette opération n'est pas valide.

Action :	Attribuez au déclencheur une procédure ne demandant pas d'arguments.

La procédure `<nom_proc>' associée à l'objet `<nom_obj>' n'existe pas.

Cause :	Vous avez associé à l'objet une procédure bouton PL/SQL que Graphics Builder n'a pas trouvée.

Action :	Assurez-vous que le nom indiqué dans le champ Procédure de la boîte de dialogue Propriété d'objets correspond à une procédure définie.

L'unité de programme `<nom_up>' associée à l'objet `<nom_obj>' n'est pas une procédure.

Cause :	L'unité de programme que vous avez associée à l'objet n'est pas une procédure. Vous ne pouvez pas associer à un objet des fonctions ou des packages.

Action :	Assurez-vous que le nom indiqué dans le champ Procédure de la boîte de dialogue Propriété d'objets est celui d'une procédure valide.

La procédure `<nom_proc>' associée à l'objet `<nom_obj>' doit avoir exactement quatre paramètres.

Cause :	L'en-tête de la procédure PL/SQL que vous avez associée à l'objet ne contient pas les quatre arguments obligatoires pour les procédures bouton.

Action :	Assurez-vous que l'en-tête de la procédure contient les quatre arguments obligatoires.

La procédure `<nom_proc>' associée à l'objet <nom_obj>' a des types d'argument incorrects.

Cause :	L'en-tête de la procédure PL/SQL que vous avez associée à l'objet contient un ou plusieurs arguments dont le type ne correspond pas à celui demandé pour les procédures bouton.

Action :	Assurez-vous que l'en-tête de la procédure contient des arguments d'un type correct et qu'ils sont énumérés dans l'ordre voulu.


Connecter

Permet de vous connecter à une base de données.

Vous pouvez remplir chacun des champs séparément ou entrer sur une seule ligne dans le champ Nom utilisateur :

nom_utilisateur/mot_passe@base_données.

Vous pouvez également entrer uniquement le nom utilisateur et la base de données dans le champ Nom utilisateur, et le mot de passe dans le champ Mot de passe, afin qu'il ne soit pas affiché :

nom_utilisateur@base_données

Options de la boîte de dialogue

Nom utilisateur

Permet d'indiquer le nom utilisateur du compte de base de données auquel vous voulez vous connecter.

Mot de passe

Permet d'indiquer le mot de passe associé au compte de la base de données.

Base de données

Permet d'indiquer la chaîne de connexion qui identifie la base de données. Pour vous connecter à une base de données éloignée, vous devez également entrer la chaîne de connexion à la base de données SQL*Net appropriée.


Déconnecter

Permet d'interrompre votre connexion à la base de données.


Administration

Vous permet de gérer les modules stockés dans la base de données, de générer un affichage d'exécution et de gérer le système de contrôle de source des fichiers.

Cette option de menu affiche les options de sous-menu ci-après.

Accès

Permet d'autoriser ou de révoquer l'accès à un module stocké dans la base de données. Lorsque vous avez choisi un type de module dans ce sous-menu, vous voyez apparaître la  boîte de dialogue Accès module de base de données.

Supprimer

Permet de supprimer un module de la base de données. Lorsque vous avez choisi un type de module dans ce sous-menu, vous voyez apparaître la boîte de dialogue Suppression de la base de données.

Renommer

Permet de renommer un module stocké dans la base de données. Lorsque vous avez choisi un type de module dans ce sous-menu, vouz voyez apparaître la boîte de dialogue Renommer.

Générer

Permet de créer une version d'exécution de l'affichage en cours. Si vous choisissez de l'enregistrer dans la base de données, vous voyez apparaître la boîte de dialogue Enregistrement dans la base. Si vous l'enregistrez dans le système de fichiers, vous voyez apparaître la boîte de dialogue Enregistrement de fichier de votre système.

Lorsque vous générez un affichage, les unités de programme PL/SQL non compilées sont automatiquement compilées. En cas d'erreur (de compilation ou autre), un message d'erreur apparaît et la génération est interrompue.

Archivage

Permet d'appeler la boîte de dialogue Contrôle de source : Archivage, qui vous permet d'extraire et d'archiver un fichier d'affichage. Cette commande n'est disponible que si PVCS (Polytron Version Control System) est installé.

Lorsque vous archivez un fichier d'affichage, PVCS effectue automatiquement une conversion de binaire en texte et archive le fichier à l'emplacement indiqué, sous la forme d'un fichier texte.

Voir aussi : boîte de dialogue Contrôle de source : Archivage.

Extraction

Permet d'appeler la boîte de dialogue Contrôle de source : Extraction qui vous permet d'extraire un fichier d'affichage qui a déjà été vérifié dans une archive de contrôle de source. Cette commande n'est utilisable que si PVCS (Polytron Version Control System) est installé.

Les fichiers archivés sont stockés sous la forme de fichiers texte. Lorsque vous extrayez un fichier, Graphics Builder convertit automatiquement le fichier texte en fichier binaire (.OGD) pour qu'il puisse être édité dans le Designer.

Voir aussi : boîte de dialogue Contrôle de source : Extraction.

Gestion des archives et rapports

Appelle la boîte de dialogue Contrôle de source : Options qui vous permet d'indiquer les options du système de contrôle de source. Cette commande n'est utilisable que si PVCS (Polytron Version Control System) est installé.

Voir aussi : boîte de dialogue Contrôle de source : Options.


Imprimer

Permet d'imprimer la présentation sur l'imprimante par défaut.

Seules les couches affichées seront imprimées.

Votre système peut afficher une boîte de dialogue Imprimante lorsque vous choisissez l'option de menu Imprimer. Pour plus d'informations, reportez-vous à la documentation de votre système.


Imprimer
Configuration de l'imprimante (mise en page)

Permet d'indiquer les paramètres d'impression (format de page, orientation et autres).

Cette boîte de dialogue est propre à votre système. Pour plus d'informations, reportez-vous à la documentation de votre système.


Liste des derniers fichiers ouverts

Permet d'énumérer, en ordre décroissant, les quatre derniers fichiers auxquels vous avez accédé. Les types de fichier possibles sont .ogd et .pll. Cliquez deux fois sur le nom d'un fichier .ogd pour ouvrir ce fichier dans le Designer, et cliquez deux fois sur le nom d'un fichier .pll pour charger la bibliothèque.


Quitter

Permet de mettre fin à votre session Graphics Builder Designer.

Tous les affichages ouverts sont fermés et la session prend fin. Si vous avez modifié des affichages depuis qu'ils ont été enregistrés ou ouverts pour la dernière fois, vous êtes invité à enregistrer les modifications, à les ignorer ou à interrompre l'opération Quitter.


Menu Format

La présente section décrit les options du menu Format de Graphics Builder :

Police

Interlignage

Alignement

Direction

Trait

Tiret

Relief

Flèche

Symbole

Options de dessin

Palette de couleurs

Nombre

Date


Police

Permet de définir la police de caractères du texte sélectionné. Sur certains systèmes, Police affiche un sous-menu contenant une liste de polices. Sur d'autres, Police affiche une boîte de dialogue.

Les polices disponibles dépendent du système utilisé, mais peuvent comporter des options de type Times, Helvetica, et Courier. Pour plus d'informations, reportez-vous à la documentation de votre système.

Si un objet texte est sélectionné, la police que vous choisissez est appliquée à tout le texte de cet objet. Si vous ne sélectionnez qu'un segment de texte dans l'objet texte, la police choisie ne s'applique qu'à ce segment.

La police choisie devient la police par défaut de tout le texte créé ultérieurement, que le texte ait, ou non, été sélectionné lorsque la police a été choisie.


Interlignage

Permet de définir l'interlignage d'un objet texte.

Cette option de menu affiche les options de sous-menu suivantes :

Simple

Signifie que l'interligne est égal à la taille en points du plus gros segment de texte de chaque ligne.

1 1/2

Signifie que l'interligne est égal à une fois et demie la taille en points du plus gros segment de texte de chaque ligne.

Double

Signifie que l'interligne est égal à deux fois la taille en points du plus gros segment de texte de chaque ligne.

Personnalisé

Permet de personnaliser la valeur de l'interlignage. Le choix de cette option de sous-menu affiche la boîte de dialogue Interlignage perso décrite ci-dessous.

Options de la boîte de dialogue

Sélectionnez un interlignage ou sélectionnez Personnalisé et entrez une valeur dans le champ de texte correspondant.


Alignement

Permet de définir l'alignement du texte dans un objet texte par rapport à la boîte englobante.

Cette option de menu affiche les options de sous-menu suivantes :

Gauche

Aligne la partie gauche de chaque ligne de texte sur le bord gauche de la boîte englobant l'objet texte.

Centre

Aligne le centre de chaque ligne de texte sur le centre horizontal de la boîte englobant l'objet texte.

Droite

Aligne la partie droite de chaque ligne de texte sur le bord droit de la boîte englobant l'objet texte.

Début

Aligne le texte sur le point de début indiqué par les paramètres de langue de votre système. Par exemple, un système français aligne le texte à gauche, alors qu'un système arabe l'aligne à droite.

Fin

Aligne le texte sur le point de fin déterminé par les paramètres de langue de votre système. Par exemple, un système français aligne le texte à droite, alors qu'un un système arabe l'aligne à gauche.


Direction

Permet de définir la direction dans laquelle le nouveau texte sera inséré dans l'objet texte.

Cette option de menu affiche les options de sous-menu suivantes :

Par défaut

Insère le nouveau texte dans la direction indiquée par les paramètres de langue de votre système. Par exemple, un système français insérera le texte de gauche à droite alors qu'un système arabe l'insérera de droite à gauche.

Gauche-droite

Insère le nouveau texte de gauche à droite.

Droite-gauche

Insère le nouveau texte de droite à gauche.


Trait

Permet de définir la largeur d'un trait ou du bord d'un objet.

Choisissez une largeur de trait dans le sous-menu. Si vous choisissez Personnalisé, vous voyez apparaître la boîte de dialogue Largeur de trait personnalisée, décrite ci-dessous.

Options de la boîte de dialogue

Largeur

Largeur du trait.

Unités

Unité de mesure dans laquelle la largeur est indiquée.


Tiret

Permet de définir le style de tiret d'un trait ou du bord d'un objet.

Choisissez un type de tiret dans le sous-menu.


Relief

Permet de définir le type de relief d'un trait ou du bord d'un objet.

Choisissez un type de relief dans le sous-menu.


Flèche

Permet de définir le type de flèche d'un trait.

Choisissez un type de flèche dans le sous-menu.


Symbole

Permet de définir la taille d'un symbole.

Choisissez une taille de symbole dans le sous-menu.


Options de dessin

Permet de définir les styles et les options de dessin.

Sélectionnez l'option de sous-menu correspondant aux options que vous voulez indiquer :

Général

Permet de définir le style des extrémités et des jointures, le dessin à partir de l'angle ou du centre et le mode de transfert.

Arc

Permet de définir les styles de remplissage et de fermeture des arcs.

Texte

Permet de définir l'origine du texte, la boîte englobante, le renvoi à la ligne et d'autres options.

Rectangle

Permet de définir le rayon des angles du rectangle arrondi.

Image

Permet de définir les options de qualité d'image et de trame.


Palette de couleurs

Permet de modifier les couleurs définies dans la palette de couleurs.

Cette option de menu n'est utilisable que si le mode de la palette de couleurs de la boîte de dialogue Options outils est Modifiable.

Comme la palette de couleurs est enregistrée avec l'affichage, les modifications que vous apportez à la palette sont également enregistrées.

Options de la boîte de dialogue

Sélectionner la couleur à éditer

Permet d'afficher le contenu de la palette de couleurs en cours. Sélectionnez une cellule de couleur pour modifier la couleur qu'elle contient.

Couleur courante

Nom de la couleur sélectionnée dans la palette. Pour en modifier le nom, entrez un nouveau nom dans ce champ puis sélectionnez Renommer.

Editer

Permet d'afficher une boîte de dialogue propre au système qui vous permet de modifier la définition de la couleur sélectionnée. Pour plus d'informations, reportez-vous à la documentation de votre système.

Renommer

Permet de remplacer le nom de la couleur sélectionnée par celui qui apparaît dans le champ Couleur courante.


Nombre

Permet d'ajouter, de supprimer ou d'appliquer les masques de format de nombre disponibles. Vous ne pouvez pas appliquer un masque de format à un objet texte qui n'est pas un élément de graphique.

Le choix de cette option de menu affiche la boîte de dialogue Format de nombre.


Date

Permet d'ajouter, de supprimer ou d'appliquer les masques de format de date disponibles. Vous ne pouvez appliquer un masque de format à un objet texte qui n'est pas un élément de graphique.

Le choix de cette option de menu affiche la boîte de dialogue Format de date.


 Menu Aide

Le menu Aide est propre au système utilisé. Pour plus d'informations, reportez-vous à la documentation de votre système. Cependant, tous les systèmes affichent les options de menu suivantes :

Sommaire de l'aide

Assistants

Aperçu produit

Info module

A propos de Graphics Builder


Sommaire de l'aide

Permet d'appeler le système d'aide de Graphics Builder. Le cas échéant, ce système utilise l'interface d'aide standard de votre système d'exploitation. Dans le cas contraire, vous voyez apparaître le système d'aide Oracle.


Assistants

Permet d'appeler les assistants, qui vous offrent une assistance sur l'exécution d'un grand nombre de tâches de base de Graphic Builder.


Aperçu produit

(New topic text goes here.)

Permet d'afficher un aperçu des outils disponibles sur Graphic Builder ainsi que les étapes de base dans le processus de génération des affichages.


Info module

Permet d'afficher les informations concernant la création et la révision de l'affichage en cours.

Options de la boîte de dialogue

Création

Permet d'afficher les informations sur la création de l'affichage, si celui-ci est stocké dans la base de données.

Par	Nom utilisateur sous lequel l'affichage a été enregistré pour la première fois dans la base de données.

Date	Date à laquelle l'affichage a été enregistré pour la première fois dans la base de données.

Version	Version de Graphics Builder utilisée pour créer l'affichage.

Dernière modification

Permet d'afficher les informations sur la modification de l'affichage, si celui-ci est stocké dans la base de données.

Par	Nom utilisateur sous lequel l'affichage a été enregistré pour la première fois dans la base de données.

Date	Date à laquelle l'affichage a été modifié en dernier dans la base de données.

Version	Version de Graphics Builder utilisée pour la dernière mise à jour de l'affichage.

Copyright

Permet d'afficher les informations de copyright sur l'affichage. Ces informations sont intéressantes si vous envisagez de distribuer l'affichage à d'autres personnes. Elles apparaissent également dans la boîte de dialogue Info module de l'exécutable Runtime de Graphics Builder. Entrez ici le texte qui doit être affiché dans les versions exécutables de l'affichage que vous envisagez de distribuer. La valeur par défaut de ce champ est le contenu du champ Message de copyright de la boîte de dialogue Options outils.


A propos de Graphics Builder

Permet d'afficher des informations sur l'exécutable Graphics Builder et notamment le numéro de version et les mentions de copyright.


 Menu Navigateur

La présente section décrit les options du menu Navigateur de Graphics Builder :

Créer

Supprimer

Développer

Réduire

Développer tout

Réduire tout

Signet

Atteindre signet

Options du navigateur


Créer

Permet de créer un nouvel objet de même type que le nœud d'en-tête ou l'objet sélectionné.


Supprimer

Permet de supprimer l'objet sélectionné.


Développer

Permet d'afficher les fils immédiats du nœud sélectionné.


Réduire

Permet de masquer les fils immédiats du nœud sélectionné.


Développer tout

Permet de développer de manière récursive les nœuds fils du noeud sélectionné.


Réduire tout

Permet de réduire de manière récursive les nœuds fils du nœud sélectionné.


Signet

Permet de placer un signet sur le nœud sélectionné. Cela vous permet de manipuler d'autres objets du Navigateur d'objet, puis de revenir au nœud affecté d'un signet en choisissant l'option de menu Atteindre signet.


Atteindre signet

Permet de sélectionner le nœud préalablement affecté d'un signet par utilisation de l'option de menu Signet.


Options du navigateur

Permet de définir les options qui déterminent l'aspect des objets dans le Navigateur d'objet.

Options de la boîte de dialogue

Afficher les noeuds de référence

Permet d'afficher les nœuds sous un objet qui représentent d'autres objets auxquels le nœud fait référence. Par exemple, un objet graphique contient un nœud Interrogation qui affiche l'interrogation à laquelle le graphique fait référence.

Afficher les nœuds référence-par

Permet d'afficher les nœuds sous un objet qui représentent les références d'autres objets à cet objet. Par exemple, un objet interrogation peut indiquer qu'un graphique fait référence à l'interrogation.


Menu Modèle

La présente section décrit les éléments du menu Modèle de Graphics Builder :

Créer

Renommer

Supprimer

Cadre

Axes

Modèles de champ

Lignes de référence


Créer

Permet de créer un nouveau modèle de graphique.

Lorsque vous créez un nouvel affichage, l'Editeur de modèle de graphique ne comprend au départ aucun modèle de graphique. Pour créer le tout premier, vous pouvez :

•	Choisir Modèle [image] Créer, comme décrit ici.

•	Choisir un type de graphique dans le menu Type. Un nouveau modèle de graphique appelé "modèle0" est automatiquement créé.

Lorsque vous avez validé cette boîte de dialogue, un nouveau modèle de graphique apparaît dans l'Editeur de modèle de graphique.

Options de la boîte de dialogue

Type de graphique

Type de graphique à créer. Sélectionnez une icône pour sélectionner un type de graphique.

Nom du modèle

Nom identifiant le modèle.


Renommer

Permet de modifier le nom du modèle affiché dans l'Editeur de modèle de graphique.

Options de la boîte de dialogue

Nom du modèle

Nouveau nom du modèle.


Supprimer

Permet de supprimer le modèle affiché dans l'Editeur de modèle de graphique.


Cadre

Permet de modifier les propriétés de cadre du modèle affiché dans l'Editeur de modèle de graphique.

Sélectionnez la page de propriétés des options que vous voulez définir :

Page de propriétés de cadre

Permet de définir les paramètres de profondeur, d'ombre et de légende.

Page de propriétés de cadre d'axe (graphique à axes uniquement)

Permet de définir la ligne de base, la largeur de catégorie et les propriétés de second axe des Y.

Page de propriétés de cadre de secteurs  (graphique à secteurs uniquement)

Permet de définir la représentation des secteurs, les étiquettes, la définition des "autres" secteurs et d'autres propriétés.

Page de propriétés de cadre de tableau (graphique de type tableau uniquement)

Permet de définir l'étiquette, la grille, le nombre de lignes et de colonnes, et d'autres propriétés.


Axes

Permet de modifier les propriétés des axes du modèle affiché dans l'Editeur de modèle de graphique.

Sélectionnez la page de propriétés d'options que vous voulez définir:

Page de propriétés d'axe

Permet de définir l'étiquette, la position, l'orientation, la graduation, la grille et d'autres propriétés.

Page de propriétés d'axe continu

Permet de définir le maximum, le minimum, le pas et l'échelle.

Page de propriétés d'axe de date

Permet de définir le maximum, le minimum, le pas, l'étiquette et d'autres propriétés.

Page de propriétés d'axe discret

Permet de définir le nombre maximum et minimum de catégories.


Modèles de champ

Permet de modifier les propriétés des modèles de champ du modèle de graphique affiché dans l'Editeur de modèle de graphique.

Sélectionnez la page de propriétés d'options que vous voulez définir:

Page de propriétés de champ

Permet de définir le nom des modèles de champ et le schéma de rotation des couleurs et des motifs.

Page de propriétés d'axes de champ

Permet de définir le tracé, le style de ligne, l'orientation d'étiquette, l'ajustement de courbe et d'autres propriétés.


Lignes de référence

Permet de modifier les propriétés des lignes de référence du modèle affiché dans l'Editeur de modèle de graphique.

Options de la fenêtre de propriétés

Ligne de référence

Sélectionnez la ligne de référence à modifier. Toutes les lignes de référence qui existent dans le modèle en cours apparaissent dans la liste.

Légende

Permet d'indiquer le texte qui identifie la ligne de référence dans la légende.

Valeur

Permet d'indiquer la valeur de référence à laquelle la ligne de référence apparaît.

Axe de référence

Permet d'indiquer à quel axe la valeur de référence est comparée pour déterminer sa position.

Nouvelle

Permet de créer une nouvelle ligne de référence pour le modèle en cours.

Supprimer

Permet de supprimer la ligne de référence du modèle en cours.


 Menu Outils

La présente section décrit les éléments du menu Outils de Graphics Builder  :

Propriétés

Interpréteur PL/SQL

Unités de programme

Unités de programme stockées

Déclencheurs de base de données

Affichage

Couches

Paramètres

Interrogations

Modèles

Horloges

Options outils


Propriétés

Permet de définir les propriétés de l'objet sélectionné. Vous pouvez sélectionner un objet soit sur la Présentation soit dans le Navigateur d'objet.

Sélectionnez le type d'objet à modifier:

Graphique

Permet de définir le type de graphique, l'interrogation, les catégories, les valeurs et d'autres propriétés.

Affichage

Permet de définir les déclencheurs d'ouverture et de fermeture d'affichage et de modifier le format de date paramètre.

Objet graphique

Permet de définir les propriétés de nom, de procédure bouton et de descente de niveau.

Couche

Permet de créer, de supprimer, de masquer, d'afficher, d'activer et de renommer des couches.

Paramètre

Permet de créer et de supprimer des paramètres et d'en définir le nom, le type de données et la valeur initiale.

Interrogation

Permet de créer et de supprimer des interrogations et de définir la source de données et d'autres propriétés.

Modèle

Permet d'afficher l'Editeur de modèle de graphique, de créer et de supprimer des modèles de graphique et de définir le cadre, le modèle de champ, les axes et d'autres propriétés.

Horloge

Permet de créer et de supprimer des horloges et de définir leur nom, la procédure déclencheur et l'intervalle de temps.

Options outils


Interpréteur PL/SQL

Permet d'afficher l'interpréteur PL/SQL pour pouvoir exécuter et déboguer des unités de programme PL/SQ. Pour plus d'informations, reportez-vous à Procedure Builder Developer's Guide.


Unités de programme

Permet d'afficher l'Editeur d'unités de programme pour pouvoir créer et éditer des unités de programme PL/SQL. Pour plus d'informations, reportez-vous à Procedure Builder Developer's Guide.


Unités de programme stockées

Permet d'afficher l'Editeur d'unités de programme stockées, pour pouvoir créer et éditer des unités de programme PL/SQL stockées. Pour plus d'informations, reportez-vous à Procedure Builder Developer's Guide.


Déclencheurs de base de données

Permet d'afficher l'Editeur de déclencheurs de base de données pour pouvoir créer et éditer des déclencheurs de base de données. Pour plus d'informations, reportez-vous à Procedure Builder Developer's Guide.


Affichage

Permet de définir les déclencheurs d'ouverture et de fermeture d'affichage et de modifier le format de date paramètre.

Options de la fenêtre de propriétés

Déclencheur d'ouverture

Permet d'indiquer le nom de la procédure PL/SQL qui est exécutée lorsque l'affichage est ouvert pour la première fois lors de l'exécution. Cette liste ne comporte que les procédures qui ont un en-tête de procédure déclencheur d'ouverture valide.

Nouveau

Permet de créer un nouveau déclencheur d'ouverture d'affichage.

Déclencheur de fermeture

Permet d'indiquer le nom de la procédure PL/SQL qui est exécutée lorsque l'affichage est fermé lors de l'exécution. Cette liste ne comporte que les procédures qui ont un en-tête de procédure déclencheur de fermeture valide.

Nouveau

Permet de créer un nouveau déclencheur de fermeture d'affichage.

Format de date paramètre

Permet de spécifier le masque de format de date utilisé pour reconnaître les valeurs valides pour les paramètres de type DATE.

Liste

Permet d'afficher les masques de format de date disponibles dans l'affichage et d'ajouter ou de supprimer des masques. Le choix de ce bouton affiche la boîte de dialogue Format de date.

Direction

Permet d'indiquer la direction par défaut du texte, des flèches, etc. pour le support NLS bidirectionnel. Choisissez Gauche à droite, Droite à gauche ou Défaut (option déterminée par la langue utilisée).


Couches

Permet de créer, de supprimer, de masquer, d'afficher, d'activer et de renommer des couches.

Options de la boîte de dialogue

Couches existantes

Permet d'afficher les couches présentes dans l'affichage. L'ordre des couches dans la liste détermine la manière dont leurs objets apparaissent dans la présentation. Les objets d'une couche recouvrent les objets de toutes les couches affichées, qui se trouvent au-dessous d'elle dans la liste.

Nouvelle

Permet de créer une nouvelle couche vide appelée "layerx" (où x est une valeur numérique).

Supprimer

Permet de supprimer la couche sélectionnée dans la liste. Tous les objets de cette couche sont également supprimés.

Masquer/afficher

Permet de masquer la couche sélectionnée si elle est affichée ou de l'afficher si elle est masquée. Un signe `+' (plus) à côté du nom de la couche dans la liste indique qu'elle est affichée ; inversement, un signe `-' (moins) indique qu'elle est masquée. Vous ne pouvez pas masquer la couche active.

Activer

Permet d'activer la couche sélectionnée. Si la couche est masquée, elle est automatiquement définie comme devant être affichée. Pour désactiver une couche, activez-en une autre.

Haut/Bas/Sommet/Base

Permet de faire remonter ou redescendre la couche sélectionnée d'une position dans la liste et de la faire passer au sommet ou au bas de la liste. L'ordre des couches dans la liste détermine la manière dont leurs objets apparaissent dans la présentation. Les objets d'une couche recouvrent les objets de toutes les couches affichées, qui se trouvent au-dessous d'elle dans la liste.

Couche active

Permet d'afficher le nom de la couche active. Il ne peut y avoir qu'une couche active à la fois.

Renommer

Permet d'indiquer le nouveau nom de la couche sélectionnée. Sélectionnez Renommer pour renommer la couche.

Renommer

Permet de donner à la couche sélectionnée le nom spécifié dans le champ de texte Renommer.


Paramètres

Permet de créer et de supprimer des paramètres et de définir leur nom, leur type de données et leur valeur initiale.

Options de la fenêtre de propriétés

Paramètre

Sélectionnez le paramètre à modifier. Tous les paramètres qui existent dans l'affichage apparaissent dans cette liste.

Nom

Nom du paramètre.

Type

Type de données du paramètre.

Valeur initiale

Valeur initiale du paramètre lorsque vous exécutez l'affichage pour la première fois. La valeur entrée ici peut être remplacée par une valeur spécifiée dans la ligne de commande, et vous pouvez la modifier lors de l'exécution.

Une valeur de paramètre ne peut pas avoir plus de 2000 octets.


Interrogations

Permet de créer et de supprimer des interrogations et de définir leur source de données et d'autres propriétés.

Sélectionnez la page de propriétés correspondant aux options que vous voulez définir :

Page de propriétés d'interrogation

Permet de définir le nom, la source de données et l'instruction SQL (si nécessaire) d'une interrogation.

Page de propriétés des données

Permet d'afficher les données retournées par l'interrogation.

Page de propriétés d'option

Permet de définir les propriétés d'exécution, de cache de données et de déclencheurs, et d'autres propriétés.

Page de propriétés de schéma (interrogations personnalisées uniquement)

Permet de créer, de supprimer et de définir le nom et le type de données de colonnes personnalisées.


Page de propriétés d'interrogation

Permet de définir le nom, la source de données et l'instruction SQL (si nécessaire) d'une interrogation.

Options de la page de propriétés

Interrogation

Sélectionnez l'interrogation à modifier. Toutes les interrogations qui existent dans l'affichage apparaissent dans cette liste.

Nom

Nom de l'interrogation.

Type

Type d'interrogation. Sélectionnez l'une des options suivantes :

Instruction SQL	Permet d'indiquer que l'interrogation extrait ses données d'une base de données, en fonction de l'instruction SQL SELECT que vous fournissez. Entrez l'instruction SQL dans le champ de texte Instruction SQL.

Fichier SYLK	Permet d'indiquer que l'interrogation extrait ses données d'un fichier en format SYLK. SYLK est un format utilisé par différentes applications classiques, comme Microsoft Excel. Lorsque vous exécutez l'interrogation, les données sont extraites du fichier. Indiquez le fichier à utiliser dans le champ de texte Fichier.

Fichier WKS	Permet d'indiquer que l'interrogation extrait ses données d'un fichier en format WKS. WKS est un format utilisé par différentes applications classiques, comme Lotus 1-2-3. Lorsque vous exécutez l'interrogation, les données sont extraites du fichier. Indiquez le fichier à utiliser dans le champ de texte Fichier.

Fichier PRN	Permet d'indiquer que l'interrogation extrait ses données d'un fichier en format PRN. PRN est un format de fichier texte. Lorsque vous exécutez l'interrogation, les données sont extraites du fichier. Indiquez le fichier à utiliser dans le champ de texte Fichier.

Personnaliser	Vous permet de personnaliser les colonnes et les données de l'interrogation. Pour définir les colonnes, utilisez les contrôles de la Page de propriétés de schéma. Pour définir les données, utilisez la procédure interne OG_APPEND_ROW.

Fichier SQL externe	Permet d'indiquer que l'interrogation extrait ses donnés d'un fichier texte qui contient une instruction SQL SELECT. Lorsque vous exécutez l'interrogation, l'instruction SQL est extraite du fichier et exécutée. Indiquez le fichier à utiliser dans le champ de texte Fichier.

Fichier

Permet d'afficher l'emplacement et le nom du fichier à utiliser pour une interrogation SQL externe, SYLK, WKS ou PRN. Pour localiser le fichier dans votre système de fichiers, sélectionnez le bouton Parcourir.

Parcourir

Permet de localiser et de sélectionner le nom de fichier qui doit apparaître dans le champ de texte Fichier.

Instruction SQL

Permet d'indiquer l'instruction SQL SELECT qui est exécutée pour une interrogation Instruction SQL.

Connecter

Permet d'afficher la boîte de dialogue Connexion, qui vous permet de vous connecter à une base de données.

Importer SQL

Permet d'entrer le contenu d'un fichier texte dans le champ de texte Instruction SQL. Notez que le texte est copié, et non pas lié au fichier. Pour créer un lien à un texte SQL dans un fichier, utilisez un type d'interrogation de Fichier SQL externe.

Exporter SQL

Permet d'entrer le contenu du champ de texte Instruction SQL dans un fichier.

Nouvelle

Permet de créer une nouvelle interrogation.

Supprimer

Permet de supprimer l'interrogation en cours.

Exécuter

Permet d'exécuter l'interrogation en cours. Si l'interrogation est une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation extrait les données d'un fichier, le fichier est lu. Si l'interrogation est une interrogation personnalisée, sa procédure d'interrogation personnalisée est exécutée.

Eff. données

Permet d'effacer du cache des données toutes les données extraites. L'interrogation elle-même n'est ni supprimée ni modifiée.


Page de propriétés de données

Permet d'afficher les données retournées par l'interrogation. Sélectionnez une cellule pour afficher son contenu dans le champ de texte au-dessus du tableau. La première ligne de ce tableau contient les noms de colonne et les types de données.

Options de la page de propriétés

Interrogation

Sélectionnez l'interrogation à modifier. Toutes les interrogations qui existent dans l'affichage apparaissent dans cette liste.

Nouvelle

Permet de créer une nouvelle interrogation.

Supprimer

Permet de supprimer l'interrogation en cours.

Exécuter

Permet d'exécuter l'interrogation en cours. Si l'interrogation est une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation extrait les données d'un fichier, le fichier est lu. Si l'interrogation est une interrogation personnalisée, sa procédure d'interrogation personnalisée est exécutée.

Eff. données

Permet d'effacer du cache des données toutes les données extraites. L'interrogation elle-même n'est ni supprimée ni modifiée.


Page de propriétés d'option

Permet de définir les propriétés d'exécution et de cache de données, les déclencheurs et d'autres propriétés.

Options de la page de propriétés

Interrogation

Sélectionnez l'interrogation à modifier. Toutes les interrogations qui existent dans l'affichage apparaissent dans cette liste.

Exécuter sur

Permet de spécifier le moment auquel l'interrogation est automatiquement exécutée. Sélectionnez l'une des options suivantes :

Affichage à l'ouverture	Permet d'exécuter l'interrogation lorsque l'affichage est ouvert pour la première fois lors de l'exécution.

Horloge	Permet d'exécuter l'interrogation à la fréquence spécifiée par une horloge. Sélectionnez une horloge dans la liste déroulante, ou sélectionnez Nouvelle pour créer une nouvelle horloge.

Données

Permet de définir différentes options relatives aux données de l'interrogation.

Nouvelles données	Permet de déterminer la façon dont sont traitées les dernières données extraites d'une interrogation.

Remplace les anciennes données signifie qu'aucune des données provenant de la précédente exécution n'est prise en compte et que les données récemment extraites les remplacent.

S'ajoute aux anciennes données signifie que toutes les lignes de données existantes sont conservées et que les nouvelles sont ajoutées au bas de l'ensemble de données existant.

Enregistrer les anciennes données	Permet d'indiquer si les données préalablement extraites sont stockées dans un tampon spécial lorsqu'elles sont remplacées par les nouvelles données. Vous pouvez alors accéder à ce tampon d'"anciennes données" en utilisant des routines intégrées comme OG_GET_NUMCELL. Cette propriété n'est valide que lorsque le paramètre Nouvelles données remplace les anciennes données.

Nombre maximum de lignes 	 Permet d'indiquer le nombre maximum de lignes de données qui sont conservées dans l'ensemble de données de l'interrogation. Si l'ajout de données entraîne un dépassement du nombre maximum de lignes, les lignes excédentaires ne sont pas prises en compte à partir du début de l'ensemble de données. Cette propriété n'est valide que lorsque le paramètre Nouvelles données est S'ajoute aux anciennes données. En outre, l'attribut maxflag de l'interrogation doit être défini à TRUE (par défaut). Pour plus d'informations sur la définition de maxflag, reportez-vous à Propriété d'indicateur nombre maximum de lignes.

Format de date 	Permet d'indiquer le format utilisé pour reconnaître les données de date d'un fichier et de déterminer la manière dont les dates apparaissent dans la Page de propriétés de données. Si les données du fichier sont dans un format autre que celui spécifié dans cette boîte de dialogue, Graphics Builder ne les considère pas comme des dates.

PL/SQL

Permet d'indiquer différentes options relatives à l'utilisation de PL/SQL par l'interrogation.

Procédure d'exécution personnalisée	(Interrogation personnalisée uniquement) Permet d'indiquer la procédure PL/SQL qui est appelée lorsqu'une Interrogation personnalisée est exécutée. En général cette procédure contient des instructions PL/SQL qui remplissent l'interrogation de données. Seules les procédures qui ont un en-tête de procédure déclencheur d'interrogation personnalisée valide apparaissent dans cette liste.

Sélectionnez Nouvelle pour créer une nouvelle procédure d'interrogation personnalisée.

Déclencheur post-exécution 	Procédure PL/SQL appelée lorsque l'interrogation a été exécutée. Seules les procédures qui ont un en-tête de procédure déclencheur de post-interrogation valide apparaissent dans cette liste.

Sélectionnez Nouvelle pour créer une procédure de post-exécution.

Nouvelle

Permet de créer une nouvelle interrogation.

Supprimer

Permet de supprimer l'interrogation en cours.

Exécuter

Permet d'exécuter l'interrogation en cours. S'il s'agit d'une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation extrait des données d'un fichier, le fichier est lu. Si l'interrogation est personnalisée, sa procédure d'interrogation personnalisée est exécutée.

Eff. données

Permet d'effacer du cache de données toutes les données extraites. L'interrogation elle-même n'est ni supprimée ni modifiée.


Page de propriétés de schéma

(Interrogations personnalisées uniquement) Permet de créer, de supprimer et de définir le nom et le type de données des colonnes d'une interrogation personnalisée.

Options de la page de propriétés

Interrogation

Sélectionnez l'interrogation à modifier. Toutes les interrogations qui existent dans l'affichage apparaissent dans cette liste.

Colonne

Sélectionnez la colonne à modifier. Toutes les colonnes qui ont été définies pour cette interrogation apparaissent dans cette liste.

Nom

Nom de la colonne. Pour le modifier, entrez un nouveau nom et sélectionnez Appliquer.

Type

Type de données de la colonne.

Longueur maximum

Longueur maximum des données contenues dans la colonne. Cette option ne s'applique qu'aux colonnes de type CHAR.

Nouvelle colonne

Permet d'ajouter une nouvelle colonne à l'interrogation.

Supprimer colonne

Permet de supprimer de l'interrogation la colonne en cours.

Nouvelle

Permet de créer une nouvelle interrogation.

Supprimer

Permet de supprimer l'interrogation en cours.

Exécuter

Permet d'exécuter l'interrogation en cours. S'il s'agit d'une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation est extraite des données d'un fichier, le fichier est lu. Si l'interrogation est personnalisée, sa procédure d'interrogation personnalisée est exécutée.

Eff. données

Permet d'effacer du cache de données toutes les données extraites. L'interrogation elle-même n'est ni supprimée ni modifiée.


Modèles

Permet d'afficher l'Editeur de modèle de graphique, de créer et de supprimer des modèles de graphique et de définir un cadre, un modèle de champ, un axe et d'autres propriétés.


Horloges

Permet de créer et de supprimer des horloges et d'en indiquer le nom, la procédure déclencheur et l'intervalle de temps.

Options de la fenêtre de propriétés

Horloge

Sélectionnez l'horloge à modifier. Toutes les horloges qui existent dans l'affichage apparaissent dans la liste.

Nom

Nom de l'horloge.

Procédure

Procédure PL/SQL (si elle existe) qui s'exécute lorsque l'horloge est activée. Seules les procédures qui ont un en-tête de procédure déclencheur d'horloge valide apparaissent dans cette liste.

Pour créer une nouvelle procédure d'horloge, sélectionnez Nouvelle.

Intervalle

Intervalle de temps entre deux activations de l'horloge.

Activer

Permet d'activer l'horloge.

Nouvelle

Permet de créer une nouvelle horloge.

Supprimer

Permet de supprimer l'horloge en cours.


Options outils

Permet de modifier différentes options de Graphics Builder.

Sélectionnez l'onglet de la boîte de dialogue correspondant aux options que vous voulez définir :

Onglet Par défaut

Permet de définir le message de copyright, la palette de couleurs, les listes de formats de nombre et de date et la taille de la page.

Onglet Préférences

Permet de définir les options de démarrage et d'autres paramètres généraux.


Onglet Par défaut

Permet de définir le message de copyright, la palette de couleurs, les listes de format de nombre et de date et le format de la page.

Options de la boîte de dialogue

Message de copyright

Texte par défaut qui apparaît dans la boîte de dialogue Informations utilisateur du champ Copyright d'un affichage nouvellement créé. Ce paramètre entre en vigueur dès que vous créez ou que vous ouvrez un nouvel affichage.

Palette de couleurs

Permet de définir les options relatives à la palette de couleurs utilisée.

Fichier	Nom du fichier qui contient la palette de couleurs à utiliser pour les nouveaux affichages que vous créez. Si ce champ est laissé en blanc, Graphic Builders utilise sa palette de couleurs par défaut. Ce champ doit contenir le nom complet ou relatif du chemin d'accès à la palette de couleurs. Ce paramètre entre en vigueur dès que vous créez ou que vous ouvrez un nouvel affichage.

Mode	Permet de déterminer la façon dont la palette de couleurs d'un affichage est mise en oeuvre sur votre système. Chaque fois que vous activez un affichage différent, Graphics Builder tente de modifier la palette de couleurs de votre système afin qu'elle corresponde à la palette de couleurs de cet affichage ou qu'elle s'en rapproche le plus possible. Comme votre système ne peut à un moment donné gérer qu'un nombre limité de couleurs, Graphics Builder peut ne pas être en mesure d'afficher avec précision plusieurs affichages simultanés s'ils utilisent des palettes de couleurs différentes. Ce paramètre entre en vigueur dès que vous créez ou que vous ouvrez un nouvel affichage. La liste contient les options suivantes :

Modifiable Permet d'indiquer que Graphics Builder remplace momentanément la palette de couleurs de votre système par celle de l'affichage actif. Chaque fois que vous activez un nouvel affichage, sa palette de couleurs remplace la palette du système. L'affichage actif est alors précis, bien que l'aspect des affichages inactifs puisse en souffrir. La palette doit être Modifiable pour que vous puissiez modifier ou importer une palette de couleurs.

Lecture seule - partagée Permet d'indiquer que Graphics Builder continue à ajouter la palette de couleurs de chaque affichage actif à la palette d'origine de votre système, et ce jusqu'à ce que la palette soit pleine. Cette palette devient la palette commune à tous les affichages ouverts. Si vous activez un affichage qui utilise des couleurs totalement différentes, il risque de ne pas être précis.

Lecture seule - privée Permet d'indiquer que chaque fois que vous activez un affichage, Graphics Builder ajoute la palette de couleurs de cet affichage à la palette d'origine de votre système, et ce jusqu'à ce que la palette soit pleine. Cette palette devient la palette utilisée lorsque cet affichage est actif. L'affichage actif est alors précis, bien que l'aspect des affichages inactifs puisse en souffrir.

Listes de format

Permet de définir les formats de date et de nombre existant par défaut dans les boîtes de dialogue Format de nombre et Format de date. Ce paramètre prend effet immédiatement. Vous avez le choix entre les boutons suivants :

Date	Permet de définir les masques de format de date et d'afficher la boîte de dialogue Format de date.

Nombre	Permet de définir les masques de format de nombres et d'afficher la boîte de dialogue Format de nombre.

Taille de la page

Permet de définir la largeur, la hauteur et les unités d'une page physique, qui déterminent l'emplacement des lignes de saut de page sur la présentation. Notez que la présentation peut être plus large que la page.

Enregistrer

Permet de valider les options et de les enregistrer dans votre fichier d'options.


Onglet Préférences

Permet de définir les options de démarrage et d'autres paramètres généraux.

Options de la boîte de dialogue

Démarrage

Permet de définir différentes options qui contrôlent le comportement de Graphics Builder lorsque vous l'exécutez pour la première fois.

Ouvrir	Permet d'indiquer si Graphics Builder ouvre ou crée un affichage par défaut.

Pas d'affichage signifie qu'aucun affichage n'est créé ni ouvert lorsque vous exécutez Graphics Builder pour la première fois.

Nouvel affichage signifie que Graphics Builder crée automatiquement un nouvel affichage et affiche son éditeur de présentation.

Ouvrir fichier signifie que Graphics Builder affiche automatiquement la boîte de dialogue Filtre, pour vous permettre d'ouvrir au départ un affichage à partir d'un fichier.

Connexion au démarrage	Permet d'afficher la boîte de dialogue Connexion lorsque vous exécutez Graphics Builder pour la première fois. Si vous vous connectez à une base de données en utilisant l'argument d'exécutable USERID, la boîte de dialogue Connexion n'apparaît pas. Ce paramètre entre en vigueur dès que vous lancez un exécutable Graphics Builder.

Générales

Permet de définir des options générales.

Sortie son

Unité de sortie utilisée pour les sons. Les éléments de cette liste sont propres au système utilisé. Pour plus d'informations, reportez-vous à la documentation de votre système. Ce paramètre entre en vigueur immédiatement.

Compression d'image

Permet d'indiquer le système utilisé pour comprimer toutes les images de l'affichage lorsque vous enregistrez ou générez un affichage, ou que vous copiez une image dans le Presse-papiers.

Si vous sélectionnez un système de compression qui ne s'applique pas à une image de l'affichage, cette image n'est pas compressée. Par exemple, si vous sélectionnez PackBits et si vous enregistrez un affichage contenant une image couleurs, cette image ne sera pas compressée. Ce paramètre entre en vigueur dès que vous créez ou que vous ouvrez un nouvel affichage.

Conversion automatique jeu de caractères

Permet d'indiquer si Graphics Builder convertit automatiquement le texte d'un affichage en caractères du jeu spécifié par la variable d'environnement NLS_LANG lorsque l'affichage est ouvert. Ce paramètre entre en vigueur dès que vous créez ou que vous ouvrez un nouvel affichage.

Redessiner progressivement à l'exécution

Permet d'indiquer comment Graphics Builder met à jour les parties de la présentation qui sont concernées par les opérations de dessin. Ce paramètre entre en vigueur lors de l'exécution.

Si ce paramètre est désactivé, Graphics Builder dessine individuellement chaque objet modifié dans une région endommagée.

Si ce paramètre est activé, Graphics Builder commence par stocker chacun des objets modifiés dans un tampon interne.

Lorsque le stockage est terminé, la présentation est mise à jour par un nouveau tracé. L'option Redessiner progressivement diminue considérablement le scintillement de la présentation lors de sa mise à jour. Cependant, si la région endommagée est importante, le tampon interne généré par Redessiner progressivement peut occuper beaucoup de place en mémoire. Il est conseillé de laisser activé Redessiner progressivement si vous ne rencontrez pas de problème de place en mémoire.

Conserver une sauvegarde

Permet d'indiquer si Graphics Builder conserve une copie de l'affichage chaque fois que vous l'enregistrez. Le fichier de sauvegarde a le même nom de base que le fichier d'origine, mais avec l'extension .bak. Par exemple, si vous enregistrez l'affichage tendances.ogd, le fichier de sauvegarde s'appellera tendances.bak.

Appliquer les propriétés à la navigation

Permet d'indiquer si les modifications apportées à une fenêtre de propriétés sont automatiquement appliquées lorsque vous affichez les propriétés d'un autre objet dans cette fenêtre de propriétés (par exemple en sélectionnant un autre objet dans la liste déroulante de la fenêtre de propriétés). Si cette case n'est pas cochée, vous serez invité à enregistrer les modifications en attente lorsque nécessaire.

Appliquer les propriétés d'interrogation à la navigation

Permet d'indiquer si les modifications apportées à la fenêtre de propriétés d'interrogation sont automatiquement appliquées lorsque vous exécutez l'interrogation. Si cette case n'est pas cochée, vous serez invité à enregistrer les modifications en attente lorsque nécessaire.

Enregistrer

Permet de valider les options et de les enregistrer dans votre fichier d'options.


Menu Type

Le menu Type contient des modèles prédéfinis pour chacun des types de graphiques supportés par Graphics Builder. Ces modèles pourront vous servir de point de départ lorsque vous personnaliserez vos propres modèles. Cette section décrit les options du menu Type de Graphics Builder :

Colonne

Barre

Ligne

Combiné

Secteur

Double-Y

Haut-Bas

Gantt

Nuages de points

Tableau


Colonne

Permet d'afficher un sous-menu contenant des modèles de graphiques à colonnes prédéfinis. Si l'éditeur de modèle de graphique affiche un modèle, le choix d'un modèle prédéfini dans ce menu remplace les propriétés du modèle existant. En l'absence de modèle, le choix d'un modèle de ce menu crée un nouveau modèle ayant les propriétés par défaut choisies.


Barre

Permet d'afficher un sous-menu contenant des modèles de graphiques à barres prédéfinis. Si l'éditeur de modèle de graphique affiche un modèle, le choix d'un modèle prédéfini dans ce menu remplace les propriétés du modèle existant. En l'absence de modèle, le choix d'un modèle de ce menu crée un nouveau modèle ayant les propriétés par défaut choisies.


Ligne

Permet d'afficher un sous-menu contenant des modèles de graphiques à lignes prédéfinis. Si l'éditeur de modèle de graphique affiche un modèle, le choix d'un modèle prédéfini dans ce menu remplace les propriétés du modèle existant. En l'absence de modèle, le choix d'un modèle de ce menu crée un nouveau modèle ayant les propriétés par défaut choisies.


Combiné

Permet d'afficher un sous-menu contenant des modèles de graphiques combinés prédéfinis. Si l'éditeur de modèle de graphique affiche un modèle, le choix d'un modèle prédéfini dans ce menu remplace les propriétés du modèle existant. En l'absence de modèle, le choix d'un modèle de ce menu crée un nouveau modèle ayant les propriétés par défaut choisies.


Secteur

Permet d'afficher un sous-menu contenant des modèles de graphiques à secteurs prédéfinis. Si l'éditeur de modèle de graphique affiche un modèle, le choix d'un modèle prédéfini dans ce menu remplace les propriétés du modèle existant. En l'absence de modèle, le choix d'un modèle de ce menu crée un nouveau modèle ayant les propriétés par défaut choisies.


Double-Y

Permet d'afficher un sous-menu contenant des modèles de graphiques à doubles-Y prédéfinis. Si l'éditeur de modèle de graphique affiche un modèle, le choix d'un modèle prédéfini dans ce menu remplace les propriétés du modèle existant. En l'absence de modèle, le choix d'un modèle de ce menu crée un nouveau modèle ayant les propriétés par défaut choisies.


Haut-Bas

Permet d'afficher un sous-menu contenant des modèles de graphiques de type haut-bas prédéfinis. Si l'éditeur de modèle de graphique affiche un modèle, le choix d'un modèle prédéfini dans ce menu remplace les propriétés du modèle existant. En l'absence de modèle, le choix d'un modèle de ce menu crée un nouveau modèle ayant les propriétés par défaut choisies.


Gantt

Permet d'afficher un sous-menu contenant des modèles de graphiques de Gantt prédéfinis. Si l'éditeur de modèle de graphique affiche un modèle, le choix d'un modèle prédéfini dans ce menu remplace les propriétés du modèle existant. En l'absence de modèle, le choix d'un modèle de ce menu crée un nouveau modèle ayant les propriétés par défaut choisies.


Nuages de points

Permet d'afficher un sous-menu contenant des modèles de graphiques à nuages de points prédéfinis. Si l'éditeur de modèle de graphique affiche un modèle, le choix d'un modèle prédéfini dans ce menu remplace les propriétés du modèle existant. En l'absence de modèle, le choix d'un modèle de ce menu crée un nouveau modèle ayant les propriétés par défaut choisies.


Tableau

Permet d'afficher un sous-menu contenant des modèles de graphiques de type tableau prédéfinis. Si l'éditeur de modèle de graphique affiche un modèle, le choix d'un modèle prédéfini dans ce menu remplace les propriétés du modèle existant. En l'absence de modèle, le choix d'un modèle de ce menu crée un nouveau modèle ayant les propriétés par défaut choisies.


 Menu Affichage

La présente section décrit les options du menu Affichage de Graphics Builder :

Taille normale

Ajuster à la fenêtre

Zoom avant

Zoom arrière

Règles

Guides

Grille

Grille magnétique

Sauts de page

Palette d'outils

Barre d'état

Options d'affichage


Taille normale

Permet d'afficher en format normal la présentation qui avait été agrandie.


Ajuster à la fenêtre

Permet de réduire la présentation pour qu'elle soit entièrement visible.


Zoom avant

Permet de doubler la taille de la présentation.


Zoom arrière

Permet de réduire de moitié la taille de la présentation.


Règles

Permet d'afficher ou de masquer les règles de la présentation.


Guides

Permet d'afficher ou de masquer les guides de la présentation.


Grille

Permet d'afficher ou de masquer la grille de la présentation.


Grille magnétique

Permet d'activer ou de désactiver la grille magnétique de la présentation.


Sauts de page

Permet d'afficher ou de masquer les sauts de page de la présentation.


Palette d'outils

Permet d'afficher ou de masquer la palette d'outils de la présentation.


Barre d'état

Permet d'afficher ou de masquer la barre d'état de la présentation.


Options d'affichage

Permet de modifier les options associées à l'affichage de la présentation.

Sélectionnez l'option de sous-menu correspondant aux options que vous voulez définir :

Règle

Permet de définir les options d'unités de règle, de pas de la grille et de résolution de la grille magnétique.

Présentation

Permet de définir les options d'orientation et de taille de la page.


Menu Fenêtre

Ce menu répertorie toutes les fenêtres de Graphics Builder ouvertes que vous pouvez activer.

La fenêtre choisie devient la fenêtre active et s'affiche devant toutes les autres. Par exemple, si vous avez ouvert l'éditeur de présentation et l'éditeur de modèle de graphique et que l'éditeur de présentation soit actif (devant toutes les autres fenêtres), vous pouvez choisir l'éditeur de modèle de graphique dans le menu Fenêtre pour l'activer. Pour plus d'informations sur le menu Fenêtre, reportez-vous à la documentation de votre système.


A propos de OLE

OLE (Object Linking and Embedding) vous permet de combiner les fonctions de plusieurs applications en un seul document.

Une application conteneur est une application qui peut afficher les objets d'une autre application. Par exemple, Forms peut contenir une feuille de calcul Microsoft Excel.

Une application serveur est une application dont les objets peuvent être affichés par un conteneur. Par exemple, un affichage Graphics Builder  peut être intégré dans une grille Visual Basic.

Graphics Builder est un serveur OLE. Vous pouvez intégrer un affichage Graphics Builder dans toute application conteneur OLE. Pour plus d'informations, reportez-vous à la documentation sur l'application conteneur.


A propos de verbes OLE
A propos des verbes OLE

Un verbe définit l'opération qu'exécute un affichage Graphics Builder lorsqu'il est activé dans un conteneur OLE. Graphics Builder supporte les verbes suivants :

HIDE

OPEN

SHOW

Le verbe PRINCIPAL (c'est-à-dire par défaut) est OPEN.


A propos de HIDE

Le verbe OLE HIDE désactive l'objet Graphics Builder intégré et masque l'affichage.


A propos de OPEN

Le verbe OLE OPEN lance l'exécutable Graphics Builder et charge l'affichage intégré dans l'application conteneur.


A propos de SHOW

Le verbe OLE SHOW active l'objet Graphics Builder intégré et le prépare à son interaction avec l'application conteneur.


A propos de l'automatisation OLE

L'automatisation OLE vous permet de manipuler un affichage Graphics Builder intégré en utilisant des éléments de programme de l'application conteneur. Graphics Builder supporte différentes méthodes qui permettent d'accéder aux fonctionnalités de Graphics Builder. Pour plus d'informations sur l'appel de ces méthodes, reportez-vous à la documentation sur l'application conteneur.


ClearQuery

Permet d'effacer toutes les données d'une interrogation Graphics Builder.

Syntaxe Visual Basic :

ole.Object.ClearQuery nom_interrogation

où :

ole	Indique l'objet OLE.

nom_interrogation	Indique le nom de l'interrogation Graphics Builder à effacer.


Connect

Permet d'établir une connexion de base de données pour l'affichage Graphics Builder intégré.

Syntaxe Visual Basic :

ole.Object.Connect chaîne_connexion

où :

ole	Indique l'objet OLE.

chaîne_connexion	Indique une chaîne de connexion de base de données 0racle valide, se présentant sous la forme nom_utilisateur/mot_passe@serveur_éloigné.


GetCharParam

Permet de retourner la valeur de type caractère d'un paramètre Graphics Builder. Si le paramètre n'est pas de type CHAR, il est converti en CHAR avant d'être retourné.

Syntaxe Visual Basic :

x = ole.Object.GetCharParam nom_param

où :

ole	Indique l'objet OLE.

nom_param	Indique le nom du paramètre de l'affichage Graphics Builder.


Interpret

Permet de demander à Graphics Builder d'exécuter une chaîne PL/SQL.

Syntaxe Visual Basic :

ole.Object.Interpret chaîne_pls

où :

ole	Indique l'objet OLE.

chaîne_pls	Indique une chaîne PL/SQL qui peut être exécutée par Graphics Builder.


MouseDown

Permet de signaler un événement de bouton souris enfoncé à l'affichage Graphics Builder.

Syntaxe Visual Basic :

ole.Object.MouseDown pos_x pos_y

où :

ole	Indique l'objet OLE.

pos_x	Indique la coordonnée x de l'emplacement de l'événement de souris. Par exemple, cette information est fournie par l'événement MouseDown Visual Basic.

pos_y	Indique la coordonnée y de l'emplacement de l'événement de souris. Par exemple, cette information est fournie par l'événement MouseDown Visual Basic


MouseMove

Permet de signaler un événement de mouvement souris à l'affichage Graphics Builder.

Syntaxe Visual Basic :

ole.Object.MouseMove pos_x pos_y

où :

ole	Indique l'objet OLE.

pos_x	Indique la coordonnée x de l'emplacement de l'événement de souris. Par exemple, cette information est fournie par l'événement MouseMove Visual Basic.

pos_y	Indique la coordonnée y de l'emplacement de l'événement de souris. Par exemple, cette information est fournie par l'événement MouseMove Visual Basic.


MouseUp

Permet de signaler un événement de bouton souris relâché à l'affichage Graphics Builder.

Syntaxe Visual Basic :

ole.Object.MouseUp pos_x, pos_y

où :

ole	Indique l'objet OLE.

pos_x	Indique la coordonnée x de l'emplacement de l'événement de souris. Par exemple, cette information est fournie par l'événement MouseUp Visual Basic.

pos_y	Indique la coordonnée y de l'emplacement de l'événement de souris. Par exemple, cette information est fournie par l'événement MouseUp Visual Basic.


SetRow

Permet d'ajouter une ligne de données à une interrogation personnalisée dans l'affichage Graphics Builder intégré.

Syntaxe Visual Basic :

ole.Object.SetRow nom_interrogation, valeur[, valeur...]

où :

ole	Indique l'objet OLE.

nom_interrogation	Indique le nom de l'interrogation personnalisée.

Valeur Indique une valeur de données de type numérique ou caractère. Ces valeurs sont combinées en une seule ligne de données, puis ajoutées à l'interrogation. Par exemple, si vous définissez l'interrogation personnalisée 'Interrogation0' qui contient les colonnes ENAME et SAL pour ajouter une ligne contenant les valeurs 'SMITH' et 2000, vous utiliserez la commande Visual Basic suivante :

ole.Object.SetRow "interrogation0", "SMITH", 2000


Sync

Permet de mettre à jour l'aspect de l'objet intégré afin qu'il reflète l'état actuel de l'affichage.

Syntaxe Visual Basic :

ole.Object.Sync

où :

ole	Indique l'objet OLE.


Palette de motifs

Pour visualiser un exemple de chaque motif de la palette, ainsi que son nom, sélectionnez l'un des liens suivants :

Motifs, 1re partie

Motifs, 2e partie


Palette de couleurs par défaut

Graphics Builder utilise sa palette de couleurs par défaut si vous n'en indiquez pas spécifiquement ou si vous n'en importez pas une autre.

La palette par défaut est également fournie sous la forme d'un fichier que vous pouvez importer dans un affichage. Pour plus d'informations sur l'emplacement de ce fichier, reportez-vous aux instructions d'installation de votre système d'exploitation.

La palette de couleurs par défaut est définie par les règles suivantes :

1	La partie supérieure gauche de la palette contient 16 couleurs couramment utilisées, appelées :

noir	blanc	vert	vert foncé
	gris	gris foncé	cyan	cyan foncé
	rouge	rouge foncé	bleu	bleu foncé
	jaune	jaune foncé	magenta	magenta foncé
1	La partie inférieure gauche de la palette contient huit cellules vides dans lesquelles vous pouvez entrer vos couleurs personnalisées.

2	Les cinq colonnes suivantes se composent de différentes nuances de gris. Chaque couleur est appelée 'gris' <valeur>', selon son pourcentage de gris. Les valeurs sont comprises entre 4 et 96, par incréments de 4. Exemple de noms de couleur valides : 'gris96', 'gris92' et 'gris4'.

3	Le reste de la palette contient les couleurs indiquées en faisant varier les pourcentages de rouge, de vert et de bleu (RVB) :

Les pourcentages de chaque composant de rouge ou vert sont les suivants : 0, 25, 50, 75, 88 ou 100.

Les pourcentages de chaque composant de bleu sont : 0, 50, 75, 88 ou 100.

Chaque couleur est appelée `r<valeur>v<valeur>b<valeur>', selon ses valeurs RVB (c'est-à-dire la couleur qui est composée de 100 % de rouge, 0 % de vert et 88 % de bleu s'appelle `r100v0b88').

A l'exception des cellules de couleur décrites ci-dessus, la palette se compose de cinq régions principales contenant chacune 36 couleurs disposées 6 par 6. Ces couleurs sont définies par les règles suivantes :

La valeur du rouge augmente lorsque la couleur progresse de gauche à droite dans chaque région principale.

La valeur du vert augmente lorsque la couleur progresse de gauche à droite dans chaque région principale.

La valeur du bleu augmente lorsque les régions principales progressent de gauche à droite, toutes les couleurs d'une même région utilisant la même valeur de bleu.


Niveaux de gris

La palette de couleurs de nuances de gris se compose uniquement de différentes teintes de gris. Elle est définie par les règles suivantes :

1	Les deux premières couleurs s'appellent 'noir' et 'blanc'.

2	Le reste de la palette contient des couleurs indiquées en faisant varier les pourcentages de gris. Chaque couleur est appelée `gris<valeur>', selon sa valeur de gris. Ces couleurs sont définies par les règles suivantes :

La valeur de gris de la première couleur grise (à la droite de 'blanc') est 100 %, et s'appelle donc 'gris100'.

Lorsque les couleurs progressent de gauche à droite sur la palette (et avec passage de la cellule de droite d'une ligne à la cellule de gauche de la suivante), la valeur de gris de chaque couleur est inférieure de 0.5 à celle qui la précède.

Après 'gris12.5', la valeur de gris de chaque couleur est inférieure de 0.25 à celle qui la précède.

Les valeurs de gris continuent à diminuer jusqu'à la dernière couleur de la palette, appelée 'gris0'.


Oracle CDE1

La palette de couleurs ORACLE CDE1 est l'ancienne palette de couleurs par défaut de Graphics Builder 2.0. Elle est définie par les règles suivantes :

1	Les deux premières colonnes de la palette contiennent :

les couleurs couramment utilisées, appelées `bleu', `magenta', `rouge', `cyan', `vert' et `jaune'

les nuances de gris appelées `noir', `gris60', `gris45', `gris30', `gris15', et `blanc'

2	Le reste de la palette contient les couleurs indiquées en faisant varier les pourcentages de rouge, vert et bleu (RVB). La valeur de pourcentage de chaque composant est : 0, 40, 55, 70, 85 ou 100.

Chaque couleur est appelée `r<valeur>v<valeur>b<valeur>', selon ses valeurs RVB (c'est-à-dire que la couleur qui est composée de 100 % de rouge, 40 % de bleu et 0 % de vert s'appelle `r100b40v0').

Exception faite des deux premières colonnes, la palette se compose de 6 zones principales, contenant chacune 36 couleurs disposées 6 par 6. Ces couleurs sont définies par les règles suivantes :

 La valeur du rouge augmente lorsque la couleur progresse de gauche à droite dans chaque région principale.

 La valeur du vert augmente lorsque la couleur progresse de haut en bas dans chaque région principale.

 La valeur du bleu augmente lorsque les régions principales progressent de gauche à droite, toutes les couleurs d'une même région utilisant la même valeur de bleu.


Motifs, 1re partie


Motifs, 2e partie


Liste alphabétique des objets

propriétés d'axe

propriétés de graphique

propriétés d'affichage

propriétés de modèle de champ

propriétés de cadre

propriétés de couche

propriétés d'objet

propriétés de paramètre

propriétés d'interrogation

propriétés de ligne de référence

propriétés d'horloge


Propriétés d'axe

propriétés d'axe

Etiquette, position, direction, marque de graduation, grille et autres paramètres.

propriétés d'axe continu

Maximum, minimum, pas et échelle d'axe.

propriétés de l'axe de date

Maximum, minimum, pas, étiquette et autres paramètres.

propriétés d'axe discret

Nombre minimum et maximum de catégories.


Propriétés d'axe

Etiquette personnalisée

Permet d'indiquer le type d'étiquette affichée le long de l'axe.

Type de données

Permet d'indiquer le comportement des données affichées le long de l'axe.

Position de l'axe

Permet d'indiquer le bord du graphique le long duquel l'axe apparaît.

Direction de l'axe

Permet d'indiquer l'emplacement des valeurs croissantes ou des catégories successives le long de l'axe.

Position des graduations

Permet d'indiquer la présentation des graduations principales et secondaires.

Orientation étiquettes de graduation

Permet d'indiquer l'angle de rotation des étiquettes de graduation. Remarque : Certains systèmes ne supportent pas la rotation de texte. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

Graduations secondaires par intervalle

Permet d'indiquer le nombre de graduations secondaires définies dans chaque intervalle de graduation principale.

Graduations principales

Permet d'indiquer la présence de graduations principales à chaque intervalle principal.

Graduations secondaires

Permet d'indiquer la présence de graduations secondaires selon la valeur définie pour l'option Graduations secondaires par intervalle.

Grille principale

Permet d'indiquer la présence d'une ligne de grille à chaque graduation principale.

Grille secondaire

Permet d'indiquer la présence d'une ligne de grille à chaque graduation secondaire.

Etiquette de l'axe

Permet d'indiquer la présence d'étiquettes d'identification des valeurs le long de l'axe.

Etiquettes des graduations

Permet d'indiquer la présence d'étiquettes d'identification des valeurs le long de l'axe.


Propriétés d'axe continu

Maximum

Permet d'indiquer la valeur la plus élevée devant figurer sur l'axe.

Pas

Permet d'indiquer l'intervalle principal des graduations et des étiquettes le long de l'axe.

Minimum

Permet d'indiquer la valeur la plus faible devant figurer sur l'axe.

Echelle

Permet d'indiquer l'algorithme utilisé pour mettre l'axe à l'échelle.

Linéaire	L'axe est mis à l'échelle selon l'intervalle fixe entre les valeurs minimum et maximum de l'axe.

Logarithmique	L'axe est mis à l'échelle selon un algorithme logarithmique (basé sur des puissances de 10) pour déterminer les intervalles entre les valeurs minimum et maximum de l'axe.

Pourcentage de	L'axe est mis à l'échelle de sorte que les valeurs soient tracées par rapport à l'une des valeurs suivantes :

somme	Le tracé de chaque valeur de données s'effectue sous la forme d'un pourcentage de la somme de toutes les valeurs de données.

minimum	Le tracé de chaque valeur de données s'effectue sous la forme d'un pourcentage de la plus petite valeur de données.

maximum	Le tracé de chaque valeur de données s'effectue sous la forme d'un pourcentage de la plus grande valeur de données.

Remarque : La mise à l'échelle de Pourcentage de ne s'applique pas à un axe continu et indépendant (par exemple, sur un graphique à nuages de points).

Si vous choisissez Pourcentage de, vous devez également indiquer comment seront calculées les valeurs de comparaison :

champ	Le pourcentage de chaque valeur est calculé par rapport aux valeurs de données du même champ dans d'autres catégories. Par exemple, le salaire de SMITH sera tracé par comparaison avec les salaires de tous les autres employés.

categorie	Le pourcentage de chaque valeur est calculé par rapport aux valeurs de données de la même catégorie dans d'autres champs. (Cette option n'est significative que lorsque le système trace plusieurs champs pour une même catégorie.) Par exemple, le salaire et la commission de SMITH seront tracés par comparaison de l'un avec l'autre, mais non par comparaison avec les valeurs des autres employés.


Propriétés d'axe de date

Maximum

Permet d'indiquer la valeur la plus élevée devant figurer sur l'axe.

Pas

Permet d'indiquer la granularité utilisée pour la division en catégories d'un axe de date indépendant. Le pas est divisé en unités principales indiquées par la valeur de l'option Etiquettes qui donne le nombre de catégories tracées entre les graduations.

Minimum

Permet d'indiquer la valeur la plus faible devant figurer sur l'axe.

Premier mois

Permet d'indiquer le mois qui sera considéré comme le premier mois de l'année.

Sauter les week-ends

Permet d'indiquer que les week-ends ne seront pas pris en compte lors du calcul des valeurs de l'axe.

Etiquettes

Permet d'indiquer l'intervalle principal le long de l'axe portant les graduations principales et les étiquettes, ainsi que la présentation des étiquettes. Les paramètres des étiquettes pour les unités inférieures à celles représentées par l'option Pas ne sont pas pris en compte.

Personnalisé L'entrée d'un format de date personnalisé dans le champ correspondant est obligatoire. Si l'unité la plus faible utilisée dans ce format est inférieure à celle cochée, Graphics Builder se comporte comme si vous aviez coché cette unité. Pour plus d'informations sur les formats de date valides, reportez-vous à Oracle7 Server SQL Language Reference Manual.


Propriétés d'axe discret

Nombre minimum de catégories

Nombre minimum de catégories tracées dans le graphique. Si le nombre réel de catégories est inférieur au nombre indiqué ici, le système laisse de la place sur le graphique pour le nombre minimum de catégories indiqué.

Nombre maximum de catégories

Nombre maximum de catégories tracées dans le graphique. Lorsque le nombre maximum de catégories a été tracé, les données restantes ne sont pas prises en compte.


Propriétés de graphique

propriétés de graphique

Nom, titre, type de graphique et propriétés du modèle.

propriétés de données (graphique)

Interrogation, filtre, plage de données et autres propriétés.

propriétés de catégorie

Colonnes d'interrogation qui apparaissent sous la forme de catégories sur le graphique.

propriétés de valeurs

Colonnes d'interrogation qui apparaissent sous la forme de valeurs sur le graphique.

propriétés PL/SQL

Paramètres de la procédure bouton PL/SQL.


Propriétés de graphique

Nom

Nom du graphique. Vous devrez utiliser ce nom pour faire référence au graphique dans vos unités de programme PL/SQL. Si vous ne prévoyez pas de faire référence au graphique dans votre programme, vous pouvez laisser ce champ vide.

Titre

Titre du graphique. Par défaut, le titre apparaît au-dessus du graphique. Si nécessaire, vous pouvez le déplacer.

Type

Type du graphique de base.

Sous-type

Variante du type de graphique. Chaque variante est basée sur le type de graphique indiqué, les différentes propriétés permettant de faire varier la présentation.

Modèle

Modèle sur lequel est basé le graphique. Le système crée automatiquement un nouveau modèle lorsque vous créez un nouveau graphique. Pour baser un graphique sur un modèle existant, sélectionnez-le dans cette liste.


Propriétés de données (graphique)

Interrogation

Interrogation qui fournit les données utilisées pour le graphique.

Notez que Graphics Builder crée le graphique en utilisant les plus récentes données fournies par l'interrogation que vous sélectionnez. Pour utiliser des données plus récentes, réexécutez l'interrogation.

Mettre à jour le graphique sur exécution de l'interrogation

Permet de demander la mise à jour automatique du graphique lorsque l'interrogation est exécutée. Vous pouvez également utiliser la procédure interne OG_UPDATE_CHART pour programmer la mise à jour du graphique.

Fonction filtre

Fonction PL/SQL à utiliser pour filtrer les données fournies par l'interrogation. Seules les lignes de données pour lesquelles cette fonction retourne la valeur TRUE apparaissent sur le graphique. Seules les fonctions qui ont un en-tête de fonction de déclenchement de filtre valide apparaissent dans cette liste.

Type correspondance

Permet de déterminer la présentation de la page de propriétés de valeurs. Les paramètres disponibles dépendent du type de graphique.

Générales	Permet de définir une liste de valeurs.

Gantt	Permet de définir les colonnes qui apparaissent sous la forme de valeurs "début" et "fin".

Max-min	Permet de définir les colonnes qui apparaissent sous la forme de valeurs "Max", "Clôture" et "Min".

Plage de données

Permet d'indiquer les lignes de données qui, provenant de l'interrogation, sont tracées sur le graphique.

Tracer toutes les lignes	Permet de faire figurer toutes les lignes de l'interrogation sur le graphique.

Tracer les lignes	Permet de ne faire figurer que les lignes de données qui se situent dans la plage donnée.


Propriétés de catégorie

Colonnes d'interrogation

Permet d'afficher les colonnes de l'interrogation qui peuvent être utilisées comme catégories du graphique.

Catégories de graphique

Permet d'afficher les colonnes qui seront tracées sous la forme de catégories du graphique.

Sous-catégorie

Permet d'indiquer la colonne d'interrogation qui sera utilisée comme sous-catégorie dans un graphique ventilé.

Insérer

Permet d'ajouter la colonne sélectionnée à la liste de catégories.

Supprimer

Permet de supprimer la colonne sélectionnée de la liste de catégories.

Sommet

Permet de faire passer la colonne sélectionnée au début de la liste de catégories pour qu'elle soit tracée en premier.

Base

Permet de faire passer la colonne sélectionnée à la fin de la liste des catégories pour qu'elle soit tracée en dernier.

Haut

Permet de décaler la colonne sélectionnée d'une position vers le haut dans la liste des catégories pour qu'elle soit tracée plus tôt.

Bas

Décale la colonne sélectionnée d'une position vers le bas dans la liste des catégories pour qu'elle soit tracée plus tard.


Propriétés de valeurs

Colonnes d'interrogation

Permet d'afficher les colonnes de l'interrogation qui peuvent être utilisées comme valeurs du graphique.

Valeurs de graphique

(Type de correspondance générale) Permet d'afficher les colonnes qui sont tracées sous la forme de valeurs de graphique.

Modèle de champ

(Type de correspondance générale) Permet d'indiquer le modèle de champ qui sera utilisé pour déterminer la présentation de la colonne sélectionnée.

Début

(Type de correspondance Gantt) Permet d'indiquer la colonne dont les données seront tracées sous la forme de valeurs de début.

Fin

(Type de correspondance Gantt) Permet d'indiquer la colonne dont les données seront tracées sous la forme de valeurs de fin.

Max

(Type de correspondance Max-Min) Permet d'indiquer la colonne dont les données seront tracées sous la forme de valeur maximum.

Valeur de clôture

(Type de correspondance Max-Min) Permet d'indiquer la colonne dont les données seront tracées sous la forme de valeur de clôture.

Min

(Type de correspondance Max-Min) Permet d'indiquer la colonne dont les données seront tracées sous la forme de valeur minimum.


Propriétés PL/SQL

Procédure

Permet d'indiquer le nom de la procédure bouton PL/SQL associée au graphique. Cette procédure est exécutée lors de la détection d'un "événement de souris" concernant le graphique. Seules les procédures qui ont un en-tête de procédure déclencheur sur bouton valide apparaissent dans cette liste.

Types d'événement

Permet d'indiquer les "événements de souris" qui appellent la procédure bouton indiquée.

Bouton souris enfoncé	La procédure sera appelée lorsque vous enfoncerez le bouton de la souris.

Bouton souris relâché	La procédure sera appelée lorsque le bouton de la souris sera relâché.

Mouvement souris bouton enfoncé	La procédure est appelée lorsque l'utilisateur déplace la souris tout en maintenant le bouton enfoncé.


Propriétés d'affichage

Permet de définir les déclencheurs d'ouverture et de fermeture d'affichage, ainsi que de modifier le format de date de paramètre.

Déclencheur d'ouverture

Permet d'indiquer le nom de la procédure PL/SQL qui est exécutée lorsque l'affichage est ouvert pour la première fois à l'exécution. Seules les procédures qui ont un en-tête de procédure déclencheur d'ouverture valide apparaissent dans cette liste.

Nouveau

Permet de créer un nouveau déclencheur d'ouverture d'affichage.

Déclencheur de fermeture

Permet d'indiquer le nom de la procédure PL/SQL qui est exécutée lorsque l'affichage est fermé pour la première fois à l'exécution. Seules les procédures qui ont un en-tête de procédure déclencheur de fermeture valide apparaissent dans cette liste.

Nouveau

Permet de créer un nouveau déclencheur de fermeture d'affichage.

Format de date paramètre

Permet d'indiquer le masque de format de date utilisé pour reconnaître les valeurs valides associées aux paramètres de type DATE.

Liste

Permet d'afficher les masques de format de date disponibles et d'en ajouter ou d'en supprimer. La sélection du bouton affiche la boîte de dialogue Format de date.

Orientation

Permet de déterminer l'orientation par défaut du texte, des flèches, etc. pour le support NLS bidirectionnel. Choisissez Gauche-droite, Droite-gauche ou Défaut (déterminé par la langue en cours).


Propriétés de modèle de champ

propriétés de champ

Nom du modèle de champ et schéma de rotation des couleurs et des motifs.

propriétés de champ d'axe

Type de tracé, style de ligne, orientation des étiquettes, ajustement de courbes et autres paramètres.


Propriétés de champ

Nom

Nom du modèle de champ.

Rotation de couleurs

Permet d'indiquer si Graphics Builder déclenche automatiquement la rotation de la palette de couleurs ou de motifs pour sélectionner une teinte particulière pour chaque champ utilisant ce modèle de champ. Sinon, tous les champs qui utilisent ce modèle de champ ont la même teinte.


Propriétés de champ d'axe

Type de tracé

Permet d'indiquer les éléments utilisés pour tracer ce champ sur le graphique.

Barre	Permet d'indiquer que les différentes valeurs de données du champ sont tracées sous la forme d'une barre reliant la ligne de base à sa valeur le long de l'axe de valeurs.

Ligne	Permet d'indiquer que les différentes valeurs de données du champ sont tracées sous la forme d'une ligne reliant les valeurs de chaque catégorie.

Remplissage Permet d'indiquer que les différentes valeurs de données du champ sont tracées sous la forme d'une zone remplie, délimitée par la ligne de base, les bords du graphique et une ligne reliant les valeurs des différentes catégories.

Symbole	Permet d'indiquer que les différentes valeurs de données du champ sont représentées par un symbole apparaissant à son point de données. Pour choisir un symbole personnalisé, sélectionnez l'un des symboles des modèles et choisissez-en un dans la palette de symboles.

Pointe	Permet d'indiquer que les différentes valeurs de données du champ sont représentées sous la forme d'une droite reliant la ligne de base au point de données.

Etiquette	Permet d'indiquer que les différentes valeurs de données du champ sont représentées sous la forme d'une étiquette de texte contenant sa valeur.

Style de ligne

Permet d'indiquer le style de ligne utilisé pour relier les points de données d'un champ par un tracé de type ligne.

Orientations d'étiquette

Permet d'indiquer l'angle de rotation des étiquettes d'un champ ayant un tracé de type étiquette.

Axe de référence

Permet d'indiquer l'axe auquel les valeurs de données sont comparées pour déterminer le mode de tracé du champ.

Type d'ajustement de courbe

Permet d'indiquer si un ajustement de courbe est appliqué au graphique et, dans l'affirmative, l'algorithme à utiliser. Graphics Builder calcule la courbe en utilisant la méthode d'approximation des moindres carrés. En d'autres termes, Graphics Builder tente de trouver les valeurs a et b des équations ci-dessous de sorte que la somme des carrés des différences entre les valeurs de la courbe et les valeurs de données réelles soit aussi faible que possible. La courbe de chaque type d'ajustement est définie de la manière suivante :

linéaire	Permet d'indiquer que la courbe est définie par l'équation :

y = ax + b.

logarithmique	Permet d'indiquer que la courbe est définie par l'équation :

y = a(log x) + b.

exponentiel	Permet d'indiquer que la courbe est définie par l'équation :

(log y) = ax + b.

puissance	Permet d'indiquer que la courbe est définie par l'équation :

(log y) = a(log x) + b.

Méthode de tracé

Permet d'indiquer pour chaque catégorie la relation entre les valeurs de données de plusieurs champs.

Normale	Permet d'indiquer que les valeurs de données de plusieurs champs sont tracées normalement, et avec répartition égale de la place disponible pour tracer les données de la catégorie.

Suivant champ

précédent	Permet d'indiquer que les valeurs de données des différents champs sont empilées les unes sur les autres, le tracé de chaque élément de graphique (barre, ligne, etc.) commençant au point final du précédent et se poursuivant jusqu'au nouveau point de données.

Pile	Permet d'indiquer que les valeurs de données des différents champs sont empilées les unes sur les autres et partagent l'espace disponible pour le tracé des données de la catégorie. La position de chaque point de données est déterminé par ajout de sa valeur à la précédente.

Chevauchement

Permet d'indiquer le pourcentage de chevauchement des différentes barres représentant des valeurs de données de plusieurs champs dans un graphique à barres ou à colonnes.


Propriétés de cadre

propriétés de cadre

Profondeur, ombre et paramères de légende.

propriétés de cadre d'axe

Ligne de base, largeur de catégorie et paramètres de second axe Y.

propriétés de cadre secteurs

Représentation des secteurs, étiquettes, définition des "autres" secteurs et autres paramètres.

propriétés de cadre de tableau

Etiquette, grille, nombre de lignes et de colonnes et autres paramères.


Propriétés de cadre

Profondeur

Permet d'indiquer la profondeur à laquelle le cadre et les éléments du graphique sont dessinés pour apparaître sous la forme d'un objet en trois dimensions.

Taille de l'ombre

Permet d'indiquer la taille de l'ombre du cadre et des éléments du graphique.

Direction de l'ombre

Permet d'indiquer la direction de l'ombre du cadre et des éléments du graphique.

Afficher le cadre du graphique

Permet d'indiquer si le rectangle entourant le graphique doit être affiché (cette option ne s'applique pas aux graphiques à secteurs).

Afficher la légende

Permet d'indiquer si la légende du graphique doit être affichée (cette option ne s'applique pas aux graphiques de type tableau).

Nombre de colonnes de la légende

Permet d'indiquer le nombre de colonnes utilisées pour afficher les étiquettes qui apparaissent dans la légende. Si cette valeur est supérieure ou égale au nombre d'étiquettes existantes, chaque étiquette apparaît dans une colonne séparée.


Propriétés de cadre d'axe

Valeur ligne de base

Permet d'indiquer la valeur utilisée comme point de départ du tracé des champs le long de l'axe des valeurs. Les valeurs supérieures à celles de la ligne de base sont tracées au-dessus de celle-ci. Les valeurs inférieures à celles de la ligne de base sont tracées en dessous.

Minimum	Permet d'indiquer que la ligne de base est la valeur minimum de l'axe.

Maximum	Permet d'indiquer que la ligne de base est la valeur maximum de l'axe.

Zéro	Permet d'indiquer que la ligne de base a la valeur 0.

Personnalisé	Permet d'indiquer que la valeur entrée dans le champ associé est utilisée comme ligne de base.

Référence ligne de base

Permet d'indiquer l'axe auquel la valeur de la ligne de base est comparée pour déterminer sa position.

Largeur catégorie

Permet d'indiquer, sous la forme d'un pourcentage de la "largeur de bande", la largeur des barres d'un graphique à barres ou à colonnes. La largeur de bande est la largeur maximum que peuvent avoir les barres sans se chevaucher. Elle s'obtient en divisant la longueur de l'axe de catégorie par le nombre de barres à tracer.

Pour espacer les barres, donnez au paramètre de largeur de catégorie une valeur inférieure à 100 %.

Afficher le second axe Y

Permet d'indiquer si le graphique doit comporter un second axe Y.


Propriétés de cadre secteurs

Représentation des secteurs

Permet d'indiquer la relation entre les différents secteurs et l'ensemble du graphique.

Valeur totale	Permet d'indiquer que chaque secteur est tracé comme si sa valeur de données était un pourcentage de la valeur totale indiquée ici.

Pourcentage	Permet d'indiquer que la somme des valeurs de données existantes représente le pourcentage indiqué de la valeur totale du graphique et que les différents secteurs sont tracés en conséquence.

Ordre de tracé

Permet d'indiquer le sens dans lequel les valeurs de données sont tracées. Le premier secteur apparaît toujours en haut du graphique. Les suivants apparaissent dans l'ordre indiqué ici.

Etiquettes de catégorie

Permet d'indiquer si une étiquette de secteur porte le nom de la catégorie qu'il représente.

Valeurs des données

Permet d'indiquer si une étiquette de secteur indique sa valeur de date.

Pourcentages

Permet d'indiquer si une étiquette de secteur indique le pourcentage de la totalité du graphique qu'il représente.

Graduation

Permet d'indiquer si les graduations qui relient chaque secteur à son étiquette sont affichées.

Secteurs inférieurs à % comme "Autre"

Permet d'indiquer que les différents secteurs qui représentent chacun des pourcentages inférieurs à la valeur indiquée ici sont regroupés en un secteur unique dont l'étiquette porte la mention 'Autre'.

Empêcher chevauchement d'étiquettes

Vous permet d'indiquer que les étiquettes des secteurs ne doivent pas se chevaucher. Si elles sont trop longues, vous aurez peut-être intérêt à les séparer du graphique. Dans ce cas, vous pourrez désactiver cette option.


Propriétés de cadre de tableau

Orientation du tableau

Permet d'indiquer si les lignes de données sont affichées horizontalement ou verticalement.

Nombre minimum de lignes

Permet d'indiquer le nombre minimum de lignes du graphique. Si le nombre réel de lignes est inférieur au nombre indiqué ici, le système laisse de la place dans la partie gauche du graphique pour le nombre minimum de lignes indiqué.

Nombre maximum de lignes

Permet d'indiquer le nombre maximum de lignes du graphique. Lorsque le nombre maximum est atteint, les lignes restantes ne sont pas prises en compte.

Noms des colonnes

Permet d'indiquer si les noms de colonne sont affichés dans la première ligne du graphique.

Lignes de grille verticales

Permet d'indiquer si les colonnes séparées par des lignes de grille verticales apparaissent.

Lignes de grille horizontales

Permet d'indiquer si les colonnes séparées par des lignes de grille horizontales apparaissent.

Lignes par intervalle horizontal

Permet d'indiquer le nombre de lignes de données tracées avant que la ligne de grille horizontale soit tracée.


Propriétés de couche

Permet de créer, de supprimer, de masquer, d'afficher, d'activer et de renommer des couches.

Options de boîtes de dialogue

Couches existantes

Permet de visualiser les différentes couches de l'affichage. L'ordre des couches détermine la façon dont leurs objets apparaissent dans la présentation. Les objets d'une couche recouvrent ceux de toutes les couches affichées, situées en dessous d'elles dans la liste.

Nouvelle

Permet de créer une couche vide appelée "couchex" (où x est une valeur numérique).

Supprimer

Permet de supprimer la couche sélectionnée dans la liste. Tous les objets de cette couche sont également supprimés de la liste.

Masquer/afficher

Permet de masquer la couche sélectionnée si elle est affichée ou de l'afficher si elle est masquée. Le signe "+" à côté d'un nom de couche indique qu'elle est affichée et le signe "-" indique qu'elle est masquée. Vous ne pouvez pas masquer la couche active.

Activer

Permet d'activer la couche sélectionnée. Si elle est masquée, elle est automatiquement affichée. Pour désactiver une couche, activez-en une autre.

Haut/Bas/Sommet/Base

Permet de déplacer la couche sélectionnée d'une position vers le haut ou vers le bas de la liste ou de la faire passer en début ou en fin de liste. L'ordre des couches dans la liste détermine la manière dont leurs objets apparaissent dans la présentation. Les objets de chaque couche recouvrent ceux de toutes les couches affichées au-dessous dans la liste.

Couche active

Permet d'afficher le nom de la couche active. Il ne peut y avoir qu'une couche active à la fois.

Renommer

Permet d'indiquer le nouveau nom de la couche sélectionnée. Sélectionnez Renommer pour lui attribuer ce nom.

Renommer

Permet de donner à la couche sélectionnée le nom indiqué dans le champ Renommer.


Propriétés d'objet

propriétés d'objet

Nom, procédure bouton, événement de souris et déclencheur de format.

propriétés de hiérarchisation vers le bas

Propriétés de hiérarchisation vers le bas.


Propriétés d'objet

Nom

Nom de l'objet. Vous devez utiliser le nom de l'objet pour y faire référence dans vos unités de programme PL/SQL. Si vous n'avez pas l'intention de faire référence à l'objet dans votre programme, le nom n'est pas nécessaire.

Procédure

Nom de la procédure bouton PL/SQL associée à l'objet. Cette procédure est exécutée lors de la détection d'un "événement de souris" concernant l'objet détecté. Seules les procédures qui ont un en-tête de procédure déclencheur bouton valide apparaissent dans cette liste.

Types d'événement

Permet d'indiquer les "événements de souris" qui appellent la procédure bouton indiquée.

Bouton souris enfoncé	La procédure sera appelée lorsque vous enfoncerez le bouton de la souris.

Bouton souris relâché	La procédure sera appelée lorsque le bouton de la souris sera relâché.

Mouvement souris bouton enfoncé	La procédure est appelée lorsque l'utilisateur déplace la souris tout en maintenant le bouton enfoncé.

Mouvement souris bouton relâché	(couches uniquement) La procédure est appelée lorsque l'utilisateur déplace la souris sans maintenir le bouton enfoncé.

Déclencheur de format

Nom de la procédure du déclencheur de format de graphique associée à cet objet. Seules les procédures qui ont un en-tête de procédure de déclencheur de format valide apparaissent dans cette liste. Remarque : cette propriété ne s'applique que si l'objet est un élément de graphique.


Propriétés de hiérarchisation vers le bas

Définir paramètres

Permet d'indiquer le paramètre dont vous définissez la valeur lorsque vous sélectionnez l'objet.

Nouveau

Permet de créer un nouveau paramètre et affiche la page de propriétés de paramètre.

A la valeur de

Permet d'indiquer la valeur donnée au paramètre lorsque vous sélectionnez l'objet.

Si l'objet est un élément de graphique, vous pouvez sélectionner une colonne de l'interrogation du graphique. Le paramètre reçoit alors la valeur de date qui apparaît dans la colonne indiquée pour la ligne de l'interrogation en cours.

Si la ligne n'est pas un élément de graphique, la seule option possible consiste à donner au paramètre le nom de l'objet.

Exécuter interrogation

Permet d'indiquer l'interrogation à exécuter lorsque vous sélectionnez l'objet. Si vous indiquez également qu'un paramètre est défini, la définition du paramètre précède l'exécution de l'interrogation.

Nouveau

Permet de créer une nouvelle interrogation et d'afficher la page de propriétés d'interrogation.


Propriétés de paramètre

Paramètre

Sélectionnez le paramètre à modifier. Tous les paramètres qui existent dans l'affichage apparaissent dans cette liste.

Nom

Nom du paramètre.

Type

Type de données du paramètre.

Valeur initiale

Valeur initiale du paramètre lorsque vous exécutez l'affichage pour la première fois. La valeur entrée ici peut être remplacée par une valeur indiquée dans la ligne de commande et vous pouvez la modifier lors de l'exécution.

Une valeur de paramètre ne peut compter plus de 2 000 octets.


Propriétés d'interrogation

propriétés d'interrogation

Nom, source de données et instruction SQL (si nécessaire) d'une interrogation.

propriétés de données (interrogation)

Données retournées par l'interrogation.

propriétés d'option

Propriétés d'exécution et de cache de données, de déclencheurs et autres propriétés.

propriétés de schéma (custom queries only)

Permet de créer, de supprimer et de définir le nom et le type de données des colonnes personnalisées.


Propriétés d'interrogation

Interrogation

Sélectionnez l'interrogation à modifier. Toutes les interrogations qui existent dans l'affichage apparaissent dans cette liste.

Nom

Nom de l'interrogation.

Type

Type d'interrogation. Sélectionnez l'une des options suivantes :

Instruction SQL	Permet d'indiquer que l'interrogation extrait ses données d'une base de données, en fonction de l'instruction SQL SELECT que vous fournissez. Entrez l'instruction SQL dans le champ Instruction SQL.

Fichier SYLK	Permet d'indiquer que l'interrogation extrait ses données d'un fichier en format SYLK. SYLK est un format utilisé par différentes applications classiques, comme Microsoft Excel. Lorsque vous exécutez l'interrogation, les données sont extraites du fichier. Indiquez le fichier à utiliser dans le champ Fichier.

Fichier WKS	Permet d'indiquer que l'interrogation extrait ses données d'un fichier en format WKS. WKS est un format utilisé par différentes applications classiques, comme Lotus 1-2-3. Lorsque vous exécutez l'interrogation, les données sont extraites du fichier. Indiquez le fichier à utiliser dans le champ Fichier.

Fichier PRN	Permet d'indiquer que l'interrogation extrait ses données d'un fichier en format PRN. PRN est un format de fichier texte. Lorsque vous exécutez l'interrogation, les données sont extraites du fichier. Indiquez le fichier à utiliser dans le champ Fichier.

Personnaliser	Vous permet de personnaliser les colonnes et les données de l'interrogation. Pour définir les colonnes, utilisez les contrôles de la Page de propriétés de schéma. Pour définir les données, utilisez la procédure interne OG_APPEND_ROW.

Fichier SQL externe	Permet d'indiquer que l'interrogation extrait ses donnés d'un fichier texte qui contient une instruction SQL SELECT. Lorsque vous exécutez l'interrogation, l'instruction SQL est extraite du fichier et exécutée. Indiquez le fichier à utiliser dans le champ Fichier.

Fichier

Permet d'afficher l'emplacement et le nom du fichier à utiliser pour une interrogation SQL externe, SYLK, WKS ou PRN. Pour localiser le fichier dans votre système de fichiers, sélectionnez le bouton Parcourir.

Parcourir

Permet de localiser et de sélectionner le nom de fichier qui doit apparaître dans le champ Fichier.

Instruction SQL

Permet d'indiquer l'instruction SQL SELECT qui est exécutée pour une interrogation Instruction SQL.

Connecter

Permet d'afficher la boîte de dialogue Connexion, qui vous permet de vous connecter à une base de données.

Importer SQL

Permet d'entrer le contenu d'un fichier texte dans le champ Instruction SQL. Notez que le texte est copié, et non pas lié au fichier. Pour créer un lien à un texte SQL dans un fichier, utilisez un type d'interrogation de Fichier SQL externe.

Exporter SQL

Permet d'entrer le contenu du champ Instruction SQL dans un fichier.

Nouvelle

Permet de créer une nouvelle interrogation.

Supprimer

Permet de supprimer l'interrogation en cours.

Exécuter

Permet d'exécuter l'interrogation en cours. Si l'interrogation est une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation extrait les données d'un fichier, le fichier est lu. Si l'interrogation est une interrogation personnalisée, sa procédure d'interrogation personnalisée est exécutée.

Eff. données

Permet d'effacer du cache de données toutes les données extraites. L'interrogation elle-même n'est ni supprimée ni modifiée.


Propriétés de données (interrogation)

Interrogation

Sélectionnez l'interrogation à modifier. Toutes les interrogations qui existent dans l'affichage apparaissent dans cette liste.

Nouvelle

Permet de créer une nouvelle interrogation.

Supprimer

Permet de supprimer l'interrogation en cours.

Exécuter

Permet d'exécuter l'interrogation en cours. Si l'interrogation est une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation extrait les données d'un fichier, le fichier est lu. Si l'interrogation est une interrogation personnalisée, sa procédure d'interrogation personnalisée est exécutée.

Eff. données

Permet d'effacer du cache des données toutes les données extraites. L'interrogation elle-même n'est ni supprimée ni modifiée.


Propriétés d'option

Interrogation

Sélectionnez l'interrogation à modifier. Toutes les interrogations qui existent dans l'affichage apparaissent dans cette liste.

Exécuter sur

Permet d'indiquer le moment auquel l'interrogation est automatiquement exécutée. Sélectionez l'une des options suivantes :

Affichage à l'ouverture	Permet d'exécuter l'interrogation lorsque l'affichage est ouvert pour la première fois lors de l'exécution.

Horloge	Permet d'exécuter l'interrogation à la fréquence déterminée par une horloge. Sélectionnez une horloge dans la liste déroulante ou le bouton Nouvelle pour créer une nouvelle horloge.

Données

Permet de définir différentes options relatives aux données de l'interrogation.

Nouvelles données	Permet de déterminer la façon dont sont traitées les dernières données extraites d'une interrogation.

Remplace les anciennes données signifie qu'aucune des données provenant de la précédente exécution n'est prise en compte et que les données récemment extraites les remplacent.

S'ajoute aux anciennes données signifie que toutes les lignes de données existantes sont conservées et que les nouvelles sont ajoutées au bas de l'ensemble de données existant.

Enregistrer les anciennes

données	Permet d'indiquer si les données préalablement extraites sont stockées dans un tampon spécial lorsqu'elles sont remplacées par les nouvelles données. Vous pouvez alors accéder à ce tampon d'"anciennes données" en utilisant des routines intégrées comme OG_GET_NUMCELL. Cette propriété n'est valide que lorsque le paramètre Nouvelles données remplace les anciennes données.

Nombre maximum de lignes	Permet d'indiquer le nombre maximum de lignes de données qui sont conservées dans l'ensemble de données de l'interrogation. Si l'ajout de données entraîne un dépassement du nombre maximum de lignes, les lignes excédentaires ne sont pas prises en compte à partir du début de l'ensemble de données. Cette propriété n'est valide que lorsque le paramètre Nouvelles données est S'ajoute aux anciennes données. De plus, l'attribut maxflag pour l'interrogation doit être défini TRUE (valeur par défaut). Pour plus d'informations sur la définition de maxflag, reportez-vous à Propriété Indicateur du nombre maximum de lignes.

Format de date 	Permet d'indiquer le format utilisé pour reconnaître les données de date d'un fichier et de déterminer la manière dont les dates apparaissent dans la Page de propriétés de données. Si les données du fichier sont dans un format autre que celui indiqué dans cette boîte de dialogue, Graphics Builder ne les considère pas comme des dates.

PL/SQL

Permet d'indiquer différentes options relatives à l'utilisation de PL/SQL par l'interrogation.

Procédure d'exécution personnalisée (Interrogation personnalisée uniquement.) Permet d'indiquer la procédure PL/SQL qui est appelée lorsqu'une Interrogation personnalisée est exécutée. En général, cette procédure contient des instructions PL/SQL qui remplissent l'interrogation de données. Seules les procédures qui ont un en-tête de procédure déclencheur d'interrogation personnalisée valide apparaissent dans cette liste.

Sélectionnez Nouvelle pour créer une nouvelle procédure d'interrogation personnalisée.

Déclencheur post-exécution	Procédure PL/SQL appelée lorsque l'interrogation a été exécutée. Seules les procédures qui ont un en-tête de procédure déclencheur de post-interrogation valide apparaissent dans cette liste.

Sélectionnez Nouvelle pour créer une procédure de post-exécution.

Nouvelle

Permet de créer une nouvelle interrogation.

Supprimer

Permet de supprimer l'interrogation en cours

Exécuter

Permet d'exécuter l'interrogation en cours. S'il s'agit d'une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation extrait des données d'un fichier, le fichier est lu. Si l'interrogation est personnalisée, sa procédure d'interrogation personnalisée est exécutée.

Eff. données

Permet d'effacer du cache de données toutes les données extraites. L'interrogation elle-même n'est ni supprimée ni modifiée.


Propriétés de schéma

Ces propriétés ne concernent que les interrogations personnalisées.

Interrogation

Sélectionnez l'interrogation à modifier. Toutes les interrogations qui existent dansl'affichage apparaissent dans cette liste.

Colonne

Sélectionnez la colonne à modifier. Toutes les colonnes qui ont été définies pour cette interrogation apparaissent dans cette liste.

Nom

Nom de la colonne. Pour le modifier, entrez un nouveau nom et sélectionnez Appliquer.

Type

Type de données de la colonne.

Longueur maximum

Longueur maximum des données contenues dans la colonne. Cette option ne s'applique qu'aux colonnes de type CHAR.

Nouvelle colonne

Permet d'ajouter une nouvelle colonne à l'interrogation.

Supprimer colonne

Permet de supprimer de l'interrogation la colonne en cours.

Nouvelle

Permet de créer une nouvelle interrogation.

Supprimer

Permet de supprimer l'interrogation en cours.

Exécuter

Permet d'exécuter l'interrogation en cours. S'il s'agit d'une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation est extraite des données d'un fichier, le fichier est lu. Si l'interrogation est personnalisée, sa procédure d'interrogation personnalisée est exécutée.

Eff. données

Permet d'effacer du cache de données toutes les données extraites. L'interrogation elle-même n'est ni supprimée ni modifiée.


Propriétés de ligne de référence

Permet de modifier les propriétés des lignes de référence du modèle affiché dans l'éditeur de modèle de graphique.

Ligne de référence

Sélectionnez la ligne de référence à modifier. Toutes les lignes de référence qui existent dans le modèle en cours apparaissent dans la liste.

Légende

Permet d'indiquer le texte qui identifie la ligne de référence dans la légende.

Valeur

Permet d'indiquer la valeur de référence à laquelle la ligne de référence apparaît.

Axe de référence

Permet d'indiquer à quel axe la valeur de référence est comparée pour déterminer sa position.

Nouvelle

Permet de créer une nouvelle ligne de référence pour le modèle en cours.

Supprimer

Permet de supprimer la ligne de référence du modèle en cours.


Propriétés d'horloge

Permet de créer et de supprimer des horloges et d'en indiquer le nom, la procédure déclencheur et l'intervalle de temps.

Options de la fenêtre de propriétés

Horloge

Sélectionnez l'horloge à modifier. Toutes les horloges qui existent dans l'affichage apparaissent dans la liste.

Nouvelle

Permet de créer une nouvelle horloge.

Supprimer

Permet de supprimer l'horloge en cours.

Nom

Nom de l'horloge.

Procédure

Procédure PL/SQL (si elle existe) qui s'exécute lorsque l'horloge est déclenchée. Seules les procédures qui ont un en-tête de procédure déclencheur d'horloge valide apparaissent dans cette liste.

Pour créer une nouvelle procédure d'horloge, sélectionnez Nouvelle.

Intervalle

Intervalle de temps entre deux déclenchements de l'horloge.

Active

Permet d'activer l'horloge.

Nouvelle

Permet de créer une nouvelle horloge.

Supprimer

Permet de supprimer l'horloge en cours.


A propos de la sécurité de fichiers et des restrictions
A propos de la sécurité des fichiers et des restrictions

Graphics Builder utilise l'environnement de votre système d'exploitation pour déterminer la sécurité des modules stockés dans des fichiers. La façon dont vous êtes autorisé à accéder aux modules stockés dans des fichiers dépend du système d'exploitation utilisé. Pour plus d'informations, reportez-vous à la documentation de votre système.


A propos de la sécurité des bases de données et des restrictions

Vous pouvez imposer aux utilisateurs de Graphics Builder deux types de restrictions :

contrôle d'accès à Graphics Builder

contrôle d'accès aux modules des autres utilisateurs

La fonction de sécurité de Graphics Builder fait appel aux commandes GRANT et REVOKE d'Oracle qui permettent d'exercer un contrôle supplémentaire. Toutes les restrictions imposées par GRANT et REVOKE restent valables.


Contrôle d''accès à Graphics Builder
Contrôle d'accès à Graphics Builder

Pour contrôler l'accès à Graphics Builder :

 Un utilisateur ne peut accéder à Graphics Builder que s'il est autorisé à accéder aux tables de Graphics Builder en exécutant le script d'installation approprié. Pour interdire à un utilisateur d'accéder à Graphics Builder, vous devez le faire manuellement.


Contrôle d'accès des autres utilisateurs à vos modules

Pour contrôler l'accès des autres utilisateurs à vos modules :

1	Choisissez un type de module en sélectionnant Fichier [image] Administration [image], dans le menu Accès de l'éditeur de présentation pour afficher la boîte de dialogue Accès au module de la base.

2	Sélectionnez un nom de module.

3	Sélectionnez OK pour afficher la boîte de dialogue Accès au module de la base.

4	Entrez un nom utilisateur (ou PUBLIC) dans le champ Utilisateur. Si vous entrez PUBLIC, tous les utilisateurs qui ont été autorisés à accéder aux tables appartenant au système auront accès au module.


A propos du stockage des tables de la base de données
A propos du stockage des tables de base de données

Graphics Builder utilise trois types de tables :

•	Tables de démonstration	qui contiennent des données d'exemples utilisés dans les démonstrations.

•	Tables de données	qui contiennent vos propres données.

•	Tables Graphics Builder	qui contiennent les modules Graphics Builder.

Tables de Graphics Builder

Lorsque vous stockez un module Graphics Builder (affichage, dessin, modèle de graphique, palette de couleurs, son, image) dans une base de données, celui-ci est stocké dans les tables Graphics Builder. Ces tables sont de deux types :

Tables propres à Graphics Builder : Les tables propres à Graphics Builder contiennent des définitions de modules et d'autres affichages. Elles ne sont utilisées que par Graphics Builder et ne sont pas communes à d'autres produits Oracle. L'utilisation de vues et de synonymes publics permet aux utilisateurs de visualiser des informations sur les modules qui leur appartiennent ou auxquels ils ont été autorisés à accéder.

Tables de produits Oracle partagées : Les tables de produits Oracle partagées contiennent des définitions de modules et peuvent être communes à d'autres produits Oracle.

Attention : Oracle Corporation ne garantit ni les fonctionnalités ni l'intégrité des modules dont les définitions de tables ont été modifiées via SQL*Plus ou un autre outil de base de données qui n'aurait pas été conçu spécifiquement pour modifier les tables de Graphics Builder. Notez également qu'Oracle Corporation se réserve le droit de modifier les noms ou les structures de ses tables à tout moment et sans préavis.


A propos des règles de stockage dans la base de données

Les tables de produits Oracle partagées occupent, lorsqu'elles sont vides, environ 255 blocs dans la base de données (ou 460 Ko). Les tables propres à Graphics Builder demandent, lorsqu'elles sont vides, 130 blocs de base de données (ou 260 Ko) de plus. Si plusieurs utilisateurs partagent une même série de tables, il suffit au départ de 385 blocs par installation. En revanche, si chaque utilisateur doit posséder sa propre série de tables, prévoyez 385 blocs par utilisateur.

La mémoire occupée par ces tables augmente avec la définition des modules. La mémoire réelle occupée par chaque module peut varier dans des proportions considérables. Pour les affichages, elle dépend du nombre d'objets, du nombre d'interrogations, de la taille des unités de programmes PL/SQL, etc.


A propos des tables propres à Graphics Builder

Les tables propres à Graphics Builder contiennent des définitions de modules et d'autres affichages. Elles sont utilisées exclusivement par Graphics Builder et ne sont pas communes à d'autres produits Oracle. L'utilisation de vues et de synonymes publics permet aux utilisateurs de visualiser des informations sur les modules qui leur appartiennent ou auxquels ils ont été autorisés à accéder.


Tables propres à Graphics Builder

GC_CHARTING

GC_FIELD

GC_REFERENCE

GO_DOCUMENT

GO_PARAMETER

GO_QUERY

GO_SOUND

GO_TIMER

VG_COLOR

VG_FONT

VG_IMAGE


GC_CHARTING

Nom 	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEMID	INTEGER	ID instance
CHARTNAME	RAW(255)	Nom graphique
CHARTNAME_LEN	INTEGER	Longueur du nom de graphique
CHARTNAME_CS	INTEGER	Jeu car. nom de graphique
CHART_TYPE	INTEGER	Type de graphique
CHART_VIS	INTEGER	Indicateur visibilité de graphique
DEPTH_SIZE	INTEGER	Profondeur (0 => 20)
SHADOW_SIZE	INTEGER	Taille ombre (0 => pas d'ombre)
SHADOW_DIR	INTEGER	Direction ombre
BASELN_FLG	INTEGER	Indicateur définition ligne de base
BASELN_DAT	DATE	Valeur date ligne de base
BASELN_VAL	FLOAT	Valeur ligne de base
CATEGORY_WD	FLOAT	Largeur totale catégorie (% largeur graduation)
BASELN_AXIS	INTEGER	Axe référence ligne de base (y1 ou y2)
X1_AXIS_TYPE	INTEGER	Type données axe : date cont ou discr
X1_AXIS_DEP	INTEGER	Etat dépendance axe : true si dép.
X1_SCALE_FNC	INTEGER	Fonction échelle : % journal linéaire
X1_AXIS_POS	INTEGER	Position axe : haut/bas/gauche/droite
X1_GRID_VIS	INTEGER	Masque visibilité graduation/grille principale/secondaire
X1_AXIS_STEP	INTEGER	Indicateur bit min/max/pas défini par l'utilisateur
X1_NUM_STRIP	INTEGER	Nombre graduations sur axe discret
X1_CONT_AX_MN	FLOAT	Min. axe continu
X1_CONT_AX_MX	FLOAT	Max. axe continu
X1_CONT_AX_ST	FLOAT	Pas axe continu
X1_DATE_AX_MN	DATE	Min. axe date
X1_DATE_AX_MX	DATE	Max. axe date
X1_DATE_AX_ST	INTEGER	Pas axe date
X1_AX_LBL_HS	INTEGER	Indicateur masq./affich. étiquette axe
X1_TIC_TYPE	INTEGER	Type graduation (centrée, gauche, droite)
X1_MINOR_TIC	INTEGER	Nombre graduations/grilles secondaires 0 .. 9
X1_NUM_FORMAT	RAW(255)	Chaîne format numérique pour étiquettes graduation
X1_NUM_FORMAT_CS	INTEGER	Jeu car. format numérique pour étiquettes graduation
X1_NUM_FORMAT_LEN	INTEGER	Long. car. Format numérique pour étiquettes graduation
X1_DAT_FORMAT	RAW(255)	Chaîne format date pour étiquettes graduation
X1_DAT_FORMAT_CS	INTEGER	Jeu car. format date pour étiquettes de graduations
X1_DAT_FORMAT_LEN	INTEGER	Long. car. Format date pour étiquettes de graduations
X1_TIC_ROT	INTEGER	Orientation étiquettes de graduation (rotation)
X1_TIC_FIX	INTEGER	Indicateur orientation fixe étiquettes graduation
X1_TIC_DT_VIS	INTEGER	Visibilité étiquettes graduation axe date
X1_DATE_ABBR	INTEGER	Indicateurs abrégés date
X1_WKEND_FLG	INTEGER	Indicateur Pas de week-end
X1_START_MNTH	INTEGER	1er mois exercice fiscal (1..2)
X1_PCT_TYP	INTEGER	Type pourcentage (somme, min ou max)
X1_PCT_GRP	INTEGER	Regroupement de pourcentages (colonne ou catégorie)
X2_AXIS_TYPE	INTEGER	Type données axe : date cont ou discr
X2_AXIS_DEP	INTEGER	Etat dépendance axe : true si dép.
X2_SCALE_FNC	INTEGER	Fonction échelle : % journal linéaire
X2_AXIS_POS	INTEGER	Position axe : haut/bas/gauche/droite
X2_GRID_VIS	INTEGER	Masque visibilité graduation/grille principale/secondaire
X2_AXIS_STEP	INTEGER	Indicateur bit min/max/pas défini par l'utilisateur
X2_NUM_STRIP	INTEGER	Nombre graduations sur axe discret
X2_CONT_AX_MN	FLOAT	Min. axe continu
X2_CONT_AX_MX	FLOAT	Max. axe continu
X2_CONT_AX_ST	FLOAT	Pas axe continu
X2_DATE_AX_MN	DATE	Min. axe date
X2_DATE_AX_MX	DATE	Max. axe date
X2_DATE_AX_ST	INTEGER	Pas axe date
X2_AX_LBL_HS	INTEGER	Indicateur masq./affich. étiquette axe
X2_TIC_TYPE	INTEGER	Type graduation (centrée, gauche, droite)
X2_MINOR_TIC	INTEGER	Nombre graduations/grilles principales 0 à 9
X2_NUM_FORMAT	RAW(255)	Chaîne format numérique pour étiquettes graduation
X2_NUM_FORMAT_CS	INTEGER	Jeu car. format numérique pour étiquettes graduation
X2_NUM_FORMAT_LEN	INTEGER	Long. car. Format numérique pour étiquettes graduation
X2_DAT_FORMAT	RAW(255)	Chaîne format date pour étiquettes graduation
X2_DAT_FORMAT_CS	INTEGER	Jeu car. format date pour étiquettes graduation
X2_DAT_FORMAT_LEN	INTEGER	Long. car. format date pour étiquettes graduation
X2_TIC_ROT	INTEGER	Orientation étiquettes graduation (rotation)
X2_TIC_FIX	INTEGER	Indicateur orientation fixe étiquettes graduation
X2_TIC_DT_VIS	INTEGER	Visibilité étiquettes graduation axe date
X2_DATE_ABBR	INTEGER	Indicateurs abrégés date
X2_WKEND_FLG	INTEGER	Indicateur Pas de week-end
X2_START_MNTH	INTEGER	1er mois exercice fiscal (1..2)
X2_PCT_TYP	INTEGER	Type pourcentage (somme, min ou max)
X2_PCT_GRP	INTEGER	Regroupement de pourcentages (colonne ou catégorie)
X3_AXIS_TYPE	INTEGER	Type données axe: date cont ou discr
X3_AXIS_DEP	INTEGER	Etat dépendance axe: true si dép.
X3_SCALE_FNC	INTEGER	Fonction échelle : % journal linéaire
X3_AXIS_POS	INTEGER	Position axe : haut/bas/gauche/droite
X3_GRID_VIS	INTEGER	Masque visibilité graduation/grille principale/secondaire
X3_AXIS_STEP	INTEGER	Indicateur bit min/max/pas défini par l'utilisateur
X3_NUM_STRIP	INTEGER	Nombre graduations sur axe discret
X3_CONT_AX_MN	FLOAT	Min. axe continu
X3_CONT_AX_MX	FLOAT	Max. axe continu
X3_CONT_AX_ST	FLOAT	Pas axe continu
X3_DATE_AX_MN	DATE	Min. axe date
X3_DATE_AX_MX	DATE	Max. axe date
X3_DATE_AX_ST	INTEGER	Pas axe date
X3_AX_LBL_HS	INTEGER	Indicateur masq./affich. étiquette axe
X3_TIC_TYPE	INTEGER	Type graduation (centrée, gauche, droite)
X3_MINOR_TIC	INTEGER	Nombre graduations/grilles secondaires 0 .. 9
X3_NUM_FORMAT	RAW(255)	Chaîne format numérique pour étiquettes graduation
X3_NUM_FORMAT_CS	INTEGER	Jeu car. format numérique pour étiquettes graduation
X3_NUM_FORMAT_LEN	INTEGER	Long. car. format numérique pour étiquettes graduation
X3_DAT_FORMAT	RAW(255)	Chaîne format date pour étiquettes graduation
X3_DAT_FORMAT_CS	INTEGER	Jeu car. format date pour étiquettes graduation
X3_DAT_FORMAT_LEN	INTEGER	Long. car. format date pour étiquettes graduation
X3_TIC_ROT	INTEGER	Orientation étiquettes graduation (rotation)
X3_TIC_FIX	INTEGER	Indicateur orientation fixe étiquettes graduation
X3_TIC_DT_VIS	INTEGER	Visibilité étiquettes graduation axe date avec étiquettes
X3_DATE_ABBR	INTEGER	Indicateurs abrégés date
X3_WKEND_FLG	INTEGER	Indicateur Pas de week-end
X3_START_MNTH	INTEGER	1er mois exercice fiscal (1..2)
X3_PCT_TYP	INTEGER	Type pourcentage (somme, min ou max)
X3_PCT_GRP	INTEGER	Regroupement de pourcentages (colonne ou catégorie)
P_CLOCK_FLG	INTEGER	Indicateur Sens horloge
P_SUM_FLG	INTEGER	Indicateur Somme
P_TIC_VIS	INTEGER	Masque bit visibilité graduations/étiquettes
P_FIXED_SUM	FLOAT	Somme définie par l'utilisateur
P_FIXED_PCT	FLOAT	% défini par l'utilisateur
P_CAT_LBL_FMT	RAW(255)	Chaîne format étiquette catégorie
P_CAT_LBL_FMT_CS	INTEGER	Jeu car. format étiquette catégorie
P_CAT_LBL_FMT_LEN	INTEGER	Long. chaîne format étiquette catégorie
P_DAT_LBL_FMT	RAW(255)	Chaîne format étiquette date
P_DAT_LBL_FMT_CS	INTEGER	Jeu car. format étiquette date
P_DAT_LBL_FMT_LEN	INTEGER	Long. chaîne format étiquette date
P_ABS_LBL_FMT	RAW(255)	Chaîne format étiquette absolue
P_ABS_LBL_FMT_CS	INTEGER	Jeu car. format étiquette absolue
P_ABS_LBL_FMT_LEN	INTEGER	Long. chaîne format étiquette absolue
P_PCT_LBL_FMT	RAW(255)	Chaîne format étiquette de %
P_PCT_LBL_FMT_CS	INTEGER	Jeu car. format étiquette de %
P_PCT_LBL_FMT_LEN	INTEGER	Long. chaîne format étiquette de %
T_MAX_ROW	INTEGER	Nbre max. de lignes
T_MAX_ROW_FIX	INTEGER	Indicateur max. lignes définies
T_GRID_VIS	INTEGER	Indicateurs visibilité grille
T_TABLE_DIR	INTEGER	Orientation table
T_ROW_PERGRID	INTEGER	Lignes par intervalle horizontal
L_NUM_COL	INTEGER	Légende : nombre de colonnes
L_SHADOW_SIZE	INTEGER	Légende : taille ombre (0 => pas d'ombre)


GC_FIELD

Nom 	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEMID	INTEGER	ID instance
TEMPLATE_SEQ	INTEGER	N° ordre (séquence) modèle champ
FIELDNAME	RAW(255)	Nom modèle champ
FIELDNAME_LEN	INTEGER	Longueur nom modèle champ
FIELDNAME_CS	INTEGER	Jeu caractères nom modèle champ
PLOT_DEF	INTEGER	Masque bit définition tracé
CONNECT_TYPE	INTEGER	Type connecteur
PLOT_EXT	INTEGER	Etendue tracé
REGRESS_TST	INTEGER	Type régression
ROT_COL_FLAG	INTEGER	Indicateur rotation couleurs/motifs
LABEL_ROT_ANG	INTEGER	Angle rotation étiquette
BAR_OVERLAP	FLOAT	Chevauchement barre (fract. larg. barre)
NUM_FORMAT	RAW(255)	Chaîne format num. pour texte/annotation
NUM_FORMAT_CS	INTEGER	Jeu car. format num. pour texte/annotation
NUM_FORMAT_LEN	INTEGER	Long. format num. pour texte/annotation
DAT_FORMAT	RAW(255)	Chaîne format date pour texte/annotation
DAT_FORMAT_CS	INTEGER	Jeu car. format date pour texte/annotation
DAT_FORMAT_LEN	INTEGER	Long. format date pour texte/annotation
AXIS_MAPPING	INTEGER	Axe référence


GC_REFERENCE

Nom	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEMID	INTEGER	ID instance
REFLINE_ID	INTEGER	ID ligne référence
REFLINE_MAP	INTEGER	Correspondance ligne référence
CONT_AXIS_VAL	FLOAT	Correspondance valeur axe cont. pour cette ligne
DATE_AXIS_VAL	DATE	Correspondance valeur axe date pour cette ligne
LEG_LBL	RAW(255)	Chaîne légende
LEG_LBL_LEN	INTEGER	Longueur chaîne légende
LEG_LBL_CS	INTEGER	Jeu car. chaîne légende


GO_DOCUMENT

Nom	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
FOREGROUND_EDGE_COLOR	INTEGER	Couleur bord premier plan par défaut
BACKGROUND_EDGE_COLOR	INTEGER	Couleur bord arrière-plan par défaut
EDGE_PATTERN	INTEGER	Motif bord par défaut
FOREGROUND_FILL_COLOR	INTEGER	Couleur remplissage premier plan par défaut
BACKGROUND_FILL_COLOR	INTEGER	Couleur remplissage arrière-plan par défaut
FILL_PATTERN	INTEGER	Motif remplissage par défaut
DASH_STYLE	INTEGER	Type tiret par défaut
ARROW_STYLE	INTEGER	Type flèche par défaut
SYMBOL_SIZE	INTEGER	Taille symbole par défaut
SYMBOL_INDEX	INTEGER	Index symbole par défaut
BRUSH_WIDTH	INTEGER	Largeur ligne par défaut
TRANS_MODE	INTEGER	Mode transfert par défaut
CAP_STYLE	INTEGER	Type extrémité par défaut
JOIN_STYLE	INTEGER	Type jointure par défaut
ARC_FILL_STYLE	INTEGER	Remplissage arc par défaut
ARC_CLOSURE	INTEGER	Fermeture arc par défaut
RRECT_CORNER_WIDTH	INTEGER	Angle rectangle arrondi par défaut
RRECT_CORNER_HEIGHT	INTEGER	Angle rectangle arrondi par défaut
FACE_NAME	RAW(255)	Police caractères par défaut
FACE_NAME_CHAR	INTEGER	Jeu caractères nom police
FACE_NAME_LEN	INTEGER	Longueur nom police
FONT_SIZE	INTEGER	Taille (points) police par défaut
FONT_STYLE	INTEGER	Style police par défaut
FONT_WEIGHT	INTEGER	Epaisseur police par défaut
FONT_WIDTH	INTEGER	Largeur police par défaut
IMAGE_TEXT	INTEGER	Texte image par défaut
KERNING	INTEGER	Paramètre crénage par défaut
CHAR_SET	INTEGER	Jeu de caractères par défaut
TEXT_COLOR	INTEGER	Couleur texte par défaut
TEXT_HOR_ALIGN	INTEGER	Alignement horizontal texte par défaut
TEXT_VER_ALIGN	INTEGER	Alignement vertical texte par défaut
TEXT_HOR_JUSTI	INTEGER	Justification horizontale texte par défaut
TEXT_VER_JUSTI	INTEGER	Justification verticale texte par défaut
TEXT_SPACING	INTEGER	Interlignage texte par défaut
TEXT_FIXED_FLAG	INTEGER	Indicateur texte défini par défaut
TEXT_FONTSC_FLAG	INTEGER	Indicateur police proportionnelle par défaut
TEXT_WRAP_FLAG	INTEGER	Indicateur renvoi à la ligne par défaut
TEXT_BBOX_SCALABILITY	INTEGER	Indicateur champ texte proportionnel par défaut
TEXT_INVISIBILITY	INTEGER	Indicateur texte invisible par défaut
TEXT_CUSTOM_SPACING	INTEGER	Indicateur interlignage personnalisé par défaut
HOR_ALIGN_MODE	INTEGER	Paramètres alignement horizontal par défaut
VER_ALIGN_MODE	INTEGER	Paramètres alignement vertical par défaut
CTR_TRACK_FLAG	INTEGER	Indicateur tracé à partir centre/angle par défaut
DRAW_SIZE_WIDTH_DEN	INTEGER	Dénominateur largeur présentation
DRAW_SIZE_WIDTH_NUM	INTEGER	Numérateur largeur présentation
DRAW_SIZE_HEIGHT_DEN	INTEGER	Dénominateur hauteur présentation
DRAW_SIZE_HEIGHT_NUM	INTEGER	Numérateur hauteur présentation
PAGE_COUNT	INTEGER	Nombre pages par défaut
ACTIVE_LAYER	INTEGER	ID couche active
MAIN_EDITOR_X	INTEGER	Coordonnée X éditeur de présentation
MAIN_EDITOR_Y	INTEGER	Coordonnée Y éditeur de présentation
MAIN_EDITOR_WIDTH	INTEGER	Largeur éditeur de présentation
MAIN_EDITOR_HEIGHT	INTEGER	Hauteur éditeur de présentation
CHART_TEMP_HS	INTEGER	Masquage/affichage éditeur modèle graphique
CHART_TEMP_X	INTEGER	Coordonnée X éditeur modèle graphique
CHART_TEMP_Y	INTEGER	Coordonnée Y éditeur modèle graphique
CHART_TEMP_WIDTH	INTEGER	Largeur éditeur modèle graphique
CHART_TEMP_HEIGHT	INTEGER	Hauteur éditeur modèle graphique
DATATABLE_HS	INTEGER	Masquage/affichage table données
DATATABLE_X	INTEGER	Coordonnée X table données
DATATABLE_Y	INTEGER	Coordonnée Y table données
DATATABLE_WIDTH	INTEGER	Largeur table données
DATATABLE_HEIGHT	INTEGER	Hauteur table données
CONST_WIND_HS	INTEGER	Masquage/affichage contrôleur cohérence
CONST_WIND_X	INTEGER	Coordonnée X contrôleur cohérence
CONST_WIND_Y	INTEGER	Coordonnée Y contrôleur cohérence
CONST_WIND_WIDTH	INTEGER	Largeur contrôleur cohérence
CONST_WIND_HEIGHT	INTEGER	Hauteur contrôleur cohérence
PLSQL_WIND_HS	INTEGER	Masquage/affichage compilateur lots
PLSQL_WIND_X	INTEGER	Coordonnée X compilateur lots
PLSQL_WIND_Y	INTEGER	Coordonnée Y compilateur lots
PLSQL_WIND_WIDTH	INTEGER	Largeur compilateur lots
PLSQL_WIND_HEIGHT	INTEGER	Hauteur compilateur lots
PLSQL_PROG_HS	INTEGER	Masquage/affichage Navigateur PL/SQL
PLSQL_PROG_X	INTEGER	Coordonnée X Navigateur PL/SQL
PLSQL_PROG_Y	INTEGER	Coordonnée Y Navigateur PL/SQL
PLSQL_PROG_WIDTH	INTEGER	Largeur Navigateur PL/SQL
PLSQL_PROG_HEIGHT	INTEGER	Hauteur Navigateur PL/SQL
PLSQL_BROWSER_HS	INTEGER	Masquage/affichage Navigateur bibliothèque
PLSQL_BROWSER_X	INTEGER	Coordonnée X Navigateur bibliothèque
PLSQL_BROWSER_Y	INTEGER	Coordonnée Y Navigateur bibliothèque
PLSQL_BROWSER_WIDTH	INTEGER	Largeur Navigateur bibliothèque
PLSQL_BROWSER_HEIGHT	INTEGER	Hauteur Navigateur bibliothèque
BIND_VAR_HS	INTEGER	Masquage/affichage table paramètres
BIND_VAR_X	INTEGER	Coordonnée X table paramètres
BIND_VAR_Y	INTEGER	Coordonnée Y table paramètres
BIND_VAR_WIDTH	INTEGER	Largeur table paramètres
BIND_VAR_HEIGHT	INTEGER	Hauteur table paramètres
OPEN_DRAWING_TRIGNAME	RAW(255)	Nom déclencheur ouverture affichage
OPEN_DRAWING_CHARSET	INTEGER	Jeu car. nom déclencheur ouverture affichage
OPEN_DRAWING_CHARLEN	INTEGER	Longueur nom déclencheur ouverture affichage
CLOSE_DRAWING_TRIGNAME	RAW(255)	Nom déclencheur fermeture affichage
CLOSE_DRAWING_CHARSET	INTEGER	Jeu car. nom déclencheur fermeture affichage
CLOSE_DRAWING_CHARLEN	INTEGER	Longueur nom déclencheur fermeture affichage
BIND_VAR_NAME	RAW(255)	Format date table paramètres
BIND_VAR_CHAR	INTEGER	Jeu car. format date table paramètres
BIND_VAR_LEN	INTEGER	Longueur format date table paramètres
TEMPLATE_NAME	RAW(255)	Nom modèle en cours
TEMPLATE_NAME_CHAR	INTEGER	Jeu car. nom modèle en cours
TEMPLATE_NAME_LEN	INTEGER	Longueur nom modèle en cours
ACTIVE_QUERY	INTEGER	ID interrogation en cours
DISPLAY_ROW	INTEGER	Nombre lignes table paramètres
OCL_VERSION	INTEGER	Numéro de version Oracle Charting Library


GO_PARAMETER

Nom	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEM	INTEGER	ID paramètre
PARAM_NAME	RAW(255)	Nom paramètre
PARAM_NAME_CHAR	INTEGER	Jeu car. nom paramètre
PARAM_NAME_LEN	INTEGER	Longueur nom paramètre
PARAM_TYPE	INTEGER	Type paramètre
PARAM_STR_NAME	RAW(255)	Valeur paramètre
PARAM_STR_NAME_CHAR	INTEGER	Jeu car. valeur paramètres
PARAM_STR_NAME_LEN	INTEGER	Longueur valeur paramètre
ROW_NUMBER	INTEGER	Ligne table paramètres


GO_QUERY

Nom	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEMID	INTEGER	ID interrogation
QUERY_NAME	RAW(255)	Nom interrogation
QUERY_NAME_CHAR	INTEGER	Jeu car. nom interrogation
QUERY_NAME_LEN	INTEGER	Longueur nom interrogation
QUERY_SRC	LONG RAW	Source interrogation
QUERY_SRC_CHAR	INTEGER	Jeu car. source interrogation
QUERY_SRC_LEN	INTEGER	Longueur source interrogation
QUERY_TYPE	INTEGER	Type interrogation
DATE_FORMAT	RAW(255)	Format date
DATE_FORMAT_CHAR	INTEGER	Jeu car. format date
DATE_FORMAT_LEN	INTEGER	Longueur format date


GO_SOUND

Nom	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEMID	INTEGER	ID son
NAME	RAW(255)	Nom de son
NAME_SET	INTEGER	Jeu car. Nom de son
NAME_LEN	INTEGER	Longueur nom de son
LONGID	INTEGER	ID champ long
RECVOLUME	INTEGER	Volume enregistrement
PLAYVOLUME	INTEGER	Volume lecture


GO_TIMER

Nom	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEM	INTEGER	ID horloge
TIMER_NAME	RAW(255)	Nom horloge
TIMER_NAME_CHARSET	INTEGER	Jeu car. nom horloge
TIMER_NAME_LENGTH	INTEGER	Longueur nom horloge
PROC_NAME	RAW(255)	Nom procédure horloge
PROC_NAME_CHARSET	INTEGER	Jeu car. nom procédure
PROC_NAME_LENGTH	INTEGER	Longueur nom procédure
TIMER_INTERVAL	INTEGER	Intervalle horloge


GO_VISLAYER

Nom	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
LAYERID	INTEGER	ID couche


VG_COLOR

Nom	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEMID	INTEGER	ID instance
CELLID	INTEGER	ID cellule couleur
COLOR_NAME	RAW(255)	Nom couleur
NAME_SET	INTEGER	Jeu car. nom couleur
NAME_LENGTH	INTEGER	Longueur nom couleur
RED	INTEGER	Composant rouge
GREEN	INTEGER	Composant vert
BLUE	INTEGER	Composant bleu


VG_DRAWING

Name	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEMID	INTEGER	ID instance
LONGID	INTEGER	ID champ long


VG_FONT

Nom	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEMID	INTEGER	ID instance
FONTID	INTEGER	ID police
COUNT	INTEGER	Nombre objets faisant référence à police
NAME	RAW(255)	Nom police
NAME_SET	INTEGER	Jeu car. nom police
NAME_LEN	INTEGER	Longueur nom police
FONT_SIZE	INTEGER	Taille police
STYLE	INTEGER	Style police
WEIGHT	INTEGER	Epaisseur police
WIDTH	INTEGER	Largeur police
IMAGETEXT	INTEGER	Texte image police
KERNING	INTEGER	Crénage police
CHAR_SET	INTEGER	Jeu car. police


VG_IMAGE

Nom	Type	Description

OWNER	VARCHAR(30)	ID propriétaire
MODID	INTEGER	ID module
ITEMID	INTEGER	ID instance
IMAGEID	INTEGER	ID Image
COUNT	INTEGER	Nombre objets faisant référence à image
LONGID	INTEGER	ID champ long


A propos des tables de produits Oracles partagées
A propos des tables de produits Oracle partagées

Les tables de produits Oracle partagées contiennent des définitions de module et peuvent être communes à d'autres produits Oracle. En utilisant des vues de base de données et des synonymes publics, les utilisateurs peuvent visualiser des informations sur les modules qui leur appartiennent ou auxquels ils ont été autorisés à accéder.


Tables de produits Oracle partagées

DE_ATTACHED_LIBS

ROSLFDESC

ROSSTRINGS

TOOL_ACCESS

TOOL_LRAW

TOOL_MODULE

TOOL_PLSQL


DE_ATTACHED_LIBS

Nom	Type	Description

OWNER	VARCHAR(30)	Propriétaire
MODID	DECIMAL(10)	ID module
ITEMID	DECIMAL(10)	Numéro bibliothèque (ordre dans liste)
LIBNAME	VARCHAR(30)	Nom bibliothèque
LIBMODE	DECIMAL(10)	Mode bibliothèque (masque de bit)


ROSLFDESC

Nom	Type	Description

OWNER	VARCHAR(30)	Utilisateur
MODID	DECIMAL(10)	ID module
ID	DECIMAL(10)	ID champ long
LPAGEID	DECIMAL(10)	Numéro séquence page logique
LFLEN	DECIMAL(10)	Longueur champ long
N	DECIMAL(10)	Nombre pages
DATALEN	DECIMAL(10)	Longueur de données page
DATA	LONG RAW	Données (chaîne)


ROSSEQUENCES

Nom	Type	Description

OWNER	VARCHAR2(30)	Propriétaire
MODID	DECIMAL(10)	ID module
SEQNAME	VARCHAR2(30)	Nom séquence
MIN_VAL	DECIMAL(10)	Valeur minimale
MAX_VAL	DECIMAL(10)	Valeur maximale
INC_BY	DECIMAL(10)	Incrément
CURRVAL	DECIMAL(10)	Valeur en cours
NEXTVAL	DECIMAL(10)	Valeur suivante
CACHESIZE	DECIMAL(10)	Taille cache


ROSSTRINGS

Nom	Type	Description

OWNER	VARCHAR(30)	Utilisateur
MODID	DECIMAL(10)	ID module
GROUPID	DECIMAL(10)	ID groupe
STRINGID	DECIMAL(10)	Identification instance chaîne dans module
LFID	DECIMAL(10)	Pour utilisation ROS
LEN length	DECIMAL(10)	Données (chaîne)
CS	DECIMAL(10)	Jeu de caractères
STR	LONG RAW	Données (chaîne)


TOOL_ACCESS

Nom	Type	Description

PRODUCT	VARCHAR(30)	Nom produit
OWNER	VARCHAR(30)	Propriétaire module
MODID	INTEGER	ID module
GRANTEE	VARCHAR(30)	Utilisateur autorisé


TOOL_LRAW

Nom	Type	Description

OWNER	VARCHAR(30)	Propriétaire module
MODID	DECIMAL(10)	ID module
ID	DECIMAL(10)	ID champ LONG RAW
LPAGEID	DECIMAL(10)	ID page LONG RAW
LFLEN	DECIMAL(10)	Longueur champ LONG RAW
N	DECIMAL(10)	Numéro séquence champ LONG RAW
ATALEN	DECIMAL(10)	Longueur champ LONG RAW
DATA	LONG RAW	Données LONG RAW


TOOL_MODULE

Nom	Type	Description

PRODUCT	VARCHAR(30)	Nom produit
MODTYPE	VARCHAR(30)	Type module
MODID	DECIMAL(10)	ID module
NEXT_ITEMID	DECIMAL(10)	Prochain ID interne disponible
OWNER	VARCHAR(30)	Propriétaire module
MODNAME	VARCHAR(30)	Nom module
CREATOR	VARCHAR(30)	Créateur module
CREATE_DATE	DATE	Date de création
CREATE_VER	DECIMAL(10)	Version produit utiliséepour création
MODIFIER	VARCHAR(30)	Dernier utilisateur ayant modifié le module
MOD_DATE	DATE	Date de modification
MOD_VER	DECIMAL(10)	Version produit utilisée pour modification
COPYRIGHT	VARCHAR(250)	Copyright du module
REQ_ROLE	VARCHAR(30)	Rôle nécessaire pour exécuter ce module
TCS_VER	DECIMAL(8)	Version de TCS
VGS_VER	DECIMAL(8)	Version de VGS
DE_VER	DECIMAL(8)	Version de DE
ROS_VER	DECIMAL(8)	Version de ROS


TOOL_PLSQL

Nom	Type	Description

OWNER	VARCHAR(30)	Propriétaire module
MODID	DECIMAL(10)	ID module
ITEMID	DECIMAL(10)	ID élément (unité programme)
OBJECT_ID	DECIMAL(10)	ID objet associé (facultatif)
TYPE	DECIMAL(4)	Type unité programme (facultatif, défini par produit)
NAME	VARCHAR(30)	Nom unité programme
PLSLFID_ST	DECIMAL(10)	ID champ LONG texte source PL/SQL
PLSLFID_EP	DECIMAL(10)	ID champ LONG unité programme codée PL/SQL


Correspondance de polices

Si vous utilisez un jeu de caractères (par ex. WE8ISO8859P1) pour développer un affichage et un autre jeu lors de l'exécution (EEC8EUROPA3), n'oubliez pas d'entrer les paramètres appropriés dans votre fichier des alias de police (uifont.ali) pour établir la correspondance entre les polices des différents jeux de caractères.

Pour définir les alias de police utilisés par Graphics Builder, modifiez uifont.ali. Pour chaque police pour laquelle vous voulez créer un alias, entrez dans le fichier les paramètres suivants :

police_source = police_cible

Pour chaque police, vous pouvez indiquer les attributs suivants :

<police>.<taille>.<style>.<épaisseur>.<largeur>.<jeu_de_caractères>

<police> doit être le nom (chaîne/identificateur) d'une police de caractères. <style>, <épaisseur>, <largeur> et <jeu_de_caractères> peuvent être soit une valeur numérique soit un nom (chaîne/identificateur) prédéfini. Par exemple, US7ASCII et 1 sont deux valeurs valides, qui font référence au même jeu de caractères. Le paramètre <taille> doit indiquer  une taille explicite, en points.

Liste des noms reconnus et de leurs équivalents numériques :

Styles	Valeur numérique
----------------------------------------
simple	0
italique	1
oblique	2
souligné	4
relief	8
ombré	16
inversé	32
surimpression	64
clignoter	128

Epaisseur	Valeur numérique
---------------------------------------
ultramince	1
extramince	2
mince	3
demimince	4
moyen	5
demigras	6
gras	7
extragras	8
ultragras	9
ultradense	1
extradense	2
dense	3
semidense	4
normal	5
semilarge	6
large	7
extralarge	8
ultralarge	9

Vous pouvez combiner des styles en utilisant le signe Plus (+). Par exemple :

Arial..Italique+Surimpression = Helvetica.12.Italique.Gras

En correspondance, le programme ne fait pas la différence entre majuscules et minuscules dans les chaînes. En consultation, comme les polices de caractères font dans la plupart des cas la différence, selon la plate-forme, vous devrez faire particulièrement attention aux noms figurant à droite, mais lors de l'établissement des correspondances, le programme ne fera pas la différence entre les majuscules et les minuscules.

La barre oblique inversée (\) est utilisée comme caractère de suite. Les commentaires peuvent être inclus de la manière suivante :

/* commentaire */
# commentaire
; commentaire

Vérification des correspondance de polices

Pour vous assurer que le fichier uifont.ali est correct, vous pouvez utiliser le programme fontchk qui vérifie que les fichiers ne comportent pas d'erreurs. Pour analyser votre fichier de correspondance de polices, entrez :

fontchk nom_fichier

Exemple de correspondance de polices

Exemple de fichier de correspondance de polices utilisable avec Graphics Builder.

[ Global ]  # Inscrire ici les correspondances pour toutes les plates-formes.

# Correspondance pour MS Windows

Arial             = helvetica
"Courier New"     = courier
"Times New Roman" = times
Modern            = helvetica
"MS Sans Serif"   = helvetica
"MS Serif"        = times
"Small Polices"   = helvetica

# Correspondance pour Macintosh

"New Century Schlbk" = "new century schoolbook"
"New York"           = "times"
[ Printer ]  # Inscrire ici les correspondances pour toutes les imprimantes.
[ Printer:PostScript1 ]  /* Inscrire ici les correspondances pour
                            les imprimantes PostScript de niveau 1. */

# Correspondance pour MS Windows

Roman             = palatino
Script            = "itc zapf chancery"
FixedSys          = courier
System            = helvetica
# Correspondance pour Macintosh
"Avant Garde"     = "itc avant garde gothic"

# Correspondance pour affichage Motif

fixed             = courier
clean             = times
lucidatypewriter  = courier
lucidabright      = times

# Exemple de correspondance de polices Kanji

courier...Medium..JEUC   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..JEUC     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
courier...Medium..SJIS   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..SJIS     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..JEUC     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..JEUC       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..SJIS     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..SJIS       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..JEUC = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..JEUC   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..SJIS = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..SJIS   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC

[ Printer:PostScript2 ]  /* Inscrire ici les correspondances pour les
                            imprimantes PostScript de niveau 2. */

# Correspondance pour MS Windows

Roman             = palatino
Script            = "itc zapf chancery"
FixedSys          = courier
System            = helvetica

# Correspondance pour Macintosh

"Avant Garde"     = "itc avant garde gothic"

# Correspondance pour affichage sous Motif

fixed             = courier
clean             = times
lucidatypewriter  = courier
lucidabright      = times

# Exemple de correspondance de polices Kanji

courier...Medium..JEUC   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..JEUC     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
Courier...Medium..SJIS   = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
courier...Bold..SJIS     = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..JEUC     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..JEUC       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
times...Medium..SJIS     = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
times...Bold..SJIS       = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..JEUC = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..JEUC   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC
helvetica...Medium..SJIS = \
   "Ryumin-Light-83pv-RKSJ-H"...Light..JEUC
helvetica...Bold..SJIS   = \
   "GothicBBB-Medium-83pv-RKSJ-H"...Medium..JEUC

[ Display ]  # Inscrire ici les correspondances pour tous les affichages.

[ Display:Motif ]  # Inscrire ici les correspondances pour les affichages sous Motif.

# Correspondance pour MS Windows

Courier           = courier
Roman             = lucida
Script            = lucidabright
FixedSys          = fixed
System            = lucida

# Correspondance pour Macintosh

"Avant Garde"     = helvetica
"Bookman"         = times
[ Display:CM ]     # Inscrire ici les correspondances pour les affichages CM.

# Ces affichages sont propres à DEC et peuvent nécessiter une localisation.

*..Blink          = Blinking
*..Inverted+Underline.Bold = ReverseBoldUnderline
*..Inverted+Underline.    = UnderlineReverse
*..Underline.Bold = UnderlineBold
*..Inverted.Bold  = ReverseBold
*...Bold          = Bold
*..Underline      = Underline
*..Inverted       = Reverse
*                 = Plain    # Police de dernier recours


Fichier de correspondance de polices

Graphics Builder supporte les alias de police. Les correspondances de polices utilisées par Graphics Builder sont définies dans le fichier uifont.ali. Vous pouvez les modifier en éditant ce fichier. L'emplacement de ce fichier est fonction de votre système d'exploitation.

Remarque : Graphics Builder recherchera le fichier de correspondance de polices à l'adresse spécifiée par la variable d'environnement TK2_FONTALIAS. Si TK2_FONTALIAS n'est pas indiquée, Graphics Builder la recherchera à l'adresse spécifiée par défaut pour votre système d'exploitation.


Fonctions supportées pour les sorties utilisateur

Les sorties utilisateur écrites en utilisant l'un des langages hôte du précompilateur Oracle permettent d'effectuer :

•	des opérations de procédure (par des instructions en langage hôte)

•	des fonctions supplémentaires (par les instructions du tableau ci-après)

Instructions	Description

EXEC SQL	Exécute des commandes SQL.
EXEC TOOLS GET	Transmet des valeurs de Graphics Builder à une sortie utilisateur.
EXEC TOOLS SET	Transmet des valeurs d'une sortie utilisateur à Graphics Builder.
EXEC TOOLS MESSAGE	Transmet un message et un code de message facultatif d'une sortie utilisateur à Graphics Builder.
EXEC TOOLS GET CONTEXT	Transmet un pointeur de contexte de Graphics Builder à une sortie utilisateur.
EXEC TOOLS SET CONTEXT	Transmet un pointeur de contexte d'une sortie utilisateur à Graphics Builder.
EXEC ORACLE	Exécute des options du précompilateur ORACLE.


EXEC SQL

Cette instruction est une commande SQL précédée de "EXEC SQL". Les instructions EXEC SQL vous permettent d'exécuter toute commande SQL dans une sortie utilisateur du précompilateur Oracle. Vous pouvez ainsi sélectionner ou manipuler des données stockées dans la base de données à partir d'une sortie utilisateur.

Syntaxe :	EXEC SQL instruction_sql;

où :

instruction_sql	Indique toute instruction SQL ORACLE valide, à l'exception des commandes restreintes indiquées dans cette section.

Il n'est pas nécessaire d'établir une connexion (CONNECT) explicite dans une sortie utilisateur du précompilateur Oracle, car Graphic Builder l'établit automatiquement. Cependant, ORACLE n'accepte pas les connexions simultanées. Pour plus d'informations, reportez-vous à Programmer's Guide to the Oracle Precompiler.

Remarque : Graphics Builder ne valide pas (COMMIT) les modifications apportées à la base de données après l'exécution d'un affichage (avec G30DES, G30RUN et/ou G30BAT). Si vous voulez les valider, utilisez votre sortie utilisateur.


EXEC TOOLS GET

Cette instruction transmet une valeur de Graphics Builder à une sortie utilisateur du précompilateur Oracle. Plus précisément, elle entre la valeur d'un paramètre Graphics Builder dans une variable en langage hôte. Lorsque Graphics Builder transmet une valeur à une sortie utilisateur, celle-ci peut utiliser la valeur pour des opérations de calcul, de manipulation ou de mise à jour.

Syntaxe :	EXEC TOOLS GET variable_affichage_1[,
variable_affichage_2, ...]INTO :variable_hôte_1[,
:variable_hôte_2, ...];

où :

variable_affichage_n	Indique le nom du paramètre Graphics Builder qui contient la valeur à extraire.

variable_hôte_n	Indique le nom de la variable en langage hôte à laquelle vous transférez une valeur.

Remarques :

1	variable_affichage_n peut être une référence à :

   un paramètre Graphics Builder

  une variable en langage hôte (précédée de deux points) dont la valeur est un nom de paramètre

2	Graphics Builder transmet les arguments d'affichage à la sortie utilisateur en format SQL standard.

   les chaînes sont transmises entourées de guillemets simples (voir règle 1 ci-dessous)

  les constantes sont transmises telles quelles (c'est-à-dire sans guillemets)

  les dates sont transmises dans le format indiqué par le masque de format de paramètre, entre guillemets simples (voir règle 1 ci-dessous)

  les variables hôte sont précédées de deux points (:)

La façon dont Graphics Builder transmet des arguments à une sortie utilisateur est décrite dans le tableau ci-après :

Valeur	Résultat

`Summit'	Indique comment la valeur de la chaîne constante 'Summit' est transmise.
413.60	Indique comment la valeur numérique constante 413.60 est transmise.
`19910414083000'	Indique comment la valeur de date 14 avril 1991, 8h30, ayant pour masque de format AAAAMMJJHH24MISS, est transmise.
:holder1	Indique la manière dont la variable holder1 est transmise.
(Pour plus d'informations sur les restrictions applicables aux variables en langage hôte, reportez-vous à Programmer's Guide to the Oracle Precompiler.)

Règles :

1	Certains langages hôte utilisent des doubles guillemets à la place des guillemets simples.

2	Si les données d'un objet Graphics Builder ont plus de 32 K de long, la valeur retournée par EXEC TOOLS GET est tronquée aux 32 K premiers caractères.


EXEC TOOLS SET

 Rubriques connexes

Cette instruction transmet une valeur d'une sortie utilisateur du précompilateur Oracle à Graphics Builder. Plus précisément, elle place la valeur d'une constante ou la valeur d'une variable en langage hôte dans un paramètre Graphics Builder.

Syntaxe :	EXEC TOOLS SET variable_affichage [, ...]VALUES
({:variable_hôte | constante}[, ...]);

où :

variable_affichage	Indique le nom du paramètre Graphics Builder auquel vous transférez une valeur.

variable_hôte	Indique le nom de la variable en langage hôte de laquelle vous extrayez une valeur.

constante	Indique la constante que vous extrayez.

Remarque : La transmission d'arguments à destination et en provenance de la sortie utilisateur s'effectue de la même manière.

Règles :

1	Les données de plus de 32 K de caractères ne peuvent pas être transmises par EXEC TOOLS SET à un paramètre Graphics Builder.


EXEC TOOLS GET CONTEXT

Cette instruction transmet un contexte d'une sortie utilisateur du précompilateur Oracle à une autre. Plus précisément, elle vous permet d'extraire (GET) des informations d'une sortie utilisateur à une autre sans nécessiter de variables globales.

Syntaxe :	EXEC TOOLS GET CONTEXT nom_contexte_application INTO
:pointeur_variable_hôte;

où :

nom_contexte_application	Indique le nom du contexte auquel vous voulez accéder.

pointeur_variable_hôte	Indique le nom de la variable du pointeur en langage hôte dans laquelle vous voulez entrer le contexte.

Règles :

1	Pour extraire (GET) un contexte, il faut que la sortie utilisateur réside dans le même processus que l'exécutable Graphics Builder auquel elle est liée (c'est-à-dire que la sortie utilisateur ne doit pas générer de sous-processus et attendre que le sous-processus puisse accéder au contexte).


EXEC TOOLS SET CONTEXT

Cette instruction crée un contexte nommé. Les contextes vous permettent de partager des informations entre les différentes sorties utilisateur sans demander de variables globales. Plus précisément, si une sortie utilisateur appelée A crée un contexte, vos autres sorties utilisateur liées à A peuvent extraire (GET) des informations du contexte que A a créé.

Syntaxe :	EXEC TOOLS SET CONTEXT :pointeur_variable_hôte BY
nom_contexte_application;

où :

pointeur_variable_hôte	Indique le pointeur au contexte que vous créez.

nom_contexte_application	Indique le nom du contexte.

Règles :

1	Pour partager un contexte, la sortie utilisateur doit résider dans le même processus que l'exécutable Graphics Builder auquel il est lié (c'est-à-dire que la sortie utilisateur ne doit pas générer de sous-processus et attendre que le sous-processus puisse accéder au contexte).


EXEC ORACLE

Cette instruction, qui n'est pas une instruction SQL standard, est utilisée pour exécuter des options du précompilateur Oracle. Pour plus d'informations, reportez-vous à Programmer's Guide to the Oracle Precompiler.

Règles :

1	Graphics Builder ne valide pas (COMMIT) les modifications apportées à la base de données après l'exécution d'un affichage (avec G30DES, G30RUN et/ou G30BAT). Si vous voulez les valider, utilisez votre sortie utilisateur.


EXEC TOOLS MESSAGE

 Rubriques connexes

Cette instruction transmet un message d'une sortie utilisateur du précompilateur Oracle à Graphics Builder. Plus précisément, Graphics Builder affichera le message comme tout autre message Graphics Builder (c'est-à-dire sous la forme d'une alerte, envoyée à votre unité de sortie système standard, etc.)

Syntaxe :	EXEC TOOLS MESSAGE texte_msg [numéro_msg];

où :

texte_msg	Indique un message d'au maximum 190 caractères, moins les caractères alphanumériques de texte_msg.

numéro_msg	Indique une valeur numérique comprise entre 0 et 9999 à afficher comme numéro de message.

Remarque : Vous pouvez également définir et afficher un message d'erreur en utilisant PL/SQL.


Règle générale

Vous ne pouvez pas effectuer d'entrées-sorties d'écran en langage hôte à partir d'une sortie utilisateur du précompilateur Oracle. Cette restriction est due au fait que les routines d'exécution qu'utilise un langage hôte pour exécuter des entrées-sorties d'écran ne sont pas compatibles avec les routines que Graphics Builder utilise pour effectuer ses entrées-sorties.

Vous pouvez effectuer des entrées-sorties de fichiers en langage hôte à partir d'une sortie utilisateur.


Syntaxe d'un appel de sortie utilisateur transmis

Votre programme de sortie utilisateur recevra l'appel de sortie utilisateur sous la forme d'une chaîne contenant tout d'abord le nom_sortie_utilisateur, puis une liste_arguments facultative. Les arguments de liste_arguments sont séparés par des espaces.

Exemples :

1	L'appel :

OG_USER_EXIT('quota 10 20 Q4');

est transmis à la sortie utilisateur sous la forme :

'quota 10 20 Q4'

2	L'appel :

OG_USER_EXIT('quota');

est transmis à la sortie utilisateur sous la forme :

'quota'

Règles :

1	C'est la sortie utilisateur - et non Graphics Builder - qui doit analyser la chaîne de l'appel de sortie utilisateur.

2	S'il y a plusieurs espaces entre les arguments transmis avec le nom de sortie utilisateur, Graphics Builder supprime les blancs en trop avant de transmettre les chaînes à la sortie utilisateur.

Par exemple, l'appel :

'quota 10     20  Q4'

est transmis à la sortie utilisateur sous la forme :

'quota 10 20 Q4'


Utilisation des enregistrements d'attributs

•	Généralités

•	Procédures internes raccourcies

•	Description des enregistrements attribut


Généralités

De nombreux sous-programmes intégrés acceptent un argument appelé "enregistrement d'attributs". Un "attribut" est une propriété ou une caractéristique d'un objet Graphics Builder. Par exemple, la couleur de remplissage du premier plan d'un rectangle est un attribut ; l'angle de départ et l'angle d'arrivée d'un arc sont des attributs. Graphics Builder comporte suffisamment d'attributs pour décrire totalement la structure et l'aspect d'un objet.

Graphics Builder offre plusieurs nouveaux types de variables intégrées permettant de contrôler ces attributs, dont la plupart sont de type RECORD. (Pour plus d'informations sur les données de type RECORD, reportez-vous à PL/SQL User's Guide and Reference.) Chaque champ de l'un de ces enregistrements représente un attribut particulier. Un "enregistrement d'attributs" fait donc référence à une variable dont vous avez déclaré le type après l'avoir choisi dans l'un de ces nouveaux types d'enregistrement.

Ainsi, la définition du type de OG_LINE_ATTR, enregistrement d'attributs d'une ligne, peut s'écrire de la manière suivante :

TYPE og_line_attr IS RECORD
(mask         NUMBER(1,1),
 startpt      og_point,
 endpt        og_point,
 arrowstyle   NUMBER(1,0)
);

Cet enregistrement indique les points de départ et d'arrivée, ainsi que le style de flèche d'une ligne (l'attribut masque sera décrit ultérieurement).

Tous les attributs d'un objet sont représentés dans l'un des enregistrements d'attributs. Pour modifier par programme l'un de ces attributs (son motif de remplissage, par exemple), vous devez changer la valeur des champs appropriés dans l'enregistrement d'attributs approprié, puis transmettre l'enregistrement d'attributs à une procédure ou à une fonction. (Notez que les procédures et les fonctions exécutent effectivement les opérations que vous avez demandées ; cependant, vous devez utiliser un enregistrement d'attributs pour indiquer à la procédure ou la fonction la façon exacte dont vous voulez que l'action soit exécutée.)


Classes d'attributs

Certains enregistrements d'attributs contiennent des attributs communs à de nombreux types d'objet alors que d'autres contiennent des attributs propres à un seul type d'objet. Par exemple, tous les objets ont un nom, mais seuls les objets texte ont une taille de police.

Les attributs appartiennent aux catégories suivantes :

•	génériques

•	graphiques

•	spécifiques

Attributs génériques

Les attributs génériques s'appliquent à la plupart des classes d'objets. Par exemple, la plupart des objets peuvent avoir un nom, une procédure bouton associée ou un objet père.

Attributs graphiques

Les attributs graphiques s'appliquent à de nombreuses classes d'objets, mais pas à toutes. Ils ne peuvent s'appliquer qu'à des objets graphiques (c'est-à-dire à ceux qui peuvent être créés à l'aide de l'un des outils graphiques de l'éditeur Présentation). Par exemple, l'attribut graphique 'couleur de remplissage' peut être utilisé pour décrire un rectangle, un arc, un symbole, etc. Cependant, il ne s'applique pas à la description d'une image, puisqu'elle n'a pas de couleur de remplissage. De même, un objet groupe ne peut pas être décrit par des attributs graphiques. (Notez qu'un groupe n'est pas un objet graphique, mais que ses différents composants peuvent être des objets graphiques. Les attributs graphiques peuvent donc s'appliquer à ces composants).

Attributs spécifiques

Les attributs spécifiques ne s'appliquent qu'à une classe d'objets spécifiques. Par exemple, 'angle de départ' est un attribut qui décrit uniquement un arc, et non un rectangle, une ligne, une image ou un autre objet. De même, vous pouvez vouloir connaître le 'nombre de fils' composant un objet de groupe, mais utiliser cet attribut avec une autre classe d'objets serait dépourvu d'intérêt. Graphics Builder a identifié les attributs spécifiques des objets application, arc, graphique, groupe, image, ligne, polygone, rectangle, rectangle arrondi, symbole, texte et fenêtre.

Nous avons défini un enregistrement d'attributs intégrés pour les attributs génériques, et un autre pour les attributs graphiques. En outre, nous avons défini un enregistrement distinct pour chaque ensemble d'attributs spécifiques.

Les différents objets Graphics Builder, ainsi que les enregistrements d'attributs significatifs pour chacun d'entre eux, sont nommés ci-dessous :

Classe d'objet	Enregistrements attributs
application	application
arc	générique graphique arc
graphique	générique groupe graphique
élément graphique	graphique élément de graphique
affichage	affichage
graphique	générique graphique
groupe	générique groupe
image	générique
ligne	générique graphique ligne
polygone	générique graphique polygone
imprimante	imprimante
interrogation	interrogation
rectangle	générique graphique rectangle
rectangle arrondi	générique graphique rectangle arrondi
son	son
symbole	générique graphique symbole
texte	générique graphique texte
horloge	horloge
fenêtre	fenêtre


Enregistrements d'attributs combinés

Aux enregistrements d'attributs décrits ci-dessus viennent s'ajouter des "enregistrements d'attributs combinés" définis par Graphics Builder. Un enregistrement d'attributs combinés combine en une même variable tous les enregistrements d'attributs nécessaires à la description complète d'un objet. Comme son nom l'indique, l'enregistrement d'attributs combinés est un autre enregistrement, mais chacun de ses champs est un enregistrement d'attributs génériques, graphique ou spécifiques. Dans la plupart des cas, vous pouvez donc utiliser un seul enregistrement d'attributs combinés pour gérer tous les attributs d'un objet, au lieu d'utiliser plusieurs enregistrements d'attributs distincts pour représenter chacune des classes d'attribut de l'objet.

Par exemple, l'enregistrement d'attributs combinés du rectangle contient trois champs représentant les enregistrements d'attributs générique, graphique et rectangle. L'enregistrement d'attributs combinés de l'image ne contient que deux champs, qui représentent les enregistrements d'attributs génériques et images.

Exemple de définition de type de OG_LINE_CA, l'enregistrement d'attributs combinés d'un objet ligne :

TYPE og_line_ca IS RECORD
(line_caob  og_generic_attr,  /* enregistrement d'attributs génériques*/
 line_caoh  og_graphic_attr,  /* enregistrement d'attributs graphiques */
 line_caol  og_line_attr      /* enregistrement d'attributs spécifiques */
);

Cet enregistrement d'attributs combinés contient trois champs qui représentent les enregistrements d'attributs génériques, graphiques et spécifiques.


Attributs de masque

Chaque enregistrement d'attributs (à l'exclusion des enregistrements d'attributs combinés) comporte un champ numérique appelé "masque". La valeur de ce champ indique les attributs de l'enregistrement d'attributs que vous voulez modifier (c'est-à-dire, définir) ou examiner (c'est-à-dire, lire). Lorsque vous utilisez un enregistrement d'attributs comme argument d'une procédure ou d'une fonction, cette procédure ou cette fonction utilise le masque pour déterminer les attributs auxquels elle doit prêter attention.

Par exemple, supposons que vous vouliez changer uniquement la couleur de remplissage du premier plan d'un objet en définissant l'attribut ffcolor d'un enregistrement d'attributs graphiques, puis transmettre à la procédure OG_SET_ATTR cet enregistrement d'attributs et l'identificateur de l'objet sous la forme d'arguments. La procédure ne connaît pas les attributs que vous voulez qu'elle définisse : doit-elle changer tous les objets attributs graphiques de l'objet, ou uniquement certains d'entre eux ? Pour le savoir, elle se réfère à l'attribut masque de l'enregistrement d'attributs.

La valeur d'un attribut masque indique les attributs de l'enregistrement d'attributs qu'une procédure ou une fonction doit utiliser. Cette valeur est appelée "valeur de masque".


Constantes de masque

Pour vous aider à déterminer une valeur de masque correspondant à un enregistrement d'attributs, dans Graphics Builder, à chaque attribut est associée une constante numérique intégrée particulière, appelée "constante de masque".

Exemple d'enregistrement d'attributs de ligne et de ses constantes de masque :

TYPE og_line_attr IS RECORD    Constantes de masque :
(mask       NUMBER(1,0),
 startpt    og_point,          OG_STARTPT_LINEA
 endpt      og_point,          OG_ENDPT_LINEA
 arrowstyle NUMBER(1,0)        OG_ARROWSTYLE_LINEA
);
                               OG_ALL_LINEA
                               OG_NONE_LINEA

Après avoir déterminé quels attributs d'un enregistrement d'attributs vous voulez utiliser, calculez la somme des constantes de masque associées à ces attributs. Le résultat est une valeur de masque qui ne représente que ces attributs. Si vous définissez l'attribut masque de l'enregistrement d'attributs à cette valeur de masque, la procédure ou la fonction à laquelle vous transmettez cet enregistrement d'attributs ne prend en compte que ces attributs.

Par exemple, pour changer l'attribut startpt de l'enregistrement d'attributs de la ligne ci-dessus, commencez par déclarer une variable du type :

my_variable   og_line_attr;

puis définissez une nouvelle valeur de l'attribut startpt :

my_variable.startpt := new_point;

Enfin, définissez le masque pour indiquer que vous voulez définir un nouveau point de départ :

my_variable.mask := OG_STARTPT_LINEA;

(Notez que cette série d'actions ne fait que préparer un enregistrement d'attributs à son utilisation par une procédure ou une fonction. Pour tous renseignements sur le rapport entre cette opération et la modification d'un objet, reportez-vous à la description de la procédure ou de la fonction spécifique.)

Pour définir les nouvelles valeurs pour le point de départ et le point d'arrivée de la ligne, définissez le masque en conséquence. Dans ce cas, la valeur de masque appropriée sera la somme des constantes de masque de ces deux attributs :

my_variable.mask := OG_STARTPT_LINEA +  OG_ENDPT_LINEA;

Outre les constantes de masque de chaque attribut, chaque enregistrement d'attributs contient deux attributs supplémentaires qui indiquent que tous les attributs doivent être utilisés par une procédure ou une fonction, ou qu'aucun ne doit être utilisé. Pour l'enregistrement d'attributs de ligne, ces constantes de masque sont OG_ALL_LINEA et OG_NONE_LINEA.

N'oubliez pas que ces constantes de masque sont des valeurs numériques et peuvent être traitées comme telles. Vous pouvez non seulement les additionner pour indiquer des attributs multiples, mais aussi les retrancher. Par exemple, pour indiquer que tous les attributs sauf le point final doivent être modifiés par une procédure ou une fonction, vous pouvez définir la valeur de masque à :

my_variable.mask := OG_ALL_LINEA - OG_ENDPT_LINEA;

Dans certains cas, la même constante de masque est utilisée pour représenter plusieurs attributs d'un enregistrement d'attributs. Si cette constante de masque est utilisée pour calculer la valeur du masque, tous les attributs représentés par cette constante seront utilisés par la procédure ou la fonction à laquelle l'enregistrement d'attributs sera transmis.

Les masques dans les enregistrements d'attributs combinés

Nous avons vu ci-dessus que tous les enregistrements d'attributs contiennent un attribut de masque, alors que les enregistrements d'attributs combinés n'en comportent pas. Lorsque vous transmettez à une procédure un enregistrement d'attributs combinés sous la forme d'un argument, cette procédure utilise les masques de chacun des enregistrements d'attributs qui le composent.

Par exemple, supposons que vous déclariez que la variable est un enregistrement d'attributs combinés de ligne (n'oubliez pas qu'un enregistrement d'attributs combinés de ligne contient des enregistrements d'attributs pour les attributs génériques, graphiques et spécifiques de type ligne) :

comb_variable   og_line_ca;

Vous voulez ensuite modifier différents attributs de l'enregistrement. Dans l'enregistrement d'attributs génériques, vous ne voulez modifier aucune valeur ; dans l'enregistrement d'attributs graphiques, vous voulez modifier les valeurs des attributs dashstyle et capstyle  ; enfin, dans l'enregistrement d'attributs spécifiques (de type ligne), vous voulez changer uniquement la valeur de l'attribut arrowstyle. Pour cela, vous pouvez utiliser les instructions suivantes :

comb_variable.line_caoh.dashstyle := new_dashstyle;
comb_variable.line_caoh.capstyle := new_capstyle;
comb_variable.line_caol.arrowstyle := new_arrowstyle;

Avant de transmettre cet enregistrement d'attributs combinés à une procédure qui appliquera vos modifications, définissez le masque de chaque enregistrement d'attributs pour indiquer les attributs de l'enregistrement que la procédure devra utiliser :

comb_variable.line_caob.mask := OG_NONE_GENERICA;
comb_variable.line_caoh.mask := OG_DASHSTYLE_GRAPHICA +
                                OG_CAPSTYLE_GRAPHICA;
comb_variable.line_caol.mask := OG_ARROWSTYLE_LINEA;

Notez que vous devez définir le masque pour chaque enregistrement d'attributs d'un enregistrement d'attributs combinés, même si vous ne voulez pas utiliser d'attributs dans cet enregistrement d'attributs. Dans ce cas, vous devez définir le masque à la constante de masque qui indique qu'aucun attribut ne doit être utilisé.

Lorsque vous avez défini les masques de chacun des enregistrements d'attributs individuels, vous pouvez transmettre l'enregistrement d'attributs combinés à une fonction ou à une procédure. N'oubliez pas que la valeur de masque d'un enregistrement d'attributs est la seule façon d'indiquer à la procédure ou à la fonction les attributs que vous voulez qu'elle utilise.


Attributs pouvant être créés, définis et lus

Dans le tableau ci-dessous, chaque définition d'attribut s'accompagne d'une, deux ou trois lettres.

Lettre	Signification
C	Indique que l'attribut doit être créé, c'est-à-dire que Graphics Builder reconnaît la valeur que vous affectez à l'attribut lorsque l'objet contenant l'attribut est créé. Si l'attribut ne peut pas être créé, Graphics Builder fournit une valeur par défaut lorsque l'objet est créé.
S	Indique que l'attribut est définissable, c'est-à-dire que vous pouvez définir sa valeur en appelant le sous-programme Graphics Builder intégré approprié.
G	Indique que l'attribut peut être obtenu, c'est-à-dire que vous pouvez extraire la valeur de l'attribut en appelant le sous-programme Graphics Builder intégré approprié.


Raccourcis de procédure interne

Outre l'approche par enregistrements d'attributs, Graphics Builder propose une série de sous-programmes intégrés qui simplifient la création des objets et la lecture ou la définition de leurs attributs. Chacun de ces sous-programmes "raccourcis" peut être utilisé pour définir ou lire un attribut d'un objet. Pour plus d'informations, reportez-vous à Généralités sur les procédures internes Graphics Builder.

Par exemple, pour définir le motif de remplissage et de bordure d'un objet en utilisant l'approche par enregistrements d'attributs, vous devez définir les nouveaux motifs de remplissage, définir les masques appropriés et appeler OG_SET_ATTR:

PROCEDURE attr_rec_approach (my_obj OG_OBJECT) IS
   my_rec   og_graphic_ca;
BEGIN
   my_rec.graphic_caoh.fillpatt:='gray50';
   my_rec.graphic_caoh.edgepatt:='kangaroo';
   my_rec.graphic_caob.mask:=OG_NONE_GENERICA;
   my_rec.graphic_caoh.mask:=OG_FILLPATT_GRAPHICA+
                             OG_EDGEPATT_GRAPHICA;
   og_set_attr(my_obj, my_rec);
END;

En utilisant les raccourcis, vous pouvez exécuter exactement la même opération par deux appels de procédure seulement :

PROCEDURE shortcut_approach (my_obj OG_OBJECT) IS
BEGIN
   og_set_fillpatt(my_obj, 'gray50');
   og_set_edgepatt(my_obj, 'kangaroo');
END;

Avantages

L'utilisation des raccourcis à la place des enregistrements d'attributs offre les avantages suivants :

•	Elle réclame moins de code PL/SQL, ce qui diminue le temps de développement.

•	Elle facilite la lecture et de la compréhension de vos unités de programme.

Inconvénients

L'utilisation des raccourcis à la place des enregistrements d'attributs présente les inconvénients suivants :

•	Elle est moins efficace. Comme Graphics Builder utilise les enregistrements d'attributs en interne, il doit, chaque fois que vous appelez un raccourci, définir et remplir un nouvel enregistrement d'attributs interne. En outre, il faut plus de temps pour exécuter plusieurs routines de définition que pour n'en exécuter qu'une. Dans l'exemple ci-dessus, la première procédure (qui comporte un appel 'set') est pratiquement deux fois plus rapide que la seconde (qui comporte deux appels 'set').

•	Elle demande que votre application utilise des paramètres par défaut, puisque l'appel de plusieurs raccourcis pour définir la totalité des attributs nécessaires peut nuire considérablement aux performances de votre application.


Enregistrement d'attributs d'application

L'enregistrement d'attributs d'application contient des attributs qui peuvent être utilisés avec l'application en cours.

TYPE og_app_attr IS RECORD            Constantes de masque :
(mask         NUMBER(3,0),
 cursor       VARCHAR2(255),          OG_CURSOR_APPA
 hscreen_res  NUMBER(5,0),            OG_SCREEN_RES_APPA
 vscreen_res  NUMBER(5,0),            OG_SCREEN_RES_APPA
 hlayout_res  NUMBER(10,0),           OG_LAYOUT_RES_APPA
 vlayout_res  NUMBER(10,0),           OG_LAYOUT_RES_APPA
 platform     NUMBER(1,0),            OG_PLATFORM_APPA
 username     VARCHAR2(255),          OG_USERNAME_APPA
 password     VARCHAR2(255),          OG_PASSWORD_APPA
 connection   VARCHAR2(255)           OG_CONNECTION_APPA
);
                                      OG_ALL_APPA
                                      OG_NONE_APPA

	Attribut	Description
SG	cursor	Nom du curseur de souris utilisé. La valeur de cet attribut peut être l'une des chaînes suivantes :  défaut insertion crosshair aide occupé L'aspect de chaque curseur est propre au système utilisé. Pour plus d'informations, reportez-vous à la documentation de votre système d'exploitation. Si vous définissez cet attribut à une valeur non valide, Graphics Builder utilise la valeur 'défaut'.
G	hscreen_res	Résolution horizontale de l'écran. Cette valeur correspond au nombre d'unités de résolution de l'écran (c'est-à-dire de pixels) d'un pouce horizontal de l'écran.
G	vscreen_res	Résolution verticale de l'écran. Cette valeur correspond au nombre d'unités de résolution de l'écran (c'est-à-dire de pixels) d'un pouce vertical de l'écran.
G	hlayout_res	Résolution horizontale de la présentation. Cette valeur correspond au nombre d'unités de présentation par pouce horizontal de la présentation.
G	vlayout_res	Résolution verticale de la présentation. Cette valeur correspond au nombre d'unités de présentation par pouce vertical de la présentation.
G	platform	Plate-forme sur laquelle Graphics Builder s'exécute. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_MACINTOSH_PLATFORM   Indique que la plate-forme est de type Macintosh.
		OG_MOTIF_PLATFORM Indique que la plate-forme est de type OSF/MOTIF.
		OG_MSWINDOWS_PLATFORM Indique que la plate-forme est de type Microsoft Windows.
		OG_PM_PLATFORM Indique que la plate-forme est de type Presentation Manager.
		OG_X_PLATFORM Indique que la plate-forme est de type X Window System.
G	username	Nom utilisateur de la connexion à la base de données en cours. Si l'utilisateur n'est pas connecté, cet attribut a la valeur NULL.
G	password	Mot de passe de la connexion à la base de données en cours. Si l'utilisateur n'est pas connecté ou si l'option de préférence Keep_Password est définie à No, la valeur de cet attribut est NULL.
G	connection	Chaîne de connexion à la base de données en cours. Si l'utilisateur n'est pas connecté, cet attribut a la valeur NULL.


Enregistrement d'attributs combinés d'arc

L'enregistrement d'attributs combinés d'arc se compose d'un enregistrement d'attributs génériques, d'un enregistrement d'attributs graphiques et d'un enregistrement d'attributs d'arc :

TYPE og_arc_ca IS RECORD
(arc_caob  og_generic_attr,   /* générique */
 arc_caoh  og_graphic_attr,   /* graphique */
 arc_caoa  og_arc_attr        /* arc */
);


Enregistrement d'attributs d'arc

L'enregistrement d'attributs d'arc contient des attributs qui ne peuvent être utilisés qu'avec les objets arc :

TYPE og_arc_attr IS RECORD                Constantes de masque:
(mask     NUMBER(1,0),
 basearc  og_arc,                         OG_BASEARC_ARCA
 arcfill  NUMBER(1,0),                    OG_ARCFILL_ARCA
 closed   BOOLEAN                         OG_CLOSED_ARCA
);
                                          OG_ALL_ARCA
                                          OG_NONE_ARCA

	Attribut	Description
CSG	basearc	Coordonnées x et y de l'angle supérieur gauche, et hauteur et largeur du rectangle utilisé comme base de l'ellipse dans laquelle l'arc est découpé.
CSG	arcfill	Forme de remplissage de l'arc. La valeur de cet attribut peut être une des constantes intégrées suivantes :
		OG_CHORD_ARCFILL   Indique que la forme de remplissage de l'arc est celle d'une corde.
		OG_PIE_ARCFILL   Indique que la forme de remplissage de l'arc est celle d'un secteur plein.
CSG	closed	Fermeture de l'arc. La valeur de cet attribut peut être l'une des suivantes :
		TRUE   Indique que l'arc est fermé.
		FALSE   Indique que l'arc est ouvert.


Enregistrement d'attributs combinés d'axe continu

TYPE og_contaxis_ca IS RECORD
(ca_axis  og_axis_attr,       /* axe générique*/
 ca_cont  og_contaxis_attr   /* axe continu */
);


Enregistrement d'attributs d'axe continu

TYPE og_contaxis_attr IS RECORD     Constantes de masque :
(mask      NUMBER(4,0),
 automin   BOOLEAN,                 OG_MINIMUM_CONTAXISA
 minimum   NUMBER(6),               OG_MINIMUM_CONTAXISA
 autostep  BOOLEAN,                 OG_STEP_CONTAXISA
 step      NUMBER(6),               OG_STEP_CONTAXISA
 automax   BOOLEAN,                 OG_MAXIMUM_CONTAXISA
 maximum   NUMBER(6),               OG_MAXIMUM_CONTAXISA
 scale     NUMBER(1,0),             OG_SCALE_CONTAXISA
 pct_of    NUMBER(1,0),             OG_PCTOF_CONTAXISA
 pct_by    NUMBER(1,0),             OG_PCTBY_CONTAXISA
 numfmt    VARCHAR2(255)            OG_NUMFMT_CONTAXISA
);
                                    OG_ALL_CONTAXISA
                                    OG_NONE_CONTAXISA

	Attribut	Description
SG	automin	Indique si la valeur de l'axe est définie à Auto.
SG	minimum	Valeur minimum de l'axe (si automin est défini à FALSE).
SG	autostep	Indique si la valeur de l'intervalle de l'axe est définie à Auto.
SG	step	Valeur de l'intervalle de l'axe (si autostep est défini à FALSE).
SG	automax	Indique si la valeur maximum de l'axe est définie à Auto.
SG	maximum	Valeur maximum de l'axe (si automax est défini à FALSE).
SG	scale	Algorithme utilisé pour la mise à l'échelle de l'axe. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_LINEAR_SCALE   Indique que l'axe est mis à l'échelle par utilisation d'un intervalle fixe entre les valeurs minimum et maximum de l'axe.
		OG_LOG_SCALE   Indique que l'axe est mis à l'échelle à l'aide d'un algorithme logarithmique (basé sur les puissances de 10) pour déterminer les intervalles entre les valeurs minimum et maximum de l'axe.
		OG_PCT_SCALE   Indique que l'axe est mis à l'échelle de sorte que les valeurs de données soient tracées par rapport au montant indiqué pct_of.
SG	pct_of	Facteur de mise à l'échelle relatif (si scale est défini à OG_PCT_SCALE).  La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_MAXIMUM_PCTOF   Indique que chaque valeur de données est tracée sous la forme d'un pourcentage de la plus grande valeur de données.
		OG_MINIMUM_PCTOF   Indique que chaque valeur de date et tracée sous la forme d'un pourcentage de la plus petite valeur de données.
		OG_SUM_PCTOF   Indique que chaque valeur de données est tracée sous la forme d'un pourcentage de la somme de toutes les valeurs de données.
SG	pct_by	Indique comment les valeurs de mise à l'échelle de pct_of sont calculées. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_CATEGORY_PCTBY   Indique que le pourcentage de chaque valeur de données est calculé par rapport aux valeurs de données du même champ d'autres catégories.
		OG_FIELD_PCTBY   Indique que le pourcentage de chaque valeur de données est calculé par rapport aux valeurs de données de la même catégorie d'autres champs.
SG	numfmt	Format numérique des étiquettes de graduation des axes. Cette information doit être une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.


Enregistrement d'attributs combinés d'axe de date

TYPE og_dateaxis_ca IS RECORD
(ca_axis  og_axis_attr,       /* axe générique */
 ca_date  og_dateaxis_attr   /* axe de date */
);


Enregistrement d'attributs d'axe de date

TYPE og_dateaxis_attr IS RECORD   Constantes de masque:
(mask       NUMBER(5,0),
 automin    BOOLEAN,              OG_MINIMUM_DATEAXISA
 minimum    DATE,                 OG_MINIMUM_DATEAXISA
 autostep   BOOLEAN,              OG_STEP_DATEAXISA
 step       NUMBER(2,0),          OG_STEP_DATEAXISA
 automax    BOOLEAN,              OG_MAXIMUM_DATEAXISA
 maximum    DATE,                 OG_MAXIMUM_DATEAXISA
 firstmon   NUMBER(2,0),          OG_FIRSTMON_DATEAXISA
 skipwknds  BOOLEAN,              OG_SKIPWKNDS_DATEAXISA
 labels     NUMBER(4,0),          OG_LABELS_DATEAXISA
 dayfmt     NUMBER(1,0),          OG_DAYFMT_DATEAXISA
 monthfmt   NUMBER(1,0),          OG_MONTHFMT_DATEAXISA
 qtrfmt     NUMBER(1,0),          OG_QTRFMT_DATEAXISA
 yearfmt    NUMBER(1,0),          OG_YEARFMT_DATEAXISA
 custfmt    VARCHAR2(255)         OG_CUSTMT_DATEAXISA
);
                                  OG_ALL_DATEAXISA
                                  OG_NONE_DATEAXISA

	Attribut	Description
SG	automin	Indique si la valeur du minimum de l'axe est définie à Auto.
SG	minimum	Valeur du minimum de l'axe (si automin est défini à FALSE).
SG	autostep	Indique si la valeur des intervalles de l'axe est définie à Auto.
SG	step	Valeur des intervalles de l'axe (si autostep est défini à FALSE). La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_SECOND_STEP
		OG_MINUTE_STEP
		OG_HOUR_STEP
		OG_DAY_STEP
		OG_WEEK_STEP
		OG_MONTH_STEP
		OG_QUARTER_STEP
		OG_YEAR_STEP
SG	automax	Indique si la valeur du maximum de l'axe est définie à Auto.
SG	maximum	Valeur du maximum de l'axe (si automax est défini à FALSE).
SG	firstmonth	Mois considéré comme le premier d'une nouvelle année. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_JAN_MONTH
		OG_FEB_MONTH
		OG_MAR_MONTH
		OG_APR_MONTH
		OG_MAY_MONTH
		OG_JUN_MONTH
		OG_JUL_MONTH
		OG_AUG_MONTH
		OG_SEP_MONTH
		OG_OCT_MONTH
		OG_NOV_MONTH
		OG_DEC_MONTH
SG	skipweekends	Indique si les week-ends sont pris en compte pour le calcul des valeurs d'axe.
SG	labels	Intervalle principal sur l'axe où les marques et les étiquettes de graduation principales s'affichent, ainsi que l'aspect des étiquettes de graduation. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_NO_LABELS
		OG_SECOND_LABELS
		OG_MINUTE_LABELS
		OG_HOUR_LABELS
		OG_AMPM_LABELS
		OG_DAY_LABELS
		OG_DAYOFWEEK_LABELS
		OG_WEEK_LABELS
		OG_MONTH_LABELS
		OG_QUARTER_LABELS
		OG_YEAR_LABELS
		OG_CUSTOM_LABELS   (Si labels est défini à cette valeur, vous devez indiquer le format de date personnalisé dans l'attribut customfmt.)
SG	dayfmt	Aspect sur l'axe des libellés de jour de la semaine. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_FIRSTLETTER_FMT
		OG_THREELETTER_FMT
SG	monthfmt	Aspect sur l'ace des libellés de mois. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_FIRSTLETTER_FMT
		OG_THREELETTER_FMT
SG	quarterfmt	Aspect sur l'axe des libellés de trimestre. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_ARABIC_FMT
		OG_ROMAN_FMT
SG	yearfmt	Aspect sur l'axe des libellés d'année. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_FOURDIGIT_FMT
		OG_TWODIGIT_FMT
SG	custfmt	Format de date personnalisé pour les étiquettes de graduation d'axe. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.


Enregistrement d'attributs combinés d'axe discret

TYPE og_discaxis_ca IS RECORD
(ca_axis  og_axis_attr,       /* axe générique */
 ca_disc  og_discaxis_attr   /* axe discret */
);


Enregistrement d'attributs d'axe discret

TYPE og_discaxis_attr IS RECORD       Constantes de masque:
(mask     NUMBER(3,0),
 automin  BOOLEAN,                    OG_MINCAT_DISCAXISA
 mincat   NUMBER(10,0),               OG_MINCAT_DISCAXISA
 automax  BOOLEAN,                    OG_MAXCAT_DISCAXISA
 maxcat   NUMBER(10,0),               OG_MAXCAT_DISCAXISA
 numfmt   VARCHAR2(255),              OG_NUMFMT_DISCAXISA
 datefmt  VARCHAR2(255)               OG_DATEFMT_DISCAXISA
);
                                      OG_ALL_DISCAXISA
                                      OG_NONE_DISCAXISA

	Attribut	Description
SG	automin	Indique si le nombre minimum de catégories qui s'affichent sur l'axe est défini à Auto.
SG	mincat	Nombre minimum de catégories qui s'affichent sur l'axe (si automin est défini à FALSE).
SG	automax	Indique si le nombre maximum de catégories qui s'affichent sur l'axe est défini à Auto.
SG	maxcat	Nombre maximum de catégories qui s'affichent sur l'axe (si automax est défini à FALSE).
SG	numfmt	Format numérique des étiquettes de graduation de l'axe. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.
SG	datefmt	Format de date des étiquettes de graduation d'axe. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.


Enregistrement d'attributs d'axe

TYPE og_axis_attr IS RECORD          Constantes de masque :
(mask          NUMBER(5,0),
 axistype      NUMBER(1,0),          OG_AXISTYPE_AXISA
 custlabel     VARCHAR2(255),        OG_CUSTLABEL_AXISA
 position      NUMBER(1,0),          OG_POSITION_AXISA
 direction     NUMBER(1,0),          OG_DIRECTION_AXISA
 tickpos       NUMBER(1,0),          OG_TICKPOS_AXISA
 ticklabelrot  NUMBER(1,0),          OG_TICKLABELROT_AXISA
 minorct       NUMBER(1,0),          OG_MINORCT_AXISA
 majorticks    BOOLEAN,              OG_MAJORTICKS_AXISA
 minorticks    BOOLEAN,              OG_MINORTICKS_AXISA
 majorgrid     BOOLEAN,              OG_MAJORGRID_AXISA
 minorgrid     BOOLEAN,              OG_MINORGRID_AXISA
 axislabel     BOOLEAN,              OG_AXISLABEL_AXISA
 ticklabels    BOOLEAN               OG_TICKLABELS_AXISA
);
                                     OG_ALL_AXISA
                                     OG_NONE_AXISA

	Attribut	Description
SG	axistype	La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_CONTINUOUS_AXISTYPE
		OG_DATE_AXISTYPE
		OG_DISCRETE_AXISTYPE
SG	custlabel	Texte de l'étiquette qui s'affiche le long de l'axe.
SG	position	Côté du graphique sur lequel s'affiche l'axe. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_BOTTOM_POSITION
		OG_LEFT_POSITION
		OG_RIGHT_POSITION
		OG_TOP_POSITION
SG	direction	Indique dans quel sens les valeurs croissantes ou les catégories successives s'affichent sur l'axe. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_DOWN_DIRECTION
		OG_LEFT_DIRECTION
		OG_RIGHT_DIRECTION
		OG_UP_DIRECTION
SG	tickpos	Indique comment les repères de graduation principaux et secondaires s'affichent. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_CROSS_TICKPOS
		OG_INSIDE_TICKPOS
		OG_OUTSIDE_TICKPOS
SG	ticklabelrot	La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_CCW_ROTATION
		OG_CW_ROTATION
		OG_NO_ROTATION
SG	minorct	Nombre de repères de graduation secondaires compris dans chaque intervalle de graduation principale.
SG	majorticks	Indique si les repères de graduation principaux s'affichent sur chaque intervalle principal.
SG	minorticks	Indique si repères de graduation secondaires s'affichent, en fonction de la valeur définie pour les graduations secondaires par intervalle.
SG	majorgrid	Indique si une ligne de grille s'affiche à chaque repère de graduation principal.
SG	minorgrid	Indique si une ligne de grille s'affiche à chaque repère de graduation secondaire.
SG	axislabel	Indique si les étiquettes identifiant les valeurs s'affichent sur l'axe.
SG	ticklabels	Indique si les étiquettes identifiant les valeurs s'affichent sur l'axe.


Enregistrement d'attributs combinés de graphique

Un graphique (diagramme) est considéré comme un objet groupe, composé de lignes, de rectangles, de texte, etc. L'enregistrement d'attributs combinés de graphique vous permet donc d'accéder aux attributs de groupe et aux attributs propres à un graphique. En outre, comme un graphique n'est pas en soi un objet graphique (bien que les objets qui le composent le soient), cet enregistrement ne permet pas d'accéder aux attributs graphiques. Pour définir les attributs graphiques des différents éléments d'un graphique, utilisez l'enregistrement d'attributs d'éléments de graphique décrit ci-dessous.

Cet enregistrement peut être utilisé pour accéder aux attributs d'un graphique dessiné manuellement sur la présentation, uniquement si le graphique a été déclaré dynamique. Si le graphique est un dessin, il est considéré comme un objet groupe et non comme un objet graphique. Un graphique créé par programme est un graphique dynamique.

L'enregistrement d'attributs combinés de graphique se compose d'un enregistrement d'attributs génériques, d'un enregistrement d'attributs de groupe et d'un enregistrement d'attributs de graphique :

TYPE og_chart_ca IS RECORD
(chart_caob  og_generic_attr,   /* générique */
 chart_caog  og_group_attr,     /* groupe */
 chart_caoc  og_chart_attr      /* graphique */
);


Enregistrement d'attributs de graphique

L'enregistrement d'attributs de graphique contient les attributs qui peuvent être utilisés uniquement avec les objets graphiques :

TYPE og_chart_attr IS RECORD        Constantes de masque :
(mask        NUMBER(4,0),
 frame       og_rectangle,          OG_FRAME_CHARTA
 template    og_template,           OG_TEMPLATE_CHARTA
 query       og_query,              OG_QUERY_CHARTA
 title       VARCHAR2(255),         OG_TITLE_CHARTA
 autoupdate  BOOLEAN,               OG_AUTOUPDATE_CHARTA
 rangeflag   BOOLEAN,               OG_ROWS_CHARTA
 startrow    NUMBER(10,0),          OG_ROWS_CHARTA
 endrow      NUMBER(10,0),          OG_ROWS_CHARTA
 filter      VARCHAR2(255)          OG_FILTER_CHARTA
);
                                    OG_ALL_CHARTA
                                    OG_NONE_CHARTA

	Attribut	Description
CSG	frame	Coordonnées x et y, hauteur et largeur du cadre du graphique (en unités de présentation).
CSG	template	Identificateur du modèle à utiliser pour le graphique.
CSG	query	Identificateur de l'interrogation à utiliser pour le graphique.
CSG	title	Titre du graphique.
CSG	autoupdate	Indique que le graphique doit être automatiquement mis à jour lorsque l'interrogation est exécutée.
CSG	rangeflag	Indique si le nombre de lignes d'interrogation qui s'affichent sur le graphique est limité à la plage spécifiée par startrow et endrow.
CSG	startrow	Première ligne de l'interrogation qui s'affiche sur le graphique. La première ligne de l'interrogation porte le numéro 0, la deuxième porte le numéro 1 et ainsi de suite.
CSG	endrow	Dernière ligne de l'interrogation qui s'affiche sur le graphique.
CSG	filter	Nom de la procédure de déclenchement du filtre d'interrogation.


Enregistrement d'attributs combinés d'éléments de graphique

Un élément de graphique (diagramme) est un objet graphique qui représente une seule valeur pour un champ. Par exemple, les barres et les secteurs sont des éléments graphiques. Cet enregistrement d'attributs combinés est utilisé avec la procédure OG_SET_ATTR pour modifier les attributs d'un élément de graphique.

L'enregistrement d'attributs combinés d'éléments de graphique se compose d'un enregistrement d'attributs graphiques et d'un enregistrement d'attributs d'éléments de graphique.

TYPE og_chelement_ca IS RECORD
(chelement_cagr  og_graphic_attr,    /* graphique */
 chelement_cace  og_chelement_attr   /* élément graphique */
);


Enregistrement d'attributs d'élément de graphique

L'enregistrement d'attributs d'éléments de graphique contient des attributs qui ne peuvent être utilisés qu'avec des éléments de graphique :

TYPE og_chelement_attr IS RECORD   Constantes de masque:
(mask       NUMBER(1,0),
 button     og_buttonproc,         OG_BUTTON_CHELEMENTA
 events     NUMBER(2,0),           OG_BUTTON_CHELEMENTA
 explosion  NUMBER(10,0),          OG_EXPLOSION_CHELEMENTA
 name       VARCHAR2(255)          OG_NAME_CHELEMENTA
);
                                   OG_ALL_CHELEMENTA
                                   OG_NONE_CHELEMENTA

	Attribut	Description
S	button	Identificateur de la procédure bouton qui doit être associée à cet élément de graphique. Notez que l'attribut events doit être défini correctement pour que cette procédure reçoive les événements de souris voulus.
S	events	Type d'événement de souris que la procédure bouton doit recevoir. La valeur de cet attribut peut être l'une des constantes intégrées énumérées ci-dessous. Pour que la procédure puisse recevoir plusieurs types d'événement, définissez cet attribut à la somme des constantes des événements souhaités.
		OG_NO_EVENTS   Indique que la procédure ne reçoit pas d'événements de souris.
		OG_MOUSE_DOWN   Indique que la procédure ne reçoit que les événements de bouton de souris enfoncé.
		OG_MOUSE_MOVE_DOWN   Indique que la procédure ne reçoit que les événements de mouvement bouton de souris enfoncé.
		OG_MOUSE_UP   Indique que la procédure ne reçoit que les événements de bouton de souris relâché.
		OG_MOUSE_MOVE_UP   Indique que la procédure ne reçoit que les événements de mouvement bouton de souris relâché.
S	explosion	Distance à laquelle l'élément de graphique (secteur, par exemple) doit être détaché, exprimée en pourcentage des rayons x et y du graphique. Cet attribut n'est significatif que lorsqu'il est utilisé avec un diagramme à secteurs. En outre, tous les secteurs d'une catégorie donnée seront détachés à la même distance. L'enregistrement d'attributs qui indique la valeur d'un détachement doit donc être associé à un champ indépendant.
S	name	Nom de l'élément graphique. Pour connaître le nom d'un élément de graphique, utilisez l'enregistrement d'attributs génériques.


Enregistrement d'attributs d'affichage

L'enregistrement d'attributs d'affichage contient des attributs qui ne peuvent être utilisés qu'avec l'affichage en cours.

TYPE og_display_attr IS RECORD	   Constantes de masque :
(mask          NUMBER(2,0),
 opentrigger   VARCHAR2(255),        OG_OPENTRIGGER_DISPLAYA
 closetrigger  VARCHAR2(255),        OG_CLOSETRIGGER_DISPLAYA
 width         NUMBER(10,0),         OG_SIZE_DISPLAYA
 height        NUMBER(10,0),         OG_SIZE_DISPLAYA
 dateformat    VARCHAR2(255)         OG_DATEFORMAT_DISPLAYA
);
                                     OG_ALL_DISPLAYA
                                     OG_NONE_DISPLAYA

	Attribut	Description
SG	opentrigger	Nom du déclencheur d'affichage Open Display.
SG	closetrigger	Nom du déclencheur d'affichage Close Display.
SG	width	Largeur de la présentation (en unités de présentation)
SG	height	Hauteur de la présentation (en unités de présentation).
SG	dateformat	Format de date des paramètres. Vous devez indiquer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.


Enregistrement d'attributs combinés de modèle de champ d'axe

TYPE og_axisftemp_ca IS RECORD
(ca_ftemp   og_ftemp_attr,     /* modèle de champ générique */
 ca_aftemp  og_axisftemp_attr  /* modèle de champ d'axe */
);


Enregistrement d'attributs de modèle de champ d'axe

TYPE og_axisftemp_attr IS RECORD   Constantes de masque:
(mask       NUMBER(3,0),
 plottype   NUMBER(3,0),           OG_PLOTTYPE_AXISFTEMPA
 linestyle  NUMBER(1,0),           OG_LINESTY_AXISFTEMPA
 labelrot   NUMBER(1,0),           OG_LABELROT_AXISFTEMPA
 plotpos    NUMBER(1,0),           OG_PLOTPOS_AXISFTEMPA
 overlap    NUMBER(3),             OG_OVERLAP_AXISFTEMPA
 axis       NUMBER(1,0),           OG_AXIS_AXISFTEMPA
 curvefit   NUMBER(1,0)            OG_CURVEFIT_AXISFTEMPA
);
                                   OG_ALL_AXISFTEMPA
                                   OG_NONE_AXISFTEMPA

	Attribut	Description
SG	plottype	Eléments utilisés pour tracer ce champ sur le graphique. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_NONE_PLOTTYPE
		OG_BAR_PLOTTYPE
		OG_LINE_PLOTTYPE
		OG_SYMBOL_PLOTTYPE
		OG_FILL_PLOTTYPE
		OG_SPIKE_PLOTTYPE
		OG_LABEL_PLOTTYPE
SG	linestyle	Style de ligne utilisé pour relier les points de données d'un champ à un type de tracé de ligne. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_SPLINE_LINESTYLE
		OG_STEP_LINESTYLE
		OG_STRAIGHT_LINESTYLE
SG	labelrot	Angle de rotation des étiquettes d'un champ de type de tracé d'étiquette. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
SG	plotpos	Indique - pour chaque catégorie - la relation entre les valeurs de données de plusieurs champs. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_NORMAL_PLOTPOS
		OG_FROMPREV_PLOTPOS
		OG_STACKED_PLOTPOS
SG	overlap	Pourcentage de chevauchement des barres représentant des valeurs de données de plusieurs champs d'un graphique en barres ou en colonnes.
SG	axis	Axe auquel les valeurs de données sont comparées pour déterminer la manière dont le champ est tracé. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_X_AXIS
		OG_Y1_AXIS
		OG_Y2_AXIS
SG	curvefit	Indique si un ajustement de courbe est appliqué au graphique et, dans l'affirmative, l'algorithme qui est utilisé. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_NO_CURVEFIT
		OG_LINEAR_CURVEFIT
		OG_LOG_CURVEFIT
		OG_EXP_CURVEFIT
		OG_POWER_CURVEFIT


Enregistrement d'attributs de modèle de champ

TYPE og_ftemp_attr IS RECORD           Constantes de masque :
(mask      NUMBER(3,0),
 name      VARCHAR2(255),              OG_NAME_FTEMPA
 root      OG_OBJECT,                  OG_ROOT_FTEMPA
 colorrot  NUMBER(1,0),                OG_COLORROT_FTEMPA
 numfmt    VARCHAR2(255),              OG_NUMFMT_FTEMPA
 datefmt   VARCHAR2(255)               OG_DATEFMT_FTEMPA
);
                                       OG_ALL_FTEMPA
                                       OG_NONE_FTEMPA

	Attribut	Description
SG	name	Nom du modèle de champ.
G	root	Identificateur du modèle de graphique auquel appartient le modèle de champ.
SG	colorrot	Indique si Graphics Builder effectue automatiquement une rotation de la palette de couleurs ou de motifs pour sélectionner une teinte particulière pour chaque champ qui utilise ce modèle de champ. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_NO_COLORROT
		OG_AUTO_COLORROT
		OG_COLOR_COLORROT
		OG_PATTERN_COLORROT
		OG_BOTH_COLORROT
SG	numfmt	Format numérique des étiquettes de champ. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference
SG	datefmt	Format de date des étiquettes de champ. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference


Enregistrement d'attributs combinés d'encadrement d'axe

TYPE og_axisframe_ca IS RECORD
(ca_frame  og_frame_attr,       /* cadre générique */
 ca_axis   og_axisframe_attr    /* encadrement d'axe */
);


Enregistrement d'attributs d'encadrement d'axe

TYPE og_axisframe_attr IS RECORD   Constantes de masque :
(mask       NUMBER(3,0),
 reflinect  NUMBER(3,0),           OG_REFLINECT_AXISFRAMEA
 basevalue  NUMBER(1,0),           OG_BASEVALUE_AXISFRAMEA
 cust_num   NUMBER(6),             OG_BASEVALUE_AXISFRAMEA
 cust_date  DATE,                  OG_BASEVALUE_AXISFRAMEA
 base_axis  NUMBER(1,0),           OG_BASEAXIS_AXISFRAMEA
 catwidth   NUMBER(3,0),           OG_CATWIDTH_AXISFRAMEA
 second_y   BOOLEAN                OG_SECONDY_AXISFRAMEA
);
                                   OG_ALL_AXISFRAMEA
                                   OG_NONE_AXISFRAMEA

	Attribut	Description
G	reflinect	Nombre de lignes de référence appartenant au modèle de graphique.
SG	baseline_value	Valeur utilisée comme point de départ du traçage des champs le sur l'axe des valeurs. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_MIN_BASELINE
		OG_MAX_BASELINE
		OG_ZERO_BASELINE
		OG_CUSTOM_BASELINE
SG	custom_num	Nombre personnalisé à définir pour la ligne de base. Ce nombre définit automatiquement la valeur de base à OG_CUSTOM_BASELINE.
SG	custom_date	Date personnalisé à définir pour la valeur de date personnalisée. Cette date définit automatiquement la valeur de base à OG_CUSTOM_BASELINE.
SG	baseline_axis	Axe auquel la valeur de la ligne de base est comparée pour déterminer sa position.
SG	catwidth	Largeur des barres d'un graphique en barres ou en colonnes, en pourcentage de la "largeur des bandes". Cette valeur correspond à la plus grande largeur que peuvent avoir les barres sans se chevaucher, et est déterminée par la division de la longueur de l'axe des catégories par le nombre de barres à tracer.
SG	second_y	Indique si le graphique doit comporter un deuxième axe Y.


Enregistrement d'attributs d'encadrement

TYPE og_frame_attr IS RECORD       Constantes de masque :
(mask         NUMBER(4,0),
 name         VARCHAR2(255),       OG_NAME_FRAMEA
 frametype    NUMBER(1,0),         OG_FRAMETYPE_FRAMEA
 ftempct      NUMBER(5,0),         OG_FTEMPCT_FRAMEA
 root         OG_OBJECT,           OG_ROOT_FRAMEA
 depthsize    NUMBER(1,0),         OG_DEPTHSIZE_FRAMEA
 shadowsize   NUMBER(1,0),         OG_SHADOWSIZE_FRAMEA
 shadowdir    NUMBER(1,0),         OG_SHADOWDIR_FRAMEA
 plotframe    BOOLEAN,             OG_PLOTFRAME_FRAMEA
 legend       BOOLEAN,             OG_LEGEND_FRAMEA
 legendcolct  NUMBER(3,0)          OG_LEGENDCOLCT_FRAMEA
);
                                   OG_ALL_FRAMEA
                                   OG_NONE_FRAMEA

	Attribut	Description
SG	name	Nom du modèle de graphique.
G	frametype	Type du graphique représenté par ce modèle. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_AXIS_FRAMETYPE
		OG_PIE_FRAMETYPE
		OG_TABLE_FRAMETYPE
G	ftempct	Nombre de modèles de champ appartenant au modèle de graphique.
G	root	Identificateur du modèle de graphique.
SG	depthsize	Profondeur suivant laquelle l'encadrement et les éléments du graphique doivent être dessinés pour donner un aspect tridimensionnel. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_NONE_DEPTHSIZE
		OG_SMALL_DEPTHSIZE
		OG_MEDIUM_DEPTHSIZE
		OG_LARGE_NONE_DEPTHSIZE
		OG_XLARGE_DEPTHSIZE
SG	shadowsize	Taille de l'ombre de l'encadrement et des éléments du graphique. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_NONE_SHADOWSIZE
		OG_SMALL_SHADOWSIZE
		OG_MEDIUM_SHADOWSIZE
		OG_LARGE_SHADOWSIZE
		OG_XLARGE_SHADOWSIZE
SG	shadowdir	Orientation de l'ombre de l'encadrement et des éléments du graphique. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_UPPERRIGHT_SHADOWDIR
		OG_UPPERLEFT_SHADOWDIR
		OG_LOWERRIGHT_SHADOWDIR
		OG_LOWERLEFT_SHADOWDIR
SG	plotframe	Indique si le rectangle qui entoure le graphique doit être affiché (ne s'applique pas aux graphiques à secteurs).
SG	legend	Indique si la légende du graphique doit être affichée  (ne s'applique pas aux graphiques en tableaux).
SG	legendcolct	Nombre de colonnes utilisées pour afficher les étiquettes figurant dans la légende.


Enregistrement d'attributs combinés d'encadrement de graphique à secteurs

TYPE og_pieframe_ca IS RECORD
(ca_frame  og_frame_attr,     /* cadre générique */
 ca_pie   og_pieframe_attr   /* encadreemnt de graphique à secteurs */
);


Enregistrement d'attributs d'encadrement de graphique à secteurs

TYPE og_pieframe_attr IS RECORD   Constantes de masque :
(mask        NUMBER(3,0),
 usage       NUMBER(1,0),         OG_USAGE_PIEFRAMEA
 usagevalue  NUMBER(6),           OG_USAGE_PIEFRAMEA
 plotorder   NUMBER(1,0),         OG_PLOTORDER_PIEFRAMEA
 categs      BOOLEAN,             OG_CATEGS_PIEFRAMEA
 datavals    BOOLEAN,             OG_DATAVALS_PIEFRAMEA
 pctvalues   BOOLEAN,             OG_PCTVALUES_PIEFRAMEA
 ticks       BOOLEAN,             OG_TICKS_PIEFRAMEA
 other       NUMBER(3),           OG_OTHER_PIEFRAMEA
 nooverlap   BOOLEAN,             OG_NOOVERLAP_PIEFRAMEA
 catnumfmt   VARCHAR2(255),       OG_CATNUMFMT_PIEFRAMEA
 catdatefmt  VARCHAR2(255),       OG_CATDATEFMT_AXSFRAMEA
 valuefmt    VARCHAR2(255),       OG_VALUEFMT_PIEFRAMEA
 pctfmt      VARCHAR2(255)        OG_PCTFMT_PIEFRAMEA
);
                                  OG_ALL_PIEFRAMEA
                                  OG_NONE_PIEFRAMEA

	Attribut	Description
SG	usage	Indique la relation entre les différents secteurs et l'ensemble du graphique. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_TOTALVALUE_USAGE
		OG_PCT_USAGE
SG	usagevalue	Chaque secteur est tracé comme si sa valeur de données était un pourcentage de la valeur totale indiquée ici (valide uniquement si usage est défini à OG_TOTALVALUE_USAGE.
SG	plotorder	Direction dans laquelle les valeurs de données sont tracées. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_CCW_PLOTORDER
		OG_CW_PLOTORDER
SG	categs	Indique si chaque secteur de graphique comporte une étiquette indiquant le nom de la catégorie qu'il représente.
SG	datavals	Indique si chaque secteur comporte une étiquette  indiquant sa valeur de données.
SG	pctvalues	Indique si chaque secteur comporte une étiquette indiquant le pourcentage du graphique qu'il représente.
SG	ticks	Indique si les repères de graduation qui relient chaque secteur du graphique à son étiquette sont affichés.
SG	other	Indique que les secteurs qui représentent individuellement des pourcentages inférieurs à la valeur entrée ici sont combinés en un seul secteur portant la mention "Autres".
SG	nooverlap	Indique que les étiquettes des secteurs du graphique ne doivent pas se chevaucher.
SG	catnumfmt	Format numérique des étiquettes des catégories. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.
SG	catdatefmt	Format de date des étiquettes de catégorie. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.
SG	valuefmt	Format numérique des étiquettes de valeur de données. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.
SG	pctfmt	Format numérique des étiquettes de valeur de pourcentage. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.


Enregistrement d'attributs combinés d'encadrement de table

TYPE og_tableframe_ca IS RECORD
(ca_frame  og_frame_attr,       /* encadrement générique */
 ca_table  og_tableframe_attr   /* encadrement de table */
);


Enregistrement d'attributs d'encadrement de table

TYPE og_tableframe_attr IS RECORD   Constantes de masque :
(mask     NUMBER(3,0),
 automin  BOOLEAN,                  OG_MIN_TABLEFRAMEA
 minrows  NUMBER(10,0),             OG_MIN_TABLEFRAMEA
 automax  BOOLEAN,                  OG_MAX_TABLEFRAMEA
 maxrows  NUMBER(10,0),             OG_MAX_TABLEFRAMEA
 cname    BOOLEAN,                  OG_CNAME_TABLEFRAMEA
 vgrid    BOOLEAN,                  OG_VGRID_TABLEFRAMEA
 hgrid    BOOLEAN,                  OG_HGRID_TABLEFRAMEA
 gridct   NUMBER(10,0)              OG_GRIDCT_TABLEFRAMEA
);
                                    OG_ALL_TABLEFRAMEA
                                    OG_NONE_TABLEFRAMEA

	Attribut	Description
SG	automin	Indique si le nombre minimum de lignes figurant sur le graphique est défini à Auto.
SG	minrows	Nombre minimum de lignes figurant dans le graphique (si automin est défini à FALSE).
SG	automax	Indique si le nombre maximum de lignes figurant sur le graphique est défini à Auto.
SG	maxrows	Nombre maximum de lignes figurant dans le graphique (si automax est défini à FALSE).
SG	colnames	Indique si le nom des colonnes constitue la première ligne du graphique.
SG	vgrid	Indique si les colonnes doivent être séparées par des lignes de séparation verticales.
SG	hgrid	Indique si les lignes doivent être séparées par des lignes de séparation horizontales.
SG	gridct	Nombre de lignes de données entre deux lignes de séparation horizontales (si hgrid est défini à TRUE).


Enregistrement d'attributs génériques

L'enregistrement d'attributs génériques contient des attributs qui peuvent être utilisés avec chaque objet.

TYPE og_generic_attr IS RECORD    Constantes de masque :
(mask       NUMBER(6,0),
 name       VARCHAR2(255),          OG_NAME_GENERICA
 parent     og_object,              OG_PARENT_GENERICA
 ibbox      og_rectangle,           OG_IBBOX_GENERICA
 obbox      og_rectangle,           OG_OBBOX_GENERICA
 objtype    NUMBER(2,0),            OG_OBJTYPE_GENERICA
 button     og_buttonproc,          OG_BUTTON_GENERICA
 events     NUMBER(2,0),            OG_EVENTS_GENERICA
 keycol     VARCHAR2(255,           OG_KEYCOL_GENERICA
 execquery  og_query,               OG_EXECQUERY_GENERICA
 setparam   VARCHAR2(255),          OG_SETPARAM_GENERICA
 fmttrig    VARCHAR2(255),          OG_FMTTRIG_GENERICA
 hide       BOOLEAN                 OG_HIDE_GENERICA
);
                                    OG_ALL_GENERICA
                                    OG_NONE_GENERICA

	Attribut	Description
CSG	name	Nom de l'objet.
CG	parent	Identificateur de l'objet père de l'objet.
G	ibbox	Boîte englobante intérieure de l'objet, c'est-à-dire le rectangle qui constitue la forme idéale de l'objet (reliant les quatre points de contrôle de l'objet), quelles que soient l'épaisseur des bords ou les autres définitions d'attributs.
G	obbox	Boîte englobante extérieure de l'objet, c'est-à-dire le plus petit rectangle qui entoure complètement l'objet. Cette boîte peut être différente de la boîte englobante intérieure si l'objet a un bord épais. Alors que la boîte englobante intérieure ne trace que la forme idéale de l'objet, la boîte englobante extérieure entoure tout l'objet.
G	objtype	Type de l'objet La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_ARC_OBJTYPE   Indique que l'objet est un arc.
		OG_CHART_OBJTYPE Indique que l'objet est un graphique.
		OG_GROUP_OBJTYPE Indique que l'objet est un groupe.
		OG_IMAGE_OBJTYPE Indique que l'objet est une image.
		OG_LINE_OBJTYPE Indique que l'objet est un trait.
		OG_POLY_OBJTYPE Indique que l'objet est un polygone ou une ligne polygonale.
		OG_RECT_OBJTYPE Indique que l'objet est un rectangle.
		OG_RRECT_OBJTYPE Indique que l'objet est un rectangle arrondi.
		OG_SYMBOL_OBJTYPE Indique que l'objet est un symbole.
		OG_TEXT_OBJTYPE Indique que l'objet est un objet texte.
CSG	button	Identificateur de la procédure bouton à associer à cet objet. Notez que l'attribut d'événement doit être défini correctement pour que cette procédure reçoive les événements souris voulus.
CSG	events	Type d'événements souris que la procédure indiquée par l'attribut button doit recevoir. La valeur de cet attribut peut être l'une des constantes intégrées indiquées ci-dessous. Pour autoriser la procédure à recevoir plusieurs types d'événements, définissez ces attributs à la somme des constantes des événements voulus.
		OG_NO_EVENTS   Indique que la procédure ne reçoit pas d'événement de souris.
		OG_MOUSE_DOWN   Indique que la procédure ne reçoit que les événements bouton souris enfoncé.
		OG_MOUSE_UP Indique que la procédure ne reçoit que les événements bouton souris relâché.
		OG_MOUSE_MOVE_UP   indique que la procédure ne reçoit que les événements de mouvement bouton souris relâché.
CSG	keycol	Colonne à définir dans un graphique de hiérarchisation vers le bas. Cet attribut ne s'applique qu'aux éléments graphiques.
CSG	execquery	Interrogation à exécuter lorsque l'utilisateur sélectionne l'objet.
CSG	setparam	Paramètre dont la valeur est définie lorsque l'utilisateur sélectionne l'objet.
CSG	fmttrig	Déclencheur de format. Cet attribut ne s'applique qu'aux éléments de graphique.
SG	hide	Masque l'objet Graphics Builder indiqué.


Enregistrement d'attributs combinés graphique
Enregistrement d'attributs combinés graphiques

L'enregistrement d'attributs combinés graphiques se compose d'un enregistrement d'attributs génériques et d'un enregistrement d'attributs graphiques :

TYPE og_graphic_ca IS RECORD
(graphic_caob  og_generic_attr,   /* générique */
 graphic_caoh  og_graphic_attr    /* graphique */
);


Enregistrement d'attributs graphiques

L'enregistrement d'attributs graphiques contient des attributs qui ne peuvent être utilisés qu'avec des objets graphiques :

TYPE og_graphic_attr IS RECORD     Constantes de masque :
(mask        NUMBER(4,0),
 ewidth      NUMBER(10,0),         OG_EWIDTH_GRAPHICA
 rotang      NUMBER(5,2),          OG_ROTANG_GRAPHICA
 fecolor     VARCHAR2(255),        OG_FECOLOR_GRAPHICA
 becolor     VARCHAR2(255),        OG_BECOLOR_GRAPHICA
 edgepatt    VARCHAR2(255),        OG_EDGEPATT_GRAPHICA
 ffcolor     VARCHAR2(255),        OG_FFCOLOR_GRAPHICA
 bfcolor     VARCHAR2(255),        OG_BFCOLOR_GRAPHICA
 fillpatt    VARCHAR2(255),        OG_FILLPATT_GRAPHICA
 dashstyle   NUMBER(1,0),          OG_DASHSTYLE_GRAPHICA
 capstyle    NUMBER(2,0),          OG_CAPSTYLE_GRAPHICA
 joinstyle   NUMBER(2,0),          OG_JOINSTYLE_GRAPHICA
 transfer    NUMBER(1,0)           OG_TRANSFER_GRAPHICA
 bevelstyle  NUMBER(2,0)           OG_BEVELSTYLE_GRAPHICA
);
                                   OG_ALL_GRAPHICA
                                   OG_NONE_GRAPHICA

	Attribut	Description
CSG	ewidth	Largeur du bord de l'objet (en unités de présentation).
CSG	rotang	Angle de rotation de l'objet. L'angle auquel l'objet est initialement créé est considéré comme ayant la valeur 0, et cet attribut indique le nombre de degrés, dans le sens contraire des aiguilles d'une montre dont l'objet diffère de cet angle initial. Vous pouvez faire pivoter un objet suivant un angle absolu en définissant cet attribut, ou utiliser la procédure OG_ROTATE pour faire pivoter un objet suivant un angle relatif (Notez que lorsque vous utilisez OG_ROTATE pour faire pivoter un objet, l'attribut rotang est mis à jour automatiquement pour refléter le nouvel angle absolu.
CSG	fecolor	Couleur du premier plan du bord de l'objet. Pour plus d'informations sur les palettes de couleurs valides, reportez vous à Palettes de couleurs par défaut .
CSG	becolor	Couleur de l'arrière-plan du bord de l'objet. Pour plus d'informations sur les noms de couleur valides, reportez-vous à Palettes de couleurs par défaut .
CSG	edgepatt	Motif du bord de l'objet. Pour plus d'informations sur les noms de motif valides, reportez-vous à Palette de motifs .
CSG	ffcolor	Couleur de remplissage du premier plan de l'objet. Pour plus d'informations sur les noms de couleur valides, reportez-vous à Palettes de couleurs par défaut .
CSG	bfcolor	Couleur de remplissage de l'arrière-plan de l'objet. Pour plus d'informations sur les noms de couleur valides, reportez-vous à Palettes de couleurs par défaut .
CSG	fillpatt	Motif de remplissage de l'objet. Pour plus d'informations sur les noms de motif valides, reportez-vous à Palette de motifs.
CSG	dashstyle	Style de pointillé du bord de l'objet. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_SOLID_DSTYLE   Indique une ligne pleine.
		OG_DOT_DSTYLE   Indique une ligne en pointillés.
		OG_LONG_DSTYLE   Indique une ligne constituée de tirets longs.
		OG_DASHDOT_DSTYLE   Indique une ligne constituée d'une succession de tirets et de points.
		OG_DOTDOT_DSTYLE   Indique une ligne constituée d'une série de deux points consécutifs.
		OG_SHORT_DSTYLE   Indique une ligne constituée d'une série de tirets courts.
		OG_DASHDOTDOT_DSTYLE   Indique une ligne constituée d'une série de tirets suivis de deux points.
CSG	capstyle	Type d'extrémité du bord de l'objet. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_BUTT_CSTYLE   Indique une extrémité de type bout à bout.
		OG_PROJECTING_CSTYLE   Indique une extrémité de type projection.
		OG_ROUND_CSTYLE   Indique une extrémité de style arrondi.
CSG	joinstyle	Style de jointure des bords de l'objet. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_MITRE_JSTYLE   Indique une jointure de style angle droit.
		OG_BEVEL_JSTYLE   Indique une jointure de style biseau.
		OG_ROUND_JSTYLE   Indique une jointure de style arrondi.
CSG	transfer	Mode de transfert de l'objet. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_COPY_TRANSFER   Indique que le mode de transfert est copy.
		OG_REVCOPY_TRANSFER Indique que le mode de transfert est reverse copy.
		OG_OR_TRANSFER Indique que le mode de transfert est or.
		OG_REVOR_TRANSFER Indique que le mode de transfert est reverse or.
		OG_CLEAR_TRANSFER Indique que le mode de transfert est clear.
		OG_REVCLEAR_TRANSFER Indique que le mode de transfert est reverse clear.
		OG_INVERT_TRANSFER Indique que le mode de transfert est invert.
		OG_BACKINVERT_TRANSFER Indique que le mode de transfert est background invert.
CSG	bevelstyle	Style de relief de l'objet. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_INSET_BSTYLE   Indique un relief incrusté.
		OG_LOWERED_BSTYLE   Indique un relief enfoncé.
		OG_OUTSET_BSTYLE   Indique un relief ressorti.
		OG_PLAIN_BSTYLE   Indique que l'objet n'a pas de relief.
		OG_RAISED_BSTYLE   Indique un relief relâché.


Enregistrement d'attributs combinés de groupe

L'enregistrement d'attributs combinés de groupe se compose d'un enregistrement d'attributs génériques et d'un enregistrement d'attributs de groupe :

TYPE og_group_ca IS RECORD
(group_caob  og_generic_attr,   /* générique */
 group_caog  og_group_attr      /* groupe */
);


Enregistrement d'attributs de groupe

L'enregistrement d'attributs de groupe contient des attributs qui ne peuvent être utilisés qu'avec des objets groupe.

TYPE og_group_attr IS RECORD        Constantes de masque :
(mask        NUMBER(1,0),
 childcount  NUMBER(10,0),          OG_CHILDCOUNT_GROUPA
 clipflag    BOOLEAN                OG_CLIPFLAG_GROUPA
);
                                    OG_ALL_GROUPA
                                    OG_NONE_GROUPA

	Attribut	Description
G	childcount	Nombre de fils qui appartiennent à l'objet groupe. Si un autre objet groupe est un fils du groupe en cours de vérification, cet objet ne sera compté que comme un objet.
CSG	clipflag	Indique si le premier objet du groupe est un objet rectangle qui devra être utilisé comme un rectangle clipping. Si le fichier d'attributs a la valeur TRUE, les seuls membres du groupe qui apparaissent dans la présentation sont les objets - ou les parties de ces objets - qui apparaissent dans les limites du rectangle clipping. L'objet rectangle lui-même apparaît également. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que le premier objet du groupe est considéré comme un rectangle clipping.
		FALSE   Indique que le premier objet du groupe n'est pas considéré comme un rectangle clipping.


Enregistrement d'attributs combinés d'image

L'enregistrement d'attributs combinés d'image se compose d'un enregistrement d'attributs génériques et d'un enregistrement d'attributs d'image.

TYPE og_image_ca IS RECORD
(image_caob  og_generic_attr,   /* générique */
 image_caoi  og_image_attr      /* image */
);


Enregistrement d'attributs d'image

L'enregistrement d'attributs d'image contient des attributs qui ne peuvent être utilisés qu'avec des objets image :

TYPE og_image_attr IS RECORD          Constantes de masque :
(mask        NUMBER(3,0),
 cliprect    og_rectangle,            OG_CLIPRECT_IMAGEA
 upperleft   og_point,                OG_UPPERLEFT_IMAGEA
 width       NUMBER(10,0),            OG_SIZE_IMAGEA
 height      NUMBER(10,0),            OG_SIZE_IMAGEA
 query       og_query,                OG_DATA_IMAGEA
 which_data  NUMBER(1,0),             OG_DATA_IMAGEA
 colname     VARCHAR2(255),           OG_DATA_IMAGEA
 quality     NUMBER(5,0),             OG_QUALITY_IMAGEA
 dither      BOOLEAN                  OG_DITHER_IMAGEA
);
                                      OG_ALL_IMAGEA
                                      OG_NONE_IMAGEA

	Attribut	Description
SG	cliprect	Coordonnées x et y, hauteur et largeur du rectangle clipping de l'image (en unités de présentation). Seule la partie de l'image qui se trouve dans ce rectangle sera affichée. Si cet attribut n'est pas affiché, le rectangle clipping sera égal aux dimensions complètes de l'image.
SG	upperleft	Coordonnées x et y de l'angle supérieur gauche de l'image (en unités de présentation).
SG	width	Largeur de l'image (en unités de présentation). Si vous définissez cet attribut à une valeur autre que la largeur par défaut de l'image, l'image sera mise à l'échelle en fonction de la nouvelle largeur.
SG	height	Hauteur de l'image (en unités de présentation). Si vous définissez cet attribut à une valeur autre que la hauteur par défaut de l'image, l'image sera mise à l'échelle en fonction de la nouvelle hauteur.
C	query	Identificateur de l'interrogation qui extrait l'image d'une table d'une base de données. Notez que cette table doit être une table utilisateur et non l'une des tables privées utilisées par Graphics Builder lorsque vous enregistrez ou exportez dans la base de données un affichage, un dessin, un modèle de graphique, une palette de couleurs, une image ou un son. Seules les images Oracle Format peuvent être stockées dans la base de données.
C	which_data	Indique si l'image à créer se trouve dans le nouvel ensemble de données d'une interrogation, ou dans l'ancien. Graphics Builder offre deux constantes numériques intégrées qui peuvent être utilisées comme valeurs de cet attribut :
		OG_NEWDATA   Indique que l'image se trouve dans le nouvel ensemble de données de l'interrogation.
		OG_OLDDATA   Indique que l'image se trouve dans l'ancien ensemble de données de l'interrogation.
C	colname	Nom de la colonne d'interrogation qui contient les données de l'image. L'image qui est créée est celle qui se trouve dans la cellule d'interrogation à l'intersection de la colonne indiquée par cet attribut et de la ligne pointée par le curseur de l'interrogation.
CSG	quality	Qualité du dessin de l'image. Plus la qualité est élevée, plus l'image est précise, mais plus il faut de temps pour la manipuler (par exemple, pour la dessiner, la déplacer, la mettre à l'échelle, etc.). La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_HIGH_IQUALITY   Indique que la qualité est élevée.
		OG_MED_IQUALITY   Indique que la qualité est moyenne.
		OG_LOW_IQUALITY   Indique que la qualité est faible.
CSG	dither	Indique si Graphics Builder trame l'image lorsqu'il l'affiche. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que l'image est tramée.
		FALSE   Indique que l'image n'est pas tramée.


Enregistrement d'attributs combinés de ligne

L'enregistrement d'attributs combinés de ligne se compose d'un enregistrement d'attributs génériques, d'un enregistrement d'attributs graphiques et d'un enregistrement d'attributs de ligne.

TYPE og_line_ca IS RECORD
(line_caob  og_generic_attr,   /* générique */
 line_caoh  og_graphic_attr,   /* graphique */
 line_caol  og_line_attr       /* ligne */
);


Enregistrement d'attributs de ligne

L'enregistrement d'attributs de ligne contient des attributs qui ne peuvent être utilisés qu'avec des objets ligne :

TYPE og_line_attr IS RECORD           Constantes de masque :
(mask        NUMBER(1,0),
 startpt     og_point,                OG_STARTPT_LINEA
 endpt       og_point,                OG_ENDPT_LINEA
 arrowstyle  NUMBER(1,0)              OG_ARROWSTYLE_LINEA
);
                                      OG_ALL_LINEA
                                      OG_NONE_LINEA

	Attribut	Description
CSG	startpt	Coordonnées x et y du point de départ de la ligne (en unités de présentation)
CSG	endpt	Coordonnées x et y du point final de la ligne (en unités de présentation).
CSG	arrowstyle	Style de flèche de la ligne. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_NOARROW_ASTYLE   Indique que la ligne ne comporte pas de flèche.
		OG_START_ASTYLE   Indique que la ligne comporte une flèche à son point de départ.
		OG_END_ASTYLE   Indique que la ligne comporte une flèche à son point final.
		OG_BOTH_ASTYLE   Indique que la ligne comporte une flèche à ses deux extrémités.
		OG_MIDTOSTART_ASTYLE   Indique que la ligne comporte, en son milieu, une flèche qui pointe vers le point de départ.
		OG_MIDTOEND_ASTYLE   Indique que la ligne comporte, en son milieu, une flèche qui pointe vers le point final.


Enregistrement d'attributs combinés de polygone

L'enregistrement d'attributs combinés de polygone se compose d'un enregistrement d'attributs génériques, d'un enregistrement d'attributs graphiques et d'un enregistrement d'attributs de polygone.

TYPE og_poly_ca IS RECORD
(poly_caob  og_generic_attr,   /* générique */
 poly_caoh  og_graphic_attr,   /* graphique */
 poly_caop  og_poly_attr       /* polygonal */
);


Enregistrement d'attributs de polygone

L'enregistrement d'attributs de polygone contient des attributs qui ne peuvent être utilisés qu'avec des objets polygone.

TYPE og_poly_attr IS RECORD               Constantes de masque :
(mask     NUMBER(1,0),
 pointct  NUMBER(10,0),                   OG_POINTCT_POLYA
 closed   BOOLEAN                         OG_CLOSED_POLYA
);
                                          OG_ALL_POLYA
                                          OG_NONE_POLYA

	Attribut	Description
G	pointct	Nombre de points composant l'objet polygone.
CSG	closed	Fermeture du polygone. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que le polygone est fermé.
		FALSE   Indique que le polygone est ouvert.


Enregistrements d'attributs d'imprimante

TYPE og_printer_attr IS RECORD      Constantes de masque :
(mask       NUMBER(3,0),
 name       VARCHAR2(255),          OG_NAME_PRINTERA
 landscape  BOOLEAN,                OG_LANDSCAPE_PRINTERA
 startpage  NUMBER(5,0),            OG_STARTPAGE_PRINTERA
 endpage    NUMBER(5,0),            OG_ENDPAGE_PRINTERA
 width      NUMBER(10,0),           OG_WIDTH_PRINTERA
 height     NUMBER(10,0),           OG_HEIGHT_PRINTERA
 copies     NUMBER(5,0),            OG_COPIES_PRINTERA
 printfile  VARCHAR2(255)           OG_PRINTFILE_PRINTERA
);
                                    OG_ALL_PRINTERA
                                    OG_NONE_PRINTERA

	Attribut	Description
SG	name	Nom de l'imprimante en cours.
SG	landscape	Indique si l'affichage est imprimé en mode portrait ou en mode paysage.
SG	startpage	Première page à imprimer.
SG	endpage	Dernière page à imprimer.
S	width	Largeur de la page.
S	height	Hauteur de la page.
SG	copies	Nombre de copies à imprimer.
SG	printfile	Nom du fichier PostScript dans lequel sera effectuée l'impression. Si cette propriété est définie à NULL, la sortie est envoyée à l'imprimante.


Enregistrement d'attributs d'interrogation

L'enregistrement d'attributs d'interrogation contient des attributs qui ne peuvent être utilisés qu'avec des interrogations :

TYPE og_query_attr IS RECORD       Constantes de masque :
(mask         NUMBER(4,0),
 name         VARCHAR2(255),       OG_NAME_QUERYA
 dateformat   VARCHAR2(255),       OG_DATEFORMAT_QUERYA
 querysource  VARCHAR2(2000),      OG_QUERYSOURCE_QUERYA
 querytype    NUMBER(1,0),         OG_QUERYTYPE_QUERYA
 cachetype    NUMBER(1,0),         OG_CACHETYPE_QUERYA
 maxflag      BOOLEAN,             OG_MAXFLAG_QUERYA
 maxrows      NUMBER(10,0),        OG_MAXROWS_QUERYA
 execopen     BOOLEAN,             OG_EXECOPEN_QUERYA
 exectimer    VARCHAR2(255),       OG_EXECTIMER_QUERYA
 execalert    VARCHAR2(255),       OG_EXECALERT_QUERYA
 customproc   VARCHAR2(255),       OG_CUSTOMPROC_QUERYA
 postproc     VARCHAR2(255)        OG_POSTPROC_QUERYA
);
                                   OG_ALL_QUERYA
                                   OG_NONE_QUERYA

	Attribut	Description
CSG	name	Nom de l'interrogation.
CSG	dateformat	Masque de format de date de l'interrogation.
CSG	querysource	Source des données de l'interrogation. Si les données proviennent d'une base de données, cet attribut doit contenir le texte de l'instruction SQL.SELECT de l'interrogation. Si les données sont stockées dans le système de fichiers, cet attribut doit contenir le chemin et le nom du fichier de données.
CSG	querytype	Type d'interrogation. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_CUSTOM_QTYPE   Indique que l'interrogation est personnalisée.
		OG_EXSQL_QTYPE   Indique que l'interrogation extrait ses données d'un fichier texte contenant une instruction SQL.SELECT.
		OG_PRN_QTYPE   Indique que l'interrogation est basée sur un fichier PRN.
		OG_SQL_QTYPE   Indique que l'interrogation est une instruction SQL.SELECT.
		OG_SYLK_QTYPE   Indique que l'interrogation est basée sur un fichier SYLK.
		OG_WKS_QTYPE   Indique que l'interrogation est basée sur un fichier WKS.
CSG	cachetype	Détermine la façon dont les dernières données extraites de l'exécution d'une interrogation sont traitées. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_APPEND_CACHETYPE   Indique que toutes les lignes de données existantes sont conservées et que les nouvelles lignes de données sont ajoutées à la base de l'ensemble de données existant.
		OG_COPY_CACHETYPE   Indique que toutes les données provenant de la précédente exécution sont copiées dans un tampon spécial et remplacées par les dernières données extraites.
		OG_NONE_CACHETYPE   Indique que les données provenant de la précédente exécution ne sont pas prises en compte et qu'elles sont remplacées par les dernières données extraites.
CSG	maxflag	Nombre de lignes contenues dans l'ensemble de données est limité.
CSG	maxrows	Nombre maximum de lignes de données conservées dans l'ensemble de données d'interrogation.
CSG	execopen	Indique si l'interrogation doit être exécutée automatiquement lorsque l'affichage est ouvert au moment de l'exécution.
CSG	exectimer	Nom de l'horloge sur laquelle s'exécute l'interrogation.
CSG	execalert	Réservé pour une utilisation ultérieure.
CSG	customproc	Procédure PL/SQL appelée lorsqu'une interrogation personnalisée est exécutée.
CSG	postproc	Procédure PL/SQL appelée après l'exécution de l'interrogation.


Enregistrement d'attributs combinés de rectangle

L'enregistrement d'attributs combinés d'un rectangle se compose d'un enregistrement d'attributs génériques, d'un enregistrement d'attributs graphiques et d'un enregistrement d'attributs de rectangle.

TYPE og_rect_ca IS RECORD
(rect_caob  og_generic_attr,   /* générique */
 rect_caoh  og_graphic_attr,   /* graphique */
 rect_caor  og_rect_attr       /* rectangle */
);


Enregistrement d'attributs de rectangle

L'enregistrement d'attributs d'un rectangle contient des attributs qui ne peuvent être utilisés qu'avec des objets rectangle.

TYPE og_rect_attr IS RECORD              Constantes de masque :
(mask      NUMBER(1,0),
 baserect  og_rectangle                  OG_BASERECT_RECTA
);
                                         OG_ALL_RECTA
                                         OG_NONE_RECTA

	Attribut	Description
CSG	baserect	Coordonnées x et y de l'angle supérieur gauche, ainsi que la hauteur et la largeur du rectangle utilisé comme base de l'objet rectangle (en unités de présentation).


Enregistrement d'attributs de ligne de référence

TYPE og_refline_attr IS RECORD           Constantes de masque :
(mask       NUMBER(2,0),
 numvalue   NUMBER(6),                   OG_VALUE_REFLINEA
 datevalue  DATE,                        OG_VALUE_REFLINEA
 label      VARCHAR2(255),               OG_LABEL_REFLINEA
 axis       NUMBER(1,0)                  OG_AXIS_REFLINEA
);
                                         OG_ALL_REFLINEA
                                         OG_NONE_REFLINEA

	Attribut	Description
SG	numvalue	Valeur numérique à laquelle apparaît la ligne de référence.
SG	datevalue	Valeur de date à laquelle apparaît la ligne de référence.
SG	label	Libellé de texte qui identifie la ligne de référence dans la légende.
SG	axis	Axe auquel la valeur de référence est comparée pour déterminer sa position.


Enregistrement d'attributs combinés de rectangle arrondi

L'enregistrement d'attributs combinés de rectangle arrondi se compose d'un enregistrement d'attributs génériques, d'un enregistrement d'attributs graphiques et d'un enregistrement d'attributs de rectangle arrondi :

TYPE og_rrect_ca IS RECORD
(rrect_caob  og_generic_attr,   /* générique */
 rrect_caoh  og_graphic_attr,   /* graphique */
 rrect_caor  og_rrect_attr      /* rectangle arrondi */
);


Enregistrement d'attributs de rectangle arrondi

L'enregistrement d'attributs de rectangle arrondi contient des attributs qui ne peuvent être utilisés qu'avec des objets rectangle arrondi :

TYPE og_rrect_attr IS RECORD            Constantes de masque :
(mask      NUMBER(1,0),
 baserect  og_rectangle,                OG_BASERECT_RRECTA
 corner    og_point                     OG_CORNER_RRECTA
);
                                        OG_ALL_RRECTA
                                        OG_NONE_RRECTA

	Attribut	Description
CSG	baserect	Coordonnées x et y de l'angle supérieur gauche, ainsi que la hauteur et la largeur du rectangle utilisé comme base de l'objet rectangle. (en unités de présentation).
CSG	corner	Rayons x et y (en unités de présentation) de l'ellipse qui serait tracée si les arcs formant les angles arrondis se prolongeaient en un chemin complet sur 360°.


Enregistrement d'attributs de son

L'enregistrement d'attributs de son contient des attributs qui ne peuvent être utilisés qu'avec les sons.

TYPE og_sound_attr IS RECORD              Constantes de masque :
(mask        NUMBER(1,0),
 query       og_query,                    OG_DATA_SOUNDA
 which_data  NUMBER(1,0),                 OG_DATA_SOUNDA
 colname     VARCHAR2(255),               OG_DATA_SOUNDA
 name        VARCHAR2(255),               OG_NAME_SOUNDA
);
                                          OG_ALL_SOUNDA
                                          OG_NONE_SOUNDA

	Attribut	Description
C	query	Indicateur de l'interrogation qui extrait le son d'une table d'une base de données. Notez que cette table doit être une table utilisateur et non l'une des tables privées utilisées par Graphics Builder lorsque vous enregistrez ou exportez dans la base de données un affichage, un dessin, un modèle de graphique, une palette de couleurs, une image ou un son.
C	which_data	Indique si le son à créer se trouve dans le nouvel ensemble de données de l'interrogation ou dans l'ancien. Graphics Builder offre deux constantes numériques qui peuvent être utilisées comme valeurs pour cet attribut :
		OG_NEWDATA   Indique que le son se trouve dans le nouvel ensemble de données de l'interrogation.
		OG_OLDDATA   Indique que le son se trouve dans l'ancien ensemble de données de l'interrogation.
C	colname	Nom de la colonne d'interrogation qui contient les données du son. Le son créé est celui qui se trouve dans la cellule d'interrogation, à l'intersection de la colonne indiquée par cet attribut et de la ligne pointée par le curseur de l'interrogation.
CSG	name	Nom du son.


Enregistrement d'attributs combinés de symbole

L'enregistrement d'attributs combinés de symbole se compose d'un enregistrement d'attributs génériques, d'un enregistrement d'attributs graphiques et d'un enregistrement d'attributs de symbole

TYPE og_symbol_ca IS RECORD
(symbol_caob  og_generic_attr,   /* générique */
 symbol_caoh  og_graphic_attr,   /* graphique */
 symbol_caos  og_symbol_attr     /* symbole */
);


Enregistrement d'attributs de symbole

L'enregistrement d'attributs d'arc contient des attributs qui ne peuvent être utilisés qu'avec des objets arc.

TYPE og_symbol_attr IS RECORD          Constantes de masque :
(mask     NUMBER(1,0),
 center   og_point,                    OG_CENTER_SYMBOLA
 indx     NUMBER(3,0),                 OG_INDX_SYMBOLA
 symsize  NUMBER(1,0)                  OG_SYMSIZE_SYMBOLA
);
                                       OG_ALL_SYMBOLA
                                       OG_NONE_SYMBOLA

	Attribut	Description
CSG	center	Coordonnées x et y du centre du symbole (en unités de présentation).
CSG	indx	Index (ou numéro) de la position du symbole tel qu'il figure dans la palette de symboles de Designer.
CSG	symsize	Taille du symbole. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_LARGE_SYMSIZE   Indique que le symbole est grand.
		OG_MEDIUM_SYMSIZE   Indique que le symbole est moyen.
		OG_SMALL_SYMSIZE   Indique que le symbole est petit.


Généralités sur les attributs de texte

L'enregistrement d'attributs de texte ne contient pas le texte qui apparaîtra dans l'objet texte. Vous devez commencer par créer un objet texte, puis utiliser la procédure OG_INSERT_CMPTEXT pour insérer un "élément texte composé" dans l'objet texte. Vous pouvez insérer plusieurs éléments texte composé dans un objet texte. Chacun représentera une ligne de texte dans l'objet. En outre, chaque élément de texte composé peut contenir un ou plusieurs "éléments de texte simple". Un élément de texte simple contient une chaîne de texte réelle, et doit être inséré dans un élément de texte composé, an moyen de la procédure OG_INSERT_SMPTEXT.

Les enregistrements d'attributs des textes simple et composé sont décrits ci-dessous.


Enregistrement d'attributs combinés de texte

L'enregistrement d'attributs combinés de texte se compose d'un enregistrement d'attributs génériques, d'un enregistrement d'attributs graphiques et d'un enregistrement d'attributs texte.

TYPE og_text_ca IS RECORD
(text_caob  og_generic_attr,   /* générique */
 text_caoh  og_graphic_attr,   /* graphique
 text_caot  og_text_attr       /* texte*/
);


Enregistrement d'attributs de texte

L'enregistrement d'attributs de texte contient des attributs qui ne peuvent être utilisés qu'avec des objets texte.

TYPE og_text_attr IS RECORD            Constantes de masque :
(mask       NUMBER(6,0),
 origin     og_point,                  OG_ORIGIN_TEXTA
 ctcount    NUMBER(10,0),              OG_CTCOUNT_TEXTA
 gfont      og_font_attr,              OG_GFONT_TEXTA
 gcolor     VARCHAR2(255),             OG_GCOLOR_TEXTA
 spacing    NUMBER(1,0),               OG_SPACING_TEXTA
 custom     NUMBER(10,0),              OG_SPACING_TEXTA
 horigin    NUMBER(1,0),               OG_HORIGIN_TEXTA
 vorigin    NUMBER(1,0),               OG_VORIGIN_TEXTA
 halign     NUMBER(2,0),               OG_HALIGN_TEXTA
 valign     NUMBER(3,0),               OG_VALIGN_TEXTA
 fixed      BOOLEAN,                   OG_FIXED_TEXTA
 wrap       BOOLEAN,                   OG_WRAP_TEXTA
 bbscale    BOOLEAN,                   OG_BBSCALE_TEXTA
 fontscale  BOOLEAN,                   OG_FONTSCALE_TEXTA
 invisible  BOOLEAN,                   OG_INVISIBLE_TEXTA
 width      NUMBER(10,0),              OG_FIXEDWH_TEXTA
 height     NUMBER(10,0)               OG_FIXEDWH_TEXTA
);
                                       OG_ALL_TEXTA
                                       OG_NONE_TEXTA

	Attribut	Description
CSG	origin	Coordonnées x et y de l'angle supérieur gauche de l'objet texte (en unités de présentation).
G	ctcount	Nombre d'éléments texte composé constituant l'objet texte.
S	gfont	Police globale de l'objet texte. Lorsque cet attribut est défini, l'attribut font  de chaque élément de texte simple de l'objet texte est défini à cette police. Notez que la définition de cet attribut ne porte que sur les éléments de texte simple existants. Les éléments de texte simple, ajoutés ultérieurement, apparaîtront dans la police indiquée dans leurs enregistrements d'attributs de texte simple.
S	gcolor	Couleur globale de l'objet texte. Lorsque cet attribut est défini, l'attribut color de chaque élément de texte simple de l'objet texte sera défini à cette couleur. Notez que la définition de cet attribut ne porte que sur les éléments de texte simple existants. Les éléments de texte simple, ajoutés ultérieurement, apparaîtront dans la couleur indiquée dans leurs enregistrements d'attributs de texte simple.
CSG	spacing	Interligne de l'objet texte. La valeur de cet attribut peut être l'une des constantes intégrées ci-dessous. Si l'espacement personnalisé est défini, la valeur de l'attribut custom doit indiquer la valeur d'espacement exacte.
		OG_SINGLE_SPACE   Indique que le texte est en espacement simple.
		OG_ONEHALF_SPACE   Indique que le texte est en espacement 1 ½.
		OG_DOUBLE_SPACE   Indique que le texte est en espacement double.
		OG_CUSTOM_SPACE   Indique que le texte est en espacement personnalisé. L'espacement réel utilisé est défini par l'attribut custom.
CSG	custom	Espacement personnalisé de l'objet texte en unités de présentation. Cet attribut n'est utilisé pour indiquer l'espacement que si l'attribut gspacing est défini à espacement personnalisé.
CSG	horigin	Position horizontale de l'objet texte par rapport à son point d'origine. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_LEFT_HORIGIN   Indique que le point d'origine se trouve le long du bord gauche de la boîte englobante.
		OG_CENTER_HORIGIN   Indique que le point d'origine se trouve à égale distance des bords gauche et droit de la boîte englobante.
		OG_RIGHT_HORIGIN   Indique que le point d'origine se trouve le long du bord droit de la boîte englobante.
CSG	vorigin	Position verticale de l'objet texte par rapport à son point d'origine. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_TOP_VORIGIN   Indique que le point d'origine se trouve le long du bord supérieur de la boîte englobante.
		OG_MIDDLE_VORIGIN   Indique que le point d'origine se trouve à égale distance entre les bords supérieur et inférieur de la boîte englobante.
		OG_BOTTOM_VORIGIN   Indique que le point d'origine se trouve le long du bord inférieur de la boîte englobante.
CSG	halign	Alignement horizontal de l'objet texte. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_LEFT_HALIGN   Indique que le texte est aligné à gauche.
		OG_CENTER_HALIGN   Indique que le texte est centré.
		OG_RIGHT_HALIGN   Indique que le texte est aligné à droite.
CSG	valign	Alignement vertical de l'objet texte. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_TOP_VALIGN   Indique que le texte est aligné sur le haut.
		OG_MIDDLE_VALIGN   Indique que le texte est aligné sur le milieu.
		OG_BOTTOM_VALIGN   Indique que le texte est aligné sur le bas.
CSG	wrap	Indique si le texte doit passer à la ligne pour tenir dans la boîte englobante de l'objet texte. Comme décrit ci-dessous, un élément texte composé représente une ligne de texte et se compose d'éléments de texte simple. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que le texte passe à la ligne suivante.
		FALSE   Indique que le texte ne passe pas à la ligne suivante.
CSG	bbscale	Indique si la boîte englobante de l'objet texte doit être mise à l'échelle lorsque l'objet texte est mis à l'échelle. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que la boîte englobante est mise à l'échelle.
		FALSE   Indique que la boîte englobante n'est pas mise à l'échelle.
CSG	fontscale	Indique si la taille des caractères doit être mise à l'échelle lorsque l'objet texte est mis à l'échelle. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que la taille des caractères est mise à l'échelle.
		FALSE   Indique que la taille des caractères n'est pas mise à l'échelle.
CSG	fixed	Indique si la boîte englobante de l'objet texte doit rester de taille fixe. Si cet attribut est défini à TRUE, les valeurs des attributs width et height doivent indiquer la taille de la boîte englobante. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que la boîte englobante est fixe. Les dimensions de cette boîte sont définies par les attributs width et height.
		FALSE   Indique que la boîte englobante n'est pas fixe.
CSG	width	Largeur de la boîte englobante (en unités de présentation). Lorsque la boîte englobante change, cet attribut est automatiquement mis à jour en fonction de la nouvelle largeur. Cet attribut est utilisé pour définir la largeur uniquement si l'attribut fixed est défini à TRUE.
CSG	height	Hauteur de la boîte englobante (en unités de présentation). Lorsque la boîte englobante change, cet attribut est automatiquement mis à jour en fonction de la nouvelle hauteur. Cet attribut est utilisé pour définir la hauteur uniquement si l'attribut fixed est défini à TRUE.
CSG	invisible	Indique si le texte de l'objet texte doit être invisible, ce qui est utile pour les champs de texte dans lesquels l'utilisateur entre un mot de passe, si celui-ci ne doit pas être vu. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que le texte est invisible.
		FALSE   Indique que le texte est visible.


Enregistrement d'attributs de police

L'enregistrement d'attributs de police est utilisé pour indiquer les propriétés d'une police comme typeface et point size.

TYPE og_font_attr IS RECORD           Constantes de masque :
(mask         NUMBER(3,0),
 typeface     VARCHAR2(255),          OG_TYPEFACE_FONTA
 ptsize       NUMBER(10,2),           OG_PTSIZE_FONTA
 style        NUMBER(5,0),            OG_STYLE_FONTA
 weight       NUMBER(5,0),            OG_WEIGHT_FONTA
 width        NUMBER(5,0),            OG_WIDTH_FONTA
 kerning      BOOLEAN,                OG_KERNING_FONTA
 nearest      BOOLEAN,                OG_NEAREST_FONTA
 synthesize   BOOLEAN,                OG_SYNTHESIZE_FONTA
 charset      NUMBER(5,0)             OG_CHARSET_FONTA
);
                                      OG_ALL_FONTA
                                      OG_NONE_FONTA

	Attribut	Description
CG	typeface	Style de la police. Les valeurs de ce champ indiquent les styles (italique, ombré, souligné) et sont propres au système utilisé. Pour plus d'informations, consultez votre administrateur système ou votre documentation système.
CG	ptsize	Taille en points de la police. Les valeurs de ce champ sont propres au système utilisé. Pour plus d'informations, consultez votre administrateur système ou votre documentation système
CG	style	Style de la police. Les styles ne sont pas tous disponibles sur tous les systèmes. Pour plus d'informations, consultez votre administrateur système ou votre documentation système. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_BLINK_FONTSTYLE   Indique que le style est clignotant.
		OG_INVERTED_FONTSTYLE   Indique que le style est inversé.
		OG_ITALIC_FONTSTYLE   Indique que le style est italique.
		OG_OBLIQUE_FONTSTYLE   Indique que le style est oblique.
		OG_OUTLINE_FONTSTYLE   Indique que le style est outline.
		OG_OVERSTRIKE_FONTSTYLE   Indique que le style est overstrike.
		OG_PLAIN_FONTSTYLE   Indique que le style est normal.
		OG_SHADOW_FONTSTYLE   Indique que le style est ombré.
		OG_UNDERLINE_FONTSTYLE   Indique que le style est souligné.
		OG_UNKNOWN_FONTSTYLE   Indique que le style est inconnu. Vous ne pouvez pas définir de style à cette valeur. Cependant, cette valeur est retournée si vous extrayez une police dont Graphics Builder ne peut pas déterminer le style.
CG	weight	Graisse de la police. Les graisses ne sont pas toutes disponibles sur tous les systèmes. Pour plus d'informations, consultez votre administrateur système ou votre documentation système. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_BOLD_FONTWEIGHT   Indique que la police est de type gras.
		OG_DEMIBOLD_FONTWEIGHT   Indique que la police est de type demi-gras.
		OG_DEMILIGHT_FONTWEIGHT   Indique que la police est de type demi-light.
		OG_EXTRABOLD_FONTWEIGHT   Indique que la police est de type extra-gras.
		OG_EXTRALIGHT_FONTWEIGHT   Indique que la police est de type extra-light.
		OG_LIGHT_FONTWEIGHT   Indique que la police est de type light.
		OG_MEDIUM_FONTWEIGHT   Indique la que la police est de type medium.
		OG_ULTRABOLD_FONTWEIGHT   Indique que la police est de type ultra-gras.
		OG_ULTRALIGHT_FONTWEIGHT   Indique que la police est de type ultra-light.
		OG_UNKNOWN_FONTWEIGHT Indique que la police est de type inconnu. Vous ne pouvez pas définir un poids à cette valeur. Cependant, cette valeur est retournée si vous extrayez une police dont Graphics Builder ne peut pas déterminer le poids.
CG	width	Largeur de la police. Les largeurs ne sont pas toutes disponibles sur tous les systèmes. Pour plus d'informations, consultez votre administrateur système ou votre documentation système. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		OG_DENSE_FONTWIDTH   Indique que la largeur est dense.
		OG_EXPAND_FONTWIDTH   Indique que la largeur est étendue.
		OG_EXTRADENSE_FONTWIDTH   Indique que la largeur est extra-dense.
		OG_EXTRAEXPAND_FONTWIDTH   Indique que la largeur est extra-étendue.
		OG_NORMAL_FONTWIDTH   Indique que la largeur est normale.
		OG_SEMIDENSE_FONTWIDTH   Indique que la largeur est semi-dense.
		OG_SEMIEXPAND_FONTWIDTH   Indique que la largeur est semi-étendue.
		OG_ULTRADENSE_FONTWIDTH   Indique que la largeur est ultra-dense.
		OG_ULTRAEXPAND_FONTWIDTH   Indique que la largeur est ultra-étendue.
		OG_UNKNOWN_FONTWIDTH   Indique que la largeur est inconnue. Vous ne pouvez pas définir un poids à cette valeur. Cependant, cette valeur est retournée si vous extrayez une police dont Graphics Builder ne peut pas déterminer sa largeur.
CG	kerning	Indique si la police doit être crénée. Le crénage est le réglage de l'espace entre deux lettres adjacentes pour améliorer la visibilité du texte. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que la police est crénée.
		FALSE   Indique que la police n'est pas crénée.
C	nearest	Indique si Graphics Builder doit substituer la police correspondante la plus proche s'il  ne trouve pas la police exacte indiquée. La priorité de recherche de la police la plus proche est caractère, taille en points, style, poids et largeur (dans l'ordre indiqué). La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Substituer  la police la plus proche.
		FALSE   Ne pas substituer  la police la plus proche.
C	synthesize	Indique si Graphics Builder doit tenter de synthétiser la police voulue (si la police indiquée est introuvable) en transformant la police la plus proche au niveau correspondance. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que la police ??.
		FALSE   Indique que la police n'est pas ??
CG	charset	Jeu de caractères de la police. Les valeurs de ce champ indiquent des jeux de caractères tels que U.S. ASCII, Kanji et Arabic. Pour connaître la liste des valeurs valides pour ce champ, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.
		OG_US7ASCII_CHARSET
		OG_WE8DEC_CHARSET
		OG_WE8HP_CHARSET
		OG_US8PC437_CHARSET
		OG_WE8EBCDIC37_CHARSET
		OG_WE8EBCDIC500_CHARSET
		OG_WE8PC850_CHARSET
		OG_D7DEC_CHARSET
		OG_F7DEC_CHARSET
		OG_S7DEC_CHARSET
		OG_E7DEC_CHARSET
		OG_SF7ASCII_CHARSET
		OG_NDK7DEC_CHARSET
		OG_I7DEC_CHARSET
		OG_NL7DEC_CHARSET
		OG_CH7DEC_CHARSET
		OG_SF7DEC_CHARSET
		OG_WE8ISO8859P1_CHARSET
		OG_EE8ISO8859P2_CHARSET
		OG_SE8ISO8859P3_CHARSET
		OG_NEE8ISO8859P4_CHARSET
		OG_CL8ISO8859P5_CHARSET
		OG_AR8ISO8859P6_CHARSET
		OG_EL8ISO8859P7_CHARSET
		OG_IW8ISO8859P8_CHARSET
		OG_WE8ISO8859P9_CHARSET
		OG_AR8ASMO708PLUS_CHARSET
		OG_AR7ASMO449PLUS_CHARSET
		OG_WE8MACROMAN8_CHARSET
		OG_JVMS_CHARSET
		OG_JEUC_CHARSET
		OG_JDEC_CHARSET
		OG_SJIS_CHARSET
		OG_JDBCS_CHARSET
		OG_JHP_CHARSET
		OG_KSC5601_CHARSET
		OG_KIBM5540_CHARSET
		OG_KDBCS_CHARSET
		OG_CGB231380_CHARSET
		OG_CDBCS_CHARSET
		OG_BIG5_CHARSET
		OG_CNS1164386_CHARSET


Enregistrement d'attributs d'élément de texte composé

L'enregistrement d'attributs d'élément de texte composé contient des attributs qui ne peuvent être utilisés qu'avec des éléments de texte composé :

TYPE og_cmptext_attr IS RECORD	   Constantes de masque :
(mask     NUMBER(1,0),
 stcount  NUMBER(10,0)               OG_STCOUNT_CMPTEXTA
);
                                     OG_ALL_CMPTEXTA
                                     OG_NONE_CMPTEXTA

	Attribut	Description
G	stcount	Nombre d'éléments de texte simple composant l'élément de texte composé.


Enregistrement d'attributs d'élément de texte simple

L'enregistrement d'attributs d'éléments de texte simple contient des attributs qui peuvent être utilisés uniquement avec des éléments de texte simple :

TYPE og_smptext_attr IS RECORD    Constantes de masque :
(mask   NUMBER(1,0),
 str    VARCHAR2(2000)            OG_STR_SMPTEXTA
 font   og_font_attr,             OG_FONT_SMPTEXTA
 color  VARCHAR2(255)             OG_COLOR_SMPTEXTA
);
                                  OG_ALL_SMPTEXTA
                                  OG_NONE_SMPTEXTA

	Attribut	Description
CSG	str	Chaîne de caractères contenant le texte de l'élément de texte simple.
CSG	font	Police dans laquelle le texte de la chaîne de caractères doit être affiché. Les seuls attributs de police qui seront utilisés sont ceux qui sont indiqués par la valeur de l'attribut ou des attributs de mask dans l'enregistrement d'attributs de police. Les champs de l'enregistrement d'attributs, pour lesquels le masque n'est pas défini, ne seront pas concernés.
CSG	color	Couleur dans laquelle le texte de la chaîne de caractères doit être affichée. Notez que cette couleur est celle du texte lui-même. Pour définir la couleur du bord ou la couleur de remplissage de l'objet de texte, modifiez les attributs graphiques de l'objet de texte.
Exemple

Cette procédure crée un objet texte, nommé "Message", au point d'origine (1", 1") et contenant les deux lignes de texte suivantes en police Times 12 points :

Ligne 1.

Ligne 2.

N'oubliez pas que chaque élément de texte composé représente exactement une ligne de texte dans l'objet de texte.

PROCEDURE make_text IS
   text_obj   og_object;
   text_rec   og_text_ca;
   smp_rec    og_smptext_attr;
   font_rec   og_font_attr;
BEGIN
/* Définir les attributs de nom et d'origine de l'objet de texte */
   text_rec.text_caob.name:='Message';
   text_rec.text_caot.origin.x:=OG_INCH;
   text_rec.text_caot.origin.y:=OG_INCH;
   text_rec.text_caob.mask:=OG_NAME_GENERICA;
   text_rec.text_caoh.mask:=OG_NONE_GRAPHICA;
   text_rec.text_caot.mask:=OG_ORIGIN_TEXTA;
/* Créer l'objet de texte */
   text_obj:=og_make(text_rec);
/* Insérer le nouvel élément de texte composé dans l'objet de texte à
      l'indice 0 */
   og_insert_cmptext(text_obj, 0);
/* Définir les attributs de caractère et taille en points de l'enregistrement */
   font_rec.typeface:='times';
   font_rec.ptsize:=12;
   font_rec.mask:=OG_TYPEFACE_FONTA+
                  OG_PTSIZE_FONTA;
/* Définir l'enregistrement de texte simple de la chaîne de texte et de la police */
   smp_rec.str:='This is line 1.';
   smp_rec.font:=font_rec;
   smp_rec.mask:=OG_STR_SMPTEXTA+
                 OG_FONT_SMPTEXTA;
/* Insérer un nouvel élément de texte simple à l'indice 0 dans
      l'élément de texte composé de l'objet texte à l'indice 0 en utilisant
      l'enregistrement de texte simple défini */
   og_insert_smptext(text_obj, smp_rec, 0, 0);
/* Insérer le nouvel élément de texte composé dans l'objet texte à
      l'indice 1 */
   og_insert_cmptext(text_obj, 1);
/* Changer la chaîne de texte de l'enregistrement de texte simple */
   smp_rec.str:='And now';
/* Insérer un nouvel élément de texte simple à l'indice 0 dans l'élément de
      texte composé de l'objet texte à l'indice 1 en utilisant
      l'enregistrement de texte simple défini */
   og_insert_smptext(text_obj, smp_rec, 1, 0);
/* Changer la chaîne de texte de l'enregistrement de texte simple */
   smp_rec.str:=' line 2.';
/* Insérer un nouvel élément de texte simple à l'indice 1 dans
      l'élément de texte composé de l'objet texte à l'indice 1
      en utilisant l'enregistrement de texte simple défini */
   og_insert_smptext(text_obj, smp_rec, 1, 1);
END;

Exemple

Cette fonction prend comme argument un identificateur d'un objet de champ de texte et retourne le texte figurant dans ce champ. Notez que comme le programme n'accède qu'à un élément de texte composé, seule la première ligne de texte du champ de texte est extraite.

FUNCTION get_text(text_obj IN og_object) RETURN VARCHAR2 IS
   smp_rec   og_smptext_attr;
BEGIN
   /* Définir le masque de l'enregistrement de texte simple en indiquant que la chaîne de texte est le seul attribut à extraire. */
   smp_rec.mask:=OG_STR_SMPTEXTA;
   /* Extraire l'élément de texte simple de niveau 0 de l'élément de
      texte composé de niveau 0 de l'objet de texte, et stocker le résultat
      dans l'enregistrement de texte simple */
   og_get_smptext(text_obj, 0, 0, smp_rec);
   /* Retourner l'attribut de chaîne de texte de l'enregistrement de texte
      simple */
   RETURN(smp_rec.str);
END;


Enregistrement d'attributs d'horloge

L'enregistrement d'attributs d'horloge contient les attributs qui ne peuvent être utilisés qu'avec des horloges.

TYPE og_timer_attr IS RECORD          Constantes de masque :
(mask       NUMBER(2,0),
 name       VARCHAR2(255),            OG_NAME_TIMERA
 interval   NUMBER(10,3),             OG_INTERVAL_TIMERA
 timerproc  VARCHAR2(255),            OG_TIMERPROC_TIMERA
 active     BOOLEAN                   OG_ACTIVE_TIMERA
);
                                      OG_ALL_TIMERA
                                      OG_NONE_TIMERA

	Attribut	Description
CSG	name	Nom de l'horloge.
CSG	interval	Nombre de secondes qui devront s'écouler entre deux exécutions de la procédure horloge.
CSG	timerproc	Nom de la procédure qui est exécutée lorsque l'horloge sera activée.


Enregistrement d'attributs de fenêtre

La position et les dimensions des fenêtres sont exprimées en "unités de résolution d'écran", plus couramment appelées Pixels. Les valeurs verticales et horizontales de résolution d'écran sont stockées dans un enregistrement global intégré appelé OG_APP. Cet enregistrement, de type OG_APP_ATTR, est défini intégralement dans la section "Enregistrement d'attributs d'application" de ce chapitre.

Utilisez cette variable globale au lieu d'une valeur numérique réelle pour que votre application reste cohérente sur les systèmes ayant des résolutions d'écran différentes.

L'enregistrement d'attributs de fenêtre contient des attributs qui ne peuvent être utilisés qu'avec des fenêtres.

TYPE og_window_attr is RECORD      Constantes de masque :
(mask        NUMBER(2,0),
 position    og_point,             OG_POSITION_WINDOWA
 width       NUMBER(5,0),          OG_SIZE_WINDOWA
 height      NUMBER(5,0),          OG_SIZE_WINDOWA
 name        VARCHAR2(255),        OG_NAME_WINDOWA
 scrollbars  BOOLEAN,              OG_SCROLLBARS_WINDOWA
 helptarget  VARCHAR2(255)         OG_HELPTARGET_WINDOWA
);
                                   OG_ALL_WINDOWA
                                   OG_NONE_WINDOWA

	Attribut	Description
CSG	position	Coordonnées x et y de l'angle supérieur gauche de la fenêtre (en unités de résolution d'écran).
CSG	width	Largeur de la fenêtre (en unités de résolution d'écran).
CSG	height	Hauteur de la fenêtre (en unités de résolution d'écran).
CSG	name	Nom de la fenêtre. Lors de l'exécution, le nom par défaut de la fenêtre de présentation est "Présentation principale".
C	scrollbars	Indique si les barres de défilement apparaissent dans la fenêtre. La valeur de cet attribut peut être l'une des constantes intégrées suivantes :
		TRUE   Indique que la fenêtre comporte des barres de défilement.
		FALSE   Indique que la fenêtre ne comporte pas de barres de défilement.
CSG	helptarget	Cible hypertexte du document Aide runtime affiché si le système d'aide est appelé alors que la fenêtre est active.


A propos des sous-programmes intégrés PL/SQL

La présente section décrit tous les sous-programmes intégrés de Graphics Builder. Ces sous-programmes sont des extensions du langage PL/SQL qui peuvent être utilisés dans vos propres sous-programmes pour accéder aux fonctions et aux fonctionnalités de Graphics Builder.

Pour plus d'informations sur l'utilisation de ces sous-programmes, reportez-vous à Graphics Builder Developer's Guide.

utilisation de l'indicateur de dommage

utilisation de l'indicateur de mise à jour de boîtes englobantes

utilisation de listes d'objets

description d'un sous-programme intégré


A propos de l'utilisation de l'indicateur de dommage

La plupart des procédures et des fonctions décrites ci-dessous acceptent un argument booléen appelé "indicateur de dommage". L'argument est toujours facultatif, et sa valeur par défaut est TRUE.

Si l'indicateur de dommage est défini à TRUE, les parties de la présentation concernées par la procédure ou la fonction sont marquées "endommagées". Ces zones sont appelées "régions de dommage". Par exemple, si vous changez la couleur ou la taille d'un objet, les zones de l'affichage dans lesquelles apparaît l'objet sont endommagées.

Les régions endommagées sont toujours rectangulaires. Si l'objet concerné n'est pas rectangulaire, la région de dommage est la plus petite région rectangulaire qui englobe complètement l'objet.

Les régions de dommage sont redessinées automatiquement lorsque la procédure ou la fonction de plus haut niveau au cours de laquelle elles ont été endommagées prend fin, ou lorsque vous appelez explicitement la procédure interne OG_SYNCHRONIZE. Lorsqu'une zone de l'écran est redessinée, elle n'est plus endommagée (jusqu'à ce qu'un autre appel de procédure l'endommage à nouveau).

Si l'indicateur de dommage est défini à FALSE, les parties de la présentation concernées par l'appel au sous-programme ne sont pas endommagées et ne sont donc pas redessinées dans les cas décrits ci-dessus.

N'oubliez pas que même si l'indicateur de dommage est défini à FALSE lorsque vous modifiez un objet, les modifications que vous y apportez s'appliquent à la description interne de cet objet. Si vous tentez ultérieurement d'examiner par programme les attributs de cet objet (par exemple, en utilisant la procédure OG_GET_ATTR), vous constaterez qu'il ne correspond pas au contenu de l'affichage.

Par exemple, si vous modifiez la taille d'un objet tout en définissant l'indicateur de dommage à  FALSE, vous ne verrez pas de changement dans la taille de l'objet, dans la présentation. Cependant, sa représentation interne sera modifiée ; si vous utilisez ultérieurement OG_GET_ATTR pour déterminer la taille de l'objet, vous constaterez que pour Graphics Builder l'objet a la nouvelle taille que vous avez définie et non celle qui apparaît dans la présentation.

Réfléchissez bien avant de définir l'indicateur de dommage à FALSE, car vous risquez alors que l'aspect de l'objet dans l'affichage et sa description interne soient "désynchronisés".

Pour endommager explicitement une région de la présentation, utilisez la procédure interne OG_DAMAGE.


A propos de l'utilisation de l'indicateur de mise à jour de boîtes englobantes

La plupart des procédures et des fonctions décrites ci-dessous acceptent un argument booléen appelé "indicateur de mise à jour de boîtes englobantes". L'argument est toujours facultatif, et sa valeur par défaut est TRUE.

De nombreuses modifications susceptibles d'être apportées à un objet affectent ses boîtes englobantes intérieures et/ou extérieures. Par exemple, lorsque vous modifiez la largeur du bord d'un objet, sa boîte englobante intérieure reste inchangée, mais sa boîte englobante extérieure peut s'adapter à la nouvelle taille de l'objet. Lorsque vous déplacez un objet, ses deux boîtes englobantes changent.

Chaque fois que vous exécutez ce type d'opération, Graphics Builder met à jour en interne les boîtes englobantes de l'objet. (Les boîtes englobantes sont représentées par les attributs obbox et ibbox de l'enregistrement d'attributs générique.)

Si l'indicateur de mise à jour de boîtes englobantes est défini à TRUE, Graphics Builder met normalement à jour les boîtes englobantes de l'objet, après chaque opération pouvant les concerner. En outre, Graphics Builder met à jour les boîtes englobantes de tous ses antécédents, jusqu'à la couche sur laquelle réside l'objet, celle-ci comprise.

Si l'indicateur de boîtes englobantes est défini à FALSE, Graphics Builder ne met pas les boîtes englobantes à jour.

Si vous modifiez de nombreux objets, ou modifiez quelques objets un grand nombre de fois, le temps passé par Graphics Builder à mettre à jour toutes leurs boîtes englobantes peut nuire aux performances de votre application. Par souci d'efficacité, vous aurez donc parfois intérêt à attendre que toutes vos modifications soient terminées avant de mettre les boîtes englobantes à jour. Par exemple, si vous apportez plusieurs modifications à un objet, Graphics Builder va, par défaut, mettre à jour les boîtes englobantes après chaque modification. Vous pouvez cependant décider de bloquer ces multiples mises à jour automatiques, puis de mettre à jour explicitement les boîtes englobantes par un unique appel à la procédure interne OG_UPDATE_BBOX.

En revanche, si les modifications que vous apportez à un objet ne portent pas sur ses boîtes englobantes (un changement de couleur, par exemple), leur mise à jour est sans importance, et vous pouvez alors choisir de bloquer la mise à jour automatique des boîtes englobantes, et de ne pas les mettre à jour ultérieurement.

Pour mettre à jour explicitement les boîtes englobantes d'un objet, utilisez la procédure interne OG_UPDATE_BBOX.

Lorsque vous modifiez un objet et définissez l'indicateur de mise à jour des boîtes englobantes à FALSE, vous avez intérêt à définir également l'indicateur de dommage à FALSE. Graphics Builder utilise les boîtes englobantes de l'objet pour déterminer la région de dommage à redessiner. Si les boîtes englobantes ne sont pas précises, il est probable que la présentation risque de ne pas être endommagée correctement.


A propos de l'utilisation de listes d'objets

Certaines des procédures et des fonctions énumérées dans la présente section sont utilisées pour créer ou pour modifier une "liste" d'éléments. Exemple de liste :

•	un objet groupe contient une liste d'objets fils,

•	un objet polygone contient une liste de points,

•	un objet texte contient une liste d'éléments texte composés,

•	un élément texte composé contient une liste d'éléments texte simples,

•	un objet graphique contient une liste de champs.

A chaque élément d'une liste correspond un "index", ou numéro, qui représente sa position dans la liste. Comme les listes commencent à zéro, le premier élément a l'index 0, le deuxième, l'index 1 et ainsi de suite.

Par exemple, la représentation graphique d'un objet groupe (une raquette de tennis) et de la liste des objets fils qui la composent (un cadre, une poignée et un manche) :

Opérations sur des listes

Les trois opérations que vous pouvez exécuter sur ces listes sont les suivantes :

•	insertion d'un élément,

•	suppression d'un élément,

•	lecture d'un élément (pour examiner sa valeur).

A chaque objet utilisant une liste correspondent des sous-programmes intégrés qui vous permettent d'exécuter ces opérations. Par exemple, les sous-programmes concernant un objet groupe et ses fils sont : OG_INSERT_CHILD, OG_DELETE_CHILD et OG_GET_CHILD.

Pour ces sous-programmes, vous devez indiquer l'index de l'élément que vous voulez manipuler.

Supposons, par exemple, que vous avez créé l'objet texte décrit ci-dessous, composé d'un élément texte composé et de trois éléments texte simples :

Pour supprimer le deuxième élément texte simple du premier élément texte composé, vous pouvez transmettre l'objet texte à cette procédure :

PROCEDURE delete_second_word(textobj og_object) IS
BEGIN
   og_delete_smptext(textobj, 0, 1, 1);
END;

Autre exemple : vous voulez ajouter un objet à un groupe en insérant cet objet à la fin de la liste des objets fils du groupe. Pour indiquer un index correspondant au dernier élément de la liste, vous devez savoir combien la liste comporte d'éléments. Cependant, Graphics Builder comporte une constante numérique intégrée que vous pouvez utiliser comme index pour indiquer le dernier élément de la liste : OG_LAST. (Graphics Builder comporte également la constante OG_FIRST pour indiquer le premier élément d'une liste.)

La procédure décrite ci-dessous accepte un objet groupe et un autre objet comme arguments, et attache le second objet à la fin du groupe :

PROCEDURE stick_at_end(groupobj og_object, childobj og_object) IS
BEGIN
   og_insert_child(groupobj, childobj, OG_LAST);
END;

Notez que l'index de la constante OG_LAST ne peut être utilisé que pour insérer un élément à la fin d'une liste. Pour supprimer ou lire un élément de la fin d'une liste, vous devez indiquer la valeur réelle de l'index de cet élément. Pour insérer un élément dans une liste vide, vous pouvez utiliser l'index de la constante OG_FIRST ou OG_LAST.

Lorsque vous insérez un élément en utilisant un index déjà occupé par un autre élément, le nouvel élément est inséré devant l'ancien (c'est-à-dire que le nouvel élément occupe la position d'index indiquée).

Pour plus d'informations, reportez-vous à la description complète du sous-programme de liste que vous voulez utiliser.


Description d'un sous-programme intégré

Description

Indique le but et l'utilisation du sous-programme.

Syntaxe

Indique la syntaxe d'appel du sous-programme. Si vous avez plusieurs possibilités, elles sont toutes indiquées.

Paramètres

Décrit les paramètres du sous-programme.

Retourne

Décrit la valeur de retour du sous-programme (pour les fonctions uniquement).

Commentaires

Explique les règles et les restrictions d'utilisation.

Exemple

Fournit un exemple d'utilisation du sous-programme.


Exceptions classées par nom

  Rubriques connexes

Syntaxe

Nom de l'exception EXCEPTION;


OG_Active_Layer_Del

  Rubriques connexes

Description	Cette exception est générée lorsque la couche active en cours est utilisée comme argument de OG_Destroy.

Syntaxe

OG_Active_Layer_Del EXCEPTION;

Code d'erreur	 102034


 OG_Append_Failure

  Rubriques connexes

Description	Cette exception est générée lorsqu'une erreur se produit pendant une tentative d'ajout de données à une interrogation personnalisée.

Syntaxe

OG_Append_Failure EXCEPTION;

Code d'erreur	 102166


  OG_Column_Not_Settable

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de modifier le schéma d'une colonne d'interrogation, alors que l'interrogation n'est pas personnalisée.

Syntaxe

OG_Column_Not_Settable EXCEPTION;

Code d'erreur	 102167


OG_Colors_Not_Writable

  Rubriques connexes

Description	Cette exception est générée lorsque vous définissez OG_Import_Image et définissez l'argument use_colors à TRUE, alors que la palette de couleurs de l'affichage n'est pas modifiable.

Syntaxe

OG_Colors_Not_Writable EXCEPTION;

Code d'erreur	 102097


OG_Column_Type_Mismatch

  Rubriques connexes

Description	Cette exception est générée lorsque les données retournées par OG_Get_Charcell, OG_Get_Datecell ou OG_Get_Numcell ne sont pas du type attendu par cette fonction.

Syntaxe

OG_Column_Type_Mismatch EXCEPTION;

Code d'erreur	 102043


OG_Date_Overflow

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez OG_Update_Chart et que le graphique contient un axe de date, mais avec une plage de données trop grande. Par exemple, si les données recouvrent un grand nombre d'années et si la taille des incréments d'axe est en secondes.

Syntaxe

OG_Date_Overflow EXCEPTION;

Code d'erreur	 102074


OG_Delete_Column_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de supprimer une colonne d'une interrogation. Vous ne pouvez supprimer de colonnes que d'interrogations personnalisées.

Syntaxe

OG_Delete_Column_Failure EXCEPTION;

Code d'erreur	 102169


OG_Delete_Object_Prop_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de supprimer une propriété d'un objet.

Syntaxe

OG_Delete_Object_Prop_Failure EXCEPTION;

Code d'erreur	 102164


OG_Delete_Param_Error

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de supprimer un paramètre.

Syntaxe

OG_Delete_Param_Error EXCEPTION;

Code d'erreur	 102176


OG_Delete_Property_Error

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de supprimer une propriété d'un objet.

Syntaxe

OG_Delete_Property_Error EXCEPTION;

Code d'erreur	 102181


OG_Display_Closed

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'exécuter une opération sur un affichage après sa fermeture par un appel à OG_Close_Display.

Syntaxe

OG_Display_Closed EXCEPTION;

Code d'erreur	 102115


OG_Drawing_Export_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Export_Drawing détecte une erreur pendant une tentative d'exportation d'un dessin.

Syntaxe

OG_Drawing_Export_Failure EXCEPTION;

Code d'erreur	 102091


OG_Drawing_Import_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Import_Drawing détecte une erreur pendant une tentative d'importation d'un dessin.

Syntaxe

OG_Drawing_Import_Failure EXCEPTION;

Code d'erreur	 102095


OG_Duplicate_Column_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous définissez une colonne dans une interrogation personnalisée, alors que le nom de la colonne est déjà utilisé par une autre colonne.

Syntaxe

OG_Duplicate_Column_Name EXCEPTION;

Code d'erreur	 102172


OG_Duplicate_Display_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez OG_Save_Display et donnez à l'argument name un nom identique à celui d'un autre affichage ouvert.

Syntaxe

OG_Duplicate_Display_Name EXCEPTION;

Code d'erreur	 102106


OG_Duplicate_Ftemp_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous créez un modèle de champ, alors qu'il existe déjà un autre modèle de champ ayant le même nom.

Syntaxe

OG_Duplicate_Ftemp_Name EXCEPTION;

Code d'erreur	 102156


OG_Duplicate_Query_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous créez une interrogation alors qu'il existe déjà une autre interrogation ayant le même nom.

Syntaxe

OG_Duplicate_Query_Name EXCEPTION;

Code d'erreur	 102171


OG_Duplicate_Template_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous créez un modèle de graphique alors qu'il existe déjà un autre modèle de graphique ayant le même nom.

Syntaxe

OG_Duplicate_Template_Name EXCEPTION;

Code d'erreur	 102157


OG_Env_Var_Error

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Translate_Envvar détecte une erreur pendant une tentative d'évaluation d'une variable d'environnement.

Syntaxe

OG_Env_Var_Error EXCEPTION;

Code d'erreur	 102102


OG_Env_Var_Notfound

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Translate_Envvar tente de traduire une variable d'environnement qui n'a pas été définie pour votre système.

Syntaxe

OG_Env_Var_Notfound EXCEPTION;

Code d'erreur	 102103


OG_Font_Not_Found

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de définir une police en utilisant un nom de police qui n'existe pas sur votre système.

Syntaxe

OG_Font_Not_Found EXCEPTION;

Code d'erreur	 102098


OG_Generate_Display_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Generate_Display détecte une erreur pendant une tentative de génération d'un affichage.

Syntaxe

OG_Generate_Display_Failure EXCEPTION;

Code d'erreur	 102105


OG_Get_Object_Prop_Failure

  Rubriques connexes

Description	Cette exception est générée lorsqu'une erreur se produit pendant une tentative de lecture d'une valeur de propriété d'objet.

Syntaxe

OG_Get_Object_Prop_Failure EXCEPTION;

Code d'erreur	 102163


OG_Get_Param_Error

  Rubriques connexes

Description	Cette exception est générée lorsqu'une erreur se produit pendant une tentative de lecture d'une valeur de paramètre.

Syntaxe

OG_Get_Param_Error EXCEPTION;

Code d'erreur	 102175


OG_Get_Printer_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'imprimer, mais que Graphics Builder ne peut pas trouver l'imprimante.

Syntaxe

OG_Get_Printer_Failure EXCEPTION;

Code d'erreur	 102160


OG_Get_Property_Error

  Rubriques connexes

Description	Cette exception est générée lorsqu'une erreur se produit pendant une tentative de lecture d'une valeur de propriété d'objet.

Syntaxe

OG_Get_Property_Error EXCEPTION;

Code d'erreur	 102179


OG_Hide_Active_Layer

  Rubriques connexes

Description	Cette exception est générée lorsque la couche active en cours est utilisée comme argument de OG_Hide_Layer. Pour désactiver une couche, activez-en une autre en utilisant OG_Activate_Layer.

Syntaxe

OG_Hide_Active_Layer EXCEPTION;

Code d'erreur	 102013


OG_Host_Failure_Error

  Rubriques connexes

Description	Cette exception est générée lorsque la procédure interne OG_Host rencontre une erreur pendant une tentative d'exécution d'une commande sur le système hôte.

Syntaxe

OG_Host_Failure_Error EXCEPTION;

Code d'erreur	 102059


OG_Image_Creation_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque vous rencontrez une erreur pendant une tentative de création d'une image.

Syntaxe

OG_Image_Creation_Failure EXCEPTION;

Code d'erreur	 102083


OG_Image_Export_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Export_Image rencontre une erreur pendant une tentative d'exportation d'une image.

Syntaxe

OG_Image_Export_Failure EXCEPTION;

Code d'erreur	 102087


OG_Image_Import_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Import_Image rencontre une erreur pendant une tentative d'importation d'une image.

Syntaxe

OG_Image_Import_Failure EXCEPTION;

Code d'erreur	 102093


OG_Incompatible_Pos_Dir

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une position ou une direction d'axe non valide.

Syntaxe

OG_Incompatible_Pos_Dir EXCEPTION;

Code d'erreur	 102141


OG_Insert_Column_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'insérer une colonne dans une interrogation. Vous ne pouvez insérer de colonnes que dans des interrogations personnalisées.

Syntaxe

OG_Insert_Column_Failure EXCEPTION;

Code d'erreur	 102168


OG_Internal_OG_Error

  Rubriques connexes

Description	Cette exception est générée lorsqu'une erreur interne grave se produit. Contactez le Support technique Oracle.

Syntaxe

OG_Internal_OG_Error EXCEPTION;

Code d'erreur	 102000


OG_Internal_Tk_Error

  Rubriques connexes

Description	Cette exception est générée lorsqu'une erreur interne grave se produit. Contactez le Support technique Oracle.

Syntaxe

OG_Internal_Tk_Error EXCEPTION;

Code d'erreur	 102001


OG_Invalid_Arc_Fill

  Rubriques connexes

Description	Cette exception est générée lorsque vous utilisez une valeur non valide pour la définition du style de remplissage d'un arc.

Syntaxe

OG_Invalid_Arc_Fill EXCEPTION;

Code d'erreur	 102066


OG_Invalid_Arrowstyle

  Rubriques connexes

Description	Cette exception est générée lorsque vous utilisez une valeur non valide pour la définition du style de flèche d'une ligne.

Syntaxe

OG_Invalid_Arrowstyle EXCEPTION;

Code d'erreur	 102022


OG_Invalid_Axis

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur d'axe non valide. Les valeurs valides sont OX_Axis, OG_Y1_Axis et OG_Y2_Axis uniquement.

Syntaxe

OG_Invalid_Axis EXCEPTION;

Code d'erreur	 102140


OG_Invalid_Axis_Handle

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de faire référence à un identificateur d'axe non valide.

Syntaxe

OG_Invalid_Axis_Handle EXCEPTION;

Code d'erreur	 102122


OG_Invalid_Axis_Mapping

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de mettre à jour un graphique avec une correspondance d'axes non valide.

Syntaxe

OG_Invalid_Axis_Mapping EXCEPTION;

Code d'erreur	 102134


OG_Invalid_Baselinetype

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un type de ligne de base non valide.

Syntaxe

OG_Invalid_Baselinetype EXCEPTION;

Code d'erreur	 102132


OG_Invalid_Baseline_Value

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur de ligne de base non valide.

Syntaxe

OG_Invalid_Baseline_Value EXCEPTION;

Code d'erreur	 102153


OG_Invalid_Bbox

  Rubriques connexes

Description	Cette exception est générée lorsque vous utilisez une valeur non valide pour l'argument which_bbox dans la procédure interne OG_Update_Bbox.

Syntaxe

OG_Invalid_Bbox EXCEPTION;

Code d'erreur	 102060


OG_Invalid_Buttonproc_Handle

  Rubriques connexes

Description	Cette exception est générée lorsqu'un enregistrement d'attributs utilisé comme argument d'une procédure contient une valeur non valide pour l'attribut de procédure bouton.

Syntaxe

OG_Invalid_Buttonproc_Handle EXCEPTION;

Code d'erreur	 102006


OG_Invalid_Cachetype

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un type de cache non valide. Les valeurs valides sont OG_Append_Cachetype, OG_Copy_Cachetype et OG_None_Cachetype uniquement.

Syntaxe

OG_Invalid_Cachetype EXCEPTION;

Code d'erreur	 102170


OG_Invalid_Cap_Style

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur non valide comme style des extrémités.

Syntaxe

OG_Invalid_Cap_Style EXCEPTION;

Code d'erreur	 102018


OG_Invalid_Catwidth

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une largeur de catégorie non valide.

Syntaxe

OG_Invalid_Catwidth EXCEPTION;

Code d'erreur	 102135


OG_Invalid_Chart_Creation_Attr

  Rubriques connexes

Description	Cette exception est générée lorsqu'un enregistrement d'attributs combinés de graphiques, utilisé comme argument de OG_Make, contient un enregistrement d'attributs de graphique dont les attributs ne sont pas valides. Lorsqu'un graphique est créé pour la première fois, vous devez indiquez un modèle et une interrogation à attacher au graphique.

Syntaxe

OG_Invalid_Chart_Creation_Attr EXCEPTION;

Code d'erreur	 102054


OG_Invalid_Chart_Update_Mask

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur de masque, utilisée comme argument pour OG_Update_Chart, n'est pas valide.

Syntaxe

OG_Invalid_Chart_Update_Mask EXCEPTION;

Code d'erreur	 102052


OG_Invalid_Child_Del_Total

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur utilisée comme argument de OG_Delete_Child, qui indique le nombre total de fils à supprimer, est supérieure au nombre de fils existant réellement dans le groupe après le premier fils indiqué comme devant être supprimé, celui-ci compris.

Syntaxe

OG_Invalid_Child_Del_Total EXCEPTION;

Code d'erreur	 102032


OG_Invalid_Child_Index

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur d'index, utilisée comme argument de OG_Delete_Child, OG_Get_Child ou OG_Insert_Child, est supérieure au nombre de fils du groupe moins un.

Syntaxe

OG_Invalid_Child_Index EXCEPTION;

Code d'erreur	 102031


OG_Invalid_Child_Object

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez OG_Insert_Child et définissez l'argument child_hdl comme un objet qui ne peut pas être inséré dans un groupe.

Syntaxe

OG_Invalid_Child_Object EXCEPTION;

Code d'erreur	 102116


OG_Invalid_Cmptext_Del_Total

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur utilisée comme argument de OG_Delete_Cmptext, qui indique le nombre total d'éléments texte composés à supprimer, est supérieure au nombre d'éléments texte supprimés existant réellement dans l'objet texte après le premier élément indiqué comme devant être supprimé, celui-ci inclus.

Syntaxe

OG_Invalid_Cmptext_Del_Total EXCEPTION;

Code d'erreur	 102037


OG_Invalid_Cmptext_Index

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un index de texte composé qui est supérieur au nombre d'éléments texte composés figurant dans l'objet texte moins un.

Syntaxe

OG_Invalid_Cmptext_Index EXCEPTION;

Code d'erreur	 102036


OG_Invalid_Color_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur non valide pour l'une des propriétés de couleur.

Syntaxe

OG_Invalid_Color_Name EXCEPTION;

Code d'erreur	 102015


OG_Invalid_Column_Index

  Rubriques connexes

Description	Cette exception est générée lorsque vous utilisez une valeur non valide pour l'argument col_num dans la fonction intégrée OG_Get_Schema.

Syntaxe

OG_Invalid_Column_Index EXCEPTION;

Code d'erreur	 102099


OG_Invalid_Column_Name

  Rubriques connexes

Description	Cette exception est générée dans les cas suivants :

•	un enregistrement d'un champ contenant un nom de colonne non valide a été inséré dans un graphique (par OG_Insert_Field) et le type de graphique est mis à jour par un appel à OG_Update_Chart,

•	un nom de colonne non valide est utilisé comme argument de OG_Set_Attr (lors de la définition des attributs de l'un des éléments d'un graphique) et le graphique est ensuite mis à jour par un appel à OG_Update_Chart,

•	un nom de colonne non valide est utilisé comme argument de OG_Get_Charcell, OG_Get_Datecell ou OG_Get_Numcell.

 Syntaxe

OG_Invalid_Column_Name EXCEPTION;

Code d'erreur	 102044


OG_Invalid_Compression_Type

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une constante de compression d'image non valide.

Syntaxe

OG_Invalid_Compression_Type EXCEPTION;

Code d'erreur	 102121


OG_Invalid_Cursor_Offset

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur de décalage utilisée comme argument de OG_Start_From, est supérieure au nombre de lignes existant pour l'interrogation indiquée, moins un.

Syntaxe

OG_Invalid_Cursor_Offset EXCEPTION;

Code d'erreur	 102047


OG_Invalid_Curvefit

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un curvefit non valide.

Syntaxe

OG_Invalid_Curvefit EXCEPTION;

Code d'erreur	 102158


OG_Invalid_Dash_Style

  Rubriques connexes

Description	Cette exception est générée lorsqu'un enregistrement d'attributs utilisé comme argument de OG_Make or OG_Set_Attr contient une valeur non valide pour l'attribut de style tiret.

Syntaxe

OG_Invalid_Dash_Style EXCEPTION;

Code d'erreur	 102019


OG_Invalid_Data_File

  Rubriques connexes

Description	Cette exception est générée lorsque Graphics Builder détecte une erreur pendant une tentative d'ouverture ou de lecture d'un fichier PRN, SYLK ou WKS.

Syntaxe

OG_Invalid_Data_File EXCEPTION;

Code d'erreur	 102077


OG_Invalid_Data_Flag

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un indicateur de données non valide. Les valeurs valides sont les constantes intégrées OG_Newdata et OG_Olddata uniquement.

Syntaxe

OG_Invalid_Data_Flag EXCEPTION;

Code d'erreur	 102042


OG_Invalid_Data_Value

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez OG_Update_Chart et que l'interrogation sur laquelle repose le graphique contient des données qui ne sont pas valides pour ce type de graphique (par exemple, si le graphique est un graphique à secteurs et que l'interrogation contient des données négatives).

Syntaxe

OG_Invalid_Data_Value EXCEPTION;

Code d'erreur	 102070


OG_Invalid_Date_Format

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un format de date non valide.

Syntaxe

OG_Invalid_Date_Format EXCEPTION;

Code d'erreur	 102108


OG_Invalid_Datevalue

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur de date non valide.

Syntaxe

OG_Invalid_Datevalue EXCEPTION;

Code d'erreur	 102133


OG_Invalid_Depthsize

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une profondeur non valide.

Syntaxe

OG_Invalid_Depthsize EXCEPTION;

Code d'erreur	 102129


OG_Invalid_Direction

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une direction d'axe non valide.

Syntaxe

OG_Invalid_Direction EXCEPTION;

Code d'erreur	 102143


OG_Invalid_Display_Handle

  Rubriques connexes

Description	Cette exception est générée lorsqu'un identificateur d'affichage non valide est utilisé comme argument de OG_Close_Display.

Syntaxe

OG_Invalid_Display_Handle EXCEPTION;

Code d'erreur	 102011


OG_Invalid_Drawing_Format

  Rubriques connexes

Description	Cette exception est générée lorsque vous utilisez une valeur non valide pour l'argument format des procédures internes OG_Export_Drawing ou OG_Import_Drawing.

Syntaxe

OG_Invalid_Drawing_Format EXCEPTION;

Code d'erreur	 102089


OG_Invalid_External_Location

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un emplacement non valide. Les valides sont les constantes intégrées OG_Db et OG_Filesystem uniquement.

Syntaxe

OG_Invalid_External_Location EXCEPTION;

Code d'erreur	 102056


OG_Invalid_Event_Mask

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'indiquer une valeur non valide pour la propriété événements.

Syntaxe

OG_Invalid_Event_Mask EXCEPTION;

Code d'erreur	 102058


OG_Invalid_Field_Datatype

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez OG_Update_Chart et que l'interrogation sur laquelle repose le graphique contient des données dont le type n'est pas valide pour ce graphique. Par exemple, si les champs dépendants d'un graphique à secteurs sont de type CHAR.

Syntaxe

OG_Invalid_Field_Datatype EXCEPTION;

Code d'erreur	 102069


OG_Invalid_Field_Del_Total

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur utilisée comme argument de OG_Delete_Field, qui indique le nombre total de champs à supprimer d'un graphique, est supérieure au nombre de champs existant réellement dans le graphique après le premier champ indiqué comme devant être supprimé, celui-ci inclus.

Syntaxe

OG_Invalid_Field_Del_Total EXCEPTION;

Code d'erreur	 102041


OG_Invalid_Field_Index

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur d'index utilisée comme argument de OG_Delete_Field, OG_Get_Field ou  OG_Insert_Field est supérieure au nombre de champs du graphique, moins un.

Syntaxe

OG_Invalid_Field_Index EXCEPTION;

Code d'erreur	 102040


OG_Invalid_Field_Template

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un nom de modèle de champ non valide.

Syntaxe

OG_Invalid_Field_Template EXCEPTION;

Code d'erreur	 102067


OG_Invalid_Field_Type

  Rubriques connexes

Description	Cette exception est générée lorsqu'un enregistrement de champs contenant une valeur de type de champ non valide a été inséré dans un graphique (par OG_Insert_Field), et que le graphique est ultérieurement mis à jour par un appel à OG_Update_Chart. Les valeurs de type de champ valides comprennent les constantes intégrées OG_Dependent et OG_Independent.

Syntaxe

OG_Invalid_Field_Type EXCEPTION;

Code d'erreur	 102045


OG_Invalid_Ftemp_Del_Total

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de supprimer davantage de modèles de champ qu'un modèle de graphique n'en comporte.

Syntaxe

OG_Invalid_Ftemp_Del_Total EXCEPTION;

Code d'erreur	 102125


OG_Invalid_Ftemp_Index

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un modèle de champ non valide à supprimer d'un modèle de graphique.

Syntaxe

OG_Invalid_Ftemp_Index EXCEPTION;

Code d'erreur	 102124


OG_Invalid_Gridct

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un nombre de grilles non valide.

Syntaxe

OG_Invalid_Gridct EXCEPTION;

Code d'erreur	 102155


OG_Invalid_Image_Format

  Rubriques connexes

Description	Cette exception est générée lorsque vous utilisez une valeur non valide pour l'argument format des procédures internes OG_Export_Image ou OG_Import_Image.

Syntaxe

OG_Invalid_Image_Format EXCEPTION;

Code d'erreur	 102082


OG_Invalid_Join_Style

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un type de jointure non valide.

Syntaxe

OG_Invalid_Join_Style EXCEPTION;

Code d'erreur	 102017


OG_Invalid_Labelrot

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une orientation d'étiquette non valide.

Syntaxe

OG_Invalid_Labelrot EXCEPTION;

Code d'erreur	 102150


OG_Invalid_Layer_Handle

  Rubriques connexes

Description	Cette exception est générée lorsqu'un identificateur de couche non valide est utilisé comme argument de OG_Activate_Layer, OG_Hide_Layer ou OG_Show_Layer.

Syntaxe

OG_Invalid_Layer_Handle EXCEPTION;

Code d'erreur	 102009


OG_Invalid_Linestyle

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un style de trait non valide.

Syntaxe

OG_Invalid_Linestyle EXCEPTION;

Code d'erreur	 102159


OG_Invalid_Min_Max

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un minimum ou un maximum d'axe non valide.

Syntaxe

OG_Invalid_Min_Max EXCEPTION;

Code d'erreur	 102139


OG_Invalid_Minimum

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un minimum d'axe non valide.

Syntaxe

OG_Invalid_Minimum EXCEPTION;

Code d'erreur	 102154


OG_Invalid_Month

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un mois non valide.

Syntaxe

OG_Invalid_Month EXCEPTION;

Code d'erreur	 102149


OG_Invalid_Number_Format

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un format de nombre non valide.

Syntaxe

OG_Invalid_Number_Format EXCEPTION;

Code d'erreur	 102138


OG_Invalid_Object_Handle

  Rubriques connexes

Description	Cette exception est générée lorsque vous utilisez un identificateur d'objet non valide comme argument d'un sous-programme..

Syntaxe

OG_Invalid_Object_Handle EXCEPTION;

Code d'erreur	 102003


OG_Invalid_Object_Type

  Rubriques connexes

Description	Cette exception est générée lorsqu'un enregistrement d'attributs, utilisé comme argument de OG_Make or OG_Set_Attr, contient une valeur non valide pour l'attribut de type d'objet.

Syntaxe

OG_Invalid_Object_Type EXCEPTION;

Code d'erreur	 102020


OG_Invalid_Overlap

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un type de chevauchement non valide.

Syntaxe

OG_Invalid_Overlap EXCEPTION;

Code d'erreur	 102152


OG_Invalid_Pattern_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un nom de motif non valide.

Syntaxe

OG_Invalid_Pattern_Name EXCEPTION;

Code d'erreur	 102016


OG_Invalid_Pct_By

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un pourcentage par valeur non valide.

Syntaxe

OG_Invalid_Pct_By EXCEPTION;

Code d'erreur	 102148


OG_Invalid_Pct_Of

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un pourcentage de valeur non valide.

Syntaxe

OG_Invalid_Pct_Of EXCEPTION;

Code d'erreur	 102147


OG_Invalid_Pie_Usage

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un pourcentage de valeur non valide.

Syntaxe

OG_Invalid_Pie_Usage EXCEPTION;

Code d'erreur	 102136


OG_Invalid_Pie_Usagevalue

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur d'utilisation non valide.

Syntaxe

OG_Invalid_Pie_Usagevalue EXCEPTION;

Code d'erreur	 102137


OG_Invalid_Plotpos

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une position de tracé non valide.

Syntaxe

OG_Invalid_Plotpos EXCEPTION;

Code d'erreur	 102151


OG_Invalid_Point_Del_Total

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur utilisée comme argument de OG_Delete_Point qui indique le nombre total de points à supprimer est supérieure au nombre de points existant réellement dans l'objet après le premier point indiqué comme devant être supprimé, celui-ci inclus.

Syntaxe

OG_Invalid_Point_Del_Total EXCEPTION;

Code d'erreur	 102035


OG_Invalid_Point_Index

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur d'index, utilisée comme argument de OG_Delete_Point, OG_Get_Point ou OG_Insert_Point, est supérieure au nombre de points de l'objet, moins un.

Syntaxe

OG_Invalid_Point_Index EXCEPTION;

Code d'erreur	 102033


OG_Invalid_Position

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une position d'axe non valide.

Syntaxe

OG_Invalid_Position EXCEPTION;

Code d'erreur	 102142


OG_Invalid_Prn_Format

  Rubriques connexes

Description	Cette exception est générée lorsque vous exécutez une interrogation qui fait référence à un fichier PRN qui n'a pas un format PRN valide.

Syntaxe

OG_Invalid_Prn_Format EXCEPTION;

Code d'erreur	 102079


OG_Invalid_Query_Handle

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un identificateur d'interrogation non valide.

Syntaxe

OG_Invalid_Query_Handle EXCEPTION;

Code d'erreur	 102004


OG_Invalid_Query_Source

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une instruction SQL ou un nom de fichier non valide pour une interrogation.

Syntaxe

OG_Invalid_Query_Source EXCEPTION;

Code d'erreur	 102107


OG_Invalid_Query_Type

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un type d'interrogation non valide.

Syntaxe

OG_Invalid_Query_Type EXCEPTION;

Code d'erreur	 102109


OG_Invalid_Refline_Del_Total

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez  de supprimer davantage de lignes de référence que n'en contient un modèle de graphique.

Syntaxe

OG_Invalid_Refline_Del_Total EXCEPTION;

Code d'erreur	 102128


OG_Invalid_Refline_Index

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une ligne de référence non valide à supprimer.

Syntaxe

OG_Invalid_Refline_Index EXCEPTION;

Code d'erreur	 102127


OG_Invalid_Refline_Handle

  Rubriques connexes

Description	Cette exception est générée lorsque vous faites référence à un identificateur de ligne de référence non valide.

Syntaxe

OG_Invalid_Refline_Handle EXCEPTION;

Code d'erreur	 102123


OG_Invalid_Row_Number

  Rubriques connexes

Description	Cette exception est générée lorsqu'un numéro de ligne non valide est utilisé comme argument de OG_Set_Attr (lors de la définition des attributs de l'un des éléments d'un graphique), puis que le graphique est mis à jour par un appel à OG_Update_Chart.

Syntaxe

OG_Invalid_Row_Number EXCEPTION;

Code d'erreur	 102053


OG_Invalid_Scale

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur d'échelle non valide.

Syntaxe

OG_Invalid_Scale EXCEPTION;

Code d'erreur	 102146


OG_Invalid_Shadowdir

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une direction d'ombre non valide.

Syntaxe

OG_Invalid_Shadowdir EXCEPTION;

Code d'erreur	 102131


OG_Invalid_Shadowsize

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une taille d'ombre non valide.

Syntaxe

OG_Invalid_Shadowsize EXCEPTION;

Code d'erreur	 102130


OG_Invalid_Smptext_Del_Total

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur utilisée comme argument de OG_Delete_Smptext, qui indique le nombre total d'éléments texte simple à supprimer, est supérieur au nombre d'éléments texte simple existant réellement dans l'élément texte composé après le premier élément indiqué comme devant être supprimé, celui-ci inclus.

Syntaxe

OG_Invalid_Smptext_Del_Total EXCEPTION;

Code d'erreur	 102039


OG_Invalid_Smptext_Index

  Rubriques connexes

Description	Cette exception est générée lorsque la valeur d'index utilisée comme argument de OG_Delete_Smptext, OG_Get_Smptext ou OG_Insert_Smptext, est supérieure au nombre d'éléments texte simple de l'élément texte composé, moins un.

Syntaxe

OG_Invalid_Smptext_Index EXCEPTION;

Code d'erreur	 102038


OG_Invalid_Sound_Format

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un format de son  non valide.

Syntaxe

OG_Invalid_Sound_Format EXCEPTION;

Code d'erreur	 102084


OG_Invalid_Sound_Handle

  Rubriques connexes

Description	Cette exception est générée lorsqu'un identificateur de son non valide est utilisé comme argument de OG_Play_Sound.

Syntaxe

OG_Invalid_Sound_Handle EXCEPTION;

Code d'erreur	 102007


OG_Invalid_Step

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur d'étape non valide.

Syntaxe

OG_Invalid_Step EXCEPTION;

Code d'erreur	 102145


OG_Invalid_Sylk_Format

  Rubriques connexes

Description	Cette exception est générée lorsque vous exécutez une interrogation qui fait référence à un fichier SYLK, alors que le fichier n'a pas un format SYLK valide.

Syntaxe

OG_Invalid_Sylk_Format EXCEPTION;

Code d'erreur	 102078


OG_Invalid_Symbol_Index

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un index de symbole non valide.

Syntaxe

OG_Invalid_Symbol_Index EXCEPTION;

Code d'erreur	 102023


OG_Invalid_Symbol_Size

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une taille de symbole non valide.

Syntaxe

OG_Invalid_Symbol_Size EXCEPTION;

Code d'erreur	 102024


OG_Invalid_Template_Handle

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'utiliser un identificateur de modèle non valide.

Syntaxe

OG_Invalid_Template_Handle EXCEPTION;

Code d'erreur	 102005


OG_Invalid_Template_Type

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un type de modèle non valide.

Syntaxe

OG_Invalid_Template_Type EXCEPTION;

Code d'erreur	 102126


OG_Invalid_Text_Horalign

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur d'alignement non valide.

Syntaxe

OG_Invalid_Text_Horalign EXCEPTION;

Code d'erreur	 102026


OG_Invalid_Text_Horjust

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur de justification non valide.

Syntaxe

OG_Invalid_Text_Horjust EXCEPTION;

Code d'erreur	 102027


OG_Invalid_Text_Spacing

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur d'espacement non valide.

Syntaxe

OG_Invalid_Text_Spacing EXCEPTION;

Code d'erreur	 102025


OG_Invalid_Text_Vertalign

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur d'alignement non valide.

Syntaxe

OG_Invalid_Text_Vertalign EXCEPTION;

Code d'erreur	 102028


OG_Invalid_Text_Vertjust

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur de justification non valide.

Syntaxe

OG_Invalid_Text_Vertjust EXCEPTION;

Code d'erreur	 102029


OG_Invalid_Tickpos

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une position de graduation non valide.

Syntaxe

OG_Invalid_Tickpos EXCEPTION;

Code d'erreur	 102144


OG_Invalid_Timer_Handle

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un identificateur d'horloge non valide.

Syntaxe

OG_Invalid_Timer_Handle EXCEPTION;

Code d'erreur	 102010


OG_Invalid_Timer_Procedure

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une procédure déclencheur non valide.

Syntaxe

OG_Invalid_Timer_Procedure EXCEPTION;

Code d'erreur	 102112


OG_Invalid_Timer_Interval

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un intervalle de temps non valide.

Syntaxe

OG_Invalid_Timer_Interval EXCEPTION;

Code d'erreur	 102113


OG_Invalid_Transfer_Mode

  Rubriques connexes

Description	Cette exception est générée lorsque vous définissez un mode de transfert non valide.

Syntaxe

OG_Invalid_Transfer_Mode EXCEPTION;

Code d'erreur	 102057


OG_Invalid_Userexit_Invocation

  Rubriques connexes

Description	Cette exception est générée lorsque Graphics Builder ne peut pas appeler la sortie utilisateur indiquée.

Syntaxe

OG_Invalid_Userexit_Invocation EXCEPTION;

Code d'erreur	 102048


OG_Invalid_Window_Dimensions

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez des dimensions de fenêtre non valides.

Syntaxe

OG_Invalid_Window_Dimensions EXCEPTION;

Code d'erreur	 102002


OG_Invalid_Window_Handle

  Rubriques connexes

Description	Cette exception est générée lorsqu'un identificateur de fenêtre non valide est utilisé comme argument d'un sous-programme.

Syntaxe

OG_Invalid_Window_Handle EXCEPTION;

Code d'erreur	 102008


OG_Invalid_Wks_Format

  Rubriques connexes

Description	Cette exception est générée lorsque vous exécutez une interrogation qui fait référence à un fichier WKS qui n'a pas un format WKS valide.

Syntaxe

OG_Invalid_Wks_Format EXCEPTION;

Code d'erreur	 102080


OG_Layer_Not_Child_Of_Root

  Rubriques connexes

Description	Cette exception est générée lorsqu'un enregistrement d'attributs, utilisé comme argument de OG_Make, contient une valeur non valide pour l'attribut père.

Syntaxe

OG_Layer_Not_Child_Of_Root EXCEPTION;

Code d'erreur	 102012


OG_Login_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de vous connecter à une base de données en utilisant OG_Connect ou OG_Logon, mais que la connexion échoue.

Syntaxe

OG_Login_Failure EXCEPTION;

Code d'erreur	 102085


OG_Logoff_Disallowed

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez OG_Logoff, mais que Graphics Builder ne peut pas fermer la connexion à la base de données parce que votre affichage contient des curseurs SQL ouverts.

Syntaxe

OG_Logoff_Disallowed EXCEPTION;

Code d'erreur	 102101


OG_Logon_Disallowed

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez OG_Logon, mais que Graphics Builder ne peut pas fermer la précédente connexion à la base de données parce que votre affichage contient des curseurs SQL ouverts.

Syntaxe

OG_Logon_Disallowed EXCEPTION;

Code d'erreur	 102100


OG_Logoff_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Logoff détecte une erreur pendant la tentative de fermeture de la connexion à la base de données.

Syntaxe

OG_Logoff_Failure EXCEPTION;

Code d'erreur	 102086


OG_Main_Window_Destruction

  Rubriques connexes

Description	Cette exception est générée lorsque la fenêtre d'affichage principale est utilisée comme argument de OG_Destroy. Pour fermer la fenêtre principale sans la détruire, utilisez OG_Hide_Window.

Syntaxe

OG_Main_Window_Destruction EXCEPTION;

Code d'erreur	 102046


OG_Missing_Chart_Field

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez OG_Update_Chart, mais que l'interrogation sur laquelle repose le graphique ne contient pas un ou plusieurs champs attendus par le graphique, par exemple, si vous créez un graphique devant tracer les valeurs de NOME, SAL et COMM, et que l'interrogation retourne uniquement NOME et SAL.

Syntaxe

OG_Missing_Chart_Field EXCEPTION;

Code d'erreur	 102068


OG_No_Chart_Data

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez OG_Update_Chart, mais que l'interrogation associée au graphique n'a pas encore été exécutée.

Syntaxe

OG_No_Chart_Data EXCEPTION;

Code d'erreur	 102114


OG_No_Database_Connection

  Rubriques connexes

Description	Cette exception est générée lors d'une tentative d'accès à une base de données qui n'est pas encore correctement connectée. Elle peut être générée par OG_Execute_Query ou OG_Open_Display.

Syntaxe

OG_No_Database_Connection EXCEPTION;

Code d'erreur	 102055


OG_No_Dependent_Fields

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de mettre à jour un graphique qui ne contient pas de champs dépendants.

Syntaxe

OG_No_Dependent_Fields EXCEPTION;

Code d'erreur	 102072


OG_No_Independent_Fields

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de mettre à jour un graphique qui ne contient pas de champs indépendants.

Syntaxe

OG_No_Independent_Fields EXCEPTION;

Code d'erreur	 102186


OG_No_Query_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un nom d'interrogation non valide.

Syntaxe

OG_No_Query_Name EXCEPTION;

Code d'erreur	 102173


OG_No_Schema

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'exécuter une interrogation personnalisée ne comportant pas de schéma.

Syntaxe

OG_No_Schema EXCEPTION;

Code d'erreur	 102165


OG_Not_Chart_Element

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de traiter un objet comme un élément graphique, alors qu'il ne l'est pas.

Syntaxe

OG_Not_Chart_Element EXCEPTION;

Code d'erreur	 102184


OG_Not_Supported_In_Designer

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'exécuter une instruction PL/SQL qui ne s'applique pas à Designer de Graphics Builder. Il est très probable que vous devrez exécuter l'instruction uniquement au stade de l'exécution..

Syntaxe

OG_Not_Supported_In_Designer EXCEPTION;

Code d'erreur	 102183


OG_Sound_Conversion_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque vous importez un son, mais que Graphics Builder n'a pas pu effectuer la conversion à partir du système de codage ou de la vitesse d'échantillonnage d'origine du son. Généralement, cette exception indique que le son est trop important.

Syntaxe

OG_Sound_Conversion_Failure EXCEPTION;

Code d'erreur	 102120


OG_No_Sound_Input_Device

  Rubriques connexes

Description	Cette exception est générée lorsque vous utilisez OG_Play_Sound pour exécuter un son, alors qu'il n'y a pas d'unité de sortie de son correspondante.

Syntaxe

OG_No_Sound_Input_Device EXCEPTION;

Code d'erreur	 102118


OG_No_Sound_Output_Device

  Rubriques connexes

Description	Cette exception est générée lorsque vous utilisez OG_Record_Sound pour enregistrer un son, mais qu'il n'y a pas d'unité d'entrée de son correspondante.

Syntaxe

OG_No_Sound_Output_Device EXCEPTION;

Code d'erreur	 102117


OG_Not_Chart_Object

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez un sous-programme intégré qui agit sur un graphique, mais que l'argument que vous lui transmettez n'est pas un identificateur valide pour un objet graphique.

Syntaxe

OG_Not_Chart_Object EXCEPTION;

Code d'erreur	 102061


OG_Not_Group_Object

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez un sous-programme intégré qui agit sur un groupe, mais que l'argument que vous lui transmettez n'est pas un identificateur valide pour un objet de groupe.

Syntaxe

OG_Not_Group_Object EXCEPTION;

Code d'erreur	 102062


OG_Not_Image_Object

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez un sous-programme intégré qui agit sur une image, mais que l'argument que vous lui transmettez n'est pas un identificateur valide pour un objet image.

Syntaxe

OG_Not_Image_Object EXCEPTION;

Code d'erreur	 102064


OG_Not_Polygon_Object

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez un sous-programme intégré qui agit sur une ligne polygonale ou un polygone, mais que l'argument que vous lui transmettez n'est pas un identificateur valide pour l'objet ligne polygonale ou un polygone.

Syntaxe

OG_Not_Polygon_Object EXCEPTION;

Code d'erreur	 102063


OG_Not_Text_Object

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez un sous-programme intégré qui agit sur un objet texte, mais que l'argument que vous lui transmettez n'est pas un identificateur valide pour un objet texte.

Syntaxe

OG_Not_Text_Object EXCEPTION;

Code d'erreur	 102065


OG_Null_Chart_Element

  Rubriques connexes

Description	Cette exception est générée lorsque vous appelez OG_Get_Chart_Element et que l'élément graphique a la valeur NULL.

Syntaxe

OG_Null_Chart_Element EXCEPTION;

Code d'erreur	 102187


OG_Null_Module_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez un nom de module NULL comme argument d'un sous-programme intégré qui exporte, importe ou ouvre un module du système de fichiers ou de la base de données.

Syntaxe

OG_Null_Module_Name EXCEPTION;

Code d'erreur	 102110


OG_Open_Display_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Open_Display détecte une erreur pendant une tentative d'ouverture d'un affichage.

Syntaxe

OG_Open_Display_Failure EXCEPTION;

Code d'erreur	 102030


OG_Parent_Not_Group

  Rubriques connexes

Description	Cette exception est générée lorsque l'attribut père d'un enregistrement d'attributs, utilisé comme argument de OG_Make, ne contient pas d'identificateur valide d'un objet de groupe.

Syntaxe

OG_Parent_Not_Group EXCEPTION;

Code d'erreur	 102014


OG_Pctchart_Zero

  Rubriques connexes

Description	Cette exception est générée lorsque vous indiquez une valeur de Pourcentage non valide pour un graphique.

Syntaxe

OG_Pctchart_Zero EXCEPTION;

Code d'erreur	 102071


OG_Piechart_Sum_Overflow

  Rubriques connexes

Description	Cette exception est générée lorsque vous mettez à jour un graphique à secteurs pour lequel vous avez indiqué une Valeur totale (dans la fenêtre de propriété Cadre secteurs) inférieure à la somme réelle des données retournées par l'interrogation.

Syntaxe

OG_Piechart_Sum_Overflow EXCEPTION;

Code d'erreur	 102073


OG_Print_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque Graphics Builder détecte une erreur pendant une tentative d'impression de l'affichage.

Syntaxe

OG_Print_Failure EXCEPTION;

Code d'erreur	 102111


OG_Query_Execution_Error

  Rubriques connexes

Description	Cette exception est générée lorsque Graphics Builder détecte une erreur pendant une tentative d'exécution d'une interrogation.

Syntaxe

OG_Query_Execution_Error EXCEPTION;

Code d'erreur	 102075


OG_Recursive_Chart_Update

  Rubriques connexes

Description	Cette exception est générée lorsqu'un processus qui met à jour un graphique appelle un déclencheur qui met explicitement à jour le même graphique.

Syntaxe

OG_Recursive_Chart_Update EXCEPTION;

Code d'erreur	 102185


OG_Root_Object_Destruction

  Rubriques connexes

Description	Cette exception est générée lorsque l'objet utilisé comme argument de OG_Destroy est l'objet racine de l'arborescence des groupes de présentation.

Syntaxe

OG_Root_Object_Destruction EXCEPTION;

Code d'erreur	 102021


OG_Row_Retrieval_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Get_Charcell, OG_Get_Datecell ou OG_Get_Numcell ne peut pas trouver la ligne de données en cours.

Syntaxe

OG_Row_Retrieval_Failure EXCEPTION;

Code d'erreur	 102081


OG_Save_Display_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Save_Display détecte une erreur pendant une tentative d'enregistrement d'un affichage.

Syntaxe

OG_Save_Display_Failure EXCEPTION;

Code d'erreur	 102104


OG_Set_Object_Prop_Failure

  Rubriques connexes

Description	Cette exception est générée lorsqu'une erreur se produit pendant la définition d'une propriété d'objet.

Syntaxe

OG_Set_Object_Prop_Failure EXCEPTION;

Code d'erreur	 102162


OG_Set_Param_Error

  Rubriques connexes

Description	Cette exception est générée lorsqu'une erreur se produit pendant la définition d'un paramètre.

Syntaxe

OG_Set_Param_Error EXCEPTION;

Code d'erreur	 102174


OG_Set_Printer_Failure

  Rubriques connexes

Description	Cette exception est générée lorsqu'une erreur se produit pendant la définition du nom de l'imprimante.

Syntaxe

OG_Set_Printer_Failure EXCEPTION;

Code d'erreur	 102161


OG_Set_Property_Error

  Rubriques connexes

Description	Cette exception est générée lorsqu'une erreur se produit pendant la définition d'une propriété d'objet.

Syntaxe

OG_Set_Property_Error EXCEPTION;

Code d'erreur	 102180


OG_Sound_Export_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Export_Sound détecte une erreur pendant une tentative d'exportation d'un son.

Syntaxe

OG_Sound_Export_Failure EXCEPTION;

Code d'erreur	 102088


OG_Sound_Import_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Import_Sound détecte une erreur pendant une tentative d'importation d'un son.

Syntaxe

OG_Sound_Import_Failure EXCEPTION;

Code d'erreur	 102094


OG_Sql_Execution_Error

  Rubriques connexes

Description	Cette exception est générée lorsque Graphics Builder détecte une erreur pendant une tentative d'exécution d'une interrogation reposant sur une instruction SQL.

Syntaxe

OG_Sql_Execution_Error EXCEPTION;

Code d'erreur	 102076


OG_Template_Export_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Export_Template détecte une erreur pendant une tentative d'exportation d'un modèle.

Syntaxe

OG_Template_Export_Failure EXCEPTION;

Code d'erreur	 102092


OG_Template_Import_Failure

  Rubriques connexes

Description	Cette exception est générée lorsque OG_Import_Template détecte une erreur pendant une tentative d'importation d'un modèle.

Syntaxe

OG_Template_Import_Failure EXCEPTION;

Code d'erreur	 102096


OG_Too_Many_Data_Rows

  Rubriques connexes

Description	Cette exception est générée lorsque vous exécutez une interrogation qui retourne davantage de lignes de données que Graphics Builder ne peut en traiter sur votre système.

Syntaxe

OG_Too_Many_Data_Rows EXCEPTION;

Code d'erreur	 102119


OG_Undefined_Param

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de faire référence à un paramètre qui n'est pas défini.

Syntaxe

OG_Undefined_Param EXCEPTION;

Code d'erreur	 102178


OG_Undefined_Property

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de faire référence à une propriété d'objet qui n'est pas définie.

Syntaxe

OG_Undefined_Property EXCEPTION;

Code d'erreur	 102182


OG_Userexit_Failure_Error

  Rubriques connexes

Description	Cette exception est générée lorsqu'une sortie utilisateur retourne à Graphics Builder son code d'erreur correspondant.

Syntaxe

OG_Userexit_Failure_Error EXCEPTION;

Code d'erreur	 102049


OG_Userexit_Fatal_Error

  Rubriques connexes

Description	Cette exception est générée lorsqu'une sortie utilisateur retourne à Graphics Builder son code d'erreur correspondant.

Syntaxe

OG_Userexit_Fatal_Error EXCEPTION;

Code d'erreur	 102050


OG_Userexit_Unknown_Error

  Rubriques connexes

Description	Cette exception est générée lorsqu'une sortie utilisateur retourne à Graphics Builder un code d'erreur non reconnu.

Syntaxe

OG_Userexit_Unknown_Error EXCEPTION;

Code d'erreur	 102051


Tool_Int.Duplicate_Parameter_Key

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'ajouter un paramètre à une liste de paramètres, alors qu'un paramètre ayant le même nom a déjà été défini.

Syntaxe

Tool_Int.Duplicate_Parameter_Key EXCEPTION;

Code d'erreur	 104508


Tool_Int.Duplicate_Parameter_List_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de créer une liste de paramètres en indiquant un nom qui est déjà utilisé par une autre liste de paramètres.

Syntaxe

Tool_Int.Duplicate_Parameter_List_Name EXCEPTION;

Code d'erreur	 104504


Tool_Int.Internal_Tools_Error

  Rubriques connexes

Description	Cette exception est générée lorsqu'il se produit une erreur interne grave. Contactez le Support technique Oracle.

Syntaxe

Tool_Int.Internal_Tools_Error EXCEPTION;

Code d'erreur	 104500


Tool_Int.Invalid_Communication_Mode

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'appeler Tool_Int.Run_Product en utilisant un mode de communication non valide. Les valeurs valides sont les constantes en package Tool_Int.Synchronous et Tool_Int.Asynchronous uniquement.

Syntaxe

Tool_Int.Invalid_Communication_Mode EXCEPTION;

Code d'erreur	 104511


Tool_Int.Invalid_Execution_Mode

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'appeler Tool_Int.Run_Product en utilisant un mode d'exécution non valide. Les valeurs valides sont les constantes en package Tool_Int.Batch et Tool_Int.Runtime uniquement.

Syntaxe

Tool_Int.Invalid_Execution_Mode EXCEPTION;

Code d'erreur	 1045010


Tool_Int.Invalid_Location

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'appeler Tool_Int.Run_Product en utilisant un emplacement non valide pour le module indiqué. Les valeurs valides sont les constantes en package Tool_Int.Db et Tool_Int.Filesystem uniquement.

Syntaxe

Tool_Int.Invalid_Location EXCEPTION;

Code d'erreur	 104503


Tool_Int.Invalid_Parameter_List_Handle

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de faire référence à un identificateur de liste de paramètres non valide.

Syntaxe

Tool_Int.Invalid_Parameter_List_Handle EXCEPTION;

Code d'erreur	 104506


Tool_Int.Invalid_Parameter_Key

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de faire référence à un paramètre en utilisant un nom non valide.

Syntaxe

Tool_Int.Invalid_Parameter_Key EXCEPTION;

Code d'erreur	 104507


Tool_Int.Invalid_Parameter_List_Name

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez de faire référence à une liste de paramètres en utilisant un nom non valide.

Syntaxe

Tool_Int.Invalid_Parameter_List_Name EXCEPTION;

Code d'erreur	 104505


Tool_Int.Invalid_Parameter_Type

  Rubriques connexes

Description	Cette exception est générée lorsque vous définissez un type de paramètre à une valeur autre que CHAR, DATE ou NUMBER.

Syntaxe

Tool_Int.Invalid_Parameter_Type EXCEPTION;

Code d'erreur	 104501


Tool_Int.Invalid_Product

  Rubriques connexes

Description	Cette exception est générée lorsque vous tentez d'appeler Tool_Int.Run_Product en utilisant un produit non valide. Les valeurs valides sont les constantes en package Tool_Int.Book, Tool_Int.Forms et Tool_Int.Reports uniquement.

Syntaxe

Tool_Int.Invalid_Product EXCEPTION;

Code d'erreur	 104502


Tool_Int..Run_Product_Failure
Tool_Int.run_product_failure

  Rubriques connexes

Description	Cette exception est générée lorsque Graphics Builder ne peut pas exécuter le produit indiqué par un appel à Tool_Int.Run_Product. Pour toute information sur la préparation d'un autre produit destiné à être utilisé avec Graphics Builder, reportez-vous à la documentation Graphics Builder de votre système d'exploitation ou à votre documentation produit.

Syntaxe

Tool_Int..Run_Product_Failure EXCEPTION;

Code d'erreur	 104509


A propos des exceptions intégrées PL/SQL

La présente section décrit toutes les exceptions intégrées de Graphics Builder. Ces exceptions sont tout d'abord classées par codes d'erreur, puis décrites complètement. Chacune d'entre elles est accompagnée de sa syntaxe, d'une description et d'un message d'erreur.

Toute exception non gérée interrompt temporairement l'exécution de l'affichage et génère le message d'erreur indiqué. Une fois le message généré et accepté, l'exécution de l'affichage se poursuit.

Pour toute information sur les règles de portée et la propagation des exceptions, reportez-vous à PL/SQL User's Guide and Reference.


Classement des exceptions par code d'erreur

Description

Code d'erreur	Nom de l'exception
102000	OG_Internal_OG_Error
102001	OG_Internal_Tk_Error
102002	OG_Invalid_Window_Dimensions
102003	OG_Invalid_Object_Handle
102004	OG_Invalid_Query_Handle
102005	OG_Invalid_Template_Handle
102006	OG_Invalid_Buttonproc_Handle
102007	OG_Invalid_Sound_Handle
102008	OG_Invalid_Window_Handle
102009	OG_Invalid_Layer_Handle
102010	OG_Invalid_Timer_Handle
102011	OG_Invalid_Display_Handle
102012	OG_Layer_Not_Child_Of_Root
102013	OG_Hide_Active_Layer
102014	OG_Parent_Not_Group
102015	OG_Invalid_Color_Name
102016	OG_Invalid_Pattern_Name
102017	OG_Invalid_Join_Style
102018	OG_Invalid_Cap_Style
102019	OG_Invalid_Dash_Style
102020	OG_Invalid_Object_Type
102021	OG_Root_Object_Destruction
102022	OG_Invalid_Arrowstyle
102023	OG_Invalid_Symbol_Index
102024	OG_Invalid_Symbol_Size
102025	OG_Invalid_Text_Spacing
102026	OG_Invalid_Text_Horalign
102027	OG_Invalid_Text_Horjust
102028	OG_Invalid_Text_Vertalign
102029	OG_Invalid_Text_Vertjust
102030	OG_Open_Display_Failure
102031	OG_Invalid_Child_Index
102032	OG_Invalid_Child_Del_Total
102033	OG_Invalid_Point_Index
102034	OG_Active_Layer_Del
102035	OG_Invalid_Point_Del_Total
102036	OG_Invalid_Cmptext_Index
102037	OG_Invalid_Cmptext_Del_Total
102038	OG_Invalid_Smptext_Index
102039	OG_Invalid_Smptext_Del_Total
102040	OG_Invalid_Field_Index
102041	OG_Invalid_Field_Del_Total
102042	OG_Invalid_Data_Flag
102043	OG_Column_Type_Mismatch
102044	OG_Invalid_Column_Name
102045	OG_Invalid_Field_Type
102046	OG_Main_Window_Destruction
102047	OG_Invalid_Cursor_Offset
102048	OG_Invalid_Userexit_Invocation
102049	OG_Userexit_Failure_Error
102050	OG_Userexit_Fatal_Error
102051	OG_Userexit_Unknown_Error
102052	OG_Invalid_Chart_Update_Mask
102053	OG_Invalid_Row_Number
102054	OG_Invalid_Chart_Creation_Attr
102055	OG_No_Database_Connection
102056	OG_Invalid_External_Location
102057	OG_Invalid_Transfer_Mode
102058	OG_Invalid_Event_Mask
102059	OG_Host_Failure_Error
102060	OG_Invalid_Bbox
102061	OG_Not_Chart_Object
102062	OG_Not_Group_Object
102063	OG_Not_Polygon_Object
102064	OG_Not_Image_Object
102065	OG_Not_Text_Object
102066	OG_Invalid_Arc_Fill
102067	OG_Invalid_Field_Template
102068	OG_Missing_Chart_Field
102069	OG_Invalid_Field_Datatype
102070	OG_Invalid_Data_Value
102071	OG_Pctchart_Zero
102072	OG_No_Dependent_Fields
102073	OG_Piechart_Sum_Overflow
102074	OG_Date_Overflow
102075	OG_Query_Execution_Error
102076	OG_Sql_Execution_Error
102077	OG_Invalid_Data_File
102078	OG_Invalid_Sylk_Format
102079	OG_Invalid_Prn_Format
102080	OG_Invalid_Wks_Format
102081	OG_Row_Retrieval_Failure
102082	OG_Invalid_Image_Format
102083	OG_Image_Creation_Failure
102084	OG_Invalid_Sound_Format
102085	OG_Login_Failure
102086	OG_Logoff_Failure
102087	OG_Image_Export_Failure
102088	OG_Sound_Export_Failure
102089	OG_Invalid_Drawing_Format
102091	OG_Drawing_Export_Failure
102092	OG_Template_Export_Failure
102093	OG_Image_Import_Failure
102094	OG_Sound_Import_Failure
102095	OG_Drawing_Import_Failure
102096	OG_Template_Import_Failure
102097	OG_Colors_Not_Writable
102098	OG_Font_Not_Found
102099	OG_Invalid_Column_Index
102100	OG_Logon_Disallowed
102101	OG_Logoff_Disallowed
102102	OG_Env_Var_Error
102103	OG_Env_Var_Notfound
102104	OG_Save_Display_Failure
102105	OG_Generate_Display_Failure
102106	OG_Duplicate_Display_Name
102107	OG_Invalid_Query_Source
102108	OG_Invalid_Date_Format
102109	OG_Invalid_Query_Type
102110	OG_Null_Module_Name
102111	OG_Print_Failure
102112	OG_Invalid_Timer_Procedure
102113	OG_Invalid_Timer_Interval
102114	OG_No_Chart_Data
102115	OG_Display_Closed
102116	OG_Invalid_Child_Object
102117	OG_No_Sound_Output_Device
102118	OG_No_Sound_Input_Device
102119	OG_Too_Many_Data_Rows
102120	OG_Sound_Conversion_Failure
102121	OG_Invalid_Compression_Type
102122	OG_Invalid_Axis_Handle
102123	OG_Invalid_Refline_Handle
102124	OG_Invalid_Ftemp_Index
102125	OG_Invalid_Ftemp_Del_Total
102126	OG_Invalid_Template_Type
102127	OG_Invalid_Refline_Index
102128	OG_Invalid_Refline_Del_Total
102129	OG_Invalid_Invalid_Depthsize
102130	OG_Invalid_Shadowsize
102131	OG_Invalid_Shadowdir
102132	OG_Invalid_Baselinetype
102133	OG_Invalid_Datevalue
102134	OG_Invalid_Axis_Mapping
102135	OG_Invalid_Catwidth
102136	OG_Invalid_Pie_Usage
102137	OG_Invalid_Pie_Usagevalue
102138	OG_Invalid_Number_Format
102139	OG_Invalid_Min_Max
102140	OG_Invalid_Axistype
102141	OG_Incompatible_Pos_Dir
102142	OG_Invalid_Position
102143	OG_Invalid_Direction
102144	OG_Invalid_Tickpos
102145	OG_Invalid_Step
102146	OG_Invalid_Scale
102147	OG_Invalid_Pct_Of
102148	OG_Invalid_Pct_By
102149	OG_Invalid_Month
102150	OG_Invalid_Labelrot
102151	OG_Invalid_Plotpos
102152	OG_Invalid_Overlap
102153	OG_Invalid_Baseline_Value
102154	OG_Invalid_Minimum
102155	OG_Invalid_Gridct
102156	OG_Duplicate_Ftemp_Name
102157	OG_Duplicate_Template_Name
102158	OG_Invalid_Curvefit
102159	OG_Invalid_Linestyle
102160	OG_Get_Printer_Failure
102161	OG_Set_Printer_Failure
102162	OG_Set_Object_Prop_Failure
102163	OG_Get_Object_Prop_Failure
102164	OG_Delete_Object_Prop_Failure
102165	OG_No_Schema
102166	OG_Get_Append_Failure
102167	OG_Column_Not_Settable
102168	OG_Insert_Column_Failure
102169	OG_Delete_Column_Failure
102170	OG_Invalid_Cachetype
102171	OG_Duplicate_Query_Name
102172	OG_Duplicate_Column_Name
102173	OG_No_Query_Name
102174	OG_Set_Param_Error
102175	OG_Get_Param_Error
102176	OG_Delete_Param_Error
102178	OG_Undefined_Param
102179	OG_Get_Property_Error
102180	OG_Set_Property_Error
102181	OG_Delete_Property_Error
102182	OG_Undefined_Property
102183	OG_Not_Supported_In_Designer
102184	OG_Not_Chart_Element
102185	OG_Recursive_Chart_Update
102186	OG_No_Independent_Fields
102187	OG_Null_Chart_Element
104500	Tool_Int.Internal_Tools_Error
104501	Tool_Int.Invalid_Parameter_Type
104502	Tool_Int.Invalid_Product
104503	Tool_Int.Invalid_Location
104504	Tool_Int.Duplicate_Parameter_List_Name
104505	Tool_Int.Invalid_Parameter_List_Name
104506	Tool_Int.Invalid_Parameter_List_Handle
104507	Tool_Int.Invalid_Parameter_Key
104508	Tool_Int.Duplicate_Parameter_Key
104509	Tool_Int.Run_Product_Failure
104510	Tool_Int.Invalid_Execution_Mode
104511	Tool_Int.Invalid_Communication_Mode


Types de données des procédures internes

OG_Arc

OG_Axis

OG_Buttonproc

OG_Colschema

OG_Display

OG_Event

OG_Field

OG_Ftemp

OG_Layer

OG_Object

OG_Point

OG_Query

OG_Rectangle

OG_Refline

OG_Sound

OG_Template

OG_Timer

OG_Window

Tool_Int.Param_Attr

Tool_Int.Paramlist


 OG_Arc

Description	Cette procédure définit le tracé d'un arc. Ce type de données est un enregistrement, défini de la manière suivante :

Syntaxe

TYPE OG_Arc IS RECORD
(x        NUMBER(10,0),
 y        NUMBER(10,0),
 hauteur  NUMBER(10,0),
 largeur  NUMBER(10,0),
 angle s  NUMBER(5,0),
 anglef   NUMBER(5,0)
);

où : x	Indique la coordonnée x (en unités de présentation) de l'angle supérieur gauche du rectangle utilisé comme base de l'arc (c'est-à-dire du rectangle qui relierait les quatre points de contrôle de l'arc).
y	Indique la coordonnée y de l'angle supérieur gauche du rectangle utilisé comme base de l'arc (en unités de présentation).
hauteur	Indique la hauteur du rectangle utilisé comme base de l'arc (en unités de présentation).
largeur	Indique la largeur du rectangle utilisé comme base de l'arc (en unités de présentation).
angle s	Indique l'angle de départ de l'arc (en degrés).
angle f	Indique l'angle de fin de l'arc (en degrés).


OG_Axis

Description	Indique l'identificateur d'un axe de graphique.


 OG_Buttonproc

Description	Indique un identificateur d'une procédure bouton.


OG_Colschema

Description	Décrit le schéma d'une colonne d'une interrogation. Ce type de données est un enregistrement, défini de la manière suivante :

Syntaxe

TYPE OG_Colschema IS RECORD
(nomcol     VARCHAR2(255),
 typecol     NUMBER(3,0),
 not_null    BOOLEAN,
 précision   NUMBER(3,0),
 échelle       NUMBER(3,0),
 longmax      NUMBER(10,0),
 formatdate  VARCHAR2(255)
);

où : nomcol	Indique le nom de la colonne.
typecol	Indique le type de la colonne. La valeur de ce champ d'enregistrement peut être l'une des constantes intégrées suivantes : OG_Char_Coltype Indique que la colonne est de type CHAR, VARCHAR2 ou ROWID. OG_Number_Coltype Indique que la colonne est de type NUMBER. OG_Long_Coltype Indique que la colonne est de type LONG. OG_Date_Coltype Indique que la colonne est de type DATE. OG_Raw_Coltype Indique que la colonne est de type RAW. OG_Longraw_Coltype Indique que la colonne est de type LONGRAW. OG_Mlslabel_Coltype Indique que la colonne est de type MLSLABEL.
not_null	Indique si la colonne doit être NOT NULL. Ce champ d'enregistrement peut contenir l'une des valeurs suivantes :  TRUE Indique que la colonne doit être NOT NULL. FALSE Indique que la colonne ne doit pas être NOT NULL.
précision	Indique la valeur de la précision définie pour une colonne de type NUMBER. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference. Ce champ d'enregistrement est significatif uniquement pour les interrogations SQL à partir d'une base de données.
échelle	Indique la valeur d'échelle définie pour une colonne de type NUMBER. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference. Ce champ d'enregistrement n'est significatif que pour les interrogations SQL à partir d'une base de données.
longmax	Indique la longueur maximum (en octets) des données que la colonne peut contenir. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.
formatdate	Indique le masque de format de date utilisé pour reconnaître les valeurs de colonnes comme des dates.


OG_Display

Description	Indique un identificateur d'un affichage.


 OG_Event

Description	Fournit des informations sur un événement de souris ayant appelé une procédure bouton. Ce type de données est un enregistrement, défini de la manière suivante :

Syntaxe

TYPE OG_Event IS RECORD
(type_événement   NUMBER(1,0),
 position_souris  OG_Point,
 nombre_clics     NUMBER(5,0),
 contrainte       BOOLEAN,
 bouton_souris    NUMBER(1,0)
);

où : type_événement	Indique le type d'événement de souris reçu par la procédure bouton. La valeur de ce champ d'enregistrement peut être l'une des constantes intégrées suivantes : OG_Mouse_Down Indique que la procédure a reçu un événement de bouton de souris enfoncé. OG_Mouse_Move_Down Indique que la procédure a reçu un événement de déplacement de souris avec bouton enfoncé. OG_Mouse_Up Indique que la procédure a reçu un événement de bouton de souris relâché. OG_Mouse_Move_Up Indique que la procédure a reçu un événement de déplacement de souris avec bouton enfoncé.
position_souris	Indique les coordonnées x et y de la position de la souris sur la présentation au moment où l'événement a été reçu.
nombre_clics	Indique le nombre de clics de souris qui ont été détectés, uniquement si l'événement était un événement de bouton de souris enfoncé. Remarque : En cas de détection d'un double clic, la procédure reçoit également tous les événements composant le double clic : tout d'abord un événement de bouton de souris enfoncé ayant un nombre de clics égal à un 1, puis un événement de bouton de souris relâché, puis un événement de bouton de souris enfoncé avec un nombre de clics égal à 2 puis enfin un autre événement de bouton de souris relâché. Veuillez en tenir compte lorsque vous définissez la logique de vos procédures.
contrainte	Indique si la touche majuscule est enfoncée. Ce champ d'enregistrement peut avoir l'une des valeurs suivantes : TRUE Indique que la touche majuscule est enfoncée. FALSE Indique que la touche majuscule n'est pas enfoncée.
bouton_souris	Indique le bouton qui a été enfoncé. Ce champ d'enregistrement peut avoir l'une des valeurs suivantes :  OG_Left_Mouse_Button OG_Center_Mouse_Button OG_Right_Mouse_Button


OG_Field

Description	Indique les propriétés d'un champ d'un graphique. Ce type de données est un enregistrement, défini de la manière suivante :

Syntaxe

TYPE OG_Field IS RECORD
(type_champ  NUMBER(1,0),
 nomcol     VARCHAR2(255),
 nommc      VARCHAR2(255)
);

où : type_champ	Indique le type du champ. La valeur de ce champ d'enregistrement peut être l'une des constantes intégrées suivantes : OG_Category Indique que le champ est tracé dans le graphique sous la forme d'une catégorie. OG_Dependent Est synonyme de OG_Value. OG_Subcategory Indique que le champ est utilisé comme une sous-catégorie d'un graphique de ventilation. OG_Independent Est synonyme de OG_Category. OG_Value Indique que le champ est tracé dans le graphique sous la forme d'une valeur.
nomcol	Indique le nom de la colonne dans l'interrogation du graphique que ce champ doit représenter sur un graphique.
nommc	Indique le nom du modèle de champ associé au champ. Notez que l'association d'un modèle de champ à une catégorie est dépourvue de signification ; lorsque vous définissez ce type de champ, vous ne devez pas lui attribuer de modèle.


 OG_Ftemp

Description	Indique un identificateur de modèle de champ.


OG_Layer

Description	Indique un identificateur de couche.


OG_Object

Description	Indique un identificateur d'objet graphique.


OG_Point

Description	Indique les valeurs x et y des opérations qui demandent des informations sur les coordonnées ou les tailles. Ce type de données est un enregistrement, défini de la manière suivante :

Syntaxe

TYPE OG_Point IS RECORD
(x  NUMBER(10,0),
 y  NUMBER(10,0)
);

où: x	Indique la valeur du composant x. Cette valeur est généralement exprimée en unités de présentation.
y	Indique la valeur du composant y. Cette valeur est généralement exprimée en unités de présentation.


OG_Query

Description	Indique l'identificateur d'une interrogation.


OG_Rectangle

Description	Définit une région rectangulaire. Ce type de données est un enregistrement défini de la manière suivante :

Syntaxe

TYPE OG_Rectangle IS RECORD
(x       NUMBER(10,0),
 y       NUMBER(10,0),
 hauteur NUMBER(10,0),
 largeur NUMBER(10,0)
);

où : x	Indique la coordonnée x de l'angle supérieur gauche du rectangle (en unités de présentation).
y	Indique la coordonnée y de l'angle supérieur gauche du rectangle (en unités de présentation).
hauteur	Indique la hauteur du rectangle (en unités de présentation).
largeur	Indique la largeur du rectangle (en unités de présentation).


OG_Refline

Description	Indique un identificateur d'une ligne de référence.


OG_Sound

Description	Indique un identificateur d'un son.


OG_Template

Description	Indique un identificateur d'un modèle de graphique.


OG_Timer

Description	Indique un identificateur d'une horloge.


OG_Window

Description	Indique un identificateur d'une fenêtre.


TOOL_INT.PARAMLIST

Description	Indique l'identificateur d'une liste de paramètres.


TOOL_INT.PARAM_ATTR

Description	Définit un paramètre. Ce type de données est un enregistrement défini de la manière suivante :

Syntaxe

TYPE TOOL_INT.param_attr IS RECORD
(masque     NUMBER(1,0),
 typeparam  NUMBER(1,0),
 valeur     VARCHAR2(255))
);

où : masque	Indique le masque de l'enregistrement d'attribut.
typeparam	Indique le type de paramètre. La valeur de ce champ d'enregistrement peut être l'une des constantes intégrées suivantes : TOOL_INT.DATA_PARAMETER TOOL_INT.TEXT_PARAMETER
valeur	Indique la valeur du paramètre.


Built-in Global Variables

OG_App

OG_Inch

OG_Null_Axis

OG_Null_Buttonproc

OG_Null_Display

OG_Null_Ftemp

OG_Null_Layer

OG_Null_Object

OG_Null_Query

OG_Null_Refline

OG_Null_Sound

OG_Null_Template

OG_Null_Timer

OG_Null_Window


OG_App

Description	Cette variable contient un cliché des valeurs des attributs de l'application au moment où le premier élément PL/SQL intégré est exécuté.

Syntaxe

OG_App  OG_App_Attr;

Remarque : Comme cette variable globale est un cliché ponctuel des valeurs, les modifications que vous apportez aux attributs de l'application ne se répercuteront pas sur cette variable. Par exemple, les attributs nom utilisateur, mot de passe et connexion ne sont pas mis automatiquement à jour lorsque la connexion à la base de données change.


OG_Inch

Description	Cette variable contient le nombre d'unités de présentation par pouce.

Syntaxe

OG_Inch  NUMBER;


 OG_Null_Axis

Description	Est un identificateur nul d'un axe de graphique.

Syntaxe

OG_Null_Axis  OG_Axis;


OG_Null_Buttonproc

Description	Est un identificateur nul d'une procédure bouton.

Syntaxe

OG_Null_Buttonproc  OG_Buttonproc;


OG_Null_Display

Description	Est un identificateur nul d'un affichage.

Syntaxe

OG_Null_Display  OG_Display;


OG_Null_Ftemp

Description	Est un identificateur nul d'un modèle de champ.

Syntaxe

OG_Null_Ftemp  OG_Ftemp;


OG_Null_Layer

Description	Est un identificateur nul d'une couche.

Syntaxe

OG_Null_Layer  OG_Layer;


OG_Null_Object

Description	Est un identificateur nul d'un objet graphique.

Syntaxe

OG_Null_Object  OG_Object;


OG_Null_Query

Description	Est un identificateur nul d'une interrogation.

Syntaxe

OG_Null_Query  OG_Query;


OG_Null_Refline

Description	Est un identificateur nul d'une ligne de référence.

Syntaxe

OG_Null_Refline  OG_Refline;


OG_Null_Sound

Description	Est un identificateur nul d'un son.

Syntaxe

OG_Null_Sound  OG_Sound;


OG_Null_Template

Description	Est un identificateur nul d'un modèle de graphique.

Syntaxe

OG_Null_Template  OG_Template;


OG_Null_Timer

Description	Est un identificateur nul d'une horloge.

Syntaxe

OG_Null_Timer  OG_Timer;


OG_Null_Window

Description	Est un identificateur nul d'une fenêtre.

Syntaxe

OG_Null_Window  OG_Window;


Liste alphabétique des procédures internes

OG_Activate_Layer

OG_Activate_Timer

OG_Append_Directory

OG_Append_File

OG_Append_Row

OG_Center

OG_Clear_Query

OG_Clone (objet)

OG_Clone (modèle)

OG_Close_Display

OG_Connect

OG_Damage (objet)

OG_Damage (région)

OG_Data_Changed

OG_Data_Queried

OG_Deactivate_Timer

OG_Delete_Child

OG_Delete_Cmptext

OG_Delete_Column

OG_Delete_Field

OG_Delete_Ftemp

OG_Delete_Param

OG_Delete_Point

OG_Delete_Property

OG_Delete_Refline

OG_Delete_Smptext

OG_Destroy (objet)

OG_Destroy (interrogation)

OG_Destroy (son)

OG_Destroy (modèle)

OG_Destroy (horloge)

OG_Destroy (fenêtre)

Do_Sql

OG_Draw

OG_Execute_Query

OG_Export_Drawing (affichage)

OG_Export_Drawing (objet/couche)

OG_Export_Drawing (fenêtre)

OG_Export_Image

OG_Export_Sound

OG_Export_Template

OG_Generate_Display

OG_Get_Attr (application)

OG_Get_Attr (axe)

OG_Get_Attr (affichage)

OG_Get_Attr (modèle de champ)

OG_Get_Attr (modèle d'encadrement)

OG_Get_Attr (objet)

OG_Get_Attr (imprimante)

OG_Get_Attr (interrogation)

OG_Get_Attr (ligne de référence)

OG_Get_Attr (son)

OG_Get_Attr (horloge)

OG_Get_Attr (fenêtre)

OG_Get_Axis

OG_Get_Buttonproc

OG_Get_Char_Param

OG_Get_Char_Property

OG_Get_Charcell

OG_Get_Chart_Element

OG_Get_Child

OG_Get_Cmptext

OG_Get_Column

OG_Get_Date_Param

OG_Get_Date_Property

OG_Get_Datecell

OG_Get_Display

OG_Get_Field

OG_Get_Ftemp

OG_Get_Layer

OG_Get_Newrows

OG_Get_Num_Param

OG_Get_Num_Property

OG_Get_Numcell

OG_Get_Object

OG_Get_Param_Type

OG_Get_Point

OG_Get_Query

OG_Get_Refline

OG_Get_Row

OG_Get_Schema

OG_Get_Smptext

OG_Get_Sound

OG_Get_Template

OG_Get_Timer

OG_Get_Window

OG_Help

OG_Hide_Layer

OG_Hide_Window

OG_Host

OG_Import_Drawing

OG_Import_Image

OG_Import_Sound

OG_Import_Template

OG_Insert_Child

OG_Insert_Cmptext

OG_Insert_Column

OG_Insert_Field

OG_Insert_Ftemp

OG_Insert_Point

OG_Insert_Refline

OG_Insert_Smptext

OG_Isnull

OG_Logged_On

OG_Logoff

OG_Logon

OG_Make_Chart

OG_Make_Ellipse

OG_Make_Group

OG_Make_Image

OG_Make_Line

OG_Make_Poly

OG_Make_Query

OG_Make_Rect

OG_Make_Rrect

OG_Make_Sound

OG_Make_Symbol

OG_Make_Template

OG_Make_Text

OG_Make_Timer

OG_Make_Window

OG_Move

OG_Next_Row

OG_Numcols

OG_Numrows

OG_Open_Display

OG_Param_Exists

OG_Pause

OG_Play_Sound

OG_Point_In

OG_Point_Near

OG_Print

OG_Property_Exists

OG_Quit

OG_Record_Sound

OG_Root_Object

OG_Rotate

OG_Same

OG_Save_Display

OG_Scale

OG_Set_Edgecolor

OG_Set_Fillcolor

OG_Set_Attr (application)

OG_Set_Attr (axe)

OG_Set_Attr (élément de graphique)

OG_Set_Attr (affichage)

OG_Set_Attr (modèle de champ)

OG_Set_Attr (modèle d'encadrement)

OG_Set_Attr (objet)

OG_Set_Attr (imprimante)

OG_Set_Attr (interrogation)

OG_Set_Attr (ligne de référence)

OG_Set_Attr (son)

OG_Set_Attr (horloge)

OG_Set_Attr (fenêtre)

OG_Set_Charcell

OG_Set_Datecell

OG_Set_Numcell

OG_Set_Schema

OG_Set_Param

OG_Set_Property

OG_Show_Layer

OG_Show_Window

OG_Start_From

OG_Stop_Sound

OG_Synchronize

Tool_Int.Add_Parameter

Tool_Int.Create_Parameter_List

Tool_Int.Delete_Parameter

Tool_Int.Destroy_Parameter_List

Tool_Int.Get_Parameter_Attr

Tool_Int.Get_Parameter_List

Tool_Int.Isnull

Tool_Int.Run_Product

Tool_Int.Set_Parameter_Attr

OG_Translate_Envvar

OG_Update_Chart

OG_Update_Bbox

OG_User_Exit


Aucune procédure interne ne commence par cette lettre.


Procédures internes de graphique

OG_Delete_Column

OG_Delete_Field

OG_Get_Chart_Element

OG_Get_Column

OG_Get_Field

OG_Get_Row

OG_Insert_Field

OG_Make_Chart

OG_Update_Chart


OG_Delete_Column

  Exemples	  Rubriques connexes

Description  Cette procédure supprime une colonne d'une interrogation personnalisée.

Syntaxe

PROCEDURE OG_Delete_Column
  (ident_interro  OG_Query,
   indx           NUMBER,
   total          NUMBER);

Paramètres

ident_interro	Identificateur de l'interrogation dans laquelle se trouve la colonne à supprimer.
indx	Index de la première colonne à supprimer de l'interrogation.
total	Nombre total de colonnes à supprimer.


OG_Delete_Column - Exemple

  Liste alphabétique          [image]  Tous les exemples    [image]  Rubriques connexes

 /* La procédure ci-dessous supprime une colonne
 ** de l'interrogation ‘interro0’:
 */

PROCEDURE example(col_num number) IS
   query   OG_Query;
BEGIN
   query:=OG_Get_Query(‘interro0’);
   OG_Delete_Column(query, col_num, 1);
END;


OG_Delete_Field

  Exemples	  Rubriques connexes

Description  Cette procédure supprime un ou plusieurs champs de l'objet graphique indiqué.

Syntaxe

PROCEDURE OG_Delete_Field
  (ident_graph  OG_Object,
   indx         NUMBER,
   total        NUMBER);

Paramètres

ident_graph	Identificateur de l'objet graphique.
indx	Index du premier champ à supprimer de la liste des champs.
total	Nombre total de champs à supprimer.

Notes d'utilisation  La suppression d'un champ le supprime uniquement du graphique indiqué, mais ne supprime pas (ou ne modifie pas) le modèle de champ auquel le champ peut faire référence. En outre, les modifications que vous apportez à la liste des champs du graphique ne sont appliquées que lorsque le graphique est mis à jour par un appel à OG_Update_Chart.


OG_Delete_Field - Exemples

  Liste alphabétique          [image]  Tous les exemples    [image]  Rubriques connexes

 /* Un graphique affiche les tracés correspondant aux données de salaires
** et de commissions, et le tracé des commissions doit être supprimé de ce
** graphique pour être tracé dans un autre graphique
*/

PROCEDURE transfer_comm(chart1 IN OG_Object, chart2 IN
OG_Object, field_index in number) IS
   the_field   OG_Field;
BEGIN
   the_field:=OG_Get_Field(Chart1, field_index);
   OG_Delete_Field(Chart1, field_index, 1);
   OG_Insert_Field(Chart2, the_field, OG_Last);
   OG_Update_Chart(Chart1, OG_All_Chupda);
   OG_Update_Chart(Chart2, OG_All_Chupda);
END;


OG_Get_Chart_Element

  Exemples	  Rubriques connexes

Description  A partir de l'identificateur d'un groupe d'éléments graphiques (barres, secteur, etc.) et d'un numéro de ligne, cette fonction retourne l'élément correspondant à ce numéro de ligne.

Syntaxe

FUNCTION OG_Get_Chart_Element
  (ident_groupe  OG_Object,
   num_ligne     NUMBER)
RETURN OG_Object;

Paramètres

ident_groupe	Identificateur de groupe contenant l'élément graphique.
num_ligne	Numéro de ligne correspondant à l'élément graphique que vous voulez obtenir.

Retourne  L'élément graphique correspondant au numéro de ligne indiqué.

Notes d'utilisation  L'identificateur de groupe peut être extrait de l'objet graphique à l'aide de OG_Get_Object et du nom approprié.


OG_Get_Chart_Element - Exemples

  Liste alphabétique          [image]  Tous les exemples    [image]  Rubriques connexes

 /* La procédure ci-dessous modifie la couleur de la première
 ** barre d'un graphique en colonne, quelle que soit sa valeur :
 */

PROCEDURE example(chart OG_Object) IS
  bars_group  OG_Object;
  elem        OG_Object;
BEGIN
  bars_group := OG_Get_Object('Barres_Sal', chart);
  elem := OG_Get_Chart_Element(Bars_Group, 0);
  OG_Set_Fillcolor(Elem, 'rouge');
END;


OG_Get_Column

  Exemples	  Rubriques connexes

Description  Cette fonction retourne le nom de la colonne d'interrogation représentée par un élément graphique spécifique.

Syntaxe

FUNCTION OG_Get_Column
  (ident_élém_gr  OG_Object)
RETURN VARCHAR2;

Paramètres

ident_élém_gr	Identificateur de l'élément graphique.

Retourne  Le nom de la colonne associée à l'élément graphique.


OG_Get_Column - Exemples

  Liste alphabétique          [image]  Tous les exemples    [image]  Rubriques connexes

 /* La fonction ci-dessous retourne la colonne de l'interrogation représentée
 ** par la première barre d'un graphique en colonne.
 */

FUNCTION example(chart OG_Object) RETURN CHAR IS
  bars  OG_Object;
  elem  OG_Object;
  col   VARCHAR2(15);
BEGIN
  bars := OG_Get_Object('Barres_Sal', chart);
  elem := OG_Get_Chart_Element(Bars, 0);
  col := OG_Get_Column(Elem);
  RETURN(col);
END;


 OG_Get_Field

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un enregistrement contenant les valeurs des attributs du champ du graphique indiqué.

Syntaxe

FUNCTION OG_Get_Field
  (ident_graph  OG_Object,
   indx         NUMBER)
RETURN OG_Field;

Paramètres

ident_graph	Identificateur de l'objet graphique.
indx	Index du champ de la liste de champs de graphique à retourner.

Retourne  Les attributs du champ indiqué.


OG_Get_Field - Exemples

  Liste alphabétique          [image]  Tous les exemples    [image]  Rubriques connexes

 /* Un graphique affiche les tracés correspondant aux données de salaires
 ** et de commissions, et le tracé des commissions doit être supprimé du
 ** graphique pour être tracé dans un autre graphique.
 */

PROCEDURE transfer_comm(chart1 IN OG_Object, chart2 IN
  OG_Object, field_index IN NUMBER) IS
   the_field   OG_Field
BEGIN
   the_field:=OG_Get_Field(The_Chart, field_index);
   OG_Delete_Field(Chart1, field_index, 1);
   OG_Insert_Field(Chart2, the_field, OG_Last);
END;


OG_Get_Row

  Exemples	  Rubriques connexes

Description  Cette fonction retourne le numéro de ligne d'interrogation représenté par un élément graphique spécifique.

Syntaxe

FUNCTION OG_Get_Row
  (ident_élém_gr  OG_Object,
RETURN NUMBER;

Paramètres

ident_élém_gr	Identificateur de l'élément graphique.

Retourne  Le numéro de la ligne associée à l'élément graphique.


OG_Get_Row - Exemples

  Liste alphabétique          [image]  Tous les exemples    [image]  Rubriques connexes

 /* Le déclencheur de format ci-dessous éclate le secteur
 ** représentant SAL pour l'employé 'DUPONT':
 */

PROCEDURE OGFORMATTRIG0(elem IN OG_Object,
                        query IN OG_Query) IS
  ename    VARCHAR2(10);
  chart    OG_Object;
  row_num  NUMBER;
BEGIN
  ename := OG_Get_Charcell(Query, 'NOME');
  IF ename = 'DUPONT' THEN
    chart := OG_Get_Object('Chart0');
    row_num := OG_Get_Row(Elem);
    OG_Set_Explosion(Chart, row_num, 'SAL', 25);
  END IF;
END;


 OG_Insert_Field

  Exemples	  Rubriques connexes

Description  Cette procédure insère un nouveau champ dans le graphique indiqué.

Syntaxe

PROCEDURE OG_Insert_Field
  (ident_graph  OG_Object,
   enreg_champ  OG_Field,
   indx         NUMBER);

Paramètres

ident_graph	Identificateur de l'objet graphique.
enreg_champ	Enregistrement contenant les attributs du champ.
indx	Index auquel insérer le nouveau champ dans la liste des champs du graphique. Cet argument doit être un entier compris entre 0 et n (inclus), où n indique le nombre de champs du graphique avant l'insertion. La valeur de cet argument peut également être l'une des constantes intégrées suivantes : OG_First   Indique l'insertion du nouveau champ au début de la liste des champs du graphique (index = 0). OG_Last   Indique l'insertion du nouveau champ à la fin de la liste des champs du graphique (index = nombre de champs du graphique avant l'insertion).
Notes d'utilisation  Les modifications que vous apportez à la liste des champs du graphique ne sont appliquées que lorsque le graphique est mis à jour par un appel à OG_Update_Chart.


OG_Insert_Field - Exemples

  Liste alphabétique          [image]  Tous les exemples    [image]  Rubriques connexes

 /* Un graphique affiche les tracés correspondant aux données de salaires
 ** et de commissions, et le tracé des commissions doit être supprimé du
 ** graphique pour être tracé dans un autre graphique.
 */

PROCEDURE transfer_comm (chart1 IN OG_Object, chart2 IN
OG_Object, field_index IN NUMBER) IS
   the_field   OG_Field;
BEGIN
   the_field:=OG_Get_Field(The_Chart, field_index);
   OG_Delete_Field(Chart1, field_index, 1);
   OG_Insert_Field(Chart2, the_field, OG_Last);
END;


 OG_Make_Chart

  Exemples	  Rubriques connexes

Description  Cette fonction crée un graphique.

Syntaxe

FUNCTION OG_Make_Chart
  (position          OG_Point,
   hauteur           NUMBER,
   largeur           NUMBER,
   modèle            OG_Template,
   interrogation     OG_Query)
RETURN OG_Object;

Paramètres

position	Coordonnées x et y de l'encadrement du graphique.
hauteur	Hauteur du graphique.
largeur	Largeur du graphique.
modèle	Modèle à utiliser pour le graphique.
interrogation	Interrogation à utiliser pour le graphique.

Retourne  Un identificateur du graphique nouvellement créé.

Notes d'utilisation   Le graphique ne sera terminé que lorsque vous y ajouterez des champs en utilisant OG_Insert_Field et que vous le mettrez à jour en utilisant OG_Update_Chart.


OG_Make_Chart - Exemples

  Liste alphabétique          [image]  Tous les exemples    [image]  Rubriques connexes

 /* La fonction ci-dessous crée un graphique en utilisant
 ** le modèle et l'interrogation indiqués :
 */

FUNCTION example(template OG_Template, query OG_Query) RETURN OG_Object IS
  chart   OG_Object;
  pos     OG_Point;
  height  NUMBER;
  width   NUMBER;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;
  height := 4* OG_Inch;
  width := 4* OG_Inch;

  chart := OG_Make_Chart(Pos, height, width, template, query);
  RETURN(chart);
END;


OG_Update_Chart

  Exemples	  Rubriques connexes

Description  Cette procédure met à jour la ou les partie(s) du graphique indiqué, en fonction du résultat des nouvelles interrogation ou des nouveaux attributs qui ont été appliqués aux éléments graphiques. Vous devez avoir exécuté l'interrogation au moins une fois pour pouvoir mettre à jour un graphique sur lequel repose cette interrogation.

Syntaxe

PROCEDURE OG_Update_Chart
  (ident_graph    OG_Object,
   masque_graph   NUMBER,
   dommage        BOOLEAN    :=  TRUE,
   boîte_maj      BOOLEAN    :=  TRUE);

Paramètres

ident_graph	Identificateur du graphique à mettre à jour.
Masque_graph	Partie(s) du graphique à mettre à jour. La valeur de cet argument peut être l'une des constante intégrées suivantes :  OG_All_Chupda   Indique la mise à jour de la totalité du graphique. OG_Dep1axis_Chupda Indique la mise à jour uniquement des parties du graphique associées au premier axe dépendant. OG_Dep2axis_Chupda Indique la mise à jour uniquement des parties du graphique associées au second axe dépendant. OG_Frame_Chupda Indique la mise à jour uniquement des parties de graphique associées à l'encadrement. OG_Indaxis_Chupda Indique la mise à jour uniquement des parties du graphique associées à l'axe indépendant. OG_Inframe_Chupda Indique la mise à jour uniquement des parties du graphique qui apparaissent dans l'encadrement. OG_Legend_Chupda Indique la mise à jour uniquement des parties du graphique associées à la légende. OG_None_Chupda Indique que les parties du graphique ne seront pas mises à jour. OG_Title_Chupda   Indique la mise à jour uniquement du titre du graphique.
Dommage	Indicateur de dommage.
Boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Lorsque cette procédure est appelée, Graphics Builder détruit le graphique en cours et le reconstruit en fonction du résultat de la mise à jour de l'interrogation et des paramètres des attributs. Les modifications à apporter aux paramètres des attributs d'un élément graphique depuis le dernier appel à OG_Update_Chart seront donc perdues. Par exemple, si vous utilisez OG_Set_Attr pour définir les attributs d'une barre spécifique du graphique, que vous mettez à jour ensuite, vous obtenez les résultats voulus. Cependant, si vous appelez à nouveau OG_Update_Chart, les modifications seront perdues et la barre apparaîtra avec ses paramètres par défaut.

N'oubliez donc pas que, chaque fois que vous mettez le graphique à jour, vous devez commencer par modifier ses éléments. Cette étape supplémentaire vous semblera souvent utile, puisque les critères de modification des éléments du graphique peuvent changer avec les modifications des données.


OG_Update_Chart - Exemples

  Liste alphabétique          [image]  Tous les exemples    [image]  Rubriques connexes

 /* Un graphique doit être mis à jour périodiquement.
 ** Pour cela, écrire le déclencheur d'horloge suivant :
 */

PROCEDURE my_timer IS+
   my_query   OG_Query;
   my_chart   OG_Object;
BEGIN
   my_query:=OG_Get_Query('Interro_Emp');
   my_chart:=OG_Get_Object('Graph_Emp');
   OG_Execute_Query(My_Query);
   OG_Update_Chart(My_Chart, OG_All_Chupda);
END;


Procédures internes de base de données

OG_Connect

OG_Logged_On

OG_Logoff

OG_Logon


 OG_Connect

  Exemples	  Rubriques connexes

Description  Cette fonction affiche la boîte de dialogue Connexion.

Syntaxe

FUNCTION OG_Connect
RETURN BOOLEAN;

Paramètres

Aucun.


OG_Connect - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* Une application demande que
** l'utilisateur soit connecté à une base de données. La
** procédure décrite ci-dessous vérifie
** l'existence de la connexion et, si elle n'existe pas, demande à
** l'utilisateur de se connecter en affichant la boîte de dialogue Connexion :
*/

PROCEDURE ensure_connection IS
BEGIN
   IF NOT OG_Logged_On THEN
   status:=OG_Connect;
   END IF;
END;


OG_Logged_On

  Exemples	  Rubriques connexes

Description  Cette fonction retourne TRUE si l'utilisateur est connecté à une base de données et FALSE dans le cas contraire.

Syntaxe

FUNCTION OG_Logged_On
RETURN BOOLEAN;

Paramètres

Aucun.

Retourne TRUE	Si l'utilisateur est connecté à la base de données
FALSE	Si l'utilisateur n'est pas connecté à une base de données


OG_Logged_On - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Une application demande que l'utilisateur soit
** connecté à une base de données. La procédure décrite ci-dessous
** vérifie l'existence de la connexion et, si elle n'existe pas, demande à
** l'utilisateur de se connecter en affichant la boîte de dialogue Connexion :
*/

PROCEDURE ensure_connection IS
BEGIN
   IF NOT OG_Logged_On THEN
      OG_Connect;
   END IF;
END;


OG_Logoff

  Exemples	  Rubriques connexes

Description  Cette procédure ferme la connexion avec la base de données.

Syntaxe

PROCEDURE OG_Logoff;

Paramètres :

Aucun.


OG_Logoff - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* Pour se déconnecter d'une base de données lorsque l'affichage est fermé,
** écrire le déclencheur de fermeture d'affichage suivant :
*/

PROCEDURE close_trig IS
BEGIN
   IF OG_Logged_On THEN
      OG_Logoff;
   END IF;
END;


OG_Logon

  Exemples	  Rubriques connexes

Description  Cette procédure vous connecte à la base de données indiquée.

Syntaxe

PROCEDURE OG_Logon
  (nom_utilisateur        VARCHAR2  :=  NULL,
   mot_de_passe        VARCHAR2  :=  NULL,
   chaîne_de_connexion VARCHAR2  :=  NULL);

Paramètres

nom_utilisateur	Nom utilisateur à utiliser
mot_de_passe	Mot de passe à utiliser
chaîne_de_connexion	Chaîne de connexion à la base de données à utiliser. Pour vous connecter à une base de données distante, vous devez fournir la chaîne de connexion de base de données SQL*Net appropriée. Pour plus d'informations, reportez-vous à Oracle Network Manager Administrator's Guide.

Notes d'utilisation  S'il existe déjà une connexion, elle est abandonnée, que la connexion tentée par cette procédure réussisse ou non.


OG_Logon - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Une application demande que l'utilisateur soit connecté à une base de données.
** La procédure décrite ci-dessous vérifie l'existence de la connexion et, si elle n'existe
** pas, demande à l'utilisateur de se connecter en affichant la boîte de dialogue Connexion :
*/

PROCEDURE ensure_connection IS
BEGIN
   IF NOT OG_Logged_On THEN
      OG_Logon('Scott', 'tiger', 't:paris:MA_BD');
   END IF;
END;


Procédures internes d'affichage

OG_Close_Display

OG_Generate_Display

OG_Get_Display

OG_Isnull

OG_Open_Display

OG_Save_Display


OG_Close_Display

  Exemples	  Rubriques connexes

Description  Cette procédure ferme l'affichage indiqué et détruit toutes les fenêtres utilisées par cet affichage. Elle entraîne également l'exécution du déclencheur de fermeture d'affichage indiqué.

Syntaxe

PROCEDURE OG_Close_Display
  (ident_affichage  OG_Display);

Paramètres

ident_affichage	Identificateur de l'affichage à fermer.

Notes d'utilisation  Notez que si vous appelez une procédure qui ferme l'affichage en cours (c'est-à-dire dans lequel est définie la procédure en cours d'exécution), OG_Close_Display doit figurer dans la dernière ligne de cette procédure. En d'autres termes, vous ne pouvez pas exécuter d'autres instructions PL/SQL dans un affichage que vous avez fermé.


OG_Close_Display - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* L'utilisateur a fini d'utiliser un affichage.
 ** Cet affichage doit être fermé avant l'ouverture d'un autre affichage.
*/

PROCEDURE continue (old_disp_name, new_disp_name) IS
   old_disp   OG_Display;


OG_Generate_Display

  Exemples	  Rubriques connexes

Description  Cette fonction génère l'affichage en cours. L'affichage généré peut être exécuté par les exécutables Graphics Builder Runtime et Batch.

Syntaxe

PROCEDURE OG_Generate_Display;

PROCEDURE OG_Generate_Display
  (nom        VARCHAR2,
   gisement  OG_Number);

Paramètres

nom	Nom de l'affichage généré. Si l'affichage doit être stocké dans la base de données, cet argument ne doit contenir que le nom de l'affichage. Si l'affichage doit être stocké dans le système de fichiers, cet argument doit contenir le chemin d'accès absolu ou relatif au fichier d'affichages.
gisement	Indique si l'affichage doit être stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Db   Indique que l'affichage doit être stocké dans la base de données. OG_Filesystem   Indique que l'affichage doit être stocké dans le système de fichiers.
Notes d'utilisation  Si vous omettez nom et gisement, l'affichage est généré sous le nom et le gisement à partir duquel il a été ouvert en dernier.


OG_Generate_Display - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Un affichage permet à l'utilisateur d'indiquer de manière interactive
**les interrogations à visualiser et le type de graphique à utiliser.
**Lorsque l'utilisateur sélectionne un bouton de "génération",
**une version runtime de l'affichage
**que l'utilisateur pourra utiliser ultérieurement doit être générée.
*/

PROCEDURE gen(buttonobj IN OG_Object, hitobj IN OG_Object,
  win IN OG_Window, eventinfo IN OG_Event) IS


OG_Get_Display

  Exemples	  Rubriques connexes

Description  Notez que nom_affichage doit toujours être ouvert pendant la session Graphics Builder en cours. Pour ouvrir un affichage autre que celui qui est en cours d'exécution, utilisez OG_Open_Display.

Syntaxe

FUNCTION OG_Get_Display
RETURN OG_Display;

FUNCTION OG_Get_Display
  (nom_affichage  VARCHAR2,
   gisement    NUMBER)
RETURN OG_Display;

Paramètres

nom_affichage	Nom de l'affichage. Si l'affichage est stocké dans la base de données, cet argument doit contenir uniquement le nom de l'affichage. Si l'affichage est stocké dans le système de fichiers, cet argument doit contenir le chemin d'accès absolu ou relatif au fichier d'affichages.
gisement	Indique si l'affichage doit être stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Db   Indique que l'affichage doit être stocké dans la base de données. OG_Filesystem   Indique que l'affichage doit être stocké dans le système de fichiers.
Retourne  Un identificateur de l'affichage indiqué. Si cet affichage n'existe pas ou n'est pas ouvert, la fonction retourne un identificateur NULL.

Notes d'utilisation  Si nom_affichage et gisement sont omis, cette fonction retourne un identificateur de l'affichage en cours.


OG_Get_Display - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* L'utilisateur a fini d'utiliser un affichage,
** Cet affichage doit être fermé avant l'ouverture d'un autre affichage.
*/
.

PROCEDURE continue(old_disp_name, new_disp_name) IS
   old_disp   OG_Display;
   new_disp   OG_Display;
BEGIN
   old_dispb:=OG_Get_Display(Old_Disp_Name, OG_Filesystem);
   OG_Close_Display(Old_Disp);
   new_dispb:=OG_Open_Display(New_Disp_Name, OG_Filesystem);
END;


OG_Isnull

  Exemples	  Rubriques connexes

Description  Cette fonction détermine si l'identificateur indiqué est un identificateur NULL.

Syntaxe

FUNCTION OG_Isnull                           interrogation
  (Identificateur  OG_Query)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           objet
  (Identificateur  OG_Object)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           modèle de graphique
  (Identificateur  OG_Template)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           procédure bouton
  (Identificateur  OG_Buttonproc)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           son
  (Identificateur  OG_Sound)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           fenêtre
  (Identificateur  OG_Window)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           couche
  (Identificateur  OG_Layer)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           horloge
  (Identificateur  OG_Timer)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           affichage
  (Identificateur  OG_Display)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           axe
  (Identificateur  OG_Axis)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           modèle de champ
  (Identificateur  OG_Ftemp)
RETURN BOOLEAN;

FUNCTION OG_Isnull                           ligne de référence
  (Identificateur  OG_Refline)
RETURN BOOLEAN;

Paramètres

identificateur	Identificateur à évaluer.
Retourne TRUE	Si l'identificateur est NULL
FALSE	Si l'identificateur n'est pas NULL.


OG_Isnull - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Un affichage crée parfois un objet texte contenant un message d'avertissement. Dans
** certains cas, il est souhaitable de supprimer le message d'avertissement avant de
** poursuivre l'exécution de l'affichage. Au lieu de garder la trace de la génération d'un
** message d'avertissement, il peut être utile de rechercher l'existence de l'objet texte avant de le supprimer.
*/

PROCEDURE remove_warning IS
   warning_obj   OG_Object;
BEGIN
   warning_obj:=OG_Get_Object(‘avertissement’);
   IF NOT (OG_Isnull(warning_obj)) THEN;
      OG_Destroy(warning_obj);
   END IF;
END;


OG_Open_Display

  Exemples	  Rubriques connexes

Description  Cette fonction ouvre l'affichage indiqué et exécute son déclencheur d'ouverture d'affichage. Elle retourne un identificateur de l'affichage que vous pourrez utiliser ultérieurement comme argument pour OG_Close_Display. Si l'affichage n'existe pas, cette fonction retourne un identificateur NULL.

Syntaxe

FUNCTION OG_Open_Display
  (nom_affichage  VARCHAR2,
   gisement    NUMBER)
RETURN OG_Display;

Paramètres

nom_affichage	Nom de l'affichage. Si l'affichage est stocké dans la base de données, cet argument doit contenir uniquement le nom de l'affichage. Si l'affichage est stocké dans le système de fichiers, cet argument doit contenir le chemin d'accès absolu ou relatif au fichier d'affichages.
gisement	Indique si l'affichage est stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Db   Indique que l'affichage est stocké dans la base de données. OG_Filesystem   Indique que l'affichage est stocké dans le système de fichiers.
Retourne  Un identificateur du dernier affichage ouvert.

Notes d'utilisation  Notez que cette fonction n'accepte pas d'identificateur d'affichage comme argument, car l'existence de l'affichage dans le système de fichiers ou dans la base de données doit être vérifié avant l'ouverture de cet affichage. Vous avez, par exemple, utilisé OG_Get_Display pour accéder à l'identificateur d'affichage, puis supprimé l'affichage du système de fichiers ou de la base de données. Si vous avez tenté de transférer l'identificateur d'affichage à OG_Open_Display, il ne pourra pas trouver l'affichage auquel l'identificateur fait référence. Le nom de l'affichage devra donc être réutilisé.


OG_Open_Display - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* L'utilisateur a fini d'utiliser un affichage,
** Cet affichage doit être fermé avnat l'ouverture d'un autre affichage.
*/

PROCEDURE continue(old_display_name IN CHAR,
new_display_name IN CHAR) IS
   old_display   OG_Display;
   new_display   OG_Display;
BEGIN
   old_display:=OG_Get_Display(old_display_name, OG_Filesystem);
   new_display:=OG_Open_Display(new_display_name, OG_Filesystem);
   OG_Close_Display(old_display);
END;


OG_Save_Display

  Exemples	  Rubriques connexes

Description  Cette fonction enregistre l'état actuel de l'affichage. L'affichage enregistré est terminé et peut être ouvert et édité dans Graphics Builder.

Syntaxe

PROCEDURE OG_Save_Display;

PROCEDURE OG_Save_Display
  (nom        VARCHAR2,
   gisement  OG_Number);

Paramètres

nom	Nom sous lequel l'affichage est enregistré. Si l'affichage doit être stocké dans la base de données, cet argument doit contenir uniquement le nom de l'affichage. Si l'affichage doit être stocké dans le système de fichiers, cet argument doit contenir le chemin d'accès absolu ou relatif au fichier d'affichages.
gisement	Indique si l'affichage doit être stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Db   Indique que l'affichage doit être stocké dans la base de données. OG_Filesystem   Indique que l'affichage doit être stocké dans le système de fichiers.
Notes d'utilisation  Si vous omettez nom et gisement, l'affichage est généré sous le nom et le gisement à partir duquel il a été ouvert en dernier.


OG_Save_Display - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* Pour importer 100 images TIFF, ce qui est
** long et fastidieux, il est conseillé
** d'écrire la procédure ci-dessous,
** qui importe les images des fichiers `image00'
** à `image99'. Une fois l'opération terminée, l'affichage est enregistré de
** façon à pouvoir être ouvert à nouveau dans Builder.
*/

PROCEDURE import_100 IS
   the_image   OG_Image;
   file_name   VARCHAR2(7);
BEGIN
   FOR i IN 0..99 LOOP
      file_name:='image'||SUBSTR(TO_CHAR(i, `09'), 2);
      the_image:=OG_Import_Image(File_Name, OG_Filesystem, OG_Tiff_Iformat);
   END LOOP;
   OG_Save_Display;
END;


Procédures internes de couches
Procédures internes de couche

OG_Activate_Layer

OG_Get_Layer

OG_Hide_Layer

OG_Show_Layer


OG_Activate_Layer

  Exemples	  Rubriques connexes

Description  Cette procédure active la couche indiquée dans la fenêtre indiquée.

Syntaxe

PROCEDURE OG_Activate_Layer
  (ident_couche   OG_Layer,
   iden_fenêtre  OG_Window
   dommage      BOOLEAN   :=  TRUE);

PROCEDURE OG_Activate_Layer
  (ident_couche   OG_Layer,
   dommage      BOOLEAN   :=  TRUE);

Paramètres

ident_couche	Identificateur de la couche activée.
ident_fenêtre	Identificateur de la fenêtre dans laquelle la couche est activée. Si cet identificateur n'est pas indiqué, la couche est activée dans toutes les fenêtres.
dommage	Indicateur de dommage.

Notes d'utilisation  L'activation d'une couche masquée déclenche son affichage. Vous ne pouvez avoir qu'une couche active à la fois ; lorsque vous activez une couche, la couche active précédemment est désactivée.

Si vous insérez un objet de groupe comme fils de l'objet racine de l'affichage, vous pouvez utiliser OG_Get_Layer pour obtenir un identificateur de couche de ce groupe. L'activation de ce type d'objet de groupe oblige Graphics Builder à le considérer comme une couche.


OG_Activate_Layer - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Une présentation comporte plusieurs couches,
**contenant chacune une série de boutons.
**Pour que certains boutons soient actifs
**à un moment donné, activer la couche qui
**les contient. Si l'utilisateur
**sélectionne un objet bouton qui n'est pas dans la couche active,
**aucune opération n'est exécutée.
*/

PROCEDURE activate_a_layer(layer_num NUMBER, the_window OG_Window) IS
   layer_name   VARCHAR2(6);
   the_layer    OG_Layer;
BEGIN
   layer_name:='couche'||TO_CHAR(layer_num);
   the_layer:=OG_Get_Layer(Layer_Name);
   OG_Activate_Layer(The_Layer, the_window);
END;


OG_Get_Layer

  Exemples	  Rubriques connexes

Description  Notez que vous pouvez également considérer une couche comme un objet de groupe en transmettant son nom à OG_Get_Object.

Syntaxe

FUNCTION OG_Get_Layer
  (nom_couche  VARCHAR2)
RETURN OG_Layer;

Paramètres

nom_couche	Indique le nom de la couche dont l'identificateur doit être retourné.

Retourne  Un identificateur de la couche indiquée. Si cette couche n'existe pas, la fonction retourne un identificateur NULL.

Notes d'utilisation  Vous pouvez en outre utiliser OG_Get_Layer pour extraire un identificateur de couche d'un objet de groupe, puis obliger ce groupe à devenir une couche en l'affichant ou en l'activant.


OG_Get_Layer - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour masquer "couche1".
*/

PROCEDURE make_layer1_invis (the_window) IS
   my_layer   OG_Layer;
BEGIN
   my_layer:=OG_Get_Layer('Couche1');
   OG_Hide_Layer(My_Layer, the_window);
END;


OG_Hide_Layer

  Exemples	  Rubriques connexes

Description  Cette procédure masque la couche indiquée.

Syntaxe

PROCEDURE OG_Hide_Layer
  (ident_couche   OG_Layer);

PROCEDURE OG_Hide_Layer
  (ident_couche   OG_Layer,
   ident_fenêtre  OG_Window);

Paramètres

ident_couche	Identificateur de la couche masquée
ident_fenêtre	Identificateur de la fenêtre dans laquelle la couche est masquée. S'il n'est pas indiqué, la couche est masquée dans toutes les fenêtres.

Notes d'utilisation  Si la couche est affichée dans plusieurs fenêtres, elle sera masquée uniquement dans la fenêtre indiquée. La couche active ne peut pas être masquée ; pour cela, vous devez commencer par activer une autre couche.


OG_Hide_Layer - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* "Couche1" contient des informations qu'il n'est plus nécessaire afficher.
**Pour les masquer, utiliser la procédure suivante :
*/

PROCEDURE make_couche1_invis(the_window) IS
   my_layer   OG_Layer;
BEGIN
   my_layer:=OG_Get_Layer('Couche1');
   OG_Hide_Layer(My_Layer, the_window);
END;


OG_Show_Layer

  Exemples	  Rubriques connexes

Description  Cette procédure affiche la couche indiquée.

Syntaxe

PROCEDURE OG_Show_Layer
  (ident_couche   OG_Layer,
   ident_fenêtre  OG_Window);

Paramètres

ident_couche	Identificateur de la couche masquée
ident_fenêtre	Identificateur de la fenêtre dans laquelle la couche est affichée. S'il n'est pas indiqué, la couche est affichée dans toutes les fenêtres.

Notes d'utilisation Si la couche est masquée dans plusieurs fenêtres, elle sera affichée uniquement dans la fenêtre indiquée

Si vous insérez un objet de groupe comme fils de l'objet racine de l'affichage, vous pouvez ensuite utiliser OG_Get_Layer pour obtenir un identificateur de couche de ce groupe. L'affichage de cet objet de groupe oblige Graphics Builder à le considérer comme une couche.


OG_Show_Layer - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour afficher "couche1".
*/

PROCEDURE make_layer_visible (the_window) IS
   my_layer   OG_Layer;
BEGIN
   my_layer:=OG_Get_Layer('Couche1');
   OG_Show_Layer(My_Layer, the_window);
END;


Procédures internes diverses

Do_Sql

OG_Append_Directory

OG_Append_File

OG_Center

OG_Damage (région)

OG_Get_Attr (application)

OG_Get_Attr (axe)

OG_Get_Attr (affichage)

OG_Get_Attr (modèle de champ)

OG_Get_Attr (modèle d'encadrement)

OG_Get_Attr (objet)

OG_Get_Attr (imprimante)

OG_Get_Attr (interrogation)

OG_Get_Attr (ligne de référence)

OG_Get_Attr (son)

OG_Get_Attr (horloge)

OG_Get_Attr (fenêtre)

OG_Get_Buttonproc

OG_Help

OG_Host

OG_Pause

OG_Print

OG_Quit

OG_Root_Object

OG_Set_Attr (application)

OG_Set_Attr (axe)

OG_Set_Attr (élément graphique)

OG_Set_Attr (affichage)

OG_Set_Attr (modèle de champ)

OG_Set_Attr (modèle d'encadrement)

OG_Set_Attr (objet)

OG_Set_Attr (imprimante)

OG_Set_Attr (interrogation)

OG_Set_Attr (ligne de référence)

OG_Set_Attr (son)

OG_Set_Attr (horloge)

OG_Set_Attr (fenêtre)

OG_Translate_Envvar

OG_User_Exit


DO_SQL

  Exemples	  Rubriques connexes

Description  Cette procédure exécute l'instruction SQL indiquée.

Syntaxe

PROCEDURE do_sql
  (instr_sql  VARCHAR2);

Paramètres

instr_sql	Instruction SQL valide, dont les instructions DML (de langage de manipulation de données) ou DLL (de langage de définition de données).

Notes d'utilisation  Comme le code PL/SQL standard ne vous permet pas d'exécuter des instructions DDL, vous utiliserez cette procédure pour les exécuter. Vous pouvez cependant inclure des instructions DML dans vos unités  de programme SQL. En général, les instructions DML sont exécutées de manière plus efficace dans les unités de programme qu'avec la procédure DO_SQL.


Do_Sql - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous crée une table à partir de Graphics Builder :
*/

PROCEDURE create_table(table_name VARCHAR2) IS
BEGIN
  do_sql('créer table' || table_name ||
         '  (empno  number(4),' ||
         '   ename  varchar2(10));');
END;


OG_Append_Directory

  Exemples	  Rubriques connexes

Description  Cette fonction crée une chaîne qui indique un nom de chemin d'accès dans votre système de fichiers.

Syntaxe

FUNCTION OG_Append_Directory
  (rép     VARCHAR2,
   sousrép  VARCHAR2)
RETURN VARCHAR2;

Paramètres

rép	Chaîne qui précise le répertoire auquel sousrép est ajouté. Cet argument doit contenir le nom complet d'un répertoire valide.
sousrép	Chaîne qui précise le sous-répertoire ajouté à rép.

Retourne  Une chaîne de caractères contenant le chemin complet d'accès au répertoire.

Notes d'utilisation  Vous fournissez le nom du répertoire et celui du sous-répertoire, et la fonction les chaîne en utilisant le séparateur de répertoires approprié à votre système.


OG_Append_Directory - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un affichage qui s'exécute sur plusieurs systèmes différents
**et une fonction de cet affichage qui doit importer une image du fichier
**`mon_image'.  La structure des répertoires est identique dans tous les
** systèmes sur lesquels l'affichage est exécuté, mais chaque système demande
** un séparateur de répertoires différent. La procédure ci-dessous crée une
** chaîne de répertoires valides pour chaque système :
*/

PROCEDURE import_my_image(file_path VARCHAR2) IS
   the_image   OG_Object;
BEGIN
   file_path:=OG_Append_Directory(File_Path, 'origine');
   file_path:=OG_Append_Directory(File_Path, 'dupont');
   file_path:=OG_Append_Directory(File_Path, 'images');
   file_path:=OG_Append_File(File_Path, 'mon_image');
   the_image:=OG_Import_Image(File_Path, OG_Filesystem,
OG_Tiff_Iformat);
END;

 /*La valeur initiale de file_path est `C:\'.  Pour les systèmes MS-DOS,
**la valeur de file_path, transmise à OG_Import_Image, est :
**C:\origine\dupont\images\mon_image.
*/

 /* La valeur initiale de file_path est `disc$ic1[]'.  Pour les systèmes VMS,
** la valeur de file_path, transmise à OG_Import_Image, est :
**disc$ic1:[origine.dupont.images]mon_image.
*/


OG_Append_File

  Exemples	  Rubriques connexes

Description  Cette fonction crée une chaîne qui indique le chemin d'accès à un fichier de votre système de fichiers.

Syntaxe

FUNCTION OG_Append_File
  (rép       VARCHAR2,
   nomfichier  VARCHAR2)
RETURN VARCHAR2;

Paramètres

rép	Chaîne qui précise le répertoire auquel nomfichier est ajouté. Cet argument doit contenir le nom complet d'un répertoire valide.
nomfichier	Chaîne qui précise le nom du fichier à ajouter à rép.

Retourne  Une chaîne de caractères contenant le chemin complet d'accès au fichier.

Notes d'utilisation  Vous fournissez le nom du répertoire et celui du fichier, et la fonction les chaîne en utilisant le séparateur de répertoires approprié à votre système.


OG_Append_File - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un affichage qui s'exécute sur plusieurs systèmes différents et une fonction de
** cet affichage qui doit importer une image du fichier `mon_image'.  La structure des
** répertoires est identique dans tous les systèmes sur lesquels l'affichage est exécuté,
** mais chaque système demande un séparateur de répertoires différent. La procédure ci-
** dessous crée une chaîne de répertoires valides pour chaque système :
*/

PROCEDURE import_my_image(file_path VARCHAR2) IS
   the_image   OG_Object;
BEGIN
   file_path:=OG_Append_Directory(File_Path, 'origine');
   file_path:=OG_Append_Directory(File_Path, 'dupont');
   file_path:=OG_Append_Directory(File_Path, 'images');
   file_path:=OG_Append_File(File_Path, 'mon_image');
   the_image:=OG_Import_Image(File_Path, OG_Filesystem,
     OG_Tiff_Iformat);
END;

/*La valeur initiale de file_path est `C:\'.  Pour les systèmes MS-DOS, la valeur de
**file_path, transmise à OG_Import_Image, est : **C:\origine\dupont\images\mon_image.
*/

 /* La valeur initiale de file_path est `disc$ic1[]'.  Pour les systèmes VMS, la valeur de
** file_path, transmise à OG_Import_Image, est : disc$ic1:[origine.dupont.images]mon_image.
*/


OG_Center

  Exemples	  Rubriques connexes

Description  Cette procédure redessine l'affichage dans la fenêtre indiquée afin que le point de l'affichage représenté par pt_centre apparaisse au centre de la fenêtre.

Syntaxe

PROCEDURE OG_Center
  (ident_fenêtre  OG_Window,
   pt_centre   OG_Point);

Paramètres

ident_fenêtre	Identificateur de la fenêtre.
pt_centre	Indique le point de l'affichage sur lequel la fenêtre doit être centrée.


OG_Center - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un graphique qui doit apparaître au centre d'une fenêtre. Il faut
** pour cela obtenir l'emplacement et les dimensions de la boîte englobante
** située à l'extérieur du graphique, calculer son point central, puis utiliser
** pt_centre pour placer ce point au centre de la fenêtre.
*/

PROCEDURE center_chart (my_window IN og_window, my_chart IN
og_object) IS
   center_point   og_point;
   chart_record   og_chart_ca;
BEGIN
   chart_record.chart_caob.mask:=OG_OBBOX_GENERICA;
   chart_record.chart_caog_mask:=OG_NONE_GROUPA;
   chart_record.chart_caoc_mask:=OG_NONE_CHARTA;
   og_get_attr (my_chart, chart_record);
   center_pt.x:=chart_record.chart_caob.obbox.x +
(chart_record.chart_caob.obbox.width / 2);
   center_pt.y:=chart_record.chart_caob.obbox.y +
(chart_record.chart_caob.obbox.height / 2);
   og_center (my_window, center_point);
END;


OG_Damage (région)

  Exemples	  Rubriques connexes

Description  Cette procédure endommage une région rectangulaire de la présentation.

Syntaxe

PROCEDURE OG_Damage
  (région  OG_Rectangle);

PROCEDURE OG_Damage
  (région     OG_Rectangle,
   ident_couche OG_Layer);

Paramètres

région	Région rectangulaire à endommager.
ident_couche	Couche dans laquelle la région rectangulaire est endommagée. Si ce paramètre n'est pas indiqué, la région de toutes les couches est endommagée.

Notes d'utilisation  Pour plus d'informations, reportez-vous à "Indicateur de dommage" .


OG_Damage (région) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous endommage une superficie de 3"x2"
** dans l'angle supérieur gauche de la présentation :
*/

PROCEDURE example IS
  damage_region  OG_Rectangle;
BEGIN
  damage_region.x := 0;
  damage_region.y := 0;
  damage_region.width := 3 * OG_Inch;
  damage_region.height := 2 * OG_Inch;

  OG_Damage(Damage_Region);
END;


OG_Get_Attr (application)

  Exemples	  Rubriques connexes

Description

Syntaxe

PROCEDURE OG_Get_Attr
  (attr  IN OUT  OG_App_Attr);

Paramètres

attr	Enregistrement devant recevoir des attributs de l'application.

Notes d'utilisation  Cette procédure recherche les valeurs d'attribut de l'exécutable Graphics Builder en cours d'exécution.

Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs masque, dans l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (application) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne le nombre d'unités de résolution d'écran
**(c'est-à-dire le nombre de pixels) de l'unité d'affichage en cours :
*/

FUNCTION example RETURN NUMBER IS
  rec  OG_App_Attr;
BEGIN
  rec.mask := OG_Screen_Res_Appa;
  OG_Get_Attr(Rec);
  RETURN(rec.hscreen_res);
END;


OG_Get_Attr (axe)

  Exemples	  Rubriques connexes

Description  Cette procédure recherche les valeurs des attributs de l'axe indiqué.

Syntaxe

PROCEDURE OG_Get_Attr                        générique
  (ident_axe  IN      OG_Axis,
   attr       IN OUT  OG_Axis_Attr);

PROCEDURE OG_Get_Attr                        continue
  (ident_axe  IN      OG_Axis,
   attr       IN OUT  OG_Contaxis_Ca);

PROCEDURE OG_Get_Attr                        date
  (ident_axe  IN      OG_Axis,
   attr       IN OUT  OG_Dateaxis_Ca);

PROCEDURE OG_Get_Attr                        discrète
  (ident_axe  IN      OG_Axis,
   attr       IN OUT  OG_Discaxis_Ca);

Paramètres

ident_axe	Identificateur de l'axe dont vous voulez obtenir les attributs.
attr	Enregistrement devant recevoir les attributs de l'axe.

Notes d'utilisation  Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (axe) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne le libellé personnalisé de l'axe indiqué :
*/

FUNCTION example(axis OG_Axis) RETURN CHAR IS
  rec  OG_Contaxis_Ca;
BEGIN
  rec.ca_axis.mask := OG_Custlabel_Axisa;
  rec.ca_cont.mask := OG_None_Contaxisa;
  OG_Get_Attr(Axis, rec);
  RETURN(rec.ca_axis.custlabel);
END;


OG_Get_Attr (affichage)

  Exemples	  Rubriques connexes

Description  Cette procédure extrait la valeur des attributs de l'affichage en cours.

Syntaxe

PROCEDURE OG_Get_Attr
  (attr  IN OUT  OG_Display_Attr);

Paramètres

attr	Enregistrement devant recevoir les attributs de l'affichage.

Notes d'utilisation Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (affichage) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne la largeur de l'affichage :
*/

FUNCTION example RETURN NUMBER IS
  rec  OG_Display_Attr;
BEGIN
  rec.mask := OG_Size_Displaya;
  OG_Get_Attr(Rec);
  RETURN(rec.width);
END;


OG_Get_Attr (modèle de champ)

  Exemples	  Rubriques connexes

Description  Cette procédure extrait les valeurs d'attribut du modèle de champ indiqué.

Syntaxe

PROCEDURE OG_Get_Attr                        générique
  (ident_modC  IN      OG_Ftemp,
   attr       IN OUT  OG_Ftemp_Attr);

PROCEDURE OG_Get_Attr                        axe
  (ident_modC  IN      OG_Ftemp,
   attr       IN OUT  OG_Axisftemp_Ca);

Paramètres

ident_modC	Identificateur du modèle de champ dont vous voulez extraire les attributs.
attr	Enregistrement devant recevoir les attributs du modèle de champ.

Notes d'utilisation Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (modèle de champ) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne le masque de format de nombre du modèle de champ indiqué :
*/

FUNCTION example(ftemp OG_Ftemp) RETURN CHAR IS
  rec  OG_Axisftemp_Ca;
BEGIN
  rec.ca_ftemp.mask := OG_Numfmt_Ftempa;
  rec.ca_aftemp.mask := OG_None_Axisftempa;
  OG_Get_Attr(Ftemp, rec);
  RETURN(rec.ca_ftemp.numfmt);
END;


OG_Get_Attr (modèle d'encadrement)

  Exemples	  Rubriques connexes

Description  Cette procédure extrait les valeurs d'attribut du modèle d'encadrement indiqué.

Syntaxe

PROCEDURE OG_Get_Attr                        encadrement générique
  (ident_modèle  IN      OG_Template,
   attr          IN OUT  OG_Frame_Attr);

PROCEDURE OG_Get_Attr                        encadrement d'axe
  (ident_modèle  IN      OG_Template,
   attr          IN OUT  OG_Axisframe_Ca);

PROCEDURE OG_Get_Attr                        encadrement de secteur
  (ident_modèle  IN      OG_Template,
   attr          IN OUT  OG_Pieframe_Ca);

PROCEDURE OG_Get_Attr                        encadrement de table
  (ident_modèle  IN      OG_Template,
   attr          IN OUT  OG_Tableframe_Ca);

Paramètres

ident_modèle	Identificateur du modèle de graphique dont vous voulez rechercher les attributs d'encadrement.
attr	Enregistrement devant recevoir les attributs du modèle d'encadrement.

Notes d'utilisation Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (modèle d'encadrement) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne la valeur de la profondeur de l'encadrement du modèle indiqué :
*/

FUNCTION example(temp OG_Template) RETURN NUMBER IS
  rec  OG_Axisframe_Ca;
BEGIN
  rec.ca_frame.mask := OG_Depthsize_Framea;
  rec.ca_axis.mask := OG_None_Framea;
  OG_Get_Attr(Temp, rec);
  RETURN(rec.ca_frame.depthsize);
END;


OG_Get_Attr (objet)

  Exemples	  Rubriques connexes

Description  Cette procédure extrait les valeurs d'attribut de l'objet indiqué.

Syntaxe

PROCEDURE OG_Get_Attr                        arc
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Arc_Ca);

PROCEDURE OG_Get_Attr                        graphique
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Chart_Ca);

PROCEDURE OG_Get_Attr                        générique
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Generic_Attr);

PROCEDURE OG_Get_Attr                        graphique
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Graphic_Ca);

PROCEDURE OG_Get_Attr                        groupe
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Group_Ca);

PROCEDURE OG_Get_Attr                        image
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Image_Ca);

PROCEDURE OG_Get_Attr                        ligne
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Line_Ca);

PROCEDURE OG_Get_Attr                        polygone/ligne polygonale
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Poly_Ca);

PROCEDURE OG_Get_Attr                        rectangle
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Rect_Ca);

PROCEDURE OG_Get_Attr                        rectangle arrondi
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Rrect_Ca);

PROCEDURE OG_Get_Attr                        symbole
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Symbol_Ca);

PROCEDURE OG_Get_Attr                        texte/champ texte
  (ident_objet  IN      OG_Object,
   attr         IN OUT  OG_Text_Ca);

Paramètres

ident_objetl	Identificateur de l'objet dont vous voulez extraire les attributs.
attr	Enregistrement devant recevoir les attributs de l'objet.

Notes d'utilisation Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (objet) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* L'utilisateur sélectionne un objet dont la couleur détermine les informations que
**l'utilisateur souhaite visualiser. La fonction ci-dessous utilise un objet comme
**argument et retourne le nom de sa couleur de remplissage de premier plan. La couleur peut
**alors être déterminée et les informations appropriées affichées.
*/

FUNCTION get_color(the_object IN OG_Object) RETURN VARCHAR2
IS
   obj_record   OG_Graphic_Ca;
BEGIN
   obj_record.graphic_caoh.mask:=OG_Ffcolor_Graphica;
   obj_record.generic_caob.mask:=OG_None_Generica;
   OG_Get_Attr(The_Object, obj_record);
   RETURN(obj_record.graphic_caoh.ffcolor);
END;


OG_Get_Attr (imprimante)

  Exemples	  Rubriques connexes

Description  Cette procédure extrait les valeurs d'attribut de l'imprimante en cours..

Syntaxe

PROCEDURE OG_Get_Attr
  (attr  IN OUT  OG_Printer_Attr);

Paramètres

attr	Enregistrement devant recevoir les attributs de l'imprimante.

Notes d'utilisation  Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (imprimante) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne le nom de l'imprimante utilisée :
*/

FUNCTION example RETURN CHAR IS
  rec  OG_Printer_Attr;
BEGIN
  rec.mask := OG_Name_Printera;
  OG_Get_Attr(Rec);
  RETURN(rec.name);
END;


OG_Get_Attr (interrogation)

  Exemples	  Rubriques connexes

Description  Cette procédure extrait les valeurs d'attribut de l'interrogation indiquée.

Syntaxe

PROCEDURE OG_Get_Attr
  (ident_interro  IN      OG_Query,
   attr       IN OUT  OG_Query_Attr);

Paramètres

ident_interro	Identificateur de l'interrogation dont vous voulez extraire les attributs.
attr	Enregistrement devant recevoir les attributs de l'interrogation.

Notes d'utilisation  Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (interrogation) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne l'instruction SQL qui définit l'interrogation indiquée :
*/

FUNCTION example(query OG_Query) RETURN CHAR IS
  rec  OG_Query_Attr;
BEGIN
  rec.mask := OG_Querysource_Querya;
  OG_Get_Attr(Query, rec);
  RETURN(rec.querysource);
END;


OG_Get_Attr (ligne de référence)

  Exemples	  Rubriques connexes

Description  Cette procédure extrait les valeurs d'attribut de la ligne de référence indiquée.

Syntaxe

PROCEDURE OG_Get_Attr
  (ident_ligne_réf  IN      OG_Refline,
   attr             IN OUT  OG_Refline_Attr);

Paramètres

ident_ligne_réf	Identificateur de la ligne de référence dont vous voulez extraire les attributs.
attr	Enregistrement devant recevoir les attributs de la ligne de référence.

Notes d'utilisation  Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (ligne de référence) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne le libellé de la ligne de référence indiquée.
*/

FUNCTION example(refline OG_Refline) RETURN CHAR IS
  rec  OG_Refline_Attr;
BEGIN
  rec.mask := OG_Label_Reflinea;
  OG_Get_Attr(Refline, rec);
  RETURN(rec.label);
END;


OG_Get_Attr (son)

  Exemples	  Rubriques connexes

Description  Cette procédure extrait les valeurs d'attribut du son indiqué.

Syntaxe

PROCEDURE OG_Get_Attr
  (ident_son  IN      OG_Sound,
   attr       IN OUT  OG_Sound_Attr);

Paramètres

ident_son	Identificateur du son dont vous voulez extraire les attributs.
attr	Enregistrement devant recevoir les attributs du son.

Notes d'utilisation  Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (son) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne le nom du son indiqué :
*/

FUNCTION example(sound OG_Sound) RETURN CHAR IS
  rec  OG_Sound_Attr;
BEGIN
  rec.mask := OG_Name_Sounda;
  OG_Get_Attr(Sound, rec);
  RETURN(rec.name);
END;


OG_Get_Attr (horloge)

  Exemples	  Rubriques connexes

Description  Cette procédure extrait les valeurs d'attribut de l'horloge indiquée.

Syntaxe

PROCEDURE OG_Get_Attr
  (ident_horloge  IN      OG_Timer,
   attr           IN OUT  OG_Timer_Attr);

Paramètres

ident_horloge	Identificateur de l'horloge dont vous voulez extraire les attributs.
attr	Enregistrement devant recevoir les attributs de l'horloge.

Notes d'utilisation  Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (horloge) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne le nom de la procédure attribuée à l'horloge indiquée.
*/

FUNCTION example(timer OG_Timer) RETURN CHAR IS
  rec  OG_Timer_Attr;
BEGIN
  rec.mask := OG_Timerproc_Timera;
  OG_Get_Attr(Timer, rec);
  RETURN(rec.timerproc);
END;


OG_Get_Attr (fenêtre)

  Exemples	  Rubriques connexes

Description Cette procédure extrait les valeurs d'attribut de la fenêtre indiquée.

Syntaxe

PROCEDURE OG_Get_Attr
  (ident_fenêtre  IN      OG_Window,
   attr        IN OUT  OG_Window_Attr);

Paramètres

ident_fenêtre	Identificateur de la fenêtre dont vous voulez extraire les attributs.
attr	Enregistrement devant recevoir les attributs de la fenêtre.

Notes d'utilisation  Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Get_Attr (fenêtre) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne la position de la fenêtre indiquée :
*/

FUNCTION example(window OG_Window) RETURN OG_Point IS
  rec  OG_Window_Attr;
BEGIN
  rec.mask := OG_Position_Windowa;
  OG_Get_Attr(Window, rec);
  RETURN(rec.position);
END;


OG_Get_Buttonproc

  Exemples	  Rubriques connexes

Description  La procédure bouton doit déjà être définie et ne pas exister dans un package PL/SQL.

Syntaxe

FUNCTION OG_Get_Buttonproc
  (nom_proc  VARCHAR2)
RETURN OG_Buttonproc;

Paramètres

nom_proc	Nom de la procédure PL/SQL dont l'identificateur doit être retourné.

Retourne  Un identificateur de la procédure bouton indiquée. Si cette procédure n'existe pas, la fonction retourne un identificateur NULL.


OG_Get_Buttonproc - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit une procédure bouton, appelée `afficher_données_ventes', à
** attribuer à un objet ; lorsque l'utilisateur
** sélectionne l'objet, la procédure s'exécute.
*/

PROCEDURE make_object_button(my_obj IN OG_Object) IS
   obj_rec         OG_Generic_Attr;
   my_buttonproc   OG_Buttonproc;
BEGIN
   my_buttonproc:=OG_Get_Buttonproc('Afficher_Données_Ventes');
   obj_rec.mask:=OG_Button_Generica;
   obj_rec.button:=my_buttonproc;
   obj_rec.events:=OG_Mouse_Down;
   OG_Set_Attr(My_Obj, obj_rec);
END;


OG_Help

  Exemples	  Rubriques connexes

Description  Cette procédure appelle le système d'aide et affiche le document d'aide runtime sur la cible hypertexte indiquée.

Syntaxe

PROCEDURE OG_Help
  (cible  VARCHAR2);

Paramètres

cible	Cible hypertexte dans le document d'aide runtime affiché.


OG_Help - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Un utilisateur doit pouvoir sélectionner un bouton et appeler
** le système d'aide. Ecrire pour cela la procédure bouton suivante :
*/

PROCEDURE get_help (buttonobj IN OG_Object, hitobj IN
OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
BEGIN
   IF eventinfo.event_type=OG_Mouse_Up THEN
      OG_Help('Rubrique_1');
   END IF;
END;


OG_Host

  Exemples	  Rubriques connexes

Description  Cette procédure transmet la commande indiquée au système d'exploitation.

Syntaxe

PROCEDURE OG_Host
  (commande  VARCHAR2);

Paramètres

commande	Chaîne de texte contenant la commande à exécuter.


OG_Host - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour être informé par messagerie électronique de la fermeture de l'affichage par un
** utilisateur, créer un script appelé `ma_messagerie' dans le système de fichiers qui
** envoie les messages, puis appeler le script en utilisant le déclencheur de fermeture d'affichage suivant :
*/

PROCEDURE send_me_mail IS
BEGIN
   OG_Host('Ma_messagerie');
END;


OG_Pause

  Exemples	  Rubriques connexes

Description  Cette procédure suspend l'exécution de l'affichage pendant le nombre de secondes indiqué.

Syntaxe

PROCEDURE OG_Pause
  (secs  NUMBER);

Paramètres

secs	Indique en secondes la durée de l'interruption.


OG_Pause - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous suspend l'exécution de l'affichage pendant sept secondes :
*/

PROCEDURE example IS
BEGIN
  OG_Pause(7);
END;


OG_Print

  Exemples	  Rubriques connexes

Description  Cette procédure imprime le contenu de la présentation sur l'unité d'impression sélectionnée.

Syntaxe

PROCEDURE OG_Print;

PROCEDURE OG_Print
  (ident_fenêtre  OG_Window);

Paramètres

ident_fenêtre	Identificateur de la fenêtre à imprimer.

Notes d'utilisation  Si un identificateur de fenêtre est indiqué, seules les couches affichées dans cette fenêtre sont imprimées ; sinon, toutes les couches de l'affichage sont imprimées, quelle que soit la fenêtre dans laquelle elles se trouvent, qu'elles soient affichées ou masquées.


OG_Print - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour imprimer le contenu de la fenêtre de présentation principale :
*/

PROCEDURE print_main_window IS
   the_window   OG_Window;
BEGIN
   the_window:=OG_Get_Window('Présentation principale');
   OG_Print(The_Window);
END;


OG_Quit

  Exemples	  Rubriques connexes

Description  Cette procédure quitte la session Graphics Builder en cours.

Syntaxe

PROCEDURE OG_Quit;

Paramètres

Aucun.


OG_Quit - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour que l'utilisateur puisse, en sélectionnant un bouton,
**valider les modifications apportées à la base de données et quitter
** Graphics Builder, écrire la procédure bouton suivante :
*/

PROCEDURE commit_and_quit (hitobj IN OG_Object, buttonobj
  IN OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
BEGIN
   COMMIT;
   OG_Quit;
END;


OG_Root_Object

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un identificateur de l'objet racine de l'affichage.

Syntaxe

FUNCTION OG_Root_Object
RETURN OG_Object;

Paramètres:

Aucun.

Retourne  Un identificateur de l'objet racine de l'affichage.

Notes d'utilisation  L'objet racine est l'objet qui se trouve en haut de l'affichage. Ses fils immédiats sont les couches de l'affichage.


OG_Root_Object - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous fait passer la couche supérieure de l'affichage au bas de la liste des couches.
*/

PROCEDURE example IS
  root   OG_Object;
  layer  OG_Object;
BEGIN
  root := OG_Root_Object;
  layer := OG_Get_Child(Root, 0);
  OG_Insert_Child(Root, layer, OG_Last);
END;


OG_Set_Attr (application)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les attributs de l'exécutable Graphics Builder en cours d'exécution.

Syntaxe

PROCEDURE OG_Set_Attr
  (attr  OG_App_Attr);

Paramètres

attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (application) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit le curseur à 'occupé':
*/

PROCEDURE example IS
  attr  OG_App_Attr;
BEGIN
  attr.cursor := 'occupé';
  attr.mask := OG_Cursor_Appa;
  OG_Set_Attr(Attr);
END;


OG_Set_Attr (axe)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les valeurs d'attribut de l'axe indiqué.

Syntaxe

PROCEDURE OG_Set_Attr                        générique
  (ident_axe  OG_Axis,
   attr       OG_Axis_Attr);

PROCEDURE OG_Set_Attr                        continue
  (ident_axe  OG_Axis,
   attr       OG_Contaxis_Ca);

PROCEDURE OG_Set_Attr                        date
  (ident_axe  OG_Axis,
   attr       OG_Dateaxis_Ca);

PROCEDURE OG_Set_Attr                        discrète
  (ident_axe  OG_Axis,
   attr       OG_Discaxis_Ca);

Paramètres

ident_axe	Identificateur de l'axe dont vous voulez définir les attributs.
attr	Enregistrement contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (axe) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit le libellé personnalisé de l'axe indiqué :
*/

PROCEDURE example(axis OG_Axis, label VARCHAR2) IS
  rec  OG_Contaxis_Ca;
BEGIN
  rec.ca_axis.custlabel := 'Nouveau libellé';
  rec.ca_axis.mask := OG_Custlabel_Axisa;
  rec.ca_cont.mask := OG_None_Contaxisa;
  OG_Set_Attr(Axis, rec);
END;


OG_Set_Attr (élément graphique)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les attributs d'un élément graphique (barre ou secteur, par exemple).

Syntaxe

PROCEDURE OG_Set_Attr
  (ident_graph  OG_Object,
   num_ligne    NUMBER,
   nom_col   VARCHAR2,
   attr       OG_Chelement_Ca);

Paramètres

ident_graph	Identificateur du graphique contenant la valeur de données dont vous voulez définir les attributs.
num_ligne	Numéro de ligne de la valeur de données dont vous voulez définir les attributs.
nom_col	Nom de la colonne de la valeur de données dont vous voulez définir les attributs.
attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Vous devez indiquer le graphique, la ligne et la colonne de la valeur de données correspondante, ainsi qu'un enregistrement d'attributs de définition de graphique. L'enregistrement d'attributs contient des attributs graphiques et d'autres attributs qui seront appliqués à l'élément graphique représentant la valeur de données indiquée. Par exemple, vous pouvez définir la couleur d'une barre d'un graphique "à barres", en indiquant un enregistrement d'attributs pour la valeur de données correspondant à cette barre.

Notez que les modifications que vous apportez à un élément graphique ne seront appliquées que lorsque le graphique sera mis à jour par un appel à OG_Update_Chart.

Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (élément graphique) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous boucle sur toutes les lignes de l'interrogation d'un graphique,
** puis définit la couleur de chaque barre du graphique en fonction de sa valeur :
*/

PROCEDURE OGTRIGGERPROC0 IS
chart og_object;
query og_query;
rec og_chelement_ca;
total number;
bar_val number;

BEGIN
  chart := og_get_object ('Employés');
  query:= og_get_query ('interrogation0');
  og_execute_query (query);
  og_start_from(query, OG_NEWDATA);
  total := og_numrows (query, OG_NEWDATA);
for i in 0..total-1 loop
  bar_val:=og_get_numcell (query, OG_NEWDATA,'SAL');
   IF bar_val>2000 THEN^M
   rec.chelement_cagr.mask :=OG_BFCOLOR_GRAPHICA;
   rec.chelement_cace.mask :=OG_NONE_CHELEMENTA;
   rec.chelement_cagr.bfcolor := 'cyan';
og_set_attr (chart, i, 'SAL', rec);
   END; IF;
  og_next_row(query, OG_NEWDATA);
 END LOOP;
 og_update_chart (chart, OG_ALL_CHUPDA);
END;


OG_Set_Attr (affichage)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les attributs de l'affichage en cours.

Syntaxe

PROCEDURE OG_Set_Attr
  (attr  OG_Display_Attr);

Paramètres

attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (affichage) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit la largeur de l'affichage :
*/

PROCEDURE example IS
  rec  OG_Display_Attr;
BEGIN
  rec.width := 4 * OG_Inch;
  rec.height := 5 * OG_Inch;
  rec.mask := OG_Size_Displaya;
  OG_Set_Attr(Rec);
END;


OG_Set_Attr (modèle de champ)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les valeurs d'attribut du modèle de champ indiqué.

Syntaxe

PROCEDURE OG_Set_Attr                        générique
  (ident_modC  OG_Ftemp,
   attr        OG_Ftemp_Attr);

PROCEDURE OG_Set_Attr                        axe
  (ident_modC  OG_Ftemp,
   attr        OG_Axisftemp_Ca);

Paramètres

ident_modC	Identificateur du modèle de champ dont vous voulez définir les attributs.
attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (modèle de champ) - Exemples

  Liste alphabétique           [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit le masque de format de nombre du modèle de champ indiqué :
*/

PROCEDURE example(ftemp OG_Ftemp) IS
  rec  OG_Axisftemp_Ca;
BEGIN
  rec.ca_ftemp.numfmt := '9,990';
  rec.ca_ftemp.mask := OG_Numfmt_Ftempa;
  rec.ca_aftemp.mask := OG_None_Axisftempa;
  OG_Set_Attr(Ftemp, rec);
END;


OG_Set_Attr (modèle d'encadrement)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les valeurs d'attribut du modèle d'encadrement indiqué.

Syntaxe

PROCEDURE OG_Set_Attr                        générique d'encadrement
  (ident_modèle  OG_Template,
   attr          OG_Frame_Attr);

PROCEDURE OG_Set_Attr                        encadrement d'axe
  (ident_modèle  OG_Template,
   attr          OG_Axisframe_Ca);

PROCEDURE OG_Set_Attr                        encadrement de secteur
  (ident_modèle  OG_Template,
   attr          OG_Pieframe_Ca);

PROCEDURE OG_Set_Attr                        encadrement de table
  (ident_modèle  OG_Template,
   attr          OG_Tableframe_Ca);

Paramètres

ident_modèle	Identificateur du modèle de graphique dont vous voulez définir les attributs d'encadrement.
attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (modèle d'encadrement) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit la valeur de la profondeur de l'encadrement de modèle indiqué :
*/

PROCEDURE example(temp OG_Template) IS
  rec  OG_Axisframe_Ca;
BEGIN
  rec.ca_frame.depthsize := OG_Large_Depthsize;
  rec.ca_frame.mask := OG_Depthsize_Framea;
  rec.ca_axis.mask := OG_None_Framea;
  OG_Set_Attr(Temp, rec);
END;


OG_Set_Attr (objet)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les attributs de l'objet indiqué.

Syntaxe

PROCEDURE OG_Set_Attr                        arc
  (ident_objet   OG_Object,
   attr          OG_Arc_Ca,
   dommage       BOOLEAN          :=  TRUE,
   boîte_maj     BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        graphique
  (ident_objet   OG_Object,
   attr          OG_Chart_Ca,
   dommage       BOOLEAN          :=  TRUE,
   update_bbox   BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        générique
  (ident_objet   OG_Object,
   attr          OG_Generic_Attr,
   dommage       BOOLEAN          :=  TRUE,
   boîte_maj     BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        graphique
  (ident_objet   OG_Object,
   attr          OG_Graphic_Ca,
   damage        BOOLEAN          :=  TRUE,
   update_bbox   BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        groupe
  (object_hdl    OG_Object,
   attr          OG_Group_Ca,
   damage        BOOLEAN          :=  TRUE,
   update_bbox   BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        image
  (ident_objet   OG_Object,
   attr          OG_Image_Ca,
   dommage       BOOLEAN          :=  TRUE,
   boîte_maj     BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        ligne
  (ident_objet   OG_Object,
   attr          OG_Line_Ca,
   dommage       BOOLEAN          :=  TRUE,
   boîte_maj     BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        polygone/ligne polygonale
  (ident_objet   OG_Object,
   attr          OG_Poly_Ca,
   dommage       BOOLEAN          :=  TRUE,
   boîte_maj     BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        rectangle
  (ident_objet   OG_Object,
   attr          OG_Rect_Ca,
   dommage       BOOLEAN          :=  TRUE,
   boîte_maj     BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        rectangle arrondi
  (ident_objet   OG_Object,
   attr          OG_Rrect_Ca,
   dommage       BOOLEAN          :=  TRUE,
   boîte_maj     BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        symbole
  (ident_objet   OG_Object,
   attr          OG_Symbol_Ca,
   dommage       BOOLEAN          :=  TRUE,
   boîte_maj     BOOLEAN          :=  TRUE);

PROCEDURE OG_Set_Attr                        texte/champ de texte
  (ident_objet   OG_Object,
   attr          OG_Text_Ca,
   dommage       BOOLEAN          :=  TRUE,
   boîte_maj     BOOLEAN          :=  TRUE);

Paramètres

ident_objet	Identificateur de l'objet dont vous voulez définir les attributs.
attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.
dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (objet) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit une carte du monde sur laquelle la couleur de l'un des pays doit être
** changée. Extraire d'abord l'identificateur de l'objet du pays, puis
** modifier sa couleur.
*/

PROCEDURE color_country (country_name) IS
   my_object    OG_Object;
   obj_record   OG_Graphic_Ca;
BEGIN
   my_object:=OG_Get_Object(Country_Name);
   obj_record.graphic_caob.mask:=OG_None_Generica;
   obj_record.graphic_caoh.mask:=OG_Ffcolor_Graphica;
   obj_record.graphic_caoh.ffcolor:='rouge';
   OG_Set_Attr(My_Object, obj_record);
END;


OG_Set_Attr (imprimante)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les valeurs d'attribut de l'imprimante en cours.

Syntaxe

PROCEDURE OG_Set_Attr
  (attr  OG_Printer_Attr);

Paramètres

attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (imprimante) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit le nombre d'exemplaires à imprimer :
*/

PROCEDURE example IS
  rec  OG_Printer_Attr;
BEGIN
  rec.copies := 2;
  rec.mask := OG_Copies_Printera;
  OG_Set_Attr(Rec);
END;


OG_Set_Attr (interrogation)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les attributs de l'interrogation indiquée.

Syntaxe

PROCEDURE OG_Set_Attr
  (ident_interro  OG_Query,
   attr       OG_Query_Attr);

Paramètres

ident_interro	Identificateur de l'interrogation dont vous voulez définir les attributs.
attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (interrogation) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit l'instruction SQL pour l'interrogation indiquée :
*/

PROCEDURE example(query OG_Query) IS
  rec  OG_Query_Attr;
BEGIN
  rec.querysource := 'select ename, sal from emp';
  rec.mask := OG_Querysource_Querya;
  OG_Set_Attr(Query, rec);
END;


OG_Set_Attr (ligne de référence)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les attributs de la ligne de référence indiquée.

Syntaxe

PROCEDURE OG_Set_Attr
  (ident_ligne_réf  OG_Refline,
   attr             OG_Refline_Attr);

Paramètres

ident_ligne_réf	Identificateur de la ligne de référence dont vous voulez définir les attributs.
attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (ligne de référence) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit le libellé de la ligne de référence indiquée :
*/

PROCEDURE example(refline OG_Refline) IS
  rec  OG_Refline_Attr;
BEGIN
  rec.label := 'Moyenne';
  rec.mask := OG_Label_Reflinea;
  OG_Set_Attr(Refline, rec);
END;


OG_Set_Attr (son)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les attributs du son indiqué.

Syntaxe

PROCEDURE OG_Set_Attr
  (ident_son  OG_Sound,
   attr       OG_Sound_Attr);

Paramètres

ident_son	Identificateur du son dont vous voulez définir les attributs.
attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (son) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit le nom du son indiqué :
*/

PROCEDURE example(sound OG_Sound) IS
  rec  OG_Sound_Attr;
BEGIN
  rec.name := 'Alerte';
  rec.mask := OG_Name_Sounda;
  OG_Set_Attr(Sound, rec);
END;


OG_Set_Attr (horloge)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les attributs de l'horloge indiquée.

Syntaxe

PROCEDURE OG_Set_Attr
  (ident_horloge  OG_Timer,
   attr       OG_Timer_Attr);

Paramètres

ident_horloge	Identificateur de l'horloge dont vous voulez définir les attributs.
attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (horloge) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit le nom de procédure attribué à l'horloge indiquée :
*/

PROCEDURE example(timer OG_Timer) IS
  rec  OG_Timer_Attr;
BEGIN
  rec.timerproc := 'proc_maj';
  rec.mask := OG_Timerproc_Timera;
  OG_Set_Attr(Timer, rec);
END;


OG_Set_Attr (fenêtre)

  Exemples	  Rubriques connexes

Description  Cette procédure définit les attributs de la fenêtre indiquée.

Syntaxe

PROCEDURE OG_Set_Attr
  (ident_fenêtre  OG_Window,
   attr        OG_Window_Attr);

Paramètres

ident_fenêtre	Identificateur de la fenêtre dont vous voulez définir les attributs.
attr	Enregistrement d'attributs contenant les nouvelles valeurs d'attribut.

Notes d'utilisation  Les seules valeurs d'attribut qui seront définies sont celles indiquées par la valeur de l'attribut ou des attributs de masque de l'enregistrement d'attributs. Les champs de cet enregistrement, pour lequel le masque n'est pas défini, ne seront pas modifiés par l'appel à cette procédure.


OG_Set_Attr (fenêtre) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit la taille de la fenêtre indiquée :
*/

PROCEDURE example(window OG_Window) IS
  rec  OG_Window_Attr;
BEGIN
  rec.width := 4 * OG_Get_Ap_Hscreen_Res;
  rec.height := 5 * OG_Get_Ap_Vscreen_Res;
  rec.mask := OG_Size_Windowa;
  OG_Set_Attr(Window, rec);
END;


OG_Translate_Envvar

  Exemples	  Rubriques connexes

Description  Cette fonction retourne la valeur de la variable d'environnement indiquée.

Syntaxe

FUNCTION OG_Translate_Envvar
  (var_env  VARCHAR2)
RETURN VARCHAR2;

Paramètres

var_env	Variable d'environnement à traduire.

Retourne  Une chaîne de caractères contenant la valeur de la variable d'environnement.

Notes d'utilisation  Le traitement (et même l'existence) des variables d'environnement est propre au système considéré. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

Lorsqu'il recherche la variable d'environnement, Graphics Builder commence par se référer à votre système d'exploitation pour savoir si elle est définie. Si elle ne l'est pas, il la recherche dans votre fichier de préférences.


OG_Translate_Envvar - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un système comportant une variable d'environnement, appelée
** REP_IMAGE, qui indique le chemin d'accès au répertoire du fichier image
** 'Mon_image'. La procédure qui importe cette image est la suivante :
*/

PROCEDURE import_my_image IS
   the_image   OG_Object;
   file_path   VARCHAR2(50);
BEGIN
   file_path:=OG_Translate_Envvar('Rep_image');
   file_path:=OG_Append_File(File_Path, 'mon_image');
   the_image:=OG_Import_Image(File_Path, OG_Filesystem,
     OG_Tiff_Iformat);
END;


OG_User_Exit

  Exemples	  Rubriques connexes

Description  Cette procédure exécute un exécutable défini par l'utilisateur.

Syntaxe

PROCEDURE OG_User_Exit
  (commande  VARCHAR2);

Paramètres

commande	Nom du user exit, avec les arguments que vous voulez lui transmettre.


OG_User_Exit - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un affichage contrôlant le fonctionnement des composants matériels
** connectés à un système. Lorsque l'utilisateur sélectionne un bouton, il doit être
** possible d'appeler la routine du contrôleur matériel, liée sous la forme d'un user exit.
** En outre, il peut être souhaitable de transmettre un argument à ce
** user exit. La procédure ci-dessous appelle le user exit
** `ctrl_mat' avec le paramètre `signal':
*/

PROCEDURE control_hw(buttonobj IN OG_Object, hitobj IN OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
BEGIN
   OG_User_Exit('Ctrl_mat' || :signal);
END;


Aucun sous-programme intégré ne commence par cette lettre.


Procédures internes de paramètres

OG_Delete_Param

OG_Get_Char_Param

OG_Get_Date_Param

OG_Get_Num_Param

OG_Get_Param_Type

OG_Param_Exists

OG_Set_Param


OG_Delete_Param

  Exemples	  Rubriques connexes

Description  Cette procédure supprime le paramètre indiqué.

Syntaxe

PROCEDURE OG_Delete_Param
  (nom_param  VARCHAR2);

Paramètres

nom_param	Nom du paramètre à supprimer.


OG_Delete_Param - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous supprime le paramètre 'param0'.
*/

PROCEDURE example IS
BEGIN
  OG_Delete_Parameter('Param0');
END;


OG_Get_Char_Param

  Exemples	  Rubriques connexes

Description  Cette fonction extrait la valeur du paramètre CHAR indiqué. Elle équivaut à utiliser une référence de lien au paramètre.

Syntaxe

FUNCTION OG_Get_Char_Param
  (nom_param  VARCHAR2)
RETURN VARCHAR2;

Paramètres

nom_param	Nom du paramètre dont vous voulez extraire la valeur.

Retourne  La valeur du paramètre indiqué.

Notes d'utilisation  Cette fonction permet de faire référence au paramètre contenu dans une unité de programme stockée dans une bibliothèque. Les références de lien ne sont pas compilées dans le contexte d'une bibliothèque, mais cette fonction le permet.


OG_Get_Char_Param - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous extrait la valeur du paramètre 'Etat'
**et modifie la couleur de l'objet indiqué en fonction de sa valeur.
*/

PROCEDURE example(object OG_Object) IS
  stat  VARCHAR2(10);
BEGIN
  stat := OG_Get_Char_Param('Etat');
  IF stat = 'obsolète' THEN
    OG_Set_Fillcolor(Object, 'rouge');
  END IF;
END;


OG_Get_Date_Param

  Exemples	  Rubriques connexes

Description  Cette fonction extrait la valeur du paramètre DATE indiqué. Elle équivaut à utiliser une référence de lien au paramètre.

Syntaxe

FUNCTION OG_Get_Date_Param
  (nom_param  VARCHAR2,
   fmt         VARCHAR2)
RETURN DATE;

Paramètres

nom_param	Nom du paramètre dont vous voulez extraire la valeur.

Retourne  La valeur du paramètre indiqué.

Notes d'utilisation  Cette fonction permet de faire référence au paramètre contenu dans une unité de programme stockée dans une bibliothèque. Les références de lien ne sont pas compilées dans le contexte d'une bibliothèque, mais cette fonction le permet.


OG_Get_Date_Param - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous extrait la valeur du paramètre 'date_échéance'
**et modifie la couleur de l'objet indiqué en fonction de sa valeur :
*/

PROCEDURE example(object OG_Object) IS
  due  DATE;
BEGIN
  due := OG_Get_Date_Param('Date_échéance');
  IF due < sysdate THEN
    OG_Set_Fillcolor(Object, 'rouge');
  END IF;
END;


OG_Get_Num_Param

  Exemples	  Rubriques connexes

Description  Cette fonction extrait la valeur du paramètre NUMBER indiqué. Elle équivaut à utiliser une référence de lien au paramètre.

Syntaxe

FUNCTION OG_Get_Num_Param
  (nom_param  VARCHAR2)
RETURN NUMBER;

Paramètres

nom_param	Nom du paramètre dont vous voulez extraire la valeur.

Retourne  La valeur du paramètre indiqué.

Notes d'utilisation Cette fonction permet de faire référence au paramètre contenu dans une unité de programme stockée dans une bibliothèque. Les références de lien ne sont pas compilées dans le contexte d'une bibliothèque, mais cette fonction le permet.


OG_Get_Num_Param - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous extrait la valeur du paramètre 'priorité' et l'augmente de 1 :
*/

PROCEDURE example IS
  val  NUMBER;
BEGIN
  val := OG_Get_Num_Param('Priorité');
  OG_Set_Param('Priorité', val + 1);
END;


OG_Get_Param_Type

  Exemples	  Rubriques connexes

Description  Cette fonction retourne le type de données d'un paramètre.

Syntaxe

FUNCTION OG_Get_Param_Type
  (nom_param  VARCHAR2)
RETURN NUMBER;

Paramètres

nom_param	Nom du paramètre.

Retourne  Cette fonction retourne l'une des constantes intégrées suivantes :

•	OG_Char_Paramtype

•	OG_Date_Paramtype

•	OG_Num_Paramtype


OG_Get_Param_Type - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous extrait le type de données du paramètre 'param0',
**puis l'augmente d'une unité s'il est de type NUMBER :
*/

PROCEDURE example IS
  dtype  NUMBER;
BEGIN
  dtype := OG_Get_Param_Type('Param0');
  IF dtype = OG_Num_Paramtype THEN
    :param0 := :param0 + 1;
  END IF;
END;


OG_Param_Exists

  Exemples	  Rubriques connexes

Description  Cette fonction détermine si un paramètre a été créé.

Syntaxe

FUNCTION OG_Param_Exists
  (nom_param  VARCHAR2)
RETURN BOOLEAN;

Paramètres

nom_param	Nom du paramètre.
Retourne TRUE	Si le paramètre existe.
FALSE	Si le paramètre n'existe pas.


OG_Param_Exists - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous attribue un comportement de descente de niveau à un graphique,
**mais commence par s'assurer que le paramètre qu'il définit existe (et le crée s'il n'existe pas) :
*/

PROCEDURE example(chart OG_Object, param_name VARCHAR2) IS
  chelement_group  OG_Object;
BEGIN
  IF NOT OG_Param_Exists(Param_Name) THEN
    OG_Set_Param(Param_Name, 10);
  END IF;

  chelement_group := OG_Get_Object('Barres_sal', chart);
  OG_Set_Setparam(Chelement_Group, param_name);
  OG_Set_Keycol(Chelement_Group, 'DEPTNO');
END;


OG_Set_Param

  Exemples	  Rubriques connexes

Description  Cette procédure définit la valeur du paramètre indiqué. Si le paramètre n'existe pas, il est créé.

Syntaxe

PROCEDURE OG_Set_Param                       date
  (nom_param    VARCHAR2,
   valeur_param   DATE,
   format_param  VARCHAR2  :=  'DD-MON-YY');

PROCEDURE OG_Set_Param                       number
  (nom_param   VARCHAR2,
   valeur_param  NUMBER);

PROCEDURE OG_Set_Param                       char
  (nom_param   VARCHAR2,
   valeur_param  VARCHAR2);

Paramètres

nom_param	Nom du paramètre dont vous voulez définir la valeur.
valeur_param	Valeur à laquelle le paramètre sera défini.
format_param	Masque de format utilisé pour interpréter valeur_param pour les paramètres de date.

Notes d'utilisation Cette fonction permet de faire référence au paramètre contenu dans une unité de programme stockée dans une bibliothèque. Les références de lien ne sont pas compilées dans le contexte d'une bibliothèque, mais cette fonction le permet.


OG_Set_Param - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous extrait la valeur du paramètre
**'priorité' et l'augmente de 1 :
*/

PROCEDURE example IS
  val  NUMBER;
BEGIN
  val := OG_Get_Num_Param('Priorité');
  OG_Set_Param('Priorité', val + 1);
END;


Procédures internes d'interrogation

OG_Append_Row

OG_Clear_Query

OG_Data_Changed

OG_Data_Queried

OG_Destroy (interrogation)

OG_Execute_Query

OG_Get_Charcell

OG_Get_Datecell

OG_Get_Newrows

OG_Get_Numcell

OG_Get_Query

OG_Get_Schema

OG_Insert_Column

OG_Make_Query

OG_Next_Row

OG_Numcols

OG_Numrows

OG_Set_Charcell

OG_Set_Datecell

OG_Set_Numcell

OG_Set_Schema

OG_Start_From


OG_Append_Row

  Exemples	  Rubriques connexes

Description  Cette procédure ajoute le tampon de ligne en cours au bas d'une interrogation personnalisée.

Syntaxe

PROCEDURE OG_Append_Row
  (ident_interro  OG_Query);

Paramètres

ident_interro	Identificateur de l'interrogation à laquelle est ajouté le tampon de ligne.

Notes d'utilisation  Indiquez le contenu du tampon de ligne en utilisant OG_Set_Charcell, OG_Set_Datecell et OG_Set_Numcell.


OG_Append_Row - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour créer une interrogation personnalisée en utilisant les colonnes NOME,
**SAL et DATEMB de l'interrogation 'interro0' comme base et, dans
**l'interrogation suivante, doubler la valeur de chaque SAL, utiliser la
**procédure d'interrogation personnalisée suivante :
*/

PROCEDURE OGQUERYPROC0(query IN OG_Query) IS
  other_ename     VARCHAR2(10);
  other_sal       NUMBER(7,2);
  other_query     OG_Query;
  other_hiredate  DATE;
  row_count       NUMBER;
BEGIN
  OG_Clear_Query(Query);

  other_query := OG_Get_Query('Interro0');
  row_count := OG_Numrows(Other_Query, OG_Newdata);
  OG_Start_From(Other_Query, OG_Newdata, 0);

  FOR i IN 0..row_count loop
    other_ename := OG_Get_Charcell(Other_Query, 'NOME');
    other_sal := OG_Get_Numcell(Other_Query, 'SAL');
    other_hiredate := OG_Get_Numcell(Other_Query, 'DATEMB');
    OG_Set_Charcell(Query, 'NOME', other_ename);
    OG_Set_Numcell(Query, 'SAL', other_sal * 2);
    OG_Set_Datecell(Query, 'DATEMB', other_hiredate);
    OG_Append_Row(Query);
    OG_Next_Row(Other_Query, OG_Newdata);
  END LOOP;

END;


OG_Clear_Query

  Exemples	  Rubriques connexes

Description  Cette procédure supprime toutes les lignes de données de l'interrogation indiquée.

Syntaxe

PROCEDURE OG_Clear_Query
  (ident_interro  OG_Query);

Paramètres

ident_interro	Identificateur de l'interrogation à supprimer.


OG_Clear_Query - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Pour créer une interrogation personnalisée en utilisant les colonnes NOME,
**SAL et DATEMB de l'interrogation 'interro0' comme base et, dans
**l'interrogation suivante, doubler la valeur de chaque SAL, utiliser la
**procédure d'interrogation personnalisée suivante :
*/

PROCEDURE OGQUERYPROC0(query IN OG_Query) IS
  other_ename     VARCHAR2(10);
  other_sal       NUMBER(7,2);
  other_query     OG_Query;
  other_hiredate  DATE;
  row_count       NUMBER;
BEGIN
  OG_Clear_Query(Query);

  other_query := OG_Get_Query('Interro0');
  row_count := OG_Numrows(Other_Query, OG_Newdata);
  OG_Start_From(Other_Query, OG_Newdata, 0);

  FOR i IN 0..row_count loop
    other_ename := OG_Get_Charcell(Other_Query, 'NOME');
    other_sal := OG_Get_Numcell(Other_Query, 'SAL');
    other_hiredate := OG_Get_Numcell(Other_Query, 'DATEMB');
    OG_Set_Charcell(Query, 'NOME', other_ename);
    OG_Set_Numcell(Query, 'SAL', other_sal * 2);
    OG_Set_Datecell(Query, 'DATEMB', other_hiredate);
    OG_Append_Row(Query);
    OG_Next_Row(Other_Query, OG_Newdata);
  END LOOP;

END;


OG_Data_Changed

  Exemples	  Rubriques connexes

Description  Cette fonction compare les anciennes données et les nouvelles données découlant du dernier appel à la fonction OG_Execute_Query indiquée. Elle retourne TRUE si les données sont différentes et FALSE si elles sont identiques.

Syntaxe

FUNCTION OG_Data_Changed
  (ident_interro  OG_Query)
RETURN BOOLEAN;

Paramètres

ident_interro	Identificateur de l'interrogation.
Retourne TRUE	Si les données ont été modifiées.
FALSE	Si les données n'ont pas été modifiées.

Notes d'utilisation  Cette fonction compare, pour les anciennes et les nouvelles données, les éléments indiqués ci-dessous, et s'arrête dès qu'elle détecte une divergence :

1	nombre de lignes retournées

2	schéma de l'interrogation

3	comparaison cellule par cellule des données (notez que cette comparaison peut être très longue si les ensembles de données sont volumineux)


OG_Data_Changed - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Pour mettre périodiquement à jour un graphique, mais uniquement.
**si les données ont été modifiées, écrire le déclencheur d'horloge suivant :
*/

PROCEDURE my_timer IS
   my_query   OG_Query;
   my_chart   OG_Object;
BEGIN
   my_query:=OG_Get_Query('Interro_Emp');
   OG_Execute_Query(My_Query);
   IF OG_Data_Changed(My_Query) THEN
      my_chart:=OG_Get_Object('Graph_Emp');
      OG_Update_Chart(My_Chart, OG_All_Chupda);
   END IF;
END;


OG_Data_Queried

  Exemples	  Rubriques connexes

Description  Cette fonction détermine si la catégorie de données indiquée a été interrogée par le dernier appel à la fonction OG_Execute_Query indiquée.

Syntaxe

FUNCTION OG_Data_Queried
  (ident_interro   OG_Query,
   données         NUMBER)
RETURN BOOLEAN;

Paramètres

ident_interro	Identificateur de l'interrogation.
données	Indique si l'état des anciennes données ou des nouvelles données doit être vérifié. Graphics Builder comporte deux constantes numériques intégrées qui doivent être utilisées comme valeurs de cet argument : OG_Newdata et OG_Olddata.
Retourne TRUE	Si les données ont été interrogées.
FALSE	Si les données n'ont pas été interrogées.
Notes d'utilisation  Si l'interrogation n'a pas été exécutée par OG_Execute_Query, aucune catégorie de données n'aura été interrogée et cette fonction retourne FALSE. Si l'interrogation a été exécutée exactement une fois, cette fonction retourne TRUE pour les nouvelles données et FALSE pour les anciennes. Si l'interrogation a été exécutée plusieurs fois, cette fonction retourne toujours TRUE.


OG_Data_Queried - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure OG_Data_Changed doit être utilisée pour vérifier si les
**données d'une interrogation ont été modifiées, puis mettre à jour un **graphique.
**utilisant cette interrogation. Pour vérifier, auparavant, que les **nouvelles données et
**les anciennes données ont été interrogées.
*/

PROCEDURE check_and_update IS
   my_query   OG_Query;
   my_chart   OG_Object;
BEGIN
   my_query:=OG_Get_Query('Interro ventes');
   IF OG_Data_Queried(My_Query, OG_Olddata) AND
OG_Data_Queried(My_Query, OG_Newdata) THEN
      IF data_changed(my_query) THEN
         my_chart:=OG_Get_Object('Graph ventes');
         OG_Update_Chart(My_Chart, OG_All_Chupda);
      END IF;
   END IF;
END;


OG_Destroy (interrogation)

  Exemples	  Rubriques connexes

Description  Cette procédure détruit l'interrogation indiquée.

Syntaxe

PROCEDURE OG_Destroy
  (ident_interro  OG_Query);

Paramètres

ident_interro	Identificateur de l'interrogation à détruire.


OG_Destroy (interrogation) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous détruit l'interrogation indiquée :
*/

PROCEDURE destroy_query(query_name VARCHAR2) IS
  query  OG_Query;
BEGIN
  query := OG_Get_Query(Query_Name);
  OG_Destroy(Query);
END;


OG_Execute_Query

  Exemples	  Rubriques connexes

Description  Cette procédure exécute l'interrogation indiquée et stocke le résultat en interne.

Syntaxe

PROCEDURE OG_Execute_Query
  (ident_interro  OG_Query);

Paramètres

ident_interro	Identificateur de l'interrogation à exécuter.

Notes d'utilisation  L'interrogation doit être définie dans Builder. Si elle implique un accès à la base de données, alors que la base de données n'est pas connectée, l'exception OG_No_Database_Connection est générée. Notez que cette procédure ne fait qu'extraire des données ; elle n'applique pas les données à un graphique, et ne manipule des données en aucune façon.

Pour chaque interrogation, la procédure stocke deux ensemble de données : le résultat actuel de l'interrogation ("nouvelles données") et le résultat précédent de l'interrogation ("anciennes données"), ce qui permet d'exécuter des opérations dépendant d'une modification des données, comme la mise à jour d'un graphique, uniquement si les données ont été modifiées depuis la dernière exécution de l'interrogation. D'autres fonctions et procédures internes, qui vous permettent de manipuler et d'examiner des données, servent à indiquer l'ensemble de données que vous voulez utiliser.

Si l'interrogation n'a pas été exécutée par un appel à cette procédure, ni les anciennes données, ni les nouvelles données de l'interrogation n'existent. La première fois que l'interrogation est exécutée, le résultat est stocké sous la forme de nouvelles données, mais les anciennes données n'existent pas. Par la suite, chaque fois que l'interrogation est exécutée, les anciennes données sont détruites, les nouvelles deviennent les anciennes et le dernier résultat de l'interrogation est stocké sous la forme de nouvelles données.

Chaque fois qu'une interrogation est exécutée, un curseur implicite est créé pour les nouvelles données. (Différentes autres procédures et fonctions vous permettent de manipuler ce curseur et d'examiner les données.) Lorsque les nouvelles données sont reclassées comme anciennes, leur curseur (et la position actuelle du curseur dans le liste des données) est conservé. Notez, cependant, qu'un nouveau curseur ne pointe pas automatiquement sur une ligne de données valide. Pour préparer l'utilisation du curseur, utilisez OG_Start_From.


OG_Execute_Query - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour mettre périodiquement à jour un graphique,
**écrire le déclencheur d'horloge suivant :
*/

PROCEDURE every_30_secs IS
   the_query   OG_Query;
   the_chart   OG_Object;
BEGIN
   the_query:=OG_Get_Query('Interro_Emp');
   the_chart:=OG_Get_Object('Graph_Emp');
   OG_Execute_Query(The_Query);
   OG_Update_Chart(The_Chart, OG_All_Chupda);
END;


OG_Get_Charcell

  Exemples	  Rubriques connexes

Description  Cette fonction retourne une valeur de données de type caractère pour l'interrogation indiquée, dans la ligne de données en cours, pour la colonne indiquée.

Syntaxe

FUNCTION OG_Get_Charcell
  (ident_interro   OG_Query,
   nom_col         VARCHAR2)
RETURN VARCHAR2;

FUNCTION OG_Get_Charcell
  (ident_interro   OG_Query,
   données         NUMBER,
   nom_col         VARCHAR2)
RETURN VARCHAR2;

Paramètres

ident_interro	Identificateur de l'interrogation contenant les données à retourner.
nom_col	Nom de la colonne contenant les données à retourner.
données	Indique si la valeur de la cellule est extraite des anciennes données ou des nouvelles. Si ce paramètre n'est pas indiqué, la valeur de cet argument est OG_Newdata par défaut. Elle peut être l'une des constantes intégrées suivantes :  OG_Newdata   Indique que la valeur de la cellule est extraite des nouvelles données. OG_Olddata Indique que la valeur de la cellule est extraite des anciennes données.
Retourne  Le contenu de la cellule de données indiquée.

Notes d'utilisation  La ligne en cours est déterminée par le curseur implicite de l'interrogation, qui est créé à l'origine lorsque la procédure OG_Execute_Query est utilisée pour exécuter l'interrogation.

Si vous représentez sous forme de graphique le résultat de l'interrogation affiché dans la table Données, cette procédure retourne les données contenues dans la cellule à l'intersection de la ligne en cours et de la colonne indiquée.

Vous pouvez utiliser cette procédure pour retourner des valeurs de données provenant de colonnes de type CHAR, VARCHAR2 ou RAW.


OG_Get_Charcell - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Soit un graphique qui
**affiche les salaires des employés.
**La procédure ci-dessous utilise un déclencheur de format
**pour peindre en jaune la colonne de salaire d'un
**employé donné (dans le cas présent, "Scott").
*/

PROCEDURE CharCell (elem IN og_object,

                        query IN og_query) IS

  ename varchar2(10);

BEGIN

  ename := og_get_charcell(query, OG_NEWDATA, 'nome');

  if ename = 'SCOTT' then

     og_set_bfcolor(elem, 'jaune');

  end if;

END;


OG_Get_Datecell

  Exemples	  Rubriques connexes

Description  Cette fonction retourne la valeur de données de date de l'interrogation indiquée, dans la ligne de données en cours, pour la colonne indiquée.

Syntaxe

FUNCTION OG_Get_Datecell
  (ident_interro  OG_Query,
   données        NUMBER,
   nom_col        VARCHAR2)
RETURN DATE;

Paramètres

ident_interro	Identificateur de l'interrogation contenant les données à retourner.
nom_col	Nom de la colonne contenant les données à retourner.
données	Indique si la valeur de la cellule est extraite des anciennes données ou des nouvelles. Si ce paramètre n'est pas indiqué, la valeur de cet argument est OG_Newdata par défaut. Elle peut être l'une des constantes intégrées suivantes :  OG_Newdata   Indique que la valeur de la cellule est extraite des nouvelles données. OG_Olddata Indique que la valeur de la cellule est extraite des anciennes données.
Retourne  Le contenu de la cellule de données indiquée.

Notes d'utilisation  La ligne en cours est déterminée par le curseur implicite de l'interrogation, qui est créé à l'origine lorsque la fonction OG_Execute_Query est utilisée pour exécuter l'interrogation.

Si vous représentez sous forme de graphique le résultat de l'interrogation affiché dans la table de données, cette fonction retourne les données contenues dans la cellule à l'intersection de la ligne en cours et de la colonne indiquée.


OG_Get_Datecell - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/* Soit un graphique en barres
**qui affiche les dates d'embauche de plusieurs employés.
**Pour que la colonne des employés
**embauchés avant le 28 sep 81
**soit colorée en vert,
**utiliser le déclencheur de format suivant.
*/

 PROCEDURE DateCell (elem IN og_object,
                        query IN og_query) IS
  HireDate date;
BEGIN
  HireDate := og_get_datecell(query, OG_NEWDATA, 'DATEMB');
  if HireDate < '28-SEP-81' then
     og_set_bfcolor(elem, 'vert');
  end if;
END;


OG_Get_Newrows

  Exemples	  Rubriques connexes

Description  Cette fonction détermine le nombre de nouvelles lignes de données ajoutées à une interrogation.

Syntaxe

FUNCTION OG_Get_Newrows
  (interrogation  OG_Query)
RETURN NUMBER;

Paramètres

interrogation	Identificateur de l'interrogation.
Retourne  Le nombre de lignes ajoutées à l'interrogation la dernière fois qu'elle a été exécutée.

Notes d'utilisation  Cette fonction est utile uniquement si les propriétés d'interrogation indiquent que les nouvelles données sont ajoutées aux anciennes. Si les nouvelles données remplacent les anciennes, cette fonction retourne le même résultat que OG_Numrows.


OG_Get_Newrows - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit une interrogation qui ajoute de nouvelles données aux anciennes. Pour connaître la
**valeur d'une cellule correspondant à la première nouvelle ligne retournée, utiliser la
**procédure ci-dessous qui définit le curseur de l'interrogation pour qu'il commence à la première nouvelle ligne retournée :
*/

FUNCTION example(query OG_Query) RETURN CHAR IS
  total_rows  NUMBER;
  new_rows    NUMBER;
  new_name    VARCHAR2(10);
BEGIN
  OG_Execute_Query(Query);
  total_rows := OG_Numrows(Query, OG_Newdata);
  new_rows := OG_Get_Newrows(Query);
  OG_Start_From(Query, OG_Newdata, total_rows - new_rows);

  new_name := OG_Get_Charcell(Query, 'NOME');
  RETURN(new_name);
END;


OG_Get_Numcell

  Exemples	  Rubriques connexes

Description  Cette fonction retourne la valeur numérique des données de l'interrogation indiquée, dans la ligne de données en cours, pour la colonne indiquée.

Syntaxe

FUNCTION OG_Get_Numcell
  (ident_interro   OG_Query,
   nom_col         VARCHAR2)
RETURN NUMBER;

FUNCTION OG_Get_Numcell
  (ident_interro   OG_Query,
   données  NUMBER,
   nom_col    VARCHAR2)
RETURN NUMBER;

Paramètres

ident_interro	Identificateur de l'interrogation contenant les données à retourner.
nom_col	Nom de la colonne contenant les données à retourner.
données	Indique si la valeur de la cellule est extraite des anciennes données ou des nouvelles. Si ce paramètre n'est pas indiqué, la valeur de cet argument est OG_Newdata par défaut. Elle peut être l'une des constantes intégrées suivantes : OG_Newdata   Indique que la valeur de la cellule est extraite des nouvelles données. OG_Olddata Indique que la valeur de la cellule est extraite des anciennes données.
Retourne  Le contenu de la cellule de données indiquée.

Notes d'utilisation  La ligne en cours est déterminée par le curseur implicite de l'interrogation, qui est créé à l'origine lorsque la fonction OG_Execute_Query est utilisée pour exécuter l'interrogation.

Si vous représentez sous forme de graphique le résultat de l'interrogation affiché dans la table de données, cette fonction retourne les données contenues dans la cellule à l'intersection de la ligne en cours et de la colonne indiquée.


OG_Get_Numcell - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous illustre un
**déclencheur de format qui colore en rouge
**l'élément de graphique choisi (par exemple,
**graphique en secteur ou en barre)
**si sa valeur est supérieure à 200.
/*

PROCEDURE format_point (elem IN og_object, query IN
    og_query) IS
  st_price NUMBER;
BEGIN
  st_price:=OG_GET_NUMCELL (query, OG_NEWDATA, 'pr_vente');
IF st_price > 200 THEN
  OG_SET_BFCOLOR (elem,'rouge');
END IF;
END;


OG_Get_Query

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un identificateur de l'interrogation indiquée.

Syntaxe

FUNCTION OG_Get_Query
  (nom_interro  VARCHAR2)
RETURN OG_Query;

Paramètres

nom_interro	Nom de l'interrogation dont l'identificateur est retourné.  Remarque :  NOM_INTERRO fait l'objet d'une distinction entre majuscules et minuscules.

Retourne  Un identificateur de l'interrogation indiquée.

Notes d'utilisation  Si l'interrogation n'existe pas, cette fonction retourne un identificateur NULL.


OG_Get_Query - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Pour mettre périodiquement à jour un graphique,
**écrire le déclencheur d'horloge suivant :
*/

PROCEDURE every_30_secs IS
   the_query   OG_Query;
   the_chart   OG_Object;
BEGIN
   the_query:=OG_Get_Query('Interro_Emp');
   the_chart:=OG_Get_Object('Graph_Emp');
   OG_Execute_Query(The_Query);
   OG_Update_Chart(The_Chart, OG_All_Chupda);


OG_Get_Schema

  Exemples	  Rubriques connexes

Description  Cette fonction retourne des informations sur le schéma d'une colonne particulière d'une interrogation.

Syntaxe

FUNCTION OG_Get_Schema
  (ident_interro   OG_Query,
   données          NUMBER,
   num_col         NUMBER)
RETURN OG_Colschema;

Paramètres

ident_interro	Identificateur de l'interrogation qui contient la colonne.
données	Indique si la colonne dont le schéma est extrait existe dans les nouvelles données de l'interrogation ou dans les anciennes. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Newdata   Indique que la colonne existe dans les nouvelles données de l'interrogation. OG_Olddata Indique que la colonne existe dans les anciennes données de l'interrogation.
num_col	Indique le schéma de colonne qui est extrait. La première colonne porte le numéro 0, la deuxième le numéro 1, etc.

Retourne  Le schéma de la colonne dans l'interrogation indiquée.


OG_Get_Schema - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Pour interroger une table de base de données, puis utiliser
**le nom de la première colonne en un autre endroit de l'application, un
**paramètre de type CHAR, appelé 'mon_interrogation', a été défini, ainsi que
**l'interrogation SQL, ci-dessous, appelée `interro0' :
*/

&my_query

/* La fonction suivante utilise un nom de table comme argument et
**retourne le nom de la première colonne de la table :
*/

FUNCTION get_col_name (table_name IN VARCHAR2) RETURN VARCHAR2 IS
   my_schema    OG_Colschema;
   star_query   OG_Query;
BEGIN
   :my_query:='select * from ' || table_name;
   star_query:=OG_Get_Query('Interro0');
   OG_Execute_Query(Star_Query);
   my_schema:=OG_Get_Schema(Star_Query, OG_Newdata, 0);
   RETURN(my_schema.colname);
END;


OG_Insert_Column

  Exemples	  Rubriques connexes

Description  Cette procédure insère une colonne dans une interrogation personnalisée.

Syntaxe

PROCEDURE OG_Insert_Column
  (ident_interro  OG_Query,
   index          NUMBER,
   schéma         OG_Colschema);

Paramètres

ident_interro	Identificateur de l'interrogation dans laquelle la colonne doit être insérée.
index	Index auquel la nouvelle colonne doit être insérée dans la liste de colonnes de l'interrogation. Cet argument doit être un entier compris entre 0 et n (inclus), où n est le nombre de colonnes de l'interrogation avant l'insertion. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_First   Indique que la nouvelle colonne sera insérée au début de la liste des colonnes de l'interrogation (index = 0). OG_Last Indique que la nouvelle colonne sera insérée à la fin de la liste des colonnes de l'interrogation (index = nombre de colonnes de l'interrogation avant l'insertion).
schéma	Schéma de la colonne à insérer.


OG_Insert_Column - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure suivante crée 'interro0', qui contient les colonnes NOME et SAL :
*/

PROCEDURE example IS
  query  OG_Query;
  col    OG_Colschema;
BEGIN
  query := OG_Make_Query('Interro0', NULL);
  OG_Set_Querytype(Query, OG_Custom_Qtype);

  col.colname := 'NOME';
  col.coltype := OG_Char_Coltype;
  col.maxlen := 10;

  OG_Insert_Column(Query, OG_Last, col);

  col.colname := 'SAL';
  col.coltype := OG_Number_Coltype;
  col.precision := 7;
  col.scale := 2;

  OG_Insert_Column(Query, OG_Last, col);

END;


OG_Make_Query

  Exemples	  Rubriques connexes

Description  Cette fonction crée une interrogation.

Syntaxe

FUNCTION OG_Make_Query
  (type_interro    NUMBER,
   type_source     VARCHAR2
RETURN OG_Query;

Paramètres

type_interro	Type de l'interrogation. La valeur de cet argument peut être l'une des constantes intégrées suivantes  OG_Custom_Qtype   Indique que l'interrogation est une interrogation personnalisée. OG_Exsql_Qtype Indique que l'interrogation extrait ses données d'un fichier texte qui contient une instruction SQL SELECT. OG_Prn_Qtype Indique que l'interrogation est basée sur un fichier PRN. OG_Sql_Qtype Indique que l'interrogation est une instruction SQL SELECT. OG_Sylk_Qtype Indique que l'interrogation est basée sur un fichier SYLK. OG_Wks_Qtype Indique que l'interrogation est basée sur un fichier WKS.
type_source	Source des données de l'interrogation. Si les données proviennent d'une base de données, cette propriété doit contenir le texte de l'instruction SQL_SELECT de l'interrogation. Si les données sont stockées dans le système de fichiers, cette propriété doit contenir le chemin d'accès au fichier de données et son nom.

Retourne  Un identificateur de l'interrogation nouvellement créée.


OG_Make_Query - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous crée une interrogation SQL :
*/

FUNCTION example(query_name VARCHAR2) RETURN OG_Query IS
  query   OG_Query;
  qtype   NUMBER;
  qsource VARCHAR2(2000);
BEGIN
  qtype := OG_Sql_Qtype;
  qsource := 'select nome, sal from emp';

  query := OG_Make_Query(Qtype, qsource);

  OG_Set_Name(Query, query_name);
  OG_Execute_Query(Query);
  RETURN(query);
END;


OG_Next_Row

  Exemples	  Rubriques connexes

Description

Syntaxe Cette procédure fait avancer le curseur implicite associé à l'interrogation indiquée, à la prochaine ligne de données.

PROCEDURE OG_Next_Row
  (ident_interro   OG_Query,
   données          NUMBER);

Paramètres

ident_interro	Identificateur de l'interrogation.
données	Type de données à traiter : anciennes ou nouvelles La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Newdata   Indique le déplacement du curseur en vue du traitement des nouvelles données de l'interrogation. OG_Olddata   Indique le déplacement du curseur en vue du traitement des anciennes données de l'interrogation.
Notes d'utilisation  Si le curseur pointe sur la dernière ligne de données de l'interrogation, le prochain appel à OG_Next_Row ne déplacera pas le curseur. Le curseur ne passera pas à une ligne qui n'existe pas, et aucune erreur ou exception ne sera générée. Pour savoir si le curseur pointe sur la dernière ligne de données, utilisez OG_Numrows qui détermine le nombre exact de lignes, puis notez le nombre de fois où vous utilisez OG_Next_Row pour faire avancer le curseur.


OG_Next_Row - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour donner un nom à chaque barre d'un graphique en barres afin de pouvoir
**déterminer, lorsque l'utilisateur sélectionne l'une des barres, celle dont
**il s'agit en vérifiant son nom, l'interrogation du graphique peut se présenter comme suit :
*/

SELECT ENAME, SAL FROM EMP

 /*La procédure ci-dessous donne à chaque barre le nom de sa catégorie
**qui, dans le cas présent, est le NOME qui lui est associé :
*/

PROCEDURE name_the_bars (my_chart IN OG_Object, my_query IN
  OG_Query) IS
   bar_rec    OG_Chelement_Ca;
   curr_row   NUMBER;
   total      NUMBER;
   bar_name   VARCHAR2(15);
BEGIN
   OG_Execute_Query(My_Query);
   OG_Start_From(My_Query, OG_Newdata, 0);
   total:=OG_Numrows(My_Query, OG_Newdata);
   FOR curr_row IN 0..total-1 LOOP
      bar_name:=OG_Get_Charcell(My_Query,
        OG_Newdata, 'NOME');
      bar_rec.chelement_cagr.mask:=OG_None_Graphica;
      bar_rec.chelement_cace.mask:=OG_Name_Chelementa;
      bar_rec.chelement_cace.name:=bar_name;
      OG_Set_Attr(My_Chart, curr_row, 'NOME', bar_rec);
      OG_Next_Row(My_Query, OG_Newdata);
   END LOOP;
   OG_Update_Chart(My_Chart, OG_All_Chupda);
END;


OG_Numcols

  Exemples	  Rubriques connexes

Description  Cette fonction retourne le nombre de colonnes existant dans une interrogation.

Syntaxe

FUNCTION OG_Numcols
  (ident_interro   OG_Query,
   données              NUMBER)
RETURN NUMBER;

Paramètres

ident_interro	Identificateur de l'interrogation.
données	Type des données à vérifier : anciennes ou nouvelles. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Newdata   Indique que la fonction devra retourner le nombre de colonnes des nouvelles données de l'interrogation. OG_Olddata Indique que la fonction devra retourner le nombre de colonnes des anciennes données de l'interrogation.
Retourne  Le nombre de colonnes de l'interrogation indiquée.


OG_Numcols - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Reports doit transmettre à votre affichage des données à tracer sous forme de
**graphique. La colonne qui recevra l'affichage n'étant pas connue exactement, il est
**conseillé de rendre générique la procédure de traçage de graphique. Ecrire une procédure
**pour créer un graphique, puis transmettre l'interrogation graphique à une autre procédure
**qui insère les colonnes de l'interrogation sous la forme ce champs. La procédure ci-
**dessous insère les colonnes (en considérant que la première est le champ indépendant et
**les suivantes des champs dépendants) :
*/

PROCEDURE add_columns(the_query OG_Query, the_chart OG_Object) IS
   num_of_cols   NUMBER(1);
   the_field     OG_Field;
   the_column    OG_Colschema;
BEGIN
   OG_Execute_Query(The_Query);
   num_of_cols:=OG_Numcols(The_Query, OG_Newdata);
   FOR i IN 0..num_of_cols-1 LOOP
      the_column:=OG_Get_Schema(The_Query, OG_Newdata, i);
      the_field.colname:=the_column.colname;
      IF i=0 THEN
         the_field.field_type:=OG_Independent;
      ELSE
         the_field.field_type:=OG_Dependent;
         the_field.ftname:='ligne';
      END IF;
      OG_Insert_Field(The_Chart, the_field, i);
   END LOOP;
   OG_Update_Chart(The_Chart, OG_All_Chupda);
END;


OG_Numrows

  Exemples	  Rubriques connexes

Description  Cette fonction retourne le nombre de lignes existant dans une interrogation.

Syntaxe

FUNCTION OG_Numrows
  (ident_interro   OG_Query,
   données          NUMBER)
RETURN NUMBER;

Paramètres

ident_interro	Identificateur de l'interrogation.
données	Type des données à vérifier : anciennes ou nouvelles. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Newdata   Indique que la fonction devra retourner le nombre de lignes des nouvelles données de l'interrogation. OG_Olddata Indique que la fonction devra retourner le nombre de lignes des anciennes données de l'interrogation.
Retourne  Le nombre de lignes de l'interrogation indiquée.


OG_Numrows - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour donner un nom à chaque barre d'un graphique en barres afin de pouvoir
**déterminer, lorsque l'utilisateur sélectionne l'une des barres, celle dont il
**s'agit en vérifiant son nom, l'interrogation du graphique peut se présenter comme suit :
*/

SELECT ENAME, SAL FROM EMP

/*La procédure ci-dessous donne à chaque barre le nom de sa catégorie
**qui, dans le cas présent, est le NOME qui lui est associé :
*/

PROCEDURE name_the_bars(my_chart IN OG_Object, my_query IN
  OG_Query) IS
   bar_rec    OG_Chelement_Ca;
   curr_row   NUMBER;
   total      NUMBER;
   bar_name   VARCHAR2(15);
BEGIN
   OG_Execute_Query(My_Query);
   OG_Start_From(My_Query, OG_Newdata, 0);
   total:=OG_Numrows(My_Query, OG_Newdata);
   FOR curr_row IN 0..total-1 LOOP
      bar_name:=OG_Get_Charcell(My_Query, OG_Newdata,
        'NOME');
      bar_rec.chelement_cagr.mask:=OG_None_Graphica;
      bar_rec.chelement_cace.mask:=OG_Name_Chelementa;
      bar_rec.chelement_cace.name:=bar_name;
      OG_Set_Attr(My_Chart, curr_row, 'NOME', bar_rec);
      OG_Next_Row(My_Query, OG_Newdata);
   END LOOP;
   OG_Update_Chart(My_Chart, OG_All_Chupda);
END;


OG_Set_Charcell

  Exemples	  Rubriques connexes

Description  Cette procédure définit la valeur d'une cellule de type CHAR dans le tampon de lignes.

Syntaxe

PROCEDURE OG_Set_Charcell
  (ident_interro   OG_Query,
   nom_col         VARCHAR2
   valeur_cellule  VARCHAR2);

Paramètres

ident_interro	Identificateur de l'interrogation dans laquelle la valeur de cellule doit être définie.
nom_col	Nom de la colonne contenant la cellule à définir.
valeur_cellule	Indique la valeur que contiendra la cellule.

Notes d'utilisation  Lorsque vous avez défini les valeurs de toutes les cellules du tampon, utilisez OG_Append_Row pour ajouter le tampon à la fin de l'interrogation personnalisée, sous la forme d'une nouvelle ligne.


OG_Set_Charcell - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour créer une interrogation personnalisée en utilisant les colonnes NOME,
**SAL et DATEMB de l'interrogation 'interro0' comme base et, dans
**l'interrogation suivante, doubler la valeur de chaque SAL,
**utiliser pour cela la procédure d'interrogation personnalisée suivante :
*/

PROCEDURE OGQUERYPROC0(query IN OG_Query) IS
  other_ename     VARCHAR2(10);
  other_sal       NUMBER(7,2);
  other_query     OG_Query;
  other_hiredate  DATE;
  row_count       NUMBER;
BEGIN
  OG_Clear_Query(Query);

  other_query := OG_Get_Query('Interro0');
  row_count := OG_Numrows(Other_Query, OG_Newdata);
  OG_Start_From(Other_Query, OG_Newdata, 0);

  FOR i IN 0..row_count-1 loop
    other_ename := OG_Get_Charcell(Other_Query, 'NOME');
    other_sal := OG_Get_Numcell(Other_Query, 'SAL');
    other_hiredate := OG_Get_Numcell(Other_Query, 'DATEMB');
    OG_Set_Charcell(Query, 'NOME', other_ename);
    OG_Set_Numcell(Query, 'SAL', other_sal * 2);
    OG_Set_Datecell(Query, 'DATEMB', other_hiredate);
    OG_Append_Row(Query);
    OG_Next_Row(Other_Query, OG_Newdata);
  END LOOP;

END;


OG_Set_Datecell

  Exemples	  Rubriques connexes

Description  Cette procédure définit la valeur d'une cellule de type DATE dans le tampon de lignes.

Syntaxe

PROCEDURE OG_Set_Datecell
  (ident_interro       OG_Query,
   nom_col             VARCHAR2
   valeur_cellule      DATE);

Paramètres

ident_interro	Identificateur de l'interrogation dans laquelle la valeur de cellule doit être définie.
nom_col	Nom de la colonne contenant la cellule à définir.
valeur_cellule	Indique la valeur que contiendra la cellule.

Notes d'utilisation  Lorsque vous avez défini les valeurs de toutes les cellules du tampon, utilisez OG_Append_Row pour ajouter le tampon à la fin de l'interrogation personnalisée, sous la forme d'une nouvelle ligne.


OG_Set_Datecell - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour créer une interrogation personnalisée en utilisant les colonnes NOME,
**SAL et DATEMB de l'interrogation 'interro0' comme base et, dans
**l'interrogation suivante, doubler la valeur de chaque SAL, utiliser pour
**cela la procédure d'interrogation personnalisée suivante :
*/

PROCEDURE OGQUERYPROC0(query IN OG_Query) IS
  other_ename     VARCHAR2(10);
  other_sal       NUMBER(7,2);
  other_query     OG_Query;
  other_hiredate  DATE;
  row_count       NUMBER;
BEGIN
  OG_Clear_Query(Query);

  other_query := OG_Get_Query('Interro0');
  row_count := OG_Numrows(Other_Query, OG_Newdata);
  OG_Start_From(Other_Query, OG_Newdata, 0);

  FOR i IN 0..row_count-1 loop
    other_ename := OG_Get_Charcell(Other_Query, 'NOME');
    other_sal := OG_Get_Numcell(Other_Query, 'SAL');
    other_hiredate := OG_Get_Numcell(Other_Query, 'DATEMB');
    OG_Set_Charcell(Query, 'NOME', other_ename);
    OG_Set_Numcell(Query, 'SAL', other_sal * 2);
    OG_Set_Datecell(Query, 'DATEMB', other_hiredate);
    OG_Append_Row(Query);
    OG_Next_Row(Other_Query, OG_Newdata);
  END LOOP;

END;


OG_Set_Numcell

  Exemples	  Rubriques connexes

Description  Cette procédure définit la valeur d'une cellule de type NUMBER dans le tampon de lignes.

Syntaxe

PROCEDURE OG_Set_Numcell
  (ident_interro       OG_Query,
   nom_col             VARCHAR2,
   valeur_cellule      NUMBER);

Paramètres

ident_interro	Identificateur de l'interrogation dans laquelle la valeur de cellule doit être définie.
nom_col	Nom de la colonne contenant la cellule à définir.
valeur_cellule	Indique la valeur que contiendra la cellule.

Notes d'utilisation  Lorsque vous avez défini les valeurs de toutes les cellules du tampon, utilisez OG_Append_Row pour ajouter le tampon à la fin de l'interrogation personnalisée, sous la forme d'une nouvelle ligne.


OG_Set_Numcell - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour créer une interrogation personnalisée en utilisant les colonnes NOME, SAL et
**DATEMB de l'interrogation 'interro0' comme base et, dans l'interrogation
**suivante, doubler la valeur de chaque SAL, utiliser pour cela la
**procédure d'interrogation personnalisée suivante :
*/

PROCEDURE OGQUERYPROC0(query IN OG_Query) IS
  other_ename     VARCHAR2(10);
  other_sal       NUMBER(7,2);
  other_query     OG_Query;
  other_hiredate  DATE;
  row_count       NUMBER;
BEGIN
  OG_Clear_Query(Query);

  other_query := OG_Get_Query('Interro0');
  row_count := OG_Numrows(Other_Query, OG_Newdata);
  OG_Start_From(Other_Query, OG_Newdata, 0);
  FOR i IN 0..row_count-1 loop
    other_ename := OG_Get_Charcell(Other_Query, 'NOME');
    other_sal := OG_Get_Numcell(Other_Query, 'SAL');
    other_hiredate := OG_Get_Numcell(Other_Query, 'DATEMB');
    OG_Set_Charcell(Query, 'NOME', other_ename);
    OG_Set_Numcell(Query, 'SAL', other_sal * 2);
    OG_Set_Datecell(Query, 'DATEMB', other_hiredate);
    OG_Append_Row(Query);
    OG_Next_Row(Other_Query, OG_Newdata);
  END LOOP;

END;


OG_Set_Schema

  Exemples	  Rubriques connexes

Description  Cette procédure définit le schéma d'une colonne d'une interrogation personnalisée.

Syntaxe

PROCEDURE OG_Set_Schema
  (ident_interro  OG_Query,
   num_col        NUMBER,
   schéma         OG_Colschema);

Paramètres

ident_interro	Identificateur de l'interrogation dont vous voulez définir le schéma.
num_col	Index de la colonne que vous voulez définir.
schéma	Nouveau schéma auquel vous voulez définir la colonne.


OG_Set_Schema - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous remplace, dans la première colonne d'une
**interrogation personnalisée, NOME par EMPLOYE :
*/

PROCEDURE example(query OG_Query) IS
  schema  OG_Colschema;
BEGIN
  schema.colname := 'EMPLOYE';
  schema.coltype := OG_Char_Coltype;
  schema.maxlen := 10;

  OG_Set_Schema(Query, 0, schema);

END;


OG_Start_From

  Exemples	  Rubriques connexes

Description  Cette procédure fait pointer le curseur implicite associé à l'interrogation indiquée sur la ligne de données indiquée.

Syntaxe

PROCEDURE OG_Start_From
  (ident_interro   OG_Query,
   données          NUMBER,
   ligne_départ    NUMBER);

Paramètres

ident_interro	Identificateur de l'interrogation.
données	Données à traiter : anciennes ou nouvelles données. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Newdata   Indique que le curseur devra être défini pour les nouvelles données de l'interrogation. OG_Olddata Indique que le curseur devra être défini pour les anciennes données de l'interrogation.
ligne_départ	Numéro de la ligne à laquelle le curseur doit être positionné.

Notes d'utilisation  Pour que le curseur pointe sur la toute première ligne des données, utilisez une valeur de décalage de 0. La dernière ligne de données aura un décalage égal à la valeur retournée par OG_Numrows moins 1. Notez que chaque fois que la procédure OG_Execute_Query est utilisée pour exécuter l'interrogation  la position du curseur n'est pas prise en compte et doit être redéfinie. N'oubliez pas que le nombre de lignes extraites par une interrogation peut changer chaque fois que l'interrogation est exécutée.


OG_Start_From - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour donner un nom à chaque barre d'un graphique en barres afin de pouvoir
**déterminer, lorsque l'utilisateur sélectionne l'une des barres, celle dont il
**s'agit en vérifiant son nom, l'interrogation du graphique peut se présenter
**comme suit :
*/

SELECT ENAME, SAL FROM EMP

/*La procédure ci-dessous donne à chaque barre le nom de sa catégorie
**qui, dans le cas présent, est le NOME qui lui est associé :
*/

PROCEDURE name_the_bars (my_chart IN OG_Object, my_query IN
  OG_Query) IS
   bar_rec    OG_Chelement_Ca;
   curr_row   NUMBER;
   total      NUMBER;
   bar_name   VARCHAR2(15);
BEGIN
   OG_Execute_Query(My_Query);
   OG_Start_From(My_Query, OG_Newdata, 0);
   total:=OG_Numrows(My_Query, OG_Newdata);
   FOR curr_row IN 0..total-1 LOOP
      bar_name:=OG_Get_Charcell(My_Query, OG_Newdata,
        'NOME');
      bar_rec.chelement_cagr.mask:=OG_None_Graphica;
      bar_rec.chelement_cace.mask:=OG_Name_Chelementa;
      bar_rec.chelement_cace.name:=bar_name;
      OG_Set_Attr(My_Chart, curr_row, 'NOME', bar_rec);
      OG_Next_Row(My_Query, OG_Newdata);
   END LOOP;
   OG_Update_Chart(My_Chart, OG_All_Chupda);
END;


Aucun sous-programme intégré ne commence par cette lettre.


Procédures internes de son

OG_Destroy (son)

OG_Export_Sound

OG_Get_Sound

OG_Import_Sound

OG_Make_Sound

OG_Play_Sound

OG_Record_Sound

OG_Stop_Sound


OG_Destroy (son)

  Exemples	  Rubriques connexes

Description  Cette procédure détruit le son indiqué.

Syntaxe

PROCEDURE OG_Destroy
  (ident_son  OG_Sound);

Paramètres

ident_son	Identificateur du son à détruire.


OG_Destroy (son) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* La procédure ci-dessous détruit le son indiqué :
*/

PROCEDURE destroy_sound(sound_name VARCHAR2) IS
  sound  OG_Sound;
BEGIN
  sound := OG_Get_Sound(Sound_Name);
  OG_Destroy(Sound);
END;


OG_Export_Sound

  Exemples	  Rubriques connexes

Description  Cette procédure exporte un son.

Syntaxe

PROCEDURE OG_Export_Sound
  (nom         VARCHAR2,
   gisement    NUMBER,
   format      NUMBER,
   ident_son   OG_Sound);

Paramètres

nom	Nom sous lequel le son sera exporté. Si le son est stocké dans la base de données, cet argument doit contenir uniquement le nom du module son. Si le son est stocké dans le système de fichiers, cet argument doit contenir le chemin d'accès absolu ou relatif au fichier Son.
gisement	Indique si le son doit être stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Db   Indique que le son doit être stocké dans la base de données. OG_Filesystem   Indique que le son doit être stocké dans le système de fichiers.
format	Format dans lequel le son est exporté. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Aiff_Sformat   Indique que le son est enregistré en format AIFF. OG_Aiffc_Sformat   Indique que le son est enregistré en format AIFF-c. OG_Au_Sformat   Indique que le son est enregistré en format SUN AU. OG_Wave_Sformat   Indique que le son est enregistré en format PCM WAVE.
ident_son	Identificateur du son à exporter.


OG_Export_Sound - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*Pour exporter le son, appelé 'son0', dans le fichier AIFF-c
**`mon_son', afin de pouvoir l'importer ultérieurement dans une autre
**application, utiliser la procédure ci-dessous :
*/

PROCEDURE export_the_sound IS
   the_sound   OG_Sound;
BEGIN
   the_sound:=OG_Get_Sound('Son0');
   OG_Export_Sound('Mon_Son', OG_Filesystem,
OG_Aiffc_Sformat, the_sound);
END;


OG_Get_Sound

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un identificateur du son indiqué.

Syntaxe

FUNCTION OG_Get_Sound
   (nom_son  VARCHAR2)
RETURN OG_Sound;

Paramètres

nom_son	Nom du son dont l'identificateur doit être retourné.

Retourne  Un identificateur du son indiqué. Si le son n'existe pas, cette fonction retourne un identificateur NULL.


OG_Get_Sound - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*Pour exécuter un son d'avertissement signalant que le stock
**est insuffisant ou que l'utilisateur a effectué une action non valide.
*/

PROCEDURE warning IS
   the_sound   OG_Sound;
BEGIN
   the_sound:=OG_Get_Sound('Son_avertissement');
   OG_Play_Sound(The_Sound);
END;


OG_Import_Sound

  Exemples	  Rubriques connexes

Description  Cette procédure importe un son de la base de données ou d'un fichier.

Syntax

FUNCTION OG_Import_Sound
  (nom         VARCHAR2,
   gisement    NUMBER,
   format      NUMBER,
   nom_son     VARCHAR2)
RETURN OG_Sound;

Paramètres

nom	Nom du son stocké. Si le son est stocké dans la base de données, cet argument doit contenir uniquement le nom du son. Si le son est stocké dans le système de fichiers, cet argument doit contenir le chemin d'accès absolu ou relatif au fichier Son.
gisement	Indique si le son est stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Db   Indique que le son est stocké dans la base de données. OG_Filesystem   Indique que le son est stocké dans le système de fichiers.
format	Format dans lequel le son est enregistré. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Aiff_Sformat Indique que le son est enregistré en format AIFF. OG_Aiffc_Sformat Indique que le son est enregistré en format AIFF-c. OG_Any_Sformat   Indique que Graphics Builder détermine automatiquement le format du son.  Remarque :  Indiquez ce format si le son a été exporté en format Oracle (actuellement obsolète). OG_Au_Sformat Indique que le son est enregistré en format SUN AU. OG_Oracle_Sformat  Indique que le son est enregistré en format Oracle, utilisé par d'autres produits Oracle. OG_Wave_Sformat Indique que le son est enregistré en format WAV.
nom_son	Indique le nom que Graphics Builder donnera au son. S'il existe déjà un autre son de ce nom, Graphics Builder le remplace par le son importé.

Retourne  Un identificateur du son importé.


OG_Import_Sound - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*Pour importer le contenu du fichier AIFF-c
**`mon_son' dans un affichage sous le nom `son0',
**utiliser la procédure ci-dessous :
*/

PROCEDURE import_the_sound IS
   the_sound   OG_Sound;
BEGIN
   the_sound:=OG_Import_Sound('Mon_son', OG_Filesystem,
OG_Aiffc_Sformat, 'son0');
END;


OG_Make_Sound

  Exemples	  Rubriques connexes

Description  Cette fonction crée un son à partir des données stockées dans une table de base de données.

Syntaxe

FUNCTION OG_Make_Sound
  (interrogation OG_Query,
   données       NUMBER,
   nomcol        VARCHAR2)
RETURN OG_Sound;

Paramètres

interrogation	Identificateur de l'interrogation qui extrait le son d'une table d'une base de données. Notez que cette table doit être une table utilisateur, et non l'une des tables privées utilisées par Graphics Builder lorsque vous enregistrez ou exportez un module dans la base de données.
données	Indique si le son à créer se trouve dans l'ancien ensemble de données d'une interrogation, ou dans le nouveau. Graphics Builder fournit deux constantes numériques intégrées, à utiliser pour cet attribut :   OG_Newdata   Indique que le son se trouve dans le nouvel ensemble de données de l'interrogation. OG_Olddata   Indique que le son se trouve dans l'ancien ensemble de données de l'interrogation.
nomcol	Nom de la colonne de l'interrogation qui contient les données son. Le son créé est celui qui se trouve dans la cellule de l'interrogation, située à l'intersection de la colonne indiquée par cet attribut et de la ligne pointée par le curseur de l'interrogation.

Retourne  Un identificateur du son nouvellement créé.


OG_Make_Sound - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* La fonction ci-dessous crée un son à partir de données situées à la sixième
**ligne de l'interrogation 'interro_son' de la colonne COLONNE_SON :
*/

FUNCTION example(sound_name VARCHAR2) RETURN OG_Sound IS
  query  OG_Query;
  sound  OG_Sound;
BEGIN
  query := OG_Get_Query('Interro_son');
  OG_Execute_Query(Query);
  OG_Start_From(Query, OG_Newdata, 5);
  sound := OG_Make_Sound(Query, OG_Newdata, 'COLONNE_SON');

  OG_Set_Name(Sound, sound_name);
  RETURN(sound);
END;


OG_Play_Sound

  Exemples	  Rubriques connexes

Description  Cette procédure lit le son indiqué, sur l'unité de sortie précisée dans les préférences.

Syntaxe

PROCEDURE OG_Play_Sound
  (ident_son  OG_Sound);

Paramètres

ident_son	Identificateur du son à lire.


OG_Play_Sound - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* Pour exécuter un son d'avertissement signalant que le stock
** est insuffisant ou que l'utilisateur a effectué une action non valide.
*/

PROCEDURE warning IS
   the_sound   OG_Sound;
BEGIN
   the_sound:=OG_Get_Sound('Son_avertissement');
   OG_Play_Sound(The_Sound);
END;


OG_Record_Sound

  Exemples	  Rubriques connexes

Description  Cette procédure affiche la boîte de dialogue de son et permet à l'utilisateur d'enregistrer un nouveau son.

Syntaxe

PROCEDURE OG_Record_Sound
  (ident_son  OG_Sound);

Paramètres

ident_son	Indique l'identificateur du son.

Notes d'utilisation  Le nouveau son remplace le son sur lequel pointe ident_son. En outre, ident_son doit pointer sur un son déjà créé soit dans le Builder, soit par les fonctions intégrées OG_Import_Sound et OG_Make.


OG_Record_Sound - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*Pour que l'utilisateur enregistre un son qui se fera entendre sous la forme d'un
**avertissement lorsque les données changent, utiliser la procédure suivante :
*/

PROCEDURE record_warning IS
   warn_sound   OG_Sound;
BEGIN
   warn_sound:=OG_Get_Sound('Avertissement');
   IF not OG_Isnull(Warn_Sound) THEN
      OG_Record_Sound(Warn_Sound);
   END IF;
END;


OG_Stop_Sound

  Exemples	  Rubriques connexes

Description  Cette procédure annule la lecture d'un son en cours.

Syntaxe

PROCEDURE OG_Stop_Sound
  (ident_son   OG_Sound);

Paramètres

ident_son	Identificateur du son dont vous voulez arrêter la lecture.


OG_Stop_Sound - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* Pour créer un bouton que l'utilisateur
**pourra sélectionner pour arrêter la lecture d'un son en cours,
**utiliser la procédure suivante :
*/

PROCEDURE OGBUTTONPROC0 (buttonobj IN OG_Object, hitobj IN OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
  sound  OG_Sound;
BEGIN
  sound := OG_Get_Sound('Alarme');
  OG_Stop_Sound(Sound);
END;


Procédures internes de modèle

OG_Clone (modèle)

OG_Delete_Ftemp

OG_Delete_Refline

OG_Destroy (modèle)

OG_Export_Template

OG_Get_Axis

OG_Get_Ftemp

OG_Get_Refline

OG_Get_Template

OG_Import_Template

OG_Insert_Ftemp

OG_Insert_Refline

OG_Make_Template


OG_Clone (modèle)

  Exemples	  Rubriques connexes

Description  Cette fonction crée un nouveau modèle de graphique identique au modèle indiqué.

Syntaxe

FUNCTION OG_Clone
  (ident_modèle  OG_Template,
   nom           VARCHAR2)
RETURN OG_Template;

Paramètres

ident_modèle	Identificateur du modèle de graphique à cloner.
nom	Nom à donner au nouveau modèle.

Retourne  Un identificateur du modèle nouvellement créé.


OG_Clone (modèle) - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un modèle à utiliser pour en créer un autre,
**identique, sans avoir à indiquer à nouveau les mêmes propriétés.
*/

PROCEDURE dup_template(old_template IN OG_Template) IS
   new_template   OG_Template;
BEGIN
   new_template:=OG_Clone(Old_Template);
END;


OG_Delete_Ftemp

  Exemples	  Rubriques connexes

Description  Cette procédure supprime un ou plusieurs modèles de champ du modèle de graphique indiqué.

Syntaxe

PROCEDURE OG_Delete_Ftemp
  (ident_modèle   OG_Template,
   index          NUMBER,
   total          NUMBER);

Paramètres

ident_modèle	Identificateur du modèle de graphique.
index	Index du premier modèle de champ à supprimer de la liste des modèles de champ du graphique.
total	Nombre total de modèles de champ à supprimer.


OG_Delete_Ftemp - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure suivante supprime une colonne du modèle 'modèle0':
*/

PROCEDURE example(ft_num  NUMBER) IS
  template  OG_Template;
BEGIN
  template := OG_Get_Template('Modèle0');
  OG_Delete_Ftemp(Template, ft_num, 1);
END;


OG_Delete_Refline

  Exemples	  Rubriques connexes

Description  Cette procédure supprime une ou plusieurs lignes de référence du modèle de graphique indiqué.

Syntaxe

PROCEDURE OG_Delete_Refline
  (ident_modèle  OG_Template,
   index         NUMBER,
   total         NUMBER);

Paramètres

ident_modèle	Identificateur du modèle de graphique.
index	Index de la première ligne de référence à supprimer de la liste des lignes de référence du modèle de graphique.
total	Nombre total de lignes de référence à supprimer.


OG_Delete_Refline - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous supprime une ligne de référence du modèle 'modèle0'.
*/

PROCEDURE example(rl_num  NUMBER) IS
  template  OG_Template;
BEGIN
  template := OG_Get_Template('Modèle0');
  OG_Delete_Refline(Template, rl_num, 1);
END;


OG_Destroy (modèle)

  Exemples	  Rubriques connexes

Description  Cette procédure détruit le modèle de graphique indiqué.

Syntaxe

PROCEDURE OG_Destroy
  (ident_modèle  OG_Template);

Paramètres

ident_modèle	Identificateur du modèle de graphique à détruire.


OG_Destroy (modèle) - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous détruit le modèle indiqué :
*/

PROCEDURE destroy_template(template_name VARCHAR2) IS
  template  OG_Template;
BEGIN
  template := OG_Get_Template(Template_Name);
  OG_Destroy(Template);
END;


OG_Export_Template

  Exemples	  Rubriques connexes

Description  Cette procédure exporte un modèle de graphique.

Syntaxe

PROCEDURE OG_Export_Template
  (nom           VARCHAR2,
   gisement      NUMBER,
   ident_modèle  OG_Template);

Paramètres

nom	Nom sous lequel le modèle sera exporté. Si le modèle est stocké dans la base de données, cet argument doit contenir uniquement le nom du modèle. Si le modèle est stocké dans le système de fichiers, cet argument doit contenir le nom de chemin d'accès absolu ou relatif au fichier de modèles.
gisement	Indique si le modèle doit être stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être une des constantes intégrées suivantes :  OG_Db   Indique que le modèle doit être stocké dans la base de données. OG_Filesystem Indique que le modèle doit être stocké dans le système de fichiers.
ident_modèle	Identificateur du modèle à exporter.


OG_Export_Template - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit le modèle de graphique, appelé 'modèle0', à exporter dans
**le fichier 'mon_mod' pour pouvoir l'importer ultérieurement dans un autre
**affichage Graphics Builder. Utiliser pour cela la procédure ci-dessous :
*/

PROCEDURE export_the_template IS
   the_temp   OG_Template;
BEGIN
   the_temp:=OG_Get_Template('Modèle0');
   OG_Export_Template('Mon_mod', OG_Filesystem, the_temp);
END


OG_Get_Axis

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un identificateur d'un axe du modèle de graphique.

Syntaxe

FUNCTION OG_Get_Axis
  (ident_modèle  OG_Template,
   axe           NUMBER)
RETURN OG_Axis;

Paramètres

ident_modèle	Identificateur du modèle de graphique contenant l'axe dont vous voulez retourner l'identificateur.
Axe	Axe à retourner. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_X_Axis    OG_Y1_Axis    OG_Y2_Axis
Retourne  Un identificateur de l'axe indiqué. Si la procédure bouton indiquée n'existe pas, cette procédure retourne un identificateur NULL.


OG_Get_Axis - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne un identificateur de l'axe X du modèle indiqué :
*/

FUNCTION example(template_name VARCHAR2) RETURN OG_Axis IS
  template  OG_Template;
  axis      OG_Axis;
BEGIN
  template := OG_Get_Template(Template_Name);
  axis := OG_Get_Axis(Template, OG_X_Axis);
  RETURN(axis);
END;


OG_Get_Ftemp

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un identificateur d'un modèle de champ d'un modèle de graphique.

Syntaxe

FUNCTION OG_Get_Ftemp
  (ident_modèle  OG_Template,
   index         NUMBER)
RETURN OG_Ftemp;

Paramètres

ident_modèle	Identificateur du modèle de graphique contenant le modèle de champ à retourner.
index	Index du modèle de champ de la liste des modèles de champ du graphique à retourner.

Retourne  Les attributs du modèle de champ indiqué.


OG_Get_Ftemp - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne l'identificateur du
**premier modèle de champ du modèle de graphique indiqué :
*/

FUNCTION example(temp_name VARCHAR2) RETURN OG_Ftemp IS
  template  OG_Template;
  ftemp     OG_Ftemp;
BEGIN
  template := OG_Get_Template(Temp_Name);
  ftemp := OG_Get_Ftemp(Template, 0);
  RETURN(ftemp);
END;


OG_Get_Refline

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un identificateur d'une ligne de référence d'un modèle de graphique :

Syntaxe

FUNCTION OG_Get_Refline
  (ident_modèle  OG_Template,
   index         NUMBER)
RETURN OG_Refline;

Paramètres

ident_modèle	Identificateur du modèle de graphique contenant la ligne de référence à retourner.
index	Index de la ligne de référence de la liste des lignes de référence du graphique à retourner.

Retourne  Un identificateur de la ligne de référence indiquée.


OG_Get_Refline - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous retourne un identificateur de la
**première ligne de référence du modèle de graphique indiqué :
*/

FUNCTION example(temp_name VARCHAR2) RETURN OG_Refline IS
  template  OG_Template;
  refline   OG_Refline;
BEGIN
  template := OG_Get_Template(Temp_Name);
  refline := OG_Get_Refline(Template, 0);
  RETURN(refline);
END;


OG_Get_Template

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un identificateur du modèle indiqué.

Syntaxe

FUNCTION OG_Get_Template
  (nom_modèle  VARCHAR2)
RETURN OG_Template;

Paramètres

nom_modèle	Nom du modèle de graphique dont l'identificateur doit être retourné.

Retourne  Un identificateur du modèle de graphique indiqué. Si le modèle n'existe pas, cette fonction retourne un identificateur NULL.


OG_Get_Template - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour créer un graphique par programme, affecter des valeurs d'attributs (et notamment un modèle) à un enregistrement d'attribut combiné de graphiques, puis transmettre cet enregistrement à OG_Make.
*/

PROCEDURE create_emp_chart IS
   chart_rec      OG_Chart_Ca;
   the_template   OG_Template;
   the_query      OG_Query;
   the_chart      OG_Object;
BEGIN
   the_template:=OG_Get_Template('Modèle_Emp');
   the_query:=OG_Get_Query('Interro_Emp');
   chart_rec.chart_caoc.template:=the_template;
   chart_rec.chart_caoc.query:=the_query;
   chart_rec.chart_caob.mask:=OG_None_Generica;
   chart_rec.chart_caog.mask:=OG_None_Groupa;
   chart_rec.chart_caoc.mask:=OG_Template_Charta+
                              OG_Query_Charta;
   the_chart:=OG_Make(Chart_Rec);

END;


OG_Import_Template

  Exemples	  Rubriques connexes

Description  Cette procédure importe un modèle de graphique.

Syntaxe

FUNCTION OG_Import_Template
  (nom           VARCHAR2,
   gisement      NUMBER,
   nom_modèle    VARCHAR2)
RETURN OG_Template;

Paramètres

nom	Nom du modèle stocké. Si le modèle est stocké dans la base de données, cet argument doit contenir uniquement le nom du modèle. Si le modèle est stocké dans le système de fichiers, cet argument doit contenir le nom de chemin d'accès absolu ou relatif au fichier de modèles.
gisement	Indique si le modèle est stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être une des constantes intégrées suivantes :  OG_Db   Indique que le modèle est stocké dans la base de données. OG_Filesystem Indique que le modèle est stocké dans le système de fichiers.
nom_modèle	Nom que Graphics Builder doit attribuer au modèle. S'il existe déjà un modèle de ce nom, Graphics Builder le remplace par le modèle importé.

Retourne  Un identificateur du modèle importé.


OG_Import_Template - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour importer le fichier de modèles de graphique 'Mon_mod'
**dans un affichage, sous le nom 'Modèle0',
**utiliser la procédure ci-dessous :
*/

PROCEDURE import_the_template IS
   the_temp   OG_Template;
BEGIN
   the_temp:=OG_Import_Template('Mon_mod', OG_Filesystem,
'modèle0');
END;


OG_Insert_Ftemp

  Exemples	  Rubriques connexes

Description  Cette procédure insère un nouveau modèle de champ dans le modèle de graphique indiqué.

Syntaxe

PROCEDURE OG_Insert_Ftemp                    graphique secteur/table
  (ident_modèle  OG_Template,
   attr          OG_Ftemp_Attr,
   index         NUMBER);

PROCEDURE OG_Insert_Ftemp                    graphique axe
  (template_hdl  OG_Template,
   attr          OG_Axisftemp_Ca,
   indx          NUMBER);

Paramètres

ident_modèle	Identificateur du modèle de graphique.
attr	Enregistrement contenant les attributs du modèle de champ.
index	Index auquel le nouveau modèle de champ doit être inséré dans la liste des modèles de champ du modèle de graphique. Cet argument doit être un entier compris entre 0 et n (inclus), où n est le nombre de modèles de champ du modèle de graphique, avant l'insertion. La valeur de cet argument peut également être l'une des constantes intégrées suivantes : OG_First   Indique que le nouveau modèle de champ doit être inséré au début de la liste des modèles de champ du modèle de graphique (index = 0). OG_Last   Indique que le nouveau modèle de champ doit être inséré à la fin de la liste des modèles de champ du modèle de graphique (index = nombre de modèles de champ du modèle de graphique avant l'insertion).


OG_Insert_Ftemp - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous insère un nouveau modèle de champ
**dans le modèle de graphique indiqué.
*/

PROCEDURE example(template OG_Template) IS
  attr  OG_Axisftemp_Ca;
BEGIN
  attr.ca_aftemp.plottype := OG_Bar_Plottype;
  attr.ca_ftemp.name := 'colonne';
  attr.ca_aftemp.mask:= OG_Plottype_Axisftempa;
  attr.ca_ftemp.mask := OG_Name_Ftempa;

  OG_Insert_Ftemp(Template, attr, 0);
END;


OG_Insert_Refline

  Exemples	  Rubriques connexes

Description  Cette procédure insère une nouvelle ligne de référence dans le modèle de graphique indiqué.

Syntaxe

PROCEDURE OG_Insert_Refline
  (ident_modèle  OG_Template,
   attr          OG_Refline_Attr,
   index         NUMBER);

Paramètres

ident_modèle	Identificateur du modèle de graphique.
attr	Enregistrement contenant les attributs de la ligne de référence.
index	Index auquel la nouvelle ligne de référence doit être insérée dans la liste des lignes de référence du modèle de graphique. Cet argument doit être un entier compris entre 0 et n (inclus), où n est le nombre de lignes de référence du modèle de graphique, avant l'insertion. La valeur de cet argument peut également être une des constantes intégrées suivantes : OG_First   Indique que la nouvelle ligne de référence doit être insérée au début de la liste des lignes de référence du modèle de graphique (index = 0). OG_Last   Indique que la nouvelle ligne de référence doit être insérée à la fin de la liste des lignes de référence du modèle de graphique (index = nombre de lignes de référence du modèle de graphique avant l'insertion).


OG_Insert_Refline - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous insère une nouvelle ligne de
**référence dans le modèle de graphique indiqué.
*/

PROCEDURE example(template OG_Template) IS
  attr  OG_Refline_Attr;
BEGIN
  attr.numvalue := 1000;
  attr.label := 'Moyenne';
  attr.mask:= OG_Value_Reflinea+
              OG_Label_Reflinea;

  OG_Insert_Refline(Template, attr, 0);
END;


OG_Make_Template

  Exemples	  Rubriques connexes

Description  Cette fonction crée un modèle de graphique.

Syntaxe

FUNCTION OG_Make_Template
  (nom             VARCHAR2,
   type_graphique  NUMBER
RETURN OG_Template;

Paramètres

nom	Nom du modèle.
type_graphique	Type de graphique du modèle. Cette valeur peut être l'une des constantes intégrées suivantes : OG_Column OG_Column_Stacked OG_Column_Overlap OG_Column_Pct OG_Column_Zero OG_Column_Shadow OG_Column_3d OG_Column_Line OG_Bar OG_Bar_Stacked OG_Bar_Overlap OG_Bar_Pct OG_Bar_Zero OG_Bar_Shadow OG_Bar_3d OG_Bar_Line OG_Line OG_Line_Symbol OG_Line_Stacked OG_Line_Fill OG_Step OG_Step_Symbol OG_Step_Stacked OG_Step_Fill OG_Spline OG_Spline_Symbol OG_Spline_Stacked OG_Spline_Fill OG_Mixed_Line OG_Mixed_Fill OG_Mixed_Spline OG_Mixed_Spfill OG_Doubley_Column OG_Doubley_Overlap OG_Doubley_Line OG_Doubley_Symbol OG_Highlow_Symbol OG_Highlow_Spike OG_Highlow_Both OG_Highlow_Line OG_Highlow_Fill OG_Scatter_Symbol OG_Scatter_Curvefit OG_Scatter_Linear OG_Scatter_Log OG_Scatter_Loglog OG_Scatter_Connect OG_Gantt OG_Gantt_Shadow OG_Gantt_Depth OG_Pie OG_Pie_Shadow OG_Pie_Depth OG_Table OG_Table_Shadow OG_Table_Depth
Retourne  Un identificateur du modèle nouvellement créé.


OG_Make_Template - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous crée un modèle de graphique en colonne
**avec des ombres sur les barres :
*/

FUNCTION example RETURN OG_Template IS
  template  OG_Template;
BEGIN
  template := OG_Make_Template('Modèle0', OG_Column_Shadow);
  RETURN(template);
END;


 Procédures internes d'horloge

OG_Activate_Timer

OG_Deactivate_Timer

OG_Destroy (horloge)

OG_Get_Timer

OG_Make_Timer


OG_Activate_Timer

  Exemples	  Rubriques connexes

Description  Cette procédure active l'horloge indiquée.

Syntaxe

PROCEDURE OG_Activate_Timer
  (ident_horloge  OG_Timer);

Paramètres

ident_horloge	Identificateur de l'horloge à activer.

Notes d'utilisation  Notez que, par défaut, toutes les horloges sont activées lors de l'ouverture d'un affichage. Vous n'avez besoin d'activer une horloge que si vous l'avez explicitement désactivée en utilisant la procédure OG_Deactivate_Timer.


OG_Activate_Timer - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit des horloges destinées à mettre à jour la totalité des graphiques
**toutes les 30 secondes, les horloges des graphiques qui ne sont pas
**affichés ayant été désactivées. Pour réactiver l'horloge d'un graphique
**au moment où il est affiché :
*/

PROCEDURE activate_emp_timer IS
   my_timer   OG_Timer;
BEGIN
   my_timer:=OG_Get_Timer('Horloge_Emp');
   OG_Activate_Timer(My_Timer);
END;


OG_Deactivate_Timer

  Exemples	  Rubriques connexes

Description  Cette procédure désactive l'horloge indiquée.

Syntaxe

PROCEDURE OG_Deactivate_Timer
  (ident_horloge  OG_Timer);

Paramètres

ident_horloge	Identificateur de l'horloge à désactiver.

Notes d'utilisation  Notez que, lorsque vous ouvrez un affichage, toutes les horloges sont automatiquement activées. Si vous voulez qu'une horloge soit inactive, vous devez la désactiver explicitement en utilisant cette procédure. Il est souvent intéressant de désactiver les horloges dont vous n'avez pas besoin pour la partie d'affichage en cours d'utilisation, pour éviter que votre système perde du temps à traiter ces horloges.


OG_Deactivate_Timer - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit des horloges destinées à mettre à jour la totalité des graphiques
**toutes les 30 secondes, les horloges des
**graphiques qui ne sont pas affichés ayant été désactivées.
*/

PROCEDURE deactivate_emp_timer IS
   my_timer   OG_Timer;
BEGIN
   my_timer:=OG_Get_Timer('Horloge_Emp');
   OG_Deactivate_Timer(My_Timer);
END;


OG_Destroy (horloge)

  Exemples	  Rubriques connexes

Description  Cette procédure détruit l'horloge indiquée..

Syntaxe

PROCEDURE OG_Destroy
  (ident_horloge  OG_Timer);

Paramètres

ident_horloge	Identificateur de l'horloge à détruire.


OG_Destroy (horloge) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous détruit l'horloge indiquée :
*/

PROCEDURE destroy_timer(timer_name VARCHAR2) IS
  timer  OG_Timer;
BEGIN
  timer := OG_Get_Timer(Timer_Name);
  OG_Destroy(Timer);
END;


OG_Get_Timer

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un identificateur de l'horloge indiquée.

Syntaxe

FUNCTION OG_Get_Timer
  (nom_horloge  VARCHAR2)
RETURN OG_Timer;

Paramètres

nom_horloge	Nom de l'horloge dont l'identificateur est retourné.

Retourne  Un identificateur de l'horloge indiquée. Si l'horloge n'existe pas, cette procédure retourne un identificateur NULL.


OG_Get_Timer - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit des horloges destinées à mettre à jour la totalité des graphiques
**toutes les 30 secondes, les horloges des graphiques qui ne sont pas
**affichés ayant été désactivées. Pour réactiver l'horloge d'un graphique
**au moment où il est affiché :
*/

PROCEDURE activate_emp_timer IS
   my_timer   OG_Timer;
BEGIN
   my_timer:=OG_Get_Timer('Horloge_Emp');
   OG_Activate_Timer(My_Timer);
END;


OG_Make_Timer

  Exemples	  Rubriques connexes

Description  Cette fonction crée une horloge.

Syntaxe

FUNCTION OG_Make_Timer
  (intervalle   OG_Point,
   prochorloge  VARCHAR2
RETURN OG_Timer;

Paramètres

intervalle	Indique (en secondes) l'intervalle d'activation de l'horloge.
prochorloge	Nom de la procédure à exécuter à l'intervalle prévu.

Retourne  Un identificateur de l'horloge nouvellement créée.


OG_Make_Timer - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous crée une horloge qui exécute
**la procédure 'proc_maj' toutes les 30 secondes.
*/

PROCEDURE example(timer_name VARCHAR2) IS
  timer  OG_Timer;
BEGIN
  timer := OG_Make_Timer(30, 'proc_maj');
  OG_Set_Name(Timer, timer_name);
END;


Procédures internes TOOLS_INT

Tool_Int.Add_Parameter

Tool_Int.Create_Parameter_List

Tool_Int.Delete_Parameter

Tool_Int.Destroy_Parameter_List

Tool_Int.Get_Parameter_Attr

Tool_Int.Get_Parameter_List

Tool_Int.Isnull

Tool_Int.Run_Product

Tool_Int.Set_Parameter_Attr


TOOL_INT.ADD_PARAMETER

  Exemples	  Rubriques connexes

Description  Cette procédure ajoute un paramètre à la liste des paramètres indiquée.

Syntaxe

PROCEDURE TOOL_INT.add_parameter
  (ident_list  TOOL_INT.PARAMLIST,
   nom_param   CHAR,
   attr        TOOL_INT.PARAM_ATTR);

PROCEDURE TOOL_INT.add_parameter
  (ident_list  TOOL_INT.PARAMLIST,
   nom_param   CHAR,
   attr        TOOL_INT.PARAM_ATTR);

PROCEDURE TOOL_INT.add_parameter
  (ident_list  TOOL_INT.PARAMLIST,
   nom_param   CHAR,
   type_param  NUMBER,
   valeur      CHAR);

Paramètres

ident_list	Identificateur de la liste de paramètres.
Nom_param	Nom du paramètre à ajouter.
attr	Enregistrement d'attribut de paramètre qui contient le type et la valeur du paramètre à ajouter.
type_param	Type du paramètre à ajouter. La valeur de cet argument peut être l'une des constantes intégrées suivantes : TOOL_INT.DATA_PARAMETER   Indique que le paramètre représente une correspondance d'interrogation d'un produit à l'autre. TOOL_INT.TEXT_PARAMETER   Indique que le paramètre est une valeur unique.
valeur	Valeur du paramètre à ajouter.

Notes d'utilisation  Vous pouvez soit fournir un enregistrement d'attribut de paramètre qui contient le type et la valeur du paramètre, soit indiquer le type et la valeur directement dans cet appel de procédure.


Tool_Int.Add_Parameter - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous crée une liste de paramètres,
**et y ajoute plusieurs paramètres :
*/

PROCEDURE create_plist IS
  the_list  tool_int.paramlist;
BEGIN
  the_list:=tool_int.create_parameter_list('ma_listep');
  tool_int.add_parameter(the_list, 'idutilisateur',
    TOOL_INT.TEXT_PARAMETER, 'scott/tiger');
  tool_int.add_parameter(the_list, 'destype',
    TOOL_INT.TEXT_PARAMETER, 'imprimante');
  tool_int.add_parameter(the_list, 'exemplaires',
    TOOL_INT.TEXT_PARAMETER, '2');
  tool_int.add_parameter(the_list, 'mon_param',
    TOOL_INT.TEXT_PARAMETER, '67');
  tool_int.add_parameter(the_list, 'Q_1',
    TOOL_INT.DATA_PARAMETER, 'interro0');
END;


TOOL_INT.CREATE_PARAMETER_LIST

  Exemples	  Rubriques connexes

Description  Cette fonction crée une nouvelle liste de paramètres à laquelle elle donne le nom indiqué.

Syntaxe

FUNCTION TOOL_INT.create_parameter_list
  (nom  CHAR)
RETURN TOOL_INT.PARAMLIST;

Paramètres

nom	Nom de la liste de paramètres à créer.

Retourne  Un identificateur à la liste de paramètres nouvellement créée.


Tool_Int.Create_Parameter_List - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous crée une liste de paramètres
**et y ajoute plusieurs paramètres :
*/

PROCEDURE create_plist IS
  the_list  tool_int.paramlist;
BEGIN
  the_list:=tool_int.create_parameter_list('ma_listep');
  tool_int.add_parameter(the_list, 'idutilisateur',
    TOOL_INT.TEXT_PARAMETER, 'scott/tiger');
  tool_int.add_parameter(the_list, 'destype',
    TOOL_INT.TEXT_PARAMETER, 'imprimante');
  tool_int.add_parameter(the_list, 'exemplaires',
    TOOL_INT.TEXT_PARAMETER, '2');
  tool_int.add_parameter(the_list, 'mon_param',
    TOOL_INT.TEXT_PARAMETER, '67');
  tool_int.add_parameter(the_list, 'Q_1',
    TOOL_INT.DATA_PARAMETER, 'interro0');
END;


TOOL_INT.DELETE_PARAMETER

  Exemples	  Rubriques connexes

Description  Cette procédure supprime le paramètre indiqué de la liste des paramètres indiquée.

Syntaxe

PROCEDURE TOOL_INT.delete_parameter
  (ident_liste    TOOL_INT.PARAMLIST,
   nom_param  CHAR);

Paramètres

ident_liste	Identificateur de la liste de paramètres dont vous voulez supprimer le paramètre.
nom_param	Nom du paramètre à supprimer.


Tool_Int.Delete_Parameter - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous supprime de la liste le paramètre 'nomutilisateur' d'une liste de paramètres :
*/

PROCEDURE example IS
  list  tool_int.paramlist;
BEGIN
  list := tool_int.get_parameter_list('liste0');
  tool_int.delete_parameter(list, 'nomutilisateur');
END;


TOOL_INT.DESTROY_PARAMETER_LIST

  Exemples	  Rubriques connexes

Description  Cette procédure détruit la liste de paramètres indiquée.

Syntaxe

PROCEDURE TOOL_INT.destroy_parameter_list
  (ident_liste  TOOL_INT.PARAMLIST);

Paramètres

ident_liste	Identificateur de la liste de paramètres à détruire.


Tool_Int.Destroy_Parameter_List - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous crée une liste de paramètres
**en commençant par détruire une liste existante (le cas échéant) :
*/

PROCEDURE example IS
  list  tool_int.paramlist;
BEGIN
  list := tool_int.get_parameter_list('liste0');

  IF NOT tool_int.isnull(list) THEN
    tool_int.destroy_parameter_list(list);
  END IF;

  list := tool_int.create_parameter_list('liste0');
END;


TOOL_INT.GET_PARAMETER_ATTR

  Exemples	  Rubriques connexes

Description  Cette procédure extrait les attributs du paramètre indiqué, dans la liste de paramètres indiquée.

Syntaxe

PROCEDURE TOOL_INT.get_parameter_attr
  (ident_liste TOOL_INT.PARAMLIST,
   nom_param   CHAR,
   attr        TOOL_INT.PARAM_ATTR);

PROCEDURE TOOL_INT.get_parameter_attr
  (ident_liste TOOL_INT.PARAMLIST,
   nom_param   CHAR,
   type_param  NUMBER,
   valeur      CHAR);

Paramètres

ident_liste	Identificateur de la liste de paramètres de laquelle vous voulez extraire le paramètre.
nom_param	Nom du paramètre à extraire.
attr	Enregistrement d'attribut à définir aux attributs du paramètre.
type_param	Variable que cette procédure, lors de son appel, définira au type de paramètre. La valeur de cet argument peut être l'une des constantes intégrées suivantes : TOOL_INT.DATA_PARAMETER   Indique que le paramètre représente une correspondance d'une interrogation d'un produit à l'autre. TOOL_INT.TEXT_PARAMETER   Indique que le paramètre est une valeur unique.
valeur	Variable que cette procédure, lors de son appel, définira à la valeur du paramètre.

Notes d'utilisation  Vous pouvez soit fournir un enregistrement d'attribut de paramètre que chaque procédure définira aux attributs du paramètre, soit fournir des variables distinctes qui seront définies.


Tool_Int.Get_Parameter_Attr - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous extrait la valeur du paramètre 'priorité',
**et augmente sa valeur de 1:
*/

PROCEDURE example IS
  list    tool_int.paramlist;
  ptype   NUMBER;
  pvalue  VARCHAR2;
BEGIN
  list := tool_int.get_parameter_list('liste0');
  tool_int.get_parameter_attr(list, 'priorité', ptype,
    pvalue);

  pvalue := to_char(to_number(pvalue) + 1);

  tool_int.set_parameter_attr(list, 'priorité',
    tool_int.TEXT_PARAMETER, pvalue);

END;


TOOL_INT.GET_PARAMETER_LIST

  Exemples	  Rubriques connexes

Description  Cette fonction retourne l'identificateur de la liste de paramètres ayant le nom indiqué.

Syntaxe

FUNCTION TOOL_INT.get_parameter_list
  (nom_liste  CHAR)
RETURN TOOL_INT.paramlist;

Paramètres

nom_liste	Nom de la liste de paramètres à extraire.

Retourne  Un identificateur de la liste de paramètres nommée.


Tool_Int.Get_Parameter_List - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous crée une liste de paramètres
**en commençant par détruire la liste existante (le cas échéant) :
*/

PROCEDURE example IS
  list  tool_int.paramlist;
BEGIN
  list := tool_int.get_parameter_list('liste0');

  IF NOT tool_int.isnull(list) THEN
    tool_int.destroy_parameter_list(list);
  END IF;

  list := tool_int.create_parameter_list('liste0');
END;


TOOL_INT.ISNULL

  Exemples	  Rubriques connexes

Description  Cette fonction détermine si l'identificateur de liste de paramètres indiquée est un identificateur NULL.

Syntaxe

FUNCTION TOOL_INT.isnull
  (ident_liste  TOOL_INT.PARAMLIST)
RETURN BOOLEAN;

Paramètres

ident_liste	Identificateur à évaluer.
Retourne TRUE	Si l'identificateur est NULL.
FALSE	Si l'identificateur n'est pas NULL

Notes d'utilisation  TOOL_INT.GET_PARAMETER_LIST retourne un identificateur NULL si la liste de paramètres qu'elle tente d'extraire n'existe pas.


Tool_Int.Isnull - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous crée une liste de paramètres
**en commençant par détruire la liste existante (le cas échéant) :
*/

PROCEDURE example IS
  list  tool_int.paramlist;
BEGIN
  list := tool_int.get_parameter_list('liste0');

  IF NOT tool_int.isnull(list) THEN
    tool_int.destroy_parameter_list(list);
  END IF;

  list := tool_int.create_parameter_list('liste0');
END;


TOOL_INT.RUN_PRODUCT

  Exemples	  Rubriques connexes

Description  Cette procédure appelle un autre produit pris en charge par Oracle.

Syntaxe

PROCEDURE TOOL_INT.run_product
  (produit     NUMBER,
   module      CHAR,
   mode_comm   NUMBER,
   mode_exec   NUMBER,
   gisement    NUMBER,
   ident_liste TOOL_INT.PARAMLIST);

PROCEDURE TOOL_INT.run_product
  (produit     NUMBER,
   module      CHAR,
   mode_comm   NUMBER,
   mode_exec   NUMBER,
   gisement    NUMBER,
   nom_liste   CHAR);

Paramètres

produit	Produit Oracle qui sera appelé. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  TOOL_INT.BOOK   Indique l'appel à Oracle Book. TOOL_INT.FORMS   Indique l'appel à Forms. TOOL_INT.REPORTS   Indique l'appel à Reports.
module	Nom du module à exécuter par le produit appelé. Si le module est stocké dans la base de données, cet argument doit contenir uniquement le nom du module. Si le module est stocké dans le système de fichiers, cet argument doit contenir le nom du chemin d'accès absolu ou relatif du fichier du module.
mode_comm	Mode de communication dans lequel le produit sera appelé. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  TOOL_INT.SYNCHRONOUS   Indique que le produit est appelé en mode synchrone. TOOL_INT.ASYNCHRONOUS   Indique que le produit est appelé en mode asynchrone.
mode_exec	Indique le mode d'exécution du produit appelé. La valeur de cet argument peut être l'une des constantes intégrées suivantes : TOOL_INT.BATCH   Indique que le produit est appelé en mode Batch. TOOL_INT.RUNTIME   Indique que le produit est appelé en mode Runtime.
gisement	Indique si le module est stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes :   TOOL_INT.DB   Indique que le module est stocké dans la base de données. TOOL_INT.FILESYSTEM   Indique que le module est stocké dans le système de fichiers.
ident_liste	Identificateur de la liste de paramètres à transmettre au produit appelé.
nom_liste	Nom de la liste de paramètres à transmettre au produit appelé.

Notes d'utilisation  Pour plus d'informations, reportez-vous à la documentation sur vos produits Oracle.


Tool_Int.Run_Product - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous ouvre le document Oracle Book appelé
**`catalogue' et saute à la cible hypertexte sailboard:
*/

PROCEDURE call_book is
  list  tool_int.paramlist;
BEGIN
  list:=tool_int.create_parameter_list('listep');

  tool_int.add_parameter(list, 'cible',
    tool_int.TEXT_PARAMETER, 'sailboard');

  tool_int.RUN_PRODUCT(tool_int.BOOK, 'catalogue',
    tool_int.ASYNCHRONOUS, tool_int.RUNTIME,
    tool_int.FILESYSTEM, list);

END;


TOOL_INT.SET_PARAMETER_ATTR

  Exemples	  Rubriques connexes

Description  Cette procédure définit les attributs du paramètre indiqué dans la liste de paramètres indiquée.

Syntaxe

PROCEDURE TOOL_INT.set_parameter_attr
  (ident_liste TOOL_INT.PARAMLIST,
   nom_param   CHAR,
   attr        TOOL_INT.PARAM_ATTR);

PROCEDURE TOOL_INT.set_parameter_attr
  (ident_liste TOOL_INT.PARAMLIST,
   nom_param   CHAR,
   type_param  NUMBER,
   valeur      CHAR);

Paramètres

ident_liste	Identificateur de la liste de paramètres qui contient le paramètre.
nom_param	Nom du paramètre à définir.
attr	Enregistrement d'attribut qui contient les attributs du paramètre à définir.
type_param	Type auquel le paramètre doit être défini. La valeur de cet argument peut être l'une des constantes intégrées suivantes : TOOL_INT.DATA_PARAMETER Indique que le paramètre représente une correspondance d'interrogation d'un produit à l'autre. TOOL_INT.TEXT_PARAMETER   Indique que le paramètre est une valeur unique.
valeur	Valeur à laquelle définir le paramètre.

Notes d'utilisation Vous pouvez soit fournir un enregistrement d'attribut de paramètre que cette procédure utilisera pour définir les attributs du paramètre, soit fournir des variables distinctes contenant les attributs à définir.


Tool_Int.Set_Parameter_Attr - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous extrait la valeur du paramètre 'priorité'
**et augmente sa valeur de 1 :
*/

PROCEDURE example IS
  list    tool_int.paramlist;
  ptype   NUMBER;
  pvalue  VARCHAR2;
BEGIN
  list := tool_int.get_parameter_list('liste0');
  tool_int.get_parameter_attr(list, 'priorité', ptype,
    pvalue);

  pvalue := to_char(to_number(pvalue) + 1);

  tool_int.set_parameter_attr(list, 'priorité',
    tool_int.TEXT_PARAMETER, pvalue);

END;


Procédures internes de fenêtre

OG_Destroy (fenêtre)

OG_Get_Window

OG_Hide_Window

OG_Make_Window

OG_Show_Window


OG_Destroy (fenêtre)

  Exemples	  Rubriques connexes

Description  Cette procédure détruit la fenêtre indiquée, ce qui ferme la fenêtre, mais ne modifie pas son contenu.

Syntaxe

PROCEDURE OG_Destroy
  (ident_fenêtre  OG_Window);

Paramètres

ident_fenêtre	Identificateur de la fenêtre à détruire.


OG_Destroy (fenêtre) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Un utilisateur clique sur un pays d'une carte du monde :
**l'application crée une nouvelle fenêtre dans laquelle seront affichées
**des informations sur les ventes dans ce pays. Lorsque l'utilisateur sélectionne
**un autre pays, l'ancienne fenêtre doit être détruite et une nouvelle
**fenêtre, contenant des informations sur le nouveau pays, doit être créée.
*/

PROCEDURE destroy_USA IS
   the_window   OG_Window;
BEGIN
   the_window:=OG_Get_Window('Fenêtre_Usa');
   OG_Destroy(The_Window);
END;


OG_Get_Window

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un identificateur de la fenêtre indiquée.

Syntaxe

FUNCTION OG_Get_Window
  (nom_fenêtre  VARCHAR2)
RETURN OG_Window;

Paramètres

nom_fenêtre	Nom de la fenêtre dont l'identificateur doit être retourné.

Retourne  Un identificateur de la fenêtre indiquée. Si la fenêtre n'existe pas, cette fonction retourne un identificateur NULL.

Notes d'utilisation  La fenêtre peut être la fenêtre principale de l'affichage (appelée "Présentation principale") ou une fenêtre créée par programme.


OG_Get_Window - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La fenêtre principale, qui était masquée précédemment, contient des
**informations à visualiser maintenant. La procédure ci-dessous affiche ces informations :
*/

PROCEDURE show_main_window IS
   the_main_window   OG_Window;
BEGIN
   the_main_window:=OG_Get_Window('Présentation principale');
   OG_Show_Window(The_Main_Window);
END;


OG_Hide_Window

  Exemples	  Rubriques connexes

Description  Cette procédure masque la fenêtre indiquée.

Syntaxe

PROCEDURE OG_Hide_Window
  (ident_fenêtre  OG_Window);

Paramètres

ident_fenêtre	Identificateur de la fenêtre qui doit être masquée.

Notes d'utilisations  Notez que la fenêtre ne sera pas détruite. Vous pouvez donc masquer la fenêtre lorsque son contenu ne vous intéresse pas, puis l'afficher à nouveau lorsqu'il vous intéresse.


OG_Hide_Window - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La fenêtre de présentation principale contient un graphique dont
**l'utilisateur n'a plus besoin. La procédure ci-dessous permet de la masquer
**momentanément. N'oubliez pas que cette procédure ne détruit pas la fenêtre,
**qui continue à exister et peut être réaffichée en cas de besoin.
*/

PROCEDURE hide_main_window IS
   the_main_window   OG_Window;
BEGIN
   the_main_window:=OG_Get_Window('Présentation principale');
   OG_Hide_Window(The_Main_Window);
END;


OG_Make_Window

  Exemples	  Rubriques connexes

Description  Cette fonction crée une fenêtre.

Syntaxe

FUNCTION OG_Make_Window
  (position  OG_Point,
   hauteur    NUMBER,
   largeur     NUMBER)
RETURN OG_Window;

Paramètres

position	Coordonnées x et y de l'angle supérieur gauche de la fenêtre (en unités de résolution d'écran).
hauteur	Hauteur de la fenêtre (en unités de résolution d'écran).
largeur	Largeur de la fenêtre (en unités de résolution d'écran).

Retourne  Un identificateur de la fenêtre nouvellement créée.


OG_Make_Window - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous crée une fenêtre de 5"x4"
**dans l'angle supérieur gauche de l'écran :
*/

FUNCTION example(window_name VARCHAR2) RETURN OG_Window IS
  window    OG_Window;
  pos       OG_Point;
  height    NUMBER;
  width     NUMBER;
BEGIN
  pos.x   := 0;
  pos.y   := 0;
  largeur := 5 * OG_Get_Ap_Hscreen_Res;
  hauteur := 4 * OG_Get_Ap_Vscreen_Res;

  window := OG_Make_Window(Pos, height, width);
  OG_Set_Name(Window, window_name);
  RETURN(window);
END;


OG_Show_Window

  Exemples	  Rubriques connexes

Description  Cette procédure affiche la fenêtre indiquée.

Syntaxe

PROCEDURE OG_Show_Window
  (ident_fenêtre  OG_Window);

Paramètres

ident_fenêtre	Identificateur de la fenêtre à afficher.


OG_Show_Window - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fenêtre principale, qui était masquée précédemment, contient des
** informations à visualiser maintenant.
** La procédure ci-dessous affiche ces informations :
*/

PROCEDURE show_main_window IS
   the_main_window   OG_Window;
BEGIN
   the_main_window:=OG_Get_Window('Présentation principale');
   OG_Show_Window(The_Main_Window);
END;


Procédures internes d'objet graphique

OG_Clone (objet)

OG_Damage (objet)

OG_Delete_Child

OG_Delete_Cmptext

OG_Delete_Point

OG_Delete_Property

OG_Delete_Smptext

OG_Destroy (objet)

OG_Draw

OG_Export_Drawing (affichage)

OG_Export_Drawing (objet/couche)

OG_Export_Drawing (fenêtre)

OG_Export_Image

OG_Get_Char_Property

OG_Get_Child

OG_Get_Cmptext

OG_Get_Date_Property

OG_Get_Num_Property

OG_Get_Object

OG_Get_Point

OG_Get_Smptext

OG_Import_Drawing

OG_Import_Image

OG_Insert_Child

OG_Insert_Cmptext

OG_Insert_Point

OG_Insert_Smptext

OG_Make_Ellipse

OG_Make_Group

OG_Make_Image

OG_Make_Line

OG_Make_Poly

OG_Make_Rect

OG_Make_Rrect

OG_Make_Symbol

OG_Make_Text

OG_Move

OG_Point_In

OG_Point_Near

OG_Property_Exists

OG_Rotate

OG_Same

OG_Scale

OG_Set_Edgecolor

OG_Set_Fillcolor

OG_Set_Property

OG_Synchronize

OG_Update_Bbox


OG_Clone (objet)

  Exemples	  Rubriques connexes

Description  Cette fonction crée un nouvel objet identique à l'objet indiqué.

Syntaxe

FUNCTION OG_Clone
  (ident_objet   OG_Object,
   dommage       BOOLEAN    :=  TRUE,
   boîte_maj     BOOLEAN    :=  TRUE)
RETURN OG_Object;

Paramètres

ident_objet	Identificateur de l'objet à cloner.
dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Retourne  L'identificateur de l'objet nouvellement créé.


OG_Clone (objet) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour créer un objet, puis en créer un autre,
**identique, sans avoir à indiquer
**à nouveau les mêmes propriétés.
*/

PROCEDURE dup_object(old_object IN OG_Object) IS
   new_object   OG_Object;
BEGIN
   new_object:=OG_Clone(Old_Object);
END;


OG_Damage (objet)

  Exemples	  Rubriques connexes

Description  Cette procédure endommage un objet de la présentation.

Syntaxe

PROCEDURE OG_Damage
  (ident_objet  OG_Object);

Paramètres

ident_objet	Identificateur de l'objet à endommager.


OG_Damage (objet) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Soit un objet à déplacer. Par défaut, la procédure
**interne OG_Move met à jour des boîtes englobantes de tous les
**antécédents de l'objet modifié, y compris de la couche sur laquelle réside l'objet.
**Pour mettre à jour les boîtes englobantes d'une couche, Graphics Builder doit examiner chacun des objets situés
**sur cette couche. Si la couche contient un grand nombre d'objets,
**cette opération peut être très longue.
*/

 /*Pour rendre l'application plus efficace, il est possible de déplacer l'objet
**tout en bloquant cette mise à jour automatique de boîte englobante,
**puis ne mettre à jour explicitement que les boîtes englobantes de cet objet. (Il faut noter que,
**comme les boîtes englobantes ne sont pas automatiquement mises à jour, les boîtes englobantes
**des antécédents de l'objet ne peuvent pas être précises).
*/

 /*Lors de la modification d'un objet avec un indicateur de mise à jour de boîte englobante FALSE,
**il peut être souhaitable également d'utiliser un indicateur de dommage FALSE. Dans ce cas,
**une fois l'objet modifié, un appel à
**OG_Damage va endommager explicitement l'objet.
*/

PROCEDURE move_efficiently (the_object OG_Object) IS
   offset   OG_Point;
BEGIN
   offset.x:=OG_Inch;
   offset.y:=OG_Inch;
   OG_Move(The_Object, offset, FALSE, FALSE)
   OG_Update_Bbox(The_Object, OG_Bothbbox);
   OG_Damage(The_Object);
END;


OG_Delete_Child

  Exemples	  Rubriques connexes

Description  Cette procédure supprime un ou plusieurs objets fils de l'objet de groupe indiqué.

Syntaxe

PROCEDURE OG_Delete_Child
  (ident_groupe   OG_Object,
   index          NUMBER,
   total          NUMBER,
   dommage        BOOLEAN    :=  TRUE,
   boîte_maj      BOOLEAN    :=  TRUE);

Paramètres

ident_groupe	Identificateur de l'objet de groupe.
index	Index du premier objet à supprimer de la liste des fils du groupe.
total	Nombre total d'objets fils à supprimer.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Lorsque vous supprimez un fils, l'objet n'est plus associé à son groupe père, mais n'est pas détruit. L'attribut père de l'enregistrement d'attribut générique du fils supprimé sera défini par un identificateur NULL, et le fils n'existera plus dans la liste des objets de groupe. Notez qu'un objet qui a un identificateur NULL pour un parent ne sera pas affiché dans la présentation.

Vous pouvez supprimer une couche en traitant l'objet racine de l'affichage comme un groupe, et en le transmettant, ainsi que l'index de couche, à cette procédure.


OG_Delete_Child - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Soit plusieurs objets représentant des produits stockés
**en entrepôt, dont l'un doit être transféré
**d'un entrepôt à l'autre. L'affichage peut utiliser un groupe
**composé des produits représentant le stock de chaque
**entrepôt. Pour transférer un produit d'un entrepôt à l'autre,
**rechercher l'identificateur de l'objet produit,
**le supprimer d'un groupe d'entrepôts et l'ajouter à un autre
**groupe d'entrepôts.
*/

 /*Il faut noter que cette procédure ne modifie que la composition interne
**des objets de groupe. Pour déplacer ou modifier l'aspect de
**l'objet produit, utiliser d'autres procédures internes de Graphics Builder.
*/

PROCEDURE move_prod(warehouse1 IN OG_Object, warehouse2 IN
OG_Object, prod_index IN number) IS
   the_prod   OG_Object;
BEGIN
   the_prod:=OG_Get_Child(Warehouse1, prod_index);
   OG_Delete_Child(Warehouse1, prod_index, 1);
   OG_Insert_Child(Warehouse2, the_prod, OG_Last);
END;


OG_Delete_Cmptext

  Exemples	  Rubriques connexes

Description  Cette procédure supprime un ou plusieurs éléments texte composé de l'objet texte indiqué. Comme décrit dans "Attributs de texte", un élément texte composé représente une ligne de texte d'un objet texte.

Syntaxe

PROCEDURE OG_Delete_Cmptext
  (ident_texte   OG_Object,
   index         NUMBER,
   total         NUMBER,
   dommage       BOOLEAN    :=  TRUE,
   boîte_maj     BOOLEAN    :=  TRUE);

Paramètres

ident_texte	Identificateur de l'objet texte.
index	Index, dans l'objet texte, du premier élément texte composé à supprimer de la liste des éléments texte composé.
total	Nombre total d'éléments texte composé à supprimer.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Lorsque vous supprimez un élément texte composé, cet élément et tous les éléments texte simple qui le composent sont détruits.


OG_Delete_Cmptext - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Soit un objet texte utilisé pour afficher des messages destinés à l'utilisateur.
**Une précédente section de l'application a généré des messages en deux lignes,
**mais la partie d'affichage actuellement utilisée n'affiche que des messages
**en une ligne. Pour supprimer l'élément
**texte excédentaire :
*/

PROCEDURE delete_msg_line(msg_object IN OG_Object,
line_index IN number) IS
BEGIN
   OG_Delete_Cmptext(Msg_Object, line_index, 1);
END;


OG_Delete_Point

  Exemples	  Rubriques connexes

Description  Cette procédure supprime un ou plusieurs points de l'objet polygone ou de l'objet ligne polygonale indiqués.

Syntaxe

PROCEDURE OG_Delete_Point
  (ident_poly   OG_Object,
   index        NUMBER,
   total        NUMBER,
   dommage      BOOLEAN    :=  TRUE,
   boîte_maj    BOOLEAN    :=  TRUE);

Paramètres

poly_hdl	Identificateur de l'objet polygone ou de l'objet ligne polygonale.
index	Index du premier point à supprimer de la liste des points.
total	Nombre total de points à supprimer.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Si l'objet a été créé dans Builder, les valeurs initiales d'index des points correspondront à l'ordre dans lequel l'utilisateur a cliqué sur la souris lorsque l'objet a été dessiné (le premier point ayant l'index 0). Les valeurs d'index des points qui ont été insérés par programme dépendront de l'index qui a été indiqué lors de leur insertion.


OG_Delete_Point - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/*Une carte comporte plusieurs polygones, chacun d'entre eux
**reliant les villes situées sur un itinéraire de distribution spécifique.
**Si une ville passe d'un itinéraire de distribution à l'autre,
**le point la représentant doit être supprimé d'un
**polygone et ajouté à l'autre.
*/

PROCEDURE move_city(route1 IN OG_Object, route2 IN
OG_Object, city_index IN number) IS
   the_city   OG_Point;
BEGIN
   the_city:=OG_Get_Point(Route1, city_index);
   OG_Delete_Point(Route1, city_index, 1);
   OG_Insert_Point(Route2, OG_Last, the_city);
END;


OG_Delete_Property

  Exemples	  Rubriques connexes

Description  Cette procédure supprime la propriété d'un objet définie par l'utilisateur.

Syntaxe

PROCEDURE OG_Delete_Property
  (ident_objet  OG_Object,
   nom_prop     VARCHAR2);

Paramètres

ident_objet	Identificateur de l'objet dont vous voulez supprimer la propriété.
nom_prop	Nom de la propriété à supprimer.


OG_Delete_Property - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous supprime la propriété 'priorité'
** de chaque objet fils d'un groupe nommé :
*/

PROCEDURE example(group_name VARCHAR2) IS
  group_obj    OG_Object;
  child_count  NUMBER;
  child_obj    OG_Object;
BEGIN
  group_obj := OG_Get_Object(Group_Name);
  child_count := OG_Get_Childcount(Group_Obj);

  FOR i IN 0..child_count LOOP
    child_obj := OG_Get_Child(Group_Obj, i);
    OG_Delete_Property(Child_Obj, 'priorité');
  END LOOP;
END;


OG_Delete_Smptext

  Exemples	  Rubriques connexes

Description  Cette procédure supprime un ou plusieurs éléments texte simple de l'élément texte composé indiqué dans l'objet texte indiqué. Comme décrit dans "Attributs de texte", un élément simple représente une chaîne de texte d'un élément texte composé.

Syntaxe

PROCEDURE OG_Delete_Smptext
  (ident_texte  OG_Object,
   indexcmp     NUMBER,
   indexsmp     NUMBER,
   total        NUMBER,
   dommage      BOOLEAN    :=  TRUE,
   boîte_maj    BOOLEAN    :=  TRUE);

Paramètres

ident_texte	Identificateur de l'objet texte.
Indexcmp	Index de l'élément texte composé qui contient l'élément ou les éléments texte simple à supprimer.
total	Nombre total d'éléments texte simple à supprimer.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  La suppression d'un texte simple est sans effet sur l'existence ou l'index de son élément texte composé. En fait, il est possible de supprimer tout le texte simple d'un élément texte composé, pour qu'il ne reste qu'un élément texte composé vide.


OG_Delete_Smptext - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/*Soit un objet texte de message. Pour modifier
**le message qu'il contient, supprimer l'élément texte simple qui
**contient le message et insérer un nouveau texte simple contenant
**le nouveau message. Pour conserver les attributs de police et les autres attributs,
** rechercher d'abord l'élément texte simple dans un enregistrement Attribut,
**de façon à modifier uniquement la chaîne de texte,
**et conserver les autres paramètres d'attributs (police, par exemple).
*/

PROCEDURE put_msg(mess IN VARCHAR2) IS
  msgobj    OG_Object;
  msgrec    OG_Smptext_Attr;
BEGIN
  msgobj := OG_Get_Object(’msg’);
  OG_Get_Smptext(msgobj, 0, 0, msgrec);
  OG_Delete_Smptext(msgobj, 0, 0, 1);
  msgrec.mask:= OG_STR_SMPTEXTA;
  msgrec.str:= mess;
  OG_Insert_Smptext(msgobj, msgrec, 0, OG_LAST);
END;


OG_Destroy (objet)

  Exemples	  Rubriques connexes

Description  Cette procédure détruit l'objet indiqué. Si vous détruisez un objet groupe, tous les fils de ce groupe sont également détruits.

Syntaxe

PROCEDURE OG_Destroy
  (ident_objet   OG_Object,
   recurs        BOOLEAN    :=  FALSE,
   dommage       BOOLEAN    :=  TRUE,
   boîte_maj     BOOLEAN    :=  TRUE);

Paramètres

ident_objet	Identificateur de l'objet à détruire.
Recurs	Indicateur de destruction récursive pour cet argument facultatif. Sa valeur est FALSE par défaut. En outre, il n'est pas pris en compte si l'objet que vous détruisez n'est pas le seul fils d'un groupe.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Si l'objet que vous détruisez est le seul fils d'un groupe, la valeur récursive TRUE indique que le groupe père doit également être détruit. Cette action se poursuit jusqu'à l'arborescence du groupe de l'objet (c'est-à-dire, si le père de l'objet est le seul fils de son groupe père, ce groupe père sera également détruit, etc.). Enfin, si le dernier objet d'une couche est détruit, la couche est également détruite (à moins qu'elle ne soit active dans une fenêtre).

Si recurs a la valeur FALSE, seul l'objet indiqué par ident_objet sera détruit.


OG_Destroy (objet)  - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous détruit l'objet indiqué :
*/

PROCEDURE destroy_obj(obj_name VARCHAR2) IS
  object  OG_Object;
BEGIN
  object := OG_Get_Object(Obj_Name);
  OG_Destroy(Object);
END;


OG_Draw

  Exemples	  Rubriques connexes

Description  Cette procédure dessine l'objet indiqué dans la présentation.

Syntaxe

PROCEDURE OG_Draw
  (ident_objet  OG_Object);

Paramètres

ident_objet	Identificateur de l'objet à dessiner.

Notes d'utilisation  A la différence des autres procédures qui modifient les objets, celle-ci n'endommage pas une zone rectangulaire de la présentation. Elle dessine uniquement l'objet indiqué, sans rien modifier d'autre.

Cette procédure, qui vous permet de faire apparaître un objet sur la présentation, empêche Graphics Builder de redessiner une région d'endommagement de rectangle qui peut être plus grande que nécessaire.


OG_Draw - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/*Soit un objet à cloner qui doit apparaître dans la
**présentation sans que la région d'endommagement soit redessinée.
**Créer d'abord l'objet en appelant OG_Clone avec un indicateur de dommage
**ayant la valeur FALSE, puis faire apparaître l'objet dans la présentation
**en appelant OG_Draw.
*/

PROCEDURE clone_object IS
   the_object   OG_Object;
   new_object   OG_Object;
BEGIN
   the_object:=OG_Get_Object('Mon_Objet');
   new_object:=OG_Clone(The_Object, FALSE);
   OG_Draw(new_object);
END;


OG_Export_Drawing (affichage)

  Exemples	  Rubriques connexes

Description  Cette procédure exporte la totalité de la présentation (couches masquées comprises) sous la forme d'un dessin.

Syntaxe

PROCEDURE OG_Export_Drawing
  (nom          VARCHAR2,
   gisement     NUMBER,
   format       NUMBER,
   compression  NUMBER    :=  OG_No_Icompression);

Paramètres

nom	Nom sous lequel le dessin sera exporté. Si le dessin est stocké dans la base de données, cet argument doit contenir uniquement le nom du dessin. Si le dessin est stocké dans le système de fichiers, cet argument doit contenir le nom du chemin d'accès absolu ou relatif du fichier de dessin.
gisement	Indique si le dessin doit être stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Db   Indique que le dessin doit être stocké dans la base de données. OG_Filesystem   Indique que le dessin doit être stocké dans le système de fichiers.
format	Format dans lequel le dessin est exporté. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Cgm16_Dformat   Indique que le dessin est enregistré en format CGM sur 2 octets. OG_Cgm32_Dformat Indique que le dessin est enregistré en format CGM sur 4 octets. OG_Oracle_Dformat Indique que le dessin est enregistré en format Oracle, utilisé par d'autres produits Oracle.
compression	Type de compression utilisé pour comprimer les images qui font partie du dessin. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_No_Icompression   Indique que les images ne sont pas compressées. OG_H3g_Icompression   Indique que les images sont compressées en utilisant la compression CCITT Groupe 3 avec codage Huffman. OG_G3fax_Icompression   Indique que les images sont compressées en utilisant la compression Fax Groupe 3. Ce type de compression n'est valide que pour les images monochromes. OG_G4fax_Icompression   Indique que les images sont compressées en utilisant la compression Fax Groupe 4. Ce type de compression n'est valide que pour les images monochromes. OG_Pack_Icompression   Indique que les images sont compressées en utilisant la compression PackBits. Ce type de compression n'est valide que pour les images TIFF monochromes OG_Lzwhdiff_Icompression Indique que les images sont compressées en utilisant la compression LZW avec différenciation horizontale. OG_Lzwnohdiff_Icompression Indique que les images sont compressées en utilisant la compression LZW sans différenciation horizontale. OG_Jpeg_Lowest_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne le taux de compression le plus faible et la qualité la plus élevée. OG_Jpeg_Low_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression faible et une qualité élevée. OG_Jpeg_Medium_Icompression  Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression moyen et une qualité moyenne. OG_Jpeg_High_Icompression   Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression élevé et une qualité faible. OG_Jpeg_Highest_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne le taux de compression le plus élevé et la qualité la moins élevée.


OG_Export_Drawing (affichage) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/*Le contenu de l'affichage doit être exporté dans le fichier CGM
**`mon_dessin', pour être importé ultérieurement dans une autre application.
**La procédure qui exécute cette opération est la suivante :
*/

PROCEDURE export_the_drawing IS
BEGIN
   OG_Export_Drawing('Mon_dessin', OG_Filesystem, OG_Cgm16_Dformat);
END;


OG_Export_Drawing (objet/couche)

  Exemples	  Rubriques connexes

Description  Cette procédure exporte l'objet ou la couche indiqués sous la forme d'un dessin.

Syntaxe

PROCEDURE OG_Export_Drawing
  (nom           VARCHAR2,
   gisement      NUMBER,
   format        NUMBER,
   ident_objet   OG_Object,
   compression   NUMBER     :=  OG_No_Icompression);

Paramètres

nom	Nom sous lequel le dessin sera exporté. Si le dessin est stocké dans la base de données, cet argument doit contenir uniquement le nom du dessin. Si le dessin est stocké dans le système de fichiers, cet argument doit contenir le nom du chemin d'accès absolu ou relatif du fichier de dessin.
Gisement	Indique si le dessin doit être stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Db   Indique que le dessin doit être stocké dans la base de données. OG_Filesystem   Indique que le dessin doit être stocké dans le système de fichiers.
format	Format dans lequel le dessin est exporté. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Cgm16_Dformat   Indique que le dessin est enregistré en format CGM sur 2 octets. OG_Cgm32_Dformat Indique que le dessin est enregistré en format CGM sur 4 octets. OG_Oracle_Dformat Indique que le dessin est enregistré en format Oracle, utilisé par d'autres produits Oracle.
ident_objet	Identificateur de l'objet à exporter. L'objet peut être soit un groupe soit l'identificateur d'objet d'une couche ; l'objet et tous ses descendants seront exportés. Pour indiquer une couche à exporter, utilisez OG_Get_Object pour indiquer l'identificateur d'objet de la couche.
Compression	Type de compression utilisé pour comprimer les images qui font partie du dessin. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_No_Icompression   Indique que les images ne sont pas compressées. OG_H3g_Icompression   Indique que les images sont compressées en utilisant la compression CCITT Groupe 3 avec codage Huffman. OG_G3fax_Icompression   Indique que les images sont compressées en utilisant la compression Fax Groupe 3. Ce type de compression n'est valide que pour les images monochromes. OG_G4fax_Icompression   Indique que les images sont compressées en utilisant la compression Fax Groupe 4. Ce type de compression n'est valide que pour les images monochromes. OG_Pack_Icompression   Indique que les images sont compressées en utilisant la compression PackBits. Ce type de compression n'est valide que pour les images TIFF monochromes OG_Lzwhdiff_Icompression Indique que les images sont compressées en utilisant la compression LZW avec différenciation horizontale. OG_Lzwnohdiff_Icompression Indique que les images sont compressées en utilisant la compression LZW sans différenciation horizontale. OG_Jpeg_Lowest_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne le taux de compression le plus faible et la qualité la plus élevée. OG_Jpeg_Low_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression faible et une qualité élevée. OG_Jpeg_Medium_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression moyen et une qualité moyenne. OG_Jpeg_High_Icompression   Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression élevé et une qualité faible. OG_Jpeg_Highest_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne le taux de compression le plus élevé et la qualité la moins élevée.


OG_Export_Drawing (objet/couche) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Le contenu de couche0 doit être exporté dans le fichier CGM
**`Mon_dessin', pour être importé ultérieurement dans une autre application.
**La procédure qui exécute cette opération est la suivante :
*/

PROCEDURE export_the_drawing IS
   the_layer   OG_Object;
BEGIN
   the_layer:=OG_Get_Object('Couche0');
   OG_Export_Drawing('Mon_dessin', OG_Filesystem,
OG_Cgm16_Dformat, the_layer);
END;


OG_Export_Drawing (fenêtre)

  Exemples	  Rubriques connexes

Description  Cette procédure exporte le contenu visible de la fenêtre indiquée sous la forme d'un dessin.

Syntaxe

PROCEDURE OG_Export_Drawing
  (nom            VARCHAR2,
   gisement       NUMBER,
   format         NUMBER,
   ident_fenêtre  OG_Window,
   compression    NUMBER     :=  OG_No_Icompression);

Paramètres:

nom	Nom sous lequel le dessin sera exporté. Si le dessin est stocké dans la base de données, cet argument doit contenir uniquement le nom du dessin. Si le dessin est stocké dans le système de fichiers, cet argument doit contenir le nom du chemin d'accès absolu ou relatif du fichier de dessin.
Gisement	Indique si le dessin doit être stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Db   Indique que le dessin doit être stocké dans la base de données. OG_Filesystem   Indique que le dessin doit être stocké dans le système de fichiers.
format	Format dans lequel le dessin est exporté. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Cgm16_Dformat   Indique que le dessin est enregistré en format CGM sur 2 octets. OG_Cgm32_Dformat Indique que le dessin est enregistré en format CGM sur 4 octets. OG_Oracle_Dformat Indique que le dessin est enregistré en format Oracle, utilisé par d'autres produits Oracle.
ident_fenêtre	Identificateur de la fenêtre qui contient le dessin à exporter. Toutes les couches qui sont affichées dans la fenêtre seront exportées.
Compression	Type de compression utilisé pour comprimer les images qui font partie du dessin. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_G3fax_Icompression   Indique que les images sont compressées en utilisant la compression Fax Groupe 3. Ce type de compression n'est valide que pour les images monochromes. OG_G4fax_Icompression   Indique que les images sont compressées en utilisant la compression Fax Groupe 4. Ce type de compression n'est valide que pour les images monochromes. OG_H3g_Icompression   Indique que les images sont compressées en utilisant la compression CCITT Groupe 3 avec codage Huffman. OG_Jpeg_High_Icompression   Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression élevé et une qualité faible. OG_Jpeg_Highest_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne le taux de compression le plus élevé et la qualité la moins élevée. OG_Jpeg_Low_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression faible et une qualité élevée. OG_Jpeg_Lowest_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne le taux de compression le plus faible et la qualité la plus élevée. OG_Jpeg_Medium_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression moyen et une qualité moyenne. OG_Lzwhdiff_Icompression Indique que les images sont compressées en utilisant la compression LZW avec différenciation horizontale. OG_Lzwnohdiff_Icompression Indique que les images sont compressées en utilisant la compression LZW sans différenciation horizontale. OG_No_Icompression   Indique que les images ne sont pas compressées. OG_Pack_Icompression   Indique que les images sont compressées en utilisant la compression PackBits. Ce type de compression n'est valide que pour les images TIFF monochromes.


OG_Export_Drawing (fenêtre) - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Le contenu de la fenêtre `Présentation principale' doit être exporté
** dans le fichier CGM `mon_dessin', pour être importé ultérieurement
** dans une autre application. La procédure qui exécute cette opération est la suivante :
*/

PROCEDURE export_the_drawing IS
   the_window   OG_Window;
BEGIN
   the_window:=OG_Get_Window('Présentation principale');
   OG_Export_Drawing('Mon_dessin', OG_Filesystem,
OG_Cgm16_Dformat, the_window);
END;


OG_Export_Image

  Exemples	  Rubriques connexes

Description  Cette procédure exporte un objet Graphics Builder, entouré d'une bordure d'un demi-pouce, dans une image.

Syntaxe

PROCEDURE OG_Export_Image
  (nom          VARCHAR2,
   gisement     NUMBER,
   format       NUMBER,
   ident_image  OG_Object,
   compression  NUMBER     :=  OG_No_Icompression);

Paramètres

nom	Nom sous lequel l'image sera exportée. Si l'image est stockée dans la base de données, cet argument doit contenir uniquement le nom de l'image. Si l'image est stockée dans le système de fichiers, cet argument doit contenir le nom du chemin d'accès absolu ou relatif du fichier d'image.
Gisement	Indique si l'image doit être stockée dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Db   Indique que l'image doit être stockée dans la base de données. OG_Filesystem   Indique que l'image doit être stockée dans le système de fichiers.
format	Format dans lequel l'image est exportée. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Bmp_Iformat   Indique que l'image est enregistrée en format Windows/OS2 Bitmap. OG_Cals_Iformat Indique que l'image est enregistrée en format CALS Type 1 Raster. OG_Gif_Iformat Indique que l'image est enregistrée en format CompuServe GIF format.  Compressez les fichiers GIF en utilisant OG_Lzwhdiff_Icompression. OG_Jfif_Iformat Indique que l'image est enregistrée en format JPEG File Image. OG_Pict_Iformat Indique que l'image est enregistrée en format Macintosh PICT. OG_Ras_Iformat Indique que l'image est enregistrée en format SUN Raster. OG_Tiff_Iformat Indique que l'image est enregistrée en format Tag Image File.
ident_ image	Identificateur de l'image à exporter. Cet argument peut être un objet Graphics Builder.
Compression	Type de compression utilisé. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_G3fax_Icompression   Indique que les images sont compressées en utilisant la compression Fax Groupe 3. Ce type de compression n'est valide que pour les images monochromes. OG_G4fax_Icompression   Indique que les images sont compressées en utilisant la compression Fax Groupe 4. Ce type de compression n'est valide que pour les images monochromes. OG_H3g_Icompression   Indique que les images sont compressées en utilisant la compression CCITT Groupe 3 avec codage Huffman. OG_Jpeg_High_Icompression   Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression élevé et une qualité faible. OG_Jpeg_Highest_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne le taux de compression le plus élevé et la qualité la plus faible. OG_Jpeg_Low_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression faible et une qualité élevée. OG_Jpeg_Lowest_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne le taux de compression le plus faible et la qualité la plus élevée. OG_Jpeg_Medium_Icompression Indique que les images sont compressées en utilisant la compression JPEG qui donne un taux de compression moyen et une qualité moyenne. OG_Lzwhdiff_Icompression Indique que les images sont compressées en utilisant la compression LZW avec différenciation horizontale. OG_Lzwnohdiff_Icompression Indique que les images sont compressées en utilisant la compression LZW sans différenciation horizontale. OG_No_Icompression   Indique que les images ne sont pas compressées. OG_Pack_Icompression   Indique que les images sont compressées en utilisant la compression PackBits. Ce type de compression n'est valide que pour les images TIFF monochromes.


OG_Export_Image - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit l'image, appelée'image0', à exporter dans le fichier TIFF
**`mon_image', pour être importée ultérieurement dans une autre application.
**La procédure qui exécute cette opération est la suivante :
*/

 PROCEDURE export_the_image IS
   the_image   OG_Object;
BEGIN
   the_image:=OG_Get_Object('image0');
   OG_Export_Image('mon_image', OG_Filesystem,
      OG_Tiff_Iformat, the_image);
END;


OG_Get_Char_Property

  Exemples	  Rubriques connexes

Description  Cette procédure lit la valeur de la propriété d'un objet de type CHAR, définie par l'utilisateur.

Syntaxe

FUNCTION OG_Get_Char_Property
  (ident_objet  OG_Object,
   nom_prop     VARCHAR2)
RETURN VARCHAR2;

Paramètres

ident_objet	Identificateur de l'objet contenant la propriété que vous voulez lire.
nom_prop	Nom de la propriété dont vous voulez lire la valeur.

Retourne  La valeur de la propriété indiquée.


OG_Get_Char_Property - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la propriété 'état'
**de chaque objet fils d'un groupe, puis modifie
**la couleur de l'objet si l'état est 'obsolète'.
*/

PROCEDURE example(group_name VARCHAR2) IS
  group_obj    OG_Object;
  child_count  NUMBER;
  child_obj    OG_Object;
  stat         VARCHAR2(10);
BEGIN
  group_obj := OG_Get_Object(Group_Name);
  child_count := OG_Get_Childcount(Group_Obj);

  FOR i IN 0..child_count LOOP
    child_obj := OG_Get_Child(Group_Obj, i);
    stat := OG_Get_Char_Property(Child_Obj, 'état');
    IF stat = 'obsolète' THEN
      OG_Set_Fillcolor(Child_Obj, 'rouge');
    END IF;
  END LOOP;

END;


OG_Get_Child

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un identificateur d'un objet fils d'un objet de groupe.

Syntaxe

FUNCTION OG_Get_Child
  (ident_groupe  OG_Object,
   index              NUMBER)
RETURN OG_Object;

Paramètres

ident_groupe	Identificateur de l'objet de groupe contenant l'objet fils.
index	Index de l'objet dans la liste des objets fils du groupe dont l'identificateur doit être retourné.

Retourne  Un identificateur de l'objet fils indiqué dans un groupe.


OG_Get_Child - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit plusieurs objets représentant des produits, stockés
**en entrepôt, dont l'un est à transférer
**d'un entrepôt à l'autre. L'affichage peut utiliser un groupe
**composé des produits représentant le stock de chaque
**entrepôt. Pour transférer un produit d'un entrepôt à l'autre,
**rechercher l'identificateur de l'objet produit, le supprimer d'un groupe d'entrepôts et
**l'ajouter à un autre groupe d'entrepôts.
*/

PROCEDURE move_prod(warehouse1 IN OG_Object, warehouse2 IN
OG_Object, prod_index in number) IS
   the_prod   OG_Object;
BEGIN
   the_prod:=OG_Get_Child(Warehouse1, prod_index);
   OG_Delete_Child(Warehouse1, prod_index, 1);
   OG_Insert_Child(Warehouse2, the_prod, OG_Last);
END;

/*Noter que cette procédure ne modifie que la composition interne
**des objets de groupe. Pour déplacer ou modifier l'aspect de
**l'objet produit, utiliser d'autres procédures internes de Graphics Builder.
*/


OG_Get_Cmptext

  Exemples	  Rubriques connexes

Description  Cette procédure lit les valeurs d'attribut de l'élément texte composé indiqué et les attribue aux champs correspondants de l'enregistrement d'attributs texte composé indiqué. Comme décrit dans "Attributs de texte", un élément texte composé représente une ligne de texte d'un objet texte.

Syntaxe

PROCEDURE OG_Get_Cmptext
  (ident_texte  OG_Object,
   index        NUMBER,
   attr         IN OUT  OG_Cmptext_Attr);

Paramètres

ident_texte	Identificateur de l'objet texte.
index	Index de l'élément texte composé dans la liste des éléments texte composé dont vous voulez extraire les attributs.
attr	Enregistrement d'attributs texte composé qui recevra les attributs de l'élément texte composé.

Notes d'utilisation  Les seules valeurs d'attribut qui seront extraites sont celles indiquées par la valeur de l'attribut masque de l'enregistrement d'un attribut. Les champs de l'enregistrement d'attributs pour lesquels le masque n'est pas défini ne sont pas concernés par l'appel à OG_Get_Cmptext.


OG_Get_Cmptext - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour déterminer le nombre d'éléments texte simple
** qui composent le premier élément texte composé d'un objet texte,
**il est possible d'effectuer une boucle et d'examiner chaque élément texte simple.
*/

FUNCTION how_many(my_text IN OG_Object) RETURN NUMBER IS
   ctext_rec   OG_Cmptext_Attr;
BEGIN
   ctext_rec.mask:=OG_Stcount_Cmptexta;
   OG_Get_Cmptxt(My_Text, 0, ctext_rec);
   RETURN(ctext_rec.stcount);
END;


OG_Get_Date_Property

  Exemples	  Rubriques connexes

Description  Cette procédure lit la valeur de la propriété DATE d'un objet, définie par l'utilisateur.

Syntaxe

FUNCTION OG_Get_Date_Property
  (ident_objet  OG_Object,
   nom_propr     VARCHAR2,
   fmt_date     VARCHAR2   := 'DD-MON-YY')
RETURN DATE;

Paramètres

ident_objet	Identificateur de l'objet contenant la propriété que vous voulez lire.
nom_propr	Nom de la propriété dont vous voulez lire la valeur.
fmt_date	Masque de format de date utilisé pour définir la propriété DATE dans OG_Set_Property.

Retourne  La valeur de la propriété indiquée.


OG_Get_Date_Property - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la propriété 'date_échéance' de chaque objet fils
**d'un groupe, puis modifie la couleur de l'objet si la date d'échéance est dépassée :
*/

PROCEDURE example(group_name VARCHAR2) IS
  group_obj    OG_Object;
  child_count  NUMBER;
  child_obj    OG_Object;
  due          DATE;
BEGIN
  group_obj := OG_Get_Object(Group_Name);
  child_count := OG_Get_Childcount(Group_Obj);

  FOR i IN 0..child_count-1 LOOP
    child_obj := OG_Get_Child(Group_Obj, i);
    due := OG_Get_Date_Property(Child_Obj, 'date_échéance');
    IF due < sysdate THEN
      OG_Set_Fillcolor(Child_Obj, 'rouge');
    END IF;
  END LOOP;

END;


OG_Get_Num_Property

  Exemples	  Rubriques connexes

Description  Cette procédure lit la valeur de la propriété d'un objet de type NUMBER, définie par l'utilisateur.

Syntaxe

FUNCTION OG_Get_Num_Property
  (ident_objet  OG_Object,
   nom_propr     VARCHAR2)
RETURN NUMBER;

Paramètres

ident_objet	Identificateur de l'objet contenant la propriété que vous voulez lire.
nom_propr	Nom de la propriété dont vous voulez lire la valeur.

Retourne  La valeur de la propriété indiquée.


OG_Get_Num_Property - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous lit la propriété 'priorité' de chaque objet fils
**d'un groupe, puis définit la propriété à une valeur supérieure d'une unité à la valeur en cours :
*/

PROCEDURE example(group_name VARCHAR2) IS
  group_obj    OG_Object;
  child_count  NUMBER;
  child_obj    OG_Object;
  current_p    NUMBER;
BEGIN
  group_obj := OG_Get_Object(Group_Name);
  child_count := OG_Get_Childcount(Group_Obj);

  FOR i IN 0..child_count-1 LOOP
    child_obj := OG_Get_Child(Group_Obj, i);
    current_p := OG_Get_Num_Property(Child_Obj, 'priorité');
    OG_Set_Property(Child_Obj, 'priorité', current_p + 1);
  END LOOP;

END;


OG_Get_Object

  Exemples	  Rubriques connexes

Description  L'objet peut être un objet arc, graphique, groupe, image, ligne, polygone, rectangle, rectangle arrondi, symbole ou texte. L'objet doit être créé et nommé soit dans Builder, soit par programme avant son extraction par cette fonction. Si l'objet n'existe pas, cette fonction retourne un identificateur NULL.

Syntaxe

FUNCTION OG_Get_Object
  (nom_objet  VARCHAR2)
RETURN OG_Object;

FUNCTION OG_Get_Object
  (nom_objet  VARCHAR2,
   ident racine     OG_Object)
RETURN OG_Object;

Paramètres

nom_objet	Nom de l'objet dont vous voulez obtenir l'identificateur. Remarque : NOM_OBJET fait l'objet d'une distinction entre majuscules et minuscules.
ident_racine	Identificateur de l'objet dans l'arborescence de groupe à rechercher.

Retourne  Un identificateur de l'objet indiqué.

Notes d'utilisation  Si vous n'indiquez pas ident_racine, Graphics Builder commence la recherche par l'objet racine de l'affichage, puis recherche dans chaque objet de l'affichage celui dont le nom est indiqué. Si vous indiquez ident_racine, Graphics Builder ne recherche l'objet nommé que dans la partie de l'arborescence de groupe située en dessous de cet objet. Si plusieurs objets du chemin de recherche ont le même nom, les résultats sont imprévisibles.

Si nom_objet est le nom d'une couche, cette fonction la considère comme un objet de groupe et retourne l'identificateur de ce groupe. Vous pouvez alors utiliser les sous-programmes concernant le groupe (OG_Insert_Child, OG_Delete_Child, etc.) pour manipuler les objets situés sur la couche.


OG_Get_Object - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Sur une carte du monde, pour changer
**la couleur de l'un des pays, commencer par lire l'identificateur de
**l'objet pays, puis changer sa couleur.
*/

PROCEDURE color_country(country_name) IS
   my_object    OG_Object;
   obj_record   OG_Graphic_Ca;
BEGIN
   my_object:=OG_Get_Object(Country_Name);
   obj_record.graphic_caob.mask:=OG_None_Generica;
   obj_record.graphic_caoh.mask:=OG_Ffcolor_Graphica;
   obj_record.graphic_caoh.ffcolor:='rouge';
   OG_Set_Attr(My_Object, obj_record);
END;


OG_Get_Point

  Exemples	  Rubriques connexes

Description  Cette fonction retourne un enregistrement contenant les coordonnées x et y d'un point de l'objet indiqué.

Syntaxe

FUNCTION OG_Get_Point
  (ident_objet  OG_Object,
   index        NUMBER
   rotation     BOOLEAN    :=  FALSE)
RETURN OG_Point;

Paramètres

ident_objet	Identificateur de l'objet index.
index	Index du point dans la liste des points à retourner.
rotation	Indique si le point retourné doit ou non refléter l'angle de rotation appliqué à l'objet.

Retourne  L'emplacement du point indiqué.

Notes d'utilisation

Polygone: Retourne le point de l'objet correspondant à l'index.

Arc, Graphique, Rectangle, Rectangle arrondi :  L'index 0 retourne l'angle supérieur gauche ; l'index 1 retourne l'angle supérieur droit ; l'index 2 retourne l'angle inférieur droit et l'index 3 retourne l'angle inférieur gauche.

Texte :  L'index 0 retourne l'angle supérieur gauche ; l'index 1 retourne l'angle supérieur droit ; l'index 2 retourne l'angle inférieur droit et l'index 3 retourne l'angle inférieur gauche.

Ligne: L'index 0 retourne le point de départ et l'index 1 le point de fin.

Image, Groupe, Symbole :  Non applicable.

Si l'objet a été créé dans Builder, les valeurs d'index initiales des points correspondront à l'ordre dans lequel l'utilisateur a cliqué sur la souris lorsque l'objet a été dessiné (le premier point ayant l'index 0). Les valeurs d'index des points qui ont été insérés par programme dépendront de l'index indiqué lorsqu'ils ont été insérés.


OG_Get_Point - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Une carte comporte plusieurs polygones, chacun d'entre eux
**reliant les villes situées dans une zone de distribution spécifique.
**Si une ville passe d'une zone de distribution à une autre,
**le point la représentant doit être supprimé d'un polygone et ajouté à un autre.
*/

PROCEDURE move_city(area1 IN OG_Object, area2 IN OG_Object,
  city_index NUMBER) IS
   the_city   OG_Point;
BEGIN
   the_city:=OG_Get_Point(Area1, city_index);
   OG_Delete_Point(Area1, city_index, 1);
   OG_Insert_Point(Area2, OG_Last, the_city);
END;


OG_Get_Smptext

  Exemples	  Rubriques connexes

Description  Cette procédure lit les valeurs d'attribut de l'élément texte simple indiqué dans l'élément texte composé indiqué et l'objet texte indiqué. Ces attributs sont alors attribués aux champs correspondants de l'enregistrement d'attributs texte simple indiqué. Comme décrit dans "Attributs de texte", un élément texte simple représente une chaîne de texte d'un élément texte composé.

Syntaxe

PROCEDURE OG_Get_Smptext
  (ident_texte     OG_Object,
   indexcmp        NUMBER,
   indexsmp        NUMBER,
   attr            IN OUT  OG_Smptext_Attr);

Paramètres

ident_texte	Identificateur de l'objet texte.
Indexcmp	Index, dans l'objet texte, de l'élément texte composé qui contient l'élément texte simple dont vous voulez extraire les attributs.
Indexsmp	Index, dans l'élément texte composé, de l'élément texte simple dont vous voulez extraire les attributs.
attr	Enregistrement d'attributs de texte simple qui recevra les attributs de l'élément texte simple.

Notes d'utilisation  Les seules valeurs d'attributs qui seront extraites sont celles indiquées par la valeur de l'attribut masque de l'enregistrement d'attributs. Les champs de l'enregistrement d'attributs pour lesquels le masque n'est pas défini ne sont pas concernés par l'appel à OG_Get_Smptext.


OG_Get_Smptext - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Soit un objet texte de message dont le message qu'il contient
**doit être modifié : supprimer l'élément texte simple qui contient
**le message et insérer un nouveau texte simple contenant le nouveau
**message. Pour conserver les attributs de police et les autres attributs,
**rechercher l'élément texte simple dans un enregistrement Attributs et
**ainsi modifier uniquement la chaîne de texte,
**en conservant les autres paramètres d'attributs (police, par exemple).
*/

PROCEDURE put_msg (mess IN VARCHAR2) IS
   msgobj   OG_Object;
   msgrec   OG_Smptext_Attr;
BEGIN
   msgobj:=OG_Get_Object('Msg');
   msgrec.mask:=OG_Font_Smptexta+
                OG_Color_Smptexta;
   msgrec.font.mask:=OG_All_Fonta;
   OG_Get_Smptext(Msgobj, 0, 0, msgrec);
   OG_Delete_Smptext(Msgobj, 0, 0, 1, FALSE);
   msgrec.mask:=msgrec.mask + OG_Str_Smptexta;
   msgrec.str:=mess;
   OG_Insert_Smptext(Msgobj, msgrec, 0, OG_Last);
END;


OG_Import_Drawing

  Exemples	  Rubriques connexes

Description  Cette procédure importe un dessin et retourne un identificateur du premier objet du dessin.

Syntaxe

FUNCTION OG_Import_Drawing
  (nom             VARCHAR2,
   gisement        NUMBER,
   format          NUMBER,
   couleurs_util   BOOLEAN,
   dommage         BOOLEAN   :=  TRUE,
   boîte_maj       BOOLEAN   :=  TRUE)
RETURN OG_Object;

FUNCTION OG_Import_Drawing
  (nom             VARCHAR2,
   gisement        NUMBER,
   format          NUMBER,
   couleurs_util   BOOLEAN,
   ident_père      OG_Object,
   dommage         BOOLEAN   :=  TRUE,
   boîte_maj       BOOLEAN   :=  TRUE)
RETURN OG_Object;

Paramètres

nom	Nom sous lequel le dessin sera stocké. Si le dessin est stocké dans la base de données, cet argument doit contenir uniquement le nom du dessin. Si le dessin est stocké dans le système de fichiers, cet argument doit contenir le nom du chemin d'accès absolu ou relatif du fichier de dessin.
Gisement	Indique si le dessin doit être stocké dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Db   Indique que le dessin doit être stocké dans la base de données. OG_Filesystem   Indique que le dessin doit être stocké dans le système de fichiers.
format	Format dans lequel le dessin est enregistré. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Cgm_Dformat   Indique que le dessin est enregistré en format CGM (sur 2 ou 4 octets). OG_Oracle_Dformat Indique que le dessin est enregistré en format Oracle, utilisé par d'autres produits Oracle..
couleurs_util	Palette de couleurs du dessin à utiliser. Si cet argument a la valeur TRUE, la palette sera utilisée. S'il a la valeur FALSE, la palette de couleurs par défaut de Graphics Builder sera utilisée.
ident_père	Identificateur d'un objet de groupe dans lequel le dessin devra être importé sous la forme d'un objet fils. Si cet argument n'est pas indiqué, le dessin est inséré sous la forme d'un fils de l'objet racine (bien qu'il ne soit pas reconnu comme couche tant que vous ne l'avez pas activé ou affiché).
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Retourne  Un identificateur du dessin importé.


OG_Import_Drawing - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit le fichier CGM `mon_dessin' dont le contenu doit être importé
**sur la couche 'couche0'. Obtenir l'identificateur d'objet de la couche,
** puis l'utiliser pour ident_père.  La procédure qui exécute cette opération est la suivante :
*/

PROCEDURE import_the_drawing IS
   the_layer   OG_Object;
   dummy   OG_Object;
BEGIN
   the_layer:=OG_Get_Object('Couche0');
   dummy:=OG_Import_Drawing('Mon_Dessin', OG_Filesystem,
OG_Cgm16_Dformat, FALSE, the_layer);
END;


OG_Import_Image

  Exemples	  Rubriques connexes

Description  Cette procédure importe une image sur la couche active de la fenêtre active.

Syntaxe

FUNCTION OG_Import_Image
  (nom         VARCHAR2,
   gisement    NUMBER,
   format      NUMBER,
   dommage     BOOLEAN   :=  TRUE,
   boîte_maj   BOOLEAN   :=  TRUE)
RETURN OG_Object;

Paramètres

nom	Nom de l'image. Si elle est stockée dans la base de données, cet argument doit contenir uniquement le nom de l'image. Si elle est stockée dans le système de fichiers, cet argument doit contenir le nom du chemin d'accès absolu ou relatif du fichier d'image.
Gisement	Indique si l'image est stockée dans le système de fichiers ou dans la base de données. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Db   Indique que l'image est stockée dans la base de données. OG_Filesystem   Indique que l'image est stockée dans le système de fichiers.
format	Format dans lequel l'image est enregistrée. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Any_Iformat   Indique que Graphics Builder détermine automatiquement le format de l'image.  Remarque : Indiquez ce format si votre image a été exportée dans le format Oracle (devenu obsolète). OG_Bmp_Iformat   Indique que l'image est enregistrée en format BMP. OG_Cals_Iformat Indique que l'image est enregistrée en format CALS. OG_Gif_Iformat Indique que l'image est enregistrée en format GIF. OG_Jfif_Iformat Indique que l'image est enregistrée en format JFIF. OG_Oracle_Sformat Indique que l'image est enregistrée en format Oracle, utilisé par les autres produits Oracle. OG_Pcd_Iformat Indique que l'image est enregistrée en format PCD. OG_Pcx_Iformat Indique que l'image est enregistrée en format PCX. OG_Pict_Iformat Indique que l'image est enregistrée en format PICT. OG_Ras_Iformat Indique que l'image est enregistrée en format SUN Raster. OG_Tiff_Iformat Indique que l'image est enregistrée en format TIFF.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Retourne  Un identificateur de l'image importée.


OG_Import_Image - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit le fichier TIFF `mon_image' dont le contenu doit être importé
**sur la couche `couche0'.  La procédure qui exécute cette opération est la suivante :
*/

PROCEDURE import_the_image IS
   the_image   OG_Object;
BEGIN
   OG_Activate_Layer(OG_Get_Layer('Couche0'));
   the_image:=OG_Import_Image('Mon_Image', OG_Filesystem,
     OG_Tiff_Iformat);
END;


OG_Insert_Child

  Exemples	  Rubriques connexes

Description  Cette procédure insère un objet fils dans l'objet de groupe indiqué. Si l'objet à insérer est déjà un fils d'un autre objet de groupe, Graphics Builder commence par supprimer automatiquement le fils du père en cours.

Syntaxe

PROCEDURE OG_Insert_Child
  (ident_group   OG_Object,
   ident_fils    OG_Object,
   index         NUMBER,
   dommage       BOOLEAN    :=  TRUE,
   boîte_maj     BOOLEAN    :=  TRUE);

Paramètres

ident_groupe	Identificateur de l'objet de groupe dans lequel doit être inséré le fils.
ident_fils	Identificateur de l'objet qui doit être inséré comme fils.
index	Index de la liste des fils du groupe où le nouveau fils doit être inséré. Cet argument doit être un entier compris entre 0 et n (inclus), où n est le nombre de fils du groupe avant l'insertion. La valeur de cet argument peut aussi être l'une des constantes intégrées suivantes : OG_First   Indique que l'objet sera inséré comme le premier fils du groupe (index = 0). OG_Last   Indique que l'objet sera inséré comme le dernier fils du groupe (index = nombre de fils du groupe avant l'insertion).
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Vous pouvez insérer un objet dans une couche en considérant la couche comme un objet de groupe et en transmettant son identificateur d'objet de cette procédure. Vous pouvez également créer une nouvelle couche en insérant un objet de groupe dans l'objet racine de l'affichage. Cependant, Graphics Builder ne considérera pas ce groupe comme une couche tant que vous ne l'aurez pas explicitement affiché en appelant OG_Activate_Layer ou OG_Show_Layer.

Notez que Graphics Builder ne contrôle pas l'existence de boucles dans les objets de groupe, ce qu'il ferait si vous insériez un groupe en tant que fils de l'un de ses descendants. Dans ce cas, Graphics Builder exécute une boucle infinie lorsqu'il traverse l'arborescence de groupe pour mettre à jour les boîtes englobantes des objets concernés.

Notez que cette procédure ne modifie que la composition interne des objets de groupe. Pour déplacer ou modifier l'aspect de l'objet produit, vous devez utiliser d'autres procédures internes de Graphics Builder.


OG_Insert_Child - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Soit plusieurs objets représentant des produits, stockés
**en entrepôt, dont l'un est à transférer  d'un entrepôt à l'autre. L'affichage peut
**utiliser un groupe composé des produits représentant le stock de chaque
**entrepôt. Pour transférer un produit d'un entrepôt à l'autre, rechercher l'identificateur
**de l'objet produit, le supprimer d'un groupe d'entrepôts et l'ajouter à un autre groupe
**d'entrepôts.
*/

PROCEDURE move_prod (warehouse1 IN OG_Object, warehouse2 IN
  OG_Object, prod_index IN number) IS
   the_prod   OG_Object;
BEGIN
   the_prod:=OG_Get_Child(Warehouse1, prod_index);
   OG_Delete_Child(Warehouse1, prod_index, 1);
   OG_Insert_Child(Warehouse2, the_prod, OG_Last);
END;


OG_Insert_Cmptext

  Exemples	  Rubriques connexes

Description  Cette procédure insère un nouvel élément texte composé dans l'objet texte indiqué. Comme décrit dans "Attributs de texte", un élément texte composé représente une ligne de texte dans un objet texte.

Syntaxe

PROCEDURE OG_Insert_Cmptext
  (ident_texte   OG_Object,
   index         NUMBER,
   dommage       BOOLEAN    :=  TRUE,
   boîte_maj     BOOLEAN    :=  TRUE);

Paramètres

ident_texte	Identificateur de l'objet texte.
Index	Index de la liste des éléments texte composé de l'objet texte auquel le nouvel élément texte composé doit être inséré. Cet argument doit être un entier compris entre 0 et n (inclus), où n est le nombre d'éléments texte composé de l'objet texte avant l'insertion. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_First   Indique l'insertion du nouvel élément texte composé au début de l'objet texte (index = 0). OG_Last    Indique l'insertion du nouvel élément texte composé à la fin de l'objet texte (index = nombre d'éléments texte composé de l'objet texte avant l'insertion).
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Les attributs d'un élément texte composé sont définis automatiquement par Graphics Builder. Vous ne devez donc pas fournir d'enregistrement d'attributs texte composé lorsque vous créez un nouveau texte composé. (Par contre, si vous voulez lire les attributs de l'élément, vous devez fournir à OG_Get_Cmptext un enregistrement d'attributs texte composé devant les recevoir.)


OG_Insert_Cmptext - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un objet texte qui contiendra un message destiné à
** l'utilisateur. La fonction décrite ci-dessous crée l'objet, insère un élément texte
** composé, puis un élément texte simple qui contient le texte du message.
*/

PROCEDURE make_text (the_message IN VARCHAR2) IS
   text_rec   OG_Text_Ca;
   text_obj   OG_Object;
   smp_rec    OG_Smptext_Attr;
BEGIN
   text_rec.text_caob.mask:=OG_None_Generica;
   text_rec.text_caoh.mask:=OG_None_Graphica;
   text_rec.text_caot.mask:=OG_None_Texta;
   text_obj:=OG_Make(Text_Rec);
   OG_Insert_Cmptext(Text_Obj, OG_Last);
   smp_rec.mask:=OG_Str_Smptexta;
   smp_rec.str:=the_message;
   OG_Insert_Smptext(Text_Obj, smp_rec, 0, OG_Last);
END;


OG_Insert_Point

  Exemples	  Rubriques connexes

Description  Cette procédure insère un nouveau point dans l'objet polygone indiqué.

Syntaxe

PROCEDURE OG_Insert_Point
  (ident_poly    OG_Object,
   index         NUMBER,
   pt            OG_Point,
   dommage       BOOLEAN    :=  TRUE,
   boîte_maj     BOOLEAN    :=  TRUE);

Paramètres

ident_poly	Indicateur du polygone ou de l'objet polygonal.
index	Index de la liste de points à laquelle le nouveau point doit être inséré. Cet argument doit être un entier compris entre 0 et n (inclus), où n est le nombre de points de l'objet avant l'insertion. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_First   Indique l'insertion du nouveau point au début de la liste de points de l'objet (index = 0). OG_Last   Indique l'insertion du nouveau point à la fin de la liste de points de l'objet (index = nombre d'éléments texte composé de l'objet texte avant l'insertion).
pt	Enregistrement contenant les coordonnées x et y du point à insérer.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Si l'objet a été créé dans Builder, les valeurs d'index initiales des points correspondront à l'ordre dans lequel l'utilisateur a cliqué sur la souris lorsqu'il a dessiné l'objet (le premier point ayant l'index 0). Les valeurs d'index des points qui ont été insérés par programme dépendront de l'index indiqué lors de leur insertion.


OG_Insert_Point - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Une carte comporte plusieurs polygones, qui relient chacun les villes
**d'une zone de distribution spécifique. Si une ville est transférée d'une zone de distribution
** à une autre, il est nécessaire de lire l'indicateur du point
**qui représente cette ville, de le supprimer du polygone et de l'ajouter à un autre.
*/

PROCEDURE move_city(area1 IN OG_Object, area2 IN OG_Object,
city_index IN NUMBER) IS
   the_city   OG_Point;
BEGIN
   the_city:=OG_Get_Point(Area1, city_index);
   OG_Delete_Point(Area1, city_index, 1);
   OG_Insert_Point(Area2, OG_Last, the_city);
END;


OG_Insert_Smptext

  Exemples	  Rubriques connexes

Description  Cette procédure insère un nouvel élément texte simple dans l'élément texte composé indiqué dans l'objet texte indiqué. Comme décrit dans "Attributs de texte", un élément texte simple représente une chaîne de texte d'un élément texte composé.

Syntaxe

PROCEDURE OG_Insert_Smptext
  (objtext      OG_Object,
   attr_smp     OG_Smptext_Attr,
   indexcmp     NUMBER,
   indexsmp     NUMBER,
   dommage      BOOLEAN          :=  TRUE,
   boîte_maj    BOOLEAN          :=  TRUE);

Paramètres

ident_texte	Identificateur de l'objet texte.
attr_smp	Enregistrement d'attributs de l'élément texte simple à insérer.
Indexcmp	Index de l'élément texte composé dans l'objet texte dans lequel le texte simple doit être inséré.
Smpindex	Index de l'élément texte composé auquel le nouvel élément texte simple doit être inséré. Cet argument doit être un entier compris entre 0 et n (inclus), où n est le nombre d'éléments texte simple figurant dans l'élément texte composé avant l'insertion. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_First   Indique que le texte simple sera inséré au début de l'élément texte composé (index = 0). OG_Last   Indique que le texte simple sera inséré à la fin de l'élément texte composé (index = nombre d'éléments texte simple de l'objet composé avant l'insertion).
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  L'enregistrement d'attributs d'élément texte simple indiqué (attr_smp) contient les attributs de l'élément texte simple, y compris la chaîne de texte. Les seules valeurs d'attributs qui seront définies sont celles indiquées par la valeur de l'attribut masque dans cet enregistrement d'attributs.


OG_Insert_Smptext - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un objet texte qui contiendra un message destiné
** à l'utilisateur. La procédure ci-dessous crée l'objet, insère un élément
** texte composé, puis un élément texte simple qui contient
** le texte du message.
*/

PROCEDURE make_text (the_message IN VARCHAR2) IS
   text_rec   OG_Text_Ca;
   text_obj   OG_Object;
   smp_rec    OG_Smptext_Attr;
BEGIN
   text_rec.text_caob.mask:=OG_None_Generica;
   text_rec.text_caoh.mask:=OG_None_Graphica;
   text_rec.text_caot.mask:=OG_None_Texta;
   text_obj:=OG_Make(Text_Rec);
   OG_Insert_Cmptext(Text_Obj, OG_Last);
   smp_rec.mask:=OG_Str_Smptxta;
   smp_rec.str:=the_message;
   OG_Insert_Smptext(Text_Obj, smp_rec, 0, OG_Last);
END;


OG_Make_Ellipse

  Exemples	  Rubriques connexes

Description  Cette fonction crée une ellipse.

Syntaxe

FUNCTION OG_Make_Ellipse
  (position   OG_Point,
   hauteur    NUMBER,
   largeur    NUMBER)
RETURN OG_Object;

Paramètres

position	Coordonnées x et y de l'ellipse.
hauteur	Hauteur de l'ellipse.
largeur	Largeur de l'ellipse.

Retourne  Un identificateur de l'ellipse nouvellement créée.


OG_Make_Ellipse - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous crée une ellipse.
*/

FUNCTION example RETURN OG_Object IS
  object  OG_Object;
  pos     OG_Point;
  height  NUMBER;
  width   NUMBER;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;
  height := 4* OG_Inch;
  width := 4* OG_Inch;

  object := OG_Make_Ellipse(Pos, height, width);
  RETURN(object);
END;


OG_Make_Group

  Exemples	  Rubriques connexes

Description  Cette fonction crée un objet de groupe (notez que le groupe sera vide tant que vous n'y aurez pas ajouté de fils en utilisant OG_Insert_Child).

Syntaxe

FUNCTION OG_Make_Group
RETURN OG_Object;

Paramètres

Aucun.

Retourne   Un identificateur du groupe nouvellement créé.


OG_Make_Group - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous crée un groupe ayant le nom indiqué :
*/

FUNCTION example(group_name VARCHAR2) RETURN OG_Object IS
  object  OG_Object;
BEGIN
  object := OG_Make_Group;
  OG_Set_Name(Object, group_name);
  RETURN(object);
END;


OG_Make_Image

  Exemples	  Rubriques connexes

Description  Cette fonction crée une image à partir des données stockées dans une table de base de données.

Syntaxe

FUNCTION OG_Make_Image
  (interrogation   OG_Query,
   données          NUMBER,
   nomcol          VARCHAR2)
RETURN OG_Object;

Paramètres

interrogation	Identificateur de l'interrogation qui extrait l'image d'une table de base de données. Notez que cette table doit être une table utilisateur, et non l'une des tables privées utilisées par Graphics Builder lorsque vous enregistrez ou exportez un module dans la base de données.
Données	Image à créer dans un nouvel ensemble de données d'interrogation ou dans un ancien. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Newdata   Indique que l'image se trouve dans le nouvel ensemble de données de l'interrogation. OG_Olddata Indique que l'image se trouve dans l'ancien ensemble de données de l'interrogation.
Nomcol	Nom de la colonne d'interrogation qui contient les données de l'image. L'image qui est créée est celle qui figurait dans la cellule d'interrogation à l'intersection de la colonne indiquée par cet attribut et de la ligne désignée par le curseur de l'interrogation.

Retourne  Un identificateur de l'image nouvellement créée.


OG_Make_Image - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous crée une image à partir des données stockées
**à la sixième ligne de l'interrogation 'interro_image' de la colonne IMAGE_COLUMN:
*/

FUNCTION example(image_name VARCHAR2) RETURN OG_Object IS
  query   OG_Query;
  object  OG_Object;
BEGIN
  query := OG_Get_Query('Interro_Image');
  OG_Execute_Query(Query);
  OG_Start_From(Query, OG_Newdata, 5);
  object := OG_Make_Image(Query, OG_Newdata, 'COLONNE_IMAGE');

  OG_Set_Name(Object, image_name);
  RETURN(object);
END;


OG_Make_Line

  Exemples	  Rubriques connexes

Description  Cette fonction crée une ligne.

Syntaxe

FUNCTION OG_Make_Line
  (ptdépt   OG_Point,
   ptarr    OG_Point)
RETURN OG_Object;

Paramètres

ptdépt	Point de départ de la ligne (en unités de présentation).
ptarr	Point d'arrivée de la ligne (en unités de présentation).

Retourne  Un identificateur de la ligne nouvellement créée.


OG_Make_Line - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous crée une ligne horizontale de 2 pouces.
*/

FUNCTION example RETURN OG_Object IS
  object   OG_Object;
  startpt  OG_Point;
  endpt    OG_Point;
BEGIN
  startpt.x := OG_Inch;
  startpt.y := OG_Inch;
  endpt.x := 2 * OG_Inch;
  endpt.y := OG_Inch;

  object := OG_Make_Line(Startpt, endpt);
  RETURN(object);
END;


OG_Make_Poly

  Exemples	  Rubriques connexes

Description  Cette fonction crée un objet polygone ou une ligne polygonale (notez que l'objet ne contient pas de points tant que vous n'en avez pas ajouté en utilisant OG_Insert_Point).

Syntaxe

FUNCTION OG_Make_Poly
RETURN OG_Object;

Paramètres

Aucun.

Retourne  Un identificateur de l'objet polygone ou de la ligne polygonale nouvellement créés.


OG_Make_Poly - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous crée un polygone ayant le nom indiqué :
*/

FUNCTION example(poly_name VARCHAR2) RETURN OG_Object IS
  object  OG_Object;
BEGIN
  object := OG_Make_Poly;
  OG_Set_Name(Object, poly_name);
  RETURN(object);
END;


OG_Make_Rect

  Exemples	  Rubriques connexes

Description  Cette fonction crée un rectangle.

Syntaxe

FUNCTION OG_Make_Rect
  (position  OG_Point,
   hauteur   NUMBER,
   largeur   NUMBER)
RETURN OG_Object;

Paramètres

position	Coordonnées x et y du rectangle.
hauteur	Hauteur du rectangle.
largeur	Largeur du rectangle.

Retourne  Un identificateur du rectangle nouvellement créé.


OG_Make_Rect - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous crée un rectangle.
*/

FUNCTION example RETURN OG_Object IS
  object  OG_Object;
  pos     OG_Point;
  height  NUMBER;
  width   NUMBER;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;
  height := 4* OG_Inch;
  width := 4* OG_Inch;

  object := OG_Make_Rect(Pos, height, width);
  RETURN(object);
END;


OG_Make_Rrect

  Exemples	  Rubriques connexes

Description  Cette fonction crée un rectangle arrondi.

Syntaxe

FUNCTION OG_Make_Rrect
  (position    OG_Point,
   hauteur     NUMBER,
   largeur     NUMBER)
RETURN OG_Object;

Paramètres

position	Coordonnées x et y du rectangle arrondi.
hauteur	Hauteur du rectangle arrondi.
largeur	Largeur du rectangle arrondi.

Retourne  Un identificateur du rectangle arrondi nouvellement créé.


OG_Make_Rrect - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction ci-dessous crée un rectangle arrondi.
*/

FUNCTION example RETURN OG_Object IS
  object  OG_Object;
  pos     OG_Point;
  height  NUMBER;
  width   NUMBER;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;
  height := 4* OG_Inch;
  width := 4* OG_Inch;

  object := OG_Make_Rrect(Pos, height, width);
  RETURN(object);
END;


OG_Make_Symbol

  Exemples	  Rubriques connexes

Description  Cette fonction crée un symbole.

Syntaxe

FUNCTION OG_Make_Symbol
  (position    OG_Point,
   index       NUMBER,
   taillesym   NUMBER)
RETURN OG_Object;

Paramètres

position	Point central du symbole.
index	Index (ou numéro) de la position du symbole dans la palette de symboles de Builder.
Taillesym	Taille du symbole. La valeur de cet argument peut être l'une des constantes intégrées suivantes : OG_Large_Symsize    OG_Medium_Symsize    OG_Small_Symsize
Retourne  Un indicateur du symbole nouvellement créé.


OG_Make_Symbol - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction suivante crée un symbole :
*/

FUNCTION example RETURN OG_Object IS
  symbol  OG_Object;
  pos     OG_Point;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;

  symbol := OG_Make_Symbol(Pos, 5, OG_Large_Symsize);
  RETURN(symbol);

END;


OG_Make_Text

  Exemples	  Rubriques connexes

Description  Cette fonction crée un objet texte.

Syntaxe

FUNCTION OG_Make_Text
  (position  OG_Point,
RETURN OG_Object;

OG_Make_Text
  (position  OG_Point,
   chaîne    VARCHAR2)
RETURN OG_Object;

OG_Make_Text
  (position    OG_Point,
   string      VARCHAR2,
   taillept    NUMBER)
RETURN OG_Object;

Paramètres

position	Coordonnées x et y de l'objet texte.
chaîne	Chaîne de texte.
taillept	Taille en points.

Retourne  Un identificateur de l'objet texte nouvellement créé.


OG_Make_Text - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La fonction suivante crée un objet texte :
*/

FUNCTION example RETURN OG_Object IS
  object  OG_Object;
  pos     OG_Point;
BEGIN
  pos.x := OG_Inch;
  pos.y := OG_Inch;
  object := OG_Make_Text(Pos, 'Classement des vendeurs');
  RETURN(object);
END;


OG_Move

  Exemples	  Rubriques connexes

Description  Cette procédure fait passer l'objet indiqué à une autre position de la présentation.

Syntaxe

PROCEDURE OG_Move
  (ident_objet   OG_Object,
   décalage      OG_Point,
   dommage       BOOLEAN    :=  TRUE,
   boîte_maj     BOOLEAN    :=  TRUE);

Paramètres

ident_objet	Identificateur de l'objet à déplacer.
décalage	Distance relative de déplacement de l'objet à partir de sa position en cours.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Notez que vous pouvez faire sortir les objets de la présentation en indiquant un décalage entraînant des coordonnées négatives.

Des valeurs positives des composants x et y de décalage déplaceront l'objet vers la droite et le bas. Des valeurs négatives le déplaceront vers la gauche et le haut.

Pour faire passer un objet à une position absolue de la présentation, définissez la nouvelle position dans l'enregistrement d'attributs.


OG_Move - Exemples

  Liste alphabétique           [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un objet qui représente le stock d'un entrepôt.
**Si ce stock est transféré d'un entrepôt à l'autre, il faut
**déplacer l'objet qui le représente.
*/

PROCEDURE move_inventory(invent_obj IN OG_Object) IS
   distance   OG_Point;
BEGIN
   distance.x:=(3*OG_Inch);
   distance.y:=(3*OG_Inch);
   OG_Move(Invent_Obj, distance);
END;


OG_Point_In

  Exemples	  Rubriques connexes

Description  Cette fonction détermine si le point de référence indiqué se trouve dans la région de remplissage d'un objet.

Syntaxe

FUNCTION OG_Point_In
  (ident_objet  OG_Object,
   pt_réf       OG_Point,
   ouverture    OG_Point)
RETURN OG_Object;

FUNCTION OG_Point_In
  (ident_fenêtre  OG_Window,
   pt_réf         OG_Point,
   ouverture      OG_Point)
RETURN OG_Object;

Paramètres

ident_objet	Identificateur de l'objet à vérifier.
ident_fenêtre	Identificateur de la fenêtre à vérifier.
pt_réf	Point de référence.
Ouverture	Distance maximum acceptable à partir du point de référence (utilisée uniquement si ident_objet a un remplissage transparent).

Retourne  Si le point de référence indiqué se trouve dans la région de remplissage d'un objet, la fonction retourne l'identificateur de cet objet. Dans le cas contraire, la fonction retourne un identificateur NULL.

Notes d'utilisation  Cette fonction est surtout intéressante lorsque vous contrôlez l'activité de la souris d'un utilisateur. Par exemple, vous pouvez écrire une procédure bouton pour un objet de groupe et utiliser l'enregistrement d'événements de l'en-tête de la procédure pour déterminer la position de la souris lorsque l'utilisateur la déplace ou clique sur l'un de ses boutons. Vous pouvez alors appeler OG_Point_In ou OG_Point_Near et transmettre l'objet de groupe et les coordonnées de la souris comme arguments. La fonction retournera alors l'objet simple du groupe que l'utilisateur a sélectionné.

Notez que cette fonction détermine uniquement si le point se trouve dans la région de remplissage d'un objet. Si le point se trouve exactement sur le bord d'un objet, cette fonction retourne un identificateur NULL. (La fonction considère que le bord de l'objet est l'épaisseur minimum possible et ne tient pas compte de la surface occupée par un bord épais.) Si l'objet a un motif de remplissage transparent (et n'a donc pas de région de remplissage), la fonction utilise par défaut le comportement de OG_Point_Near.  Notez que l'argument Ouverture n'est pas utilisé par OG_Point_In, mais est transmis à OG_Point_Near si l'objet a un motif de remplissage transparent.

Si vous indiquez comme argument un objet simple, cette fonction vérifie que le point se trouve dans l'objet. Si vous avez indiqué un objet de groupe, cette fonction vérifie chaque membre du groupe (et des sous-groupes) et retourne l'objet simple supérieur dans lequel se trouve le point (ou un identificateur NULL si le point ne se trouve pas dans un objet du groupe). Notez qu'une couche peut être transmise comme objet de groupe. De même, si vous indiquez une fenêtre au lieu d'un objet, cette fonction vérifie chaque objet de la fenêtre.

Si le point se trouve dans plusieurs objets, la fonction retourne l'objet le plus haut dans l'arborescence du groupe.


OG_Point_In - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* L'application permet à l'utilisateur de sélectionner un objet et de le faire glisser
**au-dessus des autres objets d'un groupe. Lorsque l'utilisateur relâche le bouton de la souris, il est nécessaire
**de déterminer l'objet pointé par la souris et de le détruire.
**La procédure ci-dessous peut être utilisée comme procédure bouton pour l'objet qui a été déplacé.
*/

PROCEDURE destroy_target (hitobj IN OG_Object, buttonobj IN
OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
   the_group    OG_Object;
   aper         OG_Point;
   target_obj   OG_Object;
BEGIN
   IF eventinfo.event_type=OG_Mouse_Up THEN
      the_group:=OG_Get_Object('Grand_groupe');
      aper.x:=3*OG_App.HSCREEN_RES;   /* three pixels */
      aper.y:=3*OG_App.VSCREEN_RES;   /* three pixels */
      target_obj:=OG_Point_In(The_Group,
        eventinfo.mouse_position, aper);
      IF not(OG_Isnull(Target_Obj)) THEN
         OG_Destroy(Target_Obj);
      END IF;
   END IF;
END;


OG_Point_Near

  Exemples	  Rubriques connexes

Description  Cette fonction détermine si le point de référence indiqué se trouve sur le bord d'un objet.

Syntaxe

FUNCTION OG_Point_Near
  (ident_objet    OG_Object,
   pt_réf         OG_Point,
   ouverture      OG_Point)
RETURN OG_Object;

FUNCTION OG_Point_Near
  (ident_fenêtre  OG_Window,
   pt_réf         OG_Point,
   ouverture      OG_Point)
RETURN OG_Object;

Paramètres

ident_objet	Identificateur de l'objet à vérifier.
ident_fenêtre	Identificateur de la fenêtre à vérifier.
pt_réf	Point de référence.
Ouverture	Distance maximum acceptable par rapport au point de référence.

Retourne  Si le point de référence indiqué se trouve sur le bord d'un objet, la fonction retourne l'identificateur de cet objet. Dans le cas contraire, la fonction retourne un identificateur NULL.

Notes d'utilisation  Cette fonction est surtout intéressante lorsque vous contrôlez l'activité de la souris d'un utilisateur. Par exemple, vous pouvez écrire une procédure bouton pour un objet de groupe et utiliser l'enregistrement d'événements de l'en-tête de la procédure pour déterminer la position de la souris lorsque l'utilisateur la déplace ou clique sur l'un de ses boutons. Vous pouvez alors appeler OG_Point_In ou OG_Point_Near et transmettre l'objet de groupe et les coordonnées de la souris comme arguments. La fonction retournera alors l'objet simple du groupe que l'utilisateur a sélectionné.

Notez que si l'objet a un motif de bord transparent, cette fonction retourne un identificateur NULL.

Si vous indiquez comme argument un objet simple, cette fonction vérifie que le point se trouve le long du bord de l'objet. Si vous avez spécifié un objet de groupe, cette fonction vérifie chaque membre du groupe (et des sous-groupes) et retourne l'objet simple sur le bord duquel se trouve le point (ou un identificateur NULL si le point ne se trouve pas le long du bord d'un objet du groupe). Notez qu'une couche peut être transmise comme objet de groupe. De même, si vous indiquez une fenêtre au lieu d'un objet, cette fonction vérifie chaque objet de la fenêtre.

L'argument ouverture indique la distance maximum entre le point de référence et le bord d'un objet, et retourne toujours l'identificateur de cet objet. Si la région indiquée par l'ouverture dépasse le bord de l'objet, OG_Point_Near retourne l'identificateur de l'objet. Notez que l'ouverture a un composant x et un composant y.

Si le point se trouve dans plusieurs objets, la fonction retourne l'objet qui se trouve au sommet dans l'arborescence du groupe.

Généralement, vous utiliserez l'ouverture pour donner à l'utilisateur une marge d'erreur qui compensera un positionnement imprécis de la souris. Dans ce cas, vous définirez les composants x et y de l'ouverture à la même valeur, éventuellement l'équivalent de 3 pixels d'écran.


OG_Point_Near - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* L'application permet à l'utilisateur de sélectionner un objet et de le
** faire glisser sur le bord des autres objets d'un groupe. Lorsque l'utilisateur relâche
** le bouton de la souris, il est nécessaire de déterminer le bord de l'objet sur lequel
** pointe la souris et de le détruire. La procédure ci-dessous peut être utilisée comme
** procédure bouton pour l'objet déplacé.
*/

PROCEDURE destroy_target (hitobj IN OG_Object, buttonobj IN
  OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
   the_group    OG_Object;
   aper         OG_Point;
   target_obj   OG_Object;
BEGIN
   IF eventinfo.event_type=OG_Mouse_Up THEN
      the_group:=OG_Get_Object('Grand_groupe');
      aper.x:=3*OG_App.HSCREEN_RES;   /* trois pixels */
      aper.y:=3*OG_App.VSCREEN_RES;   /* trois pixels */
      target_obj:=OG_Point_Near(The_Group,
        eventinfo.mouse_position, aper);
      IF not(OG_Isnull(Target_Obj)) THEN
         OG_Destroy(Target_Obj);
      END IF;
   END IF;
END;


OG_Property_Exists

  Exemples	  Rubriques connexes

Description  Cette fonction détermine si une propriété définie par l'utilisateur a été créée pour un objet donné.

Syntaxe

FUNCTION OG_Property_Exists
  (ident_objet  OG_Object,
   nom_propr   VARCHAR2)
RETURN BOOLEAN;

Paramètres

ident_objet	Identificateur de l'objet contenant la propriété.
nom_propr	Nom de l'objet dont vous voulez vérifier l'existence.
Retourne TRUE	Si la propriété existe.
FALSE	Si la propriété n'existe pas.


OG_Property_Exists - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous ajoute la propriété 'priorité' à un objet, si elle n'existe pas encore :
*/

PROCEDURE example(object OG_Object) IS
BEGIN
  IF NOT OG_Property_Exists(Object, 'priorité') THEN
    OG_Set_Property(Object, 'priorité', 10);
  END IF;
END;


OG_Rotate

  Exemples	  Rubriques connexes

Description  Cette procédure fait pivoter l'objet indiqué du nombre indiqué de degrés, dans le sens inverse des aiguilles d'une montre.

Syntaxe

PROCEDURE OG_Rotate
  (ident_objet   OG_Object,
   pt_centre     OG_Point,
   degrés        NUMBER,
   dommage       BOOLEAN    :=  TRUE,
   boîte_maj     BOOLEAN    :=  TRUE);

Paramètres

ident_objet	Identificateur de l'objet à faire pivoter.
pt_centre	Point de la présentation à utiliser comme centre de rotation.
Degrés	Nombre de degrés dont l'objet doit pivoter dans le sens inverse des aiguilles d'une montre.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.


OG_Rotate - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un affichage contenant un cadran. L'aiguille du cadran
**pointe sur des valeurs données du cadran. Lorsque les données changent,
**l'aiguille doit pivoter pour pointer sur une nouvelle valeur.
*/

PROCEDURE rotate_needle (degrees IN NUMBER,
  center_pt IN OG_Point) IS
   the_needle   OG_Object;
BEGIN
   the_needle:=OG_Get_Object('Aiguille 1');
   OG_Rotate(The_Needle, center_pt, degrees);
END;


OG_Same

  Exemples	  Rubriques connexes

Description  Cette fonction compare les deux identificateurs pour savoir s'il sont identiques. Par exemple, si vous transmettez ces identificateurs de fonction à deux objets, la fonction vérifie si les deux identificateurs pointent sur le même objet.

Syntaxe

FUNCTION OG_Same                             objet
  (ident1  OG_Object,
   ident2  OG_Object)
RETURN BOOLEAN;

FUNCTION OG_Same                             interrogation
  (ident1  OG_Query,
   ident2  OG_Query)
RETURN BOOLEAN;

FUNCTION OG_Same                             modèle de graphique
  (ident1  OG_Template,
   ident2  OG_Template)
   RETURN BOOLEAN;

FUNCTION OG_Same                             procédure bouton
  (ident1  OG_Buttonproc,
   ident2  OG_Buttonproc)
RETURN BOOLEAN;

FUNCTION OG_Same                             son
  (ident1  OG_Sound,
   ident2  OG_Sound)
RETURN BOOLEAN;

FUNCTION OG_Same                             fenêtre
  (ident1  OG_Window,
   ident2  OG_Window)
RETURN BOOLEAN;

FUNCTION OG_Same                             couche
  (ident1  OG_Layer,
   ident2  OG_Layer)
RETURN BOOLEAN;

FUNCTION OG_Same                             horloge
  (ident1  OG_Timer,
   ident2  OG_Timer)
RETURN BOOLEAN;

FUNCTION OG_Same                             affichage
  (ident1  OG_Display,
   ident2  OG_Display)
RETURN BOOLEAN;

FUNCTION OG_Same                             axe
  (ident1  OG_Axis,
   ident2  OG_Axis)
RETURN BOOLEAN;

FUNCTION OG_Same                             modèle de champ
  (ident1  OG_Ftemp,
   ident2  OG_Ftemp)
RETURN BOOLEAN;

FUNCTION OG_Same                             ligne de référence
  (ident1  OG_Refline,
   ident2  OG_Refline)
RETURN BOOLEAN;

Paramètres

ident1	Indique le premier des deux identificateurs à comparer.
ident2	Indique le second des deux identificateurs à comparer.
Retourne TRUE	Si les deux identificateurs sont identiques.
FALSE	Si les deux identificateurs sont différents.

Notes d'utilisation

Cette fonction est nécessaire parce que vous ne pouvez pas utiliser "=" pour comparer les valeurs des identificateurs. Par exemple, la procédure ci-dessous n'est pas valide :

PROCEDURE invalid (obj1 OG_Object, obj2 OG_Object) IS
BEGIN
   IF obj1 = obj2 THEN     --illegal comparison
      NULL;
   END IF;
END;


OG_Same - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit deux objets à comparer pour savoir s'ils sont identiques.
**La fonction ci-dessous retourne TRUE s'ils sont identiques et FALSE dans le cas contraire :
*/

FUNCTION compare (obj1 OG_Object, obj2 OG_Object) RETURN BOOLEAN IS
BEGIN
   IF OG_Same(Obj1, obj2) THEN
      RETURN(TRUE);
   ELSE
      RETURN(FALSE);
   END IF;
END;


OG_Scale

  Exemples	  Rubriques connexes

Description  Cette procédure redimensionne l'objet indiqué.

Syntaxe

PROCEDURE OG_Scale
  (ident_objet   OG_Object,
   ancrage       OG_Point,
   ancpt         OG_Point,
   nouvpt        OG_Point,
   dommage       BOOLEAN    :=  TRUE,
   boîte_maj     BOOLEAN    :=  TRUE);

Paramètres

ident_objet	Identificateur de l'objet à redimensionner.
ancrage	Point d'ancrage de l'objet.
ancpt	Point de départ.
nouvpt	Point d'arrivée.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.

Notes d'utilisation  Pour calculer le facteur d'échelle, la fonction prend la distance entre le nouveau point et le point d'ancrage, et la distance entre l'ancien point et le point d'ancrage. Le rapport de ces deux distances est le facteur d'échelle. La fonction calcule un facteur d'échelle distinct pour les coordonnées x et y.

Ce facteur sera utilisé pour redimensionner la position relative de chacun des points de contrôle de l'objet par rapport au point d'ancrage. Notez que si les facteurs d'échelle x et y sont identiques, l'objet sera redimensionné mais son rapport d'aspect restera identique (c'est-à-dire qu'un carré restera un carré).

Par exemple, pour doubler la taille d'un objet dont le point de contrôle supérieur gauche se trouve à (OG_Inch, OG_Inch), vous pouvez utiliser les valeurs suivantes : ancrage = (OG_Inch, OG_Inch), ancpt = (OG_Inch+1, OG_Inch+1), nouvpt = (OG_Inch+2, OG_Inch+2). Le facteur d'échelle x sera donc (nouvpt.x-ancrage.x) / (ancpt.x-ancrage.x) = (OG_Inch+2-OG_Inch) / (OG_Inch+1-OG_Inch) = 2 / 1 = 2. Le facteur d'échelle y sera donc : (nouvpt.y-ancrage.y) / (ancpt.y-ancrage.y) = (OG_Inch+2-OG_Inch) / (OG_Inch+1-OG_Inch) = 2 / 1 = 2.

Ce facteur sera utilisé pour redimensionner la distance entre le point d'ancrage et chacun des points de contrôle de l'objet. Pour reprendre l'exemple ci-dessus, si le facteur d'échelle est 2 et si le point de contrôle supérieur droit de l'objet se trouve à 1,5 pouces à droite du point d'ancrage, le point de contrôle sera déplacé à 3 pouces à droite du point d'ancrage. Les autres points de contrôle de l'objet seront déplacés de la même façon.

Notez que si un point de contrôle est utilisé comme point d'ancrage, sa position ne changera pas (puisque la distance entre le point de contrôle et le point d'ancrage sera égale à 0).

Vous pouvez également utiliser cette procédure pour redimensionner l'objet indiqué, comme si vous aviez utilisé un outil de sélection pour sélectionner un point de contrôle et le faire glisser à un autre endroit de la présentation. Le point d'ancrage est le point de contrôle qui ne se déplace pas pendant l'opération (le point se trouvant diagonalement opposé au point que vous feriez glisser sur la présentation). Le point de contrôle que vous voulez déplacer est ancpt, et nouvpt est la nouvelle position à laquelle vous voulez le faire passer.


OG_Scale - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Pour doubler la taille de l'objet que l'utilisateur sélectionne,
** le centre de l'objet se trouvant à (OG_Inch, OG_Inch), et ce point étant
** utilisé comme point d'ancrage, exécuter la procédure ci-dessous :
*/

PROCEDURE double (buttonobj IN OG_Object, hitobj IN
  OG_Object, win IN OG_Window, eventinfo IN OG_Event) IS
   anchor OG_Point;
   newpt OG_Point;
   oldpt OG_Point;
BEGIN
   anchor.x:=OG_Inch;
   anchor.y:=OG_Inch;
   oldpt.x:=OG_Inch+1;
   oldpt.y:=OG_Inch+1;
   newpt.x:=OG_Inch+2;
   newpt.y:=OG_Inch+2;
   OG_Scale(Hitobj, anchor, oldpt, newpt);
END;


OG_Set_Edgecolor

  Exemples	  Rubriques connexes

Description  Cette procédure définit la couleur du bord de l'objet indiqué. Elle définit le motif du bord à 'transparent' et la couleur de bord de l'arrière-plan à la couleur indiquée.

Syntaxe

PROCEDURE OG_Set_Edgecolor
  (objet        OG_Object,
   couleur      VARCHAR2
   dommage      BOOLEAN    :=  TRUE,
   boîte_maj    BOOLEAN    :=  TRUE);

Paramètres

objet	Identificateur de l'objet à modifier.
couleur	Nom de la couleur.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.


OG_Set_Edgecolor - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit la couleur du bord de l'objet indiqué :
*/

PROCEDURE example(object OG_Object) IS
BEGIN
  OG_Set_Edgecolor(Object, 'rouge');
END;


OG_Set_Fillcolor

  Exemples	  Rubriques connexes

Description  Cette procédure définit la couleur de remplissage de l'objet indiqué. Elle définit le motif de remplissage à 'transparent' et la couleur de remplissage de l'arrière-plan à la couleur indiquée.

Syntaxe

PROCEDURE OG_Set_Fillcolor
  (objet       OG_Object,
   couleur     VARCHAR2
   dommage     BOOLEAN    :=  TRUE,
   boîte_maj   BOOLEAN    :=  TRUE);

Paramètres

objet	Identificateur de l'objet à modifier.
couleur	Nom de la couleur.
Dommage	Indicateur de dommage.
boîte_maj	Indicateur de mise à jour de la boîte englobante.


OG_Set_Fillcolor - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit la couleur de remplissage de l'objet indiqué :
*/

PROCEDURE example(object OG_Object) IS
BEGIN
  OG_Set_Fillcolor(Object, 'rouge');
END;


OG_Set_Property

  Exemples	  Rubriques connexes

Description  Cette procédure définit la valeur de la propriété, définie par l'utilisateur, d'un objet.

Syntaxe

PROCEDURE OG_Set_Property                    date
  (ident_objet   OG_Object,
   nom_ prop     VARCHAR2,
   valeur_propr  VARCHAR2,
   fmt_date      VARCHAR2   := 'DD-MON-YY');

PROCEDURE OG_Set_Property                    nombre
  (ident_objet   OG_Object,
   nom_propr     VARCHAR2,
   valeur_propr  NUMBER);

PROCEDURE OG_Set_Property                    graphique
  (ident_objet   OG_Object,:
   nom_propr     VARCHAR2,
   valeur_propr  VARCHAR2,);

Paramètres

ident_objet	Identificateur de l'objet dont vous voulez définir la propriété.
nom_propr	Nom de la propriété à définir.
valeur_propr	Valeur à laquelle la propriété sera définie.
fmt_date	Masque de format de date pour la conversion de la chaîne de caractères valeur_propr en une date.

Notes d'utilisation  Si la propriété existe, cette procédure change sa valeur. Si elle n'existe pas, cette procédure la crée et définit sa valeur sans générer d'erreur.


OG_Set_Property - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous lit la propriété 'priorité' de chaque objet fils
**d'un groupe, puis la définit à une valeur supérieure d'une unité à sa valeur en cours :
*/

PROCEDURE example(group_name VARCHAR2) IS
  group_obj    OG_Object;
  child_count  NUMBER;
  child_obj    OG_Object;
  current_p    NUMBER;
BEGIN
  group_obj := OG_Get_Object(Group_Name);
  child_count := OG_Get_Childcount(Group_Obj);

  FOR i IN 0..child_count-1 LOOP
    child_obj := OG_Get_Child(Group_Obj, i);
    current_p := OG_Get_Num_Property(Child_Obj, 'priorité');
    OG_Set_Property(Child_Obj, 'priorité', current_p + 1);
  END LOOP;
END;


OG_Synchronize

  Exemples	  Rubriques connexes

Description  Cette procédure redessine les régions endommagées dans toutes les fenêtres. Elle synchronise les descriptions internes de tous les objets et leurs représentations visuelles.

Syntaxe

PROCEDURE OG_Synchronize;

Paramètres

Aucun.

Notes d'utilisation  Notez que, dans vos propres programmes PL/SQL, une procédure OG_Synchronize implicite est exécutée à la fin de la procédure ou de la fonction de niveau supérieur qui est appelée.


OG_Synchronize - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* Soit un objet à déplacer sur l'affichage en dix incréments d'un quart de pouce.
**Au lieu de le déplacer plusieurs fois et de déclencher sa mise à jour visuelle uniquement à la fin
**de la procédure, il est possible de synchroniser la présentation et la
**représentation interne de l'objet après chaque déplacement.
*/

PROCEDURE slide_across(the_object IN OG_Object) IS
   offset   OG_Point;
BEGIN
   offset.x:=(1/4)*OG_Inch;
   offset.y:=0;
   FOR i IN 1..10 LOOP
      move(the_object, offset);
      OG_Synchronize;
   END LOOP;
END;


OG_Update_Bbox

  Exemples	  Rubriques connexes

Description  Cette fonction met à jour la ou les boîtes englobantes d'un objet. Si l'objet est un groupe, les boîtes englobantes de tous ses descendants sont également mises à jour.

Syntaxe

PROCEDURE OG_Update_Bbox
  (ident_objet  OG_Object,
   boîte_engl  NUMBER);

Paramètres

ident_objet	Identificateur de l'objet à mettre à jour.
boîte_engl	Boîte englobante : intérieure ou extérieure. La valeur de cet argument peut être l'une des constantes intégrées suivantes :  OG_Bothbbox   Indique la mise à jour de la boîte englobante intérieure et de la boîte englobante extérieure. OG_Innerbbox   Indique la mise à jour de la boîte englobante intérieure uniquement. OG_Outerbbox   Indique la mise à jour de la boîte englobante extérieure uniquement.


OG_Update_Bbox - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*Soit un objet à déplacer. Par défaut,
**la procédure interne OG_Move met à jour les boîtes
**englobantes de tous les antécédents de l'objet modifié,
**y compris la couche sur laquelle réside l'objet. Pour mettre à jour les
**boîtes englobantes d'une couche, Graphics Builder doit examiner chaque objet
**de la couche. Si la couche contient un grand nombre d'objets, cette
**opération peut être extrêmement longue.*/

 /*Pour optimiser l'application, il est possible de déplacer
**l'objet tout en bloquant cette mise à jour automatique des boîtes englobantes,
**puis de mettre explicitement à jour uniquement les boîtes englobantes de cet objet.
**(Il faut noter que comme la mise à jour automatique des boîtes englobantes n'est pas
**effectuée, les boîtes englobantes des antécédents de l'objet peuvent ne pas
**être précises.)
*/

/*Lors de la modification d'un objet avec un indicateur de mise à jour de boîte englobante FALSE,
**il peut aussi être souhaitable d'utiliser un indicateur de dommage FALSE.
**Dans ce cas, une fois les modifications de l'objet terminées, un appel à
**OG_Damage permet d'endommager explicitement l'objet.
*/

PROCEDURE move_efficiently (the_object OG_Object) IS
   offset   OG_Point;
BEGIN
   offset.x:=OG_Inch;
   offset.y:=OG_Inch;
   OG_Move(The_Object, offset, FALSE, FALSE)
   OG_Update_Bbox(The_Object, OG_Bothbbox);
   OG_Damage(The_Object);

END;


Aucun sous-programme interne ne commence par cette lettre.


Liste alphabétique des sous-programmes intégrés de propriété

Propriété active (horloge)

Propriété de style de flèche (ligne)

Propriété de maximum auto (axe continu)

Propriété de maximum auto (axe de date)

Propriété de maximum auto (axe discret)

Propriété de maximum auto (encadrement, graphique de type tableau)

Propriété de minium auto (axe continu)

Propriété de minium auto (axe de date)

Propriété de minium auto (axe discret)

Propriété de minium auto (encadrement, graphique de type tableau)

Propriété d'intervalle auto (axe continu)

Propriété d'intervalle auto (axe de date)

Propriété de mise à jour auto (graphique)

Propriété d'étiquette d'axe (axe générique)

Propriété d'axe (modèle de champ, graphique à axes)

Propriété d'axe (ligne de référence)

Propriété de type d'axe (axe générique)

Propriété de couleur d'arrière-plan du bord (graphique)

Propriété de couleur de remplissage d'arrière-plan (graphique)

Propriété d'arc de base (arc)

Propriété de rectangle de base (rectangle)

Propriété de rectangle de base (rectangle arrondi)

Propriété d'axes de ligne de base (graphique, graphique à axes)

Propriété de valeur de ligne de base (graphique, graphique à axes)

Propriété de style de relief (graphique)

Propriété de largeur de boîte englobante (texte)

Propriété de hauteur de boîte englobante (texte)

Propriété de procédure bouton (élément de graphique)

Propriété de procédure bouton (générique)

Propriété de type de tampon (interrogation)

Propriété de style d'extrémité (graphique)

Propriété de catégories (encadrement, graphique à secteurs)

Propriété de format de date de catégorie (encadrement, graphique à secteurs)

Propriété de format numérique de catégorie (encadrement, graphique à secteurs)

Propriété de largeur de catégorie (encadrement, graphique à axes)

Propriété de centre (symbole)

Propriété de jeu de caractères (texte)

Propriété de nombre de fils (groupe)

Propriété d'indicateur de clipping (groupe)

Propriété de rectangle clipping (image)

Propriété de déclencheur de fermeture (affichage)

Propriété de fermeture (arc)

Propriété de fermeture (polygone)

Propriété de couleur (texte simple)

Propriété de couleur (texte)

Propriété de noms de colonne (encadrement, graphique de type tableau)

Propriété de colonne (générique)

Propriété de nombre de textes composés (texte)

Propriété de chaîne de connexion (application)

Propriété de chaîne de connexion (application)

Propriété de nombre de copies (imprimante)

Propriété de rayons d'angle (rectangle arrondi)

Propriété de curseur (application)

Propriété de lissage de courbe (modèle de champ, graphique à axes)

Propriété de format de date personnalisé (encadrement, graphique à axes)

Propriété de format personnalisé (axe de date)

Propriété d'étiquette personnalisée (axe générique)

Propriété de format numérique personnalisé (encadrement, graphique à axes)

Propriété de procédure d'interrogation personnalisée (interrogation)

Propriété d'espacement personnalisé (texte)

Propriété de style de pointillé (graphique)

Propriété de valeurs de données (encadrement, graphique à secteurs)

Propriété de format de date (axe discret)

Propriété de format de date (affichage)

Propriété de format de date (interrogation)

Propriété de valeur de date (ligne de référence)

Propriété de format de jour (axe de date)

Propriété de profondeur (encadrement générique)

Propriété de direction (axe générique)

Propriété de tramage (image)

Propriété de motifs de bord (graphique)

Propriété de largeur de bord (graphique)

Propriété de dernière page (imprimante)

Propriété de point final (ligne)

Propriété de dernière ligne (graphique)

Propriété d'événements (élément de graphique)

Propriété d'événements (générique)

Propriété d'exécution sur ouverture (interrogation)

Propriété d'exécution sur horloge (interrogation)

Propriété d'exécution d'interrogation (générique)

Propriété d'explosion (élément de graphique)

Propriété de nombres de modèle de champ (encadrement générique)

Propriété de motif de remplissage (graphique)

Propriété de remplissage (arc)

Propriété de filtre (graphique)

Propriété de premier mois (axe de date)

Propriété de boîte englobante fixe (texte)

Propriété de couleur de premier plan du bord (graphique)

Propriété de couleur de remplissage de premier plan (graphique)

Propriété de police (texte simple)

Propriété de déclencheur de format (générique)

Propriété de type d'encadrement (encadrement générique)

Propriété de nombre de lignes de séparation (encadrement, graphique de type tableau)

Propriété de hauteur (affichage)

Propriété de hauteur (image)

Propriété de hauteur (fenêtre)

Propriété de cible d'aide (fenêtre)

Propriété d'alignement horizontal (texte)

Propriété de ligne de séparation horizontale (encadrement, graphique de type tableau)

Propriété de résolution horizontale de présentation (application)

Propriété d'origine horizontale (texte)

Propriété de résolution horizontale d'écran (application)

Propriété d'index (symbole)

Propriété de boîte englobante intérieure (générique)

Propriété d'intervalle (horloge)

Propriété invisible (texte)

Propriété de style de jointure (graphique)

Propriété de crénage (texte)

Propriété d'étiquette (ligne de référence)

Propriété de rotation d'étiquette (modèle de champ, graphique à axes)

Propriété d'étiquettes (axe de  date)

Propriété paysage (imprimante)

Propriété de nombre de colonnes de légende (encadrement générique)

Propriété de légende (encadrement générique)

Propriété de style de ligne (modèle de champ, graphique à axes)

Propriété de grille principale (axe générique)

Propriété de repères principaux (axe générique)

Propriété de nombre maximum de catégories (axe discret)

Propriété de nombre maximum de lignes (encadrement, graphique de type tableau)

Propriété de maximum (axe continu)

Propriété de maximum (axe de date)

Propriété de nombre maximum de lignes (interrogation)

Propriété de nombre minimum de catégories (axe discret)

Propriété de nombre minimum de lignes (encadrement, graphique de type tableau)

Propriété de minimum (axe continu)

Propriété de minimum (axe de date)

Propriété de graduation secondaire (axe générique)

Propriété de graduation secondaire par intervalle (axe générique)

Propriété de graduation secondaire (axe générique)

Propriété de format de mois (axe de date)

Propriété de nom (élément de graphique)

Propriété de nom (encadrement générique)

Propriété de nom (modèle de champ générique)

Propriété de nom (modèle de champ générique)

Propriété de nom (générique)

Propriété de nom (imprimante)

Propriété de nom (interrogation)

Propriété de nom (son)

Propriété de nom (horloge)

Propriété de nom (fenêtre)

Propriété la plus proche (texte)

Propriété d'absence de chevauchement (encadrement, graphique à secteurs)

Propriété de format numérique (axe discret)

Propriété de format numérique (axe continu)

Propriété de valeur (ligne de référence)

Propriété de type d'objet (générique)

Propriété de déclencheur d'ouverture (affichage)

Propriété de point d'origine (texte)

Propriété Autres (encadrement, graphique à secteurs)

Propriété de boîte englobante extérieure (générique)

Propriété de chevauchement (modèle de champ, graphique à axes)

Propriété de format de page (imprimante)

Propriété de père (générique)

Propriété de mot de passe (application)

Propriété de pourcentage par rapport (axe continu)

Propriété de pourcentage de (axe continu)

Propriété de valeurs de pourcentage (encadrement, graphique à secteurs)

Propriété de plate-forme (application)

Propriété d'encadrement de tracé (encadrement générique)

Propriété d'ordre de tracé (encadrement, graphique à secteurs)

Propriété de position de traçage (modèle de champ, graphique à axes)

Propriété de type de traçage (modèle de champ, graphique à axes)

Propriété de nombre de points (polygone)

Propriété de taille en points (texte)

Propriété de position (axe générique)

Propriété de position (image)

Propriété de position (fenêtre)

Propriété de déclenchement après interrogation (interrogation)

Propriété de fichier d'impression (imprimante)

Propriété de procédure (horloge)

Propriété  de qualité (image)

Propriété de format de trimestre (axe de date)

Propriété d'interrogation (graphique)

Propriété de source d'interrogation (interrogation)

Propriété de type d'interrogation (interrogation)

Propriété de plage (graphique)

Propriété de nombre de lignes de référence (encadrement, graphique à axes)

Propriété de racine (encadrement générique)

Propriété de racine (modèle de champ générique)

Propriété d'angle de rotation (graphique)

Propriété de boîte englobante pouvant être mise à l'échelle (texte)

Propriété de police pouvant être mise à l'échelle (texte)

Propriété d'échelle (axe continu)

Propriété de second axe des Y (encadrement, graphique à axes)

Propriété de définition de paramètre (générique)

Propriété d'orientation de l'ombre (encadrement générique)

Propriété de taille d'ombre (encadrement générique)

Propriété de nombre de textes simples (texte composé)

Propriété de taille et de position (graphique)

Propriété de saut de week-end (axe de date)

Propriété d'espacement (texte)

Propriété de première page (imprimante)

Propriété de point de départ (ligne)

Propriété de ligne de début (graphique)

Propriété d'intervalle (axe continu)

Propriété d'intervalle (axe de date)

Propriété de style (texte)

Propriété de taille de symbole (symbole)

Propriété de synthétisation (texte)

Propriété de modèle (graphique)

Propriété de chaîne de texte (texte simple)

Propriété de rotation d'étiquette de graduation (axe générique)

Propriété d'étiquettes de graduation (axe générique)

Propriété de position de graduation (axe générique)

Propriété de repères (encadrement, graphique à secteurs)

Propriété de titre (graphique)

Propriété de mode de transfert (graphique)

Propriété de police de caractères (texte)

Propriété d'utilisation (encadrement, graphique à secteurs)

Propriété de valeur d'utilisation (encadrement, graphique à secteurs)

Propriété de nom utilisateur (application)

Propriété de format de valeur (encadrement, graphique à secteurs)

Propriété d'alignement vertical (texte)

Propriété de ligne se séparation verticale (encadrement, graphique de type tableau)

Propriété de résolution verticale de présentation (application)

Propriété d'origine verticale (texte)

Propriété de résolution verticale d'écran (application)

Propriété de graisse (texte)

Propriété de largeur (affichage)

Propriété de largeur (image)

Propriété de largeur (texte)

Propriété de largeur (fenêtre)

Propriété de passage automatique à la ligne (texte)


Aucun sous-programme intégré ne commence par cette lettre.


Propriétés d'axe (de date)

Propriété de maximum auto

Propriété de minimum auto

Propriété d'intervalle auto

Propriété de format personnalisé

Propriété de format de jour

Propriété de premier mois

Propriété d'étiquettes

Propriété de maximum

Propriété de minimum

Propriété de format de mois

Propriété de format de trimestre

Propriété de saut de week-end

Propriété d'intervalle

Propriété de format d'année


Propriété de maximum auto

  Exemples	  Rubriques connexes

Description  Indique si la valeur du maximum de l'axe est définie à Auto.

Syntaxe

PROCEDURE OG_Set_Date_Automax
  (axis     OG_Axis,
   automax  BOOLEAN,
   maximun  DATE);

FUNCTION OG_Get_Date_Automax
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
automax	Indique si la valeur du maximum de l'axe est définie à Auto.
maximun	Valeur du maximum de l'axe (si automax est défini à FALSE).


Propriété de maximum auto - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**le maximum de date de l'axe Y1 est défini à Auto. Si
**la valeur de retour est TRUE, fait revenir la valeur à
**FALSE avec default_max; si la valeur
**de retour est FALSE, fait revenir la valeur à
**TRUE après lecture de la valeur
**du maximum de l'axe indiquée.
/*

PROCEDURE datemax IS
  template	og_template;
  axis 	og_axis;
  val1 	date;
  val2 	boolean;
  default_max date := '06-dec-99';
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val2 := og_get_date_automax(axis);
  if val2 = true then
    og_set_date_automax(axis, false, default_max);
    val1 := og_get_date_maximum(axis);
  elsif val2 = false then
   og_set_date_automax(axis, true, default_max);
  end if;
END;


Propriété de minimum auto

  Exemples	  Rubriques connexes

Description  Indique si la valeur du minimum de l'axe est définie à Auto.

Syntaxe

PROCEDURE OG_Set_Date_Automin
  (axis     OG_Axis,
   automin  BOOLEAN,
   minimun  DATE);

FUNCTION OG_Get_Date_Automin
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
automin	Indique si la valeur du minimum de l'axe est définie à Auto.
minimun	Valeur du minimum de l'axe (si automin est défini à FALSE).


Propriété de minimum auto - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**le minimum de date de l'axe Y1 est défini à Auto. Si
**la valeur de retour est TRUE, fait revenir la valeur à
**FALSE avec default_min; si la valeur de retour
**est FALSE, fait revenir la valeur à
**TRUE après lecture de la valeur
**du minimum de l'axe indiquée.
*/

PROCEDURE datemin IS
  template 	og_template;
  axis 	og_axis;
  val1 	date;
  val2 	boolean;
 default_min	date := '01-dec-79';
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val2 := og_get_date_automin(axis);
  if val2 = true then
    og_set_date_automin(axis, false, default_min);
    val1 := og_get_date_minimum(axis);
  elsif val2 = false then
    og_set_date_automin(axis, true, default_min);
  end if;
END;


Propriété d'intervalle auto

  Exemples	  Rubriques connexes

Description  Indique si la valeur des intervalles de l'axe est définie à Auto.

Syntaxe

PROCEDURE OG_Set_Date_Autostep
  (axis      OG_Axis,
   autostep  BOOLEAN,
   step      NUMBER);

FUNCTION OG_Get_Date_Autostep
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
autostep	Indique si la valeur des intervalles de l'axe est définie à Auto.
step	Valeur des intervalles de l'axe (si autostep est défini à FALSE).


Propriété d'intervalle auto - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**l'intervalle de date de l'axe Y1 est défini à Auto. Si
**la valeur de retour est TRUE, fait revenir la valeur à
**FALSE avec default_step; si la valeur
**de retour est FALSE, fait revenir la valeur à
**TRUE après lecture de la valeur
**d'intervalle indiquée.
*/

PROCEDURE datestep IS
  template 	og_template;
  axis 	og_axis;
  val  	boolean;
  num  	number;
  default_step number := og_second_step;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val:= og_get_date_autostep(axis);
  if val = true then
    og_set_date_autostep(axis, false, default_step);
    num := og_get_date_step(axis);
  elsif val = false then
    og_set_date_autostep(axis, true, default_step);
  end if;
END;


Propriété de format personnalisé

  Exemples	  Rubriques connexes

Description  Format de date personnalisé pour les étiquettes de graduation d 'axe. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

PROCEDURE OG_Set_Custfmt
  (axis     OG_Axis,
   custfmt  VARCHAR2);

FUNCTION OG_Get_Custfmt
  (axis  OG_Axis)
RETURN VARCHAR2;

Paramètres

axis	Objet axe décrit.
custfmt	Format de date personnalisé pour les étiquettes de graduation d 'axe.


Propriété de format personnalisé - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la
**valeur de format personnalisé et la compare
**à la variable 'default_format';
**si les deux valeurs sont différentes,
**fait revenir le format en cours à
**la valeur de 'default_format'.
*/

PROCEDURE customfmt IS
  template 	og_template;
  axis 	og_axis;
  val  	varchar2(10);
  default_format varchar2(10) := 'JJ_AA_MM';
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_custfmt(axis);
  if val != default_format then
    og_set_custfmt(axis, default_format);
  end if;
END;


Aucun sous-programme intégré ne commence par cette lettre.


Propriété de format de jour

  Exemples	  Rubriques connexes

Description  Aspect, sur l'axe, des libellés de jour de la semaine. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Firstletter_Fmt

OG_Threeletter_Fmt

Syntaxe

PROCEDURE OG_Set_Dayfmt
  (axis    OG_Axis,
   dayfmt  NUMBER);

FUNCTION OG_Get_Dayfmt
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
dayfmt	Aspect, sur l'axe, des libellés de jour de la semaine.


Propriété de format de jour - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie
**le format des jours de la semaines. Si le format en cours est
**First-Letter, fait revenir la valeur à
**Three-Letter, et vice versa.
*/

PROCEDURE dayfmt IS
  template 	og_template;
  axis 	og_axis;
  num  	number;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  num:= og_get_dayfmt(axis);
  if num = og_firstletter_fmt then
    og_set_dayfmt(axis, og_threeletter_fmt);
  elsif num = og_threeletter_fmt then
    og_set_dayfmt(axis, og_firstletter_fmt);
  end if;
END;


Propriété de premier mois

  Exemples	  Rubriques connexes

Description  Mois considéré comme le premier d'une nouvelle année. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Jan_Month

OG_Feb_Month

OG_Mar_Month

OG_Apr_Month

OG_May_Month

OG_Jun_Month

OG_Jul_Month

OG_Aug_Month

OG_Sep_Month

OG_Oct_Month

OG_Nov_Month

OG_Dec_Month

Syntaxe

PROCEDURE OG_Set_Firstmon
  (axis      OG_Axis,
   firstmon  NUMBER);

FUNCTION OG_Get_Firstmon
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
firstmon	Mois considéré comme le premier d'une nouvelle année.


Propriété de premier mois - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**la valeur du premier mois et la réinitialise à
**la prochaine valeur acceptable.
*/

PROCEDURE firstmonth IS
  template 	og_template;
  axis 	og_axis;
  num  	number;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  num:= og_get_firstmon(axis);
  if num = og_jan_month then
    og_set_firstmon(axis, og_feb_month);
  elsif num = og_feb_month then
    og_set_firstmon(axis, og_mar_month);
  elsif num = og_mar_month then
    og_set_firstmon(axis, og_apr_month);
  elsif num = og_apr_month then
    og_set_firstmon(axis, og_may_month);
  elsif num = og_may_month then
    og_set_firstmon(axis, og_jun_month);
  elsif num = og_jun_month then
    og_set_firstmon(axis, og_jul_month);
  elsif num = og_jul_month then
    og_set_firstmon(axis, og_aug_month);
  elsif num = og_aug_month then
    og_set_firstmon(axis, og_sep_month);
  elsif num = og_sep_month then
    og_set_firstmon(axis, og_oct_month);
  elsif num = og_oct_month then
    og_set_firstmon(axis, og_nov_month);
  elsif num = og_nov_month then
    og_set_firstmon(axis, og_dec_month);
  else og_set_firstmon(axis, og_jan_month);
  end if;
END;


Propriété d'étiquettes

  Exemples	  Rubriques connexes

Description  Intervalle principal sur l'axe où les marques et les étiquettes de graduation principales s'affichent, et aspect des étiquettes de graduation. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_No_Labels

OG_Second_Labels

OG_Minute_Labels

OG_Hour_Labels

OG_Ampm_Labels

OG_Day_Labels

OG_Dayofweek_Labels

OG_Week_Labels

OG_Month_Labels

OG_Quarter_Labels

OG_Year_Labels

OG_Custom_Labels   (si labels est défini à cette valeur, vous devez indiquer le format de date personnalisée dans la propriété Custom Format.)

Syntaxe

PROCEDURE OG_Set_Labels
  (axis    OG_Axis,
   labels  NUMBER);

FUNCTION OG_Get_Labels
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
labels	Intervalle principal sur l'axe où les marques et les étiquettes de graduation principales s'affichent, et aspect des étiquettes de graduation.


Propriété d'étiquettes - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous détermine
**si des cases d'étiquettes sont cochées.
**Dans l'affirmative, toutes les coches
**sont supprimées ; dans la négative,
**la procédure vérifie la case à
**cocher 'Année'
*/

PROCEDURE labels IS
  template 	og_template;
  axis 	og_axis;
  num  	number;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);

  num:= og_get_labels(axis);
  if num != og_no_labels then
    og_set_labels(axis, og_no_labels);
  else og_set_labels(axis, og_year_labels);
  end if;
END;


Propriété de maximum

  Exemples	  Rubriques connexes

Description  Valeur du maximum de l'axe (si Auto Maximum est défini à FALSE).

Syntaxe

(Voir OG_Set_Date_Automax, ci-dessus.)

FUNCTION OG_Get_Date_Maximum
  (axis  OG_Axis)
RETURN DATE;

Paramètres

axis	Objet axe décrit.


Propriété de maximum - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**le maximum de date de l'axe Y1 est défini à Auto.
**Si la valeur de retour est TRUE,
**fait revenir la valeur à
**FALSE avec default_max; si la valeur
**de retour est FALSE, fait revenir la valeur à
**TRUE après lecture de la valeur
**d'axe maximum indiquée.
/*

PROCEDURE datemax IS
  template	og_template;
  axis 	og_axis;
  val1 	date;
  val2 	boolean;
  default_max date := '06-dec-99';
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val2 := og_get_date_automax(axis);
  if val2 = true then
    og_set_date_automax(axis, false, default_max);
    val1 := og_get_date_maximum(axis);
  elsif val2 = false then
   og_set_date_automax(axis, true, default_max);
  end if;
END;


Propriété de minimum

  Exemples	  Rubriques connexes

Description Valeur du minimum de l'axe (si Auto Minimum est défini à FALSE).

Syntaxe

(See OG_Set_Date_Automin.)

FUNCTION OG_Get_Date_Minimum
  (axis  OG_Axis)
RETURN DATE;

Paramètres

axis	Objet axe décrit.


Propriété de minimum - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**le minimum de date de l'axe Y1 est défini à Auto.
**Si la valeur de retour est TRUE,
**fait revenir la valeur à FALSE avec default_min; si la valeur
**de retour est FALSE, fait revenir la valeur à
**TRUE après lecture de la valeur
**d'axe minimum indiquée.
/*

PROCEDURE datemin IS
  template 	og_template;
  axis 	og_axis;
  val1 	date;
  val2 	boolean;
 default_min	date := '01-dec-79';
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val2 := og_get_date_automin(axis);
  if val2 = true then
    og_set_date_automin(axis, false, default_min);
    val1 := og_get_date_minimum(axis);
  elsif val2 = false then
    og_set_date_automin(axis, true, default_min);
  end if;
END;


Propriété de format de mois

  Exemples	  Rubriques connexes

Description  Aspect, sur l'axe, des libellés de mois.  La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Firstletter_Fmt

OG_Threeletter_Fmt

Syntaxe

PROCEDURE OG_Set_Monthfmt
  (axis      OG_Axis,
   monthfmt  NUMBER);

FUNCTION OG_Get_Monthfmt
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
monthfmt	Aspect, sur l'axe, des libellés de mois.


Propriété de format de mois - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie le format
**du mois. Si le format en cours est
**First-Letter, fait revenir la valeur
**à Three-Letter,
**et vice versa.
*/

PROCEDURE monthfmt IS
  template 	og_template;
  axis 	og_axis;
  num  	number;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  num:= og_get_monthfmt(axis);
  if num = og_firstletter_fmt then
    og_set_monthfmt(axis, og_threeletter_fmt);
  elsif num = og_threeletter_fmt then
    og_set_monthfmt(axis, og_firstletter_fmt);
  end if;
END;


Propriété de format de trimestre

  Exemples	  Rubriques connexes

Description  Aspect, sur l'axe, des libellés de trimestre.  La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Arabic_Fmt

OG_Roman_Fmt

Syntaxe

PROCEDURE OG_Set_Qtrfmt
  (axis    OG_Axis,
   qtrfmt  NUMBER);

FUNCTION OG_Get_Qtrfmt
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
qtrfmt	Aspect, sur l'axe, des libellés de trimestre.


Propriété de format de trimestre - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie le
**format du trimestre. Si le format en cours est
**Arabic, fait revenir le format
**à Roman, et vice versa.
*/

PROCEDURE qtrfmt IS
  template 	og_template;
  axis 	og_axis;
  num  	number;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  num:= og_get_qtrfmt(axis);
  if num = og_arabic_fmt then
    og_set_qtrfmt(axis, og_roman_fmt);
  elsif num = og_roman_fmt then
    og_set_qtrfmt(axis, og_arabic_fmt);
  end if;
END;


Propriété de saut de week-end

  Exemples	  Rubriques connexes

Description  Indique si les week-ends sont pris en compte pour le calcul des valeurs d'axe.

Syntaxe

PROCEDURE OG_Set_Skipwknds
  (axis       OG_Axis,
   skipwknds  BOOLEAN);

FUNCTION OG_Get_Skipwknds
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
skipwknds	Indique si les week-ends sont pris en compte pour le calcul des valeurs d'axe.


Propriété de saut de week-end - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**les week-ends sont pris en compte lors du calcul
**des valeurs d'axe. Si la valeur de saut de week-end
**est définie à TRUE (week-ends non pris en compte), la procédure
**fait revenir la valeur à FALSE (inclure
**dans le calcul) et vice versa.
*/

PROCEDURE skipwknds IS
  template 	og_template;
  axis 	og_axis;
  val  	boolean;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val:= og_get_skipwknds(axis);
  if val = true then
    og_set_skipwknds(axis, false);
  elsif val = false then
    og_set_skipwknds(axis, true);
  end if;
END;


Propriété d'intervalle

  Exemples	  Rubriques connexes

Description  Valeur des intervalles de l'axe (si Auto Step est défini à FALSE).  La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Second_Step

OG_Minute_Step

OG_Hour_Step

OG_Day_Step

OG_Week_Step

OG_Month_Step

OG_Quarter_Step

OG_Year_Step

Syntaxe

(See OG_Set_Date_Autostep.)

FUNCTION OG_Get_Date_Step
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.


Propriété d'intervalle - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**l'intervalle de date de l'axe Y1 de l'axe est défini à Auto.
**Si la valeur de retour est TRUE, fait revenir
**la valeur à FALSE avec default_step; si la valeur
**de retour est FALSE, fait revenir la valeur à
**TRUE après lecture de la valeur
**d'intervalle
**indiquée.
*/

PROCEDURE datestep IS
  template 	og_template;
  axis 	og_axis;
  val  	boolean;
  num  	number;
  default_step number := og_second_step;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val:= og_get_date_autostep(axis);
  if val = true then
    og_set_date_autostep(axis, false, default_step);
    num := og_get_date_step(axis);
  elsif val = false then
    og_set_date_autostep(axis, true, default_step);
  end if;
END


Propriété de format d'année

  Exemples	  Rubriques connexes

Description  Aspect, sur l'axe, des libellés d'année.  La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Fourdigit_Fmt

OG_Twodigit_Fmt

Syntaxe

PROCEDURE OG_Set_Yearfmt
  (axis     OG_Axis,
   yearfmt  NUMBER);

FUNCTION OG_Get_Yearfmt
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
yearfmt	Aspect, sur l'axe, des libellés d'année.


Propriété de format d'année - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie le format
**de l'année. Si le format en cours est Two-Digit,
**fait revenir la valeur à
**Four-Digit, et vice versa.
*/

PROCEDURE yearfmt IS
  template 	og_template;
  axis 	og_axis;
  num  	number;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  num:= og_get_yearfmt(axis);
  if num = og_fourdigit_fmt then
    og_set_yearfmt(axis, og_twodigit_fmt);
  elsif num = og_twodigit_fmt then
    og_set_yearfmt(axis, og_fourdigit_fmt);
  end if;
END;


Propriétés d'application

Propriété de chaîne de connexion

Propriété de curseur

Propriété de résolution horizontale de présentation

Propriété de résolution horizontale d'écran

Propriété de mot de passe

Propriété de plate-forme

Propriété de nom utilisateur

Propriété de résolution verticale de présentation

Propriété de résolution verticale d'écran


Propriété de chaîne de connexion

  Exemples	  Rubriques connexes

Description  Chaîne de connexion à la base de données en cours. Si l'utilisateur n'est pas connecté, cette propriété a la valeur NULL.

Syntaxe

FUNCTION OG_Get_Ap_Connection
RETURN VARCHAR2;

Paramètres

Aucun.


Propriété de chaîne de connexion - Exemples

  Liste alphabétique      [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure d'ouverture de déclencheur ci-dessous
**affiche la chaîne de connexion de la
**base de données en cours
**à un objet texte.
*/

PROCEDURE connection IS
  connstr 	varchar2(10);
BEGIN
  connstr := og_get_ap_connection;
  if connstr = NULL then
    og_set_str(og_get_object('objet texte'), 'NULL', true, true);
  else
    og_set_str(og_get_object(' objet texte '), connstr, true, true);
  end if;
END;


Propriété de curseur

  Exemples	  Rubriques connexes

Description  Nom du curseur de souris à utiliser. La valeur de cette propriété peut être l'une des chaînes suivantes :

défaut
insertion
réticule
aide
occupé

L'aspect de chaque curseur est propre au système utilisé. Pour plus d'informations, reportez-vous à la documentation de votre système d'exploitation. Si vous définissez cette propriété à une valeur non valide, Graphics Builder utilise la valeur `défaut.'

Syntaxe

PROCEDURE OG_Set_Ap_Cursor
  (cursor  VARCHAR2);

FUNCTION OG_Get_Ap_Cursor
RETURN VARCHAR2;

Paramètres

cursor	Curseur de souris à utiliser.


Propriété de curseur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous change
** la forme du curseur en fonction
**de la couche que l'utilisateur sélectionne.
*/

PROCEDURE ChangeCursor (buttonobj IN og_object,
  hitobj IN og_object, win IN og_window,
  eventinfo IN og_event) IS
  cur 	varchar2(10);
BEGIN
  mycur := og_get_ap_cursor;
  if cur = 'default' then
     og_set_ap_cursor('insertion');
  elsif cur = 'insertion' then
     og_set_ap_cursor('réticule');
  elsif cur = 'crosshair' then
     og_set_ap_cursor('aide');
  elsif cur = 'aide' then
     og_set_ap_cursor('occupé');
  elsif cur = 'occupé' then
     og_set_ap_cursor('défaut');
  end if;
END;


Propriété de résolution horizontale de présentation

  Exemples	  Rubriques connexes

Description  Résolution horizontale de la présentation. Cette valeur correspond au nombre d'unités de présentation par pouce horizontal de la présentation.

Syntaxe

FUNCTION OG_Get_Ap_Hlayout_Res
RETURN NUMBER;

Paramètres

Aucun.


Propriété de résolution horizontale de présentation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous affiche
**la résolution horizontale
**de la présentation d'un objet texte.
*/

PROCEDURE h_layout IS
  h_layout 	number;
BEGIN
  h_layout := og_get_ap_hlayout_res;
  og_set_str(og_get_object('objet texte'), h_layout, true, true);
END;


Propriété de résolution horizontale d'écran

  Exemples	  Rubriques connexes

Description  Résolution horizontale de l'écran. Cette valeur correspond au nombre d'unités de résolution de l'écran (c'est-à-dire de pixels) d'un pouce horizontal de l'écran.

Syntaxe

FUNCTION OG_Get_Ap_Hscreen_Res
RETURN NUMBER;

Paramètres

Aucun.


Propriété de résolution horizontale d'écran - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous affiche
**la résolution horizontale de l'écran
**pour un objet texte.
*/

PROCEDURE HRES IS
  h_res 	number;
BEGIN
  h_res := og_get_ap_vscreen_res;
  og_set_str(og_get_object('objet texte'), h_res, true, true);
END;


Propriété de mot de passe

  Exemples	  Rubriques connexes

Description  Mot de passe de la connexion à la base de données en cours. Si l'utilisateur n'est pas connecté ou si l'option de préférence Keep_Password est définie à No, la valeur de cette propriété est NULL.

Syntaxe

FUNCTION OG_Get_Ap_Password
RETURN VARCHAR2;

Paramètres

Aucun.


Propriété de mot de passe - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure d'ouverture de déclencheur ci-dessous
**affiche le mot de passe de la connexion de la
**base de données en cours à un objet texte.
*/

PROCEDURE password IS
  pw 	varchar2(10);
BEGIN
  pw := og_get_ap_password;
  if pw = NULL then
    og_set_str(og_get_object('objet texte'), 'NULL', true, true);
  else
    og_set_str(og_get_object('objet texte'), pw, true, true);
  end if;
  END;


Propriété de plate-forme

  Exemples	  Rubriques connexes

Description  Plate-forme sur laquelle Graphics Builder s'exécute. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Macintosh_Platform   Indique que la plate-forme est de type Apple Macintosh.

OG_Motif_Platform   Indique que la plate-forme est de type OSF/MOTIF.

OG_Mswindows_Platform   Indique que la plate-forme est de type Microsoft Windows.

OG_Pm_Platform   Indique que la plate-forme est de type Presentation Manager.

OG_X_Platform   Indique que la plate-forme est de type X Window System.

Syntaxe

FUNCTION OG_Get_Ap_Platform
RETURN NUMBER;

Paramètres

Aucun.


Propriété de plate-forme - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous affiche
**le type de la plate-forme sur laquelle Oracle
**Graphics s'exécute pour un
**objet texte.
*/

PROCEDURE platform IS
  ptform 	number;
BEGIN
  ptform := og_get_ap_platform;
  if ptform = og_macintosh_platform then
    og_set_str(og_get_object('objet texte'), 'og_macintosh_platform', true, true);
  elsif ptform = og_motif_platform then
    og_set_str(og_get_object('objet texte'), 'og_motif_platform', true, true);
  elsif ptform = og_mswindows_platform then
    og_set_str(og_get_object('objet texte'), 'og_mswindows_platform', true, true);
  elsif ptform = og_pm_platform  then
    og_set_str(og_get_object('objet texte'), 'og_pm_platform', true, true);
  elsif ptform = og_x_platform then
    og_set_str(og_get_object('objet texte'), 'og_x_platform', true, true);
  end if;
END;


Propriété de nom utilisateur

  Exemples	  Rubriques connexes

Description  Nom d'utilisateur de la connexion à la base de données en cours. Si l'utilisateur n'est pas connecté, cette propriété a la valeur NULL.

Syntaxe

FUNCTION OG_Get_Ap_Username
RETURN VARCHAR2;

Paramètres

Aucun.


Propriété de nom utilisateur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure de déclencheur d'ouverture ci-dessous
**affiche le nom utilisateur de la
**connexion de la base de données en cours à un objet texte.
*/

PROCEDURE username IS
  usr 	varchar2(10);
BEGIN
  usr := og_get_ap_username;
  if usr = NULL then
    og_set_str(og_get_object('objet texte'), 'NULL', true, true);
  else
    og_set_str(og_get_object('objet texte'), usr, true, true);
  end if;
  END;


Propriété de résolution verticale de présentation

  Exemples	  Rubriques connexes

Description  Résolution verticale de la présentation. Cette valeur correspond au nombre d'unités de présentation par pouce vertical de la présentation.

Syntaxe

FUNCTION OG_Get_Ap_Vlayout_Res
RETURN NUMBER;

Paramètres

Aucun.


Propriété de résolution verticale de présentation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous affiche la résolution
**verticale de la présentation pour un objet texte.
*/

PROCEDURE v_layout IS
  v_layout 	number;
BEGIN
  v_layout := og_get_ap_vlayout_res;
  og_set_str(og_get_object('objet texte'), v_layout, true, true);
END;


Propriété de résolution verticale d'écran

  Exemples	  Rubriques connexes

Description  Résolution verticale de l'écran. Cette valeur correspond au nombre d'unités de résolution de l'écran (c'est-à-dire de pixels) d'un pouce vertical de l'écran.

Syntaxe

FUNCTION OG_Get_Ap_Vscreen_Res
RETURN NUMBER;

Paramètres

Aucun.


Propriété de résolution verticale d'écran - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous affiche
**la résolution verticale de l'écran pour un objet texte
/*

PROCEDURE VRES IS
  v_res	number;
BEGIN
  v_res := og_get_ap_vscreen_res;
  og_set_str(og_get_object('objet texte'), v_res, true, true);
END;


Propriétés d'arc

Propriété de base d'arc

Propriété de fermeture

Propriété de remplissage


Propriété de base d'arc

  Exemples	  Rubriques connexes

Description  Coordonnées x et y de l'angle supérieur gauche, et hauteur et largeur du rectangle utilisé comme base de l'ellipse dans laquelle l'arc est découpé.

Syntaxe

PROCEDURE OG_Set_Basearc
  (arc          OG_Object,
   basearc      OG_Arc,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Basearc
  (arc  OG_Object)
RETURN OG_Arc;

Paramètres

arc	Objet arc décrit.
basearc	Coordonnées x et y de l'angle supérieur gauche, et hauteur et largeur du rectangle utilisé comme base de l'ellipse dans laquelle l'arc est découpé.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de base d'arc - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**les informations d'un arc existant,
**réduit toutes les données de moitié, et
**met à jour l'objet arc.
*/

PROCEDURE base_arc IS
  arc 	og_arc;
BEGIN
  arc := og_get_basearc(og_get_object('arc'));
  arc.x := arc.x/2;
  arc.y := arc.y/2;
  arc.height :=arc.height/2;
  arc.width := arc.width/20;
  arc.sangle := arc.sangle/2;
  arc.eangle := arc.eangle/2;
  og_set_basearc(og_get_object('arc'), arc);
END;


Propriété de fermeture

  Exemples	  Rubriques connexes

Description  Fermeture de l'arc. La valeur de cette propriété peut être l'une des suivantes :

TRUE   Indique que l'arc est fermé.

FALSE   Indique que l'arc est ouvert.

Syntaxe

PROCEDURE OG_Set_Arc_Closed
  (arc          OG_Object,
   closed       BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Arc_Closed
  (arc  OG_Object)
RETURN BOOLEAN;

Paramètres

arc	Objet arc décrit.
closed	Fermeture de l'arc.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de fermeture - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**la fermeture d'un arc existant. Si la fermeture a la valeur
**TRUE, la procédure remplit l'arc de rouge et
**définit la valeur de fermeture à FALSE ;
**si la fermeture a la valeur FALSE,
**la procédure remplit l'arc de bleu et définit la valeur à TRUE.
*/

PROCEDURE closure IS
  cls	 BOOLEAN;
  arc 	 og_object;
BEGIN
  arc := og_get_object('arc');
  cls := og_get_arc_closed(arc);
  if cls = TRUE  then
     og_set_bfcolor(arc, 'rouge');
     og_set_arc_closed(arc, FALSE);
  else
     og_set_bfcolor(arc, 'bleu');
     og_set_arc_closed(arc, TRUE);
  end if;
END;


Propriété de remplissage

  Exemples	  Rubriques connexes

Description  Forme de remplissage de l'arc. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Chord_Arcfill   Indique que la forme de remplissage de l'arc est celle d'une corde.

OG_Pie_Arcfill Indique que la forme de remplissage de l'arc est celle d'un secteur plein.

Syntaxe

PROCEDURE OG_Set_Arcfill
  (arc          OG_Object,
   arcfill      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Arcfill
  (arc  OG_Object)
RETURN NUMBER;

Paramètres

arc	Objet arc décrit.
arcfill	Forme de remplissage de l'arc.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de remplissage - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**le remplissage d'un arc, imprime la valeur dans
**un objet texte et attribue une valeur différente
**à la valeur de remplissage d'arc.
*/

PROCEDURE fill IS

  text 	og_object;
  arc 	og_object;
  num NUMBER;
BEGIN
  text := og_get_object('objet texte');
  arc := og_get_object('arc');
  num := og_get_arcfill(arc);
  og_set_str(text, num);
  og_set_arcfill(arc, og_chord_arcfill);
END;


Propriétés d'axe générique

Propriété d'étiquettes d'axe

Propriété de type d'axe

Propriété d'étiquette personnalisée

Propriété de direction

Propriété de grille principale

Propriété de repères principaux

Propriété de grille secondaire

Propriété de graduation secondaire

Propriété de graduation secondaire par intervalle

Propriété de position

Propriété de rotation d'étiquette de graduation

Propriété d'étiquettes de graduation

Propriété de position de graduation


Propriété d'étiquettes d'axe

  Exemples	  Rubriques connexes

Description  Indique si les étiquettes identifiant les valeurs s'affichent sur l'axe.

Syntaxe

PROCEDURE OG_Set_Axislabel
  (axis       OG_Axis,
   axislabel  BOOLEAN);

FUNCTION OG_Get_Axislabel
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
axislabel	Indique si les étiquettes identifiant les valeurs s'affichent sur l'axe.


Propriété d'étiquettes d'axe - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous détermine si
**la case à cocher Etiquette d'axe est cochée.
**Dans l'affirmative, supprime la coche,
**et vice versa.
*/

PROCEDURE GenAxisLbl IS
  template og_template;
  x_axis og_axis;
  val boolean;
BEGIN
  template := og_get_template('modèle0');
  x_axis := og_get_axis(template, og_x_axis);

  val := og_get_axislabel(x_axis);
  if val = true then
     og_set_axislabel(x_axis, false);
  else
     og_set_axislabel(x_axis, true);
  end if;
END;


Propriété de type d'axe

  Exemples	  Rubriques connexes

Description  Indique le type d'axe à utiliser.  La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Continuous_Axistype

OG_Date_Axistype

OG_Discrete_Axistype

Syntaxe

PROCEDURE OG_Set_Axistype
  (axis      OG_Axis,
   axistype  NUMBER);

FUNCTION OG_Get_Axistype
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
axistype	Indique le type d'axe à utiliser.


Propriété de type d'axe - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le
**type d'axe en cours. S'il est
**CONTINUOUS, fait revenir le type à la
**valeur DISCRETE, ou vice versa. Si le type
**est DATE, la procédure change le
**format de l'année.
*/

PROCEDURE GenAxisType IS
  template 	og_template;
  axis 	og_axis;
  num  	number;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_x_axis);
  num := og_get_axistype(axis);
  if num = og_discrete_axistype then
     og_set_axistype(axis,og_continuous_axistype);
  elsif num = og_continuous_axistype then
     og_set_axistype(axis, og_discrete_axistype);
  elsif num = og_date_axistype then
     og_set_yearfmt(axis, og_twodigit_fmt);
  end if;
END;


Propriété d'étiquette personnalisée

  Exemples	  Rubriques connexes

Description  Texte de l'étiquette qui s'affiche le long de l'axe.

Syntaxe

PROCEDURE OG_Set_Custlabel
  (axis       OG_Axis,
   custlabel  VARCHAR2);

FUNCTION OG_Get_Custlabel
  (axis  OG_Axis)
RETURN VARCHAR2;

Paramètres

axis	Objet axe décrit.
custlabel	Texte de l'étiquette qui s'affiche le long de l'axe.


Propriété d'étiquette personnalisée - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit l'étiquette
**de l'axe indiqué et modifie le nom
**de cette étiquette.
*/

PROCEDURE CustLabel IS
  template og_template;
  axis og_axis;
  label varchar2(20);
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_x_axis);
  label := og_get_custlabel(axis);
  og_set_custlabel(axis, 'Employee Number');
END;


Propriété de direction

  Exemples	  Rubriques connexes

Description  Indique dans quel sens les valeurs croissantes ou les catégories successives s'affichent sur l'axe. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Down_Direction

OG_Left_Direction

OG_Right_Direction

OG_Up_Direction

Syntaxe

PROCEDURE OG_Set_Direction
  (axis       OG_Axis,
   direction  NUMBER);

FUNCTION OG_Get_Direction
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
direction	Indique dans quel sens les valeurs croissantes ou les catégories successives s'affichent sur l'axe.


Propriété de direction - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**les directions de l'axe des x et de l'axe des y
**et les définit aux directions opposées.
*/

PROCEDURE GenDirection IS
  template 	og_template;
  x_axis 	og_axis;
  y_axis 	og_axis;
  num  	number;
BEGIN
  template := og_get_template('modèle0');
  x_axis := og_get_axis(template, og_x_axis);
  y_axis := og_get_axis(template, og_y1_axis);
  num := og_get_direction(x_axis);
  if num = og_left_direction then
     og_set_direction(x_axis, og_right_direction);
  elsif num = og_right_direction then
     og_set_direction(x_axis, og_left_direction);
  end if;
  num := og_get_direction(y_axis);
  if num = og_up_direction then
     og_set_direction(y_axis, og_down_direction);
  elsif num = og_down_direction then
     og_set_direction(y_axis, og_up_direction);
  end if;
END;


Propriété de grille principale

  Exemples	  Rubriques connexes

Description  Indique si une ligne de grille s'affiche à chaque repère de graduation principal.

Syntaxe

PROCEDURE OG_Set_Majorgrid
  (axis       OG_Axis,
   majorgrid  BOOLEAN);

FUNCTION OG_Get_Majorgrid
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
majorgrid	Indique si une ligne de grille s'affiche à chaque repère de graduation principal.


Propriété de grille principale - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**la case à cocher Grille principale est cochée.
**Dans l'affirmative, annule la coche, et vice
**versa.
*/

PROCEDURE GenMajorGrids IS
  template og_template;
  x_axis og_axis;
  val boolean;
BEGIN
  template := og_get_template('modèle0');
  x_axis := og_get_axis(template, og_x_axis);

  val := og_get_majorgrid(x_axis);
  if val = true then
     og_set_majorgrid(x_axis, false);
  else
     og_set_majorgrid(x_axis, true);
  end if;
END;


Propriété de repères principaux

  Exemples	  Rubriques connexes

Description  Indique si les repères de graduation principaux s'affichent sur chaque intervalle principal.

Syntaxe

PROCEDURE OG_Set_Majorticks
  (axis        OG_Axis,
   majorticks  BOOLEAN);

FUNCTION OG_Get_Majorticks
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
majorticks	Indique si les repères de graduation principaux s'affichent sur chaque intervalle principal.


Propriété de repères principaux  - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**la case à cocher Repères principaux est cochée.
**Dans l'affirmative, la procédure supprime la coche
**et vice versa.
*/

PROCEDURE GenMajorTicks IS
  template og_template;
  x_axis og_axis;
  val boolean;
BEGIN
  template := og_get_template('modèle0');
  x_axis := og_get_axis(template, og_x_axis);

  val := og_get_majorticks(x_axis);
  if val = true then
    og_set_majorticks(x_axis, false);
  else
     og_set_majorticks(x_axis, true);
  end if;
END;


Propriété de grille secondaire

  Exemples	  Rubriques connexes

Description  Indique si une ligne de grille s'affiche sur chaque repère de graduation secondaire.

Syntaxe

PROCEDURE OG_Set_Minorgrid
  (axis       OG_Axis,
   minorgrid  BOOLEAN);

FUNCTION OG_Get_Minorgrid
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
minorgrid	Indique si une ligne de grille s'affiche sur chaque repère de graduation secondaire.


Propriété de grille secondaire - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**la case à cocher grille secondaire est cochée.
**Dans l'affirmative, la procédure supprime la coche
**et vice versa.
*/

PROCEDURE GenMinorGrids IS
  template og_template;
  x_axis og_axis;
  val boolean;
BEGIN
  template := og_get_template('modèle0');
  x_axis := og_get_axis(template, og_x_axis);

  val := og_get_minorgrid(x_axis);
  if val = true then
     og_set_minorgrid(x_axis, false);
  else
     og_set_minorgrid(x_axis, true);
  end if;
END;


Propriété de graduations secondaires

  Exemples	  Rubriques connexes

Description  Indique si les repères de graduation secondaire s'affichent en fonction de la valeur définie pour Graduations secondaires par intervalle.

Syntaxe

PROCEDURE OG_Set_Minorticks
  (axis        OG_Axis,
   minorticks  BOOLEAN);

FUNCTION OG_Get_Minorticks
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
minorticks	Indique si les repères de graduation secondaire s'affichent en fonction de la valeur définie pour Graduation secondaire par intervalle.


Propriété de graduations secondaires - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si la case à cocher
**Graduations secondaires est cochée.
**Dans l'affirmative, la procédure supprime la coche,
**et vice versa.
*/

PROCEDURE GenMinorTicks IS
  template og_template;
  x_axis og_axis;
  val boolean;
BEGIN
  template := og_get_template('modèle0');
  x_axis := og_get_axis(template, og_x_axis);

  val := og_get_minorticks(x_axis);
  if val = true then
     og_set_minorticks(x_axis, false);
  else
     og_set_minorticks(x_axis, true);
  end if;
END;


Propriété de graduations secondaires par intervalle

  Exemples	  Rubriques connexes

Description  Nombre de graduations secondaires définies pour chaque intervalle principal.

Syntaxe

PROCEDURE OG_Set_Minorct
  (axis     OG_Axis,
   minorct  NUMBER);

FUNCTION OG_Get_Minorct
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
minorct	Nombre de graduations secondaires définies pour chaque intervalle principal.


Propriété de graduation secondaire par intervalle - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le
**nombre de graduations secondaires par intervalle et
**donne à la valeur une valeur triple de la valeur d'origine.
*/

PROCEDURE GenMinorCt IS
  template og_template;
  x_axis og_axis;
  num number;
BEGIN
  template := og_get_template('modèle0');
  x_axis := og_get_axis(template, og_x_axis);
  num := og_get_ticklabelrot(x_axis);
  og_set_minorct(x_axis, 3*num);
END;


Propriété de position

  Exemples	  Rubriques connexes

Description  Côté du graphique sur lequel l'axe s'affiche. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Bottom_Position

OG_Left_Position

OG_Right_Position

OG_Top_Position

Syntaxe

PROCEDURE OG_Set_Position
  (axis      OG_Axis,
   position  NUMBER);

FUNCTION OG_Get_Position
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
position	Côté du graphique sur lequel l'axe s'affiche.


Propriété de position - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous détermine
**le côté du graphique sur lequel l'axe
**s'affiche, et fait revenir l'axe sur
**le côté opposé.
*/

PROCEDURE GenPosition IS
  template og_template;
  axis og_axis;
  num number;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_x_axis);
  num := og_get_position(axis);
  if num = og_bottom_position then
     og_set_position(axis, og_top_position);
  elsif num = og_left_position then
     og_set_position(axis, og_right_position);
  elsif num = og_right_position then
     og_set_position(axis, og_left_position);
  elsif num = og_top_position then
     og_set_position(axis, og_bottom_position);
  end if;
END;


Propriété de rotation d'étiquette de graduation

  Exemples	  Rubriques connexes

Description  Sens dans lequel s'effectue la rotation des étiquettes de graduation. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Ccw_Rotation   Rotation dans le sens opposé de celui des aiguilles d'une montre.

OG_Cw_Rotation   Rotation dans le sens des aiguilles d'une montre.

OG_No_Rotation   Pas de rotation.

Syntaxe

PROCEDURE OG_Set_Ticklabelrot
  (axis          OG_Axis,
   ticklabelrot  NUMBER);

FUNCTION OG_Get_Ticklabelrot
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
ticklabelrot	Sens dans lequel s'effectue la rotation des étiquettes de graduation.


Propriété de rotation d'étiquette de graduation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**le sens de rotation des étiquettes de graduation
**et lui donne une valeur différente.
*/

PROCEDURE GenTickLbl IS
  template og_template;
  x_axis og_axis;
  num number;
BEGIN
  template := og_get_template('modèle0');
  x_axis := og_get_axis(template, og_x_axis);

  num := og_get_ticklabelrot(x_axis);
  if num = og_ccw_rotation then
     og_set_ticklabelrot(x_axis, og_cw_rotation);
  elsif num = og_cw_rotation then
     og_set_ticklabelrot(x_axis, og_no_rotation);
  elsif num = og_no_rotation then
     og_set_ticklabelrot(x_axis, og_ccw_rotation);
  end if;
END;


Propriété d'étiquettes de graduation

  Exemples	  Rubriques connexes

Description  Indique si les étiquettes qui identifient les valeurs s'affichent sur l'axe.

Syntaxe

PROCEDURE OG_Set_Ticklabels
  (axis        OG_Axis,
   ticklabels  BOOLEAN);

FUNCTION OG_Get_Ticklabels
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
ticklabels	Indique si les étiquettes qui identifient les valeurs s'affichent sur l'axe.


Propriété d'étiquettes de graduation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**le case à cocher Etiquettes de graduation est cochée.
**Dans l'affirmative, elle annule la coche,
**et vice versa.
*/

PROCEDURE GenTickLbl IS
  template og_template;
  x_axis og_axis;
  val boolean;
BEGIN
  template := og_get_template('modèle0');
  x_axis := og_get_axis(template, og_x_axis);
  val := og_get_ticklabels(x_axis);
  if val = true then
     og_set_ticklabels(x_axis, false);
  else
     og_set_ticklabels(x_axis, true);
  end if;
END;


Propriété de position de graduation

  Exemples	  Rubriques connexes

Description  Indique comment les repères de graduation principaux et secondaires s'affichent. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Cross_Tickpos

OG_Inside_Tickpos

OG_Outside_Tickpos

Syntaxe

PROCEDURE OG_Set_Tickpos
  (axis     OG_Axis,
   tickpos  NUMBER);

FUNCTION OG_Get_Tickpos
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.
tickpos	Indique comment les repères de graduation principaux et secondaires s'affichent.


Propriété de position de graduation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la
**position des repères de l'axe des x et lui donne
**une valeur différente.
*/

PROCEDURE GenTickPos IS
  template og_template;
  x_axis og_axis;
  num number;
BEGIN
  template := og_get_template('modèle0');
  x_axis := og_get_axis(template, og_x_axis);
  num := og_get_tickpos(x_axis);
  if num = og_cross_tickpos then
     og_set_tickpos(x_axis, og_inside_tickpos);
  elsif num = og_inside_tickpos then
     og_set_tickpos(x_axis, og_outside_tickpos);
  elsif num = og_outside_tickpos then
     og_set_tickpos(x_axis, og_cross_tickpos);
  end if;
END;


Propriétés d'axe discret

Propriété de maximum auto

Propriété de minimum auto

Propriété de format de date

Propriété de nombre maximum de catégories

Propriété de nombre minimum de catégories

Propriété de format numérique


Propriété de maximum auto

  Exemples	  Rubriques connexes

Description  Indique si le nombre maximum de catégories qui s'affichent sur l'axe est défini à Auto.

Syntaxe

PROCEDURE OG_Set_Disc_Automax
  (axis     OG_Axis,
   automax  BOOLEAN,
   maxcat   NUMBER);

FUNCTION OG_Get_Disc_Automx
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
automax	Indique si le nombre maximum de catégories qui s'affichent sur l'axe est défini à Auto.
maxcat	Nombre maximum de catégories qui s'affichent sur l'axe (si automax est défini à FALSE).


Propriété de maximum auto - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si le
**maximum de l'axe X est défini à Auto. Dans
**l'affirmative, fait revenir la valeur à FALSE
**avec default_maxcat ; dans le cas contraire, lit
**la valeur en cours et la fait revenir à TRUE.
*/

PROCEDURE datemax IS
  template og_template;
  axis og_axis;
  val boolean;
  maxcat number;
  default_maxcat number := 3;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_automax(axis);
  if val = true then
     og_set_disc_automax(axis, false, default_maxcat);
  elsif val = false then
    maxcat := og_get_disc_maxcat(axis);
    og_set_disc_automax(axis,true,default_maxcat);
  end if;
END;


Propriété de minimum auto

  Exemples	  Rubriques connexes

Description  Indique si le nombre minimum de catégories qui s'affichent sur l'axe est défini à Auto.

Syntaxe

PROCEDURE OG_Set_Disc_Automin
  (axis     OG_Axis,
   automin  BOOLEAN,
   mincat   NUMBER);

FUNCTION OG_Get_Disc_Automin
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet axe décrit.
automin	Indique si le nombre minimum de catégories qui s'affichent sur l'axe est défini à Auto.
mincat	Nombre minimum de catégories qui s'affichent sur l'axe (si automin est défini à FALSE).


Propriété minimum auto - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/*La procédure ci-dessous vérifie si le
**minimum de l'axe X est défini à Auto. Dans
**l'affirmative, fait revenir la valeur à false
**avec default_mincat ; dans le cas contraire, lit
**la valeur en cours et la fait revenir
**à true.
*/

PROCEDURE datemin IS
  template og_template;
  axis og_axis;
  val boolean;
  mincat number;
  default_mincat number := 50;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_automin(axis);
  if val = true then
    og_set_disc_automin(axis,false,default_mincat);
  elsif val = false then
    mincat := og_get_disc_mincat(axis);
    og_set_disc_automin(axis,true,default_mincat);
  end if;
END;


Propriété de format de date

  Exemples	  Rubriques connexes

Description  Format de date des étiquettes de graduation d'axe. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

PROCEDURE OG_Set_Disc_Datefmt
  (axis      OG_Axis,
   date_fmt  VARCHAR2);

FUNCTION OG_Get_Disc_Datefmt
  (axis  OG_Axis)
RETURN VARCHAR2;

Paramètres

axis	Objet axe décrit.
date_fmt	Format de date des étiquettes de graduation d'axe.


Propriété de format de date - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le format
**de date en cours de l'axe. S'il est
**différent de la variable
**'default_date', fait revenir la valeur à
**'default_date.'
*/

PROCEDURE datefmt IS
  template og_template;
  axis og_axis;
  val varchar2(10);
  default_date varchar2(10) := 'JJ_AA_MM';
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_datefmt(axis);
  if val != default_date then
     og_set_disc_datefmt(axis, default_date);
  end if;
END;


Propriété de nombre maximum de catégories

  Exemples	  Rubriques connexes

Description  Indique le nombre maximum de catégories qui s'affichent sur l'axe (si automax est défini à FALSE).

Syntaxe

(See OG_Set_Disc_Automax, above.)

FUNCTION OG_Get_Disc_Maxcat
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.


Propriété de nombre maximum de catégories - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*
** La procédure ci-dessous vérifie si
**le maximum de l'axe X est défini à Auto.
**Dans l'affirmative, fait revenir la valeur à FALSE
**avec default_maxcat ; dans le cas contraire, lit
**la valeur en cours et la fait
**revenir à TRUE.
*/

PROCEDURE datemax IS
  template og_template;
  axis og_axis;
  val boolean;
  maxcat number;
  default_maxcat number := 3;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_automax(axis);
  if val = true then
     og_set_disc_automax(axis, false, default_maxcat);
  elsif val = false then
    maxcat := og_get_disc_maxcat(axis);
    og_set_disc_automax(axis,true,default_maxcat);
  end if;
END;


Propriété de nombre minimum de catégories

  Exemples	  Rubriques connexes

Description  Indique le nombre minimum de catégories qui s'affichent sur l'axe (si automin est défini à FALSE).

Syntaxe

(See OG_Set_Disc_Automin, above.)

FUNCTION OG_Get_Disc_Mincat
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet axe décrit.


Propriété de nombre minimum de catégories - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**le minimum de l'axe X est défini à Auto.
**Dans l'affirmative, fait revenir la valeur à FALSE
**avec default_mincat ; dans le cas contraire, lit
**la valeur en cours et la fait revenir
**à TRUE.
*/

PROCEDURE datemin IS
  template og_template;
  axis og_axis;
  val boolean;
  mincat number;
  default_mincat number := 50;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_automin(axis);
  if val = true then
    og_set_disc_automin(axis,false,default_mincat);
  elsif val = false then
    mincat := og_get_disc_mincat(axis);
    og_set_disc_automin(axis,true,default_mincat);
  end if;
END;


Propriété de format numérique

  Exemples	  Rubriques connexes

Description  Format numérique des étiquettes de graduation de l'axe. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

PROCEDURE OG_Set_Disc_Numfmt
  (axis     OG_Axis,
   num_fmt  VARCHAR2);

FUNCTION OG_Get_Disc_Numfmt
  (axis  OG_Axis)
RETURN VARCHAR2;

Paramètres

axis	Objet axe décrit.
num_fmt	Format numérique des étiquettes de graduation de l'axe.


Propriété de format numérique - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le format
**numérique en cours de l'axe. S'il est
** différent de la variable
**'default_format', fait revenir la valeur à
**'default_format'
*/

PROCEDURE discnumfmt IS
  template 	og_template;
  axis 	og_axis;
  val 	varchar2(10);
  default_format 	varchar2(10) := '9,9,9,9';
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_x_axis);
  val := og_get_disc_numfmt(axis);
  if val != default_format then
     og_set_disc_numfmt(axis, default_format);
  end if;
END;


Propriétés d'axe (continu)

Propriété de maximum auto

Propriété de minimum auto

Propriété d'intervalle auto

Propriété de maximum

Propriété de minimum

Propriété de format numérique

Propriété de pourcentage par rapport à

Propriété de pourcentage de

Propriété d'échelle

Propriété d'intervalle


Propriété de maximum auto

  Exemples	  Rubriques connexes

Description  Indique si la valeur maximum de l'axe est définie à Auto.

Syntaxe

PROCEDURE OG_Set_Cont_Automax
  (axis     OG_Axis,
   automax  BOOLEAN,
   maximun  NUMBER);

FUNCTION OG_Get_Cont_Automax
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet d'axe décrit.
automax	Indique si la valeur maximum de l'axe est définie à Auto.
maximum	Indique la valeur maximum de l'axe (si automax est défini à FALSE).


Propriété de maximum auto - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**la valeur maximum de l'axe de Y1 est définie à Auto.
**Si la valeur de retour est TRUE, fait revenir la valeur à FALSE
**avec default_max ; si la valeur de retour est
**FALSE, fait revenir la valeur à TRUE
**après lecture de la valeur
**d'axe maximum indiquée.
*/

PROCEDURE automin IS
  axis 	og_axis;
  template 	og_template;
  val  	boolean;
  num  	number;
  default_max 	number := 3000;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_autostep(axis);
  if val = TRUE then
    og_set_cont_autostep(axis, FALSE, default_max);
  else
    num := og_get_cont_step(axis);
    og_set_cont_autostep(axis, TRUE, default_max);
  end if;
END;


Propriété de minimum auto

  Exemples	  Rubriques connexes

Description  Indique si la valeur minimum de l'axe est définie à Auto.

Syntaxe

PROCEDURE OG_Set_Cont_Automin
  (axis     OG_Axis,
   automin  BOOLEAN,
   minimun  NUMBER);

FUNCTION OG_Get_Cont_Automin
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet d'axe décrit .
automax	Indique si la valeur minimum de l'axe est définie à Auto.
minimun	Indique la valeur minimum de l'axe (si automin est défini à FALSE).


Propriété de minimum auto - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**la valeur minimum de l'axe de Y1 est définie à Auto.
**Si la valeur de retour est TRUE, faire revenir la valeur à FALSE
**avec default_max ; si la valeur de retour est
**FALSE, fait revenir la valeur à TRUE
**après lecture de la valeur
**d'axe minimum indiquée.
*/

PROCEDURE automin IS
  axis 	og_axis;
  template	og_template;
  val 	boolean;
  num 	number;
  default_min 	number := 500;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_automin(axis);
  if val = TRUE then
    og_set_cont_automin(axis, FALSE, default_min);
  elsif val = FALSE then
    num := og_get_cont_minimum(axis);
    og_set_cont_automin(axis, TRUE, default_min);
  end if;
END;


Propriété d'intervalle auto

  Exemples	  Rubriques connexes

Description  Indique si la valeur de l'intervalle de l'axe est définie à Auto.

Syntaxe

PROCEDURE OG_Set_Cont_Autostep
  (axis      OG_Axis,
   autostep  BOOLEAN,
   step      NUMBER);

FUNCTION OG_Get_Cont_Autostep
  (axis  OG_Axis)
RETURN BOOLEAN;

Paramètres

axis	Objet d'axe décrit.
autostep	Indique si la valeur de l'intervalle de l'axe est définie à Auto.
step	Indique la valeur de l'intervalle de l'axe (si autostep est défini à FALSE).


Propriété d'intervalle auto - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous vérifie si l'intervalle
**de l'axe Y1 est défini à Auto. Si la valeur
**de retour est TRUE, fait revenir la valeur à
**FALSE avec la valeur d'intervalle par défaut ; si la
**valeur de retour est FALSE, fait revenir
**la valeur à TRUE après lecture de la valeur
**d'intervalle
**indiquée. */

PROCEDURE autostep IS
  axis 	og_axis;
  template 	og_template;
  val 	boolean;
  num 	number;
  step 	number := 500;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_autostep(axis);
  if val = TRUE then
    og_set_cont_autostep(axis, FALSE, step);
  else
    num := og_get_cont_step(axis);
    og_set_cont_autostep(axis, TRUE, step);
  end if;
END;


Propriété de maximum

  Exemples	  Rubriques connexes

Description  Valeur maximum de l'axe (si Auto Maximum est définie à FALSE).

Syntaxe

(Voir OG_Set_Cont_Automax, ci-dessus.)

FUNCTION OG_Get_Cont_Maximum
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet d'axe décrit.


Propriété de maximum - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si la valeur maximum
**de l'axe Y1 est définie à Auto. Si la valeur de retour
**est TRUE, fait revenir la valeur à
**FALSE avec default_max ; si la valeur de retour
**est FALSE, fait revenir la valeur à
**TRUE après lecture de la valeur
**maximum d'axe.
*/

PROCEDURE automin IS
  axis 	og_axis;
  template 	og_template;
  val 	boolean;
  num 	number;
  default_max 	number := 3000;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_autostep(axis);
  if val = TRUE then
    og_set_cont_autostep(axis, FALSE, default_max);
  else
    num := og_get_cont_step(axis);
    og_set_cont_autostep(axis, TRUE, default_max);
  end if;
END;


Propriété de minimum

  Exemples	  Rubriques connexes

Description Valeur minimum de l'axe (si Auto Minimum est définie à FALSE).

Syntaxe

(Voir OG_Set_Cont_Automin, ci-dessus.)

FUNCTION OG_Get_Cont_Minimum
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet d'axe décrit.


Propriété de minimum - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si la valeur minimum
**de l'axe Y1 est définie à Auto. Si la valeur de retour
**est TRUE, fait revenir la valeur à
**FALSE avec default_max ; si la valeur de retour
**est FALSE, fait revenir la valeur à
**TRUE après lecture de la valeur
**minimum d'axe.
*/

PROCEDURE automin IS
  axis 	og_axis;
  template	og_template;
  val 	boolean;
  num 	number;
  default_min 	number := 500;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_automin(axis);
  if val = TRUE then
    og_set_cont_automin(axis, FALSE, default_min);
  elsif val = FALSE then
    num := og_get_cont_minimum(axis);
    og_set_cont_automin(axis, TRUE, default_min);
  end if;
END;


Propriété de format numérique

  Exemples	  Rubriques connexes

Description  Format numérique des étiquettes de graduation des axes. Cette information doit être une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

PROCEDURE OG_Set_Cont_Numfmt
  (axis     OG_Axis,
   num_fmt  VARCHAR2);

FUNCTION OG_Get_Cont_Numfmt
  (axis  OG_Axis)
RETURN VARCHAR2;

Paramètres

axis	Objet d'axe décrit.
num_fmt	Indique le format numérique des étiquettes de graduation des axes.


Propriété de format numérique - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le
**format numérique actuel de l'axe et lui donne une
**valeur différente.
*/

PROCEDURE numFormat IS
  axis 	og_axis;
  template 	og_template;
  val  	varchar2(10);
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_cont_numfmt(axis);
  og_set_cont_numfmt(axis,'9,9,9,9,9');
END;


Propriété de pourcentage par rapport à

  Exemples	  Rubriques connexes

Description  Indique comment les valeurs de mise à l'échelle de Percent Of sont calculées. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Category_Pctby   Indique que le pourcentage de chaque valeur de données est calculé par rapport aux valeurs de données du même champ d'autres catégories.

OG_Field_Pctby   Indique que le pourcentage de chaque valeur de données est calculé par rapport aux valeurs de données de la même catégorie d'autres champs.

Syntaxe

PROCEDURE OG_Set_Pct_By
  (axis    OG_Axis,
   pct_of  NUMBER);

FUNCTION OG_Get_Pct_By
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet d'axe décrit.
pct_of	Indique comment les valeurs de mise à l'échelle de Percent Of sont calculées.


Propriété de pourcentage par rapport à - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

*/La procédure ci-dessous lit
**la méthode de calcul des valeurs
**d'échelle de Percent Of
**(avec Scale défini pour OG_PCT_SCALE)
**de l'axe et fait revenir la valeur à la
**prochaine valeur disponible.
/*

PROCEDURE pctby IS
  axis 	og_axis;
  template 	og_template;
  val 	number;
BEGIN
  template := og_get_template('modèle0');
  axis := og_get_axis(template, og_y1_axis);
  val := og_get_pct_by(axis);
  if val = OG_category_pctby then
    og_set_pct_by(axis, og_field_pctby);
  elsif val = og_field_pctby then
    og_set_pct_by(axis, og_category_pctby);
  end if;
END;


Propriété de pourcentage de

  Exemples	  Rubriques connexes

Description  Facteur de mise à l'échelle relatif (si Scale est défini à OG_Pct_Scale). La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Maximum_Pctof   Indique que chaque valeur de données est tracée sous la forme d'un pourcentage de la plus grande valeur de données.

OG_Minimum_Pctof   Indique que chaque valeur de données est tracée sous la forme d'un pourcentage de la plus petite valeur de données.

OG_Sum_Pctof   Indique que chaque valeur de données tracée sous la forme d'un pourcentage de la somme de toutes les valeurs de données.

Syntaxe

PROCEDURE OG_Set_Pct_Of
  (axis    OG_Axis,
   pct_of  NUMBER);

FUNCTION OG_Get_Pct_Of
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet d'axe décrit.
pct_of	Indique le facteur d'échelle relatif (si Scale est défini à OG_Pct_Scale).


Propriété de pourcentage de - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**le facteur d'échelle relatif (avec Scale
**défini à OG_PCT_SCALE)de l'axe
**et fait revenir la valeur à la prochaine
**valeur disponible.
*/

PROCEDURE pctof  IS

  axis 	og_axis;

  template 	og_template;

  val 	number;

BEGIN

  template := og_get_template('modèle0');

  axis := og_get_axis(template, og_y1_axis);

  val := og_get_pct_of(axis);

  if val = OG_maximum_pctof then

     og_set_pct_of(axis, og_minimum_pctof);

  elsif val = og_minimum_pctof then

    og_set_pct_of(axis, og_sum_pctof);

  elsif val = og_sum_pctof then

    og_set_pct_of(axis, og_maximum_pctof);

  end if;

END;


Propriété d'échelle

  Exemples	  Rubriques connexes

Description  Algorithme utilisé pour la mise à l'échelle de l'axe. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Linear_Scale   Indique que l'axe est mis à l'échelle par utilisation d'un intervalle fixe entre les valeurs minimum et maximum de l'axe.

OG_LOG_Scale   Indique que l'axe est mis à l'échelle à l'aide d'un algorithme logarithmique (basé sur les puissances de 10) pour déterminer les intervalles entre les valeurs minimum et maximum de l'axe.

OG_Pct_Scale   Indique que l'axe est mis à l'échelle de sorte que les valeurs de données soient tracées par rapport au montant indiqué par Percent Of.

Syntaxe

PROCEDURE OG_Set_Scale
  (axis   OG_Axis,
   scale  NUMBER);

FUNCTION OG_Get_Scale
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet d'axe décrit.
scale	Indique l'algorithme utilisé pour la mise à l'échelle de l'axe.


Propriété d'échelle - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**la méthode utilisée pour la mise à l'échelle
**de l'axe et fait revenir la valeur à la
**prochaine valeur disponible.
*/

PROCEDURE  scale IS

  axis 	og_axis;

  template 	og_template;

  val 	number;

BEGIN

  template := og_get_template('modèle0');

  axis := og_get_axis(template, og_y1_axis);

  val := og_get_scale(axis);

  if val = OG_linear_scale then

    og_set_scale(axis, og_log_scale);

  elsif val = og_log_scale then

    og_set_scale(axis, og_pct_scale);

  elsif val = og_pct_scale then

    og_set_scale(axis, og_linear_scale);

  end if;

END;


Propriété d'intervalle

  Exemples	  Rubriques connexes

Description  Valeur de l'intervalle de l'axe (si Auto Step est défini à FALSE).

Syntaxe

(Voir OG_Set_Cont_Autostep, ci-dessus.)

FUNCTION OG_Get_Cont_Step
  (axis  OG_Axis)
RETURN NUMBER;

Paramètres

axis	Objet d'axe décrit.


Propriété d'intervalle - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si l'intervalle
**de l'axe Y1 est défini à Auto. Si la valeur de retour
**est TRUE, fait revenir la valeur à
**FALSE avec la valeur d'intervalle par défaut ; si la valeur de
**retour est FALSE, fait revenir la valeur à
**TRUE après lecture de la valeur d'intervalle indiquée.
*/

PROCEDURE autostep IS

  axis 	og_axis;

  template 	og_template;

  val 	boolean;

  num 	number;

  step 	number := 500;

BEGIN

  template := og_get_template('modèle0');

  axis := og_get_axis(template, og_y1_axis);

  val := og_get_cont_autostep(axis);

  if val = TRUE then

    og_set_cont_autostep(axis, FALSE, step);

  else

    num := og_get_cont_step(axis);

    og_set_cont_autostep(axis, TRUE, step);

  end if;

END;


Propriétés d'éléments de graphique

Propriété de procédure bouton

Propriété d'événements

Propriété d'explosion

Propriété de nom


Propriété de procédure bouton

  Exemples	  Rubriques connexes

Description  Identificateur de la procédure bouton qui doit être associée à cet élément de graphique. Notez que la propriété Events doit être définie correctement pour que cette procédure reçoive les événements de souris voulus. La propriété Evénements peut être l'une des constantes intégrées suivantes :

OG_No_Events

OG_Mouse_Up

OG_Mouse_Down

OG_Mouse_Move_Down

Pour que la procédure puisse recevoir plusieurs types d'événement, définissez Events à la somme des constantes des événements souhaités.

Syntaxe

PROCEDURE OG_Set_Button
  (chart        OG_Object,
   row_num      NUMBER,
   col_name     VARCHAR2,
   button_proc  OG_Buttonproc,
   events       NUMBER);

Paramètres

chart	Objet graphique décrit.
row_num	Numéro de ligne d'interrogation représenté par l'élément de graphique.
col_name	Colonne d'interrogation représentée par l'élément de graphique.
button_proc	Identificateur de la procédure bouton qui doit être associée à cet élément de graphique.
events	Type d'événements de souris que la procédure bouton doit recevoir.


Propriété de procédure bouton - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous attribue
**une procédure bouton à
**l'élément de graphique MGR_bars.
*/

PROCEDURE  AssignButtonProc IS
  chart og_object;
  mgrbar og_object;
  button og_buttonproc;
BEGIN
  chart := og_get_object('graphique');
  mgrbar := og_get_object('MGR_bars');
  button := og_get_buttonproc('bouton');
  og_set_button(chart, og_get_row(mgrbar), 'MGR', button, og_mouse_down);
END;


Propriété d'événements

  Exemples	  Rubriques connexes

Description  Type d'événement de souris que la procédure bouton doit recevoir. La propriété Evénements peut

être l'une des constantes intégrées suivantes :

OG_No_Events

OG_Mouse_Up

OG_Mouse_Down

OG_Mouse_Move_Down

Pour que la procédure puisse recevoir plusieurs types d'événement, définissez Events à la somme des constantes des événements souhaités.

Syntaxe

(Voir OG_Set_Button.)

Paramètres

Aucun.


Propriété d'événements - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous attribue
**une procédure bouton à
**l'élément de graphique MGR_bars.
*/

PROCEDURE  AssignButtonProc IS
  chart og_object;
  mgrbar og_object;
  button og_buttonproc;
BEGIN
  chart := og_get_object('graphique');
  mgrbar := og_get_object('MGR_bars');
  button := og_get_buttonproc('bouton');
  og_set_button(chart, og_get_row(mgrbar), 'MGR', button, og_mouse_down);
END;


Propriété d'explosion

  Exemples	  Rubriques connexes

Description  Distance à laquelle l'élément de graphique (secteur, par exemple) doit être détaché, exprimé en pourcentage des rayons x et y du graphique (par exemple, 25). Cette propriété n'est significative que lorsqu'elle est utilisée avec un diagramme à secteurs. En outre, tous les secteurs d'une catégorie donnée seront détachés à la même distance. Le nom de colonne indiqué doit donc concerner une colonne de valeurs et non une colonne de catégorie.

Syntaxe

PROCEDURE OG_Set_Explosion
  (chart        OG_Object,
   row_num      NUMBER,
   col_name     VARCHAR2,
   explode_pct  NUMBER);

Paramètres

chart	Objet graphique décrit.
row_num	Numéro de ligne d'interrogation représenté par l'élément de graphique.
col_name	Colonne d'interrogation représentée par l'élément de graphique. Doit être le nom d'une colonne de valeurs.
explode_pct	Distance à laquelle l'élément de graphique (secteur, par exemple) doit être détaché, exprimé en pourcentage des rayons x et y du graphique (par exemple, 25).


Propriété d'explosion - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous définit à 50
**la distance à laquelle l'élément de graphique doit être
**détaché.
*/

PROCEDURE Explosion IS
  pie og_object;
  mgr_slice og_object;
BEGIN
  pie := og_get_object('secteur');
  mgr_slice := og_get_object('MGR_slices');
  og_set_explosion(pie, og_get_row(mgr_slice), 'MGR', 50);
END;


Propriété de nom

  Exemples	  Rubriques connexes

Description  Nom de l'élément de graphique.

Syntaxe

PROCEDURE OG_Set_Name
  (chart     OG_Object,
   row_num   NUMBER,
   col_name  VARCHAR2,
   name      VARCHAR2);

Paramètres

chart	Objet graphique décrit.
row_num	Numéro de ligne d'interrogation représenté par l'élément de graphique.
col_name	Colonne d'interrogation représentée par l'élément de graphique.
name	Nom de l'élément de graphique.


Propriété de nom - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous définit
**le nom de l'élément de graphique.
*/

PROCEDURE Name IS
  chart og_object;
  mgr_bar og_object;
BEGIN
  chart := og_get_object('graphique');
  mgr_bar := og_get_object('Mgr_bars');
  og_set_name(chart, og_get_row(mgr_bar), 'MGR', 'NewName');
END;


Propriétés de graphique

Propriété de mise à jour automatique

Propriété de dernière ligne

Propriété de filtre

Propriété d'interrogation

Propriété de plage

Propriété de taille et de position

Propriété de première ligne

Propriété de modèle

Propriété de titre


Propriété de mise à jour automatique

  Exemples	  Rubriques connexes

Description  Indique que le graphique doit être automatiquement mis à jour lorsque l'interrogation est exécutée.

Syntaxe

PROCEDURE OG_Set_Autoupdate
  (chart       OG_Object,
   autoupdate  BOOLEAN);

FUNCTION OG_Get_Autoupdate
  (chart  OG_Object)
RETURN BOOLEAN;

Paramètres

chart	Graphique décrit.
autoupdate	Indique que le graphique doit être automatiquement mis à jour lorsque l'interrogation est exécutée.


Propriété de mise à jour automatique - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La propriété ci-dessous lit la valeur
**de autoupdate dans les propriétés de graphique
**et redonne à cette valeur la valeur opposée.
*/

PROCEDURE ChartAutoUpdate IS
  chart og_object;
  autoupdate boolean;
BEGIN
  chart := og_get_object('graphique');
  autoupdate := og_get_autoupdate(chart);
  if autoupdate = true then
     og_set_autoupdate(chart, false);
  else
    og_set_autoupdate(chart, true);
   end if;
END;


Propriété de dernière ligne

  Exemples	  Rubriques connexes

Description  Dernière ligne de l'interrogation qui s'affiche sur le graphique.

Syntaxe

(Voir OG_Set_Rows.)

FUNCTION OG_Get_Endrow
  (chart  OG_Object)
RETURN NUMBER;

Paramètres

chart	Objet graphique décrit.


Propriété de dernière ligne - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la
**valeur de la première ligne et la valeur de la dernière ligne
**du graphique(si la case à cocher Tracé de lignes est cochée),
**et fait revenir ces valeurs à startrow -1 et
**endrow -1.)
*/

PROCEDURE ChartStartEnd IS
  chart og_object;
 startrow number;
  endrow number;
BEGIN
  chart := og_get_object('graphique');
  startrow := og_get_startrow(chart);
  endrow := og_get_endrow(chart);
  og_set_rows(chart,true, startrow-1, endrow-1);
END;


Propriété de filtre

  Exemples	  Rubriques connexes

Description  Nom de la procédure de déclenchement de filtre d'interrogation.

Syntaxe

PROCEDURE OG_Set_Filter
  (chart   OG_Object,
   filter  VARCHAR2);

FUNCTION OG_Get_Filter
  (chart  OG_Object)
RETURN VARCHAR2;

Paramètres

chart	Objet graphique décrit.
filter	Nom de la procédure de déclenchement de filtre d'interrogation.


Propriété de filtre - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**le nom du déclencheur de filtre actuel du graphique
**et attribue au graphique un déclencheur de
**filtre différent.
*/

PROCEDURE ChartFilter IS
  chart og_object;
  current_filter varchar2(30);
  new_filter varchar2(30):='Monfiltre';
BEGIN
  chart := og_get_object('graphique');
  current_filter := og_get_filter(chart);
  og_set_filter(chart, new_filter);
END;


Propriété d'interrogation

  Exemples	  Rubriques connexes

Description  Identificateur de l'interrogation à utiliser pour le graphique.

Syntaxe

PROCEDURE OG_Set_Query
  (chart        OG_Object,
   query        OG_Query,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Query
  (chart  OG_Object)
RETURN OG_Query;

Paramètres

chart	Objet graphique décrit.
query	Identificateur de l'interrogation à utiliser pour le graphique.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante


Propriété d'interrogation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit l'identificateur
** de l'interrogation dans le graphique en cours
**(qry0)et redéfinit la valeur de l'identificateur à
**qry1.
*/

PROCEDURE ChartQuery IS
  chart og_object;
  qry0 og_query;
  qry1 og_query;
BEGIN
  chart := og_get_object('graphique');
  qry0 := og_get_query(chart);
  qry1 := og_get_query('query1');
  og_set_query(chart, qry1);
END;


Propriété de plage

  Exemples	  Rubriques connexes

Description  Indique si le nombre de lignes d'interrogation qui s'affichent sur le graphique est limité à la plage indiquée par startrow et endrow.

Syntaxe

PROCEDURE OG_Set_Rows
  (chart      OG_Object,
   rangeflag  BOOLEAN,
   startrow   NUMBER,
   endrow     NUMBER);

FUNCTION OG_Get_Rangeflag
  (chart  OG_Object)
RETURN BOOLEAN;

Paramètres

chart	Objet graphique décrit.
rangeflag	Indique si le nombre de lignes d'interrogation qui s'affichent sur le graphique est limité à la plage indiquée par startrow et endrow.
startrow	Première ligne de l'interrogation qui s'affiche sur le graphique. La première ligne de l'interrogation porte le numéro 0, la deuxième le numéro 1, et ainsi de suite.
endrow	Dernière ligne de l'interrogation qui s'affiche sur le graphique.


Propriété de plage - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**le nombre de lignes de l'interrogation qui s'affichent
**sur le graphique est limité par la plage indiquée.
**Dans l'affirmative, elle redéfinit la valeur à FALSE
**(c'est-à-dire trace toutes les lignes) ; dans le cas contraire,
**elle redéfinit la valeur à TRUE avec une
**plage restreinte indiquée par
**startrow et endrow.
*/

PROCEDURE ChartRange IS
  chart og_object;
  rangeflag boolean;
  startrow number := 3;
  endrow number := 9;
BEGIN
  chart := og_get_object('graphique');
  rangeflag := og_get_rangeflag(chart);
  if rangeflag = true then
     og_set_rows(chart,false, startrow, endrow);
  else
    og_set_rows(chart, true, startrow, endrow);
  end if;
END;


Propriété de taille et de position

  Exemples	  Rubriques connexes

Description  Coordonnées x et y, hauteur et largeur du cadre du graphique (en unités de présentation).

Syntaxe

PROCEDURE OG_Set_Frame
  (chart        OG_Object,
   frame        OG_Rectangle,
   damage       BOOLEAN       :=  TRUE,
   update_bbox  BOOLEAN       :=  TRUE);

FUNCTION OG_Get_Frame
  (chart  OG_Object)
RETURN OG_Rectangle;

Paramètres

chart	Objet graphique décrit.
frame	Coordonnées x et y, hauteur et largeur du cadre du graphique (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de taille et de position - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la
**taille du cadre du graphique et la diminue de moitié.
*/

PROCEDURE SizeAndPos IS
  chart og_object;
  rect og_rectangle;
BEGIN
  chart := og_get_object('graphique');
    rect := og_get_frame(chart);
  rect.x := rect.x/2;
  rect.y := rect.y/2;
  rect.height := rect.height/2;
  rect.width := rect.width/2;
  og_set_frame(chart, rect);
END;


Propriété de première ligne

  Exemples	  Rubriques connexes

Description  Première ligne de l'interrogation qui s'affiche sur le graphique. La première ligne de l'interrogation porte le numéro 0, la deuxième porte le numéro 1, et ainsi de suite.

Syntaxe

(Voir OG_Set_Rows, ci-dessus.)

FUNCTION OG_Get_Startrow
  (chart  OG_Object)
RETURN NUMBER;

Paramètres

chart	Objet graphique décrit.


Propriété de première ligne - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la valeur de la
** première ligne et la valeur de la dernière ligne de l'interrogation
**(si la case à cocher Tracé de lignes est cochée),
**et fait revenir ces valeurs à startrow -1 et
**endrow -1.)
*/

PROCEDURE ChartStartEnd IS
  chart og_object;
 startrow number;
  endrow number;
BEGIN
  chart := og_get_object('graphique');
  startrow := og_get_startrow(chart);
  endrow := og_get_endrow(chart);
  og_set_rows(chart,true, startrow-1, endrow-1);
END;


Propriété de modèle

  Exemples	  Rubriques connexes

Description  Identificateur du modèle à utiliser pour le graphique.

Syntaxe

PROCEDURE OG_Set_Template
  (chart        OG_Object,
   template     OG_Template,
   damage       BOOLEAN      :=  TRUE,
   update_bbox  BOOLEAN      :=  TRUE);

FUNCTION OG_Get_Template
  (chart  OG_Object)
RETURN OG_Template;

Paramètres

chart	Objet graphique décrit.
template	Identificateur du modèle à utiliser pour le graphique.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de modèle - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit les identificateurs
**de modèle modèle1 et modèle2 de
**graphique1 et graphique2, respectivement, et
**attribue modèle1 à graphique2 et modèle2 à
**graphique1.
*/

PROCEDURE ChartTemplate IS
  chart1 og_object;
  chart2 og_object;
  template1 og_template;
  template2 og_template;
BEGIN
  chart1 := og_get_object('graphique1');
  chart2 := og_get_object('graphique2');
  template1 := og_get_template(chart1);
  template2 := og_get_template(chart2);
  og_set_template(chart1, template2);
  og_set_template(chart2, template1);
END;


Propriété de titre

  Exemples	  Rubriques connexes

Description  Titre du graphique.

Syntaxe

PROCEDURE OG_Set_Title
  (chart  OG_Object,
   title  VARCHAR2);

FUNCTION OG_Get_Title
  (chart  OG_Object)
RETURN VARCHAR2;

Paramètres

chart	Objet graphique décrit.
Title	Titre du graphique.


Propriété de titre - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**le titre d'un graphique et
**compare la valeur à new_title. En cas
**de différence, remplace le titre
**par new_title.
*/

PROCEDURE ChartTitle IS
  chart og_object;
  title varchar2(30);
  new_title varchar2(30) := 'Nouveau titre';
BEGIN
  chart := og_get_object('graphique');
  title := og_get_title(chart);
  if title != new_title then
    og_set_title(chart, new_title);
  end if;
END;


Propriétés d'affichage

Propriété de déclencheur de fermeture

Propriété de format de date

Propriété de hauteur

Propriété de déclencheur d'ouverture

Propriété de largeur


Propriété de déclencheur de fermeture

  Exemples	  Rubriques connexes

Description  Nom du déclencheur d'affichage Close Display.

Syntaxe

PROCEDURE OG_Set_Closetrigger
  (trigger  VARCHAR2);

FUNCTION OG_Get_Closetrigger
RETURN VARCHAR2;

Paramètres

trigger	Nom du déclencheur d'affichage Close Display.


Propriété de déclencheur de fermeture - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit le nom
**du déclencheur de fermeture de l'affichage
**en cours. Si le déclencheur est autre que
**new_trigger, elle définit new_trigger comme la
**procédure de déclencheur de fermeture en cours.
*/

PROCEDURE CloseTrigger IS
  val varchar2(20);
  new_trigger varchar2(20) := 'CURSORDEFAULT';
BEGIN
   val := og_get_closetrigger;
   if val != new_trigger then
     og_set_closetrigger('CursorDefault');
   end if;
END;


Propriété de format de date

  Exemples	  Rubriques connexes

Description  Format de date des paramètres. Vous devez indiquer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

OG_Set_Dateformat
  (dateformat  VARCHAR2);

OG_Get_Dateformat
RETURN VARCHAR2;

Paramètres

dateformat	Format de date des paramètres. Vous devez indiquer une chaîne de format SQL valide.


Propriété de format de date - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit le format
**de date de l'affichage. S'il n'est pas le même que
**new_datefmt, elle définit le format en
**cours à new_format.
*/

PROCEDURE datefmt IS
  datefmt varchar2(20);
  new_datefmt varchar2(20) := 'JJ/MM/AAAA';
BEGIN
  datefmt := og_get_dateformat;
  if datefmt != new_datefmt then
    og_set_dateformat('JJ/MM/AAAA');
  end if;
END;


Propriété de hauteur

  Exemples	  Rubriques connexes

Description  Hauteur de la présentation (en unités de présentation).

Syntaxe

(Voir OG_Set_Display_Size.)

FUNCTION OG_Get_Display_Height
RETURN NUMBER;

Paramètres

Aucun.


Propriété de hauteur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/*La procédure ci-dessous lit la largeur
**et la hauteur de l'affichage en cours et
**divise par deux la taille de l'affichage.
*/

PROCEDURE dimension0 IS
  width number;
  height number;
BEGIN
  width := og_get_display_width;
  height := og_get_display_height;
  og_set_display_size(width/2, height/2);
END;


Propriété de déclencheur d'ouverture

  Exemples	  Rubriques connexes

Description  Nom du déclencheur d'affichage Open Display.

Syntaxe

PROCEDURE OG_Set_Opentrigger
  (trigger  VARCHAR2);

FUNCTION OG_Get_Opentrigger
RETURN VARCHAR2;

Paramètres

trigger	Nom du déclencheur d'affichage Open Display.


Propriété de déclencheur d'ouverture - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le nom
**du déclencheur d'ouverture de l'affichage
**en cours. Si le déclencheur est autre que
**new_trigger, elle définit new_trigger comme la
**procédure de déclencheur d'ouverture en cours.
*/
*/

PROCEDURE OpenTrigger IS
  val varchar2(20);
  new_trigger varchar2(20) := 'TOBLUE';
BEGIN
  val := og_get_opentrigger;
  if val != 'TOBLUE' then
    og_set_opentrigger('toblue');
  end if;
END;


Propriété de largeur

  Exemples	  Rubriques connexes

Description  Largeur de la présentation (en unités de présentation).

Syntaxe

PROCEDURE OG_Set_Display_Size
  (width   NUMBER,
   height  NUMBER);

FUNCTION OG_Get_Display_Width
RETURN NUMBER;

Paramètres

width	Largeur de la présentation (en unités de présentation).
height	Hauteur de la présentation (en unités de présentation).


Propriété de largeur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit la largeur
**et la hauteur de l'affichage en cours et
**divise par deux la taille de l'affichage.
*/

PROCEDURE dimension0 IS
  width number;
  height number;
BEGIN
  width := og_get_display_width;
  height := og_get_display_height;
  og_set_display_size(width/2, height/2);
END;


Propriétés d'encadrement (graphique à axes)

Propriété d'axe de ligne de base

Propriété de valeur de ligne de base

Propriété de largeur de catégorie

Propriété de format de date personnalisé

Propriété de format numérique personnalisé

Propriété de nombre de lignes de référence

Propriété de second axe des Y


Propriété d'axe de ligne de base

  Exemples	  Rubriques connexes

Description  Axe auquel la valeur de la ligne de base est comparée pour déterminer sa position. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Template

OG_Y1_Axis

OG_Y2_Axis

Syntaxe

PROCEDURE OG_Set_Baseaxis
  (template  OG_Template,
   baseaxis  NUMBER);

FUNCTION OG_Get_Baseaxis
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
baseaxis	Axe auquel la valeur de la ligne de base est comparée pour déterminer sa position.


Propriété d'axe de ligne de base - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

*/La procédure ci-dessous indique le
**format de date du libellé de la ligne de base
*/

PROCEDURE CusDateFmt IS
  chart og_object;
  template og_template;
  custDate date;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  custDate := og_get_cust_date(template);
  if custDate != '06-DEC-88' then
    og_set_cust_date(template, '06-DEC-96');
  end if;
END;


Propriété de valeur de ligne de base

  Exemples	  Rubriques connexes

Description  Valeur utilisée comme point de départ du traçage des champs sur l'axe des valeurs. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Custom_Baseline

OG_Min_Baseline

OG_Zero_Baseline

Syntaxe

PROCEDURE OG_Set_Basevalue
  (template   OG_Template,
   basevalue  NUMBER);

FUNCTION OG_Get_Basevalue
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
basevalue	Valeur utilisée comme point de départ du traçage des champs sur l'axe des valeurs.


Propriété de valeur de ligne de base - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit
**la valeur de la ligne de base
**du modèle de champ d'un graphique. Si cette
**valeur est égale à ZERO,
**la procédure redéfinit la valeur à
**MAX ; si cette valeur est différente
**de ZERO, la procédure redéfinit
**la valeur à ZERO.
*/

PROCEDURE BaseLine IS
  chart og_object;
  template og_template;
  value number;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  value := og_get_basevalue(template);
  if value = og_zero_baseline then
    og_set_basevalue(template, og_max_baseline);
  else
    og_set_basevalue(template, og_zero_baseline);
  end if;
  og_update_chart(chart);
END;


Propriété de largeur de catégorie

  Exemples	  Rubriques connexes

Description  Largeur des barres d'un graphique à barres ou à colonnes, en pourcentage de la "largeur des bandes". Cette valeur correspond à la plus grande largeur que peuvent avoir les barres sans se chevaucher et est déterminée par la division de la longueur de l'axe des catégories par le nombre de barres à tracer.

Syntaxe

PROCEDURE OG_Set_Catwidth
  (template  OG_Template,
   catwidth  NUMBER);

FUNCTION OG_Get_Catwidth
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
catwidth	Largeur des barres d'un graphique à barres ou à colonnes, en pourcentage de la "largeur des bandes". Cette valeur correspond à la plus grande largeur que peuvent avoir les barres sans se chevaucher et est déterminée par la division de la longueur de l'axe des catégories par le nombre de barres à tracer.


Propriété de largeur de catégorie - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* La procédure ci-dessous divise par
** deux la largeur de catégorie des barres,
**par rapport à la largeur d'origine.
*/

PROCEDURE CatWidth IS
  chart og_object;
  template og_template;
  width number;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  width := og_get_catwidth(template);
  og_set_catwidth(template, width/2);
END;


Propriété de format de date personnalisé

  Exemples	  Rubriques connexes

Description  Date personnalisée à définir pour la valeur de date personnalisée. Cette option définit automatiquement la valeur de base à OG_CUSTOM_BASELINE.

Syntaxe

PROCEDURE OG_Set_Cust_Date
  (template   OG_Template,
   cust_date  DATE);

FUNCTION OG_Get_Cust_Date
  (template  OG_Template)
RETURN DATE;

Paramètres

template	Modèle de graphique.
cust_date	Valeur de date d'un axe de type date. Cette valeur est utilisée comme référence pour le tracé des points de données sur l'axe des valeurs.


Propriété de format de date personnalisé - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous indique
**le format de date du libellé de la ligne de base.
*/

PROCEDURE CusDateFmt IS
  chart og_object;
  template og_template;
  custDate date;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  custDate := og_get_cust_date(template);
  if custDate != '06-DEC-88' then
    og_set_cust_date(template, '06-DEC-96');
  end if;
END;


Propriété de format numérique personnalisé

  Exemples	  Rubriques connexes

Description  Nombre personnalisé à définir pour la ligne de base. Cette option définit automatiquement la valeur de base à OG_CUSTOM_BASELINE.

Syntaxe

PROCEDURE OG_Set_Cust_Num
  (template  OG_Template,
   cust_num  NUMBER);

FUNCTION OG_Get_Cust_Num
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
cust_num	Valeur de la ligne de base d'un axe de type numérique. Cette valeur est utilisée comme référence pour le tracé des points de données le long de l'axe de valeurs.


Propriété de format numérique personnalisé - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous indique
**le format des nombres du libellé de la ligne de base.
*/

PROCEDURE CusNumFmt IS
  chart og_object;
  template og_template;
  num number;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  num := og_get_cust_num(template);
  og_set_cust_num(template, num/2);
END;


Propriété de nombre de lignes de référence

  Exemples	  Rubriques connexes

Description  Nombre de lignes de référence appartenant au modèle de graphique.

Syntaxe

FUNCTION OG_Get_Reflinect
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.


Propriété de nombre de lignes de référence - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit le
**nombre de lignes de référence et
**l'imprime dans un objet texte.
*/

PROCEDURE RefLineCnt IS
  text og_object;
  chart og_object;
  template og_template;
  cnt number;
BEGIN
  text := og_get_object('objet texte');
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  cnt := og_get_reflinect(template);
  og_set_str(text, cnt);
END;


Propriété de second axe des Y

  Exemples	  Rubriques connexes

Description  Indique si le graphique doit comporter un deuxième axe des Y.

Syntaxe

PROCEDURE OG_Set_Second_Y
  (template  OG_Template,
   second_y  BOOLEAN);

FUNCTION OG_Get_Second_Y
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
second_y	Indique si le graphique doit comporter un deuxième axe des Y.


Propriété de second axe des Y - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* La procédure ci-dessous détermine si
**le graphique comporte un second axe des Y.
**Dans la négative, elle l'ajoute.
*/

PROCEDURE SecondY IS
  chart og_object;
  template og_template;
  axis boolean;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  axis := og_get_second_y(template);
    if axis = false then
      og_set_second_y(template, true);
   end if;
  og_update_chart(chart);
END;


Propriétés d'encadrement générique

Propriété de profondeur

Propriété de nombre de modèles de champ

Propriété de type d'encadrement

Propriété de légende

Propriété de nombre de colonnes de légende

Propriété de nom

Propriété d'encadrement de tracé

Propriété de racine

Propriété d'orientation de l'ombre

Propriété de taille d'ombre


Propriété de profondeur

  Exemples	  Rubriques connexes

Description  Profondeur suivant laquelle l'encadrement et les éléments du graphique doivent être dessinés pour donner un aspect tridimensionnel. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_None_Depthsize

OG_Small_Depthsize

OG_Medium_Depthsize

OG_Large_None_Depthsize

OG_Xlarge_Depthsize

Syntaxe

PROCEDURE OG_Set_Depthsize
  (template   OG_Template,
   depthsize  NUMBER);

FUNCTION OG_Get_Depthsize
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
depthsize	Profondeur suivant laquelle l'encadrement et les éléments du graphique doivent être dessinés pour donner un aspect tridimensionnel.


Propriété de profondeur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit la profondeur
**du graphique et lui donne une
**valeur différente.
*/

PROCEDURE FrameDepth IS
  chart og_object;
  template og_template;
  depth number;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  depth := og_get_depthsize(template);
  if depth = og_none_depthsize then
     og_set_depthsize(template, og_small_depthsize);
  elsif depth = og_small_depthsize then
     og_set_depthsize(template, og_medium_depthsize);
  elsif depth = og_medium_depthsize then
     og_set_depthsize(template, og_large_depthsize);
  elsif depth = og_large_depthsize then
     og_set_depthsize(template, og_xlarge_depthsize);
  elsif depth = og_xlarge_depthsize then
     og_set_depthsize(template, og_none_depthsize);
  end if;
END;


Propriété de nombre de modèles de champ

  Exemples	  Rubriques connexes

Description  Nombre de modèles de champ appartenant au modèle de graphique.

Syntaxe

FUNCTION OG_Get_Ftempct
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.


Propriété de nombre de modèles de champ - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit le numéro
**du modèle de champ appartenant au
**modèle en cours et imprime la valeur dans un objet texte.
*/

PROCEDURE FTempCnt IS
  text og_object;
  chart og_object;
  template og_template;
  num number;
BEGIN
  text := og_get_object('objet texte');
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  num := og_get_ftempct(template);
  og_set_str(text, num);
 END;


Propriété de type d'encadrement

  Exemples	  Rubriques connexes

Description  Type du graphique représenté par ce modèle. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Axis_Frametype

OG_Pie_Frametype

OG_Table_Frametype

Syntaxe

FUNCTION OG_Get_Frametype
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.


Propriété de type d'encadrement - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit le type d'encadrement
**et imprime la valeur dans un objet texte.
*/

PROCEDURE FrameType IS
  text og_object;
  chart og_object;
  template og_template;
  num number;
BEGIN
  text := og_get_object('objet texte');
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  num := og_get_frametype(template);
  if num = og_axis_frametype then
    og_set_str(text, 'axes');
  elsif num = og_pie_frametype then
    og_set_str(text ,'secteurs');
  elsif num = og_table_frametype then
    og_set_str(text, 'tableaux');
  end if;
END;


Propriété de légende

  Exemples	  Rubriques connexes

Description  Indique si la légende du graphique doit être affichée. (Ne s'applique pas aux graphiques de type tableau.)

Syntaxe

PROCEDURE OG_Set_Legend
  (template  OG_Template,
   show      BOOLEAN);

FUNCTION OG_Get_Legend
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
show	Indique si la légende du graphique doit être affichée. (Ne s'applique pas aux graphiques de type tableau.)


Propriété de légende - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous détermine
**si une légende doit être affichée ou non.
**Dans l'affirmative, elle la masque ; si la
**légende est masquée, elle l'affiche.
*/

PROCEDURE FrameLegend IS
  chart og_object;
  template og_template;
  val boolean;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  val := og_get_legend(template);
  if val = true then
     og_set_legend(template, false);
  else
     og_set_legend(template, true);
  end if;
END;


Propriété de nombre de colonnes de légende

  Exemples	  Rubriques connexes

Description  Nombre de colonnes utilisées pour afficher les étiquettes figurant dans la légende.

Syntaxe

PROCEDURE OG_Set_Legendcolct
  (template  OG_Template,
   colct     NUMBER);

FUNCTION OG_Get_Legendcolct
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
colct	Nombre de colonnes utilisées pour afficher les étiquettes figurant dans la légende.


Propriété de nombre de colonnes de légende - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit le nombre de
**colonnes de la boîte de la légende. Si la boîte
**comporte plus d'une colonne, remplace le
**nombre de colonnes par 1 ; s'il n'y a
**qu'une colonne, remplace le nombre de colonnes
**par 2.
*/

PROCEDURE FrameLegendCol IS
  chart og_object;
  template og_template;
  num number;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  num := og_get_legendcolct(template);
  if num > 1 then
     og_set_legendcolct(template, 1);
  else
     og_set_legendcolct(template, 2);
  end if;
END;


Propriété de nom

  Exemples	  Rubriques connexes

Description  Nom du modèle de graphique.

Syntaxe

PROCEDURE OG_Set_Frame_Name
  (template  OG_Template,
   name      VARCHAR2);

FUNCTION OG_Get_Frame_Name
  (template  OG_Template)
RETURN VARCHAR2;

Paramètres

template	Modèle de graphique.
name	Nom du modèle de graphique.


Propriété de nom - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit le nom du graphique.
**Si ce nom n'est pas 'modèle1', elle le définit
**à 'modèle1'.
*/

PROCEDURE FrameName IS
  chart og_object;
  template og_template;
  name varchar2(30);
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  name := og_get_frame_name(template);
  if name != 'template1' then
    og_set_frame_name(template, 'modèle1');
  end if;
END;


Propriété d'encadrement de tracé

  Exemples	  Rubriques connexes

Description  Indique si le rectangle qui entoure le graphique doit être affiché. (Ne s'applique pas aux graphiques à secteurs.)

Syntaxe

PROCEDURE OG_Set_Plotframe
  (template  OG_Template,
   show      BOOLEAN);

FUNCTION OG_Get_Plotframe
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
show	Indique si le rectangle qui entoure le graphique doit être affiché.


Propriété d'encadrement de tracé - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous détermine si l'encadrement
**du graphique doit être tracé. Si cette propriété
**a la valeur true, la procédure supprime le cadre du tracé ;
**si la valeur est false, la procédure ajoute un encadrement
**de tracé au graphique en cours.
*/

PROCEDURE FramePlot IS
  chart og_object;
  template og_template;
  val boolean;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  val := og_get_plotframe(template);
  if val = true then
     og_set_plotframe(template, false);
  else
     og_set_plotframe(template, true);
  end if;
END;


Propriété de racine

  Exemples	  Rubriques connexes

Description  Identificateur du modèle de graphique.

Syntaxe

FUNCTION OG_Get_Root
  (template  OG_Template)
RETURN OG_Object;

Paramètres

template	Modèle de graphique.


Propriété de racine - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous fournit l'identificateur
**(racine) de l'objet graphique.
*/

PROCEDURE FrameRoot IS
  chart og_object;
  template og_template;
  root og_object;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  root := og_get_root(template);
END;


Propriété d'orientation de l'ombre

  Exemples	  Rubriques connexes

Description  Orientation de l'ombre de l'encadrement et des éléments du graphique. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Upperright_Shadowdir

OG_Upperleft_Shadowdir

OG_Lowerright_Shadowdir

OG_Lowerleft_Shadowdir

Syntaxe

PROCEDURE OG_Set_Shadowdir
  (template   OG_Template,
   shadowdir  NUMBER);

FUNCTION OG_Get_Shadowdir
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
shadowdir	Orientation de l'ombre de l'encadrement et des éléments du graphique.


Propriété d'orientation de l'ombre - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

*/La procédure ci-dessous lit l'orientation de l'ombre
**du graphique et lui donne une valeur
**différente.
*/

PROCEDURE FrameShadowDir IS
  chart og_object;
  template og_template;
  shadow number;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  shadow := og_get_shadowdir(template);
  if shadow = og_upperright_shadowdir then
     og_set_shadowdir(template, og_lowerleft_shadowdir);
  elsif shadow = og_lowerleft_shadowdir then
     og_set_shadowdir(template, og_upperleft_shadowdir);
  elsif shadow = og_upperleft_shadowdir then
     og_set_shadowdir(template, og_lowerright_shadowdir);
  elsif shadow = og_lowerright_shadowdir then
     og_set_shadowdir(template, og_upperright_shadowdir);
  end if;
END;


Propriété de taille d'ombre

  Exemples	  Rubriques connexes

Description  Taille de l'ombre de l'encadrement et des éléments du graphique. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_None_Shadowsize

OG_Small_Shadowsize

OG_Medium_Shadowsize

OG_Large_Shadowsize

OG_Xlarge_Shadowsize

Syntaxe

PROCEDURE OG_Set_Shadowsize
  (template    OG_Template,
   shadowsize  NUMBER);

FUNCTION OG_Get_Shadowsize
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
shadowsize	Taille de l'ombre de l'encadrement et des éléments du graphique.


Propriété de taille d'ombre - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/*La procédure ci-dessous lit la taille de l'ombre
**du graphique et lui donne une valeur
**différente.
*/

PROCEDURE FrameShadow IS
  chart og_object;
  template og_template;
  shadow number;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  shadow := og_get_shadowsize(template);
  if shadow = og_none_shadowsize then
     og_set_shadowsize(template, og_small_shadowsize);
  elsif shadow = og_small_shadowsize then
     og_set_shadowsize(template, og_medium_shadowsize);
  elsif shadow = og_medium_shadowsize then
     og_set_shadowsize(template, og_large_shadowsize);
  elsif shadow = og_large_shadowsize then
     og_set_shadowsize(template, og_xlarge_shadowsize);
  elsif shadow = og_xlarge_shadowsize then
     og_set_shadowsize(template, og_none_shadowsize);
  end if;
END;


Propriétés d'encadrement (graphique à secteurs)

Propriété de catégories

Propriété de format de date de catégorie

Propriété de format numérique de catégorie

Propriété de valeurs de données

Propriété d'absence de chevauchement

Propriété Autres

Propriété de format de pourcentage

Propriété de valeurs de pourcentage

Propriété d'ordre de traçage

Propriété de repères

Propriété d'utilisation

Propriété de valeur d'utilisation

Propriété de format de valeur


Propriété de catégories

  Exemples	  Rubriques connexes

Description  Indique si chaque secteur de graphique comporte une étiquette indiquant le nom de la catégorie qu'il représente.

Syntaxe

PROCEDURE OG_Set_Categs
  (template  OG_Template,
   categs    BOOLEAN);

FUNCTION OG_Get_Categs
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
categs	Indique si chaque secteur de graphique comporte une étiquette indiquant le nom de la catégorie qu'il représente.


Propriété de catégories - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous extrait des
**informations sur la relation
**entre les secteurs d'un graphique et
**l'ensemble du graphique. Si la
**relation est TOTALVALUE, la
**procédure redéfinit la relation
**à PERCENTAGE avec la valeur 50 ;
**Si la relation est PERCENTAGE,
**la procédure redéfinit la relation
**à TOTALVALUE avec
**la valeur 400000.
*/

PROCEDURE PieUsage IS
  pie og_object;
  template og_template;
  usage number;
  usagevalue number;
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  usage := og_get_usage(template);
  if usage = og_totalvalue_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_pct_usage, 50);
   elsif usage = og_pct_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_totalvalue_usage, 400000);
  end if;
  og_update_chart(pie);
END;


Propriété de format de date de catégorie

  Exemples	  Rubriques connexes

Description  Format de date des étiquettes de catégorie. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

PROCEDURE OG_Set_Catdatefmt
  (template    OG_Template,
   catdatefmt  VARCHAR2);

FUNCTION OG_Get_Catdatefmt
  (template  OG_Template)
RETURN VARCHAR2;

Paramètres

template	Modèle de graphique.
catdatefmt	Format de date des étiquettes de catégorie. Vous devez entrer une chaîne de format SQL valide.


Propriété de format de date de catégorie - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous modifie le format
**de date des étiquettes des secteurs si le
**format n'est pas
**'JJ-MM-AA'.
*/

PROCEDURE CatDateFmt IS
  pie og_object;
  template og_template;
  format varchar2(20);
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  format := og_get_catdatefmt(template);
  if format != 'MM-JJ-AA' then
   og_set_catdatefmt(template, 'MM-JJ-AA');
  end if;
  og_update_chart(pie);
END;


Propriété de format numérique de catégorie

  Exemples	  Rubriques connexes

Description  Format numérique des étiquettes de catégorie. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

PROCEDURE OG_Set_Catnumfmt
  (template   OG_Template,
   catnumfmt  VARCHAR2);

FUNCTION OG_Get_Catnumfmt
  (template  OG_Template)
RETURN VARCHAR2;

Paramètres

template	Modèle de graphique.
catnumfmt	Format numérique des étiquettes de catégorie. Vous devez entrer une chaîne de format SQL valide.


Propriété de format numérique de catégorie - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous modifie le format
**numérique des étiquettes des secteurs si
**le format n'est pas
**'9,9,9,9'.
*/

PROCEDURE CatNumFmt IS
  pie og_object;
  template og_template;
  format varchar2(20);
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  format := og_get_catnumfmt(template);
  if format != '9,9,9,9' then
    og_set_catnumfmt(template, '9,9,9,9');
  end if;
  og_update_chart(pie);
END;


Propriété de valeurs de données

  Exemples	  Rubriques connexes

Description  Indique si chaque secteur comporte une étiquette indiquant la valeur des données.

Syntaxe

PROCEDURE OG_Set_Datavals
  (template  OG_Template,
   datavals  BOOLEAN);

FUNCTION OG_Get_Datavals
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
datavals	Indique si chaque secteur comporte une étiquette indiquant la valeur des données.


Propriété de valeurs de données - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous masque/affiche
** la valeur des données de chaque secteur.
*/

PROCEDURE DataVals IS
  pie og_object;
  template og_template;
  val boolean;
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  val := og_get_datavals(template);
  if val = true then
   og_set_datavals(template, false);
  elsif val = false then
   og_set_datavals(template, true);
  end if;
  og_update_chart(pie);
END;


Propriété d'absence de chevauchement

  Exemples	  Rubriques connexes

Description  Indique que les étiquettes des secteurs du graphique ne doivent pas se chevaucher.

Syntaxe

PROCEDURE OG_Set_Nooverlap
  (template   OG_Template,
   nooverlap  BOOLEAN);

FUNCTION OG_Get_Nooverlap
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
nooverlap	Indique que les étiquettes des secteurs du graphique ne doivent pas se chevaucher.


Propriété d'absence de chevauchement - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous détermine si les étiquettes
**des secteurs peuvent se chevaucher.
**Si le chevauchement est autorisé, la procédure
**l'interdit.
*/

PROCEDURE NoOverlap IS
  pie og_object;
  template og_template;
  val boolean;
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  val := og_get_nooverlap(template);
  if val = false then
     og_set_nooverlap(template, true);
  end if;
  og_update_chart(pie);
END;


Propriété Autres

  Exemples	  Rubriques connexes

Description  Indique le pourcentage minimum du graphique qu'une valeur de données doit représenter pour apparaître sous la forme d'un secteur séparé dans le graphique à secteurs. Les valeurs de données qui représentent des pourcentages inférieurs à cette valeur sont combinées en un seul secteur portant la mention "Autres".

Syntaxe

PROCEDURE OG_Set_Other
  (template  OG_Template,
   other     NUMBER);

FUNCTION OG_Get_Other
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
other	Indique le pourcentage minimum du graphique qu'une valeur de données doit représenter pour apparaître sous la forme d'un secteur séparé dans le graphique à secteurs. Les valeurs de données qui représentent des pourcentages inférieurs à cette valeur sont combinées en un seul secteur portant la mention "Autres".


Propriété Autres - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous double la valeur
**de pourcentage pour laquelle
**un secteur de graphique quelconque, ayant
**une valeur inférieure ou égale à
**la valeur du pourcentage, sera marqué
**»Autres.»
*/

PROCEDURE Other IS
  pie og_object;
  template og_template;
  num number;
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  num := og_get_other(template);
  og_set_other(template, num*2);
  og_update_chart(pie);
END;


Propriété de format de pourcentage

  Exemples	  Rubriques connexes

Description  Format numérique des étiquettes de valeur de pourcentage. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

PROCEDURE OG_Set_Pctfmt
  (template  OG_Template,
   pctfmt    VARCHAR2);

FUNCTION OG_Get_Pctfmt
  (template  OG_Template)
RETURN VARCHAR2;

Paramètres

template	Modèle de graphique.
pctfmt	Format numérique des étiquettes de valeur de pourcentage. Vous devez entrer une chaîne de format SQL valide.


Propriété de format de pourcentage - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous masque/affiche
**la valeur de pourcentage de chaque secteur.
*/

PROCEDURE PctVals IS
  pie og_object;
  template og_template;
  val boolean;
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  val := og_get_pctvalues(template);
  if val = true then
   og_set_pctvalues(template, false);
  elsif val = false then
   og_set_pctvalues(template, true);
  end if;
  og_update_chart(pie);
END;


Propriété de valeurs de pourcentage

  Exemples	  Rubriques connexes

Description  Indique si chaque secteur comporte une étiquette indiquant le pourcentage du graphique qu'il représente.

Syntaxe

PROCEDURE OG_Set_Pctvalues
  (template   OG_Template,
   pctvalues  BOOLEAN);

FUNCTION OG_Get_Pctvalues
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
pctvalues	Indique si chaque secteur comporte une étiquette indiquant le pourcentage du graphique qu'il représente.


Propriété de valeurs de pourcentage - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous masque/affiche
**le pourcentage de chaque secteur.
*/

PROCEDURE PctVals IS
  pie og_object;
  template og_template;
  val boolean;
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  val := og_get_pctvalues(template);
  if val = true then
   og_set_pctvalues(template, false);
  elsif val = false then
   og_set_pctvalues(template, true);
  end if;
  og_update_chart(pie);
END;


Propriété d'ordre de traçage

  Exemples	  Rubriques connexes

Description  Direction dans laquelle les valeurs de données sont tracées. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Ccw_Plotorder   Les valeurs sont tracées dans le sens inverse de celui des aiguilles d'une montre.

OG_Cw_Plotorder   Les valeurs sont tracées dans le sens des aiguilles d'une montre.

Syntaxe

PROCEDURE OG_Set_Plotorder
  (template   OG_Template,
   plotorder  NUMBER);

FUNCTION OG_Get_Plotorder
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
plotorder	Direction dans laquelle les valeurs de données sont tracées.


Propriété d'ordre de traçage - Exemples

  Liste alphabétique           [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit la
**direction dans laquelle les valeurs de données
**sont tracées et
**inverse cette direction.
*/

PROCEDURE plotOrder IS
  pie og_object;
  template og_template;
  porder number;
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  porder := og_get_plotorder(template);
  if porder = og_cw_plotorder then
     og_set_plotorder(template, og_ccw_plotorder);
  else
     og_set_plotorder(template, og_cw_plotorder);
  end if;
  og_update_chart(pie);
END;


Propriété de repères

  Exemples	  Rubriques connexes

Description  Indique si les repères de graduation qui relient chaque secteur du graphique à son étiquette sont affichés.

Syntaxe

PROCEDURE OG_Set_Ticks
  (template  OG_Template,
   ticks     BOOLEAN);

FUNCTION OG_Get_Ticks
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
ticks	Indique si les repères de graduation qui relient chaque secteur du graphique à son étiquette sont affichés.


Propriété de repères - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous masque/affiche
**les repères de chaque
**secteur
*/

PROCEDURE ticks IS
  pie og_object;
  template og_template;
  val boolean;
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  val := og_get_ticks(template);
  if val = true then
   og_set_ticks(template, false);
  else
   og_set_ticks(template, true);
  end if;
  og_update_chart(pie);
END;


Propriété d'utilisation

  Exemples	  Rubriques connexes

Description  Indique la relation entre les différents secteurs et l'ensemble du graphique. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Totalvalue_Usage

OG_Pct_Usage

Syntaxe

PROCEDURE OG_Set_Usage
  (template  OG_Template,
   usage       NUMBER,
   usagevalue  NUMBER);

FUNCTION OG_Get_Usage
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
usage	Indique la relation entre les différents secteurs et l'ensemble du graphique.
usagevalue	Chaque secteur est tracé comme si sa valeur de données était un pourcentage de la valeur totale indiquée ici. (Valide uniquement si usage est défini à OG_TOTALVALUE_USAGE.)


Propriété d'utilisation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous extrait des
**informations sur la relation
**entre les secteurs d'un graphique et
**l'ensemble du graphique. Si la
**relation est TOTALVALUE, la
**procédure redéfinit la relation
**à PERCENTAGE, avec la valeur 50 ;
**Si la relation est PERCENTAGE,
**la procédure redéfinit la relation
**à TOTALVALUE, avec la valeur 400000.
*/

PROCEDURE PieUsage IS
  pie og_object;
  template og_template;
  usage number;
  usagevalue number;
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  usage := og_get_usage(template);
  if usage = og_totalvalue_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_pct_usage, 50);
   elsif usage = og_pct_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_totalvalue_usage, 400000);
  end if;
  og_update_chart(pie);
END;


Propriété de valeur d'utilisation

  Exemples	  Rubriques connexes

Description  Chaque secteur est tracé comme si sa valeur de données était un pourcentage de la valeur totale indiquée ici.

Syntaxe

(See OG_Set_Usage, above.)

FUNCTION OG_Get_Usagevalue
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.


Propriété de valeur d'utilisation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous extrait des
**informations sur la relation
**entre les secteurs d'un graphique et
**l'ensemble du graphique. Si la
**relation est TOTALVALUE, la
**procédure redéfinit la relation
**à PERCENTAGE, avec la valeur 50 ;
**Si la relation est PERCENTAGE,
**la procédure redéfinit la relation
**à TOTALVALUE, avec la valeur 400000.
*/

PROCEDURE PieUsage IS
  pie og_object;
  template og_template;
  usage number;
  usagevalue number;
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  usage := og_get_usage(template);
  if usage = og_totalvalue_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_pct_usage, 50);
   elsif usage = og_pct_usage then
     usagevalue := og_get_usagevalue(template);
     og_set_usage(template, og_totalvalue_usage, 400000);
  end if;
  og_update_chart(pie);
END;


Propriété de format de valeur

  Exemples	  Rubriques connexes

Description  Format numérique des étiquettes de valeur de données. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

PROCEDURE OG_Set_Valuefmt
  (template     OG_Template,
   valuenumfmt  VARCHAR2);

FUNCTION OG_Get_Valuefmt
  (template  OG_Template)
RETURN VARCHAR2;

Paramètres

template	Modèle de graphique.
valuenumfmt	Format numérique des étiquettes de valeur de données.


Propriété de format de valeur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous modifie
**le format numérique des étiquettes de valeur
**s'il est autre que '0999'.
*/

PROCEDURE ValFmt IS
  pie og_object;
  template og_template;
  format varchar2(20);
BEGIN
  pie := og_get_object('secteurs');
  template := og_get_template(pie);
  format := og_get_valuefmt(template);
  if format != '0999' then
    og_set_valuefmt(template, '0999');
  end if;
  og_update_chart(pie);
END;


Propriétés d'encadrement (graphique de type tableau)

Propriété de maximum auto

Propriété de minimum auto

Propriété de noms de colonne

Propriété de nombre de lignes de séparation

Propriété de ligne de séparation horizontale

Propriété de nombre maximum de lignes

Propriété de nombre minimum de lignes

Propriété de ligne de séparation verticale


Propriété de maximum auto

  Exemples	  Rubriques connexes

Description  Indique si le nombre maximum de lignes figurant sur le graphique est défini à Auto.

Syntaxe

PROCEDURE OG_Set_Automax
  (template  OG_Template,
   automax   BOOLEAN,
   maxrows   NUMBER);

FUNCTION OG_Get_Automax
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
automax	Indique si le nombre maximum de lignes figurant sur le graphique est défini à Auto.
maxrows	Indique le nombre maximum de lignes qui figurent sur le graphique (si automax est défini à FALSE).


Propriété de maximum auto - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous détermine s'il y a
**un nombre maximum de lignes à afficher
**dans le tableau, ou si le
**nombre de lignes est déterminé
**automatiquement. Si le nombre de lignes
**n'est pas déterminé automatiquement,
**la procédure lit le nombre de lignes
**affichées par le tableau, et
**le redéfinit pour qu'il soit déterminé automatiquement.
*/

PROCEDURE AutoMax IS
  table1 og_object;
  template og_template;
  val boolean;
  maxrows number := 2;
BEGIN
  table1 := og_get_object('tableau');
  template := og_get_template(table1);
  val := og_get_automax(template);
  if val = false then
     maxrows := og_get_maxrows(template);
     og_set_automax(template, true, maxrows/2);
  end if;
  og_update_chart(table1);
END;


Propriété de minimum auto

  Exemples	  Rubriques connexes

Description Indique si le nombre minimum de lignes figurant sur le graphique est défini à Auto.

Syntaxe

PROCEDURE OG_Set_Automin
  (template  OG_Template,
   automin   BOOLEAN,
   minrows   NUMBER);

FUNCTION OG_Get_Automin
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
automin	Indique si le nombre minimum de lignes figurant sur le graphique est défini à Auto.
minrows	Indique le nombre minimum de lignes qui figurent sur le graphique (si automin est défini à FALSE).


Propriété de minimum auto - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous détermine s'il y a
**un nombre minimum de lignes à afficher
**dans le tableau, ou si le
**nombre de lignes est déterminé
**automatiquement. Si le nombre de lignes
**n'est pas déterminé automatiquement,
**la procédure lit le nombre de lignes
**affichées par le tableau, et
**le redéfinit pour qu'il soit
**déterminé
**automatiquement.
*/

PROCEDURE AutoMax IS
  table1 og_object;
  template og_template;
  val boolean;
  maxrows number := 2;
BEGIN
  table1 := og_get_object('tableau');
  template := og_get_template(table1);
  val := og_get_automax(template);
  if val = false then
     maxrows := og_get_maxrows(template);
     og_set_automax(template, true, maxrows/2);
  end if;
  og_update_chart(table1);
END;


Propriété de noms de colonne

  Exemples	  Rubriques connexes

Description  Indique si le nom des colonnes constitue la première ligne du graphique.

Syntaxe

PROCEDURE OG_Set_Cname
  (template  OG_Template,
   cname     BOOLEAN);

FUNCTION OG_Get_Cname
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
cname	Indique si le nom des colonnes constitue la première ligne du graphique.


Propriété de noms de colonne - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous masque/affiche
**les noms de colonne du tableau.
*/

PROCEDURE ColNames IS
  table1 og_object;
  template og_template;
  val boolean;
BEGIN
  table1 := og_get_object('tableau');
  template := og_get_template(table1);
  val := og_get_cname(template);
  if val = true then
    og_set_cname(template, false);
  elsif val = false then
    og_set_cname(template, true);
  end if;
  og_update_chart(table1);
END;


Propriété de nombre de lignes de séparation

  Exemples	  Rubriques connexes

Description  Indique le nombre de lignes de données entre deux lignes de séparation horizontale (si Horizontal Grid est définie à TRUE).

Syntaxe

PROCEDURE OG_Set_Gridct
  (template  OG_Template,
   gridct    NUMBER);

FUNCTION OG_Get_Gridct
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.
gridct	Indique le nombre de lignes de données entre deux lignes de séparation horizontale (si Horizontal Grid est définie à TRUE).


Propriété de nombre de lignes de séparation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous double
**le nombre de lignes de séparation horizontale du tableau.
*/

PROCEDURE gridcnt IS
  table1 og_object;
  template og_template;
  cnt number;
BEGIN
  table1 := og_get_object('tableau');
  template := og_get_template(table1);
  cnt := og_get_gridct(template);
  og_set_gridct(template, cnt*2);
  og_update_chart(table1);
END;


Propriété de ligne de séparation horizontale

  Exemples	  Rubriques connexes

Description  Indique si les lignes doivent être séparées par des lignes de séparation horizontale.

Syntaxe

PROCEDURE OG_Set_Hgrid
  (template  OG_Template,
   hgrid     BOOLEAN);

FUNCTION OG_Get_Hgrid
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
hgrid	Indique si les lignes doivent être séparées par des lignes de séparation horizontale.


Propriété de ligne de séparation horizontale - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous masque/affiche
**les lignes de séparation horizontale.
*/

PROCEDURE HoriGrid IS
  table1 og_object;
  template og_template;
  val boolean;
BEGIN
  table1 := og_get_object('tableau');
  template := og_get_template(table1);
  val := og_get_hgrid(template);
  if val = true then
     og_set_hgrid(template, false);
  elsif val = false then
     og_set_hgrid(template, true);
  end if;
  og_update_chart(table1);
END;


Propriété de nombre maximum de lignes

  Exemples	  Rubriques connexes

Description  Nombre maximum de lignes figurant dans le graphique (si Auto Maximum est définie FALSE).

Syntaxe

(See OG_Set_Automax, above.)

FUNCTION OG_Get_Maxrows
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.


Propriété de nombre maximum de lignes - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous détermine s'il y a
**un nombre maximum de lignes à afficher
**dans le tableau, ou si le
**nombre de lignes est déterminé
**automatiquement. Si le nombre de lignes
**n'est pas déterminé automatiquement,
**la procédure lit le nombre de lignes
**affichées par le tableau, et
**le redéfinit pour qu'il soit déterminé automatiquement.
*/

PROCEDURE AutoMax IS
  table1 og_object;
  template og_template;
  val boolean;
  maxrows number := 2;
BEGIN
  table1 := og_get_object('tableau');
  template := og_get_template(table1);
  val := og_get_automax(template);
  if val = false then
     maxrows := og_get_maxrows(template);
     og_set_automax(template, true, maxrows/2);
  end if;
  og_update_chart(table1);
END;


Propriété de nombre minimum de lignes

  Exemples	  Rubriques connexes

Description  Nombre minimum de lignes figurant dans le graphique (si Auto Minimum est déterminée à FALSE).

Syntaxe

(See OG_Set_Automin, above.)

FUNCTION OG_Get_Minrows
  (template  OG_Template)
RETURN NUMBER;

Paramètres

template	Modèle de graphique.


Propriété de nombre minimum de lignes - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/*La procédure ci-dessous détermine s'il y a
**un nombre minimum de lignes à afficher
**dans le tableau, ou si le
**nombre de lignes est déterminé
**automatiquement. Si le nombre de lignes
**n'est pas déterminé automatiquement,
**la procédure lit le nombre de lignes
**affichées par le tableau, et
**le redéfinit pour qu'il soit
**déterminé
**automatiquement.
*/

PROCEDURE AutoMax IS
  table1 og_object;
  template og_template;
  val boolean;
  maxrows number := 2;
BEGIN
  table1 := og_get_object('tableau');
  template := og_get_template(table1);
  val := og_get_automax(template);
  if val = false then
     maxrows := og_get_maxrows(template);
     og_set_automax(template, true, maxrows/2);
  end if;
  og_update_chart(table1);
END;


Propriété de lignes de séparation verticale

  Exemples	  Rubriques connexes

Description  Indique si les colonnes doivent être séparées par des lignes de séparation verticale.

Syntaxe

PROCEDURE OG_Set_Vgrid
  (template  OG_Template,
   vgrid     BOOLEAN);

FUNCTION OG_Get_Vgrid
  (template  OG_Template)
RETURN BOOLEAN;

Paramètres

template	Modèle de graphique.
vgrid	Indique si les colonnes doivent être séparées par des lignes de séparation verticale.


Propriété de ligne de séparation verticale - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* La procédure ci-dessous masque/affiche
**les lignes de séparation verticale.
*/

PROCEDURE VertGrid IS

  table1 og_object;

  template og_template;

  val boolean;

BEGIN

  table1 := og_get_object('tableau');

  template := og_get_template(table1);

  val := og_get_vgrid(template);

  if val = true then

     og_set_vgrid(template, false);

  elsif val = false then

     og_set_vgrid(template, true);

  end if;

  og_update_chart(table1);

END.


Propriétés de modèle de champ (générique)

Propriété de rotation de couleur

Propriété de format de date

Propriété de nom

Propriété de format numérique

Propriété de racine


Propriété de rotation de couleur

  Exemples	  Rubriques connexes

Description  Indique si Graphics Builder effectue automatiquement une rotation de la palette de couleurs ou de motifs pour sélectionner une teinte particulière pour chaque champ qui utilise ce modèle de champ. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_None_Colorrot

OG_Auto_Colorrot

OG_Color_Colorrot

OG_Pattern_Colorrot

OG_Both_Colorrot

Syntaxe

PROCEDURE OG_Set_Colorrot
  (ftemp     OG_Ftemp,
   colorrot  NUMBER);

FUNCTION OG_Get_Colorrot
  (ftemp  OG_Ftemp)
RETURN NUMBER;

Paramètres

ftemp	Modèle de champ décrit.
colorrot	Indique si Graphics Builder effectue automatiquement une rotation de la palette de couleurs ou de motifs pour sélectionner une teinte particulière pour chaque champ qui utilise ce modèle de champ.


Propriété de rotation de couleur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit si une
**rotation de couleur est appliquée au graphique.
**Si aucune rotation n'a été appliquée, la procédure
**applique la rotation de couleur AUTO. Si une autre
**méthode de rotation de couleur est appliquée, elle
**définit la rotation à NONE.
*/

PROCEDURE fieldColRot IS
  ftemp og_ftemp;
  color number;
BEGIN
  ftemp := og_get_ftemp(og_get_template(og_get_object('graphique')),0);
  color := og_get_colorrot(ftemp);
  if color = og_none_colorrot then
     og_set_colorrot(ftemp, og_auto_colorrot);
  else
     og_set_colorrot(ftemp, og_none_colorrot);
 end if;
     og_update_chart(og_get_object('graphique'));
END;


Propriété de format de date

  Exemples	  Rubriques connexes

Description  Format de date des étiquettes de champ. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

PROCEDURE OG_Set_Datefmt
  (ftemp     OG_Ftemp,
   date_fmt  VARCHAR2);

FUNCTION OG_Get_Datefmt
  (ftemp  OG_Ftemp)
RETURN VARCHAR2;

Paramètres

ftemp	Modèle de champ décrit.
date_fmt	Format de date des étiquettes de champ. Vous devez entrer une chaîne de format SQL valide.


Propriété de format de date - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  */La procédure ci-dessous
**détermine si tous les formats numériques
**d'étiquette sont '9,9,9,9'.
**Dans le cas contraire, elle les fait
**tous passer à '9,9,9,9'.
*/

PROCEDURE fieldDateFmt IS
  ftemp og_ftemp;
  datefmt varchar2(20);
BEGIN
  ftemp := og_get_ftemp(og_get_template(og_get_object('graphique')),0);
  datefmt := og_get_datefmt(ftemp);
  if datefmt != 'JJ-MM-AAAA' then
    og_set_datefmt(ftemp, 'JJ-MM-AAAA');
  end if;
END;


Propriété de nom

  Exemples	  Rubriques connexes

Description  Nom du modèle de champ.

Syntaxe

PROCEDURE OG_Set_Ftemp_Name
  (ftemp  OG_Ftemp,
   name   VARCHAR2);

FUNCTION OG_Get_Ftemp_Name
  (ftemp  OG_Ftemp)
RETURN VARCHAR2;

Paramètres

ftemp	Modèle de champ décrit.
name	Nom du modèle de champ.


Propriété de nom - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure bouton ci-dessous
**ajoute un '1' au nom du
**modèle de champ en cours.
*/

PROCEDURE fieldname IS
  ftemp og_ftemp;
  chart og_object;
  name varchar2(20);
BEGIN
  ftemp := og_get_ftemp(og_get_template(og_get_object('graphique')),0);
  name := og_get_ftemp_name(ftemp);
  og_set_ftemp_name(ftemp, name||'1');
END;


Propriété de format numérique

  Exemples	  Rubriques connexes

Description  Format numérique des étiquettes de champ. Vous devez entrer une chaîne de format SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Reference.

Syntaxe

PROCEDURE OG_Set_Numfmt
  (ftemp    OG_Ftemp,
   num_fmt  VARCHAR2);

FUNCTION OG_Get_Numfmt
  (ftemp  OG_Ftemp)
RETURN VARCHAR2;

Paramètres

ftemp	Modèle de champ décrit.
num_fmt	Format numérique des étiquettes de champ. Vous devez entrer une chaîne de format SQL valide.


Propriété de format numérique - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

*/La procédure ci-dessous
**détermine si le format numérique des
**étiquettes est '9,9,9,9'. Dans la
**négative, elle change le format
**en '9,9,9,9'.
*/

PROCEDURE fieldNumFmt IS
  ftemp og_ftemp;
  numfmt varchar2(20);
BEGIN
  ftemp := og_get_ftemp(og_get_template(og_get_object('graphique')),0);
  numfmt := og_get_numfmt(ftemp);
  if numfmt != '9,9,9,9' then
    og_set_numfmt(ftemp, '9,9,9,9');
  end if;
END;


Propriété de racine

  Exemples	  Rubriques connexes

Description  Identificateur du modèle de graphique auquel appartient le modèle de champ.

Syntaxe

FUNCTION OG_Get_Root
  (ftemp  OG_Ftemp)
RETURN OG_Object;

Paramètres

ftemp	Modèle de champ décrit.


Propriété de racine - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous extrait
**l'identificateur de modèle de champ d'un graphique.
*/

PROCEDURE fieldname IS
  ftemp og_ftemp;
  root og_object;
BEGIN
  ftemp := og_get_ftemp(og_get_template(og_get_object('graphique')),0);
  root := og_get_root(ftemp);
END;


Propriétés de modèle de champ (graphique à axes)

Propriété d'axe

Propriété d'ajustement de courbe

Propriété de rotation d'étiquette

Propriété de style de ligne

Propriété de chevauchement

Propriété de position de tracé

Propriété de type de tracé


Propriété d'axe

  Exemples	  Rubriques connexes

Description  Axe auquel les valeurs de données sont comparées pour déterminer la manière dont le champ est tracé. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Y1_Axis

OG_Y2_Axis

Syntaxe

PROCEDURE OG_Set_Axis
  (ftemp  OG_Ftemp,
   axis   NUMBER);

FUNCTION OG_Get_Axis
  (ftemp  OG_Ftemp)
RETURN NUMBER;

Paramètres

ftemp	Modèle de graphique décrit.
axis	Axe auquel les valeurs de données sont comparées pour déterminer la manière dont le champ est tracé.


Propriété d'axe - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous
**fait pivoter l'axe principal des Y
**dans le graphique référencé
**(s'il y a plusieurs axes des Y)
**et fait permuter l'axe principal des Y
**sur un autre axe des Y.
*/

PROCEDURE axis IS
  axis number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('graphique');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  axis := og_get_axis(ftemp);
  if axis = og_y1_axis then
     og_set_axis(ftemp, og_y2_axis);
  elsif axis = og_y2_axis then
     og_set_axis(ftemp, og_y1_axis);
  end if;
  og_update_chart(chart);
END;


Propriété d'ajustement de courbe

  Exemples	  Rubriques connexes

Description  Indique si un ajustement de courbe est appliqué au graphique et, dans l'affirmative, l'algorithme utilisé. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_No_Curvefit

OG_Linear_Curvefit

OG_LOG_Curvefit

OG_Exp_Curvefit

OG_Power_Curvefit

Syntaxe

PROCEDURE OG_Set_Curvefit
  (ftemp     OG_Ftemp,
   curvefit  NUMBER);

FUNCTION OG_Get_Curvefit
  (ftemp  OG_Ftemp)
RETURN NUMBER;

Paramètres

ftemp	Modèle de graphique décrit.
curvefit	Indique si un ajustement de courbe est appliqué au graphique et, dans l'affirmative, l'algorithme utilisé.


Propriété d'ajustement de courbe - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous détermine
**si un ajustement de courbe est appliqué au graphique.
**Dans la négative, la procédure applique
**un ajustement linéaire. Si un ajustement de courbe
**est appliqué au graphique, la procédure le supprime.
*/

PROCEDURE CurveFit IS
  curve number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('graphique');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  curve := og_get_curvefit(ftemp);
  if curve = og_no_curvefit then
    og_set_curvefit(ftemp,og_linear_curvefit);
  else
    og_set_curvefit(ftemp,og_no_curvefit);
  end if;
  og_update_chart(chart);
END;


Propriété de rotation d'étiquette

  Exemples	  Rubriques connexes

Description  Angle des rotation des étiquettes d'un champ de type de tracé d'étiquette. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Ccw_Rotation   Rotation dans le sens contraire des aiguilles d'une montre.

OG_Cw_Rotation   Rotation dans le sens des aiguilles d'une montre.

OG_No_Rotation

Syntaxe

PROCEDURE OG_Set_Labelrot
  (ftemp    OG_Ftemp,
   linesty  NUMBER);

FUNCTION OG_Get_Labelrot
  (ftemp  OG_Ftemp)
RETURN NUMBER;

Paramètres

ftemp	Modèle de graphique décrit.
linesty	Angle des rotation des étiquettes d'un champ de type de tracé d'étiquette.


Propriété de rotation d'étiquette - Exemples

  Liste alphabétique          [image]  Tous les exemples    [image]  Rubriques connexes

  /* La procédure ci-dessous fait pivoter
**les étiquettes d'un champ de graphique.
*/

PROCEDURE lblrot IS
  rot number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('graphique');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  rot := og_get_labelrot(ftemp);
  if rot = og_no_rotation then
    og_set_labelrot(ftemp,og_cw_rotation);
  elsif rot = og_cw_rotation then
    og_set_labelrot(ftemp, og_ccw_rotation);
  elsif rot = og_ccw_rotation then
    og_set_labelrot(ftemp, og_no_rotation);
  end if;
  og_update_chart(chart);
END;


Propriété de style de ligne

  Exemples	  Rubriques connexes

Description  Style de ligne utilisé pour relier les points de données d'un champ à un type de tracé de ligne. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Spline_Linestyle

OG_Step_Linestyle

OG_Straight_Linestyle

Syntaxe

PROCEDURE OG_Set_Linesty
  (ftemp    OG_Ftemp,
   linesty  NUMBER);

FUNCTION OG_Get_Linesty
  (ftemp  OG_Ftemp)
RETURN NUMBER;

Paramètres

ftemp	Modèle de graphique décrit.
linesty	Style de ligne utilisé pour relier les points de données d'un champ à un type de tracé de ligne.


Propriété de style de ligne - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous fait pivoter
**le style de ligne d'un graphique.
*/

PROCEDURE linesty IS
  style number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('graphique');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  style := og_get_linesty(ftemp);
  if style = og_spline_linestyle then
     og_set_linesty(ftemp, og_step_linestyle);
  elsif style = og_step_linestyle then
     og_set_linesty(ftemp, og_straight_linestyle);
  elsif style = og_straight_linestyle then
     og_set_linesty(ftemp, og_spline_linestyle);
  end if;
  og_update_chart(chart);
END;


Propriété de chevauchement

  Exemples	  Rubriques connexes

Description  Pourcentage de chevauchement des barres représentant des valeurs de données de plusieurs champs d'un graphique à barres ou à colonnes.

Syntaxe

PROCEDURE OG_Set_Overlap
  (ftemp    OG_Ftemp,
   overlap  NUMBER);

FUNCTION OG_Get_Overlap
  (ftemp  OG_Ftemp)
RETURN NUMBER;

Paramètres

ftemp	Modèle de graphique décrit.
overlap	Pourcentage de chevauchement des barres représentant des valeurs de données de plusieurs champs d'un graphique à barres ou à colonnes.


Propriété de chevauchement - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit
**le pourcentage de chevauchement
** qui a été indiqué. S'il est compris
**entre 0 et 50, la procédure
**redessine la colonne en utilisant
**un chevauchement de 90 % ; si le pourcentage est
**supérieur à 90 %, la procédure redessine
**les colonnes avec un chevauchement de 0 %
*/

PROCEDURE overlap IS
  percent number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('graphique');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  percent := og_get_overlap(ftemp);
  if percent between 0 and 50 then
     og_set_overlap(ftemp, 90);
  else
     og_set_overlap(ftemp, 0);
  end if;
END;


Propriété de position de tracé

  Exemples	  Rubriques connexes

Description  Indique, pour chaque catégorie, la relation entre les valeurs de données de plusieurs champs. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Normal_Plotpos

OG_Fromprev_Plotpos

OG_Stacked_Plotpos

Syntaxe

PROCEDURE OG_Set_Plotpos
  (ftemp    OG_Ftemp,
   plotpos  NUMBER);

FUNCTION OG_Get_Plotpos
  (ftemp  OG_Ftemp)
RETURN NUMBER;

Paramètres

ftemp	Modèle de graphique décrit.
plotpos	Indique, pour chaque catégorie, la relation entre les valeurs de données de plusieurs champs.


Propriété de position de tracé - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure bouton ci-dessous fait pivoter
**la position de traçage des colonnes d'un graphique.
*/

PROCEDURE plotpos IS
  pos number;
  ftemp og_ftemp;
  chart og_object;
BEGIN
  chart := og_get_object('graphique');
  ftemp := og_get_ftemp(og_get_template(chart),0);
  pos := og_get_plotpos(ftemp);
   if pos = og_normal_plotpos then
     og_set_plotpos(ftemp,og_fromprev_plotpos);
   elsif pos = og_fromprev_plotpos then
     og_set_plotpos(ftemp, og_stacked_plotpos);
   elsif pos = og_stacked_plotpos then
     og_set_plotpos(ftemp, og_normal_plotpos);
   end if;
  og_update_chart(chart);
END;


Propriété de type de tracé

  Exemples	  Rubriques connexes

Description  Eléments utilisés pour tracer ce champ sur le graphique. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_None_Plottype

OG_Bar_Plottype

OG_Line_Plottype

OG_Symbol_Plottype

OG_Fill_Plottype

OG_Spike_Plottype

OG_Label_Plottype

Syntaxe

PROCEDURE OG_Set_Plottype
  (ftemp     OG_Ftemp,
   plottype  NUMBER);

FUNCTION OG_Get_Plottype
  (ftemp  OG_Ftemp)
RETURN NUMBER;

Paramètres

ftemp	Modèle de graphique décrit.
plottype	Eléments utilisés pour tracer ce champ sur le graphique.


Propriété de type de tracé - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*Lorsque l'opérateur clique sur le bouton de la souris,
**la procédure ci-dessous fait pivoter le type de tracé d'un
**graphique.
*/

PROCEDURE Plottype (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
chart og_object;
template og_template;
ftemp og_ftemp;
num number;
BEGIN
chart := og_get_object('graphique');
template := og_get_template(chart);
ftemp := og_get_ftemp(template, 0);
num := og_get_plottype(ftemp);
if num = og_none_plottype then
   og_set_plottype(ftemp, og_bar_plottype);
elsif num = og_bar_plottype then
   og_set_plottype(ftemp, og_line_plottype);
elsif num = og_line_plottype then
   og_set_plottype(ftemp, og_symbol_plottype);
elsif num = og_symbol_plottype then
   og_set_plottype(ftemp, og_fill_plottype);
elsif num = og_fill_plottype then
   og_set_plottype(ftemp, og_spike_plottype);
elsif num = og_spike_plottype then
   og_set_plottype(ftemp, og_label_plottype);
elsif num = og_label_plottype then
   og_set_plottype(ftemp, og_none_plottype);
end if;
og_update_chart(chart);
END;


Propriétés génériques

Propriété de procédure bouton

Propriété de colonne

Propriété d'événement

Propriété d'exécution d'interrogation

Propriété de déclencheur de format

Propriété de masquage d'objet

Propriété de boîte englobante intérieure

Propriété de nom

Propriété de type d'objet

Propriété de boîte englobante extérieure

Propriété de père

Propriété de définition de paramètre


Propriété de procédure bouton

  Exemples	  Rubriques connexes

Description  Identificateur de la procédure bouton à associer à cet objet. Notez que l'attribut Events doit également être défini correctement pour que cette procédure reçoive les événements de souris voulus.

Syntaxe

PROCEDURE OG_Set_Button
  (object          OG_Object,
   buttonproc      OG_Buttonproc,
   damage          BOOLEAN        :=  TRUE,
   update_bbox     BOOLEAN        :=  TRUE);

FUNCTION OG_Get_Button
  (object  OG_Object)
RETURN OG_Buttonproc;

Paramètres

object	Objet décrit.
buttonproc	Identificateur de la procédure bouton à associer à cet objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de procédure bouton - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la procédure
**bouton d'un objet rectangle et ajoute
**cette procédure à un objet cercle.
*/

PROCEDURE transfer (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  rect og_object;
  circle og_object;
  proc og_buttonproc;
BEGIN
  rect := og_get_object('rect');
  circle := og_get_object('cercle');
  proc := og_get_button(rect);
  og_set_button(circle, proc);
END;


Propriété de colonne

  Exemples	  Rubriques connexes

Description  Valeur de colonne pour laquelle le paramètre est défini lorsque l'utilisateur sélectionne l'objet. Cette propriété ne s'applique qu'aux éléments de graphique.

Syntaxe

PROCEDURE OG_Set_Keycol
  (object  OG_Object,
   keycol  VARCHAR2);

FUNCTION OG_Get_Keycol
  (object  OG_Object)
RETURN VARCHAR2;

Paramètres

object	Objet décrit.
keycol	Valeur de colonne pour laquelle le paramètre est défini lorsque l'utilisateur sélectionne l'objet.


Propriété de colonne - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**la valeur de colonne d'un paramètre
**et lui attribue une valeur différente.
*/

PROCEDURE GenColumn IS
  rect og_object;
  param varchar2(20);
BEGIN
  rect := og_get_object('rect');
  param := og_get_keycol(rect);
  og_set_keycol(rect, 'init');
END;


Propriété d'événement

  Exemples	  Rubriques connexes

Description  Type d'événement de souris que la procédure indiquée par la propriété Bouton doit recevoir. La valeur de cette propriété peut être l'une des constantes intégrées indiquées ci-dessous. Pour autoriser la procédure à recevoir plusieurs types d'événement, définissez cette propriété à la somme des constantes des événements voulus. Notez que les constantes OG_Mouse_Move_Up et OG_Mouse_Move_Down ne sont utilisées que pour les couches d'affichage traversantes.

OG_No_Events

OG_Mouse_Down

OG_Mouse_Up

OG_Mouse_Move_Down

Syntaxe

PROCEDURE OG_Set_Events
  (object       OG_Object,
   events       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Events
  (object  OG_Object)
RETURN NUMBER;

Paramètres

object	Objet décrit.
events	Type d'événement de souris que la procédure indiquée par la propriété Bouton doit recevoir.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété d'événement - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**l'événement de souris en cours dans un objet
**et lui attribue un événement différent.
*/

PROCEDURE Events IS
  rect og_object;
  events number;
BEGIN
  rect := og_get_object('rect');
  events := og_get_events(rect);
  if events = og_no_events then
     og_set_events(rect, og_mouse_down);
  elsif events = og_mouse_down then
     og_set_events(rect, og_mouse_up);
  elsif events = og_mouse_up then
     og_set_events(rect, og_mouse_move_down);
  elsif events = og_mouse_move_down then
     og_set_events(rect, og_no_events);
  end if;
END;


Propriété d'exécution d'interrogation

  Exemples	  Rubriques connexes

Description  Interrogation à exécuter lorsque l'utilisateur sélectionne l'objet.

Syntaxe

PROCEDURE OG_Set_Execquery
  (object     OG_Object,
   execquery  OG_Query);

FUNCTION OG_Get_Execquery
  (object  OG_Object)
RETURN OG_Query;

Paramètres

object	Objet décrit.
execquery	Interrogation à exécuter lorsque l'utilisateur sélectionne l'objet.


Propriété d'exécution d'interrogation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit l'interrogation
**de l'objet indiquée et attribue à l'objet une
**interrogation différente.
*/

PROCEDURE GenQuery IS
  rect og_object;
  query og_query;
  query1 og_query;
BEGIN
  rect := og_get_object('rect');
  query := og_get_execquery(rect);
  query1 := og_get_query('query1');
  og_set_execquery(rect, query1);
END;


Propriété de déclencheur de format

  Exemples	  Rubriques connexes

Description  Déclencheur de format de l'objet. Cette propriété ne s'applique qu'aux éléments de graphique.

Syntaxe

PROCEDURE OG_Set_Fmttrig
  (object   OG_Object,
   fmttrig  VARCHAR2);

FUNCTION OG_Get_Fmttrig
  (object  OG_Object)
RETURN VARCHAR2;

Paramètres

object	Objet décrit.
fmttrig	Déclencheur de format de l'objet. Cette propriété ne s'applique qu'aux éléments de graphique.


Propriété de déclencheur de format - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le déclencheur
**de format indiqué dans un objet et lui attribue
**un déclencheur de format différent.
*/

*/PROCEDURE GenFmtTrigger IS
  rect og_object;
  fmttrig varchar2(20);
BEGIN
  rect := og_get_object('rect');
  fmttrig := og_get_fmttrig(rect);
  og_set_fmttrig(rect, 'fmttrig1');
END;


Propriété de masquage d'objet

  Exemples	  Rubriques connexes

Description  Masque l'objet.

Syntaxe

PROCEDURE OG_Set_Hide
  (object  OG_Object)
   hide BOOLEAN);

FUNCTION OG_Get_Hide
  (object  OG_Object)
RETURN BOOLEAN;

Paramètres

object	Objet décrit.
Hide	Masque l'objet.


Propriété de masquage d'objet - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton
**suivante masque ou affiche
**un objet lorsqu'on le
**sélectionne.
*/

PROCEDURE OGBUTTONPROC0 (buttonobj IN og_object,

                         hitobj IN og_object,

                         win IN og_window,

                         eventinfo IN og_event) IS

val boolean;

BEGIN

val := og_get_hide(hitobj);

if val then

   og_set_hide(hitobj, false);

 og_set_bfcolor(hitobj, 'rouge');

else

   og_set_hide(hitobj, true);

 og_set_bfcolor(hitobj, 'rouge');

end if;

END;


Propriété de boîte englobante intérieure

  Exemples	  Rubriques connexes

Description  Boîte englobante intérieure de l'objet, c'est-à-dire le rectangle qui constitue la forme idéale de l'objet (reliant les quatre points de contrôle de l'objet), quelles que soient l'épaisseur des bords ou les autres définitions de propriété.

Syntaxe

FUNCTION OG_Get_Ibbox
  (object  OG_Object)
RETURN OG_Rectangle;

Paramètres

object	Objet décrit.


Propriété de boîte englobante intérieure - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit les dimensions
**des boîtes englobantes intérieure et
**extérieure, et calcule
**la taille de la boîte englobante réelle.
*/

PROCEDURE GenIOBox IS
  obj og_object;
  ibox og_rectangle;
  obox og_rectangle;
  num number;
BEGIN
  obj := og_get_object('rect');
  ibox := og_get_ibbox(obj);
  obox := og_get_obbox(obj);
  num := (obox.height * obox.width)-(ibox.height*ibox.width);
END;


Propriété de nom

  Exemples	  Rubriques connexes

Description  Nom de l'objet.

Syntaxe

PROCEDURE OG_Set_Name
  (object       OG_Object,
   name         VARCHAR2
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Name
  (object  OG_Object)
RETURN VARCHAR2;

Paramètres

object	Objet décrit.
name	Nom de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de nom - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**le nom de l'objet et lui
**attribue un autre nom.
*/

PROCEDURE GenName IS
  obj og_object;
  name varchar2(20);
BEGIN
  obj := og_get_object('cercle');
  name := og_get_name(obj);
  og_set_name(obj, 'thérèse');
END;


Propriété de type d'objet

  Exemples	  Rubriques connexes

Description  Type de l'objet. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Arc_Objtype

OG_Chart_Objtype

OG_Group_Objtype

OG_Image_Objtype

OG_Line_Objtype

OG_Poly_Objtype

OG_Rect_Objtype

OG_Rrect_Objtype

OG_Symbol_Objtype

OG_Text_Objtype

Syntaxe

FUNCTION OG_Get_Objtype
  (object  OG_Object)
RETURN NUMBER;

Paramètres

object	Objet décrit.


Propriété de type d'objet - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous vérifie
**le type de l'objet que l'utilisateur
**sélectionne et imprime le nom du type
**dans un objet texte.
*/

PROCEDURE GenObjType2 (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  text og_object;
  objtype number;

BEGIN
  text := og_get_object('objet texte');
  objtype := og_get_objtype(hitobj);
  if objtype = og_arc_objtype then
     og_set_str(text, 'arc');
  elsif objtype = og_chart_objtype then
     og_set_str(text, 'graphique');
  elsif objtype = og_group_objtype then
     og_set_str(text, 'groupe');
  elsif objtype = og_image_objtype then
     og_set_str(text, 'image');
  elsif objtype = og_line_objtype then
     og_set_str(text, 'ligne');
  elsif objtype = og_poly_objtype then
     og_set_str(text, 'poly');
  elsif objtype = og_rect_objtype then
     og_set_str(text, 'rect');
  elsif objtype = og_rrect_objtype then
     og_set_str(text, 'rectarr');
  elsif objtype = og_symbol_objtype then
     og_set_str(text, 'symbole');
  elsif objtype = og_text_objtype then
     og_set_str(text, 'texte');
  end if;

END;


Propriété de boîte englobante extérieure

  Exemples	  Rubriques connexes

Description  Boîte englobante extérieure de l'objet, c'est-à-dire le plus petit rectangle qui entoure complètement l'objet. Cette boîte peut être différente de la boîte englobante intérieure si l'objet a un bord épais. Alors que la boîte englobante intérieure ne trace que la forme idéale de l'objet, la boîte englobante extérieure entoure tout l'objet.

Syntaxe

FUNCTION OG_Get_Obbox
  (object  OG_Object)
RETURN OG_Rectangle;

Paramètres

object	Objet décrit.


Propriété de boîte englobante extérieure - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit les dimensions
**des boîtes englobantes intérieure et extérieure, et
**calcule la taille de la boîte englobante réelle.
*/

PROCEDURE GenIOBox IS
  obj og_object;
  ibox og_rectangle;
  obox og_rectangle;
  num number;
BEGIN
  obj := og_get_object('rect');
  ibox := og_get_ibbox(obj);
  obox := og_get_obbox(obj);
  num := (obox.height * obox.width)-(ibox.height*ibox.width);
END;


Propriété de père

  Exemples	  Rubriques connexes

Description  Identificateur de l'objet père de l'objet.

Syntaxe

FUNCTION OG_Get_Parent
  (object  OG_Object)
RETURN OG_Object;

Paramètres

object	Objet décrit.


Propriété de père - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le
**père de l'objet en cours et
**imprime le nom de l'objet père
**d'un objet texte.
*/

PROCEDURE GenParent IS
  text og_object;
  obj og_object;
  parent og_object;
  name varchar2(20);
BEGIN
text := og_get_object('objet texte');
  obj := og_get_object('cercle');
  parent := og_get_parent(obj);
  name := og_get_name(parent);
  og_set_str(text, name);
END;


Propriété de définition de paramètre

  Exemples	  Rubriques connexes

Description  Paramètre dont la valeur est définie lorsque l'utilisateur sélectionne l'objet.

Syntaxe

PROCEDURE OG_Set_Setparam
  (object   OG_Object,
  setparam  VARCHAR2);

FUNCTION OG_Get_Setparam
  (object  OG_Object)
RETURN VARCHAR2;

Paramètres

object	Objet décrit.
setparam	Paramètre dont la valeur est définie lorsque l'utilisateur sélectionne l'objet.


Propriété de définition de paramètre - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le
**paramètre d'un objet rectangle et
**lui attribue un nouveau paramètre.
*/

PROCEDURE SetParam IS
  rect og_object;
  param varchar2(20);
BEGIN
  rect := og_get_object('rect');
  param := og_get_setparam(rect);
  og_set_setparam(rect, 'PARAM1');
END;


Propriétés de graphique

Propriété de couleur d'arrière-plan du bord

Propriété de couleur de remplissage d'arrière-plan

Propriété de style de relief

Propriété de style d'extrémité

Propriété de style de pointillé

Propriété de motif de bord

Propriété de largeur de bord

Propriété de motif de remplissage

Propriété de couleur de premier plan du bord

Propriété de couleur de remplissage de premier plan

Propriété de style de jointure

Propriété d'angle de rotation

Propriété de mode de transfert


Propriété de couleur d'arrière-plan du bord

  Exemples	  Rubriques connexes

Description  Couleur d'arrière-plan du bord de l'objet.

Syntaxe

PROCEDURE OG_Set_Becolor
  (object       OG_Object,
   becolor      VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Becolor
  (object  OG_Object)
RETURN VARCHAR2;

Paramètres

object	Objet décrit.
becolor	Couleur d'arrière-plan du bord de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de couleur d'arrière-plan du bord - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* /*La procédure ci-dessous permute les couleurs
**de premier plan et d'arrière-plan du bord.
*/

PROCEDURE FBEdgeColor IS
  obj og_object;
  fcolor varchar2(20);
  bcolor varchar2(20);
BEGIN
  obj := og_get_object('rect');
  fcolor := og_get_fecolor(obj);
  bcolor := og_get_becolor(obj);
  og_set_fecolor(obj, bcolor);
  og_set_becolor(obj, fcolor);
END;


Propriété de couleur de remplissage d'arrière-plan

  Exemples	  Rubriques connexes

Description  Couleur de remplissage de l'arrière-plan de l'objet.

Syntaxe

PROCEDURE OG_Set_Bfcolor
  (object       OG_Object,
   bfcolor      VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Bfcolor
  (object  OG_Object)
RETURN VARCHAR2;

Paramètres

object	Objet décrit.
bfcolor	Couleur de remplissage de l'arrière-plan de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de couleur de remplissage d'arrière-plan - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/*La procédure ci-dessous permute les couleurs de
**remplissage de premier plan et d'arrière-plan.
*/

PROCEDURE FBFillColor IS
  obj og_object;
  fcolor varchar2(20);
  bcolor varchar2(20);
BEGIN
  obj := og_get_object('rect');
  fcolor := og_get_ffcolor(obj);
  bcolor := og_get_bfcolor(obj);
  og_set_ffcolor(obj, bcolor);
  og_set_bfcolor(obj, fcolor);
END;


Propriété de style de relief

  Exemples	  Rubriques connexes

Description  Style de relief de l'objet. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Inset_Bstyle

OG_Lowered_Bstyle

OG_Outset_Bstyle

OG_Plain_Bstyle

OG_Raised_Bstyle

Syntaxe

PROCEDURE OG_Set_Bevelstyle
  (object       OG_Object,
   bevelstyle   NUMBER,
   damage       BOOLEAN    := TRUE,
   update_bbox  BOOLEAN    := TRUE);

FUNCTION OG_Get_Bevelstyle
  (object  OG_Object)
RETURN NUMBER;

Paramètres

object	Objet décrit.
bevelstyle	Style de relief de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de style de relief - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous fait pivoter
**le style de relief d'un objet.
*/

PROCEDURE bevel (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  obj og_object;
  num number;
BEGIN
  obj := og_get_object('rect');
  num := og_get_bevelstyle(obj);
  if num = og_inset_bstyle then
     og_set_bevelstyle(obj, og_lowered_bstyle);
  elsif num = og_lowered_bstyle then
     og_set_bevelstyle(obj, og_outset_bstyle);
  elsif num = og_outset_bstyle then
     og_set_bevelstyle(obj, og_plain_bstyle);
  elsif num = og_plain_bstyle then
     og_set_bevelstyle(obj, og_raised_bstyle);
  elsif num = og_raised_bstyle then
     og_set_bevelstyle(obj, og_inset_bstyle);
  end if;
END;


Propriété de style d'extrémité

  Exemples	  Rubriques connexes

Description  Style d'extrémité du bord de l'objet. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Butt_Cstyle

OG_Projecting_Cstyle

OG_Round_Cstyle

Syntaxe

PROCEDURE OG_Set_Capstyle
  (object        OG_Object,
   capstyle      NUMBER,
   damage        BOOLEAN    :=  TRUE,
   update_bbox   BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Capstyle
  (object  OG_Object)
RETURN NUMBER;

Paramètres

object	Objet décrit.
capstyle	Style d'extrémité du bord de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de style d'extrémité - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous fait pivoter
**le style d'extrémité du bord de l'objet sélectionné
*/

PROCEDURE CapStyle (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  num number;
BEGIN
  num := og_get_capstyle(hitobj);
  if num = og_butt_cstyle then
     og_set_capstyle(hitobj, og_projecting_cstyle);
  elsif num = og_projecting_cstyle then
     og_set_capstyle(hitobj,og_round_cstyle);
  elsif num = og_round_cstyle then
     og_set_capstyle(hitobj,og_butt_cstyle);
  end if;
END;


Propriété de style de pointillé

  Exemples	  Rubriques connexes

Description  Style de pointillé du bord de l'objet. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Solid_Dstyle

OG_Dot_Dstyle

OG_Long_Dstyle

OG_Dashdot_Dstyle

OG_Dotdot_Dstyle

OG_Short_Dstyle

OG_Dashdotdot_Dstyle

Syntaxe

PROCEDURE OG_Set_Dashstyle
  (object         OG_Object,
   dashstyle      NUMBER,
   damage         BOOLEAN    :=  TRUE,
   update_bbox    BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Dashstyle
  (object  OG_Object)
RETURN NUMBER;

Paramètres

object	Objet décrit.
dashstyle	Style de pointillé du bord de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de style de pointillé - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

*/La procédure bouton ci-dessous fait pivoter
**le style de pointillé de l'objet.
*/

PROCEDURE DashStyle (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
    num number;
BEGIN
  num := og_get_dashstyle(hitobj);
  if num = og_solid_dstyle then
     og_set_dashstyle(hitobj, og_dot_dstyle);
  elsif num = og_dot_dstyle then
     og_set_dashstyle(hitobj,og_long_dstyle);
  elsif num = og_long_dstyle then
     og_set_dashstyle(hitobj,og_dashdot_dstyle);
  elsif num = og_dashdot_dstyle then
     og_set_dashstyle(hitobj,og_dotdot_dstyle);
  elsif num = og_dotdot_dstyle then
     og_set_dashstyle(hitobj,og_short_dstyle);
  elsif num = og_short_dstyle then
     og_set_dashstyle(hitobj,og_dashdotdot_dstyle);
  elsif num = og_dashdotdot_dstyle then
     og_set_dashstyle(hitobj,og_solid_dstyle);
  end if;
END;


Propriété de motif de bord

  Exemples	  Rubriques connexes

Description  Motif du bord de l'objet.

Syntaxe

PROCEDURE OG_Set_Edgepatt
  (object        OG_Object,
   edgepatt      VARCHAR2,
   damage        BOOLEAN    :=  TRUE,
   update_bbox   BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Edgepatt
  (object  OG_Object)
RETURN VARCHAR2;

Paramètres

object	Objet décrit.
edgepatt	Motif du bord de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de motif de bord - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous permute le motif de bord
**et le motif de remplissage d'un objet.
*/

PROCEDURE EdgePattern IS
  obj og_object;
  edgepatt varchar2(20);
  fillpatt varchar2(20);
BEGIN
  obj := og_get_object('rect');
  edgepatt := og_get_edgepatt(obj);
  fillpatt := og_get_fillpatt(obj);
  og_set_edgepatt(obj, fillpatt);
  og_set_fillpatt(obj, edgepatt);
END;


Propriété de largeur de bord

  Exemples	  Rubriques connexes

Description  Largeur du bord de l'objet (en unités de présentation).

Syntaxe

PROCEDURE OG_Set_Ewidth
  (object       OG_Object,
   ewidth       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Ewidth
  (object  OG_Object)
RETURN NUMBER;

Paramètres

object	Objet décrit.
ewidth	Largeur du bord de l'objet (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de largeur de bord - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la largeur
**du bord d'un objet sélectionné. Si la largeur est
**égale à 0, la procédure redonne à la largeur la valeur 800.
*/

PROCEDURE EdgeWidth IS
  obj og_object;
  width number;
BEGIN
  obj := og_get_object('rect');
  width := og_get_ewidth(obj);
  if width = 0 then
    og_set_ewidth(obj, 800);
  end if;
END;


Propriété de motif de remplissage

  Exemples	  Rubriques connexes

Description  Motif de remplissage de l'objet.

Syntaxe

PROCEDURE OG_Set_Fillpatt
  (object        OG_Object,
   fillpatt      VARCHAR2,
   damage        BOOLEAN    :=  TRUE,
   update_bbox   BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Fillpatt
  (object  OG_Object)
RETURN VARCHAR2;

Paramètres

object	Objet décrit.
fillpatt	Motif de remplissage de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de motif de remplissage - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* - Exemples

 /*La procédure ci-dessous permute les motifs de
**remplissage et de bord d'un objet.
*/

PROCEDURE EdgePattern IS
  obj og_object;
  edgepatt varchar2(20);
  fillpatt varchar2(20);
BEGIN
  obj := og_get_object('rect');
  edgepatt := og_get_edgepatt(obj);
  fillpatt := og_get_fillpatt(obj);
  og_set_edgepatt(obj, fillpatt);
  og_set_fillpatt(obj, edgepatt);
END;


Propriété de couleur de premier plan du bord

  Exemples	  Rubriques connexes

Description  Couleur de premier plan du bord de l'objet.

Syntaxe

PROCEDURE OG_Set_Fecolor
  (object       OG_Object,
   fecolor      VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Fecolor
  (object  OG_Object)
RETURN VARCHAR2;

Paramètres

object	Objet décrit.
fecolor	Couleur de premier plan du bord de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de couleur de premier plan du bord - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous permute les couleurs
**du premier plan et de l'arrière plan du bord de l'objet.
*/

PROCEDURE FBEdgeColor IS
  obj og_object;
  fcolor varchar2(20);
  bcolor varchar2(20);
BEGIN
  obj := og_get_object('rect');
  fcolor := og_get_fecolor(obj);
  bcolor := og_get_becolor(obj);
  og_set_fecolor(obj, bcolor);
  og_set_becolor(obj, fcolor);
END;


Propriété de couleur de remplissage de premier plan

  Exemples	  Rubriques connexes

Description  Couleur de remplissage du premier plan de l'objet.

Syntaxe

PROCEDURE OG_Set_Ffcolor
  (object       OG_Object,
   ffcolor      VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Ffcolor
  (object  OG_Object)
RETURN VARCHAR2;

Paramètres

object	Objet décrit.
ffcolor	Couleur de remplissage du premier plan de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de couleur de remplissage de premier plan - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous permute les couleurs de
**remplissage du premier plan et de l'arrière-plan de l'objet.
*/

PROCEDURE FBFillColor IS
  obj og_object;
  fcolor varchar2(20);
  bcolor varchar2(20);
BEGIN
  obj := og_get_object('rect');
  fcolor := og_get_ffcolor(obj);
  bcolor := og_get_bfcolor(obj);
  og_set_ffcolor(obj, bcolor);
  og_set_bfcolor(obj, fcolor);
END;


Propriété de style de jointure

  Exemples	  Rubriques connexes

Description  Style de jointure du bord de l'objet. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Mitre_Jstyle

OG_Bevel_Jstyle

OG_Round_Jstyle

Syntaxe

PROCEDURE OG_Set_Joinstyle
  (object         OG_Object,
   joinstyle      NUMBER,
   damage         BOOLEAN    :=  TRUE,
   update_bbox    BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Joinstyle
  (object  OG_Object)
RETURN NUMBER;

Paramètres

object	Objet décrit.
joinstyle	Style de jointure du bord de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de style de jointure - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous fait pivoter
**le style de jointure du bord d'un objet.
*/

PROCEDURE JoinStyle (mitreonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  num number;
BEGIN
  num := og_get_joinstyle(hitobj);
  if num = og_mitre_jstyle then
     og_set_joinstyle(hitobj, og_bevel_jstyle);
  elsif num = og_bevel_jstyle then
     og_set_joinstyle(hitobj,og_round_jstyle);
  elsif num = og_round_jstyle then
     og_set_joinstyle(hitobj,og_mitre_jstyle);
  end if;
END;


Propriété d'angle de rotation

  Exemples	  Rubriques connexes

Description  Angle de rotation de l'objet. L'angle auquel l'objet est initialement créé est considéré comme ayant la valeur 0, et cette propriété indique le nombre de degrés, dans le sens des aiguilles d'une montre, dont l'objet diffère de cet angle initial. Vous pouvez faire pivoter un objet suivant un angle absolu, en définissant cette propriété, ou utiliser la procédure OG_Rotate pour faire pivoter un objet d'une valeur relative. (Notez que lorsque vous utilisez OG_Rotate pour faire pivoter un objet, la propriété Rotation Angle est automatiquement mise à jour pour refléter le nouvel angle absolu.)

Syntaxe

PROCEDURE OG_Set_Rotang
  (object       OG_Object,
   rotang       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Rotang
  (object  OG_Object)
RETURN NUMBER;

Paramètres

object	Objet décrit.
rotang	Angle de rotation de l'objet. L'angle auquel l'objet est initialement créé est considéré comme ayant la valeur 0, et cette propriété indique le nombre de degrés, dans le sens des aiguilles d'une montre, dont l'objet diffère de cet angle initial.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété d'angle de rotation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit l'angle de
**rotation d'un objet sélectionné et fait pivoter
**l'objet de +45° vers la droite.
*/

PROCEDURE RotAngle IS
  obj og_object;
  rotang number;
BEGIN
  obj := og_get_object('rect');
  rotang := og_get_rotang(obj);
  og_set_rotang(obj, rotang+45);
END;


Propriété de mode de transfert

  Exemples	  Rubriques connexes

Description  Mode de transfert de l'objet. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Copy_Transfer

OG_Revcopy_Transfer

OG_Or_Transfer

OG_Revor_Transfer

OG_Clear_Transfer

OG_Revclear_Transfer

OG_Invert_Transfer

OG_Backinvert_Transfer

Syntaxe

PROCEDURE OG_Set_Transfer
  (object        OG_Object,
   transfer      NUMBER,
   damage        BOOLEAN    := TRUE,
   update_bbox   BOOLEAN    := TRUE);

FUNCTION OG_Get_Transfer
  (object  OG_Object)
RETURN NUMBER;

Paramètres

object	Objet décrit.
transfer	Mode de transfert de l'objet.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de la boîte englobante.


Propriété de mode de transfert - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous fait pivoter le
**mode de transfert de l'objet sélectionné.
*/

PROCEDURE transher (copyonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  num number;
BEGIN
  num := og_get_transfer(hitobj);
  if num = og_copy_transfer then
     og_set_transfer(hitobj, og_revcopy_transfer);
  elsif num = og_revcopy_transfer then
     og_set_transfer(hitobj,og_or_transfer);
  elsif num = og_or_transfer then
     og_set_transfer(hitobj,og_revor_transfer);
  elsif num = og_revor_transfer then
     og_set_transfer(hitobj,og_clear_transfer);
  elsif num = og_clear_transfer then
     og_set_transfer(hitobj,og_revclear_transfer);
  elsif num = og_revclear_transfer then
     og_set_transfer(hitobj,og_invert_transfer);
  elsif num = og_invert_transfer then
     og_set_transfer(hitobj,og_backinvert_transfer);
  elsif num = og_backinvert_transfer then
     og_set_transfer(hitobj,og_copy_transfer);
  end if;
END;


Propriétés de groupe

Propriété de nombre de fils

Propriété d'indicateur de clipping


Propriété de nombre de fils

  Exemples	  Rubriques connexes

Description  Nombre de fils qui appartiennent à l'objet groupe. Si un autre objet groupe est un fils du groupe en cours de vérification, cet objet ne sera compté que comme un objet.

Syntaxe

FUNCTION OG_Get_Childcount
  (object  OG_Object)
RETURN NUMBER;

Paramètres

object	Objet décrit.


Propriété de nombre de fils - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous extrait
**le nombre de fils d'un objet groupe.
*/

PROCEDURE GrpChildCnt IS
  grp og_object;
  cnt number;
BEGIN
  grp := og_get_object('groupe');
  cnt := og_get_childcount(grp);
END;


Propriété d'indicateur de clipping

  Exemples	  Rubriques connexes

Description  Indique si le premier objet du groupe est un objet rectangle qui devra être utilisé comme un rectangle clipping. Si cette propriété a la valeur TRUE, les seuls membres du groupe qui apparaissent dans la présentation sont les objet, ou les parties de ces objets, qui apparaissent dans les limites du rectangle clipping. L'objet rectangle lui-même apparaît également.

Syntaxe

PROCEDURE OG_Set_Clipflag
  (object        OG_Object,
   clipflag      BOOLEAN,
   damage        BOOLEAN    :=  TRUE,
   update_bbox   BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Clipflag
  (object  OG_Object)
RETURN BOOLEAN;

Paramètres

object	Objet décrit.
clipflag	Indique si le premier objet du groupe est un objet rectangle qui devra être utilisé comme un rectangle clipping.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété d'indicateur de clipping - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si
**l'indicateur de clipping a la valeur TRUE.
**Dans la négative, elle définit l'indicateur à TRUE.
*/

PROCEDURE GrpClipFlg IS
  grp og_object;
  flag boolean;
BEGIN
  grp := og_get_object('groupe');
  flag := og_get_clipflag(grp);
  if flag = false then
     og_set_clipflag(grp, true);
  end if;
END;


Propriétés d'image

Propriété de rectangle clipping

Propriété de trame

Propriété de hauteur

Propriété de position

Propriété de qualité

Propriété de largeur


Propriété de rectangle clipping

  Exemples	  Rubriques connexes

Description  Coordonnées x et y, hauteur et largeur du rectangle clipping de l'image (en unités de présentation). Seule la partie de l'image qui se trouve dans ce rectangle sera affichée. Si cette propriété n'est pas indiquée, le rectangle clipping sera égal aux dimensions complètes de l'image.

Syntaxe

PROCEDURE OG_Set_Cliprect
  (image         OG_Object,
   cliprect      OG_Rectangle,
   damage        BOOLEAN       :=  TRUE,
   update_bbox   BOOLEAN       :=  TRUE);

FUNCTION OG_Get_Cliprect
  (image  OG_Object)
RETURN OG_Rectangle;

Paramètres

image	Objet image décrit.
cliprect	Coordonnées x et y, hauteur et largeur du rectangle clipping de l'image (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de rectangle clipping - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous diminue de moitié la
**taille du rectangle clipping.
*/

PROCEDURE ClipRect IS
  image og_object;
  rect og_rectangle;
BEGIN
  image := og_get_object('image');
  rect := og_get_cliprect(image);
  rect.height := rect.height/2;
  rect.width := rect.width/2;
  og_set_cliprect(image, rect);
  og_set_clipflag(image, true);
END;


Propriété de trame

  Exemples	  Rubriques connexes

Description  Indique si Graphics Builder trame l'image lorsqu'il l'affiche. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

Syntaxe

PROCEDURE OG_Set_Image_Dither
  (image   OG_Object,
   dither  BOOLEAN);

FUNCTION OG_Get_Image_Dither
  (image  OG_Object)
RETURN BOOLEAN;

Paramètres

image	Objet image décrit.
dither	Indique si Graphics Builder trame l'image lorsqu'il l'affiche.


Propriété de trame - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous
**trame une image ou supprime
**le tramage.
*/

PROCEDURE SetDither (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
val boolean;
image og_object;
BEGIN
  image := og_get_object('image');
  val := og_get_image_dither(image);
  if val then
    og_set_image_dither(og_get_object('image'), false);
  else
    og_set_image_dither(og_get_object('image'), true);
  end if;
END;


Propriété de hauteur

  Exemples	  Rubriques connexes

Description  Hauteur de l'image (en unités de présentation). Si vous définissez cette propriété à une valeur autre que la hauteur par défaut de l'image, l'image sera mise à l'échelle en fonction de la nouvelle hauteur.

Syntaxe

(Voir OG_Set_Image_Size, ci-dessus.)

FUNCTION OG_Get_Image_Height
  (image  OG_Object)
RETURN NUMBER;

Paramètres

image	Objet image décrit.


Propriété de hauteur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous diminue de moitié
**la taille de l'image.
*/

PROCEDURE SizeWidthHeight IS
  image og_object;
  height number;
  width number;
BEGIN
  image := og_get_object('image');
  width := og_get_image_width(image);
  height := og_get_image_height(image);
  og_set_image_size(image, width/2, height/2);
END;


Propriété de position

  Exemples	  Rubriques connexes

Description  Coordonnées x et y de l'angle supérieur gauche de l'image (en unités de présentation).

Syntaxe

PROCEDURE OG_Set_Upperleft
  (image          OG_Object,
   upperleft      OG_Point,
   damage         BOOLEAN    :=  TRUE,
   update_bbox    BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Upperleft
  (image  OG_Object)
RETURN OG_Point;

Paramètres

image	Objet image décrit.
upperleft	Coordonnées x et y de l'angle supérieur gauche de l'image (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de position - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**les coordonnées (x et y) de l'angle
**supérieur gauche de l'image. Si elles sont
**différentes de (0,0), la procédure
**fait passer l'angle supérieur gauche de l'image à
**la coordonnée (0,0).
*/

PROCEDURE Position IS
  image og_object;
  pos og_point;
BEGIN
  image := og_get_object('image');
  pos := og_get_upperleft(image);
  if pos.x != 0 and pos.y != 0 then
    pos.x := 0;
    pos.y := 0;
    og_set_upperleft(image, pos);
  end if;
END;


Propriété de qualité

  Exemples	  Rubriques connexes

Description  Qualité de dessin de l'image. Plus la qualité est élevée, plus l'image est précise, mais plus il faut de temps pour la manipuler (par exemple, pour la dessiner, la déplacer, la mettre à l'échelle, etc.). La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_High_Iquality

OG_Medium_Iquality

OG_Low_Iquality

Syntaxe

PROCEDURE OG_Set_Image_Quality
  (image    OG_Object,
   quality  NUMBER);

FUNCTION OG_Get_Image_Quality
  (image  OG_Object)
RETURN NUMBER;

Paramètres

image	Objet image décrit.
quality	Qualité de dessin de l'image.


Propriété de qualité - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie la qualité
**de l'image. Si l'image est dessinée en qualité
**élevée, la procédure la redessine en qualité
**faible.
*/

PROCEDURE GetQuality (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  image og_object;
  qty number;
BEGIN
  image := og_get_object('image');
  qty := og_get_image_quality(image);
  if qty = og_high_iquality then
    og_set_image_quality(image, og_low_iquality);
  end if;
END;


Propriété de largeur

  Exemples	  Rubriques connexes

Description  Largeur de l'image (en unités de présentation). Si vous définissez cette propriété à une valeur autre que la largeur par défaut de l'image, l'image sera mise à l'échelle en fonction de la nouvelle largeur.

Syntaxe

PROCEDURE OG_Set_Image_Size
  (image        OG_Object,
   width        NUMBER,
   height       NUMBER,
   damage       BOOLEAN    := TRUE,
   update_bbox  BOOLEAN    :=   TRUE);

FUNCTION OG_Get_Image_Width
  (image  OG_Object)
RETURN NUMBER;

Paramètres

image	Objet image décrit.
width	Largeur de l'image (en unités de présentation).
height	Hauteur de l'image (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de largeur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous diminue de moitié
**la taille d'une image.
*/

PROCEDURE SizeWidthHeight IS
  image og_object;
  height number;
  width number;
BEGIN
  image := og_get_object('image');
  width := og_get_image_width(image);
  height := og_get_image_height(image);
  og_set_image_size(image, width/2, height/2);
END;


Propriétés de ligne

Propriété de style de flèche

Propriété de point final

Propriété de point de départ


Propriété de style de flèche

  Exemples	  Rubriques connexes

Description  Style de flèche de la ligne. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Noarrow_Astyle   Indique que la ligne ne comporte pas de flèche.

OG_Start_Astyle   Indique que la ligne comporte une flèche à son point de départ.

OG_End_Astyle   Indique que la ligne comporte une flèche à son point final.

OG_Both_Astyle   Indique que la ligne comporte une flèche à ses deux extrémités.

OG_Midtostart_Astyle   Indique que la ligne comporte, en son milieu, une flèche qui pointe vers le point de départ

OG_Midtoend_Astyle   Indique que la ligne comporte, en son milieu, une flèche qui pointe vers le point final.

Syntaxe

PROCEDURE OG_Set_Arrowstyle
  (line         OG_Object,
   arrowstyle   NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Arrowstyle
  (line  OG_Object)
RETURN NUMBER;

Paramètres

line	Objet ligne décrit.
Arrowstyle	Style de flèche de la ligne.
Damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de style de flèche - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous détermine
*le style de flèche d'une ligne. Si la ligne
**ne comporte pas de flèche, la procédure
**en ajoute aux deux extrémités de la ligne.
**Si la ligne comporte des flèches, la procédure
**les supprime.
*/

PROCEDURE Arrow (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  arrow og_object;
  num number;
BEGIN
  arrow := og_get_object('flèche');
  num := og_get_arrowstyle(arrow);
  if num = og_noarrow_astyle then
    og_set_arrowstyle(arrow, og_both_astyle);
  else
    og_set_arrowstyle(arrow, og_noarrow_astyle);
  end if;
END;


Propriété de point final

  Exemples	  Rubriques connexes

Description  Coordonnées x et y du point final de la ligne (en unités de présentation).

Syntaxe

PROCEDURE OG_Set_Endpt
  (line         OG_Object,
   endpt        OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Endpt
  (line  OG_Object)
RETURN OG_Point;

Paramètres

line	Objet ligne décrit.
endpt	Coordonnées x et y du point final de la ligne (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de point final - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit les
**coordonnées du point final de la ligne.
**Si la ligne ne se termine pas à l'angle supérieur gauche
**de l'affichage, la procédure redéfinit le
**point final à (0,0).
*/

PROCEDURE OGBUTTONPROC0 (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  arrow og_object;
  pos og_point;
BEGIN
  arrow := og_get_object('a');
  pos := og_get_endpt(arrow);
  if pos.x != 0 and pos.y != 0 then
    pos.x := 0;
    pos.y := 0;
    og_set_endpt(arrow, pos);
  end if;
END;


Propriété de point de départ

  Exemples	  Rubriques connexes

Description Coordonnées x et y du point de départ de la ligne (en unités de présentation).

Syntaxe

PROCEDURE OG_Set_Startpt
  (line         OG_Object,
   startpt      OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Startpt(line OG_Object)
RETURN OG_Point;

Paramètres

line	Objet ligne décrit.
startpt	Coordonnées x et y du point de départ de la ligne (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de point de départ - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* /*La procédure ci-dessous lit les
**coordonnées du point de départ de la ligne.
**Si la ligne ne commence pas à l'angle
**supérieur gauche de l'affichage, la
**procédure redéfinit le
**point final à (0,0).
*/

PROCEDURE  StartPt (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  arrow og_object;
  pos og_point;
BEGIN
  arrow := og_get_object('a');
  pos := og_get_startpt(arrow);
  if pos.x != 0 and pos.y != 0 then
    pos.x := 0;
    pos.y := 0;
    og_set_startpt(arrow, pos);
  end if;
END;


Propriétés de polygone

Propriété de fermeture

Propriété de nombre de points


Propriété de fermeture

  Exemples	  Rubriques connexes

Description  Fermeture du polygone. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

TRUE   Indique que le polygone est fermé.

FALSE   Indique que le polygone est ouvert.

Syntaxe

PROCEDURE OG_Set_Poly_Closed
  (poly         OG_Object,
   closed       BOOLEAN,
   damage       BOOLEAN    := TRUE,
   update_bbox  BOOLEAN    := TRUE);

FUNCTION OG_Get_Poly_Closed
  (poly  OG_Object)
RETURN BOOLEAN;

Paramètres

poly	Polygone décrit.
closed	Fermeture du polygone.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de fermeture - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous détermine
**si un polygone est fermé ou ouvert.
**Si le polygone est ouvert, la procédure
**le ferme.
*/

PROCEDURE closure IS
  polygon og_object;
  val boolean;
BEGIN
  polygon := og_get_object('polygone');
  val := og_get_poly_closed(polygon);
  if val = false  then
     og_set_poly_closed(polygon, true);
  end if;
END;


Propriété de nombre de points

  Exemples	  Rubriques connexes

Description  Nombre de points composant l'objet polygone.

Syntaxe

FUNCTION OG_Get_Pointct
  (poly  OG_Object)
RETURN NUMBER;

Paramètres

poly	Polygone décrit.


Propriété de nombre de points - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le
**nombre de point qui compose l'objet
**polygone et imprime la valeur
**dans un objet texte.
*/

PROCEDURE PntCnt IS
  text og_object;
  polygon og_object;
  cnt number;
BEGIN
text := og_get_object('objet texte');
  polygon := og_get_object('polygone');
  cnt := og_get_pointct(polygon);
  og_set_str(text, cnt);
END;


Propriétés d'imprimante

Propriété de nombre de copies

Propriété de dernière page

Propriété de mode paysage

Propriété de nom

Propriété de format de page

Propriété de fichier d'impression

Propriété de première page


Propriété de nombre de copies

  Exemples	  Rubriques connexes

Description  Nombre de copies à imprimer.

Syntaxe

PROCEDURE OG_Set_Copies
  (copies  NUMBER);

FUNCTION OG_Get_Copies
RETURN NUMBER;

Paramètres

copies	Nombre de copies à imprimer.


Propriété de nombre de copies - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**le nombre de copies et ajoute deux
**copies supplémentaires à imprimer.
*/

PROCEDURE PrinterCopies IS
  copies number;
BEGIN
  copies := og_get_copies;
  og_set_copies(copis+2);
END;


Propriété de dernière page

  Exemples	  Rubriques connexes

Description  Dernière page à imprimer.

Syntaxe

PROCEDURE OG_Set_Endpage
  (endpage  NUMBER);

FUNCTION OG_Get_Endpage
RETURN NUMBER;

Paramètres

endpage	Dernière page à imprimer.


Propriété de dernière page - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le
**numéro de la dernière page et le redéfinit
**au numéro initial plus deux.
*/.

PROCEDURE PrinterEndPage IS
  ep number;
BEGIN
  ep := og_get_endpage;
  og_set_endpage(ep+2);
END;


Propriété de mode paysage

  Exemples	  Rubriques connexes

Description  Indique si l'affichage est imprimé en mode portrait ou en mode paysage.

Syntaxe

PROCEDURE OG_Set_Landscape
  (landscape  BOOLEAN);

FUNCTION OG_Get_Landscape
RETURN BOOLEAN;

Paramètres

landscape	Indique si l'affichage est imprimé en mode portrait ou en mode paysage.


Propriété de mode paysage - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous détermine
**si l'affichage est imprimé en mode paysage
**ou en mode portrait et imprime le type de
**mode dans un objet texte.
*/

PROCEDURE PrinterLandscape IS

  landscape boolean;

BEGIN

  landscape := og_get_landscape;
  if landscape then
     og_set_str(og_get_object('objet texte'), 'paysage');
  else
     og_set_str(og_get_object('objet texte'), 'portrait');
  end if;
END;


Propriété de nom

  Exemples	  Rubriques connexes

Description  Nom de l'imprimante en cours.

Syntaxe

PROCEDURE OG_Set_Printer_Name
  (name  VARCHAR2);

FUNCTION OG_Get_Printer_Name
RETURN VARCHAR2;

Paramètres

name	Nom de l'imprimante en cours.


Propriété de nom - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous définit
**le nom de l'imprimante et l'imprime
**dans un objet texte.
*/

PROCEDURE PrinterName IS
  name varchar2(30);
BEGIN
  name := og_get_printer_name;
  og_set_str(og_get_object('objet texte'), name);
END;


Propriété de format de page

  Exemples	  Rubriques connexes

Description  Format de page (en pouces).

Syntaxe

PROCEDURE OG_Set_Pagesize
  (width   NUMBER,
  (height  NUMBER);

Paramètres

width	Largeur de la page (en pouces).
height	Hauteur de la page (en pouces).


Propriété de format de page - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous définit
**le format de page.
*/

PROCEDURE PrinterPageSize IS
  height number := 10*og_inch;
  width number := 10*og_inch;
  printfile varchar2(20);
BEGIN
  og_set_pagesize(height, width);
END;


Propriété de fichier d'impression

  Exemples	  Rubriques connexes

Description  Nom du fichier PostScript dans lequel sera effectuée l'impression. Si cette propriété est définie à NULL, la sortie est envoyée à l'imprimante.

Syntaxe

PROCEDURE OG_Set_Printfile
  (filename  VARCHAR2);

FUNCTION OG_Get_Printfile
RETURN VARCHAR2;

Paramètres

filename	Nom du fichier PostScript dans lequel sera effectuée l'impression. Si cette propriété est définie à NULL, la sortie est envoyée à l'imprimante.


Propriété de fichier d'impression - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*.La procédure ci-dessous définit le
**nom du fichier PostScript et l'imprime
**dans un objet texte.
*/

PROCEDURE PrinterPrintFile IS
  printfile varchar2(20);
BEGIN
  og_set_printfile('monfichier');
  printfile := og_get_printfile;
  og_set_str(og_get_object('objet texte'), printfile);
END;


Propriété de première page

  Exemples	  Rubriques connexes

Description  Première page à imprimer.

Syntaxe

PROCEDURE OG_Set_Startpage
  (startpage  NUMBER);

FUNCTION OG_Get_Startpage
RETURN NUMBER;

Paramètres

startpage	Première page à imprimer.


Propriété de première page - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le numéro
**de la première page et le redéfinit
**au numéro initial plus deux.
*/

PROCEDURE PrinterStartPage IS
  sp number;
BEGIN
  sp := og_get_startpage;
  og_set_startpage(sp+2);
END;


Propriétés d'interrogation

Propriété de type de tampon

Propriété de procédure d'interrogation personnalisée

Propriété de format de date

Propriété d'exécution sur ouverture

Propriété d'exécution sur horloge

Propriété de nombre maximum de lignes

Propriété de nom

Propriété de procédure de déclenchement après interrogation

Propriété de source d'interrogation

Propriété de type d'interrogation


Propriété de type de tampon

  Exemples	  Rubriques connexes

Description  Détermine la façon dont les dernières données extraites de l'exécution d'une interrogation sont traitées. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Append_Cachetype   Indique que toutes les lignes de données existantes sont conservées et que les nouvelles lignes de données sont ajoutées à la base de l'ensemble de données existant.

OG_Copy_Cachetype   Indique que toutes les données provenant de la précédente exécution sont copiées dans un tampon spécial et remplacées par les dernières données extraites.

OG_None_Cachetype   Indique que toutes les données provenant de la précédente exécution ne sont pas prises en compte et qu'elles sont remplacées par les dernières données extraites.

Syntaxe

PROCEDURE OG_Set_Cachetype
  (query      OG_Query,
   cachetype  NUMBER);

FUNCTION OG_Get_Cachetype
  (query  OG_Query)
RETURN NUMBER;

Paramètres

query	Interrogation décrite.
cachetype	Détermine la façon dont les dernières données extraites de l'exécution d'une interrogation sont traitées.


Propriété de type de tampon - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous fait pivoter
**le type de tampon d'interrogation d'une interrogation.
*/

PROCEDURE QryCacheType (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  qry og_query;
  num number;
BEGIN
  qry := og_get_query('interrogation0');
  num := og_get_cachetype(qry);
  if num = og_append_cachetype then
     og_set_cachetype(qry, og_copy_cachetype);
  elsif num = og_copy_cachetype then
     og_set_cachetype(qry, og_none_cachetype);
  elsif num = og_none_cachetype then
     og_set_cachetype(qry, og_append_cachetype);
  end if;
END;


Propriété de procédure d'interrogation personnalisée

  Exemples	  Rubriques connexes

Description  Procédure PL/SQL appelée lorsqu'une interrogation personnalisée est exécutée.

Syntaxe

PROCEDURE OG_Set_Customproc
  (query       OG_Query,
   customproc  VARCHAR2);

FUNCTION OG_Get_Customproc
  (query  OG_Query)
RETURN VARCHAR2;

Paramètres

query	Interrogation décrite.
customproc	Procédure PL/SQL appelée lorsqu'une interrogation personnalisée est exécutée.


Propriété de procédure d'interrogation personnalisée - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous permute les deux procédures PL/SQL
**qui sont appelées lorsqu'une interrogation personnalisée

**est exécutée.
*/

PROCEDURE CustQry (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  proc varchar2(20);
  qry og_query;
BEGIN
  qry := og_get_query('interrogation0');
  proc := og_get_customproc(qry);
  if proc = 'CUSTQRY1' then
    og_set_customproc(qry, 'CUSTQRY2');
  elsif proc = 'CUSTQRY2' then
     og_set_customproc(qry, 'CUSTQRY1');
  end if;
  og_execute_query(qry);
END;


Propriété de format de date

  Exemples	  Rubriques connexes

Description  Masque de format de date de l'interrogation.

Syntaxe

PROCEDURE OG_Set_Dateformat
  (query       OG_Query,
   dateformat  VARCHAR2);

FUNCTION OG_Get_Dateformat
  (query  OG_Query)
RETURN VARCHAR2;

Paramètres

query	Interrogation décrite.
dateformat	Masque de format de date de l'interrogation.


Propriété de format de date - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit et définit
**le masque de format de date de l'interrogation.
*/

PROCEDURE QueryDateFmt IS
  qry og_query;
  DateFmt varchar2(20);
BEGIN
  qry := og_get_query('interrogation0');
  DateFmt := og_get_dateformat(qry);
  og_set_dateformat(qry, 'JJ-MM-AAAA');
  DateFmt := og_get_dateformat(qry);
END;


Propriété d'exécution sur ouverture

  Exemples	  Rubriques connexes

Description  Indique si l'interrogation doit être exécutée automatiquement lorsque l'affichage est ouvert au moment de l'exécution.

Syntaxe

PROCEDURE OG_Set_Execopen
  (query     OG_Query,
   execopen  BOOLEAN);

FUNCTION OG_Get_Execopen
  (query  OG_Query)
RETURN BOOLEAN;

Paramètres

query	Interrogation décrite.
execopen	Indique si l'interrogation doit être exécutée automatiquement lorsque l'affichage est ouvert au moment de l'exécution.


Propriété d'exécution sur ouverture - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si la case
**Exécution sur ouverture est cochée. Dans l'affirmative
**supprimez la coche, ou vice versa.
*/

PROCEDURE ExecOpen IS
  execOpen boolean;
  qry og_query;
BEGIN
  qry := og_get_query('interrogation0');
  execOpen := og_get_execopen(qry);
  if execOpen then
     og_set_execopen(qry, false);
  else
     og_set_execopen(qry, true);
  end if;
END;


Propriété d'exécution sur horloge

  Exemples	  Rubriques connexes

Description  Nom de l'horloge sur laquelle s'exécute l'interrogation. Si cette propriété est définie à NULL, l'interrogation n'est pas exécutée sur une horloge.

Syntaxe

PROCEDURE OG_Set_Exectimer
  (query      OG_Query,
   exectimer  VARCHAR2);

FUNCTION OG_Get_Exectimer
  (query  OG_Query)
RETURN VARCHAR2;

Paramètres

query	Interrogation décrite.
exectimer	Nom de l'horloge sur laquelle s'exécute l'interrogation. Si cette propriété est définie à NULL, l'interrogation n'est pas exécutée sur une horloge.


Propriété d'exécution sur horloge - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le nom
**de l'horloge sur laquelle l'interrogation est
**exécutée et attribue une nouvelle horloge à l'interrogation.
*/

PROCEDURE ExecTimer IS
  exectimer varchar2(20);
  qry og_query;
BEGIN
  qry := og_get_query('interrogation0');
  exectimer := og_get_exectimer(qry);
  og_set_exectimer(qry, 'horloge1');
END;


Propriété de nombre maximum de lignes

  Exemples	  Rubriques connexes

Description  Nombre maximum de lignes de données conservées dans l'ensemble des données de l'interrogation. Si cette propriété est définie à NULL, toutes les lignes sont conservées.

Syntaxe

PROCEDURE OG_Set_Maxrows
  (query    OG_Query,
   maxrows  NUMBER);

FUNCTION OG_Get_Maxrows
  (query  OG_Query)
RETURN NUMBER;

Paramètres

query	Interrogation décrite.
Maxrows	Nombre maximum de lignes de données conservées dans l'ensemble des données de l'interrogation. Si cette propriété est définie à NULL, toutes les lignes sont conservées.


Propriété de nombre maximum de lignes - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le nombre maximum
**de lignes de données conservées dans l'ensemble
**de données de l'interrogation et ajoute deux lignes
**au nombre initial.
*/

PROCEDURE QueryMaxRow IS
  qry og_query;
  num number;
BEGIN
  qry := og_get_query('interrogation0');
  num := og_get_maxrows(qry);
  og_set_maxrows(qry, num+2);
END;


Propriété d'indicateur de nombre maximum de lignes

  Exemples	  Rubriques connexes

Description  Indique si une limite est fixée sur le nombre de lignes conservées dans l'ensemble de données. Cette propriété n'est utilisée que lorsque le type de cache est OG_APPEND_CACHETYPE.

Syntaxe

PROCEDURE OG_Set_Maxflag
  (query    OG_Query,
   maxflag  BOOLEAN);

FUNCTION OG_Get_Maxflag
  (query  OG_Query)
RETURN BOOLEAN;

Paramètres

query	Interrogation décrite.
maxflag	Nombre maximum de lignes de données conservées dans l'ensemble des données de l'interrogation.


Propriété d'indicateur de nombre maximum de lignes - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit le nombre maximum
**de lignes de données conservées dans l'ensemble
**de données de l'interrogation et ajoute deux lignes
**au nombre initial. Si le nombre incrémenté
**est supérieur à 1024, l'indicateur de nombre maximum
**de lignes est activé, ce qui permet à l'interrogation
**d'accéder à toutes les lignes de données.
*/

PROCEDURE MaxFlagToggle IS
  qry og_query;
  num number;
BEGIN
  qry := og_get_query('interrogation0');
  num := og_get_maxrows(qry);

  num := num+2;
  og_set_maxrows(qry, num);

  IF ((num > 1024) AND (og_get_maxflag(qry)=TRUE)) THEN

    og_set_maxflag(qry,FALSE);

  END IF;
END;


Propriété de nom

  Exemples	  Rubriques connexes

Description  Nom de l'interrogation.

Syntaxe

PROCEDURE OG_Set_Name
  (query  OG_Query,
   name   VARCHAR2);

FUNCTION OG_Get_Name
  (query  OG_Query)
RETURN VARCHAR2;

Paramètres

query	Interrogation décrite.
name	Nom de l'interrogation.


Propriété de nom - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous permute
** le nom de deux interrogations.
*/

PROCEDURE QueryName IS
  qry0 og_query;
  qry1 og_query;
  name0 varchar2(30);
  name1 varchar2(30);
BEGIN
  qry0 := og_get_query('interrogation0');
  qry1 := og_get_query('interrogation1');
  name0 := og_get_name(qry0);
  name1 := og_get_name(qry1);
  og_set_name(qry1, 'tmp');
  og_set_name(qry0, name1);
  og_set_name(qry1, name0);
END;


Propriété de procédure de déclenchement après interrogation

  Exemples	  Rubriques connexes

Description  Procédure PL/SQL appelée après l'exécution de l'interrogation.

Syntaxe

PROCEDURE OG_Set_Postproc
  (query     OG_Query,
   postproc  VARCHAR2);

FUNCTION OG_Get_Postproc
  (query  OG_Query)
RETURN VARCHAR2;

Paramètres

query	Interrogation décrite.
postproc	Procédure PL/SQL appelée après l'exécution de l'interrogation.


Propriété de procédure de déclenchement après interrogation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous permute les deux procédures
**PL/SQL qui sont appelées après l'exécution de
**l'interrogation.
*/

PROCEDURE PostTrigger (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  proc varchar2(20);
  qry og_query;
BEGIN
  qry := og_get_query('interrogation0');
  proc := og_get_postproc(qry);
  if  proc = 'POST1' then
      og_set_postproc(qry, 'POST2');
  elsif proc = 'POST2' then
      og_set_postproc(qry, 'POST1');
  end if;
  og_execute_query(qry);
END;


Propriété de source d'interrogation

  Exemples	  Rubriques connexes

Description  Source des données de l'interrogation. Si les données proviennent d'une base de données, cette propriété doit contenir le texte de l'instruction SQL SELECT de l'interrogation. Si les données sont stockées dans le système de fichiers, cette propriété doit contenir le chemin et le nom du fichier de données.

Syntaxe

PROCEDURE OG_Set_Querysource
  (query        OG_Query,
   querysource  VARCHAR2);

FUNCTION OG_Get_Querysource
  (query  OG_Query)
RETURN VARCHAR2;

Paramètres

query	Interrogation décrite.
querysource	Source des données de l'interrogation.


Propriété de source d'interrogation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous permute la source
**de deux interrogations.
*/

PROCEDURE QuerySource IS
  qry0 og_query;
  qry1 og_query;
  source0 varchar2(50);
  source1 varchar2(50);
BEGIN
  qry0 := og_get_query('interrogation0');
  qry1 := og_get_query('interrogation1');
  source0:= og_get_querysource(qry0);
  source1:= og_get_querysource(qry1);
  og_set_querysource(qry0, source1);
  og_set_querysource(qry1, source0);
END;


Propriété de type d'interrogation

  Exemples	  Rubriques connexes

Description  Type d'interrogation. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Custom_Qtype   Indique que l'interrogation est personnalisée.

OG_Exsql_Qtype   Indique que l'interrogation extrait ses données d'un fichier texte contenant une instruction SQL SELECT.

OG_Prn_Qtype   Indique que l'interrogation est basée sur un fichier PRN.

OG_Sql_Qtype   Indique que l'interrogation est une instruction SQL SELECT.

OG_Sylk_Qtype   Indique que l'interrogation est basée sur un fichier SYLK.

OG_Wks_Qtype Indique que l'interrogation est basée sur un fichier WKS.

Syntaxe

PROCEDURE OG_Set_Querytype
  (query      OG_Query,
   querytype  NUMBER);

FUNCTION OG_Get_Querytype
  (query  OG_Query)
RETURN NUMBER;

Paramètres

query	Interrogation décrite.
querytype	Type d'interrogation.


Propriété de type d'interrogation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous fait pivoter
**le type d'interrogation d'une interrogation.
*/

PROCEDURE QryType (buttonobj IN og_object,

                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  qry og_query;
  num number;
BEGIN
  qry := og_get_query('interrogation0');
  num := og_get_querytype(qry);

  if num = og_custom_qtype then
     og_set_querytype(qry, og_exsql_qtype);
  elsif num = og_exsql_qtype then
     og_set_querytype(qry, og_prn_qtype);
  elsif num = og_prn_qtype then
     og_set_querytype(qry, og_sql_qtype);
  elsif num = og_sql_qtype then
     og_set_querytype(qry, og_sylk_qtype);
   elsif num = og_sylk_qtype then
     og_set_querytype(qry, og_wks_qtype);
 elsif num = og_wks_qtype then
     og_set_querytype(qry, og_custom_qtype);
  end if;
END;


Propriété de rectangle

Propriété de rectangle de base


Propriété de rectangle de base

  Exemples	  Rubriques connexes

Description  Coordonnées x et y de l'angle supérieur gauche, ainsi que hauteur et largeur du rectangle utilisé comme base de l'objet rectangle (en unités de présentation).

Syntaxe

PROCEDURE OG_Set_Rect_Baserect
  (rect         OG_Object,
   baserect     OG_Rectangle,
   damage       BOOLEAN       :=  TRUE,
   update_bbox  BOOLEAN       :=  TRUE);

FUNCTION OG_Get_Rect_Baserect
  (rect  OG_Object)
RETURN OG_Rectangle;

Paramètres

rect	Objet rectangle décrit.
baserect	Coordonnées x et y de l'angle supérieur gauche, ainsi que hauteur et largeur du rectangle utilisé comme base de l'objet rectangle (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de rectangle de base - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous détermine la taille
**du rectangle de base et la double.
*/

PROCEDURE baseRect IS
  rect og_rectangle;
  obj og_object;
BEGIN
  obj := og_get_object('rect');
  rect := og_get_rect_baserect(obj);
  rect.x := rect.x * 2;
  rect.y := rect.y * 2;
  rect.height := rect.height * 2;
  rect.width := rect.width * 2;
  og_set_rect_baserect(obj, rect);
END;);
  source0:= og_get_querysource(qry0);
  source1:= og_get_q?_


Propriétés de ligne de référence

Propriété d'axe

Propriété de valeur de date

Propriété de libellé

Propriété de valeur numérique


Propriété d'axe

  Exemples	  Rubriques connexes

Description  Axe auquel la valeur de référence est comparée pour déterminer sa position. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_X_Axis

OG_Y1_Axis

OG_Y2_Axis

Syntaxe

PROCEDURE OG_Set_Axis
  (refline  OG_Refline,
   axis     NUMBER);

FUNCTION OG_Get_Axis
  (refline  OG_Refline)
RETURN NUMBER;

Paramètres

refline	Ligne de référence décrite.
axis	Axe auquel la valeur de référence est comparée pour déterminer sa position.


Propriété d'axe - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous compare
**la ligne de référence à l'axe Y1
**si la ligne est comparée à
**l'axe Y2.
*/

PROCEDURE Axis IS
  chart og_object;
  axis number;
  refline og_refline;
  template og_template;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  refline := og_get_refline(template, 0);
  axis := og_get_axis(refline);
  if axis = og_y2_axis then
    og_set_axis(refline, og_y1_axis);
  end if;
  og_update_chart(chart);
END;


Propriété de valeur de date

  Exemples	  Rubriques connexes

Description  Valeur de date à laquelle apparaît la ligne de référence.

Syntaxe

PROCEDURE OG_Set_Datevalue
  (refline    OG_Refline,
   datevalue  DATE);

FUNCTION OG_Get_Datevalue
  (refline  OG_Refline)
RETURN DATE;

Paramètres

refline	Ligne de référence décrite.
datevalue	Valeur de date à laquelle apparaît la ligne de référence.


Propriété de valeur de date - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous augmente
**la valeur de la ligne de référence de 30 jours.
*/

PROCEDURE DateVal IS
  chart og_object;
  dateval date;
  refline og_refline;
  template og_template;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  refline := og_get_refline(template, 0);
  dateval := og_get_datevalue(refline);
  og_set_datevalue(refline, dateval+30);
  og_update_chart(chart);
END;


Propriété de libellé

  Exemples	  Rubriques connexes

Description  Libellé de texte qui identifie la ligne de référence dans la légende.

Syntaxe

PROCEDURE OG_Set_Label
  (refline  OG_Refline,
   label    VARCHAR2);

FUNCTION OG_Get_Label
  (refline  OG_Refline)
RETURN VARCHAR2;

Paramètres

refline	Ligne de référence décrite.
label	Libellé de texte qui identifie la ligne de référence dans la légende.


Propriété de libellé - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous remplace
**le nom de la ligne de référence par
**'Nouveau Libellé' si le libellé n'a pas de
**nom.
*/

PROCEDURE label IS
  chart og_object;
  label varchar2(20);
  refline og_refline;
  template og_template;
BEGIN
chart := og_get_object('graphique');
  template := og_get_template(chart);
  refline := og_get_refline(template, 0);
  label := og_get_label(refline);
  if label != 'Nouveau libellé' then
    og_set_label(refline, ' Nouveau libellé ');
  end if;
  og_update_chart(chart);
END;


Propriété de valeur numérique

  Exemples	  Rubriques connexes

Description  Valeur numérique à laquelle apparaît la ligne de référence.

Syntaxe

PROCEDURE OG_Set_Numvalue
  (refline   OG_Refline,
   numvalue  NUMBER);

FUNCTION OG_Get_Numvalue
  (refline  OG_Refline)
RETURN NUMBER;

Paramètres

refline	Ligne de référence décrite.
numvalue	Valeur numérique à laquelle apparaît la ligne de référence.


Propriété de valeur numérique - Exemples

  Liste alphabétique         [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous augmente la
**valeur de la ligne de référence de 500.
*/

PROCEDURE NumVal IS
  chart og_object;
  num number;
  refline og_refline;
  template og_template;
BEGIN
  chart := og_get_object('graphique');
  template := og_get_template(chart);
  refline := og_get_refline(template, 0);
  num := og_get_numvalue(refline);
  og_set_numvalue(refline, num+500);
  og_update_chart(chart);
END;


Propriétés de rectangle arrondi

Propriété de rectangle de base

Propriété de rayon d'angle


Propriété de rectangle de base

  Exemples	  Rubriques conexes

Description  Coordonnées x et y de l'angle supérieur gauche, ainsi que hauteur et largeur du rectangle utilisé comme base de l'objet rectangle (en unités de présentation).

Syntaxe

PROCEDURE OG_Set_Rrect_Baserect
  (rrect        OG_Object,
   baserect     OG_Rectangle,
   damage       BOOLEAN       :=  TRUE,
   update_bbox  BOOLEAN       :=  TRUE);

FUNCTION OG_Get_Rrect_Baserect
  (rrect  OG_Object)
RETURN OG_Rectangle;

Paramètres

rrect	Rectangle arrondi décrit.
baserect	Coordonnées x et y de l'angle supérieur gauche, ainsi que hauteur et largeur du rectangle utilisé comme base de l'objet rectangle (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de rectangle de base - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure bouton ci-dessous diminue
**la taille du rectangle de base
**ou du rectangle arrondi.
*/

PROCEDURE baserect (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  brect og_rectangle;
  rrect og_object;
BEGIN
  rrect := og_get_object('rectarr');
  brect := og_get_rrect_baserect(rrect);
  brect.x := brect.x/2;
  brect.y := brect.y/2;
  brect.height := brect.height/2;
  brect.width := brect.width/2;
  og_set_rrect_baserect(rrect, brect);
END;


Propriété de rayon d'angle

  Exemples	  Rubriques conexes

Description  Rayons x et y (en unités de présentation) de l'ellipse qui serait tracée si les arcs formant les angles arrondis se prolongeaient en un chemin complet sur 360°.

Syntaxe

PROCEDURE OG_Set_Corner
  (rrect        OG_Object,
   corner       OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Corner
  (rrect  OG_Object)
RETURN OG_Point;

Paramètres

rrect	Rectangle arrondi décrit.
corner	Rayons x et y (en unités de présentation) de l'ellipse qui serait tracée si les arcs formant les angles arrondis se prolongeaient en un chemin complet sur 360°.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de rayon d'angle - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure bouton ci-dessous double
**les rayons x et y de l'ellipse utilisée
**pour tracer les angles d'un rectangle arrondi.
*/.

PROCEDURE corner (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  pt og_point;
  rrect og_object;
BEGIN
  rrect := og_get_object('rectarr');
  pt := og_get_corner(rrect);
  pt.x := pt.x*2;
  pt.y := pt.y*2;
  og_set_corner(rrect, pt);
END;


Propriété de son

Propriété de nom


Propriété de nom

  Exemples	  Rubriques connexes

Description  Nom du son.

Syntaxe

PROCEDURE OG_Set_Name
  (sound  OG_Sound,
   name   VARCHAR2);

FUNCTION OG_Get_Name
  (sound  OG_Sound)
RETURN VARCHAR2;

Paramètres

sound	Objet son décrit.
name	Nom du son.


Propriété de nom - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous extrait
**le nom du son du gestionnaire de son
**et lui attribue un nouveau nom.
*/

PROCEDURE SoundName (sound in og_sound) IS

name varchar2(10);

BEGIN

  name := og_get_name(sound);

  og_set_name(sound, name||'2');

END;


Propriétés de texte simple

Propriété de couleur

Propriété de police

Propriété de chaîne de texte


Propriété de couleur

  Exemples	  Rubriques connexes

Description  Couleur dans laquelle le texte de la chaîne de caractères doit être affiché. Notez que cette couleur est celle du texte lui-même. Pour définir la couleur du bord ou la couleur de remplissage de l'objet texte, modifiez les attributs graphiques de l'objet texte.

Syntaxe

FUNCTION OG_Get_Color
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN VARCHAR2;

Paramètres

text	Objet texte décrit.
cmptext_index	Numéro d'index de l'élément texte composé décrit.
smptext_index	Numéro d'index de l'élément texte simple décrit.


Propriété de couleur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /* La procédure ci-dessous lit la couleur
**de l'objet texte en cours. Si elle
**est autre que rouge, la procédure la
**remplace par rouge.
*/

PROCEDURE color (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
color varchar2(20);
BEGIN
   color := og_get_color(hitobj, 0, 0);
   if color != 'rouge' then
     og_set_gcolor(hitobj, 'rouge');
   end if;
END;


Propriété de police

  Exemples 	  Rubriques connexes

Description  Police dans laquelle le texte de la chaîne de caractères est affiché.

Syntaxe

FUNCTION OG_Get_Font_Typeface
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN VARCHAR2;

FUNCTION OG_Get_Font_Ptsize
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN NUMBER;

FUNCTION OG_Get_Font_Style
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN NUMBER;

FUNCTION OG_Get_Font_Weight
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN NUMBER;

FUNCTION OG_Get_Font_Width
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN NUMBER;

FUNCTION OG_Get_Font_Kerning
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN BOOLEAN;

FUNCTION OG_Get_Font_Charset
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN NUMBER;

Paramètres

text	Objet texte décrit.
cmptext_index	Numéro d'index de l'élément texte composé décrit.
smptext_index	Numéro d'index de l'élément texte simple décrit.


Propriété de police - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  */La procédure ci-dessous lit
**le type de caractère de
**l'objet texte sélectionné. Si le
**style en cours n'est pas le même
**que le type de caractère de l'argument,
**un nouveau type de caractère est attribué
**à l'objet texte.
*/

PROCEDURE fonttypeface (text og_object, typeface varchar2)IS

style varchar2(10);

BEGIN

  style := og_get_font_typeface(text, 0,0);

  if style != typeface then

    og_set_font_typeface(text, typeface);

  end if;

END;


Propriété de chaîne de texte

  Exemples	  Rubriques connexes

Description  Chaîne de caractères contenant le texte de l'élément texte simple.

Syntaxe

PROCEDURE OG_Set_Str
  (text         OG_Object,
   str          VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Str
  (text           OG_Object,
   cmptext_index  NUMBER,
   smptext_index  NUMBER)
RETURN VARCHAR2;

Paramètres

text	Objet texte décrit
str	Chaîne de caractères contenant le texte de l'élément texte simple.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.
cmptext_index	Numéro d'index de l'élément texte composé décrit.
smptext_index	Numéro d'index de l'élément texte simple décrit.


Propriété de chaîne de texte - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

  /*La procédure ci-dessous lit une chaîne de texte
**affichée et y ajoute des numéros.
*/

PROCEDURE TextString IS

  text og_object;

BEGIN

  text := og_get_object('objet texte');

  og_set_str(text,og_get_str(text,0,0)||'123');

END;


Propriétés de symbole

Propriété de centre

Propriété d'index

Propriété de taille de symbole


Propriété de centre

  Exemples	  Rubriques connexes

Description  Coordonnées x et y du centre du symbole (en unités de présentation).

Syntaxe

PROCEDURE OG_Set_Center
  (symbol       OG_Object,
   center       OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Center
  (symbol  OG_Object)
RETURN OG_Point;

Paramètres

symbol	Objet symbole décrit.
center	Coordonnées x et y du centre du symbole (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de centre - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous fait passer
**le symbole de sa coordonnée d'origine (x, y)
**à (x/2, y/2).
*/

PROCEDURE Center IS
  center og_point;
  symbol og_object;
BEGIN
  symbol := og_get_object('symbole');
  center := og_get_center(symbol);
  center.x := center.x/2;
  center.y := center.y/2;
  og_set_center(symbol, center);

END;


Propriété d'index

  Exemples	  Rubriques connexes

Description  Index (ou numéro) de la position du symbole tel qu'il figure dans la palette de symboles de Builder.

Syntaxe

PROCEDURE OG_Set_Indx
  (symbol       OG_Object,
   indx         NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Indx
  (symbol  OG_Object)
RETURN NUMBER;

Paramètres

symbol	Objet symbole décrit.
indx	Index (ou numéro) de la position du symbole tel qu'il figure dans la palette de symboles de Builder.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété d'index - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous extrait
**l'index de la position de symbole
**d'un objet dans la palette de symboles,
**et remplace le symbole en cours par
**celui ayant une valeur d'index égale à
**la valeur d'index en cours + 1.
*/

PROCEDURE get_index IS
  sym_index number;
  symbol og_object;
BEGIN
  symbol := og_get_object('symbole');
  sym_index := og_get_indx(symbol);
  og_set_indx(symbol, sym_index+1);
END;


Propriété de taille de symbole

  Exemples	  Rubriques connexes

Description  Taille du symbole. La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Large_Symsize

OG_Medium_Symsize

OG_Small_Symsize

Syntaxe

PROCEDURE OG_Set_Symsize
  (symbol       OG_Object,
   symsize      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Symsize
  (symbol  OG_Object)
RETURN NUMBER;

Paramètres

symbol	Objet symbole décrit.
symsize	Taille du symbole.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de taille de symbole - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la taille
**d'un symbole. Si elle n'est pas LARGE,
**elle la remplace par LARGE.
**Si elle est LARGE, la procédure
**la remplace par SMALL.
*/

PROCEDURE get_size IS
  sym_size number;
  symbol og_object;
BEGIN
  symbol := og_get_object('symbole');
  sym_size := og_get_symsize(symbol);
  if sym_size != og_large_symsize then
     og_set_symsize(symbol, og_large_symsize);
  else
     og_set_symsize(symbol, og_small_symsize);
  end if;
END;


Propriétés d'horloge

Propriété active

Propriété d'intervalle

Propriété de nom

Propriété de procédure


Propriété active

  Exemples	  Rubriques connexes

Description  Indique si l'horloge est active.

Syntaxe

PROCEDURE OG_Set_Active
  (timer   OG_Timer,
   active  BOOLEAN);

FUNCTION OG_Get_Active
  (timer  OG_Timer)
RETURN BOOLEAN;

Paramètres

timer	Objet horloge décrit.
Active	Indique si l'horloge est active.


Propriété active - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous définit l'horloge à
**inactive si elle est active.
*/

PROCEDURE TimerActive IS

  val boolean;

  timer og_timer;

BEGIN

  timer := og_get_timer('horloge2');

  val := og_get_active(timer);

  if val then

    og_set_active(timer, false);

  end if;

END;


Propriété d'intervalle

  Exemples	  Rubriques connexes

Description  Nombre de secondes qui devront s'écouler entre deux exécutions de la procédure horloge.

Syntaxe

PROCEDURE OG_Set_Interval
  (timer     OG_Timer,
   interval  NUMBER);

FUNCTION OG_Get_Interval
  (timer  OG_Timer)
RETURN NUMBER;

Paramètres

timer	Objet horloge décrit.
interval	Nombre de secondes qui devront s'écouler entre deux exécutions de la procédure horloge.


Propriété d'intervalle - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous ajoute 2 secondes
**à l'intervalle initial de
**l'horloge.
*/

PROCEDURE TimerInterval IS

  interval number;

  timer og_timer;

BEGIN

  timer := og_get_timer('horloge2');

  interval := og_get_interval(timer);

  og_set_interval(timer, interval+2);

END;


Propriété de nom

  Exemples	  Rubriques connexes

Description  Nom de l'horloge.

Syntaxe

PROCEDURE OG_Set_Name
  (timer  OG_Timer,
   name   VARCHAR2);

FUNCTION OG_Get_Name
  (timer  OG_Timer)
RETURN VARCHAR2;

Paramètres

timer	Objet horloge décrit.
name	Nom de l'horloge.


Propriété de nom - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous ajoute
**un '1' au nom d'une horloge.
*/

PROCEDURE TimerName IS

  name varchar2(10);

  timer og_timer;

BEGIN

  timer := og_get_timer('horloge1');

  name := og_get_name(timer);

  og_set_name(timer, name||'1');

END;


Propriété de procédure

  Exemples	  Rubriques connexes

Description  Nom de la procédure qui sera exécutée lorsque l'horloge sera activée.

Syntaxe

PROCEDURE OG_Set_Timerproc
  (timer      OG_Timer,
   timerproc  VARCHAR2);

FUNCTION OG_Get_Timerproc
  (timer  OG_Timer)
RETURN VARCHAR2;

Paramètres

timer	Objet horloge décrit.
timerproc	Nom de la procédure qui sera exécutée lorsque l'horloge sera activée.


Propriété de procédure - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous remplace
**la procédure horloge par "NouvProc" s'il
** s'agit de la procédure horloge en cours.
*/

PROCEDURE TimerProc IS

  name varchar2(20);

  timer og_timer;

BEGIN

  timer := og_get_timer('horloge2');

  name := og_get_timerproc(timer);

  if name != 'NouvProc' then

    og_set_timerproc(timer, 'NouvProc');

  end if;

END;


Propriétés de texte

Propriété de hauteur de boîte englobante

Propriété de largeur de boîte englobante

Propriété de jeu de caractères

Propriété de couleur

Propriété de nombre d'éléments de texte composé

Propriété d'espacement personnalisé

Propriété de boîte englobante fixe

Propriété d'alignement horizontal

Propriété d'origine horizontale

Propriété invisible

Propriété de crénage

Propriété la plus proche

Propriété de point d'origine

Propriété de taille en points

Propriété de boîte englobante pouvant être mise à l'échelle

Propriété de police pouvant être mise à l'échelle

Propriété d'espacement

Propriété de style

Propriété de synthétisation

Propriété de police de caractères

Propriété d'alignement vertical

Propriété d'origine verticale

Propriété de graisse

Propriété de largeur

Propriété de passage automatique à la ligne


Propriété de hauteur de boîte englobante

  Exemples	  Rubriques connexes

Description  Hauteur de la boîte englobante (en unités de présentation).  Lorsque la boîte englobante change, cette propriété est automatiquement mise à jour en fonction de la nouvelle hauteur.  Cette propriété est utilisée pour définir la hauteur uniquement si la propriété Fixed Bounding Box est définie à TRUE.

Syntaxe

(See OG_Set_Text_Size.)

FUNCTION OG_Get_Text_Height
  (text  OG_Object)
RETURN NUMBER;

Paramètres

text	Objet texte décrit.


Propriété de hauteur de boîte englobante - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous double la taille de
**la boîte englobante de l'objet texte.
*/

PROCEDURE BBoxSize IS

  width number;
  height number;
  text og_object;
BEGIN
   text := og_get_object('objet texte');
   width := og_get_text_width(text);
   height := og_get_text_height(text);
   og_set_text_size(text, width*2, height*2);
END;


Propriété de largeur de boîte englobante

  Exemples	  Rubriques connexes

Description  Largeur de la boîte englobante (en unités de présentation).  Lorsque la boîte englobante change, cette propriété est automatiquement mise à jour en fonction de la nouvelle largeur.  Cette propriété est utilisée pour définir la largeur uniquement si la propriété Fixed Bounding Box est définie à TRUE.

Syntaxe

PROCEDURE OG_Set_Text_Size
  (text         OG_Object,
   width        NUMBER,
   height       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Text_Width
  (text  OG_Object)
RETURN NUMBER;

Paramètres

text	Objet texte décrit.
Width	Largeur de la boîte englobante (en unités de présentation).
Height	Hauteur de la boîte englobante (en unités de présentation).
Damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de largeur de boîte englobante - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous double la taille de
**la boîte englobante de l'objet texte.
*/

PROCEDURE BBoxSize IS

  width number;
  height number;
  text og_object;
BEGIN
   text := og_get_object('objet texte');
   width := og_get_text_width(text);
   height := og_get_text_height(text);
   og_set_text_size(text, width*2, height*2);
END;


Propriété de jeu de caractères

  Exemples	  Rubriques connexes

Description  Jeu de caractères de la police.  Les valeurs de ce champ indiquent des jeux de caractères tels que U.S. ASCII, Kanji et Arabic.  Les jeux de caractères n'existent pas tous sur tous les systèmes.  Pour plus d'informations, consultez l'administrateur système ou votre documentation système. La valeur de ce champ peut être l'une des constantes intégrées suivantes :

OG_Us7ascii_Charset

OG_We8dec_Charset

OG_We8hp_Charset

OG_Us8pc437_Charset

OG_We8ebcdic37_Charset

OG_We8ebcdic500_Charset

OG_We8pc850_Charset

OG_D7dec_Charset

OG_F7dec_Charset

OG_S7dec_Charset

OG_E7dec_Charset

OG_Sf7ascii_Charset

OG_Ndk7dec_Charset

OG_I7dec_Charset

OG_Nl7dec_Charset

OG_Ch7dec_Charset

OG_Sf7dec_Charset

OG_We8iso8859p1_Charset

OG_Ee8iso8859p2_Charset

OG_Se8iso8859p3_Charset

OG_Nee8iso8859p4_Charset

OG_Cl8iso8859p5_Charset

OG_Ar8iso8859p6_Charset

OG_El8iso8859p7_Charset

OG_Iw8iso8859p8_Charset

OG_We8iso8859p9_Charset

OG_Ar8asmo708plus_Charset

OG_Ar7asmo449plus_Charset

OG_We8macroman8_Charset

OG_Jvms_Charset

OG_Jeuc_Charset

OG_Jdec_Charset

OG_Sjis_Charset

OG_Jdbcs_Charset

OG_Jhp_Charset

OG_Ksc5601_Charset

OG_Kibm5540_Charset

OG_Kdbcs_Charset

OG_Cgb231380_Charset

OG_Cdbcs_Charset

OG_Big5_Charset

OG_Cns1164386_Charset

Syntaxe

PROCEDURE OG_Set_Font_Charset
  (text         OG_Object,
   charset      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

Paramètres

text	Objet texte décrit.
charset	Jeu de caractères de la police.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de jeu de caractères - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous vérifie
**si le jeu de caractères de l'objet texte sélectionné
**figure dans le jeu de caractères US ASCII. Dans la négative,
**elle attribue le jeu de caractères ASCII à l'objet.
*/

PROCEDURE CharSet (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
setNo number;
BEGIN

     SetNo := OG_get_Font_charset(hitobj,0,0);
     if SetNo != og_US7ASCII_Charset then
        og_set_font_charset(hitobj, og_US7ASCII_charset);
     end if;
END;


Propriété de couleur

  Exemples	  Rubriques connexes

Description  Couleur de l'objet texte.

Syntaxe

PROCEDURE OG_Set_Gcolor
  (text         OG_Object,
   gcolor       VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

Paramètres

text	Objet texte décrit.
Gcolor	Couleur de l'objet texte.
Damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de couleur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**la couleur de l'objet texte en cours.
**Si la couleur est autre que rouge,
**elle la change en rouge.
*/

PROCEDURE color (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
color varchar2(20);
BEGIN
   color := og_get_color(hitobj, 0, 0);
   if color != 'red' then
     og_set_gcolor(hitobj, 'red');
   end if;
END;


Propriété de nombre d'éléments de texte composé

  Exemples	  Rubriques connexes

Description  Nombre d'éléments de texte composé constituant l'objet texte.

Syntaxe

FUNCTION OG_Get_Ctcount
  (text  OG_Object)
RETURN NUMBER;

Paramètres

text	Objet texte décrit.


Propriété de nombre d'éléments de texte composé - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous compte le nombre
**d'éléments de texte composé d'un objet texte.
/*

PROCEDURE CompoundTextCnt IS
  num number;
  text og_object;

BEGIN
  text := og_get_object;
  num := og_get_ctcount(text);
END;


Propriété d'espacement personnalisé

  Exemples	  Rubriques connexes

Description  Espacement personnalisé de l'objet texte (en unités de présentation).  Cette propriété n'est utilisée pour indiquer l'espacement que si la propriété Spacing est définie à espacement personnalisé.

Syntaxe

PROCEDURE OG_Set_Custom
  (text         OG_Object,
   custom       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Custom
  (text  OG_Object)
RETURN NUMBER;

Paramètres

text	Objet texte décrit.
custom	Espacement personnalisé de l'objet texte  (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété d'espacement personnalisé - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous redéfinit
**l'espacement personnalisé au double de sa valeur d'origine.
*/

PROCEDURE CustomSpacing (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
num number;
BEGIN
   num := og_get_custom(hitobj);
   og_set_str(hitobj, 'abc'||num);
   og_set_custom(hitobj, num*2);
END;


Propriété de boîte englobante fixe

  Exemples	  Rubriques connexes

Description  Indique si la boîte englobante de l'objet texte doit rester de taille fixe.  Si cette propriété est définie à TRUE, les valeurs des propriétés Width et Height doivent indiquer la taille de la boîte englobante.

Syntaxe

PROCEDURE OG_Set_Fixed
  (text         OG_Object,
   fixed        BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Fixed
  (text  OG_Object)
RETURN BOOLEAN;

Paramètres

text	Objet texte décrit.
fixed	Indique si la boîte englobante de l'objet texte doit rester de taille fixe.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de boîte englobante fixe - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si la boîte englobante de l'objet texte
**reste de taille fixe.
*/

PROCEDURE FixBBox IS
  val boolean;
  text og_object;
BEGIN
   text := og_get_object('objet texte');
   val := og_get_fixed(text);
   if val  then
      og_set_fixed(text, false);
   else
      og_set_fixed(text, true);
   end if;
END;


Propriété d'alignement horizontal

  Exemples	  Rubriques connexes

Description Alignement horizontal de l'objet texte.  La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Left_Halign

OG_Center_Halign

OG_Right_Halign

Syntaxe

PROCEDURE OG_Set_Halign
  (text         OG_Object,
   halign       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Halign
  (text  OG_Object)
RETURN NUMBER;

Paramètres

text	Objet texte décrit.
halign	Alignement horizontal de l'objet texte.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété d'alignement horizontal - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

Horizontal Alignment

 /*La procédure ci-dessous lit l'alignement horizontal
**et le réajuste.
*/

PROCEDURE Halign IS
  num number:=og_right_halign;
  text og_object;
BEGIN
   text := og_get_object('objet texte');
   num := og_get_halign(text);
   if num = og_left_halign then
     og_set_halign(text, og_center_halign);
   elsif num = og_center_halign then
     og_set_halign(text, og_right_halign);
   elsif num = og_right_halign then
     og_set_halign(text, og_left_halign);
   end if;
END;


Propriété d'origine horizontale

  Exemples	  Rubriques connexes

Description  Position horizontale de l'objet texte par rapport à son point d'origine.  La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Left_Horigin   Indique que le point d'origine se trouve le long du bord gauche de la boîte englobante.

OG_Center_Horigin   Indique que le point d'origine se trouve à égale distance des bords gauche et droit de la boîte englobante.

OG_Right_Horigin   Indique que le point d'origine se trouve le long du bord droit de la boîte englobante.

Syntaxe

PROCEDURE OG_Set_Horigin
  (text         OG_Object,
   horigin      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Horigin
  (text  OG_Object)
RETURN NUMBER;

Paramètres

text	Objet texte décrit.
horigin	Position horizontale de l'objet texte par rapport à son point d'origine.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété d'origine horizontale - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

/*La procédure ci-dessous lit l'origine horizontale
**et la réajuste.
*/

PROCEDURE Horigin IS

  num number;

  text og_object;

BEGIN

   text := og_get_object('objet texte');
   num := og_get_horigin(text);
   if num = og_left_horigin then
     og_set_horigin(text, og_center_horigin);
   elsif num = og_center_horigin then
     og_set_horigin(text, og_rightr_horigin);
   elsif num = og_right_horigin then
     og_set_horigin(text, og_left_horigin);
   end if;
END;


Propriété invisible

  Exemples	  Rubriques connexes

Description  Indique si le texte de l'objet texte doit être invisible, ce qui est utile pour les champs de texte dans lesquels l'utilisateur entre un mot de passe, si celui-ci ne doit pas être vu.

Syntaxe

PROCEDURE OG_Set_Invisible
  (text       OG_Object,
   invisible  BOOLEAN,
   damage         BOOLEAN    :=  TRUE,
   update_bbox    BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Invisible
  (text  OG_Object)
RETURN BOOLEAN;

Paramètres

text	Objet texte décrit.
invisible	Indique si le texte de l'objet texte doit être invisible.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété invisible - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous détermine si
** le texte d'un objet texte est invisible.
** S'il est invisible, elle le rend visible ; s'il est
** visible, elle le rend invisible.
*/

PROCEDURE Invisible IS
  val boolean;
  text og_object;
BEGIN
   text := og_get_object('objet texte');
   val := og_get_invisible(text);
   if val  then
      og_set_invisible(text, false);
   else
      og_set_invisible(text, true);
   end if;
END;


Propriété de crénage

  Exemples	  Rubriques connexes

Description  Indique si la police doit être crénée.  Le crénage est le réglage de l'espace entre deux lettres adjacentes pour améliorer la lisibilité du texte.

Syntaxe

PROCEDURE OG_Set_Font_Kerning
  (text         OG_Object,
   kerning      BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

Paramètres

text	Objet texte décrit.
kerning	Indique si la police doit être crénée.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de crénage - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous active et désactive le
**crénage des caractères pour un objet texte sélectionné.

PROCEDURE kerning (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  val boolean;
BEGIN
  val := og_get_font_kerning(hitobj,0,0);
  if val then
     og_set_font_kerning(hitobj, false);
  else
     og_set_font_kerning(hitobj, true);
  end if;
END;


Propriété la plus proche

  Exemples	  Rubriques connexes

Description  Indique si Graphics Builder doit substituer la police correspondante la plus proche s'il ne trouve pas la police exacte indiquée.  La priorité de recherche de la police la plus proche est caractère, taille en points, style, poids et largeur (dans l'ordre indiqué).

Syntaxe

PROCEDURE OG_Set_Font_Nearest
  (text         OG_Object,
   nearest      BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

Paramètres

text	Objet texte décrit.
nearest	Indique si Graphics Builder doit substituer le police correspondante la plus proche s'il ne trouve pas la police exacte indiquée.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété la plus proche - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous définit les propriétés
**les plus proches à TRUE.
*/

PROCEDURE nearest (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS

BEGIN
     OG_Set_Font_Nearest(hitobj, true);
END;


Propriété de point d'origine

  Rubriques connexes

Description  Coordonnées x et y de l'angle supérieur gauche de l'objet texte (en unités de présentation).

Syntaxe

PROCEDURE OG_Set_Origin
  (text         OG_Object,
   origin       OG_Point,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Origin
  (text  OG_Object)
RETURN OG_Point;

Paramètres

text	Objet texte décrit.
origin	Coordonnées x et y de l'angle supérieur gauche de l'objet texte (en unités de présentation).
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de taille en points

  Exemples	  Rubriques connexes

Description  Taille en points de la police.  Les valeurs de ce champ sont propres au système utilisé.  Pour plus d'informations, consultez l'administrateur système ou votre documentation système.

Syntaxe

PROCEDURE OG_Set_Font_Ptsize
  (text         OG_Object,
   ptsize       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

Paramètres

text	Objet texte décrit.
ptsize	Taille en points de la police.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de taille en points - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit la taille en points de l'objet
**en cours et agrandit l'objet texte au double de sa
**taille initiale.
*/

PROCEDURE ptsize (text og_object)IS
num number;
BEGIN
  num := og_get_font_ptsize(text,0,0);
  og_set_font_ptsize(text, num*2);
END;


Propriété de boîte englobante pouvant être mise à l'échelle

  Exemples	  Rubriques connexes

Description  Indique si la boîte englobante de l'objet texte doit être mise à l'échelle lorsque l'objet texte est mis à l'échelle.

Syntaxe

PROCEDURE OG_Set_Bbscale
  (text         OG_Object,
   bbscale      BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Bbscale
  (text  OG_Object)
RETURN BOOLEAN;

Paramètres

text	Objet texte décrit.
Bbscale	Indique si la boîte englobante de l'objet texte doit être mise à l'échelle lorsque l'objet texte est mis à l'échelle.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de boîte englobante pouvant être mise à l'échelle - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si la boîte englobante de
**l'objet texte est mise à l'échelle lorsque
**l'objet texte est mis à l'échelle.
*/

PROCEDURE Scalebox IS
  val boolean;
  text og_object;
BEGIN
   text := og_get_object('objet texte');
   val := og_get_bbscale(text);
   if val  then
      og_set_bbscale(text, false);
   else
      og_set_bbscale(text, true);
   end if;
END;


Propriété de police pouvant être mise à l'échelle

  Exemples	  Rubriques connexes

Description  Indique si la taille des caractères doit être mise à l'échelle lorsque l'objet texte est mis à l'échelle.  La valeur de cette propriété peut être l'une des suivantes :

Syntaxe

PROCEDURE OG_Set_Fontscale
  (text         OG_Object,
   fontscale    BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Fontscale
  (text  OG_Object)
RETURN BOOLEAN;

Paramètres

text	Objet texte décrit.
fontscale	Indique si la taille des caractères doit être mise à l'échelle lorsque l'objet texte est mis à l'échelle.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de police pouvant être mise à l'échelle - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous vérifie si la taille en points des caractères
** est mise à l'échelle lorsque l'objet texte est mis à l'échelle.
*/

PROCEDURE Scalable IS
  val boolean;
  text og_object;
BEGIN
   text := og_get_object('objet texte');
   val := og_get_fontscale(text);
   if val  then
      og_set_fontscale(text, false);
   else
      og_set_fontscale(text, true);
   end if;
END;


Propriété d'espacement

  Exemples	  Rubriques connexes

Description  Interligne de l'objet texte.  La valeur de cette propriété peut être l'une des constantes intégrées indiquées ci-dessous.  Si l'espacement personnalisé est défini, la valeur de la propriété Custom Spacing doit indiquer la valeur d'espacement exacte.

OG_Single_Space

OG_Onehalf_Space

OG_Double_Space

OG_Custom_Space   Indique que le texte est en espacement personnalisé.  L'espacement réel utilisé est défini par la propriété Custom Spacing.

Syntaxe

PROCEDURE OG_Set_Spacing
  (text         OG_Object,
   spacing      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Spacing
  (text  OG_Object)
RETURN NUMBER;

Paramètres

text	Objet texte décrit.
spacing	Interligne de l'objet texte.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété d'espacement - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure bouton ci-dessous
**fait pivoter la définition d'espacement
**d'un objet texte.
*/

PROCEDURE Spacing (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
num number;
BEGIN
   num := og_get_spacing(hitobj);
   if num = og_single_space then
      og_set_spacing(hitobj, og_onehalf_space);
   elsif num = og_onehalf_space then
   og_set_spacing(hitobj, og_double_space);
   elsif num = og_double_space then
   og_set_spacing(hitobj, og_custom_space);
   elsif num = og_custom_space then
   og_set_spacing(hitobj, og_single_space);
   end if;
END;


Propriété de style

  Exemples	  Rubriques connexes

Description  Style de la police.  Les styles ne sont pas tous disponibles sur tous les systèmes.  Pour plus d'informations, consultez l'administrateur système ou votre documentation système.  La valeur de ce champ peut être l'une des constantes intégrées suivantes :

OG_Blink_Fontstyle

OG_Inverted_Fontstyle

OG_Italic_Fontstyle

OG_Oblique_Fontstyle

OG_Outline_Fontstyle

OG_Overstrike_Fontstyle

OG_Plain_Fontstyle

OG_Shadow_Fontstyle

OG_Underline_Fontstyle

OG_Unknown_Fontstyle   Indique que le style est inconnu.  Vous ne pouvez pas définir de style à cette valeur. Cependant, cette valeur est retournée si vous extrayez une police dont Graphics Builder ne peut pas déterminer le style.

Syntaxe

PROCEDURE OG_Set_Font_Style
  (text         OG_Object,
   style        NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

Paramètres

text	Objet texte décrit.
Style	Style de la police.
Damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de style - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous
**fait pivoter le style du texte
*/

PROCEDURE style (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
text og_object;
num number;
BEGIN
  text := og_get_object('objet texte');
  num := og_get_font_style(text,0,0);
  if num = og_blink_fontstyle then
    og_set_font_style(text, og_inverted_fontstyle);
  elsif num = og_inverted_fontstyle then
    og_set_font_style(text, og_italic_fontstyle);
  elsif num = og_italic_fontstyle then
    og_set_font_style(text, og_oblique_fontstyle);
  elsif num = og_oblique_fontstyle then
    og_set_font_style(text, og_outline_fontstyle);
  elsif num = og_outline_fontstyle then
    og_set_font_style(text, og_overstrike_fontstyle);
  elsif num = og_overstrike_fontstyle then
    og_set_font_style(text, og_plain_fontstyle);
  elsif num = og_plain_fontstyle then
    og_set_font_style(text, og_shadow_fontstyle);
  elsif num = og_shadow_fontstyle then
    og_set_font_style(text, og_underline_fontstyle);
  elsif num = og_underline_fontstyle then
    og_set_font_style(text, og_unknown_fontstyle);
  elsif num = og_unknown_fontstyle then
    og_set_font_style(text, og_blink_fontstyle);
  end if;
END;


Propriété de synthétisation

  Exemples	  Rubriques connexes

Description  Indique si Graphics Builder doit tenter de synthétiser la police voulue (si la police indiquée est introuvable) en transformant la police la plus proche au niveau correspondant.

Syntaxe

PROCEDURE OG_Set_Font_Synthesize
  (text         OG_Object,
   synthesize   BOOLEAN,
   damage       BOOLEAN  :=  TRUE,
   update_bbox  BOOLEAN  :=  TRUE);

Paramètres

text	Objet texte décrit.
Synthesize	Indique si Graphics Builder doit tenter de synthétiser la police voulue (si la police indiquée est introuvable) en transformant la police la plus proche au niveau correspondant.
Damage	Indicateur de dommage.
Update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de synthétisation - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous définit les
** propriétés de synthétisation à TRUE.
*/

PROCEDURE synthesize (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS

BEGIN
     OG_Set_Font_Synthesize(hitobj, true);
END;


Propriété de police de caractères

  Exemples	  Rubriques connexes

Description  Type de police (nom de la police).  Les valeurs de ce champ sont propres au système utilisé et peuvent comprendre des polices comme Times, Courier et Helvetica.  Pour plus d'informations, consultez l'administrateur système ou votre documentation système.

Syntaxe

PROCEDURE OG_Set_Font_Typeface
  (text         OG_Object,
   typeface     VARCHAR2,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

Paramètres

text	Objet texte décrit.
Typeface	Type de police (nom de la police).
Damage	Indicateur de dommage.
Update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de police de caractères - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

*/La procédure ci-dessous lit
**le type de caractère de l'objet texte
**sélectionné. Si le style n'est pas le
**même que celui de l'argument,
**elle attribue un nouveau style à
**l'objet texte.
*/

PROCEDURE fonttypeface (text og_object, typeface varchar2)IS
style varchar2(10);
BEGIN
  style := og_get_font_typeface(text, 0,0);
  if style != typeface then
    og_set_font_typeface(text, typeface);
  end if;
END;


Propriété d'alignement vertical

  Exemples	  Rubriques connexes

Description  Alignement vertical de l'objet texte.  La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Top_Valign

OG_Middle_Valign

OG_Bottom_Valign

Syntaxe

PROCEDURE OG_Set_Valign
  (text         OG_Object,
   valign       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Valign
  (text  OG_Object)
RETURN NUMBER;

Paramètres

text	Objet texte décrit.
valign	Alignement vertical de l'objet texte.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété d'alignement vertical - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* La procédure ci-dessous lit l'alignement
** vertical et le réajuste.
*/

PROCEDURE VAligin IS
  num number;
  text og_object;
BEGIN
   text := og_get_object('objet texte');
   num := og_get_valign(text);
   if num = og_top_valign then
     og_set_valign(text, og_middle_valign);
   elsif num = og_middle_valign then
     og_set_valign(text, og_bottom_valign);
   elsif num = og_bottom_valign then
     og_set_valign(text, og_top_valign);
   end if;
END;


Propriété d'origine verticale

  Exemples	  Rubriques connexes

Description  Position verticale de l'objet texte par rapport à son point d'origine.  La valeur de cette propriété peut être l'une des constantes intégrées suivantes :

OG_Top_Vorigin   Indique que le point d'origine se trouve le long du bord supérieur de la boîte englobante.

OG_Middle_Vorigin   Indique que le point d'origine se trouve à égale distance entre les bords supérieur et inférieur de la boîte englobante.

OG_Bottom_Vorigin   Indique que le point d'origine se trouve le long du bord inférieur de la boîte englobante.

Syntaxe

PROCEDURE OG_Set_Vorigin
  (text         OG_Object,
   vorigin      NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Vorigin
  (text  OG_Object)
RETURN NUMBER;

Paramètres

text	Objet texte décrit.
vorigin	Position verticale de l'objet texte par rapport à son point d'origine.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété d'origine verticale - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous lit
**l'origine verticale et la réajuste.
*/

PROCEDURE Vorigin IS
  num number;
  text og_object;
BEGIN
   text := og_get_object('objet texte');
   num := og_get_vorigin(text);
   if num = og_top_vorigin then
     og_set_vorigin(text, og_middle_vorigin);
   elsif num = og_middle_vorigin then
     og_set_vorigin(text, og_bottom_vorigin);
   elsif num = og_bottom_vorigin then
     og_set_vorigin(text, og_top_vorigin);
   end if;
END;


Propriété de graisse

  Exemples	  Rubriques connexes

Description  Graisse de la police. Les graisses ne sont pas toutes disponibles sur tous les systèmes.  Pour plus d'informations, consultez l'administrateur système ou votre documentation système.  La valeur de ce champ peut être l'une des constantes intégrées suivantes :

OG_Bold_Fontweight

OG_Demibold_Fontweight

OG_Demilight_Fontweight

OG_Extrabold_Fontweight

OG_Extralight_Fontweight

OG_Light_Fontweight

OG_Medium_Fontweight

OG_Ultrabold_Fontweight

OG_Ultralight_Fontweight

OG_Unknown_Fontweight   Indique que la graisse est de type inconnu.  Vous ne pouvez pas définir une graisse à cette valeur. Cependant, cette valeur est retournée si vous extrayez une police dont Graphics Builder ne peut pas déterminer la graisse.

Syntaxe

PROCEDURE OG_Set_Font_Weight
  (text         OG_Object,
   weight       NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

Paramètres

text	Objet texte décrit.
Weight	Graisse de la police.
Damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de graisse - Exemples

  Alphabetic List          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous
**fait pivoter la graisse de la police
**d'un objet texte sélectionné.
*/

PROCEDURE weight (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  num number;
  text og_object;
BEGIN
  text := og_get_object('objet texte');
  num := og_get_font_weight(text,0,0);
  if num = og_bold_fontweight then
    og_set_font_weight(text, og_demibold_fontweight);
  elsif num = og_demibold_fontweight then
    og_set_font_weight(text, og_demilight_fontweight);
  elsif num = og_demilight_fontweight then
    og_set_font_weight(text, og_extrabold_fontweight);
  elsif num = og_extrabold_fontweight then
    og_set_font_weight(text, og_extralight_fontweight);
  elsif num = og_extralight_fontweight then
    og_set_font_weight(text, og_light_fontweight);
  elsif num = og_light_fontweight then
    og_set_font_weight(text, og_medium_fontweight);
  elsif num = og_medium_fontweight then
    og_set_font_weight(text, og_ultrabold_fontweight);
  elsif num = og_ultrabold_fontweight then
    og_set_font_weight(text, og_ultralight_fontweight);
  elsif num = og_ultralight_fontweight then
    og_set_font_weight(text, og_unknown_fontweight);
  elsif num = og_unknown_fontweight then
    og_set_font_weight(text, og_bold_fontweight);
  end if;
END;


Propriété de largeur

  Exemples	  Rubriques connexes

Description  Largeur de la police.  Les largeurs ne sont pas toutes disponibles sur tous les systèmes.  Pour plus d'informations, consultez l'administrateur système ou votre documentation système.  La valeur de ce champ peut être l'une des constantes intégrées suivantes :

OG_Dense_Fontwidth

OG_Expand_Fontwidth

OG_Extradense_Fontwidth

OG_Extraexpand_Fontwidth

OG_Normal_Fontwidth

OG_Semidense_Fontwidth

OG_Semiexpand_Fontwidth

OG_Ultradense_Fontwidth

OG_Ultraexpand_Fontwidth

OG_Unknown_Fontwidth   Indique que la largeur est de type inconnu.  Vous ne pouvez pas définir une graisse à cette valeur. Cependant, cette valeur est retournée si vous extrayez une police dont Graphics Builder ne peut pas déterminer la graisse.

Syntaxe

PROCEDURE OG_Set_Font_Width
  (text         OG_Object,
   width        NUMBER,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

Paramètres

text	Objet texte décrit.
Width	Largeur de la police.
Damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de largeur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure bouton ci-dessous
**fait pivoter la largeur de la police
**de l'objet texte sélectionné.
*/

PROCEDURE width (buttonobj IN og_object,
                         hitobj IN og_object,
                         win IN og_window,
                         eventinfo IN og_event) IS
  num number;
  text og_object;
BEGIN
  text := og_get_object('objet texte');
  num := og_get_font_width(text,0,0);
  if num = og_dense_fontwidth then
    og_set_font_width(text, og_expand_fontwidth);
  elsif num = og_expand_fontwidth then
    og_set_font_width(text, og_extradense_fontwidth);
  elsif num = og_extradense_fontwidth then
    og_set_font_width(text, og_extraexpand_fontwidth);
  elsif num = og_extraexpand_fontwidth then
    og_set_font_width(text, og_normal_fontwidth);
  elsif num = og_normal_fontwidth then
    og_set_font_width(text, og_semidense_fontwidth);
  elsif num = og_semidense_fontwidth then
    og_set_font_width(text, og_semiexpand_fontwidth);
  elsif num = og_semiexpand_fontwidth then
    og_set_font_width(text, og_ultradense_fontwidth);
  elsif num = og_ultradense_fontwidth then
    og_set_font_width(text, og_ultraexpand_fontwidth);
  elsif num = og_ultraexpand_fontwidth then
    og_set_font_width(text, og_unknown_fontwidth);
  elsif num = og_unknown_fontwidth then
    og_set_font_width(text, og_dense_fontwidth);
  end if;
END;


Propriété de passage automatique à la ligne

  Exemples	  Rubriques connexes

Description  Indique si le texte doit passer à la ligne pour tenir dans la boîte englobante de l'objet texte.  Comme décrit ci-dessous, un élément de texte composé représente une ligne de texte et se compose d'éléments de texte simple.

Syntaxe

PROCEDURE OG_Set_Wrap
  (text         OG_Object,
   wrap         BOOLEAN,
   damage       BOOLEAN    :=  TRUE,
   update_bbox  BOOLEAN    :=  TRUE);

FUNCTION OG_Get_Wrap
  (text  OG_Object)
RETURN BOOLEAN;

Paramètres

text	Objet texte décrit.
wrap	Indique si le texte doit passer à la ligne pour tenir dans la boîte englobante de l'objet texte.
damage	Indicateur de dommage.
update_bbox	Indicateur de mise à jour de boîte englobante.


Propriété de passage automatique à la ligne - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous vérifie si le texte passe
** automatiquement à la ligne dans la boîte englobante de texte.
*/

PROCEDURE wrap IS
  val boolean;
  text og_object;
BEGIN
   text := og_get_object('objet texte');
   val := og_get_wrap(text);
   if val  then
      og_set_wrap(text, false);
   else
      og_set_wrap(text, true);
   end if;
END;


Aucune entrée ne commence par cette lettre.


Propriétés de fenêtre

Description

La position et les dimensions des fenêtres sont exprimées en "unités de résolution d'écran", plus couramment appelées pixels. Vous pouvez obtenir les valeurs verticales et horizontales de résolution d'écran en utilisant les procédures internes OG_Get_Ap_Hscreen_Res et OG_Get_Ap_Vscreen_Res.

Vous devrez utiliser ces procédures internes au lieu d'une valeur numérique réelle pour que votre application reste cohérente sur les systèmes ayant des résolutions d'écran différentes.

Propriété de hauteur

Propriété de cible d'aide

Propriété de nom

Propriété de position

Propriété de largeur


Propriété de hauteur

  Exemples	  Rubriques connexes

Description  Hauteur de la fenêtre (en unités de résolution d'écran).

Syntaxe

(See OG_Set_Window_Size.)

FUNCTION OG_Get_Window_Height
  (window  OG_Window)
RETURN NUMBER;

Paramètres

window	Fenêtre décrite.


Propriété de hauteur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /* /*La procédure ci-dessous redonne à la fenêtre une dimension
**inférieure de moitié à sa taille d'origine.
*/

PROCEDURE WinSize IS
  window og_window;
  width number;
  height number;
BEGIN
  window := og_get_window('Présentation principale');
  width := og_get_window_width(window);
  height := og_get_window_height(window);
  og_set_window_size(window, width/2,height/2);
END;


Propriété de cible d'aide

  Exemples	  Rubriques connexes

Description  Cible hypertext de document Aide runtime qui est affiché si le système d'aide est appelé alors que la fenêtre est active.

Syntaxe

PROCEDURE OG_Set_Helptarget
  (window      OG_Window,
   helptarget  VARCHAR2);

FUNCTION OG_Get_Helptarget
  (window  OG_Window)
RETURN VARCHAR2;

Paramètres

window	Fenêtre décrite.
helptarget	Cible hypertext de document Aide runtime qui est affiché si le système d'aide est appelé alors que la fenêtre est active.


Propriété de cible d'aide - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous définit la cible d'aide à
** 'NouvCible' si "Nouvelle Cible" n'est pas
** la cible d'aide en cours.
*/

PROCEDURE Help IS
  window og_window;
  help varchar2(20);
BEGIN
  window := og_get_window('Présentation principale');
  help :=  og_get_helptarget(window);
  if help != ' NouvCible ' then
    og_set_helptarget(window, 'NouvCible');
  end if;
END;


Propriété de nom

  Exemples	  Rubriques connexes

Description  Nom de la fenêtre. Lors de l'exécution, le nom par défaut de la fenêtre de présentation est "Présentation principale".

Syntaxe

PROCEDURE OG_Set_Name
  (window  OG_Window,
   name    VARCHAR2);

FUNCTION OG_Get_Name
  (window  OG_Window)
RETURN VARCHAR2;

Paramètres

window	Fenêtre décrite.
name	Nom de la fenêtre.


Propriété de nom - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous redéfinit
**le nom de la fenêtre s'il n'est pas
**'Présentation principale'.
*/

PROCEDURE Name IS
  window og_window;
  name varchar2(20);
BEGIN
  window := og_get_window('Présentation principale');
  name :=  og_get_name(window);
  if name != 'Présentation principale' then
    og_set_name(window, 'Présentation principale');
  end if;
END;


Propriété de position

  Exemples	  Rubriques connexes

Description  Coordonnées x et y de l'angle supérieur gauche de la fenêtre (en unités de résolution d'écran).

Syntaxe

PROCEDURE OG_Set_Position
  (window    OG_Window,
   position  OG_Point);

FUNCTION OG_Get_Position
  (window  OG_Window)
RETURN OG_Point;

Paramètres

window	Fenêtre décrite.
position	Coordonnées x et y de l'angle supérieur gauche de la fenêtre (en unités de résolution d'écran).


Propriété de position - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous repositionne
**la fenêtre.
*/

PROCEDURE Position IS
  window og_window;
  pos og_point;
BEGIN
  window := og_get_window('Présentation principale');
  pos := og_get_position(window);
  pos.x := pos.x*2;
  pos.y := pos.y*2;
  og_set_position(window, pos);
END;


Propriété de largeur

  Exemples	  Rubriques connexes

Description  Largeur de la fenêtre (en unités de résolution d'écran).

Syntaxe

PROCEDURE OG_Set_Window_Size
  (window  OG_Window,
   width   NUMBER,
   height  NUMBER);

FUNCTION OG_Get_Window_Width
  (window  OG_Window)
RETURN NUMBER;

Paramètres

window	Fenêtre décrite.
width	Largeur de la fenêtre (en unités de résolution d'écran).
height	Hauteur de la fenêtre (en unités de résolution d'écran).


Propriété de largeur - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

 /*La procédure ci-dessous redonne à la fenêtre
** une dimension inférieure de moitié à sa taille d'origine.
*/

PROCEDURE WinSize IS
  window og_window;
  width number;
  height number;
BEGIN
  window := og_get_window('Présentation principale');
  width := og_get_window_width(window);
  height := og_get_window_height(window);
  og_set_window_size(window, width/2,height/2);
END;


 Résolution des problèmes

Vous trouverez ci-dessous, classés en ordre numérique, les messages d'erreur et les exceptions, ainsi que les explications correspondantes. Les sujets traités sont les suivants :

conditions anormales

messages d'erreur de Graphics Builder

exceptions de Graphics Builder

codes de message d'erreur

recours au Support technique Oracle


Messages d'erreur de Graphics Builder

La présente section décrit, classés en ordre de numéros de code, les messages d'erreur de Graphics Builder.

OG-00001 :	Erreur(s) de compilation par lots

 Cause :	Vous avez tenté d'exécuter un affichage dans le débogueur PL/SQL mais Graphics Builder a détecté une erreur pendant l'exécution d'une compilation par lots des unités de programme de l'affichage.

 Action :	Affichez le compilateur par lots, puis corrigez les erreurs PL/SQL indiquées.

OG-00002 :	Procédure bouton non trouvée

 Cause :	Vous avez associé une procédure bouton à un objet ou à une couche, mais Graphics Builder n'a pas pu trouver de procédure de ce nom.

 Action :	Si la procédure n'existe pas, créez-la. Vérifiez également l'orthographe du nom de la procédure.

OG-00005 :	Erreur(s) de cohérence d'unité de programme

 Cause :	Vous avez tenté d'exécuter un affichage contenant des erreurs de cohérence.

 Action :	Affichez le vérificateur de cohérence et exécutez un contrôle de cohérence, puis corrigez les erreurs indiquées.

OG-00006 :	Un paramètre a été tronqué

 Cause :	Vous avez attribué une valeur de plus de 2000 octets de long à un paramètre de type CHAR.

 Action :	Un paramètre CHAR ne peut pas avoir plus de 2000 octets de long.

OG-00030 :	Spécification d'unité de programme non valide

 Cause :	Vous avez tenté d'appliquer une unité de programme comportant une spécification non valide.

 Action :	Insérez un en-tête valide, puis recommencez.

OG-00032 :	Nom d'unité de programme PL/SQL dupliqué

 Cause :	Vous avez tenté de créer une unité de programme à laquelle vous avez donné le même nom qu'une unité de programme existante.

 Action :	Donnez à vos unités de programme des noms uniques.

OG-00057 :	Procédure déclencheur non trouvée

 Cause :	Vous avez associé une procédure à un déclencheur, mais Graphics Builder n'a pas pu trouver de procédure de ce nom.

 Action :	Si la procédure n'existe pas, créez-la. Vérifiez également l'orthographe du nom de la procédure.

OG-00064 :	Echec d'extrapolation de paramètre d'unité de programme

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00066 :	Echec enregistrement connexion base de données dans PL/SQL

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00068 :	Echec enregistrement liste bibliothèques PL/SQL attachées

 Cause :	Graphics Builder a détecté une erreur lorsqu'il a tenté d'enregistrer la liste des bibliothèques PL/SQL attachées.

 Action :	Pour un enregistrement dans une base de données, assurez-vous que les tables de Graphics Builder sont correctement installées. Pour l'enregistrement dans un fichier, assurez-vous que vous avez les autorisations d'écriture correspondantes, qu'il y a suffisamment de place sur le disque et qu'il n'existe pas d'autres conditions qui vous empêcheraient d'enregistrer un fichier.

OG-00069 :	Echec chargement liste bibliothèques PL/SQL attachées

 Cause :	Graphics Builder a détecté une erreur lorsqu'il a tenté de charger la liste des bibliothèques PL/SQL attachées.

 Action :	Pour un enregistrement à partir d'une base de données, vérifiez l'installation des tables de Graphics Builder. Pour le chargement à partir d'un fichier, assurez-vous que vous avez les autorisations de lecture correspondantes, que vous avez accès aux bibliothèques en question (par exemple, qu'elles sont dans le répertoire courant ou dans le répertoire indiqué par la variable d'environnement ORAPLSQLLOADPATH) et qu'il n'existe pas d'autres conditions qui vous empêcheraient de lire un fichier.

OG-00070 :	Echec suppression liste bibliothèques PL/SQL attachées

 Cause :	Graphics Builder a détecté une erreur lorsqu'il a tenté de supprimer la liste des bibliothèques PL/SQL attachées.

 Action :	Vérifiez l'installation des tables de Graphics Builder.

OG-00071 :	L'affichage contient des unités de programme non compilées

 Cause :	Vous avez tenté d'exécuter un affichage contenant des unités de programme non compilées.

 Action :	Compilez toutes les unités de programme, puis enregistrez ou générez l'affichage avant de l'exécuter.

OG-00072 :	Echec chargement unité de programme

 Cause :	Graphics Builder a détecté une erreur lorsqu'il a tenté de charger une unité de programme.

 Action :	Assurez-vous que toutes les tables de base de données ou les autres unités de programme auxquelles fait référence l'unité de programme sont accessibles, et vérifiez l'installation des tables de Graphics Builder.

OG-00076 :	Une ou plusieurs unités de programme PL/SQL trop importante(s) pour être codée(s)

 Cause :	Vous avez tenté d'enregistrer un affichage contenant une ou plusieurs unités de programme qui dépassent la taille maximum de blocs de mémoire contigus autorisée pour votre système.

 Action :	Découpez vos unités de programmes en unités plus petites. Pour plus d'informations sur les contraintes de mémoire de votre système, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

OG-00078 :	Impossible de créer des point d'arrêt

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00079 :	Simulation d'exécution interrompue

 Cause :	Vous avez annulé une opération avant de passer à la simulation d'exécution.

OG-00077 :	Une ou plusieurs unités de programme PL/SQL trop importante(s) pour être décodée(s)

 Cause  :	Vous avez tenté d'ouvrir un affichage contenant une ou plusieurs unités de programme qui dépassent la taille maximum de blocs de mémoire contigus autorisée pour votre système.

 Action :	Ouvrez l'affichage sur le système sur lequel il a été créé et découpez vos unités de programmes en unités plus petites. Pour plus d'informations sur les contraintes de mémoire de votre système, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

OG-00401 :	Aucun nom d'horloge spécifié

 Cause :	Vous avez tenté d'appliquer des modifications dans la boîte de dialogue Déclencheurs d'horloge, mais le champ de texte Renommer a été laissé en blanc.

 Action :	Entrez un nom d'horloge dans le champ de texte Renommer ou supprimez l'horloge.

OG-00402 :	Nom d'horloge spécifié dupliqué

 Cause :	Vous avez tenté d'appliquer des modifications dans la boîte de dialogue Déclencheurs d'horloge, mais le nom que vous avez indiqué pour l'horloge sélectionnée est celui d'une autre horloge.

 Action :	Entrez dans le champ de texte Renommer un nom d'horloge unique.

OG-00403 :	Nom de document spécifié dupliqué

 Cause :	Au cours d'une session Graphics Builder, vous avez tenté d'exécuter l'une des opérations suivantes :

A.	Ouverture, dans le Builder, d'un affichage déjà ouvert.

B.	Ouverture, dans la simulation d'exécution, d'un affichage déjà ouvert.

C.	Ouverture, dans l'exécutable Runtime, d'un affichage déjà ouvert.

 Action :	Au cours d'une même session Graphics Builder, vous ne pouvez exécuter qu'une fois l'une des opérations d'ouverture ci-dessus sur l'affichage sélectionné.

OG-00406 :	Aucun nom de son spécifié

 Cause :	Vous avez tenté d'appliquer des modifications dans la boîte de dialogue Sons, mais vous avez laissé en blanc le champ de texte Renommer.

 Action :	Entrez un son dans le champ de texte Renommer ou supprimez le son.

OG-00407 :	Nom de son dupliqué

 Cause :	Vous avez tenté d'appliquer des modifications dans la boîte de dialogue Sons, mais vous avez sélectionné un nom qui existait déjà.

 Action :	Donnez à l'horloge un nom de son unique en l'entrant dans le champ de texte Renommer.

OG-00408 :	Intervalle horloge spécifié égal à zéro

 Cause :	Vous avez tenté d'appliquer des modifications dans la boîte de dialogue Déclencheurs d'horloge, mais l'intervalle de l'horloge sélectionnée est défini à 0 minute 0 seconde.

 Action :	Entrez des valeurs valides dans les champs de texte Intervalle ou supprimez l'horloge.

OG-00409 :	Pas de procédure spécifiée pour l'horloge

 Cause :	Vous avez tenté d'appliquer des modifications dans la boîte de dialogue Déclencheurs d'horloge, mais le champ de texte Procédure a été laissé en blanc.

 Action :	Entrez le nom d'une procédure de déclencheur PL/SQL dans le champ de texte Procédure ou supprimez l'horloge.

OG-00410 :	Impossible de créer l'horloge

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00411 :	Affichage Designer non trouvé

 Cause :	A partir d'un affichage de simulation d'exécution, vous avez tenté de synchroniser des unités de programme sur l'affichage de Builder, mais cet affichage était introuvable.

 Action :	Assurez-vous que l'affichage Builder est ouvert et que vous n'avez pas modifié son nom depuis sa dernière exécution.

OG-00412 :	Plusieurs noeuds sélectionnés

 Cause :	Vous avez sélectionné plusieurs noeuds dans le Navigateur d'objet, puis tenté une opération qui demandait qu'un seul noeud soit sélectionné.

 Action :	Sélectionnez un seul noeud, puis tentez à nouveau d'exécuter l'opération.

OG-00413 :	Pas d'affichage sélectionné

 Cause :	Vous avez tenté une opération qui demandait qu'un affichage soit sélectionné, alors qu'aucun affichage n'était sélectionné.

 Action :	Sélectionnez un affichage, puis recommencez.

OG-00414 :	Cet affichage est déjà en exécution

 Cause :	Vous avez tenté d'exécuter un affichage en simulation d'exécution, mais cet affichage était déjà en cours d'exécution.

 Action :	Sélectionnez un autre affichage ou fermez l'affichage en cours d'exécution.

OG-00415 :	Nom de paramètre dupliqué spécifié

 Cause :	Vous avez tenté de créer un paramètre en indiquant un nom déjà utilisé par un autre paramètre.

 Action :	Utilisez un nom unique pour le paramètre.

OG-00416 :	Pas de nom de paramètre spécifié

 Cause :	Vous avez tenté de créer un paramètre sans indiquer de nom.

 Action :	Indiquez un nom de paramètre.

OG-00505 :	Erreur compte de liste

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00507 :	Type d'interrogation non valide

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00508 :	Modèle de graphique non trouvé

 Cause :	Vous avez tenté de mettre un graphique à jour, mais le modèle de graphique sur lequel il est basé n'a pas pu être trouvé. Causes possibles :

A.	Vous avez supprimé le modèle de graphique.

B.	Vous avez renommé le modèle de graphique.

 Action :	Pour modifier le modèle sur lequel est basé le graphique, sélectionnez un nouveau modèle dans la boîte de dialogue Propriétés des graphiques du graphique. En outre, vous pouvez exécuter l'une des opérations ci-dessous, ou les deux :

A.	Créer un nouveau modèle de graphique ayant le même nom que le modèle supprimé.

B.	Donner au modèle de graphique le nom attendu par le graphique.

OG-00511 :	Pas de modèle de graphique spécifié

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00512 :	Pas d'interrogation spécifiée

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00513 :	L'interrogation n'a pas de données

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00514 :	Pas de pointeur de document spécifié

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00516 :	Echec de chargement de contexte de communication

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00517 :	Echec de chargement d'interface de communication

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00518 :	Echec de transmission de données inter-produit

 Cause :	Un autre produit Oracle a appelé Graphics Builder et demandé la transmission du contenu d'un affichage, mais Graphics Builder a détecté une erreur lorsqu'il a tenté de communiquer avec ce produit.

 Action :	Assurez-vous que Graphics Builder a été appelé en mode synchrone. Assurez-vous également qu'il ne s'est pas produit d'erreur système susceptible d'empêcher la communication entre les produits.

OG-00519 :	Echec connexion de chaîne

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00520 :	Erreur d'intégration - <message>

 Cause :	Il s'est produit une erreur pendant la tentative d'intégration dans un autre produit.

 Action :	Etudiez le message d'erreur, puis reportez-vous à la documentation concernant l'autre produit.

OG-00521 :	Aide non initialisée

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00522 :	Nom d'imprimante non valide

 Cause :	Il s'est produit une erreur pendant la tentative de localisation de l'imprimante.

 Action :	Assurez-vous que l'imprimante est connectée et fonctionne.

OG-00524 :	Aucun nom d'interrogation spécifié

 Cause :	Vous avez tenté de créer une interrogation, mais vous n'avez pas indiqué son nom.

 Action :	Indiquez le nom de l'interrogation.

OG-00525 :	Nom d'interrogation dupliqué spécifié

 Cause :	Vous avez tenté de créer une interrogation en indiquant un nom utilisé par une autre interrogation.

 Action :	Utilisez un nom unique pour l'interrogation.

OG-00528 :	Nom de colonne dupliqué

 Cause :	Vous avez tenté de créer une colonne en indiquant un nom déjà utilisé pour une autre colonne.

 Action :	Utilisez un nom unique pour la colonne.

OG-00529 :	Aucun nom de colonne spécifié

 Cause :	Vous avez tenté de créer une colonne, mais n'avez pas indiqué son nom.

 Action :	Indiquez le nom de la colonne.

OG-00532 :	Impossible de mettre à jour le graphique quand une mise à jour est en cours

 Cause :	Vous avez tenté de mettre à jour un graphique qui était déjà en cours de mise à jour. Il est très probable que vous avez tenté d'exécuter cette opération dans un déclencheur lié au graphique et ayant entraîné une autre mise à jour de graphique.

 Action :	Assurez-vous que vous n'avez pas demandé d'opération entraînant la mise à jour du graphique en cours de mise à jour.

OG-00533 :	Paramètre de descente de niveau non trouvé

 Cause :	Graphics Builder a tenté de définir un paramètre utilisé par un graphique de descente de niveau, mais le paramètre n'existe pas.

 Action :	Assurez-vous que le paramètre existe et est bien attribué au graphique.

OG-00602 :	Echec d'acceptation d'unité de programme

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00604 :	Echec d'annulation d'unité de programme

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00608 :	Impossible d'exécuter la procédure PL/SQL

 Cause :	Graphics Builder a détecté une erreur lors qu'il tentait d'exécuter une procédure PL/SQL.

 Action :	Assurez-vous que la procédure n'a pas été compilée par inadvertance.

OG-00609 :	Erreur interne PL/SQL

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00622 :	Position de paramètre non valide

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00630 :	Echec d'attachement de bibliothèque PL/SQL interne

 Cause :	Graphics Builder a détecté une erreur pendant une tentative d'attachement d'une bibliothèque interne.

 Action :	Si l'affichage est stocké dans la base de données, vérifiez l'installation des tables de Graphics Builder. Si l'affichage est stocké dans un fichier, assurez-vous que le fichier que vous tentez d'ouvrir est un fichier d'affichage valide.

OG-00632 :	Erreur d'insertion de bibliothèque PL/SQL interne

 Cause :	Graphics Builder a détecté une erreur pendant une tentative d'insertion d'une unité de programme dans une bibliothèque.

 Action :	Si l'affichage est stocké dans la base de données, vérifiez l'installation des tables de Graphics Builder. Si l'affichage est stocké dans un fichier, vérifiez la place disponible dans votre système de fichiers.

OG-00633 :	Echec de suppression de bibliothèque PL/SQL interne

 Cause :	Graphics Builder a détecté une erreur pendant une tentative de suppression de bibliothèque interne.

 Action :	Vérifiez l'installation des tables de Graphics Builder.

OG-00637 :	Exception PL/SQL non traitée <numéro_exception>

 Cause :	Graphics Builder a détecté une exception PL/SQL pendant l'exécution d'une unité de programme.

 Action :	Notez le numéro de l'exception qui figure à la fin du message d'erreur, puis reportez-vous au tableau ci-dessous :

Numéros d'exception	Type d'exception	Reportez-vous à

-------------------------------------------------------------------------------------------------------------------------------

0-99999	Oracle/PL/SQL	Oracle7 Server Messages

and Codes Manual

102000-102499	Procédure interne Graphics Builder	Exception PL/SQL

104500-104999	Package TOOL_INT	Exception PL/SQLs

105000-105499	Package TOOL_RES 	Oracle Procedure Builder

Developer's Guide

105500-105999	Package ORA_NLS 	Oracle Procedure Builder

Developer's Guide

300000-300499	Package DEBUG 	Oracle Procedure Builder

Developer's Guide

300500-300999	Package LIST 	Oracle Procedure Builder

Developer's Guide

302000-302499	Package TOOL_ERR 	Oracle Procedure Builder

Developer's Guide

302500-302999	Package TEXT_IO 	Oracle Procedure Builder

Developer's Guide

OG-00801 :	Erreur d'exécution de l'interrogation

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00802 :	Erreur d'exécution de l'interrogation SQL

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-00901 :	Nom de paramètre saisi non valide

 Cause :	Vous avez entré dans la colonne Nom de la table des paramètres un nom de paramètre qui n'était pas valide.

 Action :	Utilisez un nom de paramètre valide.

OG-00902 :	Paramètre saisi non valide

 Cause :	Vous avez entré dans la colonne Type de la table des paramètres un type de paramètre qui n'était pas valide.

 Action :	Entrez l'un des types suivants : CHAR, DATE ou NUMBER.

OG-00903 :	Valeur de paramètre saisi non valide

 Cause :	Vous avez entré dans la colonne Valeur de la table des paramètres une valeur de paramètre qui n'était pas valide.

 Action :	Entrez une valeur valide pour le type de paramètre que vous avez indiqué.

OG-01001 :	Impossible de trouver la ressource attendue

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01002 :	Impossible de trouver la ressource attendue

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01103 :	Echec dialogue son élevé

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01105 :	Impossible de charger l'affichage

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01106 :	Echec d'initialisation de lecture de cache d'enregistrement

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01107 :	Echec de conversion son

 Cause :	Vous avez tenté d'importer ou de créer un son, mais sa conversion à partir de la vitesse d'échantillonnage d'origine et du système de codage a échoué. Il est très probable que votre son est trop fort.

 Action :	Importez ou créez un son plus faible.

OG-01108 :	Impossible de lire depuis le fichier d'importation de son

 Cause :	Vous avez tenté d'importer un son, mais le fichier à importer ne contient pas de données de son valides.

 Action :	Assurez-vous que le fichier contient des données de son valides.

OG-01109 :	Impossible de créer le curseur

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01110 :	Impossible de trouver l'imprimante

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01301 :	Impossible d'ouvrir le fichier de données

 Cause :	Vous avez tenté d'exécuter une interrogation qui extrait ses données d'un fichier que Graphics Builder n'a pas pu ouvrir. Causes possibles :

A.	Le fichier n'existe pas.

B.	Vous n'avez pas les autorisations nécessaires pour ouvrir le fichier.

C.	Une erreur système a empêché Graphics Builder d'ouvrir le fichier.

 Action :	Vous pouvez exécuter une ou plusieurs des actions suivantes :

A.	Créer le fichier nécessaire.

B.	Changer - ou demander à l'administrateur système de changer - vos privilèges.

C.	Consulter la documentation système ou contacter l'administrateur système.

OG-01304 :	Impossible de créer un cache de données

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01305 :	Fichier SYLK non valide

 Cause :	Vous avez défini une interrogation devant faire référence à un fichier SYLK qui n'est pas dans le format voulu.

 Action :	Vérifiez le format et le fichier que vous avez indiqués.

OG-01306 :	Fichier PRN non valide

 Cause :	Vous avez défini une interrogation devant faire référence à un fichier PRN qui n'est pas dans le format voulu.

 Action :	Vérifiez le format et le fichier que vous avez indiqués.

OG-01307 :	Fichier WKS non valide

 Cause :	Vous avez défini une interrogation devant faire référence à un fichier WKS qui n'est pas dans le format voulu.

 Action :	Vérifiez le format et le fichier que vous avez indiqués.

OG-01601 :	Impossible de créer cax au démarrage

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01603 :	Impossible de créer contexte DE

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01604 :	Impossible de créer contexte DE UI

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01605 :	Impossible de créer la fenêtre principale

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01606 :	Impossible de lancer Oracle Ressource Manager

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01607 :	Impossible d'initialiser ZOM

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01610 :	Impossible de créer le compilateur PL/SQL batch

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01613 :	Impossible de créer la fenêtre d'édition de PL/SQL

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01614 :	Echec de création de l'unité de programme PL/SQL

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01615 :	Impossible de créer le contexte d'exécution de l'environnement de développement PL/SQL

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01616 :	Impossible de créer cav au démarrage

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01617 :	Impossible de créer un interpréteur non modal

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01618 :	Impossible de créer l'interpréteur modal PL/SQL

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01619 :	Impossible d'initialiser le gestionnaire d'erreurs

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01620 :	Impossible d'initialiser le stockage objet

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01621 :	Impossible d'initialiser Oracle Image

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01622 :	Impossible d'initialiser Oracle Sound

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01623 :	Impossible d'initialiser Oracle Help

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01625 :	Impossible de définir les attributs de la fenêtre batch

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01626 :	Arguments de l'option de la ligne de commande trop nombreux

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01627 :	Spécification dupliquée pour option de ligne de commande

 Cause :	Vous avez appelé un exécutable Graphics Builder à partir d'une ligne de commande et lui avez transmis des arguments de ligne de commande, mais en utilisant plusieurs fois le même mot-clé.

 Action :	Vous ne pouvez indiquer qu'un mot-clé de ligne de commande dans une ligne de commande. Pour indiquer plusieurs valeurs pour un mot-clé, utilisez une liste de valeurs.

Pour toute information, reportez-vous à "Value Lists" dans le chapitre "Exécutables" de Graphics Builder Reference Manual.

OG-01629 :	Argument de ligne de commande sans mot-clé après le mot-clé de ligne de commande

 Cause :	Vous avez appelé un exécutable Graphics Builder à partir d'une ligne de commande et indiqué un mot-clé et sa valeur, puis une valeur sans mot-clé.

Action :	Si vous indiquez un mot-clé dans une ligne de commande, vous devez indiquer des mots-clés dans tous les arguments suivants de la ligne de commande. Vous ne pouvez omettre les mots-clés que si leurs valeurs sont indiquées dans l'ordre prévu par la syntaxe de l'exécutable et s'ils ne suivent pas un autre argument de la ligne de commande utilisant explicitement son mot-clé.

OG-01630 :	Valeur d'option de ligne de commande non valide

 Cause :	Vous avez appelé un exécutable de Graphics Builder à partir d'une ligne de commande et indiqué pour un mot-clé une valeur non valide.

 Action :	Vous devez indiquer des valeurs de ligne de commande valides.

Pour toute information, reportez-vous à "Value Lists" dans le chapitre "Exécutables" de Graphics Builder Reference Manual.

OG-01631 :	Liste mal formatée dans la ligne de commande

 Cause :	Vous avez appelé un exécutable de Graphics Builder à partir d'une ligne de commande et indiqué plusieurs valeurs pour un mot-clé, alors que la liste des valeurs n'était pas correctement formée.

 Action :	Vous devez entourer une liste de valeurs de parenthèses et faire suivre chaque valeur d'une virgule. Notez que votre système peut imposer des restrictions particulières à l'utilisation des parenthèses et des virgules dans une ligne de commande.

Pour toute information, reportez-vous à "Value Lists" dans le chapitre "Exécutables" de Graphics Builder Reference Manual.

OG-01632 :	Entrée liste non valide dans la ligne de commande

 Cause :	Vous avez indiqué pour un mot-clé d'exécutable une liste de valeurs qui n'autorisait pas les valeurs multiples.

 Action :	N'indiquez pas de valeurs multiples pour les mots-clés qui n'acceptent qu'une valeur.

OG-01633 :	Fichier de commande non trouvé

 Cause :	Graphics Builder n'a pas pu trouver le fichier de commande indiqué par le mot-clé d'exécutable CMDFILE.

 Action :	Assurez-vous que le fichier existe et qu'il est dans un format lisible.

OG-01635 :	Impossible de créer l'explorateur des unités de programme PL/SQL

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01636 :	Impossible de créer l'outil de consultation de bibliothèque

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01638 :	Echec de l'initialisation de SQLLIB

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01639 :	Echec à l'initialisation de l'intégration outils

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01640 :	Impossible de créer la fenêtre de table de données

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01641 :	Impossible de créer la fenêtre de table de paramètres

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01643 :	Impossible de créer la fenêtre modèle de graphique

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01644 :	Impossible de créer la fenêtre de table de données

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01642 :	Impossible de créer la fenêtre modèle de graphique

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01901 :	Erreur de stockage objet générique

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01902 :	Impossible de trouver le niveau à enregistrer

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01903 :	Liste de niveau vide inattendue en mode présentation

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01904 :	Impossible d'ouvrir le stockage de la base de données

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-01905 :	Impossible d'extraire le nom utilisateur

 Cause :	Graphics Builder a détecté une erreur lorsqu'il tentait de résoudre un nom utilisateur inconnu ou non indiqué, en demandant la résolution à partir du serveur. Par exemple, si vous n'avez pas entré de nom utilisateur dans la boîte de dialogue Connexion, Graphics Builder demande au serveur de résoudre un nom utilisateur OPS$.

 Action :	Assurez-vous que le nom utilisateur est enregistré et apparaît dans la table USER_USERS.

OG-02205 :	Ces objets n'appartiennent pas au même groupe

 Cause :	Vous avez tenté de sélectionner simultanément deux objets qui ne sont pas des fils du même objet de groupe.

 Action :	Vous ne pouvez sélectionner plusieurs objets que s'ils sont membres du même groupe.

OG-02207 :	Vous devez sélectionner précisément un groupe

 Cause :	Vous avez sélectionné un ou plusieurs objets isolés ou plusieurs objets d'un groupe, puis tenté de dégrouper les objets, de sélectionner les fils ou un objet d'un groupe.

 Action :	Pour ces opérations, vous devez sélectionner précisément un groupe.

OG-02212 :	L'objet sélectionné n'est pas un groupe

 Cause :	Vous avez sélectionné un objet unique, puis tenté de sélectionner ses fils.

 Action :	Par définition, un objet unique n'a pas de fils. Pour cette opération, vous devez sélectionner précisément un objet de groupe.

OG-02213 :	L'objet n'a pas de père

 Cause :	Vous avez sélectionné un objet, puis tenté de sélectionner son père, mais l'objet n'est pas membre d'un groupe, et n'a donc pas de père.

 Action :	Vous ne pouvez sélectionner le père d'un objet que s'il est membre d'un groupe.

OG-02215 :	Objet non modifiable

 Cause :	Vous avez sélectionné l'outil Remettre en forme, puis un point de contrôle d'un objet qui ne peut pas être remis en forme.

 Action :	Vous ne pouvez pas remettre en forme un symbole, un graphique ou un objet de groupe.

OG-02313 :	Sélectionnez précisément un objet texte à exporter

 Cause :	Vous avez tenté d'exporter une image, mais vous en avez sélectionné plusieurs ou n'en avez sélectionné aucune.

 Action :	Ne sélectionnez qu'une image à exporter.

OG-02502 :	Fichier introuvable ou illisible

Cause :	Vous avez tenté d'ouvrir un fichier que Graphics Builder n'a pas pu trouver ou lire. Causes possibles :

A.	Le fichier n'existe pas.

B.	Vous n'avez pas les autorisations nécessaires pour ouvrir le fichier.

C.	Une erreur système a empêché Graphics Builder d'ouvrir le fichier.

 Action :	Vous pouvez exécuter une ou plusieurs des actions suivantes :

A.	Créer le fichier nécessaire.

B.	Changer - ou demander à l'administrateur système de changer - vos privilèges.

C.	Consulter la documentation système ou contacter l'administrateur système.

OG-02503 :	Impossible d'ouvrir le fichier en écriture

 Cause :	Vous avez tenté d'écrire dans un fichier, mais Graphics Builder a détecté une erreur. Causes possibles :

A.	Vous n'avez pas les privilèges pour écrire dans le fichier.

B.	Une erreur système a empêché Graphics Builder d'écrire dans le fichier.

 Action :	Vous pouvez exécuter une ou plusieurs des actions suivantes :

A.	Changer - ou demander à l'administrateur système de changer - vos privilèges.

B.	Consulter la documentation système ou contacter l'administrateur système.

OG-02505 :	Ouverture impossible de la mémoire de base de données. Il se peut que la base de données ne soit pas configurée correctement

 Cause :	Graphics Builder a détecté une erreur alors qu'il tentait de stocker un module dans la base de données (c'est-à-dire d'enregistrer un affichage, d'exporter un dessin, etc.)

 Action :	Assurez-vous que vous avez les privilèges d'accès nécessaires pour stocker des données dans les tables de Graphics Builder.

OG-02506 :	Impression impossible. Vérifier la configuration d'imprimante

 Cause :	Graphics Builder a détecté une erreur pendant une tentative d'impression.

 Action :	Vérifiez la configuration de votre imprimante et de l'environnement d'impression. Pour plus d'informations, reportez-vous à la documentation système.

OG-02507 :	Ouverture de fichier impossible, ou le fichier n'est pas dans le format indiqué.

 Cause :	Vous avez tenté d'importer un fichier, mais Graphics Builder a détecté une erreur lorsqu'il a tenté d'ouvrir le fichier, ou le fichier n'a pas le format indiqué.

 Action :	Assurez-vous que vous pouvez accéder au fichier et que son format est correct.

OG-02508 :	Document introuvable dans la base de données

 Cause :	Vous avez tenté d'ouvrir un module stocké dans la base de données, mais Graphics Builder n'a pas pu trouver de module de ce nom.

 Action :	Assurez-vous que le module que vous avez indiqué existe dans la base de données et que l'utilisateur a les privilèges nécessaires.

OG-02701-2718 :	Erreur lors de la lecture du fichier CGM

 Cause :	Vous avez tenté d'importer un fichier CGM, mais Graphics Builder a détecté une erreur lorsqu'il a tenté de le lire. Il est probable que le fichier est endommagé ou qu'il n'est pas valide.

 Action :	Assurez-vous que le fichier est un fichier CGM valide.

OG-02801-2806 :	Erreur E/S sur fichier

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-03003 :	Affichage de l'image impossible

 Cause :	Vous avez tenté d'ouvrir un affichage contenant une image dans Builder, mais n'avez pas assez de mémoire pour afficher l'image.

 Action :	Enregistrez votre affichage et quittez Graphics Builder puis, si possible, libérez de la place en mémoire et recommencez l'opération. Pour tout renseignement sur la place occupée en mémoire, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

OG-03101 :	Erreur Oracle Toolkit

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-03501 :	Fichier de ressources introuvable. Vérifiez vos paramètres d'environnement

 Cause :	Graphics Builder n'a pas pu trouver le fichier de ressources nécessaire.

 Action :	Vérifiez la configuration de votre environnement. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

OG-03507 :	Fichier palette de couleurs introuvable. Vérifiez vos paramètres d'environnement

 Cause :	Graphics Builder n'a pas pu trouver le fichier de palette de couleurs par défaut vgid.ros.

 Action :	Vérifiez la configuration de votre environnement. Pour plus d'informations, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

OG-03701-3702 :	Mémoire insuffisante

 Cause :	Graphics Builder a manqué de mémoire.

 Action :	Enregistrez votre affichage et quittez Graphics Builder. Pour tout renseignement sur la place occupée en mémoire, reportez-vous à la documentation Graphics Builder de votre système d'exploitation.

OG-03704 :	Erreur de stockage d'objet

 Cause :	Condition anormale.

 Action :	Pour toute information, reportez-vous à Conditions anormales.

OG-03800-3812 :	Ecriture du fichier CGM impossible

 Cause :	Vous avez tenté d'exporter un dessin en format CGM, mais Graphics Builder a détecté une erreur. Causes possibles :

A.	Vous n'avez pas les privilèges nécessaires pour écrire dans le fichier.

B.	Une erreur système a empêché Graphics Builder d'écrire dans le fichier.

 Action :	Vous pouvez prendre les mesures suivantes :

A.	Changer - ou demander à l'administrateur système de changer - vos privilèges.

B.	Consulter la documentation système ou contacter l'administrateur système.

OG-04001 :	Modèle de champ introuvable dans le modèle graphique

 Cause :	Modèle endommagé.

 Action :	Mettez le graphique à jour ou recréez-le.

OG-04002 :	Colonne non trouvée dans les données interrogées

 Cause :	Vous avez créé un graphique qui reposait sur une interrogation contenant certaines colonnes de données, puis vous avez modifié l'interrogation, ce qui a eu pour effet de supprimer une ou plusieurs colonnes. Lorsque vous avez tenté de mettre le graphique à jour, il a recherché ces colonnes sans pouvoir les trouver.

 Action :	Mettez à jour la correspondance des champs du graphique qui ne doit comporter que les colonnes existant dans l'interrogation.

OG-04003 :	La combinaison minimum/maximum/pas d'axe spécifié est non valide

 Cause :	Vous avez entré une valeur d'axe Minimum supérieure à la valeur Maximum.

 Action :	Entrez une valeur Minimum inférieure à la valeur Maximum, ou sélectionnez Auto pour l'une de ces valeurs, ou les deux.

OG-04004 :	Type de données de colonne non valide pour l'axe correspondant.

 Cause :	Le type de données indiqué dans Graphique->Propriétés d'axe ne

correspond pas au type de données en cours.

 Action :	Vérifiez le type des données du tracé et de la propriété de l'axe.

OG-04005 :	Tracé de valeur négative impossible pour un histogramme

 Cause :	La position de traçage d'un champ du graphique est définie à Empiler, mais l'interrogation contient des données négatives.

 Action :	Vous ne pouvez tracer que des valeurs de données positives dans un graphique empilé.

OG-04006 :	Tracé de données négatives ou nulles impossible en graphique log

 Cause :	Vous avez créé un graphique logarithmique dans lequel l'un des axes utilise une échelle logarithmique, alors que le champ correspondant à cet axe contient des valeurs de données négatives.

 Action :	Vous ne pouvez tracer que des valeurs de données positives le long d'un axe logarithmique.

OG-04007 :	Tracé de données négatives impossible en graphique de pourcentage

 Cause :	L'interrogation sur laquelle repose un graphique de pourcentage contient des valeurs de données négatives.

 Action :	Vous ne pouvez tracer que des valeurs de données positives dans un graphique de pourcentage.

OG-04008 :	Somme, minimum, maximum à zéro en graphique de pourcentage

 Cause :	Vous avez créé un graphique dont les valeurs de données sont tracées sous la forme d'un pourcentage de la somme, du minimum ou du maximum de toutes les valeurs données, mais la somme, le minimum ou le maximum sont nuls.

 Action :	Vous ne pouvez pas calculer de pourcentage si la somme, le minimum ou le maximum sont nuls.

OG-04010 :	Tracé de données négatives impossible en graphique à secteurs

 Cause :	L'interrogation sur laquelle repose un graphique à secteurs contient des valeurs de données négatives.

 Action :	Vous ne pouvez tracer que des valeurs positives dans un graphique à secteurs.

OG-04011 :	La somme des données est supérieure à la valeur totale spécifiée

 Cause :	Vous avez indiqué pour le graphique à secteurs une Valeur totale inférieur à la somme réelle des données de l'interrogation.

 Action :	Donnez à la Valeur totale du graphique à secteurs une valeur supérieure ou égale à la somme réelle des données retournée par l'interrogation.

OG-04012 :	Dépassement de données - essayez une précision différente pour l'axe

 Cause :	Vous avez créé ou mis à jour un graphique contenant un axe de date, mais la plage de données est trop importante. Cette erreur se produit par exemple si les données portent sur un très grand nombre d'années et si les incréments d'axe sont indiqués en secondes.

 Action :	Choisissez une unité plus grande pour les incréments de l'axe, pour réduire le nombre de subdivisions.

OG-04013 :	Les colonnes de la légende ne peuvent pas être à zéro

 Cause :	Vous avez défini à zéro le nombre de colonnes de la légende.

 Action :	Définissez à 1 au moins le nombre de colonnes qui s'affichent dans la légende.

OG-04014 :	Pas de données à tracer

 Cause :	Vous avez tenté de mettre à jour un graphique dont l'interrogation associée n'a pas été exécutée, parce que l'interrogation fait référence à la base de données, alors que la base de données n'est pas connectée, ou qu'un fichier SYLK, WKS ou PRN est introuvable.

 Action :	Assurez-vous que la base de données est connectée ou que le fichier existe.

OG-04015 :	Trop de lignes de données

 Cause :	Vous avez tenté d'exécuter une interrogation qui a retourné davantage de lignes de données que Graphics Builder ne peut en traiter sur votre système.

 Action :	Limitez votre interrogation afin que le nombre de lignes à traiter soit moins élevé.


Graphics Builder - Questions fréquemment posées

Sur la création de graphiques

Sur PL/SQL

Sur le débogage

Sur les performances

Sur l'intégration

Sur le développement en général


 Sur la création de graphiques

Comment faire pour que mon graphique soit mis à jour correctement ?

Peut-on réutiliser des options d'un graphique pour en créer un autre ?

Comment personnaliser les couleurs d'un graphique à secteurs ?

Quand j'importe un dessin dans Graphics Builder, je ne peux pas sélectionner d'objets. Pourquoi ?

Comment supprimer la légende ?

Y-a-t-il une façon d'exporter une présentation sous la forme d'une image ?

Comment faire pivoter les étiquettes ?

Comment donner aux bords des objets un aspect 3-D ?

Comment sélectionner un outil pour qu'il reste sélectionné ?

Comment mettre un texte à l'échelle ?

Comment éditer ma palette de couleurs ?

Comment modifier mes étiquettes par défaut ?


Comment faire pour que mon graphique soit mis à jour correctement ?

Lorsque je crée un affichage avec un graphique et que je l'exécute, l'affichage ne comporte aucune donnée d'exécution. Je ne vois que les données que j'avais la dernière fois que j'ai enregistré à partir du Designer de Graphics Builder. Que faire pour que la mise à jour s'exécute correctement ?

Assurez-vous que l'option Mettre à jour le graphique sur exécution de l'interrogation est cochée sur la page Données de la boîte de dialogue Propriétés de graphique. Assurez-vous également que Execute on Opening Display est cochée sur la page Données de la boîte de dialogue Propriétés d'interrogation.


Peut-on réutiliser des options d'un graphique pour en créer un autre ?

Si je crée un graphique que je veux réutiliser avec des modifications mineures, quelle est la meilleure façon de procéder ?

Tous les graphiques reposent sur des modèles de graphique. Lorsque vous sélectionnez le type et le sous-type du graphique que vous créez, vous sélectionnez en fait l'un des cinquante et quelques modèles de graphiques par défaut fournis par Graphics Builder, qui crée alors une copie du modèle pour votre graphique.

Bien que vous ne puissiez pas modifier les modèles par défaut fournis, vous pouvez modifier la copie créée pendant la création du graphique et l'enregistrer sous la forme d'un modèle de graphique personnalisé. Pour cela, éditez le modèle de graphique dans l'éditeur de modèle de graphique.


Comment faire pour personnaliser les couleurs de mon graphique à secteurs ?

J'aimerais choisir les couleurs de mon graphique à secteurs, mais Graphics Builder semble les choisir toutes à ma place, sauf la première. Comment faire ?

Cette sélection de couleurs n'est pas possible dans le Designer. Vous pouvez cependant boucler par programmation sur les données et modifier le secteur du graphique, en changeant la couleur, le motif de remplissage, etc. Vous pouvez également étudier un exemple en consultant la procédure name_the_bars qui est mentionnée à différents endroits du Graphics Builder Reference (par exemple, p.316).

Vous pouvez aussi utiliser le Composant réutilisable de Graphics Builder color ramp en attachant la bibliothèque PL/SQL colorrmp.pll. Pour plus d'informations, reportez-vous à l'aide sur les Composants réutilisables de Graphics Builder.


Quand j'importe un dessin dans Graphics Builder, je ne peux pas sélectionner d'objets. Pourquoi ?

Quand j'importe un dessin dans Graphics Builder et que je sélectionne le dessin dans la présentation, je ne peux pas sélectionner d'objets. Pourquoi ?

Lorsque vous utilisez Editer [image] Importer [image] Dessin, votre nouveau dessin n'est pas importé dans la couche en cours. Graphics Builder crée automatiquement une nouvelle couche pour votre dessin. Utilisez la boîte de dialogue Réorganisation [image] Couches pour activer la couche que vous venez d'importer.


Comment supprimer une légende ?

Je veux créer un graphique sans légende. Comment supprimer celle qui est créée par défaut ?

Désélectionnez la case à cocher Afficher la légende dans la fenêtre de propriétés Encadrement (à laquelle vous pouvez accéder en utilisant le menu de droite de la souris ou le menu Graphique.


Comment faire pour exporter une présentation sous la forme d'une image ?

Je voudrais inclure une image de mon graphique dans une page Web. Comment exporter la présentation de mon graphique dans une image ?

Pour exporter la présentation de votre graphique dans une image, vous avez trois possibilités. La première consiste à utiliser, dans la ligne de commande, l'option de ligne de commande exportimage, de la manière suivante :

g25run openfile=c:\test.ogd
userid=scott/tiger
exportimage=c:\test.gif quit=yes

qui exécute l'affichage et exporte la présentation, y compris les données du graphique, dans le fichier GIF test.gif.

Vous pouvez également utiliser la boîte de dialogue Export d'image à laquelle vous accédez par Editer [image] Exporter [image] Image.

Enfin, vous pouvez appeler le sous-programme intégré OG_EXPORT_IMAGE de Graphics Builder et entrer, par exemple :

og_export_image(‘C:\test.gif’, OG_FILESYSTEM, OG_GIF_IFORMAT, og_root_object, OG_LZWHDIFF_ICOMPRESSION);

Cette instruction définit également le type de compression.


Peut-on faire pivoter les étiquettes ?

Je voudrais modifier l'orientation de mes étiquettes. Est-ce possible ?

Oui. Pour cela,, utilisez le déclencheur suivant :

PROCEDURE Rotate_Label(nomgraphique   VarChar2, nométiquette    VarChar2,  anglerotation    Numéro) IS
axislabel	og_object;
theoffset	og_point

BEGIN

axislabel := og_get_object(nométiquette);
og_set_horigin(axislabel, OG_CENTER_HORIGEN, false, false);
og_rotate(axislabel, og_get_origin(étiquetteaxe), anglerotation, false, false);
og_draw(og_get_object(nomgraphique);

END

--La mise à jour du graphique annulera la rotation des étiquettes!!!
--Appelez cette procédure après avoir mis le graphique à jour.
--L'angle de rotation est dans le sens des aiguilles d'une montre.

Vous devez exécuter ce déclencheur après toutes les autres opérations, y compris la mise à jour du graphique. (Cependant, si vous utilisez un Composant réutilisable de Graphics Builder ou si vous enregistrez l'un de vos fichiers .ogd comme Composant réutilisable, les modifications apportées à l'affichage après la mise à jour du graphique seront maintenues.)


Comment donner aux bords des objets un aspect 3-D ?

Je voudrais que les objets de mon affichage aient l'air raised ou depressed. Comment faire ?

Sélectionnez le ou les objets dans la présentation, puis sélectionnez Format [image] Relief et choisissez la façon dont le bord doit se présenter: raised, lowered, avec relief inset, ou avec relief outset. Si le relief n'apparaît pas immédiatement, il est possible que le bord de l'objet soit trop étroit pour être visible. Sélectionnez Format [image] Ligne et choississez une largeur plus importante pour le bord de l'objet.


Comment sélectionner un outil pour qu'il reste sélectionné ?

Si je veux dessiner plusieurs instances d'un type d'objet - par exemple, des cercles, ou des rectangles - dans ma présentation, comment faire pour empêcher cet outil de revenir à l'outil Sélectionner après avoir dessiné chaque objet ?

Si vous cliquez deux fois sur un outil la première fois que vous le sélectionnez, vous remarquez que son icône dans la palette d'outils semble rester depressed, et être maintenu enfoncé par l'image d'une épingle push pin. Cela signifie que vous avez activé le mode pour cet outil et qu'il restera sélectionné jusqu'à ce que vous sélectionniez un autre outil.


Comment mettre un texte à l'échelle ?

Je voudrais pouvoir faire simplement glisser mes objets texte pour leur donner la taille voulue. Est-ce possible ?

Sous Format [image] Options de dessin, sélectionnez Texte... et, dans la boîte de dialogue d'options de dessin de texte, sélectionnez Scalable Fonts. Vous pourrez alors mettre le texte à l'échelle dans vos objets texte.


Comment éditer ma palette de couleurs ?

Les couleurs de ma palette ne me plaisent pas. Comment faire pour les modifier ou changer de palette ?

Pour modifier les couleurs de votre palette, sélectionnez Outils [image] Options des outils... et, sur la page Par défaut, sous Palette de couleurs, sélectionnez un Mode Modifiable. Enregistrez votre nouvelle préférence. Pour qu'elle prenne effet, fermez et réouvrez votre affichage. Vous pouvez alors sélectionner Format [image] Palette de couleurs et créer vos propres couleurs pour la palette de couleurs par défaut de Graphics Builder.

Si vous voulez utiliser une palette de couleurs différente, vous pouvez choisir l'une de celles proposées par Graphics Builde, et notamment une palette de niveaux de gris, une palette VGA et une palette VGA 16-couleurs. Après vous être assuré que votre palette peut être modifiée, comme expliqué ci-dessus, sélectionnez Editer [image] Importer [image] Palette de couleurs et utilisez la boîte de dialogue d'importation pour choisir un fichier .pal ou un fichier de palettes de couleurs. Pour savoir précisément où se trouvent les fichiers de palettes de couleurs disponibles, reportez-vous à votre Installation and User’s Guide.


Comment modifier mes étiquettes par défaut ?

Je voudrais ajouter un symbole de pourcentage à mes étiquettes de graphiques à secteurs. Comment faire ?

Pour ajouter un symbole de pourcentage à vos étiquettes de graphiques à secteurs, il suffit d'attacher un déclencheur de format au groupe d'étiquettes de graphiques à secteurs. Par exemple :

--Déclencheur de format d'Elément de graphique.
--Appelé pour chaque membre d'un groupe
--d'éléments de graphiques indiqué.
--Arguments:
--	ELEM	L'élément graphique en cours.
--	QUERY	L'interrogation associée à
--	ce graphique.  La ligne en cours
--	de l'interrogation est celle qui
--	est associée à ELEM.
--	Utilisez OG_GET_xxxCELL pour passer aux
--	valeurs de colonnes de la ligne en cours.

PROCEDURE FTRIG(élém IN og_object, interrogation IN og_query) IS

BEGIN

og_set_str(elem, og_get_str(elem, 0, 0) || ‘%’);

END

Utilisez cette méthode pour modifier les étiquettes des graphiques.


 Sur PL/SQL

Mon affichage contient un bouton, alors que je n'en ai pas défini. Pourquoi ?

Comment gérer les exceptions PL/SQL ?

Est-il possible d'exporter une présentation sous la forme d'une image ?

Peut-on mettre des informations à jour dans la base de données à partir de Graphics Builder ?

Peut-on exploser un graphique à secteurs ?


Mon affichage contient un bouton, alors que je n'en ai pas défini. Pourquoi ?

A la génération de mon affichage, je reçois un message d'erreur du type "La procédure 'my_buttonproc' associée à l'objet 'my_button' doit avoir exactement quatre paramètres." Pourquoi ?

Si vous associez une procédure à un objet, cet objet devient un bouton qui permet d'activer la procédure. Lorsqu'il est appelé, Graphics Builder transmet automatiquement quatre arguments à la procédure, dont l'identificateur de l'objet qui a été activé. Si la procédure n'est pas définie pour accepter quatre arguments, vos recevrez ce message d'incohérence lors de la génération.

La façon la plus simple de résoudre ce problème consiste à vous assurer que, lorsque vous définissez une procédure bouton, vous lancez sa définition en choisissant Fichier [image] Nouveau Bouton au lieu de lancer la procédure à partir du début. Graphics Builder vous donne alors les quatre arguments par défaut, ainsi que leurs types de données, et vous n'avez plus qu'à modifier le nom et le corps de la procédure.


Comment gérer les exceptions PL/SQL ?

Quand j'exécute une procédure pour mettre mon graphique à jour, je reçois le message "OG-637: Unhandled PL/SQL exception error 102003". Que veut-il dire ?

L'erreur OG-637 est propre à un certain nombre d'erreurs PL/SQL ou ORACLE. Reportez-vous à Exceptions des procédures intégrées de Graphics Builder qui contient une explication des codes d'erreur à six chiffres.


Peut-on mettre des informations à jour dans la base de données à partir de Graphics Builder ?

Je voudrais valider les modifications apportées à la base de données à partir de Graphics Builder. Est-ce possible ?

Oui, dans les procédures PL/SQL associées à l'affichage. Vous pouvez exécuter des instructions DML à partir de vos unités de programme PL/SQL, et aussi exécuter des instructions DDL en utilisant la procédure intégrée DO_SQL.


Peut-on exploser un graphique à secteurs ?

Je voudrais attirer l'attention sur un secteur particulier d'un graphique. Comment le détacher du reste du graphique ?

Vous pouvez utiliser une procédure PL/SQL pour exploser un graphique à secteurs. Pour cela, procédez de la manière suivante :

1. 	Dans la boîte de dialogue Propriétés de graphique, passez à la page Données et assurez-vous que «Update on query execution» est désélectionnée.

2. 	Sélectionnez Outils [image] Affichage et sélectionnez le bouton Nouveau, à droite de la liste déroulante Déclencheur d'ouverture.

3. 	Entrez le corps de la procédure qui explosera le graphique. Par exemple :

PROCEDURE explode IS
pie	OG_OBJECT;
pieq	OG_QUERY;
mrows	NUMBER;
msal	NUMBER;
csal	NUMBER;
rowsq	NUMBER;

BEGIN
--Attribuez les valeurs des valeurs initiales
msal := 0;
mrows :=0;
pie := OG_GET_OBJECT (‘sal_chart’);
pieq := OG_GET_QUERY (‘query0’);
--Où ‘sal_chart’ est le nom du graphique et
--‘query0’ est celui de l'interrogation.

--Exécutez l'interrogation pour obtenir de nouvelles données.
OG_EXECUTE_QUERY(pieq);

--Comptez le nombre de lignes retournées par l'interrogation
rowsq := OG_NUMROWS(pieq, OG_NEWDATA);

--Déterminez la valeur maximum en bouclant sur les lignes de l'interrogation
OG_START_FROM(pieq, OG_NEWDATA, 0);
FOR I IN 0 .. rowsq -1 LOOP
csal := OG_GET_NUMCELL (peiq, OG_NEWDATA, ‘sal’);
IF csal > msal THEN
msal := csal;
mrows := i;
END IF;
OG_NEXT_ROW(pieq, OG_NEWDATA);
END LOOP;

--Définir l'explosion du graphique
OG_SET_EXPLOSION(pie, OG_ALL_CHUPDA);

--Mettre le graphique à jour

OG_UPDATE_CHART(pie, OG_ALL_CHUPDA);

END;

4. 	Compiler le déclencheur et fermer l'éditeur d'unités de programme.

Vous pouvez également utiliser le Composant réutilisable pie explosion  de Graphics Builder en attachant la bibliothèque PL/SQL explode.pll. Pour plus d'informations reportez-vous à l'aide sur les composants réutilisables de Graphics Builder.


 Sur le débogage

Comment faire pour avoir une liste du PL/SQL dans mon affichage ?

Comment enregistrer les modifications apportées au PL/SQL pendant la simulation d'exécution ?


Comment faire pour avoir une liste du PL/SQL dans mon affichage ?

Comment faire pour avoir dans mon affichage Graphics Builder un fichier texte comprenant la liste du code source de toutes les unités de programme PL/SQL ?

Exécutez l'affichage à partir du Designer de Graphics Builder et appelez l'Interpréteur PL/SQL. A l'invite PL/SQL, entrez la commande :

export prog * file <my_text_file>


Comment enregistrer les modifications apportées au PL/SQL pendant la simulation d'exécution ?

Si je vois des modifications que je dois apporter à une procédure pendant que je teste un affichage, comment faire pour apporter ces modifications sur le champ et m'assurer qu'elles prennent aussi effet dans la version design-time de la procédure ?

Vous pouvez soit couper/copier/coller (CUT/COPY/PASTE) le texte source entre les unités de programme de simulation et les unités de programme de développement, soit appeler l'Interpréteur PL/SQL à partir de la simulation d'exécution et entrer la commande :

og_save_display;

Notez que cette commande enregistrera tout dans votre état de simulation d'exécution. Comme les modifications apportées aux objets graphiques de votre affichage seront également enregistrées, la prochaine fois que vous appellerez votre affichage, certains objets auront peut-être un état autre que leur état initial. A partir de votre session de Designer en cours, vous devrez choisir Fichier [image] Rétablir pour récupérer les modifications.


Sur les performances

Comment faire pour améliorer la performance d'un affichage incorporé ?

Faut-il utiliser les bibliothèques attachées ou le PL/SQL local ?

Où stocker mes unités de programme PL/SQL ?

Que faire si mon affichage trace un très grand nombre de points de données ?

Quand utiliser DO_SQL?


Quelle est la meilleure façon d'optimiser les performances de Graphics ?

La meilleure façon d'optimiser les performances de Graphics consiste à contrôler les indicateurs de dommage et de mise à jour qui sont les deux derniers arguments de la plupart des procédures internes de PL/SQL Graphics. Par défaut, ces indicateurs sont définis à TRUE, et sont redessinés chaque fois que la liste des affichages Graphics est modifiée. Pour améliorer les performances, assurez-vous que vos unités de programme PL/SQL (et notamment les procédures boutons, les déclencheurs, etc.) ne mettent l'affichage à jour qu'une seule fois. Par exemple :

Begin

   for i in 1 .. 100 loop

     og_set_fillcolor(og_get_object('obj' || to_char(i)),
        'red');

   end loop;

End;

Pour améliorer la performance, vous pourriez modifier le code de la manière suivante :

Begin

   for i in 1 .. 100 loop

     og_set_fillcolor(og_get_object('obj' || to_char(i)),
        'red', false, false);

   end loop;

   og_draw(og_root_object);

End;

Dans cet exemple, aucune partie de l'écran n'est mise à jour avant la fin de la procédure.

Cette technique permet d'améliorer considérablement les affichages dans lesquels plusieurs objets sont créés ou détruits "à la volée" lors de l'exécution, ou ceux qui utilisent beaucoup de code PL/SQL. (N'oubliez pas qu'une boucle de trois lignes peut contenir beaucoup de code.)

Comment faire pour améliorer la performance d'un affichage incorporé ?

Quelles mesures prendre pour améliorer la performance d'un affichage incorporé dans une application Forms ou un état ?

En général, pour être certain que votre affichage s'exécute aussi efficacement que possible lorsqu'il est appelé à partir d'une application Forms ou d'un état, essayez d'utiliser autant d'éléments communs que possible lorsque vous concevez l'application Forms et l'affichage. Par exemple, lorsque vous tracez un graphique de données déjà extraites par Forms, vous aurez intérêt à transférer les mêmes données par groupes d'enregistrements au lieu de laisser l'affichage réinterroger la base de données. Utilisez la même palette de couleurs dans votre application Forms et dans votre affichage. Mettez les mêmes polices à disposition.

Pour améliorer la performance d'un affichage, vous pouvez également vous assurer que vos unités de  (et notamment les procédures boutons, les déclencheurs, etc.) ne mettent l'affichage à jour qu'une seule fois. Pour cela, chaque fois que l'indicateur de dommage et la boîte englobante sont définies à TRUE, restaurez-les à FALSE, puis exécutez uniquement une fonction OG_UPDATE_CHART et OG_DRAW comme dernières actions.

Pour plus d'informations sur l'amélioration des performances de Graphics Builder, reportez-vous à la section :

Quelle est la meilleure façon d'optimiser les performances de Graphics ?

Pour plus d'informations sur l'indicateur de dommage et la boîte englobante, reportez-vous aux sections :

Utilisation de l'indicateur de dommage

Utilisation de l'indicateur de mise à jour de boîte englobante


Faut-il utiliser les bibliothèques attachées ou le PL/SQL local ?

Mon PL/SQL doit-il rester externe à mon affichage ?

Chaque fois que possible, incorporez le PL/SQL dans des bibliothèques attachées à votre affichage, au lieu d'utiliser le P/SQL local à l'affichage.

Les unités de programme qui se trouvent dans des bibliothèques externes peuvent être utilisées par un nombre quelconque de documents (affichages, applications Forms et états inclus), alors que les unités de programme locales ne peuvent être utilisées que par les documents auxquels elles appartiennent.

En outre, les unités de programme locales se chargent à l'ouverture du document, qu'elles soient exécutées ou non. Les bobloithèques ne sont chargées que lorsqu'elles sont appelées.


Où stocker mes unités de programme PL/SQL ?

Vaut-il mieux stocker les unités de programme sur le client ou sur le serveur ?

Certaines procédures sont plus performantes si elles sont stockées sur le client, d'autres si elles sont stockées sur le serveur. Pour toute information sur le choix du meilleur emplacement de stockage d'une procédure donnée, reportez-vous à la documentation Procedure Builder.


Que faire si mon affichage trace un grand nombre de points de données ?

Comment contrebalancer une dégradation de performance dans mon affichage s'il doit tracer un grand nombre de points de données ?

Graphics Builder ne limite pas le nombre de points qu'il peut tracer dans un affichage, mais il convient cependant de respecter certains conseils pratiques. Il est possible que votre machine n'ait pas assez de mémoire pour tracer un grand nombre de points dans un délai raisonnable.

Pour résoudre le programme, vous pouvez ne tracer qu'un sous-ensemble de tous les points à un moment donné et dessiner l'affichage de manière que l'utilisateur puisse soit faire défiler l'affichage soit sélectionner et descendre sur les points tracés pour accéder à un complément d'information.


Quand utiliser DO_SQL ?

Pour ajouter DDL ou DML à un affichage, me faut-il DO_SQL ?

N'utilisez la procédure en package DO_SQL que si nécessaire, c'est-à-dire si vous voulez exécuter des instructions DDL, car PL/SQL ne le fait pas, mais si vous voulez utiliser DML dans votre affichage, vous pouvez les entrer dans les unités de programme.

La procédure DO_SQL vous permet d'ajouter des opérations DDL ou DML à votre affichage - opération très importante - mais peut, si elle n'est pas utilisée avec discernement, être d'un emploi très onéreux. Tout comme une interrogation, une instruction DO_SQL est analysée, ouvre un curseur sur la base de données, et s'exécute. A la différence d'un interrogation, cependant, une instruction DO_SQL s'exécute chaque fois que son propriétair (par exemple, une rupture) extrait des données. (Par exemple, si votre instruction DO_SQL appartient à une rupture qui extrait 10 enregistrements, l'instruction sera sera analysée 10 fois, 10 curseurs seront ouverts, et l'instruction sera exécutée 10 fois.)


 Sur l'intégration

Comment utiliser des groupes d'enregistrements pour transférer des données de Forms à Graphics Builder ?

Comment arrêter Graphics Builder Batch à partir de Forms?

Quand mon graphique est incorporé dans une application Forms, il apparaît coupé. Pourquoi ?

Pourquoi Graphics Builder ne peut-il pas trouver l'affichage que je veux ouvrir à partir de Forms ?

Pourquoi l'affichage n'est-il pas incorporé dans la mise à jour de mon application Forms ?

Mon affichage n'apparaît pas dans mon état.. Pourquoi ?


Comment utiliser des groupes d'enregistrement pour transférer des données de Forms à Graphics Builder ?

Je voudrais transmettre un groupe d'enregistrements dans Graphics Builder et que le graphique soit fondé sur les données du groupe - mais je ne sais pas très bien comment faire.

La solution est simple : il faut que le paramètre transmis ait le même nom que l'interrogation affichée. Appelez Graphics Builder par RUN_PRODUCT en mode SYNCHRONE (vous ne pouvez pas transmettre de groupes d'enregistrements autrement) en transmettant cette liste de paramètres sous forme d'un argument. Respectez la procédure décrite dans la question ci-dessus pour ré-exécuter l'interrogation et mettre le graphique à jour. Pour un exemple de ce type de déclencheur Forms, reportez-vous à Forms User's Guide.


Comment arrêter Graphics Builder Batch à partir de Forms ?

Quand je lance Graphics Builder à partir de Forms, l'icône de mode batch de Graphics Builder apparaît sur mon bureau Windows, et ne disparaît pas quand je suis sorti de mon application Forms. Comment faire pour le supprimer automatiquement ?

Pour optimiser les performances, le processus Graphics Builder batch reste par défaut actif lorsqu'il est appelé à partir de Forms. Autrement, l'utilisateur devrait attendre que Graphics Builder démarre à chaque mise à jour d'un graphique à partir de Forms. Si vous voulez arrêter Graphics Builder lorsque vous quittez votre application Forms, écrivez un déclencheur Post-Form qui arrête explicitement le processus Graphics Builder en mode batch.

declare

pl paramlist;

begin

pl := create_parameter_list('listparam');

add_parameter(pl, 'oracle_shutdown', text_parameter, 'YES');

run_product(graphics, '<your_display_name>',

synchronous, batch, filesystem,

pl, '<chart_item_name>);

destroy_parameter_list(pl);

end;


Quand mon graphique est incorporé dans une application Forms, il apparaît coupé. Pourquoi ?

Quand j'incorpore un graphique dans une application Forms et que j'exécute l'application, mon affichage n'est pas toujours parfait. Que faire ?

Par défaut, l'appel de OG.OPEN qui lance Graphics Builder et ouvre votre affichage coupe l'affichage aux dimensions de la zone que vous définissez pour lui dans le graphique. Vous avez deux possibilités : mettre l'affichage à l'échelle en indiquant

clip=no

dans votre appel initial, ou redimensionner l'objet graphique que vous avez créé dans l'application Forms pour qu'il soit plus proche de la taille réelle de l'affichage.


Pourquoi Graphics Builder ne peut-il pas trouver l'affichage que je veux ouvrir à partir de Forms ?

Quand je crée un objet graphique dans une application Forms et que je demande que l'affichage s'ouvre dans mon appel à OG.OPEN, Graphics Builder ne le trouve toujours pas. Pourquoi ?

Assurez-vous que votre fichier .ogd se trouve bien dans le répertoire indiqué par la variable d'environnement Path de Graphics Builder (et non dans la variable d'environnement Path de Forms). Comme le nom de cette variable d'environnement dépend de la plate-forme, reportez-vous à la documentation Graphics Builder correspondante.


Pourquoi l'affichage n'est-il pas incorporé dans la mise à jour de mon application Forms ?

Quand j'exécute une application Forms avec un affichage incorporé, que je ferme l'application et que je l'exécute à nouveau, les données ont changé, mais l'affichage n'a pas été mis à jour. Pourquoi ?

La fermeture d'une application Forms et la sortie de Forms Runtime ne ferme pas automatiquement de Graphics Builder batchmode, qui est l'exécutable Graphics Builder appelé pour exécuter des affichages incorporés dans des applications Forms. Tant que la session de Graphics Builder batchmode reste ouverte, elle continue à exécuter la même itération de l'affichage, en utilisant les mêmes données. Pour être certain de fermer Graphics Builder batchmode quand vous sortez de Forms, entrez, dans un déclencheur Forms, un appel à OG.CLOSE pour fermer votre affichage.


Mon affichage n'apparaît pas dans mon état. Pourquoi ?

Même si je crée un élément d'affichage graphique dans la présentation de mon état et si je l'associe à un affichage, mon graphique n'apparaît pas dans mon état et je reçois un message d'erreur. Que se passe-t-il ?

Vous avez peut-être associé un affichage à votre état, mais vous avez peut-être omis de créer une correspondance un-à-un entre les colonnes de l'état et celles du graphique.


 Sur le développement en général

Est-il possible de créer des applications avec des contrôles natifs ?

Publications connexes


Est-il possible de créer des applications avec des contrôles natifs ?

Graphics Builder permet-il de créer des applications avec des contrôles natifs (boutons poussoirs, menus, listes instantanées, etc) ?

Non - mais vous pourrez obtenir l'application voulue en utilisant Forms 4.5 et en incorporant des objets Graphics Builder (des graphiques ou des schémas, par exemple).


Publications connexes

Manuels

Oracle PL/SQL Programming par Steven Feuerstein, O’Reilly and Associates, Inc.

800-998-9938, (707) 829-0515

http://www.ora.com

Learning Oracle Forms 4.5 par Stephen Edelstein, Relationship Business Systems

(212) 956-3670

74160.645@compuserve.com

Mastering Oracle in Client Server Computing par Steve Bobrowski, Sybex

Journaux

Oracle Technical Journal (OTJ), Miller Freeman

pchapnickel@nfi.com


Boîtes de dialogue

La présente section est consacrée aux boîtes de dialogue suivantes et à leurs options :

Options de dessin - arc - Boîte de dialogue

Assistant graphique - Boîte de dialogue

Compilation - Boîte de dialogue

Format de date - Boîte de dialogue

Suppression de la base -Boîte de dialogue

Export - Boîte de dialogue

Export vers la base - Boîte de dialogue

Export d'image - Boîte de dialogue

Export de son - Boîte de dialogue

Options de dessin - généralités - Boîte de dialogue

Options de dessin - image - Boîte de dialogue

Import - Boîte de dialogue

Import d'affichage - Boîte de dialogue

Import depuis la base - Boîte de dialogue

Import d'image - Boîte de dialogue

Import de son - Boîte de dialogue

Paramètres de présentation - Boîte de dialogue

Accès au module - Boîte de dialogue

Accès au module de la base - Boîte de dialogue

Nouvelle interrogation - Boîte de dialogue

Format de nombre - Boîte de dialogue

Ouverture depuis la base - Boîte de dialogue

Renommer - Boîte de dialogue

Options de dessin - rectangles arrondis - Boîte de dialogue

Paramètres de règles - Boîte de dialogue

Enregistrement dans la base - Boîte de dialogue

Enregistrement dans - Boîte de dialogue

Contrôle de source : Archives

Contrôle de source : Extraction

Contrôle de source : Options

Options de dessin - texte - Boîte de dialogue

Utilisation de Oracle Help


Options de dessin - arc - Boîte de dialogue

Permet de définir les types de remplissage et de fermeture d'arc.

Options de la boîte de dialogue

Remplissage de l'arc Permet d'indiquer comment doit être rempli l'arc sélectionné. Sélectionnez l'une des options proposées.

Fermeture de l'arc

Permet d'indiquer si l'arc sélectionné doit être ouvert ou fermé. Sélectionnez l'une des options proposées.


Assistant graphique - Boîte de dialogue

Permet de sélectionner une interrogation ou d'en créer une destinée à fournir des données pour le graphique en cours de création.

Options de la boîte de dialogue

Interrogation existante

Permet d'afficher une liste de toutes les interrogations définies dans l'affichage en cours. Sélectionnez l'interrogation que vous voulez utiliser pour le graphique.

Nouvelle interrogation

Permet de créer une nouvelle interrogation à utiliser pour le graphique. Si vous choisissez cette option et cliquez sur OK, vous voyez apparaître la boîte de dialogue.


Compilation - Boîte de dialogue

Permet d'afficher l'état de la dernière compilation exécutée et les éventuelles erreurs de compilation qui en ont découlé. Cliquez sur un message d'erreur pour passer à l'unité de programme ayant provoqué l'erreur.

Options de la boîte de dialogue

Interrompre

Permet d'interrompre la compilation en cours.

Reprendre

Permet de reprendre la compilation en cours, si elle a été interrompue.

Atteindre erreur

Permet de passer directement à l'unité de programme contenant la première erreur signalée.


Format de date - Boîte de dialogue

Permet d'ajouter, de supprimer ou d'appliquer les masques de format de date disponibles.

Options de la boîte de dialogue

Format

Permet d'indiquer la chaîne de format à ajouter à la liste, à supprimer de la liste ou à appliquer à un objet. Cette chaîne doit être un masque de format de date Oracle SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Language Reference Manual.

Ajouter

Permet d'ajouter à la liste des formats disponibles le masque de format affiché dans le champ de texte Format.

Supprimer

Permet de supprimer de la liste des formats disponibles le masque de format affiché dans le champ de texte Format.

OK

Permet d'accepter les modifications et de fermer la boîte de dialogue. Le cas échéant, le masque de format sélectionné est appliqué aux objets sélectionnés.


Suppression de la base - Boîte de dialogue

Permet d'afficher une liste des modules stockés dans la base de données.

Options de la boîte de dialogue

Nom

Permet d'indiquer le nom du module à supprimer. Le nom du module sélectionné dans la liste apparaît dans ce champ. Vous pouvez également y entrer un nom directement.

MàJ liste

Permet de mettre à jour la liste des modules stockés.

OK

Permet de supprimer le module dont le nom apparaît dans le champ de texte Nom.


Export - Boîte de dialogue

Permet de stocker dans un fichier ou dans la base de données un module provenant de l'affichage en cours.

Options de la boîte de dialogue

Destination des données

Permet d'indiquer l'emplacement et le format du module à exporter.

Système de fichiers	Permet d'afficher la boîte de dialogue d'enregistrement de fichier de votre système.

Base de données	Permet d'afficher la boîte de dialogue d'export vers la base.

Format	Permet d'indiquer le format dans lequel le module devra être exporté. Les options disponibles changent en fonction du type de module que vous exportez.

Options

Permet d'indiquer plusieurs options :

Compression	Permet d'indiquer le système de compression (le cas échéant) à utiliser lors de l'exportation d'images composant un dessin exporté.

Encodage CGM	Permet d'indiquer l'encodage à utiliser lors de l'exportation d'un dessin CGM. CGM supporte des espaces de coordonnées sur 2 octets et 4 octets. La plupart des produits utilisent un espace de coordonnées sur 2 octets pour CGM.


Export vers la base - Boîte de dialogue

Permet d'afficher une liste des modules stockés dans la base de données.

Options de la boîte de dialogue

MàJ liste

Permet de mettre à jour la liste des modules stockés.

Nom

Permet d'indiquer le nom sous lequel sera stocké le module exporté. Le nom du module sélectionné dans la liste apparaît dans ce champ. Vous pouvez également y entrer un nom directement.

OK

Permet de valider le module sélectionné en vue de son exportation.


Export d'image - Boîte de dialogue

Permet de stocker l'image sélectionnée dans un fichier ou dans la base de données.

Options de la boîte de dialogue

Base de données

Permet d'indiquer que l'image à exporter sera stockée dans la base de données. Cliquer sur Parcourir affiche la boîte de dialogue d'export vers la base de données.

Fichier

Permet d'indiquer que l'image à exporter sera stockée dans un fichier.

Format

Permet d'indiquer le format dans lequel l'image devra être exportée.

Type de données

Permet d'indiquer le type de données dans lequel l'image sera exportée.

Compression

Permet d'indiquer le système de compression à utiliser lors de l'exportation de l'image. Les options changent en fonction du format dans lequel vous exportez l'image.

Qualité

Permet d'indiquer la qualité d'exportation de l'image. Cette option ne s'applique qu'aux formats d'image qui supportent plusieurs paramètres de qualité.


Export de son - Boîte de dialogue

Permet de stocker le son sélectionné dans un fichier ou dans la base de données.

Options de la boîte de dialogue

Base de données

Permet d'indiquer que le son à exporter sera stocké dans la base de données. Cliquer sur Parcourir affiche la boîte de dialogue d'export vers la base de données.

Fichier

Permet d'indiquer que le son à exporter sera stocké dans un fichier.

Format

Permet d'indiquer le format du son à exporter.

Encodage

Permet d'indiquer le système d'encodage à utiliser lors de l'exportation du son. Les options changent en fonction du format dans lequel vous exportez le son.

Type de données

Permet d'indiquer le type de données dans lequel le son devra être exporté.

Compression

Permet d'indiquer le système de compression à utiliser lors de l'exportation du son. Les options changent en fonction du format dans lequel vous exportez le son.

Débit

Permet d'indiquer le débit d'échantillonnage auquel le son devra être exporté.


Options de dessin - généralités - Boîte de dialogue

Permet de définir les types d'extrémité, de jointure et de traçage à partir d'un angle ou du centre ainsi que le mode de transfert.

Options de la boîte de dialogue

Type d'extrémité

Permet d'indiquer le type d'extrémité des lignes et des bords sélectionnés. Choisissez l'une des options proposées.

Type de jointure

Permet d'indiquer le type de jointure à utiliser lorsque les lignes et les bords sélectionnés se rencontrent. Sélectionnez l'une des options proposées.

Création d'objet

Permet d'indiquer comment les objets doivent être tracés lorsque vous les dessinez sur la présentation. Vous avez le choix entre les options suivantes :

Tracer à partir d'un angle	Permet d'indiquer que le point sur lequel vous cliquez lorsque vous dessinez les objets est un angle de la boîte englobante de l'objet.

Tracer à partir du centre	Permet d'indiquer que le point sur lequel vous cliquez lorsque vous dessinez les objets est le centre de la boîte englobante de l'objet.

Mode de transfert

Permet d'indiquer le mode de transfert du ou des objets sélectionnés. Vous avez le choix entre les options suivantes :

Normal	Permet d'indiquer que la couleur de premier plan est appliquée à l'élément de premier plan du motif, et que la couleur d'arrière-plan est appliquée à l'élément d'arrière-plan du motif.

Négatif	Permet d'indiquer que la couleur d'arrière-plan est appliquée à l'élément de premier plan du motif, et que la couleur de premier plan est appliquée à l'élément d'arrière-plan du motif.

Transparence	Permet d'indiquer que la couleur de premier plan est appliquée à l'élément de premier plan du motif, et que l'élément d'arrière-plan du motif est incolore.

Transparence négative	Permet d'indiquer que l'élément de premier plan du motif est incolore, et que la couleur de premier plan est appliquée à l'élément d'arrière-plan du motif.

Filtre	Permet d'indiquer que la couleur d'arrière-plan est appliquée à l'élément de premier plan du motif, et que l'élément d'arrière-plan du motif est incolore.

Filtre négatif	Permet d'indiquer que l'élément de premier plan du motif est incolore, et que la couleur d'arrière-plan est appliquée à l'élément d'arrière-plan du motif.

Inverser contour	Permet d'indiquer que la couleur de premier plan est inversée et appliquée à l'élément de premier plan du motif, et que l'élément d'arrière-plan du motif est incolore.

Inverser fond	Permet d'indiquer que l'élément de premier plan du motif est incolore, et que la couleur d'arrière-plan est inversée et appliquée à l'élément d'arrière-plan du motif.

Les modes de transfert Inverser permettent, si vous utilisez la procédure interne OG_DRAW, de dessiner deux fois un objet inversé. Les deux traces s'annulent l'une l'autre, et l'objet n'apparaît plus dans la présentation (bien qu'il existe encore).


Options de dessin - image - Boîte de dialogue

Permet de définir les options de qualité et de tramage de l'image.

Options de la boîte de dialogue

Qualité de l'image

Permet de définir la qualité d'affichage de l'image de Graphics Builder. Plus la qualité est élevée, plus l'image est nette, mais plus la régénération de l'écran est lente.

Trame de l'image

Permet d'indiquer si Graphics Builder trame l'image. Le tramage est l'opération par laquelle Graphics Builder simule les couleurs qui apparaissent dans l'image, mais n'existent pas dans la palette de couleurs en cours. Si l'image n'est pas tramée, Graphics Builder utilise les couleurs qui se rapprochent le plus de celles de l'image. Plus la trame est élevée, plus l'image est nette, mais plus la régénération de l'écran est lente.


Import - Boîte de dialogue

Permet d'incorporer dans l'affichage en cours un module stocké dans un fichier.

Options de la boîte de dialogue

Source des données

Permet d'indiquer l'emplacement et le format du module à importer.

Système de fichiers	Permet de charger le module à partir d'un fichier.

Base de données	Permet de charger le module à partir d'une base de données. Cliquer sur Parcourir affiche la boîte de dialogue d'import de la base de données.

Format	Permet d'indiquer le format du module à importer. Les options disponibles changent en fonction du type de module que vous importez.

Options

Permet d'indiquer différentes options :

Importer vers la couche active	Permet d'indiquer si les objets importés sont placés sur la couche active. Sinon, ils sont placés sur une couche nouvellement créée.

Utiliser la palette de couleurs importée	Permet d'indiquer si la palette de couleurs d'un dessin importé doit remplacer la palette de couleurs de l'affichage. Cette option n'est activée que si la palette de couleurs de l'affichage est en mode Modifiable.


Import d'affichage - Boîte de dialogue

Permet de fusionner dans l'affichage en cours un affichage enregistré dans une base de données ou dans un fichier.

Options de la boîte de dialogue

Base de données

Permet d'indiquer que l'affichage à importer est stocké dans la base de données.

Fichier

Permet d'indiquer que l'affichage à importer est stocké dans un fichier.

Nom de l'affichage

Permet d'indiquer le nom de l'affichage à importer. Ce nom est soit le nom de l'affichage dans la base de données, soit le chemin d'accès au fichier d'affichage et son nom.

Fusionner le niveau actif

Permet de placer le niveau actif de l'affichage à importer sur le niveau actif de l'affichage ouvert.

Utiliser la palette de couleurs importée

Permet de remplacer la palette de couleurs en cours par celle de l'affichage importé. Cette option n'est valide que si la palette de couleurs d'affichage en cours est en mode Modifiable.

Résoudre les conflits de nom en

Permet d'indiquer le comportement de l'application en cas de conflit de nom entre les objets de l'affichage en cours et les objets de l'affichage importé.

Remplaçant l'objet existant	Permet d'indiquer que l'objet conflictuel dans l'affichage en cours est remplacé par l'objet de l'affichage importé.

Ignorant l'objet importé	Permet d'indiquer que l'objet conflictuel dans l'affichage importé n'est pas importé et que l'objet existant dans l'affichage en cours est laissé tel quel.

Confirmant à chaque conflit	Permet d'indiquer qu'un message vous demande une solution chaque fois que Graphics Builder est confronté à un conflit d'objets.

Importer

Permet d'importer l'affichage en fonction des options définies dans cette boîte de dialogue.


Import depuis la base - Boîte de dialogue

Permet d'afficher la liste des modules stockés dans la base de données.

Options de la boîte de dialogue

MàJ liste

Permet de mettre à jour la liste des modules stockés.

Nom

Permet d'indiquer le nom du module à importer. Le nom du module sélectionné dans la liste apparaît dans ce champ. Vous pouvez également y entrer un nom de module directement.

OK

Permet de valider le module sélectionné en vue de son importation.


Import d'image - Boîte de dialogue

Permet de placer une image bitmap dans la présentation en cours.

Options de la boîte de dialogue

Base de données

Permet d'indiquer que l'image à importer est stockée dans la base de données.

Fichier

Permet d'indiquer que l'image à importer est stockée dans un fichier.

Format

Permet d'indiquer le format de l'image à importer.

Qualité

Permet d'indiquer la qualité d'importation de l'image. Cette option ne s'applique qu'aux formats d'image qui supportent plusieurs paramètres de qualité.


Import de son - Boîte de dialogue

Permet de charger un son dans l'affichage en cours.

Options de la boîte de dialogue

Base de données

Permet d'indiquer que le son à importer est stocké dans la base de données.

Fichier

Permet d'indiquer que le son à importer est stocké dans un fichier.

Format

Permet d'indiquer le format du son à importer.


Paramètres de présentation - Boîte de dialogue

Permet de définir les options de taille de présentation et d'orientation de page.

Remarque : Graphics Builder impose que la taille de présentation réelle soit un multiple entier de la taille de page de l'affichage. La taille que vous entrez dans cette boîte de dialogue indique les dimensions minimales souhaitées ; Graphics Builder ajoute ou soustrait alors des pages entières pour respecter la valeur que vous avez indiquée.

Options de la boîte de dialogue

Taille

Permet d'indiquer les dimensions horizontale et verticale de la présentation.

Unités

Permet d'indiquer l'unité de mesure utilisée pour indiquer la taille de présentation.

Orientation de page

Permet d'indiquer l'orientation qui conditionne la présentation des pages à l'impression. Vous avez le choix entre les options suivantes :

Gauche-droite	Permet d'indiquer que la présentation est divisée en pages de gauche à droite.

Haut-bas	Permet d'indiquer que la présentation est divisée en pages de haut en bas.


Accès au module - Boîte de dialogue

Permet d'afficher la liste des utilisateurs qui ont tous les droits d'accès au module de la base de données.

Options de la boîte de dialogue

Utilisateur

Permet d'indiquer le nom utilisateur auquel vous voulez accorder ou refuser des droits d'accès. Le nom utilisateur sélectionné dans la liste apparaît dans ce champ. Vous pouvez également y entrer directement un nom utilisateur.

Ajouter

Permet d'ajouter à la liste d'accès le nom utilisateur figurant dans le champ Utilisateur et de donner à cet utilisateur un droit d'accès total au module stocké dans la base de données.

Supprimer

Permet de supprimer de la liste d'accès le nom utilisateur figurant dans le champ Utilisateur et de révoquer les privilèges d'accès de cet utilisateur au module stocké dans la base de données.


Accès au module de la base - Boîte de dialogue

Permet d'afficher la liste des modules stockés dans la base de données.

Options de la boîte de dialogue

Nom

Permet d'indiquer le nom du module dont vous voulez modifier les droits d'accès. Le nom du module sélectionné dans la liste apparaît dans ce champ. Vous pouvez également y entrer un nom directement.

MàJ liste

Permet de mettre à jour la liste des modules stockés.

OK

Permet de définir les privilèges d'accès au module sélectionné. Choisir ce bouton affiche la boîte d'accès au module.


Nouvelle interrogation - Boîte de dialogue

Permet de créer une nouvelle interrogation à utiliser pour le graphique que vous créez.

Sélectionnez l'onglet de dialogue correspondant aux options que vous voulez définir :

Onglet Interrogation

Onglet Données

Onglet Schéma (interrogations personnalisées uniquement)


Onglet Interrogation

Permet de définir le nom, la source des données et l'instruction SQL (si nécessaire) d'une interrogation.

Options de la boîte de dialogue

Nom

Permet d'indiquer le nom de l'interrogation.

Type

Permet d'indiquer le type de l'interrogation. Sélectionnez l'une des options suivantes :

Instruction SQL	Permet d'indiquer que l'interrogation extrait ses données d'une base de données, en fonction de l'instruction SQL SELECT que vous fournissez. Entrez l'instruction SQL dans le champ de texte Instruction SQL.

Fichier SYLK	Permet d'indiquer que l'interrogation extrait ses données d'un fichier au format SYLK. SYLK est un format utilisé par différentes applications classiques, comme Microsoft Excel. Lorsque vous exécutez l'interrogation, les données sont extraites du fichier. Indiquez le fichier à utiliser dans le champ de texte Fichier.

Fichier WKS	Permet d'indiquer que l'interrogation extrait ses données d'un fichier au format WSK. WKS est un format utilisé par différentes applications classiques comme Lotus 1-2-3. Lorsque vous exécutez l'interrogation, les données sont extraites du fichier. Indiquez le fichier à utiliser dans le champ de texte Fichier.

Fichier PRN	Permet d'indiquer que l'interrogation extrait ses données d'un fichier au format PRN. PRN est un format de fichier texte. Lorsque vous exécutez l'interrogation, les données sont extraites du fichier. Indiquez le fichier à utiliser dans le champ de texte Fichier.

Personnaliser	Permet de personnaliser les colonnes et les données de l'interrogation. Pour définir les colonnes, utilisez les contrôles qui apparaissent dans l'onglet Schéma. Pour définir les données, utilisez la procédure interne OG_APPEND_ROW.

Fichier SQL externe	Permet d'indiquer que l'interrogation extrait ses données d'un fichier texte qui contient une instruction SQL SELECT. Lorsque vous exécutez l'interrogation, l'instruction SQL est extraite du fichier et exécutée. Indiquez le fichier à utiliser dans le champ de texte Fichier.

Fichier

Permet d'indiquer l'emplacement et le nom du fichier à utiliser pour une interrogation SYLK, WKS, PRN ou SQL externe. Pour localiser le fichier dans votre système de fichier, cliquez sur Parcourir.

Parcourir

Permet de localiser et de sélectionner le nom de fichier qui doit apparaître dans le champ de texte Fichier.

Instruction SQL

Permet d'indiquer l'instruction SQL SELECT qui est exécutée pour une interrogation Instruction SQL.

Connecter

Permet d'afficher la boîte de dialogue de connexion, qui vous permet de vous connecter à une base de données.

Importer SQL

Permet de placer le contenu d'un fichier texte dans le champ de texte Instruction SQL. Notez que le texte est copié, et non lié au fichier. Pour créer un lien au texte SQL dans un fichier, utilisez le type d'interrogation Fichier SQL externe.

Exporter SQL

Permet de placer le contenu du champ de texte Instruction SQL dans un fichier.

Exécuter

Permet d'exécuter l'interrogation en cours. Si l'interrogation est une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation extrait des données d'un fichier, le fichier est lu. Si l'interrogation est une interrogation personnalisée, sa procédure d'interrogation personnalisée est exécutée.


Onglet Données

Permet de définir les données retournées par l'interrogation. Cliquez sur une cellule pour afficher son contenu dans le champ de texte, au-dessus de la table de calcul. La première ligne de cette table contient les noms de colonne et les types de données.

Options de la boîte de dialogue

Eff. données

Permet d'effacer du cache de données toutes les données extraites. Cette opération ne supprime pas l'interrogation elle-même et ne la modifie pas.

Exécuter

Permet d'exécuter l'interrogation en cours. Si l'interrogation est une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation extrait des données d'un fichier, le fichier est lu. Si l'interrogation est une interrogation personnalisée, sa procédure d'interrogation personnalisée est exécutée.


Onglet Schéma

(Interrogations personnalisées uniquement) Permet de créer, de supprimer et de définir le nom et le type de données des colonnes d'une interrogation personnalisée.

Options de la boîte de dialogue

Colonne

Permet de sélectionner la colonne à modifier. Toutes les colonnes qui ont été définies pour cette interrogation apparaissent dans cette liste.

Nom

Permet d'indiquer le nom de la colonne. Pour le modifier, entrez un nouveau nom dans cette case et cliquez sur Appliquer.

Type

Permet d'indiquer le type de données de la colonne.

Longueur maximum

Permet d'indiquer la longueur maximum des données contenues dans la colonne. Cette option ne s'applique qu'aux colonnes de type CHAR.

Nouvelle colonne

Permet d'ajouter une nouvelle colonne à l'interrogation.

Supprimer colonne

Permet de supprimer de l'interrogation la colonne en cours.

Exécuter

Permet d'exécuter l'interrogation en cours. Si l'interrogation est une instruction SQL SELECT, les données sont extraites de la base de données. Si l'interrogation extrait des données d'un fichier, le fichier est lu. Si l'interrogation est une interrogation personnalisée, sa procédure d'interrogation personnalisée est exécutée.


Format de nombre - Boîte de dialogue

Permet d'ajouter, de supprimer ou d'appliquer des masques de format de nombre.

Options de la boîte de dialogue

Format

Permet d'indiquer la chaîne de format à ajouter à la liste, à supprimer de la liste ou à appliquer à un objet. Cette chaîne doit être un masque de format de nombre Oracle SQL valide. Pour plus d'informations, reportez-vous à Oracle7 Server SQL Language Reference Manual.

Ajouter

Permet d'ajouter à la liste des formats disponibles le masque de format affiché dans le champ de texte Format.

Supprimer

Permet de supprimer de la liste des formats disponibles le masque de format affiché dans le champ de texte Format.

OK

Permet d'accepter les modifications et de fermer la boîte de dialogue. Le cas échéant, le masque de format sélectionné est appliqué aux objets sélectionnés.


Ouverture depuis la base - Boîte de dialogue

Permet d'afficher la liste des modules stockés dans la base de données.

Options de la boîte de dialogue

Nom

Permet d'indiquer le nom de l'affichage à ouvrir. Le nom de l'affichage sélectionné dans la liste apparaît dans ce champ. Vous pouvez également y entrer un nom directement.

MàJ liste

Permet de mettre à jour la liste des affichages stockés.

OK

Permet d'ouvrir l'affichage dont le nom apparaît dans le champ Nom.


Renommer - Boîte de dialogue

Cette boîte de dialogue permet d'afficher la liste des modules stockés dans la base de données.

Options de la boîte de dialogue

Ancien nom

Permet d'indiquer le nom du module à renommer.

Nouveau nom

Permet d'indiquer le nouveau nom du module.

MàJ liste

Permet de mettre à jour la liste des modules stockés.

Renommer

Permet de remplacer le nom du module indiqué dans le champ de texte Ancien Nom par le nom entré dans le champ de texte Nouveau Nom.


Options de dessin - rectangles arrondis - Boîte de dialogue
Options de desssin - rectangles arrondis - Boîte de dialogue

Permet de définir les rayons de coin des rectangles arrondis.

Options de la boîte de dialogue

Rayons de coin

Permet d'indiquer les rayons de l'ellipse qui serait tracée si les arcs formant les angles arrondis se poursuivaient sur 360°. Vous pouvez définir les options suivantes :

Horizontal	Permet d'indiquer le rayon horizontal (ou x) de l'ellipse imaginaire.

Vertical	Permet d'indiquer le rayon vertical (ou y) de l'ellipse imaginaire.

Unités	Permet d'indiquer l'unité de mesure dans laquelle les rayons horizontal et vertical sont précisés.


Paramètres de règles - Boîte de dialogue

Unités

Permet d'indiquer l'unité de mesure utilisée par les règles.

Taille cellule de caractère

Permet d'indiquer, en points, les tailles horizontale et verticale d'une unité de cellule de caractère.

Pas de grille

Permet d'indiquer l'intervalle (basé sur l'unité de mesure choisie) entre deux lignes apparaissant sur la grille. Sélectionnez l'une des options proposées ou entrez une valeur personnalisée dans le champ de texte Autre.

Nombre de points magnétiques par pas de grille

Permet d'indiquer le nombre de points magnétiques par ligne de la grille. Vous pouvez utiliser les points magnétiques pour faciliter le positionnement des objets sur la présentation. Plus il y a de points magnétiques entre les lignes de la grille, mieux vous contrôlez l'emplacement des objets.

Sélectionnez l'une des options proposées ou entrez une valeur personnalisée dans le champ de texte Autre.


Enregistrement dans la base - Boîte de dialogue

Cette boîte de dialogue permet d'afficher  la liste des modules stockés dans la base de données.

Options de la boîte de dialogue

MàJ liste

Permet de mettre à jour la liste des modules stockés.

Nom

Permet d'indiquer le nom sous lequel sera stocké le module enregistré. Le nom du module sélectionné dans la liste apparaît dans ce champ. Vous pouvez également y entrer un nom directement.

OK

Permet d'enregistrer le module sélectionné. Si vous tentez d'enregistrer un affichage sous un nom déjà utilisé par un autre affichage de la base de données, un message vous demande de confirmer le remplacement de l'affichage existant.


Enregistrement dans - Boîte de dialogue

Permet d'indiquer l'endroit où vous voulez enregistrer le module.

Options de la boîte de dialogue

Système de fichiers	Permet d'afficher la boîte de dialogue d'enregistrement de fichier de votre système.

Base données	Permet d'afficher la boîte de dialogue d'enregistrement dans la base.


Options de dessin - texte - Boîte de dialogue

Permet de définir l'origine du texte, la boîte englobante, le renvoi à la ligne et d'autres options.

Options de la boîte de dialogue

Origine horizontale

Permet d'indiquer la position horizontale de l'objet texte par rapport à son point d'origine. Vous avez le choix entre les options suivantes :

A gauche	Permet d'indiquer que le point d'origine se trouve le long du bord gauche de la boîte englobante.

Au centre	Permet d'indiquer que le point d'origine se trouve le long du centre horizontal de la boîte englobante.

A droite	Permet d'indiquer que le point d'origine se trouve le long du bord droit de la boîte englobante.

Origine verticale

Permet d'indiquer la position verticale de l'objet texte par rapport à son point d'origine. Vous avez le choix entre les options suivantes :

Coin supérieur	Permet d'indiquer que le point d'origine se trouve le long du bord supérieur de la boîte englobante.

Au centre	Permet d'indiquer que le point d'origine se trouve le long du centre vertical de la boîte englobante.

Coin inférieur	Permet d'indiquer que le point d'origine se trouve le long du bord inférieur de la boîte englobante.

Polices proportionnelles

Permet d'indiquer si les polices sont redimensionnées lorsque l'objet texte est redimensionné.

Texte invisible

Permet d'indiquer si le texte est visible ou invisible.

Boîte englobante prédéfinie

Permet d'indiquer si la boîte englobante de l'objet texte est automatiquement redimensionnée en fonction de la forme du texte qu'elle contient.

Renvoi à la ligne

Permet d'indiquer si, au cas où une ligne de texte est plus longue que la largeur de l'objet texte, le ou les mots trop longs pour la ligne sont automatiquement renvoyés au début de la ligne suivante. Cette option est désactivée si Boîte englobante prédéfinie n'est pas cochée pour indiquer que la boîte englobante s'adapte automatiquement à la forme du texte.

Boîte englobante variable

Permet d'indiquer si la taille de la boîte englobante est modifiée lorsque l'objet texte est redimensionné. Cette option est désactivée si Boîte englobante prédéfinie n'est pas cochée pour indiquer que la boîte englobante s'adapte automatiquement à la forme du texte.


Utilisation de Oracle  Help

L'interface Oracle Help portable est utilisée sur les systèmes qui n'ont pas d'interface de système d'aide standard.

Options de Oracle Help

Table des matières

Permet d'afficher la table des matières du document d'aide. Pour afficher des informations d'aide sur une rubrique, sélectionnez-la, puis choisissez Atteindre.

Index

Permet d'afficher l'index du document Aide. Pour afficher des informations d'aide sur une rubrique, sélectionnez-la, puis choisissez Atteindre.

Historique

Permet d'afficher la boîte de dialogue d'historique dans lequel figure le chemin d'accès aux rubriques du système d'aide que vous avez utilisées pendant votre session de consultation de l'aide. Cette fonction vous permet de voir où vous êtes allé et l'ordre des opérations et de revenir sur une rubrique de la boîte de dialogue d'historique en la sélectionnant et en choisissant Atteindre. Les rubriques sont affichées en ordre chronologique inverse.

Revenir à

Permet d'afficher les informations d'aide sur la dernière rubrique que vous avez consultée avant la rubrique en cours. Vous pouvez utiliser Revenir à plusieurs fois, pour revenir sur le chemin que vous avez suivi dans le document d'aide. Le chemin "arrière" que vous suivez est défini par la liste de la boîte de dialogue d'historique.

Signet

Permet d'attribuer un signet à la rubrique d'aide en cours pour que vous puissiez y revenir ultérieurement en sélectionnant à nouveau Signet, puis Atteindre signet.

Précédent

Permet d'afficher le chapitre précédent.

Suivant

Permet d'afficher le chapitre suivant.

Imprimer

Permet d'imprimer une rubrique d'aide.

Chercher

Permet de rechercher dans le document d'aide la chaîne que vous indiquez.

Fermer

Permet de quitter le système d'aide et de revenir à Graphics Builder.


Interface de l'Editeur de déclencheur de base de données

  Rubriques connexes

L'Editeur de déclencheur de base de données permet de créer et de modifier les déclencheurs BEFORE/AFTER des tables, ainsi que les déclencheurs INSTEAD OF des vues et des vues d'objet (si vous êtes connecté à Oracle8).

Pour définir un nouveau déclencheur :

1	Sélectionnez un nom utilisateur (schéma) dans la liste déroulante Propriétaire de la table.

2	Sélectionnez un nom de table dans la liste déroulante Table.

Elle répertorie les noms des tables appartenant à l'utilisateur qui apparaît dans le champ Propriétaire de la table. Si vous sélectionnez un nom utilisateur différent du vôtre dans ce champ, la liste déroulante Table ne répertorie que les tables auxquelles vous avez accès parmi celles du propriétaire sélectionné.

(Concerne uniquement les vues.) Pour définir un déclencheur INSTEAD OF pour une vue d'objet, cliquez sur la flèche située à côté de la liste Table pour afficher la liste déroulante, puis sélectionnez Vue. Choisissez ensuite un nom de vue dans la liste déroulante Vue.

3	Cliquez sur Nouveau pour créer un déclencheur de base de données.

Un nom de déclencheur unique (par rapport aux autres déclencheurs appartenant au même schéma) est affecté automatiquement au nouveau déclencheur, dans la liste déroulante Nom. Vous pouvez modifier ce nom.

La liste déroulante Nom répertorie les noms des déclencheurs associés à la table (ou à la vue) affichée dans le champ Table (ou Vue). Elle ne répertorie que les noms des déclencheurs de base de données associés aux tables auxquelles vous avez accès.

4	Indiquez les options de déclenchement.

Les sections suivantes vous informent sur les différentes options que vous pouvez utiliser pour définir un déclencheur de base de données dans l'Editeur de déclencheur de base de données.

5	Une fois les options et l'action du déclencheur indiquées, cliquez sur Enregistrer pour compiler le déclencheur.

Options de déclenchement :

Avant/Après	(Concerne uniquement les tables.) Correspond à l'option BEFORE ou AFTER de la commande SQL CREATE TRIGGER. Permet d'indiquer l'instant d'activation du corps du déclencheur par rapport à l'instruction de déclenchement (par exemple, UPDATE, INSERT ou DELETE) exécutée. Les déclencheurs BEFORE sont activés avant l'exécution de l'instruction de déclenchement et les déclencheurs AFTER, après cette exécution. Les déclencheurs BEFORE et AFTER concernent les déclencheurs sur ligne et sur instruction.
Au lieu de	(Concerne uniquement les vues.) Correspond à l'option INSTEAD OF de la commande SQL CREATE TRIGGER. Oracle active le déclencheur au lieu d'exécuter l'instruction de déclenchement. Le déclencheur effectue les travaux d'insertion, de mise à jour ou de suppression directement dans les tables de base de la vue.

Cases à cocher Instruction :

UPDATE INSERT DELETE	Permet d'indiquer le type d'instruction SQL (instruction de déclenchement) qui active le corps du déclencheur. Les options possibles sont UPDATE, INSERT et DELETE. Cochez une ou plusieurs cases pour inclure la ou les options correspondantes dans l'instruction de déclenchement. Si cette instruction indique UPDATE, une liste facultative de colonnes peut être incluse dans l'instruction de déclenchement. Reportez-vous à l'option Des colonnes ci-après. Si vous sélectionnez plusieurs options, vous pouvez utiliser les prédicats conditionnels UPDATING, INSERTING et DELETING pour exécuter des blocs de code précis dans le corps du déclencheur. Reportez-vous à l'option Corps de déclencheur ci-après.

Option Des colonnes :

Des colonnes	(Concerne uniquement les tables.) Correspond à la clause OF figurant dans l'instruction de déclenchement UPDATE de la commande SQL CREATE TRIGGER. Cette option affiche la liste des colonnes de la table sélectionnée dans le champ Table. Cette liste n'est active que si l'instruction de déclenchement indique UPDATE. Cliquez sur une ou plusieurs colonnes dans cette liste pour indiquer que le déclencheur est activé uniquement lorsque l'une des colonnes sélectionnées est mise à jour. Si vous voulez que le déclencheur soit activé lorsqu'une colonne quelconque de la table est mise à jour, ne cliquez sur aucun nom de colonne. Cette option n'est pas disponible avec les déclencheurs INSTEAD OF. Oracle active ce type de déclencheur chaque fois qu'une instruction UPDATE modifie une valeur dans une colonne quelconque de la vue. Objets Oracle8 : vous ne pouvez pas indiquer de colonnes de tables imbriquées ou de colonnes LOB dans la clause OF.

Option Pour chaque instruction :

Instruction	Correspond à l'option FOR EACH STATEMENT de la commande SQL CREATE TRIGGER. Indique que le déclencheur est un déclencheur sur instruction. Oracle n'exécute qu'une seule fois ce type de déclencheur, au moment de la génération de l'instruction de déclenchement (indépendamment du nombre de lignes concernées), si la contrainte du déclencheur facultatif définie dans la clause WHEN est remplie. Cette option n'est pas disponible avec les déclencheurs INSTEAD OF.

Options Pour chaque ligne :

Ligne	Correspond à l'option FOR EACH ROW de la commande SQL CREATE TRIGGER. Indique que le déclencheur est un déclencheur sur ligne. Oracle n'exécute ce type de déclencheur qu'une seule fois pour chaque ligne affectée par l'instruction de déclenchement, et si cette ligne remplit la contrainte du déclencheur facultatif, telle qu'elle est définie dans la clause WHEN.
Création de références	Indique les noms de corrélation. Vous pouvez les utiliser dans le corps du déclencheur et dans la clause WHEN d'un déclencheur sur ligne pour faire référence de manière spécifique aux nouvelles et aux anciennes valeurs de la ligne en cours. Les noms de corrélation par défaut sont OLD et NEW. Si votre déclencheur sur ligne est associé à une table appelée OLD ou NEW, utilisez cette option pour indiquer des noms de corrélation différents, afin d'éviter toute confusion entre les noms de table et de corrélation. Concerne uniquement les déclencheurs sur ligne.
OLD comme	Permet d'indiquer un nom de corrélation pour éviter tout conflit de noms entre le nom de corrélation et le nom d'une table appelée OLD.
NEW comme	Permet d'indiquer un nom de corrélation pour éviter tout conflit de noms entre le nom de corrélation et le nom d'une table appelée NEW.
Lorsque	(Concerne uniquement les tables.) Correspond à l'expression booléenne SQL dans une clause WHEN de la commande SQL CREATE TRIGGER. Concerne uniquement les déclencheurs sur ligne. Indique une restriction de déclencheur facultatif. Si elle est incluse, l'expression SQL est calculée pour chaque ligne concernée par le déclencheur. Si le résultat du calcul de l'expression est TRUE pour une ligne, le corps du déclencheur est activé. Si le résultat du calcul de l'expression est FALSE ou NOT TRUE pour une ligne (c'est-à-dire inconnue, comme avec des valeurs nulles), le corps du déclencheur n'est pas activé. Objets Oracle8 : vous pouvez référencer les colonnes d'objets ou leurs attributs, l'élément VARRAY, une table imbriquée ou les colonnes LOB. Vous ne pouvez appeler ni les fonctions PL/SQL, ni les méthodes de restriction de déclenchement.

Indiquez l'action du déclencheur dans :

Corps du déclencheur	Le bloc PL/SQL d'Oracle est exécuté pour activer le déclencheur. Il s'agit d'une zone de texte multiligne déroulante, dans laquelle vous pouvez entrer et éditer un corps de déclencheur de base de données PL/SQL. Les corps de déclencheur peuvent comporter des instructions SQL et PL/SQL. Les mots-clés BEGIN et END sont requis. Le corps des déclencheurs sur ligne peut contenir des noms de corrélation et l'option REFERENCING, ainsi que les prédicats conditionnels INSERTING, DELETING et UPDATING. Si plusieurs types d'instruction de déclenchement sont indiqués pour le déclencheur sur ligne (par exemple, INSERT et UPDATE), vous pouvez inclure les conditions suivantes afin d'exécuter des blocs de code précis dans le corps du déclencheur : IF INSERTING THEN…END IF; IF UPDATING THEN…END IF;

L'Editeur contient les boutons suivants :

Nouveau	Crée un nouveau déclencheur de base de données. Cliquez sur Nouveau pour lancer la définition d'un nouveau déclencheur.
Enregistrer	Permet d'enregistrer les options du déclencheur et de compiler la source qui figure dans le champ Corps de déclencheur. Les messages d'erreur générés par la compilation apparaissent dans un message distinct.
Rétablir	Permet de rendre au déclencheur de base de données l'état dans lequel il se trouvait lors de la dernière opération d'enregistrement ou de rétablissement.
Eliminer	Permet de supprimer de la base de données le déclencheur de base de données en cours, après confirmation.
Fermer	Permet de quitter l'Editeur de déclencheur de base de données.
Aide	Affiche la présente rubrique d'aide.


A propos des déclencheurs de base de données

Les déclencheurs de base de données sont des procédures stockées dans la base de données et implicitement exécutées lorsqu'une instruction de déclenchement, telle qu'INSERT, UPDATE ou DELETE, est créée dans la table associée. Les déclencheurs ne peuvent être définis que sur les tables, et non sur les vues. Toutefois, les déclencheurs portant sur la table de base d'une vue sont activés si une instruction INSERT, UPDATE ou DELETE est créée dans une vue.

Un déclencheur peut contenir des instructions SQL et PL.SQL fonctionnant en tant qu'entité distincte, ou appeler d'autres procédures stockées. N'utilisez des déclencheurs qu'en cas de nécessité absolue. Leur utilisation excessive peut provoquer l'apparition de déclencheurs en cascade ou récursifs. Par exemple, lorsque vous activez un déclencheur, toute instruction SQL du corps de ce déclencheur peut activer d'autres déclencheurs.

L'utilisation des déclencheurs de base de données permet de mettre en place des règles complexes et d'assurer un comportement uniforme de toutes les applications. Pour créer des déclencheurs, suivez les directives ci-dessous :

•	Utilisez des déclencheurs pour assurer que la réalisation d'une opération donnée entraîne la réalisation des actions connexes.

•	N'utilisez des déclencheurs de base de données que pour les opérations centralisées ou globales, qui doivent être activées pour l'instruction de déclenchement quel que soit l'utilisateur ou l'application de base de données à l'origine de l'instruction.

•	Ne définissez aucun déclencheur reproduisant une fonctionnalité déjà intégrée à Oracle. Par exemple, ne définissez aucun déclencheur qui impose des règles d'intégrité des données, car ces règles sont facilement applicables à l'aide des contraintes d'intégrité déclaratives.

•	Limitez la taille des déclencheurs (un maximum de 60 lignes est une limite correcte). Si la logique de votre déclencheur nécessite bien plus de 60 lignes de code PL/SQL, incluez la majeure partie du code dans une procédure stockée, puis appelez cette dernière à partir du déclencheur.

•	Veillez à ne pas créer de déclencheurs récursifs. Par exemple, la création d'un déclencheur sur instruction AFTER UPDATE sur la table EMP, qui crée lui-même une instruction UPDATE sur cette table EMP, entraîne une activation récursive du déclencheur jusqu'à épuisement de la mémoire.

Pour plus d'informations sur l'utilisation des déclencheurs dans les applications, reportez-vous au manuel Oracle8 Application Developer's Guide. Pour plus d'informations sur les différents types de déclencheur, reportez-vous au manuel Oracle8 Concepts Manual.


Affiche l'ID utilisateur du propriétaire de la table de base de données en cours. Cliquez sur la flèche à droite de ce champ pour afficher une liste déroulante d'utilisateurs.


Affiche le nom de la table ou de la vue de base de données en cours. Cliquez sur la flèche à droite de ce champ pour afficher une liste déroulante des tables ou des vues appartenant à l'utilisateur indiqué dans le champ Propriétaire de table. Cliquez sur une table ou sur une vue de la liste pour la sélectionner. La liste n'affiche que les noms des tables ou des vues de base de données auxquelles vous avez accès. (Les vues ne concernent qu'Oracle8)


Affiche le nom du déclencheur de base de données en cours. Cliquez sur la flèche à droite de ce champ pour afficher une liste déroulante des noms de déclencheur pour la table ou la vue indiquée dans le champ Table/Vue. La liste Nom n'affiche que les noms des déclencheurs de base de données auxquels vous avez accès.


Permet d'indiquer si le corps du déclencheur est activé par l'exécution de l'instruction de déclenchement (par exemple, UPDATE, INSERT ou DELETE). Ce groupe de boutons d'option correspond aux options BEFORE, AFTER et INSTEAD OF de la commande SQL CREATE TRIGGER.


Permet d'indiquer que le déclencheur est activé avant l'instruction de déclenchement.


Permet d'indiquer que le déclencheur est activé après l'instruction de déclenchement.


Permet d'indiquer qu'Oracle active le déclencheur au lieu d'exécuter l'instruction de déclenchement. Concerne uniquement les vues.


Permet d'indiquer le type d'instruction SQL qui active le corps du déclencheur. Les options possibles sont UPDATE, INSERT et DELETE. Cliquez sur une ou plusieurs des cases à cocher pour activer l'option. Concerne uniquement les tables.


Permet d'indiquer que le déclencheur est activé sur un événement INSERT.


Permet d'indiquer que le déclencheur est activé sur un événement DELETE.


Permet d'indiquer que le déclencheur est activé sur un événement UPDATE.


Affiche la liste des colonnes de la table sélectionnée dans le champ Table. Cette liste n'est active que si l'option UPDATE est activée dans le champ Instruction. Concerne uniquement les tables.


Permet d'indiquer un déclencheur sur ligne. Correspond à l'option FOR EACH ROW de la commande CREATE TRIGGER.


Permet d'indiquer un déclencheur sur instruction. Correspond à l'option FOR EACH STATEMENT de la commande CREATE TRIGGER.


Permet d'indiquer un nom de corrélation pour éviter tout conflit de noms entre le nom de corrélation et le nom d'une table ou d'une vue appelée OLD.


Permet d'indiquer un nom de corrélation pour éviter tout conflit de noms entre le nom de corrélation et le nom d'une table ou d'une vue appelée NEW.


Permet d'indiquer une expression booléenne SQL dans une clause WHEN. Si elle est incluse, l'expression de la clause WHEN est calculée pour chaque ligne concernée par le déclencheur. Si le résultat du calcul de l'expression est TRUE pour une ligne, le corps du déclencheur est activé. Si le résultat du calcul de l'expression est FALSE ou NOT TRUE (c'est-à-dire inconnue, comme avec des valeurs nulles) pour une ligne, le corps du déclencheur n'est pas activé. Concerne uniquement les tables.


Est une boîte de texte multiligne défilante, dans laquelle vous pouvez entrer et éditer un corps de déclencheur de base de données PL/SQL. Les corps de déclencheur sont des blocs PL/SQL qui peuvent comporter des instructions SQL et PL/SQL.


Crée un nouveau déclencheur de base de données sans nom.


Permet d'enregistrer les options du déclencheur et de compiler la source qui figure dans le champ Corps de déclencheur. Les messages d'erreur générés par la compilation apparaissent dans d'un message séparé.


Permet de rendre au déclencheur de base de données l'état dans lequel il se trouvait lors de la dernière opération d'enregistrement ou de rétablissement. Si aucune opération d'enregistrement ou de rétablissement n'a été exécutée, le déclencheur reprend son état d'origine.


Permet de supprimer de la base de données le déclencheur de base de données en cours, après confirmation.


Interface Interpréteur PL/SQL

L'Interpréteur PL/SQL est l'espace de travail de débogage, où vous pouvez afficher le code source, créer des actions de débogage, lancer des unités de programme et exécuter des commandes de l'Interpréteur, et des instructions PL/SQL et SQL.

Par défaut, deux fenêtres sont toujours ouvertes dans l'Interpréteur PL/SQL : la fenêtre Source et la fenêtre Interpréteur.

Boutons de barre d'outils standard  Toutes les fenêtres de l'Interpréteur ont la même barre d'outils. A l'exception de Fermer, les boutons décrits ci-dessous ne sont activés que pendant la suspension de l'exécution d'une unité de programme et sont utilisés pour le débogage.

Step Into		Reprend l'exécution de l'unité de programme interrompue, jusqu'à l'instruction exécutable suivante.
Step Over		Reprend l'exécution de l'unité de programme interrompue, jusqu'à l'instruction exécutable suivante, en sautant tous les appels aux sous-programmes imbriqués.
Step Out		Reprend l'exécution du sous-programme imbriqué, en suspendant l'exécution à la prochaine instruction exécutable dans l'unité de programme appelante.
Atteindre		Reprend l'exécution de l'unité de programme interrompue, jusqu'à la fin de l'unité de programme ou la prochaine action de débogage.
Réinitialiser		Sort du niveau de débogage en cours. Au niveau 1, l'exécution interrompue est abandonnée.
Fermer		Ferme la fenêtre Interpréteur.
Aide		Affiche cette rubrique d'aide.

Fenêtre Source  La fenêtre Source affiche en lecture seule une copie de l'unité de programme sélectionnée. Les mots-clés, les commentaires, les chaînes et les symboles sont colorés différemment. La première colonne de la marge gauche est réservée aux icônes ou aux symboles. Les lignes source sont numérotées dans la seconde colonne. Les icônes suivantes peuvent être affichées :

flèche jaune		Indique l'emplacement ou le PC d'exécution en cours (compteur d'instruction).
rond rouge		Indique un point d'interruption ou un déclencheur activé.
rond vert		Indique un point d'interruption ou un déclencheur désactivé.

Les symboles suivants peuvent également apparaître dans la fenêtre Source :

|	Indique l'emplacement du source en cours.  Cet emplacement change à la suite de l'exécution de commandes de l'Interpréteur (LIST par exemple) ou lorsque l'exécution de l'unité de programme est interrompue par une action de débogage (un point d'interruption, par exemple).
B(n)	Indique l'emplacement d'un point d'interruption, où n est l'ID d'action de débogage correspondant.
T(n)	Indique l'emplacement d'un déclencheur de débogage, où n est l'ID d'action de débogage correspondant.

La fenêtre Source offre un menu instantané comprenant les commandes suivantes (sous Windows, cliquez avec le bouton droit de la souris) :

Arrêt	Affiche la boîte de dialogue Point d'interruption, dans laquelle vous pouvez définir un nouveau point d'interruption.
Déclencheur	Affiche la boîte de dialogue Déclencheur, dans laquelle vous pouvez définir un nouveau déclencheur de débogage.
Edition	Affiche l'Editeur d'unité de programme, dans lequel vous pouvez éditer l'unité de programme en cours.

Remarque : Les systèmes ne prennent pas tous en charge les menus instantanés. Les commandes ci-dessus figurent également dans le menu Débogage.

Barres de partage Les barres de partage permettent de modifier la place relative occupée par chaque fenêtre dans l'Interpréteur. Lorsque l'Interpréteur apparaît pour la première fois, une barre sépare la fenêtre Source de la fenêtre Interpréteur. Une seconde barre de partage s'affiche si vous utilisez l'Interpréteur modal ou que vous ayez inséré la fenêtre Navigateur dans l'Interpréteur sans mode.

Fenêtre Interpréteur  La fenêtre Interpréteur constitue une interface de ligne de commande avec PL/SQL, Procedure Builder et SQL. Vous pouvez entrer des instructions ou des blocs PL/SQL, des commandes de l'Interpréteur de Procedure Builder ou des instructions SQL après l'invite PL/SQL>. (Les instructions et la syntaxe SQL*Plus ne sont pas prises en charge.)

Commandes multilignes  Lorsque vous entrez une syntaxe PL/SQL à l'invite PL/SQL>, vous pouvez toujours appuyer sur la touche Entrée pour afficher une invite secondaire sous la forme +>. Affichez autant d'invites secondaires successives que nécessaire avant d'exécuter le code terminé par un point-virgule (;).

Niveaux de débogage  Lorsque l'exécution d'un programme est interrompue par une action de débogage, l'Interpréteur établit un niveau de débogage. A ce niveau, vous pouvez entrer des commandes et des instructions PL/SQL, qui peuvent à leur tour être interrompues, entraînant l'imbrication des niveaux de débogage. Le niveau de débogage en cours est indiqué par une nouvelle invite de la fenêtre Interpréteur, qui comporte un préfixe contenant le numéro de niveau de débogage en cours. Par exemple, l'invite de l'interpréteur au niveau de débogage 1 s'affiche de la manière suivante :

(debug 1)PL/SQL>

Menu instantané  La fenêtre Interpréteur affiche un menu instantané proposant les commandes suivantes (sous Windows, cliquez avec le bouton droit de la souris) :

Effacer	Annule tout le texte de la fenêtre Interpréteur et émet une nouvelle invite.
Nouvelle invite	Affiche une nouvelle invite dans la fenêtre Interpréteur. Aucune entrée après l'invite précédente n'est prise en compte.
Remarque : Les systèmes ne prennent pas tous en compte les menus instantanés.

Fenêtre Navigateur  La fenêtre Navigateur permet d'afficher la pile d'appels en cours et éventuellement de modifier les valeurs des paramètres et des variables locales à l'emplacement de travail en cours, pendant le débogage. Vous pouvez insérer cette fenêtre entre la fenêtre Source et la fenêtre Interpréteur pour travailler entièrement dans l'Interpréteur tout en déboguant vos unités de programme. Pour ce faire, choisissez Affichage [image] Fenêtre Navigateur dans le menu. Pour masquer la fenêtre Navigateur, choisissez à nouveau cette même commande. Vous pouvez également masquer toutes les autres fenêtres en sélectionnant la commande adéquate dans le menu Affichage.

Barre d'outils Navigateur  Lorsque la fenêtre Navigateur est affichée, la barre d'outils comporte également les boutons suivants :

Créer		Crée une nouvelle instance de l'objet ou du noeud sélectionné.
Supprimer		Supprime l'objet sélectionné après confirmation.
Développer		Développe le premier niveau de sous-noeud du noeud sélectionné.
Réduire		Réduit le niveau de sous-noeud sélectionné du noeud actuellement affiché.
Développer tout		Développe tous les niveaux de sous-noeuds du noeud sélectionné. Toutefois, cette commande ne développe pas de façon récurrente les noeuds de type de données et d'attributs Oracle8.
Réduire tout		Réduit tous les niveaux de sous-noeud du noeud sélectionné.
Rechercher (zone de texte)		Permet de rechercher un objet dans le Navigateur en saisissant tout ou partie de son nom.
Recherche avant		Recherche l'occurrence suivante du critère de recherche indiqué dans la zone de texte Rechercher.
Recherche arrière		Recherche l'occurrence précédente du critère de recherche indiqué dans la zone de texte Rechercher.


Reprend l'exécution de l'unité de programme interrompue à la prochaine instruction exécutable.


Reprend l'exécution de l'unité de programme interrompue à la prochaine instruction exécutable, en sautant tous les appels aux sous-programmes imbriqués.


Reprend l'exécution d'un sous-programme imbriqué, en suspendant l'exécution à la prochaine instruction exécutable dans l'unité de programme appelante.


Reprend l'exécution de l'unité de programme interrompue à la fin de l'unité de programme ou à la prochaine action de débogage.


Sort du niveau de débogage en cours. Au niveau 1, l'exécution interrompue est abandonnée.


Crée une nouvelle instance de l'objet ou du noeud sélectionné.


Supprime l'objet sélectionné après confirmation.


Développe le premier niveau de sous-noeud du noeud sélectionné.


Réduit le niveau de sous-noeud du noeud sélectionné.


Développe tous les niveaux de sous-noeud du noeud sélectionné. Le type de données Oracle8 et les noeuds d'attributs ne sont pas développés de façon récurrente.


Réduit tous les niveaux de sous-noeud du noeud sélectionné.


Entrez le nom de l'objet que vous voulez rechercher dans le Navigateur.


Indique le nom de l'unité de programme en cours et précise s'il est chargé sur le client ou le serveur.


Affiche en lecture seule une copie de l'unité de programme sélectionnée, avec les lignes source numérotées dans la seconde colonne.


 Les barres de partage permettent de modifier la place relative occupée par chaque fenêtre dans l'Interpréteur. Lorsque l'Interpréteur apparaît pour la première fois, une barre sépare la fenêtre Source de la fenêtre Interpréteur. Une seconde barre de partage apparaît si vous utilisez l'Interpréteur modal ou que vous ayez inséré la fenêtre Navigateur dans l'Interpréteur sans mode.


La fenêtre Navigateur d'objet permet d'afficher la pile d'appels en cours et éventuellement de modifier les valeurs des paramètres et des variables locales à l'emplacement de travail en cours, pendant le débogage.


La fenêtre Interpréteur constitue une interface de ligne de commande avec PL/SQL, Procedure Builder et SQL. Vous pouvez entrer des instructions ou des blocs PL/SQL, des commandes de l'Interpréteur de Procedure Builder ou des instructions SQL après l'invite PL/SQL>.


A propos des messages d'erreur

Chaque composant a son propre préfixe de messages d'erreur :

Préfixe	Composant
FRM	Form Builder
OG	Graphics Builder
PDE	Procedure Builder
REP	Report Builder
BRW	Query Builder
BRS	Schema Builder
NX, XBD	Translation Builder
Remarque : Sous Unix, Report Builder attribue la valeur 0 (opération réussie) ou 1 (échec de l'opération) à la variable $status qui apparaît dans certains messages.

Aux messages d'erreur d'Oracle Developer peuvent éventuellement s'ajouter des messages d'erreur provenant d'autres sources  :

Préfixe	Source	Aide
ORA	Oracle Server	Manuel Oracle7 Server Messages ou Oracle8 Error Messages
PLS	PL/SQL	Manuel Oracle7 Server Messages ou Oracle8 Error Messages
NET	SQL*Net	Manuel Oracle Network Products Messages
Les manuels Oracle7 Server Messages et Oracle8 Error Messages contiennent les codes et les descriptions des messages d'erreur de tous les utilitaires de base de données comme SQL*DBA, SQL*Loader, SQL*Module, Export, Import et les pré-compilateurs Oracle.

Les messages d'erreur propres au système sont expliqués dans la documentation de votre système d'exploitation.


Recours au Support technique Oracle

Dans certains cas (erreurs internes, par exemple), vous devrez faire appel au Support technique Oracle, mais auparavant, nous vous conseillons de réunir les informations suivantes :

1	Votre nom, celui de votre société, votre ID de Support technique Oracle.

2	Le matériel, le système d'exploitation et le numéro de version du système d'exploitation utilisé.

3	Le numéro complet de version du composant que vous utilisiez lorsque l'erreur s'est produite et, notamment, le numéro de révision et le numéro du port, le cas échéant. (Pour connaître le numéro de version des composants, choisissez Aide [image] A propos de.)

4	Tous les autres produits (et leur numéro de version) utilisés lorsque l'erreur s'est produite (par exemple, Oracle 7.1.4).

5	Si vous avez reçu un ou plusieurs messages d'erreur, le numéro et le texte exacts des messages et l'ordre dans lequel ils sont apparus.

6	Une description du problème et, notamment, des conditions inhabituelles.

7	La gravité du problème, selon les codes suivants :

•	1 : Programme inutilisable. Impact critique sur les opérations.

•	2 : Programme utilisable. Opérations très limitées.

•	3 : Programme utilisable, mais avec des fonctions limitées. Non critique pour les opérations globales.

•	4 : Problème réglé par le client. Effet minime, voire nul, sur les opérations.


Conditions anormales

Certaines erreurs qui peuvent se produire sont connues sous le nom de conditions anormales. Celles-ci peuvent avoir l'une des causes suivantes :

•	Un utilisateur a effectué une opération qui a empêché votre application d'achever la tâche demandée : il a, par exemple, sauté l'interface utilisateur et, lors de la modification des données dans une table de base de données, a entré une valeur non valide.

•	Une bogue logicielle a empêché la réalisation de la tâche requise.

Action  Contactez tout d'abord votre administrateur système pour savoir si le message a une autre cause qu'Oracle Developer. Si vous pouvez déterminer que le message ne provient pas d'une erreur de l'utilisateur ou d'un problème système, contactez le Support technique Oracle.


A propos de l'utilitaire de conversion PL/SQL V1

  Rubriques connexes

L'utilitaire de conversion PL/SQL V1 facilite l'automatisation de la mise à niveau de vos applications écrites en PL/SQL V1 ou V2.

Si les déclencheurs, les unités de programme et les blocs PL/SQL de vos applications Forms, états et affichages version 1 sont écrits en PL/SQL V1 ou V2, le code correspondant doit être mis à niveau. Sinon, vous risquez deux types de problèmes :

•	Une partie du code PL/SQL V1 ou V2 n'est pas valide, sur le plan syntactique, dans les versions ultérieures et génère une erreur de compilation.

•	Une partie du code PL/SQL V1 ou V2 est correcte sur le plan syntactique dans les versions ultérieures, mais a une signification différente, qui entraîne un comportement inattendu ou incorrect.

L'utilitaire de conversion gère ces deux types de problèmes.


Fonctionnement de l'utilitaire de conversion PL/SQL V1

  Rubriques connexes

Vous pouvez utiliser l'utilitaire de conversion de manière interactive ou en mode de traitement par lots. Dans un cas comme dans l'autre, c'est vous qui décidez si l'utilitaire doit mettre votre code à jour. Le mode interactif offre une plus grande flexibilité, car vous pouvez effectuer certaines corrections en automatique et d'autres en manuel. En mode de traitement par lots, l'utilitaire exécute lui-même toutes les conversions ou n'en exécute aucune. Quel que soit le mode choisi, un récapitulatif du processus de conversion est transmis à un fichier journal appelé module.plg.

Pour exécuter l'utilitaire de manière interactive, ouvrez une application Forms, un état, un affichage ou une bibliothèque contenant un code PL/SQL V1 ou V2 dans le Builder associé.

Pour exécuter l'utilitaire en mode de traitement par lots, reportez-vous aux rubriques suivantes :

•	Conversion d'applications Forms en mode de traitement par lots

•	Conversion d'états en mode de traitement par lots

•	Conversion d'affichages en mode de traitement par lots

Conseil

L'utilitaire de conversion peut faire évoluer votre code pour régler plusieurs incompatibilités de V1 ou V2, mais ne peut pas régler tous les problèmes. Ceux qui ne peuvent pas être réglés entraînent des erreurs de compilation, qui sont énumérés dans la boîte de dialogue de récapitulatif de conversion (mode interactif) de PL/SQL V1 ou dans le fichier journal, afin que vous puissiez les régler manuellement. Pour plus d'informations, reportez-vous à Conversions que l'utilitaire ne peut pas effectuer .

Lorsque l'utilitaire a converti et enregistré une application, même si vous décidez de ne pas tenir compte des conversions suggérées, l'utilitaire n'est jamais appelé à nouveau pour cette application, pour ne pas écraser accidentellement vos modifications manuelles.


Avant de choisir le mode à utiliser, tentez de convertir interactivement quelques modules pour chaque type. Vous aurez alors une idée des difficultés associées à chaque module et pourrez déterminer la marche à suivre. Par exemple, vous pourriez découvrir que vos applications Forms nécessitent un contrôle assidu que vous offre le mode interactif, alors que vos états et vos bibliothèques PL/SQL peuvent être convertis en toute sécurité en mode de traitement par lots.


Utilisation interactive de l'utilitaire de conversion PL/SQL V1

  Rubriques connexes

Pour utiliser de manière interactive l'utilitaire de conversion, ouvrez une grille, un état, un affichage ou une bibliothèque contenant le code PL/SQL V1 ou V2 dans l'application Builder associée, puis enregistrez cette dernière.

Important :

•	Lorsque l'utilitaire de conversion a converti une application même si vous décidez de ne pas tenir compte des conversions suggérées l'utilitaire n'est jamais appelé à nouveau pour cette application, pour ne pas écraser accidentellement vos modifications manuelles.

Toute instruction PL/SQL V1 ou V2 dans votre déclencheur, votre bloc PL/SQL ou votre unité de programme apparaît dans la boîte de dialogue Conversion. Cette dernière explique aussi les mesures que prendra l'utilitaire de conversion si vous choisissez d'effectuer la conversion. Vous pouvez décider d'accepter ou d'ignorer la modification proposée, de convertir l'application entière ou encore d'arrêter entièrement le processus. (Vous pouvez aussi utiliser la boîte de dialogue des options de conversion de PL/SQL V1 pour définir les paramètres qui contrôlent le processus de conversion.)

L'utilitaire effectue le suivi des modifications effectuées (et de celles que vous n'avez pas appliquées) et les résume à l'issue du processus de conversion dans un fichier journal appelé module.plg. Vous pouvez ensuite appeler l'Editeur PL/SQL pour mettre l'application à jour manuellement.


Utilisation de l'utilitaire de conversion PL/SQL V1 en mode de traitement par lots

  Rubriques connexes

Pour exécuter l'utilitaire en mode de traitement par lots, reportez-vous aux rubriques suivantes :

•	Conversion d'applications Forms en mode de traitement par lots

•	Conversion d'états en mode de traitement par lots

•	Conversion d'affichages en mode de traitement par lots


Conversion d'applications Forms en mode de traitement par lots

  Rubriques connexes

Pour convertir une application Forms en mode de traitement par lots :

1	Assurez-vous que vous avez converti toutes les bibliothèques PL/SQL attachées à l'application Forms.

2	Puis :

•	Lancez la version GUI de Form Compiler

•	Exécutez Form Compiler à partir de la ligne de commande.

Quelle que soit la méthode choisie, un récapitulatif du processus est automatiquement écrit dans le fichier journal module.plg, où module est le nom du module application Forms converti.

Note d'utilisation :

•	Lorsque l'utilitaire de conversion a converti une application même si vous décidez de ne pas tenir compte des conversions suggérées l'utilitaire n'est jamais appelé à nouveau pour cette application, pour ne pas écraser accidentellement vos modifications manuelles.


Conversion d'applications Forms à l'aide de la version GUI de Form Compiler

Pour convertir une application Forms à l'aide de la version GUI de Form Compiler :

1	Cliquez deux fois sur l'icône Form Compiler.

2	Sélectionnez le type de module et l'accès module appropriés.

3	Sélectionnez la case Voulez-vous faire passer PL/SQL de V1 à V2.3 ?.

4	Cliquez sur OK.


Conversion d'applications Forms à partir de la ligne de commande

  Rubriques connexes

Pour convertir une application Forms à l'aide de Form Compiler dans la ligne de commande :

  Dans la ligne de commande, entrez :

<Form Compiler> MODULE=form BATCH=yes UPGRADE_PLSQL=yes UPGRADE=yes

où :

<Form Compiler>	Est le nom de l'exécutable Form Compiler sur votre plate-forme.
Form	Est le nom de l'application Forms à convertir.
Notes d'utilisation :

•	Si vous indiquez UPGRADE_PLSQL=YES sans indiquer également UPGRADE=YES, le système génère un message d'erreur. Comme vous ne pouvez pas convertir le PL/SQL d'une application Forms sans faire passer la totalité de l'application Forms à la version 6.0, UPGRADE=YES doit être indiqué lorsque UPGRADE_PLSQL= YES.

•	Pour convertir plusieurs affichages à la fois, utilisez Project Builder. Reportez-vous à la rubrique d'aide de Project Builder, Choix d'une méthode de mise à niveau.


Conversion de bibliothèques PL/SQL attachées à une application Forms

Pour convertir une bibliothèque PL/SQL de manière interactive :

  Ouvrez la bibliothèque dans Form Builder, puis enregistrez-la.

Pour convertir une bibliothèque PL/SQL à l'aide de la version GUI du Form Compiler :

1	Cliquez deux fois sur l'icône Form Compiler.

2	Dans le champ Fichier, sélectionnez la bibliothèque PL/SQL à convertir.

3	Dans le champ Ecrire sortie dans fichier, assurez-vous que le fichier cible a l'extension .PLL.

4	Cliquez sur OK.

Pour convertir une bibliothèque PL/SQL à l'aide de Form Compiler dans la ligne de commande :

  Dans la ligne de commande, entrez :

<Form Compiler> MODULE=library BATCH=yes UPGRADE_PLSQL=yes UPGRADE=yes

où :

<Form Compiler>	Est le nom de l'exécutable Form Compiler sur votre plate-forme.
library	Est le nom de la bibliothèque à convertir.
Note d'utilisation :

•	Si vous indiquez UPGRADE_PLSQL=YES sans indiquer également UPGRADE=YES, le système génère un message d'erreur. Comme vous ne pouvez pas convertir le PL/SQL d'une application Forms sans faire passer la totalité de l'application Forms à la version 6.0, UPGRADE=YES doit être indiqué lorsque UPGRADE_PLSQL= YES.

•	Pour convertir plusieurs affichages à la fois, utilisez Project Builder. Reportez-vous à la rubrique d'aide de Project Builder, Choix d'une méthode de mise à niveau.


Indication des paramètres du compilateur Form Builder

Le tableau ci-dessous décrit l'incidence des différentes combinaisons de paramètres BATCH, UPGRADE, et UPGRADE_PLSQL sur le processus de conversion :

BATCH	UPGRADE_PLSQL	UPGRADE	Comportement
NO	YES	YES	Le PL/SQL de l'application Forms est converti en mode de traitement par lots (même si BATCH=NO). L'utilitaire ne peut pas être appelé de manière interactive à l'extérieur du Builder.
YES	YES	YES	Le PL/SQL de l'application Forms est converti en mode de traitement par lots.
NO	NO	YES	Le PL/SQL de l'application Forms n'est pas converti, mais une liste de suggestions de conversions est écrite dans module.plg. Le reste de l'application Forms est converti en version 6.0.
YES	NO	YES	Le PL/SQL de l'application Forms n'est pas converti, mais une liste de suggestions de conversions est écrite dans module.plg. Le reste de l'application Forms est converti en Version 6.0.
NO	NO	NO	Utilisé pour compiler un nouveau FMX sans modifier le FMB. Si l'application Forms contient un PL/SQL Version 1.3, vous pouvez constater l'existence d'erreurs de compilation, ou le comportement du code peut être différent.
YES	NO	NO	Utilisé pour compiler un nouveau FMX sans modifier le FMB. Si l'application Forms contient un PL/SQL Version 1.3, vous pouvez constater l'existence d'erreurs de compilation, ou le comportement du code peut être différent.
Important :

Si vous mettez à niveau 45FMT vers 60FMB et que vous n'indiquiez pas l'option UPGRADE_PLSQL, le PL/SQL de l'application Forms n'est pas converti, mais une liste de conversions proposées est consignée dans le fichier journal. Ce fichier est placé dans le répertoire en cours, qui peut être différent du répertoire dans lequel se trouve le fichier FMT.


Conversion d'états en mode de traitement par lots

Pour convertir un état en mode de traitement par lots :

1	Assurez-vous que vous avez converti toutes les bibliothèques PL/SQL attachées à l'état.

2	Puis :

•	Lancez la version GUI du Report Compiler

•	Exécutez le Report Compiler à partir de la ligne de commande.

Quelle que soit la méthode choisie, un récapitulatif du processus est automatiquement écrit dans le fichier journal module.plg, où module est le nom du module état converti. Le programme génère un journal séparé pour chaque module.

Note d'utilisation :

•	Lorsque l'utilitaire de conversion a converti une application même si vous décidez de ne pas tenir compte des conversions suggérées l'utilitaire n'est jamais appelé à nouveau pour cette application, pour ne pas écraser accidentellement vos modifications manuelles.


Conversion d'états à l'aide de la version GUI de Report Compiler

Pour convertir un ou plusieurs états à l'aide de la version GUI de Report Compiler :

1	Cliquez deux fois sur l'icône Report Compiler.

2	Dans le champ Type de document, sélectionnez Etat.

3	Choisissez les types Source et Destination appropriés.

4	Utilisez le bouton Parcourir du champ Source pour localiser le ou les états à convertir.

5	Utilisez le bouton Parcourir du champ Destination pour sélectionner la destination de l'état converti.

6	Cliquez sur OK.


Conversion d'états à partir de la ligne de commande

Pour convertir un ou plusieurs états à partir de la ligne de commande :

  Dans la ligne de commande, entrez :

<Report Compiler> SOURCE=rep1,rep2, UPGRADE_PLSQL=yes

où :

<Report Compiler>	Est le nom de l'exécutable Report Compiler sur votre plate-forme.
Rep1,rep2,	Est le nom du ou des états à convertir.


Conversion de bibliothèques PL/SQL attachées à un état

Pour convertir une bibliothèque PL/SQL de manière interactive :

  Ouvrez la bibliothèque dans Report Builder, puis enregistrez-la.

Pour convertir une bibliothèque PL/SQL à l'aide de la version GUI du Report Compiler :

1	Cliquez deux fois sur l'icône Report Compiler.

2	Dans le champ Type de document, indiquez Bibliothèque PL/SQL.

3	Dans le champ Type source, indiquez .PLL.

4	Dans le champ Type de destination, indiquez .PLL ou .PLX. Si vous indiquez .PLD, le PL/SQL V1 ou V2 ne sera pas converti.

Pour convertir une bibliothèque PL/SQL à l'aide le Report Compiler dans la ligne de commande :

  Dans la ligne de commande, entrez :

<Report Compiler> SOURCE=lib1,lib2, UPGRADE_PLSQL=yes

où :

<Report Compiler>	Est le nom de l'exécutable Report Compiler sur votre plate-forme.
lib1, lib2	Est le nom de la ou des bibliothèques à convertir.
Note d'utilisation :

•	Pour convertir plusieurs affichages à la fois, utilisez Project Builder. Reportez-vous à la rubrique d'aide de Project Builder, Choix d'une méthode de mise à niveau.


Conversion d'affichages en mode de traitement par lots

Pour convertir des affichages en mode de traitement par lots :

1	Assurez-vous que vous avez converti toutes les bibliothèques PL/SQL attachées à l'affichage.

2	Lancez la commande suivante :

<Graphics Builder> openfile=temp.ogd upgrade_plsql=yes savefile=temp1.ogd quit=yes

où :

<Graphics Builder>	Est le nom de l'exécutable Graphics Builder sur votre plate-forme.
openfile=temp.ogd	Ouvre l'affichage temp.ogd dans Graphics Builder.
upgrade_plsql=yes	Convertit le PL/SQL V1 ou V2.
Savefile=temp1.ogd	Enregistre l'affichage converti dans temp1.ogd.
quit=yes	Ferme Graphics Builder après la conversion de l'affichage.
Notes d'utilisation :

•	Un récapitulatif du processus de conversion est automatiquement écrit dans le fichier journal module.plg, où module est le nom de l'affichage converti.

•	Pour convertir plusieurs affichages à la fois, utilisez Project Builder. Reportez-vous à la rubrique d'aide de Project Builder, Choix d'une méthode de mise à niveau.

•	Lorsque l'utilitaire de conversion convertit une application, même si vous choisissez de ne pas tenir compte des conversions suggérées, vous ne pouvez plus l'appeler pour cette application, pour ne pas écraser accidentellement vos modifications manuelles.


Conversion de bibliothèques PL/SQL attachée à un affichage

Pour convertir une bibliothèque PL/SQL de manière interactive :

  Ouvrez la bibliothèque dans Graphics Builder, puis enregistrez-la.

Pour convertir une bibliothèque PL/SQL en mode de traitement par lots :

  Entrez cette commande :

<Graphics Builder> openfile=temp.lib upgrade_plsql=yes savefile=temp1.lib quit=yes

où :

<Graphics Builder>	Est le nom de l'exécutable Graphics Builder sur votre plate-forme.
openfile=temp.lib	Ouvre la bibliothèque temp.lib dans Graphics Builder.
upgrade_plsql=yes	Convertit le PL/SQL V1 ou V2.
savefile=temp1.lib	Enregistre la bibliothèque convertie dans temp1.lib.
quit=yes	Ferme Graphics Builder après la conversion de la bibliothèque.
Notes d'utilisation :

•	Un récapitulatif du processus de conversion est automatiquement écrit dans le fichier journal module.plg, où module est le nom de la bibliothèque convertie.

•	Lorsque l'utilitaire de conversion convertit une application, même si vous choisissez de ne pas tenir compte des conversions suggérées, vous ne pouvez plus l'appeler pour cette application, pour ne pas écraser accidentellement vos modifications manuelles.

•	Pour convertir plusieurs affichages à la fois, utilisez Project Builder. Reportez-vous à la rubrique d'aide de Project Builder, Choix d'une méthode de mise à niveau.


Conversions que l'utilitaire de conversion PL/SQL V1 peut effectuer

  Rubriques connexes

Les problèmes que l'utilitaire de conversion peut régler dans votre application sont les suivants :

CHAR remplacé par VARCHAR2

Longueur de chaîne requise par VARCHAR2

Expressions par défaut pour OUT et IN OUT interdits

RETURN nécessite une expression

Remplacement de procédures internes obsolètes

Fonction length retournant NULL pour des chaînes de longueur zéro

Transfert incorrect de NULL vers un sous-programme surchargé

Instruction RETURN absente dans fonction provoquant erreur de lancement

Contraintes de longueur supprimées


CHAR remplacé par VARCHAR2

Dans PL/SQL V1, les types de données CHAR et VARCHAR2 peuvent être interchangeables. Dans les versions ultérieures à V1, le type de données CHAR est rempli de blancs à droite.

Dans PL/SQL V1, l'instruction :

var1 CHAR(10) := 'hello';

. . .équivaut à 'hello'.

Dans les versions ultérieures à V1, cependant, cette instruction est transformée en 'hello ', (total 10 caractères).

Pour conserver le comportement V1 des variables de type CHAR, l'utilitaire de conversion remplace toutes les déclarations CHAR(n) par l'instruction VARCHAR2(n) équivalente. Dans l'exemple ci-dessus, var1 devient VARCHAR2(10).

L'utilitaire de conversion remplace également toutes les instructions VARCHAR par l'expression VARCHAR2 équivalente.


Longueur de chaîne obligatoire pour VARCHAR2

Dans les versions ultérieures à PL/SQL V1, vous devez indiquer une longueur pour toutes les variables de type VARCHAR2. Si vous avez déjà indiqué une longueur pour un type de données CHAR, l'utilitaire de conversion utilise cette longueur lorsqu'il remplace la déclaration par VARCHAR2 (pour plus d'informations, reportez-vous à CHAR remplacé par VARCHAR2). Par exemple :

var1 CHAR(10);

. . .est converti en :

var1 VARCHAR2(10);

Lorsque le convertisseur détecte une instruction CHAR ou VARCHAR2 sans chaîne de longueur, il suggère une longueur d'un caractère. Par exemple :

var2 CHAR;

. . .est converti en :

var2 VARCHAR2(1);

De même,

var3 VARCHAR2;

. . .est converti en :

var3 VARCHAR2(1);

Si vous n'indiquez pas une longueur pour une déclaration VARCHAR2, le compilateur génère le message d'erreur :

ERROR 215:  String length constraint must be in range (1 . . 32767)


Expressions par défaut pour OUT et IN OUT interdits

  Exemple

Dans PL/SQL V1, les paramètres OUT et IN OUT peuvent être suivis d'une expression par défaut, qui n'est cependant jamais prise en compte. L'utilitaire de conversion supprime les expressions par défaut pour les paramètres OUT et IN OUT.

Si vous compilez un code existant comprenant des paramètres OUT et IN OUT avec des expressions par défaut, le système génère le message d'erreur :

ERROR 230:  OUT and IN OUT formal parameters may not have default expressions


Suppression d'expressions par défaut - Exemple

  Rubriques connexes 	   Tous les exemples

L'utilitaire de conversion convertit le code PL/SQL V1 suivant :

PROCEDURE p (p1 IN OUT NUMBER DEFAULT 25,
             p2 OUT NUMBER DEFAULT 16) IS

BEGIN
. . .
END;

. . .par :

PROCEDURE p (p1 IN OUT NUMBER, p2 OUT NUMBER) IS

BEGIN
. . .
END;


RETURN nécessite une expression

  Exemple

Dans PL/SQL V1, il était possible d'utiliser une instruction RETURN sans expression pour retourner une valeur NULL. Comme toutes les fonctions doivent retourner des valeurs, les versions ultérieures à V1 considèrent que l'instruction RETURN est obligatoire. L'utilitaire de conversion remplace toutes les instructions RETURN qui ne sont pas suivies d'expression par RETURN NULL.

Si vous compilez un code existant comprenant une instruction RETURN sans expression, le message d'erreur suivant est généré :

ERREUR 503 : instruction RETURN requise pour le renvoi des données de la fonction.


Ajout de NULL à RETURN - Exemple

  Rubriques connexes 	   Tous les exemples

L'utilitaire de conversion convertit le code PL/SQL V1 suivant :

FUNCTION f RETURN NUMBER IS
x NUMBER;
BEGIN
x :=13;
IF . . . THEN
RETURN;
END IF;
RETURN x;
END;

. . .par :

FUNCTION f RETURN NUMBER IS
x NUMBER;
BEGIN
x :=13;
IF . . . THEN
RETURN NULL;    NULL ajouté ici
END IF;
RETURN x;
END;


Remplacement de procédures internes obsolètes

  Exemple

La procédure interne TO_PLS_INTEGER, qui convertit les chaînes de caractères en entiers PL/SQL, est obsolète dans les versions ultérieures à V1. L'utilitaire de conversion remplace TO_PLS_INTEGER par la procédure interne TO_NUMBER.

Si vous ne remplacez pas la procédure interne TO_PLS_INTEGER, le système génère le message d'erreur de compilation :

ERROR 201:  Identified TO_PLS_INTEGER must be declared

Remarque : Les autres procédures internes obsolètes doivent être remplacées manuellement.


Remplacement de procédures internes obsolètes - Exemple

  Rubriques connexes 	   Tous les exemples

L'utilitaire de conversion convertit le code PL/SQL V1 suivant :

PROCEDURE foo IS
     v INTEGER;
BEGIN
     v := TO_PLS_INTEGER(24);
END;

. . .par :

PROCEDURE foo IS
     v INTEGER;
BEGIN
     v := TO_NUMBER(24);      TO_PLS_INTEGER remplacé par TO_NUMBER
END;


Fonction LENGTH retournant NULL pour des chaînes de longueur zéro

  Exemple

Dans PL/SQL V1, la fonction LENGTH appliquée à une expression NULL retourne la valeur zéro. Dans les versions ultérieures à V1, cette fonction, appliquée à une expression NULL, retourne NULL.

Pour conserver le comportement de V1, l'utilitaire de conversion PL/SQL ajoute le prédicat SQL NVL afin de garantir que la fonction LENGTH appliquée à une expression NULL retourne la valeur zéro.


Fonction Length - Exemple

  Rubriques connexes 	   Tous les exemples

L'utilitaire de conversion convertit le code PL/SQL V1 suivant :

c:=null;
l=LENGTH( c );         Dans V1, donne 0.

. . .par :

c:=null;
l=NVL(LENGTH( c ),0);  Le convertisseur imbrique la fonction LENGTH
                                                      dans une procédure interne NVL( ), obligeant
                                                      l'expression à retourner 0.


Transfert incorrect de NULL vers un sous-programme surchargé

  Exemple

Dans PL/SQL V1, vous pouviez définir un sous-programme dans un package en tant que deux types de données différents : VARCHAR2 et un type RECORD. C'est ce que l'on appelle surcharger le sous-programme. Si vous transfériez ensuite une valeur NULL vers un sous-programme surchargé, le type de données PL/SQL devenait VARCHAR2. Cependant, dans les versions ultérieures à V1, une valeur NULL transférée vers un sous-programme surchargé au sein d'un package doit avoir un type défini.

Pour conserver le comportement de V1, l'utilitaire de conversion PL/SQL peut prendre l'une des mesures suivantes, selon le cas, lorsque NULL a été transféré vers un sous-programme surchargé :

•	Imbriquer NULL dans TO_CHAR( )

•	Imbriquer NULL dans TO_NUMBER( )

•	Imbriquer NULL dans TO_DATE( )

•	Imbriquer NULL dans NOT

Si vous transférez une valeur NULL vers un sous-programme surchargé sans définir le type de données souhaité, le programme génère le message d'erreur suivant :

ERROR 307:  Too many declarations of ‘PU name’ match this call . . .


Transfert de NULL vers un sous-programme surchargé - Exemple

  Rubriques connexes 	   Tous les exemples

L'utilitaire de conversion convertit le code PL/SQL V1 suivant :

PACKAGE ps1 IS
  TYPE foo IS RECORD(id PLS_INTEGER);
                              Le sous-programme p est surchargé :
  PROCEDURE p(a VARCHAR2);    a est défini comme une variable de type VARCHAR2
  PROCEDURE p(a FOO);         a est également défini comme un autre type de données
END;

PROCEDURE foo2 IS
BEGIN
  ps1.p(NULL);                Dans PL/SQL V1, le type de données
                                                                      VARCHAR2 est appliqué.
END;

. . .par :

PACKAGE ps1 IS
  TYPE foo IS RECORD(id PLS_INTEGER);

  PROCEDURE p(a VARCHAR2);
  PROCEDURE p(a FOO);

END;

PROCEDURE foo2 IS
BEGIN
  ps1.p(TO_CHAR(NULL));      Comme a est de type VARCHAR2, la valeur NULL
                             est imbriquée dans TO_CHAR( )
END;


Instruction RETURN absente d'une fonction provoquant une erreur de lancement

  Exemple

Lorsque l'instruction RETURN ne figure pas dans une fonction de PL/SQL V1, le système ne provoque pas de problème de lancement. Cependant, c'est le cas dans les versions ultérieures à V1.

Pour conserver le comportement de V1, l'utilitaire de conversion PL/SQL ajoute une instruction RETURN comprenant un argument NULL aux fonctions absentes de l'instruction RETURN.

Remarque : Une instruction RETURN absente d'une fonction ne génère pas d'erreur de compilation, mais une erreur de lancement, dans les versions ultérieures à V1.


Instruction RETURN absente - Exemple

  Rubriques connexes 	   Tous les exemples

L'utilitaire de conversion convertit le code PL/SQL V1 suivant :

FUNCTION noreturn (arg IN NUMBER) RETURN char IS
BEGIN
  IF (arg > 100000) THEN
    TEXT_IO.PUT_LINE ('The point of no return.');
  ENDIF;
                         instruction RETURN absente
END;

. . .par :

FUNCTION noreturn (arg IN NUMBER) RETURN char IS
BEGIN
  IF (arg > 100000) THEN
    TEXT_IO.PUT_LINE ('Point de non-retour.');
  ENDIF;
  RETURN NULL;            RETURN NULL ajouté par le convertisseur
END;


Contraintes de longueur supprimées

  Exemple

Dans PL/SQL V2, les contraintes de longueur des commandes DATE, BOOLEAN, MLSLABEL et ROWID ne sont pas prises en compte. Toutefois, cela entraîne des erreurs de compilation dans V8.

Pour conserver le comportement de V2, l’utilitaire de conversion PL/SQL supprime les contraintes.


Suppression des contraintes de longueur - Exemple

  Rubriques connexes 	   Tous les exemples

L’utilitaire de conversion convertit le code suivant :

PROCEDURE badconstraint IS
d DATE(5);
b BOOLEAN(5);
d MLSLABEL(5); --V2 only
r ROWID(5); --V2 only
BEGIN
  null;
END;

. . .par :

PROCEDURE badconstraint IS
d DATE;
b BOOLEAN;
d MLSLABEL; --V2 only
r ROWID; --V2 only
BEGIN
  null;
END;


Conversions que l'utilitaire PL/SQL V1 ne peut pas effectuer

  Rubriques connexes

Alors que l'utilitaire de conversion peut convertir de nombreuses incompatibilités PL/SQL parmi celles auxquelles il est confronté, certaines situations exigent que vous y remédiez manuellement :

Noms uniques exigés au sein d'un package

Fonction de package standard n'étant plus utilisée

Nouveaux mots réservés dans PL/SQL V2.3 ou versions ultérieures

%ROWTYPE ou %TYPE requis dans les déclarations de variable

Le message d'avertissement « Erreur non réparable, abandon de la conversion, ligne <numéro ligne> colonne <colonne> » apparaît en cas d'erreur fatale du compilateur ; le processus de conversion est interrompu.


Noms uniques exigés au sein d'un package

  Exemple

Dans PL/SQL V1, lorsque vous créiez une variable portant le même nom qu'une procédure ou fonction d'un même package, c'était toujours la variable qui était utilisée ; la procédure ou la fonction portant le même nom n'était pas prise en compte. Dans les versions ultérieures à V1, les variables, les fonctions et les procédures au sein d'un même package doivent porter des noms uniques.

Afin d'éviter toute erreur, vérifiez que toutes les procédures d'un package portent chacune un nom unique, en le faisant de manière explicite ou bien en ajoutant le mot Unused au nom de la procédure.

Remarque : Dans V1, Procedure Builder permettait malencontreusement de créer une unité de programme portant le même nom qu'un package intégré. Dans les versions ultérieures à V1, cela est interdit. Si Procedure Builder détecte une unité de programme portant le même nom qu'un package intégré, il modifie le nom de l'unité pendant le chargement en ajoutant deux signes dollar à la fin. Ainsi, DEBUG devient DEBUG$$.


Attribution d'un nouveau nom de procédure unique dans un package - Exemple

  Rubriques connexes 	   Tous les exemples

L'exemple suivant présente tout d'abord un code PL/SQL V1 qui génère une erreur de compilation, puis explique comment éditer le code afin d'éviter cette erreur.

Remplacez le code :

PACKAGE pk1 IS
  v1 NUMBER;           v1 est une variable
  PROCEDURE v1;        v1 est aussi défini comme une procédure
  PROCEDURE p2 (x OUT NUMBER);
END;

PACKAGE BODY pk1 IS
  PROCEDURE v1 IS
  BEGIN
   . . .
  END;

  PROCEDURE p2 (x OUT NUMBER) IS
  BEGIN
x := pk1.v1;
  END;

END;

. . .par :

PACKAGE pk1 IS
  v1 NUMBER;
  PROCEDURE v1Unused;	  Déclaration de la procédure v1 en tant que « Unused »
  PROCEDURE p2 (x OUT NUMBER);
END;

PACKAGE BODY pk1 IS
  PROCEDURE v1Unused IS
  BEGIN
   . . .
  END;

  PROCEDURE p2 (x OUT NUMBER) IS
  BEGIN
x := pk1.v1;
  END;

END;


Fonction de package standard n'étant plus utilisée

  Exemple

Dans PL/SQL V1, vous pouviez appeler la fonction FLOOR depuis votre propre package, p1, de la façon suivante :

v : = p1.FLOOR(x).

Si le package p1 ne disposait d'aucune fonction nommée FLOOR, PL/SQL utilisait la fonction FLOOR du package standard. Cette erreur de codage PL/SQL a été corrigée dans PL/SQL V2.3 ou supérieur. Ainsi, dans PL/SQL V2.3, le compilateur ne recherche pas le nom de la fonction du package standard, mais signale correctement que la situation est erronée :

ERROR 302 : le composant CCCCC doit être déclaré

. . . où ‘CCCCC' est le nom de la fonction ou de la procédure qui existe dans un package standard ou dans une extension de package standard.

Le message « Les références incorrectes vont être traduites dans le package intégré V1 » est inscrit dans le journal.

Pour diriger le compilateur vers le package standard, supprimez le nom de package incorrect.


Suppression du préfixe de package - Exemple

  Rubriques connexes 	   Tous les exemples

L'exemple suivant présente tout d'abord un code PL/SQL V1 qui génère une erreur de compilation, puis explique comment éditer le code afin d'éviter cette erreur.

Remplacez le code :

PACKAGE pk1 IS a NUMBER;
END;

PROCEDURE p IS v NUMBER;
BEGIN
v := pk1.FLOOR(20.5);
END;

. . .par :

PACKAGE pk1 IS a NUMBER;
END;

PROCEDURE p IS v NUMBER;
BEGIN
v := FLOOR(20.5);     Préfixe supprimé
END;


Nouveaux mots réservés dans PL/SQL V2.3 ou supérieur

  Exemples

Le mot VARIANCE est réservé dans PL/SQL V2.3 ou supérieur et, s'il est utilisé, génère une erreur de compilation.

Pour plus d'informations sur l'utilisation du mot VARIANCE sans génération d'erreur, reportez-vous à l'exemple ci-après.


Mots réservés - Exemple

  Rubriques connexes 	   Tous les exemples

L’exemple ci-dessous présente tout d'abord un code PL/SQL V1 qui génère une erreur de compilation, puis explique comment éditer le code pour éviter cette erreur.

Exemple 1 :

Remplacez le code :

FUNCTION variance (y IN NUMBER)
RETURN NUMBER IS

BEGIN
     . . .
     RETURN . . .;
END;

. . .par :

FUNCTION varianceUniqueName (y IN NUMBER)
     /* Un nom unique a été ajouté à Variance. */
RETURN NUMBER IS

BEGIN
     . . .
     RETURN . . .;
END;

Exemple 2 :

Lorsque vous appelez un sous-programme, remplacez le code :

PROCEDURE foo IS
     x NUMBER;
     y NUMBER;
BEGIN
     . . .
     x := variance(someNumber);
END;

. . .par :

PROCEDURE foo IS
     x NUMBER;
     y NUMBER;
BEGIN
     . . .
     x := varianceUniqueName(someNumber);
END;


%ROWTYPE ou %TYPE requis dans les déclarations de variable

  Exemples

Le compilateur PL/SQL V8 signale une erreur lorsqu'il détecte la syntaxe non autorisée ci-dessous (cette syntaxe est, par contre, acceptée par le code PL/SQL V2) :

return expression_variable

procedure (paramètre IN <nom_table>)

procedure (paramètre IN <nom_table>.<nom_colonne>)

La syntaxe correcte est :

return type_variable

procedure (paramètre IN <nom_table>%ROWTYPE)

procedure (paramètre IN <nom_table>.<nom_colonne>%TYPE)

Pour éviter toute erreur, utilisez le type de données de l’expression, ajoutez %ROWTYPE au nom de la table ou ajoutez %TYPE au nom de la colonne.


Déclarations de variables - Exemples

  Rubriques connexes 	   Tous les exemples

Les exemples suivant présentent tout d’abord le code PL/SQL V2 générant l'erreur de compilation, puis expliquent comment le modifier pour éviter cette erreur.

Exemple 1 :

Remplacez le code :

FUNCTION colonne_retour RETURN dept.dname IS
. . .

. . .par :

FUNCTION colonne_retour RETURN dept.dname%TYPE IS
. . .

Remplacez le code :

PROCEDURE foo (name IN dept.dname) IS
. . .

. . .par :

PROCEDURE foo (name IN dept.dname%TYPE) IS
. . .

Exemple 2 :

Remplacez le code :

FUNCTION table_retour RETURN dept IS
. . .

. . .par :

FUNCTION table_retour RETURN dept.%ROWTYPE IS
. . .

Remplacez le code :

PROCEDURE foo (name IN dept) IS
. . .

. . .par :

PROCEDURE foo (name IN dept%ROWTYPE) IS
. . .

Exemple 3 :

Cet exemple présente une exception pour laquelle vous ne pouvez pas utiliser %TYPE.

Lorsque vous déclarez des paramètres, remplacez le code :

FUNCTION param_retour (x IN NUMBER)
  RETURN x IS
. . .

. . .par :

FUNCTION param_retour (x IN NUMBER)
  RETURN number IS
. . .


Boîte de dialogue Bibliothèques de base de données

Cette boîte de dialogue affiche la liste des bibliothèques stockées dans la base de données.

Bibliothèque	Liste des bibliothèques disponibles dans la base de données à laquelle vous êtes connecté. Seules les bibliothèques auxquelles vous avez l'autorisation d'accéder sont affichées. Cliquez sur le nom d'une bibliothèque pour la sélectionner.


Liste des bibliothèques disponibles dans la base de données à laquelle vous êtes connecté. Seules les bibliothèques auxquelles vous avez l'autorisation d'accéder sont affichées. Cliquez sur le nom d'une bibliothèque pour la sélectionner.


Boîte de dialogue Nouvelle unité de programme

Cette boîte de dialogue permet d'indiquer le nom et le type de l'unité de programme à créer.

Nom	Entrez le nom de l'unité de programme.
Types	Indique le type d'unité de programme que vous créez. Vous pouvez choisir entre les types suivants :
Procédure	Sous-programme PL/SQL qui exécute une série d'opérations indiquées.
Fonction	Sous-programme PL/SQL qui exécute une série d'opérations indiquées et renvoie une valeur.
Spéc. de package	Types de données et sous-programmes qui peuvent être désignés par d'autre unités de programme.
Corps de package	Met en oeuvre le package. Cette unité de programme peut être dotée de sous-programmes et de types de données privés. Elle est facultative si ce package est constitué uniquement de déclarations.
Spécification du type	Indique le nom, les variables (attributs) et les sous-programmes membres (méthodes) d'un type d'objet ou d'ensemble.
Corps du type	Met en oeuvre les méthodes membres (fonctions et procédures) définies dans la spécification du type d'un objet. Chaque spécification de méthode doit être associée à un corps de méthode.
Remarque : Spécification du type et Corps du type ne sont activées que si vous êtes connecté à Oracle8.


Entrez le nom de l'unité de programme.


Type de l'unité de programme que vous voulez créer.


Boîte de dialogue Ouverture de bibliothèque

Cette boîte de dialogue permet d'ouvrir les bibliothèques existantes, dans le système de fichiers ou dans la base de données; elle constitue une interface graphique pour la commande OPEN de l'Interpréteur.

Bibliothèque	Nom (et emplacement) de la bibliothèque à ouvrir.
Rechercher	Si vous avez sélectionné Système de fichiers ou Les deux dans le champ Dans, permet d'afficher la boîte de dialogue de sélection de fichiers de votre système d'exploitation. Si vous avez sélectionné Base de données dans le champ Dans, permet d'afficher la boîte de dialogue Bibliothèques de base de données.
Dans	Permet d'indiquer si la bibliothèque est stockée dans le système de fichiers ou dans la base de données.


Nom (et emplacement) de la bibliothèque à ouvrir.


Si vous avez sélectionné Système de fichiers ou Les deux dans le champ Dans, permet d'afficher la boîte de dialogue de fichiers de votre système d'exploitation. Si vous avez sélectionné Base de données dans le champ Dans, permet d'afficher la boîte de dialogue Bibliothèques de base de données.


Permet d'indiquer si la bibliothèque est stockée dans le système de fichiers ou dans la base de données.


Boîte de dialogue Attachement de bibliothèque

Cette boîte de dialogue permet d'attacher des bibliothèques à votre session en cours; elle constitue une interface graphique pour la commande ATTACH de l'Interpréteur.

Bibliothèque	Nom (et emplacement) de la bibliothèque à attacher.
Rechercher	Si vous avez sélectionné Système de fichiers ou Les deux dans le champ Dans, permet d'afficher la boîte de dialogue de sélection de fichiers de votre système d'exploitation. Si vous avez sélectionné Base de données dans le champ Dans, permet d'afficher la boîte de dialogue Bibliothèques de base de données.
Dans	Permet d'indiquer si la bibliothèque est stockée dans le système de fichiers ou dans la base de données.
Attacher	Permet de confirmer vos sélections, d'attacher la bibliothèque et de fermer la boîte de dialogue.


Nom (et emplacement) de la bibliothèque à attacher.


Si vous avez sélectionné Système de fichiers ou Les deux dans le champ Dans, permet d'afficher la boîte de dialogue de fichiers de votre système d'exploitation. Si vous avez sélectionné Base de données dans le champ Dans, permet d'afficher la boîte de dialogue Bibliothèques de base de données.


Permet d'indiquer si la bibliothèque est stockée dans le système de fichiers ou dans la base de données.


Permet de confirmer vos sélections, d'attacher la bibliothèque et de fermer la boîte de dialogue.


Boîte de dialogue Journalisation d'interpréteur

Cette boîte de dialogue permet de gérer les activités de journalisation ; elle constitue une interface graphique pour la commande LOG de l'Interpréteur.

Fichier	Nom du fichier dans lequel la session de journalisation doit être enregistrée.
Rechercher	Permet d'afficher la boîte de dialogue de fichiers de votre système d'exploitation que vous pouvez explorer pour sélectionner un emplacement ou un nom de fichier existant.
Annexer	Permet d'activer cette option : la session de journalisation en cours est ajoutée à la fin du fichier de journalisation existant que vous avez indiqué dans la boîte de texte Fichier. Si cette option n'est pas sélectionnée, les informations sur la journalisation en cours, dans le fichier indiqué, seront recouvertes par la nouvelle session de journalisation.
Désactivé	Permet d'activer cette option : la journalisation dans le fichier indiqué est momentanément suspendue jusqu'à ce qu'elle soit de nouveau activée.
Afficher le journal	Permet d'afficher l'explorateur de journal de l'interpréteur lorsque la boîte de dialogue Journalisation d'interpréteur est validée. Vous pouvez également afficher l'explorateur de journal d'interpréteur en choisissant Affichage [image] Journal interpréteur dans l'Interpréteur.


Nom du fichier dans lequel la session de journalisation doit être enregistrée.


Permet d'afficher la boîte de dialogue de fichiers de votre système d'exploitation que vous pouvez explorer pour sélectionner un emplacement ou un nom de fichier existant.


Permet d'activer cette option : la session de journalisation en cours est ajoutée à la fin du fichier de journalisation existant que vous avez indiqué dans la boîte de texte Fichier. Si cette option n'est pas sélectionnée, les informations sur la journalisation en cours, dans le fichier indiqué, seront recouvertes par la nouvelle session de journalisation.


Permet d'activer cette option : la journalisation dans le fichier indiqué est momentanément suspendue jusqu'à ce qu'elle soit de nouveau activée.


IPermet d'afficher l'explorateur de journal d'interpréteur lorsque la boîte de dialogue Journalisation d'interpréteur est validée. Vous pouvez également afficher l'explorateur de journal d'interpréteur en choisissant Affichage --> Journal interpréteur dans l'interpréteur.


Explorateur de journal interpréteur

Cette boîte de dialogue affiche les messages enregistrés, provenant de la dernière session de journalisation.

Activer/Désactiver	Permet de sélectionner l'état Activé/Désactivé de la session de journalisation en cours.
Désactivé	Permet de mettre fin à la session de journalisation en cours et de fermer l'explorateur.
Boîte de liste de messages	Zone défilante, en lecture seule, qui affiche un enregistrement de l'entrée et de la sortie dans la fenêtre Interpréteur. Vous pouvez sélectionner, copier et rechercher le texte affiché dans la boîte de liste.


Permet de sélectionner l'état Activé/Désactivé de la session de journalisation en cours.


Permet de mettre fin à la session de journalisation en cours et de fermer l'explorateur.


Zone défilante, en lecture seule, qui affiche un enregistrement de l'entrée et de la sortie dans la fenêtre Interpréteur. Vous pouvez sélectionner, copier et rechercher le texte affiché dans la boîte de liste.


Boîte de dialogue Connexion

Cette boîte de dialogue vous permet de vous connecter à une instance de base de données ; elle constitue une interface graphique pour la commande CONNECT de l'Interpréteur.

Nom utilisateur	Votre ID utilisateur de base de données. Vous pouvez entrer votre chaîne de connexion complète, mais votre mot de passe sera renvoyé en écho.
Mot_passe	Votre mot de passe d'accès à la base de données. Pour garantir la confidentialité, le mot de passe que vous entrez n'est pas renvoyé en écho.
Base de données	Chaîne de connexion à la base de données à laquelle vous voulez vous connecter, généralement sous la forme :
	protocole_réseau:noeud_réseau[:nom_base de données]
	Chacun des champs est séparé par un signe deux-points (:). Pour connaître la chaîne de connexion correspondant à votre base de données, interrogez votre administrateur de bases de données. Notez que si vous vous connectez à une source de données ODBC, la syntaxe est la suivante :
	nom_utilisateur/mot_passe@ODBC:source_données[:nom_bd] Si nom_bd n'est pas indiqué, la base de données en cours est utilisée pour la connexion ODBC.
Connecter	Permet de valider les informations que vous avez fournies et de tenter d'établir une connexion. Si la connexion réussit, la boîte de dialogue se ferme. Si elle échoue, un message d'erreur est généré.


Votre ID utilisateur de base de données. Vous pouvez entrer votre chaîne de connexion complète, mais votre mot de passe sera renvoyé en écho.


Votre mot de passe d'accès à la base de données. Pour garantir la confidentialité, le mot de passe que vous entrez n'est pas renvoyé en écho.


Chaîne de connexion à la base de données à laquelle vous voulez vous connecter, généralement sous la forme :


Permet de valider les informations que vous avez fournies et de tenter d'établir une connexion. Si la connexion réussit, la boîte de dialogue se ferme. Si elle échoue, un message d'erreur est généré.


Boîte de dialogue Autorisation à liste d'accès

Cette boîte de dialogue permet d'afficher et de modifier les autorisations d'accès à la bibliothèque sélectionnée ou à l'unité de programme stockée sur le serveur de base de données ; elle constitue une interface graphique pour les commandes GRANT et REVOKE de l'Interpréteur. Pour pouvoir accorder ou retirer des autorisations d'accès à d'autres utilisateurs, vous devez avoir une Autorisation d'accès à la bibliothèque.

Boîte de liste d'utilisateurs	Permet d'afficher la liste des utilisateurs qui ont accès à la bibliothèque sélectionnée ou à l'unité de programme stockée. Cliquez sur un nom pour l'entrer dans la boîte de texte Utilisateur.
Utilisateur	Entrez le nom de l'utilisateur auquel vous voulez accorder ou retirer une autorisation d'accès à la bibliothèque sélectionnée ou à l'unité de programme stockée. Ce nom doit être un nom valide pour la base de données en cours. Si le nom utilisateur figure déjà dans la boîte de liste d'utilisateurs, cliquez simplement sur son nom.
Ajouter	Permet d'ajouter le nom utilisateur à la liste de ceux qui sont autorisés à accéder à la bibliothèque ou à l'unité de programme stockée.
Supprimer	Permet de supprimer le nom utilisateur de la liste de ceux qui sont autorisés à accéder à la bibliothèque à l'unité de programme stockée.


Permet d'afficher la liste des utilisateurs qui ont accès à la bibliothèque sélectionnée. Cliquez sur un nom pour l'entrer dans la boîte de texte Utilisateur.


Entrez le nom de l'utilisateur auquel vous voulez accorder ou retirer une autorisation d'accès à la bibliothèque sélectionnée. Ce nom doit être un nom valide pour la base de données en cours. Si le nom de l'utilisateur figure déjà dans la boîte de liste d'utilisateurs, cliquez simplement sur son nom.


Permet d'ajouter le nom utilisateur à la liste de ceux qui sont autorisés à accéder à la bibliothèque.


Permet de supprimer le nom utilisateur de la liste de ceux qui sont autorisés à accéder à la bibliothèque.


Boîte de dialogue Enregistrement de bibliothèque

Cette boîte de dialogue permet d'enregistrer une bibliothèque dans le système de fichiers ou dans la base de données ; elle constitue une interface graphique pour la commande SAVE de l'Interpréteur.

Bibliothèque	Entrez le nom (et l'emplacement) de la bibliothèque que vous voulez enregistrer.
Rechercher	Si vous avez sélectionné Système de fichiers dans le champ Dans, permet d'afficher la boîte de dialogue de fichiers de votre système d'exploitation. Si vous avez sélectionné Base de données dans le champ Dans, permet d'afficher la boîte de dialogue Bibliothèques de base de données.
Dans	Permet d'indiquer si la bibliothèque sera sauvegardée dans le système de fichiers ou dans la base de données.


Entrez le nom (et l'emplacement) de la bibliothèque que vous voulez enregistrer.


Si vous avez sélectionné Système de fichiers dans le champ Dans, permet d'afficher la boîte de dialogue de fichiers de votre système d'exploitation. Si vous avez sélectionné Base de données dans le champ Dans, permet d'afficher la boîte de dialogue Bibliothèques de base de données.


Permet d'indiquer si la bibliothèque sera sauvegardée dans le système de fichiers ou dans la base de données.


Boîte de dialogue Recherche/remplacement

Cette boîte de dialogue vous permet de rechercher et éventuellement de remplacer des chaînes ou des expressions régulières dans la source d'unité de programme affichée dans l'Editeur d'unité de programme ou d'unité de programme stockée.

Rechercher	Entrez la chaîne que vous recherchez. Si vous voulez que la chaîne soit considérée comme une expression régulière, cliquez sur la case à cocher Expression régulière pour la sélectionner.
Remplacer par	Entrez la chaîne devant remplacer les correspondances trouvées.
Expression régulière	Permet d'indiquer si l'opération doit faire la différence entre les majuscules et les minuscules dans la chaîne de recherche. Si cette case n'est pas cochée, la recherche trouvera toutes les correspondances des chaînes de recherche, qu'elles soient en majuscules ou en minuscules.
Distinction maj/min	Permet d'indiquer si la chaîne de recherche doit être considérée comme une chaîne ou une expression régulière. Si cette case n'est pas cochée, le contenu de la boîte de texte Rechercher est considéré comme une chaîne.
Rechercher	Permet de rechercher la prochaine correspondance de la chaîne de recherche, à partir de la position du curseur.
Remplacer	Permet de remplacer la dernière chaîne trouvée par la chaîne spécifiée dans la boîte de texte Remplacer. Si aucune correspondance n'est sélectionnée, recherche la prochaine occurrence de la chaîne de recherche et la remplace.
Remplacer par	Permet de remplacer toutes les correspondances par la chaîne de remplacement (à partir de la position du curseur jusqu'à la fin de la zone sur laquelle porte la recherche).


Entrez la chaîne que vous recherchez. Si vous voulez que la chaîne soit considérée comme une expression régulière, cliquez sur la case à cocher Expression régulière pour la sélectionner.


Entrez la chaîne devant remplacer les correspondances trouvées.


Permet d'indiquer si la chaîne de recherche doit être considérée comme une chaîne ou une expression régulière. Si cette case n'est pas cochée, le contenu de la boîte de texte Rechercher est considéré comme une chaîne.


Permet d'indiquer si l'opération doit faire la différence entre les majuscules et les minuscules dans la chaîne de recherche. Si cette case n'est pas cochée, la recherche trouvera toutes les correspondances des chaînes de recherche, qu'elles soient en majuscules ou en minuscules.


Permet de rechercher la prochaine correspondance de la chaîne de recherche, à partir de la position du curseur.


Permet de remplacer la dernière chaîne trouvée par la chaîne spécifiée dans la boîte de texte Remplacer. Si aucune correspondance n'est sélectionnée, recherche la prochaine occurrence de la chaîne de recherche et la remplace.


Permet de remplacer toutes les correspondances par la chaîne de remplacement (à partir de la position du curseur jusqu'à la fin de la zone sur laquelle porte la recherche).


Boîte de dialogue Point d'interruption PL/SQL

Cette boîte de dialogue permet de créer un point d'interruption ; elle constitue une interface graphique pour la commande BREAK. Elle vous permet de créer ou de modifier des points d'interruption et les déclencheurs correspondants.

Point d'interruption	Permet d'identifier le point d'interruption et se présente sous la forme Point d'interruption:  New ou Point d'interruption:  number. Le libellé est " New " lors de l'indication d'un nouveau point d'interruption, ou une valeur numérique lors de la modification d'un point d'interruption existant.
Activé	Permet d'indiquer si le point d'interruption est activé ou désactivé.
Unité programme	Permet d'identifier l'unité de programme cible, ou l'emplacement du point d'interruption existant ou du nouveau.
Ligne	Permet d'identifier l'emplacement source du point d'interruption dans l'unité de programme.
Déclencheur	Si nécessaire, entrez les instructions PL/SQL qui seront activées lorsque le point d'interruption sera atteint. Les mots-clés BEGIN et END ne sont pas obligatoires dans le déclencheur. Par exemple, vous pouvez utiliser DEBUG.INTERPRET pour exécuter une commande de l'Interpréteur. DEBUG.INTERPRET('.SHOW LOCALS');


Permet d'identifier le point d'interruption et se présente sous la forme Point d'interruption:  New ou Point d'interruption:  number. Le libellé est " New " lors de l'indication d'un nouveau point d'interruption, ou une valeur numérique lors de la modification d'un point d'interruption existant.


Permet d'indiquer si le point d'interruption est activé ou désactivé.


Permet d'identifier l'unité de programme cible du point d'interruption existant ou du nouveau.


Permet d'identifier l'emplacement source du point d'interruption dans l'unité de programme.


Entrez les instructions PL/SQL de point d'interruption qui seront activées lorsque le point d'interruption sera atteint. Les mots-clés BEGIN et END ne sont pas obligatoires.


Boîte de dialogue Déclencheur PL/SQL

Cette boîte de dialogue permet de créer un déclencheur de débogage ; elle constitue une interface graphique pour la commande TRIGGER.

Déclencheur	Permet d'identifier le déclencheur de débogage et se présente sous la forme Déclencheur:  New ou Déclencheur:  number. Le libellé est "New" lors de l'indication d'un nouveau déclencheur de débogage, ou une valeur numérique lors de la modification d'un déclencheur de débogage existant.
Activé	Permet d'indiquer si le déclencheur de débogage est activé ou désactivé.
Emplacement	Permet d'indiquer l'emplacement source du déclencheur de débogage.
	L'option Unité de programme (par défaut) indique que le déclencheur de débogage se trouve à un emplacement source spécifique dans l'unité de programme.
	L'option Entrée débogage indique que le déclencheur est activé dès que l'exécution de l'unité de programme est suspendue.
	L'option Chaque instruction indique que le déclencheur de débogage est activé immédiatement avant chaque instruction exécutable de l'unité de programme.
Unité programme	Permet d'identifier l'unité de programme cible.
Ligne	Permet d'identifier l'emplacement source du déclencheur de débogage dans l'unité de programme.
Corps du déclencheur	Entrez les instructions PL/SQL à utiliser comme corps du déclencheur de débogage. Les mots-clés BEGIN et END ne sont pas obligatoires. Un déclencheur de débogage fonctionne comme celui de point d'interruption conditionnel. Si vous indiquez les conditions de date/heure d'une action de débogage, le déclencheur n'est activé que si elles sont vraies. Par exemple, vous pouvez activer DEBUG.BREAK si une variable est égale à une valeur donnée, telle que 100. IF DEBUG.GETC('vnumber') = 100 THEN   RAISE DEBUG.BREAK; END IF;


Permet d'identifier le déclencheur de débogage et se présente sous la forme Déclencheur:  New ou Déclencheur:  number. Le libellé est "New" lors de l'indication d'un nouveau déclencheur de débogage, ou une valeur numérique lors de la modification d'un déclencheur de débogage existant.


Permet d'indiquer si le déclencheur de débogage est activé ou désactivé.


Permet d'indiquer l'emplacement source du déclencheur de débogage.


Permet d'identifier l'unité de programme cible.


Permet d'identifier l'emplacement source du déclencheur de débogage dans l'unité de programme.


Entrez les instructions PL/SQL qui devront être utilisées comme corps du déclencheur de débogage.


Boite de dialogue Etape de débogage PL/SQL

Cette boîte de dialogue permet de définir des options permettant de progresser pas à pas dans le code d'une unité de programme interrompue pendant le débogage ; elle constitue l'interface graphique pour la commande STEP de l'Interpréteur.

Mode	Permet d'indiquer l'option Step à utiliser.
	INTO reprend l'exécution jusqu'à la prochaine instruction exécutable.
	OVER reprend l'exécution jusqu'à la prochaine instruction exécutable dans l'unité de programme en cours, en sautant les appels de sous-programmes.
	OUT reprend l'exécution d'un sous-programme imbriqué et s'arrête après l'instruction exécutable de l'unité de programme appelante.
	TO (vers) reprend l'exécution jusqu'à ce que l'emplacement indiqué soit atteint.
Unité programme	Permet d'identifier le corps de l'unité de programme cible de l'option de commande STEP TO.
Ligne	Permet d'identifier l'emplacement, dans le corps de l'unité de programme cible, de l'option de commande STEP TO.
Décompte	Permet d'indiquer le nombre de fois où la commande STEP est répétée. Valeur par défaut : 1.
Appliquer	Permet d'accepter les options indiquées et de reprendre l'exécution de l'unité de programme en conséquence. Comme les opérations pas à pas s'exécutent généralement les unes après les autres, la boîte de dialogue STEP reste affichée jusqu'à ce que vous la fermiez explicitement, ou tant qu'il y a un niveau de débogage actif.


Permet d'indiquer l'option Step à utiliser.


Permet d'identifier le corps de l'unité de programme cible de l'option de commande STEP TO.


Permet d'identifier l'emplacement, dans le corps de l'unité de programme cible, de l'option de commande STEP TO.


Permet d'indiquer le nombre de fois où la commande STEP est répétée. Valeur par défaut : 1.


Permet d'accepter les options indiquées et de reprendre l'exécution de l'unité de programme en conséquence. Comme les opérations pas à pas s'exécutent généralement les unes après les autres, la boîte de dialogue STEP reste affichée jusqu'à ce que vous la fermiez explicitement, ou tant qu'il y a un niveau de débogage actif.


Boîte de dialogue Chargement d'unité de programme

Cette boîte de dialogue permet d'importer et de compiler une unité de programme stockée dans le système de fichiers ; elle constitue une interface graphique pour la commande LOAD de l'Interpréteur.

Fichier	Entrez le nom (et l'emplacement) du fichier contenant le texte source de l'unité de programme.
Rechercher	Permet d'afficher la boîte de dialogue de fichiers de votre système d'exploitation.
Supprimer les confirmations	Permet de supprimer tous les messages de confirmation pendant le chargement et la compilation, par exemple lors de l'écrasement d'une unité de programme existante. Lorsque cette option est désactivée (par défaut), les confirmations ne sont pas supprimées.
Charger	Permet de valider vos sélections, de charger l'unité de programme et de fermer la boîte de dialogue.


Entrez le nom (et l'emplacement) du fichier contenant le texte source de l'unité de programme.


Permet d'afficher la boîte de dialogue de fichiers de votre système d'exploitation.


Permet de supprimer tous les messages de confirmation pendant le chargement et la compilation, par exemple lors de l'écrasement d'une unité de programme existante. Lorsque cette option est désactivée (par défaut), les confirmations ne sont pas supprimées.


Permet de valider vos sélections, de charger l'unité de programme et de fermer la boîte de dialogue.


Boîte de dialogue Interpréteur de script de débogage

Cette boîte de dialogue permet d'importer et d'exécuter un script contenant toute combinaison de commandes de l'Interpréteur, de source PL/SQL ou d'instructions SQL ; elle constitue une interface graphique pour la commande INTERPRET.

Fichier	Entrez le nom (et l'emplacement) du fichier contenant le script de débogage à interpréter.
Rechercher	Permet d'afficher la boîte de dialogue de fichiers de votre système d'exploitation.
Echo	Permet d'activer ou de désactiver le mode Echo. Lorsque cette option est désactivée (par défaut), chaque ligne de script n'est pas renvoyée en écho dans la ligne de commande de l'Interpréteur, au fur et à mesure du chargement du script.
Silencieux	Permet d'activer ou de désactiver le mode Silencieux. Lorsque cette option est désactivée (par défaut), les messages d'état sont affichés pendant le chargement du script.
Supprimer les confirmations	Permet de supprimer toutes les confirmations pendant l'opération, par exemple, lors de l'écrasement d'une unité de programme existante. Lorsque cette option est désactivée (par défaut), les confirmations ne sont pas supprimées.
Interpréter	Permet de valider vos sélections, d'exécuter le script et de fermer la boîte de dialogue.


Entrez le nom (et l'emplacement) du fichier contenant le script de débogage à interpréter.


Permet d'afficher la boîte de dialogue de fichiers de votre système d'exploitation.


Permet d'activer ou de désactiver le mode Echo. Lorsque cette option est désactivée (par défaut), chaque ligne de script n'est pas renvoyée en écho dans la ligne de commande de l'Interpréteur, au fur et à mesure du chargement du script.


Permet d'activer ou de désactiver le mode Silencieux. Lorsque cette option est désactivée (par défaut), les messages d'état sont affichés pendant le chargement du script.


Permet de supprimer toutes les confirmations pendant l'opération, par exemple, lors de l'écrasement d'une unité de programme existante. Lorsque cette option est désactivée (par défaut), les confirmations ne sont pas supprimées.


Permet de valider vos sélections, d'exécuter le script et de fermer la boîte de dialogue.


Boîte de dialogue Compilation

Cette boîte de dialogue affiche les messages d'erreur de compilation pendant la compilation par lots et vous permet de suspendre et de reprendre la compilation, ainsi que de passer à une source d'erreur.

Ligne d'état	Pendant la compilation des unités de programme, indique les informations suivantes :
	nom et type de l'unité de programme en cours de compilation
	[INTERROMPU] lorsque vous cliquez sur Interrompre
	pourcentage d'unités de programme qui ont été compilées.
Liste des erreurs de compilation	Zone que l'utilisateur peut faire défiler à l'aide de la souris ; elle répertorie les erreurs détectées lors de la compilation des unités de programme sélectionnées. Dans cette zone de liste, cliquez sur une erreur de façon à ce que l'Editeur d'unité de programme apparaisse et que cette erreur soit localisée. Si vous cliquez sur ce bouton et que vous avez interrompu la compilation après avoir attendu de cliquer, une zone d'avertissement apparaît ; elle vous informe que l'accès à la source d'une erreur provoque l'abandon de la compilation par lots.
Interrompre	Permet d'arrêter momentanément la compilation, par exemple lorsque le nombre d'erreurs générées est trop important.
Reprendre	Permet de reprendre la compilation après une interruption.
Atteindre l'erreur	Permet d'afficher l'Editeur d'unité de programme contenant la source de l'unité de programme à l'emplacement de la première erreur. Si vous cliquez sur ce bouton et que vous avez interrompu la compilation après avoir attendu de cliquer, une zone d'avertissement apparaît ; elle vous informe que l'accès à la source d'une erreur provoque l'abandon de la compilation par lots. Cette option permet également d'appeler la boîte de dialogue des messages de compilation PL/SQL, zone de liste que l'utilisateur peut faire défiler à l'aide de la souris pour consulter toutes les erreurs détectées lors de la compilation des unités de programme sélectionnées. Dans cette zone de liste, cliquez sur une erreur pour afficher l'Editeur d'unité de programme et l'unité de programme contenant cette erreur.

Si la compilation se termine sans qu'aucune erreur n'ait été détectée, le message Compilation réussie apparaît dans la ligne d'état. Si des erreurs ont été détectées pendant la compilation, le message Compilation avec erreurs apparaît.

La boîte de dialogue des messages d'erreur de compilation PL/SQL est une zone de liste que vous pouvez faire défiler à l'aide de la souris pour consulter toutes les erreurs détectées lors de la compilation des unités de programme sélectionnées. Dans cette zone de liste, cliquez sur une erreur pour afficher l'Editeur d'unité de programme et l'unité de programme dans laquelle se trouve l'erreur.


Pendant la compilation des unités de programme, indique les informations suivantes : le nom et le type de l'unité de programme en cours de compilation, ainsi que le pourcentage d'unités de programme ayant été compilées.


Permet d'arrêter momentanément la compilation, par exemple lorsque le nombre d'erreurs générées est trop important. Le fait de cliquer sur Interrompre affiche [INTERROMPU] dans la ligne d'état.


Permet de reprendre la compilation après une interruption.


Permet d'afficher l'explorateur de messages de compilation PL/SQL et l'Editeur d'unité de programme contenant la source de l'unité de programme à l'emplacement de la première erreur.


Expressions régulières

Les expressions régulières sont des chaînes qui peuvent contenir les caractères génériques spéciaux suivants :

.	Equivaut à n'importe quel caractère. Par exemple, .oc équivaut à la fois à toc et roc.
( )	Utilisé pour imposer la priorité des opérateurs (par exemple, +) lorsque la priorité par défaut ne doit pas être utilisée. Par exemple, la concaténation de caractères (par exemple le) a priorité sur les autres opérateurs comme +, de sorte que le+A équivaut à (le)+A. Si vous voulez que la correspondance soit leeeeeeA, vous pouvez imposer que + précède la concaténation en utilisant des parenthèses : l(e+)A.
[ ]	Equivaut à n'importe quel caractère entre crochets. Les crochets équivalent à un opérateur OR logique. Par exemple, b[roi]s correspondra à bris et à bois.
|	Utilisé entre deux expressions régulières. Il y a correspondance si l'une ou l'autre des expressions régulières correspond.
\	Equivaut au caractère spécial qui suit la barre oblique inversée. Par exemple, \* équivaut à *. La barre oblique inversée est le caractère dit " d'échappement ". Tout caractère spécial qui le suit n'est pas considéré comme un caractère spécial. Exemples d'utilisation du caractère d'échappement :
	\n équivaut à un caractère de changement de ligne ;
	\t correspond à un caractère de tabulation ;
	\b correspond à un caractère blanc ;
	\w correspond à \n, \t, \b ou \0.
*	Correspond à 0 ou à plusieurs instances de l'expression régulière. Par exemple, (le)*A correspond à A, leA et leleA.
+	Correspond à une ou plusieurs instances de l'expression régulière. Par exemple,(le)+A correspond à la fois à leA et à leleA, mais ne correspond pas à le tout seul, contrairement à (le)*A.
Les caractères suivants ont une signification particulière lorsqu'ils sont utilisés entre crochets :

~	Utilisé comme premier caractère, correspond à tout caractère qui ne figure pas dans les caractères ou les séries de caractères entre crochets. Par exemple, b[~ro]is correspond à bais, mais pas à bris.
-	Entre deux paires de caractères, correspond à n'importe quel caractère de la série. Par exemple, A-E correspondra aux lettres A, B, C, D et E. Les paires de séries de caractères peuvent être :
	• des caractères alphabétiques en majuscules ou en minuscules, dans lesquels le premier caractère précède (ou est au même niveau que) le deuxième caractère de l'alphabet ;
	• des chiffres, dans lesquels le premier est inférieur ou égal au second (par exemple,  [4-9] ou [0-3]).
	Vous pouvez également utiliser le caractère d'échappement entre crochets.
Règles : L'ordre de priorité des caractères spéciaux d'une expression régulière est le suivant : ( ), [ ], caractères concaténés (par exemple abc), *, +, ~,  , |, .

Exemples d'implication de l'ordre de priorité :

•	Début|Fin équivaut à (Début)|(Fin)

•	Début* équivaut à (Début)*

•	Début|Fin* équivaut à (Début)|((Fin)*)


Boîte de dialogue Sélection de lignes de table PL/SQL

Cette boîte de dialogue contient des index de lignes d'une table sélectionnée et permet de sélectionner les lignes que vous voulez consulter, totalement développées, dans le Navigateur d'objet.

Boîte de liste d'index d'enregistrements	Zone que vous pouvez faire défiler à l'aide de la souris, contenant une liste des index de toutes les lignes de la table sélectionnée.
Sélectionner tout	Permet de sélectionner tous les éléments de la table sélectionnée.
Désélectionner tout	Permet d'annuler la sélection de tous les éléments de la table sélectionnée.
Par défaut, tous les index sont sélectionnés. Pour désélectionner chaque index de la liste, cliquez dessus tout en appuyant sur la touche Ctrl.


Boîte de dialogue de recherche et de remplacement dans les unités de programme

Cette boîte de dialogue vous permet d'effectuer une recherche globale et des remplacements dans plusieurs unités de programme.

Rechercher	Entrez la chaîne à rechercher. Pour que cette chaîne soit considérée comme une expression régulière, cochez la case Utiliser les expressions.
Expression	Permet d'afficher la liste des expressions régulières que vous pouvez utiliser dans vos critères de recherche. Cliquez sur l'une d'elles pour l'insérer dans la zone Rechercher.
Remplacer par	Entrez la chaîne devant remplacer celle recherchée.
Utiliser les expressions	Cochez cette case si vous utilisez des expressions régulières dans vos critères de recherche. Désélectionnez-la si vous n'en employez pas.
Respecter la casse	Cochez cette case pour indiquer que la recherche doit distinguer les majuscules et les minuscules. Désélectionnez-la pour rechercher toutes les instances correspondantes de la chaîne de recherche, qu'elles soient en majuscules ou en minuscules.
Rechercher sur	Indiquez l'endroit où vous voulez effectuer la recherche ou une recherche/remplacement. Dans une session Procedure Builder autonome,  / représente le niveau supérieur du noeud Unités de programme du Navigateur d'objet. Toutes les librairies PL/SQL ouvertes dans la session en cours sont répertoriées sous le signe /. Tous les noeuds sont sélectionnés par défaut. Pour effectuer la recherche uniquement dans l'un des noeuds, cliquez dessus.
Chercher tout	Permet de rechercher toutes les instances correspondantes de la chaîne de recherche que vous avez indiquée. Aucun remplacement n'est effectué.
Remplacer par	Permet de remplacer toutes les instances correspondantes de la chaîne de recherche par celle que vous avez indiquée. Une zone de message apparaît ; elle vous invite à confirmer le remplacement par lots avant sa réalisation.
Fermer	Permet de fermer la boîte de dialogue.
Aide	Permet d'afficher cette rubrique d'aide.
Zone de résultats	Permet d'afficher les instances de la chaîne trouvées. L'emplacement de chacune d'elles est indiqué par le nom du noeud et de l'unité de programme concernés, ainsi que par le numéro de ligne et de colonne de la ligne source. Le nombre total d'instances apparaît dans la barre d'état située au-dessus de cette zone de liste. Cliquez sur l'une de ces instances pour la sélectionner. Vous pouvez en choisir plusieurs.
Remplacer	Permet de remplacer la chaîne de recherche par celle indiquée dans les instances correspondantes sélectionnées dans la zone de résultats uniquement.
Editer	Permet d'ouvrir la source de l'instance correspondante sélectionnée dans l'Editeur d'unité de programme.


Boîte de dialogue Options de conversion PL/SQL V1

Cette boîte de dialogue permet de définir le comportement de l'utilitaire pour tous les types de syntaxe V1 ou V2 pris en charge par PL/SQL. Vos préférences sont enregistrées dans la base de registres Microsoft Windows ou dans un profil UNIX.

Type de problème	Répertorie les types de syntaxe PL/SQL V1 ou V2 pris en charge par l'utilitaire de conversion : CHAR remplacé par VARCHAR2 Longueur de chaîne requise par VARCHAR2 Expressions OUT et IN OUT par défaut supprimées Valeur NULL ajoutée à RETURN dans les fonctions Procédure interne obsolète La fonction LENGTH renvoie la valeur NULL pour une chaîne de longueur zéro. Le transfert de la valeur NULL au sous-programme surchargé est incorrect. Absence d'une instruction RETURN dans la fonction
Convertir	Toutes les instances du type de problème sélectionné sont converties automatiquement sans demande de confirmation.
Convertir tout	Raccourci pour définir tous les types de problème à Convertir. L'utilitaire convertit automatiquement tous les problèmes PL/SQL V1 ou V2 sans demande de confirmation.
Ignorer	Aucune instance du type de problème sélectionné n'est prise en compte. Pour éviter des erreurs du compilateur, vous devez modifier manuellement le code V1 ou V2.
Ignorer tout	Raccourci pour définir tous les types de problème à Ignorer. L'utilitaire ne prend en compte aucun de ces types de problème et n'effectue aucune conversion. Pour éviter des erreurs du compilateur, vous devez modifier manuellement le code V1 ou V2.
Me consulter	Chaque instance du type de problème sélectionné est affichée individuellement dans la boîte de dialogue Conversion. Vous pouvez alors choisir Convertir ou Ignorer.
Me consulter pour tout	Raccourci pour définir tous les types de problème pour lesquels le système doit vous consulter. L'utilitaire vous demande de confirmer (dans la boîte de dialogue Conversion) avant de procéder à la conversion d'une chaîne PL/SQL V1 ou V2.
OK	Permet de confirmer vos sélections et de fermer la boîte de dialogue.
Annuler	Permet d'annuler toute modification apportée au module et de fermer la boîte de dialogue.


Boîte de dialogue Conversion

Cette boîte de dialogue vous permet de contrôler de façon interactive le processus de conversion de PL/SQL V1 ou V2. Pour définir des options pour des  conversions ultérieures, cliquez sur Options.

Fenêtre source	Affiche le source de l'unité de programme où la condition de conversion est détectée. La syntaxe à convertir est mise en évidence. Vous pouvez faire défiler cette fenêtre vers le haut ou vers le bas pour analyser les conversions réalisées.
Condition:	Instruction PL/SQL V1 ou V2 nécessitant une conversion.
Action :	Opération effectuée par l'utilitaire si vous cliquez sur Convertir
Expliquer. . .	Permet d'afficher plus de détails sur le problème et le s conséquences si vous décidez de passer outreà la conversion.
Convertir	Permet d'accepter l'action recommandée par défaut et de passer à l'instruction suivante.
Convertir tout	Permet de convertir tous les problèmes de syntaxe PL/SQL V1 ou V2 dans tout le module, pouvant contenir plusieurs unités de programme. Toutes les actions par défaut sont acceptées.
Ignorer	Permet de ne pas convertir l'instruction PL/SQL V1 ou V2 décrite dans le champ Problème et de passer à l'instruction suivante.
Ignorer tout	Permet de passer outre le processus de conversion pour tout le module, pouvant contenir plusieurs unités de programme.
Options. . .	Permet d'afficher la boîte de dialogue Options de conversion PL/SQL V1 dans laquelle vous pouvez indiquer les options de contrôle du processus de conversion.


Boîte de dialogue Sommaire de conversion PL/SQL V1

Cette boîte de dialogue fournit les informations suivantes :

•	lignes source converties

•	lignes source non prises en compte

lignes source ayant généré des erreurs du compilateur PL/SQL

Boutons de la barre d'outils :

Icône X	Permet de fermer la boîte de dialogue.
Icône ?	Permet d'afficher l'aide de la boîte de dialogue.
Fenêtre Sommaire :

Rechercher	Permet d'afficher les fonctions de recherche standard pour les noeuds développés et réduits.
Noeud	Un noeud par unité de programme dans le module. Si le noeud contient un signe plus, cliquez sur celui-ci pour afficher un sommaire de la conversion (et la façon dont la conversion a été réalisée) et sur ce qui n'a pas été pris en compte. Si un noeud est vide (sans signe plus ni signe moins), l'unité de programme ne nécessite aucune conversion. Pour adresser les erreurs du compilateur - ou analyser le source converti - ou encore les éléments non pris en compte, cliquez deux fois sur une ligne dans le noeud développé. (Ou choisissez la ligne et sélectionnez Programme [image] Editeur d'unité de programme.) L'Editeur s'ouvre, le curseur étant positionné sur la ligne sélectionnée. Remarque : Après avoir modifié le source à l'aide de l'Editeur d'unité de programme, il se peut que la prochaine fois que vous cliquiez deux fois sur une ligne ou que vous utilisiez le bouton Editer le curseur ne soit pas correctement positionné.
Options de menu :

Le menu Programme offre deux options :

Editeur d'unité de programme	Permet d'ouvrir le source dans l'Editeur d'unité de programme. Le curseur se positionne sur la ligne sélectionnée.
Options de conversion	Permet d'afficher la boîte de dialogue Options de conversion afin de visualiser ou de modifier les options indiquées.
Menu instantané :

Cliquez sur le bouton droit de la souris pour afficher un menu instantané.

Editer	Permet d'ouvrir le source dans l'Editeur d'unité de programme. Le curseur se positionne sur la ligne sélectionnée.
Expliquer	Permet d'afficher l'aide en ligne sur le type de conversion pour la ligne sélectionnée.


Interface de l'éditeur d'unité de programme
Interface de l'Editeur d'unité de programme

  Rubriques connexes

L'Editeur contient les boutons et la zone de liste déroulante suivants :

Compiler	Permet de compiler l'unité de programme en cours. Les messages d'erreur générés par la compilation apparaissent dans la fenêtre déroulante Messages de compilation.
Appliquer	Permet d'enregistrer les modifications apportées à l'unité de programme depuis sa première ouverture, ou la dernière opération d'application ou de rétablissement. L'unité de programme n'est pas recompilée. L'Editeur reste ouvert. La pile annuler/rétablir est supprimée.
Rétablir	Permet de rendre à l'unité de programme l'état dans lequel elle se trouvait lors de la dernière opération d'application ou de rétablissement. Si aucune opération d'application ou de rétablissement n'a été exécutée, l'unité de programme reprend son état d'origine.
Nouveau	Permet d'afficher la boîte de dialogue Nouvelle unité de programme, dans laquelle vous pouvez indiquer le type et le nom de l'unité de programme que vous voulez créer.
Supprimer	Permet de supprimer l'unité de programme affichée. Une zone de message vous invite à confirmer l'opération.
Fermer	Permet de fermer l'Editeur d'unité de programme.
Aide	Affiche cette rubrique d'aide.
Nom	Affiche le nom de l'unité de programme en cours. Cliquez sur la flèche à droite de la zone pour afficher la liste déroulante des unités de programme de la session en cours. Cliquez sur une unité de programme de la liste pour l'afficher dans la fenêtre Source.

L'Editeur comporte également les éléments suivants :

Fenêtre Source	Zone de saisie et de modification du texte source de l'unité de programme PL/SQL. Des barres de partage permettent de créer jusqu'à quatre vues différentes de l'unité de programme en cours. Vous pouvez faire défiler chaque vue indépendamment des autres. Pour créer des vues horizontales dans la fenêtre Source, positionnez le curseur sur la barre de partage située en haut de la barre de défilement vertical, puis cliquez deux fois. La fenêtre Source est divisée horizontalement en deux vues de tailles identiques. Vous pouvez également cliquer sur la barre de partage et la faire glisser vers le bas afin de modifier la taille des vues. Pour créer des vues verticales, positionnez le curseur sur la barre de partage située à l'extrémité gauche de la barre de défilement horizontal, puis cliquez deux fois. La fenêtre Source est divisée verticalement en deux vues de tailles identiques. Vous pouvez également cliquer sur la barre de partage et la faire glisser vers la droite pour modifier la taille des vues. Pour redimensionner les vues, cliquez sur la barre de partage qui les sépare et faites-la glisser. Pour supprimer une vue horizontale ou verticale, cliquez deux fois sur la barre de partage qui sépare les vues ou faites-la glisser vers le bord de la fenêtre. Pour supprimer en une seule fois les quatre vues, positionnez le curseur au point d'intersection des barres de partage et cliquez deux fois, ou faites-le glisser vers l'un des angles de la fenêtre. Pour sélectionner une ligne de code, positionnez le curseur sur la marge gauche et cliquez dessus.
Messages de compilation	Affiche les éventuels messages d'erreur générés par la compilation. Cliquer sur un message d'erreur le met en évidence, fait défiler la fenêtre Source vers l'instruction source à l'origine de l'erreur et positionne le curseur de texte à l'emplacement de l'erreur. Par défaut, la fenêtre Messages de compilation apparaît uniquement si des messages d'erreur sont générés au cours de la compilation. Pour afficher manuellement cette fenêtre au moment voulu, déplacez le curseur vers l'angle inférieur droit de la fenêtre de l'Editeur, jusqu'à ce qu'il prenne une forme de viseur. Cliquez ensuite dessus et faites-le glisser vers le haut. La barre de partage est déplacée vers le haut, et la fenêtre Messages de compilation située en-dessous apparaît.
Barre de partage (séparant les fenêtres)	Sépare les fenêtres Source et Messages de compilation. Elle permet de modifier la taille de ces fenêtres. Cliquez sur la barre de partage et faites-la glisser pour redimensionner les fenêtres. Si la fenêtre Messages de compilation n'apparaît pas, la barre de partage est située près du bas de la fenêtre de l'Editeur.
Barre d'état	Affiche, au bas de l'Editeur, des informations sur l'état de l'unité de programme.


Permet de compiler l'unité de programme affichée dans la fenêtre Source. Les messages d'erreur générés par la compilation s'affichent dans la fenêtre déroulante Messages de compilation.


Permet d'enregistrer les modifications apportées à l'unité de programme, dans l'Editeur, depuis la première ouverture ou la dernière opération d'application ou de rétablissement. L'unité de programme n'est pas recompilée. L'Editeur reste ouvert.


Permet de rendre à l'unité de programme l'état dans lequel elle se trouvait lors de la dernière opération d'application ou de rétablissement. Si aucune opération d'application ou de rétablissement n'a été exécutée, l'unité de programme reprend son état d'origine.


Permet d'afficher la boîte de dialogue Nouvelle unité de programme, dans laquelle vous pouvez indiquer le type et le nom de l'unité de programme que vous voulez créer.


Permet de supprimer l'unité de programme affichée, après avoir demandé confirmation.


Vous avez tenté de fermer l'Editeur. Si des modifications ont été effectuées, sans être enregistrées, une zone de message apparaît, vous demandant d'enregistrer ou d'annuler les modifications, ou encore d'annuler l'opération. Après l'enregistrement de toutes les modifications, l'Editeur d'unité de programme disparaît.


Indique le type de l'unité de programme (déclencheur, procédure, etc.) affichée dans l'Editeur.


Indique l'objet auquel le programme est associé.


Affiche le nom de l'unité de programme en cours. Utilisez la flèche à droite du champ pour afficher la liste déroulante des autres unités de programme. Cliquez sur une unité de programme de la liste pour l'afficher dans l'Editeur.


Permet d'entrer et d'éditer le texte source d'une unité de programme PL/SQL.


Affiche les erreurs de syntaxe générées par la compilation. Cliquez sur une erreur pour passer à sa source dans l'unité de programme.


Permet de modifier l'espace relatif occupé par les deux fenêtres (Source et Messages de compilation) dans l'Editeur d'unité de programme. Notez que, par défaut, la fenêtre Messages de compilation ne s'affiche qu'en cas de génération de messages d'erreur de compilation.


La partie gauche de la barre d'état affiche les messages suivants :

Non modifiée	Aucune modification n'a été apportée à l'unité de programme depuis qu'elle a été affichée pour la première fois ou appliquée pour la dernière fois.
Modifiée	Une ou plusieurs modification ont été apportées à l'unité de programme depuis qu'elle a été affichée pour la première fois ou appliquée pour la dernière fois.

La partie droite de la barre d'état affiche les messages suivants :

Non compilé	Le texte source de l'unité de programme, affiché actuellement, n'a pas été compilé.
Compilé avec succès	Le texte source de l'unité de programme, affiché actuellement, a été compilé sans erreur.
Compilé avec erreurs	Le texte source de l'unité de programme, affiché actuellement, a été compilé avec erreurs. Les erreurs s'affichent dans la fenêtre Messages de compilation.


Fonctions d'édition

  Rubriques connexes

Les fonctions d'éditions suivantes sont prises en charge uniquement dans l'Editeur d'unité de programme et dans l'Editeur d'unité de programme stockée :

Retrait/retrait négatif automatique	Lorsque vous entrez du code dans les éditeurs, les lignes sont automatiquement mises en retrait ou en retrait négatif en fonction des règles de syntaxe PL/SQL.
Mise en évidence de la syntaxe à l'aide de couleurs	Les mots-clés, les commentaires, les chaînes et les symboles tels que : = et || sont identifiés à l'aide de couleurs différentes.
Sélection de colonnes et de lignes	Vous pouvez sélectionner des colonnes de texte, ainsi que des lignes de code source. Pour sélectionner une colonne, appuyez sur la touche ALT, puis cliquez sur cette colonne et faites glisser le curseur horizontalement. Pour sélectionner une ligne, cliquez sur la marge à l'extrême gauche de cette ligne dans la fenêtre Source.
Manipulation de texte par glisser-déplacer	Vous pouvez copier ou déplacer le texte sélectionné en le faisant glisser. Pour copier le texte sélectionné, appuyez sur la touche CTRL et faites-le glisser. Pour déplacer le texte sélectionné, il vous suffit de le faire glisser.
Lignes mises en retrait ou en retrait négatif	Les commandes de mise en retrait ou en retrait négatif du menu Edition vous permettent de mettre en retrait ou en retrait négatif les lignes source sélectionnées. Vous pouvez également utiliser les touches TAB et Maj-TAB pour mettre les lignes sélectionnées en retrait ou en retrait négatif.
Vues multiples	Vous pouvez créer jusqu'à quatre vues distinctes de l'unité de programme en cours. Pour créer des vues horizontales, placez le curseur sur la barre de partage en haut de la barre de défilement verticale. Puis cliquez sur la barre de partage et faites-la glisser vers le bas. Pour créer des vues verticales, placez le curseur sur la barre de partage à l'extrême gauche de la barre de défilement horizontale. Puis cliquez sur la barre de partage et faites-la glisser vers la droite. Pour supprimer une vue horizontale ou verticale, cliquez deux fois sur la barre de partage qui sépare les vues.
Impression	Choisissez Fichier [image] Imprimer pour imprimer l'unité de programme en cours.
Annulation et annulation d'annulation illimitées	Les commandes Annuler et Annuler annulation du menu Edition vous permettent d'annuler des modifications ou des annulations pour toutes les opérations effectuées depuis le dernier enregistrement du fichier.

Remarque : Ces fonctions sont disponibles uniquement sous Microsoft Windows. Sous UNIX, vous pouvez uniquement effectuer les opérations suivantes :

•	imprimer l'unité de programme en cours

•	utiliser les touches TAB et Maj-TAB pour mettre en retrait ou en retrait négatif les lignes sélectionnées

•	déplacer le texte sélectionné en le faisant glisser


Utilisation de la souris dans l'éditeur

  Rubriques connexes

Les opérations décrites ci-après sont prises en charge lorsque vous utilisez l'éditeur d'unité de programme (et l'éditeur d'unité de programme stockée) sous Microsoft Windows :

Pour :	Opération à l'aide de la souris :
Sélectionner des caractères dans une plage	Cliquez et faites glisser le curseur du premier au dernier caractère de la plage à sélectionner (cette opération est aussi prise en charge sous UNIX). Ou, Cliquez sur le premier caractère, appuyez sur la touche Maj et cliquez sur le dernier caractère de la plage à sélectionner.
Sélectionner le mot situé sous le curseur	Cliquez deux fois sur ce mot (cette opération est aussi prise en charge sous UNIX). Ou, Appuyez sur la touche Ctrl, puis cliquez sur le mot à sélectionner.
Sélectionner des mots dans une plage	Appuyez sur la touche Ctrl, puis cliquez et faites glisser le curseur du premier au dernier mot de la plage à sélectionner.
Sélectionner une ligne	Positionnez le curseur sur la marge de gauche de la ligne à sélectionner. Cliquez lorsque le curseur prend la forme d'une flèche.
Sélectionner plusieurs lignes	Positionnez le curseur sur la marge de gauche de la première ligne à sélectionner. Lorsque le curseur prend la forme d'une flèche, cliquez et faites-le glisser jusqu'à la dernière ligne à sélectionner.
Sélectionner des colonnes de texte	Appuyez sur la touche Alt, puis cliquez et faites glisser le curseur de la première à la dernière colonne de la plage à sélectionner.
Déplacer le texte sélectionné	Tout d'abord, sélectionnez le texte. Puis cliquez et faites-le glisser vers son nouvel emplacement (cette opération est aussi prise en charge sous UNIX).
Copier le texte sélectionné	Tout d'abord, sélectionnez le texte. Puis appuyez sur la touche Ctrl, faites-le glisser vers l'emplacement où vous souhaitez le copier et relâchez le bouton de la souris.
Séparer une fenêtre en deux vues horizontales	Cliquez deux fois sur la barre de partage située en haut de la barre de défilement verticale. Ou, Cliquez sur la barre de partage située en haut de la barre de défilement verticale et faites-la glisser.
Séparer une fenêtre en deux vues verticales	Cliquez deux fois sur la barre de partage située à l'extrême gauche de la barre de défilement horizontale. Ou, Cliquez sur la barre de partage située à l'extrême gauche de la barre de défilement horizontale et faites-la glisser.
Ajuster la taille relative des vues	Cliquez sur la barre de partage qui sépare les vues et faites-la glisser.
Supprimer des vues dans un affichage de vues multiples	Cliquez deux fois sur la barre de partage qui sépare les vues. Ou, Cliquez sur la barre de partage et faites-la glisser vers le bord de la fenêtre. Pour supprimer les quatre vues à la fois, cliquez deux fois sur le point de rencontre des barres de partage ou faites-le glisser vers n'importe quel angle de la fenêtre.


Utilisation du clavier dans l'éditeur

  Rubriques connexes

Les opérations au clavier décrites ci-après sont prises en charge lorsque vous utilisez l'éditeur d'unité de programme (et l'éditeur d'unité de programme stockée) sous Microsoft Windows et sous UNIX :

Pour :	Séquence de touches :
Déplacer le curseur d'un caractère vers la gauche	Touche Gauche
Sélectionner un caractère en déplaçant le curseur vers la gauche	Maj + Gauche
Déplacer le curseur d'un caractère vers la droite	Touche Droite
Sélectionner un caractère en déplaçant le curseur vers la droite	Maj + Droite
Copier les caractères ou les mots sélectionnés	Ctrl + C
Couper les caractères ou les mots sélectionnés	Ctrl + X
Coller le contenu du presse-papiers	Ctrl + V
Supprimer le caractère à droite du curseur, ou supprimer les caractères ou les mots sélectionnés	Suppr
Supprimer le caractère à gauche du curseur	Retour Arrière
Placer le curseur à la fin de l'unité de programme	Ctrl + Fin	(Windows seulement)
Placer le curseur au début de l'unité de programme	Ctrl + Origine	(Windows seulement)
Sélectionner les lignes source à partir de la position actuelle du curseur jusqu'à la fin de l'unité de programme	Ctrl + Maj + Fin	(Windows seulement)
Sélectionner les lignes source à partir de la position actuelle du curseur jusqu'au début de l'unité de programme	Ctrl + Maj + Origine	(Windows seulement)
Placer le curseur à la fin de la ligne en cours	Fin	(Windows seulement)
Placer le curseur au début de la ligne en cours	Origine	(Windows seulement)
Sélectionner les caractères à partir de la position actuelle du curseur jusqu'à la fin de la ligne en cours	Maj + Fin	(Windows seulement)
Sélectionner les caractères à partir de la position actuelle du curseur jusqu'au début de la ligne en cours	Maj + Origine	(Windows seulement)
Mettre en retrait la ligne sélectionnée ou les caractères à droite du curseur	Touche Tab
Mettre en retrait négatif la ligne sélectionnée	Maj + touche Tab
Faire descendre le curseur d'une ligne	Touche Bas
Sélectionner la ligne en déplaçant le curseur vers le bas	Maj + Bas
Faire monter le curseur d'une ligne	Touche Haut
Sélectionner la ligne en déplaçant le curseur vers le haut	Maj + Haut
Faire défiler vers le bas l'unité de programme du nombre de lignes affichées dans la fenêtre Source	Pg.Suiv
Faire défiler vers le bas l'unité de programme du nombre de lignes affichées dans la fenêtre Source et les sélectionner en même temps	Maj + Pg.Suiv
Faire défiler vers le haut l'unité de programme du nombre de lignes affichées dans la fenêtre Source	Touche Pg.Préc
Faire défiler vers le haut l'unité de programme du nombre de lignes affichées dans la fenêtre Source et les sélectionner en même temps	Maj + Pg.Préc
Annuler l'opération la plus récente	Ctrl + Z	(Windows seulement)
Annuler l'opération d'annulation la plus récente	Ctrl + Y	(Windows seulement)


 Interface de l'Editeur d'unité de programme stockée

  Rubriques connexes

Cette interface propose les boutons et zones de liste suivants :

Nouveau	Permet d'afficher la boîte de dialogue Nouvelle unité de programme, dans laquelle vous pouvez indiquer le type et le nom de l'unité de programme stockée que vous voulez créer.
Enregistrer	Permet de compiler l'unité de programme stockée affichée dans la fenêtre Source. Les messages d'erreur générés par la compilation s'affichent dans la fenêtre déroulante Messages de compilation. La pile Annuler/Annuler annulation est effacée.
Rétablir	Permet de rendre à l'unité de programme l'état dans lequel elle se trouvait lors de la dernière opération d'enregistrement ou de rétablissement. Si aucune opération d'enregistrement ou de rétablissement n'a été exécutée, l'unité de programme reprend son état d'origine.
Eliminer	Permet de supprimer de la base de données l'unité de programme stockée. Une zone de message apparaît et vous invite à confirmer la suppression.
Fermer	Permet de fermer l'Editeur d'unité de programme stockée.
Aide	Affiche cette rubrique d'aide.
Propriétaire	Affiche l'ID utilisateur de base de données du propriétaire de l'unité de programme en cours. Cliquez sur la flèche à droite de cette zone pour afficher la liste déroulante des noms utilisateur. Cette liste ne répertorie que les noms des utilisateurs dont vous avez accès aux unités de programme stockées.
Nom	Affiche le nom de l'unité de programme stockée en cours. Cliquez sur la flèche à droite de la zone pour afficher la liste déroulante des autres unités de programme stockées appartenant à l'utilisateur dont l'ID est indiqué dans le champ Propriétaire. La liste n'affiche que les noms des unités de programme stockées auxquelles vous avez accès.

L'Editeur comporte également les éléments suivants :

Fenêtre source	Entrez et modifiez le texte du source de l'unité de programme PL/SQL. Les barres de partage vous permettent de créer jusqu'à quatre vues distinctes de l'unité de programme en cours. Vous pouvez faire défiler chaque vue de façon indépendante. Pour créer des vues horizontales dans la fenêtre Source, positionnez le curseur sur la barre de partage située en haut de la barre de défilement verticale, puis cliquez deux fois : la fenêtre Source est fractionnée horizontalement en deux vues de taille égale. Sinon, vous pouvez cliquer sur la barre de partage et la faire glisser vers le bas pour modifier la taille des vues. Pour créer des vues verticales, positionnez le curseur sur la barre de partage située à l'extrémité gauche de la barre de défilement horizontale, puis cliquez deux fois : la fenêtre Source est fractionnée verticalement en deux vues de taille égale. Sinon, vous pouvez cliquer sur la barre de partage et la faire glisser vers la droite pour modifier la taille des vues. Pour redimensionner les vues, cliquez sur la barre de partage et faites-la glisser. Pour supprimer une vue horizontale ou verticale, cliquez deux fois sur la barre de partage, ou faites-la glisser hors de la fenêtre. Pour supprimer les quatre vues d'un coup, positionnez le curseur sur l'intersection des barres de partage et cliquez deux fois, ou faites-la glisser vers un angle de la fenêtre. Pour sélectionner une ligne de code, positionnez le curseur sur la marge gauche et cliquez.
Fenêtre Messages de compilation	Affiche les messages d'erreur, le cas échéant, générés par la compilation. Cliquer sur un message d'erreur le met en évidence, fait défiler la fenêtre Source jusqu'à l'instruction source posant problème et positionne le curseur de texte à l'emplacement de l'erreur. Par défaut, la fenêtre Message de compilation ne s'affiche qu'en cas de génération de messages d'erreur de compilation. Pour afficher manuellement la fenêtre Messages de compilation à n'importe quel moment, déplacez le curseur vers l'angle inférieur droit de la fenêtre de l'Editeur jusqu'à ce qu'il se transforme en viseur. Cliquez et faites glisser le curseur vers le haut : la barre de partage est déplacée vers le haut, ce qui fait apparaître la fenêtre Messages de compilation qui se trouvait en dessous.
Barre de partage	Sépare la fenêtre Source et la fenêtre Message de compilation. Permet de modifier la taille de ces fenêtres. Cliquez sur la barre de partage et faites-la glisser pour redimensionner les fenêtres. Si la fenêtre Messages de compilation n'est pas affichée, la barre de partage se situe en fait au bas de la fenêtre de l'Editeur.
Barre d'état	Affiche, au bas de l'Editeur, des informations sur l'état de l'unité de programme stockée.


Permet d'afficher la boîte de dialogue Nouvelle unité de programme, dans laquelle vous pouvez indiquer le type et le nom de l'unité de programme que vous voulez créer.


Permet de compiler l'unité de programme stockée affichée dans la fenêtre Source. Les messages d'erreur générés par la compilation s'affichent dans la fenêtre déroulante Messages de compilation.


Permet de rendre à l'unité de programme stockée l'état dans lequel elle se trouvait lors de la dernière opération d'enregistrement ou de rétablissement. Si aucune opération d'enregistrement ou de rétablissement n'a été exécutée, l'unité de programme reprend son état d'origine.


Permet de supprimer de la base de données l'unité de programme stockée, après avoir demandé confirmation.


Affiche l'ID utilisateur de base de données du propriétaire de l'unité de programme en cours. Cliquez sur la flèche à droite de ce champ pour afficher la liste déroulante des noms utilisateur dont vous avez accès aux unités de programme stockées.


Affiche le nom de l'unité de programme stockée en cours. Cliquez sur la flèche à droite du champ pour afficher la liste déroulante des autres unités de programme stockées appartenant à l'utilisateur dont l'ID est indiqué dans le champ Propriétaire. La liste n'affiche que les noms des unités de programme stockées auxquelles vous avez accès.


Permet d'entrer et d'éditer le texte source d'une unité de programme PL/SQL stockée.


Affiche les erreurs de syntaxe survenues pendant la compilation. Cliquez sur une erreur pour passer à son emplacement source dans l'unité de programme.


Permet de modifier l'espace relatif occupé par les deux fenêtres dans l'Editeur d'unité de programme stockée. Notez que, par défaut, la fenêtre Messages de compilation ne s'affiche qu'en cas de génération de messages d'erreur pendant la compilation.


Interface de la palette de syntaxe

La palette de syntaxe vous permet d'afficher et de copier la syntaxe des instructions PL/SQL ou des packages intégrés. Elle vous permet de copier la syntaxe sélectionnée vers l'éditeur d'unité de programme ou l'éditeur d'unité de programme stockée uniquement.

La palette de syntaxe offre les pages suivantes :

Page PL/SQL	Permet d'afficher et de sélectionner des éléments de langage PL/SQL afin de les copier. Ces éléments sont regroupés par catégories, telles que le flux de contrôle, les curseurs, les exceptions, etc.
Page Procédures internes	Permet d'afficher et de sélectionner un élément PL/SQL intégré (fonction ou procédure) afin de le copier. Les procédures internes sont regroupées par noms de package, tels que EXEC_SQL, DEBUG, DDE, etc.

Chaque page présente les composants suivants :

Liste déroulante	Affiche un nom de catégorie PL/SQL ou de package intégré.  Cliquez sur la flèche située à droite pour choisir une catégorie ou un package.
Zone de liste	Affiche chaque élément de langage de la catégorie PL/SQL ou du package intégré sélectionné. Par défaut, le premier élément de la liste est mis en évidence (sélectionné).  Cliquez sur un élément pour le sélectionner et faire apparaître sa syntaxe complète dans la zone d'affichage. En cliquant deux fois sur un élément PL/SQL, vous insérez sa syntaxe dans la fenêtre d'éditeur active, à l'emplacement du curseur.
Zone d'affichage	Affiche la syntaxe complète de l'élément PL/SQL sélectionné. Les mots réservés apparaissent en majuscules. Une fois la syntaxe insérée dans l'éditeur, remplacez les éléments en minuscules qui ne sont pas des commentaires par les valeurs appropriées. Les éléments en minuscules qui comportent des commentaires sont facultatifs.
Insérer	Cliquez cette option pour copier l'élément sélectionné dans la liste à l'emplacement du curseur dans la fenêtre d'éditeur active.
Fermer	Cliquez sur cette option pour fermer la palette de syntaxe.
Aide	Affiche la présente rubrique d'aide.


Affichage de la palette de syntaxe

Pour afficher la palette de syntaxe :

  Choisissez Programme [image] Palette de syntaxe.


Fermeture de la palette de syntaxe

Pour fermer la palette de syntaxe :

  Cliquez sur le bouton Fermer.


Insertion de la syntaxe dans un éditeur

  Rubriques connexes

Pour insérer la syntaxe dans un éditeur :

1	Assurez-vous que l'éditeur d'unité de programme ou l'éditeur d'unité de programme stockée est actif (sélectionné en dernier).

2	Placez le curseur dans l'éditeur à l'endroit où vous voulez insérer la syntaxe.

3	Dans la palette de syntaxe, sélectionnez l'onglet PL/SQL ou Procédures internes.

4	Choisissez une catégorie PL/SQL ou un package intégré dans la liste déroulante.

Lorsque vous cliquez sur une catégorie ou un package, les éléments PL/SQL pouvant être sélectionnés apparaissent dans la zone de liste située au-dessous.

5	Choisissez un élément PL/SQL dans la zone de liste.

Lorsque vous cliquez sur un élément PL/SQL, sa syntaxe apparaît dans la zone d'affichage se trouvant sous la zone de liste.

6	Cliquez sur Insérer pour copier la syntaxe sélectionnée.

La syntaxe PL/SQL est insérée, avec ses éléments, dans la fenêtre d'éditeur active à l'emplacement actuel du curseur. Les mots réservés apparaissent en majuscules.

Remplacez tous les éléments en minuscules qui ne sont pas des commentaires par les valeurs appropriées. Les éléments comportant des commentaires sont facultatifs.


Liste des catégories PL/SQL

Blocs

Commentaires

Flux de contrôle

Curseurs

Types de données

Exceptions

Fonctions

Boucles

Types d'objet

Packages

Tables PL/SQL

Procédures

Interrogations

Enregistrements

Curseurs SQL

Tables/Vues

Transactions

Types d'utilisateur

Variables


Liste des procédures internes

EXEC_SQL

TOOL_SQL

ORA_FFI

ORA_DE

ORA_PROF

ORA_NLS

TOOL_RES

TOOL_ENV

TEXT_IO

TOOL_ERR

STPROC

LIST

OLE2

DDE

DEBUG

PLITBLM

STANDARD


A propos du contrôle de source

  Rubriques connexes

Ce contrôle permet de gérer et de tenir à jour plusieurs révisions d'un fichier dans une archive.

Une archive est un répertoire, défini par l'utilisateur, qui contient une version texte du fichier, ainsi que des informations sur chacune des révisions effectuées, notamment la description et la date de toutes les modifications.

L'archive permet à un membre d'une équipe de développement d'extraire, de modifier et de mettre en place une révision fiable et cohérente.

Ses composants (Form Builder par exemple) proposent un contrôle de source par une interface générique avec le fournisseur de contrôle de source de votre choix. A l'heure actuelle, il existe des modules enfichables pour le système PVCS (Polytron Version Control System) de INTERSOLV et Pure-Atria Clearcase, mais d'autres modules sont en cours de développement.

Pour toute information sur l'installation et l'utilisation de PVCS, reportez-vous à votre documentation INTERSOLV.

PVCS prend également en charge le verrouillage des fichiers et l'établissement d'états sur les archives.


A propos des fichiers de configuration

Il existe quatre variables d’environnement qui doivent être définies pour optimiser les performances de l’interface de source de contrôle. Sous Windows 3.1, celles-ci sont définies dans oracle.ini, alors que sous Windows NT ou Windows 95/98, elles figurent dans la base de registres, dans la clé SOFTWARE/ORACLE.

DEV2000_SOURCECONTROL indique le système de contrôle de source à utiliser. Il doit être défini à «PVCS». La valeur par défaut étant définie à PVCS par ses composants (Forms Builder par exemple), l’omission de cette variable n’aura aucun effet perceptible dans la présente version. Cependant, comme ils prennent également en charge d’autres système de contrôle de source, la définition de cette variable vous assure un bon fonctionnement de l’interface de contrôle de source.

DEV2000_PROJECT remplace la variable TVCCFG d’Oracle Developer versions 1.0 et 1.1, et identifie le fichier de configuration de projet PVCS (.CFG) à utiliser. Si vous n’indiquez pas de fichier configuration de projet via une variable d’environnement, vous devrez en choisir un dans la boîte de dialogue Contrôle de source : Options pour chaque session.

DEV2000_SCVIEWER contrôle l’affichage des résultats d’un journal de contrôle de source ou d’un état des différences. Pour désactiver l’affichage des résultats, définissez cette variable à NULL (aucune valeur).

DEV2000_SCCONVERT contrôle la conversion des fichiers en code ASCII avant leur archivage dans PVCS, et leur reconversion en binaire avant leur extraction. A moins que ne vouliez mettre à niveau PVCS d’une version antérieure d’Oracle Developer et souhaitiez le conserver, laissez la valeur par défaut FALSE.

Exemple d’une partie du contenu du fichier oracle.ini :

...

DEV2000_SOURCECONTROL=PVCS

DEV2000_PROJECT=C:\PROJECTS\MYPROJ\MYPROJ.CFG

DEV2000_SCVIEWER=NOTEPAD.EXE

DEV2000_SCCONVERT=FALSE

...


A propos de la mise en oeuvre de PVCS

Lorsque vous archivez certains objets (applications Forms, menus, états, affichages, bibliothèques PL/SQL) le fichier binaire est automatiquement converti en un fichier texte équivalent, qui est archivé dans le contrôle de source. Par exemple, si vous avez archivé MONAPPLI.FMB, ce fichier est automatiquement converti en MONAPPLI.FMT (équivalent en format texte), puis ce dernier est archivé dans le contrôle de source.

De même, lorsque vous extrayez un fichier archivé, Developer/2000 convertit la version texte du fichier en son équivalent en format binaire, qui peut être lu par les interfaces de développement. Si vous voulez extraire MONAPPLI.FMT, il sera converti en MONAPPLI.FMB pour que vous puissiez l'éditer.

L'archivage est effectué sur la version texte du fichier pour permettre la génération entre les différentes versions d'un fichier d'états des différences plus significatifs. PVCS archive les fichiers binaires, mais ne crée pas d'états des différences entre les différentes révisions de ces fichiers.

Une fois cette conversion de fichiers effectuée, votre répertoire de travail peut contenir des fichiers supplémentaires, en fonction des options que vous avez choisies pour PVCS. Si la configuration de votre projet prévoit la création de fichiers de travail en lecture seule après l'archivage, votre répertoire contiendra le fichier binaire et un fichier texte en lecture seule. Mais si la suppression des fichiers de travail après archivage est prévue dans la configuration, votre répertoire de travail ne contiendra que le fichier binaire.


A propos de l'archivage d'un fichier

  Rubriques connexes

Tout fichier modifié et entré dans une archive devient une nouvelle révision. Lorsque vous archivez un fichier (par exemple, un fichier de bibliothèque PL/SQL ayant le suffixe .pll), PVC le convertit automatiquement de binaire en texte et l'archive à l'emplacement indiqué, sous la forme d'un fichier texte ayant le suffixe approprié (par exemple, .pld). PVCS utilise le fichier texte pour générer des états d'archive.

Un libellé de version indique qu'une révision appartient à un groupe constituant généralement une version complète de votre application. Les libellés de version permettent d'exécuter une opération simultanément sur tous les fichiers associés à une version particulière en ne faisant référence qu'à un seul nom. Si vous avez déjà archivé une version du module en cours, les informations appropriées sont entrées automatiquement dans le champ Archive.


A propos de l'extraction d'un fichier

  Rubriques connexes

L'extraction d'un fichier archivé vous permet d'accéder à ce fichier pour le parcourir, l'éditer ou l'imprimer. Par défaut, un seul utilisateur peut, à un moment donné, extraire une version verrouillée.

Lorsque vous extrayez un fichier, il est automatiquement converti en fichier de format approprié (par exemple, il un fichier de bibliothèque PL/SQL du format pld est converti au format .pll). Le fichier extrait d'une archive est appelé fichier de travail. Chaque fois que vous archivez une nouvelle variante d'un fichier de travail, elle devient une révision.


A propos de la création d'états d'archive

  Rubriques connexes

PVCS permet de générer des états récapitulatifs sur les sujets suivants :

•	création d'archives

•	attributs des fichiers archivés

•	révisions successives

•	libellés

•	lignes modifiées dans la dernière révision

•	description du fichier de travail


A propos des modèles de promotion

Un modèle de promotion est une suite hiérarchisée de jalons d'un cycle de développement. La promotion permet de contrôler le développement du code source, de la phase initiale à la version finale. Chaque jalon est représenté par un groupe de promotion. Exemples : Développement, Assurance qualité et Production. Un modèle de promotion est une fonction avancée, conseillée pour les sites appliquant des procédures formelles d'évolution de logiciels.

Un modèle de promotion peut avoir un ou plusieurs groupes de niveau inférieur, ou de développement. Lorsqu'un modèle de promotion est en vigueur, les utilisateur ne peuvent modifier que les révisions associées à un groupe de développement. Pour éditer une révision associée à un groupe de niveau supérieur, l'utilisateur doit l'extraire et la ré-associer à un groupe de développement lors de l'extraction, puis la faire repasser à un groupe supérieur après l'avoir ré-archivée.

Si le modèle de promotion ne comprend qu'un groupe de développement, vous ne pouvez verrouiller qu'une révision de l'archive à la fois. Pour concevoir un modèle de promotion pour un développement parallèle, vous devez inclure au moins deux groupes de développement.

Au-dessus du ou des groupes de développement, vous pouvez définir un nombre quelconque de groupes de promotion intermédiaires pour les différentes étapes de test ou d'éditions préliminaires. Au niveau le plus élevé se trouve le groupe de production qui indique généralement que les révisions sont prêtes à être commercialisées.

L'utilisation d'un modèle de promotion vous permet de :

•	Connaître rapidement l'état d'un projet. Vous pouvez exécuter un état d'archivage sur un projet pour savoir immédiatement quels sont modules qui n'ont pas atteint un jalon particulier du cycle de développement.

•	Contrôler l'accès aux révisions aux niveaux autres que celui du développement. Etant donné que les utilisateurs ne peuvent pas modifier les révisions associées à des groupes de promotion post-développement, vous êtes certain que toutes les révisions sont intégralement testées.

•	Personnaliser votre propre modèle. Vous pouvez personnaliser une structure de promotion adaptée de façon unique à chaque projet, en indiquant le nombre de jalons de votre choix dans la structure de promotion.


Création d'un répertoire d'archives

  Etape suivante	  Rubriques connexes

Pour créer un répertoire d'archives :  Remarque :

1	Choisissez Fichier [image] Administration [image] Gestion des archives et rapports pour afficher la boîte de dialogue Contrôle de source : Options.

2	S'il n'est pas déjà sélectionné, sélectionnez l'onglet Projet.

3	Indiquez le nom et l'emplacement de votre répertoire d'archives dans le champ Nouveau répertoire d'archive.

4	Cliquez sur Ajouter nouveau répertoire à liste, puis sur Fermer pour fermer la boîte de dialogue.


Vous ne pouvez ajouter des répertoires d'archive qu'après avoir défini le paramètre DEV2000_PROJECT dans le fichier oracle.ini. Sous Microsoft Windows, définissez ce paramètre de la manière suivante :

DEV2000_PROJECT=C:\PVCS\PROJECT1\PROJECT1.CFG

Pour éditer le paramètre DEV2000_PROJECT, utilisez le fichier Oracle.ini sous Windows 3.1, et la base de registres sous Windows 95/98 et NT.


Archivage d'un fichier

  Etape suivante	  Rubriques connexes

Pour archiver un fichier :

1	Choisissez Fichier [image] Administration [image] Archiver pour afficher la boîte de dialogue Contrôle de source : archivage.

2	Entrez le nom du fichier à archiver dans la boîte de texte Fichier de travail.

3	Indiquez l'emplacement de votre archive dans le champ Archive.

4	(Facultatif) Fournissez un Libellé de version, un Groupe de promotion et une Description.

5	(Facultatif) Cliquez sur la case à cocher Garder le fichier verrouillé si vous voulez qu'une copie modifiable du fichier soit disponible localement, même après son archivage. Ce type de copie permet, sans avoir à extraire le fichier, de le modifier et d'archiver les modifications ultérieures du fichier sans avoir à l'extraire.

6	Cliquez sur OK pour archiver votre fichier.

PVCS archive le fichier.


Extraction d'un fichier

  Etape suivante	  Rubriques connexes

Pour extraire un fichier :

1	Choisissez Fichier [image] Administration [image] Extraire pour afficher la boîte de dialogue Contrôle de source : extraction.

2	Indiquez l'emplacement de l'archive source dans le champ Depuis l'archive.

3	Entrez dans la boîte de texte Nom de fichier le nom du fichier que vous voulez extraire.

4	Sélectionnez une révision de fichier dans le champ Révisions.

5	(Facultatif) Indiquez la destination en entrant un chemin dans le champ Destination.

6	(Facultatif) Pour verrouiller le fichier que vous extrayez, choisissez le Groupe de promotion de niveau Développement qui sera attribué à la révision en cours d'extraction.

7	(Facultatif) Cliquez sur la case à cocher Verrouiller ce fichier Remarque :

8	(Facultatif) Cliquez sur la case à cocher Ouvrir fichier après extraction. Si cette case est déjà cochée, le fichier extrait sera ouvert dans Designer lorsqu'il aura été extrait de PVCS.

9	Cliquez sur OK pour extraire le fichier.


Si vous voulez modifier un fichier d'archives, vous devez valider la case à cocher Verrouiller ce fichier pour archiver vos modifications. Sinon, la version extraite sera la version en lecture seule.


Création d'un état d'archives

  Rubriques connexes

Pour créer un état d'archives :

1	Choisissez Fichier [image] Administration [image] Gestion des archives et rapports.

2	Cliquez sur l'onglet Etat pour afficher la page Contrôle de source : options Etat.

3	Indiquez l'emplacement de l'archive dans le champ Archive.

4	Indiquez le nom du fichier d'archive dans le champ Fichier source. Pour générer l'état, PVCS compare ce fichier et le fichier cible.

5	Indiquez le nom d'un fichier cible dans le champ Fichier cible.  Remarque

6	Sélectionnez les révisions du fichier dans les champs Révision source et Révision cible, respectivement.

7	Indiquez le nom et l'emplacement de l'état dans le champ Fichier de sortie, puis cliquez sur Exécuter état.

PVCS crée l'état. Si vous avez indiqué un programme de visualisation en utilisant la variable d'environnement DEV2000_SCVIEWER ou le paramètre oracle.ini, ce programme sera appelé pour afficher la sortie. Sinon, utilisez un éditeur pour ouvrir votre fichier état.


Si vous comparez deux révisions stockées dans la même archive, entrez le nom du fichier d'archive que vous avez fourni à l'étape 4. Si vous comparez des fichiers d'archive différents, indiquez un fichier d'archive différent dans le champ Fichier cible.


Boîte de dialogue Contrôle de source : Archivage

  Rubriques connexes

Permet de fusionner le fichier indiqué dans l'archive indiquée.

Cette boîte de dialogue comporte les options suivantes :

Nom de fichier	Permet d'indiquer le nom du fichier que vous allez archiver. Choisissez Parcourir pour appeler une boîte de dialogue dans laquelle vous pourrez sélectionner un fichier.
Archive	Liste déroulante de toutes les archives disponibles pour le projet en cours. Sélectionnez l'archive dans laquelle le fichier doit être enregistré.
Libellé de version	(Facultatif) Permet d'indiquer le libellé de la version du fichier.
Groupe de promotion	Si vous avez défini un modèle de promotion pour votre projet PVCS, cette liste est activée. Choisissez le groupe de promotion de niveau Développement qui doit être attribué à la révision à archiver.
Description	Permet de décrire les modifications apportées à cette révision. Bien que ce champ soit facultatif, il est conseillé de le remplir pour faciliter l'identification des révisions lors de leur extraction.
Garder le fichier verrouillé ?	Permet d'indiquer si une copie modifiable du fichier d'archivage est disponible localement, même après l'archivage du fichier. Ce type de copie permet, sans avoir à extraire le fichier, de le modifier et d'enregistrer les modifications ultérieures.


Boîte de dialogue Contrôle de source : Extraction

  Rubriques connexes

Permet d'extraire d'une archive le fichier que vous voulez éditer.

Cette boîte de dialogue comprend les options suivantes :

Depuis l'archive	Permet d'indiquer le nom du répertoire d'archive contenant le fichier à extraire.
Nom de fichier	Permet d'indiquer le nom du fichier à extraire du contrôle de source. Choisissez Parcourir pour appeler une boîte de dialogue dans laquelle vous pourrez sélectionner un fichier.
Révisions	Affiche les révisions disponibles ainsi que les libellés de version du fichier sélectionné dans le champ Nom de fichier.
Description	Dresse la liste des descriptions des versions disponibles énumérées dans la liste Révisions.
Répertoire cible	(Facultatif) Permet d'indiquer le répertoire de destination du fichier à extraire.
Groupe de promotion	Si vous avez défini un modèle de promotion pour votre projet PVCS, cette liste est activée. Si vous voulez verrouiller le fichier à extraire, choisissez le groupe de promotion de niveau Développement qui sera attribué à la révision à extraire.
Verrouiller fichier à l'extraction	Permet d'indiquer si le fichier à extraire doit être marqué verrouillé. Un fichier verrouillé est protégé contre les mises à jour par d'autres utilisateurs.
Ouvrir fichier après extraction	Si vous cochez cette case, le fichier sera ouvert dans Designer après avoir été extrait de PVCS.


Boîte de dialogue Contrôle de source : Options

  Rubriques connexes

Cette boîte de dialogue comprend trois onglets :

Options de projet

Options de fichier

Options d'état


Contrôle de source : page Options de projet

  Rubriques connexes

La page Options de projet permet d'ajouter et de supprimer des répertoires d'archives dans votre fichier de configuration de projet.

Cette page comporte les option suivantes :

Projet en cours	Nom du fichier de configuration du projet PVCS en cours. Sa valeur initiale est la valeur de DEV2000_PROJECT dans le fichier oracle.ini. Pour afficher la boîte de dialogue de fichiers de votre système d'exploitation, entrez directement un nom de fichier ou cliquez sur Parcourir.
Nouveau répertoire d'archives	Permet d'indiquer le nom du nouveau répertoire d'archives à ajouter à la liste des répertoires d'archives disponibles dans le projet en cours. Pour afficher la boîte de dialogue de fichiers de votre système d'exploitation entrez un nom de répertoire ou cliquez sur Parcourir.
Liste des répertoires d'archives	Affiche les répertoires d'archives disponibles dans le projet en cours.
Ajouter nouveau répertoire à la liste	Après avoir entré un répertoire d'archives dans la boîte de texte Nouveau répertoire d'archives, cliquez sur Ajouter nouveau répertoire à liste pour ajouter ce répertoire au projet en cours. Une fois  ajouté, le répertoire apparaîtra dans la liste.
Retirer répertoire sélectionné de la liste	Sélectionnez un répertoire d'archives de la liste, puis cliquez sur Supprimer répertoire sélectionné de la liste pour le supprimer du projet.


Contrôle de source : page Options de fichier

  Rubriques connexes

La page Options de fichier permet de verrouiller ou de déverrouiller une archive ou de générer un journal d'activités de cette archive.

Cette page comporte les options suivantes :

Archive	Liste déroulante de tous les répertoires d'archives du fichier de configuration de projet en cours.
Nom de fichier	Permet d'indiquer le fichier d'archives auquel vous voulez accéder. Vous pouvez entrer directement le nom du fichier ou en choisir un à l'aide de Parcourir. Si la configuration de votre projet PVCS prévoit d'ignorer les chemins d'accès au fichier de travail, vous pouvez indiquer soit un fichier de travail, soit un fichier d'archives. Sinon, vous ne pouvez indiquez qu'un fichier d'archives.
Révisions	Cette liste déroulante affiche toutes les révisions et tous les libellés de version du fichier sélectionné. Elle comporte aussi une entrée vide qui indique l'absence de sélection. Si vous sélectionnez une révision, elle sera verrouillée ou non verrouillée. Si vous ne sélectionnez pas de révision, le comportement du programme dépendra de la présence ou de l'absence d'une définition de modèle de promotion. Si vous n'avez pas défini de modèle, la révision sera verrouillée. Si vous avez défini un modèle, la révision attribuée au groupe de promotion indiqué sera verrouillée. En cas de sélection de Déverrouiller sans révision sélectionnée, tous les verrous que vous avez posés sur le fichier seront supprimés.
Groupe de promotion	Si vous avez défini un modèle de promotion pour votre projet PVCS, cette liste est activée et affiche tous les groupes de promotion de niveau Développement de votre modèle de promotion. Lorsque vous verrouillez une révision, le groupe de promotion indiqué dans cette liste lui est attribué.
Nom du fichier de journalisation	Permet d'indiquer le nom du fichier de journalisation.
Type de journalisation	Permet d'indiquer le type des mises à jour à entrer dans le fichier de journalisation indiqué lors d'un archivage ou d'une extraction.
Verrouiller révision	Permet de verrouiller le fichier indiqué dans le champ Nom de fichier, sans l'extraire du contrôle de source. Un fichier verrouillé est protégé contre les mises à jour par d'autres utilisateurs. Si vous sélectionnez une révision de la liste Révisions, elle est verrouillée. Si vous n'en sélectionnez pas, la révision (ou celle attribuée au groupe de promotion indiqué) est verrouillée. Si vous avez défini un modèle de promotion pour votre projet PVCS, le groupe de promotion indiqué est attribué à la révision verrouillée.
Déverrouiller révision	Permet de déverrouiller le fichier indiqué dans le champ Nom de fichier pour permettre à d'autres utilisateurs d'extraire et de modifier le fichier d'archives. Si vous avez sélectionné une révision de la liste Révisions, elle sera déverrouillée. Si vous n'en sélectionnez pas, tous les verrous que vous avez posés sur les révisions du fichier sont libérés.
Générer journalisation	Permet de générer un fichier de journalisation ayant le nom indiqué. Le type d'entrée dans ce fichier journalisation est déterminé par l'option Type de journalisation. Si vous avez indiqué un programme de visualisation en utilisant la variable d'environnement DEV2000_SCVIEWER ou le paramètre oracle.ini, ce programme sera appelé pour afficher la sortie.


Contrôle de source : page Options d'état

  Rubriques connexes

La page Options d'état permet de définir et de créer des états d'archive.

Cette page comporte les options suivantes :

Archive	Liste déroulante de tous les répertoires d'archives du fichier de configuration de projet en cours.
Fichier source	Permet d'indiquer le premier fichier à utiliser pour générer un état des différences. Vous pouvez entrer directement le nom, ou choisir un fichier en utilisant le bouton adjacent Parcourir. Si la configuration de votre projet PVCS prévoit d'ignorer les chemins d'accès au fichier de travail, vous pouvez indiquer soit un fichier de travail, soit un fichier d'archives. Sinon, vous ne pouvez indiquez qu'un fichier d'archives.
Révision source	Liste déroulante de toutes les révisions et de tous les libellés de version du fichier source.
Fichier cible	Permet d'indiquer le nom du fichier cible. Pour générer un état, PVCS compare le fichier source et le fichier cible.
Révision cible	Liste déroulante de toutes les révisions et de tous les libellés de version du fichier cible.
Fichier de sortie	Permet d'indiquer le répertoire de destination et le nom du fichier dans lequel devra être entré l'état des différences découlant de la comparaison de deux fichiers.
Exécuter état	Permet de créer un état en fonction des options indiquées. Si vous avez indiqué un programme de visualisation en utilisant la variable d'environnement DEV2000_SCVIEWER ou le paramètre oracle.ini, ce programme sera appelé pour afficher la sortie.


Messages d'erreur

Les messages d'erreur qui peuvent s'afficher lorsque vous utilisez les boîtes de dialogue d'interface de contrôle de source sont décrits ci-dessous.

D2SCP-001 :	Accès au fichier refusé par le système de fichiers

 Cause :	Vous n'êtes pas autorisé par le système de fichiers à lire des fichiers d'archives, à écrire des fichiers de travail ou à écrire la sortie de l'état ou la sortie journal.

 Action :	Si vous estimez que vous devez avoir accès à ces fichiers, contactez votre administrateur système.

D2SCP-002 :	Privilèges d'accès insuffisants du gestionnaire de version

 Cause :	Vous n'êtes pas autorisé par PVCS à accéder à l'archive que vous avez indiquée. Ce message apparaît également si la modification des répertoires d'archives a été désactivée dans le projet maître et que vous tentiez de les modifier dans l'onglet Options de projet de la boîte de dialogue Options.

 Action :	Si vous estimez que vous devez avoir accès à cette archive, contactez votre administrateur système.

D2SCP-003 :	Cette archive existe déjà

 Cause :	Ce message indique une erreur interne et ne devrait pas apparaître.

 Action :	S'il réapparaît lorsque vous répétez l'opération, contactez le Support technique Oracle.

D2SCP-004 :	Archive spécifiée introuvable

 Cause :	Vous avez entré ou sélectionné un fichier qui n'était pas une archive, alors qu'il fallait indiquer un fichier d'archives. Ce message apparaît généralement lorsque vous sélectionnez le fichier de travail au lieu du fichier d'archives (par exemple, MONAPPLI.FMB au lieu de MONAPPLI.FMV).

 Action :	Utilisez le bouton Parcourir pour choisir un fichier d'archives.

D2SCP-005 :	Nom de fichier, unité ou chemin non valide ou menu de fichier contient des caractères non valides

 Cause :	Le nom de fichier que vous avez entré n'est pas un nom de fichier valide pour le système d'exploitation.

 Action :	Vérifiez la syntaxe du nom de fichier.

D2SCP-006 :	Fichier en cours d'utilisation par un autre processus

 Cause :	Le fichier auquel vous tentez d'accéder a été ouvert par un autre utilisateur PVCS.

 Action :	Si vous attendez un peu avant de tenter à nouveau d'exécuter l'opération, ce message ne devrait plus apparaître.

D2SCP-007 :	Echec de conversion. Le fichier de travail est en lecture seule ou n'est pas pris en charge.

 Cause :	Causes possibles :

A.	Votre fichier de travail est en lecture seule. Par exemple, vous extrayez le fichier sans le verrouiller, puis vous le verrouillez dans la boîte de dialogue Options.

B.	Vous avez tenté d'archiver ou d'extraire un fichier d'un type non reconnu.

 Action :	Pour corriger cette erreur, vous pouvez exécuter les opérations suivantes.

A.	Utiliser le Gestionnaire de fichiers ou l'explorateur de Windows pour permettre l'écriture dans le fichier avant de poursuivre.

B.	Archiver ou extraire le fichier en utilisant l'interface PVCS autonome.

Notez que vous pouvez extraire n’importe quel fichier à condition qu’il soit reconnu, car Oracle Developer ne peut que déterminer s'il s'agit d'un type de fichier pris en charge à partir du fichier de travail. Lorsque vous archivez un fichier, le fichier de travail permet à Oracle Developer de tester le fichier avant de l'archiver. Lorsque vous extrayez un fichier, Developper/2000 commence par l'extraire pour obtenir un fichier de travail. Ce n'est qu'à ce stade qu'il teste le fichier. Vous pouvez donc ignorer cette erreur lors d'une extraction si vous savez que le fichier n'est pas un fichier Oracle Developer.

D2SCP-008 :	Valeurs non valides ou insuffisantes

 Cause :	Ce message indique une erreur interne et ne devrait pas apparaître.

 Action :	S'il réapparaît lorsque vous répétez l'opération, contactez le Support technique Oracle.

D2SCP-010 :	Le libellé de version existe déjà

 Cause :	Vous avez indiqué dans la boîte de dialogue Archivage un libellé de version qui existe déjà pour le fichier que vous archivez. PVCS requiert que les libellés de version soient uniques.

 Action :	Changez le libellé. Pour afficher les libellés utilisés, utilisez la fonction Journal de l'onglet Options de fichiers de la boîte de dialogue Options.

D2SCP-011 :	La révision spécifiée n'existe pas

 Cause :	Ce message indique une erreur interne et ne devrait pas apparaître.

 Action :	S'il réapparaît lorsque vous avez répété l'opération, contactez le Support technique Oracle.

D2SCP-012 :	Fichier de configuration spécifié non valide

 Cause :	Causes possibles :

A.	Le fichier que vous avez choisi dans l'onglet Options de projet de la boîte de dialogue Options n'est pas un fichier de configuration PVCS valide.

B.	Si cette erreur apparaît lorsque vous tentez d'accéder à la boîte de dialogue Archivage ou Extraction, le fichier de configuration indiqué dans la variable d'environnement DEV2000_PROJECT n'est pas valide.

 Action :	Pour corriger cette erreur, vous pouvez exécuter les opérations suivantes.

A.	Sélectionner un fichier valide.

B.	Modifier la variable ou utiliser l'onglet Options de projet de la boîte de dialogue Options pour définir un fichier de configuration valide.

D2SCP-013 :	Vous devez d'abord choisir un projet depuis 'Contrôle de source : Options'

 Cause :	Vous avez tenté d'accéder à la boîte de dialogue Archivage ou Extraction sans avoir indiqué de projet, en utilisant soit la variable DEV2000_PROJECT du fichier ORACLE.INI, soit l'onglet Options de projet de la boîte de dialogue Options.

 Action :	Vous devez passer à l'onglet Options de projet et sélectionner un projet avant de poursuivre.

D2SCP-014 :	Mise à jour impossible du fichier de configuration de projet

 Cause :	Vous avez tenté d'ajouter ou de supprimer des répertoires d'archives dans le fichier de configuration de projet, sans être autorisé à écrire dans le fichier ou le répertoire dans lequel se trouve le fichier.

 Action :	Consultez votre administrateur système ou PVCS si vous estimez que vous devriez avoir cette autorisation.

D2SCP-015 :	Révision non verrouillée

 Cause :	Vous avez tenté d'archiver une révision que vous n'avez pas verrouillée, ou de déverrouiller une révision que vous n'avez pas verrouillée (à partir de l'onglet Options de fichier).

 Action :	Si vous avez modifié la révision, verrouillez-la à partir de l'onglet Options de fichier avant de l'archiver.

D2SCP-016 :	Verrouillage impossible de la révision spécifiée

 Cause :	Vous avez tenté d'extraire une révision verrouillée à partir de la boîte de dialogue Extraction ou de verrouiller une révision à partir de l'onglet Options de fichiers, mais PVCS n'a pas pu vous autoriser à effectuer le verrouillage. Causes possibles :

A.	La révision est déjà verrouillée, par vous ou par quelqu'un d'autre.

B.	Votre projet ne permet pas les verrous multiples, et la révision est déjà verrouillée.

C.	Si votre projet comporte un modèle de promotion, le groupe de promotion que vous avez indiqué est peut être déjà attribué à une révision verrouillée.

 Action :	Pour corriger cette erreur, vous pouvez exécuter les opérations suivantes.

A.	Utilisez la fonction de journalisation pour connaître le propriétaire du verrou et, si vous avez déjà verrouillé la révision, extrayez-la sans demander de verrou. Si quelqu'un d'autre a verrouillé le fichier, attendez qu'il le déverrouille avant d'extraire le fichier à modifier.

B.	Attendez que la révision ou le fichier soit disponible, ou envisagez d'autoriser plusieurs verrous par fichier dans votre projet.

C.	Attendez que le groupe de promotion soit disponible (c'est-à-dire ne soit pas attribué à une révision verrouillée) ou utilisez un autre groupe de promotion de niveau Développement.

D2SCP-017 :	Le répertoire spécifié n'existe pas

 Cause :	Vous avez indiqué un répertoire qui n'existe pas. Cette erreur apparaît souvent en cas d'extraction de fichier lorsque l'emplacement dans lequel il a été archivé n'existe pas sur votre poste de travail.

 Action :	Dans ce cas, éditez le fichier Cible pour qu'il pointe sur un répertoire existant.

D2SCP-018 :	Réacheminement impossible de la sortie vers fichier

 Cause :	Le nom de fichier que vous avez indiqué pour la sortie de l'état des différences ou le journal n'est pas valide, ou bien le fichier n'a pas pu être ouvert en écriture.

 Action :	Indiquez un nom de fichier valide et pouvant être utilisé en écriture.

D2SCP-100 :	PVCS Erreur numéro - mot-clé

 Cause :	PVCS a émis une erreur que l'interface de contrôle de source n'a pas pu traiter.

Action :	Reportez-vous à votre documentation PVCS en utilisant le numéro de l'erreur ou son mot-clé, et prenez les mesures nécessaires.


Pourquoi l'interface du gestionnaire de configuration de PVCS n'affiche-t-elle pas les nouveaux fichiers ou les révisions ?

Lorsque j'archive des fichiers et attribue des libellés de version, l'interface du gestionnaire de configuration de PVCS n'affiche pas les nouveaux fichiers ou les révisions. Que faire ?

Le dossier de projet doit être mise à jour par l'utilisation des nouvelles informations figurant dans les archives (nouveaux fichiers et révisions). Pour cela, choisissez Mettre à jour dossier projet dans le menu Projet de niveau supérieur de PVCS. Les nouveaux fichiers et les révisions doivent alors être visibles dans la fenêtre "Dossiers" de PVCS.


Pourquoi les options de menu de contrôle de source ne sont-elles activées que dans un produit ?

Si j'exécute simultanément plusieurs produits, les options de menu de contrôle de source ne sont activées que dans l'un d'entre eux. Pourquoi ?

PVCS sous Windows n'est pas invariant - cela signifie qu'à un moment donné un seul programme (programme activé par PVCS comme Report Builder ou l'interface PVCS elle-même) peut accéder aux services PVCS. Vous devrez sortir du programme dont les menus sont activés, et de celui à partir duquel vous voulez accéder aux services PVCS, puis relancer celui dans lequel vous voulez accéder à PVCS.


Pourquoi le système affiche-t-il un message d'erreur indiquant que PVCS ne peut pas trouver l'archive ?

Lorsque j'ai tenté d'extraire un état, j'ai choisi le fichier .RDV (fichier d'archives), mais je reçois toujours un message indiquant que PVCS ne peut pas trouver l'archive. Que se passe-t-il ?

Même si vous avez choisi un fichier .RDV, il est possible qu'il ne s'agisse pas du fichier d'archives. Report Builder écrit ses fichiers intermédiaires (ASCII) avec le suffixe .RDV avant de les archiver. (Pour tout détail, reportez-vous à A propos de la mise en oeuvre de PVCS  Vérifiez que vous sélectionnez bien un fichier .RDV dans le répertoire d'archives, et non le répertoire de travail. Pour éviter cette confusion, vous pouvez :

•	Définir l'option du projet PVCS de suppression des fichiers de travail après l'archivage. Dans ce cas, les fichiers .RDV intermédiaires d'état ne resteront pas sur votre disque.

•	Modifier la règle relative aux suffixes pour que les fichiers .RDV archivés aient un suffixe différent, par exemple .VRD, ce qui évitera les confusions entre les fichiers .VRD et les fichiers .RDV lors de l'extraction.

•	Configurer votre projet de manière à ignorer les chemins d'accès au fichier de travail lorsque vous explorez les archives, ce qui permet d'indiquer le fichier de travail (dans ce cas, le fichier .RDF) et non le fichier d'archive, lors de l'extraction.

Ces options figurent dans l'interface utilisateur du gestionnaire de configuration PVCS, dans l'option de menu de configuration de projet.


Comment être certain d'utiliser le nom utilisateur approprié lorsque je verrouille un fichier ?

Lorsque je verrouille un fichier (ou que j'extrais un fichier verrouillé) l'ID utilisateur est défini à "UNKNOWN" pour que d'autres utilisateurs puissent archiver ou déverrouiller le fichier. Comment être certain que le nom utilisateur que j'utilise est correct ?

L'option de configuration de projet de PVCS "Login Source" de la section Réseau des options de configuration de projet de PVCS (dans l'interface du gestionnaire de versions de PVCS) évite ce type de problème, car elle permet de définir la façon dont PVCS détermine l'ID utilisateur en cours. Par exemple, avec un réseau NETWARE, vous pouvez demander à PVCS d'utiliser l'ID de connexion NETWARE en cours. Sous Windows NT, vous pouvez utiliser l'ID de connexion NT en choisissant la source de connexion "HOST". Pour plus de détails, consultez votre documentation PVCS.


Comment faire pour sélectionner les fichiers de travail à extraire ?

Y-a-t-il une procédure qui permette de sélectionner des fichiers de travail, et non des fichiers d'archives à extraire ?

Vous pouvez utiliser l'option de configuration de projet de PVCS "Ignore Workfile Path" de la section "Archive Searching" des options de configurations de projet de PVCS (dans l'interface du gestionnaire de versions de PVCS). Si vous activez cette option, vous pourrez sélectionner soit des fichiers de travail soit des fichiers d'archive dans les boîtes de dialogue Extraction et Contrôle de source : Options.


J'ai reçu un message indiquant que VCSDIR n'est pas autorisé dans le fichier de configuration de projet. Pourquoi ?

J'ai configuré mon projet maître de manière à désactiver le changement des répertoires d'archives. Dans l'interface du Gestionnaire de versions de PVCS, je ne peux pas changer les répertoires d'archives d'un sous-projet, ce qui est normal. Mais dans Oracle Developer c'est possible. Par la suite, à partir de l'interface du Gestionnaire de versions de PVCS, un message d'erreur m'a indiqué que VCSDIR n'était pas autorisé dans le fichier de configuration du projet. Que s'est-il passé ?

L'interface du Gestionnaire de versions de PVCS a recherché dans sa racine un fichier MASTER.CFG par défaut, et l'a probablement trouvé. C'est la raison pour laquelle il a généré l'erreur indiquée lorsque vous avez changé les répertoires d'archives. Pour rendre le fichier de configuration maître reconnaissable, vous devez configurer PVCS en utilisant la commande VCONFIG. Cette commande encode le nom de votre fichier de configuration maître dans les bibliothèques PVCS, et garantit que personne ne peut modifier accidentellement la liste des répertoires d'archives. Reportez-vous aux sections "Master Configuration File" et "VCONFIG Command" dans PVCS Command-Line Reference Guide INTERSOLV.


• 9


Accès à des sources de données non Oracle

  Rubriques connexes

Via Oracle Open Client Adapter (OCA), votre application peut se connecter à toute source de données ODBC. Des informations particulières vous sont fournies concernant les sources de données énumérées ci-dessous.

Cliquez sur la source de données à laquelle vous voulez accéder :

Personal Oracle Lite

Microsoft SQL Server  (versions 4.2, 6.0 et 6.5)

Microsoft Access  (version 2.0 et ultérieures)

Oracle Rdb  (versions 5.1, 6.1 et 7.0)

Sybase   (SQL Server version 4.9, System 10 et System 11)

Tandem NonStop SQL

Informix   (SE et Online versions 5.x, 6.x et 7.x)


Préparation pour l'utilisation de OCA (Open Client Adapter)

  Rubriques connexes

Pour configurer votre système en vue de l'utilisation de OCA :

1	Installez le serveur de base de données et le logiciel client nécessaires, y compris les bibliothèques réseau. Configurez votre base de données, créez les comptes de base de données et accordez aux utilisateurs les autorisations d'accès appropriées. Notez que pour certaines sources de données mono-utilisateurs et mono-ordinateurs, comme par exemple Microsoft Access, les notions de serveur ou de client de base de données n'interviennent pas et qu'aucune configuration particulière n'est requise (il vous faut cependant créer le fichier de base de données dans lequel stocker les tables de base de données).

2	Installez sur votre ordinateur client les pilotes ODBC nécessaires et configurez la source de données à l'aide de Microsoft ODBC Administrator (automatiquement installé avec les pilotes). Les pilotes ODBC Intersolv (pour SQL Server, Rdb, Sybase, Informix, Ingres et de nombreuses autres bases de données) sont installables à partir de votre CD d'installation. Vous pouvez également utiliser des pilotes écrits par Microsoft, IBM et d'autres fournisseurs de pilotes ODBC.


Accès à Personal Oracle Lite

  Rubriques connexes 	  Ouvre oca_info.pdf

Pour accéder à Personal Oracle Lite :

1	Configurez votre système pour l'utilisation de OCA (Open Client Adapter).

2	Lisez attentivement les notes de version et la documentation PDF (oca_info.pdf).

3	Exécutez les scripts SQL permettant de créer côté serveur des vues de dictionnaires de données utilisées par les composants de conception pour afficher des noms d'objets de base de données parmi lesquels effectuer une sélection. Remarque

UBT32.EXE utilisateur/motdepasse@ODBC:sourcedonnées[:nombd] @sqlscript  Exemple

Si nombd n'est pas précisé, les vues seront créées dans la base de données " courante " pour la connexion ODBC.

4	Lancez l'application Builder.

5	(Facultatif)  Exécutez les scripts SQL permettant de créer et de remplir les tables de démonstration. Exemple

6	(Form Builder seulement) Définissez à Oui la propriété Clé primaire pour chaque élément de données. Les éléments de données correspondent aux colonnes dans votre source de données.

7	Lorsque vous êtes prêt à vous connecter à la source de données Personal Oracle Lite, entrez la chaîne de connexion suivante dans la boîte de dialogue Connexion :

[utilisateur[/motdepasse]]@ODBC:sourcedonnées[:nombd]  Exemple

Pour plus d'informations sur l'accès à Personal Oracle Lite, reportez-vous à la rubrique oca_info.pdf.


Init_Form est la routine OPENDB qui modifie automatiquement vos propriétés de niveau application Forms afin que votre application Forms puisse communiquer avec une source de données ODBC.


OCA.PLL se trouve dans votre répertoire ORACLE_HOME\oca20. Pour que Form Builder puisse le retrouver, vous devez ajouter le répertoire ORACLE_HOME\oca20 à la variable d'environnement FORMS50_PATH dans la base de registres.


Accès à Microsoft SQL Server

  Rubriques connexes	  Ouvre oca_info.pdf.

Pour accéder à Microsoft SQL Server :

1	Configurez votre système pour l'utilisation de OCA (Open Client Adapter).

2	Lisez attentivement les notes de version et la documentation PDF (oca_info.pdf).

3	Exécutez les scripts SQL permettant de créer côté serveur des vues de dictionnaires de données qui affichent les noms d'objets de base de données parmi lesquels effectuer une sélection au moment de la conception. Remarque

UBT32.EXE utilisateur/motdepasse@ODBC:sourcedonnées[:nombd] @sqlscript  Exemple

Si nombd n'est pas précisé, les vues seront créées dans la base de données " courante " pour la connexion ODBC.

4	Lancez l'application Builder.

5	(Facultatif)  Exécutez les scripts SQL permettant de créer et de remplir les tables de démonstration. Exemple

6	(Form Builder seulement) Définissez à Oui la propriété Clé primaire pour chaque élément de données. Les éléments de données correspondent aux colonnes dans votre source de données.

7	Lorsque vous êtes prêt pour la connexion à la source de données Microsoft SQL Server, entrez la chaîne de connexion suivante dans la boîte de dialogue Connexion :

[utilisateur[/motdepasse]]@ODBC:sourcedonnées[:nombd]  Exemple

Pour plus d'informations sur l'accès à Microsoft SQL Server, reportez-vous à la rubrique oca_info.pdf.


Accès à Rdb
Accès à Oracle Rdb

  Rubriques connexes 	  Ouvre oca_info.pdf

Pour accéder à Oracle Rdb :

1	Configurez votre système pour l'utilisation de OCA (Open Client Adapter).

2	Lisez attentivement les notes de version et la documentation PDF (oca_info.pdf).

3	Exécutez les scripts SQL permettant de créer côté serveur des vues de dictionnaires de données qui affichent les noms d'objets de base de données parmi lesquels effectuer une sélection au moment de la conception. Remarque

UBT32.EXE utilisateur/motdepasse@ODBC:sourcedonnées[:nombd] @sqlscript  Exemple

Si nombd n'est pas précisé, les vues seront créées dans la base de données " courante " pour la connexion ODBC.

4	Lancez l'application Builder.

5	(Facultatif)  Exécutez les scripts SQL permettant de créer et de remplir les tables de démonstration. Exemple

6	(Form Builder seulement). Attachez la bibliothèque OCA.PLL à votre application, puis créez un déclencheur Pre-Form ou When-New-Form-Instance comprenant la routine OPENDB.Init_Form.

7	Lorsque vous êtes prêt pour la connexion à la source de données Oracle Rdb, entrez la chaîne de connexion suivante dans la boîte de dialogue Connexion :

[utilisateur[/motdepasse]]@ODBC:sourcedonnées[:nombd]  Exemple

Pour plus d'informations sur l'accès à Personal Rdb, reportez-vous à la rubrique oca_info.pdf.


Accès à Microsoft Access

  Rubriques connexes 	  Ouvre oca_info.pdf

Pour accéder à Microsoft Access :

1	Configurez votre système pour l'utilisation de OCA (Open Client Adapter).

2	Lisez attentivement les notes de version et la documentation PDF (oca_info.pdf).

3	(Facultatif) Exécutez les scripts SQL permettant de créer et de remplir les tables de démonstration à l'aide de l'utilitaire UBT.

UBT32.EXE utilisateur/motdepasse@ODBC:sourcedonnées[:nombd] @sqlscript  Exemple

Si nombd n'est pas précisé, les vues seront créées dans la base de données " courante " pour la connexion ODBC.

4	Lancez l'application Builder.

5	(Form Builder seulement) Définissez à Oui la propriété Clé primaire pour chaque élément de données. Les éléments de données correspondent aux colonnes dans votre source de données.

6	Lorsque vous êtes prêt pour la connexion à la source de données Microsoft Access, entrez la chaîne de connexion suivante dans la boîte de dialogue Connexion :

[utilisateur[/motdepasse]]@ODBC:sourcedonnées[:nombd]  Exemple

Pour plus d'informations sur l'accès à Microsoft Access, reportez-vous à la rubrique oca_info.pdf.


Accès à Sybase

  Rubriques connexes 	  Ouvre oca_info.pdf.

Pour accéder à Sybase :

1	Configurez votre système pour l'utilisation de OCA (Open Client Adapter).

2	Lisez attentivement les notes de version et la documentation PDF (oca_info.pdf).

3	Exécutez les scripts SQL permettant de créer côté serveur des vues de dictionnaires de données qui affichent les noms d'objets de base de données parmi lesquels effectuer une sélection au moment de la conception. Remarque

UBT32.EXE utilisateur/motdepasse@ODBC:sourcedonnées[:nombd] @sqlscript  Exemple

Si nombd n'est pas précisé, les vues seront créées dans la base de données " courante " pour la connexion ODBC.

4	Lancez l'application Builder.

5	(Facultatif)  Exécutez les scripts SQL permettant de créer et de remplir les tables de démonstration. Exemple

6	(Form Builder seulement) Définissez à Oui la propriété Clé primaire pour chaque élément de données. Les éléments de données correspondent aux colonnes dans votre source de données.

7	Lorsque vous êtes prêt pour la connexion à la source de données Sybase, entrez la chaîne de connexion suivante dans la boîte de dialogue Connexion :

[utilisateur[/motdepasse]]@ODBC:sourcedonnées[:nombd]  Exemple

Pour plus d'informations sur l'accès à Sybase, reportez-vous à la rubrique oca_info.pdf.


Accès à Tandem NonStop SQL

  Rubriques connexes 	  Ouvre oca_info.pdf

Pour accéder à Tandem NonStop SQL :

1	Configurez votre système pour l'utilisation de OCA (Open Client Adapter).

2	Lisez attentivement les notes de version et la documentation PDF (oca_info.pdf).

3	Exécutez les scripts SQL permettant de créer côté serveur des vues de dictionnaires de données qui affichent les noms d'objets de base de données parmi lesquels effectuer une sélection au moment de la conception. Remarque

UBT32.EXE utilisateur/motdepasse@ODBC:sourcedonnées[:nombd] @sqlscript  Exemple

Si nombd n'est pas précisé, les vues seront créées dans la base de données " courante " pour la connexion ODBC.

4	Lancez l'application Builder.

5	(Facultatif)  Exécutez les scripts SQL permettant de créer et de remplir les tables de démonstration. Exemple

6	(Form Builder seulement) Définissez à Oui la propriété Clé primaire pour chaque élément de données. Les éléments de données correspondent aux colonnes dans votre source de données.

7	Lorsque vous êtes prêt pour la connexion à la source de données Tandem NonStop SQL, entrez la chaîne de connexion suivante dans la boîte de dialogue Connexion :

[utilisateur[/motdepasse]]@ODBC:sourcedonnées[:nombd]  Exemple

Pour plus d'informations sur l'accès à Tandem NonStop SQL, reportez-vous à la rubrique oca_info.pdf.


Accès à Informix

  Rubriques connexes 	  Ouvre oca_info.pdf

Pour accéder à Informix :

1	Configurez votre système pour l'utilisation de OCA (Open Client Adapter).

2	Lisez attentivement les notes de version et la documentation PDF (oca_info.pdf).

3	Exécutez les scripts SQL permettant de créer côté serveur des vues de dictionnaires de données qui affichent les noms d'objets de base de données parmi lesquels effectuer une sélection au moment de la conception. Remarque

UBT32.EXE utilisateur/motdepasse@ODBC:sourcedonnées[:nombd] @sqlscript  Exemple

Si nombd n'est pas précisé, les vues seront créées dans la base de données " courante " pour la connexion ODBC.

4	Lancez l'application Builder.

5	(Facultatif)  Exécutez les scripts SQL permettant de créer et de remplir les tables de démonstration. Exemple

6	(Form Builder seulement) Définissez à Oui la propriété Clé primaire pour chaque élément de données. Les éléments de données correspondent aux colonnes dans votre source de données.

7	Lorsque vous êtes prêt pour la connexion à la source de données Informix, entrez la chaîne de connexion suivante dans la boîte de dialogue Connexion :

[utilisateur[/motdepasse]]@ODBC:sourcedonnées[:nombd]  Exemple

Pour plus d'informations sur l'accès à Informix, reportez-vous à la rubrique oca_info.pdf.


A propos de OCA (Open Client Adapter)

  Ouvre oca_info.pdf.

OCA (Oracle Open Client Adapter) pour ODBC permet aux applications sous Microsoft Windows 3.1, Windows 95/98 et Windows NT d'accéder à des sources de données compatibles ODBC via des pilotes ODBC. OCA nécessite que le pilote ODBC soit compatible ODBC niveau 1. OCA utilise également certaines fonctions ODBC de niveau 2 en vue de meilleures performances, si cette possibilité est offerte par le pilote ODBC.

A l'aide d'OCA, une application peut accéder à différentes sources de données de façon homogène, ce qui permet à un développeur de concevoir une application capable de s'exécuter sans modifications sur une source de données parmi plusieurs possibles. L'application peut également être conçue en vue d'une source de données en particulier et tirer parti des fonctions propres à ce système.

OCA s'installe via l'installateur Oracle qui copie tous les fichiers nécessaires dans votre répertoire ORACLE_HOME. Un de ces fichiers, oca.pll, est une bibliothèque de fonctions PL/SQL que vous pouvez utiliser à partir d'applications pour :

•	ouvrir des connexions auxiliaires vers d'autres sources de données en sus de la connexion principale de l'application ;

•	exécuter des instructions SQL arbitraires et des appels de procédures stockées sur une connexion quelconque ;

•	récupérer des jeux de résultats à partir de procédures stockées non Oracle ;

•	obtenir les noms et versions de pilotes DBMS et ODBC d'une connexion donnée ;

•	adapter automatiquement les propriétés Application Forms et Bloc de données au moment de l'exécution, en fonction de la source de données.

Pour en savoir davantage sur ces fonctions, cliquez sur le bouton [image] en tête de cette rubrique.

Pour plus d'informations sur les autres fichiers install+s, reportez-vous au fichier relnotes


Par défaut, oca_info.pdf est installé dans ORACLE_HOME\TOOLS\DOC60\US. Si Adobe Acrobat Reader est installé dans le répertoire par défaut, cliquez sur le bouton [image] en tête de cette rubrique pour afficher ce document. Dans le cas contraire, lancez votre visualiseur PDF et ouvrez oca_info.pdf.


A propos de l'utilitaire UBT

OCA (Oracle Open Client Adapter) pour ODBC comprend un utilitaire de type SQL*Plus nommé UBT (Universal Backend Tester). UBT vous permet de manipuler des commandes SQL à l'intérieur de l'interpréteur ou via des fichiers de commandes.

L'exécutable de l'utilitaire UBT (UBT32.EXE pour Windows NT et Windows 95/98, et UBT.EXE pour Windows 3.1) est installé dans ORACLE_HOME\BIN.

Pour plus d'informations sur Oracle Client Adapter, reportez-vous à oca_info.pdf (comprend des informations sur l'utilitaire UBT).


Les notes sur la version d'OCA se trouvent dans le fichier RELNOTES.TXT du CD d'installation.


Par défaut, les informations relatives à l'accès à Personal Oracle Lite sont installées dans ORACLE_HOME\TOOLS\DOC60\US\oca_info.pdf. Si Adobe Acrobat Reader est installé dans le répertoire par défaut, cliquez sur le bouton [image] en tête de cette rubrique pour afficher ce document. Dans le cas contraire, lancez votre visualiseur PDF et ouvrez oca_info.pdf.


Ceci est facultatif pour le développement d'applications et n'est pas nécessaire au moment de l'exécution. Pour certaines bases de données (par exemple, Microsoft Access), les vues de dictionnaires de données ne peuvent pas être créées du fait d'une présentation inadaptée des informations du catalogue de bases de données et d'une absence de prise en charge de la création de vues. Dans ce cas, vous pouvez entrer les noms d'objets de base de données au moment de la conception au lieu de les sélectionner parmi une liste.


Par défaut, les scripts SQL permettant la création de vues de dictionnaires de données pour Personal Oracle Lite sont installés dans ORACLE_HOME\OCA20\SQL\POLITE :

polvudrp.sql	supprime toutes les anciennes versions des vues.

polvubld.sql	crée les vues nécessaires.


UBT32.EXE scott/tiger@ODBC:polite_ds @polvubld.sql


Par défaut, le script SQL permettant la création de tables de démonstration pour Personal Oracle Lite est installé dans ORACLE_HOME\OCA20\SQL\POLITE :

poldmbld.sql	crée les tables de démonstration.

Le script SQL permettant de remplir les tables de démonstration est installé dans ORACLE_HOME\OCA20\DEMO :

demodata.sql	insère des données dans les tables de démonstration.


UBT32.EXE scott/tiger@ODBC:polite_ds @poldmbld.sql


scott/tiger@ODBC:polite_ds


Par défaut, les informations relatives à l'accès à Microsoft SQL Server sont installées dans ORACLE_HOME\TOOLS\DOC60\US\oca_info.pdf. Si Adobe Acrobat Reader est installé dans le répertoire par défaut, cliquez sur le bouton [image] en tête de cette rubrique pour afficher ce document. Dans le cas contraire, lancez votre visualiseur PDF et ouvrez oca_info.pdf.


Par défaut, les scripts SQL permettant la création de vues de dictionnaires de données pour Microsoft SQL Server sont installés dans ORACLE_HOME\OCA20\SQL\SQLSRV :

sqsvudrp.sql	supprime toutes les anciennes versions des vues.

sqsvubld.sql	pour SQL Server version 4.2, crée les vues nécessaires.

sqs60bld.sql	pour SQL Server version 6.0, crée les vues nécessaires.


UBT32.EXE scott/tiger@ODBC:sqlserver_ds @sqsvubld.sql


Par défaut, le script SQL permettant la création de tables de démonstration pour Microsoft SQL Server est installé dans ORACLE_HOME\OCA20\SQL\SQLSRV :

sqsdmbld.sql	crée les tables de démonstration.

Le script SQL permettant de remplir les tables de démonstration est installé dans ORACLE_HOME\OCA20\DEMO :

demodata.sql	insère des données dans les tables de démonstration.


UBT32.EXE scott/tiger@ODBC:sqlserver_ds @sqsdmbld.sql


scott/tiger@ODBC:sqlserver_ds


Par défaut, les informations relatives à l'accès à Microsoft Access sont installées dans ORACLE_HOME\TOOLS\DOC60\US\oca_info.pdf. Si Adobe Acrobat Reader est installé dans le répertoire par défaut, cliquez sur le bouton [image] en tête de cette rubrique pour afficher ce document. Dans le cas contraire, lancez votre visualiseur PDF et ouvrez oca_info.pdf.


Par défaut, le script SQL permettant la création de tables de démonstration pour Microsoft Access est installé dans ORACLE_HOME\OCA20\SQL\ACCESS :

accdmbld.sql	crée les tables de démonstration.

Le script SQL permettant de remplir les tables de démonstration est installé dans ORACLE_HOME\OCA20\DEMO :

demodata.sql	insère des données dans les tables de démonstration.


UBT32.EXE scott/tiger@ODBC:access_ds @accdmbld.sql


scott/tiger@ODBC:access_ds


Par défaut, les informations relatives à l'accès à Oracle Rdb sont installées dans ORACLE_HOME\TOOLS\DOC60\US\oca_info.pdf. Si Adobe Acrobat Reader est installé dans le répertoire par défaut, cliquez sur le bouton [image] en tête de cette rubrique pour afficher ce document. Dans le cas contraire, lancez votre visualiseur PDF et ouvrez oca_info.pdf.


Par défaut, les scripts SQL permettant la création de vues de dictionnaires de données pour Oracle Rdb sont installés dans ORACLE_HOME\OCA20\SQL\RDB :

rdbvudrp.sql	supprime toutes les anciennes versions des vues.

rdbvubld.sql	crée les vues nécessaires.

rdbdual.sql	crée deux vues (pour la prise en charge de SYSDATE).


UBT32.EXE scott/tiger@ODBC:rdb_ds @rdbvubld.sql


Par défaut, le script SQL permettant la création de tables de démonstration pour Oracle Rdb est installé dans ORACLE_HOME\OCA20\SQL\RDB :

rdbdmbld.sql	crée les tables de démonstration.

Le script SQL permettant de remplir les tables de démonstration est installé dans ORACLE_HOME\OCA20\DEMO :

demodata.sql	insère des données dans les tables de démonstration.


UBT32.EXE scott/tiger@ODBC:rdb_ds @rdbdmbld.sql


scott/tiger@ODBC:rdb_ds


Par défaut, les informations relatives à l'accès à Sybase sont installées dans ORACLE_HOME\TOOLS\DOC60\US\oca_info.pdf. Si Adobe Acrobat Reader est installé dans le répertoire par défaut, cliquez sur le bouton [image] en tête de cette rubrique pour afficher ce document. Dans le cas contraire, lancez votre visualiseur PDF et ouvrez oca_info.pdf.


Par défaut, les scripts SQL permettant la création de vues de dictionnaires de données pour Sybase sont installés dans ORACLE_HOME\OCA20\SQL\SYBASE :

sybvudrp.sql	supprime toutes les anciennes versions des vues.

sybvubld.sql	crée les vues nécessaires.


UBT32.EXE scott/tiger@ODBC:sybase_ds @sybvubld.sql


Par défaut, le script SQL permettant la création de tables de démonstration pour Sybase est installé dans ORACLE_HOME\OCA20\SQL\SYBASE :

sybdmbld.sql	crée les tables de démonstration.

Le script SQL permettant de remplir les tables de démonstration est installé dans ORACLE_HOME\OCA20\DEMO :

demodata.sql	insère des données dans les tables de démonstration.


UBT32.EXE scott/tiger@ODBC:sybase_ds @sybdmbld.sql


scott/tiger@ODBC:sybase_ds


Par défaut, les informations relatives à l'accès à Tandem NonStop SQL sont installées dans ORACLE_HOME\TOOLS\DOC60\US\oca_info.pdf. Si Adobe Acrobat Reader est installé dans le répertoire par défaut, cliquez sur le bouton [image] en tête de cette rubrique pour afficher ce document. Dans le cas contraire, lancez votre visualiseur PDF et ouvrez oca_info.pdf.


Par défaut, les scripts SQL permettant la création de vues de dictionnaires de données pour Tandem NonStop SQL sont installés dans ORACLE_HOME\OCA20\SQL\NONSTOP :

nssvudrp.sql	supprime toutes les anciennes versions des vues.

nssvubld.sql	crée les vues nécessaires.


UBT32.EXE scott/tiger@ODBC:nonstop_ds @nssvubld.sql


Par défaut, le script SQL permettant la création de tables de démonstration pour Tandem NonStop SQL est installé dans ORACLE_HOME\OCA20\SQL\NONSTOP :

nssdmbld.sql	crée les tables de démonstration.

Le script SQL permettant de remplir les tables de démonstration est installé dans ORACLE_HOME\OCA20\DEMO :

demodata.sql	insère des données dans les tables de démonstration.


UBT32.EXE scott/tiger@ODBC:nonstop_ds @nssdmbld.sql


scott/tiger@ODBC:nonstop_ds


Par défaut, les informations relatives à l'accès à Informix sont installées dans ORACLE_HOME\TOOLS\DOC60\US\oca_info.pdf. Si Adobe Acrobat Reader est installé dans le répertoire par défaut, cliquez sur le bouton [image] en tête de cette rubrique pour afficher ce document. Dans le cas contraire, lancez votre visualiseur PDF et ouvrez oca_info.pdf.


Par défaut, les scripts SQL permettant le création de vues de dictionnaires de données et de tables de démonstration pour Informix sont installés dans ORACLE_HOME\OCA20\SQL\INFORMIX :

infvudrp.sql	supprime toutes les anciennes versions des vues.

infvubld.sql	crée les vues nécessaires.


UBT32.EXE scott/tiger@ODBC:informix_ds @infvubld.sql


Par défaut, le script SQL permettant la création de tables de démonstration pour Informix est installé dans ORACLE_HOME\OCA20\SQL\INFORMIX :

infdmbld.sql	crée les tables de démonstration.

Le script SQL permettant de remplir les tables de démonstration est installé dans ORACLE_HOME\OCA20\DEMO :

demodata.sql	insère des données dans les tables de démonstration.


UBT32.EXE scott/tiger@ODBC:informix_ds @infdmbld.sql


scott/tiger@ODBC:informix_ds


Dépannage

Si une application qui fonctionnait avec Oracle échoue avec une autre source de données ODBC, l'explication la plus probable est que vous rencontrez une restriction ou une limitation d'ODBC ou de la source de données.

Pour afficher les instructions SQL émises par OCA et les messages générés par le pilote ODBC ou par la base de données :

1	Vérifiez que l'entrée suivante est définie dans le fichier ORACLE.INI sous Windows 3.1, ou dans la base de registres de Windows NT ou de Windows 95/98 :

n	UB=ORACLE_HOME\OCA20

2	Ajoutez les entrées suivantes dans le fichier ORACLE.INI sous Windows 3.1, ou dans la base de registres de Windows NT ou de Windows 95/98, sous SOFTWARE\ORACLE :

n	OCA_DEBUG_SQL=TRUE

n	OCA_DEBUG_ERROR=TRUE

3	Lancez votre application sur la source de données ODBC pour afficher les instructions SQL ou les messages d'erreur dans la fenêtre de débogage. Cliquez sur OK pour fermer la fenêtre de débogage et poursuivre le traitement.

4	Si vous ne parvenez pas à résoudre l'erreur, appelez l'assistance technique Oracle.


Messages OCA

Code	Libellé du message

30000	General OCA error.

30001	NULL hostdef.

30002	Function not supported.

30003	NULL username in connect string.

30004	NULL hostname in connect string.

30005	All cursors are in use.

30006	Error creating parse tree.

30007	NULL SQL statement.

30008	Memory allocation failed.

30009	Error processing bind variables.

30010	Oracle to ODBC datatype conversion error.

30011	ODBC to Oracle datatype conversion error.

30012	Error binding reference value.

30013	No parameters to bind.

30014	Hostname too long.

30015	Stored procedures not supported for this datasource.

30016	Sequences not supported by this database.

30017	Error logging on to non-Oracle database.

30018	Username or password too long.

30019	Error handling non-Oracle stored procedures.

30020	Stored procedure name is missing.

30021	Error preparing/executing SQL statement.

30022	Error retrieving column.

30023	Error fetching result set.

30024	Error retrieving column descriptors.

30025	Error getting number of columns in result set.

30026	Error retrieving procedure descriptors.

30027	Error setting ODBC connection/statement option.

30028	Error at commit/rollback.

30029	Error binding column.

30030	Error binding parameter.

30031	Error retrieving information about driver/database.

30032	Error freeing memory.

30033	Row status error.

30034	Table not found.

30035	Column not found.

30036	Invalid authorization specification.

30037	Data source not available.

30038	Invalid column number.

30039	Illegal bundled operation combination.

30040	Invalid cursor context.

30041	Bind variable does not exist.

30042	No data found.

30043	Fetched column value is NULL.

30044	Fetched column value was truncated.

30045	Error returning result data.

30046	No data source name specified.

30047	Unsupported transaction isolation level.

30048	Binding arrays not supported.

30049	Not logged on.

30050 	Error freeing SQL statement.

30051	Error fetching data.  You must re-execute after a commit for this datasource.

30052	Parameter value was truncated at execution.

31000	General ODBC error issued by the ODBC driver in use.

Si une erreur se produit et que l'application est incapable de lire le message dans le fichier des messages, vérifiez que l'entrée suivante est définie dans le fichier ORACLE.INI sous Windows 3.1, ou dans la base de registres de Windows NT ou de Windows 95/98 :

n	UB=ORACLE_HOME\OCA20


Fichier PDF
Document PDF

Pour afficher le document PDF, vous devez lancer votre visualiseur PDF et ouvrir le fichier oca_info.pdf à partir du répertoire dans lequel il est installé.


Glossaire

A

    action
    action de débogage
    action définie par l'utilisateur
    action prédéfinie
    ActiveX
    activé
    ADA
    adresse IP (Internet Protocol)
    affichage
    alias
    alignement
    ancêtre
    ancrage
    antécédent
    aperçu
    applet
    application
    arborescence de dépendances
    arborescence de groupe
    architecture client/serveur
    argument
    argument exécutable
    ASCII
    assistant Projet
    attribut
    attribut visuel
    autoriser
    axe continu
    axe de catégorie
    axe de date
    axe de valeurs
    axe discret

 B

    barre de fractionnement
    barre de titre
    barre d'outils
    basculer
    base de données
    base de données distante
    base de données locale
    base de registres
    base de registres globale
    base de registres locale
    base de registres projet
    base de registres utilisateur
    Batch
    bibliothèque
    bibliothèque attachée
    bibliothèque PL/SQL externe
    bloc
    bloc anonyme
    boîte de dialogue
    boîte englobante externe
    boîte englobante interne
    bord
    bordure
    boucle
    bouton
    bouton (...)
    bouton d'option

C

    cache (mémoire cache)
    cadre
    canevas
    caractère générique
    cartouche
    cartourche Web
    case à cocher
    catégorie
    cellule
    cellule de matrice
    CGI
    CGM
    chaîne de connexion
    champ
    champ multiligne
    chiffrement
    cible
    classe de propriétés
    classification
    clause
    clé étrangère
    clé primaire
    client
    CMDFILE
    code de contrôle d'imprimante
    cohérence en lecture
    coller
    colonne
    colonne de formule
    colonne de ventilation
    colonne d'objets
    colonne récapitulative
    colonne REF
    colonne sans cache
    colonnes d'attributs
    commentaire
    compiler
    compiler par lot
    composant
    condition
    connecter (se)
    conteneur OLE
    contrainte
    contrôle VBX
    coordonnées (x, y)
    copier
    corps
    corps de package
    coupe-feu
    couper
    curseur

D

    DATE
    déboguer
    Débogueur
    débordement
    déclencheur
    déclencheur de base de données
    déclencheur de débogage
    déclencheur de format
    déclencheur de ventilation
    désactivé
    descendant
    descendant-ascendant
    descripteur
    Designer
    Designer/2000
    DIANA
    dictionnaire de données
    dimension
    dimension de qualification
    données dépendantes
    données indépendantes
    dupliquer

E

    EBCDIC
    éditeur
    élément
    élément
    élément affiché
    élément d'arrière-plan
    élément de graphique
    élément de premier plan
    élément de projet
    élément d'entrée
    élément graphique
    élément impliqué
    élément liste
    élément texte
    éléments Built-in
    encadrement itératif
    endommager
    enfant
    enregistrement
    environnement
    état de ventilation
    état matriciel
    étendue
    exception
    exécuter
    exporter
    expression

F

    faire glisser
    famille
    fenêtre
    fenêtre modale
    fenêtre sans mode
    fenêtre/vue active
    feuille de style
    feuille de style en cascade
    fichier de liaison
    fichier de projet
    fichier d'exécution
    fichier d'export
    fichier pld
    fichier pll
    fichier pls
    fichier plx
    fichier prt
    fichier rdf
    fichier rep
    fichier rex
    fichier sql
    filtre
    filtre de groupe
    fonction
    fonction de filtre d'interrogation
    fonction en package
    formule
    frère

G

    Generate
    générateur
    générer
    graphique à axes
    graphique de ventilation
    Grille de paramètres d'exécution
    groupe
    groupe ancêtre
    groupe de boutons d'option
    groupe de ventilation
    groupe d'enregistrements
    groupe d'objets
    groupe inter-produit

H

    hériter
    hiérarchie
    hiérarchie des dimensions
    hiérarchiser
    HTML
    HTTP
    hyperlien
    hypertexte

I

    ICD
    icône
    icône de bord/remplissage/texte
    image
    importer
    index
    inscrire
    instruction
    instruction SELECT
    instruction SQL
    interface graphique
    interface Oracle Call Interface
    Internet
    interrogation
    interrogation détail
    interrogation enfant
    interrogation externe
    Intranet

J

    JAR
    Java
    jointure
    justification

K

L

    lancer
    Lanceur
    liaison
    liaison de données
    liaison Web
    libellé
    ligne
    ligne de commande
    ligne de référence
    liste de paramètres
    liste de valeurs
    liste instantanée
    livrer

M

    macro
    macro définie par l'utilisateur
    macro intégrée
    marge
    masque d'attribut
    masque de format
    masqué
    matrice
    matrice imbriquée
    méga-octet (Mo)
    menu détachable
    message d'alerte
    mesure
    mesure personnalisée
    méthode
    mettre à jour
    mode de confinement
    mode flexible
    mode insertion
    mode remplacement
    modèle de champ
    modèle de données
    modèle de graphique
    module
    mot-clé
    motif

N

    Navigateur de projet
    Navigateur d'objet
    navigateur Web
    niveau
    NOCACHE
    noeud
    noeud cible
    noeud de structure de données
    noeud élément
    noeud en-tête
    noeud fichier
    noeud organisation
    noeud projet
    noeud racine
    noeud sous-projet
    nom utilisateur de réserve

O

    objet
    objet aplani
    objet colonne
    objet déstructuré
    objet englobant
    objet ligne
    objet standard
    objets de niveau état
    ODBC
    OLE
    opérateur relationnel
    opérateurs de comparaison
    opérateurs logiques
    opérateurs numériques
    Oracle Designer
    ORACLE_HOME
    origine
    outil
    outil Attribut
    outil Correspondance
    outil Exception
    outil Famille
    outil Haut/Bas
    outil Liste
    outil Niveau
    outil Période
    outil Sélecteur
    outil Sélection enregistrée
    outil Tout
    outil Tri

P

    package
    page
    page de fin
    page de garde
    page logique
    page physique
    page titre
    palette
    palette de couleurs
    palette d'outils
    panneau
    paramètre
    parent
    Pcode
    PDF
    pile
    pile d'appels
    PL/SQL
    plan de coordonnées
    point d'ancrage
    point de contrôle
    point d'insertion
    point d'interruption
    pointeur d'objet
    port
    préférence
    présentation
    présentation de type étiquette de publipostage
    présentation de type formulaire
    présentation de type formulaire-lettre
    présentation de type matrice
    présentation maître-détails
    Presse-papiers
    primitif
    procédure
    procédure bouton
    processus d'arrière-plan
    projet
    propriété
    protocole

Q

    quadrillages
    quitter

R

    racine
    RC4
    RDBMS
    rectangle de délimitation
    référence de lien
    référence lexicale
    régénérer
    regroupement/agrégation
    répertoire virtuel
    Report Server (RWMTS60)
    Reports Background Engine (RWRBE60)
    Reports Queue Manager (RWRQM60)
    Reports Web Cartridge (RWCGI60)
    Reports Web CGI (RWCGI60)
    RTF
    Runtime
    RVB

S

    saut de page
    schéma
    script
    script de l'interpréteur
    script de sélection
    script SQL
    section
    Sélecteur
    sélection
    sélection dynamique enregistrée
    sélection enregistrée
    sélection statique enregistrée
    serveur OLE
    serveur Web
    session
    simultanéité d'accès
    socket
    sortie utilisateur
    source
    source de données
    sous-interrogation associée
    sous-programme
    sous-programme stocké
    sous-projet
    spécification
    spécification de package
    SQL
    structure de code PL/SQL
    structure de code PL/SQL avec valeur
    SYLK
    syntaxe
    système de coordonnées
    système de fichiers virtuel

T

    table
    table d'objets
    tabulaire
    tampon
    TCP
    total de contrôle
    transaction
    type
    type de collecte
    type de données
    type de données Built-in
    type de données CHAR
    type de données Oracle
    type de table
    type de tableau variable
    type de tracé
    type défini par l'utilisateur
    type d'élément
    type d'objet
    type prédéfini

U

    unité de présentation
    unité de programme
    unité de programme stockée
    URL

V

    valeur d'attribut
    valeur de dimension
    valeur ligne de base
    valeur NA
    valeur NULL
    valeur par défaut
    valider (COMMIT)
    variable
    variable de lien
    variable globale
    variable locale
    variable système
    VBX
    Visualiseur
    volet
    vue
    vue de dépendances
    vue de projet
    vue-canevas

W

 Web
    WKS
    WRB
    WWW

X

    XML
    XML au format correct
    XML valide

Y

Z

    zone contextuelle
    zone de liste
    zone de message
    zone de remplissage
    zoom


Dans Project Builder, chaîne de commande fournie par Project Builder ou par l'utilisateur, et s'appliquant à des fichiers d'un type donné. Une action n'est pas restreinte à un seul type de fichier ; par exemple, si l'action Compiler est définie à la fois pour les fichiers d'application Forms et les fichiers source C, la sélection de Compiler le projet compile tous les fichiers fmb et .c à l'aide des outils appropriés. Voir aussi : action prédéfinie, action définie par l'utilisateur.


Langage de programmation de haut niveau élaboré par le Département de la défense américaine pour les systèmes informatiques intégrés.


Fenêtre ou vue dans laquelle l'utilisateur peut entrer des données.


(Oracle Express) Regroupement (ou agrégation) de données de plusieurs valeurs de dimension en une seule valeur, comme le total des unités vendues dans toutes les villes, ou en un ensemble de valeurs plus restreint, comme la moyenne des unités vendues dans les villes de chaque région. Les données sont souvent collectées au niveau de détails le plus bas, puis regroupées en totaux de niveaux supérieurs pour l'analyse.


Fenêtre modale qui vous signale une condition survenue à la suite de votre dernière action. Vous devez répondre à un message d'alerte.


Façon dont des données sont positionnées dans un champ : alignement ou justification à gauche, à droite et au centre d'un champ d'une largeur déterminée.


Nom secondaire utilisé dans une instruction SQL pour référencer une table, une vue ou une colonne.


(Oracle Express) Outil de la boîte de dialogue Sélecteur permettant de sélectionner toutes les valeurs d'une dimension ou toutes les valeurs d'une dimension correspondant à une hiérarchie donnée.


(Oracle Express) Valeur de dimension située au-dessus d'une valeur donnée dans la hiérarchie. La valeur ancêtre correspond à la somme globale des valeurs de ses descendants. L'exemple suivant désigne la valeur de dimension Europe comme l'ancêtre de France, de Lyon et de Paris dans la dimension GEOGRAPHY.


Groupe possédant un autre groupe, directement ou indirectement.


Objet de présentation servant à fixer un point d'un objet sur un point d'un autre objet, ce qui permet de positionner le premier objet par rapport au second.


(Oracle Express) Valeur de dimension particulière utilisée lors de la sélection de valeurs de dimension en fonction de leur relation familiale ou lors de l'exploration d'une hiérarchie.


Unité de programme PL/SQL sans nom ne nécessitant pas la présence explicite des mots-clés BEGIN et END pour délimiter les instructions exécutables. N'ayant pas de nom, les blocs anonymes ne peuvent être référencés par d'autres unités de programme.


Objet apparaissant n'importe où au-dessus d'un autre objet dans l'arborescence de groupe de cet objet. Tout objet est l'antécédent de ses descendants.


Terme Java qui désigne de petits programmes pouvant, au besoin, être importés de manière dynamique dans des pages Web ou des applications.


Un ou plusieurs modules de programme servant à atteindre un résultat donné. Les applications peuvent être imbriquées les unes dans les autres. Par exemple, une application de gestion des stocks d'une entreprise peut comprendre diverses applications Form Builder pour la saisie des données et diverses applications Graphic Builder pour l'affichage des données.


1. Expression facultative transmise à une unité de programme pour que celle-ci la traite.
2. Clauses contenant des mots-clés et leurs valeurs.


Acronyme d'American National Standard Code for Information Interchange.


Ensemble de sous-programmes PL/SQL en lecture seule, généralement intégré à une application pour fournir les sources PL/SQL nécessaires. Les unités de programme figurant dans une bibliothèque attachée sont implicitement chargées lors de leur premier appel par une autre unité de programme au moment de la compilation ou de l'exécution. Elles restent chargées, ce qui permet leur utilisation rapide et réduit les exigences en mémoire lors de l'exécution, tout en améliorant les performances de l'application. Voir aussi : bibliothèque.


1. Voir propriété.
2. Partie ou composant d'une définition de type d'objet Oracle8. Chaque attribut dispose d'un nom et d'un type de données Oracle8. Lorsque vous créez une table d'objets sur la base d'un type d'objet, les colonnes de la table correspondent aux attributs de la définition du type d'objet. Lorsque vous créez un objet colonne d'après le type d'objet dans une table relationnelle, cet objet contient des éléments qui équivalent à des sous-colonnes, chacune d'entre elles correspondant à un attribut de la définition du type d'objet. Dans Oracle Developer, chaque attribut d'objet Oracle8 appartenant à une table est considéré comme un élément de données distinct, comme s'il s'agissait d'une colonne distincte. Cela s'applique aux objets de table et de colonne des tables relationnelles.
3. (Oracle Express) Caractéristique descriptive partagée par les valeurs d'une dimension. Les attributs correspondent à des regroupements logiques qui permettent aux utilisateurs de sélectionner des données de caractéristiques similaires. Par exemple, dans une base de données sur les chaussures, vous pouvez utiliser un attribut de couleur de chaussure pour sélectionner toutes les bottes, tennis ou pantoufles de couleur identique.


Colonnes qui composent un objet colonne (Oracle8).


Dans Graphic Builder, premier élément d'un descripteur d'attribut. Il s'agit d'un masque de 32 bits qui informe la boîte à outils des attributs qui seront définis ou extraits par un appel de fonction ultérieur. Seuls les éléments pour lesquels les bits correspondants sont définis dans le masque d'attribut seront définis ou extraits.


(Oracle Express) Outil de la boîte de dialogue Sélecteur permettant de sélectionner des valeurs de dimension en fonction d'attributs et de valeurs d'attributs. Par exemple, dans une base de données sur les boissons non alcoolisées, vous pouvez sélectionner tous les produits d'un litre. Dans cet exemple, la taille est un attribut et 1 litre est une valeur d'attribut.


(Oracle Express) Valeurs d'un attribut dans une base de données. Par exemple, dans une base de données sur les glaces, les valeurs d'attributs suivantes peuvent appartenir à l'attribut parfum de la dimension Product : vanille, chocolat et fraise. Des valeurs de dimension de différents niveaux dans la dimension Product (marque, forme et taille, par exemple) peuvent avoir une valeur de parfum identique.


Graphique dans lequel les données sont tracées selon leur position sur les bords du graphique, appelés axes. Un graphique à axes peut contenir deux ou trois axes, chacun appartenant à l'un des types suivants : discret, continu ou date.


Partie blanche d'un motif. L'application d'une couleur à l'élément d'arrière-plan se fait à l'aide la palette de couleurs de remplissage.


Processus non interactif fonctionnant dans un environnement de système d'exploitation et effectuant un service ou des actions. Certains produits Oracle utilisent des processus d'arrière-plan, notamment pour effectuer et coordonner des tâches pour les utilisateurs de la base de données, pour traiter et acheminer les messages électroniques, et pour gérer les services d'impression.


Valeur utilisée comme point de départ pour tracer des champs sur l'axe continu d'un graphique.


Exécutable permettant d'exécuter une application en mode de traitement par lots sans utiliser de fenêtres.


Traduire en une fois plusieurs unités de programme PL/SQL afin de pouvoir les exécuter.


Référence à un paramètre utilisée pour remplacer une valeur littérale unique (chaîne de caractères, nombre ou date, par exemple) qui apparaît n'importe où dans un élément PL/SQL ou dans une instruction SQL SELECT. Pour définir une référence de lien, vous devez faire précéder le nom du paramètre par le signe deux-points (:).


Variable globale pouvant être créée et utilisée à l'extérieur d'un package PL/SQL.


1. Dans PL/SQL, unité de programme de base définie par les mots-clés DECLARE, BEGIN, EXCEPTION et END.
2. Dans Form Builder, conteneur logique se rapportant à une table ou à une vue de base de données.


1. Contient les mêmes informations que la spécification d'unité de programme et comprend également la mise en oeuvre effective du sous-programme (c'est-à-dire sa séquence d'actions). Dans la plupart des cas, seul un corps doit être défini pour un programme.
2. Dans Report Builder, partie contenant la présentation de l'état (texte, graphiques, données et calculs). Le corps de l'état figure entre la page de garde et la page de fin.


Texte et/ou graphiques apparaissant dans un état à chaque exécution. Egalement appelé dans certains produits « texte constant » ou « graphiques constants ».


Contour d'un objet de présentation défini par l'utilisateur et servant généralement à mettre celui-ci en évidence. Les bordures sont dessinées de sorte que la moitié de la largeur de la bordure soit à l'extérieur du bord de l'objet et l'autre moitié à l'intérieur.


Voir boîte englobante interne, boîte englobante externe.


Graphique à axes affichant deux catégories de données le long d'un même axe.


Colonne d'interrogation attribuée à un groupe de ventilation.


Groupe servant à ventiler des données d'état ou à les classer par catégories. Toutes les données des colonnes d'interrogation attribuées à un groupe de ventilation apparaissent au-dessus des données des colonnes appartenant à d'autres groupes. Chacun des enregistrements extraits pour un groupe de ventilation n'apparaît qu'une seule fois, tandis que plusieurs enregistrements associés dans d'autres groupes peuvent être affichés.


Etat contenant des catégories qui ventilent les données de l'état.


Bloc PL/SQL qui est exécuté chaque fois qu'un point d'interruption est atteint. Voir aussi : point d'interruption.


Action de débogage pouvant être insérée sur toute ligne source exécutable au sein d'un sous-programme PL/SQL, qui interrompt l'exécution de l'unité de programme pour donner le contrôle à l'Interpréteur PL/SQL. Les points d'interruption permettent d'exécuter un sous-programme en mode pas à pas et de rechercher les erreurs d'exécution. Voir aussi : déclencheur de ventilation.


Composant d'Oracle Developer servant à créer un type particulier de document ; par exemple, Form Builder sert à créer des applications Forms et Report Builder, des états.


Type de données défini et pris en charge par Oracle Server.


Ensemble d'extensions du langage PL/SQL, conçu pour être utilisé avec Oracle Developer. Les éléments Built-in (procédures internes) comprennent les types de données, les procédures, les fonctions, les exceptions et les constantes.


Dans Project Builder, macro livrée avec le produit. Voir aussi : macro.


Zone de mémoire temporaire servant au transfert de données entre l'ordinateur et un périphérique, ou entre des parties d'un ordinateur. Un tampon évite que des informations ne se perdent à cause de vitesses et de synchronisations de transfert différentes, et accélère certaines fonctions.


1. Elément d'interface servant à sélectionner une action, à afficher une boîte de dialogue ou à accuser réception de la condition en cours.
2. Objet d'une application auquel est associée une procédure PL/SQL. La procédure est généralement exécutée lorsque l'utilisateur clique à l'aide de la souris.


Procédure PL/SQL associée à un objet application et s'exécutant lorsqu'un événement de souris particulier se produit sur un élément à l'exécution (clic sur un bouton, par exemple). La procédure se déclenche en établissant une hiérarchie des données extraites contenant un groupe de ventilation.


Zone de mémoire temporaire pour les données d'une base auxquelles les utilisateurs accèdent ou qu'ils modifient, ou pour les données dont Oracle Server a besoin pour prendre en charge les utilisateurs. Les termes « cache » et « mémoire cache » sont utilisés indifféremment.


Interface permettant d'appeler les exécutables d'Oracle Developer à partir d'autres produits Oracle ou d'un programme en langage de troisième génération.


Chaîne d'appels de sous-programme, du point d'entrée initial jusqu'au sous-programme en cours d'exécution. Chaque appel de sous-programme est représenté par un cadre sur la pile d'appels descendante-ascendante dans laquelle les sous-programmes nouvellement entrés sont ajoutés en bas.


  Voir éditeur.


Dans Form Builder, objet d'arrière-plan sur lequel vous placez les objets d'interface dont les utilisateurs vont se servir dans l'application à l'exécution. Une vue-canevas est généralement associée à une fenêtre.


Objets manipulables connectés au client, au serveur d'application ou à la base de données via une API ouverte.


Voir feuille de style.


Libellé servant à différencier des informations par une représentation non hiérarchique ou par subdivisions, plutôt que par des niveaux de sensibilité. La classification permet de restreindre l'accès aux informations.


Voir axe discret.


Instance de données dans un tableur (par exemple, Microsoft Excel).


Acronyme de Common Gateway Interface. Standard de l'industrie servant à exécuter des applications sur un serveur Web. Alors que les documents HTML standard extraits d'un serveur Web sont statiques (le même texte est extrait chaque fois), CGI permet à un programme fonctionnant sur le serveur Web de communiquer avec un autre ordinateur pour générer des documents HTML « dynamiques » en réponse à des informations saisies par l'utilisateur.


Acronyme de Computer Graphics Metafile. Format de fichier reconnu internationalement, servant à stocker et à transférer des graphiques orientés objet d'un système ou d'un programme à un autre.


Type de données Oracle assurant la compatibilité ANSI/ISO. Une colonne de type CHAR a une longueur fixe et peut contenir tout caractère imprimable, comme A, 3, & ou des espaces. Elle peut comprendre de 1 à 255 caractères, ou avoir la valeur Null.


Barre, ligne, symbole ou autre objet graphique représentant une valeur unique pour un champ.


Rectangle de n'importe quelle taille et servant à intégrer les graphiques de Graphic Builder dans une application Forms ou dans un état.


Ensemble d'attributs et de propriétés définissant le format d'un graphique.


Elément d'interface apparaissant sous forme de petit carré, et pouvant être activé ou désactivé.


Algorithme de contrôle d'erreurs.


1. Objet membre d'un groupe, situé immédiatement au-dessous de l'objet groupe dans son arborescence de groupe. Les objets qui composent un groupe sont les enfants de ce groupe. Tout objet est l'enfant de son parent.
2. (Oracle Express) Valeur de dimension, de niveau immédiatement inférieur à celui d'une valeur donnée dans une hiérarchie. Les valeurs enfant servent à calculer la somme globale à l'origine de la valeur parent. Une valeur de dimension peut être enfant de plusieurs parents si la dimension dispose de plusieurs hiérarchies. L'exemple suivant désigne les valeurs de dimension Lyon et Paris comme enfants de France dans la dimension GEOGRAPHY.


Voir interrogation détail.


Niveau hiérarchique indiquant la sensibilité des informations libellées. La classification sert à restreindre l'accès aux informations.


Partie d'une instruction SQL, qui ne constitue pas l'intégralité de l'instruction ; une « clause WHERE », par exemple.


Utilisateur, application logicielle ou ordinateur demandant des services, des données ou l'exécution d'un programme à une autre application ou à un autre ordinateur (le serveur). Dans un environnement client-serveur, le client est le processus utilisateur. Dans un environnement réseau, le client est le processus utilisateur local, et le serveur peut être local ou distant.


Séparation du traitement entre deux unités centrales. La première agit en tant que serveur : elle fournit des services, et le client (l'autre unité centrale) demande et reçoit ces services. Toutes les opérations de gestion de données partagées peuvent être traitées par l'ordinateur qui exécute le système de gestion de bases de données, tandis que les postes de travail sur lesquels fonctionne l'application de base de données interprètent et affichent les données.


Mémoire tampon. Un objet reste dans le Presse-papiers jusqu'à ce que l'utilisateur coupe ou copie un autre objet, ou quitte l'application.


Type de données défini par l'utilisateur, décrivant une unité de données constituée d'un nombre indéterminé d'éléments dont le type de données est identique. Les types de tableau variable et les types de table sont des types de collecte. (Oracle8)


Argument permettant d'indiquer un fichier qui contient un ensemble d'arguments de ligne de commande pour les exécutables Oracle Developer.


Contient toutes les couleurs disponibles pour le système de fenêtres, pour la surface de dessin, ou pour une fenêtre et ses vues.


1. Espace vertical dans une table de base de données, représentant un domaine de données particulier. Une colonne possède un nom (ENAME, par exemple) et un type de données propre (CHAR, par exemple). Dans une table d'informations sur le personnel, par exemple, les noms des employés peuvent constituer une colonne. Une colonne de groupe d'enregistrements représente une colonne de base de données.
2. Dans Report Builder, objet modèle de données créé automatiquement pour chaque expression de colonne dans la liste SELECT d'une interrogation, ou créé manuellement pour exécuter des récapitulatifs et des formules, ou tenir lieu de marque de réservation.


Dans une table relationnelle ou une table d'objets Oracle8, colonne dont la définition dépend d'un type d'objet. La colonne est une colonne composite et ses différentes parties correspondent aux attributs du type d'objet.


Ligne de commande du système d'exploitation. La plupart des produits Oracle peuvent être appelés à partir d'une ligne de commande à l'aide d'un certain nombre d'arguments exécutables.


Elément de langage permettant d'insérer un ensemble d'explications dans un programme sans affecter l'exécution de ce programme.


Modifier de façon permanente les données de la base de données. Avant que les modifications ne soient stockées, les anciennes données et les nouvelles cohabitent, ce qui vous permet de stocker les modifications ou de restaurer les données antérieures.


(Oracle Express)

>	Supérieur à

<	Inférieur à

=	Egal à

<=	Inférieur ou égal à

>=	Supérieur ou égal à

<>	Différent de

Pour les nombres, les opérandes sont arrondis au type le moins courant (Integer est prioritaire sur Long, lui-même prioritaire sur Single, qui est prioritaire sur Double). Pour les chaînes, la comparaison distingue les majuscules des minuscules et dépend de la séquence lexicographique utilisée dans la langue indiquée dans le Panneau de configuration de Windows. Le résultat est 0 pour FALSE et -1 pour TRUE.


Traduire un programme source vers un format binaire exécutable. Les unités de programme PL/SQL doivent être compilées avant de pouvoir être exécutées.


Objet cible particulier faisant partie d'une application plus vaste : un formulaire dans un système de saisie de commandes ou une bibliothèque partagée entre de nombreux autres éléments, par exemple. Voir aussi : cible.


Accès simultané aux mêmes données par plusieurs utilisateurs exécutant des applications de base de données différentes ou identiques. Dans un logiciel de base de données, la simultanéité d'accès nécessite une logique supplémentaire pour que les utilisateurs puissent se servir de données homogènes et que toutes les modifications soient effectuées dans le bon ordre.


Expression pouvant prendre deux valeurs, vrai ou faux, comme X> 100. Vous pouvez, par exemple, définir une condition dans une interrogation pour que l'interrogation n'affiche que les lignes dont la valeur est Vrai dans votre expression.


Mode de l'Editeur de présentation empêchant les objets enfants d'être déplacés ou redimensionnés à l'intérieur ou à l'extérieur de leurs objets parents.


Accéder à une base de données. Vous devez vous connecter pour créer ou modifier des interrogations, ou pour accéder à une application stockée dans une base de données.


Ensemble de paramètres, notamment un protocole, utilisés par SQL*Net pour établir la connexion à une instance Oracle particulière sur le réseau.


Règle ou restriction concernant une donnée (telle que la restriction NOT NULL sur une colonne) appliquée au niveau de la base de données, au lieu du niveau de l'objet ou de l'application.


Structure de code PL/SQL. Il existe deux types de structure : la structure sans valeur qui ne renvoie pas de valeur et la structure avec valeur qui en renvoie une.


Zone de travail dans laquelle Oracle Server stocke l'instruction SQL en cours et, s'il s'agit d'une interrogation, les en-têtes de colonne de résultat et une ligne du résultat. Egalement appelé curseur.


Axe matérialisant des valeurs de début et de fin. Ces valeurs sont ainsi mathématiquement liées. Les données dépendantes sont généralement tracées le long de cet axe, également appelé axe de valeurs.


Chacun des quatre angles du rectangle virtuel constituant la forme idéale d'un objet. Lorsque vous sélectionnez un objet dans la présentation, ses points de contrôle s'affichent. Vous pouvez, selon l'objet sélectionné, modifier ce dernier en faisant glisser l'un de ses points de contrôle.


Grille bidimensionnelle sur laquelle l'utilisateur dessine.


Système de référence (abscisse et ordonnée) servant à déterminer la position et la taille des objets dans l'Editeur de présentation. Deux systèmes de coordonnées sont disponibles : 1) le système de type caractère, qui utilise la taille de cellule de caractère natif de la plate-forme et 2) le système de type réel, pouvant être exprimé en pixels, en centimètres, en pouces ou en points.


Valeurs définissant la position des objets dans une présentation. Les coordonnées x et y déterminent la position horizontale (x) et verticale (y) des objets.


Reproduire dans le Presse-papiers un objet sélectionné afin de le coller éventuellement à un autre emplacement d'un éditeur.


Sous-interrogation basée sur les mêmes tables que l'interrogation parent (c'est-à-dire faisant référence aux colonnes des tables comprises dans son interrogation parent).


Groupe propriétaire d'au moins deux autres groupes, qui calcule la corrélation entre les produits.


Voir cellule de matrice.


1. Petite icône matérialisant la position de la souris. La forme du curseur varie en fonction de l'outil sélectionné.
2. Pointeur interne vers les données extraites par une interrogation. Un curseur pointe vers une seule ligne de données à la fois ; vous pouvez toutefois utiliser des sous-programmes intégrés pour placer le curseur sur n'importe quelle ligne de l'ensemble de données.


(Oracle Express) Formule créée par un utilisateur, permettant d'affiner l'analyse des données. Vous pouvez créer des mesures personnalisées à l'aide des mesures standard de la base de données. Par exemple, si la base de données contient la mesure Volume Share, vous pouvez l'utiliser pour créer une mesure personnalisée appelée Volume Share Year Ago. Cette mesure vous permet de visualiser la part absolue d'un produit pour l'année précédente.


Supprimer un ou plusieurs objets et les stocker dans le Presse-papiers afin de les coller éventuellement à un autre emplacement d'un éditeur.


Une vue est endommagée lorsqu'elle est totalement ou partiellement masquée par une autre.


Ensemble de tables et de vues appartenant à l'administrateur de bases de données. Le dictionnaire de données est une source d'informations centrale pour Oracle Server et d'autres bases de données relationnelles.


Objet modèle de données servant à définir une relation maître-détail (parent-enfant) entre un groupe et une interrogation.


Modèle relationnel définissant les données à extraire de la base de données, les valeurs à calculer et le mode de classement de données à utiliser dans un état. Les interrogations, les groupes, les colonnes, les paramètres et les liens sont les objets de Report Builder qui définissent le modèle de données.


Source pour les données renvoyées par une interrogation, y compris les objets de base de données tels que les tables, les vues, les synonymes, les clichés et les interrogations stockées sous forme de vues.


Dans Project Builder, noeud du Navigateur de projet indiquant un élément de projet qui gère la structure d'un projet ouvert. Le noeud Base de registres globale, par exemple, indique la base de registres globale, qui contient la liste des registres locaux et la liste des définitions de type global.


Ensemble de tables dictionnaire et de tables utilisateur traité comme une unité.


Bloc PL/SQL stocké, implicitement exécuté lorsqu'une instruction déclencheur INSERT, UPDATE ou DELETE est émise sur la table associée dans la base de données. Voir aussi : déclencheur de débogage.


Type standard de données. Les types de données Oracle sont CHAR, VARCHAR2, DATE, NUMBER, LONG, RAW et LONG RAW.


Type de données Oracle Server. Une colonne date peut contenir une date et une heure, comprises entre le 1er janvier 4712 avant Jésus-Christ et le 31 décembre 4712 après Jésus-Christ.


Axe matérialisant des valeurs de date de début et de fin.


Détecter, diagnostiquer et éliminer les erreurs d'exécution dans les programmes.


Dans un sous-programme PL/SQL, événement défini par l'utilisateur et servant à éliminer les erreurs d'exécution.


Action de débogage conditionnelle pouvant être placée dans n'importe quelle ligne source exécutable d'un sous-programme PL/SQL. Si la condition indiquée est remplie, l'action associée est déclenchée avant la reprise de l'exécution du sous-programme. Voir aussi : déclencheur de base de données.


Fonctionnalité Procedure Builder intégrée à Oracle Developer, et utilisée à des fins de test et de débogage.


Dans Oracle8, les types d'objet et les objets sont composés ; ils contiennent des parties ou attributs. Oracle Developer traite chaque partie/attribut comme un élément de données indépendant pouvant être sélectionné de manière individuelle. Ce traitement produit un objet déstructuré (parfois appelé objet aplani). L'objet n'est pas une entité homogène dans l'environnement Oracle Developer.


Données dont la valeur dépend de celles d'autres données. L'ancienneté d'un employé, par exemple, peut avoir la valeur 10, qui dépend de la valeur du nom de l'employé. Egalement appelé données de type valeur.


Valeur fournie par le système si l'utilisateur n'indique pas de valeur pour un paramètre ou un attribut de commande obligatoire.


Préparer une application afin d'obtenir une application terminée, prête à être distribuée et déployée.


Mécanisme utilisé par Project Builder pour déterminer la façon de compiler les fichiers qui sont référencés dans les projets. Les éléments situés dans la partie supérieure gauche de l'arborescence dépendent des éléments situés dans la partie inférieure droite ; ainsi, par exemple, si un fichier d'en-tête est obsolète ou si sa date est postérieure à celle du fichier exécutable que ce fichier d'en-tête sert à générer, Project Builder régénère le fichier exécutable selon une commande Build. Les dépendances s'appliquent également aux sous-projets. Si, par exemple, un sous-projet de fonctions de bibliothèque a été régénéré, Project Builder « sait » que le projet dépendant devra être régénéré pour que les fonctions de bibliothèque mises à jour puissent être utilisées. Voir aussi : vue de dépendances.


Dans Project Builder, affiche des fichiers dans le Navigateur de projet, dans leur ordre de dépendance respectif avec des noeuds de projet au sommet de la hiérarchie, suivis par des noeuds cible, eux-mêmes suivis par des composants pouvant être générés à partir de ces cibles. Par exemple, un formulaire exécutable sera suivi du fichier .fmb qui en dépend, lui-même suivi de la bibliothèque utilisée pour une procédure USEREXIT, etc. Voir aussi : affichage de projet, cible.


1. Objet qui, dans l'arborescence de groupe d'un autre objet, apparaît au-dessous de cet objet. Tout objet est le descendant de ses antécédents.
2. (Oracle Express) Valeur de dimension de niveau inférieur à celui d'une valeur donnée dans une hiérarchie. Les valeurs des descendants servent à calculer la somme globale d'un ancêtre. L'exemple suivant désigne les valeurs de dimension France, Lyon et Paris comme les descendants d'Europe dans la dimension GEOGRAPHY.


Interface utilisée pour concevoir les différents composants d'une application Oracle Developer.


Voir Oracle Designer


Ensemble d'outils de modélisation, de conception et de génération d'applications. Oracle Designer vous permet de générer des applications Forms et des menus depuis des définitions de module enregistrées dans le référentiel Oracle.


Au cours de la définition d'un état maître-détail, l'interrogation détail extrait tous les enregistrements associés pour chacun des enregistrements extrait par l'interrogation maîtresse ou parent.


Fenêtre ou écran partiel dans lequel vous devez entrer des informations pour compléter une opération.


Représentation intermédiaire d'une unité de programme générée par le compilateur. La représentation DIANA comprend toutes les informations syntaxiques et sémantiques d'une unité de programme compilée. Afin de compiler une référence à une unité de programme, le compilateur doit pouvoir accéder à la représentation DIANA de l'unité de programme référencée. Si, par exemple, l'unité de programme A appelle l'unité de programme B, la représentation DIANA pour B doit être disponible avant que A ne puisse être compilée.


(Oracle Express) Type d'objet de base de données qui répertorie les valeurs correspondant à des catégories de données. Une dimension joue le rôle d'index dans l'identification des valeurs d'une variable. Par exemple, si vous possédez des données de vente avec une valeur différente par mois, ce type de données a une dimension MONTH : les données sont organisées par mois. Une dimension peut être assimilée à la clé d'une base de données relationnelle.

Tout élément de données d'une variable multidimensionnelle peut être sélectionné dans sa totalité de manière individuelle par indication d'un membre de chacune des dimensions de la variable. Par exemple, si une variable ventes comporte les dimensions MONTH, PRODUCT et MARKET, et que vous indiquiez Janvier pour la dimension MONTH, Stéréos pour la dimension PRODUCT et Est pour la dimension MARKET, vous désignez une cellule unique de la variable. Ainsi, les dimensions permettent d'organiser des données, et de les sélectionner rapidement et intuitivement afin de les extraire, de les mettre à jour et d'effectuer des calculs.

Une dimension peut être simple (valeurs de texte simple ou valeurs entières) ou associée (valeurs correspondant à des combinaisons de valeurs d'autres dimensions). Un composite n'est pas une dimension, mais un objet interne de type associé, considéré comme une dimension par Express pour la gestion des données rares.


(Oracle Express) Elément de la liste constituant une dimension. Par exemple, une société d'informatique peut disposer des valeurs de dimension LAPPC et DESKPC dans la dimension PRODUCT. Les valeurs de la dimension GEOGRAPHY peuvent comprendre Boston et Paris. Les valeurs de la dimension TIME peuvent inclure MAI96 et JAN97.


Etat d'un élément d'interface (option de menu ou bouton, par exemple) indiquant que ce dernier ne peut pas être utilisé dans le contexte actuel ; il ne réagit pas aux sollicitations du clavier ou de la souris.


Axe matérialisant des valeurs distinctes à intervalles fixes. Ces valeurs ne sont pas mathématiquement liées. Les données indépendantes sont généralement tracées le long de cet axe, également appelé axe de catégorie.


Document Graphic Builder contenant indifféremment des graphiques, des images, des objets texte et des formes.


Dans Form Builder, élément stockant ou affichant des informations qui doivent être extraites ou attribuées par programme avec PL/SQL.


Dans une pile d'appels, principe selon lequel les nouveaux sous-programmes entrés sont ajoutés au bas de la pile. Le premier cadre, correspondant au point d'entrée du programme initial, se trouve en haut de la pile, alors que le dernier cadre, associé à l'appel de sous-programme le plus profondément imbriqué, se trouve au bas de la pile.


Appuyer sur un bouton de la souris et le maintenir enfoncé tout en faisant glisser le curseur jusqu'à un endroit particulier d'une fenêtre.


(Oracle Express) Parcourir les différents niveaux de regroupement d'une dimension hiérarchisée. Lorsque vous sélectionnez des valeurs de dimension ou que vous visualisez des données, vous pouvez développer ou réduire la hiérarchie d'une dimension en la hiérarchisant vers le bas ou vers le haut. La hiérarchisation vers le bas développe la vue en incluant les valeurs enfants associées aux valeurs parents dans la hiérarchie de la dimension. La hiérarchisation vers le haut réduit la liste des valeurs descendantes associées à une valeur parent dans la hiérarchie de la dimension.

Vous pouvez cliquer sur l'icône représentant le signe plus ( [image]) pour effectuer une hiérarchisation vers le bas (développement) ou sur l'icône représentant le signe moins ( [image]) pour effectuer une hiérarchisation vers le haut (réduction).

Dans le Sélecteur, vous pouvez cliquer sur l'icône de hiérarchisation ( [image]) pour afficher la boîte de dialogue de hiérarchisation vers le bas afin de sélectionner un niveau de détails pour toute la dimension.


Option permettant de copier des objets directement dans la présentation, sans modifier le contenu du Presse-papiers.


(Oracle Express) Sélection enregistrée qui peut prendre différentes valeurs de dimension à chaque évaluation. Les valeurs de dimension sélectionnées peuvent varier d'une utilisation à l'autre. A l'inverse, une sélection statique enregistrée est une liste invariable de valeurs de dimension. Un script de sélection dynamique enregistrée peut comprendre « Sélectionnez les trois derniers mois », alors que le script d'une sélection statique enregistrée peut contenir « Sélectionnez février 1996, mars 1996 et avril 1996 ».


Acronyme d'Extended Binary-Coded Decimal Interchange Code.


Limite d'un objet.


Icône de la palette d'outils de l'Editeur de présentation, indiquant les paramètres en cours pour les motifs et les couleurs de bord, de remplissage et de texte.


Zone de travail dans laquelle vous effectuez un certain nombre de tâches, comme créer une unité de programme ou concevoir une application.


Notion pour laquelle vous pouvez avoir à enregistrer des informations. Les éléments sont décrits à l'aide d'attributs et d'associations à d'autres éléments.


Tout élément contenu dans le dictionnaire est classé selon le type auquel il appartient. Exemples de type d'élément : entité, attribut, module de programme, table, diagramme, texte, zone, etc. Leurs occurrences ou leurs instances sont appelées éléments.


(Oracle Express) Affiche une boîte de dialogue en rapport avec la tâche en cours, en général pour permettre la sélection d'une ou de plusieurs valeurs requises.


Etat d'un élément d'interface (option de menu ou bouton, par exemple) indiquant que ce dernier peut être utilisé dans le contexte actuel, et réagit aux sollicitations du clavier ou de la souris.


Objet qui en contient un autre. Un objet est considéré comme inclus dans un autre seulement si toutes les conditions suivantes sont respectées : les deux objets appartiennent à la même zone (corps, marge, page de garde ou page de fin), l'objet situé le plus à l'extérieur est un cadre ou un encadrement itératif, l'objet le plus à l'extérieur est situé derrière l'autre objet et l'objet le plus à l'intérieur tient entièrement dans les limites de l'autre objet.


Action de rendre indéchiffrables (non décodables) des données de telle sorte que seul le destinataire voulu puisse les déchiffrer (décoder) et les lire.


Système informatisé de l'utilisateur, y compris les outils généralement utilisés et leur configuration. Pour Project Builder, désigne le sous-ensemble d'outils utilisés pour réaliser diverses tâches relatives au développement d'applications Oracle Developer.


Condition d'avertissement ou d'erreur générée par un sous-programme PL/SQL.


(Oracle Express) Outil de la boîte de dialogue Sélecteur qui permet à l'utilisateur de sélectionner les valeurs de dimension associées aux données répondant aux limites qu'il indique. Par exemple, l'utilisateur peut sélectionner tous les produits dont les ventes en dollars dépassent $ 10 000 dans la semaine finissant le 23 décembre 1995, sur le marché de Boston.


Argument pouvant être communiqué à l'exécutable d'un produit, comme 'OPENFILE=mon_périph' et 'PRINT=YES'. Ces arguments sont généralement indiqués lorsque l'exécutable est appelé à partir d'une ligne de commande.


Voir lancer.


Stocker un exemplaire d'un objet, d'un module, ou du texte ou de l'image sélectionné, dans un fichier ou dans une base de données. Dans Project Builder, processus d'écriture d'un fichier contenant des définitions de projet, de type, d'action et/ou de macro dans un format portable à distribuer à d'autres utilisateurs susceptibles de travailler sur des plates-formes hétérogènes. Voir aussi : fichier d'export, importer.


Dans Project Builder, fichier partageable et portable créé par l'exportation d'un projet.


1. Elément PL/SQL regroupant des variables, des constantes, des valeurs litéralles et des opérations sur leurs valeurs.
2. (Oracle Express) Une ou plusieurs valeurs de données indiquées dans un programme en langage Express. Par exemple, vous pouvez désigner des expressions comme arguments de programmes ou comme fonctions. Une expression peut être l'un des éléments suivants :

•	une valeur littérale unique (par exemple, 10) ;

•	une variable ou une formule comportant une ou plusieurs valeurs ;

•	une fonction renvoyant une ou plusieurs valeurs ;

•	un calcul associant des valeurs (variables, formules ou fonctions) à des opérateurs arithmétiques ou booléens.


Voir bibliothèque.


Instruction SQL SELECT au format ANSI standard pouvant être référencée par d'autres produits Oracle.


(Oracle Express) Groupe de valeurs de dimension connexes qui correspondent aux niveaux de hiérarchie d'une dimension. Les valeurs de dimension d'une famille peuvent être apparentées comme ancêtre, parent, enfant et descendant. L'exemple suivant désigne les relations familiales de la valeur de dimension France dans la dimension GEOGRAPHY.


(Oracle Express) Outil de la boîte de dialogue Sélecteur permettant à l'utilisateur de sélectionner une famille de valeurs de dimension pour une hiérarchie donnée. Une famille comprend une valeur parent et toutes les valeurs de dimension descendantes. Par exemple, l'utilisateur peut sélectionner tous les membres de la famille situés en dessous du niveau de marché de Chicago dans la dimension Geography.


1. Elément d'interface dans lequel des données peuvent être saisies, modifiées ou supprimées. 2. Dans Graphic Builder ou Report Builder, objet définissant le mode de présentation des données d'une colonne d'interrogation.


Dans Graphic Builder, ensemble d'attributs et de propriétés déterminant le mode de représentation des données dépendantes (valeurs) sous forme de champs de graphique tels que des barres ou des lignes.


Dans Project Builder, noeud du Navigateur de projet indiquant un fichier stocké dans le système de fichiers. Par exemple, les noeuds de base de registres globale et de base de registres locale correspondent aux fichiers des bases de registres globale et locale.


Zone d'un objet à laquelle un remplissage (couleur ou motif) doit être appliqué.


Fonction PL/SQL ou fonction anonyme limitant les données affichées par un groupe.


Ordinateur réglant depuis l'extérieur l'accès aux ordinateurs d'un réseau local et gérant l'accès aux ordinateurs extérieurs depuis le réseau local.


Voir objet déstructuré.


Mode de l'Editeur de présentation redimensionnant ou réduisant automatiquement les objets parents lorsque les objets enfants sont déplacés ou redimensionnés, et ajustant l'emplacement des autres objets de présentation qui, sinon, pourraient être affectés par ce déplacement ou ce redimensionnement.


Etat d'une entité pouvant répondre aux entrées de l'utilisateur ou du client. Si une entité est la cible des entrées (point d'insertion), elle peut recevoir des événements lorsque l'utilisateur appuie sur une touche. Si un affichage de dessin est la cible des entrées (point d'insertion), il peut répondre aux routines client affectant le dessin.


Partie noire d'un motif. L'application d'une couleur à l'élément de premier plan se fait à l'aide la palette de couleurs de bord.


Valeur ou colonne d'une table faisant référence à une clé primaire d'une autre table.


Dans Report Builder, type de présentation par défaut dans lequel les libellés sont affichés à gauche des champs ; chaque enregistrement est imprimé sur une page logique distincte.


Dans Report Builder, type de présentation par défaut mélangeant les objets standard et les champs, insérant un retour à la ligne au changement de mot.


(Propriétés de champ) Paramètre définissant l'aspect de la valeur d'un champ. Par exemple, un masque de format peut être utilisé pour indiquer l'affichage de montants en devise et de dates.


Fonction PL/SQL permettant de modifier dynamiquement les attributs de formatage d'un objet.


(Oracle Express) Type d'objet de base de données représentant une expression, une procédure ou un calcul stockés à l'origine d'une valeur. Une formule permet de définir et d'enregistrer les relations complexes ou fréquemment utilisées dans les données sans enregistrer de nouveau les données. Chaque fois que vous utilisez une formule, Express lance la procédure ou effectue le calcul requis pour créer la valeur.


Colonne créée par l'utilisateur extrayant ses données à l'aide d'une fonction ou d'une expression PL/SQL, d'une sortie utilisateur, d'une instruction SQL ou de toute combinaison de ces éléments.


1. Dans Graphic Builder, partie d'un modèle de graphique définissant la structure de base d'un graphique, mais pas le mode de tracé des données.
2. Dans Report Builder, objet de présentation servant à englober d'autres objets de présentation et à contrôler le formatage, la fréquence et le positionnement de plusieurs objets simultanément.


Sous-programme PL/SQL qui exécute la suite d'actions indiquée, puis renvoie une valeur. Peut résider et être exécuté sur le client et sur le serveur de base de données.


Enregistrer une application au format binaire dans une base de données ou un fichier pouvant être exécuté par des exécutables Runtime et Batch.


Exécutable Form Builder servant à enregistrer une application dans un fichier ou dans une base de données au format binaire.


Base de registres de Project Builder stockant des informations applicables à l'intégralité d'une installation Oracle Developer. Ces informations sont limitées aux définitions de type et à leurs actions, ainsi qu'aux propriétés prédéfinies ou définies par l'utilisateur. L'utilisation de cette base de registres est facultative ; ses fonctions peuvent être exécutées à l'aide de chaque base de registres utilisateur. Voir aussi : base de registres, base de registres utilisateur.


Conteneur logique existant dans une application. Lorsqu'une application utilise une variable globale, elle conserve la variable jusqu'à sa sortie ou jusqu'à ce qu'un autre objet la supprime explicitement.


Accorder à un utilisateur l'accès à un module. Seul le créateur d'un module peut en autoriser l'accès aux autres utilisateurs.


Dans Graphic Builder, ensemble de lignes divisant une surface en carrés dans l'Editeur de présentation.


1. Objet composé de plusieurs autres objets.
2. Dans Report Builder, objet modèle de données créé automatiquement (pour contenir toutes les colonnes sélectionnées par une interrogation) ou créé par l'utilisateur (pour modifier la hiérarchie des données figurant dans un état) ; il sert principalement à créer des points d'interruption dans un état, ainsi qu'à réinitialiser des calculs.
3. Dans Project Builder, ensemble d'éléments apparentés accessibles à partir des sous-menus du Lanceur. Les groupes permettent à l'utilisateur de configurer le Lanceur de façon semblable au menu Démarrer de Windows 95, composé de groupes arbitraires contenant d'autres éléments ou groupes. Par exemple, un utilisateur peut définir un groupe appelé Doc projet, contenant l'échéancier d'un projet, la liste des activités, les spécifications de composant, etc. ; certains fichiers peuvent être de type .TXT, d'autres de type .DOC.


Fonction PL/SQL limitant les données affichées par un groupe.


Modèle hiérarchique, semblable à un arbre généalogique, décrivant les relations entre les objets groupe et les objets qui les composent.


Interface utilisateur faisant appel à des représentations graphiques, et non uniquement à des mots, pour dialoguer avec un programme. Les programmes à interface graphique fonctionnent avec un système de fenêtres (comme X Windows, Microsoft Windows, Apple Macintosh, etc.). Ces programmes affichent notamment des icônes et des boutons. Les utilisateurs contrôlent ce type de programme principalement à l'aide d'un pointeur à l'écran, (commandé par une souris). Egalement appelée interface bitmap.


Pointeur interne vers un objet application. Pour référencer un objet dans une unité de programme PL/SQL, vous devez transmettre son pointeur comme argument au sous-programme approprié.


Zone d'état facultative pouvant contenir des éléments d'introduction d'état, y compris du texte, des graphiques, des données et des calculs. La page de garde apparaît en premier, avant le corps et la page de fin.


Noeud du Navigateur d'objet indiquant un type d'objet pouvant être contenu dans un état ou y être associé. La sélection d'un noeud en-tête ne sélectionne pas un objet dans l'état.


(Propriétés de champ) Propriété indiquant si Report Builder supprimera le champ indiqué à son emplacement dans la présentation. Si la valeur Masqué est indiquée, la valeur du champ ne figurera qu'à l'endroit référencé dans les objets texte (à l'aide de &fieldname).


(Oracle Express) Méthode d'organisation et de structuration des données. Une hiérarchie existe lorsque les valeurs d'une dimension sont organisées en niveaux, chaque niveau correspondant à la somme globale des données du niveau inférieur. Certaines dimensions peuvent appartenir à plusieurs hiérarchies.

L'exemple suivant présente une hiérarchie de la dimension GEOGRAPHY, dans laquelle les valeurs de dimension sont organisées sur cinq niveaux. Les données du niveau Customers sont classées par groupe dans le niveau Cities, lui-même réparti entre les niveaux Countries/Areas, Continents/Regions et Global.


Acronyme de Hypertext Markup Language. Langage ASCII fondé sur des balises, et servant à indiquer le contenu et les liens à d'autres documents sur des serveurs Web Internet. Les utilisateurs disposant de navigateurs Web affichent les documents HTLM et suivent les liens pour afficher les autres documents.


Acronyme de Hypertext Transfer Protocol. Protocole utilisé pour acheminer le trafic WWW entre un ordinateur doté d'un navigateur WWW et le serveur WWW auquel cet ordinateur accède.


Référence (lien) entre un point donné d'un document et un autre document, ou un autre endroit du même document. Un navigateur Web affiche généralement un hyperlien de façon distincte (dans une couleur, une police ou un style différent). Lorsque les utilisateurs activent des hyperliens (en cliquant dessus avec la souris), le navigateur affiche la cible du lien.


Ensemble de documents contenant des références croisées qui permettent aux utilisateurs de se déplacer facilement d'un document à un autre à l'aide d'un navigateur Web.


Références croisées, qui permettent aux utilisateurs de se déplacer facilement d'un document à un autre à l'aide d'un navigateur Web.


Acronyme d'Interface C Definition. Interface de programmation d'applications PL/SQL à fonctionnalité mise en oeuvre en langage C.


Représentation graphique d'une fenêtre ou d'un outil.


Objet bitmap pouvant être stocké et chargé dans une application. Le client ne peut pas modifier une image importée.


Dans Project Builder, élément de projet, résultant généralement d'une génération automatique, que Project Builder reconnaît et pour lequel il crée automatiquement des entrées dans le Navigateur de projet. Par exemple, Project Builder peut reconnaître des fichiers .obj, générés à une étape intermédiaire de la compilation des fichiers source C, et créer des entrées pour ces fichiers dans le Navigateur d'objet. Bien que la réinitialisation des propriétés d'un élément impliqué soit d'usage restreint (la compilation suivante détruira les modifications), les éléments impliqués peuvent être utiles, car ils peuvent être contrôlés à l'aide des fonctions d'édition, d'affichage et d'impression. Voir aussi : élément, action.


1. Lire un module depuis le système de fichiers ou la base de données, puis l'intégrer dans une application.
2. Lire un fichier contenant des informations sur un projet.


Données dont la valeur ne dépend pas de celle d'autres données. Le nom d'un employé peut avoir, par exemple, la valeur Dupont, qui est indépendante des valeurs des noms des autres employés ou des données associées. Egalement appelées données de catégorie.


Structure facultative associée à une table utilisée par Oracle Server pour localiser rapidement des lignes de la table et (facultatif) pour s'assurer que chacune des lignes est unique.


Dans Project Builder, obtenir des informations d'un noeud ancêtre d'une arborescence de dépendances afin de définir une action, un type, une macro ou une propriété. Si des attributs apparentés existent dans le noeud ancêtre, ils peuvent être hérités. Ainsi, des éléments de système de fichiers tels que des formulaires ou des documents peuvent hériter de définitions d'action de sous-projets, de projets, de la base de registres utilisateur ou de la base de registres globale ; les projets peuvent hériter les définitions de type des bases de registres locale ou globale, et ainsi de suite.


Rectangle virtuel constituant la forme idéale d'un objet et reliant ses quatre points de contrôle, indépendamment de l'épaisseur de bord et des autres paramètres d'attribut.


Fichier servant à générer une cible : par exemple, un fichier .FMB est l'élément d'entrée d'un fichier .FMX. Egalement appelé source.


Mode selon lequel chaque caractère entré est inséré à l'emplacement du curseur, déplaçant vers la droite les caractères suivants. Contraire de mode remplacement.


Réseau mondial d'ordinateurs fondé sur TCP/IP.


Fichier contenant tout ensemble de sources PL/SQL, de commandes Procedure Builder et d'instructions SQL.


Réseau TCP/IP interne dont l'accès est restreint (via un coupe-feu) au personnel d'une entreprise ou d'une organisation. Un réseau Intranet offre à une organisation des services semblables à ceux fournis par Internet, sans que les utilisateurs soient nécessairement connectés à Internet. L'exemple classique d'un réseau Intranet consiste en une société qui configure des serveurs Web sur un réseau interne pour diffuser des informations ou des applications au sein de la société.


Numéro constitué de quatre groupes contenant au maximum trois chiffres, identifiant un ordinateur sur Internet.


Dans Project Builder, objet dans le système de fichiers associé au projet, tel qu'une application Forms ou un document, pointé sur un noeud du Navigateur de projet ou représentant ce noeud.


Dans Project Builder, entrée de la fenêtre Navigateur d'objet représentée par une icône et un titre descriptif. Ces noeuds pointent sur des éléments réels dans le système de fichiers, tels que des fichiers et des documents Form Builder. Voir aussi : noeud, élément.


Acronyme de Java ARchive. Fichier servant à réunir un grand nombre de fichiers (fichiers de classe Java, images, etc.) dans un seul fichier.


Langage informatique prenant en charge la programmation pour Internet sous forme d'« applets » indépendantes de la plate-forme.


Combinaison des données de plusieurs tables dans une instruction SELECT unique.


  Voir alignement.


1. Partie de la syntaxe d'une ligne de commande devant être fournie avec un argument correspondant.  2. Partie obligatoire d'un élément PL/SQL.


Texte identifiant les valeurs ou la signification des objets visuels d'une application.


(Oracle Express) Position dans une hiérarchie de dimension. Chaque niveau situé au-dessus du niveau de base correspond à la somme globale des données du niveau inférieur. Par exemple, la dimension TIME peut comporter des niveaux croissants comme Months, Quarter et Year. A l'intérieur d'une hiérarchie de dimension, la valeur d'un niveau de dimension dispose d'une relation familiale avec les valeurs de dimension des niveaux immédiatement supérieur et inférieur.


(Oracle Express) Outil de la boîte de dialogue Sélecteur permettant à l'utilisateur de sélectionner des valeurs de dimension en fonction de leur niveau dans une hiérarchie donnée. Par exemple, l'utilisateur peut sélectionner toutes les valeurs de dimension du niveau Key Account de la dimension Geography.


Zone d'un éditeur dans laquelle vous pouvez créer, modifier, positionner ou supprimer des objets.


Unité de mesure permettant d'assurer une uniformité de présentation entre les différents dispositifs d'affichage. Sert à indiquer un emplacement dans la présentation ou les dimensions d'un objet.


Référence à un paramètre, utilisée pour représenter une chaîne de texte dans une instruction SQL SELECT. Pour créer une référence lexicale, vous devez faire précéder le nom du paramètre d'une esperluète (&).


Ensemble constitué d'unités de programme PL/SQL stockées dans le système de fichiers client ou dans une base de données. Les unités de programme figurant dans une bibliothèque peuvent être référencées par plusieurs applications à la fois. A la différence des unités de programme stockées, qui résident et sont exécutées dans la base de données, les unités de programmes figurant dans une bibliothèque sont toujours chargées et exécutées au sein du moteur PL/SQL du côté client. Pour faire référence à des unités de programme figurant dans une bibliothèque, vous devez au préalable attacher la bibliothèque. Voir aussi : bibliothèque attachée.


Objet modèle de données servant à définir une relation maître-détail (parent-enfant) entre un groupe et une interrogation.


Nom d'un fichier auquel est associé un objet texte standard. A l'exécution, Report Builder importe le contenu du fichier dans la présentation de votre état.


Liste d'éléments dans une boîte de dialogue. Vous pouvez normalement la faire défiler et y effectuer une sélection.


Dans Form Builder, élément affichant une liste de choix.


Egalement appelée LOV. Fenêtre instantanée, que l'utilisateur peut faire défiler, affichant une liste de sélection monocolonne ou multicolonne.


(Oracle Express) Outil de la boîte de dialogue Sélecteur permettant de sélectionner des valeurs dans la liste des valeurs actuellement sélectionnées dans la dimension.


1. Base de données de l'ordinateur exécutant l'application. 2. Base de données à laquelle une application est connectée. Cette base de données analyse et exécute toutes les instructions SQL générées par l'application.


Voir base de registres utilisateur.


Variable PL/SQL déclarée uniquement pour l'unité de programme en cours.


(Oracle Express)

Not	Non unaire - Opérande de type Integer ou Long. L'opération est effectuée au niveau du bit (complément à 1).

And	Et - Opérande de type Integer ou Long. L'opération est effectuée au niveau du bit.

Or	Ou inclusif - Opérandes de type Integer ou Long. L'opération est effectuée au niveau du bit.

Xor	Ou exclusif - Opérandes de type Integer ou Long. L'opération est effectuée au niveau du bit.

Eqv	Equivalence - Opérandes de type Integer ou Long. L'opération est effectuée au niveau du bit. (A Eqv B) est identique à (Not (A Xor B)).

Imp	Implication - Opérandes de type Integer ou Long. L'opération est effectuée au niveau du bit. (A Imp B) est identique à ((Not A) OR B).


Une page de votre état proprement dit (peut être affichée sur une ou plusieurs pages physiques).


Dans un sous-programme PL/SQL, instruction conditionnelle qui est répétée jusqu'à ce que la condition ne soit plus remplie.


Dans Project Builder, variable de type spécifique pouvant être utilisée pour personnaliser et développer des actions. Une macro peut être une constante ou une expression simple (qui à son tour peut contenir d'autres constantes et/ou d'autres expressions). Le recours aux macros offre une grande souplesse pour l'émission d'options de commande et permet à l'utilisateur de modifier des ensembles de commandes en modifiant la définition d'une propriété.


Présentation par défaut affichant les enregistrements sur une ou plusieurs colonnes dans une page. Les champs apparaissent directement les uns en dessous des autres dans un encadrement itératif unique.


Zone d'état facultative apparaissant en haut et en bas de chacune des pages logiques dans la zone du corps. Une marge peut comporter tout objet de présentation, mais contient en général un texte standard et des champs (pour les numéros de page, les totaux de page, les totaux globaux, ainsi que la date et l'heure).


Présentation par défaut dans laquelle les enregistrements détail apparaissent en dessous des enregistrements maître. Les enregistrements maître ont une présentation de type formulaire, et les enregistrements détail, une présentation de type tabulaire.


(Oracle Express) Outil de la boîte de dialogue Sélecteur permettant à l'utilisateur de sélectionner des valeurs de dimension en faisant correspondre les caractères des noms des valeurs de dimension et ceux qu'il indique. Par exemple, l'utilisateur peut sélectionner toutes les valeurs de dimension du niveau Brand de la dimension Product qui contiennent les caractères « nouveau ».


Orientation itérative affichant chacun des enregistrements d'un encadrement itératif sous la forme d'une cellule de matrice.


Présentation par défaut, semblable à une grille, formatant les quatre ensembles de données nécessaires à un état matriciel ; un premier ensemble de données s'affiche sous la forme d'une ligne de libellés, un deuxième sous la forme d'une colonne de libellés, un troisième crée la grille et un quatrième remplit les cellules de la grille.


Matrice de quatre ensembles de données : un ensemble de données s'affiche de gauche à droite de la page ; un deuxième ensemble s'affiche de haut en bas de la page ; un troisième contient une référence inter-produit déterminant tous les emplacements possibles dans lesquels les données verticales et horizontales sont liées, et plaçant une cellule à ces emplacements ; et un quatrième s'affiche sous forme de « filtre » de cellules.


(Oracle Express) Données pouvant être examinées et analysées, comme les données de vente ou de coût. Vous pouvez sélectionner et afficher les données d'une mesure. Les mesures peuvent être stockées comme variables ou relations, ou calculées à l'aide de formules.


Unité de mémoire égale à 1 048 576 octets (1 024 x 1 024). Souvent arrondie à un million d'octets.


Fenêtre modale qui vous signale une condition survenue à la suite de votre dernière action. Vous devez répondre à une zone de message.


Code exécutable attaché à un objet Oracle8 via sa définition de type d'objet.


Fenêtre exigeant une réponse de l'utilisateur pour que l'application poursuive son traitement.


Fenêtre non restreinte pouvant avoir autant de fonctions que le gestionnaire de fenêtres Runtime peut en prendre en charge.


1. Objet pouvant être partagé par plusieurs applications. Les interrogations externes et les bibliothèques PL/SQL constituent des modules.  2. Dans Form Builder, composant principal d'une application (un module Menu, par exemple).


Champ d'une fenêtre ou d'une boîte de dialogue comprenant plusieurs lignes, dans lequel l'utilisateur peut faire défiler verticalement les informations.


(Oracle Express) Valeur de données spéciale indiquant que les données sont non disponibles (Not Available - NA). NA est utilisée pour toute cellule à laquelle aucune valeur de données précise n'a été affectée ou pour laquelle les données n'ont pas été calculées.


Etat matriciel dans lequel les dimensions verticale et/ou horizontale contiennent une ou plusieurs relations maître-détail. Le nombre d'imbrications autorisées est illimité.


Type de données indiquant que les données seront extraites lorsque la page sur laquelle elles figurent sera formatée (au lieu d'être extraites et mises en mémoire cache avant d'être formatées).


1. Emplacement spécifique dans la hiérarchie d'objets du Navigateur d'objet. Les noeuds peuvent être développés pour présenter des informations sur un objet, telles que des références croisées à d'autres objets.  2. Dans Project Builder, entrée du Navigateur de projet. Voir aussi : élément, noeud élément, noeud organisation.


Colonne d'état référençant une colonne de base de données de type NOCACHE.


Indique l'absence de valeur.


(Oracle Express)

^	Exposant.

-,+	Moins et plus unaires.

*, /	Multiplication ou division numérique. Pour la division, le résultat est un double.

\	Division entière. Les opérandes peuvent être de type Integer ou Long.

Mod	Modulo ou reste. Les opérandes peuvent être de type Integer ou Long.

-, +	Addition et soustraction numériques. L'opérateur + peut également être utilisé pour concaténer des chaînes.


1. Elément pouvant être placé dans la présentation. Les éléments suivants sont des objets : rectangle, trait, ellipse, arc, polygone, ligne polygonale, rectangle arrondi, forme libre, graphique, texte, symbole et champ texte. 2. Dans Oracle8, instance d'un type d'objet. Un objet peut être une ligne d'une table d'objets ou une partie de ligne d'un objet colonne d'une table relationnelle.


Voir objet colonne.


Conteneur d'un groupe d'objets, servant à autoriser la copie ou la référence des objets apparentés.


Voir descripteur.


Fenêtre contenant la liste hiérarchique des objets de la session en cours. Elle apparaît sous la forme d'un plan qui permet à l'utilisateur d'effectuer diverses tâches : création, édition, changement de nom et suppression d'objets, par exemple.


Dans Oracle8, table dont la définition est fondée sur un type d'objet. Chaque attribut du type d'objet devient une colonne de la table d'objets. Chaque ligne de la table correspond à un objet Oracle8 distinct.


Dans Oracle8, définition ou modèle fourni par l'utilisateur permettant de construire des objets. Un type d'objet est une entité composite constituée d'attributs. Chaque attribut dispose d'un nom et d'un type de données, et le type d'objet en tant qu'entité possède un nom. Un type d'objet peut également inclure une ou plusieurs méthodes.


Acronyme d'Open Database Connectivity. Norme d'accès à divers systèmes de base de données. Une application peut soumettre des instructions à ODBC à l'aide de SQL ODBC. ODBC traduit ensuite ces instructions dans un format utilisable par la base de données. Oracle Open Client Adapter (OCA) permet à une application d'accéder à divers systèmes de gestion de base de données en utilisant toujours la même méthode. Un développeur d'applications peut ainsi développer, compiler et livrer une application sans cibler un système de gestion de base de données particulier.


Acronyme d'Object Linking and Embedding.


Application permettant de stocker et d'afficher des objets OLE.


Application permettant de créer des objets OLE.


Voir type de données intégré.


Variable d'environnement indiquant le répertoire principal des produits Oracle.


Entrée du Navigateur d'objet, telle que Types, Projets, Fichiers d'application Forms, etc., permettant de structurer le Navigateur et indiquant les types de fichier des éléments enfants. Le noeud organisation peut également désigner une structure de données pour certains types d'objet de système de fichiers.


Position déterminée par des coordonnées x et y. L'origine d'une vue indique l'emplacement de la vue sur son canevas parent. L'origine d'un canevas indique l'emplacement du dessin sur une vue dessinée.


Le plus petit rectangle virtuel entourant complètement un objet.


Action se produisant lorsque le contenu d'un objet ne tient pas dans la page logique en cours. En cas de débordement, une partie du contenu passe à la page logique suivante.


Fonction PL/SQL, fournie avec Oracle Developer, pouvant être référencée en tout endroit d'une unité de programme.


Méthode d'encapsulage et de stockage de procédures, de fonctions, de variables et d'autres éléments de package apparentés sous la forme d'une unité unique dans la base de données. Les packages offrent des avantages structurels aux administrateurs de base de données ou aux développeurs d'applications, et augmentent les fonctionnalités et les performances de la base de données.


Le corps de package comprend la mise en oeuvre réelle du package, qui peut comporter des sous-programmes privés et des types de données. Il est facultatif si le package ne se compose que de déclarations.


La spécification de package déclare l'interface publique au package, c'est-à-dire les types de données et les sous-programmes pouvant être référencés par d'autres unités de programme.


(Oracle Express) 1. Tranche de données incluse dans un état. Les pages supplémentaires affichent des tranches de données supplémentaires.

La figure suivante montre trois pages de données.

2. Dans Express, une page peut également désigner une unité de stockage dans une base de données Express.


(Oracle Express) Aperçu des données sélectionnées pour une interrogation, telles qu'elles apparaîtront dans votre tableur. La présentation de la page comporte trois directions : De gauche à droite, De haut en bas et Page. Elles indiquent la manière dont le cube de données multidimensionnel défini par l'interrogation sera représenté dans le tableur en deux dimensions. Les mosaïques de dimension indiquent le nom et la position des dimensions. Une mosaïque de dimension de type De gauche à droite indique que cette dimension est affichée sous forme de colonne. Une mosaïque de dimension de type De haut en bas indique que cette dimension apparaît sous forme de ligne. Une dimension de type Page indique que cette dimension est affichée dans une zone de page, au-dessus des résultats.


Paramètre qui définit si l'objet en cours et ses enfants doivent être déplacés vers la page logique suivante. Vous pouvez demander que les sauts de page se produisent avant ou après l'objet en cours dans la sortie d'état.


Elément d'interface affichant les outils, les couleurs ou les motifs disponibles dans un éditeur.


Partie distincte d'un éditeur, généralement redimensionnable, où les opérations sont exécutées.


Nombre de pages physiques nécessaires pour imprimer une page logique.


1. Elément PL/SQL utilisé pour transmettre des informations à un sous-programme. Par exemple, dans le sous-programme appelé MYPROC (x), x est un paramètre.  2. Dans Oracle Developer, les paramètres permettent de transmettre des informations d'un composant à un autre (entre Form Builder et Graphic Builder, par exemple).  3. Variable pouvant être modifiée à l'exécution.


Groupe comprenant des noms de paramètre et les valeurs associées, utilisé pour transmettre des informations entre les composants d'Oracle Developer.


1. Objet situé immédiatement au-dessus d'un autre dans son arborescence de groupe. Un objet groupe est le parent de chacun des objets qui le composent. Chaque objet est le parent de ses enfants.
2. (Oracle Express) Valeur de dimension de niveau immédiatement supérieur à celui d'une valeur donnée dans une hiérarchie. La valeur parent correspond à la somme globale des valeurs de ses enfants. L'exemple suivant désigne la valeur de dimension France comme parent de Lyon et de Paris dans la dimension GEOGRAPHY.


Placer le contenu du Presse-papiers (objet coupé ou copié) à l'emplacement du curseur.


Propriété graphique pouvant être appliquée au bord ou au remplissage de la plupart des objets.


Code machine ou liste d'instructions pour une unité de programme compilée.


Acronyme de Portable Document Format. Format de fichier (natif pour Adobe Acrobat) servant à représenter des documents de façon indépendante de l'application, du matériel et du système d'exploitation utilisés pour créer les documents. Un fichier PDF peut décrire des documents contenant indifféremment du texte, des graphiques et des images, dans un format indépendant de l'unité et de la résolution.


Taille de la page à l'impression.


Type d'élément utilisé pour matérialiser un champ dans un graphique, tel qu'une barre, une ligne ou un symbole.


Extension (propriété d'Oracle) du langage SQL. Elle ajoute des éléments de procédure et d'autres éléments SQL permettant de concevoir des applications.


Fichier de script de l'interpréteur Procedure Builder.


Fichier de bibliothèque PL/SQL contenant un code source et un code compilé. Vous pouvez ouvrir ce fichier dans Procedure Builder pour le modifier.


Fichier texte contenant le code source PL/SQL d'une seule unité de programme.


Fichier de bibliothèque Runtime PL/SQL contenant uniquement du code exécutable. Vous ne pouvez ni l'ouvrir ni le modifier dans Procedure Builder.


Liste qui apparaît lorsque l'utilisateur effectue une opération particulière.


Numéro utilisé par TCP pour aiguiller des données envoyées ou reçues par un programme donné.


Action livrée avec Project Builder, automatiquement mise à la disposition de l'utilisateur via une option de menu ou un bouton de barre d'outils. Les actions prédéfinies comprennent Build, Deliver, et plusieurs options de gestion des archives et des rapports. Si une action prédéfinie est créée pour un type de fichier pris en charge, elle est appelée pour tout élément de ce type sélectionné, lorsque l'utilisateur appelle l'action à partir de Project Builder. Voir aussi : action, action définie par l'utilisateur.


Voir type de données intégré.


Paramètre affectant le comportement de l'interface de l'application.


(Oracle Express) Affiche le script qui serait généré si vous acceptiez les critères en cours. Dans la boîte de dialogue des outils du Sélecteur, vous pouvez prévisualiser votre sélection en cliquant sur le bouton Aperçu.


Interface vous permettant de visualiser et de parcourir en ligne la sortie d'état.


Colonne d'une table de base de données dont les membres se composent de valeurs uniques pouvant être utilisées pour identifier une ligne dans une table.


Voir type de données intégré.


Dans un fichier de définition d'imprimante, séquence d'échappement à laquelle vous attribuez un code d'imprimante pouvant être référencé dans un état.


Fichier contenant une définition d'imprimante au format texte (ASCII ou EBCDIC, par exemple).


Sous-programme PL/SQL qui exécute la suite d'actions indiquée. Peut résider et être exécuté sur le client et sur le serveur de base de données.


Structure de code PL/SQL pouvant être reconnue de manière indépendante et traitée par le programme de compilation PL/SQL. Les blocs anonymes, les spécifications et corps de sous-programme (procédures et fonctions), et les spécifications et corps de package sont des types d'unité de programme. Les unités de programme peuvent résider et être exécutées sur le client et sur le serveur de base de données. Voir aussi : unité de programme stockée.


Structure de données de base créée par Project Builder. Les projets sont des ensembles de pointeurs désignant tous les fichiers que vous considérez comme faisant partie de votre application ou que vous voulez regrouper de manière conceptuelle. Vous pouvez définir les éditeurs, les compilateurs et les autres outils que vous utilisez pour travailler avec les éléments d'un projet. Toutes les informations relatives au projet sont stockées dans une base de registres projet. Voir aussi : élément de projet, fichier de projet, exporter.


Dans Project Builder, les fichiers de projet sont tous les fichiers associés à une application. Ils peuvent être de tout type (formulaires, états, affichages, modules 3GL, documentation et scripts de test). Voir aussi : projet, élément de projet.


Dans Project Builder, tout élément pour lequel des propriétés peuvent être définies, y compris les entités stockées dans le noeud Projets, les types, les actions et les macros. Voir aussi : projet, fichier de projet.


Fenêtre contenant la liste hiérarchique des éléments de projet pour la session en cours. Cette liste apparaît sous forme de plan, qui permet à l'utilisateur d'effectuer diverses tâches : création, édition, changement de nom et suppression d'objets, par exemple. Bien que l'utilisateur ne puisse en afficher qu'un à la fois, il peut choisir entre deux schémas d'organisation des objets.


Noeud de niveau supérieur d'un projet. Il représente le fichier de projet ou pointe vers ce fichier. Voir aussi : projet, fichier de projet.


Dans Project Builder, fichier stockant toutes les informations relatives à un projet : les fichiers qui en font partie, les types, les actions et les macros définis pour ce projet, etc.


Vue de projets affichant les objets par type et par relation projet/sous-projet. Les projets sont classés dans l'ordre alphabétique par fichier de projet, puis par catégorie. Voir aussi : vue de dépendances, projet, fichier de projet, vue.


Boîte de dialogue permettant à l'utilisateur de créer plus facilement un nouveau projet ou sous-projet.


Caractéristique d'un objet déterminant le comportement ou l'aspect de cet objet.


Objet nommé contenant une liste de propriétés et leurs définitions, qui sert à contrôler de manière globale l'aspect et le fonctionnement des objets fondés sur cette classe.


Chaîne pouvant être saisie lors de la connexion à un serveur ou à une base de données, qui permet de vous connecter à un serveur ou à une base de données distante.


(Oracle Express) Lorsque vous sélectionnez des valeurs pour l'une des dimensions d'une mesure, les autres dimensions de cette mesure sont appelées dimensions qualificatives.

Supposez que la mesure Sales comporte les dimensions Product, Month et Geography. Si vous sélectionnez les dix premières villes en fonction des ventes, vous devez également indiquer le produit et le mois qui sont pris en compte dans votre comparaison des valeurs de vente. Dans ce cas, Product et Month sont les dimensions qualificatives.


Instruction SQL SELECT indiquant les données à extraire d'une ou de plusieurs tables ou vues d'une base de données.


Fonction PL/SQL qui, lors de son exécution, filtre les données extraites par une interrogation. Seules les données répondant aux conditions indiquées dans la fonction sont tracées.


Option mettant fin à la session en cours et ramenant l'utilisateur au système d'exploitation. Sur certains systèmes, Quitter correspond à « Exit ».


Contrôle (semblable à une case à cocher) apparaissant par groupes de deux ou plus, dont un seul peut être « actif » à un moment donné.


Groupe de deux boutons d'option ou plus, dont un seul peut être actif à un moment donné.


(Oracle Express) Outil de la boîte de dialogue Sélecteur permettant à l'utilisateur de sélectionner des périodes consécutives comme valeurs de dimension. Ces périodes peuvent être basées sur l'un des éléments suivants :

•	un nombre précis des périodes les plus récentes ;

•	une période de départ et une période plus récente ;

•	des périodes de début et de fin.

Par exemple, l'utilisateur peut sélectionner des valeurs de dimension pour la période allant de la semaine qui se termine le 25 novembre 1996 à celle qui se termine le 30 décembre 1996.


Chiffre désigné par RSA Data Security, Inc. et qui peut accepter des clés d'une longueur arbitraire. Il s'agit essentiellement d'un générateur de nombres pseudo-aléatoires, la sortie du générateur étant traitée par l'opération Ou exclusif (Xor) avec le flux de données afin de produire les données codées. Une même clé RC4 ne doit donc jamais être utilisée pour coder deux flux de données différents.


Acronyme de Relational Database Management System (système de gestion de base de données relationnelle - SGBDR). Système de base de données permettant de définir des structures de données, des opérations de stockage et d'extraction, ainsi que des contraintes d'intégrité. Les données et leurs relations sont structurées sous forme de tables.


Fichier contenant une seule définition d'état au format binaire. Les fichiers .RDF servent à exécuter et à éditer des états.


Fichier contenant une seule définition d'état au format binaire. Les fichiers .REP servent uniquement à exécuter des états. Vous ne pouvez pas les modifier.


Possibilité d'interroger les données d'une base de données depuis un point unique dans le temps.


Une seule ligne, extraite par une instruction SQL SELECT.


Objet de structure de données interne représenté sous forme de colonnes et de lignes, appartenant au module Application Forms dans lequel elles sont définies.


Type de colonne pointant vers les données d'autres objets colonne ou d'autres tables d'objets (Oracle8).


Ligne apparaissant à la valeur indiquée dans un graphique.


(Oracle Express) Rechercher les données les plus récentes d'une base de données Express après l'affichage des résultats de l'interrogation dans votre état. Lorsque vous ouvrez une interrogation Express enregistrée, les résultats sont automatiquement régénérés.


Ajouter la définition d'un type ou d'un nouveau projet à la base de registres globale ou locale. Une fois le nouveau type inscrit aux registres, vous pouvez lui associer des actions, et vous pouvez référencer les fichiers d'un nouveau projet en tant que types spécifiques pour y exécuter des actions. Voir aussi : base de registres.


Fichier de configuration global et/ou propre à un utilisateur, permettant de stocker des définitions de projet et des informations sur l'environnement. Voir aussi : base de registres globale, base de registres utilisateur.


Symbole utilisé dans des critères de recherche pour comparer deux valeurs, comme le signe égal dans « WHERE DEPTNO = 10 ». Les lignes dans lesquelles le résultat de la comparaison est Vrai sont renvoyées dans le résultat (extraites), alors que celles dans lesquelles la comparaison renvoie la valeur Faux sont exclues des résultats.


Base de données résidant sur un autre ordinateur que la base de données locale. En général, il s'agit d'un ordinateur du même réseau, mais sur un noeud différent (c'est-à-dire une base de données que vous utilisez via une liaison de base de données).


Objet de présentation permettant d'afficher des lignes de données extraites pour un groupe.


Mode dans lequel chacun des caractères que vous tapez remplace le caractère existant situé à l'emplacement du curseur. Contraire de mode insertion.


Objets servant à définir le modèle et la présentation des données d'un état. Les objets de niveau état sont attribués à un seul état, et ne peuvent pas être partagés par d'autres états ou d'autres produits Oracle. Ces objets comprennent les états, les interrogations, les interrogations externes, les bibliothèques PL/SQL externes, les groupes, les colonnes, les paramètres, les liaisons, les encadrements, les encadrements itératifs, les champs, les textes standard et les points d'ancrage.


Disponible sous Windows NT et Windows 95 uniquement. Attend une ligne de commande pour exécuter un état, puis place cet état dans sa file d'attente pour l'exécuter à l'arrière-plan sur le serveur local. En général, les lignes de commande sont reçues depuis Form Builder ou Graphics Builder via RUN_PRODUCT, ou reçues d'un autre état via SRW.RUN_REPORT. Vous pouvez également utiliser RWISV60 pour soumettre un état au moteur d'état d'arrière-plan (Reports Background Engine).


Permet de mettre à jour l'horodatage et les informations des états gérés par Report Server.


Disponible sous Windows NT, Windows 95 et UNIX. Permet d'exécuter des états sur un serveur distant. Met les demandes de travaux dans la file d'attente et vous permet de planifier l'exécution des états. Utilisez RWCLI60 pour envoyer un état à Report Server.


Fournit une interface entre votre serveur Web et Reports Runtime pour vous permettre d'exécuter des états de manière dynamique à partir de votre navigateur Web.


Fournit une connexion entre un serveur Web et Reports Server.


Fichier contenant une définition d'état stockée au format texte (ASCII ou EBCDIC, par exemple). Les fichiers .REX permettent de porter des états d'une plate-forme à une autre. Les fichiers .REX sont désormais inutiles. Ils sont disponibles dans un but de compatibilité avec les versions précédentes.


Acronyme de « rouge, vert, bleu », désignant l'intensité de rouge, de vert et de bleu d'une couleur.


Objet groupe auquel tous les autres objets de l'application appartiennent.


Noeud de niveau supérieur d'un projet, représentant l'environnement de l'utilisateur. Peut correspondre à la base de registres utilisateur ou à la base de registres globale, selon la base choisie pour définir les valeurs par défaut.


1. Ensemble de valeurs de champ d'une table ; par exemple, les champs représentant un employé dans la table EMP.  2. Générer une version Runtime d'une application.


Objet d'une table d'objets Oracle8. Chaque ligne de la table correspond à un objet. Toutefois, dans Oracle Developer, une table d'objets est décomposée en différentes colonnes, si bien que l'objet ligne n'existe plus en tant qu'entité unique (mais seulement sous la forme de ses différents attributs).


Exécuter une version Runtime d'une application ou d'une unité de programme.


Acronyme de Rich Text Format. Format de fichier indépendant de la plate-forme, fondé sur des mots de contrôle, permettant de représenter des textes et des images non formatés sous divers systèmes d'exploitation et dans diverses applications. Le format RTF utilise le jeu de caractères ANSI, PC-8, Macintosh ou IBM PC pour contrôler la représentation et le formatage d'un document à l'écran et à l'impression.


Voir fichier rep.


Interface permettant à l'utilisateur d'afficher une application Runtime et de l'utiliser.


Ecran ou fenêtre pouvant apparaître lors de l'exécution, dans laquelle l'utilisateur peut modifier des options et des paramètres d'impression avant l'exécution d'un état.


(Oracle Express) Ensemble de valeurs de dimension enregistrées en tant que liste de valeurs ou en tant que script. Vous pouvez enregistrer les sélections que vous créez ou l'administrateur de la base de données peut créer des sélections enregistrées que vous pourrez ensuite utiliser.

Les sélections enregistrées permettent de gagner du temps : pour réutiliser une sélection, il suffit d'extraire une sélection enregistrée, sans la créer de nouveau.


(Oracle Express) Outil du Sélecteur permettant d'extraire une sélection de valeurs de dimension enregistrée.


Ensemble d'objets de base de données apparentés, généralement regroupés par ID d'utilisateur de la base de données. Les objets de schéma comprennent les tables, les vues, les séquences, les unités de programme stockées, les synonymes, les index, les groupes et les liaisons de base de données.


Niveau (plage) auquel fonctionne un objet. Dans Project Builder :  1. Décrit la plage de fichiers affectés par les commandes Compiler et Compiler tout, appelées pour des éléments de projet compilables.  2. Décrit la plage de fichiers concernés par les définitions héritables.


Voir scripts SQL, scripts de l'interpréteur.


Dans Report Builder, une ou plusieurs présentations d'un même état dont le public, le format de sortie, la présentation de page, la taille ou l'orientation diffèrent. Par exemple, un seul état peut contenir, dans une section, un récapitulatif destiné aux cadres supérieurs et, dans une autre, un rapport détaillé destiné à chaque directeur.


Instruction SQL indiquant les lignes et les colonnes à extraire d'une ou de plusieurs tables ou vues.


(Oracle Express) Ensemble des valeurs de dimension sélectionnées dans une dimension, ou script contenant les conditions ou les critères permettant d'indiquer ces valeurs.


(Oracle Express) Description des choix effectués par l'utilisateur lors de la sélection des valeurs de dimension, affichée dans la plupart des boîtes de dialogue du Sélecteur. Il s'agit d'une traduction, en langage clair, du script en langage Express.


(Oracle Express) Ensemble d'outils servant à sélectionner les valeurs de dimension à inclure (par exemple, dans un état, une table, un graphique ou une liste de dimensions). Par exemple, vous pouvez utiliser le Sélecteur pour choisir les 10 premières villes en fonction des ventes ou pour choisir les villes dont les ventes ont dépassé le quota de 15 %. Le Sélecteur permet également de trier les valeurs de dimension, et de créer et d'extraire des sélections enregistrées.


(Oracle Express) Boîte de dialogue ou groupe de boîtes de dialogue qui permet de sélectionner ou de trier les valeurs de dimension d'une manière particulière. Chaque outil Sélecteur fait partie du Sélecteur. Vous pouvez utiliser ces outils pour sélectionner des valeurs de dimension selon leur niveau hiérarchique, leurs attributs, les caractères figurant dans le nom de la valeur, etc. Vous pouvez également les utiliser pour trier les valeurs de dimension.


Période s'écoulant entre l'appel d'un exécutable et sa fermeture.


Objet ayant le même objet parent que d'autres dans son arborescence de groupe. Tous les objets appartenant à un même objet groupe sont des objets frères.


Combinaison d'une adresse IP et d'un numéro de port.


(Oracle Express) Outil de la boîte de dialogue Sélecteur permettant de modifier l'ordre des valeurs de dimension dans la sélection affichée. Vous pouvez trier une sélection dans l'ordre croissant ou décroissant, en fonction de l'un des éléments suivants :

•	ordre alphabétique

•	ordre d'apparition dans la base de données

•	valeurs de données

•	ordre ou niveau de hiérarchie

•	période

Vous pouvez également trier une sélection manuellement, en faisant glisser les valeurs de dimension.


Instructions PL/SQL fournies dans un sous-programme ou un package. Vous devez disposer du code source d'une unité de programme pour pouvoir la compiler sous une forme exécutable. Dans Project Builder : types d'entrée nécessaires à la création des types cible.


Définit uniquement les noms, les paramètres et le type de valeur renvoyée (pour les fonctions uniquement) du sous-programme.


Petit rectangle situé au bas de la barre de défilement verticale et à gauche de la barre de défilement horizontale dans un éditeur. Il permet de créer un nouveau panneau à l'aide de la souris et crée une barre de défilement distincte pour chaque panneau.


Interface standard de stockage et d'extraction d'informations dans une base de données relationnelles. SQL est l'acronyme de Structured Query Language.


Fichier contenant une interrogation au format texte (ASCII ou EBCDIC, par exemple).


Fichier contenant des instructions SQL qui permettent d'exécuter rapidement et facilement des fonctions de gestion des bases de données. Les produits Oracle sont livrés avec plusieurs scripts SQL.


Instruction SQL pour Oracle. Une instruction SELECT est un type d'instruction SQL.


Voir pile d'appels.


Elément PL/SQL servant au contrôle conditionnel, itératif et séquentiel, ainsi qu'à la gestion des erreurs. Chaque instruction PL/SQL doit se terminer par un point-virgule (;).


(Oracle Express) Sélection enregistrée contenant les mêmes valeurs de dimension à chaque évaluation. Les sélections statiques enregistrées répertorient les valeurs de dimension à sélectionner, plutôt que les critères de sélection. Par exemple, un script de sélection statique enregistrée peut contenir « Sélectionnez février 1996, mars 1996 et avril 1996 », alors que le script d'une sélection dynamique enregistrée peut indiquer « Sélectionnez les trois derniers mois ».


Procédure, fonction ou package résidant et s'exécutant sur le serveur de base de données Oracle.


Procédure ou fonction résidant et s'exécutant sur le serveur de base de données Oracle.


Extensions HTML fournissant une souplesse de formatage dans les documents HTML. Pour afficher un document HTML avec tous les avantages des feuilles de style, affichez-le dans un navigateur prenant en charge les feuilles de style.


Procédure ou fonction PL/SQL.


Dans Project Builder, projet contenu dans un autre fichier de projet, au lieu d'être stocké dans son propre fichier. Voir aussi : projet.


Dans Project Builder, noeud indiquant un sous-projet. Voir aussi : projet, noeud projet, noeud sous-projet.


Colonne de type récapitulatif calculant des totaux partiels, des totaux globaux, des totaux cumulés et d'autres récapitulatifs des données d'un état, à l'aide des fonctions récapitulatives fournies par Report Builder.


Format de fichier utilisé par le programme Microsoft Excel.


Système ordonné permettant de combiner des commandes, des qualificateurs et des paramètres pour former des chaînes de commande valides.


L'une des variables fournies par Oracle Developer (&Logical Page ou DESTYPE, par exemple).


Ensemble nommé d'informations apparentées, stockées dans une base de données relationnelles ou sur un serveur, dans une grille à deux dimensions composée de lignes et de colonnes.


Type de collecte définissant une unité de données composée d'un ensemble non trié d'éléments dont le type de données est identique. L'unité de données correspondante est une table imbriquée à une seule colonne, dont le type est un type de procédure interne ou un type d'objet. (Oracle8)


Présentation par défaut affichant des libellés en haut de la page et des lignes de données en dessous des libellés.


Dans Project Builder, élément figurant au milieu de l'arborescence des dépendances ; par exemple, un exécutable est une cible (de compilation) pour une bibliothèque, une bibliothèque est une cible pour un groupe d'objets et un objet est une cible pour un fichier source.


Noeud indiquant une cible. Voir aussi : cible.


Acronyme de Transmission Control Protocol. Protocole de communication sous-jacent pour l'échange de demandes HTTP entre clients et serveurs Web.


Sous-menu que l'utilisateur peut sortir de son emplacement d'origine, à l'aide de la souris ou de tout autre périphérique de pointage, puis placer à un autre endroit de l'écran.


Dans Form Builder, élément affichant une valeur de chaîne de caractères.


Zone horizontale située dans la partie supérieure d'une fenêtre, affichant le nom de l'application ou de l'élément d'interface de cette fenêtre.


Voir page de garde.


Activer ou désactiver un paramètre. Vous pouvez, par exemple, afficher ou masquer le Navigateur d'objet.


Bouton portant une icône, servant à créer et à manipuler des objets dans une application.


Ensemble de boutons à icône, permettant d'exécuter des commandes. Ces boutons sont généralement alignés horizontalement dans la partie supérieure de la fenêtre ou verticalement sur le côté de la fenêtre.


Ensemble d'outils.


(Oracle Express) Outil de la boîte de dialogue Sélecteur permettant à l'utilisateur de sélectionner des valeurs de dimension en fonction des premières valeurs de données d'abscisse, des dernières valeurs de données d'ordonnées ou d'une combinaison de ces valeurs. Par exemple, l'utilisateur peut créer une sélection de dimension contenant les produits dont l'élément Volume Sales fait partie des 10 % de produits les plus vendus dans tous les Etats-Unis au cours de la période de quatre semaines se terminant le 30 décembre 1995.


Zone d'état facultative pouvant contenir des informations de clôture de l'état, notamment du texte, des graphiques, des données et des calculs. La page de fin d'état figure en dernier, après la page de garde et le corps.


Séquence d'instructions SQL traitée comme une unité.


Procédure PL/SQL exécutée ou « déclenchée » lors d'un événement particulier.


Description d'un type de fichier (une application Forms, un document, etc.) contenant des informations telles qu'un nom de type et une description. Chaque description ne s'applique qu'à un type de fichier. Il existe en outre quatre métatypes : « updtext » qui s'applique à tous les fichiers texte, « updproj » qui s'applique à tous les fichiers projet, « updlink » qui s'applique à tous les liens de projet et « tous » qui s'applique à tout type de fichier. Les types permettent de définir des actions et des macros.


Modifier des valeurs de données de table, en particulier en modifiant les valeurs de données à l'aide de la commande SQL UPDATE, mais également en supprimant des valeurs à l'aide de la commande SQL DELETE ou en insérant des valeurs à l'aide de la commande INSERT.


Acronyme de Uniform Resource Locator. Adresse utilisée pour indiquer un serveur WWW. Par exemple :
http://www.acme.com/
Cette chaîne indique que l'adresse de l'hôte est www.acme.com. Cette adresse est le plus souvent un nom de fichier, parfois doté d'un long chemin d'accès et généralement accompagné du suffixe de fichier .HTML ou .HTM (pour les noms de fichier DOS).


(user exit) Méthode consistant à passer le contrôle (et parfois des arguments) d'Oracle Developer à un autre produit Oracle ou à un langage de troisième génération, puis à rendre le contrôle (et, éventuellement, renvoyer des arguments) à Oracle Developer.


Action personnalisée définie par un utilisateur de Project Builder. Une action peut s'appliquer à un type de fichier unique ou à tous les types. Voir aussi : action, action prédéfinie.


Voir type d'objet.


Macro personnalisée définie par un utilisateur de Project Builder. Une macro peut permettre de modifier des actions intégrées et des actions définies par l'utilisateur. Voir aussi : macro, macro intégrée, action, action prédéfinie.


Fichier de projet contenant des informations de configuration relatives à un utilisateur. Il permet aux utilisateurs de personnaliser leur environnement de développement. La base de registres utilisateur hérite des informations de type de la base de registres globale et permet de définir de nouveaux types, ainsi que d'ignorer certains aspects des définitions de type stockées dans la base de registres globale. Elle permet également de stocker des informations sur l'environnement et les préférences, comme la chaîne de connexion préférée de l'utilisateur, les paramètres d'interface utilisateur (par exemple, l'option Afficher barre d'outils et certaines informations générales de projet, comme le nom de l'auteur). Voir aussi : base de registres, base de registres globale.


Voir axe continu.


Structure de code PL/SQL renvoyant une valeur. Ces structures comprennent des fonctions et des expressions.


Objet nommé auquel vous pouvez attribuer une valeur, qui sera variable dans le temps.


Type de collecte définissant une unité de données constituée d'un ensemble trié d'éléments dont le type de données est identique. L'unité de données correspondante est un tableau variable ou VARRAY. Le nombre d'éléments d'un VARRAY (taille) est variable. Toutefois, vous devez indiquer une taille maximale lorsque vous déclarez un type de tableau variable.


Extension de fichier Visual Basic utilisée pour les bibliothèques de liens dynamiques réparties sur des fichiers contenant des contrôles VBX prédéfinis.


Widget créé en langage Microsoft Visual Basic et permettant de perfectionner l'interface utilisateur, d'obtenir des entrées utilisateur et d'afficher des sorties (règles, quadrillages et boutons de contrôle, par exemple).


Table virtuelle dont les lignes n'existent pas en réalité dans la base de données, mais qui est fondée sur une table physiquement stockée dans cette base.


Mnémonique de répertoire (principalement un raccourci ou un synonyme) utilisé par le système de fichiers virtuel pour établir la correspondance des fichiers stockés dans le système de fichiers de l'ordinateur hôte.


Mise en correspondance associant les chemins d'accès utilisés dans une URL au système de fichiers mis à jour par le système d'exploitation de l'ordinateur hôte.


Propriétés de police, de couleur et de motif que vous définissez pour les objets affichés dans votre interface d'application.


Voir WWW.


Programme permettant aux utilisateurs de lire des documents HTML et des programmes stockés sur un ordinateur (desservi par un serveur Web).


Programme exécuté sur un serveur Web via Web Request Broker.


Processus serveur (démon HTTP) exécuté sur un site Web, qui renvoie des pages Web en réponse à des demandes HTTP issues de navigateurs Web.


Caractère servant à remplacer « tout caractère » ou « un ensemble de caractères contigus » dans un mot ou une expression.


1. Zone rectangulaire du bureau contenant une application. Chaque fenêtre comporte une zone dans laquelle vous pouvez dialoguer avec l'application. Les fenêtres peuvent être ouvertes, redimensionnées, déplacées, mises en icône ou agrandies pour remplir le bureau.  2. Dans Form Builder, type d'objet pouvant être associé à une vue-canevas.


Format de fichier utilisé par certains tableurs, comme les programmes SQL*Calc ou Lotus 1-2-3.


Acronyme de Web Request Broker Oracle. Offre un environnement d'exécution réparti puissant permettant de développer et de déployer des applications pour le Web. La plate-forme d'exécution WRB permet aux développeurs d'écrire des applications indépendantes des serveurs Web, mais pouvant fonctionner avec un certain nombre de ces serveurs.


Acronyme de World Wide Web. Réseau de serveurs sur Internet, dont chacun possède une ou plusieurs pages d'accueil. Ces pages fournissent des informations et des liens à d'autres documents sur le même serveur et (généralement) sur d'autres.


Développer un objet afin d'agrandir l'espace pour éditer le contenu du champ.


Barre d'outils secondaire, située par défaut le long de la partie supérieure de l'écran du Navigateur de projet, offrant des fonctions simples d'organisation et de lancement d'applications.


 Version la plus récente des contrôles OLE (OCX).


Sortie XML conforme aux principes XML généraux, c'est-à-dire dotée des balises, des imbrications et des inclusions correctes propres à une déclaration XML. Exemple : <?xml version="1.0" encoding="UTF-8"?>.


Un nom utilisateur de réserve permet à l'utilisateur de se connecter à la base de données en utilisant son nom utilisateur personnel au lieu d'utiliser le nom utilisateur correspondant à la base de données Oracle (par exemple, $nom_utilisateur@base_données) lors de l'exécution d'états depuis un navigateur Web.


Acronyme d'Extensible Markup Language. Métalangage qui utilise du code SGML pour définir et structurer les données. Report Builder prend en charge les sorties XML pour permettre la publication sur le Web et l'échange de données électroniques avec des applications tierces. Vous pouvez également utiliser le format XML pour créer des définitions d'état pouvant être exécutées séparément ou fusionnées avec d'autres définitions d'état lors de l'exécution.


Sortie XML dotée d'une structure et d'éléments conformes à une définition de type de document (DTD). Le code XML valide comporte aussi un format correct.


Utilisation de l'aide en ligne

Les instructions suivantes vous aident à utiliser le système d'aide en ligne de manière efficace :

•	Familiarisez-vous avec l'onglet Sommaire pour vous faire une idée de l'étendue des rubriques couvertes par l'aide en ligne.

•	Cliquez sur le bouton Rubriques connexes situé immédiatement en-dessous des titres de rubriques pour obtenir une liste des rubriques apparentées à la rubrique en cours.

•	Cliquez sur le bouton Options en tête de chaque rubrique pour définir l'option Aide en avant-plan, afin que les rubriques d'aide restent à l'écran lorsque vous développez les applications.

•	Cliquez sur le bouton Glossaire en tête de chaque rubrique pour obtenir une définition des termes que vous ne comprenez pas.


A propos de la documentation

Pour débuter et vous familiariser avec la génération d'applications

1	Consultez l'Aperçu produit qui présente brièvement chaque composant :

•	Choisissez Aide [image] Aperçu produit.

2	Faites défiler les Assistants pour apprendre à exécuter les opérations les plus courantes :

•	Choisissez Aide [image] Assistants.

3	Affichez les manuels en ligne (également disponibles sous forme papier) :

•	Choisissez Aide [image] Manuels.

4	Accédez au système d'aide en ligne :

•	Choisissez Aide [image] Rubriques d'aide.

•	Pour afficher une aide contextuelle, appuyez sur [Aide] (touche F1 sur la plupart des plates-formes).


Accueil


Support NLS dans Oracle Developer

  Rubriques connexes

Si vous développez des applications destinées au marché international, vous devez faire en sorte que les utilisateurs puissent utiliser leur langue maternelle et respecter les conventions locales d'affichage des données. Le support NLS (National Language Support) Oracle comporte trois couches principales :

•	prise en charge des systèmes d'encodage de caractères de la langue nationale ;

•	prise en charge des conventions linguistiques et nationales ;

•	traduction de l'interface.

Cette combinaison de prises en charge au niveau du caractère, de l'affichage des données et de l'interface garantit l'utilisation de vos applications dans la plupart des langues parlées en Europe, au Moyen-Orient et en Asie, et notamment l'acceptation des systèmes d'encodage de caractères sur plusieurs octets et de la bidirectionnalité.


Architecture NLS

  Rubriques connexes

Cette architecture se compose de deux parties principales :

•	les fonctions indépendantes de la langue ;

•	les données dépendantes de la langue.

Les fonctions indépendantes de la langue permettent de gérer l'utilisation des données, en fonction de la langue et du pays de l'utilisateur chargé de l'exécution ; elles mettent en forme les données automatiquement, selon les conventions locales de date et d'heure.

L'isolation des données dépendantes de la langue permet à votre application de ne gérer que la traduction de ses propres chaînes.


Variables d'environnement NLS

  Rubriques connexes

Vous pouvez utiliser les paramètres suivants comme variables d'environnement pour indiquer les paramètres linguistiques employés par Oracle Developer :

Parameter	Description
NLS_CALENDAR	Calendrier utilisé
NLS_CREDIT	Chaîne utilisée pour indiquer une valeur monétaire positive
NLS_CURRENCY	Symbole monétaire local
NLS_DATE_FORMAT	Format de date par défaut
NLS_DATE_LANGUAGE	Langue par défaut utilisée pour les dates
NLS_DEBIT	Chaîne utilisée pour indiquer une valeur monétaire négative
NLS_ISO_CURRENCY	Symbole monétaire ISO
NLS_LANG	Paramètres linguistiques utilisés par Oracle Developer
DEVELOPER_NLS_LANG	Langue des générateurs Oracle Developer
USER_NLS_LANG	Langue du composant Runtime d'Oracle Developer
NLS_LIST_SEPARATOR	Caractère utilisé pour séparer les éléments d'une liste
NLS_MONETARY_CHARACTERS	Séparateurs décimal et des milliers des valeurs monétaires
NLS_NUMERIC_CHARACTERS	Séparateurs décimal et des milliers des valeurs numériques
NLS_SORT	Type de tri utilisé pour les caractères

Pour plus d'informations sur ces paramètres, reportez-vous au manuel Oracle8 Reference.


Variable d'environnement NLS_LANG

  Exemples	  Rubriques connexes

Cette variable permet de définir les paramètres linguistiques employés par Oracle Developer.

NLS_LANG indique les éléments suivants :

•	la langue des messages que l'utilisateur reçoit, par exemple le message signalant un traitement en cours ;

•	les masques de format par défaut utilisés pour les dates et les nombres ;

•	la séquence de tri ;

•	le jeu de caractères.

La syntaxe de la variable NLS_LANG est la suivante :

NLS_LANG=langue_pays.jeudecaractères

où :

language	Langue ainsi que ses conventions pour l'affichage des messages et des noms de jour et de mois. Si aucune langue n'est indiquée, la valeur utilisée par défaut est American.
territory	Fait référence au pays et aux conventions correspondantes pour le format de date par défaut, le séparateur décimal des nombres et le symbole monétaire, et la numérotation des semaines et des jours. Si aucun pays n'est indiqué, la valeur utilisée par défaut est America.
jeudecaractères	Fait référence au jeu de caractères utilisé pour représenter les données. Il doit correspondre à la langue et à la plate-forme que vous utilisez. Cet argument contrôle également le jeu de caractères qui sert à afficher les messages.

Pour plus d'informations sur le paramètre NLS_LANG, reportez-vous au manuel Oracle8 Reference.


Variables d'environnement DEVELOPER_NLS_LANG et USER_NLS_LANG

  Exemples	  Rubriques connexes

Dans la plupart des cas, il suffit de définir une seule valeur pour NLS_LANG. Cependant, si vous devez utiliser simultanément deux jeux de fichiers de ressources et de messages sur le même ordinateur, deux autres variables d'environnement sont à votre disposition :

•	DEVELOPER_NLS_LANG, qui indique la langue du générateur du produit ;

•	USER_NLS_LANG, qui indique la langue du composant Runtime du produit.

La syntaxe de DEVELOPER_NLS_LANG et de USER_NLS_LANG est la même que celle de NLS_LANG.

A la place de cette variable, utilisez DEVELOPER_NLS_LANG et USER_NLS_LANG dans les cas suivants :

•	Vous préférez utiliser le générateur en anglais, mais vous développez une application dans une autre langue.

•	Vous créez une application à exécuter dans une langue qui utilise un jeu de caractères bidirectionnels.

•	Vous créez une application à exécuter dans une langue pour laquelle une version locale du générateur n'est pas disponible.

Remarque : Si ces variables d'environnement ne sont pas explicitement paramétrées, les valeurs par défaut de NLS_LANG sont utilisées.

Pour plus d'informations sur le paramètre NLS_LANG, reportez-vous au manuel Oracle8 Reference.


Définition des variables d'environnement NLS_LANG

  Exemples	  Rubriques connexes

Pour paramétrer les variables d'environnement NLS_LANG :

 Définissez les valeurs de ces variables comme vous définiriez d'autres variables d'environnement dans votre système d'exploitation de base, en respectant les règles propres à cette plate-forme (longueur de chemin d'accès, etc.).

Par exemple, pour paramétrer la variable NLS_LANG pour Microsoft Windows NT :

1	Dans le menu Démarrer, sélectionnez Exécuter.

2	Entrez « regedit », puis cliquez sur OK pour ouvrir l'éditeur de base de registres.

Remarque : Toute modification a une incidence sur la base de registres de Windows. Ne modifiez les variables d'environnement qu'en cas de nécessité absolue. Si vous vous êtes trompé, cliquez sur Annuler, puis recommencez.

1	Développez les noeuds HKEY_LOCAL_MACHINE, puis SOFTWARE.

2	Cliquez sur ORACLE pour afficher les variables d'environnement Oracle dans le panneau de droite de l'éditeur de base de registres.

3	Cliquez deux fois sur la variable d'environnement NLS_LANG.

4	Dans la zone de texte Données de la valeur, entrez une nouvelle valeur pour cette variable, puis cliquez sur OK.

Remarque : Pour utiliser une fonction NLS, vous devez au moins paramétrer la variable NLS_LANG de façon à ce qu'Oracle Developer puisse repérer les composants NLS.


Création d'alias de police sur les plates-formes Windows

  Rubriques connexes

Dans certains cas, vous créez une application en utilisant une police particulière, mais vous découvrez qu'une autre police est utilisée à l'exécution de cette application. Vous risquez de rencontrer ce problème lorsque vous employez une police anglaise, telle que MS Sans Serif ou Arial, dans un environnement non européen. Cela est dû au fait qu'Oracle Developer vérifie si le jeu de caractères associé à cette police correspond à celui indiqué par la variable d'environnement de langue. S'ils ne correspondent pas, Oracle Developer remplace automatiquement la police choisie par une autre dont le jeu de caractères correspond à celui de cette variable. Ainsi, dans l'application, la netteté de l'affichage des données renvoyées depuis la base de données est garanti.

Remarque : Si vous saisissez des caractères locaux utilisant une police anglaise, Windows les associe à une autre police de façon implicite.

Toutefois, il peut parfois être nécessaire de ne pas effectuer ce remplacement. Pour l'éviter, mettez en correspondance toutes les polices voulues avec le jeu de caractères WE8ISO8859P1 du fichier d'alias de police. Par exemple, si vous ne pouvez pas employer la police Arial dans votre application, ajoutez la ligne suivante à ce fichier :

Arial.....=Arial...WE8ISO8859P1


Jeux de caractères Microsoft Windows pris en charge

Jeu de caractères	Description
AR8MSWIN1256	Latin/arabe MS Windows sur 8 bits (page de codes 1256)
BG8MSWIN	Alphabet cyrillique bulgare MS Windows sur 8 bits
CL8MSWIN1251	Latin/alphabet cyrillique MS Windows sur 8 bits (page de codes 1251)
EE8MSWIN1250	Langues d'Europe de l'Est MS Windows sur 8 bits (page de codes 1250)
EL8MSWIN1253	Latin/grec MS Windows sur 8 bits (page de codes 1253)
ET8MSWIN923	Estonien MS Windows sur 8 bits (page de codes 923)
IW8MSWIN1255	Latin/hébreu MS Windows sur 8 bits (page de codes 1255)
JA16SJIS	Japonais sur 16 bits (Maj-JIS)
KO16KSC5601	Coréen sur 16 bits (KSC5601)
LT8MSWIN921	Lituanien MS Windows sur 8 bits (page de codes 921)
TH8TISASCII	Thaïlandais - Norme standard 620-2533, ASCII 8 bits
WE8ISO8859P1	Europe de l'Ouest - Norme ISO 8859-1
ZHS16CGB231280	Chinois simplifié sur 16 bits (CGB2312-80)
ZHT16BIG5	Chinois traditionnel sur 16 bits (BIG5)


Jeux de caractères arabes pris en charge

ID	Jeu de caractères	Description
61	AR8ASMO708PLUS	Latin/arabe sur 8 bits - ASMO 708 Plus Client
72	AR8XBASIC	Latin/arabe sur 8 bits - Client EBCDIC XBASIC
504	AR8NAFITHA711T	Latin/arabe sur 8 bits - Nafitha Enhanced 711 Client
505	AR8SAKHR707T	Latin/arabe sur 8 bits - Client SAKHR 707
506	AR8MUSSAD768T	Latin/arabe sur 8 bits - Client Mussa'd Alarabi/2 768
507	AR8ADOS710T	Latin/arabe sur 8 bits - Client MS-DOS 710 (arabe)
508	AR8ADOS720T	Latin/arabe sur 8 bits - Client MS-DOS 720 (arabe)
509	AR8APTEC715T	Latin/arabe sur 8 bits - Client APTEC 715
511	AR8NAFITHA721T	Latin/arabe sur 8 bits - Client Nafitha International 721
514	AR8HPARABIC8T	Latin/arabe sur 8 bits - Client HP ARABIC8
567	AR8ARABICMACT	Latin/arabe sur 8 bits - Client Macintosh


Conventions linguistiques et nationales

  Rubriques connexes

Tandis que les systèmes d'encodage de caractères garantissent la disponibilité des caractères de chaque langue, le support des conventions nationales permet l'affichage correct des données traduites.

La langue indiquée définit les conventions par défaut des caractéristiques suivantes :

•	la langue des messages du serveur ;

•	la langue des noms de jour et de mois, ainsi que les abréviations correspondantes indiquées dans les fonctions SQL TO_CHAR et TO_DATE ;

•	les symboles des instances correspondantes d'AM, de PM, d'AD et de BC ;

•	la séquence de tri par défaut des caractères lorsque la clause ORDER BY est indiquée (GROUP BY utilise un type de tri binaire, à moins que cette clause ne soit mentionnée) ;

•	le sens de l'écriture ;

•	les chaînes de réponse affirmatives ou négatives.

Par exemple, si la langue est paramétrée sur Français, les messages suivants :

ORA-00942:  table or view does not exist
FRM-10043:  Cannot open file.

sont traduits comme suit :

ORA-00942: table ou vue inexistante
FRM-10043: Ouverture de fichier impossible.

Le pays indiqué définit les conventions des caractéristiques de format de nombres et de date par défaut suivantes :

•	le format de date ;

•	les séparateurs décimal et des milliers ;

•	le symbole monétaire local ;

•	le symbole monétaire ISO ;

•	le premier jour de la semaine ;

•	le symbole de crédit et de débit ;

•	l'indicateur de semaine ISO ;

•	le séparateur de listes.

Par exemple, si le pays est paramétré sur France, le séparateur décimal des nombres est une virgule.


Langues prises en charge

Abréviation	Langue
us	Anglais (Etats-Unis)
ar	Arabe
bn	Bengali
ptb	Portugais (Brésil)
bg	Bulgare
frc	Français (Canada)
ca	Catalan
hr	Croate
cs	Tchèque
dk	Danois
nl	Néerlandais
eg	Egyptien
gb	Anglais (Royaume-Uni)
et	Estonien
sf	Finlandais
f	Français
d	Allemand
din	Allemand (normes DIN)
el	Grec
iw	Hébreu
hu	Hongrois
is	Islandais
in	Indonésien
n	Italien
ja	Japonais
ko	Coréen
esa	Espagnol (Amérique latine)
lv	Letton
lt	Lituanien
ms	Malais
esm	Espagnol (Mexique)
n	Norvégien
pl	Polonais
pt	Portugais
ro	Roumain
ru	Russe
zhs	Chinois simplifié
sk	Slovaque
sl	Slovène
e	Espagnol
s	Suédois
th	Thaïlandais
zht	Chinois traditionnel
tr	Turc
uk	Ukrainien
vn	Vietnamien

Remarque : Le fait qu'une langue soit prise en charge n'implique pas nécessairement qu'une traduction soit disponible.


Pays pris en charge

Algérie	Grèce	Portugal
Amérique	Hong Kong	Qatar
Autriche	Hongrie	Roumanie
Bahreïn	Islande	Arabie saoudite
Bangladesh	Irak	Slovaquie
Brésil	Israël	Slovénie
Bulgarie	Italie	Somalie
Canada	Japon	Espagne
Catalogne	Jordanie	Soudan
Chine	Corée	Suède
CEI	Koweït	Suisse
Croatie	Lettonie	Syrie
Chypre	Liban	Taiwan
République tchèque	Libye	Thaïlande
Tchécoslovaquie	Lituanie	Pays-Bas
Danemark	Malaisie	Tunisie
Djibouti	Mauritanie	Turquie
Egypte	Mexique	Ukraine
Estonie	Maroc	Emirats arabes unis
Finlande	Norvège	Royaume-Uni
France	Oman	Vietnam
Allemagne	Pologne	Yémen


Support bidirectionnel dans Oracle Developer

  Rubriques connexes

Le support NLS des langues du Moyen-Orient et d'Afrique du Nord comprend le support bidirectionnel des langues qui s'écrivent de droite à gauche.

Le support bidirectionnel permet aux développeurs de contrôler les éléments suivants :

•	l'orientation de la mise en page, notamment l'affectation des libellés à droite des éléments, et le positionnement correct des cases à cocher et des boutons d'option ;

•	la séquence de lecture, notamment l'orientation du texte de droite à gauche, ou vice versa ;

•	l'alignement, notamment la définition du point d'origine à partir de la gauche ou de la droite ;

•	la définition de l'état initial du clavier, qui permet de contrôler la création automatique des caractères locaux ou romains lorsque l'utilisateur final saisit les données dans une application Forms (il peut remplacer ce paramètre).

Les applications bidirectionnelles peuvent utiliser non seulement la variable d'environnement NLS_LANG, mais aussi deux autres variables d'environnement :

•	DEVELOPER_NLS_LANG

•	USER_NLS_LANG

Par exemple, pour utiliser une interface en anglais américain tout en développant une application en arabe dans un environnement Windows, paramétrez ces variables d'environnement de la manière suivante :

DEVELOPER_NLS_LANG=AMERICAN_AMERICA.AR8MSWIN1256
USER_NLS_LANG=ARABIC_pays.jeudecaractères


Support bidirectionnel dans Form Builder

  Rubriques connexes

Cinq propriétés permettent de définir l'apparence des objets dans les applications bidirectionnelles : Orientation, Justification, Séquence de lecture, Etat clavier et Etat initial clavier.

Orientation est une propriété générale dotant chaque objet d'autant de fonctions que possible. Pour tous les objets, à l'exception des éléments de texte et d'affichage, elle constitue l'unique propriété bidirectionnelle ; ce paramètre contrôle les autres aspects de la fonction bidirectionnelle. (Toutefois, les éléments de la liste comprennent les propriétés Etat initial clavier et Etat clavier.)

La propriété Orientation n'est pas disponible pour les éléments de texte et d'affichage. A la place, vous pouvez paramétrer de manière spécifique les propriétés Justification, Séquence de lecture, Etat initial clavier et Etat clavier.

Vous pouvez limiter l'état du clavier à une seule langue. Par exemple, si vous paramétrez Etat clavier sur Local, l'utilisateur final ne peut pas employer d'autre langue.

Lorsque les propriétés bidirectionnelles sont définies sur Par défaut, elles héritent leurs valeurs du sens naturel d'écriture indiqué par la variable d'environnement de la langue. Dans la plupart des cas, cette solution offre la fonctionnalité voulue. Il suffit d'indiquer des propriétés bidirectionnelles pour remplacer les valeurs par défaut héritées.

L'héritage des propriétés bidirectionnelles est le suivant :

	Le paramètre par défaut dérive sa valeur de l'objet suivant
Form	Variable d'environnement de la langue
Tous les objets, et notamment : Message d'alerte, Bloc, LOV, Fenêtre et Vue-canevas	Form
Tous les éléments, et notamment : Elément texte, Elément affiché, Case à cocher, Bouton, Groupe de boutons et Elément liste	Vue-canevas

La plupart des propriétés liées à la fonction bidirectionnelle peuvent être récupérées et paramétrées par programme. Pour plus d'informations, reportez-vous à la description du sous-programme intégré correspondant. Par exemple, pour en savoir plus sur l'obtention de la valeur de la propriété Orientation pour les boutons, reportez-vous à la description de GET_ITEM_PROPERTY.


Support bidirectionnel dans Report Builder

  Rubriques connexes

Trois propriétés permettent de définir l'apparence des objets dans les applications bidirectionnelles : Justification, Orientation (pour un objet) et Orientation (pour l'état). Les propriétés bidirectionnelles sont ajoutées aux objets dans l'ordre suivant :

Module,

Objet standard,

Champ,

Objet standard externe,

Bouton,

Objet standard de grille de paramètres.

Les objets ne figurant pas dans cette liste ne requièrent pas de support bidirectionnel (par exemple, les images) ou utilisent la valeur par défaut de l'une des propriétés d'objet ci-dessus.


Support du jeu de caractères Unicode dans Oracle Developer

  Rubriques connexes

Unicode est un jeu de caractères universel permettant d'afficher un texte multilingue dans une même application. Ainsi, les multinationales peuvent développer une même application en plusieurs langues pour l'utiliser dans le monde entier.

Les marchés mondiaux requièrent un jeu de caractères satisfaisant aux critères suivants :

•	être assez simple pour être utilisé dans n'importe quel pays et permettre la création standard d'un produit dans toutes les langues ;

•	contenir tous les principaux scripts existants ;

•	prendre en charge utilisateurs et organisations multilingues ;

•	permettre l'échange d'informations via le réseau Internet mondial.

Oracle Developer prend en charge le jeu de caractères Unicode. Si vous utilisez ce dernier, vous pouvez afficher dans la même application plusieurs langues sur un octet, par exemple celles de l'Europe de l'Est et de l'Ouest, ou du Moyen-Orient (type bidirectionnel), ainsi que les langues asiatiques sur plusieurs octets, telles que le chinois, le japonais et le coréen.

Si vous employez un jeu de caractères unique pour toutes les langues, vous n'avez pas besoin d'en définir un pour chaque langue.

Par exemple, pour afficher une langue sur plusieurs octets comme le japonais, la variable d'environnement NLS_LANG doit être paramétrée de la manière suivante (pour les plates-formes Windows) :

Japan_Japanese.JA16SJIS

Pour afficher une langue sur un octet comme l'allemand, la variable d'environnement NLS_LANG doit être paramétrée de la manière suivante (pour les plates-formes Windows) :

German_Germany.WE8ISO8859P1

Naturellement, l'inconvénient de ce système est que les applications ne peuvent afficher qu'un jeu de caractères à la fois. Il n'est pas possible d'utiliser plusieurs jeux de caractères.

Le jeu de caractères Unicode vous permet de paramétrer le jeu de caractères de NLS_LANG sur UTF8 au lieu d'un jeu de caractères de langue précis. Ainsi, les caractères propres à différents jeux de caractères et langues apparaissent simultanément.

Par exemple, pour afficher un texte en japonais et en allemand, la variable d'environnement NLS_LANG doit être paramétrée de la manière suivante :

Japanese_Japan.UTF8

ou

German_Germany.UTF8

La fonction Unicode d'Oracle Developer permet au développeur et à l'utilisateur final d'afficher un texte multilingue dans une application Forms. Ce texte peut provenir du Presse-papiers ou d'une base de données dont les objets de l'interface utilisateur graphique contiennent un texte Unicode multilingue (par exemple, les libellés des boutons), ou être saisi à l'aide du clavier. Actuellement, Oracle Developer prend en charge le jeu de caractères Unicode sous Windows NT 4.0 et sous Windows 95/98 (prise en charge limitée).

Remarque : Si vous développez plusieurs applications Web, vous pouvez utiliser le jeu de caractères Unicode, car il est pris en charge par Java.


Notes concernant la configuration

  Rubriques connexes

Les serveurs UNIX peuvent prendre en charge plusieurs répertoires ORACLE_HOME (où ORACLE_HOME est le répertoire créé par et pour les programmes Oracle) et, par conséquent, différents paramètres NLS. Cela signifie qu'un même serveur UNIX peut prendre en charge plusieurs langues.

Toutefois, Windows NT ne peut prendre en charge qu'un seul répertoire ORACLE_HOME et ne peut donc être doté que d'un paramètre NLS, c'est-à-dire qu'il ne peut prendre en charge qu'une seule langue.


Prise en charge des polices Unicode

  Rubriques connexes

Pour afficher un texte Unicode multilingue, vous devez utiliser une police constituée des glyphes (ou caractères des langues à faire apparaître). Sous Windows NT et sous Windows 95/98, vous devez employer les « grandes polices » TrueType fournies par Microsoft ou la police Unicode d'un fabricant tiers. Si, lorsque vous essayez de saisir, d'afficher ou d'imprimer un texte multilingue, des caractères inattendus apparaissent, vous n'utilisez peut-être pas une grande police. Les grandes polices Microsoft disponibles sous Windows NT 4.0 sont les suivantes :

•	Arial

•	Courier New

•	Lucida Console

•	Lucida Sans Unicode

•	Times New Roman

Une police fournie par un fabricant tiers peut être employée si les grandes polices Windows ne correspondent pas à vos besoins.


Activation de la prise en charge du jeu de caractères Unicode

  Rubriques connexes

Dans Oracle Developer, pour activer la prise en charge du jeu de caractères Unicode, paramétrez la variable NLS_LANG de la manière suivante :

NLS_LANG=langue_pays.UTF8


Conversion des jeux de caractères

  Rubriques connexes

Lorsque vous créez des applications à utiliser dans plusieurs langues, il est nécessaire de tenir compte des jeux de caractères employés respectivement par les utilisateurs finals et par les développeurs. Au cours de l'exécution, la conversion au niveau des jeux de caractères est automatique ; elle a une incidence sur les performances.

Par exemple, si vous créez une application à l'aide d'un jeu de caractères et que vous l'exécutiez via un autre, vous pouvez noter que les performances sont plus faibles. En outre, si l'un des jeux de caractères ne contient pas l'équivalent d'un caractère d'un autre jeu, un caractère de substitution apparaît à la place, par exemple un point d'interrogation (?). Cependant, même si vous n'observez pas de différence notable, vous devez en tant que développeur prêter attention aux jeux de caractères que vous utilisez lors de la création d'une application pour conserver les mêmes.

Remarque : Oracle Developer ne convertit que les jeux de caractères de la même langue, tels que AR8MSWIN et AR8ISO, ou IW8MSWIN et IW8ISO.

Si vous développez des applications devant s'exécuter dans plusieurs langues, ou même dans une seule, mais avec des jeux de caractères différents, vous devez adapter votre environnement de génération à votre environnement d'exécution afin d'optimiser les performances. Pour cela :

•	Définissez le jeu de caractères le plus souvent utilisé au cours de l'exécution.

•	Créez vos applications en paramétrant la variable d'environnement de la langue sur ce jeu de caractères.

Remarque : Dans Form Builder, le même jeu de caractères est utilisé lors du développement et pendant l'exécution des applications, quel que soit celui indiqué dans l'environnement d'exécution.


Interface utilisateur Oracle Developer

  Rubriques connexes

Oracle utilise le même exécutable pour internationaliser ses programmes. En d'autres termes, vous n'avez pas besoin d'employer d'autre exécutable, par exemple f60des.exe, afin de traiter les langues européennes sur un octet ou les langues asiatiques sur plusieurs octets. Les mêmes outils peuvent être utilisés pour créer des applications dans diverses langues, dont l'anglais.

Remarque : Oracle Developer utilise le système d'exploitation Microsoft Windows pour définir les polices et méthode de saisie des diverses langues. Pour entrer et afficher un texte dans une langue, vous devez exécuter une version de Windows la prenant en charge. Par exemple, pour le thaïlandais, il s'agit de la version de Windows dans cette langue.

Lors de l'installation d'Oracle Developer, vous sélectionnez la langue des fichiers de messages à installer. Lorsque vous utilisez un composant Oracle Developer, tel que Form Builder, le fichier de messages correspondant est utilisé, selon la variable d'environnement de la langue employée, pour afficher l'interface, et notamment les éléments suivants :

•	les messages ;

•	les menus et leurs options ;

•	les boîtes de dialogue ;

•	les invites et les messages d'aide ;

•	les messages d'alerte.

Si Oracle Developer ne trouve pas de fichier de messages correspondant au paramètre linguistique choisi, il utilise par défaut les fichiers de messages en anglais américain.

Remarque : Lors de l'installation, vous ne pouvez indiquer qu'une seule langue pour installer les fichiers de messages, outre ceux en anglais américain. Si vous souhaitez ultérieurement exécuter la version d'Oracle Developer dans une autre langue, il est nécessaire de réinstaller ce programme à l'aide des fichiers de messages correspondants.

La convention de dénomination des fichiers de messages fait référence au composant Oracle Developer et à la langue concernés, au format suivant :

<id_produit><id_langue>.MSB

Par exemple, dans Form Builder :

FMDUS.MSB contient les messages par défaut (en anglais américain) de Builder.

FMGUS.MSB contient les messages par défaut (en anglais américain) de Generate.

FMFUS.MSB contient les messages par défaut (en anglais américain) de Runform.

FMFI.MSB contient les messages en italien de Runform.

FMFD.MSB contient les messages en allemand de Runform.

Pour plus d'informations sur l'installation du fichier de messages dépendants de la langue, reportez-vous au guide d'utilisation et d'installation de votre plate-forme.

Remarque : Les modules de langue supplémentaires ne sont pas compatibles en aval. Ils sont uniquement conçus pour la version d'Oracle Developer avec laquelle ils ont été fournis. Si vous disposez de versions précédentes dotées de ces modules, supprimez-les du système.


Utilisation de CONVERT pour la conversion des données

Vous pouvez utiliser la fonction SQLCONVERT pour convertir des jeux de caractères. Elle convertit la représentation binaire d'une chaîne d'un jeu de caractères vers un autre. Pour plus d'informations sur ce type de conversion, reportez-vous à Conversion des jeux de caractères.

Pour obtenir la description complète de CONVERT, reportez-vous au manuel Oracle8 SQL Reference.


Masques de format par défaut

  Exemples	  Rubriques connexes

La variable d'environnement ne définit pas seulement la langue de l'interface Oracle Developer, mais aussi l'ensemble des masques de format par défaut utilisés pour afficher les données, à moins que ces derniers ne soient remplacés par des masques de format explicites. En tant que développeur d'applications, vous disposez également d'autres caractères de masque de format NLS, si vous choisissez de remplacer les masques d'affichage par défaut.

Les masques de format par défaut associés au pays indiqué sont employés pour toute saisie de données dans Oracle Developer ou dans l'application, de façon à ce que vous puissiez changer de langue lorsque vous développez et exécutez une application, sans avoir à modifier les formats de nombres et de date.

Oracle Developer utilise notamment les masques de format par défaut :

•	dans le générateur, lorsqu'il affiche les valeurs par défaut des éléments, des plages ou des paramètres ;

•	au cours de l'exécution, si un utilisateur entre des données dans un élément texte dont le type varie en fonction du pays, tel que DATE ou NUMBER.

Pour les champs de date et de devise des applications multilingues, vous devrez décider :

•	d'agrandir ou non tous les éléments affichés (objets standard, éléments texte, ou objets d'interface, tels que les boutons et les listes de valeurs) pour que les conventions de traduction des valeurs numériques et celles propres à chaque langue tiennent dans la zone d'affichage.

•	d'utiliser les caractères NLS pour créer des masques de format spéciaux ou de conserver ceux par défaut appelés par la variable NLS_LANG, considérés comme suffisants.


Conseil
Pour les conversions de type de données implicites, PL/SQL s'attend toujours à lire des éléments au format par défaut America (par exemple, JJ-MOI-AA). Si vous utilisez un élément dont le type est propre à un pays dans PL/SQL, vous devez donc indiquer les masques de format appropriés. Oracle conseille d'utiliser TO_DATE pour traduire les éléments propres à un pays dans PL/SQL.

IF :emp.hiredate < TO_DATE(’30-12-1996’,’DD-MM-YYYY’) THEN
   ...


Caractères de masque de format

  Exemples	  Rubriques connexes

Les caractères de masque de format suivants vous permettent de remplacer les masques de format par défaut :

Caractères de masque de format de date

Caractère	Retourne
D	Chiffre correspondant au jour (1-7)
JO	Nom du jour (abrégé)
JOUR	Nom du jour (rempli de blancs jusqu'à concurrence de 9 caractères)
SS	Chiffre correspondant à la semaine, calculé par l'algorithme int((jour-jan1)/7)
SI	Chiffre correspondant à la semaine ISO
MOI	Nom du mois (abrégé)
MOIS	Nom du mois (rempli de blancs jusqu'à concurrence de 9 caractères)
MR	Nombre en chiffres romains correspondant au mois
I, IA, IAA, IAAAA	Dernier, deux derniers ou trois derniers chiffres de l'année ISO ou année ISO, respectivement
BC, AD, B.C., A.D.	Indicateur BC ou AD (avec ou sans point)
AM, PM, A.M., P.M.	Indicateur AM ou PM (avec ou sans point)
Pour plus d'informations sur l'ISO (International Standards Organization) et ses masques de format de date, reportez-vous au manuel Oracle Server SQL Reference.

Caractères de masque de format numérique

Caractère	Retourne
C	Symbole monétaire international
L	Symbole monétaire local
D	Séparateur décimal
G	Séparateur de groupe (milliers)


Tri des caractères

  Restrictions	  Exemples	  Rubriques connexes

Par convention, lorsque les caractères sont triés, la séquence de tri est définie selon la valeur numérique des caractères, définie par le système d'encodage. Ce type de tri est dit « binaire » ; il génère des résultats raisonnables pour l'alphabet anglais, car les normes ASCII et EBCDIC définissent les lettres A à Z en valeurs numériques croissantes. Remarque

Toutefois, lorsque les caractères des autres langues sont utilisés, le fait de les trier au format binaire ne permet généralement pas d'obtenir de tels résultats. Par exemple, une interrogation ORDER BY ascendante renvoie les chaînes de caractères ABC, ABZ, BCD et ÄBC, dans cet ordre, lorsqu'une valeur numérique supérieure à celle de B est affectée à Ä dans le système d'encodage des caractères.

Pour créer une séquence de tri correspondant à la séquence alphabétique des caractères d'une langue, une autre technique doit être utilisée de façon à ce que ces caractères soient triés indépendamment de leur valeur numérique dans le système d'encodage. Cette méthode, appelée « tri linguistique », consiste à remplacer les caractères par d'autres valeurs binaires faisant référence à l'ordre linguistique correct pour que le tri binaire renvoie les résultats voulus.

Caractères linguistiques spéciaux : Séquences de caractères à utiliser en tant que caractère unique pendant le tri. Ces caractères sont gérés automatiquement lorsque vous procédez à un tri linguistique. Par exemple, l'une des séquences de tri linguistiques en espagnol indique que les doublons « ch » et « ll » sont triés en tant que caractères uniques, compris respectivement entre « c » et « d », et entre « l » et « m ».

Le caractère « ß » constitue un autre exemple en allemand. Dans cette langue, cette séquence peut être triée en tant que doublon « SS », alors qu'elle l'est en tant que caractère « SZ » en anglais américain.

Ces caractères spéciaux sont également gérés lors de la conversion de majuscules en minuscules, et vice versa. Par exemple, en allemand, le symbole « ß », mis en majuscules, devient le doublon « SS ». Ces problèmes de conversion de caractères sont traités par les fonctions NLS_UPPER, NLS_LOWER et NLS_INITCAP, selon les conventions établies par la séquence de tri linguistique. (Les fonctions standard UPPER, LOWER et INITCAP ne gèrent pas ces caractères spéciaux.)

Fonction NLSSORT : Vous pouvez utiliser la fonction SQL NLSSORT pour trier des caractères. Elle remplace une chaîne de caractères par la chaîne de tri correspondante employée par la fonctionnalité de tri. Dans le cas d'un tri binaire, la chaîne de tri est la même que la chaîne d'entrée. Lorsqu'un tri linguistique est effectué, NLSSORT retourne les valeurs binaires utilisées pour remplacer la chaîne d'origine.


Remarque
En mode ASCII standard, toutes les majuscules précèdent les minuscules. Il se passe le contraire en mode EBCDIC standard : les majuscules suivent toutes les minuscules.


Tri linguistique - Limites

  Rubriques connexes

Le tri linguistique n'est pas pris en charge pour les jeux de caractères sur plusieurs octets.


Comparaison de chaînes dans une clause WHERE

  Exemples	  Rubriques connexes

Les chaînes de caractères d'une clause WHERE sont comparées sur la base de leur valeur binaire : un caractère est « supérieur à » un autre si une valeur binaire plus élevée lui est affectée dans le jeu de caractères de la base de données. En général, les comparaisons effectuées ne respectent pas les conventions alphabétiques, étant donné que la séquence de caractères définie en fonction de ces valeurs binaires risque de ne pas correspondre à la séquence alphabétique de la langue choisie. Utilisez la fonction NLSSORT, pour réaliser un tri linguistique et non binaire.


Contrôle d'une clause ORDER BY

  Rubriques connexes

Dans le cas d'une séquence de tri linguistique, NLSSORT est utilisé implicitement sur chaque élément de type caractère de la clause ORDER BY. Le système de tri (linguistique ou binaire) appliqué à cette clause est donc transparent pour l'application.

Cependant, si la fonction NLSSORT est explicitement indiquée pour un élément de type caractère dans une clause ORDER BY, la fonction NLSSORT implicite n'est pas exécutée. En d'autres termes, le remplacement linguistique via NLSSORT n'est appliqué qu'une fois, et non deux.

La fonction NLSSORT n'est généralement pas nécessaire dans une clause ORDER BY, lorsque le tri par défaut est linguistique. Cependant, lorsque ce dernier est binaire, une interrogation du type :

SELECT ENAME FROM EMP

ORDER BY ENAME

utilise un tri binaire. Pour un tri linguistique (pour l'allemand, dans l'exemple ci-dessous), employez en l'occurrence :

SELECT ENAME FROM EMP

ORDER BY NLSSORT(ENAME, 'NLS_SORT = GERMAN)


Utilisation d'ALTER SESSION

  Exemples	  Rubriques connexes

Vous pouvez utiliser la commande SQL ALTER SESSION pour remplacer les valeurs NLS par défaut. Par exemple, supposez que vous créez plusieurs paramètres, tels que la langue, le pays, etc., et qu'un utilisateur définit les valeurs correspondantes : vous pouvez modifier la session selon les valeurs choisies.

Remarque : Lors de l'exécution, le serveur exécute pour le client une commande ALTER SESSION qui utilise les valeurs indiquées dans NLS_LANG. Si NLS_LANG n'est pas défini, l'instruction ALTER SESSION n'est pas exécutée.

Dans Form Builder, vous pouvez indiquer l'un des paramètres NLS ci-dessous pour la commande ALTER SESSION. Cependant, pour Report Builder et Graphics Builder, vous ne pouvez préciser que le paramètre NLS_SORT.

Parameter	Description
NLS_LANGUAGE	Langue utilisée par le serveur pour les messages et les erreurs
NLS_TERRITORY	Pays utilisé pour les masques de date et de devise par défaut
NLS_DATE_FORMAT	Format par défaut utilisé pour les dates
NLS_DATE_LANGUAGE	Langue par défaut utilisée pour les dates
NLS_NUMERIC_CHARACTERS	Séparateur de groupes et de caractères décimaux
NLS_ISO_CURRENCY	Symbole monétaire international ISO
NLS_CURRENCY	Symbole monétaire local
NLS_SORT	Séquence de tri de caractères
NLS_CALENDAR	Calendrier en cours

Pour plus d'informations sur ces paramètres, reportez-vous au manuel Oracle8 SQL Reference.


Utilisation des paramètres NLS dans les fonctions SQL

  Rubriques connexes

Lorsque vous utilisez SQL, vous pouvez remplacer par les paramètres NLS décrits ci-dessous les paramètres NLS par défaut.

Fonction SQL	Paramètre(s) NLS
TO_DATE	NLS_DATE_LANGUAGE NLS_CALENDAR
TO_NUMBER	NLS_NUMERIC_CHARACTERS NLS_CURRENCY NLS_ISO_CURRENCY
TO_CHAR	NLS_DATE_LANGUAGE NLS_NUMERIC_CHARACTERS NLS_CURRENCY NLS_ISO_CURRENCY NLS_CALENDAR
NLS_UPPER	NLS_SORT
NLS_LOWER	NLS_SORT
NLS_INITCAP	NLS_SORT
NLSSORT	NLS_SORT

Pour plus d'informations sur ces paramètres, reportez-vous au manuel Oracle8 SQL Reference.


Paramètres NLS de Form Builder

  Rubriques connexes

Vous pouvez utiliser les fonctions intégrées de Form Builder pour obtenir la valeur courante des variables d'environnement NLS pour l'utiliser dans un code PL/SQL :

	DEVELOPER_NLS_LANG,	USER_NLS_LANG
Procédure interne	GET_FORM_PROPERTY	GET_APPLICATION_PROPERTY
Parameter	MODULE_NLS_LANG	USER_NLS_LANG

Comme USER_NLS_LANG et DEVELOPER_NLS_LANG adoptent par défaut la valeur de NLS_LANG, les paramètres NLS de Form Builder contiendront la valeur de NLS_LANG si l'une de ces deux variables n'est pas spécifiquement définie.

Les paramètres NLS de Form Builder ont quatre variantes pour vous permettre d'extraire soit la totalité, soit une partie de la variable d'environnement. Le tableau ci-dessous indique les quatre paramètres de la procédure interne GET_APPLICATION_PROPERTY qui retourne la variable d'environnement USER_NLS_LANG :

Parameter	Retourne
USER_NLS_LANG	L'intégralité de la variable USER_NLS_LANG
USER_NLS_LANGUAGE	La partie langue uniquement
USER_NLS_TERRITORY	La partie pays uniquement
USER_NLS_CHARACTER_SET	La partie jeu de caractères uniquement

Pour extraire la variable d'environnement DEVELOPER_NLS_LANG, appelez GET_FORM_PROPERTY en utilisant le paramètre MODULE_NLS_LANG.


Fichier de définition d'imprimante et support NLS

  Rubriques connexes

Lorsque vous utilisez des états en mode caractères, vous devez définir la largeur physique de la page sur la largeur définie dans le fichier de définition d'imprimante (fichier .PRT), moins 1 caractère. Sinon, les caractères sur plusieurs octets risquent de commencer au dernier espace d'une ligne et de continuer sur la suivante. Par exemple, lorsque la largeur physique de la page est égale à 80 caractères et que celle indiquée dans la définition de l'imprimante est la même, un caractère sur plusieurs octets peut commencer au 80e caractère. Etant donné que les caractères sur plusieurs octets ne peuvent pas être séparés, le 81e caractère doit être compris dans la ligne précédente de façon à ce que le caractère sur plusieurs octets soit complet. Pour éviter cette situation, paramétrez sur 79 la largeur physique de la page de l'état.

Les paramètres NLS suivants propres à l'arabe et à l'hébreu peuvent être définis dans le fichier de définition d'imprimante :

Paramètre	Fonction	Valeurs
nls locale	Définition des paramètres régionaux du moteur d'impression	hébreu ou arabe
nls datastorageorder	Configuration du stockage des données logiques ou visuelles	logique ou visuel
nls contextuallayout	Mise en page pré-contextuelle des imprimantes en arabe	non ou oui
nls contextualshaping	Mise en forme pré-contextuelle des imprimantes en arabe	non ou oui
nls pcharset	Indication du jeu de caractères de l'imprimante	Tout jeu de caractères

Pour plus d'informations sur les fichiers de définition d'imprimante, reportez-vous au système d'aide de Report Builder.


Traduction des applications

  Rubriques connexes

La même langue doit être utilisée pour tous les messages d'erreur et textes standard. Lorsqu'il exécute une application, l'utilisateur final visualise les messages et textes standard issus des trois sources suivantes :

•	messages d'erreur du serveur ;

•	messages d'erreur d'exécution envoyés par Oracle Developer ;

•	messages et textes standard définis en tant qu'éléments de l'application.

Le support NLS d'Oracle contrôle la traduction des éléments des deux premières sources. En tant que développeur d'applications, vous êtes responsable de la traduction des messages et textes standard de la troisième source.

En général, il est nécessaire de traduire deux types de textes propres aux applications :

•	le texte traduisible, par exemple les menus, les textes standard, les options, les messages et les messages d'aide ;

•	les chaînes des déclencheurs et des procédures, y compris les messages d'alerte et les messages définis dans les déclencheurs.

Translation Builder (générateur de traduction) vous permet de traduire dans plusieurs langues les chaînes de « texte traduisible » de l'interface utilisateur. Vous pouvez l'utiliser dans le cadre de la traduction de la plupart des applications multilingues Oracle Developer en générant un fichier binaire pour chaque langue.

Ce générateur permet de rechercher et de traduire les chaînes de l'interface utilisateur, mais ne peut pas extraire de constantes de chaîne dans les déclencheurs et les procédures PL/SQL. Le texte constant des blocs PL/SQL doit être traduit « manuellement », car il n'est pas clairement délimité, mais est souvent constitué de variables et d'extraits de chaînes.

Pour une description complète du générateur de traduction, reportez-vous au système d'aide de ce dernier.


Notes concernant le développement d'applications

  Rubriques connexes

Lorsque vous développez une application qui sera traduite, n'oubliez pas de prévoir de l'espace supplémentaire pour les objets et les libellés standard. Pour utiliser plusieurs jeux de caractères et agrandir les zones traduites, il convient en règle générale de laisser 30 % d'espace autour des champs, des bordures et des textes standard.

Par exemple :

Invite à gauche du champ	Réservez 30 % d'espace supplémentaire pour l'agrandissement de ce champ à gauche de l'invite.
Invite au-dessus du champ	Réservez 30 % d'espace supplémentaire pour l'agrandissement de ce champ à droite de l'invite.
Boutons, cases à cocher, groupes de boutons d'option et listes instantanées	Prévoyez un agrandissement de 30 %.
Titres	Fixez la taille des boîtes englobantes de façon à pouvoir agrandir le titre de 30 % à droite.
Champs en affichage seul	Prévoyez une taille de 30 % supérieure à celle requise par la langue de base.
Tous les objets	Agrandissez les objets de façon à ce que la traduction tienne. Par exemple, les boutons doivent être suffisamment grands pour contenir les libellés traduits. Vérifiez la hauteur de ces boutons de façon à y loger le plus grand caractère à utiliser. Par exemple, calculez le nombre de pixels nécessaires au rendu des caractères Kanji.


Utilisation du générateur de traduction

  Rubriques connexes

Vous pouvez utiliser ce générateur dans le cadre de la traduction de la plupart des applications multilingues Oracle Developer. Vous pouvez l'activer, puis générer un fichier binaire pour chaque langue, à moins que les utilisateurs finals de votre application ne doivent changer de langue au cours de l'exécution.

Pour ce faire, ils doivent fermer le programme, modifier la variable d'environnement de la langue, puis redémarrer l'application.

Avec le générateur de traduction, les étapes de développement de votre application sont les suivantes :

•	Créez une définition simple de l'application (.FMB ou .RDF) dans la langue source.

•	Utilisez le générateur de traduction pour extraire des chaînes à traduire, permettre la traduction dans une ou plusieurs langues, et stocker de nouveau ces chaînes dans la définition de l'application.

•	Traduisez manuellement les messages standard des bibliothèques PL/SQL.

•	Utilisez le générateur afin de créer une version binaire de l'application pour chaque langue cible.

Avantages : Le générateur de traduction est la solution la plus simple pour mettre rapidement en œuvre des applications en plusieurs langues. Il offre une efficacité maximale. Si votre application est stable, cette approche convient parfaitement.

Par exemple, si vous avez développé une application dans quatre langues et que vous avez besoin, plus tard, de modifier le libellé d'un champ, vous effectuez cette modification dans le générateur, puis vous l'enregistrez dans le fichier de définition. Vous utilisez le générateur de traduction pour traduire le nouveau libellé, vous insérez les nouveaux messages dans le fichier de définition et vous le régénérez pour obtenir un fichier binaire contenant le nouveau libellé.

Inconvénients : Si vos applications doivent prendre en charge plusieurs langues simultanément, vous devez à la place changer de langue au cours de l'exécution.


Changement de langue lors de l'exécution

  Rubriques connexes

Seules quelques applications doivent prendre en charge simultanément plusieurs langues. Par exemple, une fenêtre en anglais peut être affichée au démarrage, et l'utilisateur final peut cliquer sur un bouton de cette fenêtre pour obtenir la traduction des invites en français et revenir à l'anglais.

Si votre application requiert un changement de langue lors de l'exécution, vous pouvez inclure plusieurs langues dans une même application, à condition qu'elles partagent le même jeu de caractères, mais vous ne pouvez pas utiliser le générateur de traduction pour localiser le texte traduisible si vous remplissez dynamiquement le texte lors de l'exécution. Vous devez donc créer des structures conditionnelles (IF...THEN...ELSEIF) pour passer d'une langue à l'autre en vérifiant la valeur de la variable d'environnement NLS, à l'aide de la procédure interne GET_FORM_PROPERTY.

L'utilisation du système de changement de langue lors de l'exécution vous permet de développer votre application en plusieurs étapes :

•	Créez l'intégralité de l'application dans une langue, y compris les bibliothèques.

•	Traduisez manuellement chaque bibliothèque.

•	Créez des libellés standard en tant qu'éléments affichés de taille correcte, remplis dynamiquement lors de l'exécution.

Comme Form Builder prend en charge l'attachement de plusieurs bibliothèques, vous pouvez réserver une bibliothèque aux messages à traduire, et d'autres bibliothèques à d'autres fins.

Avantages : Le principal avantage de cette approche est qu'elle permet la prise en charge d'applications sophistiquées dans lesquelles les applications Forms peuvent être extrêmement dynamiques. Dans ce cas, cette approche évite certains problèmes de mise à jour, car vous n'avez pas à générer de fichier distinct pour chaque langue chaque fois que l'application Forms change.

Inconvénients : Cette approche est plus compliquée, car elle implique un effort considérable au niveau de la création, du remplissage et de la mise à jour d'une mémoire de messages propres à la langue utilisée, et au niveau de la traduction manuelle. Par exemple, vous pouvez écrire un déclencheur WHEN-NEW-FORM-INSTANCE pour définir les libellés de chaque bouton en extrayant d'une bibliothèque attachée les libellés corrects, en fonction de la valeur de la variable d'environnement NLS.


Utilisation des bibliothèques PL/SQL pour les chaînes de code

  Exemples	  Rubriques connexes

Bien que le générateur de traduction facilite la traduction des messages qui font partie de l'interface Builder standard, les messages affichés par programme demandent un traitement spécial. Grâce aux bibliothèques PL/SQL, il vous est possible de mettre en œuvre une structure flexible pour les messages des déclencheurs ou des procédures.

En ce qui concerne les messages propres aux applications, c'est-à-dire affichés par les sous-programmes intégrés MESSAGE ou CHANGE_ALERT_MESSAGE, ou via l'affectation d'un message à un élément affiché depuis un déclencheur ou une procédure, vous pouvez utiliser les bibliothèques PL/SQL attachables afin de réaliser une structure flexible pour les messages. La bibliothèque peut être stockée sur l'hôte, puis être attachée dynamiquement lors de l'exécution. A ce moment-là, selon le chemin de recherche utilisé, vous pouvez intégrer la bibliothèque attachée à l'application Forms. (Par exemple, une bibliothèque peut ne contenir que les messages en italien.)


Support NLS - Exemples

  Rubriques connexes 	  Tous les exemples

Comparaison de chaînes - Exemples

Masques de format - Exemples

NLS_LANG - Exemples

Bibliothèques PL/SQL - Exemples


ALTER SESSION - Exemples

  Rubriques connexes

L'instruction suivante permet de convertir les séparateurs décimal et des milliers en virgule et en point, respectivement :

ALTER SESSION
   SET NLS_NUMERIC_CHARACTERS = ',.'

Ces nouveaux caractères sont renvoyés lorsque vous utilisez les éléments de format numérique D et G :

SELECT TO_CHAR(SUM(sal), 'L999G999D99') Total FROM emp

TOTAL
--------------
   FF29.025,00

L'instruction suivante permet de convertir le symbole monétaire ISO en celui utilisé aux Etats-Unis :

ALTER SESSION
   SET NLS_ISO_CURRENCY = America

Le symbole monétaire ISO défini pour les Etats-Unis est utilisé :

SELECT TO_CHAR(SUM(sal), 'C999G999D99') Total FROM emp

TOTAL
---------------
   USD29.025,00

L'instruction suivante permet de convertir en Deutsh Marks le symbole monétaire local :

ALTER SESSION
   NLS_CURRENCY = 'DM'

Le nouveau symbole monétaire local est renvoyé lorsque vous utilisez l'élément de format numérique L :

SELECT TO_CHAR(SUM(sal), 'L999G999D99') Total FROM emp

TOTAL
--------------
   DM29.025,00


Comparaison de chaînes - Exemples

  Rubriques connexes 	  Tous les exemples

Soit une colonne (COL1) qui contient les valeurs ABC, ABZ, BCD et ÄBC dans le jeu de caractères ISO 8859/1 sur 8 bits. Si vous avez écrit l'interrogation suivante :

SELECT COL1 FROM TAB1 WHERE COL1 > 'B'

L'interrogation retourne les valeurs BCD et ÄBC, car la valeur numérique de Ä est supérieure à celle de B.

Vous pouvez effectuer des comparaisons linguistiques en utilisant NLSSORT dans la clause WHERE, de la manière suivante :

WHERE NLSSORT(colonne) opérateur NLSSORT(chaîne)

Notez que NLSSORT doit figurer de part et d'autre de l'opérateur de comparaison.

SELECT COL1 FROM TAB1 WHERE NLSSORT(COL1) > NLSSORT('B')

Si vous effectuez un tri linguistique en allemand, les chaînes commençant par Ä ne sont pas renvoyées, car ce caractère vient avant B dans l'alphabet. Si vous procédez à un tri linguistique en suédois, ces chaînes sont retournées, car Ä vient après Z dans l'alphabet.


Masques de format - Exemples

  Rubriques connexes 	  Tous les exemples

Dans les applications compatibles NLS, évitez de coder en dur une chaîne composée d'un nom de mois. Toutefois, s'il est essentiel d'utiliser un code de ce type, n'utilisez pas la procédure interne COPY. Si vous le faites, le nom de mois risque d'être incorrect, selon la langue indiquée. (Pour mentionner une date dans une bibliothèque, utilisez la variable correspondante ; la procédure COPY fonctionne correctement.)

Exemple dépendant de la langue (déconseillé) :

:date.emb := '30-DEC-96';

copy ('30-DEC-96','date.emb');

Utilisez à la place TO_DATE, comme dans l'exemple ci-dessous :

Exemple indépendant de la langue (conseillé) :

:date.emb := to_date('30-12-1996','JJ-MO-AAAA');


NLS_LANG - Exemples

  Rubriques connexes 	  Tous les exemples

Supposez que vous souhaitiez exécuter votre application en français. Elle sera utilisée en France et les données seront affichées via le jeu de caractères WE8ISO8895P1. Vous paramétrez NLS_LANG de la manière suivante :

NLS_LANG=French_France.WE8ISO8895P1

Imaginez à présent que vous souhaitiez toujours exécuter votre application en français, mais qu'elle sera cette fois utilisée en Suisse. Vous paramétrez NLS_LANG de la manière suivante :

NLS_LANG=French_Switzerland.WE8ISO8895P1

Autres exemples :

NLS_LANG=Norwegian_Norway.NDK7DEC
NLS_LANG=Norwegian_Norway.WE8ISO8895P1
NLS_LANG=Japanese_Japan.JA16SJIS
NLS_LANG=Arabic_Egypt.AR8MSWIN1256
NLS_LANG=American_America.AR8MSWIN1256
NLS_LANG=American_America.WE8ISO8859P1


Bibliothèques PL/SQL - Exemple

  Rubriques connexes 	  Tous les exemples

FUNCTION nls_appl_mesg(index_no NUMBER)

RETURN CHAR

IS

   msg CHAR(80);

BEGIN

   IF index_no = 1001 THEN

      msg := 'L''impiegato che Voi cercate non esiste...';

   ELSIF index_no = 1002 THEN

      msg := 'Lo stipendio non puo essere minore di zero.';

   ELSIF ...

   :

   ELSE

      msg := 'ERRORE: Indice messaggio inesistente.';

   END IF;

   RETURN msg;

END;

Une routine de ce type peut être utilisée chaque fois qu'une expression de type caractère est normalement valide : par exemple, pour afficher un message d'alerte d'application correctement traduit, il vous suffit d'inclure dans votre application Forms le code suivant :

Change_Alert_Message('Mon_message_erreur', nls_appl_mesg(1001));

n := Show_Alert('Mon_message_erreur');

Pour changer la langue de l'application, il suffit de remplacer la bibliothèque PL/SQL contenant la fonction nls_appl_mesg par une bibliothèque de même nom contenant la fonction nls_appl_mesg avec le texte traduit.

Si l'application doit prendre en charge simultanément plusieurs langues, la fonction ci-dessus peut accepter un paramètre supplémentaire indiquant la langue voulue, et le code contiendra alors un niveau supplémentaire de IF...THEN...ELSIF...ELSE...END IF pour la gestion des différentes langues.


Rubrique d'aide introuvable. Recherchez les rubriques connexes dans l'aide en ligne.


Objets Oracle8 - exemples

  Rubriques connexes 	   Tous les exemples

Type d'objet

Type de table

Type de tableau variable

Objet de colonne

Table d'objets

Vue d'objet


Prise en charge d'Oracle8 Server

  Rubriques connexes

Un certain nombre des nouvelles fonctions Oracle8 Server sont aussi disponibles dans Oracle Developer. Il s'agit, de manière générale, de fonctions appartenant aux catégories suivantes :

•	Extensibilité améliorée. Par exemple, les bases de données Oracle8 peuvent contenir des dizaines de téra-octets de données et peuvent prendre en charge l'accès simultané de 10 000 utilisateurs. Les tables, quant à elles, peuvent désormais comprendre jusqu'à 1 000 colonnes. Les types de données CHAR et VARCHAR2 peuvent désormais compter jusqu'à 2 000 et 4 000 octets, respectivement.

•	Efficacité et performances améliorées. Developer gère pour vous l'utilisation de ces fonctions Oracle8, vous n'avez donc pas à intervenir. Vous bénéficiez automatiquement de la vitesse et de la fiabilité offertes par l'utilisation d'Oracle8 Server pour vos données.

•	Objets volumineux (parfois appelés LOB).

•	Objets définis par l'utilisateur.

Poursuite de la prise en charge d'Oracle7

Developer continue également de prendre en charge Oracle7 Server (versions 7.3 et ultérieures).


Types de données Oracle8 pris en charge

  Rubriques connexes

Cette version d'Oracle Developer prend en charge les types de données Oracle8 suivants :

Objets volumineux (LOB)

Dans Oracle8, les programmeurs ont la possibilité de définir des objets volumineux, souvent nommés LOB. Ces objets peuvent stocker des éléments tels que du texte, des images, des sons ou de la vidéo.

Oracle Developer prend actuellement en charge les objets volumineux Oracle8 suivants :

•	BLOB (binary large object - objet volumineux binaire)

•	CLOB (single-byte character large object - objet volumineux de type caractère, sur un octet)

•	BFILE (binary file - fichier binaire), parfois appelé fichier externe.

Objets définis par l'utilisateur

Dans Oracle8, les programmeurs peuvent définir des types d'objet (appelés aussi types d'objet définis par l'utilisateur) qui sont des composés basés sur les types de données à élément unique pris en charge par Oracle8. A l'aide de ces définitions d'objet, les programmeurs peuvent alors créer divers types de tables.

Developer prend actuellement en charge les catégories d'objets Oracle8 suivantes :

•	table d'objets, où l'ensemble de la table est basé sur un type d'objet unique ;

•	objet colonne d'une table relationnelle, cette colonne étant basée sur un type d'objet ;

•	colonne REF figurant dans une table d'objets ou dans une table relationnelle, les valeurs de cette colonne étant des pointeurs désignant des lignes d'une autre table d'objets.

Nouveaux types de données scalaires

Oracle Developer prend aussi en charge le nouveau type de données FLOAT d'Oracle8. Developer traite ce type de données comme son propre type de données NUMBER.


A propos des objets Oracle8 volumineux (LOB)

Oracle Developer permet d'accéder aux types de données des objets volumineux : objets binaires (BLOB), objets de type caractère (CLOB) et fichiers binaires (BFILE).

Sur un serveur Oracle8, ces types de données peuvent stocker des objets d'un volume allant jusqu'à 4 méga-octets. Ils ont un objectif similaire à celui des types de données familiers LONG et LONG RAW d'Oracle7, mais présentent un certain nombre d'avantages supplémentaires.

Comparaison des données LOB et LONG

LOB	LONG
4 giga-octets maximum	2 giga-octets maximum
Plusieurs colonnes LOB autorisées dans une table	Une seule colonne LONG autorisée par table
Réplication prise en charge	Pas de réplication
Prise en charge de l'accès aléatoire aux données	Seul l'accès séquentiel est pris en charge
Meilleure gestion de l'espace table (seul le repère LOB est stocké)	Efficacité moindre (les données sont stockées directement dans la table)
Autorisé dans les types d'objets définis par l'utilisateur	Non autorisé
Aisément transmis aux procédures et aux appels externes	Transmission difficile
Informations sur les LOB :

Les BLOB servent à stocker des objets volumineux au format binaire. Les CLOB servent à stocker des données de type caractère. Ces deux types de données sont aussi nommés LOB internes, car leurs données sont conservées sur le serveur. Ces données interviennent dans des transactions et des contrôles d'intégrité, y compris des validations (Commit) et des annulations (Rollback).

Les données BFILE, en revanche, sont conservées hors du serveur. Le serveur ne stocke que l'adresse du fichier, telle que le système d'exploitation la reconnaît. Il en résulte que les données BFILE ne peuvent pas faire partie des transactions de base de données.

Compatibilité

Etant donné les divers avantages que présentent les LOB (voir tableau ci-dessus), il est préférable d'utiliser les données LOB plutôt que les données LONG dans toute nouvelle application.

Cependant, par souci de compatibilité en amont, les données LONG sont toujours parfaitement prises en charge.

Types de panneau

Dans un panneau, le LOB dispose habituellement d'un contrôle de type Texte, Image ou Son, selon sa nature et son utilisation.

Restrictions

•	Les données BFILE sont en lecture seule.

•	Bien que Forms tente de charger l'intégralité du BFILE ou du BLOB lorsqu'il lit cet élément à l'exécution, il est limité par la quantité de mémoire virtuelle Runtime disponible.

•	Pour les CLOB, la limite de taille est fixée à 65 534 octets dans Forms.


A propos des objets Oracle8 définis par l'utilisateur

  Rubriques connexes  [image]  Exemples

Dans le cadre de la prise en charge d'Oracle8 Server, Developer vous permet d'utiliser les objets Oracle8 définis par l'utilisateur. Ces objets comprennent les tables, les objets colonne des tables relationnelles et un type d'objet colonne particulier, la colonne REF.

Tables d'objets

Dans Oracle8, les tables d'objets sont basées sur les définitions de types d'objet créées par l'utilisateur. Ces définitions sont des combinaisons dont chaque attribut ou composant est basé sur un type de données intégré Oracle8. (Une définition de type d'objet peut être basée sur une autre, mais au bout du compte, les définitions se fondent toujours sur les types de données intégrés Oracle8.)

Cela permet à Oracle Developer de traiter chaque colonne d'une table d'objets comme un élément de données distinct, de la même manière qu'il traite les colonnes d'une table relationnelle.

Objets colonne des tables relationnelles

Un programmeur de base de données peut aussi créer une colonne de table relationnelle sur la base d'une définition de type d'objet. Cela incorpore un objet composite dans la table relationnelle.

Developer divise l'objet colonne intégré d'après les éléments qui le composent et traite chacun d'entre eux comme une colonne distincte.

Ainsi, si Oracle8 Server stocke une table relationnelle à trois colonnes et que l'une de ces colonnes est un objet colonne, lui-même basé sur une définition d'objet possédant quatre parties ou attributs, Developer traite cette table comme une table à 6 colonnes (les 2 colonnes relationnelles, plus les 4 colonnes formant l'objet).

Si l'un des attributs de la définition de l'objet colonne est basé sur un autre type d'objet, cette partie est encore divisée par Developer et traitée comme une série de colonnes distinctes.

Colonnes REF

Dans une table d'objets ou une table relationnelle, une colonne peut être définie comme possédant le type REF. Une colonne REF ne contient pas directement de données, mais des pointeurs (des références) désignant une autre table d'objets, où se trouvent en réalité les données.

Cette référence est utilisée lors de l'exécution pour que l'utilisateur voie les données auxquelles renvoie la référence.


Objets Oracle8 définis par l'utilisateur - exemples

  Rubriques connexes

Pour créer des objets sur le serveur Oracle8 Server, un programmeur de base de données définit un type d'objet, puis crée un objet spécifique en fonction de cette définition. L'objet qui en résulte peut être une table d'objets ou un objet colonne d'une table relationnelle.

Exemples

Considérez les définitions suivantes. La première crée un type d'objet. La deuxième crée une table de ce type.

         CREATE TYPE  emp_type  AS OBJECT

                      (name     CHAR(30),

                       title    CHAR(20),

                       idnum    NUMBER);

         CREATE TABLE  emp  OF emp_type;

Dans l'exemple ci-dessus, vous créez une table d'objets nommée emp. Elle comporte trois colonnes, qui sont dotées du nom et du type de données fixés par les attributs de la définition du type d'objet emp_type.

L'exemple suivant porte sur un objet colonne dans une table relationnelle :

         CREATE TYPE  address_type  AS OBJECT

                      (street    VARCHAR2(40),

                       city      VARCHAR2(25),

                       state     VARCHAR2(2)

                       zip       NUMBER);

         CREATE TABLE  customers

                       (cust_id  NUMBER,

                        name     VARCHAR(40),

                        address  address_type);

Dans cet exemple, vous créez une table relationnelle appelée customers. Cette table comporte trois colonnes. Les deux premières (cust_id et name) sont des colonnes relationnelles ordinaires. La troisième (address) est un objet colonne. Elle est basée sur la définition du type d'objet address_type. Cette colonne possède la structure et les types de données définis par cette définition d'objet. Elle peut être considérée comme comportant quatre parties ou composants (rue, ville, état et code postal). Chacun de ces composants relève du type de données défini par la définition du type d'objet address_type. (Dans ce cas, il s'agit pour tous de VARCHAR2 sauf pour le code postal, dont le type de données est NUMBER).

Dans l'illustration suivante, la troisième colonne d'une table relationnelle à trois colonnes est basée sur un type d'objet possédant lui-même trois parties ou composants.

Remarquez qu'un objet Oracle8 est composé de différentes parties. Chacune de ces parties possède son propre nom et relève d'un type de données Oracle8 connu. Si l'objet est une table (en fait, une ligne dans une table d'objets), il comporte autant de colonnes ou de parties qu'il y a d'attributs dans la définition du type d'objet. Si une colonne d'une table relationnelle est basée sur un objet, chacune des parties de l'objet peut être considérée comme une colonne supplémentaire de cette table. Puisque ces parties dépendent des attributs de la définition du type d'objet, elles sont parfois appelées colonnes d'attribut.

Traitement des objets par Oracle Developer

Dans Developer, les tables d'objets sont traitées pratiquement comme les tables relationnelles. Chaque colonne peut être sélectionnée individuellement. Bien que toutes les colonnes puissent être sélectionnées, chacune d'entre elles est traitée comme un élément distinct dans l'application. La table elle-même ne possède pas d'identité particulière en tant qu'objet dans l'environnement Developer.

De même, Oracle Developer ne traite pas les objets colonne des tables relationnelles comme des entités uniques et homogènes. Il traite chacun des composants de l'objet colonne comme un élément de données distinct et indépendant. Chaque composant de l'objet colonne peut être sélectionné. Une fois sélectionné, il est traité comme un élément de données indépendant. Même lorsque tous les composants de l'objet colonne sont sélectionnés, ce dernier ne possède pas d'identité particulière en tant qu'objet au sein de l'environnement Developer.

Un nom au format NomObjetColonne_NomElément est attribué par défaut aux données sélectionnées dans un objet. Ainsi, si vous sélectionnez le composant zip de l'objet colonne address dans l'exemple ci-dessus, l'élément de données portera le nom address_zip dans l'application Developer.


A propos des données REF d'Oracle8

  Rubriques connexes

REF est un nouveau type de données d'Oracle8. Il fait d'un objet colonne un pointeur désignant des données d'une autre table d'objets. La colonne REF ne contient elle-même aucune donnée.

Par exemple :

           CREATE TYPE  dept_type  AS OBJECT

                        (deptname     VARCHAR2(24),

                         deptnumber   NUMBER);

           CREATE TABLE  dept_table OF dept_type;

           CREATE TABLE  emp

                         (empname    VARCHAR2(50),

                          empnumber  NUMBER,

                          empdept    REF  dept_type);

Dans la table relationnelle emp, la colonne empdept est une colonne REF. Elle désigne un objet de type dept_type.

Types et tables

Lorsqu'une colonne REF est définie, elle identifie un type d'objet et non une table d'objets particulière. Une base de données peut contenir plusieurs tables d'objets basées sur une même définition de type d'objet. Ainsi, la définition de la colonne REF n'identifie pas les tables cibles.

Résolution du pointeur

Lors de l'initialisation de la table comportant la colonne REF, les valeurs placées dans cette colonne désignent des lignes des tables contenant réellement les données voulues. Plus tard, lors de l'exécution, les valeurs affichées dans la colonne REF sont celles désignées (et non les pointeurs).

Affichage des données REF par Developer lors du développement

Durant le développement, si vous demandez à voir une table comportant une colonne REF, Oracle Developer affiche la colonne REF sous sa forme étendue. Il affiche donc les attributs du type d'objet sur lequel pointe la définition de la colonne REF d'origine.

Dans l'exemple ci-dessus, Developer affichera la colonne REF empdept comme comportant deux composants (ou colonnes d'attribut) : deptname et deptnumber. Ces deux attributs sont ceux du type d'objet (dept_type) identifié dans la définition de la colonne REF.

Comme pour les objets colonne, Developer vous permet de sélectionner n'importe lequel des composants (ou colonnes d'attribut) désignés par la référence pour en faire des données de l'application Developer. Cependant, contrairement aux objets colonne habituels, Developer vous permet aussi de sélectionner le nom de la colonne REF pour en faire un élément manipulable dans votre application. Vous pouvez ainsi utiliser cette colonne dans votre code PL/SQL. Par défaut, la colonne REF devient une partie du canevas NULL.

Affichage des données REF pour vos utilisateurs

En tant que développeur d'applications, vous pouvez choisir la manière dont sont affichées les données désignées par la référence (REF résolue) lors de l'exécution :

•	affichage de données dans le bloc de données contenant la colonne REF (parfois appelée méthode recherche)

•	affichage de données dans le bloc de données désigné par la colonne REF (méthode maître-détail)

La première solution (affichage des données au sein du bloc de données où se trouve la colonne REF) est la plus simple. Il vous suffit de sélectionner les composants REF voulus comme éléments de votre bloc de données et lors de l'exécution, Developer et Oracle8 résoudront les références et placeront les données désignées par les références dans les éléments affichés. L'utilisateur n'a besoin de voir que ce bloc.

L'autre possibilité (affichage des données dans le bloc de données désigné) requiert l'établissement d'un lien maître-détail. Vous procédez pour cela comme pour établir un lien maître-détail entre deux blocs possédant une relation clé primaire - clé étrangère. Dans ce cas, la colonne REF crée un lien entre les deux blocs. L'utilisateur voit les deux blocs, mais les données REF n'apparaissent que dans le bloc désigné par la référence.

L'assistant Bloc de données de Form Builder peut servir à la création de cette relation maître-détail.


Icônes des objets Oracle8

Le Navigateur d'objet et les assistants de Developer utilisent des icônes pour vous aider à connaître le type des données Oracle8 auxquelles vous accédez. Ces icônes et leur signification sont indiquées ci-dessous :

             table ordinaire

             type d'objet

             vue d'objet

             table d'objets

             objet imbriqué

             table imbriquée

             objet référencé

             tableau variable

             méthode

             type inconnu

             mode pile côté serveur

             unité de programme côté serveur

             fichier

             données de type Date

             données de type Number

             données de type Character

             données de type Raw

          données de type BLOB

             données de type BFILE

             données de type CLOB

             ID de ligne

             libellé MLS


Extensibilité et performances avec Oracle8

La prise en charge d'Oracle8 par Developer vous offre un certain nombre d'améliorations en matière d'extensibilité et de performances. Ces améliorations, pour la plupart, sont automatiquement mises en oeuvre.

Par exemple, Developer vous permet d'accéder aux fonctions Oracle8 suivantes :

•	Volumes supérieurs. La base de données même, le nombre d'utilisateurs simultanés et le nombre de colonnes des tables (désormais, jusqu'à 1 000 colonnes) ont augmenté.

•	Partitionnement des tables et des index

•	Mise en mémoire cache des objets côté client

Developer a aussi été amélioré afin d'utiliser directement plusieurs autres fonctions Oracle8 permettant une amélioration des performances :

•	Pré-extraction. Forms utilise cette fonction Oracle8 (ainsi que les mécanismes de taille de tableau existants) pour réduire à la fois le nombre de passages dans la base de données et la mémoire utilisée. Cela se fait automatiquement, sans intervention de l'utilisateur.

•	Clause de valeurs de retour. Forms utilise cette nouvelle fonction DML lors des insertions et des mises à jour. La clause de valeurs de retour rend inutile le lancement d'une seconde interrogation de la base de données (pour obtenir les données mises à jour par des déclencheurs côté serveur), ce qui accélère le traitement. Les utilisateurs contrôlent cette opération à l'aide de la propriété DML Valeurs de retour.

•	Déclencheur A la place de pour la mise à jour des vues. Ce déclencheur côté serveur fournit un mécanisme permettant la mise à jour des vues relationnelles et des vues d'objet, normalement impossibles à mettre à jour.


Prise en charge de PL/SQL 8

  Rubriques connexes

Cette version d'Oracle Developer utilise PL/SQL version 8 sur le client et le serveur. Les unités de programme côté client ne prennent pas en charge les fonctionnalités Oracle8 liées à l'objet. Cependant, les unités de programmes stockées peuvent utiliser toutes les nouvelles fonctionnalités PL/SQL version 8.

L'annexe A du manuel PL/SQL User's Guide and Reference Release 8 décrit les nouvelles fonctionnalités PL/SQL version 8. Ce manuel est disponible en ligne. Choisissez Aide -> Manuels, puis recherchez le dossier des manuels de références sous Manuels en ligne.


Compatibilité avec les versions antérieures de PL/SQL

Si vous possédez des unités de programme côté client écrites en PL/SQL 1 ou PL/SQL 2, vous devez en convertir le code pour utiliser la nouvelle version. L'utilitaire de conversion PL/SQL 1 est fourni pour automatiser la mise à niveau.

Les unités de programme stockées créées à l'aide de versions antérieures fonctionnent avec le moteur PL/SQL 8 sur le serveur de base de données, mais leur compilation peut générer des erreurs. Ces erreurs surviennent parfois lorsqu'il existe une incompatibilité de syntaxe entre PL/SQL 8 et PL/SQL 2. PL/SQL 8 comporte un indicateur de compatibilité vous permettant de choisir un mode compatible PL/SQL 2, afin que le moteur PL/SQL 8 ne produise pas de telles erreurs lors de la compilation du code PL/SQL 2 sur le serveur. Le chapitre 6 du manuel Oracle8 Server Migration décrit les situations couvertes par cet indicateur de compatibilité.


Fonctions Oracle8 non encore prises en charge

  Rubriques connexes

Toutes les fonctions Oracle8 ne sont pas prises en charge par cette version des produits Oracle Developer. Les principales fonctions non prises en charge sont les suivantes :

•	Types de collecte (tables imbriquées et tableaux variables (VARRAY))

•	Procédures stockées retournant des valeurs d'objet

•	Types de données scalaires NCHAR et NVARCHAR2.

Gardez également à l'esprit que, même si Developer prend en charge PL/SQL 8, la version client de ce dernier ne prend pas encore entièrement en charge toutes les fonctions d'Oracle8 Server. (PL/SQL 8 côté serveur est entièrement pris en charge.)


Prise en charge des objets Oracle8 dans le Navigateur d'objet

Dans le Navigateur d'objet, les fonctionnalités Oracle8 permettent d'accéder aux types de données des objets ; vous pouvez ainsi programmer plus aisément en employant des données Oracle 8. Cette prise en charge des objets Oracle 8 vous permet de visualiser les types de données définis par l'utilisateur sous forme d'arborescence et de rechercher puis d'afficher les tables, les vues, les colonnes, les déclencheurs, les méthodes et les attributs associés aux types de données définis par l'utilisateur.

Le noeud Objets de base de données contient les schémas (et les objets associés) auxquels vous avez accès dans la base de données à laquelle vous êtes actuellement connecté. Lorsque vous êtes connecté à une base de données Oracle8, le Navigateur d'objet affiche les types de données définis par l'utilisateur disponibles (avec leurs attributs et leurs méthodes) dans le noeud Types de chaque schéma. Les tables, vues, colonnes et déclencheurs associés aux types de données définis par l'utilisateur sont affichés dans les noeuds Tables et Vues.

Plus précisément, les fonctionnalités Oracle8 du Navigateur d'objet vous permettent de rechercher et d'afficher :

•	les tables d'objets et les objets colonne dans le noeud Tables

•	les vues d'objet dans le noeud Vues

•	les déclencheurs A la place de des vues dans le noeud Vues

•	les types d'objet, de table et de tableau variable dans le noeud Types

•	les attributs et les méthodes de types d'objet dans le noeud Types

Des icônes servent à différencier les objets relationnels et les objets Oracle8 dans le Navigateur d'objet. Par exemple, des icônes distinctes servent à représenter les tables relationnelles normales et les tables d'objets, ou les vues normales et les vues d'objet.

Pour plus d'informations sur les types de données Oracle8 définis par l'utilisateur, consultez la documentation Oracle8.

Rubriques connexes

Noeuds Type d'objet

Noeuds Type de table

Noeuds Type de tableau variable

Noeuds Objet colonne

Noeuds Table d'objets

Noeuds Vue d'objet

Développement de toute l'arborescence

Icônes des objets Oracle8


Noeuds Type d'objet

  Exemple	  Rubriques connexes

Les types d'objet apparaissent dans le noeud Types du Navigateur d'objet. Un noeud type d'objet représente un type créé par l'instruction SQL CREATE TYPE AS OBJECT. Le type d'objet apparaît dans le Navigateur d'objet sous la forme :

nom_type_objet ( Object Type [ * ] & Body [ * ] )

Le libellé Object Type apparaît lorsqu'une instruction CREATE TYPE AS OBJECT est transmise à la base de données. Un astérisque ( * ) apparaît lorsque la spécification du type n'est pas valide ou que le type est incomplet. Un type incomplet est une pseudovariable permettant de définir des types de façon récurrente.

Le libellé Object Body apparaît lorsqu'un corps de type a été créé à l'aide de l'instruction CREATE TYPE BODY. Un astérisque ( * ) apparaît lorsque le corps de type n'est pas valide.

Quand le type et le corps de l'objet ont été créés sans erreur, le libellé Object Type & Body apparaît.

Les noeuds type d'objet sont des noeuds composites ; ils possèdent deux sous-noeuds, Attributs et Méthodes. Un noeud type d'objet ne peut être développé que s'il existe une spécification de type valide.

Les attributs d'un type d'objet sont représentés sous forme de noeuds dans le sous-noeud Attributs.

Les méthodes d'un type d'objet sont représentées sous forme de noeuds dans le sous-noeud Méthodes. Les méthodes apparaissent sous forme de procédures et de fonctions. Les libellés de méthode sont affichés dans le Navigateur d'objet sous la forme :

nom_méthode (Procedure)

et

nom_méthode (Function)

Si vous définissez pour un type d'objet une méthode d'association ou de tri, le libellé de la méthode apparaît comme suit :

nom_méthode (Map Function)

ou

nom_méthode (Order Function)

Remarque : La liste d'arguments des méthodes n'est pas affichée.


Noeud Type d'objet - exemple

  Rubriques connexes 	   Tous les exemples

L'instruction SQL suivante crée le type d'objet emp_typ.

CREATE TYPE emp_typ AS OBJECT
  (ename VARCHAR2(30), esalary NUMBER(5,2),
  MEMBER PROCEDURE raise(amount NUMBER),
  MEMBER FUNCTION get_salary RETURN NUMBER,
  MAP MEMBER FUNCTION compare RETURN NUMBER);

L'arborescence emp_typ est la suivante :


Noeuds Type de table

  Exemple	  Rubriques connexes

Les tables apparaissent dans le noeud Types du Navigateur d'objet. Un noeud type de table représente un type créé par l'instruction SQL CREATE TYPE AS TABLE. Le type de table apparaît dans le Navigateur d'objet comme suit :

nom_type_table (TABLE OF nom_sous-type_table)

Lorsque le sous-type est un type intégré, le noeud type de table ne peut pas être développé. Si le sous-type est un type d'objet ou un objet REF, les attributs de l'objet apparaissent en tant que sous-noeuds.


Noeud Type de table - exemple

  Rubriques connexes 	   Tous les exemples

Les instructions SQL suivantes créent le type d'objet emp_typ et le type de table emp_tbl.

CREATE TYPE emp_typ AS OBJECT
  (ename VARCHAR2(30), esalary NUMBER(5,2),
  MEMBER PROCEDURE raise(amount NUMBER),
  MEMBER FUNCTION get_salary RETURN NUMBER,
  MAP MEMBER FUNCTION compare RETURN NUMBER);

CREATE TYPE emp_tbl AS TABLE OF emp_typ;

L'arborescence emp_tbl est la suivante :


Noeuds Type de tableau variable

  Exemple	  Rubriques connexes

Les types de tableau variable apparaissent dans le noeud Types du Navigateur d'objet. Un type de tableau variable correspond à un type créé par l'instruction SQL CREATE TYPE AS VARYING ARRAY. Un type de tableau variable apparaît comme suit dans le Navigateur d'objet :

nom_type_tableau_variable (VARRAY (taille) nom_sous-type_tableau_variable)

Lorsque le sous-type est un type intégré, le noeud type de tableau variable ne peut pas être développé. Si le sous-type est un type d'objet ou un objet REF, les attributs de l'objet apparaissent en tant que sous-noeuds.


Type de tableau variable - exemple

  Rubriques connexes 	   Tous les exemples

Les instructions SQL suivantes créent le type d'objet emp_typ et le type de tableau variable emp_ary.

CREATE TYPE emp_typ AS OBJECT
  (ename VARCHAR2(30), esalary NUMBER(5,2),
  MEMBER PROCEDURE raise(amount NUMBER),
  MEMBER FUNCTION get_salary RETURN NUMBER,
  MAP MEMBER FUNCTION compare RETURN NUMBER);

CREATE TYPE emp_ary AS VARRAY(7) OF emp_typ;

L'arborescence emp_ary est la suivante :


Noeuds Objet colonne

  Exemples	  Rubriques connexes

Les objets colonne apparaissent sous forme de noeuds dans le noeud Colonnes. Chaque objet porte un libellé entre parenthèses, où figurent son nom et son type. Les noeuds objet colonne sont des noeuds composites où les attributs du type apparaissent sous forme de sous-noeuds.

Les objets colonne admettent quatre sous-types : type d'objet imbriqué, type de table, type de tableau variable et type d'objet REF. Les objets colonne sont affichés comme suit dans le Navigateur d'objet :

nom_colonne (type_objet_imbriqué)

nom_colonne (nom_type_table:TABLE OF nom_sous-type_table)

nom_colonne (nom_type_tableau_variable: VARRAY(taille) OF nom_sous-type_tableau_variable)

nom_colonne (REF nom_type_référence)


Noeud Objet colonne - exemples

  Rubriques connexes 	   Tous les exemples

Dans l'exemple qui suit, la colonne emp_col de la table emp_tab est un objet imbriqué de type emp_typ.

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TABLE emp_tab (emp_col emp_typ, dept VARCHAR2(2));

L'arborescence emp_tab est la suivante :

Dans l'exemple suivant, la colonne emps de la table dept_tab est une table imbriquée de sous-type emp_tbl. Elle comporte des lignes de type emp_typ.

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TYPE emp_tbl AS TABLE OF emp_typ;
CREATE TABLE dept_tab (dname VARCHAR2(20), emps emp_tbl)
  NESTED TABLE emps STORE AS emps_tab;

L'arborescence dept_tab est la suivante :

Dans l'exemple suivant, la colonne emps de la table dept_tab_ary est un tableau variable de sous-type emp_ary. Il comporte des lignes de type emp_typ.

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TYPE emp_ary AS VARRAY(7) OF emp_typ;
CREATE TABLE dept_tab_ary (dname VARCHAR2(20), emps emp_ary);

L'arborescence dept_tab_ary est la suivante :

Dans l'exemple suivant, la colonne manager de la table dept_ref est un objet référencé de type emp_typ.

CREATE TYPE emp_typ AS OBJECT (ename VARCHAR2(30), esalary NUMBER(5,2));
CREATE TABLE dept_ref (dname VARCHAR2(20), manager REF emp_typ);

L'arborescence dept_ref est la suivante :


Noeuds Table d'objets

  Exemple	  Rubriques connexes

Les tables d'objets apparaissent dans le noeud Tables du Navigateur d'objet. Un noeud table d'objets correspond à une table créée par l'instruction SQL CREATE TABLE OF. Les noeuds table d'objets sont affichés comme suit dans le Navigateur d'objet :

nom_table_objets (nom_type_objet)

Chaque noeud table d'objets possède deux sous-noeuds : Déclencheurs et Colonnes. Le sous-noeud Déclencheurs contient tous les déclencheurs associés à la table d'objets. Ces déclencheurs sont affichés de la même manière que les déclencheurs associés aux tables relationnelles normales. Le noeud Colonnes contient toutes les colonnes relationnelles et les objets colonne associés à une table d'objets donnée. Chaque colonne porte un libellé entre parenthèses, où figurent son nom et son type.


Noeud Table d'objets - exemple

  Rubriques connexes 	   Tous les exemples

Les instructions SQL suivantes créent le type d'objet person_typ et la table d'objets person_tab.

CREATE TYPE person_typ AS OBJECT
  (name VARCHAR2(30), address VARCHAR2(60));

CREATE TABLE person_tab OF person_typ;

L'arborescence person_tab est la suivante :


Noeuds Vue d'objet

  Exemple	  Rubriques connexes

Les vues d'objet apparaissent dans le noeud Vues du Navigateur d'objet. Un noeud vue d'objet correspond à une vue créée à l'aide de la clause OF type_objet. Les noeuds vue d'objet portent un libellé entre parenthèses, où figurent leur nom et leur type. Les attributs de l'objet ne sont pas affichés.

Chaque noeud vue d'objet comporte deux sous-noeuds : Déclencheurs et Colonnes. Le sous-noeud Déclencheurs contient tous les déclencheurs associés à la vue d'objet, y compris les déclencheurs A la place de. Lorsqu'un tel déclencheur est associé à une vue, son libellé apparaît comme suit :

nom_déclencheur (INSTEAD OF instructions_déclenchement)


Noeud Vue d'objet - exemple

  Rubriques connexes 	   Tous les exemples

Les instructions SQL suivantes créent une vue d'objet.

CREATE TYPE emps_typ AS OBJECT (ename VARCHAR2(30), esalary number(5,2), deptno NUMBER(2));
CREATE TABLE emps (ename VARCHAR2(30), esalary number(5,2), deptno NUMBER(2));
CREATE VIEW dev_emps OF emps_typ
  WITH OBJECT OID (ename)
  AS SELECT ename, esalary, deptno FROM emps WHERE deptno = 10;

L'arborescence de la vue d'objet dev_emps est la suivante :


Développement de tous les noeuds des objets Oracle8

  Rubriques connexes

L'opération Développer tout du Navigateur d'objet ne développe pas les noeuds de type de données et d'attribut Oracle8 de façon récurrente.

Ainsi, si un attribut manager, de type emp_typ, apparaît comme descendant d'un autre type emp_typ, l'attribut manager ne sera pas développé par la commande Développer tout.


Variables d'environnement

  Rubriques connexes

CA_GPREFS

CA_UPREFS

CUE_PREFS

DEV2000_PROJECT

DEV2000_SOURCECONTROL

DOC60

FORMS60_DEFAULTFONT

FORMS60_EDITOR

FORMSnn_ERROR_DATE/DATETIME_FORMAT

FORMS60_JAVADIR

FORMS60_MAPPING

FORMS60_OUTPUT

FORMSnn_OUTPUT_DATE/DATETIME_FORMAT

FORMS60_PATH

FORMS60_REPFORMAT

FORMS60_TIMEOUT

FORMSnn_USER_DATE/DATETIME_FORMAT

FORMS60_USEREXITS

GRAPHICS60_PATH

INTERRUPT (utilisateurs DOS SQL*Net seulement)

LOCAL

NLS_LANG

OleCreateObjPoolInMemory

OleDoNotUpdateLinks

OleUpdateLinksPrompt

ORACLE_HOME

ORACLE_PATH

ORAINFONAV_DOCPATH

REPORTS60_CGIDIAGBODYTAGS

REPORTS60_CGIDIAGHEADTAGS

REPORTS60_CGIHELP

REPORTS60_CGIMAP

REPORTS60_CGINODIAG

REPORTS60_CGIPATHONLYURL

REPORTS60_COOKIE_EXPIRE

REPORTS60_DB_AUTH

REPORTS60_ENCRYPTION_KEY

REPORTS60_OWSDIAGBODYTAGS

REPORTS60_OWSDIAGHEADTAGS

REPORTS60_OWSHELP

REPORTS60_OWSMAP

REPORTS60_OWSNODIAG

REPORTS60_OWSPATHONLYURL

REPORTS60_PATH

REPORTS60_REPORTS_SERVER

REPORTS60_SYS_AUTH

REPORTS60_TERMINAL

REPORTS60_TMP

REPORTS60_USEREXIT

REMOTE

UI_ICON

USERNAME

WIN_REMOTE_SESSIONS

XMITTR (utilisateurs DOS seulement)


Base de registres (Windows 95 et Windows NT)

  Variables d'environnement

Oracle Installer crée une section ORACLE dans votre base de registres. Cette section contient des paramètres de configuration qui contrôlent notamment le nom du répertoire d'origine Oracle Home, et l'emplacement du fichier de préférences du produit et celui des fichiers d'aide.

Affichage et modification de la base de registres

Vous pouvez afficher et facultativement éditer la base de registres de Microsoft Windows à l'aide de l'Editeur de base de registres. Cet éditeur se trouve dans le répertoire où est installé votre logiciel Windows. Pour lancer l'Editeur, choisissez Démarrer [image] Exécuter, puis tapez REGEDIT et cliquez sur OK.

Dans l'Editeur de base de registres, développez le noeud HKEY_LOCAL_MACHINE, puis le noeud SOFTWARE. Cliquez sur ORACLE pour afficher les paramètres de configuration Oracle.

Vous pouvez modifier les valeurs de paramètre en cliquant deux fois sur le nom de paramètre pour afficher la boîte de dialogue d'édition de chaîne. Changez la valeur dans la boîte Valeur, puis cliquez sur OK pour accepter la nouvelle valeur.


Paramètres de configuration

  Variables d'environnement

Oracle Installer définit automatiquement plusieurs paramètres. Certains d'entre eux sont requis par les produits Oracle, et d'autres vous permettent de personnaliser le comportement des produits.

Paramètres requis

Les paramètres répertoriés dans la présente section sont automatiquement définis ou supprimés par Oracle Installer. Ils sont requis par divers produits pour assurer leur bon fonctionnement.

Attention : Ne modifiez pas la définition des paramètres répertoriés dans la présente section, car vous pourriez altérer le fonctionnement d'un ou de plusieurs produits Oracle.

La présence de nn dans les paramètres répertoriés ci-dessous indique le numéro de version d'un produit ou d'un composant. Ce numéro peut changer lorsque vous passez à une nouvelle version d'un produit Oracle.

Parameter	Valeur par défaut
BROWSERnn	ORACLE_HOME\BROWSE25
DEnn	ORACLE_HOME\TOOLS\COMMON60
FORMSnn	ORACLE_HOME\FORMS60
GRAPHICSnn	ORACLE_HOME\GRAPH60
MMnn	ORACLE_HOME\TOOLS\COMMON60
OCLnn	ORACLE_HOME\GRAPH60
PROnn	ORACLE_HOME\PRO18
RDBMSnn	ORACLE_HOME\RDBMS73
RWnn	ORACLE_HOME\REPORT60
TKnn	ORACLE_HOME\TOOLS\COMMON60
VGSnn	ORACLE_HOME\TOOLS\COMMON60
Paramètres personnalisables

Les paramètres répertoriés dans la présente section contrôlent divers aspects de vos produits Oracle. Vous pouvez en modifier les paramètres pour personnaliser le comportement du produit.

Les sections ci-dessous répertorient la valeur par défaut (le cas échéant) de chacun des paramètres définis automatiquement par Oracle Installer. Les paramètres qui ne sont pas définis automatiquement sont également indiqués. Vous y trouverez également des descriptions de valeurs valides et des exemples de paramétrage.


CA_GPREFS

Valeur par défaut : ORACLE_HOME

Valeurs valides : tout répertoire sur toute unité

Exemple :

CA_GPREFS=C:\orawin95

Ce paramètre indique l'emplacement du fichier des préférences globales CAGPREFS.ORA. Les préférences globales sont partagées par les utilisateurs réseau. En plus de rechercher le répertoire indiqué par le paramètre CA_GPREFS, les produits recherchent également le répertoire en cours pour le fichier AGPREFS.ORA.

Le fichier CAGPREFS.ORA est créé automatiquement par Oracle Installer. Pour modifier les paramètres des préférences globales, faites appel à un éditeur de texte, tel que le Bloc-notes. Les préférences globales définies dans le fichier CAGPREFS.ORA peuvent être remplacées par celles du fichier des préférences locales CAUPREFS.ORA, qui est défini par le paramètre CA_UPREFS.


CA_UPREFS

Valeur par défaut : ORACLE_HOME

Valeurs valides : tout répertoire sur toute unité

Exemple :

CA_UPREFS=C:\orawin95

Ce paramètre indique l'emplacement du fichier des préférences utilisateur CAUPREFS.ORA. Ce fichier met à jour les préférences de vos produits, définies via Outils [image] Options d'outils. En plus de rechercher le répertoire indiqué par le paramètre CA_UPREFS, les produits recherchent également le répertoire en cours pour le fichier CAUPREFS.ORA.

Plusieurs produits Oracle écrivent leurs préférences dans le fichier CAUPREFS.ORA. Pour modifier les paramètres des préférences utilisateur, faites appel à une éditeur de texte, tel que le Bloc-notes. Les préférences utilisateur définies dans le fichier CAUPREFS.ORA remplacent les préférences globales définies dans le fichier CAGPREFS.ORA, qui est défini par le paramètre CA_GPREFS.


CUE_PREFS

Valeur par défaut : ORACLE_HOME

Valeurs valides : tout répertoire sur toute unité

Exemple :

CUE_PREFS=C:\orawin95

Ce paramètre indique l'emplacement du fichier des préférences des Assistants CUEPREF.RES. Ce fichier met à jour les préférences des Assistants que vous pouvez définir dans la boîte de dialogue d'options des Assistants.

Vos préférences sont enregistrées dans le fichier CUEPREF.RES chaque fois que vous quittez une application. Vous ne pouvez pas modifier ce fichier manuellement.


DEV2000_SOURCECONTROL

Valeur par défaut : aucune

Valeurs valides : mots-clés indiquant le système de contrôle de sources à utiliser avec Oracle Developer

Exemple :

DEV2000_SOURCECONTROL=PVCS

Ce paramètre indique le système de contrôle de sources que vous prévoyez d'utiliser avec Oracle Developer. Vous pouvez n'indiquez aucun système de contrôle de sources ou définir ce paramètre à la valeur 'PVCS'. La prise en charge de systèmes de contrôle de sources supplémentaires étant assurée, vous pourrez également indiquer des mots-clés pour les systèmes de contrôle de sources supplémentaires.


DEV2000_PROJECT

Valeur par défaut : aucune

Valeurs valides : mots-clés indiquant le fichier de projet du système de contrôle de sources à utiliser avec Oracle Developer

Exemple :

DEV2000_PROJECT=c:\pvcs\project1\project1.cfg

Ce paramètre indique le nom du fichier de projet pour le système de contrôle de sources sélectionné dans le paramètre DEV2000_SOURCECONTROL.


DOC60

Valeur par défaut : Oracle_Home\tools\doc60

Valeurs valides : tout répertoire sur toute unité

Exemple :

DOC60=c:\orawin95\tools\doc60

Ce paramètre indique l'emplacement des fichiers de documentation en ligne, dont l'aide en ligne, les Assistants et les Aperçus produit.


FORMS60_DEFAULTFONT

Valeur par défaut : aucune

Valeurs valides : chaîne de texte indiquant toute police valide

Exemple :

FORMS60_DEFAULTFONT="MS Sans Serif.8"

Ce paramètre indique la police par défaut utilisée pour les textes standard dans l'Editeur de présentation de Form Builder.


FORMS60_EDITOR

Valeur par défaut : aucune

Valeurs valides : nom et chemin d'un éditeur système

Exemple :

FORMS60_EDITOR=C:\windows\notepad.exe

Ce paramètre définit l'Editeur pouvant être appelé par des éléments multilignes de Form Builder dans les composants Designer ou Runform. Aucun éditeur défini par l'utilisateur ne peut être lancé à moins que ce paramètre ne soit défini.

Remarque : Lorsque vous quittez l'Editeur, le fichier doit être enregistré sous forme de fichier "ASCII seulement". Aucun format natif de système de traitement de texte n'est pris en charge.


FORMSnn_ERROR_DATE/DATETIME_FORMAT

Objectif : ces deux variables d'environnement établissent les masques de format que Forms utilisera lors de la génération des messages d'erreur Runtime émis lorsqu'un utilisateur final saisit une valeur non valide dans un élément de date ou de date/heure.

Valeur par défaut : reportez-vous à la rubrique d'aide concernant les masques de formats de date.

Valeurs valides : tout masque de format de date/de date et heure valide.

Exemple :

FORMS65_ERROR_DATE_FORMAT YYYY/MM/DD


FORMS60_JAVADIR

Valeur par défaut : Oracle_Home\forms60\java

Valeurs valides : nom et chemin de l'environnement d'exécution Oracle Java

Exemple :

FORMS60_JAVADIR=C:\orant\forms60\java

Ce paramètre définit l'emplacement des fichiers d'environnement d'exécution Oracle Java requis pour utiliser les zones Java Bean et pour afficher un aperçu des formulaires Web dans Form Builder.


FORMS60_MAPPING

Valeur par défaut : aucune

Valeurs valides : l'emplacement virtuel de votre répertoire de travail temporaire

Exemple :

FORMS60_MAPPING=http://monhôte.com/webtemp

Pour traiter des images sur le Web, Forms Server transmet des fichiers temporaires JPEG compressés. Si vous utilisez des images ou des icônes dans vos applications Web Forms, vous devez créer un répertoire temporaire et un répertoire virtuel (par exemple, C:\ORANT\WEBTEMP) où Forms Server stocke les images et les autres fichiers de travail. Vous devez également créer les variables d'environnement FORMS60_OUTPUT et FORMS60_MAPPING sur l'ordinateur où Forms Server est exécuté.


FORMS60_OUTPUT

Valeur par défaut : aucune

Valeurs valides : tout répertoire sur toute unité où Forms Server est exécuté

Exemple :

FORMS60_OUTPUT=C:\ORANT\WEBTEMP\

Pour traiter des images sur le Web, Forms Server transmet des fichiers temporaires JPEG compressés. Si vous utilisez des images ou des icônes dans vos applications Web Forms, vous devez créer un répertoire temporaire (par exemple, C:\ORANT\WEBTEMP) où Forms Server stocke les images et les autres fichiers de travail. Vous devez également créer les variables d'environnement FORMS60_OUTPUT et FORMS60_MAPPING sur l'ordinateur où Forms Server est exécuté.


FORMSnn_OUTPUT_DATE/DATETIME_FORMAT

Objectif : ces deux variables d'environnement établissent les masques de format que Forms utilisera lors des opérations de sortie Runtime sur les éléments de date et de date/heure qui ne disposent pas de leur propre masque.

Valeur par défaut : reportez-vous à la rubrique d'aide concernant les masques de formats de date.

Valeurs valides : tout masque de format de date/de date et heure valide.

Exemple :

FORMS65_OUTPUT_DATETIME_FORMAT YYYY/MM/DD HH24:MI:SS


FORMS60_PATH

Valeur par défaut : ORACLE_HOME\FORMS60\PLSQLLIB

Valeurs valides : tout répertoire sur toute unité

Exemple :

FORMS60_PATH=C:\oracle\apps\forms;C:\myfiles

Ce paramètre indique le chemin de recherche pour les fichiers utilisés dans une application Form Builder runtime. Ces fichiers comprennent les fichiers d'application Forms (.fmx), les fichiers de menu (.mmx), les bibliothèques PL/SQL (.pll) et les autres objets que l'application tente de charger depuis un fichier à l'exécution. Par exemple, si vous importez le fichier image scooter.tif, Form Builder effectue sa recherche dans les répertoires indiqués par FORMS60_PATH pour retrouver ce fichier.

FORMS60_PATH peut indiquer plusieurs répertoires. Utilisez un point-virgule pour séparer les noms de répertoire dans une liste de chemins.


FORMS60_REPFORMAT

Valeur par défaut : aucune

Valeurs valides : HTML et PDF

Exemple :

FORMS60_REPFORMAT=HTML

Si vous appelez un navigateur pour exécuter un état de grille via RUN_PRODUCT, vous devez définir la variable d'environnement FORMS60_REPFORMAT. Ce paramètre indique le format de l'état.


FORMS60_TIMEOUT

Valeur par défaut : 15

Valeurs valides : 1 à 1 440 (1 jour)

Exemple :

FORMS60_OUTPUT=1440

Ce paramètre indique le temps écoulé en minutes avant la fermeture du serveur Forms, en l'absence de communication client avec ce serveur.


FORMSnn_USER_DATE/DATETIME_FORMAT

Objectif : ces deux variables d'environnement établissent les masques de format que Forms utilisera lors de l'exécution pour extraire des valeurs des éléments de type DATE et DATETIME lorsque ces derniers ne disposent pas de leur propre masque.

Valeur par défaut : reportez-vous à la rubrique d'aide concernant les masques de formats de date.

Valeurs valides : tout masque de format de date/de date et heure valide. Vous pouvez indiquer plusieurs masques de format en les séparant par des barres verticales. Au moment de l'exécution, lors de la conversion des éléments, les masques de format sont utilisés dans l'ordre indiqué, jusqu'à ce qu'une conversion réussisse (ou jusqu'à ce que tous les masques aient été essayés).

Exemple :

FORMS65_USER_DATE_FORMAT  FXFMDD-MM-RRRR


FORMS60_USEREXITS

Valeur par défaut : aucune

Valeurs valides : toute bibliothèque de liens dynamiques de sortie utilisateur (avec le chemin absolu).

Ce paramètre vous permet de définir plusieurs fichiers DLL de sorte que ceux-ci contiennent des fonctions étrangères pouvant être appelées depuis une interface de sortie utilisateur. Le paramètre FORMS60_USEREXITS inclut une liste de fichiers DLL d'interface utilisateur séparés par des points-virgules.

FORMS60_USEREXITS peut indiquer plusieurs fichiers DLL. Utilisez une barre oblique inverse (\) pour séparer les répertoires dans un chemin, et un point-virgule (;) pour séparer les chemins complets.

Si cette valeur n'est pas définie explicitement, Form Builder prend implicitement la valeur ORACLE_HOME\BIN\F45XTB.DLL.

Exemple :

FORMS60_USEREXITS = C:\mathlib\add.dll;C:\mathlib\mult.dll


GRAPHICS60_PATH

Valeur par défaut : aucune

Valeurs valides : tout répertoire sur toute unité

Exemple :

GRAPHICS60_PATH=C:\oracle\apps\graphics;C:\myfiles

Ce paramètre indique le chemin de recherche pour les fichiers utilisés dans une application Graphics runtime. Ces fichiers comprennent les fichiers d'affichage (.ogr), les images, les interrogations externes et les autres objets que l'application tente de charger depuis un fichier à l'exécution. Par exemple, si vous importez le fichier image scooter.tif, Graphics Builder effectue sa recherche dans les répertoires indiqués par GRAPHICS60_PATH pour retrouver ce fichier.

GRAPHICS60_PATH peut indiquer plusieurs répertoires. Utilisez une barre oblique inverse (\) pour séparer les répertoires dans un chemin, et un point-virgule (;) pour séparer les chemins complets.


INTERRUPT (utilisateurs DOS SQL*Net seulement)

Valeur par défaut : aucune

Valeurs valides : même valeur qu'indiquée dans votre fichier DOS CONFIG.ORA

Ce paramètre indique l'adresse du vecteur d'interruption que les produits DOS Oracle utiliseront. Si vous vous servez d'un pilote de périphérique DOS SQL*Net pour Windows, vérifiez votre fichier CONFIG.ORA situé dans le répertoire principal (home) DOS Oracle. Si le paramètre INTERRUPT est indiqué dans CONFIG.ORA, vous devez le définir dans la base de registres à la même valeur. Si cette variable n'est pas indiquée dans vos fichiers DOS CONFIG.ORA, vous n'avez pas à les définir dans la base de registres.

Remarque : Ne définissez pas le paramètre INTERRUPT à 103 lorsque vous utilisez un produit de gestion mémoire réalisé par des tiers, tel que QEMM, 386MAX, CEMM ou EMM386. Si vous le faites, vous vous exposez à un comportement inattendu après le lancement de SQLPME et de SQL*Net.


LOCAL

Valeur par défaut : aucune

Valeurs valides : tout préfixe de pilote de périphérique SQL*Net valide, dont les paramètres de chaîne de base de données. Pour plus d'informations, reportez-vous à Oracle Network Administrator's Guide.

Ce paramètre indique le pilote de périphérique SQL*Net et la chaîne de connexion complète que le produit utilisera si vous n'indiquez pas de périphérique de communication lorsque vous vous connectez à la base de données à partir du produit.

Si vous utilisez le paramètre LOCAL, ne l'ajoutez pas à la fin du fichier. Les produits Oracle ne reconnaîtraient pas dans ce cas le paramètre LOCAL.

Remarque : Si vous faites appel à un pilote de périphérique DOS SQL*Net pour Windows, assurez-vous que le paramètre LOCAL est défini dans votre fichier CONFIG.ORA du répertoire principal (home) DOS Oracle. Si le paramètre LOCAL est indiqué dans le fichier CONFIG.ORA, vous devez le définir dans la base de registres à la même valeur.


NLS_LANG

Valeur par défaut : AMERICAN_AMERICA.WE8ISO8859P1

Valeurs valides : Reportez-vous à NLS Reference Manual pour obtenir la liste des valeurs disponibles ou consultez le fichier suivant sur votre CD : \bonus\nls\nlsd2r1.wri

Exemple :

NLS_LANG=AMERICAN_AMERICA.WE8ISO8859P1

Ce paramètre définit la langue dans laquelle s'affichent les fichiers de messages. La syntaxe pour NLS_LANG est la suivante :

NLS_LANG=<langue>_<pays>.<jeu_car>

où :

langue	Langue ainsi que ses conventions pour l'affichage des messages et des noms de jour et de mois.
pays	Pays ainsi que ses conventions pour le calcul des numéros de semaine et de jour.
Jeu_car	Jeu de caractères utilisé pour les fonctions UPPER, LOWER et INITCAP ainsi que pour le type de tri utilisé par une interrogation ORDER BY. Cet argument contrôle également le jeu de caractères utilisé pour afficher les messages.


OleCreateObjPoolInMemory

Valeur par défaut : 0

Valeurs valides : 0 ou 1

Exemple :

OleCreateObjPoolInMemory=0

Pour Report Builder, ce paramètre indique de créer le pool d'objets OLE2 dans des fichiers temporaires (0) ou en mémoire (1). La création du pool en mémoire améliore les performances en réduisant l'accès au disque. Si vous avez un grand nombre d'objets OLE2 ou des objets OLE2 volumineux (par exemple, des images), la quantité de mémoire nécessaire peut devoir être supérieure. Lorsque vous déterminez le nombre d'objets OLE2 dont vous disposez, notez qu'un objet texte standard OLE2 dans un encadrement itératif ne contient qu'un objet OLE2. Un champ OLE2 contient un objet OLE2 pour chaque instance du champ.


OleDoNotUpdateLinks

Valeur par défaut : 0

Valeurs valides : 0 ou 1

Exemple :

OleDoNotUpdateLinks=0

Pour Report Builder, ce paramètre active (0) ou désactive (1) la mise à jour des liens lorsque vous ouvrez l'Editeur de présentation ou que vous lanciez l'état. Les objets OLE2 liés contiennent des représentations en mémoire cache de leurs objets source. Ces représentations sont mises à jour par le serveur OLE2 correspondant, en fonction des données objet continuelles.

Ces mises à jour sont produites automatiquement ou manuellement selon le type de lien. La mise à jour des représentations en mémoire cache exigeant le lancement du serveur OLE2, il se peut que vous souhaitiez désactiver la mise à jour pour améliorer les performances, si vous savez que les objets source n'ont pas été modifiés ou que vous n'ayez pas besoin des dernières modifications. Notez que même si vous n'indiquez pas cette option, vous pouvez toujours annuler les mises à jour depuis la boîte de dialogue standard qui apparaît lors de la mise à jour des objets OLE2.


OleUpdateLinksPrompt

Valeur par défaut : 0

Valeurs valides : 0 ou 1

Exemple :

OleUpdateLinksPrompt=0

Pour Report Builder, ce paramètre indique de solliciter l'intervention de l'utilisateur (0) ou de ne pas solliciter son intervention (1) lorsque la source d'un objet lié est introuvable. Si la source d'un objet est introuvable au cours d'une tentative de mise à jour, une boîte de dialogue s'affiche dans laquelle vous pouvez indiquer à nouveau la source de lien ou de ne pas prendre l'erreur en compte. Si vous n'êtes pas en mesure d'accepter la boîte de dialogue (par exemple, vous exécutez l'état la nuit), il se peut que vous souhaitiez désactiver cette invite pour vous assurer que l'état s'exécute.


ORACLE_HOME

Valeur par défaut : C:\ORAWIN95

Valeurs valides : tout répertoire sur toute unité

Exemple :

ORACLE_HOME=C:\orawin95

Ce paramètre indique le répertoire principal (home) dans lequel les produits Windows Oracle sont installés. Ce répertoire se situe en haut de la hiérarchie des répertoires Oracle.

Notes d'utilisation

•	Si vous utilisez Reports Runtime, le total des longueurs d'ORACLE_HOME et ORACLE_PATH ne doit pas dépasser 255 caractères.


ORACLE_PATH

Valeur par défaut : aucune

Valeurs valides : tout répertoire sur toute unité

Exemple :

ORACLE_PATH=C:\oracle\apps\forms;C:\oracle\apps\graphics;
C:\oracle\apps\reports

Ce paramètre indique le chemin de recherche pour les fichiers référencés par Forms, Graphics ou Reports Runtime. Notez que les répertoires indiqués par ORACLE_PATH sont recherchés après ceux qui sont mentionnés par un paramètre propre à un produit. : FORMS60_PATH, GRAPHICS60_PATH ou REPORTS60_PATH.

ORACLE_PATH peut indiquer plusieurs répertoires. Utilisez un point-virgule (;) pour séparer les noms de répertoire dans une liste de chemins.

Notes d'utilisation

•	Si vous utilisez Reports Runtime, le total des longueurs d'ORACLE_HOME et ORACLE_PATH ne doit pas dépasser 255 caractères.


ORAINFONAV_DOCPATH

Valeur par défaut : aucune

Valeurs valides : tout répertoire sur toute unité

Exemple :

ORAINFONAV_DOCPATH=C:\orawin95\oin

Ce paramètre indique l'emplacement de la table des matières et de l'index pour votre documentation en ligne.


REMOTE

Valeur par défaut : aucune

Valeurs valides : tout préfixe et paramètre de pilote de périphérique SQL*Net valide

Exemple :

REMOTE=P:PIPER

Ce paramètre indique le pilote de périphérique SQL*Net par défaut et éloigné à utiliser lors d'une connexion via une base de données locale. Il peut inclure les paramètres SQL*Net par défaut (chaîne de base de données complète).

P: est le préfixe réseau pour les canaux de communication nommés, et Piper le nom de la base de données.

Si un utilisateur se connecte et indique une connexion avec un préfixe de pilote de périphérique explicite correspondant à celui qui est mentionné dans REMOTE, mais sans indiquer de paramètres SQL*Net, les paramètres de REMOTE sont utilisés. Le paramètre REMOTE permet à l'administrateur de bases de données de définir une connexion réseau "normale" pour laquelle l'utilisateur SQL*Net n'a pas à indiquer de paramètres de connexion. Vous pouvez à tout moment redéfinir ce paramètre dans la ligne de commande.

Remarque : Si vous utilisez un pilote de périphérique DOS SQL*Net pour Windows, assurez-vous que le paramètre REMOTE est défini dans votre fichier CONFIG.ORA du répertoire principal (home) DOS Oracle. Si REMOTE est indiqué dans CONFIG.ORA, vous devez le définir à la même valeur dans la base de registres.


REPORTS60_CGIDIAGBODYTAGS

Pour Reports Web CGI, ce paramètre indique les marques HTML insérées en tant que marques <BODY…> dans la sortie de diagnostic/de débogage de RWCGI60. Par exemple, vous pouvez utiliser cette variable d'environnement pour définir la couleur et l'image du texte/de l'arrière-plan.


REPORTS60_CGIDIAGHEADTAGS

Pour Reports Web CGI, ce paramètre indique les marques HTML insérées entre les marques <HEAD> … </HEAD> dans la sortie de diagnostic/de débogage de RWCGI60. Par exemple, vous pouvez utiliser cette variable d'environnement pour définir la marque <TITLE> ou <META…>.


REPORTS60_CGIHLP

Pour Reports Web CGI, ce paramètre définit l'URL/URI du fichier d'aide RWCGI60, à laquelle vous accédez en appelant le fichier RWCGI60 à l'aide de la demande vide :

http://votre_serveurweb/votre_rep_cgi_virtuel/rwcgi60.exe?

Par exemple, si vous définissez REPORTS60_CGIHLP sur http://www.yahoo.com, vous accédez à cette URL ; si vous la définissez sur monfichieraide.htm, le fichier suivant apparaît :

http://votre_serveurweb/monfichieraide.htm

Si cette variable n'est pas définie, un écran d'aide par défaut apparaît.


REPORTS60_CGIMAP

Pour Reports Web CGI, ce paramètre définit l'emplacement/le nom de fichier complet du fichier de correspondance RWCGI60 si le type de configuration suivant est utilisé :

c:\orant\report60\mymap.dat


REPORTS60_CGINODIAG

Pour Reports Web CGI, ce paramètre, s'il est défini, désactive toutes les sorties de débogage/de diagnostic de RWCGI60.

http://votre_serveurweb/cgi-bin/rwcgi60.exe/help?

Note d'utilisation :

Ce paramètre ne fonctionne pas si REPORTS60_CGINODIAG est défini.


REPORTS60_CGIPATHONLYURL

Pour Reports Web CGI, ce paramètre, s'il est défini (quelle que soit sa valeur), contraint RWCGI60 à renvoyer toutes les URL au Navigateur sous la forme d'URL partielles ne comportant que le chemin d'accès ; ainsi, au lieu de renvoyer :

Emplacement : http://votre_serveurweb:port/chemin_accès

il renvoie :

Emplacement : /chemin_accès

Cette variable permet de résoudre les problèmes rencontrés lorsqu'un serveur Web est configuré sur plusieurs ports, y compris un port par défaut.


REPORTS60_COOKIE_EXPIRE

Valeur par défaut : 30

Valeurs valides : toute durée (en minutes)

Exemple :

REPORTS60_COOKIE_EXPIRE=30

Pour Reports Server Security, ce paramètre détermine le temps d'inactivité du cookie (par exemple, REPORTS60_COOKIE_EXPIRE=30). Les cookies enregistrent les noms utilisateur et les mots de passe codés chez le client. Lorsque CGI reçoit un cookie du client, il compare le temps enregistré dans le cookie avec l'heure système actuelle.

Si ce temps écoulé dépasse le nombre de minutes défini dans le paramètre REPORTS60_COOKIE_EXPIRE (par exemple, 30 minutes), CGI rejette le cookie, et renvoie au client la grille d'authentification de la base de données et un message d'erreur. L'utilisateur doit de nouveau s'authentifier pour exécuter l'état.


REPORTS60_DB_AUTH

Valeur par défaut : dbauth.htm

Valeurs valides : tout fichier HTML qui contient des actions d'authentification spéciales. La conservation de la valeur par défaut est recommandée.

Exemple :

REPORTS60_DB_AUTH=dbauth.htm

Indique le modèle d'authentification de base de données utilisé lors de la connexion à la base de données.


REPORTS60_SYS_AUTH

Valeur par défaut : sysauth.htm

Valeurs valides : tout fichier HTML qui contient des actions d'authentification spéciales. La conservation de la valeur par défaut est recommandée.

Exemple :

REPORTS60_SYS_AUTH=sysauth.htm

Indique le modèle d'authentification utilisé pour authentifier le nom utilisateur et le mot de passe lorsque les utilisateurs exécutent des demandes d'état sur un serveur Reports Server à accès restreint.


REPORTS60_ENCRYPTION_KEY

Valeur par défaut : Reports6.0

Valeurs valides : toute clé de chiffrement

Exemple :

REPORTS60_ENCRYPTION_KEY=reports6.0

Indique la clé de chiffrement utilisée pour coder le nom utilisateur et le mot de passe.


REPORTS60_REPORTS_SERVER

Valeurs valides : tout nom d'entrée de service Reports Server

Exemple :

REPORTS60_REPORTS_SERVER=repserver

Indique le serveur Reports Server par défaut pour les demandes Web Cartridge ou Web CGI. Lorsque ce paramètre est défini, vous pouvez omettre l'argument de ligne de commande SERVER dans les demandes d'état pour les traiter sur le serveur par défaut ou inclure l'argument de ligne de commande SERVER pour ignorer le serveur par défaut.


REPORTS60_OWSDIAGBODYTAGS

Pour Reports Web Cartridge, indique les marques HTML insérées comme marque <BODY…> dans la sortie de diagnostic/de débogage de RWOWS60. Par exemple, vous pouvez utiliser cette variable d'environnement pour définir la couleur d'un texte/d'un arrière-plan, son image, etc.


REPORTS60_OWSDIAGHEADTAGS

Pour Reports Web Cartridge, ce paramètre indique les marques HTML insérées entre les marques <HEAD> …</HEAD> dans la sortie de diagnostic/de débogage de RWOWS60. Par exemple, vous pouvez utiliser cette variable d'environnement pour définir les marques <TITLE> ou <META…>, etc.


REPORTS60_OWSHELP

Valeurs valides : tout chemin d'accès et tout nom de fichier, ou toute URL

Pour Reports Web Cartridge, ce paramètre définit l'URL/URI du fichier d'aide RWOWS60, à laquelle vous accédez lorsque vous appelez RWOWS60 à l'aide de la demande vide :

http://votre_serveurweb/rwows60?

Par exemple, si vous la définissez sur http://www.yahoo.com, vous accédez à cette URL ; si vous la définissez sur monfichieraide.htm, le fichier suivant apparaît :

http://votre_serveurweb/monfichieraide.htm

Si ce paramètre n'est pas défini, un écran d'aide par défaut apparaît.


REPORTS60_OWSMAP

Pour Reports Web Cartridge, ce paramètre définit l'emplacement/le nom de fichier complet du fichier de correspondance RWOWS60 (si la configuration suivante est utilisée) :

C:\ORANT\REPORTS60\MYMAP.DAT


REPORTS60_OWSNODIAG

Pour Reports Web Cartridge, ce paramètre, s'il est défini, désactive la sortie de débogage/de diagnostic de RWOWS60 :

http://votre_serveurweb/rwows60/aide

Ce paramètre ne fonctionne pas lorsque REPORTS60_OWSNODIAG est défini.


REPORTS60_OWSPATHONLYURL

Pour Reports Web Cartridge, ce paramètre, s'il est défini (quelle que soit sa valeur), contraint RWOWS60 à utiliser uniquement des URL ne comprenant qu'un chemin d'accès (par exemple, "/rscache/..." au lieu de "http://mywebsrv.com:1550/rscache/...") dans la réorientation HTTP vers la sortie d'état, ainsi que dans la sortie de diagnostic générée par RWOWS60. Ce paramètre est utile lorsque vous voulez contraindre le Navigateur client à conserver la demande d'URL initiale dans son fichier d'emplacement après qu'il a extrait la sortie d'état. En principe, RWOWS60 modifie l'URL pour qu'elle indique l'emplacement de la sortie d'état (le répertoire indiqué par REPORTS60_WEBLOC). Elle affiche également le nom du fichier de sortie d'état, qui est peu significatif (par exemple, 12345679.htm), car ce fichier vient d'être généré. La définition de ce paramètre permet d'éviter cette modification. Cela n'est valable que si toutes les URL utilisent le port par défaut (généralement 80).

La définition de ce paramètre présente cependant un inconvénient : tous les fichiers subsidiaires (comme les fichiers d'images) qui dépendent du fichier principal de sortie d'état ne sont pas extraits par le Navigateur (malgré une création réussie à l'emplacement désigné par REPORTS60_WEBLOC). Pour pallier à ce problème, indiquez une marque <BASE HREF="..."> ou <META HREF="..."> (l'emplacement du fichier principal correspondant à une URL complète ou partielle) dans la définition d'état afin qu'elle soit incluse dans le fichier principal de sortie d'état. Vous pouvez également définir REPORTS60_WEBLOC pour qu'il désigne l'emplacement de l'exécutable RWOWS60.

La définition de REPORTS60_OWSPATHONLYURL permet également de résoudre certains problèmes de configuration Intranet/Internet dans lesquelles un même ordinateur dispose simultanément de plusieurs adresses IP (et de plusieurs cartes réseau). En effet, elle supprime la dépendance de la réorientation HTTP vers le nom de l'ordinateur ou l'adresse IP.


REPORTS60_PATH

Valeur par défaut : ORACLE_HOME\REPORT60\DEMO ; ORACLE_HOME\REPORT60\DEMO\BITMAP ; ORACLE_HOME\REPORT60\DEMO\REQFILES

Valeurs valides : tout répertoire sur toute unité

Exemple :

REPORTS60_PATH=C:\oracle\apps\reports;C:\myfiles

Cette variable d'environnement sert à localiser des états et des objets externes que vous utilisez dans vos états, tels que des bibliothèques PL/SQL, des interrogations externes et des textes standard externes. Elle vous permet de créer des états facilement portables d'un système d'exploitation à l'autre, sans que vous ayez à coder les chemins de répertoire.

Remarque : la variable REPORTSPATH est limitée à 256 caractères.

Définissez la variable REPORTS60_PATH de la même façon que vous le faites pour les autres variables d'environnement sur votre système d'exploitation, sans oublier les règles propres à la plate-forme, telles que la longueur du chemin, etc.

En plus des chemins de répertoire, vous pouvez indiquer le mot-clé DB lorsque vous définissez REPORTS60_PATH. Ce mot-clé ordonne à Report Builder d'effectuer sa recherche dans la base de données à laquelle vous êtes connecté.

Supposons que vous ayez indiqué l'instruction suivante sur une plate-forme Unix :

setenv REPORTS60_PATH
/home/tkostin/pay:/home/tkostin/receive:DB

Report Builder effectue d'abord sa recherche dans le répertoire /home/tkostin/pay. S'il ne trouve pas le fichier en question, il le recherche dans /home/tkostin/receive. S'il ne le trouve toujours pas, il le recherche dans la base de données à laquelle vous vous êtes connecté en début de session Report Builder.


REPORTS60_TERMINAL

Valeur par défaut : aucune

Valeurs valides : tout répertoire sur toute unité

Exemple :

REPORTS60_TERMINAL=C:\mytermdefs

Cette variable d'environnement permet de localiser les définitions de terminal que vous utilisez dans vos états en mode caractère. Le chemin indiqué pour cette variable a priorité sur la variable d'environnement ORACLE_TERMINAL.

Définissez la variable REPORTS60_TERMINAL de la même façon que vous le faites pour les autres variables d'environnement sur votre système d'exploitation, sans oublier les règles propres à la plate-forme, telles que la longueur du chemin, etc.


REPORTS60_TMP

Valeur par défaut : aucune

Valeurs valides : tout répertoire sur toute unité

Exemple :

REPORTS60_TMP=C:\tmp

Cette variable d'environnement établit le répertoire dans lequel vous souhaitez stocker des fichiers temporaires Report Builder. Report Builder n'utilise à cette fin qu'un seul répertoire ; n'en définissez qu'un.

Définissez la variable REPORTS60_TMP de la même façon que vous le faites pour les autres variables d'environnement sur votre système d'exploitation, sans oublier les règles propres à la plate-forme, telles que la longueur du chemin, etc. Si vous ne définissez pas la variable REPORTS60_TMP, elle prend par défaut la valeur du répertoire de travail en cours.


REPORTS60_USEREXIT

Valeur par défaut : aucune

Valeurs valides : toute bibliothèque de liens dynamiques de sortie utilisateur (avec son chemin absolu)

Exemple :

REPORTS60_USEREXIT=C:\mydll.dll;d:\mynew.dll;e:\bin\speed.dll

Ce paramètre vous permet de définir plusieurs fichiers DLL qui seront utilisés par Report Builder et ses exécutables associés (Reports Runtime, par exemple). Ces fichiers DLL sont des modules de programme créés par vous et qui seront appelés par les exécutables Report Builder.

REPORTSS60_USEREXITS peut indiquer plusieurs fichiers DLL. Utilisez une barre oblique inverse (\) pour séparer les répertoires dans un chemin, et un point-virgule (;) pour séparer les chemins complets.

Si cette valeur n'est pas définie explicitement, Report Builder recherche 60xtb32.dll en fonction de la variable de chemin du système.


UI_ICON

Valeur par défaut : aucune

Valeurs valides : tout répertoire accessible sur toute unité

Exemple :

UI_ICON=C:\icon

Cette variable d'environnement établit le répertoire dans lequel vous souhaitez stocker des icônes pour boutons utilisées dans votre présentation. Report Builder n'utilise à cette fin qu'un seul répertoire ; n'en définissez qu'un.

Définissez la variable UI_ICON de la même façon que vous le faites pour les autres variables d'environnement sur votre système d'exploitation, sans oublier les règles propres à la plate-forme, telles que la longueur du chemin, etc.


USERNAME

Valeur par défaut : aucune

Valeurs valides : tout nom utilisateur Oracle valide (sans le préfixe OPS$)

Exemple :

USERNAME=dsanvita

Ce paramètre indique la partie variable d'un compte de connexion par défaut. Pour plus d'informations sur la définition du paramètre USERNAME, reportez-vous à la documentation de votre base de données.


WIN_REMOTE_SESSIONS

Valeur par défaut : aucune

Valeurs valides : 0-33

Lorsque vous tentez de vous connecter, si vous recevez l'un des messages d'erreur compris entre ORA-3100 et ORA-3199, il se peut que la mémoire réelle soit insuffisante pour établir un tampon de communication avec un serveur Oracle. NETINIT7.EXE résout ce problème en réservant de l'espace mémoire pour les connexions de serveur.

Ce paramètre définit le nombre de connexion à un serveur éloigné pour lequel NETINIT7 doit réserver de l'espace mémoire. Rappelez-vous les règles suivantes lorsque vous définissez le paramètre WIN_REMOTE_SESSIONS :

•	Si vous définissez WIN_REMOTE_SESSIONS à 0, NETINIT7 ne réserve aucun espace mémoire pour les connexions de serveur éloigné.

•	La définition de WIN_REMOTE_SESSIONS aux valeurs 1 à 33 réserve de l'espace mémoire pour le nombre de connexions indiqué. Notez que NETINIT7 réserve 12 Ko de mémoire réelle pour chaque connexion de serveur éloigné.

•	La valeur par défaut proposée pour WIN_REMOTE_SESSIONS est 5. La définition de WIN_REMOTE_SESSIONS à cette valeur doit créer un nombre de sessions suffisant pour vous permettre de lancer plusieurs produits.

•	Si vous n'ajoutez pas le paramètre WIN_REMOTE_SESSIONS, NETINIT7 réserve de l'espace mémoire pour une connexion de serveur éloigné.

Pour utiliser NETINIT7, procédez comme suit :

1	Configurez le nombre de sessions en ajoutant le paramètre WIN_REMOTE_SESSIONS.

2	Créez l'icône NETINIT7 dans votre groupe de programmes Oracle. (Pour plus d'informations sur la création des icônes, reportez-vous à la documentation Microsoft Windows.) Entrez le chemin suivant dans le champ Ligne de commande de la boîte de dialogue Propriétés d'élément du programme Windows :

ORACLE_HOME\bin\netinit7.exe

3	Lancez NETINIT7 en cliquant deux fois sur l'icône dans le groupe de programmes Oracle. Assurez-vous d'avoir lancé NETINIT7 avant de démarrer un produit. Si vous voulez que NETINIT7 soit lancé automatiquement au démarrage de Windows, ajoutez l'icône NETINIT7 dans le groupe de programmes Démarrer de Windows.

NETINIT7 tente de réserver de l'espace mémoire réelle pour le nombre configuré de connexions de serveur. S'il ne peut pas affecter l'espace mémoire nécessaire, il affiche un message d'avertissement et indique le nombre réel de sessions pour lequel il a affecté de l'espace mémoire.

Après avoir affecté de l'espace mémoire, NETINIT7 se minimalise. La remise à l'état initial de NETINIT7 affiche le nombre total de sessions configuré ainsi que la quantité totale de mémoire utilisée. La fermeture de NETINIT7 libère toute la mémoire de session inutilisée. Si une application utilise encore de la mémoire de session, NETINIT7 vous signale que cette application doit être fermée avant que la mémoire de session puisse être libérée.

Remarque : Si vous démarrez un produit avant NETINIT7, celui-ci affecte sa propre mémoire de session, laquelle n'est pas reconnue par NETINIT7. NETINIT7 tente d'affecter la mémoire de session configurée en plus de la mémoire déjà affectée par le produit que vous avez démarré.


XMITTR(utilisateurs DOS seulement)

Valeur par défaut : aucune

Valeurs valides : même valeur qu'indiquée dans votre fichier DOS CONFIG.ORA

Ce paramètre ne s'applique qu'aux utilisateurs d'exécutables en mode protégé Oracle DOS. Vérifiez votre fichier CONFIG.ORA qui se trouve dans le répertoire principal (home) DOS Oracle. Si le paramètre XMMITR est indiqué dans CONFIG.ORA, vous devez le définir à la même valeur dans la base de registres. Si cette variable n'est pas indiquée dans vos fichiers DOS CONFIG.ORA, il n'est pas nécessaire de la définir dans la base de registres.

XMMITR (Extended Memory Manager Interrupt Vector) est une variable indiquant le vecteur d'interruption à utiliser pour le point d'entrée des services d'interruption du gestionnaire de mémoire étendue/pilote de périphérique de transition de mode XMM/MTD. Pour définir un vecteur différent, le nouveau vecteur d'interruption doit être exprimé sous forme décimale. XMMITR ne doit être utilisé que si un autre programme dans votre système nécessite des interruptions de numération décimale 100 ou hexadécimale 64.

Remarque : Ne définissez pas le paramètre XMMITR à 103 lorsque vous utilisez un produit de gestion mémoire réalisé par des tiers, tel que QEMM, 386MAX, CEMM ou EMM386. Si vous le faites, vous vous exposez à un comportement inattendu après le lancement de SQLPME et de SQL*Net.


Conversion PL/SQL V1 - exemples

  Rubriques connexes 	   Tous les exemples

Suppression des expressions par défaut

Ajout de NULL à RETURN

Remplacement de procédures internes obsolètes

Fonction de longueur

Transfert de NULL vers un sous-programme surchargé

Instruction RETURN manquante

Modification du nom des procédures uniquement dans un package

Suppression du préfixe de package

Mot réservé

Suppression de contraintes de longueur

Déclarations de variables


Boîte de dialogue de sélection de tables de données

  Rubriques connexes

Description  La boîte de dialogue de sélection de tables de données vous permet d'inclure dans votre interrogation des objets de source de données provenant de la base de données connectée.

Cette boîte de dialogue contient les éléments suivants :

Afficher	Indique si les tables, vues, interrogations, clichés et/ou synonymes peuvent être affichés dans la liste.
Zone déroulante	Indique la source de données contenant les objets à afficher. Vous pouvez également sélectionner une table d'un compte ou d'une base de données distincts.
Sélectionner tables de données	Fournit la liste des objets de source de données que vous pouvez inclure dans votre interrogation. Conseil
Infos	Affiche des informations sur l'objet sélectionné : type, nom, propriétaire, date de création et commentaires.
Inclure	Incorpore l'élément sélectionné dans l'espace de travail de Query Builder.
Fermer	Ferme la boîte de dialogue sans incorporer d'objet de source de données.


Accès à d'autres comptes de la base de données en cours

  Rubriques connexes

Pour accéder aux tables situées dans d'autres comptes de la base de données en cours :

1	Cliquez sur le nom de la base de données en cours. Le bouton Inclure est remplacé par le bouton Ouvrir et la zone de liste répertorie les comptes de cette base de données.

2	Cliquez sur le nom du compte à ouvrir.

3	Cliquez sur Ouvrir ou cliquez deux fois sur le nom du compte. Query Builder affiche la liste des tables de ce compte et le bouton Inclure réapparaît à la place du bouton Ouvrir, ce qui vous permet d'inclure des tables selon la procédure habituelle.


Ouverture d'autres comptes

  Rubriques connexes

Si la table qui vous intéresse n'est pas répertoriée dans la base de données en cours, vous pouvez explorer d'autres comptes et d'autres bases de données, et sélectionner des tables dans ces comptes.

Pour explorer d'autres comptes et bases de données :

1	Cliquez dans la case située au-dessus de la liste des tables. Deux éléments apparaissent : le nom de la base de données en cours et le mot Bases de données.

2	Pour accéder à des tables situées dans d'autres comptes de la base de données en cours, cliquez ici.

Si vous ne parvenez pas à vous connecter à une base de données répertoriée, la liaison peut être non valide du fait d'un problème réseau ou de la modification d'un mot de passe à distance. Demandez l'intervention de l'administrateur de base de données.


Inclusion multiple d'une table

  Rubriques connexes

Lorsque vous incluez plusieurs fois la même table dans une interrogation, un alias est automatiquement affecté aux tables en double. Cet alias contient le nom de la table de base, suivi d'un trait de soulignement et d'une séquence alphanumérique.


Boîte de dialogue de sélection de tables en relation

 Description  La boîte de dialogue de sélection de tables en relation vous permet d'incorporer dans la fenêtre Interrogation des tables liées à la table sélectionnée.

Cette boîte de dialogue contient les éléments suivants :

Afficher	Option non disponible.
Boîte déroulante	Indique si toutes les tables liées doivent, ou non, être affichées.
Sélectionner tables de données	Répertorie les tables liées disponibles. Conseil
Infos	Affiche des informations relatives à la table sélectionnée : type, nom, propriétaire, date de création et commentaires.
Inclure	Incorpore la table sélectionnée.
Fermer	Ferme la boîte de dialogue sans incorporer de table liée.


Boîte de dialogue de changement de nom de table

  Rubriques connexes

Description  La boîte de dialogue de changement de nom de table vous permet de renommer la table active.

Cette boîte de dialogue contient les éléments suivants :

Nom de table par défaut	Indique le nom de la table.
Zone de liste	Fournit la liste des tables que vous avez ouvertes en vue de les renommer.
Nouveau nom	Indique le nouveau nom de la table.
Définir	Met à jour le nom de la table tout en maintenant la boîte de dialogue ouverte.


Identification d'une table dont le nom a été modifié

Dans les interrogations stockées, une distinction immédiate du type de nom d'une table donnée (nom défini par l'utilisateur ou nom d'origine) s'avère impossible.

Pour vérifier si le nom d'une table donnée a été modifié :

1	Cliquez sur [image] dans la barre d'icônes.

2	Dans la liste Tables disponibles, cliquez sur cette table.

Si le nom de la table a été modifié, l'alias apparaît dans le champ Nouveau nom et un autre nom (le nom d'origine de la table) apparaît dans le champ Nom de table par défaut.

Les utilisateurs SQL peuvent également identifier les tables renommées en cliquant sur [image] dans la barre d'icônes. Cette opération ouvre la boîte de dialogue Afficher instructions SQL, où toutes les modifications de nom apparaissent dans l'instruction SELECT, dans la syntaxe SQL standard des alias de table.


Boîte de dialogue de définition de relation

  Rubriques connexes

Description  La boîte de dialogue de définition de relation vous permet de créer entre deux tables des relations simples, composées, sans correspondance, sans égalité et des auto-relations.

Cette boîte de dialogue contient les éléments suivants :

Relation	Indique les noms des colonnes d'origine (dans A->) et cible (dans B->).
Opérateur	Indique le type de relation entre les colonnes.
Intégrer relation dans interro	Indique si la relation sera utilisée dans l'interrogation. Par défaut, cette case est cochée.
Bouton d'option A introuvable dans B	Indique que les données extraites sont celles communes aux deux tables, plus les données qui sont dans la table A, mais non dans la table B.
Bouton d'option B introuvable dans A	Indique que les données extraites sont celles communes aux deux tables, plus les données qui sont dans la table B, mais non dans la table A.
Bouton d'option Supprimer discordances	Par défaut. Indique que les données extraites sont communes aux deux tables.


A propos des relations

  Rubriques connexes

Une base de données relationnelle se compose d'un certain nombre de tables en relation. Chaque table se compose de colonnes (parfois appelées champs) disposées verticalement. Chaque colonne a un nom et contient un type de données particulier.

Les relations, ou jointures, définissent la façon dont une colonne d'une table est reliée à une colonne d'une autre table. Dans de nombreux cas, les relations dont vous avez besoin sont déjà définies dans la base de données. Les relations diminuent également la redondance des données. Lorsqu'il existe une relation entre des colonnes de différentes tables, vous pouvez utiliser ces tables ensemble dans une interrogation. Remarque

Les colonnes en relation n'ont pas toujours le même nom. Vous pouvez toujours établir une relation entre des colonnes qui ont le même type de données et, dans certains cas, entre des colonnes dont les données sont de type différent, si la relation a un sens. Par exemple, vous pouvez toujours relier une colonne de données de type numérique à une colonne de type caractère, car un nombre peut également être interprété comme un caractère. En fait, vous pouvez relier pratiquement n'importe quelle colonne (à l'exception des colonnes contenant du texte long) à des colonnes de type caractère.

Les relations peuvent être définies par l'utilisateur (temporaires) ou créées dans le dictionnaire de données sous-jacent. Les relations du dictionnaire de données apparaissent automatiquement lorsque vous incorporez des tables en relation (c'est-à-dire des tables qui ont une relation clé primaire/clé étrangère). Ces relations sont toujours valides et vous pouvez donc toujours les utiliser. Elles peuvent être créées ou modifiées dans Schema Builder.

Les relations définies par l'utilisateur ne sont valides que pour l'interrogation dans laquelle vous les créez. La création d'une relation définie par l'utilisateur n'établit pas de relation permanente correspondante dans la table sous-jacente. La principale différence entre les deux est que, dans le cas d'une relation définie par l'utilisateur, vous devez tracer la ligne de relation alors que dans une relation stockée dans la base de données, Query Builder la trace pour vous.

Remarque (concerne uniquement Report Builder) : Les liaisons de données de Report Builder ne sont pas identiques aux relations de Query Builder. Les liaisons de données de Report Builder sont créées entre plusieurs interrogations, tandis que les relations Query Builder (ou jointures) sont créées à l'intérieur d'une même interrogation. Pour plus d'informations, reportez-vous à l'aide en ligne de Report Builder.


Activation et désactivation d'une relation

  Rubriques connexes

Les relations que vous créez en utilisant la souris sont automatiquement activées et désactivées dans une interrogation en fonction des besoins. Les relations actives sont affichées avec une ligne noire épaisse, et les relations inactives avec des lignes grisées.

Pour activer manuellement une relation en utilisant la souris :

  Cliquez deux fois sur une ligne de relation inactive.

Pour désactiver une relation :

  Cliquez deux fois sur une ligne de relation active.


Boîte de dialogue de définition de colonne

Description La boîte de dialogue de définition de colonne vous permet de créer dans votre interrogation une nouvelle colonne fondée sur les valeurs d'une autre. Les colonnes définies apparaissent dans la fenêtre Sources de données et dans la fenêtre Résultats.

Cette boîte de dialogue contient les éléments suivants :

Colonnes définies	Indique le nom de la colonne que vous voulez créer.
Zone de liste	Fournit la liste des colonnes définies existantes.
Définies comme	Indique l'expression de la colonne sélectionnée.
Définir	Applique la définition à la colonne.
Supprimer	Supprime la colonne sélectionnée.
Coller colonne	Affiche la boîte de dialogue de collage de colonne.
Coller fonct.	Affiche la boîte de dialogue de collage de fonction.
Remarque : La colonne définie n'est qu'une partie de votre interrogation et ne modifie pas la définition de table enregistrée dans la base de données.


Boîte de dialogue de tri

Description La boîte de dialogue de tri vous permet de trier les données de votre interrogation en fonction des colonnes de votre table.

Cette boîte de dialogue contient les éléments suivants :

Colonnes disponibles	Fournit la liste des colonnes de table que vous pouvez trier dans la fenêtre Résultats.
Colonnes triées	Fournit la liste des colonnes de table qui sont triées dans la fenêtre Résultats.
Copier	Copie, dans la liste Colonnes triées, la colonne sélectionnée dans la liste Colonnes disponibles.
Supprimer	Supprime la colonne sélectionnée de la liste Colonnes triées.
Ordre de tri	Trie la colonne sélectionnée en ordre ascendant ou descendant. L'option par défaut est Ascendant.


Aide de Query Builder

  Rubriques connexes

Création d'une nouvelle interrogation

Ajout de conditions à une interrogation

Création d'une relation simple

Définition d'une colonne

Tri des données d'interrogation


A propos de Query Builder

  Rubriques connexes

Oracle Query Builder est un outil d'accès aux données facile à utiliser, conçu pour les analystes, les managers et, au sens large, tous les professionnels. Il offre un moyen logique et intuitif d'accéder aux informations stockées dans les bases de données de l'entreprise, pour les analyser et créer des états.

Query Builder est conçu pour les professionnels qui n'ont pas de connaissance spéciale de la programmation ou des bases de données. Toutefois, grâce à ses puissantes fonctions d'interrogation et sa prise en charge des instructions SQL (Structured Query Language), Query Builder répond aussi aux attentes des programmeurs et des utilisateurs qui connaissent bien les bases de données.

Dans la fenêtre Interrogation de Query Builder, vous pouvez demander à accéder à des données de la ou des bases de données de votre entreprise. La demande de données est appelée interrogation.

Query Builder vous permet de définir presque toutes les interrogations que vous pouvez créer via l'instruction SQL SELECT. Il génère automatiquement la clause SELECT FROM [table.colonne] appropriée à partir des colonnes affichées dans l'espace de travail Query Builder.


Boîte de dialogue Séquence de colonne

Description : La boîte de dialogue Séquence de colonne vous permet d'ajuster le résultat de votre interrogation dans l'espace de travail de Query Builder.

Cette boîte de dialogue contient les éléments suivants :

Colonnes disponibles	Fournit la liste des colonnes de table que vous pouvez afficher dans l'espace de travail de Query Builder. Conseil
Colonnes affichées	Fournit la liste des colonnes de table actuellement affichées dans l'espace de travail de Query Builder.
Copier	Copie dans la liste Colonnes affichées la colonne sélectionnée dans la liste Colonnes disponibles.
Supprimer	Supprime la colonne sélectionnée de la liste Colonnes affichées.
Mise en forme	Affiche la boîte de dialogue de mise en forme.
Totaux	Affiche la boîte de dialogue de totaux.
Exécuter	Exécute l'interrogation.


Boîte de dialogue de collage de colonne

  Rubriques connexes

Description  La boîte de dialogue de collage de colonne vous permet de coller dans votre interrogation une colonne d'une table sélectionnée.

Cette boîte de dialogue contient les éléments suivants :

Zone de liste	Fournit la liste des colonnes que vous pouvez coller. Conseil


Boîte de dialogue de collage de fonction

Description  La boîte de dialogue de collage de fonction vous permet de coller une fonction dans votre condition ou votre interrogation.

Cette boîte de dialogue contient les éléments suivants :

Afficher catégories	Indique les types de fonction qui apparaissent dans la liste : nombre, caractère, date, conversion, groupe, autre.
Zone de liste	Fournit la liste des fonctions disponibles dans la catégorie sélectionnée.
Coller arguments	Indique si l'argument (l'expression figurant entre parenthèses dans une fonction, et qui fournit des informations que la fonction doit utiliser) doit être incorporé ou non.


Boîte de dialogue d'affichage des instructions SQL

  Rubriques connexes

La boîte de dialogue d'affichage des instructions SQL répertorie les instructions SQL utilisées dans votre interrogation. Vous ne pouvez ni modifier ni copier les instructions SQL de cette boîte de dialogue.


Colonne(s) identifiant de manière unique chaque ligne de la table. Les clés primaires apparaissent en caractères gras.


Colonne faisant référence aux valeurs de clé primaire d'une autre table. Les clés étrangères apparaissent en italique.


Sources, notamment les tables, les vues, les interrogations, les synonymes et les clichés, à partir desquelles une interrogation extrait des données.


Source de données composée de colonnes provenant d'une ou de plusieurs tables de base de données combinées en une seule table logique.


Chaîne comportant une fonction ou une opération, et la ou les colonnes de base de données sur lesquelles porte la fonction ou l'opération (par exemple, SALARY+COMMISSION).


Pour respecter les conventions d'appellation, chaque nom d'interrogation doit commencer par une lettre et ne pas dépasser 30 caractères alphanumériques. Si vous ne respectez pas ces conventions lorsque vous nommez les interrogations de base de données, Query Builder convertit le nom en une valeur "littérale" (entre guillemets).


A propos de la fenêtre Conditions

La fenêtre Conditions est une partie de la fenêtre Interrogation, qui contient le champ Condition dans lequel vous entrez des expressions et des conditions. Les conditions de Query Builder génèrent automatiquement les clauses WHERE ou HAVING qui conviennent.

Les noms de table et de colonne indiquent les colonnes qui seront filtrées dans la condition. Vous pouvez omettre le nom de la table si le nom de la colonne est unique. Conseil

Remarque : Lorsque vous activez le champ Condition, le curseur prend la forme d'un signe (+) qui indique que chaque élément sur lequel vous cliquez sera ajouté à votre condition. Pour le désactiver, cliquez sur [image] dans la barre d'icônes.


A propos de la fenêtre Interrogation

Lorsque vous ouvrez une interrogation, Query Builder l'affiche dans la fenêtre Interrogation, qui est divisée en deux fenêtres :

•	La fenêtre Conditions, qui contient le champ Condition. Elle permet d'affiner l'interrogation.

•	la fenêtre Source de données, qui affiche les tables (vues, clichés, etc.) utilisées dans l'interrogation.

Les fenêtres peuvent être divisées verticalement ou horizontalement, selon votre préférence.

Chaque table est affichée dans une zone contenant le nom de la table et le nom des colonnes qu'elle contient. Des icônes permettent d'identifier l'objet de base de données en cours. Elles indiquent si des commentaires descriptifs sont attachés, le type de source de données, le type de données de la colonne et si des index ont, ou non, été définis pour les tables de l'interrogation.

L'existence de relations entre des colonnes est matérialisée par un tracé de ligne. Les relations définies entre des tables identifient la façon dont une colonne d'une table est liée à une colonne d'une autre table.

Une coche à gauche du nom de la colonne indique que la colonne a été incorporée dans l'interrogation, c'est-à-dire que Query Builder recherchera les données correspondant au nom de la colonne lorsque vous exécuterez l'interrogation. L'absence de coche indique que les données de la colonne ne seront pas incorporées.


A propos de la fenêtre Source de données

  Rubriques connexes

La fenêtre Source de données est la partie de la fenêtre Interrogation dans laquelle sont affichés les éléments tels que les tables et les relations.


A propos de la barre d'icônes

  Rubriques connexes

La barre d'icônes apparaît en haut de la fenêtre de Query Builder. Cliquez sur chaque icône pour en obtenir une description.


Icône Enregistrer

Enregistre votre interrogation dans le fichier indiqué.


Icône Couper

Coupe le texte sélectionné et le place dans le presse-papiers de votre système d'exploitation.


Icône Copier

Copie le texte sélectionné dans le presse-papiers de votre système d'exploitation sans modifier le texte d'origine.


Icône Coller

Cette icône colle à l'emplacement actif les éléments se trouvant dans le presse-papiers. Si le presse-papiers est vide, cette icône est sans effet. Vous pouvez coller tout texte que vous avez préalablement coupé ou copié.


Icône Effacer

Supprime l'élément sélectionné (texte, table, etc.). L'option Effacer ne place pas le ou les éléments supprimés dans le presse-papiers de votre système d'exploitation, comme le fait la commande Couper.


Icône Sélectionner tout

Cette icône sélectionne tous les éléments de la fenêtre active. Par exemple, si la fenêtre Conditions est active, toutes les conditions affichées dans cette dernière sont sélectionnées.


Icône Sélectionner tables de données

Affiche la boîte de dialogue de sélection de tables de données.


Icône Sélectionner tables en relation

Affiche la boîte de dialogue de sélection de tables en relation. Cette icône n'est disponible que lorsque la table que vous avez sélectionnée est en relation avec une autre table dans la base de données connectée.


Icône Renommer une table

Affiche la boîte de dialogue de changement de nom de table. Cette icône n'est disponible que s'il existe au moins une table dans l'espace de travail de Query Builder.


Icône Infos

Affiche la boîte de dialogue d'informations, ainsi que des informations relatives à l'objet de base de données sélectionné. Cette icône n'est disponible que lorsqu'un objet de source de données est actif.


Icône Définir une relation

Affiche la boîte de dialogue de définition de relation. Cette icône n'est disponible que lorsque la fenêtre Source de données contient plusieurs tables à lier.


Icône Afficher instructions SQL

Affiche la boîte de dialogue d'affichage des instructions SQL et les instructions SQL de l'interrogation active.


Icône Séquence de colonne

Affiche la boîte de dialogue Affichage.


Icône Définir une colonne

Affiche la boîte de dialogue de définition de colonne.


Icône Trier

Affiche la boîte de dialogue de tri.


Icône AND

Insère l'opérateur AND dans votre condition. Cette icône ne peut être utilisée que lorsque le champ Condition est actif. Vous pouvez également entrer AND directement dans ce champ.


Icône OR

Insère l'opérateur OR dans votre condition. Cette icône ne peut être utilisée que lorsque le champ Condition est actif. Vous pouvez également entrer OR directement dans ce champ.


Icône NOT

Insère l'opérateur NOT dans votre condition pour la nier. Cette icône ne peut être utilisée que lorsque le champ Condition est actif. Vous pouvez également entrer NOT directement dans ce champ.


Icône Séparer les conditions

Dissocie les conditions combinées par des opérateurs logiques comme AND, OR et NOT. Cette icône n'est disponible que lorsque vous avez sélectionné un opérateur logique dans la fenêtre Conditions.


Icône Accepter

Valide et accepte la condition active. Cette icône ne peut être utilisée que lorsque le champ Condition est actif. Vous pouvez également appuyer sur Entrée ou sur Retour lorsque ce champ est actif pour accepter et valider votre condition.


Icône Annuler

Annule la condition en cours. Cette icône ne peut être utilisée que lorsque le champ Condition est actif.


Icône Coller une colonne

Affiche la boîte de dialogue de collage de colonne. Cette icône ne peut être utilisée que lorsque le champ Condition est actif.


Icône Coller une fonction

Affiche la boîte de dialogue de collage de fonction. Elle ne peut être utilisée que lorsque le champ Condition est actif.


A propos des types de données

  Rubriques connexes

Dans Query Builder, les types de données les plus courants sont les suivants :

CHAR ou VARCHAR2	CHAR est utilisé pour les données de type caractère de longueur fixe ; taille maximum 255 octets, valeur par défaut 1 octet. VARCHAR2 est utilisé pour les chaînes de caractères de longueur variable ; longueur maximum 2 000 octets. Pour VARCHAR2, vous devez indiquer la taille.
NUMBER	Indique que la colonne de base de données contient des nombres (entiers, décimaux ou tout autre type de valeurs numériques). Vous pouvez exécuter des calculs sur les nombres représentés sous la forme NUMBER, mais non sur ceux représentés sous la forme CHAR.
DATE	Indique que la colonne de base de données contient des valeurs de type date. Les valeurs valides sont comprises entre le 1er janvier 4712 av. J.-C. et le 31 décembre 4712 apr. J.-C. Le format par défaut est JJ-MOI-AA ; exemple, '01-JAN-97'.
NUMBER(p,s)	Indique la précision (p) des valeurs décimales, sous la forme d'un nombre compris entre 1 et 38. La plage des valeurs de s (échelle) va de -84 à 127. La précision décimale indique le nombre de chiffres à stocker. L'échelle indique le nombre de chiffres à droite du séparateur décimal. Si l'échelle est négative, les données sont arrondies au nombre de positions à gauche du séparateur décimal. Par exemple (10, -2) demande un arrondi au chiffre des centaines.
En outre, Query Builder offre une prise en charge limitée des types de données Oracle suivants :

LONG	Une colonne de type LONG contient des données alphanumériques de longueur variable allant jusqu'à 2 giga-octets (ou 231-1). Lorsque vous entrez une colonne de type LONG dans une interrogation Query Builder, les 2 000 premiers caractères sont affichés.
RAW	Données binaires brutes ; maximum 255 octets. Les valeurs doivent être insérées sous la forme de chaînes de caractères en notation hexadécimale. Elles sont affichées en hexadécimal. Vous devez indiquer la taille des données de type RAW.
LONG RAW	LONG RAW affiche des données binaires de type RAW d'un maximum de 2 giga-octets (qui apparaissent en hexadécimal dans la fenêtre Résultats). Les limites applicables sont les mêmes que celles concernant les données de type RAW.
Remarque : Query Builder prend en charge les conversions de type de données lorsque les conditions et les expressions font référence à des types de données différents dans leur comparaison. Pour plus d'informations, reportez-vous à Oracle8 Server SQL Language Reference Manual.


Icônes de types de données

  Rubriques connexes

Les types de données pris en charge par Query Builder pour toutes les colonnes d'un objet de source de données sont indiqués ci-dessous, et sont représentés par des icônes qui apparaissent dans la colonne de droite de l'objet, dans l'espace de travail Query Builder.

Type de données	Icônes	Description
Character (Caractère)		Type de données à utiliser pour les données de type caractère de longueur fixe ; taille maximum 255 octets, valeur par défaut 1 octet. Remarque : Vous pouvez représenter des nombres en utilisant le type de données Character, mais vous pouvez exécuter des calculs uniquement avec des données de type numérique.
Varchar2		Type de données à utiliser pour les chaînes de caractères de longueur variable ; taille maximum 2 000 octets. Vous devez indiquer la taille des données de type VARCHAR2.
Number (Nombre)		Type de données à utiliser pour les valeurs entières ou en virgule flottante. Vous devez entrer la précision (nombre de chiffres) des valeurs entières. Le type de données Floating (en virgule flottante) s'applique aux nombres décimaux. Lorsque vous attribuez ce type de données à une colonne, vous devez indiquer la précision et l'échelle. La précision (nombre total de chiffres du nombre) doit être comprise entre 1 et 38. L'échelle (nombre de chiffres à droite du séparateur décimal) doit être comprise entre -84 et 127. Si l'échelle est négative, les données sont arrondies au nombre indiqué de positions à gauche du séparateur décimal. Par exemple, (10,2) correspond à dix chiffres avec deux chiffres à droite du séparateur décimal. (10,-2) correspond à un entier de dix chiffres, arrondi au chiffre des centaines le plus proche.
Date		Type de données à utiliser pour tout type de date. Les dates valides sont comprises entre le 1er janvier 4712 av. J.-C. et le 31 décembre 4712 apr. J.-C. Le format par défaut est JJ-MOI-AA ; exemple, '01-JAN-97'.
Long		Type de données à utiliser pour les données alphanumériques de longueur variable des champs de texte Long, jusqu'à 2 giga-octets.
Raw		Type de données à utiliser pour les données binaires brutes. Taille maximum : 255 octets. Les valeurs doivent être insérées sous forme de chaînes de caractères en notation hexadécimale et les valeurs sont affichées en hexadécimal. Vous devez indiquer la taille des données de type Raw.
Long Raw		Type de données permettant de stocker jusqu'à 2 giga-octets de données binaires de type Raw (entrées et affichées en format hexadécimal). Il n'est pas nécessaire d'indiquer une taille.
MLSLABEL		Type de données MLSLABEL pour stocker le format binaire d'une étiquette utilisée sur un système d'exploitation sécurisé. Les étiquettes sont utilisées par Trusted ORACLE pour permettre l'accès aux informations. Vous pouvez également utiliser ce type de données pour définir des colonnes si vous utilisez ORACLE Server standard. Pour plus d'informations sur Trusted ORACLE, et notamment sur les types de données et les étiquettes, reportez-vous à Trusted ORACLE8 Server Administrator's Guide.


Notation d'objets de source de données.

  Rubriques connexes

Exemple de deux objets de source de données reliés par une relation :

Cliquez sur une icône, un indicateur ou une partie de ces objets pour afficher une description.


Indicateur de type d'objet

L'icône située dans l'angle supérieur gauche d'un objet de source de données indique le type de cet objet :

  Table

  Vue

  Interrogation

  Cliché

  Synonyme


Titre d'objet

Nom de l'objet de source de données. Pour modifier le nom de l'objet, cliquez sur le titre de l'objet.


Indicateur de commentaire

Cette icône indique qu'un commentaire est associé à l'objet (ou à la colonne). Cliquez deux fois sur cette icône pour ouvrir la boîte de dialogue d'informations dans laquelle vous pouvez visualiser les commentaires.


Nom de colonne

Nom de l'une des colonnes de cet objet. Si vous cliquez deux fois sur un nom de colonne, la colonne est incorporée dans votre interrogation.


Indicateurs de type de données

Ces icônes indiquent le type de données de leurs colonnes respectives. Si vous cliquez sur l'une de ces icônes, tout en maintenant le bouton de souris enfoncé, un menu instantané apparaît et vous pouvez choisir un autre type de données.


Ligne de relation

Une ligne grisée entre deux colonnes indique qu'une relation a été créée entre les colonnes à l'une ou l'autre des extrémités de la ligne. La ligne va de la clé étrangère à la clé primaire.


Indicateur d'auto-relation

Cette icône indique qu'une auto-relation a été créée entre cette colonne (clé étrangère) et une autre colonne (clé primaire) de la même table.


Clé primaire

Un nom de colonne affiché en Gras indique que cette colonne a été définie comme clé primaire de l'objet.


Clé étrangère

Un nom de colonne affiché en italique indique que cette colonne est une clé étrangère, reliée à une clé primaire d'une autre colonne. La définition d'une relation entre deux colonnes est la seule façon de définir une clé étrangère.


A propos des fonctions de Query Builder

  Exemples 	  Rubriques connexes

Une fonction est semblable à un opérateur, car elle manipule des éléments de données et retourne un résultat. Les fonctions diffèrent des opérateurs au niveau du format dans lequel elles apparaissent avec leurs arguments. Ce format leur permet d'agir sur un nombre quelconque d'arguments, ou sur aucun. Chaque fois que vous associez une colonne à un nom de fonction, Query Builder exécute l'opération indiquée sur la valeur ou les valeurs de cette colonne.

Les fonctions que vous pouvez utiliser avec les interrogation de Query Builder sont les suivantes :

•	fonctions de type numérique

•	fonctions de type caractère

•	fonctions de type caractère retournant des valeurs numériques

•	fonctions de conversion

•	fonctions de type date

•	fonctions de groupe

•	autres fonctions

Informations supplémentaires : Pour toute information sur les autres fonctions, reportez-vous à Oracle8 Server SQL Language Reference Manual.


Fonctions et arguments

  Exemples 	  Rubriques connexes

Une fonction permet de manipuler des données dans une colonne spécifique. Une fonction accepte un ou plusieurs arguments. Un argument est une expression qui figure entre les parenthèses d'une fonction et qui fournit des informations destinées à la fonction.

Exemple : la fonction ROUND qui arrondit un nombre à la précision que vous indiquez. Si vous entrez ROUND (CREDIT_LIMIT, -2), Query Builder arrondit chaque valeur de CREDIT_LIMIT au chiffre des centaines le plus proche. Si vous entrez ROUND(CREDIT_LIMIT, 1), Query Builder arrondit les valeurs de CREDIT_LIMIT au chiffre des dixièmes le plus proche.

Les valeurs utilisées dans les arguments sont les suivantes :

Valeur d'argument	Description
char, set, search,	Constante de type caractère entre guillemets simples,
replace	ou expression retournant des données de type caractère.
d, e	Constante de date entre guillemets simples, ou expression retournant des données de type date.
m, n	Constante numérique ou expression retournant des données de type numérique.
X	Le type d'argument dépend du contexte de la fonction.
Expr	Expression de n'importe quel type.
Fmt	Format utilisé pour modifier l'affichage des données ou pour entrer des données dans un champ Query Builder ou une condition dans un format autre que le format par défaut.


Fonctions de type numérique

  Rubriques connexes

Les fonctions de type numérique acceptent des données numériques et retournent des données numériques. Vous pouvez les utiliser pour définir des colonnes et des conditions.

Fonction (arguments)	Description
ABS(n)	Valeur absolue de n.
CEIL(n)	Plus petit entier supérieur ou égal à n.
COS(n)	Retourne le cosinus de n (angle exprimé en radians).
COSH(n)	Retourne le cosinus hyperbolique de n.
EXP(n)	Notation exponentielle. Retourne e (2.71828183...) à la puissance n.
FLOOR(n)	Plus grand entier supérieur ou égal à n.
LN(n)	Retourne le logarithme népérien de n, où n est supérieur à 0.
LOG(m,n)	Retourne le logarithme, base m, de n. La base m peut être tout nombre positif autre que 0 ou 1, et n peut être tout nombre positif.
MOD(m,n)	Reste de m divisé par n.
POWER(m,n)	m à la puissance n. Si n n'est pas un entier, il est tronqué.
ROUND(n[,m])	n arrondi à m positions décimales ; si m est omis, arrondi à 0 position. m peut être une valeur négative pour arrondir les chiffres à gauche du séparateur décimal.
SIGN(n)	Si n<0, -1; si n=0, 0; si n>0, 1.
SIN(n)	Retourne le sinus (sine) de n (angle exprimé en radians).
SINH(n)	Retourne le sinus hyperbolique de n.
SQRT(n)	Racine carrée de n ; si n<0, NULL.
TAN(n)	Retourne la tangente de n (angle exprimé en radians).
TANH(n)	Retourne la tangente hyperbolique de n.
TRUNC(n[,m])	n tronqué à m positions décimales ; si m est omis, arrondi à 0 position. m doit être une valeur négative pour tronquer (renvoyer à 0) les chiffres situés à gauche du séparateur décimal.


Fonctions de type caractère

  Rubriques connexes

Vous pouvez utiliser des fonctions de type caractère qui acceptent des données de type caractère et retourne des données de type caractère lorsque vous définissez des colonnes et des conditions.

Fonction (arguments)	Description
CHR(n)	Caractère ayant l'équivalent binaire de n dans le jeu de caractères de la base de données.
CONCAT(car1,car2)	Retourne car1 concaténé à car2.  Cette fonction équivaut à l'opérateur de concaténation (||).
INITCAP(car)	car, avec la première lettre de chaque mot en majuscules. Les mots sont délimités par des blancs ou des caractères non alphanumériques.
LOWER(car)	car, avec toutes les lettres en minuscules.
LPAD(car1,n[,car2])	car1, rempli à gauche jusqu'à la longueur n de la séquence de caractères de car2, dupliquée autant de fois que nécessaire ; si car2 est omis, rempli de bancs.
LTRIM(car[,jeu])	car, avec les caractères initiaux supprimés jusqu'au premier caractère absent du jeu.  jeu est par défaut ` ' (un seul blanc).
NLS_INITCAP(car [,paramnls])	Retourne car, avec la première lettre de chaque mot en majuscules. Les mots sont délimités par des blancs ou des caractères non alphanumériques. Les paramètres indiqués dans paramnls peuvent avoir la forme NLS_SORT=tri, où tri est une séquence de tri linguistique valable pour votre session ou BINARY. Si vous indiquez BINARY, cette fonction retourne car. Pour toute information sur les séquences de tri, reportez-vous à Oracle8 Server Concepts Manual.
NLS_LOWER(car[,paramnls])	Retourne car, avec toutes les lettres en minuscules.  Voir NLS_INITCAP pour l'argument paramsnls.
NLS_UPPER(car[,paramnls])	Retourne car, avec toutes les lettres en majuscules. Voir NLS_INITCAP pour l'argument paramnls.
REPLACE(car,recherche[,remplacement])	car, avec chaque remplacement de chaque occurrence de recherche par remplacement. Si remplacement est omis, toutes les occurrences de recherche sont supprimées.
RPAD(car1,n[,car2])	car1, rempli à droite jusqu'à la longueur n de la séquence de caractères de car2, dupliquée autant de fois que nécessaire ; si car2 est omis, rempli de bancs.
RTRIM(car[,jeu])	car, avec les caractères finals supprimés après le dernier caractère absent du jeu. jeu est par défaut ` ' (un seul blanc).
SOUNDEX(car)	Valeur de type car représentant le son du (ou des) mot(s) de car.
SUBSTR(car,m[,n])	Sous-chaîne de car, commençant au caractère m, n caractères de long si n est omis.
SUBSTRB(car,m[,n])	Identique à SUBSTR, sauf que les arguments m et n sont exprimés en octets, et non en caractères. Pour les jeux de caractères sur un seul octet, SUBSTRB est identique à SUBSTR.
UPPER(car)	car, avec toutes les lettres en majuscules.


Fonctions de conversion
Fonctions de type caractère retournant des données numériques

  Rubriques connexes

Vous pouvez utiliser des fonctions de type caractère pour retourner des données numériques lorsque vous définissez des colonnes et des conditions.

Abréviation	Description
ASCII (car)	Valeur ASCII du premier caractère de car.
INSTR(car1,car2[,n[,m]])	Position de la nième occurrence de car2 dans car1, la recherche commençant à la position n. Si m est omis, le système utilise 1 par défaut. Si n est omis, le système utilise 1 par défaut. La position est indiquée par rapport au premier caractère de car1, même lorsque n>1.
INSTRB(car1,car2[,n[,m]])	Identique à INSTR, sauf que n et la valeur retournée sont exprimées en octets et non en caractères. Pour les jeux de caractères de base de données sur un octet, INSTRB équivaut à INSTR.
LENGTH(car)	Longueur, en caractères, de car.
LENGTHB(car)	Identique à LENGTH, sauf que car est exprimé en octets et non en caractères. Si car est NULL, cette fonction retourne NULL. Pour les jeux de caractères de base de données sur un octet, LENGTHB est identique à LENGTH.
NLSSORT(car[,paramnls])	Retourne la chaîne d'octets utilisée pour trier car. Les paramètres indiqués dans paramnls peuvent avoir la forme NLS_SORT=tri, où tri est une séquence de tri linguistique valable pour votre session, ou BINARY. Si vous indiquez BINARY, cette fonction retourne car. Pour toute information sur les séquence de tri, reportez-vous à Oracle8 Server Concepts Manual.


Fonctions de conversion

  Rubriques connexes

Vous pouvez utiliser des fonctions de conversion pour convertir des données d'un type en un autre lorsque vous définissez des colonnes et des conditions.

Abréviation	Description
TO_CHAR (d[,fmt])	Convertit d en une valeur de type caractère dans le format indiqué par la valeur de caractère fmt.  Si fmt est omis, d est converti en une valeur de type caractère dans le format de date par défaut de Query Builder, JJ-MOI-AA.
TO_CHAR(n[,fmt])	Convertit n en une valeur de type caractère dans le format indiqué par la valeur de caractère fmt.  Si fmt est omis, n est converti en une valeur de type caractère de la longueur exacte nécessaire pour stocker les chiffres significatifs.
TO_DATE(car[,fmt])	Convertit une date d'une valeur de type caractère en une valeur de type date. fmt est une valeur de type caractère qui indique le format de car. Si fmt et jomis, car doit avoir le format de date par défaut de Query Builder, JJ-MOI-AA.
TO_DATE(n,[fmt])	Convertit un nombre en date. fmt doit être un format qui, lorsqu'il est utilisé avec TO_CHAR, donne une DATE (par exemple, J ou MM).
TO_LABEL(car[,fmt])	Convertit car, valeur de type CHAR ou VARCHAR2 contenant une étiquette en format fmt, en une valeur de type MLSLABEL. Si vous omettez fmt, car doit être dans le format d'étiquette par défaut.
TO_MULTI_BYTE (car)	Retourne car avec tous les caractères sur un octet convertis en caractères multi-octets correspondants. Les caractères sur un octet qui n'ont pas d'équivalent sur plusieurs octets apparaissent dans la chaîne de sortie sous la forme d'un octet. (Cette fonction n'est utile que si votre jeu de caractères de base de données contient les deux types.)
TO_NUMBER (car)	Convertit car, données de type caractère contenant une valeur numérique, en données numériques.
TO_SINGLE_BYTE (car)	Retourne car avec tous les caractères multi-octets convertis en caractères sur un octet correspondants. Les caractères multi-octets qui n'ont pas d'équivalent sur un octet apparaissent dans la chaîne de sortie sous la forme multi-octets. (Cette fonction n'est utile que si votre jeu de caractères de base de données contient les deux types.)


Fonctions de type date

  Rubriques connexes

Toutes les fonctions de type date retournent des données de type date, sauf MONTHS_BETWEEN qui retourne des données numériques. Vous pouvez utiliser ces fonctions lorsque vous définissez des colonnes et des conditions.

Abréviation	Description
ADD_MONTHS (d,n)	Date d plus n mois.
LAST_DAY(d)	Date du dernier jour du mois contenant d.
MONTHS_BETWEEN(d,e)	Nombre de mois entre les dates d et e. Si d est postérieur à e, le résultat est positif ; s'il est antérieur, le résultat est négatif.
NEW_TIME(d,a,b)	Date et heure du fuseau horaire b lorsque la date et l'heure du fuseau horaire a sont d. a et b sont des expressions de type caractère, dont la signification est la suivante :
AST, ADT:	Heure au format Atlantic Standard ou Daylight
BST, BDT:	Heure au format Bering Standard ou Daylight
CST, CDT:	Heure au format Central Standard ou Daylight
EST, EDT:	Heure au format Eastern Standard ou Daylight
GMT:	Greenwich Mean Time
HST, HDT:	Heure au format Alaska-Hawaii Standard ou Daylight
MST, MDT:	Heure au format Mountain Standard ou Daylight
NST:	Heure au format Newfoundland Standard
PST, PDT:	Heure au format Pacific Standard ou Daylight
YST, YDT:	Heure au format Yukon Standard ou Daylight
NEXT_DAY(d,car)	Date du premier jour de la semaine, indiquée par car, qui n'est pas égale ou postérieure à d.
ROUND(d[,fmt])	d arrondi de la manière indiquée par l'unité d'arrondi fmt ; si fmt est omis, jour le plus proche.
SYSDATE	Date et heure en cours. Ne demande aucun argument.
TRUNC(d[,fmt])	d avec l'heure du jour tronquée jusqu'à l'unité de troncation indiquée, fmt ; si fmt est omis, l'heure du jour est supprimée.
Informations supplémentaires : Pour connaître les modèles de format à utiliser avec les fonctions de date ROUND et TRUNC, reportez-vous à Oracle8 Server SQL Language Reference Manual.


Fonctions de groupe

  Rubriques connexes

Les fonctions de groupe extraient des données en se fondant sur des groupes de lignes, et non un résultat par ligne. Elles exécutent des opérations de type calcul de moyenne, décompte, total et écart type.

Vous pouvez également utiliser les fonctions de groupe pour définir une nouvelle colonne ; la totalité des résultats est considérée comme un groupe lorsque vous n'affichez pas d'autres colonnes. L'affichage d'autres colonnes répartit le résultat en groupes plus petits. Vous pouvez utiliser les fonctions de groupe avec des conditions, mais uniquement avec un opérateur de comparaison, et la totalité des résultats est alors considérée comme un groupe. Par exemple, la condition SALAIRE > AVG(SALAIRE) est remplie (TRUE) lorsque la valeur de SALAIRE dans la ligne en cours est supérieure à la moyenne de SALAIRE dans toutes les autres lignes.

Les fonctions de groupe peuvent être utilisées avec les options DISTINCT ou ALL. Si vous indiquez DISTINCT, une fonction de groupe ne prend en compte que les fonctions distinctes d'une expression. Par exemple, la moyenne de 1, 1, 1, et 3 est 1,5, alors que la moyenne de DISTINCT est 2. Si vous indiquez ALL, la fonction de groupe prend toutes les valeurs en compte, y compris les doublons.

Toutes les fonctions de groupe décrites ci-dessous sautent les valeurs NULL, sauf COUNT(*). Les arguments peuvent être de type caractère, numérique ou date si expr est indiqué.

Fonction (argument)	Description
AVG([DISTINCT|ALL]n)	Valeur moyenne de n, sans tenir compte des valeurs NULL.
COUNT([DISTINCT|ALL] expr)	Nombre de lignes où expr n'est pas NULL.
COUNT(*)	Nombre de lignes du tableau, y compris les doublons et lignes comportant des valeurs NULL.
GLB([DISTINCT|ALL] étiquette)	Retourne la limite inférieure la plus élevée de étiquette.
LUB([DISTINCT|ALL] étiquette)	Retourne la limite supérieure la moins élevée de étiquette.
Informations supplémentaires : GLB et LUB retournent des valeurs de type MLSLABEL. Pour plus d'informations sur les fonctions GLB et LUB, reportez-vous à Trusted Oracle8 Server Administrator's Guide.

Fonction (argument)	Description
MAX([DISTINCT|ALL] expr)	Valeur maximum de expr.
MIN([DISTINCT|ALL] expr)	Valeur minimum de expr.
STDDEV([DISTINCT|ALL]n)	Ecart type de n, sans tenir compte des valeurs NULL, en fonction d'un calcul n-1 (exemple).
SUM([DISTINCT|ALL] n)	Somme des valeurs de n.
VARIANCE([DISTINCT|ALL] n)	Variance de n, sans tenir compte des valeurs NULL.


Autres fonctions

  Rubriques connexes

Query Builder accepte également les fonctions suivantes :

Fonction (argument)	Description
USER	Retourne le nom de l'utilisateur Oracle en cours. Ne demande pas d'argument.
DECODE(expr,recherche1, remplacement1[,recherche2, remplacement2,] ... [défaut])	Si expr est égal à une recherche, retourne le remplacement suivant. Dans le cas contraire, retourne défaut. Si défaut est omis et s'il n'y a pas de concordance, retourne NULL. expr  peut être tout type de données ; recherche doit être du même type. La valeur retournée est forcée au même type de données que le premier retour.
GREATEST(expr1,expr2,...)	Retourne la valeur la plus élevée d'une liste de valeurs. Toutes les expressions suivant expr1 sont converties en type de expr1 avant que la comparaison soit effectuée.
GREATEST_LB(étiquette[,étiquette] ...)	Retourne la limite inférieure la plus élevée de la liste d'étiquettes. Chaque étiquette doit avoir des données de type MLSLABEL ou RAW MLSLABEL ou être un littéral entre guillemets simples dans le format d'étiquette par défaut. La valeur de retour est de type RAW MLSLABEL.
LEAST(expr1,expr2,...)	Retourne la plus petite valeur d'une liste de valeurs. Toutes les expressions suivant expr1 sont converties en type de expr1 avant que la comparaison soit effectuée.
LEAST_UB(étiquette[,étiquette] ...)	Retourne la plus petite limite supérieure de la liste d'étiquettes. Chaque étiquette doit avoir des données de type MLSLABEL ou RAW MLSLABEL ou être un littéral entre guillemets simples dans le format d'étiquettes par défaut. La valeur de retour est de type RAW MLSLABEL.
NVL(x,expr)	Si x est null, retourne expr ; si x n'est pas null, retourne x. x et expr peuvent être du type de votre choix. La valeur retournée est de même type que x.
Informations supplémentaires : Pour plus d'informations sur les fonctions GREATEST_LB et LEAST_UB, reportez-vous à Trusted Oracle8 Server Administrator's Guide.


Au lieu de sélectionner une table et de cliquer sur Inclure, vous pouvez cliquer deux fois sur chaque table cible pour la déplacer vers l'espace de travail de Query Builder. Pour inclure une plage de tables, maintenez la touche MAJ enfoncée tout en cliquant sur la première et sur la dernière table de la plage.


Bien que vous puissiez définir des relations à l'aide de cette boîte de dialogue, utilisez de préférence la souris pour créer des relations. Query Builder active et désactive automatiquement les lignes des relations créées de la sorte.


Une coche mise en évidence à côté d'une colonne signifie que cette dernière apparaît dans l'instruction SELECT et sera affichée dans les résultats de l'interrogation. Une coche grisée à côté de la colonne signifie que cette dernière est utilisée en tant que critère de tri ou de groupe.


En général, Query Builder vous permet de lier des colonnes pouvant être interprétées à l'aide de la fonction de conversion implicite de la base de données Oracle. Pour toute information technique sur les conversions implicites, reportez-vous à Oracle8 Server SQL Language Reference Manual.


L'expression contenue dans le champ Définies comme se compose généralement d'une fonction ou d'une opération et de la ou des colonnes de base de données sur lesquelles devra porter l'opération. Si le nom de colonne se retrouve dans plusieurs tables, n'oubliez pas de faire également référence au nom de la table et de séparer ce nom de celui de la colonne par un point. Si le nom de colonne est unique, vous pouvez indiquer uniquement ce nom.


Renommer une table n'entraîne pas de modification correspondante dans le nom de la table sous-jacent de la base de données. Le nouveau nom n'est valide que pour l'interrogation active ; il reste dans l'interrogation si vous l'enregistrez.


Pour afficher la boîte de dialogue de définition de relations, cliquez sur [image] dans la barre d'icônes.


Pour afficher la boîte de dialogue de sélection de tables, cliquez sur [image] dans la barre d'icônes.


Pour afficher la boîte de dialogue de changement des noms de tables, cliquez sur [image] dans la barre d'icônes.


Lorsque vous sélectionnez dans une table un objet colonne, Query Builder utilise automatiquement l'alias de cette table dans l'interrogation. De même, si vous incluez un objet colonne dans le champ Condition et acceptez la condition, Query Builder insère automatiquement les alias de table appropriés dans la condition.


Vous pouvez sélectionner ou désélectionner une colonne des manières suivantes :

•	Cochez (ou désélectionnez) la case à côté de la colonne.

OU

Cliquez deux fois sur le nom de la colonne.


A propos des auto-relations

  Rubriques connexes

Une auto-relation relie une table à elle-même. Les auto-relations ont une utilisation limitée et très spécifique : elles permettent d'établir un lien hiérarchique entre deux colonnes d'une même table. Vous pouvez, par exemple, utiliser une auto-relation pour relier les filiales d'une entreprise à la société mère, ou des employés à leurs dirigeants.

Une auto-relation n'est utilisable que si les colonnes de la table sont les contreparties les unes des autres. Dans la table Employee de la base de données, par exemple, le Manager ID est le même que l'Employee ID de ce responsable. L'icône d'auto-relation est donc affichée dans la colonne Manager ID.


Création d'une auto-relation

  Rubriques connexes

Pour créer une auto-relation :

1	Dans la boîte de dialogue de définition de relation, Query Builder affiche la liste des tables pour lesquelles des relations avec la table sélectionnée ont été définies.

2	Cliquez sur le nom de la table.

3	Cliquez sur Inclure.

4	Cliquez sur OK.

5	Répétez la procédure ci-dessus pour le nom de table.

6	Query Builder donne automatiquement à la copie de la table en relation un nom d'alias. Renommez la table pour que son nom corresponde au nom de l'original.

Remarque : Si l'auto-relation a déjà été identifiée dans le dictionnaire de données sous-jacent, les deux colonnes en relation dans la table et l'alias sont reliés par une ligne de relation. Si l'auto-relation n'a pas été identifiée dans le dictionnaire de données, vous pouvez créer une auto-relation en traçant une ligne de relation temporaire reliant les deux colonnes équivalentes dans la table et l'alias.


Création d'une relation simple

  Rubriques connexes

Pour créer une relation en utilisant la souris :

1	Dans la fenêtre Interrogation, ouvrez les tables à relier.

2	Pendant que la table est affichée, sélectionnez la colonne à relier (clé étrangère).

3	Tout en maintenant le bouton de la souris enfoncé, faites glisser le pointeur sur la colonne reliée de la seconde table (clé primaire) pour tracer une ligne de relation.

4	Lorsque la colonne cible est mise en évidence, relâchez le bouton de la souris pour ancrer la ligne de relation. Par défaut, la relation est inactive (la ligne apparaît grisée).

Pour créer une relation en utilisant la boîte de dialogue de définition de relation :

1	Dans la boîte de dialogue de définition de relation, entrez le nom de la colonne d'origine (A->) et de la colonne cible (->B). Remarque Query Builder trace une ligne de relation entre les deux colonnes.

2	Cliquez sur Fermer.

Pour créer une relation en utilisant un raccourci :

1	Dans la boîte de dialogue de définition de relation, cliquez dans le champ A.

2	Dans la fenêtre Interrogation, sélectionnez une colonne. Query Builder place automatiquement le nom de la table et celui de la colonne dans le champ A.

3	Répétez la procédure pour le champ B.


Création d'une relation composite

  Rubriques connexes

Une relation composite connecte plusieurs colonnes d'une table à celles d'une autre table. Par exemple, vous pouvez relier les colonnes Order ID et Item ID de la table Items à des colonnes de noms identiques dans la table Item List.

Pour créer une relation composite :

1	Dans l'espace de travail de Query Builder, cliquez sur [image] dans la barre d'icônes.

2	Sélectionnez les deux tables à inclure.

3	Sélectionnez la colonne à relier (clé étrangère).

4	Tout en maintenant le bouton de la souris enfoncé, faites glisser le pointeur sur la colonne en relation dans la seconde table (clé primaire). Remarquez que le pointeur trace une ligne de relation au cours de cette opération.

5	Lorsque la colonne cible est mise en évidence, relâchez le bouton de la souris pour ancrer la ligne de relation. Par défaut, la relation est inactive (la ligne apparaît grisée).

Vous pouvez utiliser autant de relations composites que nécessaire pour votre interrogation, et inclure des colonnes dans des relations composites, qu'elles soient ou non utilisées dans d'autres relations.


Vous devez entrer le nom complet de la table et de la colonne (séparés par un point). A-> représente la (ou les) clé(s) étrangère(s) de la table et ->B la (ou les) clé(s) primaire(s) de la table. Séparez par des virgules les clés primaires et les clés étrangères supplémentaires.


Création d'une relation non concordante

  Rubriques connexes

Pour créer une relation non concordante, ou extérieure :

1	Dans la fenêtre Interrogation, cliquez sur la ligne de relation qui relie vos tables. Si cette ligne n'existe pas, créez une relation simple entre les deux tables.

2	Dans la boîte de dialogue de définition de relation, choisissez l'une des options d'affichage pour extraire tous les enregistrements inclus dans une relation simple ou uniquement les lignes pour lesquelles il existe une valeur correspondante dans les deux tables.

Remarque : Ne confondez pas une ligne qui retourne la valeur zéro (0) et une ligne non concordante. L'option Supprimer discordances n'est utilisable que sur les lignes qui retournent des valeurs nulles et non des valeurs zéro. Utilisez cette fonction si vous voulez afficher les données lorsqu'une table ne contient aucune valeur, par exemple des commandes sans ligne article, des clients qui n'ont pas passé de commande, des représentants qui n'ont pas de client, etc.


Suppression de lignes sans correspondance

  Rubriques connexes

Pour supprimer une relation non concordante :

1	Dans l'espace de travail de Query Builder, cliquez sur la ligne de relation qui relie vos tables cibles.

2	Dans la boîte de dialogue de définition de relation, cliquez sur le bouton d'option Supprimer discordances.

3	Cliquez sur OK.


Utilisation d'une relation de non-égalité

  Rubriques connexes

Pour créer une relation de non-égalité dans la boîte de dialogue de définition de relation :

  Sélectionnez l'opérateur.

Lorsque vous définissez une relation de non-égalité, Query Builder place une icône (le symbole différent de) sur la ligne de relation.


Suppression d'une relation

  Rubriques connexes

Pour supprimer une relation :

1	Dans la fenêtre Interrogation, cliquez sur la ligne de relation qui connecte les deux colonnes de table.

2	Lorsque les deux noms de colonnes et la ligne de relation sont en évidence, appuyez sur la touche Suppr.


A propos des lignes sans correspondance (NULL)

  Rubriques connexes

Query Builder vous permet de demander l'extraction de lignes sans correspondance lorsque vous utilisez une relation dans une interrogation. Il y a non correspondance de ligne lorsque la relation relie des tables contenant d'un côté des valeurs qui n'ont pas de valeur correspondante de l'autre côté. Les utilisateurs de SQL reconnaîtront ce cas comme une condition d'interrogation appelée jointure externe. Les lignes sans correspondance retournent généralement des valeurs null.

Remarque : Ne confondez pas une ligne qui retourne la valeur 0 (zéro) et une ligne sans correspondance. L'option Supprimer lignes discordantes de la boîte de dialogue de définition de relation n'est utilisable que pour les lignes qui retournent des valeurs NULL et non celles qui retournent des valeurs 0. Utilisez cette fonction pour afficher des données lorsqu'aucune valeur n'a été entrée dans une table (commandes ne comportant pas de ligne article, par exemple). Lorsque vous utilisez une relation sans correspondance, vous pouvez uniquement choisir un côté dans lequel afficher des enregistrements sans correspondance.


Création d'une nouvelle interrogation

  Rubriques connexes

Pour créer une nouvelle interrogation :

1	Dans l'espace de travail de Query Builder, cliquez sur [image] dans la barre d'icônes.

2	Cliquez deux fois sur la ou les tables dont vous voulez extraire des données.

3	Cliquez sur Inclure pour fermer la boîte de dialogue et afficher la table.

4	Sélectionnez chaque colonne. Une coche apparaît dans la case correspondant à chaque colonne sélectionnée. Pour inclure toutes les colonnes, cochez la case de la barre de titre de la table. Conseil

5	Entrez une ou plusieurs conditions afin de préciser votre interrogation.

6	Cliquez sur OK pour refermer Query Builder.


Localisation des tables disponibles

  Rubriques connexes

Pour localiser les tables que vous pouvez utiliser dans votre interrogation :

1	Dans l'espace de travail de Query Builder, cliquez sur [image] dans la barre d'icônes.

2	Utilisez les cases à cocher Afficher pour trier les tables par type.


Suppression d'une table

Pour supprimer (effacer) une table de l'espace de travail de Query Builder :

1	Dans la fenêtre Interrogation, cliquez sur la table à supprimer.

2	Cliquez sur [image] dans la barre d'icônes. Query Builder supprime la table de son espace de travail. Vous pouvez alors cliquer sur [image] pour l'inclure de nouveau dans votre interrogation.

Lorsque vous coupez ou que vous effacez une table, cette dernière n'est pas supprimée de la base de données, mais seulement de l'interrogation.


Changement de nom de table

  Rubriques connexes

Pour renommer une table : Remarque

1	Cliquez sur [image] dans la barre d'icônes.

2	Dans la boîte de dialogue de changement de nom de table, sélectionnez la table dont vous voulez modifier le nom dans la liste Tables disponibles.

3	Cliquez dans le champ Nouveau Nom.

4	Supprimez les informations dont vous n'avez pas besoin.

5	Entrez le nouveau nom de la table. Ce nom de peut pas avoir plus de 30 caractères.

6	Cliquez sur Définir.

7	Cliquez sur OK.

Lorsque vous renommez une table dans l'espace de travail de Query Builder, le nom de la table sous-jacente n'est pas modifié. Le nouveau nom n'est valide que pour l'interrogation en cours.


Affichage d'informations et de commentaires sur les tables et les colonnes

Pour afficher les informations et les commentaires stockés dans la base de données :

  Dans l'espace de travail de Query Builder, cliquez deux fois sur l'icône située à l'extrémité droite de l'en-tête de la table pour afficher les informations sur la table ; cliquez deux fois sur la première icône de chaque colonne pour afficher les informations de colonne.


Suppression d'une colonne d'une interrogation

  Rubriques connexes

Pour supprimer une colonne d'une interrogation :

  Sélectionnez la colonne dans l'espace de travail de Query Builder. La coche située dans la table disparaît.


Décompte des lignes d'une interrogation

Pour compter les lignes de résultat d'une interrogation avant d'exécuter cette dernière :

  Dans l'espace de travail de Query Builder, cliquez sur [image] dans la barre d'icônes. Un message d'alerte indiquant le nombre de lignes qui seront extraites apparaît.


Ajout de conditions à une interrogation

  Exemples	  Rubriques connexes

Pour ajouter des conditions à une interrogation :

1	Cliquez dans le champ Condition vierge de la fenêtre Conditions pour l'activer. Un signe plus apparaît à côté de la flèche du curseur. Vous pouvez maintenant utiliser votre pointeur de souris pour sélectionner des champs automatiquement en cliquant dessus.

2	Dans l'espace de travail de Query Builder, sélectionnez la colonne à laquelle vous voulez appliquer une condition. Pour afficher la liste des colonnes disponibles, cliquez sur [image] dans la barre d'icônes. Conseil

3	Cliquez sur l'opérateur approprié dans la barre d'icônes. Pour ajouter des fonctions à la condition, cliquez sur [image] dans la barre d'icônes.

4	Entrez la valeur appropriée correspondant à la partie droite de l'expression de condition qui suit l'opérateur. Pour ajouter une autre condition, appuyez sur Maj-Entrée pour déplacer le curseur vers une nouvelle ligne.

5	Si l'expression vous convient, cliquez hors du champ de conditions mais dans la fenêtre Conditions pour désactiver ce champ, ou cliquez sur [image] dans la barre d'icônes. Pour effacer le contenu de la fenêtre Conditions et recommencer, cliquez sur [image] dans la barre d'icônes.


A propos des conditions

  Exemples 	  Rubriques connexes

Une condition est une expression de texte que vous placez dans une interrogation pour cibler les informations voulues et éliminer les informations non voulues. Les conditions permettent de gagner du temps et d'affiner les interrogations en extrayant des colonnes de la table. Conseil

Par exemple, vous incluez la table Employee dans votre interrogation et vous sélectionnez les colonnes Name, Salary et Job. Si vous n'ajoutez aucune condition, vous demandez à la base de données de sélectionner les données des employés contenues dans les colonnes Name, Salary et Job de la table Employee. Vous pouvez ajouter des conditions à votre requête initiale, par exemple : "dont

•	le salaire mensuel est supérieur à $ 1000 et inférieur à $ 2000."

•	le nom de famille est Smith."

•	le poste occupé est Cadre."

Pour éviter d'entrer les longues phrases des exemples précédents dans la condition, utilisez des opérateurs, de manière à ce que la condition soit proche d'une formule. Par exemple, pour indiquer les employés dont le salaire dépasse $ 3000, entrez :

SALARY > 3000

Vous pouvez également utiliser des fonctions afin de faciliter la création de conditions complexes.


Exemple de condition

  Rubriques connexes 	  Tous les exemples

Supposez que vous vouliez créer une interrogation permettant d'afficher les données concernant uniquement l'état de Californie.

1	Cliquez sur le champ de conditions pour l'activer.

2	Dans la zone de travail de Query Builder, sélectionnez la colonne State de la table appropriée. Le mot STATE apparaît dans le champ de conditions.

3	Entrez le symbole EGAL (=).

4	Dans le champ Condition, entrez 'CA' à droite du signe égal.

La condition prend la forme suivante : STATE='CA'


A propos des opérateurs

  Rubriques connexes

Un opérateur est un caractère ou un mot réservé utilisé pour exécuter une opération particulière. Les trois principaux types d'opérateur utilisés dans Query Builder sont :

•	opérateurs de comparaison

•	opérateurs arithmétiques

•	opérateurs logiques

Remarque : Vous pouvez également créer des conditions de négation basées sur ces opérateurs.


Opérateurs de comparaison

  Rubriques connexes

Les opérateurs de comparaison permettent de comparer deux valeurs. Lorsque vous insérez l'opérateur entre un nom de colonne et une valeur, dans la fenêtre Conditions, Query Builder compare tous les éléments de cette colonne à la valeur et ne retourne que les lignes dans lesquelles l'instruction de condition est vraie.

Par exemple, pour ne retourner que les lignes dans lesquelles la valeur de la colonne CREDIT_LIMIT est inférieure à $ 6000, utilisez l'opérateur < (inférieur à).

CREDIT_LIMIT < 6000

Les opérateurs de comparaison de Query Builder sont les suivants :

Opérateurs	Utilisation
=	Egal
<>	Différent de
<	Inférieur à
<=	Inférieur ou égal à
>	Supérieur à
>=	Supérieur ou égal à
BETWEEN...AND...	Entre deux valeurs
IN (LIST)	Egal à tout membre de la liste suivante
IS NULL	Est une valeur NULL. Une ligne sans valeur dans une colonne est considérée comme contenant une valeur NULL.


Opérateurs arithmétiques

  Rubriques connexes

Les opérateurs arithmétiques permettent d'exécuter des calculs sur des colonnes numériques et des colonnes de dates. Lors de l'exécution des calculs, Query Builder commence par effectuer la multiplication ou la division, puis l'addition ou la soustraction.

•	Par exemple, dans l'expression 1+2x3, Query Builder commence par multiplier 2 par 3, puis ajoute le résultat à 1, ce qui donne un résultat final de 7.

Pour modifier ces règles de priorité, placez une partie de l'expression entre parenthèses ; dans ce cas, Query Builder commence par calculer les expressions entre parenthèses.

•	Par exemple, dans le calcul (1+2)x3, (1+2) est calculé en premier, puis le résultat est multiplié par 3, pour donner un résultat final de 9.

Les opérateurs arithmétiques de Query Builder sont les suivants :

Opérateurs	Utilisation
+	Addition
-	Soustraction
*	Multiplication
/	Division


Opérateurs logiques

  Rubriques connexes

Les opérateurs logiques (également appelés booléens) sont AND, OR et NOT :

•	Utilisez AND pour extraire uniquement les données pour lesquelles toutes les conditions sont remplies.

•	Utilisez OR pour extraire les données qui remplissent au moins l'une des conditions indiquées.

•	Utilisez NOT pour nier l'opérateur ou les opérateurs, ou la ou les condition(s).

La barre d'icônes contient les icônes des opérateurs logiques. Ces icônes sont disponibles lorsque la fenêtre Conditions est active ou lorsque la boîte de dialogue de définition de colonne est ouverte. Vous pouvez insérer un opérateur dans le texte de la condition ou de la colonne définie en cliquant sur cet opérateur dans la barre d'icônes.


A propos des colonnes définies (et calculées)

  Exemples 	  Rubriques connexes

Vous pouvez exécuter des calculs sur les données extraites par Query Builder de la base de données, puis afficher les données calculées dans la fenêtre Résultats sous la forme d'une nouvelle colonne (également appelée champ défini). Vous pouvez nommer, définir et afficher ces colonnes comme toute autre colonne de votre interrogation.

Vous pouvez utiliser les colonnes définies dans une interrogation Query Builder pour construire des hypothèses, des prévisions, des projections et d'autres analyses, comme des variances et des pourcentages de totaux.

Remarque : Lorsque vous affichez une colonne définie (un champ défini) contenant une fonction cumulée, Query Builder génère automatiquement la clause GROUP BY correspondante pour les autres colonnes affichées qui n'impliquent pas de fonction cumulée. Les utilisateurs connaissant bien le produit peuvent aussi indiquer manuellement des colonnes GROUP BY pour obtenir un regroupement par colonnes non affichées.

Bien que les colonnes soient généralement synonymes des colonnes de données stockées dans vos tables, elles peuvent également faire référence aux nouvelles colonnes de données d'une interrogation, qui sont dérivées des valeurs d'une autre colonne, ou calculées à partir de celle-ci. Ces colonnes calculées sont parfois appelées champs dérivés ou champs définis. Par exemple, la table Employee peut comporter deux colonnes qui décrivent la rémunération : Salary et Commission. Vous pouvez créer une colonne définie qui combine les valeurs de ces colonnes en une nouvelle colonne appelée Net Pay qui représente le total du salaire et des commissions.

Vous pouvez fonder vos colonnes définies sur toute combinaison de colonnes de base de données simples ou multiples, en fonction de vos besoins.

Les colonnes définies existent dans votre interrogation, mais non dans la base de données. Vous pouvez choisir de les afficher dans la fenêtre Résultats, sous la forme de colonnes, ou de les garder masquées (comme lorsque vous les utilisez pour créer d'autres colonnes définies).

Remarque : La colonne définie n'est qu'une partie de votre interrogation et ne modifie pas la définition de table enregistrée dans la base de données.


Suppression d'une colonne définie

  Rubriques connexes

Pour supprimer d'une interrogation une colonne définie :

1	Dans l'espace de travail de Query Builder, cliquez sur [image] dans la barre d'icônes.

2	Cliquez sur le nom de la colonne à supprimer.

3	Cliquez sur Supprimer.


Colonnes définies (et calculées) - Exemple

  Rubriques connexes 	  Tous les exemples

Vous voulez calculer des prévisions de budget concernant la paye nette de l'année prochaine (NET_PAY_NEXT) en tenant compte d'une augmentation de salaire de 10 %. Dans le champ Expression, entrez :

(SALARY*1.1) + COMMISSION

Ou, si vous voulez étudier l'effet des augmentations de 10 % de salaire et de commission, entrez :

(SALARY+COMMISSION) * 1.1

Comme NET_PAY est égal à SALARY+COMMISSION, vous pouvez aussi écrire :

NET_PAY * 1.1

Vous pouvez également créer une colonne définie qui affiche la différence entre la paye nette en cours et les prévisions pour l'année prochaine. Appelez cette colonne VARIANCE et définissez-la de la manière suivante :

NET_PAY_NEXT - NET_PAY

Lorsque vous définissez de nouvelles colonnes, les colonnes de base décrites dans votre expression n'ont pas besoin d'exister dans la base de données sous-jacente, bien qu'elles soient finalement extraites des colonnes de la table sous-jacente. VARIANCE, par exemple, équivaut à :

((SALARY+COMMISSION) * 1.1) - (SALARY+COMMISSION)


Suppression d'une colonne de tri

  Rubriques connexes

Pour supprimer une colonne de tri :

1	Dans l'espace de travail de Query Builder, cliquez sur l'icône Trier.

2	Dans la liste Colonnes triées, cliquez deux fois sur le nom de la colonne à supprimer.


Tri des données d'interrogation

  Rubriques connexes

Pour trier les données extraites par l'interrogation :

1	Dans l'espace de travail de Query Builder, cliquez sur [image] dans la barre d'icônes.

2	Dans la liste Colonnes disponibles, cliquez deux fois sur la ou les colonnes à trier. L'inclusion d'une colonne de tri dans l'interrogation n'est pas nécessaire.

Pour modifier l'ordre de tri d'une colonne par rapport à l'option par défaut (ordre croissant) :

1	Dans la liste Colonnes triées, cliquez sur la colonne voulue pour la sélectionner.

2	Sélectionnez le bouton d'option Descendant.

3	Cliquez sur OK.


Définition d'une colonne

  Rubriques connexes

Pour définir une nouvelle colonne dans une table :

1	Ouvrez la table dans laquelle vous voulez définir une colonne.

2	Cliquez sur [image] dans la barre d'icônes.

3	Cliquez dans la boîte Colonnes définies.

4	Entrez le nom de la nouvelle colonne.

5	Cliquez dans la boîte Définies comme.

6	Entrez l'expression qui définit votre colonne.

7	Cliquez sur OK.


Collage d'une fonction

  Exemples 	  Rubriques connexes

Pour coller une fonction dans une condition :

1	Activez le champ Condition et placez le curseur à l'endroit où vous voulez insérer la fonction.

2	Cliquez sur [image] dans la barre d'icônes.

3	Utilisez les cases à cocher Afficher catégories pour filtrer les types de fonction affichés.

4	Sélectionnez une fonction dans la liste.

5	Cochez la case Coller des arguments pour inclure les arguments par défaut.

6	Cliquez sur OK.

7	Dans le champ Condition, remplacez les arguments par défaut par ceux à utiliser.


Exemple de fonction (extraction de noms de plus de 30 caractères)

  Rubriques connexes 	  Tous les exemples

Supposez que vous vouliez répertorier les noms de clients dépassant 30 caractères, car leur taille est trop importante pour vos étiquettes de publipostage. Pour ce faire, créez une condition à l'aide de la fonction LENGTH. Cette fonction compte les caractères d'une chaîne.

Dans cet exemple, l'argument de la fonction LENGTH correspond à la colonne NAME de la table client. La fonction apparaît donc de la manière suivante dans la condition :

LENGTH (NAME) > 30

A l'aide de cette condition, Query Builder étudie tous les noms de la colonne NAME et renvoie ceux dont la longueur de champ dépasse 30 caractères.


Création d'une condition imbriquée

  Rubriques connexes

Pour créer une condition imbriquée :

1	Dans le champ Condition, entrez la première expression en utilisant un opérateur de comparaison, comme : TOTAL<1000.Conseil

2	Entrez l'expression suivante, en utilisant un autre opérateur de comparaison, comme : EMP.LAST_NAME=SMITH

3	Entrez une troisième expression, en utilisant le même opérateur de comparaison (=) comme : EMP.LAST_NAME=JONES.

4	Sélectionnez la deuxième et la troisième expressions.

5	Cliquez sur [image] dans la barre d'icônes.

6	Cliquez sur [image] dans la barre d'icônes.


Dimensionnement de la fenêtre Conditions

Pour dimensionner la fenêtre Conditions :

1	Cliquez sur le rectangle noir situé en bas à gauche de la barre de défilement de l'espace de travail de Query Builder et déplacez le curseur vers le haut, dans la zone de travail.

2	Faites glisser la ligne noire épaisse vers la gauche pour agrandir la fenêtre Conditions ou vers la droite pour la diminuer. Si la fenêtre est entièrement masquée, la barre de partage apparaît à l'extrémité gauche de la barre de défilement.


Syntaxe des conditions

  Rubriques connexes

Le format général d'une condition est le suivant :

[expression] [opérateur] [expression]

où

expression	indique les valeurs qui définissent la condition ; les expressions peuvent indiquer des dates, des caractères, des valeurs littérales, des nombres, des fonctions et des colonnes de bases de données.
opérateur	indique un opérateur de comparaison comme supérieur à (>), inférieur à (<) et égal à (=). Les opérateurs les plus courants sont indiqués dans le menu Données et la barre d'icônes. A ces opérateurs viennent s'ajouter des opérateurs de comparaison spéciaux comme BETWEEN, LIKE et IN.
Valeurs de données

Lorsque vous travaillez sur des dates, les opérateurs de comparaison font référence à un temps relatif. Inférieur à (<) signifie "avant".

Les valeurs de date doivent être entre guillemets simples et indiquées au format JJ-MOI-AA, où JJ représente le jour du calendrier, MOI le mois et AA l'année.

Valeurs de caractères

Dans les colonnes de type caractère, les opérateurs font référence à l'ordre alphanumérique (A précédant B, les noms qui commencent par A sont "inférieurs à" ceux qui commencent par B, et ainsi de suite).

Valeurs littérales

Les valeurs littérales doivent être entre guillemets simples pour ne pas être confondues avec des noms de colonne. La comparaison entre les valeurs de base de données et les valeurs que vous indiquez tient compte de la différence entre majuscules et minuscules.

Valeurs numériques

Si la valeur que vous entrez est de type NUMBER, entrez uniquement la valeur numérique, sans mise en forme (c'est-à-dire sans séparateur décimal ou symbole monétaire ($), par exemple). Les guillemets simples ne sont pas nécessaires dans les colonnes numériques contenant des valeurs numériques.

Remarque : Trois opérateurs logiques (booléens) (AND, OR, NOT) vous permettent de créer des conditions multiples ou des conditions de négation.

Informations complémentaires : Pour plus d'informations sur la syntaxe Oracle des différents types de données, reportez-vous à Oracle8 Server SQL Language Reference Manual.


Création d'une condition de négation

  Rubriques connexes

Pour créer une condition de négation :

1	Créez une condition.

2	Cliquez sur le champ Condition pour l'activer.

3	Sélectionnez un opérateur logique pour la condition.

4	Cliquez sur [image] dans la barre d'icônes.

5	Appuyez sur la touche Entrée ou Retour pour valider la condition.

Remarque : L'opérateur NOT AND renvoie toutes les lignes, sauf celles qui remplissent toutes les conditions ; l'opérateur NOT OR renvoie toutes les lignes, sauf celles qui remplissent l'une des conditions.


Enregistrement des instructions SQL d'une interrogation

  Rubriques connexes

Pour enregistrer les instructions SQL d'une interrogation :

  Dans la fenêtre Interrogation, sélectionnez Fichier [image] Enregistrer instructions SQL pour afficher la boîte de dialogue correspondante, dans laquelle vous pouvez indiquer un nom de répertoire et de fichier.


Modification de l'ordre des colonnes

  Rubriques connexes

Pour modifier l'ordre d'apparition des colonnes dans les résultats de votre interrogation :

1	Dans l'espace de travail de Query Builder, cliquez sur [image] dans la barre d'icônes.

2	Dans la boîte de dialogue Séquence de colonne, cliquez sur une colonne de la liste Colonnes affichées et faites-la glisser vers l'emplacement voulu. La première colonne apparaît à l'extrémité gauche de l'écran et la dernière à l'extrémité droite.


Affichage des instructions SQL d'une interrogation

  Rubriques connexes

Pour afficher les instructions SQL d'une interrogation :

  Dans l'espace de travail de Query Builder, cliquez sur [image] dans la barre d'icônes.

La boîte de dialogue d'affichage des instructions SQL est en lecture seule ; vous ne pouvez ni modifier ni copier les instructions SQL.


Ajout d'une colonne à une interrogation

  Rubriques connexes

Pour ajouter une colonne à une interrogation :

 Sélectionnez la colonne dans la table de la fenêtre Interrogation. Conseil

Lorsqu'une coche apparaît dans la colonne, cette dernière est affichée dans les résultats de l'instruction SQL et de l'interrogation. Vous ne pouvez pas inclure une colonne dans l'instruction SQL et la masquer dans les résultats affichés.


Exemples

  Liste alphabétique

Propriété d'application - exemples

Propriété d'arc - exemples

Propriété d'axe (continu) - exemples

Propriété d'axe (de date) - exemples

Propriété d'axe (discret) - exemples

Propriété d'axe (générique) - exemples

Procédures internes

Procédures internes de graphique

Propriété d'éléments de graphique - exemples

Propriété de graphique - exemples

Propriété de texte composé - exemple

Procédures internes de base de données

Procédures internes d'affichage

Propriétés d'affichage - exemples

Propriétés de modèle de champ (graphique à axes)

Propriété de modèle de champ (générique) - exemples

Propriété d'encadrement (graphique à axes) - exemples

Propriété d'encadrement (générique) - exemples

Propriété d'encadrement (graphique à secteurs) - exemples

Propriété d'encadrement (graphique de type tableau) - exemples

Propriétés génériques - exemples

Procédures internes d'objet graphique

Propriété de graphique - exemples

Propriété de groupe - exemples

Propriété d'image - exemples

Procédures internes de couche

Propriété de ligne - exemples

Procédures internes diverses

Procédures internes de paramètre

Propriété de polygone - exemples

Propriété d'imprimante - exemples

Exemples de propriétés

Procédures internes d'interrogation

Propriétés d'interrogation - exemples

Propriété de rectangle - exemples

Propriété de ligne de référence - exemples

Propriété de rectangle arrondi - exemples

Propriété de texte simple - exemples

Procédures internes de son

Propriété de son - exemples

Propriété de symbole - exemples

Procédures internes de modèle

Propriété de texte - exemples

Procédures internes d'horloge

Propriétés d'horloge - exemples

Procédures internes TOOLS_INT

Procédures internes de fenêtre

Propriétés de fenêtre - exemples


Exemples de propriétés

  Liste alphabétique      [image]  Tous les exemples

Propriété d'application - exemples

Propriété d'arc - exemples

Propriété d'axe (continu) - exemples

Propriété d'axe (de date) - exemples

Propriété d'axe (discret) - exemples

Propriété d'axe (générique) - exemples

Propriété d'éléments de graphique - exemples

Propriété de graphique - exemples

Propriété de texte composé - exemples

Propriétés d'affichage - exemples

Propriétés de modèle de champ (graphique à axes)

Propriété de modèle de champ (générique) - exemples

Propriété d'encadrement (graphique à axes) - exemples

Propriété d'encadrement (générique) - exemples

Propriété d'encadrement (graphique à secteurs) - exemples

Propriété d'encadrement (graphique de type tableau) - exemples

Propriétés génériques - exemples

Propriété de graphique - exemples

Propriété de groupe - exemples

Propriété d'image - exemples

Propriété de ligne - exemples

Propriété de polygone - exemples

Propriété d'imprimante - exemples

Propriétés d'interrogation - exemples

Propriété de rectangle - exemples

Propriété de ligne de référence - exemples

Propriété de rectangle arrondi - exemples

Propriété de texte simple - exemples

Propriété de son - exemple

Propriété de symbole - exemples

Propriété de texte - exemples

Propriétés d'horloge - exemples

Propriétés de fenêtre - exemples


Procédures internes

  Liste alphabétique      [image]  Tous les exemples

Procédures internes de graphique

Procédures internes de base de données

Procédures internes d'affichage

Procédures internes d'objet graphique

Procédures internes de couche

Procédures internes diverses

Procédures internes de paramètre

Procédures internes d'interrogation

Procédures internes de son

Procédures internes de modèle

Procédures internes d'horloge

Procédures internes TOOLS_INT

Procédures internes de fenêtre


Propriété d'application - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de chaîne de connexion - exemples

Propriété de curseur - exemples

Propriété de résolution horizontale de présentation - exemples

Propriété de résolution horizontale d'écran - exemples

Propriété de mot de passe - exemples

Propriété de plate-forme - exemples

Propriété de nom utilisateur - exemples

Propriété de résolution verticale de présentation - exemples

Propriété de résolution verticale d'écran - exemples


Propriété d'arc - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de base d'arc - exemples

Propriété de fermeture - exemples

Propriété de remplissage - exemples


Propriété d'axe (de date) - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de maximum auto - exemples

Propriété de minimum auto - exemples

Propriété d'intervalle auto - exemples

Propriété de format personnalisé - exemples

Propriété de format de jour - exemples

Propriété de premier mois - exemples

Propriété d'étiquettes - exemples

Propriété de maximum - exemples

Propriété de minimum - exemples

Propriété de format de mois - exemples

Propriété de format de trimestre - exemples

Propriété de saut de week-ends - exemples

Propriété d'intervalle - exemples

Propriété de format d'année - exemples


Propriété d'axe (générique) - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété d'étiquettes d'axe - exemples

Propriété de type d'axe - exemples

Propriété d'étiquette personnalisée - exemples

Propriété de direction - exemples

Propriété de grille principale - exemples

Propriété de repères principaux - exemples

Propriété de grille secondaire - exemples

Propriété de graduation secondaire par intervalle - exemples

Propriété de position - exemples

Propriété d'étiquettes de graduation - exemples

Propriété de position de graduations - exemples

Propriété de rotation d'étiquette de graduation - exemples


Propriété d'axe (discret) - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de maximum auto - exemples

Propriété de minimum auto - exemples

Propriété de format de date - exemples

Propriété de nombre maximum de catégories - exemples

Propriété de nombre minimum de catégories - exemples

Propriété de format numérique - exemples


Propriété d'axe (continu) - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de maximum auto - exemples

Propriété de minimum auto - exemples

Propriété d'intervalle auto - exemples

Propriété de maximum - exemples

Propriété de minimum - exemples

Propriété de format numérique - exemples

Propriété de pourcentage par rapport à - exemples

Propriété de pourcentage de - exemples

Propriété d'échelle - exemples

Propriété d'intervalle - exemples


Procédures internes de graphique

  Tous les exemples    [image]  Rubriques connexes

OG_Delete Column - exemple

OG_Delete_Field - exemples

OG_Get_Chart_Element - exemples

OG_Get_Column - exemples

OG_Get Field - exemples

OG_Get_Row - exemples

OG_Insert_Field - exemples

OG_Make_Chart - exemples

OG_Update_Chart - exemples


Propriété d'éléments de graphique - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de procédure bouton - exemples

Propriété d'événement - exemples

Propriété d'explosion - exemples

Propriété de nom - exemples


Propriété de graphique - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de mise à jour automatique - exemples

Propriété de dernière ligne - exemples

Propriété de filtre - exemples

Propriétés d'interrogation - exemples

Propriété de plage - exemples

Propriété de taille et de position - exemples

Propriété de première ligne - exemples

Propriété de modèle - exemples

Propriété de titre - exemples


Propriété de texte composé - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de nombre d'éléments de texte simple - exemples


Procédures internes de base de données

  Tous les exemples     [image]  Rubriques connexes

OG_Connect - exemples

OG_Logged_On - exemples

OG_Logoff - exemples

OG_Logon - exemples


Procédures internes d'affichage

  Tous les exemples     [image]  Rubriques connexes

OG_Close_Display - exemples

OG_Generate_Display - exemples

OG_Get_Displqy - exemples

OG Isnull - exemples

OG_Open_Display - exemples

OG_Save_Display - exemples


Propriétés d'affichage - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de déclencheur de fermeture - exemples

Propriété de format de date - exemples

Propriété de hauteur - exemples

Propriété de déclencheur d'ouverture - exemples

Propriété de largeur - exemples


Propriété d'encadrement (graphique à axes) - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété d'axe de ligne de base - exemples

Propriété de valeur de ligne de base - exemples

Propriété de largeur de catégorie - exemples

Propriété de format de date personnalisé - exemples

Propriété de format numérique personnalisé - exemples

Propriété de nombre de lignes de référence - exemples

Propriété de second axe des Y - exemples


Propriété d'encadrement (générique) - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de profondeur - exemples

Propriété de type d'encadrement - exemples

Propriété de nombre de modèles de champ - exemples

Propriété de nombre de colonnes de légende - exemples

Propriété de légende - exemples

Propriété de nom - exemples

Propriété d'encadrement de tracé - exemples

Propriété de racine - exemples

Propriété d'orientation de l'ombre - exemples

Propriété de taille d'ombre - exemples


Propriété d'encadrement (graphique à secteurs) - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de catégories - exemples

Propriété de valeurs de données - exemples

Propriété de format de date de catégorie - exemples

Propriété d'absence de chevauchement - exemples

Propriété de format numérique de catégorie - exemples

Propriété Autres

Propriété de format de pourcentage - exemples

Propriété de valeurs de pourcentage - exemples

Propriété d'ordre de traçage - exemples

Propriété de repères - exemples

Propriété d'utilisation - exemples

Propriété de valeurs d'utilisation - exemples

Propriété de format de valeur - exemples


Propriété d'encadrement (graphique de type tableau) - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de maximum auto - exemples

Propriété de minimum auto - exemples

Propriété de noms de colonne - exemples

Propriété de nombre de lignes de séparation - exemples

Propriété de ligne de séparation horizontale - exemples

Propriété de nombre maximum de lignes - exemples

Propriété de nombre minimum de lignes - exemples

Propriété de ligne de séparation verticale - exemples


Propriété de modèle de champ (générique) - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de rotation de couleur - exemples

Propriété de format de date - exemples

Propriété de nom - exemples

Propriété de format numérique - exemples

Propriété de racine - exemples


Propriétés de modèle de champ (graphique à axes)

  Tous les exemples     [image]  Rubriques connexes

Propriété d'axe - exemples

Propriété d'ajustement de courbe - exemples

Propriété de rotation d'étiquette - exemples

Propriété de style de ligne - exemples

Propriété de chevauchement - exemples

Propriété de position de tracé - exemples

Propriété de type de tracé - exemples


Propriétés génériques - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de procédure bouton - exemples

Propriété de colonne - exemples

Propriété d'événement - exemples

Propriété d'exécution d'interrogation - exemples

Propriété de déclencheur de format - exemples

Propriété de boîte englobante intérieure - exemples

Propriété de nom - exemples

Propriété de boîte englobante extérieure - exemples

Propriété de type d'objet - exemples

Propriété de père - exemples

Propriété de définition de paramètre - exemples

Propriété de masquage d'objet - exemples


Propriété de graphique - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de couleur d'arrière-plan du bord - exemples

Propriété de style de relief - exemples

Propriété de couleur de remplissage d'arrière-plan - exemples

Propriété de style d'extrémité - exemples

Propriété de style de pointillé - exemples

Propriété de motif de bord - exemples

Propriété de largeur de bord - exemples

Propriété de couleur de premier plan du bord - exemples

Propriété de couleur de remplissage de premier plan - exemples

Propriété de motif de remplissage - exemples

Propriété de style de jointure - exemples

Propriété d'angle de rotation - exemples

Propriété de mode de transfert - exemples


Propriété de groupe

  Tous les exemples     [image]  Rubriques connexes

Propriété de nombre de fils - exemples

Propriété d'indicateur de clipping - exemples


Propriété d'image - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de rectangle de clipping - exemples

Propriété de trame - exemples

Propriété de hauteur - exemples

Propriété de position - exemples

Propriété de qualité - exemples

Propriété de largeur - exemples


Procédures internes de couche

  Tous les exemples     [image]  Rubriques connexes

OG_Activate_Layer - exemples

OG_Get_Layer - exemples

OG_Hide_Layer - exemples

OG_Show_Layer - exemples


Propriété de ligne - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de style de flèche - exemples

Propriété de point final - exemples

Propriété de point de départ - exemples


Procédures internes diverses

  Tous les exemples     [image]  Rubriques connexes

OG_Append_Directory - exemples

OG_Append_File - exemples

OG_center - exemples

OG_Damage (région) - exemples

Do_Sql - exemples

OG_Get_Attr (application) - exemples

OG_Get_Attr (axe) - exemples

OG_Get_Attr (affichage) - exemples

OG_Get_Attr (modèle de champ) - exemples

OG_Get_Attr (modèle d'encadrement) - exemples

OG_Get_Attr (objet) - exemples

OG_Get_Attr (imprimante) - exemples

OG_Get_Attr (interrogation) - exemples

OG_Get_Attr (ligne de référence) - exemples

OG_Get_Attr (son) - exemples

OG_Get_Attr (horloge) - exemples

OG_Get_Attr (fenêtre) - exemples

OG_Translate_Envvar - exemples

OG_User_Exit - exemples


Procédures internes d'objet graphique

  Tous les exemples     [image]  Rubriques connexes

OG_Clone (objet) - exemples

OG_Damage (objet) - exemples

OG_Delete_Child - exemples

OG_Delete_Cmptext - exemples

OG_Delete_Point - exemples

OG_Delete_Property - exemples

OG_Delete_Smptext - exemples

OG_Destroy (objet) - exemples

OG_Draw - exemples

OG_Export_Drawing (affichage) - exemples

OG_Export_Drawing (objet/couche) - exemples

OG_Export_Drawing (fenêtre) - exemples

OG_Export_Image - exemples

OG_Get_Char_Property - exemples

OG_Get_Child - exemples

OG_Get_Cmptext - exemples

OG_Get_Date_Property - exemples

OG_Get_Num_Property - exemples

OG_Get_Object - exemples

OG_Get_Point - exemples

OG_Get_Smptext - exemples

OG_Import_Drawing - exemples

OG_Import_Image - exemples

OG_Insert_Child - exemples

OG_Insert_Cmptext - exemples

OG_Insert_Point - exemples

OG_Insert_Smptext - exemples

OG_Make_Ellipse - exemples

OG_Make_Group - exemples

OG_Make_Image - exemples

OG_Make_Line - exemples

OG_Make_Poly - exemples

OG_Make_Rect - exemples

OG_Make_Rrect - exemples

OG_Make_Symbol - exemples

OG_Make_Text - exemples

OG_Move - exemples

OG_Point_In - exemples

OG_Point_Near - exemples

OG_Property_Exists - exemples

OG_Rotate - exemples

OG_Same - exemples

OG_Scale - exemples

OG_Set_Edgecolor - exemples

OG_Set_Fillcolor - exemples

OG_Set_Property - exemples

OG_Synchronize - exemples

OG_Update_Bbox - exemples


Procédures internes de paramètre

  Tous les exemples     [image]  Rubriques connexes

OG_Delete_Param - exemples

OG_Get_Char_Param - exemples

OG_Get_Date_Param - exemples

OG_Get_Num_Param - exemples

OG_Get_Param_Type - exemples

OG_Param_Exists - exemples

OG_Set_Param - exemples


Propriété de polygone - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de fermeture - exemples

Propriété de nombre de points - exemples


Propriété d'imprimante - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de nombre de copies - exemples

Propriété de dernière page - exemples

Propriété de fichier d'impression - exemples

Propriété de mode paysage - exemples

Propriété de nom - exemples

Propriété de format de page - exemples

Propriété de première page - exemples


Procédures internes d'interrogation

  Tous les exemples     [image]  Rubriques connexes

OG_Append_Row - exemples

OG_Clear_Query - exemples

OG_Data_Changed - exemples

OG_Data_Queried - exemples

OG_Destroy (interrogation) - exemples

OG_Execute_Query - exemples

OG_Get_Charcell - exemples

OG_Get_Datecell - exemples

OG_Get_Newrows - exemples

OG_Get_Numcell - exemples

OG_Get_Query - exemples

OG_Get_Schema - exemples

OG_Insert_Column - exemples

OG_Make_Query - exemples

OG_Next_Row - exemples

OG_Numcols - exemples

OG_Numrows - exemples

OG_Set_Charcell - exemples

OG_Set_Datecell - exemples

OG_Set_Numcell - exemples

OG_Set_Schema - exemples

OG_Start_From - exemples


Propriétés d'interrogation - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de type de tampon - exemples

Propriété de procédure d'interrogation personnalisée - exemples

Propriété de format de date - exemples

Propriété d'exécution sur ouverture - exemples

Propriété d'exécution sur horloge - exemples

Propriété de nombre maximum de lignes - exemples

Propriété de nombre maximal de lignes - exemples

Propriété de nom - exemples

Propriété de procédure du déclenchement après interrogation - exemples

Propriété de source d'interrogation - exemples

Propriété de type d'interrogation - exemples


Propriété de rectangle - exemple

  Tous les exemples     [image]  Rubriques connexes

Propriété de rectangle de base - exemples


Propriété de ligne de référence - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété d'axe - exemples

Propriété de valeur de date - exemples

Propriété de libellé - exemples

Propriété de valeur numérique - exemples


Propriété de rectangle arrondi - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de rectangle de base - exemples

Propriété de rayon d'angle - exemples


Propriété de son - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de nom - exemples


Procédures internes de son

  Tous les exemples     [image]  Rubriques connexes

OG_Destroy (son) - exemples

OG_Export_Sound - exemples

OG_Get_Sound - exemples

OG_Import_Sound - exemples

OG_Make_Sound - exemples

OG_Play_Sound - exemples

OG_Record_Sound - exemples

OG_Stop_Sound - exemples


Propriété de texte simple - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de couleur - exemples

Propriété de police - exemples

Propriété de chaîne de texte - exemples


Propriété de symbole - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de centre - exemples

Propriété d'index - exemples

Propriété de taille de symbole - exemples


Procédures internes de modèle

  Tous les exemples     [image]  Rubriques connexes

OG_Clone (modèle) - exemples

OG_Delete_Ftemp - exemples

OG_Delete_Refline - exemples

OG_Destroy (modèle) - exemples

OG_Export_Template - exemples

OG_Get_Axis - exemples

OG_Get_Ftemp - exemples

OG_Get_Refline - exemples

OG_Get_Template - exemples

OG_Import_Template - exemples

OG_Insert_Ftemp - exemples

OG_Insert_Refline - exemples

OG_Make_Template - exemples


Propriétés d'horloge - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété active - exemples

Propriété d'intervalle - exemples

Propriété de nom - exemples

Propriété de procédure - exemples


Procédures internes d'horloge

  Tous les exemples     [image]  Rubriques connexes

OG_Activate_Timer - exemples

OG_Deactivate_Timer - exemples

OG_Destroy (horloge) - exemples

OG_Get_Timer - exemples

OG_Make_Timer - exemples


Procédures internes TOOLS_INT

  Tous les exemples     [image]  Rubriques connexes

Tool_Int.Add_Parameter - exemples

Tool_Int.Create_Parameter_List - exemples

Tool_Int.Delete_Parameter - exemples

Tool_Int.Destroy_Parameter_List - exemples

Tool_Int.Get_Parameter_Attr - exemples

Tool_Int.Get_Parameter_List - exemples

Tool_Int.Isnull - exemples

Tool_Int.Run_Product - exemples

Tool_Int.Set_Parameter_Attr - exemples


Propriété de texte - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de hauteur de boîte englobante - exemples

Propriété de largeur de boîte englobante - exemples

Propriété de jeu de caractères - exemples

Propriété de couleur - exemples

Propriété de nombre d'éléments de texte composé - exemples

Propriété d'espacement personnalisé - exemples

Propriété de boîte englobante fixe - exemples

Propriété d'alignement horizontal - exemples

Propriété d'origine horizontale - exemples

Propriété invisible - exemples

Propriété de crénage - exemples

Propriété la plus proche - exemples

Propriété de taille en points - exemples

Propriété de boîte englobante pouvant être mise à l'échelle - exemples

Exemples de propriété de police pouvant être mise à l'échelle - exemples

Propriété d'espacement - exemples

Propriété de style - exemples

Propriété de synthétisation - exemples

Propriété de police - exemples

Propriété d'alignement vertical - exemples

Propriété d'origine verticale - exemples

Propriété de graisse - exemples

Propriété de largeur - exemples

Propriété de passage automatique à la ligne - exemples


Propriétés de fenêtre - exemples

  Tous les exemples     [image]  Rubriques connexes

Propriété de hauteur - exemples

Propriété de cible d'aide - exemples

Propriété de nom - exemples

Propriété de position - exemples

Propriété de largeur - exemples


Procédures internes de fenêtre

  Tous les exemples     [image]  Rubriques connexes

OG_Destroy (fenêtre) - exemples

OG_Get_Window

OG_Hide_Window - exemples

OG_Make_Window - exemples

OG_Show_Window - exemples


Propriété de texte composé
Propriétés de texte composé

Propriété de nombre d'éléments de texte simple

Propriété de nombre d'éléments de texte composé


Propriété de nombre d'éléments de texte simple

  Exemples	  Rubriques connexes

Description  Nombre d'éléments de texte simple qui composent l'élément de texte composé.

Syntaxe

FUNCTION OG_Get_Stcount
  (texte           OG_Object,
   cmptext_index  NUMBER)
RETURN NUMBER;

Paramètres

texte	Elément texte décrit.
cmptext_index	Numéro d'index de l'élément texte composé décrit.


Propriété de nombre d'éléments de texte simple - Exemples

  Liste alphabétique          [image]  Tous les exemples     [image]  Rubriques connexes

*/La procédure ci-après lit le nombre
**de texte simple du premier texte composé
**d'un objet texte, et imprime à nouveau ce nombre
**dans l'objet texte.
*/

 PROCEDURE simpleText IS

  num number;

  text og_object;

BEGIN

  text := og_get_object('texte');

  num := og_get_stcount(text,0);

  og_set_str(text, num);

END;