Rubrique d'aide introuvable. Recherchez les rubriques connexes dans l'aide en ligne.


A propos des états de style tabulaire

  Rubriques connexes

L'état de style tabulaire est la forme d'état la plus simple. Chaque colonne correspond à une colonne sélectionnée dans la base de données.


A propos des états de style formulaire

  Rubriques connexes

Un état de style formulaire affiche un enregistrement par page et insère les valeurs des champs à droite des libellés de champs.


A propos des états de style étiquette de publipostage

  Rubriques connexes

Un état de style étiquette de publipostage imprime sur chaque page plusieurs colonnes d'étiquettes de publipostage. Sur la page, vous pouvez imprimer les étiquettes de gauche à droite puis de haut en bas, ou de haut en bas puis de gauche à droite.


A propos des états de style lettre type

  Rubriques connexes

Un état de style lettre type contient des valeurs de base de données insérées dans un texte standard (Est considéré comme texte standard tout texte saisi ou importé dans un éditeur d'état.)


A propos des états de style groupe - gauche

  Rubriques connexes

Un état de style groupe - gauche divise les lignes d'une table en " sous-ensembles " basés sur une valeur commune dans l'une des colonnes. Ce type d'état permet d'empêcher une colonne de répéter plusieurs fois la même valeur alors que les valeurs des colonnes associées changent.


A propos des états de style groupe - niveau supérieur

  Rubriques connexes

Un état de style groupe - niveau supérieur contient deux groupes de données ou davantage. Pour chaque valeur du groupe maître, les valeurs associées du ou des groupe(s) détails sont extraites de la base de données.


A propos des états de style matriciel

  Rubriques connexes

Un état de style matriciel (par références croisées) contient une ligne de libellés, une colonne de libellés et des informations sous forme de grille associées à ces libellés. Une caractéristique des états de style matriciel est que le nombre de leurs colonnes n'est connu qu'une fois les données extraites de la base de données.

Pour créer un état de style matriciel, il vous faut au moins quatre groupes : un de ces groupes doit être un groupe inter-produit, deux autres groupes doivent se trouver dans le groupe inter-produit pour fournir les ""libellés"", et le dernier groupe doit fournir les informations destinées à remplir les cellules. Ces groupes peuvent appartenir à une même interrogation ou à plusieurs interrogations.


A propos des états de style matriciel avec groupe

  Rubriques connexes

Un état de style matriciel avec groupe est un état de style groupe - niveau supérieur dans lequel chaque valeur du groupe maître possède une matrice distincte.


A propos des états de style matriciel imbriqués

  Rubriques connexes

Un état de style matriciel (par références croisées) imbriqué est un état de style matriciel dans lequel au moins une relation père/fils apparaît dans la grille de la matrice.

La nouvelle propriété Dimension fils du groupe imbriqué vous permet d'éliminer les lignes et/ou colonnes vides d'une matrice imbriquée à interrogation unique.


A propos des états de style multimédia

  Rubriques connexes

Un état de style multimédia peut contenir des images, du son et de la vidéo. Vous pouvez afficher des images dans des champs de votre état ou créer des boutons qui, lorsque l'utilisateur clique dessus dans l'aperçu interactif, affichent des images, ou lisent des sons ou des séquences vidéo.

Pour ajouter des sons ou de la vidéo à un état, vous pouvez sélectionner dans la base de données une colonne qui contient les objets son ou les noms de fichier des objets vidéo, ou créer un bouton dans la présentation de l'état.


A propos des états OLE2

  Rubriques connexes

Un état OLE2 peut afficher des objets tels que feuilles de calcul, graphiques et sons issus d'applications compatibles OLE2. Les états contenant des objets OLE2 ne sont pris en charge que sur la plate-forme Windows. La portabilité ne peut être obtenue que par la création d'un état multimédia.

Pour ajouter des objets OLE2 à un état, vous pouvez sélectionner dans la base de données une colonne qui contient des objets (ou leurs noms de fichier), ou lire un objet OLE2 à partir d'un fichier dans la présentation de l'état.

•	Lorsque vous sélectionnez des objets OLE2 dans la base de données, Report Builder génère automatiquement un champ ou un bouton (par exemple, pour la vidéo ou le son) destiné à contenir chaque objet OLE.

•	Lorsque vous utilisez l'outil Objet OLE2 dans la vue Modèle de présentation, vous pouvez appeler un serveur OLE2 et créer l'objet directement, ou alors utiliser un fichier existant. Une fois un fichier imbriqué, vous pouvez l'activer si vous avez accès à l'application utilisée pour le créer.


A propos des états hiérarchisés

  Rubriques connexes

Un état hiérarchisé est en fait constitué de deux états ou davantage, fonctionnant ensemble. L'état de niveau supérieur lance un état secondaire qui donne davantage de détails sur les données de l'enregistrement en cours. Pour permettre une plus grande souplesse dans la sélection des détails, vous pouvez créer dans l'état de niveau supérieur un bouton qui exécute PL/SQL afin d'appeler l'état détail et préciser les conditions de son exécution. L'état détail peut fournir des détails sur un seul enregistrement, sur un groupe d'enregistrements ou sur l'état dans son ensemble.

Pour activer les boutons de hiérarchisation, exécutez l'état, puis affichez-le dans l'aperçu interactif.


A propos des états de style Web

  Rubriques connexes

Vous pouvez envoyer le résultat de votre état vers un fichier HTML ou un fichier au format PDF (Portable Document Format). Les fichiers HTML peuvent s'afficher à l'aide d'un navigateur Web. Les fichiers PDF, quant à eux, nécessitent un visualisateur PDF. Vous pouvez également ajouter des liens Web afin d'offrir à l'utilisateur final des états interactifs et de les diffuser sur le World Wide Web.

Pour obtenir un aperçu de votre état dans un navigateur Web, vous pouvez utiliser Affichage [image] Aperçu Web dans l'aperçu interactif afin de juger immédiatement des modifications apportées au fichier HTML ou PDF.


A propos des liens Web pour les fichiers PDF

  Rubriques connexes

Les états au format PDF peuvent contenir les types suivants de liens Web : Conseils

•	Un lien d'un objet vers un autre objet à l'intérieur du même état ou vers un autre document HTML ou PDF (hyperlien).

•	Un lien allant d'une section de graphique vers une destination d'hyperlien, un autre état, un autre graphique ou une ligne de données dans la sortie d'état (création d'un hyperlien de graphique).

•	Une chaîne dans la zone de signet du visualisateur PDF qui crée un lien avec un objet associé (signet). Vous pouvez associer un signet à tout objet imprimable (champ, texte standard, encadrement, etc.) de la présentation de votre état. Dans l'état mis en forme, il suffit de cliquer sur un signet pour faire apparaître l'objet associé en haut de la fenêtre.

•	Un lien qui exécute une commande lorsque l'utilisateur clique dessus (lien de ligne de commande d'application). Vous pouvez associer une commande à tout objet imprimable (champ, texte standard, encadrement, etc.) de la présentation de votre état. Dans l'état mis en forme, il suffit de cliquer sur l'objet pour exécuter la commande associée.

•	Un identificateur de la destination d'un lien Web (destination d'hyperlien). La destination peut être tout objet imprimable (champ, texte standard, encadrement, etc.) de la présentation de votre état.

Dans la plupart des cas, vous pouvez définir les liens Web dans la palette de propriétés d'un objet. Vous pouvez indiquer des noms de colonnes et de champs dans la valeur du lien afin de créer des liens dynamiques au moment de l'exécution. Si vous souhaitez mettre en oeuvre des liens Web plus complexes, par exemple avec des paramètres conditionnels, vous devrez recourir à PL/SQL.


A propos des liens Web pour les fichiers HTML

  Rubriques connexes

Les états au format PDF peuvent contenir les types suivants de liens Web : Conseils

•	Un lien d'un objet vers un autre objet à l'intérieur du même état ou vers un autre document HTML ou PDF (hyperlien).

•	Une chaîne dans un encadrement du document HTML maître qui crée un lien vers un objet associé (signet). Vous pouvez associer un signet à tout objet imprimable (champ, texte standard, encadrement, etc.) de la présentation de votre état. Dans l'état mis en forme, il suffit de cliquer sur un signet pour faire apparaître l'objet associé en haut de la fenêtre.

•	Un identificateur de la destination d'un lien Web (destination d'hyperlien). La destination peut être tout objet imprimable (champ, texte standard, encadrement, etc.) de la présentation de votre état.

•	Un en-tête de document (échappement Avant état). Cet attribut est utile pour placer un logo ou des liens standard au début d'un document HTML.

•	Un pied de document (échappement Après état). Cet attribut est utile pour placer un logo ou des liens standard à la fin d'un document HTML :

•	Un en-tête de page (échappement Avant page). Cet attribut est utile pour placer un logo ou des liens standard au début d'une page ou de toutes les pages d'un document HTML.

•	Un pied de page (échappement Après page). Cet attribut est utile pour placer un logo ou des liens standard à la fin d'une page ou de toutes les pages d'un document HTML.

•	Un en-tête de grille de paramètres (échappement Avant grille). Cet attribut est utile pour placer un logo ou des liens standard dans l'en-tête de la grille de paramètres HTML.

•	Un pied de grille de paramètres (échappement Après grille). Cet attribut est utile pour placer un logo ou des liens standard dans le pied de la grille de paramètres HTML.

•	Des URL indiquant des ressources d'image. Les URL doivent être disponibles sur votre serveur Web de sorte que les images puissent être localisées lorsque le fichier HTML est affiché par le serveur.

•	Tout repère HTML pris en charge.

Dans la plupart des cas, vous pouvez définir les liens Web dans la palette de propriétés d'un objet. Vous pouvez indiquer des noms de colonnes et de champs dans la valeur du lien afin de créer des liens dynamiques au moment de l'exécution. Si vous souhaitez mettre en oeuvre des liens Web plus complexes, par exemple avec des paramètres conditionnels, vous devrez indiquer le lien à l'aide de PL/SQL et la procédure en package interne de Report Builder SRW.SET_ATTR.


A propos de la modification des couleurs

Les sélections de couleurs s'appliquent à l'objet dans sa totalité (par exemple, vous pouvez appliquer une couleur à tout le texte d'un objet, mais pas à un segment du texte).


A propos de la rotation des objets

Vous ne pouvez faire pivoter que le texte standard et les graphiques. Vous ne pouvez pas faire pivoter les autres objets de présentation (encadrements, encadrements itératifs ou champs).


A propos du redimensionnement des objets

Vous pouvez redimensionner les interrogations, les groupes, les encadrements et les encadrements itératifs, les champs, les objets matrices et le texte standard. Un point d'ancrage est automatiquement redimensionné si vous déplacez un des objets qu'il ancre.


A propos des images

  Rubriques connexes%!Alink(crtbutimg;rdimgfil;selimgdb;crtcollgis;crtbpurl;selurl;impgraph, , , )

Pour ajouter une image à un état, vous pouvez :

•	sélectionner dans la base de données une colonne contenant des images,

•	importer l'image dans la présentation de l'état à partir d'un fichier,

•	pour un fichier HTML, référencer le lien URL à l'image.

Par défaut, les images s'affichent dans des champs de façon à apparaître sur l'état imprimé et non seulement dans l'Aperçu interactif. Si vous préférez, vous pouvez créer pour les images des boutons qui n'apparaîtront pas sur l'état imprimé mais sur lesquels il sera possible de cliquer dans l'aperçu interactif pour afficher les images.

Pour ne pas risquer de manquer d'espace disque local et pouvoir ajouter ainsi un nombre illimité d'objets images, utilisez des références sans cache. Une référence sans cache fait que les objets ne sont lus à partir de la base de données que si nécessaire pendant le traitement d'un état. Pour pouvoir utiliser cette fonction, vous devez être connecté à une base de données ORACLE V7.1 ou de version ultérieure

Si vous référencez un URL pour une image, celle-ci s'affiche lorsque vous formatez votre état pour un fichier HTML. Pour les autres formats de fichier, le texte de URL s'affiche dans l'Aperçu interactif ; rien n'est affiché dans la destination (par exemple, un fichier ou un document PDF). Il vous incombe de vérifier si l'URL existe ; en effet, Report Builder ne valide pas l'existence de la ressource ni la syntaxe du protocole. La taille de l'objet contenant l'URL définit celle de l'image dans le fichier HTML. Toute propriété d'élasticité appliquée à l'objet n'est pas prise en compte.


A propos du son et de la vidéo

  Rubriques connexes

Pour ajouter du son et de la vidéo à un état, vous pouvez sélectionner dans la base de données une colonne contenant les objets son ou les noms de fichier d'objets son ou vidéo, ou créer un bouton dans la présentation de l'état.

Lorsque vous sélectionnez une colonne son ou vidéo dans la base de données, Report Builder crée automatiquement des boutons pour les objets. Pour activer les boutons, exécutez l'état, puis affichez-le dans l'aperçu interactif.

Pour ne pas risquer de manquer d'espace disque local et pouvoir ajouter ainsi un nombre illimité d'objets son, utilisez des références sans cache. Une référence sans cache fait que les objets ne sont lus à partir de la base de données que si nécessaire pendant le traitement d'un état. Pour pouvoir utiliser cette fonction, vous devez être connecté à une base de données ORACLE V7.1 ou suivante.


A propos des packages intégrés de Report Builder

  Rubriques connexes

Dans le but de vous économiser du temps, Report Builder est livré avec un package intégré (SRW) composé d'un ensemble de programmes PL/SQL contenant de nombreuses fonctions, procédures et exceptions auxquelles faire référence dans vos bibliothèques ou vos états.

Outre le package intégré de Report Builder, Procedure Builder offre des packages PL/SQL contenant de nombreux programmes PL/SQL auxquels faire référence lorsque vous déboguez vos unités de programme.


A propos des déclencheurs d'état

  Restrictions 	  Exemples	  Rubriques connexes

Les déclencheurs d'état exécutent des fonctions PL/SQL à des moments précis lors de l'exécution et de la mise en forme de votre état. A l'aide des capacités de traitement conditionnel des instructions PL/SQL de ces déclencheurs, vous pouvez notamment personnaliser le formatage de l'état, effectuer des tâches d'initialisation et accéder à la base de données. Pour créer ou modifier un déclencheur d'état, utilisez Déclencheurs d'état dans le Navigateur d'objets. Les déclencheurs d'état doivent renvoyer explicitement TRUE ou FALSE. Report Builder propose cinq déclencheurs d'état globaux (vous ne pouvez pas en créer d'autres) :

Déclencheur After Parameter Form

Déclencheur After Report

Déclencheur Before Parameter Form

Déclencheur Before Report

Déclencheur Between Pages


A propos des déclencheurs de format

  Exemples	  Rubriques connexes

Un déclencheur de format est une fonction PL/SQL exécutée avant la mise en forme d'un objet. Vous pouvez utiliser un déclencheur pour modifier dynamiquement les attributs de mise en forme d'un objet.


A propos des filtres de groupe

  Restrictions 	  Exemples	  Rubriques connexes

Un filtre de groupe détermine les enregistrements à inclure dans un groupe. Vous pouvez utiliser les filtres en package, First et Last, pour afficher les n premiers ou derniers enregistrements du groupe, ou encore créer vos propres filtres à l'aide de PL/SQL.


A propos des sorties utilisateur

Une sortie utilisateur est un programme que vous écrivez puis que vous liez dans l'exécutable de Report Builder ou dans les bibliothèques DLL de sorties utilisateur. Les sorties utilisateur vous permettent de transmettre le contrôle de Report Builder vers un programme écrit par vous, qui effectue une fonction particulière, puis de rendre le contrôle à Report Builder.

Vous pouvez écrire les types de sorties utilisateur suivants :

•	sorties utilisateur du précompilateur ORACLE

•	sorties utilisateur OCI (ORACLE Call Interface)

•	sorties utilisateur non ORACLE

Vous pouvez également écrire une sortie utilisateur combinant l'interface du précompilateur ORACLE et OCI.

Les sorties utilisateur peuvent effectuer les tâches suivantes :

•	exécuter des manipulations complexes de données

•	transmettre à Report Builder des données en provenance de fichiers texte du système d'exploitation

•	manipuler des données de type LONG RAW

•	prendre en charge des blocs PL/SQL

•	contrôler des périphériques en temps réel, tels qu'une imprimante ou un robot

Vous pouvez également recourir aux sorties utilisateur pour d'autres tâches, comme par exemple le traitement mathématique. Cependant, Oracle Corporation recommande d'exécuter de telles tâches avec PL/SQL à l'intérieur de Report Builder.

Notes d'utilisation

•	Tous les types de sorties utilisateur ne peuvent pas effectuer toutes les tâches présentées. La plupart ne peuvent être exécutées qu'avec les sorties utilisateur du précompilateur ORACLE.

•	Certains détails relatifs à la mise en oeuvre des sorties utilisateur sont propres aux différents systèmes d'exploitation.


A propos de l'interface d'appel

Une interface d'appel est un ensemble de procédures standard que vous pouvez appeler dans vos programmes en langage de troisième génération. Report Builder est fourni avec plusieurs de ces procédures (écrites en C), une pour chacun des exécutables suivants :

Exécutables	Procédures

RWCON60	RWCCON, RW2CON

RWRUN60 (bitmap)	RWCRRB, RW2RRB

RWRUN60 (mode caractère)	RWCRUN, RW2RUN

RWBLD60 (bitmap)	RWCSRB, RW2SRB

Imaginons par exemple que vous avez écrit un programme en Pro*FORTRAN et que vous voulez l'exécuter dans un état Report Builder (en utilisant l'exécutable en mode caractère RWRUN60). Pour cela, vous ajoutez un appel de procédure RWCRUN ou RW2RUN dans votre programme. (Pour savoir laquelle des deux procédures utiliser, reportez-vous à la partie du présent chapitre consacrée à la syntaxe.)

Vous trouverez un exemple complet d'utilisation de l'interface d'appel dans $ORACLE_HOME/REPORT30/OCI/Samples. Vous pouvez également consulter le fichier oci_info.txt dans $ORACLE_HOME/REPORT30/OCI.

Notes d'utilisation

•	Pour que vous puissiez utiliser l'interface d'appel, votre programme doit être écrit dans l'un des langages hôte de l'interface de programmation ORACLE (Ada, C, COBOL, FORTRAN, Pascal ou PL/l). Lorsque vous invoquez RWCON60 via l'interface d'appel, vous obtiendrez l'exécutable fourni pour votre plate-forme (bitmap ou mode caractère).

•	Dans la version 2.5, il existe deux procédures nommées RWCSRV et RW2SRV. Dans Report Builder 3.0 et versions ultérieures, vous devez remplacer celles-ci en utilisant RWCRRB et RW2RRB avec BACKGROUND=YES.


A propos des unités de programme et de l'éditeur PL/SQL

  Exemples	  Restrictions 	  Rubriques connexes

Les unités de programme sont des packages, des fonctions ou des procédures auxquels vous pouvez faire référence à partir de tout programme PL/SQL dans l'état en cours.

Remarque : Vous ne pouvez pas faire référence à des unités de programme à partir d'autres documents. Pour créer un package, une fonction ou une procédure auxquels faire référence à partir de plusieurs documents, vous devez créer une bibliothèque PL/SQL externe.

Dans l'éditeur PL/SQL, vous pouvez :

•	Cliquer sur Compiler pour compiler le code de l'unité de programme.

•	Cliquer sur Appliquer pour enregistrer toutes les modifications apportées à l'unité de programme depuis la dernière opération d'application ou de rétablissement. Aucune compilation n'est effectuée.

•	Cliquer sur Rétablir pour restaurer l'état de l'unité de programme tel qu'il était lors de la première ouverture de l'éditeur ou lors de la dernière opération d'application ou de rétablissement.

•	Cliquer sur Nouveau pour afficher la boîte de dialogue Nouvelle unité de programme, dans laquelle vous pouvez indiquer le nom et le type de l'unité de programme que vous désirez créer.

•	Cliquer sur Supprimer pour supprimer l'unité de programme actuellement affichée dans l'éditeur. Le système vous invite à confirmer votre demande avant de supprimer effectivement l'unité de programme.

•	Cliquer sur Fermer pour fermer l'éditeur PL/SQL.

•	Effectuer une sélection dans la liste déroulante Nom pour naviguer parmi les unités de programme existantes.

Lorsque vous apportez des modifications à une unité de programme, les unités de programme qui en dépendent perdent leur statut compilé, signalé par une astérisque (*) à la suite de leur nom dans le noeud Unités de programme du Navigateur d'objet. Vous pouvez accéder à ces unités de programme directement dans l'éditeur PL/SQL en utilisant la liste déroulante Nom afin de les recompiler.


PL/SQL (référence à une fonction PL/SQL dans les formules) - exemple

  Rubriques connexes 	  Tous les exemples

Supposons un état contenant les groupes et les colonnes suivantes :

Groupes	Colonnes	Fonction récapitulative
--------------------------------------------------
RGN	REGION
RGNSUMSAL	SUM(DEPTSUMSAL)
COSTOFLIVING

DEPT	DNAME
DEPTNO
DEPTSUMSAL	SUM(EMP.SAL)

JOB	JOB
HEADCOUNT	COUNT(EMP.EMPNO)

EMP	ENAME
EMPNO
SAL
COMM

Sur la base de ces groupes et de ces colonnes, vous pouvez créer plusieurs formules qui appliquent le facteur coût de la vie (COSTOFLIVING) aux salaires. Pour éviter tout travail répétitif, vous pouvez créer la fonction PL/SQL suivante et y faire référence dans les formules :

function CompSal(salary number) return number
  is
begin
  return (salary*CostofLiving);
end;

Voici quelques exemples de formules faisant référence à la fonction PL/SQL :

CompSal(:RGNSUMSAL)

ou

CompSal(:SAL) + COMM


Restrictions des unités de programme

•	SI vous supprimez un package, une fonction ou une procédure PL/SQL, vous devez également supprimer dans votre état toutes les références correspondantes. Sinon, vous obtiendrez une erreur lors de la compilation, de la génération ou de l'exécution de votre état.

•	Les noms de packages, de fonctions et de procédures PL/SQL doivent être uniques dans l'état et être différents des noms de colonnes, de groupes, d'interrogations et d'objets imprimables.


A propos de l'activation et de la désactivation des actions de débogage

Dans le noeud Actions de débogage du Navigateur d'objet, une astérisque en regard d'une action de débogage indique qu'elle est désactivée. L'absence d'astérisque signale qu'une action de débogage est activée.


A propos de MAPI

  Rubriques connexes

mapinobatch

Sur la plate-forme Windows, vous pouvez envoyer vos états par courrier électronique via l'interface Messaging Application Programming Interface (MAPI) de Microsoft. Les états en mode bitmap sont envoyés comme pièces jointes au format PostScript encapsulé. Les états en mode caractère sont envoyés comme texte ASCII.

Conditions préalables : Vous devez disposer d'une application de messagerie cliente MAPI appropriée installée sous Windows 95, Windows pour Workgroups 3.11 ou Windows NT. Pour plus d'informations sur la façon de configurer votre ordinateur pour la messagerie électronique, reportez-vous à la documentation de votre système d'exploitation.

Remarque : Lors de l'exécution de Reports Server (RWMTS60), Windows NT ne parvient pas à envoyer l'état par courrier électronique. Microsoft prévoit de corriger ce problème dans Microsoft Exchange Server 5.0. Vous pouvez d'ici là corriger ce problème en exécutant Reports Server au premier plan à l'aide de la commande suivante : RWMTS60.EXE -listen tnsname.


A propos des points d'ancrage

Les points d'ancrage permettent de déterminer le positionnement horizontal et vertical d'un objet fils par rapport à son père. L'extrémité du point d'ancrage portant un symbole est reliée à l'objet père.

  Cliquez ici pour faire apparaître un schéma présentant les différentes parties d'un point d'ancrage

La taille de certains objets de présentation pouvant évoluer lors de l'exécution de l'état (et de l'extraction effective des données), il vous faut recourir aux points d'ancrage pour définir l'endroit où vous voulez que les objets apparaissent les uns par rapport aux autres. Un point d'ancrage définit la position relative d'un objet par rapport à l'objet auquel il est ancré. Le positionnement est basé sur la taille des objets après extraction des données et non sur leur taille dans l'éditeur. Notez également que la position d'un objet dans l'éditeur de présentation affecte sa position finale dans l'état. Tout décalage physique dans la présentation est répercuté sur la position en pourcentage indiquée dans la feuille de propriété Ancrage.


A propos des objets standard

  Rubriques connexes

Un objet standard est tout texte ou graphique qui apparaît dans un état à chaque exécution. Report Builder crée un objet standard pour chaque libellé sélectionné dans l'assistant Report (il est nommé B_nomcolonne). De même, un objet standard est parfois créé pour chaque récapitulatif d'état. Sauf indication contraire, les objets standard appartiennent à l'objet qui les entoure.


A propos des boutons

  Rubriques connexes

Les boutons sont des objets de présentation sur lesquels l'utilisateur final peut cliquer pour accomplir certaines actions. Par exemple, les boutons permettent d'accéder aux objets multimédias (image, son ou vidéo). Ils peuvent également être utilisés pour exécuter PL/SQL afin d'accomplir des actions telles que le lancement d'un état détail. Report Builder crée automatiquement un objet bouton lorsque vous sélectionnez une colonne qui contient un objet multimédia ou y fait référence.


A propos des affichages Graphics Builder

  Rubriques connexes

Pour inclure un affichage Graphics Builder dans votre état, vous pouvez :

•	incorporer un affichage existant à l'aide de l'outil Graphique

•	créer un nouveau graphique à l'aide de l'assistant Graphique

Un affichage Graphics Builder peut recevoir des données et des paramètres directement de l'état dans lequel il est inclus au lieu de la base de données, ce qui vous permet d'inclure des affichages qui reflètent les données filtrées ou récapitulées d'un état.


A propos de la transmission de données à un affichage Graphics Builder

  Rubriques connexes

Lorsque vous faites référence à un affichage Graphics Builder, vous pouvez avoir besoin de transmettre des données de l'état à l'affichage pour les raisons suivantes :

•	Si l'état filtre les données, ce filtrage pourra être reflété dans l'affichage. Par exemple, si vous utilisez dans votre état un filtre de groupe pour limiter les enregistrements d'un groupe, vous devez transmettre les données de l'état à l'affichage. Sinon, l'affichage extrait les données elles-mêmes et les données qu'il utilise ne reflètent pas le filtre de groupe de l'état.

•	Si l'état contient un total, vous pouvez utiliser celui-ci dans l'affichage. Par exemple, si votre état contient un pourcentage de total que vous voulez utiliser dans votre affichage, vous devez transmettre ce total à l'affichage. Sinon, vous devriez recréer ce même total dans l'affichage d'une façon ou d'une autre.

•	Si les données utilisées dans l'affichage ont déjà été extraites par l'état, vous pouvez éviter que l'affichage extraie ces données à son tour.


A propos des colonnes récapitulatives

  Rubriques connexes

Une colonne récapitulative effectue un calcul sur les données d'une autre colonne. A l'aide de l'assistant Report ou de l'assistant Données, vous pouvez créer les récapitulatifs suivants : somme, moyenne, décompte, % total. Vous pouvez également créer manuellement une colonne récapitulative en vue Modèle de données et utiliser la palette de propriétés pour créer les récapitulatifs supplémentaires suivants : premier, dernier, écart standard, variance.

Remarque : Dans le cas des états de style groupe, l'assistant Report et l'assistant Données créent n champs récapitulatifs dans le modèle de données pour chaque colonne récapitulative que vous définissez : un pour chaque niveau de groupe au-dessus de la colonne récapitulée et un au niveau de l'état. Par exemple, si un état est regroupé par division et ensuite par service, une colonne récapitulative définie comme le total des salaires crée des champs pour la somme des salaires de chaque division et de chaque service (récapitulatifs au niveau du groupe), ainsi que pour la somme de tous les salaires (récapitulatif au niveau de l'état).


A propos des colonnes de base de données

Une colonne de base de données représente une colonne sélectionnée par l'interrogation. Pour chaque colonne que vous sélectionnez dans votre interrogation, Report Builder crée automatiquement une colonne dans le modèle de données de votre état.


A propos des champs

  Rubriques connexes

Un champ est le conteneur de présentation de chacune des colonnes de la présentation. Un champ appartient à l'objet qui l'entoure, généralement un encadrement itératif, sauf s'il s'agit d'un champ récapitulatif (auquel cas il appartient à un encadrement).


A propos des colonnes de type formule

  Rubriques connexes

Une colonne de type formule effectue un calcul défini par l'utilisateur sur les données d'autres colonnes, y compris des colonnes de réserve. Remarque


A propos des groupes

  Rubriques connexes

Les groupes permettent d'organiser les colonnes de votre état. Lorsque vous créez une interrogation, Report Builder crée automatiquement un groupe contenant les colonnes sélectionnées par cette interrogation. Vous créez des groupes supplémentaires afin de produire des niveaux de ventilation dans votre état. Vous pouvez les créer manuellement, ou en utilisant l'assistant Report pour générer un état au-dessus ou à gauche du groupe.


A propos des liens de données

  Rubriques connexes

Les liens de données relient les résultats de plusieurs interrogations. Un lien de données (ou relation père-fils) entraîne une exécution de l'interrogation fille pour chaque instance de son groupe père. Lorsque vous créez un lien de données dans la vue Modèle de données de votre état, Report Builder construit une clause (de la manière indiquée dans la palette de propriétés du lien) qui sera ajoutée au moment de l'exécution à l'instruction SELECT de l'interrogation fille. Vous pouvez visualiser les instructions SELECT des différentes interrogations mères et filles dans Builder, mais vous ne pouvez pas afficher l'instruction SELECT qui contient la clause créée par le lien de données que vous définissez. Remarque


A propos des objets matriciels

  Rubriques connexes

Un objet matriciel définit simplement une relation entre deux encadrements itératifs : elle n'appartient à rien et ne possède rien. Un objet matriciel n'est créé que pour les présentations de style matriciel. Un état peut renfermer plusieurs matrices, à condition que le modèle de données contienne les groupes nécessaires. Report Builder crée un objet matriciel pour chaque paire d'encadrements itératifs entrecroisés et perpendiculaires.


A propos des objets OLE2

  Rubriques connexes

Report Builder est un conteneur OLE2. Vous pouvez inclure des objets OLE2 dans vos états via le modèle de données ou la présentation.


A propos des paramètres

  Rubriques connexes

Un paramètre est une variable dont la valeur peut être définie au moment de l'exécution (par exemple, à partir de la grille de paramètres d'exécution ou de la ligne de commande). Les paramètres utilisateur sont créés par vous-même ou par l'état. Les paramètres système sont créés par Report Builder. Notez que vous pouvez supprimer ou renommer un paramètre utilisateur mais pas un paramètre système.


A propos des références de colonnes et de paramètres

  Rubriques connexes

Vous pouvez faire référence à des paramètres utilisateur, à des paramètres système et à des colonnes sous la forme de références de liaison ou de références lexicales .


A propos des objets standard de la grille de paramètres

  Rubriques connexes

Les objets standard de la grille de paramètres sont des objets texte et/ou graphiques qui apparaissent sur la grille de paramètres d'exécution à chaque exécution de l'état.


A propos des champs de la grille de paramètres

  Rubriques connexes

Les champs de la grille de paramètres sont des conteneurs de présentation pour les paramètres utilisés sur la grille de paramètres d'exécution.


A propos des colonnes de réserve

  Rubriques connexes

Une colonne de réserve est une colonne dont vous fixez le type de données et la valeur dans un programme PL/SQL que vous définissez. Vous pouvez définir la valeur d'une colonne de réserve dans :

•	le déclencheur Before Report, s'il s'agit d'une colonne de niveau état ;

•	une colonne de formule de niveau état, si la colonne de réserve est de niveau état

•	une formule du groupe de la colonne de réserve ou d'un groupe inférieur (si la valeur est définie une fois par enregistrement du groupe)


A propos des extensions HTML de la grille de paramètres

  Rubriques connexes

Les extensions HTML de la grille de paramètres permettent d'améliorer la grille de paramètres Runtime avec du texte comportant des balises HTML et avec du code JavaScript, lorsque les états sont exécutés via le Web. Pour améliorer la grille de paramètres en vue de la création d'états sur le Web, procédez comme suit :

•	Créez du texte standard avec des balises HTML pour ajouter à la grille de paramètres des hyperliens ou tout autre texte comportant des balises HTML.

•	Insérez des champs de paramètres avec du code JavaScript pour définir une entrée ou sélectionner des événements, comme l'affichage d'un message d'erreur lorsque l'utilisateur saisit des données non valides dans un champ de paramètres.

•	Créez un en-tête de grille de paramètres (échappement Avant grille) pour placer un logo ou des liens standard dans l'en-tête de la grille de paramètres HTML.

•	Créez un pied de grille de paramètres (échappement Après grille) pour placer un logo ou des liens standard dans le pied de la grille de paramètres HTML.

Vous pouvez accéder à l'Editeur de grille de paramètres depuis le Navigateur d'objet ou en sélectionnant Outils [image] Générateur de grille de paramètres.


A propos des interrogations

  Rubriques connexes

Une interrogation contient une instruction SQL SELECT qui extrait les données de la base de données pour votre état.


A propos des encadrements

  Rubriques connexes

Les encadrements permettent d'entourer des objets afin de les empêcher d'être écrasés ou déplacés par d'autres objets. Par exemple, vous pouvez utiliser un encadrement pour entourer tous les objets appartenant à un groupe, des en-têtes de colonnes ou des fonctions récapitulatives.

Lorsque vous choisissez la présentation par défaut d'un état, Report Builder crée les encadrements nécessaires autour des objets de l'état, et vous pouvez également créer manuellement un encadrement dans la vue Modèle de présentation.


A propos des encadrements itératifs

  Rubriques connexes

Les encadrements itératifs entourent tous les champs créés pour les colonnes d'un groupe. L'encadrement itératif imprime (se déclenche) une fois pour chaque enregistrement du groupe.

Lorsque vous choisissez la présentation par défaut d'un état, Report Builder crée les encadrements itératifs nécessaires autour des objets de l'état, et vous pouvez également créer manuellement un encadrement itératif dans la vue Modèle de présentation.


A propos des objets d'état

  Rubriques connexes

Les objets d'état sont les blocs qui définissent les différentes parties d'un état. Ils sont répartis en trois catégories fonctionnelles : les objets de modèle de données, les objets de modèle de présentation et les objets de grille de paramètres.

•	Les objets de modèle de données définissent les données à inclure dans un état et regroupent les interrogations, les colonnes, les groupes, les paramètres et les liaisons de données.

•	Les objets de modèle de présentation définissent le positionnement et l'apparence des données et des autres objets d'un état. Ils regroupent les encadrements, les encadrements itératifs, les champs, les objets standard, les points d'ancrage, les boutons, les affichages graphiques et les objets OLE2.

•	Les objets de grille de paramètres définissent l'apparence de la grille de paramètres d'exécution et regroupent les objets standard et les champs de la grille de paramètres d'exécution.


A propos des colonnes de tri

  Rubriques connexes

  (Oracle Express uniquement) Une colonne de tri permet de trier les valeurs de dimensions Express dans un état Express. Pour chaque dimension sélectionnée dans l'interrogation Express, Report Builder insère automatiquement la colonne de tri correspondante dans le modèle de données de l'état. Une colonne de tri contient l'index Express de la valeur de dimension correspondante.

Par exemple, si vous créez une interrogation Express servant à extraire les données des ventes régionales, regroupées par produit et par mois, l'état Express aura l'apparence suivante :

La dimension Time est triée par mois de l'année et non par ordre alphabétique.

Vous pouvez trier les valeurs de dimensions d'un état Express en utilisant l'outil de tri du Sélecteur. Vous pouvez afficher les colonnes de tri à partir de la vue Modèle de données et du Navigateur d'objet. Les colonnes de tri ne sont pas visibles à partir des assistants Données et Etat, ni à partir de la vue Modèle de présentation ou de la vue Aperçu interactif.


A propos de l'Editeur d'état

  Rubriques connexes

L'Editeur d'état est une zone de travail dans laquelle vous pouvez manipuler les objets de votre état directement ou en modifiant les paramètres de leur feuille de propriétés. Dans la fenêtre de l'Editeur d'état, vous pouvez naviguer parmi quatre vues différentes de votre état : la vue Modèle de données, la vue Modèle de présentation, la vue Grille de paramètres et la vue Aperçu interactif.


A propos de la vue Modèle de données

  Rubriques connexes

La vue Modèle de données de l'Editeur d'état vous permet de définir et de modifier les objets de modèle de données d'un état. Dans cette vue, les objets et leurs paramètres de propriétés sont représentés symboliquement pour mettre en évidence leur type et leurs relations. Pour créer les objets d'interrogation de votre modèle de données, vous pouvez utiliser l'assistant Report, l'assistant Données ou les outils d'interrogation de la palette d'outils.


A propos de la vue Modèle de présentation

  Rubriques connexes

La vue Modèle de présentation de l'Editeur d'état vous permet de définir et de modifier les objets de modèle de présentation d'un état. Dans cette vue, les objets et leurs paramètres de propriétés sont représentés symboliquement pour mettre en évidence leur type et leurs relations.


A propos de la vue Grille de paramètres

  Rubriques connexes

La vue Grille de paramètres de l'Editeur d'état vous permet de créer une grille de paramètres d'exécution pour votre état. Vous pouvez sélectionner pour votre grille des paramètres système prédéfinis à l'aide du Générateur de grilles de paramètres ou créer les vôtres.


A propos de l'Aperçu interactif

  Rubriques connexes

La vue Aperçu interactif de l'Editeur d'état vous permet de prévisualiser et d'examiner un aperçu de votre état, page par page. Vous pouvez également travailler directement sur l'état pour personnaliser et affiner son apparence.


A propos de l'Aperçu Runtime

  Rubriques connexes

Dans l'Aperçu Runtime, vous pouvez faire défiler une page donnée de l'état, parcourir la totalité de l'état ou diviser l'écran pour afficher simultanément plusieurs parties du même état.

Une page physique (ou panneau) a la même taille que la page qui sortira de votre imprimante. Une page logique a la même taille qu'une page de votre état en tant que tel (il peut courir horizontalement ou verticalement sur un nombre quelconque de pages physiques). L'Aperçu Runtime affiche les pages logiques de votre état une par une.

A l'aide de l'Aperçu Runtime, vous pouvez :

•	Hiérarchiser vers le bas vers des états détaillés : Un état peut contenir des boutons auxquels sont associées des actions PL/SQL. Par exemple, vous pouvez utiliser la procédure en package SRW.RUN_REPORT pour définir une action pour un bouton qui appelle un autre état. Ce deuxième état (ou état détail) apparaît dans son propre Aperçu Runtime modal. Le nombre de niveaux de cette hiérarchisation n'est pas limité.

•	Accéder à des objets multimédias : Un état peut contenir des boutons associés à des objets multimédias (par exemple, vidéo ou son), que vous pouvez appeler en cliquant sur ces boutons dans l'Aperçu Runtime.

•	Ouvrir des applications compatibles OLE2 : Si votre état contient des objets OLE2, vous pouvez cliquer deux fois sur ces objets dans l'Aperçu Runtime pour ouvrir l'application serveur associée. (Notez que s'il s'agit d'un objet lié, son objet source s'affiche.)


A propos des modèles

  Rubriques connexes

Les modèles définissent les caractéristiques et objets communs que vous voulez appliquer à plusieurs états. Par exemple, vous pouvez définir un modèle qui contient le logo de la société et établit les polices et les couleurs de certaines zones de l'état.

Lorsque vous créez un état à l'aide de l'assistant Report, vous avez la possibilité d'appliquer à cet état un modèle (fichier .tdf). Lorsque vous choisissez un modèle, les objets de la marge de ce modèle sont importés au même endroit dans la section en cours de l'état, ce qui écrase les objets existants. Les caractéristiques (mise en forme, polices, couleurs, etc.) des objets du corps du modèle sont appliquées aux objets du corps de la section en cours de l'état. Les propriétés, paramètres, déclencheurs d'état, unités de programme et bibliothèques attachées que vous avez définis dans ce modèle sont également appliqués. Vous pouvez appliquer différents modèles à chaque section de l'état.

Si vous appliquez ultérieurement un autre modèle à un état, les objets du modèle existant seront supprimés dans la section en cours de l'état.


A propos de l'Editeur de modèle

  Rubriques connexes

L'Editeur de modèle est une zone de travail dans laquelle vous pouvez définir les objets et les propriétés de mise en forme de vos modèles. Il est comparable à la vue Modèle de présentation de l'Editeur d'état. Vous pouvez créer, supprimer et modifier des objets (tels que numéros de page, texte et graphiques) dans la marge. Vous ne pouvez ni créer ni supprimer des objets dans le corps, mais vous pouvez modifier les propriétés des objets du corps dans la palette de propriétés (Outils [image] Palette de propriétés).

La liste déroulante Style d'état vous permet de visualiser la présentation d'un style d'état sélectionné. Pour définir les valeurs par défaut pour tous les styles d'état, vous pouvez sélectionner Par défaut dans la liste déroulante Style d'état. Pour apporter des modifications à un style d'état en particulier, il vous suffit de sélectionner celui-ci dans la liste déroulante Style d'état et d'indiquer des paramètres remplaçant les valeurs par défaut.


A propos des attributs de modèle

  Rubriques connexes

Dans le corps de présentation d'un modèle, vous pouvez définir les attributs par défaut et de remplacement dans les noeuds suivants du Navigateur d'objet :

Encadrements, qui contient les noeuds suivants :

•	un noeud Encadrement de section, qui définit les attributs de l'encadrement parent entourant la section actuellement sélectionnée.

•	un noeud Encadrement d'en-têtes, qui définit les attributs de l'encadrement parent entourant les en-têtes de colonne.

•	un noeud Encadrement de champs, qui définit les attributs de l'encadrement parent entourant les champs.

•	un noeud Encadrement de récapitulatifs, qui définit les attributs de l'encadrement parent entourant les récapitulatifs (totaux).

•	Libellés/En-têtes de champs, qui contient les noeuds suivants :

•	un noeud Caractère, qui définit les attributs des libellés ou des en-têtes de colonne des champs caractère.

•	un noeud Numérique, qui définit les attributs des libellés ou des en-têtes de colonne des champs numériques.

•	un noeud Date, qui définit les attributs des libellés ou des en-têtes de colonne des champs date.

•	Champs, qui contient les noeuds suivants :

•	un noeud Caractère, qui définit les attributs des champs caractère.

•	un noeud Numérique, qui définit les attributs des champs numériques.

•	un noeud Date, qui définit les attributs des champs date.

•	Libellés de récapitulatif, qui contient les noeuds suivants :

•	un noeud Caractère, qui définit les attributs des libellés de récapitulatif des champs caractère.

•	un noeud Numérique, qui définit les attributs des libellés de récapitulatif des champs numériques.

•	un noeud Date, qui définit les attributs des libellés de récapitulatif des champs date.

•	Récapitulatifs, qui contient les noeuds suivants :

•	a un noeud Caractère, qui définit les attributs des récapitulatifs des champs caractère.

•	un noeud Numérique, qui définit les attributs des récapitulatifs des champs numériques.

•	un noeud Date, qui définit les attributs des récapitulatifs des champs date.

Attributs par défaut

Le noeud par défaut du Navigateur d'objet définit les attributs visuels (mise en forme, polices, couleurs, etc.) pour tous les styles d'état. Si vous voulez définir des attributs pour certains styles d'état en particulier, faites-le dans le noeud de remplacement. Lorsque vous appliquez un modèle à un état, tous les attributs par défaut s'appliquent à cet état, exceptés ceux qui se trouve dans le noeud Remplacement.

Attributs de remplacement

Dans le noeud Remplacement du Navigateur d'objet, vous pouvez définir des attributs pour certains styles d'état en particulier. Chaque style d'état contient une ou plusieurs sections correspondant aux groupes de l'état.

Styles d'état monosections

Styles d'état multisections

Pour les styles d'état qui prennent en charge plusieurs groupes, vous pouvez créer des sections supplémentaires en fonction de vos besoins. La correspondance entre les sections et les groupes s'établit comme suit :

•	Autant de groupes que de sections : correspondance un à un (la première section est associée au premier groupe, la deuxième section au deuxième groupe, etc.).

•	Plus de groupes que de sections : correspondance un à un jusqu'à l'avant-dernière section. Ensuite, tous les groupes suivants sont associés à l'avant-dernière section et le dernier groupe à la dernière section. S'il n'existe qu'une seule section, tous les groupes lui sont associés.

•	Plus de sections que de groupes : correspondance un à un jusqu'à l'avant-dernier groupe. Ensuite, le dernier groupe est associé à la dernière section.


A propos de l'héritage dans les modèles

  Rubriques connexes

Dans les modèles, les propriétés d'encadrements, de champs, de libellés, d'en-têtes et de récapitulatifs peuvent toutes hériter de leurs valeurs.

Propriétés par défaut

Les propriétés par défaut héritent des valeurs prédéfinies par Report Builder. Lorsqu'une propriété est définie à sa valeur Report Builder par défaut, l'icône correspondante dans la palette de propriétés est un petit cercle. Les propriétés par défaut sont localisées lorsque vous modifiez leur valeur ou que vous les sélectionnez et cliquez sur [image] (bouton Localiser) dans la barre d'outils. Lorsqu'une propriété est localisée, l'icône correspondant prend la forme d'un carré. Pour restaurer les propriétés à leur valeur héritée, sélectionnez ces propriétés et cliquez sur [image] (bouton Hériter) dans la barre d'outils.

Propriétés de remplacement

Les propriétés des sections de remplacement héritent leur valeur des propriétés par défaut. Lorsqu'une propriété hérite d'une propriété par défaut, l'icône correspondante dans la palette de propriétés est une flèche. Les propriétés des sections de remplacement sont localisées lorsque vous modifiez leur valeur ou que vous les sélectionnez et cliquez sur [image] (bouton Localiser) dans la barre d'outils. Lorsqu'une propriété est localisée, l'icône correspondante prend la forme d'une flèche barrée d'une croix rouge. Pour restaurer les propriétés des sections de remplacement à leur valeur héritée, sélectionnez ces propriétés et cliquez sur [image] (bouton Hériter) dans la barre d'outils.


A propos de SQL*Net

SQL*Net vous permet d'accéder rapidement et efficacement à des sources de données situées sur des ordinateurs à distance. Il connecte le " client " (par exemple, Report Builder) au " serveur " (par exemple, ORACLE) et vous permet plusieurs connexions simultanées. Net8 remplace SQL*NET dans les versions 6.0 et ultérieures.


A propos de Net8

Il s'agit du logiciel Oracle d'accès aux données distantes. Il permet les communications client-serveur et serveur-serveur sur tout type de réseau. Net8 prend en charge le traitement distribué et les fonctionnalités de base de données distribuée. Il accepte et permet de relier plusieurs protocoles de communication. Net8 permet la compatibilité descendante avec SQL*NET.


A propos des rôles de base de données

  Rubriques connexes

Les rôles de base de données permettent à l'utilisateur final d'exécuter des états qui lancent des interrogations sur des tables auxquelles il n'a pas les droits d'accès nécessaires. Par exemple, un état peut lancer une interrogation sur une table contenant des informations sensibles telles que des données salariales, même si l'état final n'affiche pas ces données.

Les rôles de base de données ne sont vérifiés qu'en environnement d'exécution. Si une table requiert des droits d'accès particuliers, l'utilisateur final qui ne possède pas ces droits ne peut pas exécuter un état qui extrait des données de cette table. Cependant, si un rôle de base de données est défini pour cet état, l'utilisateur final possédant les droits de ce rôle peut exécuter l'état à l'aide de Reports Runtime (RWRUN60). Lors de l'exécution de plusieurs états, Reports Runtime bascule automatiquement sur le rôle défini pour l'état en cours.

Si vous essayez d'ouvrir un état dans Report Builder pour lequel un rôle de base de données a été défini, vous serez invité à entrer le mot de passe de rôle. Normalement, seuls le concepteur de l'état et l'administrateur de bases de données détiennent cette information.


Pour exécuter un état pour lequel un rôle de base de données est défini, l'utilisateur doit exécuter le fichier .rdf et non le fichier .rep.


A propos des bibliothèques PL/SQL externes

  Rubriques connexes

Les bibliothèques PL/SQL externes sont des ensembles de procédures, fonctions et packages PL/SQL indépendants d'une définition d'état. En attachant une bibliothèque externe à un état, vous pouvez faire référence à son contenu autant de fois que vous le souhaitez. Par exemple, vous pouvez faire référence à une procédure dans une bibliothèque attachée à partir d'un déclencheur Before Report comme d'un déclencheur de mise en forme, ce qui élimine la nécessité d'avoir à entrer à nouveau le même programme PL/SQL pour chaque application.


A propos des bibliothèques attachées

  Restrictions 	  Rubriques connexes

Les bibliothèques attachées sont des bibliothèques PL/SQL externes que vous avez associées à un état ou à une autre bibliothèque externe. Lorsqu'une bibliothèque externe est attachée, vous pouvez faire référence à ses packages, à ses fonctions et à ses procédures à partir de votre état. Par exemple, si vous avez attaché à votre état une bibliothèque externe appelée MABIB et qu'elle contenait une fonction du nom de AJOUTXY, vous pouvez alors faire référence à AJOUTXY à partir de tout programme PL/SQL de l'état.


Bibliothèques attachées - Restrictions

•	Si Report Builder ne trouve pas une bibliothèque que vous avez indiquée dans la liste des bibliothèques attachées, un avertissement apparaît lorsque vous validez la boîte de dialogue, enregistrez l'état ou ouvrez l'état. Si vous tentez d'exécuter l'état ou d'y compiler le programme PL/SQL, une erreur se produit.

•	La liste des bibliothèques attachées est enregistrée. La prochaine fois que vous ouvrirez l'état ou la bibliothèque, la liste aura le même contenu que lors du dernier enregistrement de l'état.

•	Si une bibliothèque externe fait référence à une autre bibliothèque, vous devez attacher les deux bibliothèques à l'état, même si la deuxième bibliothèque est attachée à la première.


A propos des valeurs de présentation par défaut

  Rubriques connexes

Report Builder définit une présentation d'état par défaut en fonction des règles suivantes :

1	Sauf indication contraire, un groupe horizontal prend les mêmes valeurs par défaut qu'un groupe vertical, sinon que la mise en forme par défaut est transposée. Pour déterminer rapidement la présentation par défaut d'un groupe horizontal, procédez comme suit :

•	Dessinez la présentation verticale du groupe sur du papier translucide.

•	Retournez la feuille comme si vous tourniez une page d'un livre.

•	Faites pivoter la page de 90 degrés dans le sens contraire des aiguilles d'une montre.

2	Dans les états de style lettre type, tous les champs par défaut sont masqués, leur Elasticité horizontale est définie sur Variable et leur Elasticité verticale sur Fixe. Dans tous les autres états, l'Elasticité horizontale et l'Elasticité verticale de tous les champs par défaut sont définies sur Fixe.

Exception : Pour les états tabulaires, de type formulaire, groupe - gauche ou groupe - niveau supérieur et matriciel, les champs CHAR (si vous réduisez la largeur par défaut) et LONG ont par défaut une Elasticité horizontale Fixe et une Elasticité verticale Variable. Par conséquent, toutes les valeurs du champ seront affichées et non tronquées, par passage des données à la ligne suivante.

Attention : Pour les états de style lettre type ou étiquette de publipostage, les champs CHAR (si vous réduisez la largeur par défaut) et LONG ont par défaut une Elasticité horizontale et une Elasticité verticale Fixes. Par conséquent, la valeur du champ sera tronquée si la taille des données est supérieure à celle du champ.

3	Si un ou plusieurs champs sélectionnés ont une Elasticité horizontale ou une Elasticité verticale Variable, Report Builder procède comme suit pour les états verticaux :

•	création d'un encadrement nommé M_nomgroupe_EXP dont la largeur est égale à la largeur de l'encadrement itératif propriétaire du champ de taille variable, et la longueur égale à un champ.

•	positionnement de l'encadrement autour de ce champ de taille variable et de tous les autres champs qui se trouvent à sa droite ou à sa gauche. Ainsi, tous les champs à droite et à gauche du champ Variable commencent à s'imprimer " sur la même ligne ", même si le champ Variable s'étend sur plusieurs lignes.

4	Pour les états horizontaux, adaptez la règle ci-dessus en conséquence.

5	Les résumés appartenant à l'état et non à un groupe sont autorisés dans tous les styles de présentation d'état. Ils sont tous mis en forme de la façon suivante :

•	Si le style de présentation est de type formulaire, lettre type ou étiquette de publipostage, le résumé est une colonne d'état. Une colonne d'état est mise en forme comme toutes les autres colonnes de base de données de ce style d'état.

•	Si le style de présentation est tabulaire, groupe - gauche ou groupe - niveau supérieur, ou matriciel, et que la colonne sur laquelle porte le résumé n'est pas sélectionnée, le résumé est une colonne d'état. (Celle-ci est mise en forme comme indiqué dans le point ci-dessus.) Sinon, le résumé est un résumé d'état. Il est justifié à gauche à la fin de l'état, avec le libellé à gauche du champ (si la place le permet).

6	Si le style de présentation est tabulaire, groupe - gauche ou groupe - niveau supérieur, ou matriciel, un résumé prend les mêmes valeurs par défaut qu'une colonne de base de données si la colonne qu'il résume n'est pas sélectionnée. Sinon, un résumé prend les valeurs par défaut des résumés (c'est-à-dire qu'il apparaît à l'intérieur des encadrements M_nomgroupe_FTR).

7	Si le style de présentation est tabulaire, groupe - gauche ou groupe - niveau supérieur, ou matriciel, Report Builder place un type de résumé par ligne, dans l'ordre suivant :

•	SUM

•	AVERAGE

•	MINIMUM

•	MAXIMUM

•	COUNT

•	FIRST

•	LAST

•	% OF TOTAL

•	STANDARD DEVIATION

•	VARIANCE

8	Si le style de présentation est tabulaire, groupe - gauche ou groupe - niveau supérieur, ou matriciel, le libellé du résumé apparaît à l'extrême gauche de l'encadrement de pied de page du groupe (M_nomgroupe_FTR). Si la place est insuffisante, le libellé est tronqué.


Algorithme d'ancrage implicite

  Rubriques connexes

Report Builder crée des points d'ancrage implicites au moment de l'exécution dans la zone de corps. L'algorithme de la marge est légèrement différent.

Algorithme de corps

Algorithme de marge


Algorithme de corps

  Rubriques connexes

1	Déterminez quels sont les objets qui ne sont pas entièrement inclus dans un encadrement ou un encadrement itératif (directement ou indirectement) ni explicitement ancrés à un objet inclus dans un encadrement ou un encadrement itératif (directement ou indirectement). Nous appellerons ces objets des objets de type A. (Les objets de type A sont généralement des encadrements de groupe, des encadrements itératifs, d'autres objets que vous créez et qui n'appartiennent pas à un encadrement ni à un encadrement itératif, etc.) Un objet n'est considéré comme inclus dans un autre objet que si toutes les conditions ci-après sont réunies :

•	Les deux objets appartiennent à la même zone (corps ou marge).

•	L'objet le plus extérieur des deux est un encadrement ou un encadrement itératif.

•	L'objet le plus extérieur des deux se trouve derrière l'autre objet.

•	L'objet le plus intérieur des deux se trouve entièrement à l'intérieur des limites de l'autre objet.

2	Déterminez tous les objets fils d'un encadrement ou d'un encadrement itératif (c'est-à-dire les objets qui ne sont pas de type A). Nous appellerons ces objets des objets de type B.

3	Suivez la procédure ci-après indépendamment pour les objets de type A et de type B :

•	Recherchez tous les objets de même type (par exemple de type A) et qui se trouvent sur la même couche.

•	Déterminez lesquels de ces objets ont la capacité de " pousser " d'autres objets de ce type. Un objet a la capacité de " pousser " un objet de ce type si son paramètre Elasticité horizontale et/ou Elasticité verticale a pour valeur Variable ou Développer, et qu'un deuxième objet se trouve sur son " chemin de développement " (c'est-à-dire la zone sur laquelle il est susceptible de se développer). De même, un encadrement itératif dont le paramètre Elasticité horizontale et/ou Elasticité verticale a pour valeur Fixe ou Contracter possède un " chemin de développement " : son orientation d'impression.

•	Créez des paires d'objets. Chaque paire doit contenir un pousseur (l'objet qui va se développer) et un poussé (l'objet qui sera poussé). Lors de la création de ces paires, un objet poussé ne peut pas être un objet fils ou un point d'ancrage explicite : ces objets sont ignorés.

•	Effectuez la boucle suivante. Pour chaque paire, déterminez la distance dans le " chemin de développement " entre le pousseur et le poussé. Ensuite, recherchez la paire dont la distance est la plus courte. Enfin, créez un point d'ancrage implicite entre ces objets à l'aide de l'algorithme suivant :

•	Si l'orientation du " chemin de développement " est Verticale, ancrez la partie supérieure de l'objet poussé 0% sur la partie inférieure de l'objet pousseur 0%.

•	Si l'orientation du " chemin de développement " est Horizontale, ancrez la partie gauche de l'objet poussé 0% sur la partie droite de l'objet pousseur 0%.

•	Cette paire est désormais traitée comme un seul objet et la boucle se poursuit jusqu'à ce que tous les objets soient ancrés ou que rien ne puisse pousser les objets restants et non ancrés.

•	Pour chacun des objets restants non ancrés, créez un point d'ancrage implicite entre le coin supérieur gauche de l'objet et le coin supérieur gauche de la zone de corps.

•	Passez à la couche suivante et reprenez la procédure à l'étape 1.

Règles :

1	Si un objet se trouve dans le " chemin de développement " de deux autres objets et à égale distance de ceux-ci, l'ancrage implicite de cet objet peut varier selon l'exécution de l'état. Par exemple, le schéma ci-dessous présente deux cas de figure :

  Cliquez ici

Dans le premier cas, M_Sums se trouve dans le " chemin de développement " de B_Text1 et de R_Ename. Cependant, M_Sums se trouvant à égale distance de B_Text1 et de R_Ename, les critères normaux (distance la plus courte) pour déterminer les points d'ancrage implicites ne peuvent s'appliquer. Par conséquent, au moment de l'exécution, l'algorithme de formatage crée de façon aléatoire un point d'ancrage implicite entre M_Sums et B_Text1 ou R_Ename. Pour éviter cette situation, vous pouvez créer un point d'ancrage explicite entre M_Sums et B_Text1 ou R_Ename.

Dans le second cas, B_Text3 se trouve dans le " chemin de développement " de M_Emp. Puisque les bords inférieurs de M_Emp et de R_Mgr sont approximativement dans la même position, B_Text3 peut être ancré de manière implicite à M_Emp ou à R_Mgr. Par conséquent, au moment de l'exécution, l'algorithme de formatage crée de façon aléatoire un point d'ancrage implicite entre B_Text3 et M_Emp ou R_Mgr. Pour éviter cette situation, vous pouvez créer un point d'ancrage explicite entre B_Text3 et un des objets ou supprimer le point d'ancrage explicite entre R_Ename et B_Text2. La suppression du point d'ancrage explicite obligera R_Mgr à être traité comme un descendant de M_Emp et, par conséquent, le point d'ancrage implicite sera toujours créé entre B_Text3 et M_Emp.

(Notez que le cas 2 est davantage susceptible de se présenter en mode caractère, où il est courant que les bords des objets se chevauchent dans l'Editeur de présentation.)


Algorithme de marge

  Rubriques connexes

Report Builder crée des points d'ancrage implicites pour tous les objets de type B dans la zone de marge à l'aide de l'algorithme de corps. Cependant, pour chaque objet de type A, Report Builder crée un point d'ancrage implicite entre le coin supérieur gauche de l'objet et le coin supérieur gauche de la marge. Aucun objet de type A n'est implicitement ancré à un autre objet de type A. (Ainsi, les objets de type A ne seront pas poussés en-dehors de la page. Cependant, ils peuvent être recouverts par un autre objet de type A s'ils se trouvent sur la même couche.)


Algorithme de condition d'impression

  Rubriques connexes

Report Builder définit la propriété Activation de l'impression d'objet au moment de l'exécution.

1	Si vous avez défini la propriété Activation de l'impression d'objet, Report Builder utilise cette valeur.

2	Si vous avez indiqué la valeur Par défaut pour cette propriété, Report Builder donne à cette propriété la valeur Première page ou Dernière page. Si l'objet est le fils d'un point d'ancrage implicite ou explicite et que la propriété Activation de l'impression d'objet de son père a pour valeur Tout, Tout sauf première page ou Tout sauf dernière page, Report Builder lui donne la valeur Première page et donne à la propriété Activation de l'impression d'objet la valeur Objet englobant. Si l'objet est le fils d'un point d'ancrage implicite ou explicite et que la propriété Activation de l'impression d'objet de son père a une autre valeur, Report Builder lui donne la valeur Dernière page. Sinon, en ce qui concerne les objets implicitement ancrés à la zone de corps, Report Builder lui donne la valeur Première page.


A propos des états en mode batch

  Rubriques connexes

Si vous n'avez pas à consulter de sortie d'état dans le visualiseur (par exemple, si vous devez générer d'important volumes de sortie d'un état entièrement vérifié ou encore exécuter plusieurs états successivement), vous pouvez exécuter votre état en mode batch. Cela vous permet de vous consacrer à d'autres tâches pendant l'exécution de vos états.

Vous pouvez exécuter des états en mode batch depuis la ligne de commande ou utiliser un fichier de commande pour indiquer des arguments. Un fichier de commande peut vous épargner beaucoup de temps de frappe si vous souhaitez exécuter plusieurs états à l'aide des mêmes arguments.


A propos de l'application des modèles

  Rubriques connexes

Lorsque vous appliquez un modèle à un état, tous les objets, propriétés et attributs suivants du modèle sont appliqués à la section en cours de l'état :

•	paramètres et leurs déclencheurs de validation

•	taille de la page physique

•	taille de la page logique

•	mode caractère ou bitmap

•	position de la marge

•	ordre d'impression des panneaux

•	nombre maximum de pages horizontales

•	nombre maximum de pages verticales

De plus, tous les objets de présentation de la marge du modèle sont copiés au même endroit dans la section en cours de l'état.

Remarque : Par défaut, le modèle est appliqué à la section en cours de l'état (section affichée dans la vue Modèle de présentation). Si aucune section n'est affichée, le modèle est appliqué, par défaut, à la section principale de l'état. Si vous sélectionnez le noeud correspondant à l'ensemble de l'état dans le Navigateur d'objet, le modèle est appliqué, par défaut, à la section principale de l'état. Pour l'appliquer à une section précise de votre état, sélectionnez le noeud correspondant à cette section dans le Navigateur d'objet.


A propos des feuilles de style

  Restrictions	  Rubriques connexes

Les feuilles de style (ou feuilles de style en cascade) font référence à des extensions HTML qui fournissent une grande souplesse de formatage. Grâce aux feuilles de style, vos documents HTML peuvent comprendre les éléments suivants :

•	toute taille ou tout style de police

•	le chevauchement d'objets

•	des traits horizontaux et verticaux ainsi que des rectangles de toute couleur et largeur

•	le positionnement précis d'objets sur une page

•	la numérotation des pages

•	l'impression depuis un navigateur Web

•	des tables de correspondances d'images en ligne

Cela signifie que le formatage évolué dans un état est conservé lorsque vous formatez cet état sous forme de document HTML. Sans les extensions de feuille de style, vos documents HTML n'affichent que les formats texte de base et les images importées. Avec les feuilles de style, des images de type highly formatted text peuvent être remplacées par des objets texte de style, de couleur et de police équivalents. Les objets texte peuvent être positionnés de façon à recouvrir des objets image. Tout le texte peut être consulté, et moins d'images doivent être transférées.

Pour visualiser un document HTML faisant appel aux feuilles de style, vous devez l'afficher dans un explorateur qui prend en charge les feuilles de style. (Microsoft Internet Explorer 3.01, par exemple).


Feuilles de style - Restrictions

Les éléments suivants ne sont pas pris en charge par les extensions de feuille de style HTML :

•	ellipses, arcs, polygones/polylignes et diagonales

•	rectangles arrondis (formatés comme rectangles)

•	flèches sur lignes

•	tirets sur lignes ou bordures d'objet


A propos du transfert de plateau d'imprimante

  Restrictions 	  Rubriques connexes

Les déclencheurs Before Report, Between Pages et de format permettent le transfert de plateau d'imprimante selon les formats de votre état. Vous pouvez ainsi imprimer des pages du même état sur différentes feuilles de papier (par exemple, en-tête de lettre, formulaires, couleur).

Vous pouvez déterminer le nom des plateaux définis pour votre imprimante dans la boîte de dialogue Mise en page, puis utiliser SRW.SET_PRINTER_TRAY pour définir le plateau d'imprimante comme vous le souhaitez.


Restrictions liées au bac d'imprimante

•	Le bac d'imprimante choisi à l'origine est ignoré lorsque vous imprimez des états sur une imprimante PCL sous Motif. L'état est traité à l'aide des paramètres par défaut.


A propos des interrogations de curseur de référence

  Rubriques connexes

Une interrogation de curseur de référence utilise PL/SQL pour extraire des données. Chaque interrogation de curseur de référence est associée à une fonction PL/SQL qui retourne un type de curseur de référence. La fonction doit s'assurer que le curseur de référence est ouvert et associé à une instruction SELECT ayant une liste SELECT qui correspond au type du curseur de référence.

Vous fondez une interrogation sur un curseur de référence lorsque vous voulez :

•	gérer plus facilement SQL

•	éviter d'utiliser des paramètres lexicaux dans vos états

•	partager des sources de données avec d'autres applications, telles que Form Builder

•	augmenter le contrôle et la sécurité

•	intégrer une logique à un sous-programme

De plus, si vous utilisez une unité de programme stockée pour mettre en oeuvre des curseurs de référence, vous bénéficiez des avantages supplémentaires associés au stockage de vos unités de programme dans la base de données Oracle.

Pour plus d'informations sur les curseurs de référence et sur les sous-programmes stockées, reportez-vous à PL/SQL User's Guide and Reference.


A propos des variables de curseur

Comme un curseur, une variable de curseur pointe vers un ensemble de résultats à partir d'une interrogation multiligne. Cependant, les curseurs diffèrent des variables de curseur, comme une contante diffère d'une variable. Alors qu'un curseur est statique, une variable de curseur est dynamique, car elle n'est pas liée à une interrogation particulière. Vous pouvez ouvrir une variable de curseur pour toute interrogation compatible, ce qui vous donne plus de souplesse.


A propos des unités de programme stockées

  Rubriques connexes

Les unités de programmes stockées (également appelées sous-programmes stockés) peuvent être compilées séparément et stockées en permanence dans une base de données Oracle, prêtes à être exécutées. Une fois compilées et stockées dans le dictionnaire de données, ces unités sont des objets schéma pouvant être référencées par toute application connectée à cette base de données.

Les unités de programme stockées offrent une plus grande productivité, de meilleures performances, des économies de mémoire, l'intégrité d'application et une meilleure sécurité. Par exemple, en développant des applications à partir d'une bibliothèque de procédures et de fonctions stockées, vous pouvez éviter le codage redondant et augmenter ainsi votre productivité.

Les unités de programme stockées sont stockées sous forme compilée et analysée. Lorsqu'elles sont appelées, ces unités sont chargées et transmises immédiatement au moteur PL/SQL. Elles tirent également profit de la mémoire partagée. Ainsi, le chargement en mémoire d'une seule copie d'une unité de programme permet à plusieurs utilisateurs d'en effectuer l'exécution.


A propos des sorties RTF

  Rubriques connexes

Report Builder prend en charge le format RTF (Rich Text Format) pour les sorties d'état. Il s'agit d'un format de codage de texte pouvant être lu par un grand nombre de logiciels de traitement de texte, tels que Microsoft Word. Vous pouvez utiliser les fonctions d'édition et de graphisme du logiciel pour modifier et améliorer vos sorties d'état. Lorsque vous générez une sortie d'état dans un fichier RTF, vous pouvez également envoyer votre état par courrier électronique à l'aide d'utilitaires conformes aux normes MAPI.

Notes d'utilisation

•	Le graphisme et le texte peuvent se chevaucher.

•	Le texte peut faire l'objet d'une rotation de 90 degrés.

•	Comme pour une sortie PDF, la couleur d'arrière-plan de l'objet est utilisée comme couleur de remplissage (indifféremment du motif indiqué).

Remarque : Une fois votre état envoyé à un fichier RTF, vous pouvez l'importer depuis le même fichier. Egalement, lorsque vous affichez l'état dans Microsoft Word de Office 95, vous devez choisir Affichage [image] Page pour voir tous les graphiques et les objets dans votre état.


A propos du formatage conditionnel

  Rubriques connexes

Les boîtes de dialogue de formatage conditionnel et d'exception de formatage vous permettent d'indiquer les attributs du formatage de sortie (police et/ou couleur) pour un objet de présentation sélectionné, selon des conditions existantes. Les conditions que vous définissez sont appelées exceptions de formatage.

Vous pouvez afficher la boîte de dialogue de formatage conditionnel à partir de la vue Aperçu interactif ou de la vue Modèle de présentation de l'une des façons suivantes :

•	Cliquez deux fois sur l'objet à afficher dans la Palette de propriétés. Sous le noeud Présentation générale, cliquez sur le champ de valeur Formatage conditionnel (intitulé…).

•	Affichez le menu instantané pour l'objet (cliquez sur le bouton droit sous Windows).

•	Cliquez sur l'objet, puis choisissez Format [image] Formatage conditionnel.

Une fois les conditions et le formatage indiqués pour l'objet de présentation en cours dans la boîte de dialogue d'exception de formatage, la définition est exportée vers un déclencheur de format PL/SQL. Si un déclencheur de format existe déjà pour l'objet de présentation, la définition dans cette boîte de dialogue remplace le code de déclencheur existant lorsque vous confirmez l'invite de Report Builder.

Vous pouvez éditer manuellement le déclencheur de format via l'Editeur PL/SQL ; cependant, si vous modifiez ultérieurement la définition à l'aide de la boîte de dialogue d'exception de formatage, Report Builder affiche une invite pour remplacer le déclencheur de format existant.


A propos de l'aperçu Web

  Rubriques connexes

Dans votre navigateur Web, vous pouvez obtenir un aperçu de votre état dans l'un des formats suivants :

•	HTML

•	HTML, avec extensions de feuille de styles

•	PDF

Lorsque vous choisissez Affichage [image] Aperçu Web [image] Générer dans le navigateur Web, Report Builder génère par défaut votre état dans un fichier HTML temporaire, à moins que vous n'ayez choisi de le générer dans un fichier de feuille de styles PDF ou HTML. Lorsque vous affichez le fichier temporaire dans votre navigateur Web, vous pouvez enregistrer votre sortie d'état sous forme de fichier HTML ou PDF.

Si vous disposez de plusieurs navigateurs Web sur votre ordinateur, Report Builder vous demande de choisir le navigateur à utiliser lorsque vous sélectionnez pour la première fois Affichage [image] Aperçu Web [image] Générer dans le navigateur Web.

Vous pouvez afficher toutes les pages de votre sortie d'état ou uniquement la page en cours. Report Builder affiche par défaut la page en cours de votre état.


A propos des titres d'état

  Rubriques connexes

Vous pouvez ajouter un titre à votre état de l'une des façons suivantes :

•	manuellement, en créant un objet texte standard dans la marge de la vue Modèle de présentation ;

•	en tapant le titre dans le champ Titre de la page de style de l'assistant Report.

Si vous utilisez l'assistant Report pour ajouter un titre et que vous ne sélectionniez pas de modèle pour votre sortie d'état, le titre est inséré dans la marge de l'état avec les attributs par défaut définis par Report Builder. Vous pouvez modifier ces attributs dans la vue Modèle de présentation.

Si vous utilisez l'assistant Report pour ajouter un titre et que vous sélectionniez un modèle prédéfini ou un fichier de modèle défini par l'utilisateur pour votre sortie d'état, Report Builder recherche l'objet texte standard B_OR$REPORT_TITLE défini pour le modèle sélectionné :

•	Si B_OR$REPORT_TITLE existe, le titre est affiché en utilisant les attributs de cet objet, avec le texte que vous avez saisi dans l'assistant Report.

•	Si B_OR$REPORT_TITLE n'est pas retrouvé, le titre est affiché en utilisant les attributs définis par les propriétés Par défaut (sous le noeud Titre dans la Palette de propriétés) du modèle sélectionné.

Remarque : Si vous n'indiquez pas de titre dans l'assistant Report, l'objet B_OR$REPORT_TTILE n'est pas copié dans votre état.

Pour les présentations créées à l'aide de l'outil de présentation par défaut supplémentaire, le titre est inséré dans la nouvelle présentation sous forme de titre de groupe, plutôt que dans la marge de l'état. Dans ce cas, les attributs sont définis en fonction des propriétés Par défaut (sous le noeud Titre dans la Palette de propriétés) du modèle sélectionné, et B_OR$REPORT_TITLE n'est pas pris en compte. Si vous ne sélectionnez pas de modèle, le titre fait appel aux attributs par défaut définis par Report Builder.


A propos des interrogations ne pouvant pas être liées

  Rubriques connexes

Il s’agit d’interrogations détaillées contenant des objets colonne qui empêchent les liaisons via un lien de colonne à colonne. Si vous essayez de créer ce type de lien, vous êtes invité à créer une interrogation de groupe à groupe (à l'aide des groupes pères) ou à annuler l'opération. Une icône indiquant qu’il s’agit d’une interrogation ne pouvant pas être liée apparaît [image] dans sa barre de titre.

Vous pouvez créer à la place un lien de groupe à groupe entre les deux interrogations et ajouter une clause WHERE à l'instruction SELECT de l'interrogation fils, en référençant la colonne père à l'aide d'une variable de lien.

Par exemple, pour créer un lien de colonne à colonne entre la colonne ADDRESS.STREET de l'interrogation fils et la colonne LOC1 de l'interrogation père, vous pouvez créer un lien de groupe à groupe, puis modifier l'instruction SQL de l'interrogation fils de la manière suivante :

SELECT * FROM EMP E WHERE E.ADDRESS.STREET = :LOC1


A propos des objets LOB Oracle8 dans Report Builder

  Rubriques connexes

Les objets LOB (Large Object) Oracle8 permettent de réduire l'espace temporaire utilisé par Report Builder. Sur la ligne de commande, vous pouvez demander à mettre le LOB en mémoire cache sur le client. Si vous décidez de ne pas effectuer cette opération, Report Builder stocke une référence au LOB et ne met pas ce dernier en mémoire cache dans un fichier temporaire. Cette opération réduit les besoins en espace temporaire ; toutefois, les performances sont réduites car les valeurs de colonne doivent systématiquement être extraites de la base de données.

Remarque : Vous ne pouvez définir la mise en mémoire cache du LOB que sur la ligne de commande.


A propos de la sortie délimitée

  Restrictions 	  Rubriques connexes

La sortie délimitée permet d'indiquer un séparateur (caractère ou chaîne de caractères) de données pour la sortie de l'état. Cette fonction permet de créer une sortie facile à importer dans des tableurs comme Microsoft Excel.

Vous pouvez indiquer le séparateur de l'une des manières suivantes :

•	sur la ligne de commande, via le paramètre DELIMITER ;

•	dans la boîte de dialogue de sortie délimitée, via l'option Délimiteur. (Cette boîte de dialogue n'est disponible que dans la version américaine de Report Builder 6.0 et versions ultérieures).

Lorsque vous générez une sortie délimitée, vous pouvez différencier encore plus les cellules à l'aide d'un intercalaire de cellules. Cet intercalaire peut comporter n'importe quelle série de caractères, y compris des virgules et des parenthèses.

Par exemple, si les données de votre sortie d'état comportent un caractère identique à celui du séparateur (comme une virgule), vous pouvez utiliser l'intercalaire de cellules parenthèses pour distinguer les différentes cellules :

(1,000,000),(3,6000),(543),(2,003,500)…

Notes d'utilisation

Lorsque vous générez une sortie délimitée, les données sont affichées selon l'ordre d'apparition des objets dans la vue Modèle de présentation.

•	Si vous placez A au-dessus ou à gauche de B (A et B représentant tout objet standard ou tout objet de champ), Report Builder affiche chaque instance de A avant celle de B dans les lignes de sortie.

 Cliquez ici.

•	Si vous créez un cadre qui contient un objet standard (A) et inclut un cadre itératif comportant un objet de champ (B), chaque instance de A apparaît avec celle de B.

 Cliquez ici.

•	Dans la présentation précédente, si vous ajoutez un cadre supplémentaire qui contient un objet standard (C) et inclut un autre cadre itératif comportant un objet de champ (D), A apparaît à chaque instance de B, et C apparaît à chaque instance de D.

 Cliquez ici.

•	Si vous créez une matrice dans votre état, veillez à aligner les objets conformément à la grille de la vue Modèle de présentation. Si les objets ne sont pas alignés, Report Builder risque d'interpréter l'espace restant comme une ligne ou une colonne supplémentaire, ce qui peut perturber la sortie d'état.

•	Si vous créez un objet standard en dehors de la matrice, chaque instance de cet objet apparaît sur chaque ligne (et non chaque colonne) de la matrice. Remarquez que les objets standard de la matrice ne sont pas répétés avec les objets de champ hors de la matrice.

 Cliquez ici.


A propos des hyperliens graphiques

  Exemples 	  Rubriques connexes

Vous pouvez associer une section graphique d'une sortie HTML ou PDF avec un objet quelconque de votre sortie d'état (comme un champ ou une instance d'encadrement itératif), avec un autre état ou toute autre destination hyperlien valide. Dans la sortie d'état, un utilisateur peut cliquer sur une section graphique pour la détailler. Il peut également accéder à un état de niveau hiérarchique inférieur.

Vous pouvez créer automatiquement des hyperliens graphiques via la page correspondante de l'assistant Web ou définir explicitement la propriété Hyperlien graphique dans la palette de propriétés.


A propos du sectionnement d'état

  Rubriques connexes

Le sectionnement d'état permet de définir plusieurs présentations pour un même état, chacune étant destinée à un public précis et comportant un format de sortie distinct, ainsi qu'une présentation, une orientation et un format de page différents. Vous pouvez définir jusqu'à trois sections d'état comportant un corps et une marge. Afin de conserver la compatibilité avec les versions précédentes, les sections sont appelées Section d'en-tête, Section principale et Section de fin. Par défaut, l'état est défini dans la section principale. Les autres sections permettent de définir différentes présentations et non de créer différents états. Par exemple, un seul état peut contenir un récapitulatif destiné aux cadres supérieurs dans une section et un rapport détaillé destiné aux différents directeurs dans une autre section.

Utilisez la marge et le corps des sections d'en-tête et de fin pour créer une page d’en-tête ou de fin comme dans les versions précédentes. Les prochaines versions permettront d'ajouter et de supprimer des sections.

Dans le Navigateur d'objet, les sections d'état sont affichées sous le noeud Modèle de présentation en tant que Section d'en-tête, Section principale et Section de fin.


A propos de l'intégration avec d'autres outils d'aide à la décision

Outre Oracle Discoverer et Oracle Express, Reports fournit les technologies existantes les plus performantes permettant de répondre à l'ensemble des besoins de l'entreprise en matière d'aide à la décision (du suivi de production et des questions ad hoc à une analyse avancée). Cette solution intégrée permet une grande facilité d'utilisation et des performances jamais égalées, tout en réduisant les coûts de développement et de mise en place.

Vous pouvez transformer instantanément vos feuilles de travail Discoverer en états Web dynamiques et les diffuser dans toute l'entreprise. Pour plus d'informations sur la conversion de feuilles de travail en états, reportez-vous à la documentation Discoverer.

Dans Report Builder, vous pouvez fonder un état sur les indicateurs et les dimensions Express. L'assistant Etat permet de choisir le type d'interrogation à créer (Express ou SQL). La boîte de dialogue Interrogation Express permet de sélectionner la base de données, les indicateurs et les dimensions à utiliser dans un état. Vous pouvez restreindre votre recherche à l'aide d'autres outils Express courants, comme Express Selector. Une fois l'interrogation Express terminée, vous pouvez générer et modifier rapidement la présentation de l'état comme pour tout autre état.


A propos de la diffusion d'états

  Rubriques connexes

La diffusion d'un état permet de créer un état capable de générer plusieurs formats de sortie et pouvant être diffusé vers plusieurs destinations en une seule exécution. Vous pouvez créer des diffusions pour la totalité d'un état ou pour des sections distinctes.

Par exemple, en exécutant l'état une seule fois, vous pouvez générer une sortie HTML, envoyer une version PostScript à l'imprimante et envoyer une ou toutes les sections de l'état à une liste de diffusion via courrier électronique. Dans les versions précédentes, vous deviez exécuter l'état pour chaque format de sortie ou chaque destination.

Vous pouvez diffuser un état de l'une des manières suivantes :

•	via la boîte de dialogue Diffusion ;

•	sur la ligne de commande, via le mot-clé DESTINATION, qui indique un fichier .DST.

Remarque : Pour activer la diffusion indiquée, procédez de l'une des manières suivantes :

•	Sélectionnez Fichier [image] Diffusion.

•	Entrez DISTRIBUTE=YES sur la ligne de commande.

Pour vérifier la diffusion d'un état sans le diffuser, produisez une trace de la diffusion de l'état ; elle indique les listes de diffusion utilisées. Ces informations permettent de déterminer la destination des différentes sections.

Notes d'utilisation

•	Vous ne pouvez pas utiliser à la fois le mode caractère et une sortie bitmap dans un même état. Le paramètre MODE ne peut être défini que sur une seule valeur par état (DEFAULT, BITMAP ou CHARACTER). Vous ne pouvez donc pas trouver les deux valeurs dans un même état.


A propos du fichier .DST

  Rubriques connexes 	  Exemples

Au lieu de définir la diffusion d'un état ou d'une de ses sections dans la boîte de dialogue Diffusion, vous pouvez créer un fichier .DST et entrer son nom sur la ligne de commande via le mot-clé DESTINATION pour diffuser cet état.

Si un fichier .DST est indiqué sur la ligne de commande, la diffusion ainsi définie remplace celle qui a été paramétrée dans la boîte de dialogue Diffusion.

Si vous produisez une trace de la diffusion de l'état, le format du fichier de trace (généré si la case Diffusion est cochée) est très proche du fichier .DST, ce qui vous permet de générer un fichier .DST en effectuant un copier-coller à partir du fichier de trace.

Chaque ligne d'un fichier .DST est de format :

dist_ID:  output_def

où

dist_ID	est un identificateur de destination de diffusion.
output_def	est une série d'options de ligne de commande RWRUN60 ou RWCLI60 qui indique la définition de diffusion. En outre, le paramètre suivant est valide :
	LEVEL	indique l'étendue de la diffusion. Valeurs REPORT signifie que la diffusion concerne la totalité de l'état. HEADER_SECTION signifie que la diffusion concerne uniquement la section d'en-tête. MAIN_SECTION signifie que la diffusion concerne uniquement la section principale (corps). TRAILER_SECTION signifie que la diffusion concerne uniquement la section de fin. Valeur par défaut ETAT


fichier RWRUN60 .DST
Fichier .DST - Exemple

  Rubriques connexes

/* Dans cet exemple, la définition envoie
** la sortie d'état vers un fichier HTML, 3 copies
** de la section principale vers l'imprimante et
** la section d'en-tête vers un fichier PDF.
*/

;dst file
DEST1:  DESNAME=TESTDST1.HTM DESTYPE=FILE
        DESFORMAT=HTML COPIES=1 LEVEL=REPORT
DEST2:  DESNAME=\\LUNA\2OP813 DESTYPE=PRINTER
        DESFORMAT=BITMAP COPIES=3
        LEVEL=MAIN_SECTION
DEST3:  DESNAME=SECTION1.PDF DESTYPE=FILE
        DESFORMAT=PDF COPIES=1
        LEVEL=HEADER_SECTION


A propos de la sortie au format page HTML

 Rubriques connexes

La sortie au format page HTML permet d'afficher dans le navigateur Web des pages distinctes d'une sortie d'état HTML/HTMLCSS, sans télécharger la totalité de l'état. Depuis la première page de l'état, vous pouvez accéder à toutes les autres pages. Lorsque vous cliquez sur un signet ou un hyperlien dont la destination est située :

•	à l'intérieur de l'état, le cadre contenant la page en cours est mis à jour de façon à correspondre à la page de destination ;

•	en-dehors de l'état, le cadre de base global (y compris le cadre de signet, la page et le cadre de navigation) est de nouveau chargé.

Contrôles de navigation

Pour activer les contrôles de navigation de page, vous pouvez :

•	utiliser la fonctionnalité JavaScript intégrée fournie par Report Builder ;

•	entrer votre propre script JavaScript (ou un autre script) ;

Si vous utilisez votre propre script, incluez-y ces trois variables :

•	&TotalPages (nombre total de pages)

•	&file_name (nom du fichier de destination de la sortie ; par exemple, MonEtat).

•	&file_ext (extension du fichier ; par exemple, htm)

Report Builder affecte des valeurs à ces variables au cours de la mise en forme.

La hauteur de l'encadrement des contrôles de navigation de page est codée en dur en 70 points sans barre de défilement. La largeur de cet encadrement est variable. Pour y utiliser des icônes et des images, gardez ces dimensions à l'esprit.

Vous pouvez indiquer le script de contrôle de navigation :

•	via une instruction PL/SQL (SRW.SET_PAGE_NAVIGATION_HTML dans un déclencheur Before Report) ;

•	dans la palette de propriétés Etat, via les propriétés Type Contrôle de navigation de page et Valeur Contrôle de navigation de page.

Noms des fichiers de sortie

En sortie au format pages HTML, chaque page est formatée en tant que document HTML distinct. Si votre fichier HTML s'appelle MonEtat.htm et qu'il ne contient aucun signet, les nouveaux fichiers sont intitulés :

•	MonEtat.htm (pour le cadre de base)

•	MonEtat_1.htm à MonEtat_n.htm (pour les pages)

•	MonEtatj.htm (pour le script de navigation JavaScript)

Si le fichier HTML contient des signets, les nouveaux fichiers sont appelés :

•	MonEtat.htm (pour le cadre de base)

•	MonEtatb.htm (pour le fichier de signet)

•	MonEtat_1.htm à MonEtat_n.htm (pour les pages)

•	MonEtatj.htm (pour le script de navigation JavaScript)

Etendue de la sortie HTML

Pour n'afficher la sortie HTML que sur la première page (page d'en-tête) ou la dernière (page de fin) de votre état, définissez la propriété Avant état ou Après état, ou utilisez la procédure PL/SQL SRW.SET_BEFORE_REPORT_HTML ou SRW.SET_AFTER_REPORT_HTML. Pour appliquer la sortie HTML globale à tout l'état, notamment aux couleurs de fond ou aux images, définissez la propriété Avant page ou la procédure PL/SQL SRW.SET_BEFORE_PAGE_HTML. Le logo HTML généré par Report Builder apparaît uniquement sur la dernière page de l'état.

Activation de la sortie au format pages

Pour activer la sortie au format pages lors du formatage de l'état comme sortie HTML ou HTMLCSS, entrez PAGESTREAM=YES sur la ligne de commande. Vous ne pouvez pas paramétrer cette option via l'interface utilisateur de Report Builder.


Restrictions liées à la sortie au format délimité

Si le premier champ du fichier texte est intitulé ID (en majuscules), vous ne pourrez pas ouvrir ce fichier dans Microsoft Excel. La sortie au format délimité ci-dessous provoque une erreur dans Excel :

ID, nom, titre, service, etc.

Pour générer une sortie au format délimité contenant un champ d'ID, écrivez en minuscules le nom de la colonne de base de données contenant l'ID (id) ou modifiez l'ordre des champs.


A propos de la sortie XML

 Rubriques connexes

Le format XML (Extensible Markup Language) produit une sortie délimitée par des balises, qui définit des informations structurées. Le format XML permet d'échanger des données électroniques avec une application tierce (EDI) et de publier des informatins sur le Web.

Des balises XML modifiables par l'utilisateur sont affectées par défaut aux données dans des états de type tabulaire, groupe - gauche, groupe -niveau supérieur et matrice. Pour plus d'informations sur la définition de la structure de la sortie XML, reportez-vous à la rubrique propriétés XML.

Pour obtenir des informations sur la génération d'un fichier .XML, reportez-vous à la rubrique Génération d'une sortie XML.


delim1_bmp


delim2_bmp


delim3_bmp


delim4_bmp


Déplacement d'états

Pour déplacer les états stockés dans les fichiers du système d'exploitation vers la base de données ou vice versa, vous pouvez procéder de l'une des façons suivantes :

•	Ouvrez l'état, puis sélectionnez Fichier [image] Enregistrer sous. Enregistrez l'état dans la base de données ou dans un fichier. Le cas échéant, vous pouvez ensuite supprimer la version originale de l'état à l'aide des commandes du système d'exploitation (pour les fichiers) ou en sélectionnant Fichier [image] Administration [image] Supprimer (pour la base de données).

•	Utilisez RWCON60.


Suppression de documents

Pour supprimer les documents stockés dans les fichiers du système d'exploitation, supprimez ces fichiers à l'aide des commandes appropriées du système d'exploitation.

Pour supprimer des documents de la base de données, vous pouvez procéder de l'une des façons suivantes :

•	Sélectionnez Fichier [image] Administration [image] Supprimer, puis sélectionnez le document (état, interrogation externe ou bibliothèque PL/SQL externe) que vous voulez supprimer.

•	Utilisez le script droprep.sql pour supprimer un état de la base de données.


Documentation sur les états

Pour imprimer la documentation relative à un ou plusieurs états, sélectionnez Fichier [image] Administration [image] Etat sur états. Cela génère un rapport sur vos états stockés dans la base de données. Lorsque vous y êtes invité, vous pouvez entrer en partie ou dans sa totalité un nom d'état pour indiquer pour quel(s) état(s) vous désirez un rapport. Vous pouvez utiliser les caractères % ou _ comme caractères génériques afin d'indiquer le ou les état(s) sur lesquels vous désirez des informations.


Fichiers utilisés par Report Builder

Fichiers créés par vous-même

Le tableau ci-après présente les fichiers que vous devez fournir à Report Builder en entrée, en fonction de l'exécutable utilisé et des opérations effectuées :

Type de fichier	RWBLD60	RWRUN60	RWCON60
fichier de définition d'état <nom état>.rdf	Exécuter/ Imprimer et Convertir, si STYPE a pour valeur RDFILE	Requiert toujours ce fichier ou le fichier .REP	Pour SOURCE, si STYPE a pour valeur RDFILE
fichier d'exécution d'état <nom état>.rep	-	Requiert toujours ce fichier ou le fichier .RDF	-
fichier texte d'état <nomfichier>.rex	Convertir, si STYPE a pour valeur REXFILE	-	Pour SOURCE, si STYPE a pour valeur REXFILE
fichier de description du terminal (mode caractère seulement)	Toujours	Si BATCH a pour valeur NO	-
fichier de séquences de touches (mode caractère seulement)	Si KEYIN est indiqué	Si KEYIN est indiqué	-
fichier de description d'imprimante V2.0  <dflt>	Exécuter	Toujours	-
fichier de description d'imprimante V1.1 <printdef.dat>	-	-	-

Fichiers créés par Report Builder

Le tableau ci-après présente les fichiers créés par  Report Builder, en fonction de l'exécutable utilisé et des opérations effectuées :

Type de fichier	RWBLD60	RWRUN60	RWCON60
fichier de définition d'état <nom état>.rdf	Enregistrer, Enregistrer sous ou Convertir, si DTYPE a pour valeur RDFILE	-	Pour DEST, si DTYPE a pour valeur RDFILE
fichier d'exécution d'état <nom état>.rep	Générer ou Convertir, si DTYPE a pour valeur REPFILE	-	Pour DEST, si DTYPE a pour valeur RDFILE
fichier texte d'état <nomfichier>.rex	Enregistrer, Enregistrer sous ou Convertir, si DTYPE a pour valeur REXFILE	-	Pour DEST, si DTYPE a pour valeur RDFILE
fichier d'état en sortie <nom état>.lis	Exécuter/Imprimer, si DESTYPE a pour valeur FILE	Si DESTYPE a pour valeur FILE	-
fichier journal de profil <temp>	Si PROFILER a pour valeur YES	Si PROFILER a pour valeur YES	-
fichier journal des erreurs <temp>	Si ERRFILE est indiqué	Si ERRFILE est indiqué	-
fichier journal de  trace<trace.dat>	Si TRACEFILE est indiqué	Si TRACEFILE est indiqué	-
fichier de sortie imprimante	Exécuter/Imprimer, si DESTYPE a pour valeur PRINTER	Si DESTYPE a pour valeur PRINTER	-
fichier de séquences de touches (mode caractère seulement)	Si KEYOUT est indiqué	Si KEYOUT est indiqué	-
fichier journal d'impression écran (mode caractère seulement)	PRINT SCREEN	PRINT SCREEN	-
fichier de description d'imprimante V2.0  <dflt>	-	-	-
fichier cache d'enregistrements - id<number> et dat<number> obligatoires) <temp>	Exécuter/Imprimer	Exécuter/Imprimer	-
fichiers de permutation mémoire (créés seulement en cas de besoin) <temp>	Exécuter/Imprimer	Exécuter/Imprimer	-


Packages intégrés

  Rubriques connexes 	  Liste alphabétique

Oracle propose plusieurs procédures internes à utiliser lors de la création ou du débogage des applications PL/SQL.

Votre code PL/SQL peut utiliser les procédures, les fonctions et les exceptions dans les packages intégrés client suivants :

Packages intégrés de Report Builder

Autres packages intégrés


Packages intégrés de Report Builder

  Rubriques connexes 	  Tous les packages intégrés

Un seul package intégré Report Builder existe :

SRW


Package intégré SRW

  procédures internes

SRW.ADD_DEFINITION

SRW.APPLY_DEFINTION

SRW.BREAK

SRW.CONTEXT_FAILURE

SRW.DO_SQL

SRW.DO_SQL_FAILURE

SRW.GETTERR_RUN

SRW.GET_PAGE_NUM

SRW.INTEGER_ERROR

SRW.MAXROW_INERR

SRW.MAXROW_UNSET

SRW.MESSAGE

SRW.NULL_ARGUMENTS

SRW.PROGRAM_ABORT

SRW.REFERENCE

SRW.RUN_REPORT

SRW.RUN_REPORT_BATCHNO

SRW.RUN_REPORT_FAILURE

SRW.SETattributes

SRW.TRACE_ADD_OPTION

SRW.TRACE_END

SRW.TRACE_REM_OPTION

SRW.TRACE_START

SRW.TRACEOPTS.MASK

SRW.TRUNCATED_VALUE

SRW.UNKNOWN_QUERY

SRW.UNKNOWN_USER_EXIT

SRW.USER_EXIT

SRW.USER_EXIT20

SRW.USER_EXIT_FAILURE


SRW.SET_ATTR
éAttributs SRW.SET_ATTR

  Rubriques connexes	  Toutes les procédures internes

ACTION

AFTCODE

AFTFORM_ESCAPE

AFTPAGE_ESCAPE

AFTREPORT_ESCAPE

BBCOLOR

BEFCODE

BEFFORM_ESCAPE

BEFPAGE_ESCAPE

BEFREPORT_ESCAPE

BFCOLOR

BOOKMARK

BORDERWIDTH

BORDPATT

FACE

FBCOLOR

FFCOLOR

FILLPATT

FORMATMASK

GCOLOR

GSPACING

HJUST

HYPERLINK

LINKTAG

PRINTER_INTRAY

STYLE

SZ

TEXT

WEIGHT


ACTION

  Exemples 	  Restrictions	  Rubriques connexes	  Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_PDF_ACTION. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer une ligne de commande qui sera exécutée sur la machine locale lorsque vous cliquez sur l'objet dans le Visualiseur PDF.

Remarque : Un objet associé à une action ne peut pas être la source d'un lien Web.

Valeurs

Toute ligne de commande valide sur la machine locale (par exemple c:\orawin\bin\rwrun60 userid=scott/tiger report=example.rdf or /usr/local/bin/phone smith)


ACTION - Restrictions

•	ACTION ne peut être utilisée que pour une sortie PDF.

•	ACTION doit être définie uniquement dans les déclencheurs suivants :

Format


ACTION - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET ATTR pour définir l'attribut ACTION. Il est désormais plus judicieux de définir cet attribut via la procédure SRW.SET_PDF_ACTION. La définition de cet attribut via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* Le déclencheur de format ci-dessous définit une "action"
** (dans ce cas un appel à Reports Runtime) qui
** devra être exécutée lorsque l'utilisateur cliquera
** sur l'objet standard B_2.
*/

function B_2FormatTrigger return boolean is
begin
  srw.attr.mask := srw.ACTION_ATTR;
  srw.attr.action  := 'c:\orawin\bin\rwrun60 ' ||
  'userid=scott/tiger ' ||
  'report=exemple.rdf';
  srw.set_attr(0,srw.attr);
  return (TRUE);
end;


AFTCODE

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_AFTER_PRINTING_CODE. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet de faire référence à la séquence d'échappement d'imprimante qui devra être exécutée après chaque ligne de l'objet. Cette séquence est insérée après le déclenchement de l'impression de l'objet, mais avant l'impression proprement dite. AFTCODE n'est utilisée que lors de l'exécution de votre état en mode caractère.

Valeurs

Une chaîne de type &numéro, où numéro est une valeur attribuée à une séquence d'échappement d'imprimante de Report Builder en package ou à une séquence d'échappement d'imprimante que vous avez créée.


AFTFORM_ESCAPE

  Rubriques connexes	 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_AFTER_FORM_HTML. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description  Permet d'afficher un texte, un graphique ou une commande HTML au bas d'une grille de paramètres HTML. Cet attribut est utile pour placer un logo ou des liens standard sur une grille de paramètres.

Valeurs

Vous devez indiquer pour cet attribut deux éléments :

•	AFTFORM_ESCAPE_TYPE qui peut prendre la valeur SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE.

•	AFTFORM_ESCAPE_VALUE qui peut être un nom de fichier ou une chaîne de texte contenant un HTML valide, en fonction de la valeur que vous avez donnée à AFTFORM_ESCAPE_TYPE. Si vous indiquez un fichier, la méthode de recherche de fichiers est utilisée pour le trouver.


AFTPAGE_ESCAPE

  Exemples	  Restrictions	  Rubriques connexes	 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_AFTER_PAGE_HTML. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'insérer un texte, un graphique ou une commande HTML à la fin des pages de votre document. Cet attribut permet de placer, par exemple, un logo ou des liens standard à la fin de chaque page d'un document HTML.

Valeurs

Vous devez indiquer pour cet attribut deux éléments :

•	AFTPAGE_ESCAPE_TYPE qui peut prendre la valeur SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE.

•	AFTPAGE_ESCAPE_VALUE qui peut être un nom de fichier ou une chaîne de texte contenant un HTML valide, en fonction de la valeur que vous avez donnée à AFTPAGE_ESCAPE_TYPE. Si vous indiquez un fichier, la méthode de recherche de fichiers est utilisée pour le trouver.


AFTPAGE_ESCAPE - Restrictions

Lorsque vous indiquez SRW.SET_ATTR pour cet attribut, vous devez utiliser SRW.REPORT_ID comme id d'objet :

   SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);

•	Le code HTML par défaut inclus au bas d'une page est indiqué ci-après. Il n'est obligatoire que si vous voulez que la ligne de séparation par défaut apparaisse entre les pages.

   <hr size=5 noshade>

•	Si vous voulez que AFTPAGE_ESCAPE s'applique à chacune des pages de l'état, vous devez l'indiquer dans un déclencheur qui est activé avant le début de la mise en forme de l'état, comme le déclencheur Before Report.

•	Si vous voulez que AFTPAGE_ESCAPE ne s'applique qu'à la page en cours, vous devez l'indiquer dans un déclencheur de format pour un objet de cette page.


Séparateur graphique de pages - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET_ATTR pour définir l'attribut AFTPAGE_ESCAPE. Il est désormais plus judicieux de le définir via la procédure SRW.SET_AFTER_PAGE_HTML. La définition de cet attribut via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* L'exemple ci-dessous insère un fichier GIF
** comme séparateur de page.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CARACTERE') and
    (upper(:DESFORMAT) = 'HTML')) then
 SRW.ATTR.MASK := SRW.AFTPAGE_ESCAPE_ATTR;
 SRW.ATTR.AFTPAGE_ESCAPE_TYPE := SRW.TEXT_ESCAPE;
 SRW.ATTR.AFTPAGE_ESCAPE_VALUE := '<CENTER>' ||
 '<IMG ALT="Ruler" SRC="line.gif" VSPACE=10>' ||
 '<BR></CENTER>';
 SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);
end if;
return (TRUE);
end;


AFTREPORT_ESCAPE

  Exemples	  Restrictions 	  Rubriques connexes [image] Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_AFTER_REPORT_HTML. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer un texte, un graphique ou une commande HTML que vous voulez voir figurer à la fin de votre document. Cet attribut permet de placer un logo ou des liens standards à la fin d'un document HTML.

Valeurs

Vous devez indiquer pour cet attribut deux éléments :

•	AFTREPORT_ESCAPE_TYPE qui peut prendre la valeur SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE.

•	AFTREPORT_ESCAPE_VALUE qui peut être un nom de fichier ou une chaîne de texte contenant une commande HTML valide, en fonction de la valeur que vous avez donnée à AFTREPORT_ESCAPE_TYPE. Si vous indiquez un fichier, la méthode de recherche de fichiers est utilisée pour le trouver.


AFTREPORT_ESCAPE - Restrictions

•	Lorsque vous indiquez SRW.SET_ATTR pour cet attribut, vous devez utiliser SRW.REPORT_ID comme id d'objet :

   SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);

•	La commande HTML par défaut incluse à la fin d'un état est représentée ci-après. Si vous utilisez AFTREPORT_ESCAPE pour remplacer ce texte, vous devez vous assurer qu'il contient les commandes HTML équivalentes.

   </body></html>

•	AFTREPORT_ESCAPE doit être indiqué dans un déclencheur qui est activé avant la fin de la mise en forme de l'état, comme le déclencheur Before Report.


Liens aux pages d'origine - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET_ATTR pour définir l'attribut AFTREPORT_ESCAPE. Il est désormais plus judicieux de le définir via la procédure SRW.SET_AFTER_REPORT_HTML. La définition de cet attribut via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* L'exemple ci-dessous insère deux liens vers des
** pages d'accueil à la fin de la sortie de l'état.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CARACTERE') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.ATTR.MASK := SRW.AFTREPORT_ESCAPE_ATTR;
  SRW.ATTR.AFTREPORT_ESCAPE_TYPE := SRW.TEXT_ESCAPE;
  SRW.ATTR.AFTREPORT_ESCAPE_VALUE := '<CENTER>' ||
  '<A HREF="http://www.oracle.com/">' ||
  'Oracle Corporation</A> -' ||
  chr(10) ||
  '<A HREF="http://home.netscape.com/">' ||
  'Netscape</A> </CENTER>' ||
  '</BODY> </HTML>';
  SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);
end if;
return (TRUE);
end;


BBCOLOR

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_BACKGROUND_BORDER_COLOR. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer la couleur de bordure d'arrière-plan de l'objet. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

Un nom de couleur valide.


BEFCODE

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_BEFORE_PRINTING_CODE. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet de faire référence à la séquence d'échappement d'imprimante qui devra être exécutée avant chaque ligne de l'objet. Cette séquence est insérée après la demande d'impression de l'objet, mais avant l'impression proprement dite. BEFCODE n'est utilisé que lorsque vous exécutez votre état en mode caractère.

Valeurs

Une chaîne de type &numéro, où numéro est une valeur attribuée à une séquence d'échappement d'imprimante de Report Builder en package ou à une séquence d'échappement d'imprimante que vous avez créée.


BEFFORM_ESCAPE

  Rubriques connexes	 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_BEFORE_FORM_HTML. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description  Permet d'afficher un texte, un graphique ou une commande HTML en haut d'une grille de paramètres HTML. Cet attribut est utile pour placer un logo ou des liens standard sur une grille de paramètres.

Valeurs

Vous devez indiquer pour cet attribut deux éléments :

•	BEFFORM_ESCAPE_TYPE qui peut prendre la valeur SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE.

•	BEFFORM_ESCAPE_VALUE qui peut être un nom de fichier ou une chaîne de texte contenant un HTML valide, en fonction de la valeur que vous avez donnée à BEFFORM_ESCAPE_TYPE. Si vous indiquez un fichier, la méthode de recherche de fichiers est utilisée pour le trouver.


BEFPAGE_ESCAPE

  Exemples 	  Restrictions 	  Rubriques connexes	  Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_BEFORE_PAGE_HTML. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer un texte, un graphique ou une commande HTML que vous voulez voir figurer au début des pages de votre document. Cet attribut permet de placer un logo ou des liens standards au début de chaque page d'un document HTML.

Valeurs

Vous devez indiquer pour cet attribut deux éléments :

•	BEFPAGE_ESCAPE_TYPE qui peut prendre la valeur SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE.

•	BEFPAGE_ESCAPE_VALUE qui peut être un nom de fichier ou une chaîne de texte contenant une commande HTML valide, en fonction de la valeur que vous avez donnée à BEFPAGE_ESCAPE_TYPE. Si vous indiquez un fichier, la méthode de recherche de fichiers est utilisée pour le trouver.


BEFPAGE_ESCAPE - Restrictions

•	Lorsque vous indiquez SRW.SET_ATTR pour cet attribut, vous devez utiliser SRW.REPORT_ID comme id d'objet :

   SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);

•	Si vous voulez que BEFPAGE_ESCAPE s'applique à chacune des pages de l'état, vous devez l'indiquer dans un déclencheur qui est activé avant le début de la mise en forme de l'état, comme le déclencheur Before Report .

•	Si vous voulez que BEFPAGE_ESCAPE ne s'applique qu'à la page en cours, vous devez l'indiquer dans un déclencheur de format pour un objet de cette page.


Echappement avant et après page - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET_ATTR pour définir les attributs BEFPAGE_ESCAPE et AFTPAGE_ESCAPE. Il est désormais plus judicieux de les définir via les procédures SRW.SET_BEFORE_PAGE_HTML et SRW.SET_AFTER_PAGE_HTML. La définition de ces attributs via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser les nouvelles procédures, plus simples.

/* L'exemple ci-dessous centre le document
** dans le navigateur.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CARACTERE') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.ATTR.MASK := SRW.BEFPAGE_ESCAPE_ATTR +
                   SRW.AFTPAGE_ESCAPE_ATTR;
  SRW.ATTR.BEFPAGE_ESCAPE_TYPE := SRW.TEXT_ESCAPE;
  SRW.ATTR.BEFPAGE_ESCAPE_VALUE := '<CENTER>';
  SRW.ATTR.AFTPAGE_ESCAPE_TYPE := SRW.TEXT_ESCAPE;
  SRW.ATTR.AFTPAGE_ESCAPE_VALUE := '</CENTER>';
  SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);
end if;
return (TRUE);
end;


BEFREPORT_ESCAPE

  Exemples 	  Restrictions 	  Rubriques connexes	  Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide des procédures SRW.SET_BEFORE_REPORT_HTML et SRW.SET_AFTER_REPORT_HTML. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer un texte, un graphique ou une commande HTML que vous voulez voir figurer au début de votre document. Cet attribut permet de placer un logo ou des liens standard au début d'un documents HTML.

Valeurs

Vous devez indiquer pour cet attribut deux éléments :

•	BEFREPORT_ESCAPE_TYPE qui peut recevoir la valeur SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE.

•	BEFREPORT_ESCAPE_VALUE qui peut être un nom de fichier ou une chaîne de texte contenant un HTML valide, en fonction de la valeur que vous avez donnée à BEFREPORT_ESCAPE_TYPE. Si vous indiquez un fichier, la méthode de recherche de fichiers est utilisée pour le trouver.


BEFREPORT_ESCAPE - Restrictions

•	Lorsque vous indiquez SRW.SET_ATTR pour cet attribut, vous devez utiliser SRW.REPORT_ID comme id d'objet :

   SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);

•	Le HTML par défaut inclus au début d'un état est indiqué ci-après. Si vous utilisez BEFREPORT_ESCAPE pour remplacer ce texte, vous devez vous assurer qu'il contient les commandes HTML équivalentes.

   <html>
<body bgcolor="#ffffff">

•	BEFREPORT_ESCAPE doit être défini dans un déclencheur qui est activé avant le début de la mise en forme de l'état, comme le déclencheur Before Report.


Echappement avant et après état - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET_ATTR pour définir les attributs BEFREPORT_ESCAPE et AFTREPORT_ESCAPE. Il est désormais plus judicieux de les définir via la procédure SRW.SET_BEFORE_REPORT_HTML. La définition de ces attributs via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* L'exemple ci-après définit BEFREPORT_ESCAPE et
** AFTREPORT_ESCAPE dans le déclencheur Before Report.
** La commande HTML de BEFREPORT_ESCAPE se trouve dans un fichier
** appelé logo.htm. Le HTML de AFTREPORT_ESCAPE est
** indiqué dans le PL/SQL lui-même.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CARACTERE') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.ATTR.MASK := SRW.BEFREPORT_ESCAPE_ATTR +
                   SRW.AFTREPORT_ESCAPE_ATTR;
  SRW.ATTR.BEFREPORT_ESCAPE_TYPE := SRW.FILE_ESCAPE;
  SRW.ATTR.BEFREPORT_ESCAPE_VALUE := 'logo.htm';
  SRW.ATTR.AFTREPORT_ESCAPE_TYPE := SRW.TEXT_ESCAPE;
  SRW.ATTR.AFTREPORT_ESCAPE_VALUE := '<ADDRESS>' ||
  ' Questions? - ' ||
  '<A HREF=mailto:webmaster@xyztech.com>' ||
  'webmaster@xyztech.com</A>' ||
  '</ADDRESS>' ||
  '</body></html>';
  SRW.SET_ATTR(SRW.REPORT_ID, SRW.ATTR);
end if;
return (TRUE);
end;


BFCOLOR

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_BACKGROUND_FILL_COLOR. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer la couleur de remplissage d'arrière-plan de l'objet. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

Un nom de couleur valide.


BOOKMARK

  Exemples 	  Restrictions 	  Rubriques connexes	  Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_BOOKMARK. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description BOOKMARK est une chaîne qui doit apparaître dans un cadre du document HTML principal ou dans le Visualiseur PDF si vous ouvrez la zone signet. Cliquer sur le signet permet d'afficher l'objet associé en haut de la fenêtre.

Valeurs

Une chaîne de texte sans indentation/classement. Le signet apparaît dans la liste des signets en fonction du moment où l'objet est rendu par l'état.

Une chaîne de texte avec indentation et classement se présentant sous la forme x#nom_signet, où x est un numéro de contour. Le signe # et le numéro d'ordre n'apparaissent pas dans la fenêtre signet, mais sont utilisés pour déterminer le classement et l'indentation. Par exemple :

1#Section récapitulative des dépenses
2#Section détaillée des dépenses
2.1#Dépenses du département Administration
2.2#Dépenses du département Technique
2.3#Dépenses du département Ventes
2.3.1#Dépenses de la région Est
2.3.2#Dépenses de la région Nord
2.3.3#Dépenses de la région Sud
2.3.4#Dépenses de la région Ouest


BOOKMARK - Restrictions

•	Si vous utilisez plusieurs fois le même numéro, toutes les entrées apparaissent, mais leur ordre est défini par le stade auquel les objets sont rendus par l'état.

•	S'il y a des "trous" dans les numéros, de deux choses l'une : si le trou se trouve entre des numéros de niveau pair, il n'y aura aucun effet visible (par exemple, 1.3.1 et 1.3.3, comme il n'y a pas de 1.3.2, apparaîtront côte à côte et au même niveau d'indentation). Si le trou se trouve entre un numéro de niveau supérieur à un numéro de niveau inférieur, les niveaux intermédiaires seront générés (par exemple, 1.1 suivi de 2.1.1 entraînera la définition des entrées factices 2 et 2.1, dont les titres seront identiques à ceux de l'entrée réelle suivante).

•	BOOKMARK doit être défini uniquement dans les déclencheurs suivants :

Format


BOOKMARK - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET ATTR pour définir l'attribut BOOKMARK. Il est désormais plus judicieux de le définir via la procédure SRW.SET_BOOKMARK. La définition de cet attribut via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* Le déclencheur de format ci-dessous définit un signet pour
** l'objet texte standard B_2. Notez l'utilisation d'informations
** explicites de classement (1#) dans cet exemple.
** Si vous ne voulez pas d'informations de classement, vous pouvez
** omettre 1#.
*/

function B_2FormatTrigger return boolean is
begin
  srw.attr.mask := srw.BOOKMARK_ATTR;
  srw.attr.signet  := '1# Section Résumé des dépenses';
  srw.set_attr(0,srw.attr);
  return (TRUE);
end;


BOOKMARK dynamique - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET ATTR pour définir l'attribut BOOKMARK. Il est désormais plus judicieux de le définir via la procédure SRW.SET_BOOKMARK. La définition de cet attribut via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* Le déclencheur de format ci-dessous définit un signet pour
** l'objet texte standard B_2. Le nom du signet
** est dynamique. CATEGORY est une valeur de colonne
** concaténée avec la chaîne Expense Summary Section pour
** chaque exécution du déclencheur de format.
** Dans ce cas, CATEGORY peut contenir des informations
** de classement (par exemple, 1#) ou éventuellement une
** chaîne qui rend le signet unique dans l'état.
*/

function B_2FormatTrigger return boolean is
begin
  srw.attr.mask := srw.BOOKMARK_ATTR;
  srw.attr.signet  := :category ||
  ' Section Résumé des dépenses';
  srw.set_attr(0,srw.attr);
  return (TRUE);
end;


BORDERWIDTH

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_BORDER_WIDTH. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer la largeur de la bordure de l'objet.

Valeurs

0	Pas de bordure.
Tout entier positif	Bordure avec le nombre de picas indiqué pour un état en mode bitmap ou un caractère pour un état en mode caractère.


BORDPATT

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_BORDER_PATTERN. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer le motif de remplissage de la bordure de l'objet. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

Nom de motif valide.


FACE

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_FONT_FACE. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer la police d'un champ CHAR, DATE ou NUMBER. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

Nom de police valide sur la machine sur laquelle s'exécute l'état.


FBCOLOR

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_FOREGROUND_BORDER_COLOR. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer la couleur de bordure de premier plan de l'objet. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

Un nom de couleur valide.


FFCOLOR

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_FOREGROUND_FILL_COLOR. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer la couleur de remplissage de premier plan de l'objet. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

Un nom de couleur valide.


FILLPATT

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_FILL_PATTERN. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer le motif de remplissage de l'objet. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

Nom de motif valide.


FORMATMASK

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_FORMAT_MASK. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer le masque de format du champ DATE ou NUMBER.

Valeurs

Masque de format valide.


GCOLOR

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_TEXT_COLOR. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer la couleur de l'ensemble du texte du champ CHAR, DATE ou NUMBER. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

Un nom de couleur valide.


GSPACING

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_CUSTOM_SPACING ou SRW.SET_SPACING. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer l'interlignage de l'ensemble du texte du champ CHAR, DATE ou NUMBER ou du texte standard. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

srw.single_spacing

srw.onehlf_spacing

srw.double_spacing

srw.custom_spacing	Permet d'indiquer l'interlignage en unités VGS, qui sont très petites. Si vous utilisez srw.custom_spacing, vous devez indiquer ensuite le nombre personnalisé d'unités VGS en utilisant srw.attr.custom. Par exemple :

                      srw.attr.mask        := SRW.GSPACING_ATTR;

                      srw.attr.gspacing    := SRW.CUSTOM_SPACING;

                      srw.attr.custom      := 200;

                      srw.set_attr (0, srw.attr);


HJUST

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_JUSTIFICATION. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer la justification horizontale du champ CHAR, DATE ou NUMBER.

Valeurs

srw.left_hjust

srw.center_hjust

srw.right_hjust

srw.flush_hjust	N'est pas pris en compte dans les états en mode bitmap.


HYPERLINK

  Exemples	  Restrictions	  Rubriques connexes	  Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_HYPERLINK. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer une spécification de lien Web URL.

Remarque : Un objet qui constitue la source d'un lien Web ne peut pas être associé à une action.

Valeurs

Lien valide :

à un autre document sur la même machine (par exemple : file:/perso/nouvdoc.pdf ou file:///C|/temp/nouvdoc.pdf)

à un autre document sur une autre machine (par exemple : http://www.nouvmac.com/nouvdoc.pdf)

à une destination dans le document en cours (par exemple : #mon_nom_dest)

à une destination dans un document local (par exemple : file:/perso/doc.pdf#un_nom_dest)

à une destination dans un document éloigné (par exemple : http://www.nouvmac.com/nouvdoc.pdf#nom_dest)

à un URL (par exemple : http://www.nouvmac.com/nouvdoc.html, ftp://www.collecte.com/filetoget.example, http://www.mach.com/cgi-bin/webmenu?choix1)


HYPERLINK - Restrictions

•	HYPERLINK ne doit être défini que dans les déclencheurs suivants :

Format

•	Pour pouvoir suivre les liens Web à partir d'un visualiseur PDF vers un serveur distant ou un document HTML, le visualiseur PDF doit être configuré de façon à fonctionner avec un navigateur Web (par exemple, configuré comme application de système d'aide ou comme application externe dans votre navigateur Web).


HYPERLINK - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET_ATTR pour définir l'attribut HYPERLINK. Il est désormais plus judicieux de le définir via la procédure SRW.SET_HYPERLINK. La définition de cet attribut via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* Le déclencheur de format ci-dessous définit un lien
** Web vers une destination (mytarget) dans un autre document
** (newdoc.pdf) pour l'objet texte standard B_2.
** Remarque : Si la cible se trouvait dans le même document,
** vous pourriez omettre http://www.newmach.com/newdoc.pdf.
*/

function B_2FormatTrigger return boolean is
begin
  srw.attr.mask := srw.HYPERLINK_ATTR;
  srw.attr.hyperlink  :=
  'http://www.nouvmac.com/nouvdoc.pdf' ||
  '#macible';
  srw.set_attr(0,srw.attr);
  return (TRUE);
end;


HYPERLINK dynamique - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET_ATTR pour définir l'attribut HYPERLINK. Il est désormais plus judicieux de le définir via la procédure SRW.SET_HYPERLINK. La définition de cet attribut via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* Le déclencheur de format ci-dessous définit un lien
** Web pour l'objet texte standard B_3. Notez comment
** la destination du lien est déterminée de façon dynamique
** en fonction de la valeur de SRCDIR et de CF_PICKVIDEO.
** Par exemple, si la valeur de SRCDIR était
** http://www.newmach.com et celle de CF_PICKVIDEO good.avi,
** cette fonction attribuerait le lien Web
** suivant à l'objet :
** http://www.newmach.com/webdemo/src/good.avi.
*/

function B_3FormatTrigger return boolean is
begin
  srw.attr.mask := srw.HYPERLINK_ATTR;
  srw.attr.hyperlink  := :srcdir||:cf_pickvideo;
  if ( upper(:cf_pickvideo) like '%BON%' ) then
    srw.attr.mask := srw.attr.mask +
                     srw.FBCOLOR_ATTR +
                     srw.BBCOLOR_ATTR;
    srw.attr.fbcolor := 'vert';
    srw.attr.bbcolor := 'vert';
  end if;
  srw.set_attr(0,srw.attr);
  return (TRUE);
end;

/* SRCDIR is a parameter whose value is determined at
** runtime by the following After Parameter Form trigger
*/

function AfterPForm return boolean is
begin
  :srcdir := :web_server || '/webdemo/src/';
  :docsdir := :web_server || '/webdemo/docs/';
  return (TRUE);
end;

/* CF_PICKVIDEO is a formula column whose value is
** determined by the following function
*/

function CF_pickvideoFormula return Char is
begin
  if ( :avg_h_div < .80 )
    then return ('bad.avi');
    else return ('good.avi');
  end if;
end;


LINKTAG

  Exemples 	  Restrictions 	  Rubriques connexes	  Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_LINKTAG. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer l'identificateur d'un objet et peut être utilisé comme destination dans les liens Web.

Valeurs

Un nom unique valide qui n'utilise que les 26 caractères ASCII US minuscules ou majuscules, des chiffres et des caractères de soulignement. Les autres caractères spéciaux seront automatiquement convertis en caractères de soulignement.


LINKTAG - Restrictions

•	LINKTAG ne doit être défini que dans les déclencheurs suivants :

Format


LINKTAG - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET ATTR pour définir l'attribut LINKTAG. Il est désormais plus judicieux de le définir via la procédure SRW.SET_LINKTAG. La définition de cet attribut via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* Le déclencheur de format ci-dessous affecte un identificateur
** (mytarget) à l'objet texte standard B_500.
** Cela signifie que l'objet peut maintenant constituer la
** destination d'un lien Web.
*/

function B_500FormatTrigger return boolean is
begin
  srw.attr.mask := SRW.LINKTAG_ATTR;
  srw.attr.linktag := 'macible';
  srw.set_attr(0, SRW.ATTR);
  return (TRUE);
end;


LINKTAG dynamique - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET ATTR pour définir l'attribut LINKTAG. Il est désormais plus judicieux de le définir via la procédure SRW.SET_LINKTAG. La définition de cet attribut via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* Le déclencheur de format ci-dessous affecte un identificateur
** au champ F_Dept en concaténant du texte statique
** (dept_details_) avec la valeur de la colonne source
** (DEPTNO). Cette fonction vérifie qu'un identificateur unique
** est affecté à chaque instance de F_Dept.
*/

function F_ServFormatTrigger return boolean is
begin
  srw.attr.mask := SRW.LINKTAG_ATTR;
  srw.attr.linktag := 'details_service_' ||
  LTRIM(TO_CHAR(:noseerv));
  srw.set_attr(0, SRW.ATTR);
  return (TRUE);
end;


PRINTER_INTRAY

  Exemples 	  Restrictions	  Rubriques connexes	 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_PRINTER_TRAY. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description  Permet d'indiquer le nom d'un plateau d'imprimante valide à utiliser pour imprimer un état dans un format différent.

Valeurs

Un nom unique et valide défini dans la boîte de dialogue de mise en page pour votre imprimante.


PRINTER_INTRAY - Restrictions

•	PRINTER_INTRAY ne doit être défini que dans les déclencheurs suivants :

Between Pages

Before Report

Format

•	La valeur définie pour PRINTER_INTRAY est ignorée lorsque la sortie des états est effectuée sur une imprimante PCL fonctionnant sous Motif.


PRINTER_INTRAY - Exemple

  Rubriques connexes 	  Tous les exemples

Remarque : Cet exemple illustre l'utilisation de SRW.SET ATTR pour définir l'attribut PRINTER_INTRAY. Il est désormais plus judicieux de le définir via la procédure SRW.SET_PRINTER_TRAY. La définition de cet attribut via SRW.SET_ATTR est toujours prise en charge pour des raisons de compatibilité, mais il est fortement recommandé d'utiliser la nouvelle procédure, plus simple.

/* L'exemple ci-dessous définit le plateau d'imprimante dans le déclencheur Between Pages.
*/

function BetweenPages return boolean is
begin
   srw.attr.mask             := SRW.PRINTER_INTRAY_ATTR;
   srw.attr.printer_intray   := 'letterhead';
   srw.set_attr(SRW.REPORT_ID, srw.attr);
return (TRUE);
end;


STYLE

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_FONT_STYLE. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer le style de la police du champ CHAR, DATE ou NUMBER. Cet attribut n'est pas pris en compte dans les états bitmap.

Valeurs

srw.plain_style

srw.italic_style

srw.oblique_style

srw.underline_style

srw.outline_style

srw.shadow_style

srw.inverted_style

srw.overstrike_style

srw.blink_style


SZ

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_FONT_SIZE. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer la taille des caractères du champ CHAR, DATE ou NUMBER. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

Taille valide pour la police spécifiée sur la machine sur laquelle sera exécuté l'état.


TEXT

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_CHARMODE_TEXT. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer les caractéristiques du texte en mode caractère du champ CHAR, DATE ou NUMBER. Cet attribut n'est pas pris en compte dans les états bitmap.

Valeurs

srw.plain_texta

srw.reverse_texta

srw.bold_texta

srw.reversebold_texta

srw.underline_texta

srw.underlinereverse_texta

srw.underlinebold_texta

srw.reverseboldunderline_texta


WEIGHT

 Attributs SRW.SET_ATTR

Nouvelle fonction : Il est maintenant plus pratique de définir cet attribut à l'aide de la procédure SRW.SET_FONT_WEIGHT. La définition de cet attribut via SRW.SET_ATTR est encore prise en charge pour des raisons de compatibilité. Il est toutefois fortement recommandé de faire appel à la nouvelle procédure simplifiée.

Description Permet d'indiquer l'épaisseur des caractères du champ CHAR, DATE ou NUMBER. Cet attribut n'est pas pris en compte en mode caractère.

Valeurs

srw.ultralight_weight

srw.extralight_weight

srw.light_weight

srw.demilight_weight

srw.medium_weight

srw.demibold_weight

srw.bold_weight

srw.extrabold_weight


Un programme autonome ou complémentaire, tel que Adobe Acrobat Reader, qui vous permette d'afficher vos fichiers PDF.


Explorateur conforme à HTML 3.0 (par exemple, Netscape 2.2).


SRW.FILE_ESCAPE

Permet d'indiquer que la commande HTML se trouve dans un fichier. Lorsque vous indiquez SRW.FILE_ESCAPE, vous devez entrer un nom de fichier pour SRW.xxxx_ESCAPE_VALUE (où xxxx est le nom de l'échappement, par exemple BEFREPORT).


SRW.TEXT_ESCAPE

Permet d'indiquer que la commande HTML est spécifiée dans SRW.xxxx_ESCAPE_VALUE (où xxxx est le nom de l'échappement, par exemple BEFREPORT). Lorsque vous spécifiez SRW.TEXT_ESCAPE, vous devez entrer pour SRW.xxxx_ESCAPE_VALUE une chaîne entre guillemets.


Si la propriété Ordre d'impression écran a pour valeur Diag/bas, l'ordre d'impression des pages physiques pour chaque page logique sera le suivant :


Package Report Builder PL/SQL (SRW)

Pour vous permettre de gagner du temps, Report Builder est livré avec un package - c'est-à-dire un ensemble de structures de code PL/SQL - qui contient de nombreuses fonctions, procédures et exceptions que vous pouvez appeler dans vos bibliothèques ou vos états. Le package Report Builder s'appelle SRW. Chaque fois que vous faites référence à un élément de ce package, vous devez donc le faire précéder de SRW. Par exemple, SRW.DO_SQL.

Remarque : Vous ne pouvez pas faire référence à des éléments du package SRW à partir d'un autre produit, par exemple à partir de SQL*Plus.

Les structures de code d'un package sont généralement dites "en package" : fonctions en package, procédures en package et exceptions en package.

 Procédures, fonctions, et exceptions en package SRW


SRW.ADD_DEFINITION

  Rubriques connexes	  Toutes les procédures internes

Description  Cette procédure lit une définition d'état XML stockée dans une colonne ou dans une variable, et l'ajoute au tampon de document. Vous pouvez avoir besoin d'exécuter SRW.ADD_DEFINITION plusieurs fois pour ajouter l'intégralité de la définition de l'état au tampon. Une fois la définition stockée dans le tampon, vous pouvez utiliser SRW.APPLY_DEFINITION pour l'appliquer.

Syntaxe

SRW.ADD_DEFINITION(:nom_colonne | variable);

Notes d'utilisation

•	Pour appliquer la définition d'état XML, utilisez la procédure interne SRW.APPLY_DEFINITION. Par exemple :

srw.add_definition (:xml_col);
srw.apply_definition;

•	Si la définition de l'état XML se trouve dans un fichier, utilisez uniquement SRW.APPLY_DEFINITION pour référencer le fichier. Par exemple :

srw.apply_definition('d:\xml_reps\web.xml');


SRW.APPLY_DEFINITION

  Rubriques connexes	  Toutes les procédures internes

Description  Cette procédure lit une définition d'état XML stockée dans le tampon de document ou dans le système de fichiers, et l'applique à l'état. Si cette définition provient du tampon de document, SRW.APPLY_DEFINITION ne requiert aucun argument. Si elle provient d'un fichier, SRW.APPLY_DEFINITION requiert le nom et le chemin du fichier comme argument.

Syntaxe

SRW.APPLY_DEFINITION[(nomfichier.xml)];

Notes d'utilisation

•	Pour appliquer plusieurs définitions d'état XML, empilez des instructions SRW.APPLY_DEFINITION distinctes dans l'ordre voulu.

•	Si la définition de l'état XML se trouve dans un fichier, utilisez uniquement SRW.APPLY_DEFINITION pour référencer le fichier. Par exemple :

srw.apply_definition('d:\xml_reps\web.xml');

•	Pour appliquer une définition d'état XML provenant du tampon de document, vous devez utiliser au préalable SRW.ADD_DEFINITION pour placer cette définition dans le tampon. Par exemple :

srw.add_definition (:xml_col);
srw.apply_definition;


SRW.BREAK

  Restrictions	  Rubriques connexes	  Toutes les procédures internes

Description Cette procédure arrête momentanément l'exécution de l'état à l'endroit où SRW.BREAK a été détecté et affiche (en lecture seule) les valeurs de toutes les colonnes et de tous les paramètres. L'exécution de l'état reprend lorsque l'écran en lecture seule est accepté.

Syntaxe

SRW.BREAK;


SRW.BREAK - Restrictions

•	Cette procédure n'est pas significative dans un déclencheur Before Form ou After Form, car les données de l'état ne sont introduites qu'au stade du déclencheur Before Report (qui est activé après le déclencheur After Form).

•	Toutes les valeurs de colonne et de paramètre sont affichées sur l'écran en lecture seule. Aucune variable PL/SQL ou autre valeur d'objet n'est affichée.


SRW.CONTEXT_FAILURE

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette exception arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1426: Procédure <nom de l'élément> exécutée à partir d'un contexte incorrect.

Syntaxe

SRW.CONTEXT_FAILURE;

Notes d'utilisation Report Builder génère cette exception lorsqu'une procédure ou une fonction Report Builder en package est appelée dans un contexte erroné (voir le tableau ci-après).

Dans ce tableau, NON indique que la fonction ou la procédure ne peut pas être appelée dans ce contexte et OUI qu'elle peut l'être.

Propriété Nom	Grille paramètre	Modèle données	Déclencheur format	Déclencheur état
srw.break	NO	YES	YES	NO
srw.do_sql	YES	YES	YES	YES
srw.geterr_run	YES	YES	YES	YES
srw.get_page_num	NO	NO	YES	NO
srw.message	YES	YES	YES	YES
srw.référence	YES	YES	YES	YES
srw.run_report	YES	YES	YES	YES
srw.set_attr	NO	NO	YES	NO
srw.set_field_char	NO	NO	YES	NO
srw.set_field_date	NO	NO	YES	NO
srw.set_field_num	NO	NO	YES	NO
srw.set_maxrow	NO	YES	YES	YES
srw.user_exit	YES	YES	YES	YES


SRW.CONTEXT_FAILURE - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez remplacer le message d'erreur
** par défaut par votre propre message d'erreur.
** Vous pourriez traiter cette exception de la manière suivante :
*/

EXCEPTION

when SRW.CONTEXT_FAILURE then

  srw.message(4000, 'Interroger le groupe Développement

    d'applications concernant SRW.CONTEXT_FAILURE.');

  raise srw.program_abort;


SRW.DO_SQL

  Restrictions	  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette procédure exécute l'instruction SQL spécifiée à partir de Report Builder. L'instruction SQL peut être de type DDL (instructions qui définissent des données) ou DML (instructions qui manipulent des données). Les instructions DML sont généralement plus rapides lorsqu'elles sont dans PL/SQL et non dans SRW.DO_SQL.

Comme vous ne pouvez pas exécuter d'instructions DDL dans PL/SQL, la procédure en package SRW.DO_SQL est particulièrement utile pour les exécuter à partir de Report Builder, et non par l'intermédiaire d'une sortie utilisateur. Pour plus d'informations sur les instructions DDL ou DML, reportez-vous à ORACLE8 Server SQL Language Reference Manual.

Syntaxe

SRW.DO_SQL (instruction_sql CHAR);

Paramètres

instruction_sql	Toute instruction SQL valide. N'oubliez pas de faire précéder les noms d'objet de Report Builder du signe deux-points (:).


SRW.DO_SQL - Restrictions

•	Dans Ordre d'exécution des déclencheurs d'état, notez l'endroit où figure SET TRANSACTION READONLY.

•	Une variable de lien ne peut pas avoir plus de 64 000 octets. (Au-delà, elle est tronquée à 64 000 octets).

•	Si vous utilisez un paramètre comme destination d'une colonne de caractères pour une clause INTO, vous devez veiller à ce que le paramètre soit suffisamment large pour contenir les valeurs sectionnées. Prenons par exemple l'instruction SRW.DO_SQL ci-dessous : le paramètre de destination (mon_nome) doit avoir une largeur égale à la largeur maximum de la colonne NOME, car la valeur sélectionnée contient des espaces jusqu'à la taille présumée de la valeur. Si le paramètre n'est pas suffisamment large, vous aurez une expression tronquée. Si vous n'êtes pas certain de la largeur maximum de l'élément de liste SELECT, utilisez la valeur 2000 pour le paramètre.

srw.do_sql('SELECT NOME INTO :mon_nome FROM EMP');


SRW.DO_SQL - Exemple

  Rubriques connexes 	  Tous les exemples

/* Suppose que vous vouliez qu'un état crée une table appelée VERIF
** juste avant l'affichage de la grille de paramètres d'exécution.
** Etant donné que CREATE TABLE est une instruction SQL (et que PL/SQL
** ne peut pas exécuter d'instructions DDL), vous devez utiliser SRW.DO_SQL.
** Votre PL/SQL pourrait donc, dans le déclencheur Before Form,se présenter comme indiqué ci-dessous :
*/

/* Informations complémentaires : si vous utilisez pour votre sortie d'état
** une table créée de la sorte, celle-ci doit exister avant la création de votre interrogation dans le
** modèle de données.Sinon, Report Builder ne pourrait pas analyser votre interrogation.
*/

FUNCTION CREATETAB RETURN BOOLEAN IS

BEGIN

SRW.DO_SQL('CREATE TABLE CHECK (EMPNO NUMBER NOT NULL

            PRIMARY KEY, SAL NUMBER (10,2)) PCTFREE 5

            PCTUSED 75');

RETURN(TRUE);

EXCEPTION

WHEN SRW.DO_SQL_FAILURE THEN

 SRW.MESSAGE(100, 'ERREUR PENDANT LA CREATION DE LA TABLE VERIF.');

 SRW.MESSAGE(50, 'ARRET DE L'ETAT AVANT LA GRILLE DE PARAMETRES

 D'EXECUTION.');

 RAISE SRW.PROGRAM_ABORT;

END;

/* Supposons que vous vouliez créer une "table des matières" en utilisant
** le premier caractère de la valeur d'une colonne, et le numéro de page
** sur lequel son champ s'active pour impression. Supposons en outre que vous vouliez
** entrer la "table des matières" dans une table appelée BATEAU.Pour cela, vous pourriez écrire :
*/

DECLARE

  PAGE_NON      NUMBER;

  PAGE_FOR     INDEX NUMBER;

  SORT_CHAR    CHAR(1);

  CMD_LINE     CHAR(200);

BEGIN

  SORT_CHAR := :SORT_NAME ;

  IF :CALLED = 'Y' THEN

    SRW.GET_PAGE_NUM(PAGE_FOR_INDEX);

    SRW.USER_EXIT('RWECOP PAGE_FOR_INDEX

                   P_START_PAGENO');

    SRW.MESSAGE(2,TO_CHAR(:P_START_PAGENO));

  END IF;

  SRW.GET_PAGE_NUM(PAGE_NON);

  CMD_LINE := 'INSERT INTO SHIP VALUES

       ('''||SORT_CHAR||''','||TO_CHAR(PAGE_NO)||')';

  SRW.MESSAGE(2,CMD_LINE);

  SRW.DO_SQL(CMD_LINE);

  COMMIT;

EXCEPTION

  WHEN DUP_VAL_ON_INDEX THEN

       NULL;

  WHEN SRW.DO_SQL_FAILURE THEN

       SRW.MESSAGE(1,'IMPOSSIBLE D'INSERER LA LIGNE DANS LA

TABLE MAISON');

  WHEN OTHERS THEN

       COMMIT;

END;


SRW.DO_SQL_FAILURE

  Exemples	  Rubriques connexes	  Tous les packages intégrés

Description Cette exception arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1425: Erreur au cours de l'exécution du package DO_SQL - msg_REP msg_ORA

où :

msg_REP	Est un message Report Builder.

msg_ORA	Est un message ORACLE facultatif, qui fournit des informations complémentaires sur le message de Report Builder.

Syntaxe

SRW.DO_SQL_FAILURE;

Notes d'utilisation Report Builder génère cette exception lorsque la procédure en package SRW.DO_SQL échoue (c'est-à-dire lorsque l'utilisateur n'a pas de privilèges DDL, mais tente cependant de créer une table avec SRW.DO_SQL).


SRW.DO_SQL_FAILURE - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez remplacer le message d'erreur
** par défaut par votre propre message d'erreur.
** Vous pourriez traiter cette exception de la manière suivante :
*/

EXCEPTION

when SRW.DO_SQL_FAILURE then

   srw.message(1000, 'Erreur au cours de la création de la

               table VERIF.');


SRW.GETERR_RUN

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette fonction retourne un message d'erreur si Report Builder détecte une erreur pendant l'exécution de la procédure SRW.RUN_REPORT.

Syntaxe

SRW.GETERR_RUN;

Retourne Un message d'erreur.


SRW.GETERR_RUN - Exemples

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez envoyer certaines parties d'un état à des utilisateurs par Oracle*Mail.
** Pour plus d'informations, reportez-vous à "SRW.RUN_REPORT". Supposons
** en outre que si SRW.RUN_REPORT échoue, vous vouliez afficher un message
** expliquant la raison de l'échec. Votre PL/SQL pourrait se présenter de la manière suivante :
*/

BEGIN

DECLARE TMP CHAR(100);

  begin

     srw.run_report('batch=yes report=send.rdf

     destype=file desname=send.lis desformat=dflt');

  exception when srw.run_report_failure then

     tmp := srw.geterr_run;

     srw.message(1000, tmp);

  end;

END;


SRW.GET_PAGE_NUM

  Restrictions	  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette procédure retourne le numéro de la page en cours, ce qui est utile lorsque vous voulez l'utiliser dans la propriété Déclencheur de format du champ.

Syntaxe

SRW.GET_PAGE_NUM (page_num);

Paramètres

n° de page	Variable dans laquelle vous voulez entrer le numéro de la page en cours.
Retourne	 Le numéro de la page en cours.


SRW.GET_PAGE_NUM - Restrictions

•	SRW.GET_PAGE_NUM n'a de signification que dans un déclencheur de format et est sans effet lorsqu'il est entré ailleurs.


SRW.GET_PAGE_NUM - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez exécuter un calcul basé sur un numéro de page.
** Dans le déclencheur de format du champ, vous pourriez utilisez la fonction SRW.GET_PAGE_NUM :
*/

BEGIN

DECLARE PAGE_NUM NUMBER;

  begin

     srw.get_page_num (num_page);

     srw.set_field_num (0, num_page + 3);

  end;

END;


Procédures de définition d'attributs

  Restrictions	  Rubriques connexes	  Toutes les procédures internes

SRW.SET_AFTER_FORM_HTML

SRW.SET_AFTER_PAGE_HTML

SRW.SET_AFTER_PRINTING_CODE

SRW.SET_AFTER_REPORT_HTML

Attributs SRW.SET_ATTR

SRW.SET_BACKGROUND_BORDER_COLOR

SRW.SET_BACKGROUND_FILL_COLOR

SRW.SET_BEFORE_FORM_HTML

SRW.SET_BEFORE_PAGE_HTML

SRW.SET_BEFORE_PRINTING_CODE

SRW.SET_BEFORE_REPORT_HTML

SRW.SET_BOOKMARK

SRW.SET_BORDER_PATTERN

SRW.SET_BORDER_WIDTH

SRW.SET_CHARMODE_TEXT

SRW.SET_CUSTOM_SPACING

SRW.SET_DISPLAY_NAME

SRW.SET_FIELD

SRW.SET_FIELD_CHAR

SRW.SET_FIELD_DATE

SRW.SET_FIELD_NUM

SRW.SET_FILL_PATTERN

SRW.SET_FONT_FACE

SRW.SET_FONT_SIZE

SRW.SET_FONT_STYLE

SRW.SET_FONT_WEIGHT

SRW.SET_FOREGROUND_BORDER_COLOR

SRW.SET_FOREGROUND_FILL_COLOR

SRW.SET_FORMAT_MASK

SRW.SET_HYPERLINK

SRW.SET_HYPERLINK_ATTRS

SRW.SET_JUSTIFICATION

SRW.SET_LINKTAG

SRW.SET_MAXROW

SRW.SET_PAGE_NAVIGATION_HTML

SRW.SET_PDF_ACTION

SRW.SET_PRINTER_TRAY

SRW.SET_SPACING

SRW.SET_TEXT_COLOR


SRW.SET_AFTER_FORM_HTML

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure insère du texte, des graphiques ou des commandes HTML que vous voulez faire apparaître au bas de la Grille de paramètres HTML. Cet attribut est utile pour placer un logo ou des liens standard sur la Grille de paramètres.

Syntaxe

SRW.SET_AFTER_FORM_HTML(type,'string');

Paramètres

type	SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE. Indique si le paramètre string représente un nom de fichier ou le texte à insérer.
String	Nom de fichier ou texte à insérer, selon ce qui est indiqué par le paramètre type.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez les propriétés Type Après formulaire et Valeur Après formulaire.


SRW.SET_AFTER_FORM_HTML - Exemple

  Rubriques connexes 	  Tous les exemples

/* Cet exemple insère deux liens aux pages d'accueil
** en bas de la Grille de paramètres HTML.
*/

function BeforeForm return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.SET_AFTER_FORM_HTML(SRW.TEXT_ESCAPE,'<CENTER>' ||
  '<A HREF="http://www.oracle.com/">' ||
  'Oracle Corporation</A> -' ||
  '<BR>' ||
  '<A HREF="http://home.netscape.com/">' ||
  'Netscape</A> </CENTER>' ||
  '</BODY> </HTML>');
end if;
return (TRUE);
end;


SRW.SET_AFTER_PAGE_HTML

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description Cette procédure insère du texte, des graphiques ou des commandes HTML que vous voulez faire apparaître à la fin des pages de votre document. Cet attribut est utile pour placer un logo ou des liens standard à la fin de chaque page d'un document HTML.

Si vous utilisez la sortie au format page HTML, cette procédure s'applique à toutes les pages de votre sortie d'état. Pour n'indiquer le format HTML que pour la première page (page d'en-tête) ou la dernière (page de fin) de votre état, utilisez respectivement les procédures PL/SQL SRW.SET_BEFORE_REPORT_HTML et SRW.SET_AFTER_REPORT_HTML.

Syntaxe

SRW.SET_AFTER_PAGE_HTML(type,'string');

Paramètres

type	SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE. Indique si le paramètre string représente un nom de fichier ou le texte à insérer.
chaîne	Nom de fichier ou texte à insérer, selon ce qui est indiqué par le paramètre type.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez les propriétés Type Après page et Valeur Après page.


SRW.SET_AFTER_PAGE_HTML - Restrictions

•	Le code HTML par défaut inclus au bas d'une page est indiqué ci-après. Il n'est obligatoire que si vous voulez que la ligne de séparation par défaut apparaisse entre les pages.

   <hr size=5 noshade>

•	Si vous voulez que SRW.SET_AFTER_PAGE_HTML s'applique à toutes les pages de l'état, vous devez l'indiquer dans un déclencheur qui se déclenche avant le début de la mise en forme de l'état, comme par exemple le déclencheur Before Report.

•	Si vous voulez que SRW.SET_AFTER_PAGE_HTML ne s'applique qu'à la page courante, vous devez l'indiquer dans un déclencheur de format pour un objet de cette page.


SRW.SET_AFTER_PAGE_HTML - Exemple

  Rubriques connexes 	  Tous les exemples

/* L'exemple ci-dessous insère un fichier GIF
** comme séparateur de page.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
 SRW.SET_AFTER_PAGE_HTML(SRW.TEXT_ESCAPE,'<CENTER>' ||
 '<IMG ALT="Ruler" SRC="line.gif" VSPACE=10>' ||
 '<BR></CENTER>');
end if;
return (TRUE);
end;


SRW.SET_AFTER_PRINTING_CODE

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure insère une référence à la séquence d'échappement de l'imprimante, à exécuter après chaque ligne de l'objet. La séquence d'échappement de l'imprimante est insérée après que l'objet est déclenché pour impression mais avant qu'il soit effectivement imprimé. Les codes d'imprimante ne sont utilisés que lors de l'exécution de votre état en mode caractère.

Syntaxe

SRW.SET_AFTER_PRINTING_CODE('code');

Paramètres

code	Code d'imprimante valide défini dans le fichier .prt indiqué pour DESFORMAT.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez la propriété Code d'imprimante après.


SRW.SET_AFTER_REPORT_HTML

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description Cette procédure insère du texte, des graphiques ou des commandes HTML que vous voulez faire apparaître à la fin de votre document. Cet attribut est utile pour placer un logo ou des liens standard à la fin d'un document HTML.

Si vous utilisez la sortie au format page HTML, cette procédure s'applique à la première page de la sortie de votre état. Pour indiquer que le format HTML doit être appliqué à l'intégralité de l'état (par exemple, une couleur d'arrière-plan ou des images, ou tout autre attribut <body> HTML), vous devez utiliser la procédure PL/SQL SRW.SET_BEFORE_PAGE_HTML.

Syntaxe

SRW.SET_AFTER_REPORT_HTML(type,'string');

Paramètres

type	SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE. Indique si le paramètre string représente un nom de fichier ou le texte à insérer.
chaîne	Nom de fichier ou texte à insérer, selon ce qui est indiqué par le paramètre type.
Palette de propriétés Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez les propriétés Type après état et Valeur après état.


SRW.SET_AFTER_REPORT_HTML - Restrictions

•	Le code HTML par défaut inclus à la fin d'un état est indiqué ci-après. Si vous utilisez SRW.SET_AFTER_REPORT_HTML pour remplacer ce texte, vous devez vous assurer qu'il contient les commandes HTML équivalentes.

   </body></html>

•	SRW.SET_AFTER_REPORT_HTML doit être défini dans un déclencheur qui se déclenche avant la fin de la mise en forme de l'état, comme par exemple le déclencheur Before Report.


SRW.SET_AFTER_REPORT_HTML - Exemple

  Rubriques connexes 	  Tous les exemples

/* L'exemple ci-dessous insère deux liens vers des
** pages d'accueil à la fin de la sortie de l'état.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.SET_AFTER_REPORT_HTML(SRW.TEXT_ESCAPE,'<CENTER>' ||
  '<A HREF="http://www.oracle.com/">' ||
  'Oracle Corporation</A> -' ||
  chr(10) ||
  '<A HREF="http://home.netscape.com/">' ||
  'Netscape</A> </CENTER>' ||
  '</BODY> </HTML>');
end if;
return (TRUE);
end;


SRW.SET_BACKGROUND_BORDER_COLOR

  Procédures de définition d'attributs [image]  Rubriques connexes	  Toutes les procédures internes

Description  Cette procédure indique la couleur d'arrière-plan de la bordure de l'objet. Cet attribut est ignoré en mode caractère. Selon le motif utilisé, vous ne verrez peut-être pas la couleur d'arrière-plan. Par exemple, si le motif est plein, la couleur d'arrière-plan n'apparaît pas au travers. Dans ce cas, seule la couleur de premier plan apparaît.

Syntaxe

SRW.SET_BACKGROUND_BORDER_COLOR('color');

Paramètres

color	Couleur valide de la palette de couleurs.
Notes d'utilisation

•	Cette procédure ne s'applique pas aux plates-formes Windows, car celles-ci ne prennent pas en charge les motifs de bordure. Par conséquent, la couleur de premier plan de la bordure est la seule visible sous Windows.

Palette de propriétés (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Couleur d'arrière-plan du bord.

Interface utilisateur Pour définir la couleur d'arrière-plan de la bordure dans l'interface utilisateur, reportez-vous à Modification des couleurs.


SRW.SET_BACKGROUND_FILL_COLOR

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique la couleur d'arrière-plan de remplissage de l'objet. Cet attribut est ignoré en mode caractère. Selon le motif utilisé, vous ne verrez peut-être pas la couleur d'arrière-plan. Par exemple, si le motif est plein, la couleur d'arrière-plan n'apparaît pas au travers. Dans ce cas, seule la couleur de premier plan apparaît.

Syntaxe

SRW.SET_BACKGROUND_FILL_COLOR('color');

Paramètres

color	Couleur valide de la palette de couleurs.
Palette de propriétés (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Couleur d'arrière-plan du bord.

Interface utilisateur  Pour définir la couleur d'arrière-plan de remplissage dans l'interface utilisateur, reportez-vous à Modification des couleurs.


SRW.SET_BEFORE_FORM_HTML

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure insère du texte, des graphiques ou des commandes HTML que vous voulez faire apparaître en haut de la Grille de paramètres HTML. Cet attribut est utile pour placer un logo ou des liens standard sur la Grille de paramètres.

Syntaxe

SRW.SET_BEFORE_FORM_HTML(type,'string');

Paramètres

type	SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE. Indique si le paramètre string représente un nom de fichier ou le texte à insérer.
String	Nom de fichier ou texte à insérer, selon ce qui est indiqué par le paramètre type.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez les propriétés Type Avant formulaire et Valeur Avant formulaire.


SRW.SET_BEFORE_FORM_HTML - Exemple

  Rubriques connexes 	  Tous les exemples

/* L'exemple ci-dessous définit les séquences d'échappement
** Avant formulaire et Après formulaire dans le déclencheur Before Form.
** Dans le cas de Before (Avant), le code HTML est
** situé dans un fichier appelé logo.htm. Dans le cas de
** After (Après), le code HTML est indiqué dans la procédure PL/SQL.
*/

function BeforeForm return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.SET_BEFORE_FORM_HTML(SRW.FILE_ESCAPE,'logo.htm');
  SRW.SET_AFTER_FORM_HTML(SRW.TEXT_ESCAPE, <B> ||
  '<FONT FACE=«Arial, Helvetica»>' ||
  '<FONT COLOR="#FF0000">' ||
  'Cliquez sur <IMG SRC=»RUN.GIF» HEIGHT=18 WIDTH=18>' ||
  'pour exécuter l'état à l'aide des paramètres ' ||
  'indiqués ci-dessus. ' ||
  '</FONT></FONT></B>');
end if;
return (TRUE);
end;


SRW.SET_BEFORE_PAGE_HTML

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description Cette procédure insère du texte, des graphiques ou des commandes HTML que vous voulez faire apparaître au début des pages de votre document. Cet attribut est utile pour placer un logo ou des liens standard au début de chaque page d'un document HTML.

Si vous utilisez la sortie au format page HTML, cette procédure s'applique à toutes les pages de la sortie de votre état (par exemple, une couleur d'arrière-plan ou des images, ou tout autre attribut <body> HTML). Pour n'indiquer le format HTML que pour la première page (page d'en-tête) ou la dernière (page de fin) de votre état, utilisez respectivement les procédures PL/SQL SRW.SET_BEFORE_REPORT_HTML et SRW.SET_AFTER_REPORT_HTML.

Syntaxe

SRW.SET_BEFORE_PAGE_HTML(type,'string');

Paramètres

type	SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE. Indique si le paramètre string représente un nom de fichier ou le texte à insérer.
chaîne	Nom de fichier ou texte à insérer, selon ce qui est indiqué par le paramètre type.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez les propriétés Type Avant page et Valeur Avant page.


SRW.SET_BEFORE_PAGE_HTML - Restrictions

•	Si vous voulez que SRW.SET_BEFORE_PAGE_HTML s'applique à toutes les pages de l'état, vous devez l'indiquer dans un déclencheur qui se déclenche avant le début de la mise en forme de l'état, comme par exemple le déclencheur Before Report.

•	Si vous voulez que SRW.SET_ BEFORE _PAGE_HTML ne s'applique qu'à la page courante, vous devez l'indiquer dans un déclencheur de format pour un objet de cette page.


SRW.SET_BEFORE_PAGE_HTML - Exemple

  Rubriques connexes 	  Tous les exemples

/* L'exemple ci-dessous centre le document
** dans le navigateur.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.SET_BEFORE_PAGE_HTML(SRW.TEXT_ESCAPE,'<CENTER>');
  SRW.SET_AFTER_PAGE_HTML(SRW.TEXT_ESCAPE,'</CENTER>');
end if;
return (TRUE);
end;


SRW.SET_BEFORE_PRINTING_CODE

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure insère une référence à la séquence d'échappement de l'imprimante, à exécuter avant chaque ligne de l'objet. La séquence d'échappement de l'imprimante est insérée après que l'objet est déclenché pour impression mais avant qu'il soit effectivement imprimé. Les codes d'imprimante ne sont utilisés que lors de l'exécution de votre état en mode caractère.

Syntaxe

SRW.SET_BEFORE_PRINTING_CODE('code');

Paramètres

code	Code d'imprimante valide défini dans le fichier .prt indiqué pour DESFORMAT.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez la propriété Code d'imprimante avant.


SRW.SET_BEFORE_REPORT_HTML

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description Cette procédure insère du texte, des graphiques ou des commandes HTML que vous voulez faire apparaître au début de votre document. Cet attribut est utile pour placer un logo ou des liens standard au début d'un document HTML..

Si vous utilisez la sortie au format page HTML, cette procédure s'applique à la première page de la sortie de votre état. Pour indiquer que le format HTML doit être appliqué à l'intégralité de l'état (par exemple, une couleur d'arrière-plan ou des images, ou tout autre attribut <body> HTML), vous devez utiliser la procédure PL/SQL SRW.SET_BEFORE_PAGE_HTML.

Syntaxe

SRW.SET_BEFORE_REPORT_HTML(type,'string');

Paramètres

type	SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE. Indique si le paramètre string représente un nom de fichier ou le texte à insérer.
String	Nom de fichier ou texte à insérer, selon ce qui est indiqué par le paramètre type.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez les propriétés Type Avant état et Valeur Avant état.


SRW.SET_BEFORE_REPORT_HTML - Restrictions

•	Le code HTML par défaut inclus au début d'un état est indiqué ci-après. Si vous utilisez SRW.SET_BEFORE_REPORT_HTML pour remplacer ce texte, vous devez vous assurer qu'il contient les commandes HTML équivalentes.

   <html>
   <body bgcolor="#ffffff">

•	SRW.SET_BEFORE_REPORT_HTML doit être défini dans un déclencheur qui se déclenche avant la fin de la mise en forme de l'état, comme par exemple le déclencheur Before Report.


SRW.SET_BEFORE_REPORT_HTML - Exemple

  Rubriques connexes 	  Tous les exemples

/* L'exemple ci-dessous définit les séquences d'échappement avant
** et après l'état dans le déclencheur Before Report.
** Le code HTML de la séquence avant l'état se trouve dans un
** fichier appelé logo.htm. Le code HTML de la séquence après
** l'état est indiqué dans le code PL/SQL lui-même.
*/

function BeforeReport return boolean is
begin
if ((upper(:MODE) != 'CHARACTER') and
    (upper(:DESFORMAT) = 'HTML')) then
  SRW.SET_BEFORE_REPORT_HTML(SRW.FILE_ESCAPE,'logo.htm');
  SRW.SET_AFTER_REPORT_HTML(SRW.TEXT_ESCAPE,'<ADDRESS>' ||
  ' Questions? - ' ||
  '<A HREF=mailto:webmaster@xyztech.com>' ||
  'webmaster@xyztech.com</A>' ||
  '</ADDRESS>' ||
  '</body></html>');
end if;
return (TRUE);
end;


SRW.SET_BOOKMARK

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure associe un signet à l'objet et indique une chaîne qui apparaîtra dans un cadre de signet du document HTML maître ou dans le document PDF. Si vous ouvrez la zone des signets et que vous cliquez sur le signet, l'objet apparaît en haut de la fenêtre.

Syntaxe

SRW.SET_BOOKMARK('bookmark');

Paramètres

bookmark	Un des éléments suivants : • Chaîne de texte sans informations d'indentation ni de séquence. Le signet apparaît dans la liste des signets selon le moment où l'objet est rendu par l'état. • Une chaîne de texte avec indentation et classement se présentant sous la forme x#nom_signet, où x est un numéro d'ordre. Le signe Numéro (#) et le numéro d'ordre ne doivent pas apparaître dans la fenêtre signet, mais sont utilisés pour déterminer le classement et le retrait. Par exemple : 1#Expense Summary Section  2#Expense Detail Section 2.1#Expenses for the Administration Department 2.2#Expenses for the Engineering Department 2.3#Expenses for the Sales Department 2.3.1#Expenses for the Eastern Sales Region 2.3.2#Expenses for the Northern Sales Region 2.3.3#Expenses for the Southern Sales Region 2.3.4#Expenses for the Western Sales Region
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez la propriété Signet.


SRW.SET_BOOKMARK - Restrictions

•	Si vous utilisez plusieurs fois le même numéro, toutes les entrées apparaissent, mais leur ordre est défini par le stade auquel les objets sont rendus par l'état.

•	S'il y a des "trous" dans les numéros, de deux choses l'une : si le trou se trouve entre des numéros de niveau pair, il n'y aura aucun effet visible (par exemple, 1.3.1 et 1.3.3, comme il n'y a pas de 1.3.2, apparaîtront côte à côte et au même niveau d'indentation). Si le trou se trouve entre un numéro de niveau supérieur à un numéro de niveau inférieur, les niveaux intermédiaires seront générés (par exemple, 1.1 suivi de 2.1.1 entraînera la définition des entrées factices 2 et 2.1, dont les titres seront identiques à ceux de l'entrée réelle suivante).

•	SRW.SET_BOOKMARK ne doit être définie que dans les déclencheurs suivants :

Format


SRW.SET_BOOKMARK - Exemple

  Rubriques connexes 	  Tous les exemples

/* Le déclencheur de format ci-dessous définit un signet pour
** l'objet texte standard B_2. Notez l'utilisation d'informations
** explicites de classement (1#) dans cet exemple.
** Si vous ne voulez pas d'informations de classement, vous pouvez
** omettre 1#.
*/

function B_2FormatTrigger return boolean is
begin
  srw.set_bookmark('1#Expense Summary Section');
  return (TRUE);
end;


SRW.SET_BOOKMARK dynamique - Exemple

  Rubriques connexes 	  Tous les exemples

/* Le déclencheur de format ci-dessous définit un signet pour
** l'objet texte standard B_2. Le nom du signet
** est dynamique. CATEGORY est une valeur de colonne
** concaténée avec la chaîne Expense Summary Section pour
** chaque exécution du déclencheur de format.
** Dans ce cas, CATEGORY peut contenir des informations
** de classement (par exemple, 1#) ou éventuellement une
** chaîne qui rend le signet unique dans l'état.
*/

function B_2FormatTrigger return boolean is
begin
  srw.set_bookmark(:category ||
  ' Expense Summary Section');
  return (TRUE);
end;


SRW.SET_BORDER_PATTERN

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique le motif de remplissage de la bordure de l'objet. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_BORDER_PATTERN('pattern');

Paramètres

pattern	Motif de remplissage de la bordure (par exemple, plein).
Notes d'utilisation

•	Cette procédure ne s'applique pas aux plates-formes Windows, car celles-ci ne prennent pas en charge les motifs de bordure.

Palette de propriétés  (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Motif du bord.

Interface utilisateur  Pour définir les attributs de bordure dans l'interface utilisateur, reportez-vous à Modification des attributs de bordure d'objet .


SRW.SET_BORDER_WIDTH

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique la largeur de la bordure de l'objet, exprimée en picas.

Syntaxe

SRW.SET_BORDER_WIDTH(width);

Paramètres

Largeur	Zéro ou un entier positif. Zéro indique aucune bordure et un entier positif donne la largeur de la bordure en picas.
Interface utilisateur  Pour définir les attributs de bordure dans l'interface utilisateur, reportez-vous à Modification des attributs de bordure d'objet .


SRW.SET_CHARMODE_TEXT

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique le style de police d'un champ CHAR, DATE ou NUMBER. Cet attribut est ignoré dans les états en mode bitmap.

Syntaxe

SRW.SET_CHARMODE_TEXT('style');

Paramètres

style	Un des paramètres suivants :   SRW.REVERSE_TEXTA SRW.BOLD_TEXTA SRW.REVERSEBOLD_TEXTA SRW.UNDERLINE_TEXTA SRW.UNDERLINEREVERSE_TEXTA SRW.REVERSEBOLDUNDERLINE_TEXTA SRW.PLAIN_TEXTA
Interface utilisateur  Pour définir les attributs de police dans l'interface utilisateur, reportez-vous à Modification des attributs de texte.


SRW.SET_CUSTOM_SPACING

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique le retrait du texte global d'un champ CHAR, DATE ou NUMBER, ou pour du texte standard. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_CUSTOM_SPACING(spacing);

Paramètres

spacing	Nombre représentant le retrait en unités VGS, qui sont très petites.


SRW.SET_DISPLAY_NAME

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique le texte qui apparaît dans un menu instantané lorsque que le curseur se déplace sur un objet image dans des états sortis au format HTML ou HTMLCSS.

Syntaxe

SRW.SET_DISPLAY NAME('text_string');

Paramètres

text_string	Toute chaîne de texte qui n'utilise que les 26 lettres ASCII US en majuscules ou en minuscules, des nombres ou des caractères de soulignement. Tout autre caractère spécial est automatiquement converti en caractère de soulignement.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez la propriété Nom d'affichage.


SRW.SET_DISPLAY NAME - Restrictions
SRW.SET_DISPLAY_NAME - Restrictions

•	SRW.SET_DISPLAY_NAME ne doit être définie que dans les déclencheurs suivants :

Formatfortrig>referenc


SRW.SET_DISPLAY_NAME - Exemple

  Rubriques connexes 	  Tous les exemples

/* Le déclencheur de format ci-dessous affecte une chaîne de texte
** ('Cliquez ici pour remplir votre panier à provisions.') à l'objet
** image correspondant (BASKET). Dans l'état HTML, ce menu instantané apparaît
** lorsque le curseur se déplace sur l'objet BASKET.
*/

function BASKETFormatTrigger return boolean is
begin
  SRW.SET_DISPLAY_NAME('Cliquez ici pour remplir votre panier à provisions.');
  return (TRUE);
end;


SRW.SET_FIELD

  Exemples 	  Rubriques connexes	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure définit la valeur d'un champ de type caractère, nombre ou date. Elle est utile lorsque vous voulez modifier la valeur d'un champ de façon conditionnelle.

Syntaxe

SRW.SET_FIELD (object_id, text CHAR|number NUM|date DATE);

Paramètres

id d'objet	Toujours 0. (L'objet doit toujours définir ses propres attributs.)
text number date	Caractère, nombre ou date que le champ doit afficher.
Notes d'utilisation

•	Dans le cas de dates, vous devez convertir le deuxième argument en une valeur de date avec la fonction TO_DATE. Par exemple :

srw.set_field(0, to_date('01-JAN-99'));

•	Si vous oubliez de mettre la valeur entre apostrophes, celle-ci est considérée comme étant un nombre. Par exemple :

srw.set_field(0, 99);

De la même manière, vous pouvez utiliser les apostrophes si vous utilisez également la fonction TO_NUMBER. Par exemple :

srw.set_field(0, to_number('99'));

•	Si vous utilisez des apostrophes sans fonction, la valeur est considérée comme étant une chaîne de caractères. Sinon, vous pouvez utiliser la fonction TO_CHAR afin de rendre cette valeur cohérente avec les valeurs de nombre et de date :

srw.set_field(0, to_char('ma chaîne'));


SRW.SET_FIELD - Exemple

/* Supposons que vous vouliez modifier de façon conditionnelle le
** nombre d'un champ, en fonction du salaire de chaque employé.
** Dans le déclencheur de format du champ, vous pouvez
** entrer ceci :
*/

FUNCTION CHGFIELD RETURN BOOLEAN IS

TMP    NUMBER;

BEGIN

   if :sal >= 2000 then

     tmp := :sal * 1.08;

     srw.set_field (0, tmp);

   else

     srw.set_field (0, 2500);

   end if;

RETURN (TRUE);

END;


SRW.SET_FIELD_CHAR

  Restrictions	  Exemples	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure définit la valeur d'un champ caractère. Elle s'avère utile pour modifier de façon conditionnelle la valeur d'un champ caractère.

Syntaxe

SRW.SET_FIELD_CHAR (object_id, text CHAR);

Paramètres

id d'objet	Toujours 0. (L'objet doit toujours définir ses propres attributs.)
text	Chaîne de caractères que vous voulez afficher dans le champ.


SRW.SET_FIELD_CHAR - Restrictions

•	SRW.SET_FIELD_CHAR n'est pertinente que dans le déclencheur de format d'un champ de type de données caractère. Elle n'a aucun effet ailleurs.


SRW.SET_FIELD_CHAR - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez modifier de façon conditionnelle la valeur
** d'un champ Caractère, en fonction du salaire de chaque employé.
** Dans le déclencheur de format du champ, vous pouvez entrer ceci :
*/

FUNCTION CHGFIELD RETURN BOOLEAN IS

BEGIN

   if :sal >= 2000000 then

     srw.set_field_char (0, 'HIGH SALARY');

   end if;

RETURN (TRUE);

END;


SRW.SET_FIELD_DATE

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure définit la valeur d'un champ date. Elle s'avère utile pour modifier de façon conditionnelle la valeur d'un champ date.

Syntaxe

SRW.SET_FIELD_DATE (object_id, date DATE);

Paramètres:

id d'objet	Toujours 0. (L'objet doit toujours définir ses propres attributs.)
date	Date que vous voulez afficher dans le champ.


SRW.SET_FIELD_DATE - Restrictions

•	SRW.SET_FIELD_DATE n'est pertinente que dans le déclencheur de format d'un champ date. Elle n'a aucun effet ailleurs.


SRW.SET_FIELD_DATE - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez modifier de façon conditionnelle la date d'une
** réunion, en fonction de l'année de diplôme de chaque étudiant. Dans le déclencheur
** de format du champ, vous pouvez entrer ceci :
*/

FUNCTION CHGFIELD RETURN BOOLEAN IS

BEGIN

   if :graduation >= 1975 then

     srw.set_field_date (0, '02-JUL-95');

   else

   end if;

RETURN (TRUE);

END;


SRW.SET_FIELD_NUM

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure définit la valeur d'un champ numérique. Elle s'avère utile pour modifier de façon conditionnelle la valeur d'un champ numérique.

Syntaxe

SRW.SET_FIELD_NUM (object_id, number NUM);

Paramètres

id d'objet	Toujours 0. (L'objet doit toujours définir ses propres attributs.)
number	Nombre que vous voulez afficher dans le champ.


SRW.SET_FIELD_NUM - Restrictions

•	SRW.SET_FIELD_NUM n'est pertinente que dans le déclencheur de format d'un champ de type NUMERIQUE. Elle n'a aucun effet ailleurs.


SRW.SET_FIELD_NUM - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez modifier de façon conditionnelle un nombre dans
** un champ, en fonction du salaire de chaque employé. Dans le déclencheur de format
** du champ, vous pouvez entrer ceci :
*/

FUNCTION CHGFIELD RETURN BOOLEAN IS

TMP    NUMBER;

BEGIN

   if :sal >= 2000 then

     tmp := :sal * 1.08;

     srw.set_field_num (0, tmp);

   else

     srw.set_field_num (0, '2500');

   end if;

RETURN (TRUE);

END;


SRW.SET_FILL_PATTERN

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique le motif de remplissage de l'objet. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_FILL_PATTERN('pattern');

Paramètres

pattern	Motif de remplissage de l'objet (par exemple, plein).
Palette de propriétés  (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Motif de remplissage.

Interface utilisateur  Pour définir les attributs de bordure dans l'interface utilisateur, reportez-vous à Modification des motifs.


SRW.SET_FONT_FACE

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique la police d'un champ CHAR, DATE ou NUMBER. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_FONT_FACE('face');

Paramètres

face	Police (par exemple, Arial).
Palette de propriétés  (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Police.

Interface utilisateur  Pour définir les attributs de police dans l'interface utilisateur, reportez-vous à Modification des attributs de texte.


SRW.SET_FONT_SIZE

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique le corps de la police d'un champ CHAR, DATE ou NUMBER. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_FONT_SIZE(size);

Paramètres

size	Corps de la police, exprimé en points (par exemple, 9).
Palette de propriétés  (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Police.

Interface utilisateur  Pour définir les attributs de police dans l'interface utilisateur, reportez-vous à Modification des attributs de texte.


SRW.SET_FONT_STYLE

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique le style de police d'un champ CHAR, DATE ou NUMBER. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_FONT_STYLE(style);

Paramètres

style	Un des styles suivants : SRW.ITALIC_STYLE SRW.OBLIQUE_STYLE SRW.UNDERLINE_STYLE SRW.OUTLINE_STYLE SRW.SHADOW_STYLE SRW.INVERTED_STYLE SRW.BLINK_STYLE SRW.PLAIN_STYLE
Notes d'utilisation

•	Si vous utilisez cette procédure plusieurs fois sur le même champ, les styles de polices se cumulent. Par exemple, dans le cas ci-dessous, le champs apparaîtra souligné et en italique :

SRW.SET_FONT_STYLE(SRW.UNDERLINE_STYLE);
SRW.SET_FONT_STYLE(SRW.ITALIC_STYLE);

Pour annuler tous les styles cumulés, utilisez le style PLAIN.

Palette de propriétés  (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Police.

Interface utilisateur  Pour définir les attributs de police dans l'interface utilisateur, reportez-vous à Modification des attributs de texte.


SRW.SET_FONT_WEIGHT

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique la graisse de la police d'un champ CHAR, DATE ou NUMBER. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_FONT_WEIGHT(weight);

Paramètres

weight	Un des paramètres suivants : SRW.ULTRALIGHT_WEIGHT SRW.EXTRALIGHT_WEIGHT SRW.LIGHT_WEIGHT SRW.DEMILIGHT_WEIGHT SRW.DEMIBOLD_WEIGHT SRW.BOLD_WEIGHT SRW.EXTRABOLD_WEIGHT SRW.MEDIUM_WEIGHT
Palette de propriétés  (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Police.

Interface utilisateur  Pour définir les attributs de police dans l'interface utilisateur, reportez-vous à Modification des attributs de texte.


SRW.SET_FOREGROUND_BORDER_COLOR

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique la couleur de premier plan de la bordure de l'objet. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_FOREGROUND_BORDER_COLOR('color');

Paramètres

color	Couleur valide de la palette de couleurs.
Palette de propriétés  (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Couleur de premier plan du bord.

Interface utilisateur  Pour définir la couleur de premier plan de la bordure dans l'interface utilisateur, reportez-vous à Modification des couleurs.


SRW.SET_FOREGROUND_FILL_COLOR

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique la couleur de premier plan de remplissage de l'objet. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_FOREGROUND_FILL_COLOR('color');

Paramètres

color	Couleur valide de la palette de couleurs.
Palette de propriétés  (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Couleur de premier plan.

Interface utilisateur  Pour définir la couleur de premier plan de remplissage dans l'interface utilisateur, reportez-vous à Modification des couleurs.


SRW.SET_FORMAT_MASK

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique le masque de format du champ DATE ou NUMBER.

Syntaxe

SRW.SET_FORMAT_MASK('mask');

Paramètres

mask	Masque de format valide. Reportez-vous aux rubriques Syntaxe de masque de format de date ou Syntaxe de masque de format numérique
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez la propriété Masque de format.


SRW.SET_HYPERLINK

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique un lien Web vers un URL.

Remarque : Un objet qui constitue la source d'un lien Web ne peut pas être associé à une action.

Syntaxe

SRW.SET_HYPERLINK('hyperlink');

Paramètres

hyperlink	Lien valide : • Vers un autre document sur la même machine (par exemple, file:/privé/mondocument.pdf ou file:///C|/temp/mondocument.pdf) • Vers un autre document sur une autre machine (par exemple, http://www.machine.com/document.pdf) • Vers une destination à l'intérieur du document courant (par exemple, #ma_destination) • Vers une destination dans un document local (par exemple, file:/privé/document.pdf#une_destination) • Vers une destination dans un document distant (par exemple, http://www.machine.com/document.pdf#une_destination) • Vers un URL quelconque (par exemple, http://www.machine.com/document.html, ftp://www.reposit.com/fichier.exemple, http://www.machine.com/cgi-bin/webmenu?option1)
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez la propriété Hyperlien.


SRW.SET_HYPERLINK - Restrictions

•	SRW.SET_HYPERLINK ne peut être définie que dans les déclencheurs suivants :

Formatfortrig>referenc

•	Pour pouvoir suivre les liens Web à partir d'un visualiseur PDF vers un serveur distant ou un document HTML, le visualiseur PDF doit être configuré de façon à fonctionner avec un navigateur Web (par exemple, configuré comme application de système d'aide ou comme application externe dans votre navigateur Web).


SRW.SET_HYPERLINK - Exemple

  Rubriques connexes 	  Tous les exemples

/* Le déclencheur de format ci-dessous définit un lien
** Web vers une destination (mytarget) dans un autre document
** (newdoc.pdf) pour l'objet texte standard B_2.
** Remarque : Si la cible se trouvait dans le même document,
** vous pourriez omettre http://www.newmach.com/newdoc.pdf.
*/

function B_2FormatTrigger return boolean is
begin
  SRW.SET_HYPERLINK('http://www.newmach.com/newdoc.pdf' ||
  '#mytarget');
  return (TRUE);
end;


SRW.SET_HYPERLINK dynamique - Exemple

  Rubriques connexes 	  Tous les exemples

/* Le déclencheur de format ci-dessous définit un lien
** Web pour l'objet texte standard B_3. Notez comment
** la destination du lien est déterminée de façon dynamique
** en fonction de la valeur de SRCDIR et de CF_PICKVIDEO.
** Par exemple, si la valeur de SRCDIR était
** http://www.newmach.com et celle de CF_PICKVIDEO good.avi,
** cette fonction attribuerait le lien Web
** suivant à l'objet :
** http://www.newmach.com/webdemo/src/good.avi.
*/

function B_3FormatTrigger return boolean is
begin
  SRW.SET_HYPERLINK(:srcdir||:cf_pickvideo);
  if ( upper(:cf_pickvideo) like '%GOOD%' ) then
    SRW.SET_FOREGROUND_BORDER_COLOR('green');
    SRW.SET_BACKGROUND_BORDER_COLOR('green');
  end if;
  return (TRUE);
end;

/* SRCDIR is a parameter whose value is determined at
** runtime by the following After Parameter Form trigger
*/

function AfterPForm return boolean is
begin
  :srcdir := :web_server || '/webdemo/src/';
  :docsdir := :web_server || '/webdemo/docs/';
  return (TRUE);
end;

/* CF_PICKVIDEO is a formula column whose value is
** determined by the following function
*/

function CF_pickvideoFormula return Char is
begin
  if ( :avg_h_div < .80 )
    then return ('bad.avi');
    else return ('good.avi');
  end if;
end;


SRW.SET_HYPERLINK_ATTRS

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	 	    Toutes les procédures internes

Description  Cette procédure applique des commandes HTML supplémentaires à l'hyperlien mentionné dans la Palette de propriétés ou dans la procédure SRW.SET HYPERLINK.

Syntaxe

SRW.SET_HYPERLINK_ATTRS('string');

Paramètres

HTML_string	Chaîne contenant les commandes HTML à appliquer.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez la propriété Attributs d'hyperlien supplémentaire.


SRW.SET_HYPERLINK_ATTRS - Restrictions

•	SRW.SET_HYPERLINK_ATTRS ne doit être définie que dans les déclencheurs suivants :

Formatfortrig>referenc


SRW.SET_HYPERLINK_ATTRS - Exemple

  Rubriques connexes 	  Tous les exemples

/* Le déclencheur de format ci-dessous génère un état
** d'informations en bas de votre navigateur Web
** lorsque le curseur de la souris passe sur l'objet
** du panier à provisions (BASKET).
*/

function BASKETFormatTrigger return boolean is
begin
SRW.SET_HYPERLINK_ATTRS('onMouseover "window.status="Cliquez ici pour visualiser le contenu de votre panier à provisions.";return true"'|| 'onMouseout ="window.status=" ";return true"');
  return (TRUE);
end;


SRW.SET_JUSTIFICATION

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique la justification horizontale d'un champ CHAR, DATE ou NUMBER.

Syntaxe

SRW.SET_JUSTIFICATION(justification);

Paramètres

justification	Un des paramètres suivantes : SRW.LEFT_HJUST SRW.RIGHT_HJUST SRW.FLUSH_HJUST SRW.CENTER_HJUST.
Palette de propriétés  (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Justification de caractères pour les champs caractère, Justification de dates pour les champs date, et Justification de nombres pour les champs nombre.

Interface utilisateur  Pour définir la justification horizontale dans l'interface utilisateur, reportez-vous à Modification des attributs de texte.


SRW.SET_LINKTAG

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique l'identificateur d'un objet et peut être utilisée comme destination dans des liens Web.

Syntaxe

SRW.SET_LINKTAG('linktag');

Paramètres

linktag	Un nom unique valide qui n'utilise que les 26 caractères ASCII US minuscules ou majuscules, des chiffres et des caractères de soulignement. Les autres caractères spéciaux seront automatiquement convertis en caractères de soulignement.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez la propriété Destination hyperlien.


SRW.SET_LINKTAG - Restrictions

•	SRW.SET_LINKTAG ne peut être définie que dans les déclencheurs suivants :

Formatfortrig>referenc


SRW.SET_LINKTAG - Exemple

  Rubriques connexes 	  Tous les exemples

/* Le déclencheur de format ci-dessous affecte un identificateur
** (mytarget) à l'objet texte standard B_500.
** Cela signifie que l'objet peut maintenant constituer la
** destination d'un lien Web.
*/

function B_500FormatTrigger return boolean is
begin
  SRW.SET_LINKTAG('mytarget');
  return (TRUE);
end;


SRW.SET_LINKTAG dynamique - Exemple

  Rubriques connexes 	  Tous les exemples

/* Le déclencheur de format ci-dessous affecte un identificateur
** au champ F_Dept en concaténant du texte statique
** (dept_details_) avec la valeur de la colonne source
** (DEPTNO). Cette fonction vérifie qu'un identificateur unique
** est affecté à chaque instance de F_Dept.
*/

function F_DeptFormatTrigger return boolean is
begin
  SRW.SET_LINKTAG('dept_details_' ||
  LTRIM(TO_CHAR(:deptno)));
  return (TRUE);
end;


SRW.SET_MAXROW

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure définit le nombre maximum d'enregistrements à extraire pour l'interrogation indiquée. Elle s'avère utile lorsque votre état met en forme (c'est-à-dire affiche) moins d'enregistrements que l'interrogation (ou les interrogations) qui les a extraits. Ainsi, à l'aide de SRW.SET_MAXROW, vous pouvez limiter de façon conditionnelle les données extraites dans votre état, ce qui vous permet d'améliorer ses performances.

Syntaxe

SRW.SET_MAXROW (query_name CHAR, maxnum PLS_INTEGER);

Paramètres

query_name	Interrogation dont le nombre d'enregistrements à extraire sera limité.
maxnum	Nombre maximum d'enregistrements que vous voulez extraire.
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez la propriété Nbre max de lignes à extraire.


SRW.SET_MAXROW - Restrictions

•	SRW.SET_MAXROW n'est pertinente que dans un déclencheur Before Report (c'est-à-dire une fois l'interrogation analysée). Si SRW.SET_MAXROW est appelée après le déclencheur Before Report (c'est-à-dire après l'exécution des interrogations), l'exception packagée SRW.MAXROW_UNSET survient.

•	Puisque cette procédure n'entraîne que l'extraction du nombre d'enregistrements indiqué, les enregistrements non extraits de l'interrogation ne sont pas utilisés dans les calculs, etc.

•	Si vous indiquez l'extraction de 0 enregistrement, l'interrogation sera tout de même analysée.


SRW.SET_MAXROW - Exemples

  Rubriques connexes 	  Tous les exemples

/* Supposons que votre état comporte deux interrogations, Q_Stocks et Q_Bonds.
** Supposons également que vous ayez un paramètre créé par l'utilisateur, appelé
** WHICHDATA, qui permet aux utilisateurs d'indiquer les données qu'ils veulent
** faire apparaître dans l'état : des actions ou des obligations. Dans le
** déclencheur Before Report, vous pouvez utiliser la procédure SRW.SET_MAXROW
** pour vous assurer que les données d'une seule interrogation sont extraites :
*/

FUNCTION FETCHIT RETURN BOOLEAN IS

BEGIN

   if :whichdata != 1 then

     srw.set_maxrow ('Q_Stocks', 0);

   else

     srw.set_maxrow ('Q_Bonds', 0);

   end if;

RETURN (TRUE);

END;


SRW.SET_PAGE_NAVIGATION_HTML

 Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique la création du script des contrôles de navigation dans la sortie de l'état au format de page HTML/HTMLCSS.

Syntaxe

SRW.SET_PAGE_NAVIGATION_HTML(type,'string');

Paramètres

type	SRW.FILE_ESCAPE ou SRW.TEXT_ESCAPE. Indique si le paramètre string représente un nom de fichier ou le texte du script HTML à insérer.
String	Nom de fichier ou code de création de script HTML à insérer, en fonction du paramètre type choisi. S'il est laissé vide, le code JavaScript par défaut de Report Builder est utilisé pour définir les contrôles de navigation sur chaque page de la sortie de l'état.
Notes d'utilisation

Si vous choisissez d'utiliser votre propre script de génération de contrôles de navigation, vous devez inclure dans votre script trois variables :

•	&TotalPages (nombre total de pages)

•	&file_name (nom du fichier de destination de la sortie ; par exemple, MonEtat).

•	&file_ext (extension du fichier ; par exemple, htm)

Report Builder affecte des valeurs à ces variables au cours de la mise en forme.

La hauteur de l'encadrement des contrôles de navigation de page est codée en dur en 70 points sans barre de défilement. La largeur de cet encadrement est variable. Pour y utiliser des icônes et des images, gardez ces dimensions à l'esprit.

Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez les propriétés Type Contrôle de navigation de page et Valeur Contrôle de navigation de page.


SRW.SET_PDF_ACTION

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique une ligne de commande exécutée sur la machine locale lorsque l'utilisateur clique sur l'objet dans le visualiseur PDF.

Remarque : Un objet associé à une action ne peut pas être la source d'un lien Web.

Syntaxe

SRW.SET_PDF_ACTION('action');

Paramètres

action	Toute ligne de commande valide sur la machine locale (par exemple, c:\orawin\bin\rwrun60 userid=scott/tiger report=example.rdf ou /usr/local/bin/phone smith).
Palette de propriétés  Pour définir cet attribut à l'aide de la Palette de propriétés, choisissez la propriété Ligne de commande d'application (PDF) .


SRW.SET_PDF_ACTION - Restrictions

•	SRW.SET_PDF_ACTION n'est disponible que pour une sortie PDF.

•	SRW.SET_PDF_ACTION ne peut être définie que dans les déclencheurs suivants :

Format


SRW.SET_PDF_ACTION - Exemple

  Rubriques connexes 	  Tous les exemples

/* Le déclencheur de format ci-dessous exécute un
** état appelé example.rdf lorsque vous cliquez sur
** l'objet bouton U_Report
** dans le visualiseur PDF.
*/

function U_ReportFormatTrigger return boolean is
begin
  SRW.SET_PDF_ACTION ||
  ('c:\orawin\bin\rwrun60' ||
  'userid=scott/tiger ' ||
  'report=example.rdf');
end;


SRW.SET_PRINTER_TRAY

  Restrictions 	  Exemples 	  Rubriques connexes 	  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique le nom d'un plateau d'imprimante valide et peut être utilisée pour changer de plateau d'imprimante pendant le formatage de votre état.

Syntaxe

SRW.SET_PRINTER_TRAY('tray');

Paramètres

tray	Nom d'un plateau d'imprimante valide pouvant être utilisé pour changer de plateau pendant le formatage de votre état.
Notes d'utilisation

•	Si vous utilisez SRW.SET_PRINTER_TRAY dans le déclencheur de format d'un objet, le plateau sera modifié sur la page où l'objet est imprimé. Le plateau que vous indiquez demeure actif tant que vous ne le modifiez pas dans un autre déclencheur.


SRW.SET_PRINTER_TRAY - Restrictions

•	SRW.SET_PRINTER_TRAY ne peut être définie que dans les déclencheurs suivants :

Déclencheur After Report

Before Report

Between Pages

Format

Si vous utilisez SRW.SET_PRINTER_TRAY dans un déclencheur Before Form ou After Form, vous obtiendrez une erreur de texte incorrect.

•	La valeur définie pour PRINTER_INTRAY est ignorée lorsque la sortie des états est effectuée sur une imprimante PCL fonctionnant sous Motif.


SRW.SET_PRINTER_TRAY - Exemple

  Rubriques connexes 	  Tous les exemples

/* L'exemple ci-dessous définit le plateau d'imprimante
** dans un déclencheur Between Pages.
*/

function BetweenPages return boolean is
begin
SRW.SET_PRINTER_TRAY('letterhead');
return (TRUE);
end;


SRW.SET_SPACING

  Rubriques connexes [image]  Procédures de définition d'attributs 	  Toutes les procédures internes

Description  Cette procédure indique le retrait du texte global d'un champ CHAR, DATE ou NUMBER, ou pour du texte standard. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_SPACING(spacing);

Paramètres

spacing	Un des paramètres suivants :   SRW.SINGLE_SPACING SRW.DOUBLE_SPACING SRW.ONEHLF_SPACING


SRW.SET_TEXT_COLOR

   Procédures de définition d'attributs	  Toutes les procédures internes

Description  Cette procédure indique la couleur du texte global d'un champ CHAR, DATE ou NUMBER. Cet attribut est ignoré en mode caractère.

Syntaxe

SRW.SET_TEXT_COLOR('color');

Paramètres

color	Couleur valide de la palette de couleurs.
Palette de propriétés  (Modèles uniquement) Pour définir cet attribut pour les modèles à l'aide de la Palette de propriétés, choisissez la propriété Couleur de texte.

Interface utilisateur  Pour définir la couleur du texte dans l'interface utilisateur, reportez-vous à Modification des couleurs.


SRW.INTEGER_ERROR

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette exception arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1417:  Argument entier erroné passé à <SRW.MESSAGE ou SRW.SET_MAXROW>.

Syntaxe

SRW.INTEGER_ERROR;

Notes d'utilisation Report Builder génère cette exception lorsque SRW.MESSAGE ou SRW.SET_MAXROW est appelé avec un non-entier découlant d'une erreur interne. (S'il n'y a pas d'erreur interne, PL/SQL détecte la non-concordance de type par l'intermédiaire de l'exception PL/SQL VALUE_ERROR.)


SRW.INTEGER_ERROR - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez remplacer le message d'erreur
** par défaut par votre propre message d'erreur.
** Vous pourriez traiter cette exception de la manière suivante :
*/

EXCEPTION

when SRW.INTEGER_ERROR then

   srw.message(4000, 'Interroger le groupe Développement

      d'applications sur SRW.INTEGER_ERROR.');

   raise srw.program_abort;


SRW.MAXROW_INERR

  Exemples	  Restrictions	  Rubriques connexes	  Toutes les procédures internes

Description Cette exception arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1424: Erreur interne lors de l'exécution de SRW.SET_MAXROW.

Si cette erreur est générée, contactez le Support technique Oracle.

Syntaxe

SRW.MAXROW_INERR;

Notes d'utilisation Report Builder génère cette exception lorsqu'il détecte une erreur interne pendant l'exécution de la procédure en package SRW.SET_MAXROW.


SRW.MAXROW_INERR - Restrictions

•	Lorsque vous traitez SRW.MAXROW_INERR, vous devez toujours générer SRW.PROGRAM_ABORT pour mettre fin à l'exécution de l'état (en raison de l'existence d'un problème interne dans l'état).


SRW.MAXROW_INERR - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez remplacer le message d'erreur
** par défaut par votre propre message d'erreur.
** Vous pourriez traiter cette exception de la manière suivante :
*/

EXCEPTION

when SRW.MAXROW_INERR then

   srw.message(1000, 'Contacter le Support technique Oracle

                SRW.MAXROW_INERR');

   raise srw.program_abort;


SRW.MAXROW_UNSET

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette exception arrête momentanément l'exécution de l'état et génère le message d'erreur ci-après. Une fois le message généré et accepté par vous, l'exécution de l'état reprend.

REP-1423: Impossible de définir le nombre maximum de lignes d'une interrogation, une fois l'exécution commencée.

Syntaxe

SRW.MAXROW_UNSET;

Notes d'utilisation Report Builder génère cette exception lorsque la procédure en package SRW.SET_MAXROW est appelée après le début de l'extraction des enregistrements de l'interrogation.


SRW.MAXROW_UNSET - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez remplacer le message d'erreur
** par défaut par votre propre message d'erreur.
** Vous pourriez traiter cette exception de la manière suivante :
*/

EXCEPTION

when SRW.MAXROW_UNSET then

   srw.message(1000, 'Des données ont été extraites avant

               l'appel de SRW.SET_MAXROW.');


SRW.MESSAGE

  Restrictions	  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette procédure affiche un message comportant le numéro du message et le texte que vous spécifiez. Le message est affiché dans le format mentionné ci-dessous. Une fois le message généré et accepté par vous, l'exécution de l'état reprend.

MSG-numéro_msg :  texte_msg.

Syntaxe

SRW.MESSAGE (no_msg NUMBER, texte_msg CHAR);

Paramètres

numéro de msg	Valeur numérique, composée de un à dix chiffres, qui doit être affichée dans la ligne de message. Les valeurs comportant moins de cinq chiffres seront complétées par des zéros. Par exemple, 123 sera affiché sous la forme SRW-00123.
Texte de msg	Texte de message composé d'un maximum de 190 caractères, moins les caractères alphanumériques de numéro de msg qui seront affichés dans la ligne de message.


SRW.MESSAGE - Restrictions

•	Vous ne pouvez ni dérouter ni modifier les messages d'erreur de Report Builder.

•	SRW.MESSAGE ne met pas fin à l'exécution de l'état ; si vous voulez mettre fin à un état après avoir généré un message d'erreur, utilisez SRW.PROGRAM_ABORT.

•	Les blancs excédentaires dans la chaîne du message seront affichés dans le message. Ils ne sont pas supprimés par Report Builder.


SRW.MESSAGE - Exemples

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous ayez une sortie utilisateur appelée MASORTIE à laquelle vous voulez
**passer les valeurs de la colonne SAL. Supposons également que vous vouliez
**générer votre propre message d'erreur si la sortie utilisateur est introuvable (par exemple,
** parce qu'elle n'est pas liée, compilée, etc.). Pour cela vous pourriez
**écrire dans le champ F_SAL du déclencheur de format le PL/SQL suivant :
*/

/* Ce déclencheur générera votre message de la manière suivante :
** MSG-1000 : Echec de la sortie utilisateur MASORTIE. Appeler Claude Dupont au 3455.
*/

FUNCTION FOO RETURN BOOLEAN IS

BEGIN

    srw.reference(:SAL);

    srw.user_exit('masortie sal');

EXCEPTION

    when srw.unknown_user_exit then

    srw.message(1000, 'Echec de la sortie utilisateur MASORTIE.

 Appeler Claude Dupont au 3455.');

    raise srw.program_abort;

RETURN (TRUE);

END;


SRW.NULL_ARGUMENTS

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description  Cette exception arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1418: Arguments non renseignés transmis à <SRW.DO_SQL ou SRW.MESSAGE ou SRW.RUN_REPORT ou SRW.SET_MAXROW ou SRW.USER_EXIT>.

Syntaxe

SRW.NULL_ARGUMENTS;

Notes d'utilisation Report Builder génère cette exception lorsque l'une de ses procédures ou de ses fonctions en package est appelée avec un argument manquant. Cette exception est utile lorsque vous passez des arguments à une fonction ou à une procédure en package et que vous voulez vous assurer que ces valeur ne sont pas nulles (par exemple, lorsqu'une colonne de formule appelle SRW.USER_EXIT et que la chaîne de sortie utilisateur est passée à partir d'une bibliothèque PL/SQL).

Les conditions qui peuvent déclencher cette exception sont les suivants :

•	SRW.DO_SQL

•	SRW.MESSAGE

•	SRW.RUN_REPORT

•	SRW.SET_MAXROW

•	SRW.USER_EXIT


SRW.NULL_ARGUMENTS - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez remplacer le message d'erreur
** par défaut par votre propre message d'erreur.
** Vous pourriez traiter cette exception de la manière suivante :
*/

EXCEPTION

when SRW.NULL_ARGUMENTS then

   srw.message(4000, 'Interroger le Développement

      ...d'applications sur SRW.NULL_ARGUMENTS.');

   raise srw.program_abort;


SRW.PROGRAM_ABORT

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette exception arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1419: Abandon du programme PL/SQL.

SRW.PROGRAM_ABORT arrête l'exécution de l'état lorsque vous générez cette exception.

Syntaxe

SRW.PROGRAM_ABORT;

Notes d'utilisation Vous devez générer l'exception à partir de votre PL/SQL.


SRW.PROGRAM_ABORT - Exemples

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez tracer un cadre autour du salaire s'il est supérieur à 0.
** Supposons aussi que, si l'état extrait un salaire inférieur à 0, vous vouliez générer
** un message d'erreur personnalisé (par exemple "DETECTION D'UN SALAIRE NEGATIF. . ."),
** puis mettre fin à l'exécution de l'état. Pour cela, vous pourriez écrire pour
** F_SAL le déclencheur de format ci-après :
*/

FUNCTION foo return boolean is

BEGIN

if :sal >= 0 then

   srw.attr.mask         := SRW.BORDERWIDTH_ATTR;

   srw.attr.borderwidth := 1;

   srw.set_attr (0, srw.attr);

else

   srw.message(100, 'DETECTION D'UN SALAIRE NEGATIF.

   VERIFIER LA TABLE EMPL.');

   raise srw.program_abort;

end if;

RETURN (TRUE);

END;


SRW.REFERENCE

  Restrictions	  Exemples 	  Rubriques connexes	  Toutes les procédures internes

Description Cette procédure déclenche l'ajout, par Report Builder, de l'objet référencé à la liste de dépendances de l'élément PL/SQL. Dans ce cas, Report Builder détermine la valeur de l'objet avant d'activer l'élément PL/SQL, ce qui est utile si vous voulez vous assurer que la valeur d'une colonne transmise à une sortie utilisateur est la valeur qui a été lue ou calculée en dernier.

Syntaxe

SRW.REFERENCE (:objet CHAR|DATE|NUMBER);

Paramètres

objet	Colonne ou paramètre Report Builder dont la valeur doit être vérifiée avant l'activation de l'élément.


SRW.REFERENCE - Restrictions

•	Le signe deux-points (:) est obligatoire avant le nom de l'objet.

•	SRW.REFERENCE n'est pas nécessaire lorsque l'élément PL/SQL en cours fait référence à l'objet.


SRW.REFERENCE - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez transmettre les valeurs de température
** et de pression à une sortie utilisateur appelée SUPERCHAUFFE.
** Supposons également que si la température est trop basse, vous vouliez générer un message d'erreur personnalisé.
** Pour cela, vous pourriez écrire :
*/

FUNCTION EXIT RETURN BOOLEAN IS

BEGIN

  if :temp > 0 then

     srw.reference (:temp); -- référence non nécessaire

     srw.reference (:pression);

     srw.user_exit('pression température superchauffe');

  else srw.message(1000, 'La température est inférieure

     à la normale. La machine est-elle arrêtée ?');

     raise srw.program_abort;

  end if;

RETURN(TRUE);

END;


SRW.RUN_REPORT

  Restrictions	  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette procédure appelle RWRUN60 avec la chaîne que vous indiquez. Elle est utile pour :

•	exécuter des états de descente de niveau (c'est-à-dire appeler un état à partir du déclencheur d'action d'un bouton)

•	envoyer certaines parties d'un état à différents destinataires (par exemple, envoyer par Messagerie à chaque responsable un état ne comportant que les données de son groupe)

•	envoyer certaines parties d'un état à différentes imprimantes (par exemple, envoyer à chaque responsable, sur son imprimante, l'état qui lui est destiné) ;

•	exécuter plusieurs états à partir d'un seul état "pilote" ;

SRW.RUN_REPORT exécute la commande RWRUN60 indiquée.

Syntaxe

SRW.RUN_REPORT (ligne de commande CHAR);

Paramètres

ligne de commande	Commande RWRUN60 valide.


SRW.RUN_REPORT - Restrictions

•	Si vous voulez que les valeurs de paramètres entrées dans la grille de paramètres runtime soient transmises dans la chaîne RWRUN60, vous devez appeler SRW.RUN_REPORT après le déclencheur Before Form.

•	La chaîne qui est spécifiée pour cette procédure ou qui lui est transmise doit respecter la syntaxe et les règles d'écriture en majuscules/minuscules de votre système d'exploitation.

•	Aucun identificateur d'utilisateur ne doit être spécifié pour la procédure SRW.RUN_REPORT. L'identificateur d'utilisateur est hérité par l'état "appelant".

•	Si l'état père qui appelle SRW.RUN_REPORT est exécuté en mode batch, TYPE_DES ne peut être que File, Printer, Sysout ou Mail. Sinon, TYPE_DES peut être File, Printer ou Mail.

•	Si SRW.RUN_REPORT est utilisé dans le PL/SQL pour un bouton, la grille de paramètres d'exécution n'apparaît pas par défaut lorsque le bouton est sélectionné. Si vous voulez que cette grille apparaisse, vous devez spécifier PARAMFORM=YES dans l'appel à SRW.RUN_REPORT.

•	Si vos ne spécifiez pas de chemin d'accès, Report Builder utilise son propre ordre d'exploration des chemins d'accès pour trouver l'état.


SRW.RUN_REPORT - Exemples
SRW.RUN_REPORT - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous ayez deux états :

** ETAT_RES, qui demande les noms des responsables et appelle un second état appelé ENVOI_EMAIL ;

** ENVOI_EMAIL, qui recherche dans les noms d'employé celui du responsable que lui transmet ETAT_RES,
** et lui envoie la sortie de l'état via la Messagerie.

** La description de ETAT_RES pourrait être la suivante :

** Interrogation :

   SELECT NOM_E, NOEMP FROM EMP WHERE JOB='MANAGER'

** Filtre de groupe :
*/

   FUNCTION FOO RETURN BOOLEAN IS

   BEGIN

    srw.run_report('report=ENVOI_MAIL

      desname='||:nom_mail ||' desformat=dflt batch=yes

      mgr_no='|| TO_CHAR(:noemp) );

    RETURN (TRUE);

    EXCEPTION

    when srw.run_report_failure then

      srw.message(30, 'Erreur au cours de l'envoi des états.');

      raise srw.program_abort;

   END;

/* Cette séquence PL/SQL appelle ENVOI_MAIL, indique que
** la sortie de ENVOI_MAIL doit être transmise au manager par la Messagerie
** et passe le numéro du manager afin que l'état ENVOI_MAIL puisse n'interroger
** que les employés du manager.

** Remarque : Les valeurs de NOEMP doivent être converties
** en caractères (TO_CHAR dans le PL/SQL ci-dessus) car
** SRW.RUN_REPORT demande une chaîne de caractères.

** Présentation : Aucune présentation n'est nécessaire, car cet état ne
** fait que lire des données, puis les passe à un second état.

** La description de ENVOI_EMAIL pourrait être la suivante :

** Interrogation :

   SELECT DEPTNO, ENAMEE, SAL FROM EMP WHERE MGR=:MGR_NO

** Présentation : Maître/Détail
*/

/* Supposons que vous ayez trois états : SALAIRES, COMMISS et
** TAXES que vous exécutez presque toujours ensemble.
** Pour les exécuter avec une commande RWRUN60, créez un
** état pilote appelé PAYE. La description de PAYE pourrait être la suivante :

** Interrogation :

   SELECT DEPTNO FROM DEPT

** Déclencheur Before Report :
*/

   FUNCTION FOO RETURN BOOLEAN IS

   BEGIN

     srw.run_report('batch=yes report=SALAIRE

      destype=file desformat=dflt desname=salaire.lis');

     srw.run_report('batch=yes report=COMMISS

      destype=file desformat=dflt desname=comiss.lis');

     srw.run_report('batch=yes état=TAXES

      destype=file desformat=dflt desname=comiss.lis');

   RETURN (TRUE);

   END;

/* Présentation : tabulaire

** Lorsque vous exécuterez PAYE à partir du Designer ou de RWRUN60,
** les trois autres états seront également exécutés. (Notez que
** dans ce cas, c'est vous qui spécifiez l'interrogation et
** la présentation de Paye. Ils ne sont utilisés ici que pour permettre d'exécuter PAYE.)
*/


SRW.RUN_REPORT_BATCHNO

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette exception arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1429 : Impossible d'appeler SRW.RUN_REPORT avec batch=no.

Syntaxe

SRW.RUN_REPORT_BATCHNO;

Notes d'utilisation Report Builder génère cette exception lorsque la procédure SRW.RUN_REPORT est appelée avec une chaîne de ligne de commande contenant BATCH=NO.


SRW.RUN_REPORT_BATCHNO - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vos vouliez remplacer le message d'erreur
** par défaut de SRW.UNKNOWN_QUERY par votre propre message d'erreur.
** Vous pourriez traiter cette exception de la manière suivante :
*/

EXCEPTION

when SRW.RUN_REPORT_BATCHNO then

   srw.message(4000, 'Interroger le groupe Développement d'applications

     sur SRW.RUN_REPORT_BATCHNO.');

   raise srw.program_abort;


SRW.RUN_REPORT_FAILURE

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Si la procédure en package SRW.RUN_REPORT échoue, cette exception arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1428 : Erreur au cours de l'exécution de SRW.RUN_REPORT.

Syntaxe

SRW.RUN_REPORT_FAILURE;

Notes d'utilisation Report Builder génère cette exception lorsque la procédure en package SRW.RUN_REPORT échoue.


SRW.RUN_REPORT_FAILURE - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez remplacer le message d'erreur par défaut
** (ci-dessus) par votre propre message d'erreur. La séquence PL/SQL suivante
** génère un message d'erreur personnalisé lorsque SRW.RUN_REPORT_FAILURE est généré.
*/

EXCEPTION

   WHEN srw.run_report_failure then

      srw.message(30, 'Erreur au cours de l'envoi des états.');

      raise srw.program_abort;


SRW.SET_ATTR

  Liste d’attributs	  Restrictions 	  Exemples	  Rubriques connexes	  Toutes les procédures internes

Nouvelle fonction :  Il est désormais plus facile de définir les attributs à l'aide des procédures de définition d'attributs.  SRW.SET_ATTR est toujours pris en charge pour des raisons de compatibilité, mais nous vous recommandons fortement d'utiliser les procédures simplifiées.

Description SRW.SET_ATTR applique des paramètres d'attribut (police, taille ou couleur) aux objets de la présentation. Pour indiquer les attributs de mise en forme avec SRW.SET_ATTR, procédez de la manière suivante :

1	Indiquez les attributs que vous voulez utiliser (par exemple, bordure) en définissant SRW.ATTR.MASK.

2	Indiquez la valeur de chacun des attributs que vous avez définis ci-dessus (par exemple, largeur de 1 caractère).

3	Appliquez le masque à l'objet en appelant la procédure SRW.SET_ATTR.

Remarque : Vous pouvez, dans la plupart des cas, définir des liens Web (HTML ou PDF) et des attributs HTML dans la Palette de propriétés d'un objet. Pour une mise en oeuvre plus complexe, telle que des définitions conditionnelles, vous devez utiliser SRW.SET_ATTR :

•	Pour indiquer des liens Web, faites appel aux attributs ACTION, BOOKMARK, HYPERLINK et LINKTAG.

•	Pour définir un document HTML ainsi que des en-têtes et des pieds de page, utilisez les attributs BEFPAGE_ESCAPE, AFTPAGE_ESCAPE, BEFREPORT_ESCAPE et AFTREPORT_ESCAPE.

•	Pour définir des en-têtes et des pieds de grille de paramètres HTML, utilisez les attributs BEFFORM_ESCAPE et AFTFORM_ESCAPE.

Syntaxe

SRW.ATTR.MASK := SRW.attr_ATTR [+ SRW.attr_ATTR. . .];
SRW.ATTR.attr := value; [SRW.ATTR.attr := value;. . .]
SRW.SET_ATTR (object_id, SRW.ATTR);

Paramètres

Attr	Nom de l'attribut que vous définissez (par exemple, BORDERWIDTH).
id d'objet	0 ou SRW.REPORT_ID. Lorsque vous indiquez la valeur BEFREPORT_ESCAPE, AFTREPORT_ESCAPE, BEFPAGE_ESCAPE et AFTPAGE_ESCAPE, l'id_objet est SRW.REPORT_ID. Dans tous les autres cas, il a la valeur 0.
Valeur	Valeur valide pour l'attribut (par exemple, 1 pour BORDERWIDTH).


SRW.SET_ATTR - Restrictions

•	Si vous indiquez un attribut (par exemple, SRW.FILLPATT_ATTR), vous devez lui donner une valeur. Sinon, vous obtiendrez des résultats imprévisibles.

•	Toute valeur qui n'est pas fournie par le package Report Builder doit être indiquée sous la forme d'une chaîne (c'est-à-dire entre guillemets simples). Par exemple, la valeur de SRW.ATTR.FORMATMASK doit être entre guillemets simples, parce que vous pouvez indiquer n'importe quelle valeur. La valeur de SRW.ATTR.HJUST ne doit pas être entre guillemets simples, car vous devez indiquer l'une des valeurs fournies par Report Builder.

•	Le attributs du texte ne peuvent être appliqués aux champs que par SRW.SET_ATTR. Ils ne peuvent pas être appliqués à un texte standard. Pour modifier les attributs d'un texte standard, utilisez le menu Format ou la palette d'outils de l'éditeur de présentation.


SRW.SET_ATTR - Exemple en mode caractère

  Rubriques connexes 	  Tous les exemples

/* Exemple d'utilisation de tous les attributs de
** mise en forme valides pour les états en mode caractère.
** Notez les deux valeurs appliquées à l'attribut de
** justification horizontale (HJUST).
** Remarque : Pour que les codes d'imprimante &1 et &2 soient significatifs, il faut que le fichier
** de définition d'imprimante à utiliser pour cet état
** définisse l'opération que l'imprimante devra exécuter
** pour &1 et &2.
*/

function F_SALFormatTrigger return boolean is

begin

   IF :SAL > 2000 THEN

      SRW.ATTR.MASK        := SRW.BEFCODE_ATTR     +

                              SRW.AFTCODE_ATTR     +

                              SRW.TEXT_ATTR        +

                              SRW.FILLPATT_ATTR    +

                              SRW.BORDERWIDTH_ATTR +

                              SRW.FORMATMASK_ATTR  +

                              SRW.HJUST_ATTR;

      SRW.ATTR.BEFCODE     := '&1';

      SRW.ATTR.AFTCODE     := '&2';

      SRW.ATTR.TEXT        := SRW.BOLD_TEXTA;

      SRW.ATTR.FILLPATT    := 'TRANSPARENT';

      SRW.ATTR.BORDERWIDTH := 1;

      SRW.ATTR.FORMATMASK  := 'JJ-MOI-AA';

      SRW.ATTR.HJUST       := SRW.CENTER_HJUST +

                              SRW.FLUSH_HJUST;

   END IF;

   SRW.SET_ATTR(0, SRW.ATTR);

   RETURN(TRUE);

end;


SRW.SET_ATTR - Exemple de masque de format

  Rubriques connexes 	  Tous les exemples

/* Si le salaire est 2000, le segment de code
** qui donne au masque de format la valeur -99990 est le  suivant :
*/

function F_SALFormatTrigger return boolean is

begin

   if :sal = 2000 then

      srw.attr.mask        := SRW.FORMATMASK_ATTR;

      srw.attr.formatmask  := '-99990';

      srw.set_attr (0, srw.attr);

   end if;

   RETURN (TRUE);

end;


SRW.SET_ATTR - Exemple de définition de couleur de champ

  Rubriques connexes 	  Tous les exemples

/* Si le salaire est 2000, cette fonction définit les
** attributs suivants : largeur de bordure 1, couleur de
** bordure de premier plan "rouge", couleur de bordure
** d'arrière-plan "bleue" , motif de la bordure "damier",
** couleur de remplissage de premier plan "jaune",
** couleur de remplissage d'arrière-plan "vert" et motif de remplissage "croisillons".
**
** Remarque : Lorsque vous exécutez l'état avec cet élément
** de PL/SQL en mode caractère, seule la largeur de la bordure
** (1) et le motif de remplissage (plein) sont définis ;
** tous les autres paramètres ne sont pas pris en compte.
** Lorsque vous exécutez l'état avec cet élément de PL/SQL en mode bitmap,
** tous les attributs sont définis. (N'oubliez pas que certaines
** interfaces graphiques n'autorisent pas la définition de la
** couleur de la bordure d'arrière-plan.)
*/

function F_SALFormatTrigger return boolean is

begin

   if :sal = 2000 then

      srw.attr.mask     := SRW.BORDERWIDTH_ATTR +

                           SRW.FBCOLOR_ATTR     +

                           SRW.BBCOLOR_ATTR     +

                           SRW.BORDPATT_ATTR    +

                           SRW.FFCOLOR_ATTR     +

                           SRW.BFCOLOR_ATTR     +

                           SRW.FILLPATT_ATTR;

      srw.attr.borderwidth := 1;

      srw.attr.fbcolor     := 'rouge';

      srw.attr.bbcolor     := 'bleu';

      srw.attr.bordpatt    := 'damier';

      srw.attr.ffcolor     := 'jaune';

      srw.attr.bfcolor     := 'vert';

      srw.attr.fillpatt    := 'croisillons';

   srw.set_attr (0, srw.attr);

   end if;

   RETURN(TRUE);

end;


SRW.SET_ATTR - Exemple de définition des attributs de texte de champ

  Rubriques connexes	  Tous les exemples

/* Si le salaire est 2000, cette fonction
** définit les attributs de texte suivants : texte
** en gras, police TIMES, taille 18 points, style souligné,
** épaisseur gras, couleur de texte "bleu" et justification
** centrée.
**
** Remarque : Lorsque vous exécutez l'état avec cet élément
** de PL/SQL en mode caractère, seul le texte est mis
** en gras (SRW.TEXT_ ATTR) ; tous les autres attributs
** ne sont pas pris en compte. Lorsque vous exécutez l'état avec cet
** élément de PL/SQL en mode bitmap, tous les attributs,
** - à l'exception de SRW.TEXT_ATTR -
**  seront utilisées.
*/

function F_SALFormatTrigger return boolean is

begin

   if :sal = 2000 then

   srw.attr.mask        := SRW.TEXT_ATTR       +

                           SRW.FACE_ATTR       +

                           SRW.SZ_ATTR         +

                           SRW.WEIGHT_ATTR     +

                           SRW.STYLE_ATTR      +

                           SRW.GCOLOR_ATTR     +

                           SRW.HJUST_ATTR;

      srw.attr.text     := SRW.BOLD_TEXTA;

      srw.attr.face     := 'times';

      srw.attr.sz       := 18;

      srw.attr.weight   := SRW.BOLD_WEIGHT;

      srw.attr.style    := SRW.UNDERLINE_STYLE;

      srw.attr.gcolor   := 'bleu';

      srw.attr.hjust    := SRW.CENTER_HJUST;

   srw.set_attr (0, srw.attr);

   end if;

   RETURN (TRUE);

end;


SRW.SET_ATTR - Exemple d'espacement vertical

  Rubriques connexes 	  Tous les exemples

/* Si le salaire est 2000, cette fonction donne à
** l'espacement vertical entre les lignes une valeur personnalisée
** de 200 unités VGS. (Un pouce équivaut
** à 8192 unités VGS.)
*/

function F_SALFormatTrigger return boolean is

begin

   if :sal = 2000 then

      srw.attr.mask        := SRW.GSPACING_ATTR;

      srw.attr.gspacing    := SRW.CUSTOM_SPACING;

      srw.attr.custom      := 200;

      srw.set_attr (0, srw.attr);

   end if;

   RETURN (TRUE);

end;


SRW.SET_ATTR - Exemple (basculement d'un bac d'imprimante à l'autre)
SRW.SET_ATTR - Exemple (basculement d’un bac d’imprimante à l’autre)

  Rubriques connexes 	  Tous les exemples

/* L’exemple ci-dessous définit le bac de l’imprimante dans un déclencheur Between Pages.
*/

function BetweenPages return boolean is
begin
   srw.attr.mask             := SRW.PRINTER_INTRAY_ATTR;
   srw.attr.printer_intray   := 'letterhead';
   srw.set_attr(SRW.REPORT_ID, srw.attr);
return (TRUE);
end;


SRW.TRACE_ADD_OPTION

  Rubriques connexes	  Toutes les procédures internes

Description SRW.TRACE_ADD_OPTION permet d'indiquer une nouvelle option de traçage après le début de la journalisation des informations de traçage avec SRW.TRACE_START.

Exemple d'indication de trois options de traçage pour le masque, puis d'appel du masque à l'aide de SRW.TRACE_ADD_OPTION :

SRW.TRACEOPTS.MASK := SRW.TRACE_ERR +
                      SRW.TRACE_BRK +
                      SRW.TRACE_PRF;
SRW.TRACE_ADD_OPTION(SRW.TRACEOPTS);

Syntaxe

SRW.TRACE_ADD_OPTION (SRW.TRACEOPTS);

Paramètres

SRW.TRACEOPTS	Masque des options de traçage préalablement défini par SRW.TRACEOPTS.MASK. Notez que SRW.TRACE_APPEND et SRW.TRACE_REPLACE ne sont pas des options de traçage et ne peuvent pas être utilisées avec SRW.TRACE_ADD_OPTION.


SRW.TRACE_END

  Rubriques connexes	  Toutes les procédures internes

Description SRW.TRACE_END permet de mettre fin à la journalisation des informations de traçage dans un fichier pendant l'exécution d'un état. Pour lancer la journalisation, utilisez SRW.TRACE_START.

Syntaxe

SRW.TRACE_END ();


SRW.TRACE_REM_OPTION

  Rubriques connexes	  Toutes les procédures internes

Description SRW.TRACE_REM_OPTION permet de supprimer des options de traçage.

Exemple d'indication de trois options de traçage pour le masque, puis d'appel du masque à l'aide de SRW.TRACE_REM_OPTION :

SRW.TRACEOPTS.MASK := SRW.TRACE_ERR +
                      SRW.TRACE_BRK +
                      SRW.TRACE_PRF;
SRW.TRACE_REM_OPTION(SRW.TRACEOPTS);

Syntaxe

SRW.TRACE_REM_OPTION (SRW.TRACEOPTS);

Paramètres

SRW.TRACEOPTS	Masque des options de traçage préalablement défini par SRW.TRACEOPTS.MASK. Notez que SRWTRACE_APPEND et SRWTRACE_REPLACE ne sont pas des options de traçage et ne peuvent pas être utilisées avec SRW.TRACE_REM_OPTION.


SRW.TRACE_START

  Restrictions	  Rubriques connexes	  Toutes les procédures internes

Description SRW.TRACE_START permet de lancer la journalisation des options de traçage pendant l'exécution d'un état et de les enregistrer dans un fichier. Pour arrêter la journalisation, utilisez SRW.TRACE_END. Vous pouvez également spécifier les informations à inclure dans le fichier de journalisation. Ces informations peuvent être utiles pour le débogage d'un état ou la détection des goulots d'étranglement au stade de l'exécution. Vous spécifiez les options de traçage à appliquer en définissant un masque. Pour définir des options de traçage dans PL/SQL, procédez de la manière suivante :

1	Spécifiez les options que vous voulez activer.

2	Appliquez les options à l'objet en utilisant SRW.TRACEOPTS lorsque vous appelez la procédure SRW.TRACE_START.

Exemple d'indication de trois options de traçage et de leur appel à l'aide de SRW.TRACE_START.

SRW.TRACEOPTS.MASK := SRW.TRACE_ERR +
                 SRW.TRACE_BRK +
                 SRW.TRACE_PRF;
SRW.TRACE_START(test.dat, SRW.TRACE_APPEND, SRW.TRACEOPTS);

Syntaxe

SRW.TRACEOPTS.MASK := SRW.TRACE_opts [+ SRW.TRACE_opts . . .];

SRW.TRACE_START (nom du fichier,{SRW.TRACE_REPLACE|SRW.TRACE_APPEND}, SRW.TRACEOPTS);

Paramètres

nom_fichier	Nom du fichier dans lequel Report Builder stocke les informations de journalisation.
SRW.TRACE_ APPEND	Les nouvelles informations écrasent les informations précédentes dans le fichier.
SRW.TRACE_ REPLACE	Les nouvelles informations écrasent les informations précédentes dans le fichier.
SRW.TRACE OPTS	Masque des options de traçage préalablement défini par SRW.TRACEOPTS.MASK.
Opts	Option de traçage.


SRW.TRACEOPTS.MASK

  Rubriques connexes	  Toutes les procédures internes

Vous trouverez ci-après les options que vous pouvez appliquer à un masque de traçage :

Option de masque	Description
SRW.TRACE_ALL	Toutes les informations de traçage possibles doivent être enregistrées dans le fichier de journalisation.
SRW.TRACE_APP	Les informations de traçage de tous les objets de l'état doivent être enregistrées dans le fichier de journalisation.
SRW.TRACE_BRK	La liste des points de contrôle doit être enregistrée dans le fichier de journalisation.
SRW.TRACE_DST	La liste des listes de diffusion doit être enregistrée dans le fichier de journalisation. Ces informations peuvent être utilisées pour déterminer la section envoyée ainsi que sa destination.
SRW.TRACE_ERR	Les messages d'erreur et les avertissements doivent être enregistrés dans le fichier de journalisation.
SRW.TRACE_PLS	Les informations de traçage sur tous les objets PL/SQL doivent être enregistrées dans le fichier de journalisation.
SRW.TRACE_PRF	Les statistiques de performances doivent être enregistrées dans le fichier de journalisation.
SRW.TRACE_SQL	Les informations de traçage sur tous les SQL doivent être enregistrées dans le fichier de journalisation.


SRW.TRACE_START - Restrictions

•	Les informations de journalisation ne peuvent être générées que lors de l'exécution d'un fichier .rdf. Vous ne pouvez pas indiquer de journalisation lorsque vous exécutez un fichier .rep.

•	Vous ne pouvez lancer qu'une session à la fois. SRW.TRACE_START met automatiquement fin à toute autre session de journalisation.


SRW.TRUNCATED_VALUE:exemple

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette exception arrête l'exécution de l'état et génère un message d'erreur. Si l'erreur découle d'une attribution PL/SQL, vous verrez apparaître le message :

REP-1435 :  La valeur de la colonne <paramètre/nom de la colonne> a été tronquée.

Si l'erreur provient d'une sortie utilisateur IAF PUT, vous verrez apparaître le message :

REP-1416 :  La sortie utilisateur <nom> IAF PUT : valeur de colonne <paramètre/nom de la colonne> a été tronquée.

Si l'exception SRW.TRUNCATED_VALUE est traitée, la valeur est tronquée et reste attribuée au paramètre ou à la colonne.

Syntaxe

SRW.TRUNCATED_VALUE;

Notes d'utilisation Cette exception est générée lorsqu'une sortie utilisateur ou un élément PL/SQL tente d'attribuer à un paramètre ou à une colonne une valeur plus large que la largeur maximum de l'objet.


SRW.TRUNCATED_VALUE - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez remplacer le message d'erreur
** par défaut de SRW.TRUNCATED_VALUE par votre propre message d'erreur.
** Vous pourriez traiter cette exception de la manière suivante :
*/

EXCEPTION

when SRW.TRUNCATED_VALUE then

   srw.message(2000, 'Contacter Jean Martin :

       SRW.TRUNCATED_VALUE.');


SRW.UNKNOWN_QUERY:exemple

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette exception arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1427 :  Nom d'interrogation indiqué dans SRW.SET_MAXROW.

Syntaxe

SRW.UNKNOWN_QUERY;

Notes d'utilisation Cette exception est générée lorsque l'appel de la procédure en package SRW.SET_MAXROW comporte une interrogation inconnue.


SRW.UNKNOWN_QUERY - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vos vouliez remplacer le message d'erreur
** par défaut de SRW.UNKNOWN_QUERY par votre propre message d'erreur.
** Vous pourriez traiter cette exception de la manière suivante :
*/

EXCEPTION

when SRW.UNKNOWN_QUERY then

   srw.message(4000, 'Contacter Charles Matineau :

       SRW.UNKNOWN_QUERY.');

   raise srw.program_abort;


SRW.UNKNOWN_USER_EXIT:exemple

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Si votre sortie utilisateur est inconnue (par exemple, parce qu'elle n'est pas liée), cette exception arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1415 : Sortie utilisateur inconnue.

Syntaxe

SRW.UNKNOWN_USER_EXIT;

Notes d'utilisation Cette exception est générée lorsque la sortie utilisateur spécifiée pour la procédure en package SRW.USER_EXIT ou SRW.USER_EXIT20 ne peut pas être localisée (par exemple, parce que la sortie utilisateur n'a pas été liée).


SRW.UNKNOWN_USER_EXIT - Exemple

  Rubriques connexes 	  Tous les exemples

Supposons que vous vouliez remplacer le message d'erreur par défaut (ci-dessus) par votre propre message d'erreur. Vous pourriez traiter cette exception de la manière suivante :

EXCEPTION

   WHEN srw.unknown_user_exit then

        srw.message(200, 'SORTIE UTILISATEUR INCONNUE.

                    VERIFIER SES LIENS.');


SRW.USER_EXIT:exemple

  Restrictions	  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette procédure appelle la sortie utilisateur nommée dans chaîne_sortie_utilisateur. Elle est utile pour passer le contrôle à un programme en langage de 3e génération pendant l'exécution d'un état.

Syntaxe

SRW.USER_EXIT (chaîne de sortie utilisateur CHAR);

Paramètres

chaîne de sortie_utilisateur	Nom de la sortie utilisateur que vous voulez appeler et colonnes ou paramètres que vous voulez transmettre au programme de sortie utilisateur.


SRW.USER_EXIT - Restrictions

•	Les sorties utilisateur ne sont pas portables. Si votre état doit être portable et si vous devez y ajouter une clause conditionnelle, utilisez PL/SQL.

•	Si la chaîne de sortie utilisateur transmet une colonne ou un paramètre au programme de sortie utilisateur, SRW.REFERENCE doit être appelé avant cette procédure.


SRW.USER_EXIT - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous ayez une sortie utilisateur appelée STOCKAGE à laquelle vous voulez
** transmettre les valeurs des salaires provenant de Report Builder. Pour cela, vous
** pourriez écrire la formule ci-après. Pour plus d'informations sur
** la façon d'appeler les sorties utilisateur, reportez-vous à Appel d'une sortie utilisateur.
*/

FUNCTION FOO RETURN BOOLEAN IS

BEGIN

IF :SAL >= 0 THEN

   SRW.REFERENCE(:SAL);

   SRW.USER_EXIT('STOCKAGE SAL');

ELSE

   SRW.MESSAGE(100, 'DETECTION D'UN SALAIRE NEGATIF. VERIFIER

 LA TABLE EMP.');

END IF;

EXCEPTION

    WHEN SRW.UNKNOWN_USER_EXIT THEN

         SRW.MESSAGE(200, 'SORTIE UTILISATEUR STOCKAGE INCONNUE.

                     VERIFIER SES LIENS.');

    WHEN SRW.USER_EXIT_FAILURE THEN

         SRW.MESSAGE(200, 'ECHEC DE LA SORTIE UTILISATEUR.

                     VERIFIER SON CODE.');

RETURN(TRUE);

END;


SRW.USER_EXIT20

  Rubriques connexes	  Toutes les procédures internes

Description Cette procédure est pratiquement la même que SRW.USER_EXIT, la seule différence étant qu'elle appelle la sortie utilisateur avec cinq arguments, et non simplement deux. Elle vous permet de partager des sorties utilisateur avec d'autres produits Oracle, comme Oracle Forms, qui transmettent cinq arguments au lieu de deux.

SRW.USER_EXIT transmet, lors de l'appel d'une sortie utilisateur, les arguments suivants :

•	la chaîne de caractères que vous spécifiez ;

•	un pointeur sur la longueur de la chaîne de caractères ;

SRW.USER_EXIT20 transmet, lors de l'appel d'une sortie utilisateur, les arguments suivants :

•	la chaîne de caractères que vous spécifiez ;

•	un pointeur sur la longueur de la chaîne de caractères ;

•	une chaîne d'erreur (cet argument n'est pas utilisé par Report Builder et transmet toujours une valeur ' ') ;

•	un pointeur sur la longueur de la chaîne d'erreur (cet argument n'est pas utilisé par Report Builder et transmet toujours la valeur 0) ;

•	un argument d'interrogation (cet argument n'est pas utilisé par Report Builder et transmet toujours la valeur 0).

Syntaxe

SRW.USER_EXIT20 (chaîne de sortie utilisateur CHAR);

Paramètres

chaîne de sortie_utilisateur	Nom de la sortie utilisateur que vous voulez appeler et colonnes ou paramètres que vous voulez transmettre au programme de sortie utilisateur.


SRW.USER_EXIT_FAILURE:exemple

  Exemples	  Rubriques connexes	  Toutes les procédures internes

Description Cette exception est générée lorsque la sortie utilisateur que vous avez appelée a échoué. Lorsqu'elle est appelée, elle arrête l'exécution de l'état et génère le message d'erreur suivant :

REP-1416 : Echec de la sortie utilisateur <nom de la sortie>.

Syntaxe

SRW.USER_EXIT_FAILURE;

Notes d'utilisation Cette exception est générée lorsque le tampon SRWERB n'est pas vide.


SRW.USER_EXIT_FAILURE - Exemple

  Rubriques connexes 	  Tous les exemples

/* Supposons que vous vouliez que le message d'erreur par défaut (ci-dessus)
** soit remplacé par votre propre message d'erreur. Le code PL/SQL ci-après
** signalera un message d'erreur personnalisé pour SRW.USER_EXIT_FAILURE.
*/

EXCEPTION

    when SRW.USER_EXIT_FAILURE then

         SRW.MESSAGE(200, 'Echec de la sortie utilisateur <nom de la sortie>.

                     Vérifier son code.');


Palette de motifs

Les motifs de la palette de motifs de Report Builder sont présentés dans les illustrations suivantes :

 Cliquez ici.

 Cliquez ici.


Palette de couleurs par défaut

La palette de couleurs par défaut est celle utilisée par Report Builder si vous n'en indiquez aucune autre dans vos préférences. Le fichier de la palette de couleurs a pour nom default.pal. Pour plus d'informations sur l'emplacement de ce fichier sur votre système, reportez-vous au Installation Guide correspondant à votre système d'exploitation.

La palette de couleurs par défaut est définie par les règles suivantes :

•	La zone supérieure gauche de la palette contient 16 couleurs couramment utilisées dont voici les noms :

noir     blanc          vert       vert foncé

gris     gris foncé     cyan       cyan foncé

rouge    rouge foncé    bleu       bleu foncé

jaune    jaune foncé    magenta    magenta foncé

•	La zone inférieure gauche de la palette contient huit cellules vides dans lesquelles vous pouvez placer des couleurs personnalisées.

•	Les cinq colonnes suivantes sont composées de différentes nuances de gris. Chaque couleur est nommée " gris<valeur> ", en fonction de son pourcentage de gris. Les valeurs vont de 4 à 96, par incréments de 4. Par exemple, " gris96 ", " gris92 " et " gris4 " sont des noms de couleur valides.

•	Le reste de la palette contient des couleurs caractérisées par différents pourcentages de rouge, vert et bleu (dites couleurs RGB).

•	Les pourcentages de rouge ou de vert sont 0, 25, 50, 75, 88 ou 100

•	Les pourcentages de bleu sont 0, 50, 75, 88 ou 100.

Chaque couleur porte un nom sous la forme" r<valeur>g<valeur>b<valeur>', en fonction de ses valeurs RGB (par exemple, une couleur composée de 100% de rouge, 0% de vert et 88% de bleu porte le nom " r100g0b88 ").

•	Outre les cellules de couleur décrites ci-dessus, la palette est divisée en cinq zones principales, chacune contenant 36 couleurs, organisées 6 par 6. Ces couleurs sont définies selon les règles suivantes :

•	La valeur de rouge augmente au fur et à mesure que les couleurs progressent de gauche à droite dans chaque zone principale.

•	La valeur de vert augmente au fur et à mesure que les couleurs progressent de haut en bas dans chaque zone principale.

•	La valeur de bleu augmente au fur et à mesure que les zones principales progressent de gauche à droite, toutes les couleurs d'une même zone utilisant la même valeur de bleu.


Palette de nuances de gris

La palette de nuances de gris est composée entièrement de différents degrés de gris. Elle est définie par les règles suivantes :

•	Les deux premières colonnes s'appellent " noir " et " blanc ".

•	Le reste de la palette contient des couleurs caractérisées par différents pourcentages de gris. Chaque couleur s'appelle " gris<valeur> ", en fonction de sa valeur de gris. Ces couleurs sont définies par les règles suivantes.

•	La valeur de gris de la première couleur grise (à droite de " blanc ") est 100% et son nom est " gris100 ".

•	Au fur et à mesure que les couleurs progressent de gauche à droite dans la palette (en passant de la cellule la plus à droite d'une ligne à la cellule la plus à gauche de la suivante), la valeur de gris de chaque couleur  diminue de 0,5 par rapport à la précédente.

•	En-dessous de " gris12,5 ", la valeur de gris de chaque couleur est de 0,25 inférieure à celle de la précédente.

•	Les valeurs de gris continuent de diminuer jusqu'à la dernière couleur de la palette, nommée " gris0 ".


Palette de couleurs Oracle CDE1

La palette de couleurs Oracle CDE1 était la palette de couleurs par défaut de la version 2.0. Elle est définie par les règles suivantes :

•	Les deux premières colonnes de la palette contiennent :

•	les couleurs couramment utilisées, nommées " bleu ",  " magenta ", " rouge ", " cyan ", " vert " et " jaune " ;

•	les nuances de gris, nommées " noir ", " gris60 ", " gris45 ", " gris30 ",  " gris30 " et " blanc ".

•	Le reste de la palette contient des couleurs caractérisées par différents pourcentages de rouge, de vert et de bleu (dites couleurs RGB). Les pourcentages de chaque composants sont 0, 40, 55, 70, 85 ou 100.

Chaque couleur porte un nom sous la forme" r<valeur>g<valeur>b<valeur>', en fonction de ses valeurs RGB (par exemple, une couleur composée de 100% de rouge, 40% de vert et 0% de bleu porte le nom " r100g40b0 ").

Outre les deux premières colonnes, la palette est divisée en six zones principales, chacune contenant 36 couleurs, organisées 6 par 6. Ces couleurs sont définies selon les règles suivantes :

•	La valeur de rouge augmente au fur et à mesure que les couleurs progressent de gauche à droite dans chaque zone principale.

•	La valeur de vert augmente au fur et à mesure que les couleurs progressent de haut en bas dans chaque zone principale.

•	La valeur de bleu augmente au fur et à mesure que les zones principales progressent de gauche à droite, toutes les couleurs d'une même zone utilisant la même valeur de bleu.


Messages de Query Builder

  Rubriques connexes

Cliquez sur une série de messages, puis utilisez les boutons de défilement page à page jusqu'au message qui vous intéresse.

BRW-15000 à BRW-15092

BRW-15093 à BRW-15146

BRW-15147 à BRW-15196

BRW-15197 à BRW-15390

BRW-15391 à BRW-15424

BRW-15430 à BRW-15520

BRW-15521 à BRW-15569

BRW-15570 à BRW-15912

BRW-15913 à BRW-16551

BRW-16552 à BRW-16660


BRW-15000 : Erreur interne dans le gestionnaire d'erreur de Query Builder

Cause :	Le gestionnaire d'erreurs n'a pas pu être lancé.

Action :	Contactez le Support technique Oracle.


BRW-15001 : <numéro de message>

Cause :	Le fichier de messages est introuvable ou incompatible avec cette version de Query Builder.

Action :	Vérifiez la présence du fichier de messages approprié dans le répertoire Query Builder d'Oracle Home.


BRW-15002 : Mémoire insuffisante !

Cause :	Mémoire insuffisante.

Action :	Enregistrez vos documents et relancez Oracle Query Builder.


BRW-15003 : Nom de fichier incorrect : <nom>

Cause :	L'utilisateur a entré un nom de fichier non valide (comprenant, par exemple, trop de caractères).

Action :	Entrez un nom de fichier valide.


BRW-15004 : Erreur interne (<valeur1>:<valeur2>)

Cause :	Il s'est produit une erreur interne. Oracle Query Builder est dans un état non fiable.

Action :	Contactez le Support technique Oracle.


BRW-15005 : Aucun nom de fichier indiqué

Cause :	L'utilisateur n'a pas entré de nom de fichier dans la boîte de dialogue Export de données.

Action :	Entrez un nom de fichier.


15006 : Description impossible (DESCRIBE) de la table de données

Cause :	Message interne.

Action :	Contactez le Support technique Oracle.


BRW-15007 : Instruction SQL trop complexe à afficher

Cause :	La taille de la mémoire tampon d'édition de MSWINDOWS est dépassée.

Action :	Supprimez certaines colonnes de l'interrogation pour diminuer la taille de l'instruction SQL.


BRW-15009 : Privilèges insuffisants pour se connecter via Oracle Query Builder

Cause :	Les privilèges de connexion sont désactivés dans la table SYSTEM.BROWSER_PROFILE.

Action :	Contactez votre administrateur de bases de données.


BRW-15065 : Erreur de syntaxe

Cause :	L'utilisateur a entré une formule incorrecte.

Action :	Entrez à nouveau l'expression.


BRW-15066 : Expression trop complexe

Cause :	Expression trop complexe.

Action :	Simplifiez l'expression.


BRW-15068 : Fonction inconnue : <nom>

Cause :	L'utilisateur a entré un nom de fonction non valide.

Action :	Indiquez une fonction valide.


BRW-15069 : Colonne non valide : <nom>

Cause :	L'utilisateur a entré un nom de colonne non valide.

Action :	Entrez un nom de colonne valide.


BRW-15070 : Table non valide : <nom>

Cause :	L'utilisateur a entré un nom de table non valide.

Action :	Entrez un nom de table valide.


BRW-15071 : Propriétaire non valide : <nom>

Cause :	L'utilisateur a entré un nom d'entité ou un nom d'utilisateur non valide.

Action :	Entrez un nom d'entité ou un nom d'utilisateur valide.


BRW-15072 : Condition non valide

Cause :	L'utilisateur a entré une condition non valide.

Action :	Supprimez la condition et entrez une condition valide.


BRW-15073 : Expression non valide

Cause :	L'utilisateur a entré une expression non valide (généralement un blanc).

Action :	Entrez une expression valide.


BRW-15074 : Utilisation erronée du mot réservé <nom>

Cause :	L'utilisateur a utilisé un mot réservé comme identificateur.

Action :	Les identificateurs ne peuvent pas être des mots réservés. Pour plus de détails, reportez-vous à l'aide ou à la documentation.


BRW-15075 : Fonction <nom> : nombre d'arguments erroné

Cause :	L'utilisateur a entré trop peu ou trop d'arguments pour la fonction indiquée.

Action :	Entrez les arguments appropriés. Pour plus de détails, reportez-vous à l'aide ou à la documentation.


BRW-15077 : Nom ambigu : <nom>

Cause :	L'utilisateur a entré un nom de colonne ambigu.

Action :	Entrez un nom de colonne spécifique et éventuellement des qualificateurs.


BRW-15078 : Redéfinition du nom  <nom>

Cause :	L'utilisateur a redéfini une table de données ou une colonne en utilisant un nom qui existe déjà.

Action :	Définissez la colonne ou la table en utilisant un nouveau nom.


BRW-15079 : Aucune colonne sélectionnée dans l'interrogation

Cause :	L'interrogation a été créée ou entrée sans que des colonnes soient affichées.

Action :	Sélectionnez des colonnes avant d'exécuter à nouveau l'interrogation.


BRW-15080 : Aucune table indiquée dans l'interrogation

Cause :	L'utilisateur a entré une interrogation sans indiquer de tables.

Action :	Sélectionnez des tables avant d'exécuter à nouveau l'interrogation.


BRW-15081 : La commande START WITH exige CONNECT BY

Cause :	L'instruction SQL contenait une clause START WITH sans clause CONNECT BY.

Action :	Indiquez une clause CONNECT BY si vous avez l'intention d'utiliser START WITH.


BRW-15082 : La commande PRIOR exige CONNECT BY

Cause :	L'instruction SQL contenait une clause PRIOR sans clause CONNECT BY.

Action :	Indiquez une clause CONNECT BY si vous avez l'intention d'utiliser PRIOR.


BRW-15083 : Fonction <nom> : argument incorrect

Cause :	L'utilisateur a entré, pour la fonction, un type d'argument erroné.

Action :	Entrez un type d'argument correct.


BRW-15084 : Commentaire interrompu

Cause :	La mémoire tampon en cours de lecture comporte un commentaire de type C non déterminé.

Action :	Editez le fichier (en veillant à ce qu'il se termine correctement) et ouvrez-le à nouveau à partir de Query Builder.


BRW-15085 : Présence de référence circulaire dans la colonne définie

Cause :	La modification d'une colonne définie a conduit à une référence circulaire.

Action :	Redéfinissez la colonne afin qu'elle ne fasse pas référence à elle-même dans sa propre définition.


BRW-15086 : Les arguments d'une fonction de sous-interrogation corrélative doivent être de type colonne

Cause :	Vous avez fourni un argument complexe (comme sal, deptno*2).

Action :	Indiquez uniquement des colonnes valides, et non des expressions, dans la sous-interrogation.


BRW-15087 : Emplacement non valide : <nom>

Cause :	L'utilisateur a entré une adresse de base de données non valide pour une table.

Action :	Entrez une adresse de base de données valide.


BRW-15088 : Table ambiguë : <nom>

Cause :	L'utilisateur a entré un nom de table de données ambiguë (que plusieurs tables utilisent).

Action :	L'utilisateur doit fournir davantage de qualificatifs pour la table de données. Pour plus de détails, reportez-vous à l'aide ou à la documentation.


BRW-15089 : Un seul opérateur PRIOR autorisé dans une expression

Cause :	L'utilisateur a entré plusieurs clauses PRIOR dans une expression.

Action :	Supprimez l'une des clauses PRIOR.


BRW-15090 : Le nom <nom> est déjà utilisé

Cause :	L'utilisateur a entré un nom qui était déjà utilisé.

Action :	Entrez un nouveau nom.


BRW-15091 : Nom erroné : <nom>

Cause :	L'utilisateur a entré un nom qui n'était pas valide (qui comportait des espaces ou des caractères impossibles à imprimer).

Action :	Entrez un nouveau nom.


BRW-15092 : Mauvaise utilisation d'une relation externe

Cause :	L'utilisateur a indiqué une relation extérieure dans un élément autre qu'une colonne.

Action :	Les relations extérieures ne sont valides que pour les colonnes.


BRW-15093 : Nombre d'éléments erronés dans l'enregistrement correspondant

Cause :	L'utilisateur a entré deux d'enregistrements ayant des nombres d'éléments différents.

Action :	Entrez à nouveau la condition.


BRW-15094 : Fonction de groupe trop imbriquée

Cause :	L'utilisateur a entré une condition (expression) globale double (triple).

Action :	Simplifiez la condition ou l'expression globale.


BRW-15096 : Nom de table en conflit avec <nom1>, renommé en <nom2>

Cause :	Lors de l'ouverture d'une interrogation, un nom d'alias de table est en conflit avec une nouvelle colonne.

Action :	L'utilisateur peut renommer l'alias.


BRW-15097 : Nom en conflit avec <nom1>, renommé en <nom2>

Cause :	Lors du chargement d'une interrogation enregistrée, un nom d'alias est en conflit avec une nouvelle colonne.

Action :	Renommez l'alias.


BRW-15098 : Table <nom> dupliquée dans la clause FROM

Cause :	La table de données figure plusieurs fois dans la clause FROM (sans alias).

Action :	Supprimez de la clause FROM les tables de données dupliquées.


BRW-15099 : La sous-interrogation ramène un nombre incorrect de valeurs

Cause :	La sous-interrogation retourne trop peu ou trop de valeurs.

Action :	Entrez à nouveau la condition.


BRW-15100 : Les expressions corrélatives ne sont pas autorisées dans ce cas

Cause :	L'utilisateur a entré une expression corrélative en dehors d'une condition.

Action :	Entrez à nouveau la condition ou l'expression.


BRW-15101 : Pseudonyme de table non ré-utilisable dans la même clause FROM : <nom>

Cause :	L'utilisateur a tenté d'utiliser un alias dans la même clause FROM que celle dans laquelle il avait été défini.

Action :	Supprimez la référence à l'alias.


BRW-15102 : Trop d'éléments dans cet enregistrement

Cause :	L'utilisateur a entré un enregistrement comportant plus de 254 éléments.

Action :	Diminuez le nombre d'éléments - fractionnez la condition en éléments OR.


BRW-15103 : Instruction SELECT sans nom dans la clause FROM

Cause :	La clause SQL FROM contient une interrogation sans nom.

Action :	Ajoutez le nom de l'interrogation et relancez l'analyse.


BRW-15110 : Numéro erroné ou précision dépassée <nom_colonne>
BRW-15110 : Numéro erroné ou précision dépassée : <nom_colonne>

Cause :	Entrée non numérique ou valeur numérique dépassant la précision de cette colonne.

Action :	Entrez à nouveau une valeur numérique et une précision valides.


BRW-15111 : Date non valide : <valeur>

Cause :	Le masque de format de colonnes ou le masque par défaut ne permet pas la mise en forme.

Action :	Entrez à nouveau un masque de format valide.


BRW-15112 : La chaîne de caractères entrée dépasse la limite permise pour cette colonne : <##>

Cause :	L'utilisateur a entré une chaîne dépassant la limite autorisée par cette colonne.

Action :	Entrez un chaîne plus courte.


BRW-15113 : Tous les paramètres n'ont pas été indiqués

Cause :	L'utilisateur a tenté d'exécuter une interrogation sans définir tous les paramètres.

Action :	Indiquez les paramètres nécessaires ou excluez les expressions paramétrées et relancez l'opération.


BRW-15114 : Les paramètres ne peuvent être que des expressions constantes

Cause :	L'utilisateur a tenté d'entrer une valeur de paramètre dépendant d'une valeur de colonne.

Action :	Indiquez un paramètre valide, qui ne dépend pas de la valeur d'une colonne.


BRW-15115 : Mauvaise utilisation du paramètre <nom>

Cause :	L'utilisateur a entré un nom de paramètre pour une colonne ou une table.

Action :	Indiquez un paramètre valide.


BRW-15116 : Nom de paramètre non valide <nom>

Cause :	L'utilisateur a entré un nom de paramètre non valide.

Action :	Indiquez un nom de paramètre valide.


BRW-15117 : Paramètre non valide <nom>

Cause :	L'utilisateur a entré un paramètre non valide.

Action :	Indiquez un paramètre valide.


BRW-15128 : Erreur interne dans l'analyseur : <valeur>

Cause :	Erreur interne de l'analyseur/scanneur.

Action :	Contactez le Support technique Oracle.


BRW-15129 : La colonne dérivée <nom> n'est pas un argument autorisé dans une sous-interrogation corrélative

Cause :	Utilisation de colonnes dérivées (DQ4) dans une sous-interrogation corrélative.

Action :	Supprimez cet argument de la sous-interrogation corrélative.


BRW-15130 : Echec d'exécution de l'interrogation

Cause :	Erreur d'accès à la base de données.

Action :	Etudiez l'erreur et relancez l'interrogation.


BRW-15131 : Opérateur relationnel non valide

Cause :	L'utilisateur a appliqué à une condition un opérateur non valide.

Action :	Entrez un opérateur valide.


BRW-15132 : Absence de clause FROM à l'emplacement prévu

Cause :	Une clause FROM n'est pas précédée d'une clause FROM ou d'une clause GROUP/HAVING.

Action :	Editez une instruction SQL.


BRW-15133 : Présence de clause FROM sans clause SELECT correspondante

Cause :	Une clause FROM n'est pas précédée d'une clause SELECT.

Action :	Editez une instruction SQL.


BRW-15135 : Condition non modifiable

Cause :	L'utilisateur a tenté de modifier la première condition de l'Editeur de schémas.

Action :	Exécutez l'opération sur les conditions fils.


BRW-15136 : SQL contient des opérateurs d'ensemble

Cause :	Les opérateurs d'ensemble ne sont pas pris en compte.

Action :	Exécutez l'interrogation dans SQL*Plus.


BRW-15137 : Génération impossible des noms des expressions complexes

Cause :	Lors de l'ouverture d'un fichier SQL, le programme a rencontré des expressions sans nom.

Action :	Définissez des noms de colonne dans le fichier .sql.


BRW-15138 : La clause CONNECT BY existe, mais n'a pas été prise en compte

Cause :	La clause CONNECT BY n'est pas prise en compte à ce niveau (supérieur).

Action :	Exécutez l'interrogation dans SQL*Plus si vous voulez obtenir des résultats de CONNECT BY.


BRW-15139 : Impossible de séparer la condition

Cause :	Tentative de séparation d'une condition supérieure.

Action :	Cette opération n'est pas prise en charge.


BRW-15141 : La table d'interrogation ne peut pas contenir de paramètres

Cause :	Lors de la création d'une vue, le système a rencontré un ou plusieurs paramètres.

Action :	Excluez les paramètres de l'interrogation ou ignorez-les.


BRW-15142 : Deux colonnes au moins ont le même nom : <nom>

Cause :	Lors de la création d'une vue, le système a rencontré des noms de colonne en double.

Action :	Utilisez la commande Define pour renommer les colonnes en double.


BRW-15143 : <nom> est déjà une colonne affichée

Cause :	L'utilisateur a tenté d'indiquer une colonne d'affichage en double.

Action :	Pour avoir des colonnes en double, donnez un nouveau nom à la colonne et affichez-la à nouveau.


BRW-15144 : <nom> est déjà une colonne de tri

Cause :	L'utilisateur a tenté d'indiquer une colonne de tri en double.

Action :	Pour avoir des colonnes en double, donnez un nouveau nom à la colonne et triez-la à nouveau.


BRW-15145 : <nom> est déjà une colonne de groupe

Cause :	L'utilisateur a tenté d'indiquer une colonne de groupe en double.

Action :	Pour avoir des colonnes en double, donnez un nouveau nom à la colonne et regroupez-les à nouveau.


BRW-15146 : Erreur interne lors de l'ouverture de l'interrogation

Cause :	Erreur interne pendant l'ouverture de l'interrogation.

Action :	Contactez le Support technique Oracle..


BRW-15147 : Erreur interne lors de la sauvegarde de l'interrogation

Cause :	Il s'est produit une erreur interne pendant l'enregistrement de l'interrogation.

Action :	Contactez le Support technique Oracle..


BRW-15148 : Une relation doit être définie entre des types de données/tailles compatibles

Cause :	L'utilisateur a tenté d'établir une relation entre deux colonnes ayant des types de données incompatibles.

Action :	N'établissez de relations qu'entre des types de données compatibles. Pour tous détails, reportez-vous à l'aide ou à la documentation.


BRW-15150 : Définition impossible d'auto-relation

Cause :	L'utilisateur a tenté de définir une relation dans une table de données.

Action :	Définissez un pseudonyme pour la table de données, puis définissez la relation.


BRW-15151 : La relation définie par l'utilisateur existe déjà

Cause :	L'utilisateur a tenté de définir une relation qui existe déjà.

Action :	Aucune.


BRW-15152 : Colonne non autorisée dans cette relation

Cause :	L'utilisateur a indiqué une expression non valide lorsqu'il a défini une relation.

Action :	Entrez une nouvelle colonne.


BRW-15153 : Un alias de table ne peut pas se terminer par _A<nombre>

Cause :	Nom d'alias non valide.

Action :	Entrez un nouveau nom qui ne se termine pas par _A<nombre>.


BRW-15154 : Suppression impossible de la relation de base de données

Cause :	L'utilisateur a tenté de supprimer la relation de dictionnaire de base de données.

Action :	Seules les relations définies par l'utilisateur peuvent être supprimées.


BRW-15155 : Il se peut que les documents suivants aient été touchés : <nom>

Cause :	Une interrogation enregistrée a été utilisée comme table de données dans d'autres documents d'interrogation.

Action :	Si vous modifiez ou supprimez cette interrogation, ces autres interrogations seront également concernées.


BRW-15156 : Impossible d'inclure une table portant le même nom que l'interrogation

Cause :	L'utilisateur a tenté d'inclure une table de données D dans un document d'interrogation D.

Action :	Renommez l'interrogation avant d'inclure cette table.


BRW-15157 : Opérations de tri, de groupe ou de ventilation impossibles sur des colonnes de type LONG

Cause :	Tentative d'exécution d'opérations de tri, de groupe ou de ventilation sur une colonne de type LONG.

Action :	Annulez l'opération. Elle n'est pas prise en charge par Oracle.


BRW-15158 : Opérations de tri, de groupe ou de ventilation impossibles sur des colonnes de type RAW

Cause :	Tentative d'exécution d'opérations de tri, de groupe ou de ventilation sur une colonne de type RAW.

Action :	Annulez l'opération. Elle n'est pas prise en charge par Oracle.


BRW-15159 : Affichage impossible de colonnes de type LONG à partir de bases de données éloignées

Cause :	Tentative d'inclusion de colonnes de type LONG à partir de bases de données éloignées.

Action :	Annulez l'opération. Elle n'est pas prise en charge par Oracle.


BRW-15160 : Nombre maximum <##> de colonnes dépassé

Cause :	L'utilisateur a dépassé le nombre maximum de colonnes d'affichage/de groupe/de tri admis.

Action :	Supprimez les colonnes dont vous n'avez pas besoin, puis ajoutez celles dont vous avez besoin


BRW-15161 : Erreur d'ouverture de la/des colonne(s) affichée(s) <nom_colonne(s)>

Cause :	Impossible d'ouvrir une colonne d'affichage, car la base de données a été modifiée depuis l'enregistrement.

Action :	Cette colonne peut avoir été modifiée ou ne plus exister dans la base de données.


BRW-15162 : Erreur d'ouverture de la/des colonne(s) de tri <nom_colonne(s)>

Cause :	Impossible d'ouvrir une colonne de tri, car la base de données a été modifiée depuis l'enregistrement.

Action :	Cette colonne peut avoir été modifiée ou ne plus exister dans la base de données.


BRW-15163 : Erreur d'ouverture de la/des colonne(s) de groupement <nom_colonne(s)>

Cause :	Impossible d'ouvrir une colonne de groupement, car la base de données a été modifiée depuis l'enregistrement.

Action :	Cette colonne peut avoir été modifiée ou ne plus exister dans la base de données.


BRW-15164 : Erreur d'ouverture de la/des colonne(s) de ventilation <nom_colonne(s)>

Cause :	Impossible d'ouvrir une colonne de ventilation, car la base de données a été modifiée depuis l'enregistrement.

Action :	Cette colonne peut avoir été modifiée ou ne plus exister dans la base de données.


BRW-15165 : Nombre maximum <##> de colonnes de ventilation dépassé

Cause :	L'utilisateur a dépassé le nombre maximum de colonnes de ventilation prises en charge.

Action :	Supprimez les colonnes de ventilation dont vous n'avez plus besoin, puis entrez à nouveau celles dont vous avez besoin.


BRW-15166 : Erreur d'ouverture de la/des conditions <valeur>

Cause :	Impossible d'ouvrir les conditions indiquées, car la base de données a été modifiée depuis l'enregistrement.

Action :	Les tables ou les colonnes utilisées dans cette condition peuvent ne plus exister dans la base de données.


BRW-15167 : Le pseudonyme doit comporter <##> octets ou moins : <nom>

Cause :	Le nom du pseudonyme est trop long.

Action :	Essayez d'entrer un pseudonyme ayant au maximum 30 octets de long.


BRW-15168 : Opération de groupement impossible sur expression globale

Cause :	Tentative d'exécution d'un groupement sur une expression globale.

Action :	Exécutez un groupement sur une autre expression.


BRW-15169 : <nom> a déjà été défini comme colonne de ventilation

Cause :	L'utilisateur a tenté d'indiquer une colonne de ventilation dupliquée.

Action :	Si vous voulez une colonne dupliquée, donnez-lui un nouveau nom et relancez la ventilation.


BRW-15170 : Contrainte non valide pour la table <nom>

Cause :	L'utilisateur a entré une contrainte non valide pour la table sélectionnée.

Action :	Entrez à nouveau la contrainte.


BRW-15171 : Contrainte non valide pour la colonne de table <nom>

Cause :	L'utilisateur a entré une contrainte non valide pour la colonne sélectionnée.

Action :	Entrez à nouveau la contrainte.


BRW-15172 : Les sous-interrogations ne sont pas autorisées dans les contraintes

Cause :	L'utilisateur a entré une contrainte non valide.

Action :	Entrez à nouveau la contrainte.


BRW-15173 : Les conditions globales ne sont pas autorisées dans les contraintes

Cause :	L'utilisateur a entré une contrainte non valide.

Action :	Entrez à nouveau la contrainte.


BRW-15174 : Les contraintes ne peuvent porter que sur une seule table

Cause :	L'utilisateur a entré une contrainte non valide.

Action :	Entrez à nouveau la contrainte.


BRW-15175 : Le masquage de toutes les colonnes entraîne le non chargement de la table

Cause :	Toutes les colonnes sont masquées. Au moins l'une d'entre elles doit être affichée.

Action :	Utilisez l'utilitaire Query Builder Administrator pour afficher les colonnes masquées.


BRW-15188 : 1 ligne ramenée

Cause :	Message d'état pour une ligne ramenée.

Action :	Aucune.


BRW-15189 : <##> lignes ramenées

Cause :	Message d'état pour n lignes ramenées.

Action :	Aucune.


BRW-15190 : Décompte impossible sans exécution ; l'interrogation ramène <= <##> ligne(s)

Cause :	Message d'état pour différence de n lignes ramenées.

Action :	Aucune.


BRW-15192 : Format <nom1> non autorisé pour la colonne '<nom2>'

Cause :	L'utilisateur a entré un format non reconnaissable pour une colonne d'affichage.

Action :	Essayez un autre format.


BRW-15193 : Format non autorisé

Cause :	L'utilisateur a entré un format non reconnaissable pour une colonne d'affichage.

Action :	Essayez un autre format.


BRW-15195 : Type de colonne incompatible dans la relation : <nom>

Cause :	Tentative de création d'une relation non valide.

Action :	Les types de colonne ne sont pas compatibles. Pour plus de détails, reportez-vous à l'aide ou à la documentation.


BRW-15196 : Erreur d'ouverture de <nom(s)> table(s)

Cause :	Impossible d'ouvrir des tables de données, car la base de données a été modifiée ou l'objet n'existe pas.

Action :	Vérifiez votre chaîne de connexion (ou contactez l'administrateur de bases de données).


BRW-15197 : Erreur de restauration de position pour la ou les colonnes <nom>

Cause :	La colonne n'a pas pu être repositionnée, car la base de données a été modifiée ou l'objet n'existe pas.

Action :	Vérifiez votre chaîne de connexion (ou contactez l'administrateur de bases de données).


BRW-15198 : Erreur de restauration de jointure : <valeur>

Cause :	Le lien n'a pas pu être restauré pendant l'ouverture, car la base de données a été modifiée ou l'objet n'existe pas.

Action :	Vérifiez votre chaîne de connexion (ou contactez l'administrateur de bases de données).


BRW-15199 : Erreur de restauration de l'état d'inclusion : <valeur>

Cause :	L'état d'inclusion n'a pas pu être défini pendant l'ouverture, car la base de données a été modifiée ou l'objet n'existe pas.

Action :	Vérifiez votre chaîne de connexion (ou contactez l'administrateur de bases de données).


BRW-15200 : Erreur de restauration d'un état de jointure externe pour la jointure : <valeur>

Cause :	La jointure externe n'a pas pu être définie pendant  l'ouverture, car la base de données a été modifiée ou l'objet n'existe pas.

Action :	Vérifiez votre chaîne de connexion (ou contactez l'administrateur de bases de données).


BRW-15258 : Nom de document non valide : <nom>

Cause :	L'utilisateur a entré un nom de document non valide.

Action :	Entrez un nom de document valide.


BRW-15259 : Le document dépasse la taille maximum autorisée de 64 Ko

Cause :	L'utilisateur a tenté d'enregistrer/d'ouvrir un document de plus de 64 Ko.

Action :	Diminuez la taille du document.


BRW-15260 : Le document <nom> n'existe pas

Cause :	L'utilisateur a indiqué un document qui n'existe pas.

Action :	Indiquez un autre document.


BRW-15261 : Le document <nom> existe déjà

Cause :	L'utilisateur a tenté d'enregistrer un document sous le nom d'un document existant.

Action :	Indiquez un autre nom de document ou supprimez le document existant.


BRW-15262 : Plusieurs documents du même nom <nom>

Cause :	Il existe plusieurs documents portant le même nom.

Action :	Supprimez-les tous sauf un.


BRW-15263 : L'objet de base de données <nom> existe déjà

Cause :	L'utilisateur a tenté d'enregistrer un document sous le nom d'un objet existant.

Action :	Indiquez un autre nom de document.


BRW-15264 : La table <nom> n'existe pas

Cause :	La vue correspondant à un document enregistré a été supprimée.

Action :	Enregistrez à nouveau le document (il n'existe plus en tant que vue d'interrogation).


BRW-15265 : Suppression ou modification de la table <nom>

Cause :	La vue Table de données correspondant à un document enregistré a été modifiée.

Action :	Enregistrez à nouveau le document.


BRW-15266 : Le fichier <nom> n'existe pas

Cause :	L'utilisateur a indiqué un fichier qui n'existait pas.

Action :	Indiquez un autre fichier


BRW-15267 : Le fichier <nom> existe déjà

Cause :	L'utilisateur a tenté d'enregistrer un document sous le nom d'un fichier existant.

Action :	Indiquez un autre nom de fichier.


BRW-15268 : Ouverture impossible du fichier <nom>

Cause :	Le noyau d'entrée/sortie n'a pas pu ouvrir un fichier.

Action :	Indiquez un autre fichier


BRW-15269 : Verrouillage impossible du fichier <nom>

Cause :	Le noyau d'entrée/sortie n'a pas pu verrouiller un fichier.

Action :	Indiquez un autre fichier


BRW-15270 : Erreur de lecture du fichier <nom>

Cause :	Erreur du système d'exploitation ou erreur de format de fichier.

Action :	Indiquez un autre fichier


BRW-15271 : Erreur d'écriture du fichier <nom>

Cause :	Erreur du système d'exploitation ou erreur de noyau d'entrée/sortie.

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15272 : Document <nom> Oracle Query Builder obsolète

Cause :	L'utilisateur a tenté d'ouvrir un ancien document, qui n'est plus pris en charge.

Action :	Indiquez un autre document.


BRW-15273 : Le fichier <nom> n'est pas un fichier Oracle Query Builder

Cause :	L'utilisateur a tenté d'ouvrir un fichier qui n'était pas de type Query Builder.

Action :	Indiquez un autre fichier à ouvrir.


BRW-15274 : Le fichier <nom> n'est pas un fichier SQL valide

Cause :	L'utilisateur a tenté d'importer un fichier SQL non valide.

Action :	Indiquez un autre fichier à importer.


BRW-15275 : Aucune donnée à exporter ou à imprimer

Cause :	L'utilisateur a tenté d'exporter ou d'imprimer une interrogation (ou une région) qui ne comportait pas de données.

Action :	Indiquez une autre région ; exécutez l'interrogation ; modifiez l'interrogation.


BRW-15277 : Impossible d'écraser la table courante <nom>

Cause :	Erreur pendant une tentative de suppression/changement de nom d'une ancienne table de données lors d'un enregistrement.

Action :	Réglez le problème posé par la table de données et enregistrez à nouveau.


BRW-15278 : Document enregistré, mais vue <nom> non créée

Cause :	L'interrogation n'est pas une vue valide. Elle a été enregistrée, mais non sous la forme d'une vue de base de données.

Action :	Redéfinissez l'interrogation sous la forme d'une vue valide, ou n'en tenez pas compte (elles sera enregistrée, mais non sous la forme d'une vue).


BRW-15279 : '<nom>' n'est pas un littéral SQL reconnu

Cause :	L'utilisateur a tenté d'importer un fichier qui n'était pas de type SQL*Plus.

Action :	Indiquez un autre fichier à importer.


BRW-15320 : Erreur de mémoire interne E/S (<valeur>, ligne <##>)

Cause :	Etat interne non valide.

Action :	Contactez le Support technique Oracle..


BRW-15321 : Ressource introuvable (<nom>)

Cause :	Les noms de ressource ne correspondent pas au code Query Builder (ou le fichier est altéré).

Action :	Obtenez une version correcte du fichier de ressources Query Builder.


BRW-15322 : Fichier de ressource introuvable

Cause :	La structure du répertoire n'est pas valide, ou il manque un fichier.

Action :	Localisez le fichier de ressource (vérifiez le nom du fichier NLS_LANG).


BRW-15323 : Interrogation déjà ouverte dans l'application en cours (<nom>)

Cause :	L'utilisateur a tenté d'ouvrir plusieurs interrogations ayant le même nom.

Action :	Indiquez un autre fichier


BRW-15324 : Démarrage impossible du système de fenêtrage

Cause :	Variables d'environnement non valides ou manquantes (par exemple, DISPLAY, APIPATH).

Action :	Toutes les variables d'environnement requises doivent être définies correctement.


BRW-15342 : Informations sur cliché introuvables

Cause :	Cette base de données n'accepte pas les clichés (ou erreur de base de données).

Action :	Vérifiez la présence d'une table de dictionnaires de clichés.


BRW-15387 : Echec de connexion

Cause :	Il s'est produit une erreur de base de données ou SQLNet.

Action :	Vérifiez les informations de connexion et relancez l'opération.


BRW-15388 : Chargement de relations de base de données impossible

Cause :	Erreur interne de schéma pendant le chargement des relations de base de données.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15389 : Chargement impossible de la liste de propriétaires accessibles

Cause :	Erreur interne de schéma pendant le chargement de la liste des propriétaires accessibles

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15390 : Chargement impossible de la liste de tables accessibles

Cause :	Erreur interne de schéma pendant le chargement de la liste des tables de données.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15391 : Chargement de table impossible

Cause :	Erreur interne de schéma lors du chargement de la table de données.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15392 : Chargement de table impossible

Cause :	Erreur interne de schéma au cours du chargement de la table.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15393 : Chargement de synonyme impossible

Cause :	Erreur interne de schéma au cours du chargement du synonyme.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15394 : Chargement d'interrogation impossible

Cause :	Erreur interne de schéma au cours du chargement de l'interrogation.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15395 : Chargement impossible des informations associées à une colonne de la table

Cause :	Erreur interne de schéma au cours du chargement d'informations sur une colonne.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15396 : Chargement impossible des informations associées à une colonne synonyme

Cause :	Erreur interne de schéma au cours du chargement d'informations sur une colonne synonyme.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15397 : Chargement de contraintes impossible

Cause :	Erreur interne de schéma au cours du chargement de contraintes.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15398 : Informations sur clé primaire introuvables

Cause :	Erreur interne de schéma lors de la recherche de clés primaires.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15399 : Informations sur clé étrangère introuvables

Cause :	Erreur interne de schéma lors de la recherche de clés étrangères.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15400 : Chargement impossible des commentaires associés à la table ou colonne
BRW-15400 : Chargement impossible des commentaires associés à la table ou à la colonne

Cause :	Erreur interne de schéma lors de l'extraction de commentaires.

Action :	Contactez le Support technique Oracle. si cette erreur est fortuite.


BRW-15401 : Erreur de chargement du lien de base de données <nom>

Cause :	Erreur interne de schéma lors du chargement du lien de base de données.

Action :	Pour plus d'informations, reportez-vous aux messages d'erreur qui accompagnent ce message.


BRW-15402 : Erreur de chargement du propriétaire <nom>

Cause :	Erreur interne de schéma lors du chargement du lien de base de données.

Action :	Pour plus d'informations, reportez-vous aux messages d'erreur qui accompagnent ce message.


BRW-15403 : Erreur de chargement de la table <nom>

Cause :	Erreur interne de schéma lors du chargement de la table de données.

Action :	Pour plus d'informations, reportez-vous aux messages d'erreur qui accompagnent ce message.


BRW-15404 : Erreur de chargement de la contrainte de clé primaire pour <nom> (<valeur>)

Cause :	Erreur interne de schéma lors du chargement d'une contrainte primaire.

Action :	Pour plus d'informations, reportez-vous aux messages d'erreur qui accompagnent ce message.


BRW-15405 : Erreur de chargement de la contrainte de clé étrangère pour <nom>

Cause :	Erreur interne de schéma lors du chargement d'une contrainte étrangère.

Action :	Pour plus d'informations, reportez-vous aux messages d'erreur qui accompagnent ce message.


BRW-15406 : Erreur de chargement du synonyme <nom>

Cause :	Erreur interne de schéma lors du chargement d'une contrainte primaire.

Action :	Pour plus d'informations, reportez-vous aux messages d'erreur qui accompagnent ce message.


BRW-15407 : La table à laquelle le synonyme <nom> fait référence n'existe plus

Cause :	L'utilisateur a tenté de créer un synonyme pour une table de données qui n'existe pas.

Action :	Re-créez le synonyme.


BRW-15408 : Erreur de chargement des informations sur colonne <nom>

Cause :	Erreur Oracle ou suppression de la table de données.

Action :	Re-créez la table de données.


BRW-15409 : Erreur de chargement des informations de contrainte pour <nom> (<valeur>)

Cause :	Erreur Oracle.

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15410 : La table à laquelle la clé étrangère <nom> (<valeur>) fait référence est inaccessible

Cause :	La table à laquelle fait référence la clé étrangère n'est pas accessible.

Action :	Autorisez l'utilisateur en cours à accéder à la table.


BRW-15411 : Echec de déconnexion

Cause :	Erreur interne lors de la déconnexion.

Action :	Sortez ou fermez le document.


BRW-15412 : Modification de la table associée à l'interrogation <nom>. Interrogation chargée comme vue.

Cause :	La vue dont dépend l'interrogation a été modifiée après le dernier enregistrement.

Action :	Ouvrez l'interrogation et enregistrez-la à nouveau pour l'utiliser comme une table de données.


BRW-15413 : Suppression de la table associée à l'interrogation <nom>. Interrogation non chargée

Cause :	La vue dont dépend l'interrogation a été supprimée.

Action :	Ouvrez l'interrogation et enregistrez-la à nouveau pour l'utiliser comme une table de données.


BRW-15414 : La table <nom> n'existe plus

Cause :	Cette table de données n'existe plus dans la base de données.

Action :	Si vous avez besoin de cette table, contactez l'administrateur système.


BRW-15415 : Dépassement du nombre maximum de colonnes autorisées par table (254)

Cause :	L'utilisateur a tenté de charger une table de données comportant plus de 254 colonnes.

Action :	Contactez l'administrateur système.


BRW-15416 : Dépassement du nombre maximum de tables autorisées par utilisateur (8192)

Cause :	L'utilisateur est propriétaire d'un trop grand nombre de tables de données.

Action :	Contactez l'administrateur système.


BRW-15417 : Dépassement du nombre maximum de propriétaires et de bases de données autorisés (1024)

Cause :	L'utilisateur a tenté de charger trop de liens d'utilisateur, de propriétaire et de base de données.

Action :	Contactez l'administrateur système.


BRW-15418 : Informations de lien de base de données introuvables

Cause :	Cette base de données ne prend pas en charge le lien avec la base de données ou il s'est produit une erreur au niveau de la base de données.

Action :	Essayez à nouveau d'exécuter l'opération si ce message est inattendu.


BRW-15419 : Informations sur synonymes introuvables

Cause :	Cette base de données ne prend pas en charge les synonymes ou il s'est produit une erreur au niveau de la base de données.

Action :	Essayez à nouveau d'exécuter l'opération si ce message est inattendu.


BRW-15420 : Informations sur contraintes introuvables

Cause :	Cette base de données ne prend pas en charge les contraintes ou il s'est produit une erreur au niveau de la base de données.

Action :	Essayez à nouveau d'exécuter l'opération si ce message est inattendu.


BRW-15421 : Table de commentaires introuvable

Cause :	Cette base de données ne prend pas en charge les commentaires sur la table ou il s'est produit une erreur au niveau de la base de données.

Action :	Essayez à nouveau d'exécuter l'opération si ce message est inattendu.


BRW-15422 : Table de commentaires sur colonne introuvable

Cause :	Cette base de données ne prend pas en charge les commentaires sur la colonne ou il s'est produit une erreur au niveau de la base de données.

Action :	Essayez à nouveau d'exécuter l'opération si ce message est inattendu.


BRW-15423 : Ce synonyme fait référence à une séquence et n'est pas supporté

Cause :	L'utilisateur a tenté de charger un synonyme qui fait référence à une séquence.

Action :	Cette action n'est pas prise en charge.


BRW-15424 : Vous avez dépassé le nombre maximum permis de tentatives de connexion (3)
BRW-15424 : Vous avez dépassé le nombre maximum autorisé de tentatives de connexion (3)

Cause :	L'utilisateur a effectué trop de tentatives de connexion.

Action :	Demandez à l'administrateur système le nom d'utilisateur, le mot de passe et/ou la chaîne de connexion corrects.


BRW-15430 : Informations d'index non chargées

Cause :	La table d'index est introuvable.

Action :	La base de données n'est pas de type Oracle ; essayez un pilote ODBC.


BRW-15434 : Le nombre maximum de colonnes dans la table est <##>

Cause :	L'utilisateur a tenté de créer un nombre de colonnes supérieur au maximum autorisé dans une table.

Action :	Créez moins de colonnes.


BRW-15435 : Privilège DBA requis pour effectuer cette opération

Cause :	Cette opération implique des privilèges DBA.

Action :	Demandez à l'administrateur système de vous accorder le privilège DBA.


BRW-15447 : Suppression d'interrogation impossible. Faites Fichier/Supprimer... à partir de la fenêtre Interrogation

Cause :	L'utilisateur a tenté de supprimer une interrogation.

Action :	Cette opération n'est pas valide à partir de l'Editeur de schéma. Utilisez à la place la fenêtre Interrogation.


BRW-15448 : Copie d'interrogation impossible.  Faites Fichier/Enregistrer sous... à partir de la fenêtre Interrogation

Cause :	L'utilisateur a tenté de copier une interrogation.

Action :	Cette opération n'est pas valide à partir de l'Editeur de schéma. Utilisez à la place la fenêtre Interrogation.


BRW-15449 : Copie de données impossible à partir d'une table ne contenant que des colonnes de type LONG

Cause :	L'utilisateur a tenté de copier une table contenant une colonne de type LONG.

Action :	Cette action n'est pas autorisée pour la base de données.


BRW-15450 : Opération non autorisée sur une table supprimée

Cause :	L'utilisateur a tenté d'effectuer une opération sur une table de données supprimée.

Action :	Commencez par annuler la suppression.


BRW-15451 : Opération non autorisée sur une colonne supprimée

Cause :	L'utilisateur a tenté d'effectuer une opération sur une colonne supprimée.

Action :	Commencez par annuler la suppression.


BRW-15452 : Modification de nom impossible d'une table appartenant à un autre utilisateur

Cause :	L'utilisateur a tenté de définir le nom d'une table de données qui appartenait à un autre utilisateur.

Action :	Cette opération n'est pas autorisée. Demandez au propriétaire de l'exécuter à votre place.


BRW-15466 : Nom de table trop long (Max <##> octets)

Cause :	Le nom de la table de données est trop long.

Action :	Raccourcissez le nom et relancez l'opération.


BRW-15467 : Nom déjà utilisé. Veuillez choisir un autre nom.

Cause :	Le nom est déjà utilisé.

Action :	Choisissez un autre nom.


BRW-15468 : Nom de colonne trop long (Max <##> octets)

Cause :	Le nom de la colonne est trop long.

Action :	Raccourcissez le nom et relancez l'opération.


BRW-15493 : Opération non prise en charge actuellement

Cause :	Erreur interne.

Action :	Contactez le Support technique Oracle..


BRW-15494 : Erreur de chargement de texte SQL des vues

Cause :	Erreur interne.

Action :	Contactez le Support technique Oracle..


BRW-15495 : Erreur de chargement de texte SQL associé à la vue <nom>

Cause :	Erreur interne.

Action :	Contactez le Support technique Oracle..


BRW-15496 : L'échelle doit être comprise entre <##> et <##>

Cause :	Valeur non valide pour l'échelle.

Action :	Entrez une valeur valide pour l'échelle.


BRW-15498 : Modification d'interrogation impossible

Cause :	La modification d'une interrogation n'est pas autorisée.

Action :	Ouvrez l'interrogation et modifiez-la comme un document Query Builder.


BRW-15499 : Définition impossible d'attributs de colonne dans une table comportant des données dupliquées

Cause :	L'utilisateur a tenté de définir le type de colonne d'une table dupliquée comportant des données.

Action :	Commencez par valider la table, puis tentez de nouveau d'exécuter l'opération.


BRW-15501 : Mémoire virtuelle d'application insuffisante

Cause :	L'espace disque disponible est insuffisant, ou la mémoire système pour le gestionnaire de mémoire virtuelle est saturée.

Action :	Fermez un document ou libérez de la place sur votre disque.


BRW-15502 : <##> lignes autorisées par document

Cause :	Vous avez dépassé le nombre maximum de lignes imposées au moment de la compilation.

Action :	Envisagez d'ajouter des conditions à l'interrogation.


BRW-15504 : Impossible de déterminer le jeu de caractères de la base de données

Cause :	L'instruction SELECT USERENV('LANGUAGE') FROM DUAL a généré l'apparition d'un problème.

Action :	La base de données n'est pas de type Oracle et n'est donc pas prise en charge.


BRW-15505 : Ouverture impossible du fichier de mémoire virtuelle

Cause :	Vous n'avez pas d'autorisation d'écriture ou le système de fichiers est saturé.

Action :	Modifiez l'autorisation d'accès au répertoire ou supprimez des fichiers.


BRW-15506 : Fermeture de fichier de mémoire virtuelle impossible
BRW-15506 : Fermeture du fichier de mémoire virtuelle impossible

Cause :	Erreur du système d'exploitation.

Action :	Demandez l'intervention de l'administrateur système.


BRW-15507 : Lecture de fichier de mémoire virtuelle impossible
BRW-15507 : Lecture du fichier de mémoire virtuelle impossible

Cause :	Le fichier de mémoire virtuelle n'existe pas.

Action :	Assurez-vous que le fichier de mémoire virtuelle est ouvert.


BRW-15508 : Ecriture dans fichier de mémoire virtuelle impossible

Cause :	Le système de fichiers est saturé, ou le fichier de mémoire virtuelle n'a pas été ouvert.

Action :	Supprimez des fichiers. Assurez-vous que le fichier de mémoire virtuelle est ouvert.


BRW-15509 : Création de gestionnaire de mémoire virtuelle impossible
BRW-15509 : Création du gestionnaire de mémoire virtuelle impossible

Cause :	Erreur interne, ou manque de mémoire.

Action :	Demandez l'intervention de l'administrateur système.


BRW-15511 : Taille de la mémoire virtuelle dépassée

Cause :	L'entrée de l'utilisateur est trop importante pour la taille de la mémoire virtuelle

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15513 : Valeur non renseignée dans la commande '<nom>'

Cause :	L'utilisateur a entré <commande>= dans la ligne de commande sans qu'aucune option n'ait été sélectionnée.

Action :	Ajoutez une valeur pour <commande>.


BRW-15514 : Commande non renseignée sur la ligne de commande

Cause :	L'utilisateur a entré =<valeur> dans ligne de commande, mais n'a pas indiqué de commande.

Action :	Ajoutez la commande.


BRW-15515 : Commande <nom> non reconnue sur la ligne de commande

Cause :	L'utilisateur a entré une commande non valide dans la ligne de commande.

Action :	Modifiez la commande.


BRW-15516 : Commande <nom> indiquée deux fois sur la ligne de commande

Cause :	L'utilisateur a entré deux fois la même commande dans la ligne de commande.

Action :	Supprimez une des deux instructions.


BRW-15517 : Commandes incompatibles '<nom1>' et '<nom2>' sur la ligne de commande

Cause :	L'utilisateur a entré deux commandes incompatibles dans la ligne de commande.

Action :	Supprimez une des deux instructions.


BRW-15518 : Option '<nom1>' non valide dans la commande '<nom2>'

Cause :	L'utilisateur a entré une option non valide pour une commande dans la ligne de commande.

Action :	Modifiez l'option.


BRW-15519 : Instructions de connexion multiples entrées sur la ligne de commande

Cause :	L'utilisateur a entré deux instructions de connexion dans la ligne de commande.

Action :	Supprimez une des deux instructions.


BRW-15520 : Nom de document <nom> non valide sur la ligne de commande

Cause :	L'utilisateur a entré un nom de document non valide dans la ligne de commande.

Action :	Modifiez le nom du document.


BRW-15521 : Document non précisé dans la commande '<nom>'

Cause :	L'utilisateur a entré une commande sans indiquer de document dans la ligne de commande.

Action :	Ajoutez un nom de document.


BRW-15522 : Commande '<nom2>' non précisée dans la commande '<nom1>'

Cause :	L'utilisateur a entré une commande sans la compléter par une autre commande obligatoire.

Action :	Ajoutez la commande manquante.


BRW-15523 : Parenthèses incorrectes dans la commande '<nom>'

Cause :	L'utilisateur n'a pas entré de parenthèses par paire dans la ligne de commande.

Action :	Corrigez.


BRW-15530 : Edition de ligne supprimée impossible

Cause :	L'utilisateur a tenté d'éditer une ligne marquée pour être supprimée.

Action :	Commencez par annuler la suppression de la ligne.


BRW-15531 : La ligne a été supprimée de la base de données

Cause :	Un autre utilisateur a supprimé cette ligne depuis votre dernière exécution de l'interrogation.

Action :	Contactez le Support technique Oracle.. Cette erreur ne devrait jamais se produire.


BRW-15532 : La ligne a été modifiée par un autre utilisateur. Répétez l'interrogation.

Cause :	Un autre utilisateur a mis cette ligne à jour depuis votre dernière exécution de l'interrogation.

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15533 : La ligne est actuellement verrouillée par un autre utilisateur

Cause :	Cette ligne est en cours d'édition par un autre utilisateur.

Action :	Tentez à nouveau d'exécuter l'opération à un stade ultérieur.


BRW-15539 : Erreur lors de l'insertion de <##> ligne(s)

Cause :	Une ou plusieurs lignes du fichier d'entrée n'ont pas pu être insérées.

Action :	Modifiez le fichier d'entrée ou ne tenez pas compte du fichier.


BRW-15540 : Opération non autorisée sur des données de ce type

Cause :	L'utilisateur a tenté d'éditer une cellule comportant des données d'un type non éditable.

Action :	Inconnue.


BRW-15541 : Trop de lignes éditées. Veuillez sélectionner l'option Valider

Cause :	Un document comporte trop d'opération INSERT, UPDATE ou DELETE.

Action :	Sélectionnez Valider ou Rétablir.


BRW-15545 : Erreur de lecture du fichier QXF.  Analyse interrompue

Cause :	Erreur de syntaxe dans la lecture du fichier QXF.

Action :	Réglez le problème de syntaxe du fichier QXF.


BRW-15546 : Erreur d'analyse : Ligne <##>

Cause :	Erreur de syntaxe dans la ligne indiquée.

Action :	Déboguez cette ligne.


BRW-15547 : Opérateur non précisé dans bloc relationnel

Cause :	Le bloc de relation du fichier QXF comporte un opérateur non précisé.

Action :	Précisez un champ d'opérateur dans le bloc.


BRW-15548 : Erreur : absence d'argument dans <nom>, bloc relationnel

Cause :	Un champ de colonne d'un bloc relationnel ne comporte pas d'argument.

Action :	Indiquez le nom de colonne dans ce champ.


BRW-15549 : CONDITION_TEXT manquant dans bloc relationnel

Cause :	Le champ CONDITION_TEXT du bloc relationnel ne comporte pas d'argument.

Action :	Indiquez le champ CONDITION_TEXT.


BRW-15550 : Valeur INCLUSION_ORDER (<nom1>) non autorisée dans l'expression '<nom2>'

Cause :	Valeur INCLUSION_ORDER non valide dans l'expression.

Action :	Corrigez la valeur INCLUSION_ORDER.


BRW-15551 : Expression '<nom>' incluse mais absence de INCLUSION_ORDER

Cause :	Le champ INCLUSION_ORDER n'a pas été indiqué pour un bloc d'expression inclus.

Action :	Indiquez le champ INCLUSION_ORDER.


BRW-15552 : Expression '<nom>' non incluse mais présence de INCLUSION_ORDER

Cause :	L'expression n'est pas incluse (INCLUDED = FALSE), mais INCLUSION_ORDER est indiqué.

Action :	Corrigez les valeurs de ces champs.


BRW-15553 : Erreur : chaîne TEXT vide dans l'expression '<nom>'

Cause :	La chaîne TEXT n'est pas indiquée dans un bloc d'expression QXF.

Action :	Indiquez la chaîne TEXT.


BRW-15554 : Erreur : SORT_PRIORITY non indiqué dans l'expression triée '<nom>'

Cause :	SORT_PRIORITY n'est pas indiqué pour une expression triée.

Action :	Indiquez SORT_PRIORITY.


BRW-15555 : Champ '<nom1>' dans table '<nom2>' inclus, mais INCLUSION_ORDER non renseigné

Cause :	Valeur INCLUSION_ORDER non valide pour le champ.

Action :	Corrigez la valeur de INCLUSION_ORDER.


BRW-15556 : Champ '<nom1>' dans table '<nom2>' inclus, mais INCLUSION_ORDER non renseigné

Cause :	Le champ est inclus (INCLUDED = FALSE), mais INCLUSION_ORDER n'est pas indiqué.

Action :	Corrigez les valeurs de ces champs.


BRW-15557 : Champ '<nom1>' (table '<nom2>') exclus mais présence d'un INCLUSION_ORDER
BRW-15557 : Champ '<nom1>' (table '<nom2>') exclu mais présence d'un INCLUSION_ORDER

Cause :	Le champ de la base de données indiquée n'est pas inclus, mais INCLUSION_ORDER est indiqué.

Action :	Corrigez les valeurs de ces champs.


BRW-15558 : Champ trié '<nom1>' dans table '<nom2>' : SORT_PRIORITY non indiqué

Cause :	SORT_PRIORITY n'a pas été indiqué pour un champ trié.

Action :	Indiquez SORT_PRIORITY pour ce champ.


BRW-15559 : Erreur : valeur de INCLUSION_ORDER '<nom1>' non autorisée dans la table '<nom2>'

Cause :	Valeur négative dans l'ordre d'inclusion.

Action :	Corrigez la valeur.


BRW-15560 : Table '<nom>' incluse, mais INCLUSION_ORDER non renseigné

Cause :	La table de données est incluse (INCLUDED = TRUE), mais INCLUSION_ORDER n'est pas renseigné.

Action :	Corrigez les valeurs de ces champs.


BRW-15561 : Table '<nom>' exclue, mais présence de INCLUSION_ORDER

Cause :	La table des données n'est pas incluse (INCLUDED = FALSE), mais INCLUSION_ORDER est indiqué.

Action :	Corrigez les valeurs de ces champs.


BRW-15562 : Erreur : il ne peut pas y avoir plus d'un bloc conditionnel principal

Cause :	Il y a plus d'un bloc conditionnel principal (racine).

Action :	Supprimez certains blocs conditionnels, ou utilisez une conjonction.


BRW-15563 : Erreur : version 1.0 du fichier QXF attendue

Cause :	Le champ VERSION comporte un numéro de version non valide.

Action :	Modifiez la version.


BRW-15564 : Erreur d'analyse : ligne <##> : style de police  '<nom>' non valide

Cause :	Le style de police n'est pas valide.

Action :	Vérifiez et corrigez.


BRW-15565 : Erreur d'analyse : ligne <##> : argument de style de police non valide

Cause :	L'argument de style de police n'est pas valide.

Action :	Vérifiez les chaînes de styles de police et corrigez.


BRW-15566 : Erreur d'analyse : ligne <##> : fonction d'agrégat  '<nom>' non valide

Cause :	Le nom de la fonction d'agrégat n'est pas valide.

Action :	Corrigez le nom de la fonction.


BRW-15567 : Erreur d'analyse : ligne <##> : argument de résumé non valide

Cause :	L'argument du champ résumé n'est pas valide.

Action :	Corrigez l'argument du champ.


BRW-15568 : Erreur d'analyse : ligne <##> : argument de champ non valide

Cause :	L'argument du champ n'est pas valide.

Action :	Corrigez l'argument du champ.


BRW-15569 : Attention : le fichier QXF n'est que partiellement chargé en raison d'une erreur

Cause :	Erreur pendant le chargement du fichier QXF.

Action :	Corrigez l'erreur.


BRW-15570 : Erreur d'analyse : Ligne <##> : opérateur '<nom>' non valide dans bloc relationnel

Cause :	Le bloc relationnel comporte un opérateur non valide.

Action :	Vérifiez l'opérateur et corrigez.


BRW-15571 : Erreur d'analyse : Ligne <##> : Argument de champ opérateur non valide

Cause :	L'expression Elément Dérivé comporte un ID d'objet non valide.

Action :	Corrigez l'ID d'objet dans le dictionnaire.


BRW-15572 : ID d'objet non homogènes dans expression d'élément dérivée

Cause :	Le bloc relationnel comporte un argument de champ d'opérateur non valide.

Action :	Vérifiez les chaînes et corrigez.


BRW-15580 : Chargement impossible de la liste d'entités accessibles

Cause :	Il n'y a pas de table d'entité dans la couche Utilisateur Final.

Action :	Réinstallez la couche. Demandez l'intervention de l'administrateur système.


BRW-15581 : Ajout de colonnes impossible dans une table créée avec des données dupliquées

Cause :	L'utilisateur a tenté d'ajouter des colonnes dans une table créée avec des données de table dupliquées.

Action :	Validez la table, puis Essayez à nouveau d'exécuter l'opération.


BRW-15582 : Création d'une table nouvelle ou dupliquée autorisée uniquement sur une table qui existe déjà

Cause :	Création d'une nouvelle table sur une autre table, nouvelle, dupliquée ou modifiée.

Action :	Commencez par valider la table nouvelle, dupliquée ou modifiée.


BRW-15583 : Un index doit nécessairement compter une colonne minimum

Cause :	L'utilisateur a tenté de supprimer la dernière colonne de l'index.

Action :	Ajoutez d'autres colonnes, puis supprimez.


BRW-15584 : La colonne <nom> est de type LONG et ne peut être copiée

Cause :	Il n'est pas possible de copier une colonne de type LONG lors de la création d'un cliché.

Action :	La colonne ne peut pas être copiée.


BRW-15600 : Syntaxe non prise en charge

Cause :	Tentative d'analyse d'une syntaxe non prise en charge.

Action :	Utilisez une autre syntaxe Oracle 8.


 BRW-15601 : Syntaxe Oracle 8 SQL non valide

Cause :	Impossible d'utiliser une syntaxe Oracle 8.

Action :	Utilisez Oracle 7 SQL.


BRW-15602 : Constructeur de type n'est pas pris en charge dans Oracle 8 SQL

Cause :	Les constructeurs de type ne sont pas pris en charge dans Oracle 8 SQL.

Action :	Rétablissez Oracle 7.


BRW-15603 : REF n'est pas pris en charge dans Oracle 8 SQL

Cause :	REF n'est pas pris en charge dans Oracle 8 SQL.

Action :	Utilisez Oracle 7 à la place.


BRW-15604 : CAST n'est pas pris en charge dans Oracle 8 SQL

Cause :	CAST n'est pas pris en charge dans Oracle 8 SQL.

Action :	Utilisez Oracle 7 à la place.


BRW-15605 : MULTISET n'est pas pris en charge dans Oracle 8 SQL

Cause :	MULTISET n'est pas pris en charge dans Oracle 8 SQL.

Action :	Utilisez Oracle 7 à la place.


BRW-15606 : METHODS n'est pas pris en charge dans Oracle 8 SQL

Cause :	METHODS n'est pas pris en charge dans Oracle 8 SQL.

Action :	Utilisez Oracle 7 à la place.


BRW-15607 : La sous-interrogation THE n'est pas prise en charge dans Oracle 8 SQL

Cause :	La sous-interrogation THE n'est pas prise en charge dans Oracle 8 SQL.

Action :	Utilisez Oracle 7 à la place.


BRW-15608 : PARTITION (de tables) n'est pas prise en charge dans Oracle 8 SQL

Cause :	PARTITION (de tables) n'est pas prise en charge dans Oracle 8 SQL.

Action :	Utilisez Oracle 7 à la place.


BRW-15609 : Le mot-clé TABLE dans une sous-interrogation n'est pas pris en charge dans Oracle 8 SQL

Cause :	Le mot-clé TABLE dans une sous-interrogation n'est pas pris en charge.

Action :	Utilisez Oracle 7 à la place.


BRW-15610 : Renommez la table à l'aide d'un alias de table

Cause :	Vous avez tenté d'utiliser un nom de table au lieu d'un alias de table.

Action :	Renommez la table à l'aide d'un alias de table.


BRW-15641 : Echec de l'initialisation du système d'aide. Fonction d'aide non disponible.

Cause :	Impossible de localiser le document d'aide ou le fichier de ressource d'aide.

Action :	L'utilisateur peut continuer, mais le menu d'aide n'est pas disponible. Utilisez la documentation en ligne ou la documentation papier.


BRW-15643 : Fichier de ressource introuvable (<nom>), tentative d'ouverture du fichier de ressource par défaut

Cause :	NLS_LANG est défini, mais le fichier est introuvable.

Action :	Essayez d'ouvrir le fichier de ressource en utilisant la langue par défaut.


BRW-15644 : Document d'aide (<nom>) introuvable, tentative d'ouverture du document par défaut

Cause :	NLS_LANG est défini, mais le fichier est introuvable.

Action :	Essayez d'ouvrir le document d'aide en utilisant la langue par défaut.


BRW-15647 : Document d'aide introuvable

Cause :	Le fichier d'aide est introuvable dans le répertoire correct avec la langue correcte.

Action :	Vérifiez la structure des répertoires de Query Builder. Assurez-vous que NLS_LANG est défini correctement.


BRW-15648 : Erreur de création du système d'aide

Cause :	Le système d'aide n'a pas pu être lancé.

Action :	Query Builder n'a pas pu trouver le fichier de ressource d'aide, ou NLS_LANG n'est pas défini, ou la mémoire est insuffisante.


BRW-15649 : Valeur saisie pour <nom> trop faible. Nombre minimum valide : <##>

Cause :	La valeur entrée est trop faible.

Action :	Essayez à nouveau d'exécuter l'opération en indiquant une valeur plus élevée.


BRW-15650 : Valeur saisie pour <nom> trop élevée. Nombre maximum valide <##>

Cause :	La valeur entrée est trop élevée.

Action :	Essayez à nouveau d'exécuter l'opération en indiquant une valeur plus faible.


BRW-15651 : Valeur saisie pour <nom> hors plage. Doit être comprise entre <##> et <##>.
BRW-15651 : Valeur saisie pour <nom> hors plage. Doit être comprise entre <##> et <##>

Cause :	La valeur entrée n'était pas comprise dans la plage des valeurs valides.

Action :	Essayez à nouveau d'exécuter l'opération en indiquant une valeur valide.


BRW-15652 : Valeur remise à <valeur>

Cause :	La valeur entrée a été modifiée, car elle ne figurait pas dans la plage des valeurs valides.

Action :	Essayez à nouveau d'exécuter l'opération en indiquant une valeur valide, sinon Query Builder utilisera la valeur indiquée.


BRW-15653 : Erreur dans fichier Préf : Valeur <valeur> trop faible. Nombre minimum valide : <##>.

Cause :	La valeur entrée est trop faible.

Action :	Essayez à nouveau d'exécuter l'opération en indiquant une valeur plus élevée.


BRW-15654 : Erreur dans fichier Préf : Valeur <valeur> trop élevée. Nombre maximum valide : <##>.

Cause :	La valeur entrée est trop élevée.

Action :	Essayez à nouveau d'exécuter l'opération en indiquant une valeur plus faible.


BRW-15655 : Erreur dans fichier Préf : Valeur <valeur> hors plage. Doit être comprise entre <##> et <##>

Cause :	La valeur entrée n'était pas comprise dans la plage des valeurs valides.

Action :	Essayez à nouveau d'exécuter l'opération en indiquant une valeur valide.


BRW-15656 : Erreur dans fichier Préf : Valeur de <valeur> non reconnue

Cause :	La valeur définie dans le fichier des préférences n'est pas valide.

Action :	Essayez à nouveau d'exécuter l'opération en indiquant une valeur valide.


BRW-15657 : OWNERLIST=NAME : La valeur doit contenir au moins un nom

Cause :	La valeur de OWNERLIST=NAME est NULLE.

Action :	Essayez à nouveau d'exécuter l'opération en indiquant un nom valide.


BRW-15900 : Informations sur la période introuvables

Cause :	Cette base de données ne prend pas en charge les périodes, ou il s'est produit une erreur dans la base de données.

Action :	Essayez à nouveau d'exécuter l'opération si ce message est inattendu.


BRW-15901 : La source de données <nom1> à laquelle l'objet <nom2> fait référence n'existe plus

Cause :	La source de l'objet dans la base de données a été supprimée.

Action :	Rafraîchir/supprimer l'objet.


BRW-15902 : La table à laquelle l'objet <nom> fait référence n'existe plus

Cause :	La source de l'objet dans la base de données a été supprimée.

Action :	Rafraîchir/supprimer l'objet.


BRW-15903 : La table opposée à <nom> n'appartient à aucune entité. Information sur jointure non accessible

Cause :	Relation : La table/l'objet de données opposé ne figure dans aucun groupe.

Action :	Affecter cet objet à un groupe.


BRW-15904 : Le nom d'une relation ne peut comprendre plus de <##> octets

Cause :	Le nom de relation dépasse la limite autorisée.

Action :	Utilisez un nom plus court.


BRW-15905 : Un en-tête de colonne ne peut comprendre plus de <##> octets

Cause :	L'en-tête d'élément dépasse la longueur autorisée.

Action :	Utilisez un en-tête plus court.


BRW-15906 : Un format de colonne ne peut comprendre plus de <##> octets

Cause :	Le format d'élément dépasse la limite autorisée.

Action :	Utilisez un format plus court.


BRW-15907 : La largeur d'affichage d'une colonne ne peut compter plus de <##> chiffres

Cause :	La précision de largeur d'affichage de l'élément dépasse la limite autorisée.

Action :	Choisissez une largeur d'affichage inférieure.


BRW-15908 : Le nom de la période ne peut compter plus de <##> octets

Cause :	Nom de période trop long.

Action :	Utilisez un nom plus court.


BRW-15909 : Les colonnes période et séquence de la période sont identiques

Cause :	Les colonnes de période et de séquence de la période ont été définies à la même colonne.

Action :	Indiquez des colonnes de période et de séquence différentes.


BRW-15910 : Chargement impossible de la période <nom>

Cause :	Erreur interne de schéma lors du chargement de la période.

Action :	Pour plus d'informations, reportez-vous aux messages d'erreur qui accompagnent ce message.


BRW-15911 : La période <nom> existe déjà

Cause :	Le nom de la période doit être unique.

Action :	Créez une période sous un nom différent.


BRW-15912 : Valeur largeur d'affichage non autorisée

Cause :	La valeur de largeur de l'affichage n'est pas autorisée.

Action :	Entrez une valeur valide.


BRW-15913 : Le texte d'une clé <nom> doit être renseigné

Cause :	Le texte d'une clé étrangère ou primaire est vide.

Action :	Entrez le texte de la clé primaire ou étrangère.


BRW-15914 : Le nom d'une relation doit être renseigné

Cause :	Le nom de la relation n'est pas renseigné.

Action :	Entrez un nom de relation.


BRW-15924 : Le nom de l'entité doit être renseigné

Cause :	Le nom de l'entité est vide ou ne contient que des espaces.

Action :	Entrez un nouveau nom.


BRW-15925 : Table <nom1> déjà importée comme <nom2>

Cause :	La table ne peut être importée qu'une fois sous un nom donné.

Action :	Importez la table sous un nom différent.


BRW-15926 : Le nom de l'entité <nom> existe déjà

Cause :	Le nom de l'entité doit être unique.

Action :	Créez  une entité sous un nom différent.


BRW-15927 : L'entité <nom1> contient déjà une table intitulée <nom2>

Cause :	Le nom de table doit être unique dans une entité.

Action :	Renommez/importez à nouveau la table et ajoutez-la à l'entité.


BRW-15928 : Nom d'entité trop long (<##> octets max)

Cause :	Le nom de l'entité est trop long.

Action :	Raccourcissez le nom et relancez l'opération.


BRW-15929 : Description d'entité trop longue (<##> octets max)

Cause :	La description de l'entité est trop longue.

Action :	Raccourcissez la description et relancez l'opération.


BRW-15930 : Erreur lors de la validation de la table <nom>

Cause :	Il s'est produit une erreur pendant la validation de la table.

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15931 : Erreur lors de la validation de l'entité <nom>

Cause :	Il s'est produit une erreur pendant la validation de l'entité.

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15932 : Erreur lors de la validation de période <nom>

Cause :	Il s'est produit une erreur pendant la validation de la période.

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15933 : Erreur lors de la validation de la relation <nom>

Cause :	Il s'est produit une erreur pendant la validation de la relation

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15937 : Erreur de génération de procédure SQL pour la table <nom>

Cause :	Il s'est produit une erreur pendant la génération de la procédure SQL pour une table.

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15938 : Erreur de génération de procédure SQL pour l'entité <nom>

Cause :	Il s'est produit une erreur pendant la génération de la procédure SQL pour une entité.

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15939 : Erreur de génération de procédure SQL pour la période <nom>

Cause :	Il s'est produit une erreur pendant la génération de la procédure SQL pour une période.

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15940 : Erreur de génération de procédure SQL pour la relation <nom>

Cause :	Il s'est produit une erreur pendant la génération de la procédure SQL pour une relation.

Action :	Tentez à nouveau d'exécuter l'opération.


BRW-15950 : Aucune table Oracle Query Builder - Fonctions Ouverture/Enregistrement désactivées

Cause :	La base de données ne comporte pas de table d'interrogation système Query Builder.

Action :	Créez une table interrogation système (exécutez le script d'installation Query Builder).


BRW-15951 : Informations sur profils utilisateur non chargées

Cause :	La table des profils d'utilisateur n'a pas pu être chargée.

Action :	Demandez à l'administrateur système d'en créer une.


BRW-15952 : Table de privilèges utilisateur non chargée

Cause :	La table USER_USERS est manquante (base de données non Oracle ou Oracle V7).

Action :	Aucune.


BRW-15953 : Table de privilèges non chargée

Cause :	La table de privilèges est introuvable.

Action :	Base de données non Oracle ou Oracle V7.


BRW-15954 : Tables Oracle Query Builder 2.5 absentes ou installées incorrectement

Cause :	Il n'existe pas de table QUERY BUILDER_DOCS_SQL.

Action :	Installez à nouveau les tables Query Builder 2.5.


BRW-15955 : L'interrogation n'a ramené aucune ligne

Cause :	L'interrogation n'a pas ramené de ligne.

Action :	Modifiez l'interrogation afin qu'elle demande des données qui existent dans la base de données.


BRW-16000 : Document enregistré à l'aide de End User Layer et non du dictionnaire Natif. Voulez-vous continuer ?

Cause :	L'utilisateur a tenté d'ouvrir en mode Natif un document enregistré au moyen de End User Layer.

Action :	Exécutez Query Builder avec DICTIONARY=ENDUSER ou continuez (les objets de End User Layer seront inaccessibles).


BRW-16001 : Document enregistré à l'aide du dictionnaire Natif et non de End User Layer. Voulez-vous continuer ?

Cause :	L'utilisateur a tenté d'ouvrir en ENDUSER un document enregistré au moyen du dictionnaire Natif.

Action :	Exécutez Query Builder avec DICTIONARY=NATIVE ou continuez (certains objets de la base de données seront peut-être inaccessibles).


BRW-16250 : Ce document existe déjà. Voulez-vous le remplacer ?

Cause :	L'utilisateur a tenté d'exécuter une opération d'Enregistrement sur un document existant.

Action :	Ecrasez le document existant ou annulez l'opération.


BRW-16251 : Table modifiée. Voulez-vous continuer ?

Cause :	La vue a été supprimée et recréée. La nouvelle vue peut ne pas être compatible avec le document.

Action :	Continuez ou interrompez l'enregistrement.


BRW-16500 : Mémoire non disponible pour tri local. Voulez-vous relancer l'exécution ?

Cause :	Les lignes du tri local n'ont pas toutes été extraites.

Action :	Exécutez à nouveau l'interrogation, maintenant ou plus tard.


BRW-16503 : Données non disponibles pour tri local. Voulez-vous relancer l'exécution ?

Cause :	Les lignes du tri local n'ont pas toutes été extraites.

Action :	Exécutez à nouveau l'interrogation, maintenant ou plus tard.


BRW-16504 : Données non disponibles pour ventilation. Voulez-vous relancer l'exécution ?

Cause :	Les lignes de la ventilation locale n'ont pas toutes été extraites.

Action :	Exécutez à nouveau l'interrogation, maintenant ou plus tard.


BRW-16525 : L'interrogation peut exiger un produit cartésien. Voulez-vous continuer ?

Cause :	L'interrogation combine les résultats de tables non liées.

Action :	Ne tenez pas compte du message ou liez les tables avant l'exécution. Pour plus de détails, reportez-vous à l'aide ou à la documentation.


BRW-16531 : Voulez-vous redéfinir le paramètre <nom> ?

Cause :	L'utilisateur a entré un paramètre supprimé précédemment dans une expression ou une condition.

Action :	Appuyez sur OK si cette opération vous convient.


BRW-16532 : Le paramètre <nom> n'existe pas. Voulez-vous le définir ?

Cause :	L'utilisateur a entré un nouveau paramètre dans une expression ou une condition.

Action :	Appuyez sur OK si cette opération vous convient.


BRW-16549 : Rétablir annule toutes les modification apportées dans ces tables. Voulez-vous toujours rétablir ?
BRW-16549 : Rétablir annule toutes les modifications apportées dans ces tables. Voulez-vous toujours rétablir ?

Cause :	Ce message vous demande de confirmer le rétablissement des tables de données.

Action :	Cliquez sur OK pour rétablir toutes les tables de données sélectionnées, ou sur Annuler pour annuler l'opération.


BRW-16550 : La table <nom> comporte des clés primaires/uniques référencées. Voulez-vous les supprimer ?

Cause :	La table contient des contraintes.

Action :	Cliquez sur OK pour supprimer la table de données, ou sur Annuler pour annuler l'opération.


BRW-16551 : La colonne comprend des clés primaires/uniques ou des index. Voulez-vous les supprimer ?

Cause :	La colonne est utilisée par des contraintes ou des index.

Action :	Cliquez sur OK pour supprimer la colonne ou sur Annuler pour annuler l'opération.


BRW-16552 : Voulez-vous désactiver toutes les contraintes ?

Cause :	Ce message vous demande de confirmer la désactivation de toutes les contraintes.

Action :	Confirmez ou annulez.


BRW-16553 : Voulez-vous activer toutes les contraintes ?

Cause :	Ce message vous demande de confirmer l'activation de toutes les contraintes.

Action :	Confirmez ou annulez.


BRW-16575 : Certaines modifications non validées seront perdues. Voulez-vous valider ?

Cause :	L'utilisateur a tenté de sortir de l'Editeur de données sans valider les modifications.

Action :	Cliquez sur Valider ou renoncez à vos modifications.


BRW-16576 : Les valeurs Colonne définie, Résumé et Ventilation ne sont peut-être pas à jour. Voulez-vous relancer l'exécution ?

Cause :	Des valeurs ont été éditées pendant l'affichage des ventilations, des résumés ou des colonnes définies.

Action :	Exécutez l'interrogation pour mettre les valeurs à jour.


BRW-16623 : Aucune donnée disponible pour cette opération.

Cause :	Message d'alerte qui apparaît si le nombre de lignes ou de colonnes pouvant être imprimées est nul.

Action :	Tentez d'exécuter à nouveau l'interrogation, ou ajoutez des colonnes.


BRW-16624 : Définition d'interrogation modifiée. Les données ne sont peut-être plus à jour. Voulez-vous continuer ?

Cause :	Le document d'interrogation a été modifié depuis sa dernière exécution.

Action :	Exécutez à nouveau l'interrogation et continuez l'export, ou annulez.


BRW-16625 : L'imprimante ne prend pas toutes les polices nécessaires en charge. Voulez-vous changer de police ?

Cause :	La police, un style ou une graisse n'existe pas pour l'imprimante sélectionnée.

Action :	Poursuivez en changeant de police ou annulez.


BRW-16626 : Mémoire insuffisante pour obtenir un aperçu avant impression.

Cause :	Le système n'a pas pu créer une image bitmap permettant un aperçu avant impression.

Action :	Aucune.


BRW-16627 : Aucune donnée disponible pour cette opération. Voulez-vous lancer l'interrogation ?

Cause :	Ce message d'alerte apparaît si une feuille de travail vide a été utilisée pour appeler les les données d'export.

Action :	Tentez à nouveau d'exécuter l'interrogation ou annulez-la.


BRW-16628 : Accès à l'imprimante impossible. Il n'y aura pas d'impression. Voulez-vous continuer ?

Cause :	Erreur de création d'une surface d'imprimante de toolkit avec uiprc().

Action :	Poursuivez sans impression ou annulez l'opération.


BRW-16629 : Voulez-vous mettre à jour le document OLE avant de quitter ?

Cause :	Ce message demande à l'utilisateur d'enregistrer les modifications lorsqu'il ferme/quitte un document OLE.

Action :	Enregistrez ou interrompez les modifications, ou annulez l'opération.


BRW-16650 : L'imprimante ne prend pas toutes les polices nécessaires en charge. Voulez-vous changer de police ?

Cause :	La police, un style ou une graisse n'existe pas pour l'imprimante sélectionnée.

Action :	Poursuivez en changeant de police ou annulez.


BRW-16651 : Aucune imprimante sélectionnée. Voulez-vous utiliser l'imprimante par défaut ?

Cause :	L'utilisateur n'a pas explicitement nommé d'imprimante à utiliser.

Action :	Poursuivez en utilisant l'imprimante par défaut du système ou annulez l'opération.


BRW-16652 : Les marges du document sont trop larges et doivent être modifiées.

Cause :	L'utilisateur a défini des marges trop larges pour le document.

Action :	Modifiez les marges.


BRW-16653 : Aucune imprimante sélectionnée. Voulez-vous utiliser l'imprimante par défaut ?

Cause :	L'utilisateur n'a pas explicitement nommé d'imprimante à utiliser.

Action :	Poursuivez en utilisant l'imprimante par défaut du système ou annulez l'opération.


BRW-16654 : Aucune page imprimée.

Cause :	L'utilisateur a défini le nombre de copies à 0 ou la page de début/de fin n'est pas dans la plage autorisée.

Action :	Modifiez la plage des numéros de page.


BRW-16660 : Définition d'interrogation modifiée. Les données ne sont peut-être pas à jour. Voulez-vous relancer l'exécution ?

Cause :	Le document d'interrogation a été modifié depuis la dernière mise à jour DDE.

Action :	Exécutez à nouveau l'interrogation avant la mise à jour DDE ou mettez à jour sans exécution.


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.


Query Builder - exemples

  Rubriques connexes 	  Tous les exemples

Condition - exemple

Colonnes définies (et calculées) - exemple

Fonction (extraction de noms de plus de 30 caractères) - exemple


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.


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.


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.


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'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.


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 :

n	création d'archives

n	attributs des fichiers archivés

n	révisions successives

n	libellés

n	lignes modifiées dans la dernière révision

n	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 :

n	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.

n	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.

n	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.


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
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
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
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.


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


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 en retrait ou en retrait négatif les lignes sélectionnées.
Plusieurs vues fractionnées	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

n	utiliser les touches TAB et Maj-TAB pour mettre en retrait ou en retrait négatif les lignes sélectionnées

n	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	Début	(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)


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é


Assistant Données : page Bienvenue

A propos de l'assistant Données

L'assistant Données vous permet de définir rapidement et facilement une interrogation, des groupes de ventilation et des totaux pour un état multi-interrogation. Une fois le modèle de données créé, vous pouvez :

•	modifier le modèle de données dans la vue Modèle de données ;

•	utiliser l'assistant Données pour créer des interrogations supplémentaires ;

•	utiliser l'assistant Données pour donner une valeur par défaut à la présentation ;

•	modifier la présentation dans la vue Modèle de présentation, y compris réorganiser et ajouter de nouvelles sections de présentation.

Remarque : Dans la présente version, l'assistant Données ne prend pas en charge la création de liaisons de données entre interrogations. Pour définir des relations d'interrogation père-fils, vous pouvez créer une liaison de données manuellement.

Assistant Données en mode invariant

L'une des principales qualités de l'assistant Données est sa faculté de fonctionner en mode invariant, ce qui signifie que vous pouvez l'utiliser pour modifier les interrogations d'un modèle de données existant.

Pour appeler l'assistant Données en mode invariant, ouvrez une interrogation et choisissez Outils [image] Assistant Données.

Navigation dans l'assistant Données

L'assistant Données comporte six boutons qui vous permettent de naviguer dans ses pages :

•	Annuler - annule toutes les modifications que vous avez effectuées et vous fait sortir de l'assistant.

•	Aide - affiche le texte d'aide en ligne de la page en cours de l'assistant.

•	Précédent - vous fait revenir à la page précédente de l'assistant.

•	Suivant - vous fait passer à la page suivante de l'assistant.

•	Appliquer - applique vos modifications (en mode invariant uniquement).

•	Fin - enregistre vos modifications (si nécessaire) et vous fait sortir de l'assistant.

Remarque:  Si vous cliquez sur Suivant avant d'avoir entré toutes les informations demandées sur une page donnée, vous ne pouvez pas passer à la page suivante. De même, si vous n'avez pas entré dans l'assistant toutes les informations nécessaires avant de cliquer sur Appliquer ou Fin, vous passez automatiquement à la page dans laquelle vous pouvez finir d'entrer les données demandées.


Assistant Données : page Nom d'interrogation

  A propos de l'assistant Données

1	(Facultatif)  Dans le champ Nom d'interrogation, remplacez le nom par défaut de l'interrogation.

2	Si l'interrogation doit être utilisée dans le modèle de données pour un état matriciel (de gauche à droite), cochez la case d'interrogation Matrice.


Assistant Données : page Type

Choisissez le type d'interrogation que vous souhaitez créer :

•	Instruction SQL signifie que vous voulez créer une interrogation qui sélectionne les données dans une base de données relationnelle (Oracle8, par exemple).

•	Interrogation Express signifie que vous voulez créer une interrogation qui sélectionne les données sur un serveur Express.


Assistant Données : page Données

  Rubriques connexes 	  A propos de l'assistant Données

1	Si vous n'êtes pas déjà connecté à une base de données, cliquez sur Connexion et remplissez la boîte de dialogue Connexion.

2	Indiquez une instruction SELECT. Pour cela, vous avez le choix entre plusieurs possibilités :

•	Entrez l'instruction SELECT dans la zone Instruction SQL d'interrogation.

•	Cliquez sur Query Builder et définissez une interrogation en utilisant les boîtes de dialogue de Query Builder. Lorsque vous avez créé votre interrogation, l'instruction SELECT apparaît dans la zone Instruction SQL d'interrogation.

•	Cliquez sur Importer interrogation SQL pour inclure une instruction SQL stockée dans un fichier. Lorsque vous fermez la boîte de dialogue d'import, le contenu du fichier sélectionné est placé dans la zone Instruction SQL d'interrogation.


Assistant Données : page Groupes

  A propos de l'assistant Données

1	Cliquez sur le champ de la liste Champs disponibles qui doit devenir un champ de groupe.

2	Cliquez sur [image] pour faire passer le champ dans la liste Champs de groupe. Il apparaît précédé d'une ligne définissant son niveau de ventilation.

3	Répétez les étapes 1 et 2 pour tous les champs de groupe qui doivent figurer dans l'état.

4	(Facultatif) Cliquez sur un champ de la liste Champs de groupe et faites-le glisser jusqu'au niveau de ventilation de votre choix.

5	(Facultatif) Pour extraire un champ de la liste Champs de groupe, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Si vous voulez placer deux colonnes sur un même niveau de ventilation, cliquez d'abord sur l'une d'elles dans la liste des champs de groupement, puis déplacez une colonne de la liste des champs disponibles. Cette colonne est automatiquement insérée sur le même niveau de ventilation que la colonne sélectionnée. Pour créer un niveau de ventilation, cliquez sur une colonne de la liste des champs disponibles et sur un niveau de ventilation de la liste des champs de groupement, puis déplacez la colonne sélectionnée. Elle est automatiquement insérée sur le niveau de ventilation inférieur à celui sélectionné.

•	Tous les types de données Oracle8 ne sont actuellement pas pris en charge. Si votre interrogation sélectionne un type de données Oracle8 non pris en charge, une icône spéciale vous le signale dans l'assistant.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de groupement comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Données : page Totaux

  A propos de l'assistant Données	  Rubriques connexes

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur le bouton correspondant à la fonction que vous voulez appliquer au champ. Une entrée comportant le nom du champ et de la fonction apparaît dans la liste Totaux.

3	Répétez l'étape 2 pour les autres fonctions que vous voulez appliquer au champ, le cas échéant.

4	Répétez les étapes 1 à 3 jusqu'à ce que vous ayez créé tous les totaux voulus.

5	(Facultatif) Pour supprimer un champ de la liste Totaux, cliquez sur le champ, puis sur le bouton flèche gauche [image].

Notes d'utilisation

•	Tous les types de données Oracle8 ne sont actuellement pas pris en charge. Si votre interrogation sélectionne un type de données Oracle8 non pris en charge, une icône spéciale vous le signale dans l'assistant.

•	Les fonctions que vous pouvez utiliser avec des objets colonne et des colonnes Ref sont en nombre limité. Certaines fonctions apparaissent donc désactivées lorsque vous voulez les sélectionner dans la liste des champs disponibles.

•	Pour les états de groupe, l'assistant Données crée dans le modèle de données n champ(s) de récapitulatif pour chaque colonne récapitulative définie : à savoir un champ à chaque niveau de groupe, au-dessus de la colonne en cours de récapitulation, et un autre au niveau de l'état. Par exemple, si un état est groupé par division, puis par service, et que vous définissiez une colonne récapitulative pour le total des salaires, des champs sont créés pour la somme des salaires de chaque division et service (récapitulatifs de groupe), et pour celle de tous les salaires (récapitulatif d'état).


Assistant Données : page Groupes

  A propos de l'assistant Données

Si les champs de la liste Champs groupe de matrices vous conviennent :

  Cliquez sur Suivant.

Pour modifier les champs de la liste Champs groupes de matrice :

1	Cliquez sur le champ de la liste Champs disponibles qui doit devenir un champ groupes de matrice.

2	Cliquez sur [image] pour faire passer le champ dans la liste Champs de groupe. Il apparaît précédé d'une ligne définissant son niveau de ventilation.

3	Répétez les étapes 1 et 2 pour tous les champs groupes de matrices qui doivent figurer dans l'état.

4	(Facultatif) Sélectionnez un champ de la liste Champs groupes de matrices et faites-le glisser jusqu'au niveau de ventilation de votre choix.

5	(Facultatif) Pour extraire un champ de la liste Champs groupes de matrices, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Pour placer deux colonnes sur le même niveau de ventilation, cliquez d'abord sur l'une d'elles dans la liste des champs de groupement (matrice), puis déplacez une colonne de la liste des champs disponibles. Elle est automatiquement insérée sur le même niveau de ventilation que la colonne sélectionnée. Pour créer un niveau de ventilation, cliquez sur une colonne de la liste des champs disponibles et sur un niveau de ventilation de la liste des champs de groupement (matrice), puis déplacez la colonne sélectionnée. Elle est automatiquement insérée sur le niveau de ventilation inférieur à celui sélectionné.

•	Tous les types de données Oracle8 ne sont actuellement pas pris en charge. Si votre interrogation sélectionne un type de données Oracle8 non pris en charge, une icône spéciale vous le signale dans l'assistant.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de groupe matriciel comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Données : page Lignes

  A propos de l'assistant Données

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur [image] pour faire passer le champ dans la liste Champs lignes de matrices. Il apparaît précédé d'une ligne définissant son niveau de ventilation. Conseil

3	Répétez les étapes 1 et 2 pour tous les champs de lignes matricielles de votre choix.

4	(Facultatif) Pour supprimer un champ de la liste Champs lignes de matrice, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Tous les types de données Oracle8 ne sont actuellement pas pris en charge. Si votre interrogation sélectionne un type de données Oracle8 non pris en charge, une icône spéciale vous le signale dans l'assistant.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de ligne de matrice comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Données : page Colonnes

  A propos de l'assistant Données

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur [image] pour faire passer le champ dans la liste Champs colonnes de matrice. Il apparaît précédé d'une ligne définissant son niveau de ventilation. Conseil

3	Répétez les étapes 1 et 2 pour tous les champs colonnes de matrice de votre choix.

4	(Facultatif) Pour enlever un champ de la liste Champs de colonnes matricielles, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Tous les types de données Oracle8 ne sont actuellement pas pris en charge. Si votre interrogation sélectionne un type de données Oracle8 non pris en charge, une icône spéciale vous le signale dans l'assistant.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de colonne de matrice comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Données : page Cellules

  A propos de l'assistant Données

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur le bouton correspondant à la fonction que vous voulez appliquer au champ. Une entrée comportant le nom du champ et de la fonction apparaît dans la liste Champs cellules de matrice. Conseil

3	Répétez les étapes 1 et 2 pour tous les champs cellules de matrice de votre choix.

4	(Facultatif) Pour supprimer un champ de la liste Champs cellules de matrice, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Tous les types de données Oracle8 ne sont actuellement pas pris en charge. Si votre interrogation sélectionne un type de données Oracle8 non pris en charge, une icône spéciale vous le signale dans l'assistant.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de cellule de matrice comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Report : page Totaux
Assistant Données : page Totaux

  A propos de l'assistant Données

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur le bouton correspondant à la fonction que vous voulez appliquer au champ. Une entrée comportant le nom du champ et de la fonction apparaît dans la liste Totaux matriciels.

3	Répétez l'étape 2 pour les autres fonctions que vous voulez appliquer au champ, le cas échéant.

4	Répétez les étapes 1 à 3 jusqu'à ce que vous ayez créé tous les totaux voulus.

5	(Facultatif) Pour supprimer un champ de la liste Totaux matriciels, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Tous les types de données Oracle8 ne sont actuellement pas pris en charge. Si votre interrogation sélectionne un type de données Oracle8 non pris en charge, une icône spéciale vous le signale dans l'assistant.

•	Les fonctions que vous pouvez utiliser avec des objets colonne et des colonnes Ref sont en nombre limité. Certaines fonctions apparaissent donc désactivées lorsque vous voulez les sélectionner dans la liste des champs disponibles.


Assistant Données : page Fin

  A propos de l'assistant Données

Etape suivante

Vous pouvez maintenant sortir de l'assistant Données et travailler sur l'état. Lorsque vous cliquez sur Fin, Report Builder ferme l'assistant Données et affiche automatiquement le modèle de données dans la vue Modèle de données. A ce stade, vous pouvez :

•	modifier le modèle de données dans la vue Modèle de données ;

•	utiliser l'assistant Données pour créer des interrogations supplémentaires ;

•	utiliser l'assistant Données pour donner une valeur par défaut à la présentation ;

•	modifier la présentation dans la vue Modèle de présentation, y compris réorganiser et ajouter de nouvelles sections de présentation.

Pour plus d'informations sur la création d'états, reportez-vous à l'aide en ligne :

1	Affichez l'Aperçu produit pour avoir une vue d'ensemble de Report Builder :

•	Choisissez Aide [image] Aperçu produit.

2	Etudiez les différents assistants pour savoir comment exécuter les tâches les plus courantes :

•	Choisissez Aide [image] Assistants.

3	Accédez aux manuels en ligne/imprimés :

•	Choisissez Aide [image] Manuels.

4	Localisez les rubriques d'aide :

•	Pour la table des matières et l'index, choisissez Aide [image] Rubriques d'aide.

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


Boîte de dialogue d'alignement d'objets

Description  Cette boîte de dialogue permet d'indiquer comment une série d'objets doivent être positionnés.

Cette boîte de dialogue contient :

Aligner objets les uns par rapport aux autres/par rapport à la grille

Horizontal

Vertical


Aligner objets les uns par rapport aux autres/par rapport à la grille

Description  Ce bouton d'option permet d'indiquer sur quoi vous voulez aligner le ou les objets sélectionnés. Choisissez l'une des deux valeurs suivantes.

Valeurs

Par rapport à la grille	Permet d'indiquer que vous voulez aligner l'objet sur le point magnétique le plus proche.
Les uns par rapport aux autres	Permet d'indiquer que vous voulez aligner l'objet sur le ou les autres objets sélectionnés.


Horizontal

Description  Bouton d'option qui permet d'indiquer comment vous voulez aligner les objets horizontalement.

Valeurs

Centrer	Permet de déplacer les objets sélectionnés de sorte que leur point central horizontal soit aligné sur un point central commun à tous les objets sélectionnés.
Aligner à gauche	Permet de déplacer les objets sélectionnés de sorte que leur bord gauche soit aligné sur le bord gauche de l'objet sélectionné le plus à gauche.
Aligner à droite	Permet de déplacer les objets sélectionnés de sorte que leur bord droit soit aligné sur le bord droit de l'objet sélectionné le plus à droite.
Répartir	Permet de déplacer les objets sélectionnés et de les placer à égale distance les uns des autres en laissant les objets les plus à gauche et les objets les plus à droite à leur position horizontale d'origine.
Empiler	Permet de déplacer les objets sélectionnés de sorte que le côté gauche de chaque objet soit aligné sur le côté droit de l'objet qui se trouve immédiatement à sa gauche. L'objet qui se trouve le plus à gauche conserve sa position d'origine.
Aucun	Permet d'indiquer qu'aucun alignement horizontal n'est effectué.


Vertical

Description Bouton d'option qui permet d'indiquer comment vous voulez aligner les objets verticalement.

Valeurs

Aligner sur bas	Permet de déplacer les objets de sorte que leur côté inférieur soit aligné sur le côté inférieur de l'objet sélectionné le plus bas.
Centrer	Permet de déplacer les objets sélectionnés de sorte que leur point central horizontal soit aligné sur un point central commun à tous les objets sélectionnés.
Aligner sur haut	Permet de déplacer les objets de sorte que leur côté supérieur soit aligné sur le côté supérieur de l'objet sélectionné le plus haut.
Répartir	Permet de déplacer les objets sélectionnés et de les positionner à égale distance les uns des autres, en laissant les objets les plus hauts et les plus bas à leur position verticale d'origine.
Empiler	Permet de déplacer les objets sélectionnés de sorte que le côté supérieur de chaque objet soit aligné sur le bas de l'objet qui se trouve immédiatement au-dessus de lui. L'objet du haut conserve sa position d'origine.
Aucun	Permet d'indiquer qu'aucun alignement vertical n'est effectué.


Boîte de dialogue de dimensionnement d'objets

Description  Cette boîte de dialogue vous permet de redimensionner un ensemble d'objets les uns par rapport aux autres.

Elle contient :

Hauteur personnalisée

Largeur personnalisée

Hauteur

Unités

Largeur


Hauteur personnalisée

Description  Hauteur personnalisée permet d'indiquer la hauteur à laquelle chaque objet sélectionné sera redimensionné si le bouton d'option Personnalisé est sélectionné pour Hauteur.

Valeurs

Entrez un entier positif.


Largeur personnalisée

Description  Largeur personnalisée permet d'indiquer la largeur à laquelle chaque objet sélectionné sera redimensionné si le bouton d'option Personnalisé est sélectionné pour Largeur. L'unité de mesure de cette valeur est indiquée par les boutons d'option correspondants.

Valeurs

Entrez un entier positif.


Hauteur

Description  Hauteur regroupe un ensemble de boutons d'option permettant d'indiquer comment vous voulez modifier la hauteur des objets sélectionnés.

Valeurs

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 entrée dans le champ de texte Hauteur personnalisée.
Plus grand	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa hauteur soit égale à celle de l'objet sélectionné la plus élevée.
Aucune modification	Permet d'indiquer que la hauteur des objets ne sera pas modifiée.
Plus petit	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa hauteur soit égale à la hauteur de l'objet sélectionné la plus faible.


Unités

Description  Unités permet d'indiquer l'unité de mesure utilisée dans les champs Largeur personnalisée et Hauteur personnalisée.

Valeurs

Centimètres

Cellules de caractère

Pouces

Points


Largeur

Description  Largeur regroupe un ensemble de boutons d'option permettant d'indiquer comment vous voulez modifier la largeur des objets sélectionnés.

Valeurs

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 entrée dans le champ de texte Largeur personnalisée.
Plus grand	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa largeur soit égale à celle de l'objet sélectionné la plus élevée.
Aucune modification	Permet d'indiquer que la largeur des objets ne sera pas modifiée.
Plus petit	Permet d'indiquer que chaque objet sera redimensionné de sorte que sa largeur soit égale à celle de l'objet sélectionné la plus faible.


Boîte de dialogue Graphique

  Rubriques connexes

Description  Cette boîte de dialogue vous permet d'établir une correspondance entre les colonnes et les paramètres d'un état et les colonnes et les paramètres d'un graphique.

Cette boîte de dialogue contient :

  onglet Paramètres

  onglet Colonnes


Boîte de dialogue Liste de valeurs

Description  Cette boîte de dialogue vous permet de définir une liste de valeurs pour un paramètre. Vous pouvez créer une liste statique de valeurs ou utiliser les valeurs stockées dans la base de données. Lorsque vous sélectionnez le type de liste que vous voulez créer (Valeurs statiques ou Instruction SELECT), les définitions de la boîte de dialogue changent en conséquence.

Cette boîte de dialogue contient :

Ajouter

Masquer première colonne

Liste de valeurs

Query Builder

Supprimer

Restreindre la liste à des valeurs prédéterminées

Instruction SELECT/Liste statique de valeurs

Valeur


Query Builder

Description  Query Builder appelle une série de boîtes de dialogue que vous pouvez utiliser pour créer une instruction SELECT.


Boîte de dialogue Couleurs/Motifs

Description  La boîte de dialogue Couleurs/Motifs vous permet de choisir une couleur ou un motif pour la propriété en cours dans la Palette de propriétés. Sélectionnez une couleur ou un motif et validez la boîte de dialogue.


Boîte de dialogue Instruction d'interrogation SQL

Description  Cette boîte de dialogue vous permet d'entrer une instruction SQL SELECT. Vous pouvez entrer l'instruction SELECT, utiliser Query Builder pour la créer, ou importer une interrogation existante.

Cette boîte de dialogue contient :

Instruction d'interrogation SQL	Instruction SELECT que vous avez créée
Query Builder	Permet d'afficher Query Builder (ensemble de boîtes de dialogue qui vous permettent de créer une instruction SELECT)
Connecter	Permet d'afficher la boîte de dialogue Connexion qui vous permet de vous connecter à la base de données de votre choix.
Importer interrogation SQL	Permet d'afficher une boîte de dialogue du fichier dans laquelle vous avez choisir un fichier SQL à importer
Notes d'utilisation

•	L'instruction SELECT que vous entrez doit respecter toutes les règles syntaxiques de langage SQL applicables aux instructions SELECT. Reportez-vous à ORACLE8 Server SQL Language Reference Manual.

•	Si vous utilisez des caractères sur 8 bits (par exemple, Danish_Denmark.we8ISO8859P1), vous devez faire précéder et suivre les colonnes, les tables et les paramètres de double guillemets.


Boîte de dialogue Formatage conditionnel

  Rubriques connexes

Description  Cette boîte de dialogue vous permet d'ajouter, de modifier ou de supprimer les exceptions de format qui définissent les attributs de formatage conditionnel (police et/ou couleur) utilisés pour mettre en surbrillance les données de votre état. La boîte de dialogue Exception de format (qui apparaît lorsque vous cliquez sur Nouveau ou sur Modifier) permet d'indiquer rapidement et facilement les attributs de mise en forme de sortie d'un objet de présentation sélectionné, sur la base de conditions définies.

Cette boîte de dialogue contient les éléments suivants :

Exception de formatage	Répertorie les exceptions de format définies dans la boîte de dialogue Exception de format. La mise en forme est appliquée dans l'ordre d'affichage des exceptions dans la liste ; les nouvelles exceptions de format remplacent les anciennes si le paramètre sélectionné est TRUE.
Nouveau	Affiche la boîte de dialogue Exception  de format qui vous permet de définir une nouvelle exception de format.
Modifier	Affiche la boîte de dialogue Exception  de format qui vous permet de modifier une exception de format existante.
Supprimer	Supprime l'exception de format sélectionnée.
Exemple	Affiche l'exemple obtenu lorsque l'exception est TRUE. Si vous masquez l'objet, les mots « Masquer l'objet » apparaissent.
Vers le haut Vers le bas	Déplace l'exception de format vers le haut ou vers le bas dans la liste Exception de formatage. Remarque : Vous pouvez également faire glisser les éléments dans la liste.


Boîte de dialogue Exception de format

  Rubriques connexes

Description  Cette boîte de dialogue permet d'indiquer rapidement et facilement les attributs de mise en forme de sortie d'un objet de présentation sélectionné, sur la base de conditions définies. Vous pouvez en définir trois, évaluées dans l'ordre indiqué (par exemple de haut en bas). Chaque condition TRUE est appliquée, à moins que l'objet soit destiné à être masqué (dans ce cas, il est inutile de procéder à sa mise en forme).

Cette boîte de dialogue contient les éléments suivants :

Cases à cocher Condition

Liste déroulante Paramètre/colonne

Liste déroulante Condition

Champs de valeur

Liste déroulante AND/OR

Partie Mise en forme :

Couleur de la bordure

Couleur de remplissage

Police

Masquer l'objet

Réinitialiser format

Couleur du texteText>referenc


Cases à cocher Condition

Description  Ces cases à cocher vous permettent d'indiquer jusqu'à trois conditions.

Valeur

Cochez la case correspondant à chacune des conditions que vous voulez indiquer.


Liste déroulante Paramètre/colonne

Description  Cette liste déroulante présente les paramètres système et utilisateur pour lesquels des conditions peuvent être définies, ainsi que les colonnes de type nombre, date, caractère et long qui peuvent fournir des valeurs à l'objet de présentation.

Valeurs

Choisissez un paramètre ou une colonne dans la liste.


Liste déroulante Condition

Description  Cette liste déroulante présente les conditions valides pour le paramètre ou la colonne sélectionnés.

Valeurs

Choisissez une condition dans la liste.


Champs de valeur

Description  Les champs de valeur vous permettent d'indiquer une ou plusieurs valeurs pour le paramètre ou la colonne sélectionnés.

Valeurs

Choisissez une ou plusieurs valeurs dans la liste ou entrez-les pour la colonne ou le paramètre sélectionnés. Vous pouvez indiquer des valeurs littérales ou des variables liées, comme par exemple :

SAL between :LOWSAL and 50000

où :LOWSAL est une colonne ou un paramètre du modèle de données.


Liste déroulante AND/OR

Description  Cette liste déroulante vous permet d'indiquer une logique booléenne pour le calcul du résultat de plusieurs conditions. Si vous avez indiqué trois conditions, le résultat des deux premières est calculé avant d'être opposé à la troisième, c'est-à-dire : (condition1 AND/OR condition2) AND/OR condition3.

Cette liste déroulante n'est accessible que lorsque la case à cocher de la condition suivante est cochée.

Valeurs

AND	La condition courante ET la condition suivante doivent être remplies (TRUE) pour que la mise en forme soit appliquée.
OR	La condition courante OU la condition suivante doivent être remplies(TRUE) pour que la mise en forme soit appliquée.


Couleur de la bordure

Description  Il s'agit de la couleur de la bordure de l'objet de présentation lorsque la ou les conditions indiquées ont pour valeur TRUE.

Valeurs

Cliquez sur [image] et sélectionnez une couleur dans la palette de couleurs.


Couleur de remplissage

Description  Il s'agit de la couleur de remplissage (d'arrière-plan) de l'objet de présentation lorsque la ou les conditions indiquées ont pour valeur TRUE.

Valeurs

Cliquez sur [image] et sélectionnez une couleur dans la palette de couleurs.


Police

Description  Affiche la boîte de dialogue Police, qui vous permet de modifier le type, la graisse et la taille de la police de l'objet de présentation lorsque la ou les conditions indiquées ont pour valeur TRUE. Si vous cliquez sur OK dans la boîte de dialogue Police, Report Builder applique tous les paramètres de cette boîte de dialogue à l'objet de présentation lorsque les conditions indiquées ont pour valeur TRUE (que vous ayez ou non modifié les paramètres par défaut dans la boîte de dialogue Police).


Masquer l'objet

Description  Cette case à cocher vous permet d'indiquer si l'objet de présentation doit ou non apparaître sur l'état mis en forme lorsque la ou les conditions indiquées ont pour valeur TRUE.

Valeur

Activée	Masque l'objet sur l'état mis en forme.
Désactivée	Ne masque pas l'objet sur l'état mis en forme.


Réinitialiser format

Description  Ce bouton vous permet de rétablir les paramètres existants de l'objet de présentation et de n'effectuer ainsi aucune modification. Couleur et police prennent leur valeur <par défaut>.


Couleur du texte

Description  Il s'agit de la couleur du texte de l'objet de présentation lorsque la ou les conditions indiquées ont pour valeur TRUE.

Valeurs

Cliquez sur [image] et sélectionnez une couleur dans la palette de couleurs.


 Options de la boîte de dialogue Conversion

Description  Cette boîte de dialogue permet de créer une copie d'un état ou d'une bibliothèque PL/SQL dans un format différent. Par exemple, vous pouvez convertir une définition d 'état, stockée dans la base de données, dans un fichier pouvant être exécuté par RWRUN60. Vous pouvez également convertir une définition d'état en un modèle à appliquer à d'autres états.

Cette boîte de dialogue contient :

  page Conversion

  page Options

Notes d'utilisation

•	Dans certains cas, la commande Convert compile automatiquement le code PL/SQL de l'état pendant la conversion. Si la destination de la conversion n'est pas un fichier .rex, le code PL/SQL est automatiquement compilé dans les conditions décrites ci-dessous. Dans tous les autres cas, vous devez compiler vous-même le code PL/SQL de l'état (par exemple, Programme [image] Compiler [image] Tout).

•	Vous tentez de créer un fichier .rep en utilisant la commande Convert. En cas d'erreurs de compilation, un message d'erreur s'affiche et le fichier .rep n'est pas créé.

•	Vous utilisez un fichier .rex comme état Source. En cas d'erreurs de compilation, un message d'avertissement s'affiche, mais la conversion se poursuit.

•	Vous utilisez un état créé sur une autre plate-forme comme état Source. En cas d'erreurs de compilation, un message d'avertissement s'affiche, mais la conversion se poursuit.

•	Le programme établit la correspondance des polices lorsque Report Builder ou Reports Runtime ouvre un état. Cette correspondance n'est pas établie pendant la conversion.

•	Lors de la conversion d'un état en modèle, seuls les objets des pages de garde et de fin d'état, et de la zone des marges sont utilisés dans le modèle. Les objets du corps de l'état ne sont pas pris en compte.

•	Lors de la conversion d'états auxquels sont attachées des bibliothèques, vous devez convertir les fichiers .pll attachés à l'état avant de convertir le fichier .rdf.


Onglet Conversion
Page Conversion

Description  Cet onglet permet d'indiquer les informations de source et de destination de la conversion que vous voulez effectuer. La plupart des éléments de cet onglet correspondent à des mots-clés RWCON60.

Type de document

Destination	DEST

Type destination	DTYPE

Source	SOURCE

Type de source	STYPE


Onglet Options
Page Options

Description  Cet onglet permet d'indiquer des caractéristiques de conversion spéciales. Tous les éléments de cet onglet correspondent à des mots-clés RWCON60.

Unité destination	DUNIT

Format grille	FORMSIZE

FIchier journal	LOGFILE

Ecraser	OVERWRITE

Format page	PAGESIZE


Type de document

Description  Type de document permet d'indiquer le type du document que vous convertissez.

Valeurs

Bibliothèque PL/SQL

Etat

Valeur par défaut

Etat


Etat de conversion

Description  Cette boîte de dialogue fournit des informations sur le déroulement de la conversion (par exemple, si la conversion a réussi ou échoué, pourquoi elle a échoué, etc.).


Boîte de dialogue Commentaire

Description  Cette boîte de dialogue permet de documenter un objet, par exemple, décrire le but d'un objet afin que quelqu'un d'autre puisse comprendre rapidement ce que fait cet objet.  Entrez un texte ne dépassant pas 64 Ko.


Boîte de dialogue Sortie délimitée

  Rubriques connexes

Description  La boîte de dialogue Sortie délimitée définit les préférences de la sortie d'état délimitée.

Cette boîte de dialogue contient les éléments suivants :

Séparateur

Masque de format de date

Masque de format numérique

Intercalaire de cellules


DELIMITER
Séparateur

  Rubriques connexes

Description  La valeur Séparateur indique le ou les caractères utilisés pour séparer les cellules de votre sortie d'état délimitée.

Valeurs

Tab	Une tabulation sépare les cellules.
,	Une virgule sépare les cellules.
:	Cellules séparées par deux-points.
;	Cellules séparées par un point-virgule.
|	Cellules séparées par une barre verticale.
?	Cellules séparées par un point d'interrogation.
$	Cellules séparées par un signe dollar.
.	Un point sépare les cellules.
Espace	Un espace sépare les cellules.
Entrée	Un interligne sépare les cellules.
Tout caractère alphanumérique ou toute chaîne de caractères alphanumériques	Cellules séparées par le ou les caractères entrés dans la zone de texte.
Valeur par défaut

Tab

Notes d'utilisation

Vous pouvez également utiliser les séquences d'échappement fondées sur le jeu de caractères ASCII.


Masque de format de date

Description  Le Masque de format de date indique la manière dont les valeurs de date apparaissent dans votre sortie d'état délimitée.

Valeurs

tout masque de format de date valide

Valeur par défaut

none

Notes d'utilisation

•	Vous ne pouvez utiliser cette option que si vous avez sélectionné un séparateur (delimiter).

Le masque de format ne concerne que les données de date.


Masque de format numérique

Description  Le Masque de format numérique indique la manière dont les valeurs apparaissent dans votre sortie d'état délimitée.

Valeurs

tout masque de format numérique valide

Valeur par défaut

none

Notes d'utilisation

•	Vous ne pouvez utiliser cette option que si vous avez sélectionné un séparateur (delimiter).

•	Le masque de format ne concerne que les données numériques de votre sortie d'état.


Intercalaire de cellules

Description  La valeur Intercalaire de cellules indique le ou les caractères à afficher autour de chaque cellule de votre sortie d'état délimitée.

Valeurs

none	Aucun intercalaire de cellules.
«	Des guillemets apparaissent de part et d'autre de la cellule.
‘	Des apostrophes apparaissent de part et d'autre de la cellule.
Espace	Des espaces apparaissent de part et d'autre de la cellule.
Tout caractère alphanumérique ou toute chaîne de caractères alphanumériques	Le ou les caractères entrés dans la zone de texte apparaissent de part et d'autre de la cellule.
Valeur par défaut

none

Notes d'utilisation

•	Vous ne pouvez utiliser cette option que si vous avez sélectionné un séparateur (delimiter).

•	Vous pouvez également utiliser les séquences d'échappement fondées sur le jeu de caractères ASCII.


Boîte de dialogue Affichage

Description  Cette boîte de dialogue indique l'emplacement du document, de la base de données ou du fichier. Elle permet également de contrôler le type des documents affichés dans la liste de valeurs de la boîte de dialogue de fichier ou de base de données. La boîte de dialogue Affichage n'apparaît que si Préférence d'accès Objet est définie à Fichier/Base de données.

Cette boîte de dialogue contient :

  Afficher

  Ouvrir depuis


Boîte de dialogue Affichage

Description  Cette boîte de dialogue indique le type des documents à afficher dans la liste de valeurs de la boîte de dialogue de fichier ou de base de données.

Cette boîte de dialogue contient :

  Afficher


Afficher

Description  Cette option se compose de cinq cases à cocher qui permettent d'indiquer le type d'objet que vous voulez inclure dans la liste affichée dans la boîte de dialogue de sélection de fichier ou de base de données.

Valeurs

Tout	Tout sera inclus.
Bibliothèques PL/SQL	Les bibliothèques PL/SQL externes seront incluses.
Interrogations	Les interrogations externes seront incluses.
Etats	Les états seront inclus.
Modèles	Les modèles seront inclus.
Valeur par défaut

Tout


Ouvrir depuis

Description  Cette option permet d'indiquer l'endroit où se trouve le document : dans une base de données ou dans un fichier.

Valeurs

Base de données

Fichier

Fichier/Base de données

Valeur par défaut

Base de données


Boîte de dialogue Sélection de base de données

Description Cette boîte de dialogue permet de sélectionner dans la base de données un objet à utiliser.

Cette boîte de dialogue contient :

Ouvrir	Nom de l'objet que vous voulez sélectionner. Vous pouvez entrer le nom de l'objet ou le sélectionner dans une liste de valeurs. Les documents stockés dans la base de données ont un ID utilisateur qui précède le nom et un signe deux points (:) suivi d'un suffixe (REPORT, QUERY ou LIB) ajouté au nom. Si vous entrez le nom de l'objet, Report Builder lui ajoute automatiquement votre ID utilisateur comme préfixe, puis le suffixe approprié. Les documents sont classés tout d'abord par type (REPORT, QUERY, LIB), puis par ID utilisateur (utilisateur en cours, suivi des utilisateurs en ordre alphabétique), puis par nom de document, en ordre alphabétique. La liste de valeurs est limitée par l'option Afficher de la boîte de dialogue Affichage. Par exemple, si vous avez indiqué uniquement Interrogations sous l'option Afficher, la liste des valeurs ne contiendra que les noms des interrogations externes stockées dans la base de données.
Extraire liste	Si vous avez sélectionné Supprimer extraction de liste sur entrée dans la boîte de dialogue Préférences, la boîte de dialogue Base de données n'affiche pas la liste des objets existant dans la base de données. Pour afficher cette liste, vous devez sélectionner le bouton Extraire liste. Si le bouton Supprimer extraction de liste sur entrée n'est pas sélectionné, le bouton Extraire liste est désactivé (puisque la liste a déjà été affichée).
Notes d'utilisation

•	Les noms des documents stockés dans la base de données peuvent être, indifféremment, en majuscules ou en minuscules.


Boîte de dialogue Diffusion

  Restrictions	  Rubriques connexes

Description  La boîte de dialogue Diffusion permet d'indiquer plusieurs destinations pour la sortie d'état et/ou de section et de supprimer des destinations de la liste de diffusion.

Cette boîte de dialogue contient les éléments suivants :

Liste de diffusion	Liste des destinations de l'état ou de la section en cours.
ID de diffusion	Identificateur d'une destination.
DESNAME	Nom du chemin d'accès et ID de fichier, d'imprimante ou de courrier électronique (ou liste de diffusion) auxquels la sortie d'état est envoyée. Remarque : Si vous indiquez un fichier, les répertoires entrés dans le chemin d'accès doivent exister.
	Valeur par défaut repname repnamem repnameh repnamet	pour l'état pour la section principale pour la section d'en-tête pour la section de fin
DESFORMAT	Format de destination ou pilote d'imprimante à utiliser lorsque DESTYPE est paramétré sur FILE.
	Valeurs
	BITMAP	Désigne le format bitmap, tel qu'il apparaît dans Form Builder, qui peut être envoyé à l'imprimante.
	HTML	Désigne un format HTML lisible par un navigateur compatible HTML 3.0.
	HTMLCSS	Désigne un format HTML lisible par un navigateur compatible HTML 3.0 qui prend en charge les feuilles de style en cascade.
	PDF	Désigne un format PDF lisible par un visualiseur PDF. La sortie PDF dépend de l'imprimante actuellement configurée sur votre système. Le pilote de cette imprimante permet de générer la sortie ; une imprimante configurée pour l'ordinateur sur lequel vous exécutez l'état doit donc être disponible.
	ASCII	Désigne un format de caractères (ASCII) qui peut être envoyé à une messagerie compatible MAPI.
	RTF	Désigne un format RTF lisible par les traitements de texte standard (comme Microsoft Word).
	Valeur par défaut BITMAP
DESTYPE	Type de l'unité de destination qui doit recevoir la sortie d'état
	Valeurs
	FILE	Désigne un fichier (identifié par DESNAME).
	MAIL	Désigne un courrier électronique (les ID de courrier sont identifiés par DESNAME). Vous pouvez envoyer du courrier à tout système de courrier compatible MAPI ou dont le pilote prestataire de services est installé. L'état est envoyé sous forme de fichier joint.
	PRINTER	Désigne une imprimante (identifiée par DESNAME).
	Valeur par défaut FILE
COPIES	Nombre de copies à diffuser.
Nouveau	Ajoute la définition de diffusion à la section Paramètres de la Liste de diffusion et crée une ligne pour la nouvelle définition de diffusion.
Supprimer	Supprime la définition de diffusion sélectionnée de la Liste de diffusion.
Supprimer tout	Efface la Liste de diffusion.


Restrictions liées à la distribution

•	Vous pouvez distribuer les états vers plusieurs destinations en mode bitmap ou en mode caractère, mais pas dans un mode associant les deux.

•	Vous devez paramétrer le paramètre système MODE sur le mode caractère pour distribuer des états au format ASCII.


Boîte de dialogue Valeur avant état

Description  Cette boîte de dialogue vous permet d'indiquer un code HTML pour la propriété Valeur avant état. Entrez le code HTML et validez la boîte de dialogue.


Boîte de dialogue Valeur après état

Description  Cette boîte de dialogue vous permet d'indiquer un code HTML pour la propriété Valeur après état. Entrez le code HTML et validez la boîte de dialogue.


Boîte de dialogue Valeur avant page

Description  Cette boîte de dialogue vous permet d'indiquer un code HTML pour la propriété Valeur avant page. Entrez le code HTML et validez la boîte de dialogue.


Boîte de dialogue Valeur après page

Description  Cette boîte de dialogue vous permet d'indiquer un code HTML pour la propriété Valeur après page. Entrez le code HTML et validez la boîte de dialogue.


Boîte de dialogue Valeur avant application Forms

Description  Cette boîte de dialogue vous permet d'indiquer un code HTML pour la propriété Valeur avant application Forms. Entrez le code HTML et validez la boîte de dialogue.


Boîte de dialogue Valeur après application Forms

Description  Cette boîte de dialogue vous permet d'indiquer un code HTML pour la propriété Valeur après application Forms. Entrez le code HTML et validez la boîte de dialogue.


Boîte de dialogue Valeur Contrôle de navigation de page

Description  La boîte de dialogue Valeur Contrôle de navigation de page permet d'indiquer un code HTML et la propriété Valeur Contrôle de navigation de page. Entrez le code HTML voulu et validez.


Boîte de dialogue Définition d'interrogation externe

  Exemples	  Restrictions

Description  Cette boîte de dialogue contient l'instruction SQL SELECT que vous voulez utiliser comme interrogation externe. Entrez une instruction SELECT valide ne dépassant pas 64 Ko ou sélectionnez Outils [image] Query Builder pour construire une interrogation..


Instruction SELECT avec clause WHERE - Exemple

  Rubriques  connexes 	  Tous les exemples

SELECT O.CUSTID, P.DESCRIP, I.ITEMTOT, O.ORDERDATE,
      I.ORDID
FROM ORD O, PRODUCT P, ITEM I
      I.PRODID = P.PRODID
WHERE O.ORDID = I.ORDID AND
ORDER BY O.CUSTID, P.PRODID, O.ORDERDATE
/* Pour chaque client, afficher les produits qu'il a achetés */
/* (DESCRIP), la somme dépensée pour chaque produit */
/* (ITEMTOT), la date de commande de chaque produit*/
/* (ORDERDATE), l'identificateur de commande (ITEM.ORDID) de */
/* la commande utilisée pour l'achat de chaque produit. */


Instruction SELECT avec références de paramètre - Exemple

  Rubriques connexes 	  Tous les exemples

SELECT CUSTID, SUM(TOTAL) TOTAL
FROM &FROMGROUP
HAVING SUM(TOTAL) > :MINTOTAL
/* &FROMGROUP est un paramètre dont la valeur initiale est ORD GROUP */
/* BY CUSTID.  Notez que, dans ce cas, vous devez définir un paramètre appelé */
/* FROMGROUP ayant la valeur initiale indiquée.*/
/* Si la valeur de &FROMGROUP est nulle lorsque l'instruction SELECT est */
/* analysée, vous recevrez un message d'erreur parce que l'instruction  */
/* n'aura pas de nom de table après FROM.
/* :MINTOTAL est une colonne, provenant d'une autre interrogation, utilisée*/
/* pour sélectionner les clients auxquels ne correspond qu'un total minimum de cmmandes.*/


Instruction SELECT - Restrictions

Attention:  Si vous mettez à jour l'instruction SELECT,  assurez-vous que cette opération n'invalide pas de définitions d'état faisant référence à l'interrogation externe. Par exemple, si un état comporte une colonne DEPTNO et que  vous supprimiez DEPTNO de la liste SELECT de l'interrogation externe, l'état ne pourra pas s'exécuter.

•	L'instruction SELECT que vous entrez doit respecter toutes les règles de syntaxe de langage SQL applicables aux instructions SELECT. Reportez-vous à ORACLE8 Server SQL Language Reference Manual.

•	L'instruction SELECT ne doit pas se terminer par un point virgule, une barre oblique ou tout autre caractère.

•	L'instruction SELECT est validée lorsque vous acceptez l'interrogation d'état qui y fait référence. L'instruction SELECT est également validée et re-lue lorsque vous exécutez un état qui y fait référence.

•	Pour faire référence à l'interrogation externe dans un état, vous devez avoir les autorisations appropriées sur les tables et les vues référencées dans l'interrogation externe. Sinon, vous recevrez un message d'erreur.

•	Si vous utilisez une référence lexicale à un paramètre dans une interrogation externe, Report Builder la remplace par une valeur nulle lorsqu'il l'analyse.

•	Si vous utilisez des caractères sur 8 bits (par exemple, Danish_Denmark.we8ISO8859P1) dans un nom de table, de colonne ou de paramètre, placez ces éléments entre guillemets.


Boîte de dialogue Interlignage perso

Description  Cette boîte de dialogue permet d'indiquer un espacement vertical personnalisé entre les lignes de texte de champ ou de texte standard. Sélectionnez ou entrez le nombre de points à utiliser.

Cette boîte de dialogue contient :

6 pts

12 pts

18 pts

Autre	Vous propose d'entrer un nombre positif de points dans le champ qui suit.

Notes d'utilisation

•	L'interlignage est sans effet sur le texte des libellés de bouton créé par l'utilisateur.

•	L'interlignage ne peut pas être défini sur une partie sélectionnée de texte standard. Il doit s'appliquer à tout l'objet standard.


Boîte de dialogue Epaisseur de ligne personnalisée

Description  Cette boîte de dialogue permet d'indiquer la largeur d'une bordure personnalisée d'objet. Sélectionnez l'unité de mesure à utiliser et entrez une valeur pour Epaisseur.

Cette boîte de dialogue contient :

Pouces	Permet d'indiquer une épaisseur en pouces.
Centimètres	Permet d'indiquer une épaisseur en centimètres.
Points	Permet d'indiquer une épaisseur en points.
Epaisseur	Entrez, sous la forme d'un entier positif, l'épaisseur des lignes des objets sélectionnés.


Boîte de dialogue Options de dessin - généralités

Description  Cette boîte de dialogue permet d'indiquer les options qui définissent la façon dont les objets sont dessinés dans l'Editeur d'état. Choisissez une option pour Type d'extrémité, pour Type de jointure et pour Création d'objet.

Cette boîte de dialogue contient :

Type d'extrémité	Permet d'indiquer le type d'extrémité des objets. Choisissez Bout à bout, Projection ou Arrondi.
Type de jointure	Permet d'indiquer le type de jointure à utiliser aux points de contact des objets dans l'Editeur d'état. Choisissez Biseau, Angle droit ou Arrondi.
Création d'objet	Permet d'indiquer le point à partir duquel les objets doivent être dessinés lorsque vous les créez. Choisissez Tracer à partir du centre ou Tracer à partir d'un angle.
Notes d'utilisation

•	Ces options ne s'appliquent qu'aux objets tracés dans la présentation ou la grille de paramètres.

•	Si vous choisissez Création d'objet, puis Tracer à partir du centre et que vous validiez la boîte de dialogue, un signe + apparaît en regard des outils de la palette d'outils qui seront concernés par cette option.


Boîte de dialogue Arc

Description  Cette boîte de dialogue permet d'indiquer le mode de traçage dans l'Editeur d'état. Choisissez une option pour Fermeture de l'arc et pour Remplissage de l'arc.

Cette boîte de dialogue contient :

Fermeture de l'arc	Permet d'indiquer si l'arc doit être fermé. Choisissez Fermé ou Ouvert.
Remplissage de l'arc	Permet d'indiquer si l'intérieur de l'arc doit être rempli d'un motif. Choisissez Corde ou Secteur.


Boîte de dialogue Rectangle arrondi

Description  Cette boîte de dialogue permet d'indiquer le mode de traçage des rectangles arrondis dans l'Editeur d'état. Choisissez une unité de mesure sous Unités et entrez une valeur numérique pour Horizontal et pour Vertical.

Cette boîte de dialogue contient :

Horizontal	Permet d'indiquer le rayon horizontal des angles arrondis d'un rectangle arrondi. Entrez une valeur positive.
Vertical	Permet d'indiquer le rayon vertical des angles arrondis d'un rectangle arrondi. Entrez une valeur positive.
Unités	Permet d'indiquer l'unité de mesure à utiliser pour les valeurs de Horizontal et de Vertical. Choisissez Centimètres, Pouces ou Points.


Boîte de dialogue Options de dessin - image

Description  Cette boîte de dialogue permet d'indiquer comment les images seront dessinées.

Cette boîte de dialogue contient :

Trame de l'image	Permet d'indiquer si l'image doit être tramée ou non. Le tramage simule les couleurs qui apparaissent dans l'image, mais ne figurent pas dans la palette de couleurs de Report Builder. Si l'image n'est pas tramée, Report Builder utilise les couleurs disponibles qui correspondent le mieux à celles de l'image. Une image tramée est plus agréable à l'oeil, mais plus longue à afficher. Choisissez Activée ou Désactivée.
Qualité de l'image	Permet d'indiquer la qualité d'affichage de l'image par Report Builder. Une image de qualité supérieure est plus agréable à l'oeil, mais plus longue à afficher. Choisissez Max., Moyen ou Min.


Boîte de dialogue Palette de couleurs

Description  Cette boîte de dialogue permet de modifier les couleurs de la palette.

Cette boîte de dialogue contient :

Couleur courante	Permet d'indiquer le nom de la couleur sélectionnée.
Editer	Permet d'afficher une roue de couleurs dans laquelle vous pouvez modifier les paramètres de la couleur en cours.
Nom de palette	Permet d'indiquer le nom de la palette de couleurs en cours.
Renommer	Permet de donner à la couleur le nom que vous avez entré dans Couleur courante.
Sélectionner la couleur à éditer	Contient la palette de couleurs utilisée dans l'Editeur d'état. Lorsque vous sélectionnez une couleur de la palette, vous voyez apparaître une roue de couleurs dans laquelle vous pouvez modifier la couleur courante. Lorsque vous validez la roue de couleurs, le contrôle est rendu à la boîte de dialogue Palette de couleurs.


Boîte de dialogue Paramètres de règles

Description  Cette boîte de dialogue permet de définir les préférences d'aspect des règles dans l'Editeur d'état.

Cette boîte de dialogue contient :

Pas de grille

Horizontal

Nombre de points magnétiques par pas de grille

Unités

Vertical


Pas de grille

Description  Ce bouton d'option permet d'indiquer l'intervalle entre les lignes de grille pour chaque unité de règle.

Valeurs

0.25	Une ligne de grille par quart d'unité de règle, c'est-à-dire quatre lignes de grille par unité de règle.
0.5	Une ligne de grille par demi unité de règle, c'est-à-dire deux lignes de grille par unité de règle.
1	Une ligne de grille par unité de mesure, c'est-à-dire une ligne de grille par unité de règle.
2	Une ligne de grille pour deux unités de mesure, c'est-à-dire une ligne de grille pour deux unités de règle.
5	Une ligne de grille pour cinq unités de mesure, c'est-à-dire une ligne de grille pour cinq unités de règle.
Autre	Permet d'indiquer une ligne de grille pour x unités de mesure, où x est une valeur que vous entrez dans le champ qui figure en regard de Autre.


Horizontal

Description  Ce champ permet d'indiquer, en points, la taille d'une unité de cellule de caractère.

Valeurs

Entrez un entier positif.


Nombre de points magnétiques par pas de grille

Description  Les boutons d'option Nombre de points magnétiques par pas de grille permettent d'indiquer le nombre de points magnétiques souhaités par ligne de grille. Les points magnétiques sont utilisés par l'éditeur pour positionner des objets lorsque vous avez coché l'option Grille magnétique dans le menu Vue. Plus il y a de points magnétiques par point de grille, plus le contrôle de l'emplacement des objets est précis.

Valeurs

1	Un point de grille par ligne de grille.
2	Deux points de grille par ligne de grille.
4	Quatre points de grille par ligne de grille.
5	Cinq points de grille par ligne de grille.
8	Huit points de grille par ligne de grille.
Autre	Permet d'indiquer x points de grille pour chaque ligne de grille, où x est une valeur que vous entrez dans le champ affiché à côté de Autre.
Notes d'utilisation

•	Si vous avez sélectionné Pouces comme Unité, 1 comme Pas de grille et 1 comme Nombre de points magnétiques par pas de grille, les objets que vous déplacez ou créez sont placés au pouce le plus proche. Si vous donnez la valeur 2 à Nombre de points magnétiques par pas de grille, les objets sont placés au demi-pouce le plus proche.


Unités

Description  Ce bouton d'option permet d'indiquer l'unité de mesure à utiliser pour les règles dans la vue en cours.

Valeurs

Centimètres

Cellules de caractère

Pouces

Points


Vertical

Description  Ce champ permet d'indiquer, en points, la taille d'une unité de cellule de caractère.

Valeurs

Entrez un entier positif.


Points

Les points sont une unité de mesure utilisée en imprimerie pour former un pica. Un pica contient douze points et équivaut à un sixième de pouce. (Un point équivaut à 1/72 pouce.)


Cellules de caractère

Les cellules de caractère sont des unités équivalant à la taille d'un caractère (la taille d'un caractère est définie dans Horizontal et Vertical).


Boîte de dialogue Import/Export de dessin

Description  Cette boîte de dialogue permet d'indiquer comment vous voulez importer/exporter un dessin. Choisissez Base de données ou Fichier et entrez le nom du dessin. Indiquez un format. Indiquez les options de votre choix.

Cette boîte de dialogue contient :

Base de données	Permet d'indiquer si vous voulez exporter vers la base de données ou importer depuis la base de données. En regard de ce bouton d'option se trouve un champ destiné à recevoir le nom de l'objet et un bouton Parcourir qui vous permet de faire une sélection dans une liste de ce que vous avez stocké dans la base de données.
Fichier	Permet d'indiquer si vous voulez exporter vers un fichier ou importer depuis ce fichier. En regard de ce bouton d'option se trouve un champ destiné à recevoir le nom de l'objet et un bouton Parcourir qui vous permet de faire une sélection dans une liste de ce que vous avez stocké dans la base de données.
Format	Indique la liste des formats possibles pour le dessin en cours d'import/export. Choisissez un format.
Options (Export)	Encodage
CGM	Permet d'indiquer comment stocker un objet exporté en format CGM. CGM prend en charge l'espace de coordonnées sur 4 octets et 2 octets. (La plupart des produits utilisent un espace de coordonnées sur 2 octets pour CGM). Choisissez 16 bits pour un espace de coordonnées sur 2 octets et 32 bits pour un espace de coordonnées sur 4 octets.
Compression	Indique la liste des algorithmes de compression que vous pouvez utiliser lors de l'export d'un dessin. Les algorithmes de compression disponibles sont fonction de Format et de votre type de moniteur. Choisissez l'algorithme approprié.
Options (Import)
	Utiliser la palette de couleurs importée	Permet d'indiquer si vous voulez que la palette de couleurs importée soit la palette de couleurs par défaut.


Boîte de dialogue Import/Export d'image

Description  Cette boîte de dialogue permet d'indiquer comment vous voulez importer/exporter une image. Choisissez Base de données ou Fichier et entrez le nom de l'image. Indiquez un format. Indiquez les options de votre choix.

Cette boîte de dialogue contient :

Compression	Indique la liste des algorithmes de compression que vous pouvez utiliser lors de l'export d'une image. Les algorithmes de compression disponibles sont fonction de Format et de votre type de moniteur. Choisissez l'algorithme approprié.
Base de données	Permet d'indiquer si vous voulez exporter vers la base de données ou importer depuis la base de données. En regard de ce bouton d'option se trouve un champ destiné à recevoir le nom de l'objet et un bouton Parcourir qui vous permet de faire une sélection dans une liste de ce que vous avez stocké dans la base de données.
Type de données	Indique une liste des types de données dans lesquels vous pouvez exporter votre image (par exemple, niveaux de gris, couleurs réelles 24 bits, etc.).
Fichier	Permet d'indiquer si vous voulez importer/exporter de/vers un fichier. En regard de ce bouton d'option se trouve un champ destiné à recevoir le nom de l'objet et un bouton Parcourir qui vous permet de choisir dans une liste de ce que vous avez stocké dans la base de données.
Format	Indique la liste des formats possibles pour le dessin en cours d'import/export. Choisissez un format.
Qualité	Permet d'indiquer la résolution relative à laquelle une image est affichée. Plus la qualité est élevée, plus le fichier est volumineux et plus il occupe de place en mémoire. Choisissez Excellent, Très bon, Bon, Correct ou Médiocre.


Boîte de dialogue Import/Export de palette de couleurs

Description La boîte de dialogue Import/Export de palette de couleurs permet d'indiquer comment vous voulez importer/exporter une palette de couleurs. Choisissez Base de données ou Fichier et entrez le nom de la palette de couleurs.

Cette boîte de dialogue contient les éléments suivants :

Base de données	Permet d'indiquer si vous voulez exporter vers la base de données ou importer depuis la base de données. En regard de ce bouton d'option se trouve un champ destiné à recevoir le nom de l'objet et un bouton Parcourir qui vous permet de faire une sélection dans une liste de ce que vous avez stocké dans la base de données.
Fichier	Permet d'indiquer si vous voulez exporter vers un fichier ou importer depuis un fichier. En regard de ce bouton d'option se trouve un champ destiné à recevoir le nom de l'objet et un bouton Parcourir qui vous permet de faire une sélection dans une liste de ce que vous avez stocké dans la base de données.


Boîte de dialogue Insérer date et heure
Boite de dialogue Insérer date et heure

Description  Cette boîte de dialogue permet d'ajouter rapidement un champ de date et/ou d'heure à la présentation de votre état. Lorsque vous validez la boîte de dialogue, un champ comportant le masque de format approprié est inséré, à l'endroit indiqué, dans votre présentation. Si nécessaire, vous pouvez modifier ce champ comme tout autre champ de votre présentation.

Cette boîte de dialogue contient :

Formats disponibles	Répertorie les formats prédéfinis de date et d'heure. Vous pouvez soit en sélectionner un dans la liste, soit utiliser le bouton Personnalisé pour créer votre propre format.
Personnalisé	Permet d'afficher la boîte de dialogue Date et heure personnalisées, dans laquelle vous pouvez définir votre propre format de date et d'heure.
Placer la date/l'heure	Permet d'indiquer où le champ sera placé sur la page. Notez qu'une fois le champ créé, vous pouvez le déplacer comme tout autre objet de la présentation.


Boîte de dialogue Date et heure personnalisées

Description  Cette boîte de dialogue permet d'indiquer un masque de format pour la date/l'heure que vous voulez insérer dans la présentation. Lorsque vous validez cette boîte de dialogue, vous revenez à la boîte de dialogue Insérer date et heure et votre masque de format personnalisé est ajouté à la liste Formats disponibles de cette boîte de dialogue.

La boîte de dialogue Date et heure personnalisées contient :

Format personnalisé	Masque de format de date/d'heure. Les sèmes de masque de format sont affichés sous Options.
Exemple	Permet d'afficher la façon dont le masque de format indiqué dans Format personnalisé se présentera lorsqu'il sera appliqué à la date et à l'heure en cours. Si l'exemple reste vide, les sèmes en cours, indiqués dans Format personnalisé, ne constituent pas un masque de format valide.
Options	Permet d'afficher les sèmes de masques de format que vous pouvez utiliser lorsque vous construisez le masque dans Format personnalisé. Cette liste est en lecture seule.


Boîte de dialogue Insérer numéro de page

Description  Cette boîte de dialogue permet d'ajouter rapidement des numéros de page à la présentation de votre état. Lorsque vous la validez, un objet texte standard comportant les paramètres appropriés est inséré, à l'endroit indiqué, dans votre présentation. Si nécessaire, vous pouvez modifier l'objet standard comme vous modifieriez tout autre objet standard de votre présentation.

Cette boîte de dialogue contient :

Boîte déroulante Position	Indique le futur emplacement de l'objet standard sur la page. Notez qu'une fois le texte standard créé, il peut être déplacé comme n'importe quel objet dans les vues Aperçu interactif ou Modèle de présentation.
Formats disponibles	Les formats disponibles se présentent sous la forme de deux boutons d'option (Numéro de page seul, et Numéro de page et nbre total de pages) qui définissent les numéros que vous voulez insérer dans la présentation. Numéro de page seul insère « Page n », où n est le numéro de la page en cours. Numéro de page et nbre total de pages insère « Page n de m », où n est le numéro de la page en cours et m le nombre total de pages de l'état.


Boîte de dialogue Options de présentation

Description  Cette boîte de dialogue permet de définir les préférences à utiliser pour la vue Modèle de présentation.

Cette boîte de dialogue contient :

  onglet Présentation

  onglet Options


Confiné

  Restrictions 	  Rubriques connexes

Description  Cette case à cocher permet d'indiquer si vous voulez, ou non, confiner les objets de présentation aux objets (encadrements itératifs ou encadrements) qui les contiennent. Le mode Confiné permet d'éviter les erreurs de fréquence dans un état. Par exemple, si vous cochez Confiné, Report Builder ne permet pas le transfert d'un champ hors de son encadrement itératif.

En mode Confiné, Report Builder limite les opérations décrites ci-après, de façon à éviter qu'un objet se trouve en dehors des limites de l'objet qui le contient, dit "objet conteneur" :

•	déplacement d'un objet ou de l'objet conteneur

•	déplacement d'un objet ou de l'objet conteneur vers une autre couche (par exemple, utilisation de Réorganisation [image] Passer en arrière-plan, Réorganisation [image] Déplacer vers l'arrière, Réorganisation [image] Passer au premier plan, ou Réorganisation [image] Déplacer vers l'avant)

•	redimensionnement d'un objet ou de l'objet conteneur

•	rotation d'un objet ou de l'objet conteneur

•	augmentation de la taille de la bordure d'un objet ou de l'objet conteneur

Valeur par défaut

Cochée (mode Confiné activé)


Mode Confiné - Restrictions

•	Un objet est contenu par un autre si toutes les conditions ci-après sont remplies :

•	L'objet se trouve sur une couche au-dessus de l'objet conteneur.

•	L'objet est totalement entouré par l'objet conteneur.

•	L'objet n'est pas explicitement ancré à un objet extérieur à l'objet conteneur.

•	Si un objet est contenu dans un autre, lorsque le mode Confiné est sélectionné, l'objet reste dans son objet conteneur, à moins que le conteneur ne change. Pour modifier le conteneur d'un objet en mode Confiné, vous devez :

•	Ancrer explicitement l'objet à un objet extérieur à son conteneur.

•	Créer un nouveau conteneur pour l'objet, dans son conteneur d'origine.

•	Si vous créez un objet extérieur à tous les autres en mode Confiné, le premier objet conteneur dans lequel vous transférez l'objet deviendra son conteneur. Par exemple, si vous créez un champ extérieur à votre présentation, puis le transférez dans un encadrement itératif, vous ne pourrez pas le sortir de cet encadrement itératif. Dès que le champ est transféré dans l'encadrement itératif, ce dernier devient son objet conteneur et le champ ne peut plus être sorti des limites de son conteneur.


Afficher champs avec

Description Ces boutons d'option permettent d'indiquer comment afficher les champs dans les vues Présentation et Grille de paramètres de l'Editeur d'état.

Valeurs

Noms	Affiche les champs avec leurs noms.
Masques	Affiche les champs avec leurs masques de format.
Contours seuls	Affiche les champs sans leurs noms ni leurs masques.
Valeur par défaut

Noms


Afficher présentation avec

Description Ces boutons d'option permettent d'indiquer la zone de l'état qui devra être affichée dans la vue Modèle de présentation de l'Editeur d'état.

Valeurs

Vue Corps	Affiche le corps de la section d'état en cours.
Vue Marge	Affiche le cors de la section d'état en cours, entouré des marges de toutes les fenêtres d'une page logique de la section d'état.
Marges	Affiche le corps de l'état, entouré des marges de toutes les fenêtres d'une page logique de l'état.
Page de fin	Affiche les pages de fin de l'état.
Valeur par défaut

Vue Corps


Flexible

  Rubriques connexes

Description  Cette case à cocher permet d'indiquer si les objets conteneurs et les objets du chemin cible doivent être déplacés ou redimensionnés lorsque vous déplacez ou redimensionnez un objet. Par exemple, si vous essayez de sortir un champ de son encadrement itératif père en mode Flexible, l'encadrement itératif s'agrandira autant que nécessaire pour le contenir, et les objets entourant l'encadrement itératif seront également agrandis ou déplacés, selon le cas.

Attention : En mode Flexible, vous ne pouvez redimensionner qu'un objet à la fois. Si vous tentez d'en redimensionner plusieurs, seul l'objet sur le point de contrôle duquel vous cliquez sera redimensionné, et les autres objets sélectionnés seront désélectionnés. De même, vous ne pouvez redimensionner des objets que dans un sens à la fois (vertical ou horizontal et non en diagonale).

Valeur par défaut

Non cochée


Points d'ancrage

Description  Cette case à cocher permet d'afficher ou de masquer les points d'ancrage explicites dans la vue Modèle de présentation. Si vous avez de nombreux points d'ancrage, vous aurez parfois intérêt à les masquer, afin de pouvoir travailler sur d'autres objets.

Valeur par défaut

Cochée


Contours des objets standard

Description  Cette case à cocher permet d'afficher ou de masquer l'encadrement des objets standard et des objets Oracle Graphics, ainsi que leurs icônes de dimensionnement vertical et horizontal, dans la vue Modèle de présentation.

Valeur par défaut

Cochée


Commentaires

Description  Cette case à cocher permet d'afficher ou de masquer le symbole de commentaire des objets dans l'Editeur d'état.

Valeur par défaut

Cochée


Contours des champs

Description  Cette case à cocher permet d'afficher ou de masquer le contour des champs, ainsi que les icônes de dimensionnement vertical et horizontal, dans la vue Modèle de présentation.

Valeur par défaut

Cochée


Contours encadrement

Description  Cette case à cocher permet d'afficher ou de masquer le contour des encadrements, ainsi que les icônes de dimensionnement vertical et horizontal, dans la vue Modèle de présentation.

Valeur par défaut

Cochée


Champs masqués

Description  Cette case à cocher permet d'afficher ou de masquer les champs dont l'option Masqué est cochée.

Valeur par défaut

Cochée


Icônes d'objet solidaire

Description  Cette case à cocher permet d'afficher ou de masquer le symbole Objet solidaire des objets, dans la vue Modèle de présentation

Valeur par défaut

Cochée


Noms

Description  Cette case à cocher permet d'afficher ou de masque le nom des objets dans la vue Modèle de présentation.

Valeur par défaut

Non cochée


Icônes de saut de page

Description  Cette case à cocher permet d'afficher ou de masquer le symbole de saut de page des objets dont l'option Saut pge avt. ou Saut pge apr. est activée dans la vue Modèle de présentation.

Valeur par défaut

Cochée


Icônes de protection page

Description Cette case à cocher permet d'afficher ou de masquer le symbole de protection de page des objets dans la vue Modèle de présentation.

Valeur par défaut

Cochée


Options de la boîte de dialogue Options du Navigateur d'objet
 Boîte de dialogue Options du Navigateur d'objet

Description  Cette boîte de dialogue permet de contrôler le comportement du Navigateur d'objet.

Cette boîte de dialogue contient :

  onglet Général

  onglet Présentation


Afficher icônes Objet

Description  Cette case à cocher permet d'activer ou de désactiver l'affichage de l'icône qui indique le type d'objet représenté par le noeud. Si elle est affichée, cette icône apparaît à gauche du nom de noeud.

Valeur par défaut

Cochée

Notes d'utilisation

•	Si vous désélectionnez Afficher icônes Objet, vous devrez utiliser Outils [image] Palette de propriétés  pour accéder aux propriétés à partir du Navigateur d'objet.


Afficher icônes PL/SQL

Description  Cette case à cocher permet d'activer ou de désactiver l'affichage de l'icône PL/SQL qui indique qu'un code PL/SQL est associé à l'objet. Si elle est affichée, l'icône apparaît à la gauche du nom de noeud.

Valeur par défaut

Cochée

Notes d'utilisation

•	Afficher icônes PL/SQL ne s'applique qu'aux noeuds représentant des objets qui prennent en charge PL/SQL. Les noeuds d'en-tête n'affichent pas d'icône PL/SQL.


Informations sur points d'ancrage

Description  Cette case à cocher permet d'afficher un noeud Informations sur points d'ancrage pour les objets de présentation explicitement ancrés à un autre objet de présentation. Ce noeud contient la liste des objets auxquels l'objet est implicitement et explicitement ancré.

Valeur par défaut

Non cochée


Boutons

Description  Cette case à cocher permet d'afficher dans le Navigateur d'objet les objets boutons provenant de la présentation de l'état.

Valeur par défaut

Cochée


Objet standard externe

Description  Cette case à cocher permet d'afficher dans le Navigateur d'objet les objets standard externes provenant de l'Editeur d'état.

Valeur par défaut

Cochée


Champs

Description  Cette case à cocher permet d'afficher dans le Navigateur d'objet les champs provenant de la présentation de l'état.

Valeur par défaut

Cochée


Graphique standard

Description  Cette case à cocher permet d'afficher dans le Navigateur d'objet les objets graphiques standard provenant de la présentation de l'état.

Valeur par défaut

Cochée


Image standard

Description  Cette case à cocher permet d'afficher dans le Navigateur d'objet les images standard provenant de la présentation de l'état.

Valeur par défaut

Cochée


Objets OLE2

Description  Cette case à cocher permet d'afficher dans le Navigateur d'objet les objets OLE2 provenant de la présentation de l'état.

Valeur par défaut

Cochée


Graphiques

Description  Cette case à cocher permet d'afficher dans le Navigateur d'objet les graphiques provenant de la présentation de l'état.

Valeur par défaut

Cochée


Texte standard

Description  Cette case à cocher permet d'afficher dans le Navigateur d'objet les objets texte standard provenant de la présentation de l'état.

Valeur par défaut

Cochée


Boîte de dialogue Générateur de grilles de paramètres

Description  Cette boîte de dialogue permet d'indiquer le contenu et la présentation de la Grille de paramètres d'exécution. A l'aide de cette boîte de dialogue, vous pouvez indiquer les paramètres que l'utilisateur pourra modifier lors de l'exécution. Lorsque vous validez cette boîte de dialogue, la présentation Grille de paramètres d'exécution s'affiche dans la vue Grille de paramètres de l'Editeur d'état.

Cette boîte de dialogue contient :

Ligne d'aide	Aide qui apparaît sous le titre de la Grille de paramètres d'exécution. Validez le message par défaut ou entrez une chaîne alphanumérique ne dépassant pas 80 octets.
Libellé	Liste de libellés (en-têtes) des paramètres. Validez le libellé par défaut ou entrez une chaîne alphanumérique ne dépassant pas 256 octets.
Paramètre	Liste des paramètres de l'état en cours. Seuls ceux que vous sélectionnez en cliquant seront inclus dans la Grille des paramètres d'exécution. Notez qu'au départ, seuls DESNAME, DESTYPE et les paramètres créés par l'utilisateur sont sélectionnés en vue de leur intégration dans la Grille des paramètres d'exécution.
Ligne d'état	Contenu de la ligne d'état qui apparaît sous la ligne d'aide de la Grille de paramètres d'exécution. Validez l'état par défaut ou entrez une chaîne alphanumérique ne dépassant pas 80 octets.
Titre	Titre qui apparaît en haut de la Grille de paramètres d'exécution. Validez le titre par défaut ou entrez une chaîne alphanumérique ne dépassant pas 128 octets.
Notes d'utilisation

•	L'aide et le titre ne doivent pas être supérieurs à la largeur de la Grille de paramètres d'exécution, définie dans les propriétés d'état.


Grille de paramètres d'exécution

  Rubriques connexes

Description  La Grille de paramètres d'exécution est une boîte de dialogue dans laquelle vous pouvez définir les valeurs des paramètres pour l'exécution de l'état. Modifiez les paramètres si vous le désirez, puis cliquez sur [image] dans la barre d'outils pour exécuter l'état. Vous pouvez également cliquer sur [image] dans la barre d'outils pour annuler.


Boîte de dialogue Masques de format

  Rubriques connexes

Description  Cette boîte de dialogue permet de définir les masques de format qui doivent figurer dans la liste de valeurs de la propriété Masque de format des champs et la propriété Masque d'entrée des paramètres. Cliquez sur le masque que vous voulez sélectionner. Cliquer sur un masque déjà sélectionné le désélectionne. Cliquer dans une zone ouverte de la liste désélectionne tous les masques sélectionnés.

Cette boîte de dialogue contient les éléments suivants :

Ajouter	Permet d'ajouter le masque de format indiqué dans Masque à la liste Masques de format. Si Masque est vide, la sélection de ce bouton est sans effet.
Afficher	Permet d'indiquer le type (Date ou Number) du masque de format affiché dans la liste Masques de format.
Masques de format	Contient la liste des masques de format en cours.
Masque	Permet d'indiquer le masque qui sera ajouté à la liste Masques de format si vous sélectionnez le bouton Ajouter.
Supprimer	Permet de supprimer le masque de format sélectionné de la liste Masques de format. Si aucun masque n'est sélectionné dans la liste, la sélection de ce bouton est sans effet.


Boîte de dialogue Connexion

Description  La boîte de dialogue Connexion vous permet de vous connecter à une source de données Oracle ou non Oracle. Vous pouvez remplir chacun des champs séparément ou entrer une des chaînes de connexion suivantes entièrement dans le champ Utilisateur :

nom_utilisateur[/mot_passe]

nom_utilisateur[/mot_passe][@base_données]

[utilisateur[/mot_passe]]@ODBC:source_données[:base_données] ou [utilisateur[/mot_passe]]@ODBC:*

Cette boîte de dialogue contient les éléments suivants :

Base de données	Permet d'indiquer le nom de la base de données à laquelle vous voulez vous connecter. Entrez une chaîne valide ne dépassant pas 256 octets. Cette valeur peut être le nom d'une base de données locale, un protocole de communication vous permettant d'accéder à une base de données éloignée ou un nom de source de données ODBC (dans le cas d'une communication de données non-Oracle). Le protocole de communication que vous entrez dépend de votre système d'exploitation. Pour plus d'informations, reportez-vous à la documentation Oracle Net8 de votre système et/ou consultez votre administrateur de base de données.
password	Permet d'indiquer la chaîne que vous utilisez pour confirmer votre identité. Entrez un mot de passe valide ne dépassant pas 30 octets.
Nom utilisateur	Permet d'indiquer le nom que vous utilisez pour vous connecter à la base de données. Entrez un nom valide, ne dépassant pas 512 octets. Ce nom peut être différent du nom utilisateur que vous utilisez pour vous connecter à votre ordinateur.


Boîte de dialogue Pagination

Description  Cette boîte de dialogue permet de définir comment les numéros de page sont calculés pour les champs dont la Source est Numéro de page, Numéro d'écran, Numéro de page physique, Total pages, Total écrans ou Total pages physiques.

Cette boîte de dialogue contient les éléments suivants :

Inclure	Permet d'indiquer les sections de l'état utilisées pour calculer les numéros de page de l'état. Vous pouvez cocher Page de garde, Corps, Page de fin ou toute combinaison de ces options. La valeur par défaut est Page de garde, Corps et Page de fin cochés, pour indiquer que toutes les pages de l'état doivent être prises en compte dans le calcul des numéros de page.
Commencer à	Permet d'indiquer une valeur numérique, comprise entre 1 et 32 Ko, qui doit être utilisée pour la première page sur laquelle le champ est formaté. La valeur par défaut, 1, indique que la numérotation doit commencer à 1.
Augmenter de	Permet d'indiquer une valeur numérique comprise entre 1 et 32 Ko, correspondant à la valeur dont chaque page sera augmentée. La valeur par défaut, 1, indique que le numéro de page doit être augmenté de 1 à chaque changement de page.
Remise à	Permet d'indiquer quand la numérotation des pages doit reprendre à la valeur de départ indiquée dans Commencer à. Ce champ contient une liste de valeurs comprenant &Report et tous les encadrements itératifs joints. La valeur par défaut, &Report, indique que la numérotation des pages ne doit reprendre à la valeur Commencer à qu'une seule fois au début de l'état. Lorsqu'un encadrement itératif est indiqué, la numérotation des pages reprend à la valeur Commencer à à chaque instance de l'encadrement itératif.


Boîte de dialogue Préférences

Description  Cette boîte de dialogue permet de définir des préférences applicables à votre session et des paramètres d'exécution applicables à l'état en cours.

Elle contient :

 onglet Général

  onglet Accès

  onglet Assistants

  onglet Valeurs d'exécution

  onglet Paramètres d'exécution


Mode Couleur

Description  Ce mode détermine la façon dont la palette de couleurs d'un état est configurée sur votre système. Chaque fois que vous activez un état différent, Report Builder tente de modifier la palette de couleurs de votre système afin qu'elle corresponde à la palette de couleurs de l'état, ou en soit aussi proche que possible. Comme votre système ne peut gérer à la fois qu'un nombre limité de couleurs, Report Builder peut ne pas être en mesure d'afficher simultanément avec précision plusieurs états s'ils utilisent des palettes de couleurs différentes.

Valeurs

Modifiable	Indique que Report Builder remplace temporairement la palette de couleurs de votre système par celle de l'état actif. Chaque fois que vous activez un nouvel état, sa palette de couleurs remplace la palette du système. L'état actif est alors affiché avec précision, mais l'aspect des états inactifs peut en souffrir.
Lecture seule - Privé	Indique que chaque fois que vous activez un état, Report Builder ajoute la palette de couleurs de cet état à la palette initiale de votre système, jusqu'à ce qu'il ne reste plus de place dans la palette pour d'autres couleurs. Cette palette devient la palette utilisée lorsque l'état est actif. L'état actif est alors affiché avec précision, mais l'aspect des états inactifs peut en souffrir.
Lecture seule - Partagé	Indique que Report Builder continue à ajouter la palette de couleurs de chaque état actif à la palette initiale de votre système jusqu'à ce qu'il n'y ait plus de place dans la palette pour d'autres couleurs. Cette palette devient l'unique palette que tous les états ouverts partagent. Si vous créez un état qui utilise des couleurs totalement différentes, il peut ne pas être affiché avec précision.
Notes d'utilisation

•	Pour utiliser Format [image] Options de présentation [image] Palette de couleurs, vous devez définir Mode Couleur à Modifiable

•	Ce paramètre de préférence entre en vigueur lorsque vous créez ou ouvrez l'état suivant.


Supprimer l'Editeur d'état à l'ouverture

Description  Cette case à cocher permet d'indiquer si l'Editeur d'état doit être ouvert lorsqu'un état est ouvert. La suppression de l'Editeur d'état améliore les performances lors de l'ouverture d'un état.

Valeur par défaut

Non cochée

Notes d'utilisation

•	Lorsque l'Editeur d'état n'est pas ouvert, choisissez, Outils [image] Editeur d'état pour l'ouvrir et le menu Affichage pour modifier les vues qu'il contient.


Supprimer la palette de propriétés à la création

Description  Cette case à cocher permet d'indiquer si les propriétés d'objet d'un état doivent être affichées lors de la création de l'état. Certaines propriétés d'objet de présentation ne peuvent être définies que dans la palette de propriétés de l'objet (c'est-à-dire la source d'un champ). Si vous souhaitez définir totalement un objet avant d'en créer un autre, il est préférable de ne pas cocher cette préférence, afin de pouvoir définir totalement l'objet dès que vous le créez. Si vous préférez créer plusieurs objets de présentation sans définir au départ toutes leurs propriétés, cochez cette préférence, pour ne pas voir la fenêtre de propriétés chaque fois que vous créez un objet dans l'éditeur.

Valeur par défaut

Cochée

Notes d'utilisation

•	Lorsque vous utilisez ce paramètre, n'oubliez pas que certains objets requièrent le remplissage de certains paramètres pour que l'état puisse être généré ou exécuté. Par exemple, les interrogations nécessitent des instructions SELECT, et les champs et les encadrements itératifs nécessitent des sources.


Supprimer extraction de liste sur entrée

Description  Cette case à cocher permet de masquer des listes lorsqu'une action affiche une boîte de dialogue de base de données. Par exemple, dans la boîte de dialogue Ouverture depuis la base de données, la liste des modules ne s'affiche pas si cette préférence a été cochée. Cette préférence peut améliorer les performances lors de l'affichage d'une boîte de dialogue de base de données.

Valeur par défaut

Non cochée

Notes d'utilisation

•	Lorsque cette préférence est sélectionnée, il vous est toujours possible d'extraire des listes des boîtes de dialogue en cliquant sur le bouton Extraire liste.


Unité de mesure

Description  Unité de mesure permet d'indiquer les unités à utiliser lors de la définition d'un nouvel état. (Les états bitmap existants utilisent l'unité de mesure définie dans la fenêtre de propriétés Etat, à laquelle vous pouvez accéder en cliquant deux fois sur l'icône du noeud de l'état, dans le Navigateur d'objet).

Valeurs

Centimètre

Pouce

Point	Type de caractère d'imprimerie qui constitue un pica. Chaque pica contient 12 points et équivaut à 1/6 de pouce.

Valeur par défaut

Pouce


Accès

Description  Accès se compose d'une série de boutons d'option qui indiquent l'emplacement par défaut de vos documents. Les informations que vous entrez pour cette préférence sont utilisées comme informations par défaut lorsque vous exécutez des opérations de type Ouvrir ou Enregistrer sous.

Valeurs

Base de données

Fichier

Fichier/Base de données

Valeur par défaut

Fichier/Base de données

Notes d'utilisation

•	Si vous indiquez Base de données, puis que vous deviez accéder à un module d'un fichier, il vous faudra changer en Fichier la valeur que vous avez indiquée pour Accès, pour pouvoir accéder à la boîte de dialogue Fichier. De même, si vous indiquez Fichier, puis que vous deviez accéder à un module de la base de données, il vous faudra changer cette préférence en Base de données, pour pouvoir accéder à la boîte de dialogue de base de données.


Tout

Description  Cette case à cocher permet d'indiquer si Report Builder doit tout inclure dans la liste des objets/fichiers lorsque l'opération nécessite un nom d'objet ou de fichier. La valeur indiquée pour cette préférence s'affichera dans toutes les boîtes de dialogue d'affichage (par exemple, la boîte de dialogue d'affichage pour Ouvrir).

Valeur par défaut

Non cochée


Bibliothèques PL/SQL

Description  Cette case à cocher permet d'indiquer si Report Builder doit inclure les bibliothèques PL/SQL externes dans une liste d'objets ou de fichiers lorsque l'opération nécessite un nom d'objet ou de fichier. La valeur indiquée pour cette préférence s'affichera dans toutes les boîtes de dialogue d'affichage (par exemple, la boîte de dialogue d'affichage pour Ouvrir).

Valeur par défaut

Non cochée


Interrogations

Description  Cette case à cocher permet d'indiquer si Report Builder doit inclure les interrogations externes dans une liste d'objets ou de fichiers lorsque l'opération nécessite un nom d'objet ou de fichier. La valeur indiquée pour cette préférence s'affichera dans toutes les boîtes de dialogue d'affichage (par exemple, la boîte de dialogue d'affichage pou Ouvrir).

Valeur par défaut

Non cochée


Etats

Description  Cette case à cocher permet d'indiquer si Report Builder doit inclure les états dans une liste d'objets ou de fichiers lorsque l'opération nécessite un nom d'objet ou de fichier. La valeur indiquée pour cette préférence s'affichera dans toutes les boîtes de dialogue d'affichage (par exemple, la boîte de dialogue d'affichage pou Ouvrir).

Valeur par défaut

Cochée


Modèles

Description  Cette case à cocher permet d'indiquer si Report Builder doit inclure des modèles dans une liste d'objets ou de fichiers lorsque l'opération nécessite un nom d'objet ou de fichier. La valeur indiquée pour cette préférence s'affichera dans toutes les boîtes de dialogue d'affichage (par exemple, la boîte de dialogue d'affichage pou Ouvrir).

Valeur par défaut

Non cochée


Assistant Graphique - Page de bienvenue

Description  Cette case à cocher permet d'indiquer si la page de bienvenue de l'assistant Graphique doit être affichée lorsque vous lancez l'assistant Graphique.

Valeur par défaut

Cochée


Intervalle horizontal

Description  Intervalle horizontal est l'espace horizontal que Report Builder laisse entre les objets et ceux qu'ils entourent lors de la création d'une présentation par défaut. L'augmentation de cet espace facilite la lecture de votre présentation dans la vue Modèle de présentation et ajoute des blancs dans votre sortie.

Valeurs

Toute valeur numérique supérieure ou égale à zéro (maximum quatre positions décimales). L'espace est exprimé sous la forme d'un multiple de la taille de caractère utilisée pour créer la présentation par défaut. Par exemple, un intervalle horizontal de 0.1 équivaut à un espace de 1/10 de caractère dans la police en cours.

Valeur par défaut

0.1000

Notes d'utilisation

•	En émulation de mode caractère (case Concevoir en unités caractère coché dans les propriétés de l'état), Report Builder utilise les valeurs indiquées pour Intervalle horizontal et Intervalle vertical. Dans Report Builder en mode caractère, cependant, l'intervalle horizontal et l'intervalle vertical ne sont pas utilisés. Si vous voulez voir exactement la façon dont votre état se présentera dans Report Builder en mode caractère, vous devez donc définir Intervalle horizontal et Intervalle vertical à zéro.


Espace champ horizontal

Description  Espace champ horizontal est l'espace horizontal que Report Builder laisse entre les champs lorsqu'il crée une présentation par défaut. L'augmentation de cet espace facilite la lecture de votre présentation dans la vue Modèle de présentation et ajoute des blancs entre les champs de votre sortie.

Valeurs

Toute valeur numérique supérieure ou égale à zéro (maximum quatre positions décimales). L'espace est exprimé sous la forme d'un multiple de la taille de caractère utilisée pour créer la présentation par défaut. Par exemple, un espace champ horizontal de 0.1, équivaut à un espace de 1/10 de caractère dans la police en cours.

Valeur par défaut

2.0000


Assistant Report - Page de bienvenue

Description  Cette case à cocher permet d'indiquer si la page de bienvenue de l'assistant Report doit être affichée lorsque vous lancez l'assistant Report.

Valeur par défaut

Cochée


Intervalle vertical

Description  Intervalle Vertical est l'espace Vertical que Report Builder laisse entre les objets et ceux qu'ils entourent lors de la création d'une présentation par défaut. L'augmentation de cet espace facilite la lecture de votre présentation dans la vue Modèle de présentation et ajoute des blancs dans votre sortie.

Valeurs

Toute valeur numérique supérieure ou égale à zéro (maximum quatre positions décimales). L'espace est exprimé sous la forme d'un multiple de la taille de caractère utilisée pour créer la présentation par défaut. Par exemple, un intervalle vertical de 0.1 équivaut à un espace de 1/10 de caractère dans la police en cours.

Valeur par défaut

0.1000

Notes d'utilisation

•	En émulation de mode caractère (case Concevoir en unités caractère coché dans les propriétés de l'état), Report Builder utilise les valeurs indiquées pour Intervalle horizontal et Intervalle vertical. Dans Report Builder en mode caractère, cependant, l'intervalle horizontal et l'Intervalle vertical ne sont pas utilisés. Si vous voulez voir exactement la façon dont votre état se présentera dans Report Builder en mode caractère, vous devez donc définir Intervalle horizontal et Intervalle vertical à zéro.


Espace champ vertical

Description  Espace champ vertical est l'espace vertical que Report Builder laisse entre les champs lorsqu'il crée une présentation par défaut. L'augmentation de cet espace facilite la lecture de votre présentation dans la vue Modèle de présentation et ajoute des blancs entre les champs de votre sortie.

Valeurs

Toute valeur numérique supérieure ou égale à zéro (maximum quatre positions décimales). L'espace est exprimé sous la forme d'un multiple de la taille de caractère utilisée pour créer la présentation par défaut. Par exemple, un espace champ vertical de 0.1, équivaut à un espace de 1/10 de caractère dans la police en cours.

Valeur par défaut

0.0000


Assistant Web - Page de bienvenue

Description  Cette case à cocher permet d'indiquer si la page de bienvenue de l'assistant Web doit être affichée lorsque vous lancez l'assistant Web.

Valeur par défaut

Non cochée


Boîte de dialogue de bienvenue

Description  Cette case à cocher permet d'indiquer si la boîte de dialogue de bienvenue doit s'afficher lorsque vous lancez Report Builder.

Valeur par défaut

Cochée


Valeurs d'exécution

Description  Valeurs d'exécution permet d'indiquer les valeurs utilisées lorsque vous exécutez des états pendant la session en cours. (Pour modifier définitivement les valeurs par défaut de ces paramètres pour un état donné, vous devez mettre à jour la Valeur initiale des paramètres correspondants, dans la définition de l'état.)

Arrière-plan	BACKGROUND

Copies	COPIES

Symbole monétaire	CURRENCY

Décimale	DECIMAL

Format destination	DESFORMAT

Nom destination	DESNAME

Type destination	DESTYPE

Mode	MODE

Orientation	ORIENTATION

Impression	PRINTJOB

Séparateur de milliers	THOUSANDS


Paramètres d'exécution

  Restrictions	  Rubriques connexes

Description  Paramètres d'exécution indique les paramètres utilisés lorsque vous exécutez des états pendant la session en cours. (Pour modifier définitivement les valeurs par défaut de ces paramètres pour un état donné, vous devez mettre à jour la Valeur initiale des paramètres correspondants dans la définition de l'état.)

Taille de tableau	ARRAYSIZE

Validation automatique	AUTOCOMMIT

Pages vierges 	BLANKPAGES

Tampons	BUFFERS

Fichier d'erreurs 	ERRFILE

Long Chunk	LONGCHUNK

SQL non bloquant	NONBLOCKSQL

Sur échec	ONFAILURE

Sur succès	ONSUCCESS

Largeur x Hauteur page	PAGESIZE

Grille de paramètres	PARAMFORM

Profil 	PROFILE

Lecture seule	READONLY

Rôle 	ROLE

Lancer débogage	RUNDEBUG


Paramètres d'exécution - Restrictions

•	Toute valeur indiquée dans l'onglet Paramètres d'exécution a priorité sur les valeurs indiquées dans la ligne de commande et les valeurs initiales enregistrées avec la définition de l'état. Cependant, il vous est toujours possible de modifier les paramètres à partir de la Grille de paramètres d'exécution (par exemple, Type destination, Format destination, Symbole monétaire, etc.).


Palette de propriétés

La palette de propriétés permet d'accéder aux propriétés de l'objet ou des objets sélectionnés dans le Navigateur d'objet, l'Editeur d'état et l'Editeur de modèles.

Pour afficher l'aide sur une propriété, sélectionnez-la dans la palette de propriétés et appuyer sur F1.

A propos de la Palette de propriétés

A propos des sélections multiples dans la Palette de propriétés

A propos des commandes de la barre d'outils dans la Palette de propriétés

Affichage de la Palette de propriétés

Fermeture de la Palette de propriétés

Définition des propriétés en utilisant la Palette de propriétés

Exemple : définition des propriétés de sélections multiples

Comparaison des propriétés de deux objets


Boîte de dialogue Renommer

Description  Cette boîte de dialogue permet de renommer des modules stockés dans la base de données.

Cette boîte de dialogue contient les éléments suivants :

Nouveau nom	Nouveau nom Nom que vous voulez donner au module en cours. Vous entrez directement le nom dans ce champ.
Ancien nom	Ancien nom Nom actuel du module. Vous pouvez entrer le nom directement ou le sélectionner dans la liste de valeurs. (Cette liste est limitée aux modules dont vous êtes propriétaire.)
Renommer	Renommer Bouton qui permet de donner au module le nom que vous avez indiqué dans Nouveau nom.
Notes d'utilisation

•	Si le nom que vous indiquez existe déjà, une boîte de dialogue d'avertissement vous le signale pour vous permettre, si vous le souhaitez, d'indiquer un autre nom pour le module.


Boîte de dialogue Accès document

Description  Cette boîte de dialogue contient la liste de tous les utilisateurs qui ont des droits de lecture/écriture/exécution sur le document en cours. Pour accorder ou révoquer un droit d'accès, ajoutez ou supprimez des utilisateurs

Cette boîte de dialogue contient les éléments suivants :

Liste d'accès	Liste de tous les utilisateurs qui ont des droits d'accès en lecture/écriture/exécution sur le module en cours.
Ajouter	Bouton qui permet d'ajouter à la Liste d'accès le nom indiqué dans Utilisateur.
Supprimer	Bouton qui permet de supprimer de la Liste d'accès le ou les noms sélectionnés.
Utilisateur	Nom de l'utilisateur que vous voulez ajouter à la Liste d'accès. Entrez un nom d'utilisateur valide ou PUBLIC (pour accorder des droits d'accès à tous les utilisateurs).
Notes d'utilisation

•	Les entrées dans le champ Liste d'accès s'affichent en majuscules et sont automatiquement classées en ordre alphabétique lorsque vous ajoutez ou supprimez des utilisateurs.


Boîte de dialogue Etat sur les états

Description  Cette boîte de dialogue vous permet d'exécuter les paramètres d'un état, si celui-ci est stocké dans la base de données. Elle permet de conserver un enregistrement de tous vos états et de tous vos états de débogage. Choisissez Portrait ou Paysage comme orientation de l'état. Lorsque vous validez la boîte de dialogue, la grille de paramètres d'exécution pour Etat sur les états s'affiche. Entrez les informations nécessaires. Lorsque vous validez les informations, l'état s'exécute.

Outre les paramètres par défaut qui s'affichent normalement dans la grille de paramètres d'exécution, vous indiquez :

•	le nom de l'état (si vous utilisez des caractères génériques, vous pouvez générer une sortie pour plusieurs états) ;

•	si vous voulez inclure des commentaires ;

•	si vous voulez inclure le code PL/SQL ;

•	si vous voulez inclure des informations de niveau état (par exemple, Largeur de page) ;

•	si vous voulez inclure des informations sur le modèle de données (par exemple, paramètres d'interrogation) ;

•	si vous voulez inclure des définitions de paramètre

•	si vous voulez inclure des informations de présentation (par exemple, des définitions d'encadrement itératif).

Notes d'utilisation

•	Si vous voulez exécuter Etat sur les états en mode batch, utilisez RWRUN60 pour exécuter l'un des états sur les états. Exécutez srwdocpb.rdf pour une sortie Portrait et srwdoclb.rdf pour une sortie Paysage.


Boîte de dialogue Modification de rôle
Boîte de dialogue de Modification de rôle

  Rubriques connexes

Description  La boîte de dialogue Modification de rôle vous permet d'indiquer le rôle de base de données à utiliser lors de l'exécution de l'état.

Cette boîte de dialogue contient les champs suivants :

Nom de rôle	Nom Nom du rôle de base de données que vous voulez utiliser lors de l'exécution de l'état.
Mot de passe	Mot de passe Chaîne confirmant votre droit à utiliser le rôle de base de données.
Confirmer mot de passe	Confirmer mot de passe Même chaîne que celle entrée comme mot de passe. Cette confirmation permet de vérifier que le mot de passe que vous avez entrée est valide.


Boîte de dialogue Mot de passe de rôle

  Rubriques connexes

Description  La boîte de dialogue Mot de passe de rôle vous permet d'indiquer le mot de passe du rôle de base de données nécessaire pour ouvrir ou exécuter l'état.

Cette boîte de dialogue contient le champ suivant :

Mot de passe	Chaîne confirmant votre droit à utiliser le rôle de base de données.


Boîte de dialogue Paramètres de trace (exécution
Boîte de dialogue Paramètres de trace (exécution)

Description  Cette boîte de dialogue vous permet d'indiquer les informations de traçage que vous voulez placer dans un fichier journal pendant l'exécution de l'état. Ces paramètres correspondent aux arguments exécutables fournis avec RWBLD60 et sont indiqués en utilisant les mêmes valeurs.

Ajout de la case à cocher Diffusion

Lorsque vous exécutez l'état, le suivi des listes de diffusion utilisées est conservé dans le fichier indiqué dans le champ Fichier Trace. Ces informations permettent de déterminer la destination des différentes sections.

Cette boîte de dialogue contient les éléments suivants :

Fichier trace	TRACEFILE
Mode trace	TRACEMODE
Erreurs/ avertissements	TRACEOPTS=TRACE_ERR
Messages de profil	TRACEOPTS=TRACE_PRF
Points d'interruption	TRACEOPTS=TRACE_BRK
Traitement d'objets Report	TRACEOPTS=TRACE_APP
Exécution de PL/SQL	TRACEOPTS=TRACE_PLS
Exécution de SQL	TRACEOPTS=TRACE_SQL
Horodateur	TRACEOPTS=TRACE_TMS
Diffusion	TRACEOPTS=TRACE_DST
Tout	TRACEOPTS=TRACE_ALL
Notes d'utilisation

•	Les informations de Trace ne peuvent être générées que pendant l'exécution d'un fichier .rdf. Vous ne pouvez pas indiquer de traçage lorsque vous exécutez un fichier .rep.


Boîte de dialogue Bibliothèques attachées

Description  Cette boîte de dialogue permet d'attacher une bibliothèque PL/SQL externe à votre état. Lorsqu'une bibliothèque externe est attachée, vous pouvez faire référence à ses packages, fonctions et procédures à partir de votre état.

Cette boîte de dialogue contient :

Attacher	Permet d'attacher la bibliothèque PL/SQL externe indiquée dans Bibliothèque. Cliquez sur ce bouton après avoir entré dans Bibliothèque un nom de bibliothèque valide.
Depuis	Regroupe une série de boutons d'option (Base de données, Fichiers, Les deux)  indique où se trouve la bibliothèque que vous voulez attacher. Choisissez le bouton qui convient à la bibliothèque que vous attachez.
Bibliothèque	Indique le nom de la bibliothèque PL/SQL externe que vous voulez attacher à l'état. Entrez un nom de bibliothèque valide ou cliquez sur le bouton Parcourir pour rechercher ce nom.


Boîte de dialogue Recherche/remplacement

Description Cette boîte de dialogue permet de rechercher une chaîne alphanumérique et, en option, de la remplacer par une autre chaîne alphanumérique, ce qui est particulièrement utile dans des champs qui contiennent beaucoup de texte (par exemple, une longue instruction SQL).

La boîte de dialogue comporte:

Distinction maj/min	Case à cocher qui 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 de la chaîne de recherche, qu'elles soient en majuscules ou en minuscules.
Remplacer	Bouton qui permet de remplacer la dernière chaîne trouvée par la chaîne indiquée dans le champ de texte Remplacer par. Si le curseur ne se trouve pas sur une correspondance, recherche la prochaine occurrence de la chaîne de recherche et la remplace.
Remplacer tt	Bouton qui permet de remplacer toutes les correspondances par la chaîne de remplacement (de la position du curseur à la fin de la zone sur laquelle porte la recherche).
Expression régulière	Permet d'indiquer si la chaîne de recherche doit être considérée comme une expression régulière. Si cette case n'est pas cochée, Report Builder recherche une correspondance exacte du contenu du champ.
Remplacer par	Permet d'indiquer la chaîne devant remplacer les correspondances trouvées.
Rechercher	Bouton qui permet de rechercher la prochaine correspondance de la chaîne de recherche, à partir de la position du curseur.
Rechercher	Permet d'indiquer la chaîne à rechercher. Si vous voulez que cette chaîne soit considérée comme une expression régulière, cochez la case Expression régulière.


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.
( )	Equivaut au contenu des parenthèses. Par exemple (ras) équivaut à bras et à rase.
[ ]	Equivaut à l'un des caractères entre crochets. Les crochets sont un opérateur OR logique. Par exemple b[ro]is équivaut à bris et à bois.
	Deux caractères ont une signification spéciale lorsqu'ils sont entre crochets :
~	Utilisé comme premier caractère, équivaut à tout caractère qui ne figure pas dans les caractères ou les plages de caractères entre crochets. Par exemple, b[~ro]is équivaut à bais, mais pas à bris.
--	Entre deux caractères, équivaut à tout caractère de la plage. Par exemple, A-E équivaut aux lettres A et E et à toutes les lettres de la plage. Les paires de plages de caractères peuvent être : des caractères alphabétiques en majuscules ou 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 nombres, dont le premier est inférieur ou égal au deuxième.
Remarque :

|	Utilisé entre deux expressions régulières, établit une équivalence si l'une des deux expressions régulières est équivalente.
\	Equivaut au caractère spécial qui suit la barre oblique inversée. Par exemple, \* correspond à *. La barre oblique inversée est le caractère 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	équivaut à un caractère de tabulation.
\b	équivaut à un caractère vierge.
\w	équivaut à \n, \t, \b ou \0.
*	Equivaut à 0 ou à plusieurs instances de l'expression régulière. Par exemple, (le)*A correspond à A, leA et leleA.
+	Equivaut à 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.
Notes d'utilisation :

•	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)*)

•	Vous pouvez utiliser le caractère d'échappement entre crochets. Par exemple [\*\+] équivaut à * ou à +.


Assistant Web : page Bienvenue

 Rubriques connexes

A propos de l'assistant Web

L'assistant Web vous aide à générer rapidement et facilement une sortie HTML ou PDF à partir d'un état existant. Report Builder détermine, à partir des informations que vous indiquez sur chaque page de l'assistant, la façon de générer cette sortie.

Navigation dans l'assistant Web

L'assistant Web comporte cinq boutons qui vous permettent de naviguer dans ses pages :

•	Annuler—annule toutes les modifications que vous avez effectuées et vous fait sortir de l'assistant.

•	Aide—affiche le texte d'aide en ligne de la page en cours de l'assistant.

•	Précédent—vous fait revenir à la page précédente de l'assistant.

•	Suivant—vous fait passer à la page suivante de l'assistant.

•	Fin—enregistre vos modifications et vous fait sortir de l'assistant.


Assistant Web : page Hyperliens graphiques

  Rubriques connexes

1	Cliquez sur une colonne dans la liste des graphiques disponibles.

2	Cliquez sur [image] pour placer la colonne dans la liste Graphiques.

3	Répétez les étapes 1 et 2 pour ajouter d'autres hyperliens graphiques.

4	(En option) Pour supprimer un graphique de la liste, cliquez dessus, puis cliquez sur [image].


Assistant Web : page Relief

 Rubriques connexes

1	Sélectionnez une colonne dans la liste Colonnes disponibles.

2	Cliquez sur [image] pour faire passer la colonne dans la liste Signets. Chaque instance de cette colonne devient un signet dans votre sortie HTML ou PDF.

3	Répétez les étapes 1 et 2 pour toutes les colonnes à utiliser comme signets.

4	(Etape facultative) Pour supprimer une colonne de la liste Signets, cliquez sur la colonne, puis sur [image].


Assistant Web : page En-tête/pied de page HTML

 Rubriques connexes

Entrez le nom d'un fichier HTML que vous voulez utiliser comme pied de page pour votre sortie HTML ou cliquez sur Parcourir pour choisir un fichier.


Assistant Web : page Fin

 Rubriques connexes

Sélectionnez l'un des trois boutons d'option :

•	Si vous sélectionnez Générer sortie HTML maintenant ou Générer sortie PDF maintenant, Report Builder génère un fichier HTML ou PDF. Vous pouvez alors visualiser les fichiers de sortie dans un Web browser ou visualiseur PDF.

•	Si vous choisissez Revenir au Designer, les modifications que vous avez apportées dans l''assistant (signets ou fichiers d'en-tête/de bas de page, par exemple) sont enregistrées dans la définition de l'état pour que vous puissiez générer ultérieurement une sortie HTML ou PDF sans avoir à réexécuter l'Assistant.

Cochez la case Générer la sortie sur un navigateur Web pour générer automatiquement votre état sur le navigateur Web par défaut. Vous ne pouvez pas utiliser cette option si le bouton d'option de retour à Builder est sélectionné.


Boîte de dialogue Bienvenue

Description  Cette boîte de dialogue vous permet de sélectionner facilement la tâche initiale à exécuter lorsque vous lancez Report Builder. Sélectionnez l'une des tâches de la liste et validez la boîte de dialogue.

Cette boîte de dialogue contient :

Utiliser l'assistant Report	Permet d'indiquer que Report Builder vous fait passer à l'assistant Report pour créer un nouvel état. Suivez pour cela les instructions fournies.
Créer un nouvel état manuellement	Permet d'indiquer que Report Builder crée un nouveau noeud d'état dans le Navigateur d'objet et ouvre la vue Modèle de données de l'Editeur d'état.
Ouvrir un état existant	Permet d'indiquer que l'ouverture d'un état, par Report Builder, implique le passage par la ou les boîtes de dialogue dont l'affichage dépend de ce que vous avez indiqué comme Préférence d'accès. Une fois que vous avez sélectionné un état, Report Builder l'ouvre automatiquement.
Afficher au démarrage	Permet d'indiquer si la boîte de dialogue Bienvenue s'affiche lors du lancement de Report Builder. Pour supprimer l'affichage de cette boîte de dialogue, désélectionnez cette case à cocher. Cette préférence est enregistrée dans votre fichier de préférences.
Explorer les assistants (tâches)	Permet d'indiquer que Report Builder ouvre ses assistants, décrivant la séquence d'opérations qui permet d'exécuter les tâches les plus fondamentales de Report Builder.
Exécuter l'Aperçu produit (concepts)	Permet d'indiquer que Report Builder ouvre son Aperçu produit, qui est une présentation multimédia en ligne de Report Builder.
Notes d'utilisation

•	Pour afficher à nouveau la boîte de dialogue Bienvenue après avoir désélectionné Afficher au démarrage, choisissez Outils [image] Préférence. Cliquez sur l'onglet Assistants, puis activez la préférence concernant la boîte de dialogue de bienvenue.

•	Si un état est indiqué dans la ligne de commande, la boîte de dialogue Bienvenue ne s'affiche pas, mais l'état est ouvert et le Navigateur d'objet apparaît.


Boîte de dialogue Nouvel état

Description  Cette boîte de dialogue vous permet de choisir la façon dont vous voulez créer un état (c'est-à-dire la méthode assistant Report ou la méthode manuelle).

Elle contient :

Utiliser l'assistant Report	Permet d'indiquer que Report Builder vous fait passer à l'assistant Report pour créer un nouvel état. Suivez pour cela les instructions fournies.
Créer un nouvel état manuellement	Permet d'indiquer que Report Builder crée un nouveau noeud d'état dans le Navigateur d'objet et ouvre la vue Modèle de données de l'Editeur d'état.


Boîte de dialogue A propos de Report Builder

Description  Cette boîte de dialogue contient la version de Report Builder que vous utilisez et une mention de copyright.


Boîte de dialogue Informations sur ventilation PL/SQL

Description  Cette boîte de dialogue s'affiche lorsque vous avez défini un point d'interruption dans le PL/SQL par SRW.BREAK. Lorsque l'état atteint le point d'interruption, les valeurs des variables sont affichées dans cette boîte de dialogue. Cliquez sur le bouton Poursuivre pour reprendre l'exécution de l'état.


Assistant Report : page Bienvenue

A propos de l'assistant Report

L'assistant Report vous aide à définir facilement et rapidement un état mono-interrogation. Report Builder utilise les informations que vous fournissez sur chaque page de l'assistant Report pour créer un modèle de données et une présentation de l'état. Une fois l'état créé par l'assistant Report, vous pouvez le modifier de la façon habituelle.

Assistant Report en mode invariant

L'une des principales qualités de l'assistant Report est sa faculté de fonctionner en mode invariant  , ce qui signifie que vous pouvez l'utiliser pour modifier un état mono-interrogation ou multi-interrogation. Lorsque vous utilisez l'assistant Report sur un état existant, ses différents onglets vous permettent d'accéder rapidement à toutes ses pages.

Pour appeler l'assistant Report en mode invariant, ouvrez un état et choisissez Outils [image] Assistant Report.

Navigation dans l'assistant Report

L'assistant Report comporte six boutons qui vous permettent de naviguer dans ses pages :

•	Annuler - annule toutes les modifications que vous avez effectuées et vous fait sortir de l'assistant.

•	Aide - affiche le texte d'aide en ligne de la page en cours de l'assistant.

•	Précédent - vous fait revenir à la page précédente de l'assistant.

•	Suivant - vous fait passer à la page suivante de l'assistant.

•	Appliquer - applique vos modifications (en mode invariant uniquement).

•	Fin - enregistre vos modifications (si nécessaire) et vous fait sortir de l'assistant.

Remarque:  Si vous cliquez sur Suivant avant d'avoir entré toutes les informations demandées sur une page donnée, vous ne pouvez pas passer à la page suivante. De même, si vous n'avez pas entré dans l'assistant toutes les informations nécessaires avant de cliquer sur Appliquer ou Fin, vous passez automatiquement à la page dans laquelle vous pouvez finir d'entrer les données demandées.


Assistant Report : page Style

  A propos de l'assistant Report

1	(Facultatif) Dans le champ Titre, entrez le titre de votre état. Celui-ci apparaîtra dans la marge de votre état.

2	Choisissez l'un des styles d'état suivants :

A propos des états de style tabulaire

A propos des états de style formulaire

A propos des états de style étiquette de publipostage

A propos des états de style lettre type

A propos des états de style groupe - gauche

A propos des états de style groupe - niveau supérieur

A propos des états de style matriciel

A propos des états de style matriciel avec groupe

Notes d'utilisation

•	Si votre état est fondé sur une interrogation Express, vous devez en règle générale choisir une matrice ou un matrice dotée d'un état de groupe.

•	Si vous changez le style d'un état, Report Builder tente de préserver vos récapitulatifs dans le nouveau style d'état. Cependant, si vous alternez entre des styles d'état qui demandent des modèles de données différents (tabulaire et matriciel, par exemple), Report Builder peut ne pas être en mesure d'établir une correspondance exacte entre vos récapitulatifs et le nouveau type de l'état.


Assistant Report : page Type

Choisissez le type d'interrogation que vous souhaitez créer :

•	Instruction SQL signifie que vous voulez créer une interrogation qui sélectionne les données dans une base de données relationnelle (Oracle8, par exemple).

•	Interrogation Express signifie que vous voulez créer une interrogation qui sélectionne les données sur un serveur Express.


Assistant Report : page Données

  Rubriques connexes 	  A propos de l'assistant Report

1	Si vous n'êtes pas déjà connecté à une base de données, cliquez sur Connexion et remplissez la boîte de dialogue Connexion.

2	Indiquez une instruction SELECT. Pour cela, vous avez le choix entre plusieurs possibilités :

•	Entrez l'instruction SELECT dans la zone Instruction SQL d'interrogation.

•	Cliquez sur Query Builder et définissez une interrogation en utilisant les boîtes de dialogue de Query Builder. Lorsque vous avez créé votre interrogation, l'instruction SELECT s'affiche dans la zone Instruction SQL d'interrogation.

•	Cliquez sur Importer interrogation SQL pour inclure une instruction SQL stockée dans un fichier. Lorsque vous fermez la boîte de dialogue d'import, le contenu du fichier sélectionné est placé dans la zone Instruction SQL d'interrogation.


Assistant Report : page Groupes

  A propos de l'assistant Report	  Rubriques connexes

Si le ou les groupes de la liste Groupes affichés vous conviennent et ont l'orientation d'impression voulue (c'est-à-dire, Vers le bas, Vers le bas/Gauche-droite, Gauche-droite/Vers le bas, Gauche-droite ou Matrice) :

  Cliquez sur Suivant.

Pour modifier l'orientation d'impression des groupes de la liste Groupes affichés :

1	Sélectionnez un groupe de la liste Groupes affichés.

2	Cliquez sur [image].

3	Cliquez sur le bouton correspondant à l'orientation d'impression à appliquer au groupe.

4	Répétez les étapes 1 à 3 jusqu'à ce que tous les groupes de la liste Groupes affichés soient corrects. Conseil

Notes d'utilisation

•	Pour créer deux colonnes au même niveau de ventilation, cliquez d'abord sur une colonne de la liste des champs de groupement, puis déplacez une colonne de la liste des champs disponibles. La colonne de la liste Champs disponibles est automatiquement placée au même niveau de ventilation que la colonne sélectionnée. Pour créer un nouveau niveau de ventilation, cliquez sur une colonne de la liste Champs disponibles, cliquez sur un niveau de ventilation dans la liste des champs de groupement, puis déplacez la colonne sélectionnée. Elle est automatiquement placée sur le nouveau niveau de ventilation, au-dessous du niveau sélectionné.

•	Certains types de données Oracle8 ne sont pas encore pris en charge. L'icône [image] signalera le type de données demandé comme inconnu, dans l'assistant, si votre interrogation sélectionne un type de données Oracle8 non pris en charge.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de groupement comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Report : page Groupes

  A propos de l'assistant Report	  Rubriques connexes

1	Cliquez sur le champ de la liste Champs disponibles qui doit devenir un champ de groupe.

2	Cliquez sur [image] pour faire passer le champ dans la liste Champs de groupe. Il apparaît précédé d'une ligne définissant son niveau de ventilation.

3	Répétez les étapes 1 et 2 pour tous les champs de groupe qui doivent figurer dans l'état.

4	(Facultatif) Cliquez sur un champ de la liste Champs de groupe et faites-le glisser jusqu'au niveau de ventilation de votre choix.

5	(Facultatif) Pour extraire un champ de la liste Champs de groupe, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Pour créer deux colonnes au même niveau de ventilation, cliquez d'abord sur une colonne de la liste des champs de groupement, puis déplacez une colonne de la liste des champs disponibles. La colonne de la liste Champs disponibles est automatiquement placée au même niveau de ventilation que la colonne sélectionnée. Pour créer un nouveau niveau de ventilation, cliquez sur une colonne de la liste Champs disponibles, cliquez sur un niveau de ventilation dans la liste des champs de groupement, puis déplacez la colonne sélectionnée. Elle est automatiquement placée sur le nouveau niveau de ventilation, au-dessous du niveau sélectionné.

•	Certains types de données Oracle8 ne sont pas encore pris en charge. L'icône [image] signalera le type de données demandé comme inconnu, dans l'assistant, si votre interrogation sélectionne un type de données Oracle8 non pris en charge.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de groupement comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Report : page Champs

  A propos de l'assistant Report	  Rubriques connexes

1	Cliquez sur un champ de la liste Champs disponibles. Conseil

2	Cliquez sur [image] pour faire passer le champ dans la liste Champs affichés. Conseil

3	Répétez les étapes 1 et 2 pour tous les champs qui doivent figurer dans l'état.

4	(Facultatif) Pour extraire un champ de la liste Champs affichés, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Certains types de données Oracle8 ne sont pas encore pris en charge. L'icône [image] signalera le type de données demandé comme inconnu, dans l'assistant, si votre interrogation sélectionne un type de données Oracle8 non pris en charge.

•	Si vous déplacez un objet colonne ou une colonne Ref de la liste des champs disponibles à celle des champs affichés, toutes ses colonnes d'attribut sont déplacées et insérées dans la liste des champs affichés, puis l'objet colonne ou la colonne Ref disparaît. Les objets colonne ne peuvent pas servir de source à un objet de présentation et sont donc exécutés à partir de la liste Champs affichés. Les colonnes d'attribut de cette liste comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Report : page Totaux

  A propos de l'assistant Report	  Rubriques connexes

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur le bouton correspondant à la fonction que vous voulez appliquer au champ. Une entrée comportant le nom du champ et de la fonction apparaît dans la liste Totaux.

3	Répétez l'étape 2 pour les autres fonctions que vous voulez appliquer au champ, le cas échéant.

4	Répétez les étapes 1 à 3 jusqu'à ce que vous ayez créé tous les totaux voulus.

5	(Facultatif) Pour enlever un champ de la liste Totaux, cliquez sur le champ, puis sur le bouton flèche gauche [image].

Notes d'utilisation

•	Certains types de données Oracle8 ne sont pas encore pris en charge. L'icône [image] signalera le type de données demandé comme inconnu, dans l'assistant, si votre interrogation sélectionne un type de données Oracle8 non pris en charge.

•	Les fonctions que vous pouvez utiliser avec des objets colonne et des colonnes Ref sont en nombre limité. Certaines fonctions apparaissent donc désactivées lorsque vous voulez les sélectionner dans la liste des champs disponibles.

•	Pour les états de groupe, l'assistant Report créé n champs récapitulatifs dans le modèle de données, pour chacune des colonnes récapitulatives définies : à savoir, un champ à chaque niveau de groupe supérieur à la colonne récapitulative et un champ au niveau de l'état. Par exemple, si un état est regroupé par divisions et par services, la création d'une colonne récapitulative pour le total des salaires crée des champs pour la somme des salaires de chaque division et pour chaque service (récapitulatifs au niveau du groupe), ainsi que pour la somme de tous les salaires (récapitulatif au niveau de l'état).


Assistant Report : page Texte

  A propos de l'assistant Report

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur [image] pour faire passer le champ dans la zone de texte Etiquette de publipostage.

3	Ajoutez les espaces ou la ponctuation nécessaire en cliquant sur le bouton correspondant (c'est-à-dire Nouvelle ligne, Espace, Tiret, Virgule ou Point).

4	Répétez les étapes 1 à 3 jusqu'à ce que tous les champs de votre choix soient dans la zone de texte Etiquette de publipostage.

5	(Facultatif) Cliquez sur la zone de texte Etiquette de publipostage et éditez le texte, le cas échéant.


Assistant Report : page Texte

  A propos de l'assistant Report

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur [image] pour faire passer le champ dans la zone de texte Lettre type.

3	Ajoutez les espaces ou la ponctuation nécessaire en cliquant sur le bouton correspondant (c'est-à-dire Nouvelle ligne, Espace, Tiret, Virgule ou Point).

4	Répétez les étapes 1 à 3 jusqu'à ce que tous les champs de votre choix soient dans la zone de texte Lettre type.

5	(Facultatif) Cliquez sur la zone de texte Lettre type et éditez le texte, le cas échéant.


Assistant Report : page Groupes

  A propos de l'assistant Report

Si le ou les champs de la liste Champs groupe de matrices vous conviennent :

  Cliquez sur Suivant.

Pour modifier les champs de la liste Champs groupes de matrice :

1	Cliquez sur le champ de la liste Champs disponibles qui doit devenir un champ groupes de matrice.

2	Cliquez sur [image] pour faire passer le champ dans la liste Champs de groupe. Il apparaît précédé d'une ligne définissant son niveau de ventilation.

3	Répétez les étapes 1 et 2 pour tous les champs groupes de matrices qui doivent figurer dans l'état.

4	(Facultatif) Sélectionnez un champ de la liste Champs groupes de matrices et faites-le glisser jusqu'au niveau de ventilation de votre choix.

5	(Facultatif) Pour extraire un champ de la liste Champs groupes de matrices, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Pour que deux colonnes aient le même niveau de ventilation, cliquez d'abord sur une colonne de la liste des champs de groupe matriciel, puis déplacez une colonne de la liste des champs disponibles. Elle est automatiquement placée au même niveau de ventilation que la colonne sélectionnée. Pour créer un nouveau niveau de ventilation, cliquez sur une colonne de la liste Champs disponibles, cliquez sur un niveau de ventilation dans la liste des champs de groupe matriciel, puis déplacez la colonne sélectionnée dans la liste des champs disponibles. Elle est automatiquement placée sur le nouveau niveau de ventilation, au-dessous du niveau sélectionné.

•	Certains types de données Oracle8 ne sont pas encore pris en charge. L'icône [image] signalera le type de données demandé comme inconnu, dans l'assistant, si votre interrogation sélectionne un type de données Oracle8 non pris en charge.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de groupe matriciel comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Report : page Lignes

  A propos de l'assistant Report	  Rubriques connexes

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur [image] pour faire passer le champ dans la liste Champs lignes de matrices. Il apparaît précédé d'une ligne définissant son niveau de ventilation. Conseil

3	Répétez les étapes 1 et 2 pour tous les champs de lignes matricielles de votre choix.

4	(Facultatif) Pour enlever un champ de la liste Champs lignes de matrice, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Certains types de données Oracle8 ne sont pas encore pris en charge. L'icône [image] signalera le type de données demandé comme inconnu, dans l'assistant, si votre interrogation sélectionne un type de données Oracle8 non pris en charge.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de ligne de matrice comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Report : page Colonnes

  A propos de l'assistant Report	  Rubriques connexes

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur [image] pour faire passer le champ dans la liste Champs colonnes de matrice. Il apparaît précédé d'une ligne définissant son niveau de ventilation. Conseil

3	Répétez les étapes 1 et 2 pour tous les champs colonnes de matrice de votre choix.

4	(Facultatif) Pour supprimer un champ de la liste Champs de colonnes matricielles, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Certains types de données Oracle8 ne sont pas encore pris en charge. L'icône [image] signalera le type de données demandé comme inconnu, dans l'assistant, si votre interrogation sélectionne un type de données Oracle8 non pris en charge.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de colonne de matrice comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Report : page Cellules

  A propos de l'assistant Report	  Rubriques connexes

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur le bouton correspondant à la fonction que vous voulez appliquer au champ. Une entrée comportant le nom du champ et de la fonction apparaît dans la liste Champs cellules de matrice. Conseil

3	Répétez les étapes 1 et 2 pour tous les champs cellules de matrice de votre choix.

4	(Facultatif) Pour enlever un champ de la liste Champs cellules de matrice, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Certains types de données Oracle8 ne sont pas encore pris en charge. L'icône [image] signalera le type de données demandé comme inconnu, dans l'assistant, si votre interrogation sélectionne un type de données Oracle8 non pris en charge.

•	Les objets colonne et les colonnes Ref ne peuvent pas être des colonnes ventilées. Vous ne pouvez donc pas les sélectionner dans la liste des champs disponibles.

•	Les colonnes d'attribut de la liste des champs de cellule de matrice comprennent un caractère souligné qui indique leur parenté (par exemple, ADDRESS_ZIP).


Assistant Report : page Totaux

  A propos de l'assistant Report	  Rubriques connexes

1	Cliquez sur un champ de la liste Champs disponibles.

2	Cliquez sur le bouton correspondant à la fonction que vous voulez appliquer au champ. Une entrée comportant le nom du champ et de la fonction apparaît dans la liste Totaux matriciels.

3	Répétez l'étape 2 pour les autres fonctions que vous voulez appliquer au champ, le cas échéant.

4	Répétez les étapes 1 à 3 jusqu'à ce que vous ayez créé tous les totaux voulus.

5	(Facultatif) Pour enlever un champ de la liste Totaux matriciels, cliquez sur le champ, puis sur [image].

Notes d'utilisation

•	Certains types de données Oracle8 ne sont pas encore pris en charge. L'icône [image] signalera le type de données demandé comme inconnu, dans l'assistant, si votre interrogation sélectionne un type de données Oracle8 non pris en charge.

•	Les fonctions que vous pouvez utiliser avec des objets colonne et des colonnes Ref sont en nombre limité. Certaines fonctions apparaissent donc désactivées lorsque vous voulez les sélectionner dans la liste des champs disponibles.

•	Pour les états de groupe, l'assistant Report créé n champs récapitulatifs dans le modèle de données, pour chacune des colonnes récapitulatives définies : à savoir, un champ à chaque niveau de groupe supérieur à la colonne récapitulative et un champ au niveau de l'état. Par exemple, si un état est regroupé par divisions et par services, la création d'une colonne récapitulative pour le total des salaires crée des champs pour la somme des salaires de chaque division et pour chaque service (récapitulatifs au niveau du groupe), ainsi que pour la somme de tous les salaires (récapitulatif au niveau de l'état).


Assistant Report : page Libellés

  A propos de l'assistant Report

1	Cliquez sur l'un des libellés sous le titre Libellés.

2	Editez le libellé, en fonction de la façon dont il doit se présenter dans la sortie de l'état.

3	Répétez les étapes 1 et 2 jusqu'à ce que tous les libellés vous conviennent.

4	Cliquez sur l'une des valeurs numériques de Largeur.

5	Modifier la valeur numérique afin qu'elle corresponde à la largeur du champ associé.  Conseil

6	Répétez les étapes 4 et 5 jusqu'à ce que toutes les largeurs vous conviennent.


Assistant Report : page Modèles

  A propos de l'assistant Report	  Etape suivante

1	Sélectionnez l'un des trois boutons d'option suivants : Modèle prédéfini, Fichier de modèle, Aucun modèle.

2	En fonction de votre sélection à l'étape 1, exécutez l'étape suivante :

•	Pour Modèle prédéfini, sélectionnez un modèle de la liste.

•	Pour Fichier de modèle, entrez le nom d'un fichier .tdf ou cliquez sur Parcourir pour en sélectionner un.

•	Pour Aucun modèle, aucune action n'est nécessaire.


Assistant Report : page Fin

  A propos de l'assistant Report

Etape suivante

Vous pouvez maintenant sortir de l'assistant Report et travailler sur l'état. Lorsque vous cliquez sur Fin, Report Builder ferme l'assistant Report et affiche automatiquement l'état dans le Live Previewer, qui est l'un des outils de développement de Report Builder. Vous pouvez alors modifier votre état dans l'Aperçu interactif, ou choisir Outils [image] Assistant Report pour revenir à l'assistant et apporter de nouvelles modifications. Pour plus d'informations sur la création d'états, reportez-vous à l'aide en ligne :

1	Affichez l'Aperçu produit pour avoir une vue d'ensemble de Report Builder :

•	Choisissez Aide [image] Aperçu produit.

2	Etudiez les différents assistants pour savoir comment exécuter les tâches les plus courantes :

•	Choisissez Aide [image] Assistants.

3	Accédez aux manuels en ligne/imprimés :

•	Choisissez Aide [image] Manuels.

4	Localisez les rubriques d'aide :

•	Pour la table des matières et l'index, choisissez Aide [image] Rubriques d'aide.

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


Champ de groupe

Un champ de groupe permet de découper les données de votre état en groupes maître et détail (également appelés pères et enfants). Un champ de groupe apparaît dans un groupe maître et, pour chaque enregistrement du groupe maître, un enregistrement détail correspondant est extrait.


Champ groupes de matrices

Un champ groupes de matrices permet de découper les données de votre état en groupes maître et détail (également appelés pères et enfants). Un champ groupes de matrices apparaît dans un groupe maître et, pour chaque enregistrement du groupe maître, un enregistrement détail correspondant est extrait et formaté en matrice.


Champs lignes de matrice

Les valeurs des champs lignes de matrice apparaissent sur le côté de la matrice.


Champs colonnes de matrice

Les valeurs des champs colonnes de matrice apparaissent en haut de la matrice.


Conseil

Cliquez sur [image] pour faire passer dans la liste Champs affichés toutes les colonnes de la liste Champs disponibles. Cliquez sur [image] pour faire passer dans la liste Champs disponibles toutes les colonnes de la liste Champs affichés.


Conseil

Si la liste Champs de groupe est vide, cela signifie qu'il n'y a aucun champ de groupe sélectionné pour définir une ventilaion dans l'état. Vous devez avoir au moins un champ dans la liste Champs de groupe pour pouvoir changer de page dans l'assistant. Si Champs de groupe est vide, et que vous cliquies sur Suivant ou Précédent ou sélectionniez un onglet, une erreur se produit.


Conseil

Si la liste Champs affichés est vide, cela signifie qu'il n'y a aucun champ sélectionné pour figurer dans la sortie de l'état. Vous devez avoir au moins un champ dans la liste Champs affichés pour pouvoir changer de page dans l'assistant. Si Champs affichés est vide et que vous cliquiez sur Suivant ou Précédent ou sélectionniez un onglet, une erreur se produit.


Conseil

Seuls les groupes qui figurent dans la liste Groupes affichés apparaîtront dans la sortie de l'état.


Conseil

Report Builder extrait de la base de données toutes les colonnes indiquées dans les interrogations de l'état, mais seules celles qui figurent dans la liste Champs affichés apparaîtront dans la sortie de l'état.


Conseil

Le champ lignes de matrice de niveau 1 est affiché à l'extérieur, sur le côté de la matrice. Le champ de niveau 2 apparaît à la droite du champ de niveau 1, le champ de niveau 3 à la droite du champ de niveau 2, et ainsi de suite.


Conseil

Le champ colonnes de matrice de niveau 1 est affiché à l'extérieur, en haut de la matrice. Le champ de niveau 2 apparaît sous le champ de niveau 1, le champ de niveau 3 sous le champ de niveau 2, et ainsi de suite.


Conseil

Si vous ne voulez pas appliquer une fonction au champ, vous pouvez utiliser [image] pour placer le champ dans la liste Champs cellules de matrice sans appliquer de fonction ce qui est utile lorsque votre interrogation exécute déjà une fonction sur la colonne source du champ, par exemple SUM(SAL), et si vous ne voulez pas y appliquer d'autre fonction.


Conseil

La largeur est indiquée en unités de caractère (par exemple, 10 signifie 10 caractères de large).


Vue Modèle de données

  Rubriques connexes

La vue Modèle de données est une zone de travail dans laquelle vous définissez les données à utiliser dans un état. Vous créez, définissez et modifiez des objets de modèle de données (interrogations, groupes, colonnes, paramètres et liens).

Report Builder utilise le modèle de données pour déterminer les données à extraire pour l'état. Les données extraites de la base de données peuvent, ou non, figurer dans la sortie de l'état.

Accès

Zone de coloriage

Représentation d'objets

Règles

Grille

Barre d'outils

Palette d'outils

Barre d'état


Description

La vue Modèle de données est une zone de travail dans laquelle vous définissez les données à utiliser dans un état. Vous créez, définissez et modifiez des objets de modèle de données (interrogations, groupes, colonnes, paramètres et liens).

Report Builder utilise le modèle de données pour déterminer les données à extraire pour l'état. Les données extraites de la base de données peuvent, ou non, figurer dans la sortie de l'état.


Accès

Pour accéder à la vue Modèle de données, vous avez le choix entre plusieurs possibilités :

•	Cliquer sur l'outil Modèle de données.

•	Choisir Affichage [image] Modèle de données.

•	Dans le menu Fenêtres, sélectionner une fenêtre contenant le Modèle de données.

•	Dans le Navigateur d'objet, cliquer deux fois sur l'icône du noeud Modèle de données.


Zone de coloriage

La région de coloriage est la zone dans laquelle vous pouvez créer, modifier, positionner ou supprimer des objets tout en visualisant leur représentation graphique. Seule la position relative des objets dans le Modèle de données est représentée graphiquement dans un éditeur. Pour afficher les paramètres d'un objet, vous devez ouvrir sa fenêtre de propriétés en cliquant deux fois sur cet objet.


Représentation des objets

Les objets de modèle de données que vous pouvez créer dans la région de coloriage comprennent des interrogations, des groupes, des colonnes (récapitulatives et de formule), des paramètres et des liens. Vous ne pouvez pas couper, copier, coller ni dupliquer des objets de modèle de données (les options Couper, Copier, Coller et Dupliquer sont désactivées dans le menu Edition).

Dans le modèle de données, la hiérarchie des groupes est déterminée par les relations père-fils ou par la position des groupes dans l'éditeur. S'il n'y a pas de relation père-fils entre deux groupes (c'est-à-dire s'ils ont le même père ou n'ont aucun lien entre eux), la hiérarchie est déterminée par la lecture de gauche à droite, puis de haut en bas, dans la vue Modèle de données. La hiérarchie des colonnes est déterminée par la lecture de haut en bas à l'intérieur de chaque groupe.


Règles

Les règles sont affichées le long des bords gauche et supérieur de la région de coloriage. Au départ, elles sont masquées dans la vue Modèle de données. Pour les afficher, sélectionnez Affichage [image] Règles.

Repères  Les repères se déplacent le long des deux règles pour suivre l'emplacement de votre curseur dans la zone de coloriage. Les règles défilent avec la zone de coloriage. De même, lorsque vous agrandissez une partie de la zone de coloriage, les règles sont mises à jour pour refléter cet agrandissement.

Guides Les guides constituent un point de référence pour la création et la modification des objets. Pour créer un guide, cliquez sur l'une des règles et faites-la glisser dans la région de coloriage. Pour afficher les guides, sélectionnez Affichage [image] Guides.


Grille

La zone de coloriage comporte une grille qui vous aide à placer les objets dans cette zone. La grille est tracée en fonction des règles. Choisissez Afficher [image] Grille pour afficher la grille.


Barre d'outils

Cliquez sur l'outil de la barre d'outils que vous voulez utiliser. Si l'outil est conçu pour exécuter une action sur des objets, il apparaît grisé jusqu'à ce qu'un ou plusieurs objets soient sélectionnés. Lorsque vous cliquez sur l'outil, il exécute l'action prévue sur l'objet ou les objets sélectionnés.


Palette d'outils

La palette d'outils regroupe un ensemble d'outils que vous pouvez utiliser pour créer et manipuler des objets. Cliquez une fois sur un outil pour l'activer pour une opération, ou deux fois pour le " verrouiller " pour plusieurs opérations.

Les outils de la palette d'outils sont fonction de la vue Editeur d'état. Cliquez sur un outil de la palette d'outils de la vue Modèle de données pour connaître ses fonctions.


Barre d'état

Dans la vue Modèle de données, la barre d'état affiche les informations suivantes :

•	position absolue de la souris (en pixels, pouces ou centimètres)

•	déplacement de la souris (en pixels, pouces ou centimètres)

•	niveau de grossissement.


Outil Interrogation

L'outil Interrogation permet de créer une nouvelle interrogation dans le Modèle de données. Pour cela, sélectionnez l'outil et cliquez dans la région de coloriage, puis cliquez deux fois sur l'objet interrogation et indiquez les propriétés de votre choix.


Outil PL/SQL

L'outil PL/SQL permet de créer une interrogation de curseur de référence (de type Ref) dans le modèle de données. Pour ce faire, sélectionnez l'outil et cliquez dans la zone de coloriage. L'Editeur PL/SQL apparaît. Entrez le code PL/SQL correspondant à une fonction qui ouvre un curseur et renvoie une variable du type de curseur Ref que vous avez défini dans le package.


Outil Liaison de données

L'outil Liaison de données, qui permet de créer une relation entre les données de deux interrogations, peut être utilisé de trois façons :

•	Liaison interrogation à interrogation  Cliquez avec la souris et faites glisser celle-ci de l'interrogation père jusqu'à l'interrogation fils, pour créer une liaison de données pour chaque contrainte de base de données définie entre les tables de deux interrogations.

•	Liaison groupe à groupe  Cliquez avec la souris et faites glisser celle-ci du groupe père (en excluant les colonnes du groupe) jusqu'au groupe appartenant à l'interrogation fils.

•	Liaison colonne à colonne  Cliquez avec la souris et faites glisser celle-ci de la colonne du groupe père jusqu'à la colonne du groupe fils.


Outil Colonne récapitulative

L'outil Colonne récapitulative permet de créer une colonne récapitulative dans le modèle de données. Pour cela, sélectionnez l'outil et cliquez dans un groupe ou dans une zone ouverte de la région de coloriage, puis cliquez deux fois sur l'objet colonne récapitulative et indiquez les propriétés de votre choix.


Outil Colonne de formule

L'outil Colonne de formule permet de créer une nouvelle colonne de formule dans le modèle de données. Pour cela, sélectionnez l'outil et cliquez  dans un groupe ou dans une zone ouverte de la région de coloriage, puis cliquez deux fois sur l'objet colonne de formule et indiquez les propriétés de votre choix.


Outil Colonne de réserve

L'outil Colonne de réserve permet de créer une nouvelle colonne de réserve dans le modèle de données. Pour cela, sélectionnez l'outil et cliquez dans un groupe ou dans une zone ouverte de la région de coloriage, puis cliquez deux fois sur l'objet colonne de réserve et indiquez les propriétés de votre choix.


Outil Inter-produit

L'outil Inter-produit permet de créer un groupe inter-produit autour de plusieurs autres groupes. Un inter-produit est un produit mathématique utilisé dans le modèle de données pour créer une matrice. Sélectionnez l'outil inter-produit, et cliquez avec la souris et faites glisser celle-ci autour des groupes que vous voulez inclure dans le groupe inter-produit. Si le groupe de cellules est une interrogation distincte des groupes inter-produit, créez les liens appropriés entre les colonnes des groupes inter-produit et le groupe de cellules, puis générez l'état et indiquez les options d'un état matriciel dans l'assistant Report.


Vue Modèle de présentation

    Rubriques connexes

La vue Modèle de présentation est une zone de travail dans laquelle vous pouvez définir le format de la sortie de votre état. Pour cela, vous utilisez des objets de présentation comme des encadrements, des encadrements itératifs, des champs, des textes standard, des points d'ancrage et des objets graphiques.

Lorsque vous exécutez un état, Report Builder utilise le Modèle de présentation comme modèle par défaut pour la sortie de l'état. Ce modèle grossit ou diminue en fonction des données extraites pour les objets de la présentation et de la logique PL/SQL attribuée à ces objets.

Accès

Zone de coloriage

Représentation d'objets

Règles

Grille

Barre d'outils

Barre de styles

Palette d'outils

Barre d'état


Description

La vue Modèle de présentation est une zone de travail dans laquelle vous pouvez définir le format de la sortie de votre état. Pour cela, vous utilisez des objets de présentation comme des encadrements, des encadrements itératifs, des champs, des textes standard, des points d'ancrage et des objets graphiques.

Lorsque vous exécutez un état, Report Builder utilise le Modèle de présentation comme modèle par défaut pour la sortie de l'état. Ce modèle grossit ou diminue en fonction des données extraites pour les objets de la présentation et de la logique PL/SQL attribuée à ces objets.


Accès

Pour accéder à la vue Modèle de présentation, vous avez le choix entre plusieurs possibilités :

•	Cliquer sur l'outil Modèle de présentation.

•	Choisir Affichage [image] Modèle de présentation.

•	Dans le menu Fenêtres, sélectionner une fenêtre comportant le Modèle de présentation.

•	Dans le Navigateur d'objet, cliquer deux fois sur l'icône du noeud Modèle de présentation.


Zone de coloriage

Cette région est la zone dans laquelle vous pouvez créer, modifier, positionner ou supprimer des objets, tout en visualisant leur représentation graphique à l'écran. La vue Modèle de présentation comporte trois régions d'état :

•	page de garde

•	corps/marges

•	page de fin

 Cliquez ici.

Pour passer d'une région de l'état à une autre, vous pouvez :

•	Cliquer sur l'icône correspondante de la barre d'outils.

•	Choisir Section de présentation dans le menu Affichage.

Page de garde  Les pages de garde de l'état apparaissent une fois au début de chaque état, sous la forme d'un ensemble de pages distinctes. Elles peuvent contenir du texte, des graphiques, des données et des calculs.

Corps/marges  Les pages de corps/marges, placées entre les pages de garde et de fin, constituent l'essentiel de l'état. Chaque page physique de cette section se compose d'un corps et de marges. Lorsque vous passez pour la première fois à la vue Modèle de présentation d'un nouvel état, le programme vous fait passer dans la région corps/marges. Vous pouvez créer, modifier et supprimer des objets dans la région de votre choix. Pour plus d'informations sur les marges, reportez-vous à " Marges ".

Le corps contient l'essentiel du texte, des graphiques, des données et des calculs de l'état. Chaque page comporte une marge supérieure et une marge infrieure, jusqu'à ce que toutes les données du corps de l'état aient été formatées. Une marge peut comporter du texte, des graphiques, des numéros de page, des totaux de pages et des totaux globaux. La taille de marge par défaut est d'un demi-pouce en haut et en bas, et zéro pour les marges de droite et de gauche.

Page de fin  Les pages de fin de l'état apparaissent à la fin de chaque état, sous la forme d'une série de pages distinctes. Elles peuvent contenir du texte, des graphiques, des données et des calculs.


Représentation des objets

Les objets de présentation que vous pouvez créer dans la région de coloriage comprennent des encadrements, des encadrements itératifs, des champs, du texte standard, des points d'ancrage, des boutons, des objets OLE2 et des objets graphiques. La taille, la position relative, le motif, les couleurs et les polices des objets sont représentés graphiquement dans l'éditeur.

Les représentations graphiques (ou icônes) indiquent le type d'objet représenté et, dans certain cas, ses paramètres. La figure indique la signification de ces icônes dans le modèle de présentation.

 Cliquez ici.

Pour visualiser les options d'un objet, vous devez ouvrir sa fenêtre de propriétés en cliquant deux fois sur cet objet.


Règles

Les règles sont affichées le long des bords gauche et supérieur de la région de coloriage. Au départ, elles sont affichées dans la vue Modèle de présentation. Pour les masquer, désélectionnez l'option Règles dans le menu Affichage.

Unités Les unités de mesure de la règle, que vous pouvez choisir en sélectionnant Format [image] Options de présentation [image] Règles, sont les suivantes :

•	pouces ;

•	centimètres ;

•	points ;

•	cellules de caractère.

Lorsque vous modifiez la propriété Unité de mesure d'un état, les unités dans lesquelles sont affichées les règles sont mises à jour en conséquence. Lorsque vous activez Concevoir en unités caractère, les unités de règle sont changées en cellules de caractère.

Repères  Les repères se déplacent le long des deux règles pour suivre l'emplacement de votre curseur dans la zone de coloriage. Les règles défilent avec la zone de coloriage. De même, lorsque vous agrandissez une partie de la zone de coloriage, les règles sont mises à jour pour refléter cet agrandissement.

Guides Les guides constituent un point de référence pour la création et la modification des objets. Pour créer un guide, cliquez sur l'une des règles, et faites-la glisser dans la région de coloriage.

Remarque : Pour masquer les règles et les guides, désélectionnez Règles et Guides dans le menu Affichage. Pour les afficher, sélectionnez ces options de menu.


Grille

La région de coloriage comporte une grille qui facilite le positionnement des objets dans cette région. Le tracé de la grille est lié aux règles. Choisissez Format [image] Options de présentation [image] Règles pour indiquer le nombre de lignes de grille par unité de règle. Par exemple, si vous avez choisi comme Unité de mesure les pouces et comme Pas de grille 0,5, vous aurez une ligne de grille par demi-pouce de règle.


Barre d'outils

Cliquez sur l'outil de la barre d'outils que vous voulez utiliser. Si l'outil est conçu pour exécuter une action sur des objets, il apparaît grisé jusqu'à ce qu'un ou plusieurs objets soient sélectionnés. Lorsque vous cliquez sur l'outil, il exécute l'action prévue sur l'objet ou les objets sélectionnés.


Barre de styles

Pour utiliser les outils de la barre de styles, sélectionnez des objets, puis cliquez sur l'outil de votre choix. L'action correspondant à cet outil sera exécutée sur les objets sélectionnés. Les outils standard de la barre de styles permettent de modifier la police, le style de police, la taille et la justification des objets sélectionnés.


Palette d'outils

La palette d'outils regroupe un ensemble d'outils que vous pouvez utiliser pour créer et manipuler des objets. Cliquez une fois sur un outil pour l'activer pour une opération, ou deux fois pour le " verrouiller " pour plusieurs opérations.

Les outils de la palette d'outils sont fonction de la vue Editeur d'état. Cliquez sur un outil de la palette d'outils de la vue Modèle de présentation pour connaître ses fonctions.


Barre d'état

Dans la vue Modèle de présentation, la barre d'état affiche les informations suivantes :

•	position absolue de la souris (en pixels, pouces ou centimètres)

•	déplacement de la souris (en pixels, pouces ou centimètres)

•	angles de rotation

•	niveau de grossissement.

•	pourcentages d'ancrage


Outil Sélection

L'outil Sélection permet de choisir un ou plusieurs objets pour une opération. Lorsqu'un objet est sélectionné, ses points de contrôle deviennent visibles. En appuyant sur Maj tout en cliquant avec la souris, vous pouvez sélectionner plusieurs objets ou groupes. Lorsque vous sélectionnez un objet dans l'Editeur d'état, il est également sélectionné dans le Navigateur d'objet.


Outil Sélection d'encadrement

L'outil Sélection d'encadrement permet de sélectionner un encadrement ou un encadrement itératif, ainsi que tous les objets qu'il contient. Tout objet ancré indirectement ou directement à un objet se trouvant dans l'encadrement ou l'encadrement itératif est également sélectionné. Un objet ancré à l'encadrement ou à l'encadrement itératif ou à un objet extérieur au cadre ou à l'encadrement itératif n'est pas sélectionné.


Outil Rotation

L'outil Rotation permet de faire pivoter un texte standard et des objets graphiques sélectionnés. Pour faire pivoter un objet, cliquez et faites glisser l'un de ses points de contrôle. L'objet sélectionné pivote dans la direction dans laquelle vous le faites glisser.

Lorsque vous utilisez l'outil Rotation, notez que :

•	Seuls certains systèmes d'exploitation acceptent le texte après rotation. Par exemple, le mode caractère n'accepte pas ce type de texte.

•	Vous ne pouvez pas faire pivoter directement un champ, mais vous pouvez faire référence à un champ (par exemple, &nom) dans un objet texte standard, que l'on peut faire pivoter.

•	Vous ne pouvez faire pivoter que le texte standard que vous entrez ou importez dans l'éditeur. Vous ne pouvez pas faire pivoter un texte standard créé à l'aide de l'outil Fichier de liaison.

•	Pour le texte soumis à une rotation, la propriété Elasticité horizontale fait référence au sens de lecture du texte. Par exemple, si vous faites pivoter votre texte de 90° et que vous demandiez une Elasticité horizontale fixe, le texte occupera un espace vertical fixe. Si vous définissez Elasticité horizontale et verticale à Variable ou Développer et que si l'angle de rotation du texte ne soit pas un multiple de 90°, la largeur de l'objet sera considérée comme contractée (pour Variable) ou fixe (pour Développer).


Outil Remettre en forme

L'outil Remettre en forme permet de modifier la forme d'un objet sélectionné. Pour cela, cliquez sur l'un des points de contrôle de l'objet et faites glisser. Notez que les points de contrôle affichés lors de la remise en forme diffèrent de ceux qui sont affichés lors de la sélection d'un objet. Les résultats de l'outil Remettre en forme sont fonction des objets :

•	Pour les arcs, l'outil Remettre en forme permet de modifier l'angle de balayage pour qu'il ait une valeur autre que 90 ° (valeur par défaut lors de la création d'un arc).

•	Pour les polygones, l'outil Remettre en forme permet de déplacer un sommet.

•	Pour les objets rectangulaires (encadrements, champs et objets graphiques, par exemple), l'outil Remettre en forme permet de déplacer un sommet. Notez que cette fonction n'est intéressante que si le rectangle fait l'objet d'une rotation afin que les points de contrôle sélectionnés ne coïncident plus avec les points de contrôle de la remise en forme.

•	Pour les points d'ancrage, l'outil Remettre en forme vous permet de déplacer un sommet et, notamment, de déplacer ses extrémités, sur le même objet ou un objet différent.


Outil Grossir

L'outil Grossir double la zone autour du point sur lequel vous cliquez (c'est-à-dire que les objets deviennent deux fois plus gros). Si vous appuyez sur la touche de contrainte (généralement la touche Majuscules) lorsque vous utilisez l'outil Grossir, vous divisez la taille des objets par deux (c'est-à-dire qu'ils deviennent moitié moins gros). Cet outil est utile lorsque vous voulez voir en détail une partie d'une grande présentation.


Outil Ligne

L'outil Ligne permet de tracer un objet standard de type Ligne. Pour cela, cliquez à l'endroit où vous voulez placer une extrémité, faites glisser la souris jusqu'à l'autre extrémité, puis relâchez. Pour tracer des lignes parfaitement horizontales, verticales ou à 45 °, utilisez la touche de contrainte (généralement la touche Majuscules). Vous pouvez définir d'autres options de ligne en choisissant Epaisseur de ligne, Biseau, Tiret ou Flèche sur le menu Format.


Outil Rectangle arrondi

L'outil Rectangle arrondi permet de tracer un objet standard de type rectangle arrondi. Pour cela, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour créer un carré à angles arrondis, utilisez la touche de contrainte (généralement la touche Majuscules). Vous pouvez définir des Options de graphique spéciales pour un rectangle arrondi en utilisant le menu Format.


Outil Rectangle

L'outil Rectangle permet de tracer un objet standard de type rectangulaire. Pour cela, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour dessiner un carré parfait, utilisez la touche de contrainte (généralement la touche Majuscules).


Outil Ellipse

L'outil Ellipse permet de tracer un objet standard de type elliptique. Pour cela, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour dessiner un cercle parfait, utilisez la touche de contrainte (généralement la touche Majuscules).


Outil Arc

L'outil Arc permet de tracer un objet standard de type arc. Pour cela, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour dessiner l'arc d'un cercle, utilisez la touche de contrainte (généralement la touche Majuscules). Vous pouvez définir des Options de graphique spéciales pour un arc en utilisant le menu Format.


Outil Polygone

L'outil Polygone permet de tracer un objet standard de type polygone. Pour cela, cliquez à l'endroit choisi pour le premier sommet, puis sur le suivant, et ainsi de suite. Pour finir de tracer le polygone, cliquez deux fois sur le dernier sommet, pour relier le dernier sommet au premier. Pour tracer un segment parfaitement horizontal, vertical ou à 45 °, utilisez la touche de contrainte (généralement la touche Majuscules). Cette opération sur un sommet est sans effet sur les sommets suivants.


Outil Ligne polygonale

L'outil Ligne polygonale permet de créer un objet standard de type ligne polygonale. Pour cela, cliquez à l'endroit choisi pour le premier sommet, puis sur le suivant, et ainsi de suite. Pour terminer le tracé de la ligne polygonale, cliquez deux fois sur le dernier sommet. Si vous ne reliez pas manuellement le premier et le dernier sommets, ils ne sont pas reliés (contrairement au cas du polygone). Pour dessiner un segment parfaitement horizontal, vertical ou à 45 °, utilisez la touche de contrainte (généralement la touche Majuscules). Cette opération sur un sommet est sans effet sur les sommets suivants.


Outil Forme libre

L'outil Forme libre permet de tracer un objet standard de type forme libre. Pour cela, cliquez et faites glisser la souris pour définir l'objet, puis relâchez.


Outil Texte

L'outil Texte permet de créer et d'éditer un objet texte standard. Pour cela, vous avez le choix entre deux possibilités :

•	Cliquez à l'endroit où vous voulez commencer le texte et commencez la saisie. Le texte ne passe automatiquement à la ligne que lorsque vous appuyez sur la touche Retour pour commencer une nouvelle ligne.

•	Cliquez et faites glisser la souris pour créer un cadre délimitant le texte. Le texte entré dans le cadre passera automatiquement à la ligne en fonction des limites horizontales de la boîte. La boîte s'agrandira verticalement, si nécessaire, pour pouvoir contenir le texte que vous frappez.

Pour éditer un texte standard, cliquez sur l'objet texte standard et commencez à taper ou à éditer. Lorsque vous tapez ou éditez du texte, vous êtes en mode Texte. Pour sortir de ce mode, cliquez en dehors de l'objet texte standard. En mode Texte, vous pouvez exécuter différentes opérations sur le texte : couper, copier et coller, ou utiliser la barre de styles pour changer de polices et d'alignement.

Remarque : Si vous changez la police ou la taille du texte standard, la boîte qui l'entoure s'agrandit ou diminue en conséquence.


Outil Encadrement

L'outil Encadrement permet de créer un encadrement. Pour cela, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour dessiner un carré parfait, utilisez la touche de contrainte (généralement la touche Majuscules).


Outil Encadrement itératif

L'outil Encadrement itératif permet de créer un encadrement itératif. Pour cela, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour tracer un carré parfait, utilisez la touche de contrainte (généralement la touche Majuscules).


Outil Champ

L'outil Champ permet de créer un champ. Pour cela, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour tracer un carré parfait, utilisez la touche de contrainte (généralement la touche Majuscules).


Outil Fichier de liaison

L'outil Fichier de liaison permet de créer un objet standard extrait d'un fichier. L'objet standard, qui peut être du texte, des dessins ou des images, est représenté dans l'éditeur sous la forme d'un rectangle. Pour tracer un objet de type Fichier de liaison, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour tracer un carré parfait, utilisez la touche de contrainte (généralement la touche Majuscules).


Outil Graphique

L'outil Graphique permet de créer un objet graphique qui fait référence à un affichage de Graphics Builder. Pour cela, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour tracer un carré parfait, utilisez la touche de contrainte (généralement la touche Majuscules).


Outil Bouton

L'outil Bouton permet de tracer un objet bouton. Pour cela, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour tracer un carré parfait, utilisez la touche de contrainte (généralement la touche Majuscules).

Remarque : Lors de l'exécution, les boutons définis par l'utilisateur auront les mêmes caractéristiques que les boutons natifs de votre plate-forme.


Outil Point d'ancrage

L'outil Point d'ancrage permet d'ancrer deux objets l'un à l'autre. Pour tracer un point d'ancrage, cliquez sur un bord de l'objet fils, cliquez sur les autres positions dans l'éditeur (en option), puis cliquez deux fois sur un bord de l'objet père. Lorsque vous utilisez la touche de contrainte (généralement la touche Majuscules) pendant que vous placez un point d'ancrage sur l'objet fils, celui-ci est généralement contracté à l'incrément le plus proche (25 %).


Outil Objet OLE2

L'outil Objet OLE2 permet de placer un objet OLE2 dans une présentation. Pour tracer un objet OLE2, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour tracer un carré parfait, utilisez la touche de contrainte (généralement la touche Majuscules).

Lorsque vous avez tracé l'objet OLE2, vous voyez apparaître une boîte de dialogue dans laquelle vous pouvez définir le type d'objet, sa source et son type : lié ou incorporé. Notez que les options doivent être indiquées pour que l'objet soit créé.


Outil Présentation par défaut supplémentaire

L'outil Présentation par défaut supplémentaire permet de définir une présentation par défaut pour une partie d'un état, sans écraser tout le modèle de présentation. Pour cela, cliquez et faites glisser la souris en diagonale pour définir l'objet, puis relâchez. Pour tracer un carré parfait, utilisez la touche de contrainte (généralement la touche Majuscules). Lorsque vous avez défini la zone dans laquelle la présentation par défaut doit apparaître, un message vous demande d'indiquer des options en utilisant l'assistant Report.


Affichage des couleurs Remplissage/ligne/texte

Affiche les sélections en cours des couleurs de remplissage, de ligne et du texte. Pour les modifier, utilisez les outils Couleur de remplissage, Couleur de ligne et Couleur du texte.


Outil Couleur de remplissage

L'outil Couleur de remplissage affiche toutes les couleurs disponibles, Pas de remplissage et Motifs. Le fait de choisir l'une des couleurs ou Pas de remplissage définit la couleur de remplissage des objets sélectionnés et de tous les objets créés ultérieurement. La sélection de Motifs affiche une palette de motifs. Le choix d'un motif définit le motif de remplissage des objets sélectionnés et de tous les objets créés ultérieurement. Au bas de la palette Motifs figurent les palettes de couleurs de premier plan et d'arrière-plan. Le fait de choisir Couleurs de premier plan et Couleurs d'arrière-plan définit les couleurs des motifs.


Outil Couleur de ligne

L'outil Couleur de ligne affiche toutes les couleurs disponibles, Pas de ligne et Motifs. Le fait de choisir l'une des couleurs ou Pas de ligne définit la couleur des lignes des objets sélectionnés et de tous les objets créés ultérieurement. La sélection de Motifs affiche une palette de motifs. Le choix d'un motif définit le motif de remplissage des objets sélectionnés et de tous les objets créés ultérieurement. Au bas de la palette Motifs figurent les palettes de couleurs de premier plan et d'arrière-plan. Cliquez sur ces palettes pour afficher les couleurs disponibles. Le fait de choisir Couleurs de premier plan et Couleurs d'arrière-plan définit les couleurs des motifs.


Outil Couleur du texte

L'outil Couleur du texte affiche toutes les couleurs disponibles. Le choix de l'une des couleurs définit la couleur du texte des objets sélectionnés et de tous les objets créés ultérieurement, jusqu'à ce que vous changiez cette couleur.


Vue Aperçu interactif

  Rubriques connexes

La vue Aperçu interactif est une zone de travail dans laquelle vous pouvez visualiser votre état et manipuler les données réelles. Dans la vue Aperçu interactif, vous pouvez personnaliser vos états en mode interactif, c'est-à-dire voir immédiatement les résultats des modifications que vous apportez.

Pour activer les boutons de la vue Aperçu interactif, vous devez afficher la sortie de l'état dans l'Aperçu Runtime. Pour modifier votre état, notamment redimensionner les colonnes, la vue Aperçu interactif doit être en mode Flexible.

Accès

Titre

Région de visualisation

Règles

Grille

Barre d'outils

Barre de styles

Palette d'outils

Barre d'état


Description

La vue Aperçu interactif est une zone de travail dans laquelle vous pouvez visualiser votre état et manipuler les données réelles. Dans la vue Aperçu interactif, vous pouvez personnaliser vos états en mode interactif, c'est-à-dire voir immédiatement les résultats des modifications que vous apportez.

Pour activer les boutons de la vue Aperçu interactif, vous devez afficher la sortie de l'état dans l'Aperçu Runtime.


Accès

La vue Aperçu interactif s'affiche lorsque vous exécutez un état. Pour exécuter un état à partir du Navigateur d'objet ou d'un éditeur quelconque, cliquez sur [image] ou choisissez Programme [image] Exécuter état. Pour exécuter un état à partir de l'assistant Report, cliquez sur Fin.

Pour accéder à la vue Aperçu interactif, vous pouvez également :

•	Cliquer sur [image] dans la barre d'outils.

•	Choisir Affichage [image] Aperçu interactif.

•	Dans le menu Fenêtre, sélectionner une fenêtre contenant la vue Aperçu interactif.

•	Dans le Navigateur d'objet, cliquer deux fois sur [image] (icône de noeud Aperçu interactif).


Titre

Par défaut, le titre de la vue Aperçu interactif est <nom d'état> : Vue Aperçu interactif. Vous pouvez modifier l'intitulé de la vue Aperçu interactif dans la fenêtre de propriétés de l'état.


Région de visualisation

La région de visualisation est la zone dans laquelle vous pouvez visualiser et manipuler la sortie de votre état. Vous pouvez partager cette zone verticalement ou horizontalement en plusieurs régions en faisant glisser les barres noires qui se trouvent en dessous et à la droite des barres de défilement. Vous pouvez également agrandir cette région à l'aide de l'outil Grossir.

Pour obtenir d'autres options de visualisation (ouverture de plusieurs aperçus, affichage d'objets multimédia), affichez votre état dans l'Aperçu Runtime.


Règles

Les règles sont affichées le long des bords gauche et supérieur de la région de coloriage. Au départ, elles sont masquées dans la vue Aperçu interactif. Pour les afficher, sélectionnez l'option Règles dans le menu Affichage.

Unités Les unités de mesure de la règle, que vous pouvez choisir en sélectionnant Format [image] Options de présentation [image] Règles, sont les suivantes :

•	pouces ;

•	centimètres ;

•	points ;

•	cellules de caractère.

Lorsque vous modifiez la propriété Unité de mesure d'un état, les unités dans lesquelles sont affichées les règles sont mises à jour en conséquence. Lorsque vous activez Concevoir en unités caractère, les unités de règle sont changées en cellules de caractère.

Repères  Les repères se déplacent le long des deux règles pour suivre l'emplacement de votre curseur dans la zone de coloriage. Les règles défilent avec la zone de coloriage. De même, lorsque vous agrandissez une partie de la zone de coloriage, les règles sont mises à jour pour refléter cet agrandissement.

Guides Les guides constituent un point de référence pour la création et la modification des objets. Pour créer un guide, cliquez sur l'une des règles, et faites-la glisser dans la région de coloriage.

Remarque : Pour afficher les règles et les guides, sélectionnez Règles et Guides dans le menu Affichage. Pour les masquer, désélectionnez ces options de menu.


Grille

La région de coloriage comporte une grille qui facilite le positionnement des objets dans la région de visualisation. Le tracé de la grille est lié aux règles. Choisissez Format [image] Options de présentation [image] Règles pour indiquer le nombre de lignes de grille par unité de règle. Par exemple, si vous avez choisi comme Unité de mesure les pouces et comme Pas de grille 0.5, vous aurez une ligne de grille par demi-pouce de règle.


Barre d'outils

Cliquez sur l'outil de la barre d'outils que vous voulez utiliser. Si l'outil est conçu pour exécuter une action sur des objets, il apparaît grisé jusqu'à ce qu'un ou plusieurs objets soient sélectionnés. Lorsque vous cliquez sur l'outil, il exécute l'action prévue sur l'objet ou les objets sélectionnés.


Barre de styles

Pour utiliser les outils de la barre de styles, sélectionnez des objets, puis cliquez sur l'outil de votre choix. L'action correspondant à cet outil sera exécutée sur les objets sélectionnés. Les outils standard de la barre de styles permettent de modifier la police, le style de police, la taille et la justification des objets sélectionnés.


Palette d'outils

La palette d'outils regroupe un ensemble d'outils que vous pouvez utiliser pour créer et manipuler des objets. Cliquez une fois sur un outil pour l'activer pour une opération, ou deux fois pour le " verrouiller " pour plusieurs opérations.

Les outils de la palette d'outils sont fonction de la vue Editeur d'état. Cliquez sur un outil de la palette d'outils de la vue Aperçu interactif pour connaître ses fonctions.


Barre d'état

Dans la vue Aperçu interactif, la barre d'état affiche les informations suivantes :

•	position absolue de la souris (en pixels, pouces ou centimètres)

•	déplacement de la souris (en pixels, pouces ou centimètres)

•	niveau de grossissement.


Navigateur d'objet

  Rubriques connexes

Le Navigateur d'objet affiche de manière hiérarchique tous les objets principaux d'un état ou d'un modèle, y compris les bibliothèques attachées et les interrogations externes. Cette vue permet de sélectionner un objet, d'ouvrir la palette de propriétés d'un objet, de modifier l'instruction PL/SQL d'un objet, de déplacer des unités de programme PL/SQL et de rechercher un objet d'après son nom.

Accès

Composants

Noeuds

Vues


Description

Le Navigateur d'objet offre un affichage hiérarchique des principaux objets d'un état ou d'un modèle, et notamment des bibliothèques attachées et des interrogations externes, ce qui vous permet d'exécuter certaines opérations : sélection d'un objet, affichage de la palette de propriétés d'un objet, édition du PL/SQL d'un objet, déplacement d'unités de programmes PL/SQL à l'aide de la souris ou recherche d'un objet dont vous indiquez le nom.


Accès

Pour accéder au Navigateur d'objet, vous avez le choix entre deux possibilités :

•	Appeler Report Builder.

•	Sélectionner le Navigateur d'objet dans le menu Fenêtres.


Composants

Le Navigateur d'objet comporte plusieurs composants :

Liste de documents

Recherche

Barre d'outils

Arborescence d'objets


Liste de documents

La partie supérieure du Navigateur comporte une liste de tous les modules ouverts dans le Navigateur, ainsi que le dernier noeud sélectionné et ses ancêtres. En sélectionnant un nom dans la liste, vous pouvez sélectionner immédiatement son noeud dans le Navigateur.


Recherche

La partie supérieure du Navigateur comporte un champ appelé Rechercher dans lequel vous pouvez entrer une chaîne à utiliser pour rechercher un noeud. A côté du champ Rechercher, deux outils permettent d'indiquer le sens de la recherche :

 Recherche avant recherche le prochain noeud dont le nom correspond à la chaîne indiquée dans le champ Rechercher. Cette option explore et développe les noeuds réduits.

 Recherche arrière recherche le précédent noeud dont le nom correspond à la chaîne indiquée dans le champ Rechercher. Cette option explore les noeuds réduits.


 Barre d'outils

Pour utiliser les outils de la barre d'outils, cliquez sur un ou plusieurs objets de la vue pour les sélectionner, puis cliquez sur l'outil de votre choix. L'action représentée par cet outil sera exécutée sur les objets sélectionnés.


Arborescence des objets

L'arborescence des objets est une zone qui affiche une liste d'objets dans la session en cours. Cette liste se compose de noeuds dont chacun représente un objet ou un type d'objet.


Noeuds

Chaque objet ou type d'objet de votre session en cours - de chaque modèle ou état ouvert aux objets de chaque état - est représenté dans le Navigateur d'objet par un noeud. (Un noeud est une ligne du Navigateur d'objet que vous pouvez sélectionner.)

Chaque noeud du Navigateur d'objet se compose de certains ou de la totalité des éléments suivants :

•	un signe plus ou moins qui indique l'état de développement du noeud ;

•	une icône PL/SQL ( [image] ou [image]) qui représente le code PL/SQL de l'objet ;

•	un noeud d'objet ou une icône de vue de l'éditeur qui représente les propriétés de l'objet (par exemple, [image]) ou une vue de l'Editeur d'état (par exemple, [image]) ;

•	un nom ou un en-tête (par exemple, I_Emp ou Modèle de données).


Plus/moins

Indique l'état de développement du noeud :

•	Plus indique que le noeud comporte des sous-noeuds non affichés. Pour afficher les noeuds fils, cliquez sur le signe +. Si le signe + est grisé, le noeud peut contenir d'autres noeuds, mais n'en contient pas actuellement.

•	Moins indique que le noeud comporte des sous-noeuds affichés. Cliquez  sur le signe - pour réduire tous ses noeuds fils affichés.


Icône PL/SQL

Indique que l'objet peut avoir un code PL/SQL associé [image] et s'il a une unité de programme définie [image]. Pour afficher l'Editeur d'unité de programme et l'unité de programme de l'objet qu'il contient, cliquez deux fois sur l'icône PL/SQL.


Type d'objet ou vue de l'éditeur

Indique le type d'objet ou l'éditeur représenté par le noeud ; par exemple, un noeud représentant un paramètre affichera [image] et le noeud d'en-tête de vue Modèle de présentation affichera [image]. Pour afficher la palette de propriétés d'un objet, cliquez deux fois sur l'icône de cet objet. Pour afficher une vue de l'éditeur, cliquez deux fois sur l'icône de vue de l'éditeur. Pour afficher ou masquer ces icônes, utilisez Navigateur [image] Options Navigateur.


Nom ou en-tête d'objet

Il s'agit du nom de l'objet représenté par le noeud ou un noeud d'en-tête. Les noeuds d'objet représentent des objets spécifiques qui figurent dans des modèles ou des états ouverts, par exemple, F_1, M_GRPFR_Dept, ou Rectangle_B. Lorsque vous sélectionnez un noeud d'objet dans le Navigateur d'objet, l'objet est également sélectionné dans la vue correspondante de l'Editeur d'état ou de modèle, si l'éditeur est déjà ouvert. Les noeuds d'en-tête indiquent les types d'objets ou les propriétés ; par exemple Etats, Encadrements, Graphique standard sont des noeuds d'en-tête. Ces en-têtes précèdent les noeuds qui représentent les objets et sont utilisés dans la navigation.

Cliquer sur le nom ou l'en-tête sélectionne le noeud. S'il est déjà sélectionné, cliquer une fois sur non nom le fait passer en mode Edition, pour que vous puissiez éditer le nom de l'objet (vous ne pouvez pas éditer les en-têtes). Cliquer à l'extérieur des objets désactive le mode Edition et met à jour le nom édité à tous les endroits appropriés (par exemple, la présentation et les propriétés de l'objet). De même, si vous modifiez ailleurs le nom de l'objet, il est automatiquement mis à jour dans le Navigateur d'objet.

Remarque : Si le nom qui figure dans le Navigateur d'objet est en mode Edition, mais est édité ailleurs, il ne sera pas mis à jour dans le Navigateur d'objet. Le nom qui figure dans le Navigateur d'objet a priorité, et le nom final de l'objet sera celui qui se trouve dans le Navigateur d'objet au moment où le mode Edition est désactivé.


Vues

  Rubriques connexes

Le Navigateur d'objet vous permet d'afficher des objets par organisation hiérarchique ou par type d'objet.

Vue [image] Organisation hiérarchique affiche les objets selon la hiérarchie père-fils. Par exemple, les colonnes d'une interrogation apparaîtront sous l'interrogation et un champ apparaîtra sous l'encadrement itératif qui l'entoure. Cette vue peut constituer un outil de débogage utile, car elle permet de voir facilement les relations entre les objets.

Vue [image] Organisation par type d'objet affiche les objets par type. Par exemple, toutes les interrogations apparaîtront sous l'en-tête Interrogations et toutes les colonnes de la base de données sous l'en-tête Colonnes de base de données. Cette vue peut être utile pour trouver rapidement des objets dans le Navigateur d'objet.


Vue Grille de paramètres

  Rubriques connexes

La vue Grille de paramètres est un espace de travail dans lequel vous définissez le format de la Grille de paramètres d’exécution de l’état. Pour cela, vous définissez et modifiez des objets de grille de paramètres (champs et texte standard).

Lorsque vous exécutez un état, Report Builder utilise la vue Grille de paramètres comme modèle pour la grille de paramètres d'exécution. Les champs et le texte standard apparaissent dans la Grille des paramètres d'exécution exactement comme dans la vue Grille de paramètres. Si vous ne définissez pas de Grille de paramètres d'exécution dans la vue Grille de paramètres, Report Builder affiche automatiquement une grille de paramètres par défaut lors de l'exécution.

Accès

Zone de coloriage

Représentation d'objets

Règles

Grille

Barre d'outils

Barre de styles

Palette d'outils

Barre d'état


Description

La vue Grille de paramètres est un espace de travail dans lequel vous définissez le format de la Grille de paramètres d’exécution de l’état. Pour cela, vous définissez et modifiez des objets de grille de paramètres (champs et texte standard).

Lorsque vous exécutez un état, Report Builder utilise la vue Grille de paramètres comme modèle pour la grille de paramètres d'exécution. Les champs et le texte standard apparaissent dans la Grille des paramètres d'exécution exactement comme dans la vue Grille de paramètres. Si vous ne définissez pas de Grille de paramètres d'exécution dans la vue Grille de paramètres, Report Builder affiche automatiquement une grille de paramètres par défaut lors de l'exécution.


Accès

Pour accéder à la vue Grille de paramètres, vous avez le choix entre plusieurs possibilités :

•	Cliquer sur l'outil Grille de paramètres.

•	Choisir VAffichage [image] Grille de paramètres.

•	Dans le menu Fenêtres, sélectionner une fenêtre comportant la grille de paramètres.

•	Dans le Navigateur d'objet, cliquer deux fois sur l'icône du noeud Grille de paramètres.


Zone de coloriage

La région de coloriage est la zone dans laquelle vous pouvez créer, modifier, positionner ou supprimer des objets tout en visualisant leur représentation graphique. La région de coloriage de la vue Grille de paramètres se compose de pages physiques. Une page physique de la grille de paramètres est une fenêtre d'informations pouvant contenir du texte standard et des graphiques, ainsi que des champs.

Lorsque vous entrez pour la première fois dans la vue Grille de paramètres, vous vous trouvez dans la première page physique. Pour passer à d'autres pages de la grille de paramètres, faites-les défiler. Dans l'éditeur, les pages sont séparées par des lignes sombres.

Vous indiquez la taille de chaque page de grille de paramètres et le nombre de pages en utilisant la fenêtre de propriétés Etat (cliquez deux fois sur le noeud de l'état dans le Navigateur d'objet). La vue Grille de paramètres affiche verticalement le nombre de pages que vous avez indiqué et les sépare à l'aide d'une ligne horizontale. Les objets qui occupent plusieurs pages n'apparaissent que sur la première page de la vue Grille Runtime de paramètres et sont tronquées.


Représentation des objets

Dans la zone de coloriage, vous pouvez créer les objets de grille de paramètres suivants : champs et texte standard.

Vous pouvez couper, copier, coller et dupliquer des objets dans la vue Grille de paramètres, mais seule leur représentation graphique est copiée. Les options de la fenêtre de propriétés ne sont pas copiées avec les objets.

Pour visualiser les options d'un objet, vous devez ouvrir sa fenêtre de propriétés en cliquant deux fois sur cet objet.


Règles

Les règles sont affichées le long des bords gauche et supérieur de la région de coloriage. Au départ, elles sont affichées dans la vue Grille de paramètres. Pour les masquer, désélectionnez l'option Règles dans le menu Affichage.

Unités Les unités de mesure de la règle, que vous pouvez choisir en sélectionnant Format [image] Options de présentation [image] Règles, sont les suivantes :

•	pouces ;

•	centimètres ;

•	points ;

•	cellules de caractère.

Lorsque vous modifiez la propriété Unité de mesure d'un état, les unités dans lesquelles sont affichées les règles sont mises à jour en conséquence. Lorsque vous activez Concevoir en unités caractère, les unités de règle sont changées en cellules de caractère.

Repères  Les repères se déplacent le long des deux règles pour suivre l'emplacement de votre curseur dans la zone de coloriage. Les règles défilent avec la zone de coloriage. De même, lorsque vous agrandissez une partie de la zone de coloriage, les règles sont mises à jour pour refléter cet agrandissement.

Guides Les guides constituent un point de référence pour la création et la modification des objets. Pour créer un guide, cliquez sur l'une des règles, et faites-la glisser dans la région de coloriage.

Remarque : Pour masquer les règles et les guides, désélectionnez Règles et Guides dans le menu Affichage. Pour les afficher, sélectionnez ces options de menu.


Grille

La région de coloriage comporte une grille qui facilite le positionnement des objets dans cette région. Le tracé de la grille est lié aux règles. Choisissez Format [image] Options de présentation [image] Règles pour indiquer le nombre de lignes de grille par unité de règle. Par exemple, si vous avez choisi comme Unité de mesure les pouces et comme Pas de grille 0,5, vous aurez une ligne de grille par demi-pouce de règle.


Barre d'outils

Cliquez sur l'outil de la barre d'outils que vous voulez utiliser. Si l'outil est conçu pour exécuter une action sur des objets, il apparaît grisé jusqu'à ce qu'un ou plusieurs objets soient sélectionnés. Lorsque vous cliquez sur l'outil, il exécute l'action prévue sur l'objet ou les objets sélectionnés.


Barre de styles

Pour utiliser les outils de la barre de styles, sélectionnez des objets, puis cliquez sur l'outil de votre choix. L'action correspondant à cet outil sera exécutée sur les objets sélectionnés. Les outils standard de la barre de styles permettent de modifier la police, le style de police, la taille et la justification des objets sélectionnés.


Palette d'outils

La palette d'outils regroupe un ensemble d'outils que vous pouvez utiliser pour créer et manipuler des objets. Cliquez une fois sur un outil pour l'activer pour une opération, ou deux fois pour le " verrouiller " pour plusieurs opérations.

Les outils de la palette d'outils sont fonction de la vue Editeur d'état. Cliquez sur un outil de la palette d'outils de la vue Modèle de présentation pour connaître ses fonctions.


Barre d'état

Dans la vue Grille de paramètres, la barre d'état affiche les informations suivantes :

•	position absolue de la souris (en pixels, pouces ou centimètres)

•	déplacement de la souris (en pixels, pouces ou centimètres)

•	angles de rotation

•	niveau de grossissement.


Editeur de modèle

  Rubriques connexes

L'Editeur de modèle est un espace de travail dans lequel vous pouvez définir les objets de vos modèles, ainsi que leurs propriétés de mise en forme. Il est comparable à la vue Modèle de présentation de l'Editeur d'état. Vous pouvez créer, supprimer et modifier des objets (tels que numéros de page, texte et graphiques) dans la zone de marge. Vous ne pouvez pas créer ni supprimer des objets dans le corps du document, mais vous pouvez modifier les propriétés des objets figurant dans le corps via la palette de propriétés (Outils [image] Palette de propriétés).

Notes d'utilisation

Accès

Zone de coloriage

Styles d'état

Représentation d'objets

Règles

Grille

Barre d'état


Description

  Rubriques connexes

L'Editeur de modèle est une zone de travail dans laquelle vous pouvez définir des objets modèles et leurs propriétés de mise en forme. Il est comparable à la vue Modèle de présentation de l'Editeur d'état. Vous pouvez créer, supprimer et modifier des objets (tels que numéros de page, texte et graphiques) dans la zone de marge. Vous ne pouvez pas créer ni supprimer des objets dans le corps, mais vous pouvez modifier les propriétés des objets du corps dans la palette de propriétés (Outils [image] Palette de propriétés).


Notes d'utilisation

  Rubriques connexes

•	Lorsque vous travaillez dans l'Editeur de modèle, vous pouvez définir les attributs par défaut de chaque style d'état ou remplacer ceux d'un style donné.

•	Lorsque vous créez un modèle, modifiez les attributs par défaut pour lui donner une apparence générale, puis remplacez les attributs par défaut modifiés pour affiner les modifications pour des styles d'état particulier.

•	Utilisez le Navigateur d'objet pour modifier les propriétés d'état, les paramètres système, les paramètres utilisateur, les unités de programme, les bibliothèques attachées et les déclencheurs d'état du modèle.

•	Lorsque vous créez un objet dans la zone de marge, vous devez lui attribuer un nom dont vous êtes certain qu'il est unique  dans tous les états auxquels le modèle est appliqué. Par exemple, si vous créez un objet standard nommé S_1 dans un modèle, ce nom pourrait facilement entrer en conflit avec le nom d'un objet standard existant dans un état lorsque vous appliquez le modèle. Pour éviter ce problème, précisez davantage le nom de l'objet dans le modèle pour vous assurer qu'il est unique (par exemple, $MON_MODELE_STANDARD1).


Accès

Vous pouvez accéder à l'Editeur de modèle des manières suivantes :

•	A parti du menu Fenêtres, choisissez une fenêtre contenant la vue Modèle de présentation de l'Editeur de modèle.

•	Dans le Navigateur d'objet, cliquez deux fois sur l'icône du noeud Modèle de présentation d'un modèle.


Zone de coloriage

  Rubriques connexes

La zone de coloriage est la zone dans laquelle vous pouvez modifier des objets tout en visualisant leur représentation graphique à l'écran. Il existe deux zones dans l'Editeur de modèle :

•	corps

•	marge

Pour passer d'une zone à l'autre d'un état, cliquez sur l'icône correspondante dans la barre d'outils.


Corps

Les caractéristiques de mise en forme (telles que police et couleur) des objets de la zone du corps d'un modèle sont héritées par les objets de la zone du corps de tout état auquel vous appliquez ce modèle. Les objets de la zone du corps d'un modèle sont des variables mises pour les types d'objets qui apparaîtront dans une présentation d'état de ce style.


Marge

Les objets de la zone de marge d'un modèle seront importés dans la zone de marge de tout état auquel vous appliquez ce modèle; Vous pouvez définir dans la marge du texte, des graphiques et des champs dont la source est un paramètre système (par exemple, la date en cours ou le numéro de page).


Styles d'état

Pour faire passer la zone du corps d'une vue à une autre des différents styles d'état, utilisez la liste des styles d'état dans la partie supérieure de l'Editeur de modèle.


Représentation des objets

Les objets du corps ne sont proposés que comme exemples de l'application des attributs visuels aux objets d'un état. Les objets de la zone de marge apparaîtront dans l'état comme ils apparaissent dans le modèle. Pour visualiser ou modifier les paramètres d'un objet, affichez la palette de propriétésc_ppinvoke.


Règles

Les règles se trouvent sur les bords gauche et supérieur de la zone de coloriage. Elles apparaissent initialement dans la vue Modèle de présentation. Pour masquer les règles, désactivez l'option Règles du menu Affichage. Lorsque vous modifiez la propriété Unité de mesure d'un modèle (en cliquant deux fois sur l'icône de modèle du Navigateur d'objet), les unités de la règle sont mises à jour pour refléter la nouvelle unité de mesure. Lorsque vous attribuez la valeur Yes à la propriété Concevoir en unités caractères, les unités de la règle sont changées en cellules caractère.

Repères  Les repères se déplacent le long des deux règles pour suivre l'emplacement de votre curseur dans la zone de coloriage. Les règles défilent avec la zone de coloriage. De même, lorsque vous agrandissez une partie de la zone de coloriage, les règles sont mises à jour pour refléter cet agrandissement.

Guides de règles  Les guides de règles vous donnent un point de référence pour la création et la modification des objets. Pour créer un guide de règle, cliquez sur l'une des règles et faites glisser le curseur dans la zone de coloriage. Pour supprimer un guide de règle, faites-le glisser vers la règle. Pour masquer tous les guides de règles, désactivez l'option Guides du menu Affichage. Pour afficher les règles et leurs guides, sélectionnez les options de menu correspondantes.


Grille

A l'intérieur de la zone de coloriage se trouve une grille destinée à vous aider dans le positionnement des objets dans la zone de coloriage. Cette grille est tracée en relation avec les règles. A partir de la boîte de dialogue Règles, indiquez l'intervalle selon lequel les lignes de grille apparaissent en fonction des unités de la grille. Par exemple, si l'unité est le pouce et que l'espacement de la grille est de 0,5, vous aurez une ligne de grille par demi-pouce sur la règle.


Barre d'état

Dans la vue Modèle de présentation, la barre d'état affiche les informations suivantes :

•	position absolue de la souris (en pixels, pouces ou centimètres)

•	déplacement de la souris (en pixels, pouces ou centimètres)

•	angles de rotation

•	niveaux de zoom

•	pourcentages d'ancrage


Packages intégrés - Exemples

  Rubriques connexes 	  Tous les exemples

Package intégré Report Builder - Exemples

Autres packages intégrés Oracle - Exemples


Packages intégrés Report Builder - Exemples

  Rubriques connexes 	  Tous les exemples

Un seul package intégré Report Builder existe :

SRW


Package intégré SRW - Exemples

  Rubriques connexes 	  Tous les exemples

SRW.SET_HYPERLINK dynamique - Exemple

SRW.SET_LINKTAG dynamique - Exemple

SRW.CONTEXT_FAILURE - Exemple

SRW.DO_SQL - Exemple

SRW.DO_SQL_FAILURE - Exemple

SRW.GET_PAGE_NUM - Exemple

SRW.GETERR_RUN - Exemple

SRW.INTEGER_ERROR - Exemple

SRW.MAXROW_INERR - Exemple

SRW.MESSAGE - Exemple

SRW.NULL_ARGUMENTS - Exemple

SRW.PROGRAM_ABORT - Exemple

SRW.REFERENCE - Exemple

SRW.RUN_REPORT - Exemple

SRW.RUN_REPORT_BATCHNO - Exemple

SRW.RUN_REPORT_FAILURE - Exemple

SRW.SET_ATTR

SRW.SET_AFTER_PAGE_HTML - Exemples

SRW.SET_AFTER_REPORT_HTML - Exemples

SRW.SET_DISPLAY_NAME - Exemple

SRW.SET_FIELD_CHAR - Exemple

SRW.SET_FIELD_DATE - Exemple

SRW.SET_FIELD_NUM - Exemple

SRW.SET_HYPERLINK - Exemple

SRW.SET_HYPERLINK_ATTRS - Exemple

SRW.SET_LINKTAG - Exemple

SRW.SET_MAXROW - Exemple

SRW.SET_PDF_ACTION - Exemple

SRW.SET_PRINTER_TRAY - Exemple

SRW.UNKNOWN_QUERY - Exemple

SRW.UNKNOWN_USER_EXIT - Exemple

SRW.USER_EXIT - Exemple

SRW.USER_EXIT_FAILURE - Exemple


SRW.SET_ATTR

  Rubriques connexes	  Tous les exemples

Mode caractère de SRW.SET_ATTR - Exemple

Masque de format de SRW.SET_ATTR - Exemple

Définition de la couleur du champ SRW.SET_ATTR - Exemple

Définition du texte du champ SRW.SET_ATTR - Exemple

Définition de l'espacement vertical de SRW.SET_ATTR - Exemple

Lien Web - Exemples


Interface Call - Exemples

  Rubriques connexes 	  Tous les exemples

Ada - Exemple

C - Exemple

COBOL - Exemple

FORTRAN - Exemple

Pascal - Exemple

PL/I - Exemple


Diffusion - Exemples

  Rubriques connexes 	  Tous les exemples

Fichier .DST - Exemple


Modèle de données - Exemple

  Rubriques connexes 	  Tous les exemples

Ordre de ventilation - Exemples

Colonne - Exemples

Liaison de données - Exemples

Groupe - Exemples

Matrice - Exemple

Interrogation - Exemples


Ordre de ventilation - Exemples

  Rubriques connexes 	  Tous les exemples

Ordre de ventilation (descendant) - Exemple

Ordre de ventilation (ORDER BY) - Exemple


Colonne - Exemples

  Rubriques connexes 	  Tous les exemples

Colonne de formule

Formule d'ajout de données - Exemple

Formule conditionnelle - Exemple

PL/SQL (référence à une fonction PL/SQL dans les formules) - Exemple

Product Order (formule) - Exemple

Lecture depuis fichier (colonne de formule) - Exemple

Colonne récapitulative

Calculer à (état de groupe) - Exemple

Calculer à (état matriciel) - Exemple

Product Order (plusieurs groupes) - Exemple

Product Order (groupe unique) - Exemple


Groupe - Exemples

  Rubriques connexes 	  Tous les exemples

Dimension fils (définie sur Non) - Exemple

Dimension fils (définie sur Oui) - Exemple

Type de filtre - Exemple

Balise XML externe - Exemple

Attributs XML externes - Exemple

Remise à (groupe) - Exemple

Balise XML - Exemple

Attributs de balise XML (niveau groupe) - Exemple


Liaison de données - Exemples

  Rubriques connexes 	  Tous les exemples

Liaison START WITH - Exemple

Liaison de clause WHERE - Exemple


Interrogation - Exemples

  Rubriques connexes 	  Tous les exemples

Exemples d'interrogations SQL

Référence de lien - Exemples

Référence lexicale - Exemples

Lecture depuis fichier (image) - Exemple

Instruction SELECT INTO - Exemple

Instruction SELECT (première interrogation, plusieurs états Au-dessus du groupe) - Exemple

Instruction SELECT (matrice imbriquée) - Exemple

Instruction SELECT (seconde interrogation, plusieurs états Au-dessus du groupe) - Exemple

Instruction SELECT avec référence de paramètre - Exemple

Instruction SELECT avec clause WHERE - Exemple

Instruction d'interrogation SQL - Exemple

Instruction d'interrogation SQL avec référence de lien et référence lexicale - Exemple

Instruction d'interrogation SQL avec référence lexicale - Exemple

Exemples d'interrogation avec curseur de référence

Package avec curseur de référence et fonction - Exemple

Package avec curseur de référence - Exemple

Fonction d'appel de l'interrogation de curseur de référence - Exemple

Interrogation de curseur de référence - Exemple


Messagerie - Exemples

  Rubriques connexes 	  Tous les exemples

Mode de traitement par lots de la messagerie MAPI (Windows) (nom de destinataire contenant une apostrophe) - Exemple

Mode de traitement par lots de la messagerie MAPI (Windows) (nom et prénom des destinataires) - Exemple

Messagerie MAPI (Windows) (nom de destinataire contenant une apostrophe) - Exemple

Messagerie MAPI (Windows) (nom et prénom des destinataires) - Exemple

Messagerie Oracle*Mail (UNIX) (plusieurs destinataires) - Exemple


Express - Exemples

  Rubriques connexes 	  Tous les exemples

RWBLD60 - Exemples

EXPRESS_SERVER avec ID utilisateur, mot de passe et domaine - Exemple

EXPRESS_SERVER sans ID utilisateur, mot de passe ni domaine - Exemple

RWRUN60 - Exemples

EXPRESS_SERVER avec ID utilisateur, mot de passe et domaine - Exemple

EXPRESS_SERVER sans ID utilisateur, mot de passe ni domaine - Exemple


Modèle de présentation - Exemples

  Rubriques connexes 	  Tous les exemples

Point d'ancrage - Exemples

Texte standard - Exemples

Graphique - Exemple

Objet de présentation courants - Exemples

Champ - Exemples

Encadrements et encadrements itératifs - Exemples

Fichier de liaison - Exemples


Objet de présentation courant - Exemples

  Rubriques connexes 	  Tous les exemples

Protection de page

Protection de page (état de groupe) - Exemple

Protection de page (objet volumineux) - Exemple

Protection de page (petit objet) - Exemple

Elasticité verticale

Elasticité verticale (développer) - Exemple

Elasticité verticale (variable) - Exemple

Lien Web

Lien Web - Exemples


Point d'ancrage - Exemples

  Rubriques connexes 	  Tous les exemples

Centrage horizontal des champs - Exemple

Centrage vertical des champs - Exemple

Réduire verticalement et horizontalement (champ) - Exemple

Réduire verticalement (champ) - Exemple

Objet solidaire - Exemple


Texte standard - Exemples

  Rubriques connexes 	  Tous les exemples

Etirement de ligne avec encadrement (grille) - Exemple

Nbre min de lignes veuves (défini sur 1 ou 2) - Exemple

Sortie d'ObjectWidth et d'ObjectHeight en HTML - Exemple

Activation de l'objet d'impression (débordement) - Exemple

Lien Web - Exemples


Champ - Exemples

  Rubriques connexes 	  Tous les exemples

Masques de format - Exemples

Références de champs masqués - Exemple

Elasticité horizontale (champ) - Exemple

Numérotation de pages (Page N de Total) - Exemple

Numérotation de pages (pages du corps) - Exemple

Numérotation de pages (instances d'encadrement itératif) - Exemple

Source - Exemple

Lien Web - Exemples


Fichier de liaison - Exemples

  Rubriques connexes 	  Tous les exemples

Activation de l'objet d'impression (tout) - Exemple

URL (liaison vers une image) - Exemple


Encadrements et encadrements itératifs - Exemples

  Rubriques connexes 	  Tous les exemples

Mode colonne - Exemple

Elasticité horizontale (encadrement) - Exemple

Nbre max d'enregistrements par page - Exemple

Nbre min de lignes veuves - Exemple

Protection de page (état de groupe) - Exemple

Orientation d'impression (Gauche-droite/Vers le bas) - Exemple

Code d'impression (police spéciale) - Exemple


Impression - Exemples

  Rubriques connexes 	  Tous les exemples

Exemples de configuration de la palette de propriétés

Panneaux verticaux/horizontaux par page - Exemple

Orientation d'impression (Gauche-droite/Vers le bas) - Exemple

Objet d'impression activé (tout) - Exemple

Objet d'impression activé (débordement) - Exemple

Exemples de définition de l'imprimante

dec180.prt - Exemple

declno3.prt - Exemple

dflt.prt - Exemple

hplwide.prt - Exemple

psport85.prt - Exemple

Exemples relatifs à l'imprimante

Code d'impression (police spéciale) - Exemple

PRINTER_INTRAY - Exemple

SRW.SET_ATTR (changement de bac d'imprimante) - Exemple

SRW.SET_PRINTER_TRAY - Exemple


Exemples

  Liste alphabétique

Packages intégrés - Exemples

Interface d'appel - Exemples

Modèle de données - Exemples

Diffusion - Exemples

Messagerie - Exemples

Express - Exemples

Substitution de polices - Exemple

Commandes de l'Interpreter - Exemples

Modèle de présentation - Exemples

Oracle8 - Exemples

Grille de paramètres - Exemples

Conversion PL/SQL V1 - Exemples

Impression - Exemples

Query Builder - Exemples

Déclencheur - Exemples

Sortie utilisateur - Exemples

Etat Web - Exemples

XML - Exemples


Déclencheur - Exemples

  Rubriques connexes 	  Tous les exemples

Déclencheur d'état - Exemples

Déclencheur de données - Exemples

Déclencheur de présentation - Exemples


Déclencheur d'état - Exemples

  Rubriques connexes 	  Tous les exemples

Déclencheur Between Pages

SRW.SET_PRINTER_TRAY

Procédures de définition d'attributs

SRW.SET_BEFORE_REPORT_HTML - Exemple

SRW.SET_AFTER_REPORT_HTML - Exemple

SRW.SET_BEFORE_PAGE_HTML - Exemple

SRW.SET_AFTER_PAGE_HTML - Exemple

SRW.SET_BEFORE_FORM_HTML - Exemple

SRW.SET_AFTER_FORM_HTML - Exemple

SRW.SET_ATTR (préversion 2.1 pour la compatibilité descendante)

Echappement Avant et Après page - Exemple

Echappement Avant et Après état - Exemple

Séparateur de page graphique - Exemple

Liaisons vers les pages d'accueil - Exemple


Déclencheur de données - Exemples

  Rubriques connexes 	  Tous les exemples

Filtre de groupe

Filtre de groupe - Exemple

Interrogation avec curseur de référence

Package avec curseur de référence - Exemple

Package avec curseur de référence et fonction - Exemple

Curseur de référence - Exemple

Interrogation de curseur de référence - Exemple

Fonction d'appel de l'interrogation de curseur de référence - Exemple

Formules

Formule d'ajout de données - Exemple

Formule conditionnelle - Exemple

Déclencheur de validation

Déclencheur de validation - Exemple


Déclencheur de présentation - Exemples

  Rubriques connexes 	  Tous les exemples

Déclencheur d'action

Déclencheur d'action - Exemple

Déclencheur de format

Déclencheur de format (sélection d'une valeur) - Exemple

Déclencheur de format (positionnement d'un élément Commun entre les fichiers) - Exemple

Déclencheur de format (suppression de libellés) - Exemple

Déclencheur de format (suppression de valeurs) - Exemple

Déclencheur de format (insertion de lignes vierges entre des groupes de lignes) - Exemple

Mode caractère de SRW.SET_ATTR - Exemple

Masque de format de SRW.SET_ATTR - Exemple

Définition de la couleur du champ SRW.SET_ATTR - Exemple

Définition du texte du champ SRW.SET_ATTR - Exemple

Espacement vertical de SRW.SET_ATTR - Exemple

Lien Web de SRW.SET_ATTR - Exemples

Procédures de définition d'attributs

SRW.SET_BOOKMARK dynamique - Exemple

SRW.SET_HYPERLINK dynamique - Exemple

SRW.SET_LINKTAG dynamique - Exemple

SRW.SET_BOOKMARK - Exemple

SRW.SET_HYPERLINK - Exemple

SRW.SET_LINKTAG - Exemple

SRW.SET_PDF_ACTION - Exemple


Sorties utilisateur - Exemples

  Rubriques connexes 	  Tous les exemples

Sortie utilisateur totale - Exemple

SRW.USER_EXIT - Exemple

SRW.USER_EXIT_FAILURE - Exemple

SRW.USER.UNKNOWN_USER_EXIT - Exemples

Sortie utilisateur - Exemple

Appel de sortie utilisateur - Exemples


Etat Web - Exemples

  Rubriques connexes 	  Tous les exemples

Configuration de la palette de propriétés - Exemples

Procédures de définition des attributs - Exemples

SRW.SET_ATTR - Exemples (préversion 2.1 pour la compatibilité descendante)


Configuration de la palette de propriétés - Exemples

  Rubriques connexes 	  Tous les exemples

Liens Web

Lien Web - Exemples

Document HTML, en-têtes et pieds de page

Valeur Après page (insertion de GIF) - Exemple

Valeur Après état (ajout de texte) - Exemple

Valeur Après état (liens vers les pages d'accueil) - Exemple

Valeur Avant page - Exemple

Valeur Avant état - Exemple

Grille de paramètres HTML

Valeur Après formulaire (ajout de texte) - Exemple

Valeur Avant formulaire - Exemple

Objet texte standard - Exemple

Entrée par défaut en majuscules - Exemple

Validation de l'entrée de données - Exemple

Validation de la sélection - Exemple


Liens Web (palette de propriétés) - Exemples

  Rubriques connexes 	  Tous les exemples

Ligne de commande d'application

Ligne de commande d'application - Exemple

Signet

Signet (chaîne de signets dynamique) - Exemple

Signet (indentation/classement) - Exemple

Signet (liste de signets classés) - Exemple

Signet (liste de signets classés avec mise en retrait) - Exemple

Signet (chaîne de signets statique) - Exemple

Hyperlien

Hyperlien graphique - Exemple

Attributs d'hyperlien supplémentaire - Exemples

Hyperlien (dynamique) - Exemple

Hyperlien (hyperlien vers un document HTML sur un serveur à distance) - Exemple

Hyperlien (hyperlien vers un script sur un serveur à distance) - Exemple

Hyperlien (statique) - Exemple

Destination d'hyperlien

Destination d'hyperlien (dynamique) - Exemple

Destination d'hyperlien (statique) - Exemple


Procédures de définition d'attributs - Exemples

  Rubriques connexes Related Topics 	  Tous les exemples

Exemples de lien Web

Lien Web - Exemples

Exemples de document HTML, en-têtes et pieds de page

SRW.SET_AFTER_PAGE_HTML - Exemple

SRW.SET_AFTER_REPORT_HTML - Exemple

SRW.SET_BEFORE_PAGE_HTML - Exemple

SRW.SET_BEFORE_REPORT_HTML - Exemple

Exemples d'en-têtes et pieds de page de grille de paramètres HTML

SRW.SET_AFTER_FORM_HTML - Exemple

SRW.SET_BEFORE_FORM_HTML - Exemple


Lien Web (définition d'attributs) - Exemples

  Rubriques connexes 	  Tous les exemples

SRW.SET_PDF_ACTION

SRW.SET_PDF_ACTION - Exemple

SRW.SET_BOOKMARK

SRW.SET_BOOKMARK dynamique - Exemple

SRW.SET_BOOKMARK - Exemple

SRW.SET_HYPERLINK

SRW.SET_HYPERLINK dynamique - Exemple

SRW.SET_HYPERLINK - Exemple

SRW.SET_LINKTAG

SRW.SET_LINKTAG dynamique - Exemple

SRW.SET_LINKTAG - Exemple


SRW.SET_ATTR (préversion 2.1 pour la compatibilité descendante) - Exemples

  Rubriques connexes 	  Tous les exemples

Exemples de lien Web

Lien Web - Exemples

Exemples de document HTML, en-têtes et pieds de page

Echappement Avant et Après page - Exemple

Echappement Avant et Après état - Exemple

Liaisons vers les pages d'accueil - Exemples


Lien Web (SRW.SET_ATTR) - Exemples

  Rubriques connexes 	  Tous les exemples

ACTION

ACTION - Exemple

BOOKMARK

BOOKMARK - Exemple

BOOKMARK dynamique - Exemple

HYPERLINK

HYPERLINK dynamique - Exemple

HYPERLINK - Exemple

LINKTAG

LINKTAG dynamique - Exemple

LINKTAG - Exemple


XML - Exemples

  Rubriques connexes 	  Tous les exemples

Propriétés XML - Exemples

Exclure de la sortie XML (limitation de la sortie de données) - Exemple

Exclure de la sortie XML (limitation des redondances) - Exemple

Contient références XML - Exemple

Attributs XML externes - Exemple

Balise XML externe - Exemple

Valeur du prologue XML (type de prologue : fichier) - Exemple

Valeur du prologue XML (type de prologue : texte) - Exemple

Attributs de balise XML (niveau groupe) - Exemple

Attributs de balise XML (niveau état) - Exemple

Balise XML - Exemple


Noms d'exécutable

  Rubriques connexes

Les lettres ajoutées aux noms d'exécutable énumérés ci-dessus indiquent si le mode Interface graphique de l'exécutable est différent de l'interface graphique native. Par exemple, "a" indique le mode Interface graphique Apple MacIntosh et "m" le mode Interface graphique Motif. (L'absence de lettre correspond à l'Interface graphique native.) En outre, "x" indique si les sorties utilisateur sont liées à l'exécutable.


Appel d'exécutables

  Rubriques connexes

Les exécutables peuvent être appelés de deux façons différentes :

•	dans la ligne de commande,

•	en cliquant deux fois sur l'icône de l'exécutable.

Arguments d'exécutable Lorsque vous appelez un exécutable, vous pouvez entrer des arguments qui gèrent son comportement. Si vous appelez l'exécutable dans la ligne de commande, entrez ses arguments dans la ligne de commande, après le nom de l'exécutable.


Aide sur les options de la ligne de commande

  Rubriques connexes

Dans une ligne de commande, vous pouvez visualiser les options de la ligne de commande d'un exécutable en tapant le nom de cet exécutable, un blanc et un point d'interrogation, puis en appuyant sur Retour. Par exemple, rwrun60 "?".

Remarque : Dans certains systèmes d'exploitation, des guillemets avant et après le point d'interrogation sont obligatoires. Par exemple, pour visualiser les options de la ligne de commande de l'exécutable RWRUN60, dans le shell UNIX C, vous devez entrer rwrun60 "?".


Syntaxe des exécutables - Restrictions

  Rubriques connexes

•	Lorsque vous entrez un exécutable dans la ligne de commande, il se présente généralement sous la forme :

nom d'exécutable  mot-clé1=valeur1  mot-clé2=valeur2 ...

•	En cas d'absence de ligne de commande (systèmes d'exploitation Apple Macintosh ou Windows, par exemple), si vous appelez l'exécutable par une icône, une boîte de dialogue intermédiaire peut s'afficher pour vous permettre d'entrer les valeurs des arguments de l'exécutable ; sinon, vous devez utiliser l'onglet Valeurs d'exécution et Paramètres d'exécution de la boîte de dialogue Préférences (Outils [image] Préférences) pour entrer les arguments de l'exécutable.

•	Chaque couple mot-clé=valeur correspond à un argument d'exécutable. Pour éviter d'alourdir le programme, les mots-clés peuvent être omis.

•	Le signe égal d'un argument ne doit être ni précédé ni suivi de blancs.

•	Les arguments doivent être séparés par des blancs, et non par des virgules.

•	Les valeurs des arguments peuvent être entre guillemets simples ou doubles, selon le système d'exploitation utilisé.

•	La partie mot-clé= de tous les arguments peut être indiquée indifféremment en majuscules ou en minuscules. La partie valeur des arguments SOURCE, DEST, CMDFILE, TERM, DESNAME, DESFORMAT, DNAME et SNAME peut devoir être indiquée soit en majuscules, soit en minuscules, en fonction pour votre système d'exploitation. La partie valeur de tous les autres arguments peut être indiquée soit en minuscules, soit en majuscules.

•	Les mots-clés peuvent parfois être omis.

•	Pour transmettre un guillemet simple à partir de la ligne de commande, vous devez en entrer deux (un comme caractère d'échappement et un comme véritable guillemet).

Rwrun60 module=myrep destype=file desname=run.out batch=yes
p_value="Roy''s Batch Report"

Pour transmettre une valeur de paramètre ne comportant qu'un guillemet, en utilisant la procédure en package RUN_PRODUCT de Forms, vous devez entrer quatre guillemets simples (PL/SQL réduit deux guillemets simples en un, seul, tout comme Report Builder). Par exemple, si vous voulez transmettre à un paramètre de Reports la valeurs littérale :

where '='

vous devez entrer dans RUN_PRODUCT la chaîne :

'where ''''='''''

•	Pour donner à la valeur d'un argument une chaîne vide, entrez mot-clé= ou mot-clé="". Si vous choisissez cette solution pour entrer une chaîne vide, la grille des paramètres d'exécution affichera une chaîne vide pour l'argument, au lieu de sa valeur initiale.

•	Les noms de chemin d'accès complets sont acceptés pour toutes les références de fichier (par exemple, desname=/recettes/q1/ventes). Si vous n'indiquez pas le chemin d'accès complet, l'ordre de recherche de chemin d'accès est utilisé pour trouver le fichier. Remarque : afin d'assurer la portabilité des états, utilisez la variable d'environnement REPORTS60_PATH pour référencer les états, les interrogations externes, les bibliothèques PL/SQL externes, les fichiers texte, les graphiques, etc. La variable REPORTS60_PATH permet d'accéder aux fichiers stockés hors de Report Builder ou de Reports Runtime, sans devoir coder en dur les chemins de répertoire dans l'état.

•	Les valeurs entrées à partir de la grille de paramètres d'exécution remplacent celles entrées dans la ligne de commande. Par exemple, si vous indiquez RWRUN60 dans la ligne de commande, avec COPIES égal à 1, alors que avez indiqué COPIES égal à 2 dans la Grille de paramètres d'exécution, le système générera deux copies de l'état.

De même, les valeurs entrées dans la ligne de commande remplacent les valeurs indiquées dans les fichiers de commande. Supposons, par exemple, que vous indiquiez RWRUN60 dans la ligne de commande avec COPIES égal à 1 et CMDFILE égal à RUNONE (fichier de commandes). Dans RUNONE, COPIES est défini à 2 par une commande RWRUN60. Dans ce cas, le système ne générera qu'une copie de l'état.

Vous pouvez indiquer des valeurs pour DESTYPE, DESNAME, DESFORMAT, ORIENTATION et COPIES en différents endroits. La liste ci-dessous indique l'ordre de priorité des endroits où vous pouvez indiquer ces valeurs. Le premier élément de liste a priorité sur tous les autres, le deuxième a priorité sur tous les autres sauf le premier, et ainsi de suite :

•	Boîte de dialogue d'impression

•	Grille de paramètres d'exécution

•	Onglet Paramètres d'exécution/Options de la boîte de dialogue d'options d'outil ou d'options d'exécution

•	Mots-clés de la ligne de commande

•	Valeurs indiquées dans la définition de l'état

•	Boîte de dialogue de choix d'imprimante.


Utilisation des mots-clés

La partie mot-clé= de chaque argument est facultative, dans la mesure où les arguments sont entrés dans l'ordre indiqué par la syntaxe. Si vous omettez l'un des arguments, vous devez utiliser des mots-clés après l'argument omis.

Si un exécutable comporte quatre arguments, mais que vous vouliez n'indiquer que le premier, le deuxième et le quatrième, vous pouvez n'indiquer que les deux premiers arguments sans  mot-clé, mais vous devrez indiquer le mot-clé du quatrième, car vous ne l'entrez pas dans l'ordre indiqué par la syntaxe.

Exemples (valides) :

Exemples de séquence de ligne de commande valide :

rwrun60 userid=scott/tiger paramform=no destype=mail
  desname=rmiller

rwrun60 scott/tiger no destype=mail desname=rmiller

Notez que, dans cet exemple, lorsque le mot-clé DESTYPE est utilisé, tous les arguments suivants utilisent eux aussi des mots-clés. Une fois que vous avez entré un mot-clé, le reste des arguments de la ligne de commande doit également utiliser des mots-clés.

Exemples (non valides) :

Exemples de séquence de ligne de commande non valide :

rwrun60 paramform=no scott/tiger destype=mail
  desname=rmiller

La séquence ci-dessus n'est pas valide car scott/tiger n'a pas été entré à l'endroit voulu et ne comporte pas le mot-clé USERID.

Rwrun60 scott/tiger mail rmiller no

La séquence ci-dessus n'est pas valide, car la valeur NO a été entrée à un emplacement autre que celui prévu par la syntaxe, et sans le mot-clé PARAFORM.


Connexion à la base de données

  Rubriques connexes

Vous pouvez vous connecter à une base de données par :

•	Connexion explicite

•	Connexion automatique

•	Connexion à distance


Connexion explicite

Pour vous connecter explicitement à la base de données, utilisez le mot-clé USERID ou choisissez Fichier [image] Connecter.


USERID

Description  Votre USERID est votre nom utilisateur et votre mot de passe ORACLE, associés à un nom de base de données (facultatif), au protocole de communication Net8 servant à accéder à une base de données distante ou à un nom de source de données ODBC (dans le cas d'un accès à une source de données non-Oracle).

Pour plus d'informations sur le protocole de communication Net8 optionnel, reportez-vous à la rubrique Connexion à distance. Pour plus d'informations sur la connexion automatique, reportez-vous à la rubrique Connexion automatique.

Valeurs

La chaîne de connexion à la base de données doit prendre l'une des formes indiquées ci-après, mais elle ne peut pas avoir plus de 512 octets de long :

nom_utilisateur[/mot_passe]

nom_utilisateur[/mot_passe][@base_données]

[utilisateur[/mot_passe]]@ODBC:source_données[:base_données] ou [utilisateur[/mot_passe]]@ODBC:*


Connexion automatique

La fonction ORACLE de connexion automatique vous permet de vous connecter à la base de données sans fournir explicitement ni nom utilisateur ni mot de passe.

Si vous choisissez ce type de connexion, ORACLE utilise une connexion par défaut (par exemple, OPS$) pour associer votre nom utilisateur ORACLE à votre nom utilisateur du système d'exploitation. Pour appeler une procédure de connexion automatique, vous avez le choix entre trois possibilités :

•	Entrer rwconv60 / sur la ligne de commande.

•	Entrer une barre oblique (/) comme nom utilisateur dans l'écran de connexion

•	Omettre votre nom utilisateur et votre mot de passe dans la ligne de commande et appuyer deux fois sur la touche Retour ou Entrée lorsque l'écran de connexion apparaît.

Remarque : Lorsque vous utilisez ce type de connexion, vous pouvez accéder à une connexion à distance en entrant @base de données après la barre oblique.

Pour plus d'informations sur les connexions par défaut, reportez-vous à ORACLE8 Server SQL Language Reference Manual.


Connexion à distance

Net8 vous permet d'indiquer une base de données éloignée (c'est-à-dire qui ne réside pas sur votre ordinateur). Lorsque vous utilisez la fonction de connexion à distance, la base de données éloignée est transparente pour vous. Pour plus d'informations, reportez-vous à la documentation d'Oracle Net8.

Notes d'utilisation

•	Pour exécuter une connexion à distance, vous devez avoir un compte sur le noeud de l'ordinateur éloigné sur lequel réside la base de données cible.


RWBLD60

 Arguments de ligne de commande 	  Rubriques connexes

Description  RWBLD60 appelle Report Builder pour créer et tenir à jour des états.

Syntaxe

RWBLD60 [ [mot-clé=]valeur ] ...

où mot-clé = valeur représente un argument de ligne de commande valide.


Arguments de la ligne de commande de RWBLD60

[MODULE|REPORT=]nom_de_module

[USERID=]userid

[PARAMFORM=]{YES|NO}

[CMDFILE=]nom de fichier

[ARRAYSIZE=]n

[DESTYPE=]{SCREEN|FILE|PRINTER|PREVIEW|MAIL}

[DESNAME=]desname

[DESFORMAT=]desformat

[COPIES=]n

[CURRENCY=] symbole monétaire

[THOUSANDS=] séparateur des milliers

[DECIMAL=] symbole décimal

[READONLY=]{YES|NO}

[BUFFERS=]n

[PAGESIZE=]width x height

[PROFILE=]profiler_file

[RUNDEBUG=]{YES|NO}

[ONSUCCESS=]{COMMIT|ROLLBACK|NOACTION}

[ONFAILURE=]{COMMIT|ROLLBACK|NOACTION}

[ERRFILE=]error_file

[LONGCHUNK=]n

[ACCESS=]{file|database}

[ORIENTATION=]{DEFAULT|LANDSCAPE|PORTRAIT}

[BACKGROUND=]{YES|NO}

[MODE=]{BITMAP|CHARACTER|DEFAULT}

[PRINTJOB]{YES|NO}

[TRACEFILE=]tracefile

[TRACEMODE=]{TRACE_APPEND|TRACE_REPLACE}

[TRACEOPTS=]{TRACE_ERR|TRACE_PRF|TRACE_BRK|TRACE_APP|
TRACE_PLS|TRACE_SQL|TRACE_TMS|TRACE_DST|TRACE_ALL|(opt1, opt2,...)}

[AUTOCOMMIT=]{YES|NO}

[NONBLOCKSQL=]{YES|NO}

[ROLE=]rolename/[rolepassword]

[BLANKPAGES=]{YES|NO}

[MAXIMIZE=]{YES|NO}

[DISABLEPRINT=]{YES|NO}

[DISABLEMAIL=]{YES|NO}

[DISABLEFILE=]{YES|NO}

[DISABLENEW=]{YES|NO}

[DISTRIBUTE=]{YES|NO}

[DESTINATION=]filename.DST

[CACHELOB=]{YES|NO}

[DELIMITER=]value

[CELLWRAPPER=]value

[NUMBERFORMATMASK=]mask

[DATEFORMATMASK=]mask

[PAGESTREAM=]{YES|NO}

[EXPRESS_SERVER=]"server=[server]/domain=[domain]/user=[userid]/password=[passwd]"

[CUSTOMIZE]=filename.xml | (filename1.xml, filename2.xml, . . .)

[SAVE_RDF]=filename.rdf

<param>=value


MODULE/REPORT
MODULE|REPORT

  Présentation de RWBLD60

Description  MODULE|REPORT indique le module (état, interrogation externe ou bibliothèque PL/SQL externe) que vous voulez ouvrir dans Report Builder. (REPORT est autorisé pour des raisons de compatibilité descendante). Si vous n'indiquez pas d'état à l'aide de MODULE/REPORT, Report Builder commence à s'exécuter avec une nouvelle définition d'état ouverte.

Syntaxe

[MODULE|REPORT=]runfile

Valeurs

Tout nom d'état, définition d'état XML (fichier .XML), interrogation externe ou nom de bibliothèque PL/SQL externe valide. Report Builder recherche le module à l'emplacement indiqué par le mot-clé ACCESS. Si ACCESS est omis, Report Builder utilise son ordre de recherche de chemin d'accès aux fichiers. S'il ne trouve pas le module, Report Builder commence à s'exécuter sans ouvrir le module indiqué.

Notes d'utilisation

•	Si vous ouvrez un état en mode caractère à l'aide de RWBLD60 en mode bitmap, Report Builder affiche un message d'avertissement, puis ouvre l'état en utilisant le format de page 8.5" x 11" et la taille de grille de 7" x 6".

•	Pour que vous puissiez exécuter l'état (par exemple, l'afficher dans la vue Aperçu interactif), sa définition doit être complète (elle doit contenir son propre modèle de données et sa propre définition de présentation). Vous ne pouvez pas exécuter une définition d'état partielle.

•	Une définition d'état XML doit porter l'extension de fichier .XML lorsqu'elle est indiquée avec le mot-clé MODULE|REPORT.


PARAMFORM

  Présentation de RWBLD60

Description  PARAMFORM indique si la grille de paramètres d'exécution doit être affichée lorsque vous exécutez un état.

Syntaxe

[PARAMFORM=]{YES|NO}

Valeurs

YES demande d'afficher la grille.

NO demande de supprimer la grille.

Valeur par défaut

YES


CMDFILE

  Présentation de RWBLD60

Description  CMDFILE indique un fichier qui contient les arguments de la commande RWBLD60. Cette option vous permet d'exécuter un état sans indiquer de nombreux arguments chaque fois que vous appelez RWBLD60.

Syntaxe

[CMDFILE=]cmdfile

Valeurs

Tout fichier de commandes valide.

Notes d'utilisation

•	Un fichier de commandes peut faire référence à un autre fichier de commandes.

•	La syntaxe des fichiers de commande pour les arguments RWBLD60 est identique à celle de la ligne de commande.

•	Les valeurs entrées dans la ligne de commande remplacent celles indiquées dans les fichiers de commande. Ainsi, si vous entrez RWBLD60 dans la ligne de commande, définissez COPIES égal à 1 et CMDFILE égal à RUNONE (un fichier de commande), et dans RUNONE, définissez COPIES à 2, le système ne générera qu'une copie de l'état. Pour plus d'informations, reportez-vous à Restrictions de syntaxe des exécutables.

•	Le ou les arguments de ce mot-clé peuvent dépendre du système d'exploitation.


ARRAYSIZE

  Présentation de RWBLD60

Description  ARRAYSIZE indique, en kilo-octets, la taille du tableau à utiliser pour le traitement des tableaux Oracle.

Syntaxe

[ARRAYSIZE=]n

Valeurs

Tout nombre compris entre 1 et 9999, ce qui correspond à la taille de mémoire que Report Builder peut utiliser pour chaque interrogation dans votre état.

Valeur par défaut

La taille du tableau par défaut est de 10. Pour tout détail sur le traitement des tableaux Oracle, reportez-vous à Oracle8 Server Administrator's Guide.


DESTYPE

  Présentation de RWBLD60

Description  DESTYPE indique le type d'unité de destination de la sortie de l'état.

Syntaxe

[DESTYPE=]{SCREEN|FILE|PRINTER|PREVIEW|MAIL}

Valeurs

SCREEN	Transmet la sortie à l'Aperçu
FILE	Enregistre la sortie dans le fichier indiqué dans DESNAME.
PRINTER	Transmet la sortie à l'imprimante indiquée dans DESNAME.
PREVIEW	Transmet également la sortie à l'Aperçu pour une visualisation interactive. Cependant, l'Aperçu déclenche la mise en forme de la sortie en Postcript. Il utilise DESNAME pour déterminer les polices d'imprimante à utiliser pour afficher la sortie.
MAIL	Transmet la sortie aux utilisateurs de messagerie indiqués dans DESNAME. Vous pouvez transmettre la sortie à toute messagerie conforme à MAPI ou dont le pilote de fournisseur de service est installé. L'état est également transmis sous la forme d'un fichier attaché.
Valeur par défaut

Issue de la propriété Valeur initiale du paramètre DESTYPE.

Notes d'utilisation

•	Si vous utilisez RWBLD60, SYSOUT n'est pas une option valide pour DESTYPE. SYSOUT ne peut être utilisé qu'avec RWRUN60 lorsque BATCH=YES.

•	Si vous donnez à DESTYPE la valeur PRINTER, FILE ou MAIL, la boîte de dialogue d'impression de travaux apparaît dès que vous avez accepté la grille de paramètres d'exécution, à moins que celle-ci ne soit supprimée. Une fois que vous avez accepté la boîte de dialogue, l'état est exécuté et la sortie est envoyée à l'imprimante (indiquée dans Fichier [image] Choisir l'imprimante), dans un fichier ou à un ID de courrier électronique. (Si DESTYPE a une valeur autre que PRINTER, FILE ou MAIL, l'état est exécuté dès que vous avez accepté la grille de paramètres d'exécution.) La boîte de dialogue diffère selon les systèmes d'exploitation.

•	Dans certains cas, ce paramètre peut ne pas être pris en compte par votre système d'exploitation.

•	Toutes les valeurs de DESTYPE ne sont pas prises en charge par tous les systèmes d'exploitation.


DESNAME

  Présentation de RWBLD60

Description  DESNAME désigne le nom du fichier, de l'imprimante ou de l'ID courrier électronique (ou de la liste de diffusion) auquel la sortie d'état est envoyée. Pour l'envoyer via courrier électronique, indiquez le destinataire (ID) comme vous le feriez dans votre application de courrier électronique (toute application compatible MAPI sur Windows ou votre application de courrier électronique native sur UNIX). Vous pouvez indiquer plusieurs noms utilisateur en mettant ces noms entre parenthèses et en les séparant par des virgules, de la manière suivante : (nom, nom, . . .nom).

Syntaxe

[DESNAME=]desname

Valeurs

Tout nom de fichier, nom d'imprimante ou ID de courrier électronique valide dont la longueur ne dépasse pas 1 Ko. En ce qui concerne les noms d'imprimante, vous pouvez éventuellement préciser un port. Par exemple :

DESNAME=printer,LPT1:

DESNAME=printer,FILE:

Valeur par défaut

Issue de la propriété Valeur initiale du paramètre DESNAME. Si DESTYPE=FILE et que DESNAME est une chaîne vide, sa valeur par défaut au moment de l'exécution est reportname.lis.

Notes d'utilisation

•	Ce mot-clé n'est pas pris en compte si DESTYPE=SCREEN.

•	SI DESTYPE=PREVIEW, Report Builder détermine, à l'aide de DESNAME, les polices d'imprimante à utiliser pour afficher la sortie.

•	Le ou les arguments de ce mot-clé peuvent faire la distinction entre majuscules et minuscules, selon les systèmes d'exploitation.

•	Dans certains cas, ce paramètre peut ne pas être pris en compte par votre système d'exploitation.


DESFORMAT

  Rubriques connexes	  Présentation de RWBLD60

Description  Dans les environnements en mode bitmap, DESFORMAT désigne le pilote d'imprimante à utiliser lorsque DESTYPE a pour valeur FILE. Dans les environnements en mode caractère, il indique les caractéristiques de l'imprimante indiquée dans DESNAME.

Syntaxe

[DESFORMAT=]desformat

Valeurs

Tout format de destination valide, d'un maximum de 1 K de long. Exemples de valeurs valides pour ce mot-clé : hpl, hplwide, dec, decwide, decland, dec180, dflt, wide, etc.  Demandez à votre administrateur système la liste des formats de destination valides.

PDF	Indique que la sortie de l'état sera envoyée dans un fichier pouvant être lu par un visualiseur PDF . La sortie PDF est fonction de l'imprimante configurée pour votre système. Le pilote de l'imprimante sélectionnée est utilisé pour produire la sortie. Vous devez avoir une imprimante configurée pour la machine sur laquelle vous exécutez l'état.
HTML	La sortie d'état est envoyée vers un fichier lisible par un navigateur compatible HTML 3.0 (par exemple, Netscape 2.2).
HTMLCSS	La sortie d'état envoyée vers un fichier comprend des extensions de feuille de style lisibles par un navigateur compatible HTML 3.0 prenant en charge les feuilles de style en cascade.
HTMLCSSIE	La sortie d'état envoyée vers un fichier comprend des extensions de feuille de style lisibles par Microsoft Internet Explorer 3.x.
RTF	La sortie d'état est envoyée vers un fichier lisible par les logiciels de traitement de texte standard (tels que Microsoft Word). Notez que lorsque vous ouvrez un fichier dans Word, vous devez choisir Affichage [image] Page pour afficher tous les graphiques et les objets de votre état.
DELIMITED	Signifie que la sortie d’état sera envoyée vers un fichier pouvant être lu par les tableurs standard tels que Microsoft Excel. Si vous ne choisissez pas de délimiteur, celui utilisé par défaut est la tabulation.
XML	Signifie que la sortie d'état sera envoyée vers un fichier pouvant être lu par toute application prenant en charge le format XML, y compris les navigateurs Web de cinquième génération ou de génération supérieure.
Valeur par défaut

La valeur par défaut est extraite de la propriété Valeur initiale du paramètre DESFORMAT. Pour Report Builder en mode bitmap, si DESFORMAT est laissé en blanc ou est égal à DFLT, le pilote d'imprimante en cours (indiqué dans Fichier [image] Choisir imprimante) est utilisé. Si vous n'avez pas sélectionné de valeur dans Choisir imprimante, PostScript est utilisé par défaut.

Notes d'utilisation

•	Ce mot-clé n'est pas pris en compte si DESTYPE=SCREEN.

•	La ou les valeurs de ce mot-clé peuvent faire la distinction entre majuscules et minuscules, selon votre système d'exploitation.


COPIES

  Présentation de RWBLD60

Description  COPIES indique le nombre d'exemplaires de la sortie de l'état à imprimer.

Syntaxe

[COPIES=]n

Valeurs

Tout nombre entier valide compris entre 1 et 9 999.

Valeur par défaut

Issue de la propriété Valeur initiale du paramètre COPIES.

Notes d'utilisation

•	Ce mot-clé est ignoré si DESTYPE n'est pas défini sur Printer.

•	Si COPIES est vierge dans la grille de paramètres d'exécution, il prend pour valeur par défaut 1.


CACHELOB

  Rubriques connexes 	 Présentation de RWBLD60

Description  CACHELOB indique s’il convient de mettre en mémoire cache dans le répertoire temporaire (désigné par REPORTS60_TMP) les grands objets Oracle8 extraits.

Valeurs

YES indique de mettre le LOB en mémoire cache dans le répertoire de fichiers temporaires.

NO indique de ne pas le faire.

Valeur par défaut

YES

Notes d'utilisation

•	Vous ne pouvez définir cette option que sur la ligne de commande.

•	Si l'emplacement du répertoire de fichiers temporaires ne dispose pas de suffisamment d'espace disque, définissez cette valeur sur NO. Dans ce cas, les performances peuvent cependant être réduites, car le LOB doit parfois être extrait plusieurs fois du serveur.


CURRENCY

  Présentation de RWBLD60

Description  CURRENCY désigne le symbole monétaire utilisé dans les formats numériques.

Syntaxe

[CURRENCY=]currency_symbol

Valeurs

Toute chaîne alphanumérique valide dont la longueur ne dépasse pas 1 Ko.

Valeur par défaut

La valeur par défaut pour ORACLE est déterminée par les fonctions NLS d'ORACLE. Vous pouvez également définir une valeur par défaut d'un maximum de 4 caractères dans la propriété Valeur initiale du paramètre CURRENCY.

Notes d'utilisation

•	La valeur de CURRENCY entrée dans la Palette de propriétés remplace toute valeur de CURRENCY entrée dans la ligne de commande.


THOUSANDS

  Présentation de RWBLD60

Description  THOUSANDS désigne le séparateur des milliers à utiliser dans les formats numériques.

Syntaxe

[THOUSANDS=]thousands_symbol

Valeurs

Tout caractère alphanumérique valide.

Valeur par défaut

La valeur par défaut pour ORACLE est déterminée par les fonctions NLS d'ORACLE. Vous pouvez également définir une valeur par défaut d'un maximum de 4 caractères, dans la propriété Valeur initiale du paramètre THOUSANDS.

Notes d'utilisation

• 	Une valeur de THOUSANDS entrée dans la fenêtre de propriétés Paramètres remplace toute valeur de THOUSANDS entrée dans la ligne de commande.

• 	Le caractère alphanumérique défini comme valeur THOUSANDS correspond à la valeur renvoyée. Par exemple, si vous définissez "," comme valeur THOUSANDS, "," est renvoyée.


DECIMAL

  Présentation de RWBLD60

Description  DECIMAL désigne le séparateur décimal à utiliser dans les formats numériques.

Syntaxe

[DECIMAL=]decimal_symbol

Valeurs

Tout caractère alphanumérique valide.

Valeur par défaut

La valeur par défaut pour ORACLE est déterminée par les fonctions NLS d'ORACLE. Vous pouvez également définir une valeur par défaut dans la propriété Valeur initiale du paramètre DECIMAL.

Notes d'utilisation

•	Une valeur DECIMAL, entrée dans la fenêtre de propriétés Paramètres, remplace toute valeur de DECIMAL entrée dans la ligne de commande.

• 	Le caractère alphanumérique défini comme valeur DECIMAL correspond à la valeur renvoyée. Par exemple, si vous définissez "." comme valeur DECIMAL, "." est renvoyée.


READONLY

  Restrictions 	  Présentation de RWBLD60

Description  READONLY demande la cohérence en lecture pour plusieurs interrogations d'un état. Lors de l'accès aux données à partir d'ORACLE, la cohérence en lecture est assurée par une instruction SET TRANSACTION READ ONLY (pour plus d'informations sur SET TRANSACTION READ ONLY, reportez-vous au manuel ORACLE8 Server SQL Language Reference Manual).

Syntaxe

[READONLY=]{YES|NO}

Valeurs

YES demande la cohérence en lecture.

NO ne garantit pas la cohérence en lecture.

Valeur par défaut

NO

Notes d'utilisation

•	Ce mot-clé n'est utile que pour les états qui utilisent des interrogations multiples, car ORACLE assure automatiquement la cohérence de lecture, sans verrouillage, pour les états n'utilisant qu'une interrogation.


READONLY - Restrictions

•	Dans Ordre d'exécution des déclencheurs d'état, notez l'endroit où figure SET TRANSACTION READONLY.


BUFFERS

  Présentation de RWBLD60

Description  BUFFERS indique la taille de la mémoire cache virtuelle, exprimée en kilo-octets. Adaptez ce paramètre afin de disposer de suffisamment de mémoire pour exécuter vos états, sans pour autant gaspiller les ressources de votre système.

Syntaxe

[BUFFERS=]n

Valeurs

Un nombre compris entre 1 et 9 999. La limite supérieure peut être plus faible avec certains systèmes d'exploitation.

Valeur par défaut

640 Ko

Notes d'utilisation

•	Si ce paramètre est modifié en cours de session, la modification n'est prise en compte que lors de l'exécution de l'état suivante.


PAGESIZE

  Présentation de RWBLD60

Description  PAGESIZE désigne les dimensions de la page physique (c'est-à-dire de la feuille sortant de l'imprimante). Notez que cette page doit être assez large pour contenir l'état. Par exemple, si le cadre d'un état s'étend au-delà des dimensions de la page, cet état n'est pas exécuté.

Syntaxe

[PAGESIZE=]width x height

Valeurs

Toutes dimensions de page valides, sous la forme : largeur de page x hauteur de page, où la largeur de page et la hauteur de page sont égales ou supérieures à zéro. Les valeurs maximales pour la largeur et la hauteur dépendent de l'unité de mesure. Elle est de 512 pouces, 1 312 centimètres ou 36 864 picas.

Valeur par défaut

En mode bitmap, 8,5 x 11 pouces. En mode caractère, 80 x 66 caractères. Si l'état a été conçu pour le mode caractère et qu'il est exécuté ou converti en mode bitmap, la formule suivante est utilisée pour déterminer la taille de page si aucune n'est précisée : (taille de page par défaut * taille de page en caractères)/taille de page par défaut en caractères. Par exemple, si la taille de page en caractères est de 80 x 20, la taille de page en mode bitmap est égale à : (8,5 * 80)/80 x (11 * 20)/66 = 8,5 x 3,33.

Notes d'utilisation

•	Sur certaines imprimantes, la zone imprimable de la page physique est limitée. Il est possible, par exemple, qu'une imprimante accepte un format de page de 8.5 x 11", mais ne puisse imprimer que sur une zone de 8 x 10.5". Si vous définissez dans Report Builder une largeur et une hauteur de page supérieures à la zone imprimable autorisée par votre imprimante, la sortie imprimée risque d'être tronquée. Pour éviter ce problème, vous pouvez soit augmenter la zone imprimable de l'imprimante (si votre système d'exploitation le permet), soit choisir une largeur et une hauteur de page de mêmes dimensions que la zone imprimable de la page.

•	Si ce mot-clé est utilisé, sa valeur a préséance sur les dimensions de page de la définition d'état.

•	Une valeur PAGESIZE entrée dans la grille de paramètre d'exécution a préséance sur toute valeur PAGESIZE entrée sur la ligne de commande.


PROFILE

  Présentation de RWBLD60

Description  PROFILE indique le nom du fichier dans lequel vous voulez stocker les statistiques de performances sur l'exécution d'un état. Si vous indiquez un nom de fichier, Report Builder calcule les statistiques sur le temps écoulé et le temps passé par l'unité centrale à exécuter l'état. PROFILE calcule les statistiques suivantes :

•	TEMPS TOTAL ECOULE Indique le temps écoulé entre le lancement de RWBLD60 et la sortie de Designer. TEMPS TOTAL ECOULE est la somme du temps Report Builder et du temps ORACLE.

•	Heure indique le temps passé dans Report Builder.

•	Heure ORACLE désigne le temps écoulé dans la base de données et contient les éléments suivants :

•	UPI indique le temps nécessaire à des tâches telles que la connexion à la base de données, l'analyse de SQL et l'extraction des données.

•	SQL indique le temps nécessaire à l'exécution de SRW.DO_SQL.

•	Temps CPU TOTAL utilisé par le processus : temps passé dans Designer.

Remarque : Pour certains systèmes d'exploitation, le temps Report Builder comprend le temps de la base de données, car la base de données est incluse dans le processus de Report Builder.

Syntaxe

[PROFILE=]profiler_file

Valeurs

Tout nom de fichier valide dans le répertoire en cours.


RUNDEBUG

  Présentation de RWBLD60

Description  RUNDEBUG indique si vous voulez davantage de temps pour rechercher des erreurs logiques dans les états. RUNDEBUG recherche les problèmes qui ne sont pas des erreurs, mais qui peuvent entraîner l'impression d'une sortie non conforme. RUNDEBUG recherche :

•	Cadres ou cadres itératifs qui se chevauchent mais n'englobent aucun autre objet. Cela peut causer l'écrasement d'objets par d'autres dans la sortie.

•	les objets de présentation comportant des références liées aux pages, et qui n'ont pas de taille fixe. Report Builder fixe la taille de certains objets, quelles que soient les propriétés Elasticité verticale et horizontale,

•	Variables de liens référencées selon une fréquence erronée dans PL/SQL.

Syntaxe

[RUNDEBUG=]{YES|NO}

Valeurs

YES exécute une vérification supplémentaire des erreurs au moment de l'exécution.

NO n'exécute pas de vérification supplémentaire des erreurs au moment de l'exécution.

Valeur par défaut

YES


ONSUCCESS

  Présentation de RWBLD60

Description  ONSUCCESS indique si vous voulez exécuter une fonction COMMIT ou ROLLBACK à la fin de l'exécution de l'état.

Syntaxe

[ONSUCCESS=]{COMMIT|ROLLBACK|NOACTION}

Valeurs

COMMIT indique qu'une validation sera exécutée à la fin de l'état.

ROLLBACK indique qu'une annulation sera exécutée à la fin de l'état.

NOACTION indique qu'aucune action ne sera exécutée à la fin de l'état.

Valeur par défaut

COMMIT, si un USERID est fourni.

NOACTION, dans le cas d'un appel provenant d'une source externe (par exemple, Oracle Forms) sans précision de USERID.

Notes d'utilisation

•	L'opération COMMIT ou ROLLBACK pour ONSUCCESS est effectuée après l'activation du déclencheur After Report. D'autres opérations COMMIT et ROLLBACK peuvent se produire avant celle-ci. Pour plus d'informations, reportez-vous à READONLY.


ONFAILURE

  Présentation de RWBLD60

Description  ONFAILURE indique si une fonction COMMIT ou ROLLBACK doit être exécutée en cas d'erreur et d'échec d'exécution d'un état.

Syntaxe

[ONFAILURE=]{COMMIT|ROLLBACK|NOACTION}

Valeurs

COMMIT indique qu'une validation sera exécutée en cas d'échec de l'exécution d'un état.

ROLLBACK indique qu'une annulation sera exécutée en cas d'échec de l'exécution d'un état.

NOACTION indique qu'aucune action ne sera exécutée en cas d'échec de l'exécution d'un état.

Valeur par défaut

ROLLBACK, si un USERID est fourni.

NOACTION, dans le cas d'un appel provenant d'une source externe (par exemple, Oracle Forms) sans précision de USERID.

Notes d'utilisation

•	L'opération COMMIT ou ROLLBACK pour ONFAILURE est effectuée après l'échec de l'état. D'autres opérations COMMIT et ROLLBACK peuvent se produire avant celle-ci. Pour plus d'informations, reportez-vous à READONLY.


ERRFILE

  Présentation de RWBLD60

Description  ERRFILE indique le nom d'un fichier dans lequel Report Builder stockera les messages d'erreur.

Syntaxe

[ERRFILE=]error_file

Valeurs

Tout nom de fichier valide.


LONGCHUNK

  Présentation de RWBLD60

Description  LONGCHUNK indique la taille (en kilo-octets) des incréments utilisés par Report Builder pour extraire une valeur de colonne de type LONG. Vous pouvez demander que la valeur LONG soit extraite par incrément, et non en bloc, pour des raisons de limitation de taille mémoire. LONGCHUNK ne s'applique qu'à Oracle7 et à Oracle8.

Syntaxe

[LONGCHUNK=]n

Valeurs

Un nombre compris entre 1 et 9 999. La limite supérieure peut être plus faible avec certains systèmes d'exploitation.

Valeur par défaut

10 Ko


ACCESS

  Présentation de RWBLD60

Description  ACCESS indique l'endroit où des modules doivent être ouverts. Report Builder y recherche le module que vous indiquez dans MODULE. Si ACCESS n'est pas indiqué, Report Builder utilise son ordre de recherche de chemin d'accès pour trouver le fichier.

Syntaxe

[ACCESS=]{FILE|DATABASE}

Valeurs

FILE

DATABASE

Valeur par défaut

FILE


ORIENTATION

  Présentation de RWBLD60

Description  ORIENTATION contrôle l'orientation selon laquelle les pages de l'état sont imprimées.

Syntaxe

[ORIENTATION=]{DEFAULT|LANDSCAPE|PORTRAIT}

Valeurs

DEFAULT utilise les paramètres d'orientation par défaut de l'imprimante en cours.

LANDSCAPE indique une orientation paysage

PORTRAIT indique une orientation portrait

Valeur par défaut

DEFAULT

Notes d'utilisation

•	Si ORIENTATION=LANDSCAPE pour un état en mode caractère, vous devez vous assurer que votre fichier de définition d'imprimante contient une clause LANDSCAPE.

•	Les paramètres d'orientation sont ignorés lorsque vous imprimez des états sur une imprimante PCL fonctionnant sous Motif. L'état est traité avec les paramètres par défaut.


BACKGROUND

  Présentation de RWBLD60

Description  BACKGROUND indique si l'état doit être exécuté en arrière-plan.

Syntaxe

[BACKGROUND=]{YES|NO}

Valeurs

YES n'est pas une option valide pour RWBLD60.

NO

Valeur par défaut

NO


MODE

  Présentation de RWBLD60

Description  MODE indique si l'état doit être exécuté en mode caractère ou en mode bitmap - ce qui vous permet d'exécuter un état en mode caractère à partir de Report Builder en mode bitmap, ou vice versa. Par exemple, pour envoyer un état à une imprimante PostScript à partir d'un terminal (par exemple, un vt220), vous pouvez appeler RWRUN60 en mode caractère et exécuter l'état avec MODE=BITMAP. Sous Windows, MODE=CHARACTER indique que le pilote ASCII de Report Builder sera utilisé pour produire une sortie ASCII éditable.

Syntaxe

[MODE=]{BITMAP|CHARACTER|DEFAULT}

Valeurs

BITMAP

DEFAULT exécute l'état selon le mode de l'exécutable actuellement utilisé.

CHARACTER

Valeur par défaut

DEFAULT


PRINTJOB

  Présentation de RWBLD60

Description  PRINTJOB indique si la boîte de dialogue d'impression de travaux doit apparaître avant l'exécution d'un état.

Syntaxe

[PRINTJOB=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

YES

Notes d'utilisation

•	Lorsqu'un état est exécuté comme processus généré dynamiquement (c'est-à-dire qu'un exécutable tel que RWRUN60 est appelé à partir d'un autre exécutable, tel que RWBLD60), la boîte de dialogue d'impression de travaux n'apparaît pas, quelle que soit la valeur de PRINTJOB.

•	Lorsque DESTYPE=MAIL, la boîte de dialogue d'impression de travaux n'apparaît pas, quelle que soit la valeur de PRINTJOB.


TRACEFILE

  Présentation de RWBLD60

Description  TRACEFILE indique le nom du fichier dans lequel Report Builder enregistre les informations de traçage.

Syntaxe

[TRACEFILE=]tracefile

Valeurs

Tout nom de fichier valide.

Notes d'utilisation

•	Les informations de trace ne peuvent être générées que lors de l'exécution d'un fichier .rdf. Vous ne pouvez pas demander de journalisation lors de l'exécution d'un fichier .rep.

•	Si vous indiquez LOGFILE, ERRFILE ou TRACEFILE, toutes les informations de trace sont placées dans le dernier fichier indiqué. Par exemple, dans le cas suivant, toutes les informations de trace indiquées sont placées dans err.log car il s'agit du dernier fichier mentionné dans la commande RWRUN60.

RWRUN60 MODULE=order_entry
USERID=scott/tiger
TRACEFILE=trace.log LOGFILE=mylog.log
ERRFILE=err.log


TRACEMODE

  Présentation de RWBLD60

Description  TRACEMODE indique si Report Builder doit ajouter les informations de traçage au fichier ou l'écraser en totalité.

Syntaxe

[TRACEMODE=]{TRACE_APPEND|TRACE_REPLACE}

Valeurs

TRACE_APPEND ajoute les nouvelles informations à la fin du fichier.

TRACE_REPLACE écrase le fichier.

Valeur par défaut

TRACE_APPEND

Notes d'utilisation

•	Les informations de trace ne peuvent être générées que lors de l'exécution d'un fichier .rdf. Vous ne pouvez pas demander de journalisation lors de l'exécution d'un fichier .rep.


TRACEOPTS

  Présentation de RWBLD60

Description  TRACEOPTS indique les informations de traçage que vous voulez consigner dans le fichier de traçage lors de l’exécution de l’état.

Syntaxe

[TRACEOPTS=]{TRACE_ERR|TRACE_PRF|TRACE_APP|TRACE_PLS|
TRACE_SQL|TRACE_TMS|TRACE_DST|TRACE_ALL|(opt1, opt2, ...)}

Valeurs

Toutes les options que vous indiquez entre parenthèses doivent être utilisées. Par exemple, TRACE_OPTS=(TRACE_APP, TRACE_PRF) indique que vous voulez que les options TRACE_APP et TRACE_PRF soient utilisées.

TRACE_ALL consigne dans le fichier trace toutes les informations de trace disponibles.

TRACE_APP consigne dans le fichier trace les informations de trace concernant tous les objets de l'état.

TRACE_BRK indique que les points d'interruption doivent être consignés dans le fichier de traçage.

TRACE_DST indique que le fichier de traçage doit comporter la liste des listes de diffusion. Vous pouvez utiliser ces informations pour déterminer les sections ayant été envoyées et leur destination. Le format de fichier de traçage étant très semblable au format du fichier .DST, vous pouvez utiliser le couper-coller pour créer un fichier .DST à partir du fichier de traçage.

TRACE_ERR recense dans le fichier trace les messages d'erreur et les avertissements.

TRACE_PLS consigne dans le fichier trace les informations de trace concernant tous les objets PL/SQL.

TRACE_PRF consigne dans le fichier trace les statistiques de performances.

TRACE_SQL consigne dans le fichier trace toutes les informations de trace sur SQL.

TRACE_TMS crée un horodatage de toutes les entrées du fichier trace.

Valeur par défaut

TRACE_ALL

Notes d'utilisation

•	Les informations de trace ne peuvent être générées que lors de l'exécution d'un fichier .rdf. Vous ne pouvez pas demander de journalisation lors de l'exécution d'un fichier .rep.


AUTOCOMMIT

  Présentation de RWBLD60

Description  AUTOCOMMIT indique si les modifications apportées à la base de données (par exemple CREATE) doivent être automatiquement validées dans la base de données. Notez que certaines bases de données non Oracle (par exemple, SQL Server) demandent que AUTOCOMMIT ait la valeur YES.

Syntaxe

[AUTOCOMMIT=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


NONBLOCKSQL

  Présentation de RWBLD60

Description  NONBLOCKSQL indique si d'autres programmes seront autorisés à s'exécuter pendant que Report Builder extrait des données de la base de données.

Syntaxe

[NONBLOCKSQL=]{YES|NO}

Valeurs

YES signifie que l'exécution d'autres programmes est autorisée pendant l'extraction des données.

NO signifie que l'exécution d'autres programmes n'est pas autorisée pendant l'extraction des données.

Valeur par défaut

YES


ROLE

  Rubriques connexes 	  Présentation de RWBLD60

Description  ROLE indique le rôle de base de données à cocher pour l'état lors de l'exécution. Rôle n'est pas valide pour RWBLD60.

Syntaxe

[ROLE=]{nom_rôle/[mot_passe_rôle]}

Valeurs

Un rôle valide et (facultativement) un mot de passe de rôle.


BLANKPAGES

  Présentation de RWBLD60

Description  BLANKPAGES indique si les pages blanches doivent être supprimées lorsque vous imprimez un état. Utilisez ce mot-clé lorsque votre état comporte des pages blanches que vous ne voulez pas imprimer.

Syntaxe

[BLANKPAGES=]{YES|NO}

Valeurs

YES signifie que toutes les pages blanches sont imprimées.

NO signifie que les pages blanches ne sont pas imprimées.

Valeur par défaut

YES

Notes d'utilisation  BLANKPAGES est particulièrement utile si votre page logique comporte plusieurs pages physiques (ou panneaux) et que vous ne vouliez pas imprimer les pages blanches.


MAXIMIZE

  Présentation de RWBLD60

Description  MAXIMIZE indique s’il convient d’agrandir la fenêtre de Reports Runtime. Ce mot-clé n’a pas d’effet sur Report Builder et ne doit être utilisé qu’avec Reports Runtime.


DISABLEPRINT

  Présentation de RWBLD60

Description  DISABLEPRINT indique si les menus Fichier [image] Imprimer, Fichier [image] Mise en page et Fichier [image] Choisir l'imprimante (sur Motif) doivent être désactivés, ainsi que les boutons de barre d'outils équivalents dans l'Aperçu interactif Runtime.

Syntaxe

[DISABLEPRINT=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


DISABLEMAIL

  Présentation de RWBLD60

Description  DISABLEMAIL indique si le menu de courrier électronique doit être désactivé, ainsi que les boutons de barre d'outils équivalents dans l'Aperçu interactif Runtime.

Syntaxe

[DISABLEMAIL=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


DISABLEFILE

  Présentation de RWBLD60

Description  DISABLEFILE indique si le menu Fichier [image] Générer dans fichier doit être désactivé dans l'Aperçu interactif Runtime.

Syntaxe

[DISABLEFILE=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


DISABLENEW

  Présentation de RWBLD60

Description  DISABLENEW indique si le menu Affichage [image] Nouvel aperçu doit être désactivé pour empêcher d'afficher une nouvelle instance de l'Aperçu interactif Runtime.

Syntaxe

[DISABLENEW=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


DELIMITER

  Présentation de RWBLD60	  Rubriques connexes

Description  DELIMITER désigne le ou les caractères utilisés pour séparer les cellules de la sortie d'état.

Syntaxe

[DELIMITER=]value

Valeurs

Tout caractère alphanumérique ou toute chaîne de caractères alphanumériques, notamment :

,	Une virgule sépare les cellules.
.	Un point sépare les cellules.
Vous pouvez également utiliser l'une des quatre valeurs réservées suivantes :

tab	Une tabulation sépare les cellules.
space	Un espace sépare les cellules.
return	Un interligne sépare les cellules.
none	Aucun séparateur n'est utilisé.
Vous pouvez également utiliser des séquences d'échappement fondées sur le jeu de caractères ASCII, notamment :

\t	Une tabulation sépare les cellules.
\n	Un interligne sépare les cellules.
Valeur par défaut

Tab

Notes d'utilisation

•	Cet argument ne peut être utilisé que si vous avez précisé DESFORMAT=DELIMITED.


CELLWRAPPER

  Présentation de RWBLD60	  Rubriques connexes

Description  CELLWRAPPER désigne le ou les caractères affichés autour des cellules délimitées de votre sortie d'état.

Syntaxe

[CELLWRAPPER=]value

Valeur

Tout caractère alphanumérique ou chaîne de caractères alphanumériques.

«	Des guillemets apparaissent de part et d'autre de la cellule.
‘	Des apostrophes apparaissent de part et d'autre de la cellule.
Vous pouvez également utiliser l'une des quatre valeurs réservées suivantes :

tab	Des tabulations apparaissent de part et d'autre de la cellule.
space	Des espaces simples apparaissent de part et d'autre de la cellule.
return	Des interlignes apparaissent de part et d'autre de la cellule.
none	Aucun intercalaire de cellule n'est utilisé.
Vous pouvez également utiliser des séquences d'échappement fondées sur le jeu de caractères ASCII, notamment :

\t	Des tabulations apparaissent de part et d'autre de la cellule.
\n	Des interlignes apparaissent de part et d'autre de la cellule.
Valeur par défaut

none

Notes d'utilisation

•	Cet argument ne peut être utilisé que si vous avez précisé DESFORMAT=DELIMITED.

•	Ne confondez pas un intercalaire avec un séparateur (delimiter).


DATEFORMATMASK

  Présentation de RWBLD60	  Rubriques connexes

Description  DATEFORMATMASK désigne la manière dont les valeurs de date apparaissent dans la sortie d'état délimitée.

Syntaxe

[DATEFORMATMASK=]mask

Valeurs

Tout masque de format de date valide.

Notes d'utilisation

•	Vous ne pouvez utiliser cet argument que si vous avez indiqué DESFORMAT=DELIMITED.


NUMBERFORMATMASK

  Présentation de RWBLD60	  Rubriques connexes

Description  NUMBERFORMATMASK désigne la manière dont les valeurs numériques apparaissent dans l'état de sortie délimité.

Syntaxe

[NUMBERFORMATMASK=]mask

Valeurs

Tout masque de format numérique valide.

Notes d'utilisation

•	Vous ne pouvez utiliser cet argument que si vous avez indiqué DESFORMAT=DELIMITED.


DESTINATION

  Présentation de RWBLD60	  Rubriques connexes

Description  Le mot-clé DESTINATION vous permet de préciser le nom d’un fichier .DST définissant la diffusion de l’exécution en cours de l’état.

Syntaxe

[DESTINATION=]filename.DST

Valeurs

Le nom d’un fichier .DST.

Notes d'utilisation

•	Pour activer le mot-clé DESTINATION, saisissez DISTRIBUTE=YES dans la ligne de commande.


DISTRIBUTE

  Présentation de RWBLD60	  Rubriques connexes

Description  DISTRIBUTE active ou désactive la diffusion de la sortie d’état vers plusieurs destinations, ainsi que l'indique la liste de diffusion définie dans la boîte de dialogue Diffusion ou dans un fichier .DST.

Syntaxe

[DISTRIBUTE=]{YES|NO}

Valeurs

YES signifie que l'état doit être envoyé à la liste de diffusion.

NO signifie que la liste de diffusion doit être ignorée et que l'état doit être sorti de la manière indiquée dans les paramètres DESNAME et DESFORMAT. Il s'agit essentiellement d'un mode de débogage qui permet d'exécuter un état paramétré pour la diffusion, sans toutefois lancer cette dernière.

Valeur par défaut

NO

Notes d'utilisation

•	Pour activer le mot-clé DESTINATION, saisissez DISTRIBUTE=YES.


PAGESTREAM

 Présentation de RWBLD60	 Rubriques connexes

Description  PAGESTREAM active ou désactive la création de sorties d'état au format pages HTML ou HTMLCSS, à l’aide des commandes de navigation définies de l’une des manières suivantes :

•	les propriétés Type Contrôle de navigation de page et Valeur Contrôle de navigation de page de la palette de propriétés de l'état.

•	PL/SQL dans un déclencheur Avant état (SRW.SET_PAGE_NAVIGATION_HTML)

Syntaxe

[PAGESTREAM=]{YES|NO}

Valeurs

YES indique d'activer la sortie au format pages.

NO indique de la désactiver.

Valeur par défaut

NO


EXPRESS_SERVER

 Exemples

Description  EXPRESS_SERVER indique le serveur Express auquel vous voulez vous connecter.

Syntaxe

EXPRESS_SERVER="server=[server]/domain=[domain]/
user=[userid]/password=[passwd]"

Syntaxe utilisant RAM

EXPRESS_SERVER="server=[server]/domain=[domain]/
user=[userid]/password=[passwd]/ramuser=[ramuserid]/
rampassword=[rampasswd]/ramexpressid=[ramexpid]/
ramserverscript=[ramsscript]/rammasterdb=[ramdb]/
ramconnecttype=[ramconn]"

Valeurs

Chaîne de connexion valide incluse entre guillemets (") dans laquelle :

server	est la chaîne du serveur Express (ex. : ncacn_ip_tcp:sburns2-pc/0/1/0/1).
domain	Correspond au domaine du serveur Express.
user	Correspond à l'ID utilisateur permettant de se connecter au serveur Express.
password	Correspond au mot de passe de l'ID utilisateur.
ramuser	Correspond à l'ID utilisateur permettant de se connecter au RDBMS.
rampassword	Correspond au mot de passe du RDBMS.
ramexpressid	ID de l'utilisateur de la base de données Oracle Sales Analyzer. Cette valeur n'est requise que pour les bases de données Oracle Sales Analyzer.
ramserverscript	Nom complet (avec son chemin complet) du fichier de configuration de la base de données distante (RDC) sur le serveur. Ce fichier fournit des informations comme l'emplacement du code et des bases de données. La syntaxe UNC (Universal Naming Convention) permet à plusieurs utilisateurs d'employer la même connexion pour accéder aux données sans devoir associer la même lettre de lecteur à cet emplacement. La syntaxe UNC est la suivante : \\NomServeur\NomPartage\, suivie du nom des sous-dossiers et/ou fichiers.
rammasterdb	Nom de la base de données Relational Access Manager à attacher initialement. Vous ne devez indiquer que le nom de fichier de la base de données. Cette dernière doit résider dans un répertoire figurant dans la liste des chemins d'accès de la variable ServerDBPath pour Express Server. Vous pouvez vérifier le chemin ServerDBPath dans l'onglet d'entrées/sorties de fichier de la boîte de dialogue Express Configuration Manager.
ramconnecttype	Type de connexion Express. Pour utiliser une connexion directe, entrez 0.
Paramètres

La valeur server comporte quatre paramètres qui correspondent aux paramètres définis dans Oracle Express Connection Editor et stockés dans les fichiers de connexion (.xcf). Ces quatre paramètres sont indispensables, mais leur ordre est indifférent. Le tableau suivant décrit ces paramètres et leur configuration.

Paramètre	Description	Configuration
sl	Connexion au serveur	-2 : Hôte (connexion au domaine) -1 : Hôte (connexion au serveur) 0 : Aucune authentification requise 1 : Sécurité sur l'hôte (connexion au domaine) et la connexion 2 : Sécurité sur l'hôte (connexion au domaine) et les appels 3 : Sécurité sur l'hôte (connexion au domaine) et le paquet 4 : Sécurité sur l'hôte (connexion au domaine) et l'intégrité 5 : Sécurité sur l'hôte (connexion au domaine) et la confidentialité Remarques : Windows NT utilise toutes ces configurations. Les systèmes Unix n'utilisent que les configurations 0, -1 et -2. Pour plus d'informations sur ces configurations, reportez-vous au système d'aide d'Express Connection Editor.
st	Type de serveur	1 : Serveur Express
ct	Type de connexion	0 : Connexion Express
sv	Version du serveur	1 : Express 6.2 ou versions supérieures
Notes d'utilisation

•	En cas de nécessité, vous pouvez insérer des espaces dans la chaîne (par exemple, si l'ID utilisateur est John Smith) car elle est entre guillemets.

•	Si vous utilisez une barre oblique (/) dans la chaîne, vous devez en utiliser une autre en tant que caractère d'échappement. Par exemple, si le domaine est tools/reports, la ligne de commande doit se présenter sous la forme suivante :

EXPRESS_SERVER="server=ncacn_ip_tcp:olap2-pc/sl=0/st=1/
ct=0/sv=1/ domain=tools//reports"

•	Vous pouvez utiliser des apostrophes dans la chaîne. Aucun traitement spécial n'est appliqué lorsqu'une chaîne est comprise entre guillemets.


EXPRESS_SERVER avec ID utilisateur, mot de passe et domaine (RWBLD60) - Exemple

  Rubriques connexes 	  Tous les exemples

rwbld60 userid=scott/tiger@nt805
express_server='server=ncacn_ip_tcp:sburns2-pc/1/1/0/1/
user=orbuild/domain=tools/password=buildme/'
report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


EXPRESS_SERVER sans ID utilisateur, ni mot de passe, ni domaine (RWBLD60) - Exemple

  Rubriques connexes 	  Tous les exemples

rwbld60 userid=scott/tiger@nt805
express_server='server=ncacn_ip_tcp:sburns2-pc/0/1/0/1/'
report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


EXPRESS_SERVER avec RAM (RWBLD60) - Exemple

  Rubriques connexes 	  Tous les exemples

rwrun60 userid=scott/tiger@nt805
express_server="server=ncacn_ip_tcp:olap2-pc/sl=0/st=1/
ct=0/sv=1/ramuser=appqa/rampassword=appqa1/ramexpressid=appqa/
ramserverscript=\\olap3-pc\orant\olap\ram6202\ram\sqstnt.rdc/
rammasterdb=sqstnt.db/ramconnecttype=0"
report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


CUSTOMIZE

Description  CUSTOMIZE indique le fichier ou la liste de fichiers XML à appliquer à l'état sélectionné dans le mot-clé MODULE ou REPORT. Le fichier XML contient des options personnalisées (comme des modifications de police ou de couleur) qui modifient la définition de l'état.

Pour plus d'informations, reportez-vous au manuel Publishing Reports.

Syntaxe

[CUSTOMIZE=]filename.xml|(filename1.xml, filename2.xml, …)

Valeurs

Nom des fichiers contenant des définitions d'états XML valides. Si nécessaire, faites précéder ces noms des informations de chemin d'accès correspondantes.

Notes d'utilisation

•	En général, l'extension de fichier d'une définition d'état XML est .XML, sauf si elle est utilisée avec le mot-clé CUSTOMIZE.


SAVE_RDF

Description  SAVE_RDF indique le fichier dans lequel vous voulez enregistrer l'état sélectionné dans le mot-clé MODULE ou REPORT, associé aux fichiers de personnalisation XML sélectionnés dans le mot-clé CUSTOMIZE. Cet argument se révèle particulièrement utile lorsque vous disposez d'un fichier .RDF auquel vous appliquez un fichier XML via le mot-clé CUSTOMIZE et que vous voulez enregistrer la combinaison de ces deux fichiers dans un nouveau fichier .RDF.

Pour plus d'informations, reportez-vous au manuel Publishing Reports.

Syntaxe

[SAVE_RDF=]filename.rdf

Valeurs

Tout nom de fichier valide.


<param>

  Présentation de RWBLD60

Description  <param> est un paramètre appartenant à la définition de l’état. Il prend la valeur que vous indiquez.

Syntaxe

<param>=value

Valeurs

Toute valeur valide pour ce paramètre.

Valeur par défaut

Issue de la propriété Valeur initiale du paramètre.

Notes d'utilisation

•	Vous pouvez remplacer la valeur par défaut de la grille de paramètres d'exécution.

•	La valeur des arguments peut être entre apostrophes ou entre guillemets. L'effet des apostrophes ou des guillemets dépend du système d'exploitation.

•	La valeur PARAM n’est ni analysée, ni validée, car ces paramètres peuvent faire référence à des paramètres non encore définis.


RWCGI60

Description RWCGI60 est l'exécutable Reports Web CGI qui fournit une connexion entre Web Server et Reports Server (RWMTS60), ce qui vous permet d'exécuter des états dynamiquement depuis votre navigateur Web. Pour plus d'informations sur RWCGI60, reportez-vous au manuel Publishing Reports.


RWCLI60

 Arguments de ligne de commande 	  Rubriques connexes

Description  RWCLI60 analyse et transfère la ligne de commande au serveur d'états indiqué (RWMTS60). La ligne de commande utilisée est très similaire à celle de RWRUN60.

Syntaxe

RWCLI60 MODULE|REPORT=runfile USERID=userid
[ [keyword=]value|(value1, value2, ...) ] SERVER=tnsname

où mot de passe = valeur représente un argument de ligne de commande valide.

Notes d'utilisation

•	Tous les noms de fichier et les chemins d'accès indiqués dans la ligne de commande du client font référence à des fichiers et à des répertoires de l'ordinateur serveur, à l'exception du fichier de commandes.

•	Si la ligne de commande contient CMDFILE=, le fichier de commandes sera lu et ajouté à la ligne de commande d'origine avant d'être envoyé au serveur d'états. Le moteur d'exécution ne lira pas à nouveau ce fichier de commandes.


Arguments de ligne de commande de RWCLI60

[MODULE|REPORT=]runfile

[USERID=]userid

[PARAMFORM=]NO

[CMDFILE=]cmdfile

[TERM=]termfile

[ARRAYSIZE=]n

[DESTYPE=]{CACHE|LOCALFILE|FILE|PRINTER|SYSOUT|MAIL|XML}

[DESNAME=]desname

[DESFORMAT=]desformat

[CACHELOB=]{YES|NO}

[COPIES=]n

[CURRENCY=]currency_symbol

[THOUSANDS=]thousands_symbol

[DECIMAL=]decimal_symbol

[READONLY=]{YES|NO}

[LOGFILE=]logfile

[BUFFERS=]n

[BATCH=]YES

[PAGESIZE=]width x height

[PROFILE=]profiler_file

[RUNDEBUG=]{YES|NO}

[ONSUCCESS=]{COMMIT|ROLLBACK|NOACTION}

[ONFAILURE=]{COMMIT|ROLLBACK|NOACTION}

[KEYIN=]keyin_file

[KEYOUT=]keyout_file

[ERRFILE=]error_file

[LONGCHUNK=]n

[ORIENTATION=]{DEFAULT|LANDSCAPE|PORTRAIT}

[BACKGROUND=]{YES|NO}

[MODE=]{BITMAP|CHARACTER|DEFAULT}

[PRINTJOB]{YES|NO}

[TRACEFILE=]tracefile

[TRACEMODE=]{TRACE_APPEND|TRACE_REPLACE}

[TRACEOPTS=]{TRACE_ERR|TRACE_PRF|TRACE_APP|TRACE_PLS|
TRACE_SQL|TRACE_TMS|TRACE_DST|TRACE_ALL|(opt1, opt2, ...)}

[AUTOCOMMIT]{YES|NO}

[NONBLOCKSQL=]{YES|NO}

[ROLE=]rolename/[rolepassword]|(rolename/[rolepassword],. . .)

[BLANKPAGES=]{YES|NO}

[DISABLEPRINT=]{YES|NO}

[DISABLEMAIL=]{YES|NO}

[DISABLEFILE=]{YES|NO}

[DISABLENEW=]{YES|NO}

[DESTINATION=]filename.DST

[DISTRIBUTE=]{YES|NO}

[DELIMITER=]value

[CELLWRAPPER=]value

[DATEFORMATMASK=]mask

[NUMBERFORMATMASK=]mask

[PAGESTREAM=]{YES|NO}

[SERVER=]tnsname

[JOBNAME=]string

[SCHEDULE=]string

[TOLERANCE=]number

[DELIMITER=]value

[CELLWRAPPER=]value

EXPRESS_SERVER="server=[server]/domain=[domain]/user=[userid]/password=[passwd]"

[AUTHID]=username/password

[CUSTOMIZE]=filename.xml | (filename1.xml, filename2.xml, . . .)

[SAVE_RDF]=filename.rdf

<param>=value


PARAMFORM

  Rubriques connexes

Description  Si PARAMFORM est indiqué, sa valeur doit être " NO ".

Syntaxe

[PARAMFORM=]NO


DESTYPE

  Rubriques connexes

Description  DESTYPE désigne le type de périphérique qui doit recevoir la sortie d'état.

Syntaxe

[DESTYPE=]{CACHE|LOCALFILE|FILE|PRINTER|SYSOUT|MAIL}

Valeurs

CACHE	Envoie le document directement dans la mémoire cache du serveur d'états. Remarquez que DESTYPE=CACHE n'est pas compatible avec le mot-clé DISTRIBUTE. Si le serveur rencontre DISTRIBUTE sur la ligne de commande, il ignore l'argument DESTYPE=CACHE.
LOCALFILE	Localfile Envoie le document dans un fichier sur l'ordinateur client et impose un appel synchrone, quelle que soit la valeur de BACKGROUND.
FILE	File Envoie le document dans le fichier de l'ordinateur serveur indiqué par DESNAME.
PRINTER	Printer Envoie le document sur l'imprimante de l'ordinateur serveur indiquée par DESNAME.
MAIL	Envoie la sortie aux utilisateurs de courrier indiqués dans DESNAME. Vous pouvez envoyer du courrier à tout système de courrier compatible MAPI ou disposant du pilote prestataire de services. L'état est envoyé en tant que fichier joint.
SYSOUT	Sysout Envoie le document sur le périphérique de sortie par défaut de l'ordinateur client et impose un appel synchrone.
Valeur par défaut

Issue de la propriété Valeur initiale du paramètre DESTYPE.

Notes d'utilisation

•	Screen et Preview ne peuvent pas être utilisés comme DESTYPE avec RWCLI60.


BATCH

  Rubriques connexes

Description  Si BATCH est indiqué, sa valeur doit être " YES ".

Syntaxe

[BATCH=]YES


BACKGROUND

  Rubriques connexes

Description  BACKGROUND indique si l'appel est synchrone (BACKGROUND=NO) ou asynchrone (BACKGROUND=YES). Dans le cas d'un appel synchrone, le client attend que l'état intègre une file d'attente, soit attribué à un moteur d'exécution, puis s'exécute et se termine. Dans le cas d'un appel asynchrone, le client envoie simplement l'appel sans en attendre l'issue. Si le processus client est interrompu pendant un appel synchrone, le travail est annulé.

Syntaxe

[BACKGROUND=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


SERVER

  Rubriques connexes

Description  SERVER indique l'adresse TNS du serveur d'états.

Syntaxe

[SERVER=]tnsname

Valeurs

Tout TNSNAME valide.

Notes d'utilisation

•	Si vous définissez la variable d'environnement REPORTS60_REPORTS_SERVER sur l'ordinateur de votre serveur Web, vous pouvez omettre l'argument de ligne de commande SERVER pour traiter les demandes sur le serveur par défaut ou inclure cet argument pour ignorer la valeur par défaut.


JOBNAME

  Rubriques connexes

Description  JOBNAME indique le nom de travail qui apparaît dans l'Administrateur de files d'attente d'états. Il est considéré comme un commentaire et n'affecte en rien l'exécution du travail. S'il n'est pas précisé, L'Administrateur de files d'attente indique le nom de l'état comme nom de travail.

Syntaxe

[JOBNAME=]string


SCHEDULE

  Rubriques connexes

Description  SCHEDULE est une commande de planification. La valeur par défaut est " now ". Pour ne pas avoir à entourer la commande de planification de guillemets, remplacez chaque espace par un trait de soulignement (_). Par exemple :

schedule=every_first_fri_of_month_from_15:53_Oct_23,_1999_retry_3_after_1_hour

schedule=last_weekday_before_15_from_15:53_Oct_23,_1999_retry_after_1_hour

Remarque : Les versions antérieures de la syntaxe SCHEDULE sont prises en charge ; cependant, seule la syntaxe en cours est traitée ici.

Syntaxe

[SCHEDULE=]string

où la chaîne (string) est :

[FREQ from] TIME [retry {n} + after LEN]

FREQ	horaire | quotidienne | hebdomadaire | mensuelle | {chaque LEN} | DAYREPEAT}} | {dernier  {WEEKDAYS | jour ouvrable | week-end} avant {n}+}
LEN	{n}+ {minute[s] | heure[s] | jour[s] | semaine[s] | mois}
DAYREPEAT	{premier | deuxième | troisième | quatrième | cinquième} WEEKDAYS du mois
WEEKDAYS	lun | mar | mer | jeu | ven | sam | dim
TIME	now | CLOCK [DATE]
CLOCK	h:m | h:mm | hh:m | hh:mm
DATE	aujourd'hui | demain | {MONTHS {d | dd} [,année]}
MONTHS	jan | fév | mar | avr | mai | jui | jul | aoû | sep | oct | nov | déc


TOLERANCE

  Rubriques connexes

Description  TOLERANCE indique la tolérance de temps pour la détection de travaux en double, exprimée en minutes.

Syntaxe

[TOLERANCE=]number


AUTHID

  Rubriques connexes

Description  AUTHID correspond au nom utilisateur et au mot de passe utilisés pour authentifier les utilisateurs sur un serveur Reports Server protégé. Oracle WebDB permet d'effectuer le test de sécurité. WebDB s'assure que tous les utilisateurs qui exécutent les états disposent des privilèges d'accès requis pour exécuter l'état demandé. Pour plus d'informations sur la sécurité, reportez-vous à l'aide en ligne d'Oracle WebDB.

Lorsque les utilisateurs parviennent à se connecter, un cookie chiffré qui les authentifie sur le serveur Reports Server protégé est envoyé à leur navigateur. Par défaut, le cookie expire au bout de 30 minutes. Les demandes suivantes (celles envoyées au serveur protégé) doivent alors être ré-authentifiées.

Vous pouvez utiliser la variable d'environnement REPORTS60_COOKIE_EXPIRE pour modifier le délai d'expiration du cookie d'authentification.

Pour que les utilisateurs soient authentifiés et le restent après l'expiration du cookie, omettez la commande AUTHID dans la demande d'état. Pour que les utilisateurs soient authentifiés à chaque demande Web, incluez les commandes Web CGI ou Web Cartridge SHOWAUTH et AUTHYPE=S dans l'URL de l'état, ou incluez l'argument %S dans l'entrée d'association de clé, dans le fichier owscmd.dat (Web Cartridge) ou cgicmd.dat (Web CGI).

Syntaxe

[AUTHID=]username/password

Valeurs

Toute paire nom utilisateur/mot de passe valide créée dans Oracle WebDB. Pour créer des profils utilisateur dans WebDB, contactez votre DBA.


USERID

  Rubriques connexes

Description  USERID correspond au nom utilisateur ou au nom utilisateur de réserve ($username), et au mot de passe ORACLE, associés à un nom de base de données (facultatif), à un protocole de communication Net8 servant à accéder à une base de données distante ou à un nom de source de données ODBC (dans le cas d'un accès à une source de données non-Oracle).

Pour plus d'informations sur le protocole de communication Net8 optionnel, reportez-vous à la rubrique Connexion à distance. Pour plus d'informations sur la connexion automatique, reportez-vous à la rubrique Connexion automatique.

Pour que les utilisateurs se connectent à la base de données, omettez la commande USERID dans la demande d'état. Pour que les utilisateurs se connectent à chaque demande Web, incluez les commandes Web CGI ou Web Cartridge SHOWAUTH et AUTHYPE=D dans l'URL de l'état, ou incluez l'argument %D dans l'entrée d'association de clé, dans le fichier owscmd.dat (Web Cartridge) ou cgicmd.dat (Web CGI).

Valeurs

La chaîne de connexion à la base de données doit prendre l'une des formes indiquées ci-après, mais elle ne peut pas avoir plus de 512 octets de long :

nom_utilisateur[/mot_passe]

nom_utilisateur[/mot_passe][@base_données]

[utilisateur[/mot_passe]]@ODBC:source_données[:base_données] ou [utilisateur[/mot_passe]]@ODBC:*

<$nom_utilisateur>[/mot_passe]

<$nom_utilisateur>[/mot_passe][@base_données]


RWCON60

 Arguments de la ligne de commande 	  Rubriques connexes

Description  RWCON60 permet de convertir une ou plusieurs définitions d'état ou des bibliothèques PL/SQL d'un format en un autre.

RWCON60 permet d'effectuer sur les états les opérations suivantes :

•	conversion d'un état stocké dans la base de données en fichier .rep, .rex ou .rdf, ou en modèle (fichier .tdf) ;

•	conversion d'un état stocké dans un fichier .rdf en fichier .rep ou .rex,, en état de base de données ou en modèle (fichier .tdf) ;

•	conversion d'un état stocké dans un fichier .rex en état de base de données, en fichier .rdf, fichier .rep ou en modèle (fichier .tdf).

RWCON60 permet d'effectuer sur les bibliothèques PL/SQL les opérations suivantes :

•	conversion d'une bibliothèque stockée dans la base de données en fichier .pld ou .pll ;

•	conversion d'une bibliothèque stockée dans un fichier .pld en bibliothèque de base de données ou en fichier .pll ;

•	conversion d'une bibliothèque stockée dans un fichier .pll en bibliothèque de base de données ou en fichiers .pld.

Syntaxe

rwcon60 [ [mot-clé=]valeur ] ...

où mot de passe = valeur représente un argument de ligne de commande valide.

Notes d'utilisation

•	Dans certains cas, la commande Convert compile automatiquement le code PL/SQL de l'état pendant la conversion. Si la destination de la conversion n'est pas un fichier .rex, le code PL/SQL est automatiquement compilé dans les conditions décrites ci-dessous. Dans tous les autres cas, vous devez compiler vous-même le code PL/SQL de l'état (par exemple, Programme [image] Compiler [image] Tout).

•	Vous tentez de créer un fichier .rep en utilisant la commande Convert. En cas d'erreurs de compilation, un message d'erreur apparaît et le fichier .rep n'est pas créé.

•	Vous utilisez un fichier .rex comme état Source. En cas d'erreurs de compilation, un message d'avertissement apparaît, mais la conversion se poursuit.

•	Vous utilisez un état créé sur une autre plate-forme comme état Source. En cas d'erreurs de compilation, un message d'avertissement s'affiche, mais la conversion se poursuit.

•	Le programme établit la correspondance des polices lorsque Report Builder ou Reports Runtime ouvre un état. Cette correspondance n'est pas établie pendant la conversion.

•	Lors de la conversion d'un état en modèle, seuls les objets des pages de garde et de fin de l'état, et de la zone des marges sont utilisés dans le modèle. Les objets du corps de l'état ne sont pas pris en compte.

•	Lors de la conversion d'un état auquel sont attachées des bibliothèques, vous devez convertir les fichiers .pll attachés à l'état avant de convertir le fichier .rdf.


Arguments de la ligne de commande RWCON60

[USERID=]userid

[STYPE=]{DATABASE|PLLDB|PLDFILE|PLLFILE|
RDFFILE|REXFILE|XML}

[SOURCE=]{noms|(noms1,noms2,...)}

[DTYPE=]{DATABASE|PLLDB|PLDFILE|PLLFILE|
RDFFILE|REPFILE|REXFILE|TDFFILE|XML}

[DEST=]{nomd|(nomd1,nomd2,...)|nomchemin}

[CMDFILE=]cmdfile

[LOGFILE=]logfile

[OVERWRITE=]{YES|NO|PROMPT}

[BATCH=]{YES|NO}

[DUNIT=]{CENTIMETER|CHARACTER|INCH|POINT}

[PAGESIZE=]width x height

[FORMSIZE=]largeur x hauteur

[CUSTOMIZE=]filename.xml | (filename1.xml, filename2.xml, . . .)


STYPE

Description  STYPE est le format des états ou des bibliothèques à convertir.

Syntaxe

[STYPE=]{DATABASE|PLLDB|PLDFILE|PLLFILE|RDFFILE|REXFILE|XML}

Valeurs

DATABASE indique que l'état ou les états source sont stockés dans ORACLE.

PLLDB indique que les bibliothèques source PL/SQL sont stockées dans la base de données.

PLDFILE indique que les bibliothèques PL/SQL source sont stockées dans des fichiers en format ASCII.

PLLFILE indique que les bibliothèques PL/SQL source sont stockées dans des fichiers contenant du code Source et du code P.

RDFFILE indique que l'état ou les états source sont stockés dans un ou plusieurs fichiers de définition d'état (fichiers ayant le suffixe .rdf).

REXFILE indique que l'état ou les états source sont stockés dans un ou plusieurs fichiers texte (fichiers ayant le suffixe .rex).

XML indique que les états source sont stockés dans des fichiers XML (fichiers ayant le suffixe .xml).

Valeur par défaut

DATABASE


SOURCE

Description  SOURCE est l'état ou la bibliothèque, ou la liste des états ou des bibliothèques, à convertir. Vous devez indiquer une bibliothèque ou un état source.

Syntaxe

[SOURCE=]{noms|(noms1,noms2,...)}

Valeurs

Tout nom d'état ou de bibliothèque ou nom de fichier valide (par exemple, qanda).

Liste de noms d'état ou de noms de bibliothèque ou de noms de fichier valides, placés entre parenthèses et séparés par des virgules (par exemple, qanda,test,dmast)).

Notes d'utilisation

•	Les caractères génériques SQL (% et _) peuvent être utilisés pour les états ou les bibliothèques stockés dans la base de données. Par exemple, R% extraira de la base de données tous les état qui commencent par R. Tous les états correspondant à cette spécification seront convertis.

•	Une liste de noms d'état ou de bibliothèque ou de noms de fichier doit être placée entre parenthèses, les noms étant séparés par des virgules. Par exemple :

(qanda,test,dmast)

(qanda, test, dmast)

•	Les caractères génériques ne sont pas autorisés pour les états ou les bibliothèques stockés dans des fichiers (c'est-à-dire ayant le suffixe .rdf, .rep, .rex, .pld, .pll).

•	Le ou les arguments de ce mot-clé peuvent dépendre du système d'exploitation.

•	Si vous convertissez des états ou des bibliothèques stockés dans ORACLE et si vous utilisez des tables Report Builder appartenant au système, vous pouvez dresser la liste des états et des bibliothèques des autres utilisateurs, par exemple :

SOURCE=(sday.qanda,dsmith.test,dmast.sal)

•	Si vous utilisez des tables Report Builder appartenant à un utilisateur, vous devez convertir individuellement les états et les bibliothèques de chaque utilisateur.

•	Pour pouvoir convertir les états et les bibliothèques, vous devez les avoir créés ou avoir l'autorisation d'accéder à ceux que vous n'avez pas créés. Si le nom de l'état ou de la bibliothèque n'est pas précédé d'un ID utilisateur, le programme considère qu'il s'agit de l'utilisateur en cours.

•	Si vous demandez la conversion d'une base de données en fichier et si le nom de l'état ou de la bibliothèque de la base de données est trop long pour être un nom de fichier, Report Builder vous demande d'indiquer un nom de fichier de longueur conforme à votre système d'exploitation.


DTYPE

Description  DTYPE est le format dans lequel vous voulez convertir les états ou les bibliothèques.

Syntaxe

[DTYPE=]{DATABASE|PLLDB|PLDFILE|PLLFILE|RDFFILE|REPFILE|REXFILE|TDFFILE}

Valeurs

DATABASE indique que les états convertis seront stockés dans ORACLE.

PLLDB indique que les bibliothèques PL/SQL converties seront stockées dans la base de données.

PLDFILE indique que les bibliothèques PL/SQL converties seront stockées dans des fichiers en format ASCII.

PLLFILE indique que les bibliothèques PL/SQL converties seront stockées dans des fichiers contenant du code Source et du code P.

RDFFILE indique que les états convertis seront stockés dans un ou plusieurs fichiers de définition d'état (fichiers ayant le suffixe .rdf).

REPFILE indique que les états convertis seront stockés dans un ou plusieurs fichiers d'exécution binaires (fichiers ayant le suffixe .rep).

REXFILE indique que les états convertis seront stockés dans un ou plusieurs fichiers texte (fichiers ayant le suffixe .rex).

TDFFILE indique que l'état sera converti en modèle (fichier .tdf).

XML indique que les états de destination sont stockés dans des fichiers XML (fichiers ayant le suffixe .xml).

Valeur par défaut

REXFILE

Notes d'utilisation

•	Lorsque vous tentez de créer un fichier .rep en utilisant RWCON60, le code PL/SQL de l'état source est automatiquement compilé. En cas d'erreurs de compilation, un message d'erreur s'affiche et le fichier .rep n'est pas créé. Pour éviter ce problème, assurez-vous que vous compilez le PL/SQL de l'état source en utilisant Fichier [image] Compiler avant de tenter de créer un fichier .rep.

•	Lors de la conversion d'un état en modèle, seuls les objets des pages de garde et de fin de l'état, et de la zone des marges sont utilisés dans le modèle. Les objets du corps de l'état ne sont pas pris en compte.


DEST

Description  DEST est le nom des états ou des bibliothèques convertis, s'ils sont stockés dans la base de données, ou le nom des fichiers.

Syntaxe

[DEST=]{nomd|(nomd1,nomd2,...)|nomchemin}

Valeurs

Tout nom d'état ou de bibliothèque ou nom de fichier valide (par exemple, qanda).

Liste de noms d'état ou de noms de bibliothèque ou de noms de fichier valides, placés entre parenthèses et séparés par des virgules (par exemple, qanda,test,dmast)).

Valeur par défaut

Si le mot-clé DEST n'est pas indiqué, RWCON60 utilise les noms par défaut suivants :

•	Si DTYPE est DATABASE ou PLLDB, DEST est SOURCE.

•	Si DTYPE est PLDFILE, DEST est SOURCE avec le suffixe .pld.

•	Si DTYPE est PLLFILE, DEST est SOURCE avec le suffixe .pll.

•	Si DTYPE est RDFFILE, DEST est SOURCE avec le suffixe .rdf.

•	Si DTYPE est REPFILE, DEST est SOURCE avec le suffixe .rep.

•	Si DTYPE est REXFILE, DEST est expdat.rex.

Notes d'utilisation

•	Une liste de noms d'état ou de bibliothèque ou de noms de fichier doit être placée entre parenthèses, les noms étant séparés par des virgules. Par exemple :

(qanda,test,dmast)

(qanda, test, dmast)

•	Si vous avez davantage de noms de destination que de noms de source, les noms de destination excédentaires ne sont pas pris en compte. Si vous avez moins de noms de destination que de noms de source, les noms par défaut sont utilisés lorsque la liste des noms de destination est épuisée.

•	Le ou les arguments de ce mot-clé peuvent dépendre du système d'exploitation.


CMDFILE

Description  CMDFILE est un fichier qui contient les arguments de la commande RWCON60. Cette option vous permet de convertir un état ou une bibliothèque sans devoir indiquer un grand nombre d'arguments chaque fois que vous appelez RWCON60.

Syntaxe

[CMDFILE=]cmdfile

Valeurs

Tout fichier de commandes valide.

Notes d'utilisation

•	Un fichier de commandes peut faire référence à un autre fichier de commandes.

•	La syntaxe du fichier de commandes des arguments de RWCON60 est identique à celle utilisée dans la ligne de commande.

•	Les valeurs entrées dans la ligne de commande remplacent les valeurs indiquées dans les fichiers de commandes. Si, par exemple, vous indiquez RWRUN60 dans la ligne de commande, avec COPIES égal à 1 et CMDFILE égal à RUNONE (fichier de commandes) et si, dans RUNONE, COPIES est défini à 2,.le programme ne générera qu'une copie de l'état. Pour plus d'informations, reportez-vous à "Règles de syntaxe de la ligne de commande".

•	Le ou les arguments de ce mot-clé peuvent dépendre du système d'exploitation.


LOGFILE

Description  LOGFILE est le nom du fichier dans lequel sont envoyés l'état et les erreurs.

[LOGFILE=]logfile

Valeurs

Tout nom de fichier valide.

Valeur par défaut

Le fichier dfltrep.log du répertoire en cours.


OVERWRITE

Description  OVERWRITE permet d'indiquer si les fichiers ou les objets de base de données existants seront remplacés par les fichiers ou les objets convertis.

Syntaxe

[OVERWRITE=]{YES|NO|PROMPT}

Valeurs

YES indique que les fichiers ou les objets de base de données seront automatiquement remplacés s'ils ont le même nom.

NO indique que les états ne seront pas convertis s'il existe des fichiers ou des objets de base de données de même nom, et affiche un message d'avertissement.

PROMPT indique que le programme vous enverra un message avant de remplacer un fichier ou un objet de base de données.

Valeur par défaut

NO


BATCH

Description  BATCH permet de supprimer toutes les entrées et les sorties au terminal, afin de convertir les états ou les bibliothèques sans intervention de l'utilisateur.

Syntaxe

[BATCH=]{YES|NO}

Valeurs

YES supprime toutes les entrées et sorties du terminal.

NO autorise les entrées et les sorties spéciales au terminal. Dans ce cas, la boîte de dialogue de conversion s'affiche et, si vous la validez, la conversion est exécutée.

Valeur par défaut

NO


DUNIT

Description  DUNIT est l'unité de mesure de la destination de la conversion de l'état. Si vous l'indiquez, l'unité DUNIT doit être différente de l'unité de mesure de l'état SOURCE. Si vous la laissez en blanc, l'unité de mesure de l'état SOURCE sera utilisée comme unité de mesure de l'état DEST.

Syntaxe

[DUNIT=]{CENTIMETER|CHARACTER|INCH|POINT}

Valeurs

CENTIMETER indique que les états convertis utiliseront au départ le centimètre comme unité de mesure.

CHARACTER indique que les états convertis utiliseront au départ le caractère comme unité de mesure.

INCH indique que les états convertis utiliseront au départ le pouce comme unité de mesure.

POINT indique que les états convertis utiliseront au départ le point comme unité de mesure.

Valeur par défaut

Blanc


PAGESIZE

Description  PAGESIZE est la taille d'une page logique des états convertis, exprimée en unités de mesure de destination (indiquée par le mot-clé DUNIT).

Syntaxe

[PAGESIZE=]width x height

Valeurs

Toute valeur d'unité de mesure valide, sous la forme largeur x hauteur.

Valeur par défaut

En mode bitmap, 8,5 x 11 pouces. En mode caractère, 80 x 66 caractères. Si l'état a été conçu pour le mode caractère et qu'il est exécuté ou converti en mode bitmap, la formule suivante est utilisée pour déterminer la taille de page si aucune n'est précisée : (taille de page par défaut * taille de page en caractères)/taille de page par défaut en caractères. Par exemple, si la taille de page en caractères est de 80 x 20, la taille de page en mode bitmap est égale à : (8,5 * 80)/80 x (11 * 20)/66 = 8,5 x 3,33.

Notes d'utilisation

•	Pour les unités DUNITs en mode autre que caractère, vous pouvez utiliser un séparateur décimal (par exemple, 8.5 x 11).


FORMSIZE

Description  FORMSIZE est la taille de la grille de paramètres d'exécution de l'état converti, exprimée en unités de mesure de destination (indiquée par le mot-clé DUNIT)

Syntaxe

[FORMSIZE=]largeur x hauteur

Valeurs

Toute valeur d'unité de mesure valide, sous la forme largeur x hauteur.

Notes d'utilisation

•	Pour les unités DUNITs en mode autre que caractère, vous pouvez utiliser un séparateur décimal (par exemple, 8.5 x 11).


CUSTOMIZE

Description  CUSTOMIZE indique le fichier ou la liste de fichiers XML à appliquer aux états répertoriés dans le mot-clé SOURCE. Le fichier XML contient des options personnalisées (comme des modifications de police ou de couleur) qui modifient la définition de l'état.

Pour plus d'informations, reportez-vous au manuel Publishing Reports.

Syntaxe

[CUSTOMIZE=]filename.xml | (filename1.xml, filename2.xml, . . .)

Valeurs

Nom de fichier ou liste de noms de fichiers contenant une définition d'état XML valide. Ces noms sont précédés des informations de chemin.


RWMTS60

  Rubriques connexes

Description  RWMTS60 est l'exécutable du serveur Reports Server. Pour mettre en oeuvre une architecture à trois niveaux pour l'exécution de vos états, Reports Server vous permet d'exécuter des états sur un serveur éloigné. Pour démarrer RWMTS60 à partir de la ligne de commande, utilisez RWCLI60.

Lorsqu'il est utilisé avec Reports Web Cartridge, Reports Web CGI ou Reports Servlet, Reports Server permet d'exécuter des états à partir d'un navigateur Web à l'aide d'une syntaxe URL standard. Reports Server peut être installé sous Windows NT, Windows 95 ou UNIX. Les demandes d'exécution d'état, envoyées par les clients, sont placées par Reports Server dans une file d'attente de travaux. Lorsque l'un des moteurs d'exécution du serveur se libère, le travail suivant dans la file d'attente lui est transmis pour exécution. Lorsque le nombre de travaux de la file d'attente augmente, le serveur peut lancer d'autres moteurs d'exécution jusqu'à ce que la limite maximum indiquée au moment du lancement du processus du serveur soit atteinte. De même, lorsqu'ils sont restés inactifs pendant un temps supérieur au temps indiqué, les moteurs inactifs sont arrêtés.

Vous pouvez également utiliser le serveur d'états pour exécuter automatiquement vos états. La commande de planification du serveur d'états vous permet d'indiquer l'heure et la fréquence de l'exécution de l'état. Seuls les états non interactifs (c'est-à-dire ne s'exécutant pas à l'écran et dont la grille de paramètres d'exécution a été supprimée) peuvent être soumis au serveur d'états.Le serveur  d'états garde la trace du nombre maximum prédéfini de travaux écoulés. L'horodatage permet de savoir quand ils ont été mis dans la file d'attente, lancés et (RWRQM60) terminés, ainsi que l'état final de l'état. Ces informations peuvent être extraites et affichées à partir (RWRQV60)du gestionnaire de files d'attente d'états.


RWRQM60

Description  RWRQM60 est l'exécutable de Reports Queue Manager (sur la plate-forme Windows). Lorsque vous utilisez l'exécutable Reports Server (RWMTS60) pour planifier l'exécution des états sur un serveur distant, Reports Queue Manager vous permet d'obtenir des informations sur la date et l'heure de leur mise en file d'attente, de leur lancement et de la fin de leur exécution, ainsi que sur le statut final de l'état. Vous pouvez également manipuler les travaux et le serveur. Reports Queue Manager peut résider sur la même machine que Reports Server ou sur une machine client.

Sur UNIX, vous pouvez utiliser Reports Queue Viewer (RWRQV60) pour visualiser la file d'attente de Reports Server.


RWRQV60

Description  RWRQV60 est l'exécutable Reports Queue Viewer (sur la plate-forme UNIX). Lorsque vous utilisez l'exécutable Reports Server (RWMTS60) pour planifier l'exécution d'états sur un serveur distant, Reports Queue Viewer vous permet de visualiser la file d'attente de Reports Server. Sur la ligne de commande, entrez RWRQV60 "?" pour obtenir de l'aide sur les touches.

Sur Windows, vous pouvez utiliser Reports Queue Manager (RWRQM60) pour visualiser et manipuler la file d'attente de Reports Server.


RWOWS60

Description  RWOWS60 est le programme Reports Web Cartridge qui permet une connexion aisée entre le serveur d'applications Web Oracle et le serveur d'états (RWMTS60). Cette connexion permet à un client Web d'exécuter un état sur le serveur d'états et de voir la sortie de cet état dans le navigateur Web client. Comme les autres Web Cartridges, RWOWS60 est une bibliothèque liée, ou partagée, de façon dynamique et gérée par un Web Request Broker, lequel est associé en particulier à un Oracle Web Application Server Listener. RWOWS60 représente une alternative à Reports Web CGI (RWCGI60) et offre les mêmes fonctionnalités, mais il possède également une intégration native avec le serveur d'applications Web Oracle.


RWRBE60

  Rubriques connexes

Description RWRBE60 est le moteur d'arrière-plan de Reports. Ce moteur attend des lignes de commande pour exécuter des états. Lorsqu'il reçoit une ligne de commande, il entre l'état dans sa file d'attente. En général, il reçoit des lignes de commande d'une application Forms ou d'un graphique utilisant la procédure en package RUN_PRODUCT, ou d'un état utilisant SRW.RUN_REPORT.

Syntaxe

rwrbe60

Notes d'utilisation

•	Dans les précédentes versions, RWRBE60 s'appelait R25SRV.

•	Vous pouvez aussi lancer l'exécutable RWRBE60 en cliquant deux fois sur celui-ci.

•	Sous Windows, vous pouvez utiliser RWISV60 pour soumettre un état au moteur d'arrière-plan de Reports en vue de son exécution. Cette méthode est plus efficace, car elle a une incidence moindre que Reports Runtime sur les performances. Les arguments de ligne de commande de RWISV60 sont les mêmes que ceux de RWRUN60.

•	RWRBE60 n'est utilisé que pour exécuter des états localement. Pour envoyer des états au serveur d'états (RWMTS60), utilisez RWCLI60.

•	RWRBE60 maintient ouverte la session de base de données à laquelle il est connecté, jusqu'à ce que RWRBE60 exécute un état dans une autre base de données. Ceci permet de réduire le temps de connexion à la base de données.


RWRUN60

  Arguments de ligne de commande 	  Rubriques connexes

Description  RWRUN60 exécute un état (c'est-à-dire un fichier .rdf ou .rep) de façon interactive ou par lots.

Syntaxe

RWRUN60 [ [mot de passe=]valeur|(valeur1, valeur2, ...) ]

où mot de passe = valeur représente un argument de ligne de commande valide.

Notes d'utilisation

•	Si vous exécutez un fichier .rep, le code PL/SQL est déjà compilé et ne le sera pas à nouveau. Si vous exécutez un fichier .rdf, le code PL/SQL est automatiquement recompilé lorsque cela s'avère nécessaire (si vous n'avez pas compilé et enregistré l'état depuis Report Builder, ou que la plate-forme ou la version sur laquelle vous exécutez l'état est incompatible avec la plate-forme sur laquelle il a été compilé et enregistré pour la dernière fois).

•	Deux versions de l'exécutable RWRUN60 sont disponibles. Notez que ces deux versions permettent d'exécuter des états en mode caractère ou en mode bitmap. Le seul facteur restrictif est le périphérique de sortie (vous ne pouvez pas, par exemple, exécuter un état en mode bitmap sur l'écran d'un vt220).

•	L'exécutable en mode caractère est destiné aux utilisateurs qui exécutent des états à partir d'ordinateurs en mode caractère (par exemple, VT220).

•	L'exécutable avec interface graphique est destiné aux utilisateurs qui exécutent des états à partir d'ordinateurs en mode bitmap (par exemple, un PC sous Windows).


Arguments de ligne de commande RWRUN60

[MODULE|REPORT=]runfile

[USERID=]userid

[PARAMFORM=]{YES|NO}

[CMDFILE=]cmdfile

[TERM=]termfile

[ARRAYSIZE=]n

[DESTYPE=]{SCREEN|FILE|PRINTER|PREVIEW|SYSOUT|MAIL}]

[DESNAME=]desname

[DESFORMAT=]desformat

[CACHELOB=]{YES|NO}

[COPIES=]n

[CURRENCY=]currency_symbol

[THOUSANDS=]thousands_symbol

[DECIMAL=]decimal_symbol

[READONLY=]{YES|NO}

[LOGFILE=]logfile

[BUFFERS=]n

[BATCH=]{YES|NO}

[PAGESIZE=]width x height

[PROFILE=]profiler_file

[RUNDEBUG=]{YES|NO}

[ONSUCCESS=]{COMMIT|ROLLBACK|NOACTION}

[ONFAILURE=]{COMMIT|ROLLBACK|NOACTION}

[KEYIN=]keyin_file

[KEYOUT=]keyout_file

[ERRFILE=]error_file

[LONGCHUNK=]n

[ORIENTATION=]{DEFAULT|LANDSCAPE|PORTRAIT}

[BACKGROUND=]{YES|NO}

[MODE=]{BITMAP|CHARACTER|DEFAULT}

[PRINTJOB]{YES|NO}

[TRACEFILE=]tracefile

[TRACEMODE=]{TRACE_APPEND|TRACE_REPLACE}

[TRACEOPTS=]{TRACE_ERR|TRACE_PRF|TRACE_APP|TRACE_PLS|
TRACE_SQL|TRACE_TMS|TRACE_DST|TRACE_ALL|(opt1, opt2, ...)}

[AUTOCOMMIT=]{YES|NO}

[NONBLOCKSQL=]{YES|NO}

[ROLE=]rolename/[rolepassword]

[BLANKPAGES=]{YES|NO}

[DISABLEPRINT=]{YES|NO}

[DISABLEMAIL=]{YES|NO}

[DISABLEFILE=]{YES|NO}

[DISABLENEW=]{YES|NO}

[DELIMITER=]value

[CELLWRAPPER=]value

[DATEFORMATMASK=]mask

[NUMBERFORMATMASK=]mask

[DESTINATION=]filename.DST

[DISTRIBUTE=]{YES|NO}

[PAGESTREAM=]{YES|NO}

EXPRESS_SERVER="server=[server]/domain=[domain]/user=[userid]/password=[passwd]"

[CUSTOMIZE]=filename.xml | (filename1.xml, filename2.xml, . . .)

[SAVE_RDF]=filename.rdf

<param>=value


MODULE/REPORT
MODULE|REPORT

  Restrictions	  Rubriques connexes

Description  MODULE|REPORT désigne le nom de l'état à exécuter. (REPORT est admis pour des raisons de compatibilité descendante.)

Syntaxe

[MODULE|REPORT=]runfile

Valeurs

Tout fichier d'exécution valide (c'est-à-dire tout fichier portant l'extension .rdf ou .rep) ou la définition d'un état XML. Si vous ne précisez aucune extension de fichier, Reports Runtime recherche d'abord un fichier portant l'extension .rep, puis l'extension .rdf, et enfin aucune extension. Reports Runtime recherche le fichier en fonction de l'ordre de priorité précité.

Notes d'utilisation

•	Pour que vous puissiez exécuter l'état, sa définition doit être complète (elle doit contenir son propre modèle de données et sa propre définition de présentation). Vous ne pouvez pas exécuter une définition d'état partielle.

•	Une définition d'état XML doit porter l'extension de fichier .XML lorsqu'elle est indiquée avec le mot-clé MODULE|REPORT.


MODULE|REPORT - Restrictions

  Rubriques connexes

•	Si vous indiquez un fichier d'exécution à l'aide de MODULE|REPORT, la fenêtre de RWRUN60 n'apparaît pas, ce qui permet d'accéder à RWRUN60 de façon transparente à partir d'autres applications. Si vous ne précisez aucun fichier d'exécution avec MODULE/REPORT et que vous indiquez BATCH=NO, la fenêtre de RWRUN60 apparaît ; elle vous permet d'exécuter des états de façon interactive.

•	Si vous exécutez un état en mode caractère via RWRUN60 en mode bitmap, Reports Runtime affiche un message d'avertissement, puis exécute l'état sous un format de page de 8,5 x 11 po et une taille de grille de 7 x 6 po.


PARAMFORM

  Rubriques connexes

Description  PARAMFORM indique si la grille de paramètres d'exécution doit être affichée lorsque vous exécutez un état.

Syntaxe

[PARAMFORM=]{YES|NO}

Valeurs

YES demande d'afficher la grille.

NO demande de supprimer la grille.

Valeur par défaut

YES

Notes d'utilisation

PARAMFORM=YES est incompatible avec BATCH=YES, car l'affichage de la grille de paramètres d'exécution en mode de traitement par lots ne présente aucun intérêt.


CMDFILE

  Restrictions	  Rubriques connexes

Description  CMDFILE désigne un fichier contenant des arguments de commande RWRUN60. Cette option permet d'exécuter un état sans avoir à indiquer un grand nombre d'arguments chaque fois que vous appelez RWRUN60.

Syntaxe

[CMDFILE=]cmdfile

Valeurs

Tout fichier de commandes valide.


CMDFILE - Restrictions

•	Un fichier de commandes peut faire référence à un autre fichier de commandes.

•	La syntaxe des arguments de RWRUN60 dans le fichier de commandes est la même que celle utilisée sur la ligne de commande.

•	Les valeurs entrées sur la ligne de commande ont préséance sur celles indiquées dans les fichiers de commandes. Par exemple, si vous saisissez RWRUN60 sur la ligne de commande avec COPIES égal à 1 et CMDFILE égal à RUNONE (fichier de commandes). Dans RUNONE, COPIES est égal à 2. Dans ce cas, l'état est généré à un seul exemplaire.

•	Le ou les arguments de ce mot-clé peuvent dépendre du système d'exploitation.


TERM

  Rubriques connexes

Description  TERM désigne le type de terminal sur lequel vous utilisez RWRUN60. TERM n'est utile que pour la grille de paramètres d'exécution et l'Aperçu interactif Runtime. Ce mot-clé n'est utilisé qu'en mode caractère.

Syntaxe

[TERM=]termtype

Valeurs

Tout type de terminal valide.

Valeur par défaut

Fonction de l'installation. (Pour obtenir une définition compatible, adressez-vous à l'administrateur de votre système.)

Notes d'utilisation

•	Le ou les arguments de ce mot-clé peuvent faire la distinction entre majuscules et minuscules, selon les systèmes d'exploitation.


ARRAYSIZE

  Rubriques connexes

Description  ARRAYSIZE désigne la taille (exprimée en kilo-octets) utilisée avec le traitement par tableau ORACLE. Généralement, plus cette taille est élevée, plus l'exécution de l'état est rapide.

Syntaxe

[ARRAYSIZE=]n

Valeurs

Nombre compris entre 1 et 9 999 : Reports Runtime peut utiliser ce nombre de kilo-octets de mémoire par interrogation de l'état.

Valeur par défaut

La taille de tableau par défaut est de 10 Ko. Pour plus de détails sur le traitement par tableau ORACLE, reportez-vous au manuel Oracle8 Server Administrator's Guide.


DESTYPE

  Rubriques connexes

Description  DESTYPE désigne le type de périphérique qui doit recevoir la sortie d'état.

Syntaxe

[DESTYPE=]{SCREEN|FILE|PRINTER|PREVIEW|SYSOUT|MAIL}

Valeurs

SCREEN	Dirige la sortie vers l'Aperçu pour une prévisualisation interactive. Cette valeur n'est valide que lorsque BATCH=NO. Le lissage des polices n'est pas effectué pour cette valeur.
FILE	Enregistre la sortie dans le fichier indiqué dans DESNAME (prochain mot-clé abordé).
PRINTER	Dirige la sortie vers l'imprimante indiquée dans DESNAME (prochain mot-clé abordé).
PREVIEW	Dirige la sortie vers l'Aperçu pour une prévisualisation interactive. Cependant, la sortie est mise au format PostScript. L'Aperçu utilise DESNAME pour déterminer les polices d'imprimante à utiliser pour afficher la sortie. Le lissage des polices est effectué pour cette valeur.
SYSOUT	Envoie la sortie au périphérique de sortie par défaut de votre système d'exploitation. Cette valeur n'est valide que lorsque BATCH=YES.
MAIL	Envoie la sortie aux utilisateurs de courrier indiqués dans DESNAME. Vous pouvez envoyer du courrier à tout système de courrier compatible MAPI ou disposant du pilote prestataire de services. L'état est envoyé en tant que fichier joint.
Valeur par défaut

Issue de la propriété Valeur initiale du paramètre DESTYPE.

Notes d'utilisation

•	Si vous donnez à DESTYPE la valeur PRINTER, FILE ou MAIL, la boîte de dialogue d'impression de travaux apparaît dès que vous avez accepté la grille de paramètres d'exécution, à moins que celle-ci ne soit supprimée. Une fois que vous avez accepté la boîte de dialogue, l'état est exécuté et la sortie est envoyée à l'imprimante (indiquée dans Fichier [image] Choisir l'imprimante), dans un fichier ou à un ID de courrier électronique. (Si DESTYPE a une valeur autre que PRINTER, FILE ou MAIL, l'état est exécuté dès que vous avez accepté la grille de paramètres d'exécution.) La boîte de dialogue diffère selon les systèmes d'exploitation.

•	Dans certains cas, ce paramètre peut ne pas être pris en compte par votre système d'exploitation.

•	Toutes les valeurs de DESTYPE ne sont pas prises en charge par tous les systèmes d'exploitation.


DESNAME

  Rubriques connexes

Description  DESNAME désigne le nom du fichier, de l'imprimante ou de l'ID courrier électronique (ou de la liste de diffusion) auquel la sortie d'état est envoyée. Pour l'envoyer via courrier électronique, indiquez le destinataire (ID) comme vous le feriez dans votre application de courrier électronique (toute application compatible MAPI sur Windows ou votre application de courrier électronique native sur UNIX). Vous pouvez indiquer plusieurs noms utilisateur en mettant ces noms entre parenthèses et en les séparant par des virgules, de la manière suivante : (nom, nom, . . .nom).

Syntaxe

[DESNAME=]desname

Valeurs

Tout nom de fichier, nom d'imprimante ou ID de courrier électronique valide dont la longueur ne dépasse pas 1 Ko. En ce qui concerne les noms d'imprimante, vous pouvez éventuellement préciser un port. Par exemple :

DESNAME=printer,LPT1:

DESNAME=printer,FILE:

Valeur par défaut

Issue de la propriété Valeur initiale du paramètre DESNAME. Si DESTYPE=FILE et que DESNAME est une chaîne vide, sa valeur par défaut au moment de l'exécution est reportname.lis.

Notes d'utilisation

•	Ce mot-clé n'est pas pris en compte si DESTYPE a pour valeur SCREEN ou SYSOUT.

•	Si DESTYPE a pour valeur PREVIEW, Reports Runtime utilise DESNAME pour déterminer les polices d'imprimante à utiliser pour afficher la sortie.

•	Le ou les arguments de ce mot-clé peuvent faire la distinction entre majuscules et minuscules, selon les systèmes d'exploitation.

•	Dans certains cas, ce paramètre peut ne pas être pris en compte par votre système d'exploitation.


DESFORMAT

  Rubriques connexes

Description  Dans les environnements en mode bitmap, DESFORMAT désigne le pilote d'imprimante à utiliser lorsque DESTYPE a pour valeur FILE. Dans les environnements en mode caractère, il indique les caractéristiques de l'imprimante indiquée dans DESNAME.

Syntaxe

[DESFORMAT=]desformat

Valeurs

Tout format de destination valide dont la longueur ne dépasse pas 1 Ko. Voici quelques exemples de valeurs valides : hpl, hplwide, dec, decwide, decland, dec180, dflt, wide, etc. Pour obtenir la liste des formats de destination valides, adressez-vous à l'administrateur de votre système. Report Builder prend également en charge les formats de destination suivants :

PDF	La sortie d'état est envoyée vers un fichier lisible par un visualiseur PDF. La sortie PDF est basée sur l'imprimante actuellement configurée sur votre système. Les pilotes de cette imprimante sont utilisés pour générer la sortie ; vous devez donc disposer d'une imprimante configurée pour l'ordinateur sur lequel vous exécutez l'état.
HTML	La sortie d'état est envoyée vers un fichier lisible par un navigateur compatible HTML 3.0 (par exemple, Netscape 2.2).
HTMLCSS	La sortie d'état envoyée vers un fichier comprend des extensions de feuille de style lisibles par un navigateur compatible HTML 3.0 prenant en charge les feuilles de style en cascade.
HTMLCSSIE	La sortie d'état envoyée vers un fichier comprend des extensions de feuille de style lisibles par Microsoft Internet Explorer 3.x.
RTF	La sortie d'état est envoyée vers un fichier lisible par les logiciels de traitement de texte standard (tels que Microsoft Word). Notez que lorsque vous ouvrez un fichier dans Word, vous devez choisir Affichage [image] Page pour afficher tous les graphiques et les objets de votre état.
XML	Signifie que la sortie d'état sera un document XML enregistré en tant que fichier distinct portant l'extension .XML. Vous pouvez ouvrir cet état et le lire dans un navigateur compatible XML ou dans toute autre application d'affichage XML.
DELIMITED	La sortie d'état est envoyée vers un fichier lisible par les tableurs standard, comme Microsoft Excel. Notez que vous devez également indiquer un DELIMITER.
Valeur par défaut

Issue de la propriété Valeur initiale du paramètre DESFORMAT. Pour Reports Runtime en mode bitmap, si DESFORMAT est vierge ou qu'il est défini sur sa valeur par défaut, l'imprimante indiquée dans Fichier [image] Choisir l'imprimante est utilisée. Si aucune imprimante n'est sélectionnée, Postscript est utilisé par défaut.

Notes d'utilisation

•	Ce mot-clé n'est pas pris en compte si DESTYPE a pour valeur SCREEN ou SYSOUT.

•	La ou les valeurs de ce mot-clé peuvent faire la distinction entre majuscules et minuscules, selon votre système d'exploitation.


COPIES

  Rubriques connexes

Description  COPIES désigne le nombre d'exemplaires de la sortie d'état à imprimer.

Syntaxe

[COPIES=]n

Valeurs

Tout nombre entier valide compris entre 1 et 9 999.

Valeur par défaut

Issue de la propriété Valeur initiale du paramètre COPIES.

Notes d'utilisation

•	Ce mot-clé est ignoré si DESTYPE n'est pas défini sur Printer.

•	Si COPIES est vierge dans la grille de paramètres d'exécution, il prend pour valeur par défaut 1.


CACHELOB

  Rubriques connexes

Description  CACHELOB indique si les objets Oracle8 volumineux extraits doivent être mis en mémoire cache dans le répertoire de fichiers temporaires (indiqué dans REPORTS60_TMP).

Valeurs

YES indique de mettre le LOB en mémoire cache dans le répertoire de fichiers temporaires.

NO indique de ne pas le faire.

Valeur par défaut

YES

Notes d'utilisation

•	Vous ne pouvez définir cette option que sur la ligne de commande.

•	Si l'emplacement du répertoire de fichiers temporaires ne dispose pas de suffisamment d'espace disque, définissez cette valeur sur NO. Dans ce cas, les performances peuvent cependant être réduites, car le LOB doit parfois être extrait plusieurs fois du serveur.


CURRENCY

  Rubriques connexes

Description  CURRENCY désigne le symbole monétaire utilisé dans les formats numériques.

Syntaxe

[CURRENCY=]currency_symbol

Valeurs

Toute chaîne alphanumérique valide dont la longueur ne dépasse pas 1 Ko.

Valeur par défaut

La valeur par défaut pour ORACLE est déterminée par ORACLE National Language Support. Vous pouvez également définir une valeur par défaut de quatre caractères maximum dans le champ Valeur initiale de la fenêtre de propriétés Paramètre du paramètre CURRENCY.

Notes d'utilisation

•	Une valeur CURRENCY entrée dans la grille de paramètres d'exécution a préséance sur toute valeur CURRENCY entrée sur la ligne de commande.


THOUSANDS

  Rubriques connexes

Description  THOUSANDS désigne le séparateur des milliers à utiliser dans les formats numériques.

Syntaxe

[THOUSANDS=]thousands_symbol

Valeurs

Tout caractère alphanumérique valide.

Valeur par défaut

La valeur par défaut pour ORACLE est déterminée par ORACLE National Language Support. Vous pouvez également définir une valeur par défaut dans la propriété Valeur initiale du paramètre THOUSANDS.

Notes d'utilisation

•	Une valeur THOUSANDS entrée dans la grille de paramètres d'exécution a préséance sur toute valeur THOUSANDS entrée sur la ligne de commande.

• 	Le caractère alphanumérique défini comme valeur THOUSANDS correspond à la valeur renvoyée. Par exemple, si vous définissez "," comme valeur THOUSANDS, "," est renvoyée.


DECIMAL

  Rubriques connexes

Description  DECIMAL désigne le séparateur décimal à utiliser dans les formats numériques.

Syntaxe

[DECIMAL=]decimal_symbol

Valeurs

Tout caractère alphanumérique valide.

Valeur par défaut

La valeur par défaut pour ORACLE est déterminée par ORACLE National Language Support. Vous pouvez également définir une valeur par défaut dans la propriété Valeur initiale du paramètre DECIMAL.

Notes d'utilisation

•	Une valeur DECIMAL entrée dans la grille de paramètres d'exécution a préséance sur toute valeur DECIMAL entrée sur la ligne de commande.

• 	Le caractère alphanumérique défini comme valeur DECIMAL correspond à la valeur renvoyée. Par exemple, si vous définissez "." comme valeur DECIMAL, "." est renvoyée.


READONLY

  Rubriques connexes

Description  READONLY demande la cohérence en lecture pour plusieurs interrogations d'un état. Lorsque vous accédez à des données à partir d'ORACLE, la cohérence en lecture est assurée par une instruction SET TRANSACTION READ ONLY (pour plus d'informations sur SET TRANSACTION READ ONLY, reportez-vous au manuel ORACLE8 Server SQL Language Reference Manual).

Syntaxe

[READONLY=]{YES|NO}

Valeurs

YES demande la cohérence en lecture.

NO ne garantit pas la cohérence en lecture.

Valeur par défaut

NO

Notes d'utilisation

•	READONLY n'est utile que pour les états utilisant plusieurs interrogations, car ORACLE garantit automatiquement la cohérence en lecture, sans verrouillage, pour les états à une seule interrogation.


LOGFILE

  Rubriques connexes

Description  LOGFILE indique le nom du fichier dans lequel est envoyée la sortie Fichier [image] Impr écran. Si le fichier indiqué existe déjà, la sortie lui est ajoutée. Ce mot-clé n'est utilisé qu'en mode caractère.

Syntaxe

[LOGFILE=]logfile

Valeurs

Tout nom de fichier valide.

Valeur par défaut

Le fichier dfltrep.log du répertoire en cours.


BUFFERS

  Rubriques connexes

Description  BUFFERS indique la taille de la mémoire cache virtuelle, exprimée en kilo-octets. Adaptez ce paramètre afin de disposer de suffisamment de mémoire pour exécuter vos états, sans pour autant gaspiller les ressources de votre système.

Syntaxe

[BUFFERS=]n

Valeurs

Un nombre compris entre 1 et 9 999. La limite supérieure peut être plus faible avec certains systèmes d'exploitation.

Valeur par défaut

640 Ko

Notes d'utilisation

•	Si ce paramètre est modifié en cours de session, la modification n'est prise en compte que lors de l'exécution de l'état suivante.


BATCH

  Rubriques connexes

Description  BATCH supprime toutes les entrées et sorties du terminal, afin d'exécuter les états sans intervention de l'utilisateur. BATCH=YES vous permet d'exécuter votre état sans activer l'interface de RWRUN60. Pour exécuter des états en arrière-plan, reportez-vous au paramètre BACKGROUND.

Syntaxe

[BATCH=]{YES|NO}

Valeurs

YES supprime toutes les entrées et sorties du terminal.

NO autorise des entrées et des sorties spéciales du terminal.

Valeur par défaut

NO

Notes d'utilisation

•	Si BATCH=YES, les messages d'erreur sont envoyés à SYSOUT. Pour plus d'informations sur SYSOUT, reportez-vous à DESNAME.

•	Si BATCH=YES, PARAMFORM=YES n'est pas valide car l'affichage de la grille de paramètres d'exécution en mode de traitement par lots ne présente aucun intérêt.

•	Si BATCH=NO et que vous utilisez RWRUN60 en mode caractère, les états en mode bitmap ne peuvent pas être exécutés. (Il n'est pas possible d'envoyer un état en mode bitmap sur l'écran d'un périphérique en mode caractère.)

•	Si BATCH=YES et MODE=BITMAP, et que vous utilisez RWRUN60 en mode caractère, vous ne pouvez pas exécuter un état en mode caractère.


PAGESIZE

  Rubriques connexes

Description  PAGESIZE désigne les dimensions de la page physique (c'est-à-dire de la feuille sortant de l'imprimante). Notez que cette page doit être assez large pour contenir l'état. Par exemple, si le cadre d'un état s'étend au-delà des dimensions de la page, cet état n'est pas exécuté.

Syntaxe

[PAGESIZE=]width x height

Valeurs

Toutes dimensions de page valides, sous la forme : largeur de page x hauteur de page, où la largeur de page et la hauteur de page sont égales ou supérieures à zéro. Les valeurs maximales pour la largeur et la hauteur dépendent de l'unité de mesure. Elle est de 512 pouces, 1 312 centimètres ou 36 864 picas.

Valeur par défaut

En mode bitmap, 8,5 x 11 pouces. En mode caractère, 80 x 66 caractères. Si l'état a été conçu pour le mode caractère et qu'il est exécuté ou converti en mode bitmap, la formule suivante est utilisée pour déterminer la taille de page si aucune n'est précisée : (taille de page par défaut * taille de page en caractères)/taille de page par défaut en caractères. Par exemple, si la taille de page en caractères est de 80 x 20, la taille de page en mode bitmap est égale à : (8,5 * 80)/80 x (11 * 20)/66 = 8,5 x 3,33.

Notes d'utilisation

•	Sur certaines imprimantes, la zone imprimable de la page physique est limitée. Par exemple, la feuille de papier insérée dans l'imprimante peut mesurer 8,5 x 11 po, mais l'imprimante ne peut imprimer que sur une surface de 8 x 10,5 po. Si vous définissez dans Reports Runtime une largeur de page x hauteur de page supérieure à la zone imprimable autorisée par votre imprimante, votre état risque d'être tronqué. Pour éviter ce problème, vous pouvez augmenter la zone imprimable de votre imprimante (si votre système d'exploitation le permet) ou adapter la largeur de page x hauteur de page à la taille de la zone imprimable sur la page.

•	Si ce mot-clé est utilisé, sa valeur a préséance sur les dimensions de page de la définition d'état.

•	Une valeur PAGESIZE entrée dans la grille de paramètre d'exécution a préséance sur toute valeur PAGESIZE entrée sur la ligne de commande.


PROFILE

  Rubriques connexes

Description  PROFILE désigne le nom d'un fichier dans lequel vous pouvez stocker des statistiques de performances sur l'exécution des états. Si vous indiquez un nom de fichier, Reports Runtime calcule les statistiques sur le temps écoulé et le temps CPU nécessaires à l'exécution d'un état. PROFILE calcule les statistiques suivantes :

•	TEMPS TOTAL ECOULE désigne le temps écoulé entre le moment où vous avez lancé la commande RWRUN60 et la fin de l'exécution de l'état. TEMPS TOTAL ECOULE correspond à la somme de Reports Runtime Time et de Heure ORACLE.

•	Time désigne le temps écoulé dans Reports Runtime.

•	Heure ORACLE désigne le temps écoulé dans la base de données et contient les éléments suivants :

•	UPI indique le temps nécessaire à des tâches telles que la connexion à la base de données, l'analyse de SQL et l'extraction des données.

•	SQL indique le temps nécessaire à l'exécution de SRW.DO_SQL.

•	Temps CPU TOTAL utilisé par le processus indique le temps CPU nécessaire à l'exécution de l'état.

Remarque : Avec certains systèmes d'exploitation, Reports Runtime Time comprend le temps passé dans la base de données car celle-ci est incluse dans le processus Reports Runtime.

Syntaxe

[PROFILE=]profiler_file

Valeurs

Tout nom de fichier valide dans le répertoire en cours.


RUNDEBUG

  Rubriques connexes

Description  RUNDEBUG vous permet de préciser si vous désirez, au moment de l'exécution, une vérification supplémentaire des erreurs logiques de l'état. RUNDEBUG contrôle les points qui ne constituent pas des erreurs, mais qui peuvent entraîner des résultats indésirables. RUNDEBUG vérifie les points suivants :

•	Cadres ou cadres itératifs qui se chevauchent mais n'englobent aucun autre objet. Cela peut causer l'écrasement d'objets par d'autres dans la sortie.

•	Objets de présentation avec des références dépendant de la pagination qui n'ont pas de taille fixe. Reports Runtime attribue à ces objets une taille fixe indépendamment du paramétrage de leurs propriétés Elasticité verticale et Elasticité horizontale.

•	Variables de liens référencées selon une fréquence erronée dans PL/SQL.

•	Etat en mode caractère et environnement en mode bitmap, ou vice versa.

Syntaxe

[RUNDEBUG=]{YES|NO}

Valeurs

YES exécute une vérification supplémentaire des erreurs au moment de l'exécution.

NO n'exécute pas de vérification supplémentaire des erreurs au moment de l'exécution.

Valeur par défaut

NO


ONSUCCESS

  Rubriques connexes

Description  ONSUCCESS permet d'indiquer si vous désirez lancer une opération COMMIT ou ROLLBACK à la fin de l'exécution de l'état.

Syntaxe

[ONSUCCESS=]{COMMIT|ROLLBACK|NOACTION}

Valeurs

COMMIT effectue une opération COMMIT lorsque l'état est terminé.

ROLLBACK effectue une opération ROLLBACK lorsque l'état est terminé.

NOACTION n'effectue aucune opération lorsque l'état est terminé.

Valeur par défaut

COMMIT, si un USERID est fourni.

NOACTION, dans le cas d'un appel provenant d'une source externe (par exemple, Oracle Forms) sans précision de USERID.

Notes d'utilisation

•	L'opération COMMIT ou ROLLBACK pour ONSUCCESS est effectuée après l'activation du déclencheur After Report. D'autres opérations COMMIT et ROLLBACK peuvent se produire avant celle-ci. Pour plus d'informations, reportez-vous à READONLY.


ONFAILURE

  Rubriques connexes

Description  ONFAILURE permet d'indiquer si vous désirez lancer une opération COMMIT ou ROLLBACK si une erreur survient et que l'exécution de l'état est interrompue.

Syntaxe

[ONFAILURE=]{COMMIT|ROLLBACK|NOACTION}

Valeurs

COMMIT effectue une opération COMMIT si l'état échoue.

ROLLBACK effectue une opération ROLLBACK si l'état échoue.

NOACTION n'effectue aucune opération si l'état échoue.

Valeur par défaut

ROLLBACK, si un USERID est fourni.

NOACTION, dans le cas d'un appel provenant d'une source externe (par exemple, Form Builder) sans précision de USERID.

Notes d'utilisation

•	L'opération COMMIT ou ROLLBACK pour ONFAILURE est effectuée après l'échec de l'état. D'autres opérations COMMIT et ROLLBACK peuvent se produire avant celle-ci. Pour plus d'informations, reportez-vous à READONLY.


KEYIN

  Rubriques connexes

Description  KEYIN indique le nom du fichier de séquences de touches à exécuter au moment de l'exécution. KEYIN permet d'exécuter les fichiers de séquences de touches créés avec KEYOUT. KEYIN étant utilisé pour exécuter un fichier de séquences de touches, il n'est pertinent que dans un environnement en mode caractère.

Syntaxe

[KEYIN=]keyin_file

Valeurs

Tout nom de fichier de séquences de touches valide dans le répertoire en cours.


KEYOUT

  Rubriques connexes

Description  KEYOUT indique le nom du fichier de séquences de touches dans lequel vous voulez que Reports Runtime enregistre toutes vos séquences de touches. Vous pouvez ensuite recourir à KEYIN pour exécuter ce fichier de séquences de touches. KEYOUT et KEYIN sont utiles si vous devez exécuter certaines séquences de touches chaque fois que vous exécutez un état, ainsi qu'à des fins de débogage. KEYOUT étant utilisé pour créer un fichier de séquences de touches, il n'est pertinent que dans un environnement en mode caractère.

Syntaxe

[KEYOUT=]keyout_file

Valeurs

Tout nom de fichier valide.


ERRFILE

  Rubriques connexes

Description  ERRFILE indique le nom du fichier dans lequel vous voulez que Reports Runtime enregistre tous les messages d'erreur qui surviennent pendant l'exécution de votre état.

Syntaxe

[ERRFILE=]error_file

Valeurs

Tout nom de fichier valide.


LONGCHUNK

  Rubriques connexes

Description  LONGCHUNK désigne la taille (exprimée en kilo-octets) des incréments selon lesquels Reports Runtime extrait une valeur de colonne de type LONG. Lors de l'extraction d'une valeur de type LONG, il peut être préférable de procéder par incréments plutôt qu'en une seule fois afin de ne pas dépasser les limitations de taille mémoire. LONGCHUNK ne s'applique qu'à Oracle7 et à Oracle8.

Syntaxe

[LONGCHUNK=]n

Valeurs

Un nombre compris entre 1 et 9 999. La limite supérieure peut être plus faible avec certains systèmes d'exploitation.

Valeur par défaut

10 Ko


ORIENTATION

  Rubriques connexes

Description  ORIENTATION contrôle l'orientation selon laquelle les pages de l'état sont imprimées.

Syntaxe

[ORIENTATION=]{DEFAULT|LANDSCAPE|PORTRAIT}

Valeurs

DEFAULT utilise les paramètres d'orientation par défaut de l'imprimante en cours.

LANDSCAPE

PORTRAIT

Valeur par défaut

DEFAULT

Notes d'utilisation

•	Si ORIENTATION=LANDSCAPE pour un état en mode caractère, vous devez vous assurer que votre fichier de définition d'imprimante contient une clause paysage.

•	Les paramètres d'orientation sont ignorés lorsque vous imprimez des états sur une imprimante PCL fonctionnant sous Motif. L'état est traité avec les paramètres par défaut.


BACKGROUND

  Rubriques connexes

Description  BACKGROUND indique si l'état doit être exécuté en arrière-plan. Lorsque BACKGROUND est défini sur YES, un autre processus est lancé. Cette option est utile lorsque vous souhaitez effectuer une autre tâche au premier plan pendant l'exécution de votre état. Sous Windows, BACKGROUND=YES place l'état dans la file d'attente de Reports Background Engine.

Syntaxe

[BACKGROUND=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO

Notes d'utilisation

•	Sous Windows, vous pouvez utiliser RWRBE60 pour soumettre un état à Reports Background Engine pour exécution. Cette méthode est plus efficace car elle induit moins de charge sur les performances que Reports Runtime. Les arguments de ligne de commande de RWRBE60 sont les mêmes que ceux de RWRUN60.

•	Sur la ligne de commande, BACKGROUND=YES n'est pas pris en charge avec BATCH=YES, DESTYPE=SCREEN ou PREVIEW, ni RWBLD60. Cependant, si vous utilisez SRW.RUN_REPORT, BACKGROUND=YES est pris en charge avec BATCH=YES.

•	Si vous exécutez un état à partir de Reports Runtime (et non à partir de la ligne de commande ou de SRW.RUN_REPORT), vous devez enregistrer les modifications apportées à la base de données dans les déclencheurs Before Form, After Form et Validation avant d'exécuter l'état. Ainsi, ces déclencheurs partagent la connexion de base de données du processus père. Une fois l'état exécuté, cependant, il établit sa propre connexion de base de données.


MODE

  Rubriques connexes

Description  MODE indique si l'état doit être exécuté en mode caractère ou en mode bitmap. Cela vous permet d'exécuter un état en mode caractère à partir de Reports Runtime en mode bitmap ou vice versa. Par exemple, pour envoyer un état à une imprimante PostScript à partir d'un terminal (par exemple, un vt220), vous pouvez appeler RWRUN60 en mode caractère et exécuter l'état avec MODE=BITMAP. Sous Windows, MODE=CHARACTER utilise le pilote ASCII de Reports Runtime pour produire une sortie ASCII modifiable.

Syntaxe

[MODE=]{BITMAP|CHARACTER|DEFAULT}

Valeurs

BITMAP

DEFAULT exécute l'état selon le mode de l'exécutable actuellement utilisé.

CHARACTER

Valeur par défaut

DEFAULT


PRINTJOB

  Rubriques connexes

Description  PRINTJOB indique si la boîte de dialogue d'impression de travaux doit apparaître avant l'exécution d'un état.

Syntaxe

[PRINTJOB=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

YES

Notes d'utilisation

•	Lorsqu'un état est exécuté comme processus généré dynamiquement (c'est-à-dire qu'un exécutable tel que RWRUN60 est appelé à partir d'un autre exécutable, tel que RWBLD60), la boîte de dialogue d'impression de travaux n'apparaît pas, quelle que soit la valeur de PRINTJOB.

•	Lorsque DESTYPE=MAIL, la boîte de dialogue d'impression de travaux n'apparaît pas, quelle que soit la valeur de PRINTJOB.


TRACEFILE

  Rubriques connexes

Description  TRACEFILE désigne le nom du fichier dans lequel Reports Runtime consigne les informations de trace.

Syntaxe

[TRACEFILE=]tracefile

Valeurs

Tout nom de fichier valide.

Valeur par défaut

trace.dat

Notes d'utilisation

•	Les informations de trace ne peuvent être générées que lors de l'exécution d'un fichier .rdf. Vous ne pouvez pas demander de journalisation lors de l'exécution d'un fichier .rep.

•	Si vous indiquez LOGFILE, ERRFILE ou TRACEFILE, toutes les informations de trace sont placées dans le dernier fichier indiqué. Par exemple, dans le cas suivant, toutes les informations de trace indiquées sont placées dans err.log car il s'agit du dernier fichier mentionné dans la commande RWRUN60.

rwrun60 MODULE=order_entry USERID=scott/tiger
TRACEFILE=trace.log LOGFILE=mylog.log
ERRFILE=err.log


TRACEMODE

  Rubriques connexes

Description  TRACEMODE indique si Reports Runtime doit ajouter les informations de trace au fichier ou écraser le fichier entier.

Syntaxe

[TRACEMODE=]{TRACE_APPEND|TRACE_REPLACE}

Valeurs

TRACE_APPEND ajoute les nouvelles informations à la fin du fichier.

TRACE_REPLACE écrase le fichier.

Valeur par défaut

TRACE_APPEND

Notes d'utilisation

•	Les informations de trace ne peuvent être générées que lors de l'exécution d'un fichier .rdf. Vous ne pouvez pas demander de journalisation lors de l'exécution d'un fichier .rep.


TRACEOPTS

  Rubriques connexes

Description  TRACEOPTS désigne les informations de trace que vous souhaitez consigner dans le fichier trace.

Syntaxe

[TRACEOPTS=]{TRACE_ERR|TRACE_PRF|TRACE_APP|TRACE_PLS|
TRACE_SQL|TRACE_TMS|TRACE_DST|TRACE_ALL|(opt1, opt2, ...)}

Valeurs

Toutes les options que vous indiquez entre parenthèses doivent être utilisées. Par exemple, TRACE_OPTS=(TRACE_APP, TRACE_PRF) indique que vous voulez que les options TRACE_APP et TRACE_PRF soient utilisées.

TRACE_ALL consigne dans le fichier trace toutes les informations de trace disponibles.

TRACE_APP consigne dans le fichier trace les informations de trace concernant tous les objets de l'état.

TRACE_DST recense toutes les listes de diffusion du fichier trace. Ces informations permettent de déterminer la destination des différentes sections.

TRACE_ERR recense dans le fichier trace les messages d'erreur et les avertissements.

TRACE_PLS consigne dans le fichier trace les informations de trace concernant tous les objets PL/SQL.

TRACE_PRF consigne dans le fichier trace les statistiques de performances.

TRACE_SQL consigne dans le fichier trace toutes les informations de trace sur SQL.

TRACE_TMS crée un horodatage de toutes les entrées du fichier trace.

Valeur par défaut

TRACE_ALL

Notes d'utilisation

•	Les informations de trace ne peuvent être générées que lors de l'exécution d'un fichier .rdf. Vous ne pouvez pas demander de journalisation lors de l'exécution d'un fichier .rep.


AUTOCOMMIT

  Rubriques connexes

Description  AUTOCOMMIT indique si les modifications apportées à la base de données (par exemple, CREATE) doivent être automatiquement validées dans la base de données. Notez que certaines bases de données non ORACLE (par exemple, SQL Server) requièrent AUTOCOMMIT=YES.

Syntaxe

[AUTOCOMMIT=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


NONBLOCKSQL

  Rubriques connexes

Description  NONBLOCKSQL indique si l'exécution d'autres programmes est autorisée pendant que Reports Runtime extrait des données de la base de données.

Syntaxe

[NONBLOCKSQL=]{YES|NO}

Valeurs

YES signifie que l'exécution d'autres programmes est autorisée pendant l'extraction des données.

NO signifie que l'exécution d'autres programmes n'est pas autorisée pendant l'extraction des données.

Valeur par défaut

YES


ROLE

  Rubriques connexes

Description  ROLE désigne le rôle de base de données à vérifier pour l'état au moment de l'exécution. ROLE permet d'exécuter des états qui effectuent des interrogations sur des tables de bases de données auxquelles vous n'êtes normalement pas autorisé à accéder.

Syntaxe

[ROLE=]rolename/[rolepassword]

Valeurs

Un rôle valide et (facultativement) un mot de passe de rôle.


BLANKPAGES

  Rubriques connexes

Description  BLANKPAGES indique si les pages blanches doivent être supprimées lorsque vous imprimez un état. Utilisez ce mot-clé lorsque votre état comporte des pages blanches que vous ne voulez pas imprimer.

Syntaxe

[BLANKPAGES=]{YES|NO}

Valeurs

YES signifie que toutes les pages blanches sont imprimées.

NO signifie que les pages blanches ne sont pas imprimées.

Valeur par défaut

YES

Notes d'utilisation  BLANKPAGES est particulièrement utile si votre page logique comporte plusieurs pages physiques (ou panneaux) et que vous ne vouliez pas imprimer les pages blanches.


DISABLEPRINT

  Rubriques connexes

Description  DISABLEPRINT indique si les menus Fichier [image] Imprimer, Fichier [image] Mise en page et Fichier [image] Choisir l'imprimante (sur Motif) doivent être désactivés, ainsi que les boutons de barre d'outils équivalents dans l'Aperçu interactif Runtime.

Syntaxe

[DISABLEPRINT=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


DISABLEMAIL

  Rubriques connexes

Description  DISABLEMAIL indique si le menu de courrier électronique doit être désactivé, ainsi que les boutons de barre d'outils équivalents dans l'Aperçu interactif Runtime.

Syntaxe

[DISABLEMAIL=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


DISABLEFILE

  Rubriques connexes

Description  DISABLEFILE indique si le menu Fichier [image] Générer dans fichier doit être désactivé dans l'Aperçu interactif Runtime.

Syntaxe

[DISABLEFILE=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


DISABLENEW

  Rubriques connexes

Description  DISABLENEW indique si le menu Affichage [image] Nouvel aperçu doit être désactivé pour empêcher d'afficher une nouvelle instance de l'Aperçu interactif Runtime.

Syntaxe

[DISABLENEW=]{YES|NO}

Valeurs

YES ou NO

Valeur par défaut

NO


DESTINATION

  Rubriques connexes

Description  Le mot-clé DESTINATION permet d'indiquer le nom d'un fichier .DST qui définit la diffusion pour l'exécution en cours de l'état.

Syntaxe

[DESTINATION=]filename.DST

Valeurs

Nom d'un fichier .DST qui définit la diffusion d'un état ou d'une section d'état.

Notes d'utilisation

•	Pour activer le mot-clé DESTINATION, saisissez DISTRIBUTE=YES dans la ligne de commande.


DISTRIBUTE

  Rubriques connexes

Description  DISTRIBUTE active ou désactive la diffusion de la sortie d'état vers plusieurs destinations, comme l'indique la liste de diffusion paramétrée dans la définition de diffusion d'état ou dans un fichier .DST.

Syntaxe

[DISTRIBUTE=]{YES|NO}

Valeurs

YES signifie que l'état doit être envoyé à la liste de diffusion.

NO signifie que la liste de diffusion doit être ignorée et que l'état doit être sorti de la manière indiquée dans les paramètres DESNAME et DESFORMAT. Il s'agit essentiellement d'un mode de débogage qui permet d'exécuter un état paramétré pour la diffusion, sans toutefois lancer cette dernière.

Valeur par défaut

NO

Notes d'utilisation

•	Pour activer le mot-clé DESTINATION, saisissez DISTRIBUTE=YES.


 DELIMITER

  Rubriques connexes

Description  DELIMITER désigne le ou les caractères utilisés pour séparer les cellules de la sortie d'état.

Syntaxe

[DELIMITER=]value

Valeurs

Tout caractère alphanumérique ou toute chaîne de caractères alphanumériques, notamment :

,	Une virgule sépare les cellules.
.	Un point sépare les cellules.
Vous pouvez également utiliser l'une des quatre valeurs réservées suivantes :

tab	Une tabulation sépare les cellules.
space	Un espace sépare les cellules.
return	Un interligne sépare les cellules.
none	Aucun séparateur n'est utilisé.
Vous pouvez également utiliser des séquences d'échappement fondées sur le jeu de caractères ASCII, notamment :

\t	Une tabulation sépare les cellules.
\n	Un interligne sépare les cellules.
Valeur par défaut

Tab

Notes d'utilisation

Vous ne pouvez utiliser cet argument que si vous saisissez DESFORMAT=DELIMITED.


 CELLWRAPPER

  Rubriques connexes

Description  CELLWRAPPER désigne le ou les caractères affichés autour des cellules délimitées de votre sortie d'état.

Syntaxe

[CELLWRAPPER=]value

Valeurs

Tout caractère alphanumérique ou chaîne de caractères alphanumériques.

"	Des guillemets apparaissent de part et d'autre de la cellule.
‘	Des apostrophes apparaissent de part et d'autre de la cellule.
Vous pouvez également utiliser l'une des quatre valeurs réservées suivantes :

tab	Des tabulations apparaissent de part et d'autre de la cellule.
space	Des espaces simples apparaissent de part et d'autre de la cellule.
return	Des interlignes apparaissent de part et d'autre de la cellule.
none	Aucun intercalaire de cellule n'est utilisé.
Vous pouvez également utiliser des séquences d'échappement fondées sur le jeu de caractères ASCII, notamment :

\t	Des tabulations apparaissent de part et d'autre de la cellule.
\n	Des interlignes apparaissent de part et d'autre de la cellule.
Valeur par défaut

none

Notes d'utilisation

•	Vous ne pouvez utiliser cet argument que si vous avez indiqué DESFORMAT=DELIMITED.

•	Ne confondez pas un intercalaire avec un séparateur (delimiter).


 DATEFORMATMASK

  Rubriques connexes

Description  DATEFORMATMASK désigne la manière dont les valeurs de date apparaissent dans la sortie d'état délimitée.

Syntaxe

[DATEFORMATMASK=]mask

Valeurs

Tout masque de format de date valide.

Notes d'utilisation

•	Vous ne pouvez utiliser cet argument que si vous avez indiqué DESFORMAT=DELIMITED.


 NUMBERFORMATMASK

  Rubriques connexes

Description  NUMBERFORMATMASK désigne la manière dont les valeurs numériques apparaissent dans l'état de sortie délimité.

Syntaxe

[NUMBERFORMATMASK=]mask

Valeurs

Tout masque de format numérique valide.

Notes d'utilisation

Vous ne pouvez utiliser cet argument que si vous avez indiqué DESFORMAT=DELIMITED.


PAGESTREAM

  Rubriques connexes

Description  PAGESTREAM permet d'activer ou de désactiver la sortie d'état au format pages, lorsque l'état est sous la forme d'une sortie HTML ou HTMLCSS, à l'aide des contrôles de navigation définis par le créateur de l'état via :

•	les propriétés Type Contrôle de navigation de page et Valeur Contrôle de navigation de page dans la palette de propriétés de l'état ;

•	ou le PL/SQL d'un déclencheur Before Report (SRW.SET_PAGE_NAVIGATION_HTML).

Syntaxe

[PAGESTREAM=]{YES|NO}

Valeurs

YES indique d'activer la sortie au format pages.

NO indique de la désactiver.

Valeur par défaut

NO


EXPRESS_SERVER

  Rubriques connexes

Description  EXPRESS_SERVER indique le serveur Express auquel vous voulez vous connecter.

Syntaxe

EXPRESS_SERVER="server=[server]/domain=[domain]/
user=[userid]/password=[passwd]"

Syntaxe utilisant RAM

EXPRESS_SERVER="server=[serveur]/domain=[domaine]/
user=[userid]/password=[mot_passe_utilisateur]/ramuser=[ID_utilisateur_RAM]/
rampassword=[mot_passe_RAM]/ramexpressid=[PID_RAM_Express]/
ramserverscript=[script_serveur_RAM]/rammasterdb=[BdD_RAM]/
ramconnecttype=[connexion_RAM]"

Valeurs

Chaîne de connexion valide incluse entre guillemets (") dans laquelle :

server	Correspond à la chaîne du serveur Express (par exemple, ncacn_ip_tcp:olap2-pc/sl=x/st=x/ct=x/sv=x/).
domain	Correspond au domaine du serveur Express.
user	Correspond à l'ID utilisateur permettant de se connecter au serveur Express.
password	Correspond au mot de passe de l'ID utilisateur.
ramuser	Correspond à l'ID utilisateur permettant de se connecter au RDBMS.
rampassword	Correspond au mot de passe du RDBMS.
ramexpressid	ID de l'utilisateur de la base de données Oracle Sales Analyzer. Cette valeur n'est requise que pour les bases de données Oracle Sales Analyzer.
ramserverscript	Nom complet (avec son chemin complet) du fichier de configuration de la base de données distante (RDC) sur le serveur. Ce fichier fournit des informations comme l'emplacement du code et des bases de données. La syntaxe UNC (Universal Naming Convention) permet à plusieurs utilisateurs d'employer la même connexion pour accéder aux données sans devoir associer la même lettre de lecteur à cet emplacement. La syntaxe UNC est la suivante : \\NomServeur\NomPartage\, suivie du nom des sous-dossiers et/ou fichiers.
rammasterdb	Nom de la base de données Relational Access Manager à attacher initialement. Vous ne devez indiquer que le nom de fichier de la base de données. Cette dernière doit résider dans un répertoire figurant dans la liste des chemins d'accès de la variable ServerDBPath pour Express Server. Vous pouvez vérifier le chemin ServerDBPath dans l'onglet d'entrées/sorties de fichier de la boîte de dialogue Express Configuration Manager.
ramconnecttype	Type de connexion Express. Pour utiliser une connexion directe, entrez 0.
La valeur server comporte quatre paramètres qui correspondent aux paramètres définis dans Oracle Express Connection Editor et stockés dans les fichiers de connexion (.xcf). Ces quatre paramètres sont indispensables, mais leur ordre est indifférent. Le tableau suivant décrit ces paramètres et leur configuration.

Paramètre	Description	Configuration
sl	Connexion au serveur	-2 : Hôte (connexion au domaine) -1 : Hôte (connexion au serveur) 0 : Aucune authentification requise 1 : Sécurité sur l'hôte (connexion au domaine) et la connexion 2 : Sécurité sur l'hôte (connexion au domaine) et les appels 3 : Sécurité sur l'hôte (connexion au domaine) et le paquet 4 : Sécurité sur l'hôte (connexion au domaine) et l'intégrité 5 : Sécurité sur l'hôte (connexion au domaine) et la confidentialité Remarques : Windows NT utilise toutes ces configurations. Les systèmes Unix n'utilisent que les configurations 0, -1 et -2. Pour plus d'informations sur ces configurations, reportez-vous au système d'aide d'Express Connection Editor.
st	Type de serveur	1 : Serveur Express
ct	Type de connexion	0 : Connexion Express
sv	Version du serveur	1 : Express 6.2 ou versions supérieures
Notes d'utilisation

•	En cas de nécessité, vous pouvez insérer des espaces dans la chaîne (par exemple, si l'ID utilisateur est John Smith) car elle est entre guillemets.

•	Si vous utilisez une barre oblique (/) dans la chaîne, vous devez en utiliser une autre en tant que caractère d'échappement. Par exemple, si le domaine est tools/reports, la ligne de commande doit se présenter sous la forme suivante :

EXPRESS_SERVER="server=ncacn_ip_tcp:olap2-pc/sl=0/st=1/
ct=0/sv=1/ domain=tools//reports"

•	Vous pouvez utiliser des apostrophes dans la chaîne. Aucun traitement spécial n'est appliqué lorsqu'une chaîne est comprise entre guillemets.


EXPRESS_SERVER avec RAM (RWRUN60) - Exemple

  Rubriques connexes 	  Tous les exemples

rwrun60 userid=scott/tiger@nt805
express_server="server=ncacn_ip_tcp:olap2-pc/sl=0/st=1/
ct=0/sv=1/ramuser=appqa/rampassword=appqa1/ramexpressid=appqa/
ramserverscript=\\olap3-pc\orant\olap\ram6202\ram\sqstnt.rdc/
rammasterdb=sqstnt.db/ramconnecttype=0"
report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


EXPRESS_SERVER avec ID utilisateur, mot de passe et domaine (RWRUN60) - Exemple

  Rubriques connexes 	  Tous les exemples

rwrun60 userid=scott/tiger@nt805
express_server="server=ncacn_ip_tcp:olap2-pc/sl=1/st=1/ct=0/
sv=1/ user=orbuild/domain=tools/password=buildme/"
report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


EXPRESS_SERVER sans ID utilisateur, ni mot de passe ni domaine (RWRUN60) - Exemple

  Rubriques connexes 	  Tous les exemples

rwrun60 userid=scott/tiger@nt805
express_server="server=ncacn_ip_tcp:olap2-pc/sl=0/st=1/ct=0/
sv=1/" report=exp.rdf destype=file desname=exp1.html
desformat=html batch=yes


CUSTOMIZE

  Rubriques connexes

Description  CUSTOMIZE indique le fichier ou la liste de fichiers XML à appliquer à l'état sélectionné dans le mot-clé MODULE ou REPORT. Le fichier XML contient des options personnalisées (comme des modifications de police ou de couleur) qui modifient la définition de l'état.

Pour plus d'informations, reportez-vous au manuel Publishing Reports.

Syntaxe

[CUSTOMIZE=]filename.xml|(filename1.xml, filename2.xml, ...)

Valeurs

Nom des fichiers contenant des définitions d'états XML valides. Si nécessaire, faites précéder ces noms des informations de chemin d'accès correspondantes.

Notes d'utilisation

•	En général, l'extension de fichier d'une définition d'état XML est .XML, sauf si elle est utilisée avec le mot-clé CUSTOMIZE.


SAVE_RDF

  Rubriques connexes

Description  SAVE_RDF indique le fichier dans lequel vous voulez enregistrer l'état sélectionné dans le mot-clé MODULE ou REPORT, associé aux fichiers de personnalisation XML sélectionnés dans le mot-clé CUSTOMIZE. Cet argument se révèle particulièrement utile lorsque vous disposez d'un fichier .RDF auquel vous appliquez un fichier XML via le mot-clé CUSTOMIZE et que vous voulez enregistrer la combinaison de ces deux fichiers dans un nouveau fichier .RDF.

Pour plus d'informations, reportez-vous au manuel Publishing Reports.

Syntaxe

[SAVE_RDF=]filename.rdf

Valeurs

Tout nom de fichier valide.


<param>

  Rubriques connexes

Description  <param> est un paramètre qui fait partie de la définition de l'état. La valeur que vous indiquez est utilisée pour la valeur de ce paramètre.

Syntaxe

<param>=value

Valeurs

Toute valeur valide pour ce paramètre.

Valeur par défaut

Issue de la propriété Valeur initiale du paramètre.

Notes d'utilisation

•	Vous pouvez remplacer la valeur par défaut de la grille de paramètres d'exécution.

•	La valeur des arguments peut être entre apostrophes ou entre guillemets. L'effet des apostrophes ou des guillemets dépend du système d'exploitation.

•	Si vous indiquez un ou plusieurs fichiers d'exécution à l'aide du mot-clé REPORT, les valeurs de PARAM seront validées en fonction des définitions indiquées pour chaque paramètre (par exemple, Masque d'entrée, déclencheur Validation) des états.

•	Si vous n'indiquez pas de fichier d'exécution à l'aide du mot-clé REPORT, la valeur de PARAM n'est ni analysée ni validée, car les paramètres peuvent faire référence à ceux qui n'ont pas encore été définis.


 Boîte de dialogue Attach Database

Utilisez la boîte de dialogue Attach Database pour préciser le chemin d'accès complet de la base de données à attacher à votre session.

Cette boîte de dialogue n'est disponible qu'en anglais.

Eléments de la boîte de dialogue

Zones Look in - Répertoire les dossiers et fichiers disponibles. La plus grande des zones affiche les dossiers et fichiers situés à l'emplacement indiqué dans la zone la plus petite.

Notez que ces dossiers et que ces fichiers sont ceux du serveur Express auxquels vous êtes connecté.

Zone File name - Indique le nom de la base de données à ouvrir. Vous pouvez entrer le nom d'un fichier dans cette zone ou sélectionner ce nom dans la plus grande des zones Look In. Si vous ne trouvez pas le fichier voulu, vous pouvez préciser un autre emplacement dans ces mêmes zones.

Zone Files of Type - Indique le type du fichier à afficher et dont le nom apparaît dans la zone File Name. L'extension .db indique qu'il s'agit d'une base de données.

Bouton Up - Cliquez sur ce bouton pour remonter d'un niveau dans l'arborescence.

Case Read Only - Indique que vous voulez attacher la base de données en lecture seule pour qu'aucune modification ne puisse y être apportée.


 Boîte de dialogue Connect

Utilisez la boîte de dialogue Connect pour fournir des informations sur la connexion à Express.

Cette boîte de dialogue n'est disponible qu'en anglais.

Eléments de la boîte de dialogue

Zone Express Server - Indique la connexion au serveur Express à établir.

Zone Authentication - Vous permet d'entrer le nom de domaine, l'ID utilisateur et le mot de passe du serveur Express. Certaines ou la totalité de ces zones peuvent être grisées en fonction de la connexion sélectionnée.

Zone Domain - Entrez le nom de votre domaine sur le système éloigné. Cet élément n'apparaît que si une connexion au domaine est requise.

Zone User ID - Entrez votre ID utilisateur sur le système éloigné.

Zone Password - Entrez votre mot de passe sur le système éloigné.

Boîte de connexion RDBMS -- Permet d'entrer l'ID utilisateur, le mot de passe et l'ID Express pour RDBMS. La boîte ID Express pourrait être inaccessible selon la connexion du serveur Express sélectionnée.

La boîte User ID-- Entrer votre ID utilisateur pour RDBMS.

La boîte Password-- Entrer votre mot de passe pour RDBMS.

La boîte ID Express-- Entrer votre ID Express pour RDBMS.


Boîte de dialogue Custom Measures

Voir aussi

Utilisez la boîte de dialogue Custom Measures pour afficher, créer, sélectionner, ou modifier une mesure personnalisé.

Cette boîte de dialogue n’est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Database box – Indique la base de données actuellement utilisée. Pour modifier la base de données, cliquez sur la flèche et sélectionnez une base de données différente dans la liste.

Custom Measures box – Enumère les mesures personnalisées disponibles. Pour copier ou modifier une mesure personnalisée, sélectionnez une mesure à partir de cette liste avant d’appuyer sur l’un des boutons.

Expression box – Affiche la formule définie pour la mesure personnalisée sélectionnée.

Dimensions box – Affiche les dimensions de la mesure personnalisée sélectionnée..

New button – Affiche la boîte de dialogue Custom Measures - Action pour créer une nouvelle mesure personnalisée. Le nom de l’action dans la barre de titre est New.

Copy button – Affiche la boîte de dialogue Custom Measures - Action pour copier la mesure personnalisée sélectionnée. Le nom de l’action dans la barre de titre est Copy.

Delete button -- Supprime la mesure personnalisée sélectionnée.

Edit button – Affiche la boîte de dialogue Custom Measures - Action pour modifier la mesure personnalisée sélectionnée. Le nom de l’action dans la barre de titre est Edit.


Boîte de dialogue Custom Measures - Action

Utilisez la boîte de dialogue Custom Measures - Action pour créer, edit, ou copier une mesure personnalisée. Le nom de l’action affichée dans la barre de titre est déterminée par la fonction.

Cette boîte de dialogue n’est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Name box – Indique le nom de la mesure personnalisée. Le nom peut être constitué de 16 caractères maximum.

Description box -- Indique la description de la mesure personnalisée.

Expression box -- Définit l’ expression pour la mesure personnalisée.

Category box – Enumère les catégories fonctions et expressions que vous pouvez utiliser lors de la création d’une formule pour la mesure personnalisée.

Choices box – Enumère les éléments de la catégorie sélectionnée.

Insert button – Insère la sélection dans la boîte Expression pour la modification.

Information box – Affiche les informations relatives à la sélection.


 Boîte de dialogue Mot de passe de base de données

Utilisez la boîte de dialogue Mot de passe de base de données pour entrer le mot de passe affecté à la base de données que vous attachez. Cette boîte de dialogue n'apparaît que si cette base de données requiert un mot de passe.

Evitez d'attacher une base de données protégée par mot de passe car il est impossible d'interroger ce type de base de données.

Elément de la boîte de dialogue

Zone Entrez un mot de passe valide pour la base de données - Entrez le mot de passe de la base de données à attacher. Pour des raisons de sécurité, le mot de passe apparaît sous la forme d'astérisques lors de sa saisie.


 Boîte de dialogue Express Query

Utilisez la boîte de dialogue Express Query pour créer une interrogation de données Express.

Cette boîte de dialogue n'est disponible qu'en anglais.

Eléments de cette étape

Zone Choose Database - Répertorie les bases de données Express actuellement attachées. Utilisez les boutons Attach Database et Remove Database pour ajouter une base de données à la liste ou pour en supprimer une. Vous pouvez attacher plusieurs bases de données.

Bouton Attach Database - Permet d'accéder à la boîte de dialogue Attach Database dans laquelle vous pouvez sélectionner la base de données à attacher.

Bouton Remove Database - Détache la base de données sélectionnée dans la zone Choose Database. Vous ne pouvez pas détacher une base de données si elle est utilisée par une interrogation ouverte. Lorsqu'une interrogation est en cours, ou lorsque ses résultats sont affichés dans un état ouvert, vous devez annuler cette interrogation ou supprimer ces résultats avant de détacher la base de données.

Zone Available Measures - Répertorie tous les indicateurs de la base de données.

Zone Selected Measures - Répertorie les indicateurs actuellement sélectionnés.

Zone Report columns - Fournit des informations sur les dimensions correspondant aux indicateurs sélectionnés.

Bouton Add One ( [image]) - Ajoute l'indicateur sélectionné dans la zone Available Measures à la zone Selected Measures.

Bouton Add All ( [image]) - Ajoute tous les indicateurs de la zone Available Measures à la zone Selected Measures.

Bouton Remove One ( [image]) - Supprime l'indicateur sélectionné de la zone Selected Measures.

Bouton Remove All ( [image]) - Supprime tous les indicateurs de la zone Selected Measures.

Bouton Custom Measures - Permet d'accéder à la boîte de dialogue Custom Measures.

Bouton Selector - Permet d'accéder à la boîte de dialogue Selector dans laquelle vous pouvez :

sélectionner les valeurs d'une dimension, y compris une sélection enregistrée. Par exemple, pour une dimension temporelle (Time), vous pouvez sélectionner certaines années, ou certains mois ou trimestres.

personnaliser le Sélecteur pour une vue. Vous pouvez définir des options pour personnaliser l'aspect et le mode de fonctionnement de la boîte de dialogue Sélecteur pour cette interrogation.


Boîte de dialogue Dimension

La boîte de dialogue Dimension ne permet de choisir qu’une seule valeur. La barre de titre de la boîte de dialogue Dimension indique le nom de la dimension dont vous pouvez sélectionner la valeur.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Select One - Répertorie les valeurs de la dimension. Sélectionnez une valeur de la liste. Si la dimension présente une hiérarchie, la zone Select one comporte alors les deux colonnes suivantes :

Colonne Drilling - Si la dimension présente une hiérarchie, une colonne comportant des icônes de hiérarchisation apparaît sur la gauche. Vous pouvez cliquer sur ces icônes pour agrandir ou réduire la hiérarchie. Au bas de cette colonne se trouve un bouton de hiérarchisation permettant d’ouvrir la boîte de dialogue Drill.

Colonne Values - Répertorie toutes les valeurs de la dimension.


Boîte de dialogue Drill

La boîte de dialogue Drill permet d’agrandir ou de réduire la liste des valeurs de la dimension jusqu'à un niveau particulier de la hiérarchie de la dimension.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Starting With label - Identifie la valeur de la dimension utilisée comme point de départ de la hiérarchisation.

Zone Drill - Répertorie les niveaux situés au niveau ou au-dessous du point de départ de la hiérarchie de la dimension en cours. Sélectionnez le niveau le plus bas à inclure dans votre sélection.


Boîte de dialogue List

Rubriques connexes

La boîte de dialogue List permet de sélectionner les valeurs de la dimension parmi une liste de valeurs disponibles. Vous pouvez ajouter des valeurs à cette liste, y choisir des valeurs ou en supprimer. Lorsque la dimension comporte une hiérarchie, vous pouvez aussi accéder à la boîte de dialogue Drill afin d’agrandir ou de réduire cette hiérarchie.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Available Dimension Values - Répertorie toutes les valeurs de la hiérarchie en cours, ou, si aucune hiérarchie n’est sélectionnée, toutes les valeurs de la dimension. Si vous souhaitez ajouter des valeurs à la dimension sélectionnée ou remplacer cette dernière, mettez en surbrillance les valeurs à ajouter ou les valeurs de remplacement. Pour mettre plusieurs valeurs en surbrillance, utilisez les combinaisons MAJ + CLIC ou CTRL + CLIC, ou sélectionnez-les en faisant glisser la souris.

Colonne Drilling - Si la dimension en cours présente une hiérarchie, une colonne comportant des icônes de hiérarchisation apparaît sur la gauche. Vous pouvez cliquer sur ces icônes pour agrandir ou réduire la hiérarchie. Au bas de cette colonne se trouve un bouton de hiérarchisation permettant d’ouvrir la boîte de dialogue Drill.

Zone Selected Dimension Values - Répertorie les valeurs actuellement sélectionnées. Pour conserver des valeurs de la sélection en cours ou pour en supprimer, mettez en surbrillance les valeurs souhaitées. Pour mettre plusieurs valeurs en surbrillance, utilisez les combinaisons MAJ + CLIC ou CTRL + CLIC, ou sélectionnez-les en faisant glisser la souris.

Bouton Select - Remplace la sélection en cours (figurant dans la zone Selected Dimension Values) par les valeurs de la dimension mises en surbrillance dans la zone Available Dimension Values.

Bouton Add - Ajoute à la zone Selected Dimension Values les valeurs de la dimension mises en surbrillance dans la zone Available Dimension Values.

Bouton Keep - Conserve dans la sélection en cours les valeurs de la dimension en surbrillance dans la zone Selected Dimension Values et supprime les autres.

Bouton Remove - Supprime de la sélection en cours les valeurs de la dimension mises en surbrillance dans la zone Selected Dimension Values et conserve les autres.

Zone Hierarchy - Répertorie les hiérarchies définies pour cette dimension. Sélectionnez la hiérarchie dans laquelle vous souhaitez sélectionner des valeurs de la dimension. Les valeurs de la hiérarchie sélectionnées apparaissent dans la zone Available Dimension Values.


Boîte de dialogue Preview

La boîte de dialogue Preview vous permet de connaître le résultat des éléments sélectionnés à l’aide d’un outil du Sélecteur.

A mesure que vous modifiez une sélection, le script de sélection change. La boîte de dialogue Preview vous permet de connaître l’effet des modifications apportées au script et d'afficher les valeurs de la dimension qui seront sélectionnées si vous appliquez ces modifications.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Script - Affiche l’ensemble du script de sélection, y compris la partie ajoutée si vous choisissez OK dans la boîte de dialogue qui vous a permis d’ouvrir la boîte de dialogue Preview.

Zone Selected Values - Répertorie les valeurs produites par le script de sélection affiché.


Boîte de dialogue Qualifying Dimension Values

Lorsque vous sélectionnez ou que vous triez des valeurs de dimension en fonction de valeurs d'indicateur, vous ne devez indiquer qu’une valeur pour chacune des dimensions de qualification. La boîte de dialogue Qualifying Dimension Values vous permet de sélectionner une valeur pour chaque dimension de qualification.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Choose a Value for Each Dimension - Répertorie chacune des dimensions de qualification de l'indicateur, chaque dimension n’ayant qu’une valeur. Cliquez sur la dimension dont vous voulez sélectionner la valeur.

Zone Dimension Values - Répertorie les valeurs disponibles pour la dimension sélectionnée dans la zone Choose a Value for Each Dimension. Sélectionnez une valeur pour cette dimension.


Boîte de dialogue Rename Selection

La boîte de dialogue Rename Selection permet d'attribuer un nouveau nom à une sélection enregistrée.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Name - Identifie le nouveau nom de la sélection enregistrée. Il peut contenir jusqu'à 16 caractères. Pour éviter les conflits d'appellation lorsque vous partagez la sélection enregistrée avec un autre utilisateur, employez une convention garantissant l'utilisation de noms uniques. Par exemple, vous pouvez inclure la date ou vos initiales dans le nom.

Zone Description - Identifie la nouvelle description de la sélection enregistrée.


Boîte de dialogue Replace Saved Selection

Dans la boîte de dialogue Save Selection, lorsque vous enregistrez une sélection à la place d'une autre, la boîte de dialogue Replace Saved Selection apparaît et vous demande de confirmer le remplacement de l'ancienne sélection enregistrée par la nouvelle.

Choisissez Yes pour remplacer la précédente sélection par la nouvelle.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Current script - Affiche le script de la précédente sélection enregistrée.

Zone New script - Affiche le nouveau script, qui deviendra celui de la sélection enregistrée si vous cliquez sur Yes.


Boîte de dialogue Save Selection

La boîte de dialogue Save Selection permet d'enregistrer une sélection ou de remplacer une précédente sélection enregistrée.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Dimension label - Identifie la dimension à laquelle la sélection appartient.

Hierarchy label - Identifie la dernière hiérarchie sélectionnée utilisée dans la sélection enregistrée. Lorsque vous utilisez de nouveau cette sélection, cette hiérarchie devient la hiérarchie actuelle de la dimension.

Database label - Identifie la base de données contenant la dimension.

Zone Save Selection as - Sélectionnez l'un des boutons suivants :

Bouton New - Enregistre la sélection actuelle en tant que nouvelle sélection enregistrée. Lorsque vous cliquez sur New, les zones suivantes apparaissent :

Zone Name - Entrez le nom de la sélection enregistrée. Il peut contenir jusqu'à 16 caractères.

Zone Description - Entrez la description de la sélection enregistrée.

Bouton Replacement - Remplace une sélection par la sélection actuelle. Lorsque vous cliquez sur ce bouton, la liste des sélections enregistrées pour la dimension apparaît. Cliquez sur la sélection enregistrée à remplacer.

Remarque : Vous ne pouvez pas remplacer les sélections enregistrées qui ont été créées dans Express Administrator.

Zone Type - Sélectionnez l'un des types de sélection suivants :

Dynamic - Evalue les critères de sélection par rapport au statut actuel. Les valeurs incluses dans la sélection peuvent varier. Par exemple, si le script de sélection indique « Sélectionner les trois derniers mois », la sélection dynamique inclut les trois mois précédant celui pendant lequel l'utilisateur a choisi la sélection enregistrée.

Static - Sélectionne les valeurs de dimension exactes incluses dans la sélection au moment de son enregistrement. Par exemple, si le script de sélection indique « Sélectionner les trois derniers mois », la sélection statique inclut les trois mois précédant celui pendant lequel la sélection enregistrée a été créée, quel que soit le moment d'exécution de l'interrogation.

Zone Script - Affiche le script de sélection de la sélection enregistrée, à condition que la case Show selection script soit cochée dans la boîte de dialogue Selector Options.


Boîte de dialogue Saved Selection

Rubriques connexes

La boîte de dialogue Saved Selection permet d’extraire une sélection enregistrée définie dans Express Administrator pour une dimension.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Selection Type - Comporte les options suivantes concernant la manière dont les valeurs que vous venez de sélectionner vont affecter la sélection en cours :

Select - Remplace la sélection en cours par la sélection enregistrée.

Add - Ajoute les valeurs de la sélection enregistrée à la sélection en cours.

Keep - Conserve les valeurs de la sélection en cours qui figurent aussi dans la sélection enregistrée et supprime les autres valeurs de la dimension de la sélection en cours.

Remove - Supprime les valeurs de la sélection enregistrée de la sélection en cours et conserve les autres.

Zone Dimension Values in Selection - Répertorie les sélections enregistrées pour la dimension.

Zone Selection Name - Affiche les informations suivantes concernant la sélection enregistrée et mise en surbrillance :

Dimension label - Identifie la dimension à laquelle appartient la sélection enregistrée.

Hierarchy label - Identifie la hiérarchie spécifiée dans la sélection enregistrée. Celle-ci devient la hiérarchie en cours lorsque vous choisissez la sélection enregistrée.

Database label - Identifie la base de données contenant la dimension.

Type label - Indique si la sélection enregistrée est dynamique ou statique.

Access label - Indique si vous pouvez modifier la sélection enregistrée.

Zone Script - Affiche le script de sélection de la sélection enregistrée, à condition que la case Show selection script soit cochée dans la boîte de dialogue Selector Options.

Zone Script - Affiche les critères qui seront ajoutés au script de sélection de la sélection en cours d’édition si vous choisissez OK.

Bouton Preview - Ouvre la boîte de dialogue Preview, qui permet de voir la modification envisagée et répertorie les valeurs de la dimension qui seront sélectionnées si vous adoptez cette modification.


Boîte de dialogue Select All

Rubriques connexes

La boîte de dialogue Select All permet de choisir toutes les valeurs de dimension ou toutes les valeurs de dimension de la hiérarchie en cours.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Selection Type - Comporte les options suivantes concernant la manière dont les valeurs que vous venez de sélectionner vont affecter la sélection en cours :

Select - Remplace la sélection en cours par de nouvelles valeurs.

Add - Ajoute de nouvelles valeurs à la sélection en cours.

Keep - Conserve les valeurs que vous venez de choisir dans la sélection en cours et supprime les autres valeurs.

Remove - Supprime de la sélection en cours les valeurs que vous venez de sélectionner et conserve les autres.

Zone Dimension Values in hierarchy - Répertorie les hiérarchies définies pour la dimension sélectionnée. Pour inclure toutes les valeurs de la dimension dans la sélection, sélectionnez (NONE) ; pour n’inclure que les valeurs de la dimension appartenant à une hiérarchie donnée, sélectionnez cette hiérarchie.

Zone Script - Affiche les critères qui seront ajoutés au script de sélection si vous choisissez OK.

Bouton Preview - Ouvre la boîte de dialogue Preview, qui permet de voir la modification envisagée et répertorie les valeurs de la dimension qui seront sélectionnées si vous adoptez cette modification.


Boîte de dialogue Select by Attribute

Rubriques connexes

La boîte de dialogue Select by Attribute vous permet de choisir des valeurs en fonction de leurs attributs. Vous pouvez par exemple sélectionner la valeur Produit en fonction de la couleur. L’outil Attribut n’est disponible que pour les dimensions possédant un attribut.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Selection Type - Comporte les options suivantes concernant la manière dont les valeurs que vous venez de sélectionner vont affecter la sélection en cours :

Select - Remplace la sélection en cours par de nouvelles valeurs.

Add - Ajoute de nouvelles valeurs à la sélection en cours.

Keep - Conserve les valeurs que vous venez de choisir dans la sélection en cours et supprime les autres valeurs.

Remove - Supprime de la sélection en cours les valeurs que vous venez de choisir et conserve les autres.

Zone Dimension Values Where - Indique la dimension connexe définissant l’attribut.

Zone Is - Répertorie les valeurs de l’attribut en cours. Vous pouvez choisir les valeurs à utiliser comme critère de sélection.

Zone In Hierarchy - Répertorie les hiérarchies définies pour la dimension sélectionnée. Sélectionnez la hiérarchie que vous voulez utiliser.

Zone At Level(s) - Répertorie les éventuels niveaux de la hiérarchie sélectionnée. Sélectionnez les niveaux à inclure dans votre nouvelle sélection. Vous pouvez utiliser MAJ + CLIC ou CTRL + CLIC pour sélectionner plusieurs niveaux.

Zone Script - Affiche les critères qui seront ajoutés au script de sélection si vous choisissez OK.

Bouton Preview - Ouvre la boîte de dialogue Preview, qui permet de voir la modification envisagée et répertorie les valeurs de la dimension qui seront sélectionnées si vous adoptez cette modification.


Boîte de dialogue Select by Exception

Rubriques connexes

La boîte de dialogue Select by Exception vous permet de sélectionner des valeurs de dimension en fonction des valeurs des données d’un indicateur particulier ou en fonction du rapport existant entre ces données et celles d’un deuxième indicateur. Par exemple, vous pouvez sélectionner toutes les villes dont le total des ventes en dollar pour un produit donné a dépassé 5 000 000 de francs pour l’année précédente. Sinon, vous pouvez sélectionner toutes les villes où les ventes ont dépassé de 10 pour-cent les prévisions.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Selection Type - Comporte les options suivantes concernant la manière dont les valeurs que vous venez de sélectionner vont affecter la sélection en cours :

Select - Remplace la sélection en cours par de nouvelles valeurs.

Add - Ajoute de nouvelles valeurs à la sélection en cours.

Keep - Conserve les valeurs que vous venez de choisir dans la sélection en cours et supprime les autres valeurs.

Remove - Supprime de la sélection en cours les valeurs que vous venez de choisir et conserve les autres.

Zone Exception Type - Contient les options suivantes relatives aux critères des types d’exceptions :

Numeric - Compare un indicateur à une valeur unique. Lorsque vous choisissez cette option, les zones suivantes apparaissent :

Zone Dimension Values Where - Identifie l'indicateur dont les valeurs sont comparées par l’outil Exception avec la valeur précisée dans la zone Value. Pour sélectionner un autre indicateur, cliquez sur le bouton Ellipsis afin d’afficher la liste de tous les indicateurs utilisant la dimension en cours.

Zone Is - Opérateur identifiant le rapport entre les valeurs de données concordantes de l'indicateur sélectionné et une valeur de données précise. Vous pouvez choisir parmi les éléments suivants : equal to, less than or equal to, greater than or equal to, not equal to, between, greater than, outside et less than.

Zone Value - Saisissez un nombre que l’outil Exception comparera aux valeurs de l'indicateur sélectionné. Lorsque l’opérateur en cours nécessite une plage de valeurs (between ou outside), la boîte de dialogue comporte deux zones dans lesquelles vous pouvez saisir la valeur la plus élevée et la valeur la plus faible de la plage.

Measure - Compare un indicateur à un autre indicateur. Lorsque vous choisissez cette option, les zones suivantes apparaissent :

Zone Dimension Values Where - Identifie l'indicateur dont l’outil Exception compare les valeurs à la valeur spécifiée dans la zone Value. Pour sélectionner un autre indicateur, cliquez sur le bouton Ellipsis afin d'afficher la liste de tous les indicateurs utilisant la dimension en cours.

Zone Is - Opérateur identifiant le rapport entre les valeurs de données concordantes de l'indicateur sélectionné et une deuxième valeur de données. Vous pouvez choisir Less than ou Greater than.

Zone Value - Saisissez un chiffre que l’outil Exception comparera aux valeurs de l'indicateur sélectionné. Dans la zone se trouvant à côté, choisissez Percent pour que le chiffre soit exprimé sous forme de pourcentage ou Value pour obtenir une constante.

Zone Comparison - Indique le type de comparaison établie par l’outil Exception entre les deux indicateurs. Vous pouvez choisir Above, Below ou Above or below.

Zone Measure - Identifie le deuxième indicateur utilisé par l’outil Exception pour la comparaison. Pour sélectionner un autre indicateur, cliquez sur le bouton Ellipsis afin d’afficher la liste de tous les indicateurs utilisant la dimension en cours.

Zone Exclude - Contient l’option de traitement des valeurs de données qui suit :

Case à cocher Zeros - Cochez cette case pour que les valeurs nulles des données soient exclues de la recherche.

Zone In Hierarchy - Répertorie les hiérarchies définies pour la dimension sélectionnée. Sélectionnez la hiérarchie que vous voulez utiliser ou sélectionnez NONE pour inclure toutes les valeurs de la dimension.

Zone At Level(s) - Répertorie les niveaux de la hiérarchie de la dimension en cours. Sélectionnez les niveaux à inclure dans votre nouvelle sélection ou sélectionnez All pour inclure tous les niveaux. Utilisez MAJ + CLIC ou CTRL + CLIC pour mettre plusieurs niveaux en surbrillance.

Zone For Dimension - Identifie une seule valeur pour chacune des autres dimensions des deux indicateurs. Pour modifier une sélection, cliquez sur le bouton Ellipsis correspondant afin d’afficher la liste de toutes les valeurs de la dimension.

Zone Script - Affiche les critères qui seront ajoutés au script de sélection si vous choisissez OK.

Bouton Preview - Ouvre la boîte de dialogue Preview, qui permet de voir la modification envisagée et répertorie les valeurs de la dimension qui seront sélectionnées si vous adoptez cette modification.


Boîte de dialogue Select by Family

Rubriques connexes

La boîte de dialogue Select by Family permet de choisir des valeurs en fonction de leur famille. Vous pouvez par exemple sélectionner des valeurs Geography pour le Canada et ses villes fils. L’outil Famille est accessible uniquement lorsqu’une hiérarchie est définie pour la dimension sélectionnée.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Selection Type - Comporte les options suivantes concernant la manière dont les valeurs que vous venez de sélectionner vont affecter la sélection en cours :

Select - Remplace la sélection en cours par de nouvelles valeurs.

Add - Ajoute de nouvelles valeurs à la sélection en cours.

Keep - Conserve les valeurs que vous venez de choisir dans la sélection en cours et supprime les autres valeurs.

Remove - Supprime de la sélection en cours les valeurs que vous venez de choisir et conserve les autres.

Zone In Hierarchy - Répertorie les hiérarchies définies pour la dimension sélectionnée. Sélectionnez la hiérarchie à utiliser.

Zone Family Member(s) of Dimension - Identifie la valeur de la dimension dont vous voulez choisir la famille. Pour sélectionner une autre valeur, cliquez sur le bouton Ellipsis afin d’obtenir la liste de toutes les valeurs de la dimension et de la hiérarchie en cours.

Zone Levels - Comporte habituellement deux colonnes en fonction de la hiérarchie. La colonne de gauche répertorie tous les niveaux de la hiérarchie en cours. La colonne de droite montre la relation existant entre les valeurs de chaque niveau et le point d’ancrage. L’un des niveaux est identifié comme comprenant le point d’ancrage. Les valeurs des autres niveaux peuvent être l’ancêtre, le parent, l’un des fils ou l’un des descendants de la valeur sélectionnée dans la zone Family Member(s) of Dimension.

Sélectionnez les niveaux à inclure dans la sélection. Vous pouvez utiliser MAJ + CLIC ou CTRL + CLIC pour sélectionner plusieurs niveaux.

Zone Script - Affiche les critères qui seront ajoutés au script de sélection si vous choisissez OK.

Bouton Preview - Ouvre la boîte de dialogue Preview, qui permet de voir la modification envisagée et répertorie les valeurs de la dimension qui seront sélectionnées si vous adoptez cette modification.


Boîte de dialogue Select by Level

Rubriques connexes

La boîte de dialogue Select by Level vous permet de choisir des valeurs en fonction de leur niveau dans la hiérarchie de la dimension en cours. Vous pouvez par exemple sélectionner toutes les valeurs Geography du niveau City. L’outil Niveau est accessible uniquement lorsqu’une hiérarchie est définie pour la dimension sélectionnée.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Selection Type - Comporte les options suivantes concernant la manière dont les valeurs que vous venez de sélectionner vont affecter la sélection en cours :

Select - Remplace la sélection en cours par de nouvelles valeurs.

Add - Ajoute de nouvelles valeurs à la sélection en cours.

Keep - Conserve les valeurs que vous venez de choisir dans la sélection en cours et supprime les autres valeurs.

Remove - Supprime de la sélection en cours les valeurs que vous venez de choisir et conserve les autres.

Zone Dimension Values in Hierarchy - Répertorie les hiérarchies définies pour la dimension sélectionnée. Sélectionnez la hiérarchie à utiliser.

Zone At Level(s) - Répertorie les niveaux définis pour la dimension et la hiérarchie sélectionnées. Sélectionnez les niveaux à inclure dans votre nouvelle sélection. Vous pouvez utiliser MAJ + CLIC ou CTRL + CLIC pour sélectionner plusieurs niveaux.

Zone Script - Affiche les critères qui seront ajoutés au script de sélection si vous choisissez OK.

Bouton Preview - Ouvre la boîte de dialogue Preview, qui permet de voir la modification envisagée et répertorie les valeurs de la dimension qui seront sélectionnées si vous adoptez cette modification.


Boîte de dialogue Select by Matching Characters

Rubriques connexes

La boîte de dialogue Select by Matching Characters permet de choisir des valeurs de la dimension correspondant à une chaîne de caractères donnée.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Selection Type - Comporte les options suivantes concernant la manière dont les valeurs que vous venez de sélectionner vont affecter la sélection en cours :

Select - Remplace la sélection en cours par de nouvelles valeurs.

Add - Ajoute de nouvelles valeurs à la sélection en cours.

Keep - Conserve les valeurs que vous venez de choisir dans la sélection en cours et supprime les autres valeurs.

Remove - Supprime de la sélection en cours les valeurs que vous venez de choisir et conserve les autres.

Zone Dimension Values that - Indique la relation existant entre les valeurs concordantes de la dimension et la chaîne de caractères spécifiée (contain, start with, end with ou match exactly).

Zone Character(s) - Saisissez le texte dont il faut établir la concordance lors du choix des valeurs de la dimension.

Zone In Hierarchy - Répertorie les hiérarchies définies pour la dimension sélectionnée. Sélectionnez la hiérarchie à utiliser ou sélectionnez NONE pour rechercher toutes les valeurs de la dimension. Cette zone n'apparaît pas si aucune hiérarchie n’est définie pour cette dimension.

Zone At Level(s) - Répertorie les niveaux de la dimension en cours. Sélectionnez les niveaux à inclure dans votre nouvelle sélection ou sélectionnez All pour rechercher toutes les valeurs dans une dimension. Cette zone n'apparaît pas si aucune hiérarchie n’est définie pour cette dimension.

Case Ignore Capitalization - Lorsque cette case est sélectionnée (paramétrée par défaut), les majuscules et les minuscules ne sont pas prises en compte pour la recherche de concordances avec le texte saisi. Désactivez cette case pour que les majuscules et les minuscules du texte saisi soient prises en compte.

Zone Script - Affiche les critères qui seront ajoutés au script de sélection si vous choisissez OK.

Bouton Preview - Ouvre la boîte de dialogue Preview, qui permet de voir la modification envisagée et répertorie les valeurs de la dimension qui seront sélectionnées si vous adoptez cette modification.


Boîte de dialogue Select by Range

Rubriques connexes

La boîte de dialogue Select by Range vous permet de choisir une plage de périodes contiguës.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Selection Type - Comporte les options suivantes concernant la manière dont les valeurs que vous venez de sélectionner vont affecter la sélection en cours :

Select - Remplace la sélection en cours par de nouvelles valeurs.

Add - Ajoute de nouvelles valeurs à la sélection en cours.

Keep - Conserve les valeurs que vous venez de choisir dans la sélection en cours et supprime les autres valeurs.

Remove - Supprime de la sélection en cours les valeurs que vous venez de choisir et conserve les autres.

Zone Interval - Comporte les options suivantes concernant différents types d’intervalles :

The last - Sélectionne un nombre donné de périodes parmi les plus récentes. Lorsque vous choisissez cet intervalle, la zone Time Periods comporte une zone At Level permettant de sélectionner un niveau, une zone Including permettant de sélectionner le nombre de périodes et un libellé de texte indiquant la dernière date définie pour le niveau sélectionné.

To date - Sélectionne toutes les périodes situées entre une période donnée et l’instant présent. Lorsque vous choisissez cet intervalle, la zone Time Periods comporte une zone At Level permettant de choisir un niveau, une zone From permettant de choisir le début de la plage et un libellé de texte indiquant la dernière date définie pour le niveau sélectionné.

A range of - Sélectionne toutes les périodes situées entre la période de début et la période de fin (début et fin compris). Lorsque vous choisissez cet intervalle, la zone Time Periods comporte une zone At Level permettant de choisir un niveau, une zone From permettant de choisir le début de la plage et une zone To permettant de choisir la fin de la plage :

Zone Time Periods - Comporte au moins deux des zones suivantes ; ces zones permettent de définir la plage.

Zone In Hierarchy - Répertorie les hiérarchies définies pour la dimension sélectionnée. Sélectionnez la hiérarchie à utiliser.

Zone At Level - Affiche les niveaux de la hiérarchie Time. Sélectionnez le niveau à utiliser.

Zone From - Précise le début de la plage lorsque l’Intervalle est To date ou A range of.

Zone To - Précise la fin de la plage lorsque l’Intervalle est A range of.

Including - Précise le nombre de périodes à inclure dans la plage lorsque l’Intervalle est Last.

Zone Script - Affiche les critères qui seront ajoutés au script de sélection si vous choisissez OK.

Bouton Preview - Ouvre la boîte de dialogue Preview, qui permet de voir la modification envisagée et répertorie les valeurs de la dimension qui seront sélectionnées si vous adoptez cette modification.


Boîte de dialogue Select Top/Bottom

Rubriques connexes

La boîte de dialogue Select Top/Bottom permet de choisir des valeurs de la dimension en fonction des premières et dernières valeurs de données d’un indicateur précis. Vous pouvez par exemple choisir les cinq villes réalisant les meilleures ventes de nos produits. Vous allez alors choisir les valeurs Geography en fonction des données de l'indicateur Sales.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Selection Type - Comporte les options suivantes concernant la manière dont les valeurs que vous venez de sélectionner vont affecter la sélection en cours :

Select - Remplace la sélection en cours par de nouvelles valeurs.

Add - Ajoute de nouvelles valeurs à la sélection en cours.

Keep - Conserve les valeurs que vous venez de choisir dans la sélection en cours et supprime les autres valeurs.

Remove - Supprime de la sélection en cours les valeurs que vous venez de choisir et conserve les autres.

Zones Top - Saisissez un chiffre dans la première zone afin de préciser le nombre exact ou le pourcentage de valeurs à rechercher parmi celles présentant les valeurs de données les plus importantes. Dans la deuxième zone, choisissez Dimension pour le nombre exact ou % Dimension pour un pourcentage.

Zones And/Or the bottom - Saisissez un chiffre dans la première zone afin de préciser le nombre exact ou le pourcentage de valeurs à rechercher parmi celles présentant les valeurs de données les plus faibles. Dans la deuxième zone, choisissez Dimension pour le nombre exact ou % Dimension pour un pourcentage.

Zone Based On - Identifie l'indicateur dont les valeurs serviront de critères de sélection. Pour sélectionner un autre indicateur, cliquez sur le bouton Ellipsis afin d’afficher la liste de tous les indicateurs utilisant la dimension en cours.

Zone Exclude - Comporte les options suivantes permettant le traitement des valeurs de données :

Case NAs - Cochez cette case pour que les valeurs de données NA soient exclues de la recherche.

Case Zeros - Cochez cette case pour que les valeurs de données nulles soient exclues de la recherche.

Case Sort automatically - Indique si le critère indiqué dans l'outil de tri doit être utilisé pour trier automatiquement la dimension à chaque changement de sélection. Lorsque cette case est désactivée, la sélection est triée de haut en bas.

Zone In Hierarchy - Répertorie les hiérarchies définies pour la dimension sélectionnée. Sélectionnez la hiérarchie à utiliser ou sélectionnez NONE pour inclure toutes les valeurs de la dimension.

Zone At Level(s) - Répertorie les niveaux de la hiérarchie de la dimension en cours. Sélectionnez les niveaux à inclure dans votre nouvelle sélection ou sélectionnez All pour inclure tous les niveaux. Utilisez MAJ + CLIC ou CTRL + CLIC pour mettre plusieurs niveaux en surbrillance.

Zone For Dimension - Identifie une seule valeur pour chacune des autres dimensions de l'indicateur. Pour modifier une sélection, cliquez sur le bouton Ellipsis adjacent afin d’afficher la liste de toutes les valeurs de la dimension.

Zone Script - Affiche les critères qui seront ajoutés au script de sélection si vous choisissez OK.

Bouton Preview - Ouvre la boîte de dialogue Preview, qui permet de voir la modification envisagée et répertorie les valeurs de la dimension qui seront sélectionnées si vous adoptez cette modification.


Boîte de dialogue Selection Library

Rubriques connexes

La boîte de dialogue Selection Library permet d'enregistrer les sélections, et de renommer ou de supprimer des sélections enregistrées.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Zone Selections - Répertorie les sélections enregistrées de la dimension. Choisissez <Current Selection> pour enregistrer la sélection actuelle en tant que nouvelle sélection enregistrée. Pour renommer ou supprimer une sélection enregistrée, choisissez une sélection enregistrée dans la liste.

Dimension label - Identifie la dimension à laquelle la sélection enregistrée appartient.

Hierarchy label - Identifie la dernière hiérarchie sélectionnée utilisée dans la sélection enregistrée mise en évidence. Lorsque vous utilisez de nouveau cette sélection, cette hiérarchie devient la hiérarchie actuelle de la dimension.

Database label - Identifie la base de données contenant la dimension.

Type label - Indique si la sélection enregistrée est dynamique ou statique.

Access label - Indique si vous pouvez écraser, renommer ou supprimer la sélection enregistrée.

Zone Script - Affiche le script de sélection de la sélection enregistrée, à condition que la case Show selection script soit cochée dans la boîte de dialogue Selector Options.

Bouton Save - Ouvre la boîte de dialogue Save Selection, dans laquelle vous pouvez attribuer un nom à la nouvelle sélection et l'enregistrer.

Bouton Rename - Ouvre la boîte de dialogue Rename Selection, dans laquelle vous pouvez entrer un nouveau nom pour la sélection enregistrée.

Bouton Delete - Permet de supprimer la sélection enregistrée mise en évidence.


Boîte de dialogue Selector

Rubriques connexes

La boîte de dialogue de sélection permet de choisir les valeurs de dimension à afficher dans une interrogation. Vous pouvez sélectionner des valeurs précises pour une dimension, enregistrer une sélection personnalisée de valeurs de dimensions et utiliser des indicateurs personnalisés. Vous pouvez également personnaliser la boîte de dialogue pour l'interrogation.

La boîte de dialogue Selector est la première d’une série de boîtes de dialogues connexes qui composent le Sélecteur.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Barre d'outils - Comporte des boutons correspondant aux outils du Sélecteur disponibles pour la dimension sélectionnée. Chaque outil ouvre une boîte de dialogue permettant de sélectionner des valeurs de la dimension. Pour afficher un outil du Sélecteur, cliquez sur le bouton correspondant.

Si l’un des outils du Sélecteur n'apparaît pas, choisissez Options, puis sélectionnez l’outil dans la liste Available tools. Cet outil devient disponible.

Boutons d’option ou cases à cocher Dimensions - Répertorie les dimensions des indicateurs sélectionnés pour l’interrogation. En fonction du nombre de dimensions et de la configuration des options du Sélecteur, chaque dimension peut être affichée sous forme de bouton d’option, ou la liste des dimensions peut apparaître dans une zone de liste. Sélectionnez la dimension dont vous souhaitez modifier la sélection.

Zone Dimension Selection Values - Répertorie les valeurs de la dimension actuellement sélectionnées. Cette zone apparaît uniquement lorsque la case Show Selection Values de la boîte de dialogue Selector Options est cochée.

Zone Dimension Selection Script - Affiche l'intégralité du script qui décrit les sélections de la dimension. Cette zone n'apparaît que lorsque la case Show Selection Script est cochée dans la boîte de dialogue Selector Options.

Bouton Custom - Ouvre la boîte de dialogue Custom Measures, qui permet de créer, de copier, d'éditer et de supprimer des indicateurs personnalisés. Ce bouton n'apparaît que lorsque la case Allow custom measure functionality est cochée dans la boîte de dialogue Selector Options.

Bouton Library - Ouvre la boîte de dialogue Selection Library, qui permet de créer, de renommer et de supprimer des sélections enregistrées. Ce bouton n'apparaît que lorsque la case Allow access to saved selection library est cochée dans la boîte de dialogue Selector Options.

Bouton Options - Affiche la boîte de dialogue Selector Options qui permet de définir des préférences concernant l’apparence de la boîte de dialogue Selector pour l’interrogation en cours.


Boîte de dialogue Selector Options

Rubriques connexes

La boîte de dialogue Selector Options permet de définir des préférences concernant l’apparence de la boîte de dialogue Selector. Les options définies dans cette boîte de dialogue restent actives chaque fois que le Sélecteur est affiché à partir de l’interrogation.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Case à cocher Allow Custom Measure Functionality - Lorsque cette case est cochée, le bouton Custom apparaît dans la boîte de dialogue de sélection et vous permet d'accéder à la boîte de dialogue Custom Measures.

Case à cocher Allow Access To Saved Selection Library - Lorsque cette case est cochée, le bouton Library apparaît dans la boîte de dialogue de sélection et permet aux utilisateurs d'accéder à la boîte de dialogue Selection Library.

Case à cocher Show selection values - Lorsque cette case est cochée, les valeurs de la dimension de la sélection en cours apparaissent dans une zone de liste de la boîte de dialogue Selector.

Case à cocher Show Selection Script - Lorsque cette case est cochée, le script de sélection apparaît dans la boîte de dialogue Selector et dans les boîtes de dialogue connexes.

Case à cocher Use listbox to represent dimension - Lorsque cette case est cochée, les dimensions disponibles apparaissent dans une zone de liste, même si leur nombre restreint leur permettrait d'être affichées sous forme de libellés de boutons d'option. Lorsque cette case est désactivée, les dimensions n'apparaissent dans une zone de liste que lorsque leur nombre ne leur permet pas d'être affichées sous forme de boutons d'option.

Zone Show Dimension Values As - Affiche les options permettant d'indiquer les libellés ou les valeurs utilisés lors de la création de la liste des valeurs de dimension dans le Sélecteur. L'administrateur de base de données fournit ces libellés lors de la configuration de la base de données. Choisissez l'une des options suivantes :

Long labels - Utilise des libellés longs (par exemple, New York City, New York).

Short labels - Utilise des libellés abrégés (par exemple, New York).

Values - Utilise la valeur de la dimension telle qu'elle apparaît dans la base de données (par exemple, NEWYORK).

Zone Available Tools - Affiche une case à cocher pour chaque outil du Sélecteur. Lorsqu'une case est cochée, l'outil apparaît dans la boîte de dialogue Selector. Lorsque la case est désactivée, l'outil n'apparaît pas dans la boîte de dialogue.

Zone Maximum Dimension Values In A Selection - Indique le nombre maximal de valeurs de la dimension qui sont autorisées dans une sélection. Le Sélecteur ne permet pas d'en sélectionner davantage.


Boîte de dialogue Sort Selection

Rubriques connexes

La boîte de dialogue Sort Selection permet de trier les valeurs de dimension d'une sélection. Les méthodes de tri que vous pouvez utiliser dépendent des propriétés de la dimension.

Cette boîte de dialogue n'est pas traduite dans toutes les langues.

Eléments de la boîte de dialogue

Les éléments disponibles varient en fonction de la dimension en cours et des options que vous sélectionnez.

Zone Based On - Répertorie les méthodes de tri, comme suit :

Alphabet - Trie les valeurs dans l'ordre alphabétique, de A à Z ou de Z à A.

Database - Trie les valeurs selon leur ordre d'enregistrement dans la base de données, dans l’ordre standard ou dans l’ordre reverse (inverse).

Data Value - Trie les valeurs en fonction des valeurs de données correspondantes d’un indicateur, soit de low to high (ordre croissant), soit de high to low (ordre décroissant). Les zones supplémentaires suivantes apparaissent lorsque vous choisissez cette méthode :

Zone Using - Spécifie l'indicateur dont vous souhaitez utiliser les valeurs de données. Pour sélectionner un autre indicateur utilisant la dimension en cours, cliquez sur le bouton Ellipsis.

Zone For - Répertorie les autres dimensions de l'indicateur choisi à l’aide de la zone Using et identifie une valeur de dimension unique pour chacune d’elles. Pour modifier une valeur de dimension, choisissez le bouton Ellipsis.

Dragdrop - Vous permet de trier des valeurs manuellement. Une zone de liste des dimensions affiche les valeurs de la sélection en cours. Vous pouvez cliquer sur une valeur et la faire glisser jusqu'à un autre emplacement de la liste.

Hierarchy - Trie les valeurs en fonction de leur ordre dans la hiérarchie, de haut en bas (top to bottom) ou de bas en haut (bottom to top). Disponible uniquement lorsque la dimension sélectionnée possède une hiérarchie. Lorsque vous choisissez cette méthode, la zone In Hierarchy apparaît pour vous permettre de sélectionner une hiérarchie.

Level - Trie les valeurs en fonction de leur niveau, soit de haut en bas (top to bottom), soit de bas en haut (bottom to top). Disponible uniquement lorsque la dimension sélectionnée possède une hiérarchie. Notez que le tri affecte l’ordre des niveaux mais ne modifie pas l’ordre des valeurs au sein d’un niveau. Lorsque vous choisissez cette méthode, la zone In Hierarchy apparaît pour vous permettre de sélectionner une hiérarchie.

Time - Trie les valeurs de la plus récente à la plus ancienne (earliest to latest) ou dans l'ordre inverse (latest to earliest). Disponible uniquement si vous utilisez la dimension Time. Lorsque vous choisissez cette méthode, la zone In Hierarchy apparaît pour vous permettre de sélectionner une hiérarchie.

Zone In Hierarchy - Lorsque vous choisissez Data Value, Hierarchy, Level ou Time dans la zone Based On, la zone In Hierarchy répertorie les hiérarchies définies pour la dimension sélectionnée. Sélectionnez la hiérarchie que vous souhaitez utiliser.

Zone In Order - Répertorie les options d’ordre de tri des méthodes Alphabet, Database, Data Value, Hierarchy, Level et Time.

Zone Script - Affiche les critères qui seront ajoutés au script de sélection si vous choisissez OK.

Bouton Preview - Affiche la boîte de dialogue Preview afin que vous puissiez voir le nouvel ordre de tri des valeurs sélectionnées avant de remplacer l’ancien ordre de tri.

Case à cocher Sort Automatically - Indique si la dimension doit être triée automatiquement à chaque modification de la sélection.


Rubriques connexes -- Boîte de dialogue Liste

Remplacement ou redéfinition des sélections

Utilisation de l'outil Liste


Rubriques connexes -- Boîte de dialogue Custom Measures

Création d'indicateurs personnalisés

Définition d'expressions pour les indicateurs personnalisés

Limitation de l'accès aux indicateurs personnalisés


Voir aussi -- Création d'indicateurs personnalisés

Copie d'indicateurs personnalisés

Définition d'expressions pour les indicateurs personnalisés

Limitation de l'accès aux indicateurs personnalisés


Voir aussi -- Remplacement des sélections enregistrées

Contrôle de l'accès à la bibliothèque des sélections enregistrées

Création de sélections enregistrées

Suppression des sélections enregistrées

Attribution d'un nouveau nom aux sélections enregistrées


Rubriques connexes -- Boîte de dialogue Sélections enregistrées

Utilisation de sélections enregistrées


Rubriques connexes -- Boîte de dialogue Sélectionner tout

Remplacement ou redéfinition des sélections

Utilisation de l'outil Tout


Rubriques connexes -- Boîte de dialogue Sélection par attribut

Remplacement ou redéfinition des sélections

Utilisation de l'outil Attribut


Rubriques connexes -- Boîte de dialogue Sélection par exception

Remplacement ou redéfinition des sélections

Utilisation de l'outil Exception


Rubriques connexes -- Boîte de dialogue Sélection par famille

Remplacement ou redéfinition des sélections

Utilisation de l'outil Famille


Rubriques connexes -- Boîte de dialogue Sélection par niveau

Remplacement ou redéfinition des sélections

Utilisation de l'outil Niveau


Rubriques connexes -- Boîte de dialogue Sélection par caractères correspondants

Remplacement ou redéfinition des sélections

Utilisation de l'outil de mise en correspondance


Rubriques connexes -- Boîte de dialogue Sélection par période

Remplacement ou redéfinition des sélections

Utilisation de l'outil Plage


Rubriques connexes -- Boîte de dialogue Sélection des meilleurs/moins bons

Remplacement ou redéfinition des sélections

Utilisation de l'outil Haut/Bas


Rubriques connexes -- Boîte de dialogue Selection Library

Création de sélections enregistrées


Rubriques connexes -- Boîte de dialogue Sélecteur

Création d'indicateurs personnalisés

Création de sélections enregistrées

Personnalisation du Sélecteur pour une interrogation

Attribution d'un nouveau nom aux sélections enregistrées

Remplacement ou redéfinition des sélections

Sélection de données

Barre d'outils du Sélecteur

Utilisation de sélections enregistrées


Rubriques connexes -- Boîte de dialogue Options du Sélecteur

Contrôle de l'accès à la bibliothèque des sélections enregistrées

Personnalisation du Sélecteur pour une interrogation

Affichage du nom des dimensions dans le Sélecteur

Affichage de la valeur des dimensions dans le Sélecteur

Affichage ou masquage des outils du Sélecteur

Limitation de l'accès aux indicateurs personnalisés


Rubriques connexes - Barre d'outils du Sélecteur

Affichage ou masquage des outils du Sélecteur

Utilisation de sélections enregistrées

Utilisation de l'outil Tout

Utilisation de l'outil Attribut

Utilisation de l'outil Exception

Utilisation de l'outil Famille

Utilisation de l'outil Niveau

Utilisation de l'outil Liste

Utilisation de l'outil de mise en correspondance

Utilisation de l'outil Plage

Utilisation de l'outil de tri

Utilisation de l'outil Haut/Bas


Rubriques connexes -- Boîte de dialogue Tri de sélection

Utilisation de l'outil de tri


Personnalisation du Sélecteur pour une interrogation

Vous pouvez définir les options du Sélecteur pour personnaliser l'aspect et le mode de fonctionnement de la boîte de dialogue Sélecteur d'une interrogation. Chaque fois que le Sélecteur est affiché depuis une interrogation, la boîte de dialogue Sélecteur personnalisée apparaît.

Vous pouvez personnaliser la boîte de dialogue Sélecteur de l'une des manières suivantes :

en masquant ou en affichant les outils du Sélecteur dans la boîte de dialogue ;

en affichant le nom des dimensions dans une zone de liste, même si leur nombre réduit permet leur affichage sous forme de libellés de boutons d'option ;

en précisant le mode et l'emplacement d'affichage des valeurs des dimensions.

en contrôlant l'accès à la bibliothèque des sélections enregistrées ;

en contrôlant l'accès à la boîte de dialogue Custom Measures.


Contrôle de l'accès à la bibliothèque des sélections enregistrées

Par défaut, la boîte de dialogue Selector inclut le bouton Library qui permet d'accéder à la boîte de dialogue Selection Library, dans laquelle vous pouvez créer des sélections enregistrées, les modifier, les renommer ou les supprimer. Vous pouvez interdire l'accès à la bibliothèque des sélections enregistrées en masquant le bouton Library pour l'interrogation actuelle.

Remarque : Le refus de l'accès à la bibliothèque des sélections enregistrées n'empêche pas les utilisateurs d'employer une sélection enregistrée si l'outil de sélection enregistrée est disponible.

Pour contrôler l'accès à la bibliothèque des sélections :

1.	Dans la boîte de dialogue Sélecteur, choisissez Options.

2.	Dans la boîte de dialogue Selector Options, cochez ou désélectionnez la case Allow access to saved selection library :

Pour permettre l'accès à la bibliothèque, cochez la case.

ou

Pour refuser l'accès à la bibliothèque, désélectionnez la case.

3.	Cliquez sur OK.


Création de sélections enregistrées

En général, lors de l'utilisation du Sélecteur, vous sélectionnez toujours les mêmes ensembles de valeurs de dimension. Pour gagner du temps, enregistrez ces sélections pour les utiliser dans une autre interrogation.

Si vous enregistrez une sélection alors que la base de données correspondante est attachée en mode lecture/écriture, la sélection enregistrée est disponible pour tous les utilisateurs qui attachent cette base de données. Si vous enregistrez une sélection alors que la base de données correspondante est attachée en lecture seule, vous seul pouvez accéder à cette sélection.

Pour enregistrer une sélection :

1.	Dans la boîte de dialogue Selector, choisissez Library. La boîte de dialogue Selection Library apparaît.

Remarque : Si la boîte de dialogue Selector ne comprend pas de bouton Library, modifiez l'option appropriée afin d'autoriser l'accès à la bibliothèque.

2.	Dans la zone Selections, cliquez sur <Current Selection>.

3.	Dans la boîte de dialogue Selection Library, cliquez sur Save.

4.	Remplissez la boîte de dialogue Save Selection. Passez en revue les informations affichées afin de vérifier qu'elles décrivent bien la sélection que vous voulez enregistrer.

5.	Cliquez sur OK.

6.	Dans la boîte de dialogue Selection Library, cliquez sur Close pour revenir à la boîte de dialogue Selector.


Suppression de sélections enregistrées
Suppression des sélections enregistrées

Vous pouvez supprimer toutes les sélections enregistrées inutiles.

Pour supprimer une sélection enregistrée :

1.	Dans la boîte de dialogue Selector, choisissez Library. La boîte de dialogue Selection Library apparaît.

Remarque : Si la boîte de dialogue du Sélecteur ne contient pas de bouton Library, modifiez l'option appropriée afin d'autoriser l'accès à la bibliothèque.

2.	Choisissez la sélection enregistrée à supprimer, puis cliquez sur Delete. Un message vous demande de confirmer la suppression de la sélection.

3.	Cliquez sur OK.

4.	Dans la boîte de dialogue Selection Library, cliquez sur Close pour revenir à la boîte de dialogue Selector.


Affichage du nom des dimensions dans le Sélecteur

Par défaut, le nom des dimensions apparaît sous la forme d'un libellé de bouton d'option dans la boîte de dialogue Sélecteur. En revanche, si le nombre de ces dimensions est trop élevé, leur nom apparaît dans une zone de liste. Vous pouvez donc définir une option pour que ces noms soient toujours affichés sous forme de liste, quel que soit le nombre des dimensions.

La configuration choisie est appliquée chaque fois que la boîte de dialogue Sélecteur est affichée depuis l'interrogation.

Pour afficher le nom des dimensions dans une zone de liste dans le Sélecteur :

1.	Dans la boîte de dialogue Sélecteur, choisissez Options. La boîte de dialogue Options du Sélecteur apparaît.

2.	Sélectionnez Utiliser zone de liste pour représenter dimensions.

3.	Cliquez sur OK.


Affichage de la valeur des dimensions dans le Sélecteur

Les options du Sélecteur vous permettent d'adapter l'affichage des valeurs des dimensions dans le Sélecteur. Vous pouvez :

afficher ces valeurs dans la boîte de dialogue Selector ;

modifier leur mode d'affichage et d'utilisation dans le Sélecteur.

La configuration choisie est appliquée chaque fois que la boîte de dialogue Sélecteur est affichée depuis l'interrogation.

Affichage des valeurs dans la boîte de dialogue Sélecteur

Par défaut, la boîte de dialogue Sélecteur affiche le script de sélection de la dimension sélectionnée et non les valeurs sélectionnées. Vous pouvez utiliser les outils Liste pour visualiser ces valeurs ; vous pouvez également définir une option du Sélecteur pour afficher les valeurs dans la boîte de dialogue Sélecteur.

Pour afficher les valeurs des dimensions dans la boîte de dialogue Sélecteur :

1.	Dans la boîte de dialogue Sélecteur, choisissez Options.

2.	Dans la boîte de dialogue Options du Sélecteur, sélectionnez Afficher les valeurs de la sélection.

3.	Cliquez sur OK.

Modification du mode d'affichage des valeurs des dimensions dans le Sélecteur

Par défaut, les valeurs des dimensions apparaissent dans le Sélecteur sous forme de libellés développés, tels que New York. Dans la base de données Express, les valeurs ont également des libellés abrégés (par exemple, NY), ainsi que des identificateurs ne comportant que des majuscules et aucun espace (par exemple, NEWYORK). Les options du Sélecteur vous permettent de choisir parmi ces trois types d'affichage celui que vous voulez utiliser dans les zones de liste du Sélecteur.

Remarque : L'outil de tri et l'outil de mise en correspondance emploient également le type de libellé que vous choisissez ici. Par exemple, si vous paramétrez cette option sur Valeurs, l'outil de mise en correspondance recherche les valeurs des dimensions correspondant à la chaîne indiquée. Lorsque l'outil de tri classe une dimension dans l'ordre alphabétique, il utilise l'orthographe des valeurs de la dimension pour en déduire le classement alphabétique.

Pour modifier le mode d'affichage des valeurs des dimensions dans les listes du Sélecteur :

1.	Dans la boîte de dialogue Sélecteur, choisissez Options.

2.	Dans la boîte de dialogue Options du Sélecteur, sélectionnez une option dans la zone Afficher les valeurs de dimension :

Pour afficher les valeurs des dimensions sous leur forme développée (comme New York), choisissez Descriptions.

Pour afficher les valeurs des dimensions sous leur forme réduite (comme NY), choisissez Libellés abrégés.

Pour afficher les valeurs des dimensions telles qu'elles apparaissent dans la base de données Express, choisissez Valeurs.

3.	Cliquez sur OK.


Affichage ou masquage des outils du Sélecteur

Par défaut, tous les outils du Sélecteur sont répertoriés dans la boîte de dialogue Sélecteur. Quand un outil ne s'applique pas à la dimension sélectionnée, il est grisé. Les options du Sélecteur vous permettent de masquer un outil dans cette boîte de dialogue.

La configuration choisie est appliquée chaque fois que la boîte de dialogue Sélecteur est affichée depuis l'interrogation.

Pour masquer les outils du Sélecteur dans la boîte de dialogue Sélecteur :

1.	Dans la boîte de dialogue Sélecteur, choisissez Options. La boîte de dialogue Options du Sélecteur apparaît.

2.	Dans la zone Outils disponibles, activez (ou désactivez) la case à cocher correspondant aux outils à afficher (ou à masquer) dans la boîte de dialogue Sélecteur. Par exemple, pour afficher l'outil Tout mais pas l'outil Plage, activez la case à cocher de ce premier outil, mais pas celle du second.

3.	Cliquez sur OK.


Attribution d'un nouveau nom aux sélections enregistrées

Une fois une sélection enregistrée, vous pouvez la renommer.

Pour renommer une sélection enregistrée :

1.	Dans la boîte de dialogue Selector, choisissez Library.

Remarque : Si la boîte de dialogue du Sélecteur ne contient pas de bouton Library, modifiez l'option appropriée afin d'autoriser l'accès à la bibliothèque.

2.	Dans la boîte de dialogue Selection Library, sélectionnez la sélection enregistrée à renommer.

3.	Cliquez sur Rename.

4.	Complétez la boîte de dialogue Rename Selection.

5.	Cliquez sur OK.

6.	Dans la boîte de dialogue Selection Library, cliquez sur Close pour revenir à la boîte de dialogue Selector.


Remplacement ou redéfinition des sélections

Utilisez les outils du Sélecteur pour préciser les valeurs de dimensions à insérer dans la dimension sélectionnée. Vous pouvez vous servir des outils pour recommencer le processus de sélection en remplaçant la sélection en cours, ou en redéfinissant cette sélection.

Pour remplacer la sélection en cours :

Dans l'outil Sélecteur, choisissez Sélectionner comme type de sélection.

Pour redéfinir la sélection en cours :

Dans l'outil Sélecteur, choisissez l'un des types de sélection suivants :

Pour ajouter des valeurs de dimensions nouvellement sélectionnées à la sélection en cours, choisissez Ajouter.

Pour ne conserver que les valeurs de dimensions nouvellement sélectionnées dans la sélection, choisissez Conserver.

Pour supprimer les valeurs nouvellement sélectionnées de la sélection en cours, choisissez Supprimer.


Remplacement des sélections enregistrées

Rubriques connexes

Vous pouvez remplacer les sélections qui ont été enregistrées.

Pour modifier une sélection enregistrée :

1.	Utilisez l'outil Saved Selection pour choisir la sélection enregistrée à modifier.

ou

Utilisez une nouvelle sélection.

2.	Utilisez d'autres outils du Sélecteur pour modifier la sélection.

3.	Dans la boîte de dialogue Selector, choisissez Library. La boîte de dialogue Selection Library apparaît.

Remarque : Si la boîte de dialogue du Sélecteur ne contient pas de bouton Library, modifiez l'option appropriée afin d'autoriser l'accès à la bibliothèque.

4.	Dans la zone Selections, cliquez sur <Current Selection>.

5.	Cliquez sur Save.

6.	Remplissez la boîte de dialogue Save Selection. Passez en revue les informations affichées afin de vous assurer qu'elles décrivent bien la sélection que vous voulez enregistrer et de vérifier que l'option Replacement est sélectionnée dans la zone Save Selection As.

7.	Cliquez sur OK.

8.	Complétez la boîte de dialogue Replace Saved Selection.

9.	Dans la boîte de dialogue Selection Library, cliquez sur Close pour revenir à la boîte de dialogue Selector.


Sélection de données

Le Sélecteur est un ensemble de boîtes de dialogue connexes qui permet de sélectionner des valeurs de dimensions pour chaque dimension. Vous pouvez vous servir des fonctions du Sélecteur pour choisir des valeurs spécifiques pour une dimension, trier les valeurs, enregistrer une sélection personnalisée de valeurs de dimensions, et travailler avec les indicateurs personnalisés et sélections enregistrées. Vous pouvez également définir des options d'affichage pour le Sélecteur.

Pour utiliser le Sélecteur :

1.	Dans la boîte de dialogue Express Query, sélectionnez une mesure pour l'interrogation et cliquez sur Selector.

La boîte de dialogue Sélecteur apparaît. Les dimensions et le nombre de valeurs actuellement sélectionnées pour chaque dimension sont affichées.

Conseil : Vous pouvez cliquer sur Options pour modifier le mode d'affichage des valeurs dans le Sélecteur. Par exemple, vous pouvez les afficher dans une liste et non sous la forme d'une valeur.

2.	Utilisez les outils du Sélecteur pour sélectionner et trier les valeurs de cette dimension, y compris les sélections enregistrées. Les critères de sélection utilisés sont affichés dans un script. Servez-vous de ces outils pour redéfinir ou remplacer la sélection en cours.

Remarque : Tous les outils ne sont pas applicables à toutes les dimensions. Ceux qui sont grisés ne sont pas accessibles.

Conseil : Pour afficher les valeurs des dimensions sélectionnées, choisissez l'outil Liste.

3.	Lorsque la sélection inclut les valeurs voulues, cliquez sur OK dans la boîte de dialogue de sélection.

Conseil : Si vous souhaitez réutiliser les critères de sélection créés, enregistrez-les avant de quitter le Sélecteur. Pour enregistrer la sélection, choisissez Library.

4.	Répétez les étapes 1 à 3 pour chacune des dimensions à modifier.

5.	Pour créer un indicateur personnalisé ou sélectionner un indicateur personnalisé enregistré, choisissez la dimension Measure, puis Custom.

6.	Une fois cette opération terminée, cliquez sur OK.


Barre d'outils du Sélecteur

Rubriques connexes

La barre d'outils du Sélecteur se compose d'outils qui vous aideront à sélectionner ou à organiser les valeurs de dimensions répondant à vos critères. Cette barre d'outils apparaît en haut de la boîte de dialogue Sélecteur.

Icône	Outil	Description
	Outil Tout	Sélectionne ou désélectionne toutes les valeurs d'une dimension ou d'une hiérarchie de dimensions.
	Outil Liste	Sélectionne ou désélectionne des valeurs dans la liste des valeurs d'une dimension.
	Outil de mise en correspondance	Sélectionne des valeurs de dimensions contenant une chaîne de caractère donnée.
	Outil Niveau	Sélectionne ou désélectionne des valeurs de dimensions à un ou plusieurs niveaux d'une hiérarchie.
	Outil Famille	Sélectionne ou désélectionne des valeurs de dimensions sur la base d'un lien de parenté avec une valeur de dimension particulière.
	Outil Attribut	Sélectionne ou désélectionne un groupe de valeurs de dimensions ayant des attributs communs, comme la couleur ou la taille.
	Outil Exception	Sélectionne ou désélectionne des valeurs de dimensions sur la base d'une comparaison entre les valeurs d'un indicateur, et une ou plusieurs autres valeurs.
	Outil Haut/Bas	Sélectionne ou désélectionne les valeurs minimale et maximale de données dans un indicateur spécifique.
	Outil Plage	Sélectionne ou désélectionne une plage de périodes.
	Outil Saved Selection	Sélectionne ou désélectionne des valeurs de dimension dans une sélection enregistrée.
	Outil de tri	Trie les valeurs de dimensions sur la base des critères que vous indiquez.


Utilisation des sélections enregistrées
Utilisation de sélections enregistrées

Vous pouvez utiliser des sélections enregistrées dans l'administrateur Express.

Pour utiliser une sélection enregistrée :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil Enregist. qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Sélection enregistrée.

3.	Cliquez sur OK.


Utilisation de l'outil Tout

Utilisez l'outil Tout pour sélectionner toutes les valeurs d'une dimension ou toutes les valeurs de dimensions d'une hiérarchie.

Pour sélectionner toutes les valeurs d'une dimension ou d'une hiérarchie :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil Tout qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Sélectionner Tout.

3.	Cliquez sur OK.


Utilisation de l'outil Attribut

Utilisez l'outil Attribut pour sélectionner des valeurs de dimensions ayant un attribut en commun, comme la couleur ou la taille.

Pour sélectionner des valeurs d'une dimension sur la base d'un attribut, cette dimension doit en comporter au moins un.

Pour sélectionner des valeurs de dimensions ayant un attribut en commun :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil Attribut qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Sélection par attribut.

3.	Cliquez sur OK.


Utilisation de l'outil Exception

Utilisez l'outil Exception pour sélectionner des valeurs de dimensions sur la base des valeurs d'un indicateur faisant appel à cette dimension. Par exemple, vous pouvez sélectionner les villes dont les ventes (paramètre Sales) sont supérieures à 5 000 000 F.

Vous pouvez également vous servir de l'outil Exception pour faire reposer une sélection sur la comparaison de deux indicateurs. Par exemple, vous pouvez sélectionner les produits pour lesquels les ventes (paramètre Sales) sont supérieures de 5 % aux prévisions (paramètre Forecast).

Remarque : La recherche des valeurs d'exceptions est limitée à une valeur de dimension pour chacune des autres dimensions de l'indicateur indiqué.

Pour sélectionner des valeurs à l'aide de outil Exception :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil Exception qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Sélection par exception.

3.	Cliquez sur OK.


Utilisation de l'outil Famille

Lorsqu'une dimension est associée à une hiérarchie, vous pouvez utiliser l'outil Famille pour sélectionner des valeurs ayant un lien de parenté avec une valeur de dimension donnée. Par exemple, supposez qu'en tant que responsable régional des ventes, vous sélectionniez les villes de votre région. Vous pouvez vous servir de l'outil Famille pour sélectionner une région (par exemple, Eastern U.S.) et ses fils (par exemple, Boston, New York, Philadelphia, etc.).

Vous pouvez également repérer un magasin dont les ventes ont doublé au cours du mois. Utilisez l'outil Famille pour sélectionner les pères et les ancêtres du magasin afin de connaître l'incidence des ventes du magasin sur le résultat des ventes de la ville et de la région dans lesquelles se trouve ce magasin.

Pour sélectionner des valeurs à l'aide de l'outil Famille :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil Famille qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Sélection par famille.

3.	Cliquez sur OK.


Utilisation de l'outil Niveau

Lorsqu'une dimension est associée à une hiérarchie, utilisez l'outil Niveau pour sélectionner toutes les valeurs à un ou plusieurs niveaux de cette hiérarchie. Par exemple, pour analyser les ventes par ville, vous pouvez sélectionner toutes les valeurs de la dimension Geography au niveau City. Pour analyser les ventes sur une base mensuelle et trimestrielle, vous pouvez sélectionner toutes les valeurs de la dimension Time aux niveaux Month et Quarter.

Pour sélectionner des valeurs à l'aide de outil Niveau :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil Niveau qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Sélection par niveau.

3.	Cliquez sur OK.


Utilisation de l'outil Liste

Utilisez l'outil Liste pour sélectionner des valeurs de dimensions dans la liste des valeurs disponibles.

Pour sélectionner des valeurs de dimensions à l'aide de l'outil Liste :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil Liste qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Liste, puis sélectionnez des valeurs de dimensions comme suit :

Pour...	Sélectionnez des valeurs dans...
ajouter des valeurs à la sélection en cours ou remplacer cette sélection	la zone Valeurs disponibles, puis choisissez Ajouter ou Sélectionner
conserver les valeurs de la sélection en cours ou en supprimer	la zone Valeurs sélectionnées, puis choisissez Conserver ou Supprimer
3.	Cliquez sur OK.


Utilisation de l'outil de mise en correspondance

Utilisez l'outil de mise en correspondance pour sélectionner les valeurs de dimensions contenant des caractères donnés. Par exemple, vous pouvez vous servir de cet outil pour sélectionner toutes les valeurs qui contiennent les caractères "Size 12".

L'outil de mise en correspondance analyse les valeurs de dimensions à mesure qu'elles apparaissent dans le Sélecteur. Par exemple, si vous définissez l'option du Sélecteur de manière à ce qu'il affiche les valeurs de dimensions sous forme de libellés abrégés, l'outil de mise en correspondance recherche, dans les libellés de ce type, la chaîne de caractères entrée.

Conseil : Vous pouvez cliquer sur le bouton Options pour modifier le mode d'affichage des noms des valeurs de dimensions dans le Sélecteur. Par exemple, vous pouvez indiquer que les valeurs seront affichées sous leur forme abrégée (par exemple, NY) plutôt que développée (par exemple, New York).

Pour sélectionner des valeurs à l'aide de l'outil de mise en correspondance :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil de mise en correspondance qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Sélection par caractères correspondants.

3.	Cliquez sur OK.


Utilisation de l'outil Plage

Utilisez l'outil Plage pour sélectionner une plage de valeurs Time. Par exemple, vous pouvez sélectionner les mois compris entre janvier et juin de l'année précédente. Vous pouvez également sélectionner tous les mois depuis janvier de cette année jusqu'à la date du jour, ou encore sélectionner les trois derniers mois.

Pour sélectionner une plage de valeurs temporelles :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil Plage qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Sélection par période.

3.	Cliquez sur OK.


Utilisation de l'outil de tri

Par défaut, chaque dimension hiérarchique est triée avant d'apparaître dans le résultat de l'interrogation et après chaque modification de la sélection. Pour les dimensions hiérarchiques, vous pouvez utiliser l'outil de tri pour désactiver le tri automatique ou pour modifier les règles utilisées par cet outil pour trier les valeurs des dimensions.

Pour les dimensions non hiérarchiques, vous pouvez vous servir de l'outil de tri pour trier les valeurs des dimensions ou pour activer le tri automatique de la dimension.

Pour trier les valeurs des dimensions :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil de tri qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Tri de sélection. Veillez à sélectionner l'option Trier automatiquement pour que les valeurs des dimensions soient triées à chaque modification de la sélection.

3.	Cliquez sur OK.


Utilisation de l'outil Haut/Bas

Utilisez l'outil Haut/Bas pour sélectionner les valeurs de dimensions disposant des valeurs de données maximales ou minimales pour un indicateur donné. Par exemple, vous pouvez sélectionner les 10 meilleures villes (Cities) sur la base des ventes (Sales) de la gamme de produits audio (Audio Division) au cours du premier trimestre. Vous pouvez également sélectionner les villes se trouvant dans les derniers 30 % sur la base des ventes (Sales) de tous les produits pour cette année.

Remarque : La recherche des valeurs de données maximales et minimales est limitée à une valeur de dimension pour chacune des autres dimensions de l'indicateur indiqué.

Pour sélectionner les valeurs de dimensions maximales ou minimales :

1.	Dans la boîte de dialogue Sélecteur, sélectionnez l'outil Haut/Bas qui figure dans la barre d'outils du Sélecteur.

2.	Complétez la boîte de dialogue Select Top/Bottom.

3.	Cliquez sur OK.


Utilisation d'Express
Utilisation d’Express

La documentation Reports fait souvent référence à Express. Express offre un traitement analytique en ligne (OLAP) et propose des fonctions de prévision (des scénarios) et de modélisation financière. Sur la base d’un modèle de données multidimensionnel, Express est optimisé pour l’interrogation et l’analyse des données d’entreprise (services des ventes, de la commercialisation, des finances et de la production) ou des données de ressources humaines.

Vous pouvez créer des états contenant des données qui proviennent des bases de données Express en effectuant l’une des tâches suivantes :

Création d'une interrogation Express

Sélection de données

Rattachement de bases de données

Suppression de bases de données

Si vous n’installez pas les composants d’Express pendant l’installation de Report Builder, vous ne pouvez pas créer d’état avec des données Express. Pour plus d’informations sur l’installation de ces composants, reportez-vous à la rubrique intitulée Initiation à Reports.

Dans la plupart des applications Express, les données sont présentées sous forme de hiérarchies, dans lesquelles les différents niveaux de données sont mis en retrait. Vous pouvez souvent hiérarchiser ces niveaux vers le bas (développer l'arborescence) et vers le haut (réduire l'arborescence). Dans Report Builder, les données sont présentées dans des hiérarchies avec mises en retrait, mais la hiérarchisation n'est pas prise en charge.


Rattachement de bases de données

Pour rendre une base de données Express disponible en tant que source de données pour une interrogation, vous devez l’attacher. Pour extraire des données de plusieurs sources, vous pouvez attacher simultanément plusieurs bases de données.

Important : N'attachez jamais plusieurs bases de données utilisant les mêmes noms d'objet. Les résultats obtenus seraient imprévisibles.

Pour attacher une base de données :

1.	Dans la boîte de dialogue d’interrogation Express, choisissez Attach Database.

2.	Localisez le fichier de base de données à ouvrir.

3.	Choisissez Ouvrir pour attacher le fichier de base de données.

4.	Pour attacher d’autres bases de données, répétez les étapes 1 à 3.


Suppression de bases de données

Lorsque vous n’utilisez plus une base de données Express, vous pouvez la supprimer (la détacher).

Remarque : Vous ne pouvez pas détacher une base de données actuellement utilisée par une interrogation active. Lorsqu’une interrogation est en cours, ou si les résultats d’une interrogation sont affichés dans un état ouvert, vous devez annuler l’interrogation ou supprimer les résultats avant de détacher la base de données.

Pour détacher une base de données :

1.	Affichez la boîte de dialogue d’interrogation Express.

2.	Dans la zone de choix de la base de données, sélectionnez la base de données à détacher.

3.	Choisissez Supprimer une BdD.

4.	Répétez les étapes 2 et 3 pour chaque base de données à détacher.


Création d'une interrogation Express
Création d’une interrogation Express

Pour créer une interrogation de données Express, utilisez l’une des méthodes suivantes :

Assistant Report

Outil d'interrogation Express


Création d'une interrogation Express : assistant Report
Création d’une interrogation Express : assistant Report

Vous pouvez facilement utiliser l’assistant Report pour créer une interrogation avec des données provenant d’une base de données Express et afficher les résultats dans Report Builder.

Pour créer une interrogation Express :

1.	Dans le menu Outils, choisissez Assistant Report.

2.	Sur la page Style, sélectionnez le style d’état de votre choix.

3.	Choisissez Suivant.

4.	Sélectionnez Interrogation Express, puis choisissez Suivant.

5.	Choisissez Connecter pour afficher la boîte de dialogue de connexion et établir une connexion au serveur Express.

6.	Choisissez Interrogation Express pour afficher la boîte de dialogue d’interrogation Express.

7.	Dans la zone Choisir une base de données, sélectionnez une base de données.

Si la base de données de votre choix n’apparaît pas, choisissez Attach Database pour attacher une base de données. (Une fois attachée, la base de données apparaît dans la zone Choisir une base de données.)

8.	Sélectionnez des indicateurs pour l’interrogation. Pour ce faire, cliquez deux fois sur les indicateurs dans la zone Indicateurs disponibles. Vous pouvez également utiliser l’un des boutons suivants :

Remarque : Pour supprimer un indicateur de la zone Indicateurs sélectionnés, cliquez deux fois dessus. Vous pouvez également utiliser l’un des boutons suivants :

9.	Choisissez Sélecteur pour afficher la boîte de dialogue du sélecteur, dans laquelle vous pouvez visualiser le script de sélection en cours et utiliser les outils du sélecteur pour redéfinir ou remplacer la sélection de cette dimension.

Conseil : Pour afficher les valeurs actuelles, choisissez l’outil Liste.

10.	Sélectionnez des valeurs pour chaque dimension.

11.	Lorsque vous avez terminé votre travail dans le sélecteur, choisissez OK.

12.	Lorsque vous avez terminé votre travail dans la boîte de dialogue d’interrogation Express, choisissez OK.


Création d'une interrogation Express : outil d'interrogation Express
Création d’une interrogation Express : outil d’interrogation Express

Vous pouvez facilement utiliser l’outil d’interrogation Express pour créer une interrogation avec des données provenant d’une base de données Express et afficher les résultats dans Report Builder.

Pour créer une interrogation Express :

1.	Connectez-vous à Oracle8.

2.	Dans la vue Modèle de données, cliquez sur [image] [image] dans la palette d’outils.

3.	Cliquez dans la zone principale (zone du canevas) de la fenêtre.

4.	Cliquez deux fois sur la nouvelle interrogation et remplissez les champs de la boîte de dialogue de connexion afin d’établir une connexion au serveur Express.

5.	Choisissez Interrogation Express pour afficher la boîte de dialogue d’interrogation Express.

6.	Dans la zone Choisir une base de données, sélectionnez une base de données.

Si la base de données de votre choix n’apparaît pas, choisissez Attach Database pour attacher une base de données. (Une fois attachée, la base de données apparaît dans la zone Choisir une base de données.)

7.	Sélectionnez des indicateurs pour l’interrogation. Pour ce faire, cliquez deux fois sur les indicateurs dans la zone Indicateurs disponibles. Vous pouvez également utiliser l’un des boutons suivants :

Remarque : Pour supprimer un indicateur de la zone Indicateurs sélectionnés, cliquez deux fois dessus. Vous pouvez également utiliser l’un des boutons suivants :

8.	Choisissez Sélecteur pour afficher la boîte de dialogue du sélecteur, dans laquelle vous pouvez visualiser le script de sélection en cours et utiliser les outils du sélecteur pour redéfinir ou remplacer la sélection de cette dimension.

Conseil : Pour afficher les valeurs actuelles, choisissez l’outil Liste.

9.	Sélectionnez des valeurs pour chaque dimension.

10.	Lorsque vous avez terminé votre travail dans le sélecteur, choisissez OK.

11.	Lorsque vous avez terminé votre travail dans la boîte de dialogue d’interrogation Express, choisissez OK.


Copie d'indicateurs personnalisés

Vous pouvez copier les indicateurs personnalisés affichés dans la zone Custom Measure de la boîte de dialogue du même nom.

Pour copier un indicateur personnalisé :

1.	Dans la boîte de dialogue d'interrogation Express, choisissez Custom Measures.

2.	Dans la boîte de dialogue Custom Measures, sélectionnez la base de données qui contient l'indicateur personnalisé à copier.

3.	Dans la zone Custom Measures, sélectionnez l'indicateur à copier.

4.	Cliquez sur Copy.

5.	Remplissez la boîte de dialogue Custom Measures - Action.

6.	Cliquez sur OK.

7.	Cliquez sur Close.


Création d'indicateur personnalisés
Création d'indicateurs personnalisés

Rubriques connexes

Lorsque vous créez une interrogation, vous pouvez avoir besoin d'utiliser une formule qui n'existe pas dans la base de données. Vous pouvez exploiter les indicateurs existants pour définir des formules répondant à vos besoins. Les formules que vous créez sont appelées indicateurs personnalisés.

Si vous créez un indicateur personnalisé alors que la base de données correspondante est attachée en mode lecture/écriture, votre indicateur personnalisé est disponible pour tous les utilisateurs qui attachent cette base de données. Si vous créez un indicateur personnalisé alors que sa base de données est attachée en lecture seule, vous seul pouvez accéder à cet indicateur.

Pour créer un indicateur personnalisé :

1.	Dans la boîte de dialogue d'interrogation Express, choisissez Custom Measures.

2.	Dans la boîte de dialogue Custom Measures, sélectionnez la base de données à utiliser.

3.	Cliquez sur le bouton New. Le nom de l'action affiché dans la barre de titre est New.

4.	Remplissez la boîte de dialogue Custom Measures - Action.

5.	Cliquez sur OK pour revenir dans la boîte de dialogue Custom Measures.

6.	Cliquez sur Close.


Définition d'expressions pour les indicateurs personnalisés
Définition des expressions pour les indicateurs personnalisés

Lorsque vous créez, copiez ou éditez les indicateurs personnalisés, vous définissez les expressions que les indicateurs personnalisés utilisent pour calculer leurs valeurs. Vous définissez l'expression dans la zone de la boîte de dialogue Custom Measures - Action prévue à cet effet.

Remarque : Actuellement, vous ne pouvez pas utiliser les fonctions d'agrégation, telles que TOTAL ou AVERAGE, dans un indicateur personnalisé. L'utilisation de ces fonctions provoque des résultats inattendus.

La manière la plus simple de définir une expression est de sélectionner des éléments parmi les objets, fonctions et opérateurs fournis dans la zone de choix. Les fonctions d'agrégation n'y figurent pas ; vous pouvez donc utiliser en toute sécurité les fonctions affichées dans cette zone.

Vous pouvez entrer directement une expression dans la zone correspondante, à condition que la valeur entrée corresponde à une expression Express valide.

Pour définir une expression en la sélectionnant dans la zone de choix :

1.	Dans la zone de catégories, sélectionnez une catégorie de fonctions ou d'opérateurs. Si vous ne connaissez pas les fonctions contenues dans les différentes catégories, sélectionnez Functions, puis All.

2.	Dans la zone de choix, sélectionnez une fonction ou un opérateur.

Des informations sur l'entrée sélectionnée apparaissent dans la zone d'information située sous les zones de catégorie et de choix.

Pour plus d'informations sur les fonctions, reportez-vous au manuel Express Reference Manual.

3.	Insérez l'élément de la zone de choix dans la zone d'expression, en utilisant l'une des méthodes suivantes :

Cliquez deux fois sur la sélection.

ou

Cliquez sur la sélection et choisissez Insert.

4.	Dans la zone d'expression, sélectionnez une partie de l'expression déjà insérée et remplacez-la par l'élément voulu. Vous pouvez sélectionner l'argument de votre choix en cliquant deux fois dessus.

Par exemple, une fois que vous avez inséré un prototype de fonction, le premier argument du prototype est sélectionné. Vous pouvez donc le remplacer par un argument réel. Vous insérez les noms de dimension Express comme vous avez inséré la fonction.


Limitation de l'accès aux indicateurs personnalisés

La boîte de dialogue Custom Measures permet aux utilisateurs de créer leurs propres formules, ou indicateurs personnalisés, pour analyser les données. Elle leur permet également d'éditer, de copier ou de supprimer d'autres indicateurs personnalisés.

Vous pouvez définir une option du Sélecteur pour empêcher l'affichage du bouton Custom dans la boîte de dialogue Selector. Vous empêchez ainsi les utilisateurs de créer, d'éditer, de copier ou de supprimer les indicateurs personnalisés du Sélecteur. Les utilisateurs peuvent également choisir l'option Custom Measures dans la boîte de dialogue Express Query.

La configuration choisie est appliquée chaque fois que la boîte de dialogue Sélecteur est affichée depuis l'interrogation.

Pour limiter l'accès à la boîte de dialogue Custom Measure pour une interrogation :

1.	Dans la boîte de dialogue Sélecteur, choisissez Options.

2.	Dans la boîte de dialogue Selector Options, cochez ou désélectionnez la case Allow custom measure functionality :

Pour masquer le bouton Custom, désélectionnez cette case.

ou

Pour afficher le bouton Custom, cochez cette case.

3.	Cliquez sur OK.


Aide d'Express Reports Query

  Utilisation d'Express Reports Query

Rattachement de bases de données

Création d'une interrogation Express

Suppression de bases de données

Utilisation du Sélecteur

Utilisation d'Express

  Référence(s)

Informations relatives à l'Aide d'Express Reports Query


Informations relatives à l'Aide d'Express Reports Query

Conventions

Ce système d'aide utilise un ensemble de conventions typographiques permettant de définir des types d'informations et de conventions de formatage destinées à uniformiser l'apparence du texte. En vous familiarisant avec ces conventions, vous serez en mesure d'utiliser le système d'aide plus efficacement.

Conventions typographiques

Les conventions typographiques suivantes sont utilisées dans ce système d'aide.

Convention	Objectif
texte en gras	Indique une option de menu, un bouton de commande, un nom de champ ou toute autre option.
texte à pas fixe	Indique des noms de dossier, des noms de fichier et des commandes de système d'exploitation. Identifie également les exemples et tout texte à saisir exactement tel qu'il apparaît. Par exemple, si vous êtes invité à entrer show eversion, vous devez saisir tous les caractères tels qu'ils sont affichés.
texte en italique et texte en gras italique	Indique des variables, y compris du texte variable. Le texte variable est utilisé lorsque des boîtes de dialogue ou d'autres éléments d'interface ne sont pas libellés ou portent un nom qui change en fonction du contexte. Le texte variable peut ne pas correspondre exactement à ce que vous voyez à l'écran. L'attribut italique sert aussi à mettre des éléments en évidence et à baliser les titres de documents. Remarque : Lorsque vous imprimez une rubrique d'aide contenant du texte en italique ou en gras italique, les éléments en italique peuvent apparaître sans attribut, selon la configuration de l'impression.
texte en MAJUSCULES	Indique des commandes, des objets et des acronymes Express.
Conventions de formatage

Les rubriques apparaissant dans la fenêtre principale du système d'aide ont été formatées de façon à ce que leur apparence soit optimale dans une fenêtre occupant la moitié de l'écran dans le sens vertical. Vous pouvez néanmoins redimensionner la fenêtre principale à votre convenance.


Utilisation du Sélecteur

Sélection de valeurs de dimension

Remplacement ou redéfinition des sélections

Sélection de données

Barre d'outils du Sélecteur

Utilisation de l'outil Tout

Utilisation de l'outil Attribut

Utilisation de l'outil Exception

Utilisation de l'outil Famille

Utilisation de l'outil Niveau

Utilisation de l'outil Liste

Utilisation de l'outil de mise en correspondance

Utilisation de l'outil Plage

Utilisation de l'outil de tri

Utilisation de l'outil Haut/Bas

Configuration des options du Sélecteur

Personnalisation du Sélecteur pour une interrogation

Affichage de la valeur des dimensions dans le Sélecteur

Affichage du nom des dimensions dans le Sélecteur

Affichage ou masquage des outils du Sélecteur

Utilisation des indicateurs personnalisés

Copie d'indicateurs personnalisés

Création d'indicateurs personnalisés

Définition d'expressions pour les indicateurs personnalisés

Limitation de l'accès aux indicateurs personnalisés

Utilisation des sélections enregistrées

Création de sélections enregistrées

Suppression des sélections enregistrées

Attribution d'un nouveau nom aux sélections enregistrées

Remplacement de sélections enregistrées

Utilisation de sélections enregistrées


Sortie au format pages HTML

 Rubriques connexes

La sortie au format pages HTML permet d'afficher dans le navigateur Web des pages distinctes d'une sortie d'état HTML/HTMLCSS, sans télécharger la totalité de l'état. Depuis la première page de l'état, vous pouvez accéder à toutes les autres pages. Lorsque vous cliquez sur un signet ou un hyperlien dont la destination est située :

•	à l'intérieur de l'état, le cadre contenant la page en cours est mis à jour de façon à correspondre à la page de destination ;

•	en-dehors de l'état, le cadre de base global (y compris le cadre de signet, la page et le cadre de navigation) est de nouveau chargé.

Contrôles de navigation

Pour activer les contrôles de navigation de page, vous pouvez :

•	utiliser la fonctionnalité JavaScript intégrée fournie par Report Builder ;

•	entrer votre propre script JavaScript (ou un autre script) ;

Si vous utilisez votre propre script, incluez-y ces deux variables :

•	&TotalPages (nombre total de pages)

•	&file_name (nom du fichier de destination de la sortie ; par exemple, MonEtat).

Report Builder affecte des valeurs à ces variables au cours de la mise en forme.

La hauteur de l'encadrement des contrôles de navigation de page est codée en dur en 70 points sans barre de défilement. La largeur de cet encadrement est variable. Pour y utiliser des icônes et des images, gardez ces dimensions à l'esprit.

Vous pouvez indiquer le script de contrôle de navigation :

•	via une instruction PL/SQL (SRW.SET_PAGE_NAVIGATION_HTML dans un déclencheur Before Report) ;

•	dans la palette de propriétés Etat, via les propriétés Type Contrôle de navigation de page et Valeur Contrôle de navigation de page.

Noms des fichiers de sortie

En sortie au format pages HTML, chaque page est formatée en tant que document HTML distinct. Si votre fichier HTML s'appelle MonEtat.htm et qu'il ne contient aucun signet, les nouveaux fichiers sont intitulés :

•	MonEtat.htm (pour le cadre de base)

•	MonEtat_1.htm à MonEtat_n.htm (pour les pages)

•	MonEtatj.htm (pour le script de navigation JavaScript)

Si le fichier HTML contient des signets, les nouveaux fichiers sont appelés :

•	MonEtat.htm (pour le cadre de base)

•	MonEtatb.htm (pour le fichier de signet)

•	MonEtat_1.htm à MonEtat_n.htm (pour les pages)

•	MonEtatj.htm (pour le script de navigation JavaScript)

Etendue de la sortie HTML

Pour n'afficher la sortie HTML que sur la première page (page d'en-tête) ou la dernière (page de fin) de votre état, définissez la propriété Avant état ou Après état, ou utilisez la procédure PL/SQL SRW.SET_BEFORE_REPORT_HTML ou SRW.SET_AFTER_REPORT_HTML. Pour appliquer la sortie HTML globale à tout l'état, notamment aux couleurs de fond ou aux images, définissez la propriété Avant page ou la procédure PL/SQL SRW.SET_BEFORE_PAGE_HTML. Le logo HTML généré par Report Builder apparaît uniquement sur la dernière page de l'état.

Activation de la sortie au format pages

Pour activer la sortie au format pages lors du formatage de l'état comme sortie HTML ou HTMLCSS, entrez PAGESTREAM=YES sur la ligne de commande. Vous ne pouvez pas paramétrer cette option via l'interface utilisateur de Report Builder.


Intégration via d'autres outils d'aide à la décision

Outre Oracle Discoverer et Oracle Express, Reports fournit les technologies existantes les plus performantes permettant de répondre à l'ensemble des besoins de l'entreprise en matière d'aide à la décision (du suivi de production et des questions ad hoc à une analyse avancée). Cette solution intégrée permet une grande facilité d'utilisation et des performances jamais égalées, tout en réduisant les coûts de développement et de mise en place.

Vous pouvez transformer instantanément vos feuilles de travail Discoverer en états Web dynamiques et les diffuser dans toute l'entreprise. Pour plus d'informations sur la conversion de feuilles de travail en états, reportez-vous à la documentation Discoverer.

Dans Report Builder, vous pouvez fonder un état sur les indicateurs et les dimensions Express. L'assistant Etat permet de choisir le type d'interrogation à créer (Express ou SQL). La boîte de dialogue Interrogation Express permet de sélectionner la base de données, les indicateurs et les dimensions à utiliser dans un état. Vous pouvez restreindre votre recherche à l'aide d'autres outils Express courants, comme Express Selector. Une fois l'interrogation Express terminée, vous pouvez générer et modifier rapidement la présentation de l'état comme pour tout autre état.


Sortie délimitée

  Restrictions 	  Rubriques connexes

La sortie délimitée permet d'indiquer un séparateur (caractère ou chaîne de caractères) de données pour la sortie de l'état. Cette fonction permet de créer une sortie facile à importer dans des tableurs comme Microsoft Excel.

Vous pouvez indiquer le séparateur de l'une des manières suivantes :

•	sur la ligne de commande, via le paramètre DELIMITER ;

•	dans la boîte de dialogue Sortie délimitée, via l'option Delimiter.

Lorsque vous générez une sortie délimitée, vous pouvez différencier encore plus les cellules à l'aide d'un intercalaire de cellules. Cet intercalaire peut comporter n'importe quelle série de caractères, y compris des virgules et des parenthèses.

Par exemple, si les données de votre sortie d'état comportent un caractère identique à celui du séparateur (comme une virgule), vous pouvez utiliser l'intercalaire de cellules parenthèses pour distinguer les différentes cellules :

(1,000,000),(3,6000),(543),(2,003,500)…

Notes d'utilisation

Lorsque vous générez une sortie délimitée, les données sont affichées selon l'ordre d'apparition des objets dans la vue Modèle de présentation.

•	Si vous placez A au-dessus ou à gauche de B (A et B représentant tout objet standard ou tout objet de champ), Report Builder affiche chaque instance de A avant celle de B dans les lignes de sortie.

 Cliquez ici.

•	Si vous créez un cadre qui contient un objet standard (A) et inclut un cadre itératif comportant un objet de champ (B), chaque instance de A apparaît avec celle de B.

 Cliquez ici.

•	Dans la présentation précédente, si vous ajoutez un cadre supplémentaire qui contient un objet standard (C) et inclut un autre cadre itératif comportant un objet de champ (D), A apparaît à chaque instance de B, et C apparaît à chaque instance de D.

 Cliquez ici.

•	Si vous créez une matrice dans votre état, veillez à aligner les objets conformément à la grille de la vue Modèle de présentation. Si les objets ne sont pas alignés, Report Builder risque d'interpréter l'espace restant comme une ligne ou une colonne supplémentaire, ce qui peut perturber la sortie d'état.

•	Si vous créez un objet standard en dehors de la matrice, chaque instance de cet objet apparaît sur chaque ligne (et non chaque colonne) de la matrice. Remarquez que les objets standard de la matrice ne sont pas répétés avec les objets de champ hors de la matrice.

 Cliquez ici.


Hyperliens graphiques

Vous pouvez associer une valeur graphique d'une sortie HTML ou PDF avec une instance de cadre itératif de votre sortie d'état, d'un autre graphique ou d'un autre état. Dans la sortie d'état, un utilisateur peut cliquer sur une valeur graphique pour la détailler. Il peut également accéder à un autre état associé à cette valeur.

Vous pouvez créer des hyperliens graphiques via la page correspondante de l'assistant Web ou définir la propriété Hyperlien graphique dans la palette de propriétés.


Reports Runtime Java Bean

  Rubriques connexes

Vous pouvez utiliser Reports Runtime Java Bean pour permettre aux utilisateurs d'exécuter et de visualiser un état depuis leur navigateur compatible Java ou depuis tout autre visualiseur de mini-programmes Java. Reports Runtime Java Bean (ou Reports RJB) est semblable à n'importe quel autre composant Java bean ; vous pouvez l'intégrer à l'interface utilisateur (comme un mini-programme ou toute autre application Java) que vous développez, et vous en resservir par la suite.

Pour utiliser Reports RJB, vous devez créer une interface utilisateur exigeant la saisie des paramètres suivants lors de l'exécution :

1	le nom de l'état (y compris l'extension, par exemple, HTML, PDF) ;

2	le nom du serveur d'états sur lequel se trouve l'état en question ;

3	l'ID utilisateur et le mot de passe du serveur d'états ;

4	le type de la destination, le format de la destination et le nom de la destination de l'état ;

5	(pour les connexions HTTP), l'URL du serveur d'états sur lequel se trouve l'état en question.

Si vous ne demandez pas à l'utilisateur de saisir ces paramètres, vous pouvez indiquer des valeurs par défaut dans votre mini-programme ou votre application Java.

Lorsque vous récupérez la sortie de votre état via Reports RJB, vous devez indiquer le programme qui permettra de le consulter, tel qu'Acrobat Reader (pour les fichiers PDF).

Remarques

•	Vous pouvez utiliser Reports RJB pour récupérer des états simples. Notez que vous ne pouvez pas récupérer plusieurs fichiers en même temps (ainsi, Java bean récupère le fichier HTM d'un état Web, mais pas les fichiers GIF correspondants).

•	Pour plus d'informations sur les attributs Reports RJB, recherchez Java bean dans Javadoc, dans ORACLE_HOME/REPORTS60/JAVA.

•	Pour plus d'informations sur les Java beans, reportez-vous à n'importe quel manuel de programmation en langage Java ou accédez à l'adresse suivante : http://java.sun.com.


Sectionnement d'état

  Rubriques connexes

Le sectionnement d'état permet de définir plusieurs présentations pour un même état, chacune étant destinée à un public précis et comportant un format de sortie distinct, ainsi qu'une présentation, une orientation et un format de page différents. Vous pouvez définir jusqu'à trois sections d'état comportant un corps et une marge. Afin de conserver la compatibilité avec les versions précédentes, les sections sont appelées Section d'en-tête, Section principale et Section de fin. Par défaut, l'état est défini dans la section principale. Les autres sections permettent de définir différentes présentations et non de créer différents états. Par exemple, un seul état peut contenir un récapitulatif destiné aux cadres supérieurs dans une section et un rapport détaillé destiné aux différents directeurs dans une autre section.

Utilisez la marge et le corps des sections d'en-tête et de fin pour créer une page d’en-tête ou de fin comme dans les versions précédentes. Les prochaines versions permettront d'ajouter et de supprimer des sections.

Dans le Navigateur d'objet, les sections d'état sont affichées sous le noeud Modèle de présentation en tant que Section d'en-tête, Section principale et Section de fin.


Diffusion d'états

  Rubriques connexes

La diffusion d'un état permet de créer un état capable de générer plusieurs formats de sortie et pouvant être diffusé vers plusieurs destinations en une seule exécution. Vous pouvez créer des diffusions pour la totalité d'un état ou pour des sections distinctes.

Par exemple, en exécutant l'état une seule fois, vous pouvez générer une sortie HTML, envoyer une version PostScript à l'imprimante et envoyer une ou toutes les sections de l'état à une liste de diffusion via courrier électronique. Dans les versions précédentes, vous deviez exécuter l'état pour chaque format de sortie ou chaque destination.

Vous pouvez diffuser un état de l'une des manières suivantes :

•	via la boîte de dialogue Diffusion ;

•	sur la ligne de commande, via le mot-clé DESTINATION, qui indique un fichier .DST.

Remarque : Pour activer la diffusion indiquée, procédez de l'une des manières suivantes :

•	Sélectionnez Fichier [image] Diffusion.

•	Entrez DISTRIBUTE=YES sur la ligne de commande.

Pour vérifier la diffusion d'un état sans le diffuser, produisez une trace de la diffusion de l'état ; elle indique les listes de diffusion utilisées. Ces informations permettent de déterminer la destination des différentes sections.


Tri des dimensions Express
Tri des dimensions

  Rubriques connexes

Dans le modèle de données de l'état Express, l'icône [image] représente la colonne de tri. Pour chaque dimension sélectionnée dans l'interrogation Express, Report Builder insère automatiquement la colonne de tri correspondante dans le modèle de données de l'état. Une colonne de tri contient l'index Express de la valeur de dimension correspondante.

Par exemple, si vous créez une interrogation Express qui extrait les données de ventes mondiales regroupées par mois pour chaque division de produit, l'état Express aura l'apparence suivante :

La dimension Time est triée par mois de l'année et non par ordre alphabétique.

Vous pouvez trier les valeurs de dimensions d'un état Express en utilisant l'outil de tri du Sélecteur. Vous pouvez afficher les colonnes de tri à partir de la vue Modèle de données et du Navigateur d'objet. Les colonnes de tri ne sont pas visibles à partir des assistants Données et Etat, ni à partir de la vue Modèle de présentation ou de la vue Aperçu interactif.


Extensions HTML des paramètres
Extensions HTML de la grille de paramètres

Les extensions HTML de la grille de paramètres permettent d'améliorer la grille de paramètres Runtime avec des balises HTML et du code JavaScript pour les états exécutés via le Web. Pour améliorer la grille de paramètres en vue de la création d'états sur le Web, procédez comme suit :

•	Créez du texte standard avec des balises HTML, ce qui permet d'ajouter à la grille de paramètres des hyperliens ou tout autre texte contenant des balises HTML.

•	Insérez des champs de paramètres avec du code JavaScript, ce qui permet de définir des événements de type « input » ou « select », comme l'affichage d'un message d'erreur lorsqu'un utilisateur final saisit des données non valides dans un champ de la grille de paramètres.

Vous pouvez accéder à l'Editeur de grille de paramètres depuis le Navigateur d'objet ou en sélectionnant Outils [image] Générateur de grille de paramètres.


Sortie XML

Report Builder permet désormais de générer un document XML à partir d'un état. La sortie XML peut servir d'intermédiaire pour l'échange de données avec une application tierce (EDI - Electronic Data Exchange) et pour la publication sur le Web.

Un fichier XML qui contient les données structurées de l'état peut être généré via un processus simple, à partir du fichier .RDF. Vous pouvez indiquer le format de destination XML à partir de la ligne de commande ou sélectionner Fichier [image] Générer dans fichier [image] XML.

Notes d'utilisation

•	Le modèle de données définit la structure de la sortie XML d'un état. La sortie XML ne dépend pas de la présentation visuelle.

•	Vous pouvez modifier la structure de la sortie XML d'un état en éditant les propriétés XML disponibles dans la palette de propriétés des objets modèle de données.

•	Report Builder ne prend pas en charge les informations de présentation (couleur, police, disposition, etc.) dans les sorties XML. Vous pouvez fournir vos propres informations de présentation via XSL, qui peut être indiqué dans le prologue. Pour plus d'informations, reportez-vous aux rubriques Type du prologue XML et Valeur du prologue XML.

•	Depuis la ligne de commande, vous pouvez utiliser l'argument DESFORMAT=XML pour générer une sortie XML. Pour plus d'informations, reportez-vous à la rubrique DESFORMAT.

Pour plus d'informations sur XML, reportez-vous aux rubriques Génération d'une sortie XML et Propriétés XML.


Personnalisation Runtime via XML

Vous pouvez exécuter des définitions d'état élaborées à l'aide de balises XML et les fusionner avec d'autres définitions d'état. Auparavant, un état devait être construit dans Report Builder et enregistré sous forme de fichier .RDF (ou .REP) pour pouvoir être exécuté. Vous pouvez désormais construire une définition d'état à l'aide de balises XML. Cette définition d'état XML peut être exécutée séparément ou être appliquée à un fichier .RDF au moment de l'exécution pour adapter la sortie de l'état à un public précis. Cette fonction permet également d'effectuer des modifications par lot sur les états, via RWCON60. Cela vous évite d'apporter manuellement la même modification plusieurs fois dans Report Builder.

Pour plus d'informations, reportez-vous au manuel Publishing Reports.


Intégration dans Oracle WebDB

Oracle WebDB facilite et sécurise la publication d'états sur le Web. Les administrateurs système utilisent les assistants de WebDB pour contrôler l'accès des utilisateurs aux états. Le contrôle d'accès détermine :

•	les états, les serveurs Reports Server et les imprimantes accessibles ;

•	le moment où ces états, serveurs et imprimantes sont disponibles pour le traitement des demandes ;

•	les personnes qui ont accès à ces états, serveurs et imprimantes.

Lorsque vous établissez un contrôle d'accès pour un état, vous stockez des informations sur cet état (comme sa méthode d'exécution) sous forme de procédure en package. Ainsi, vous n'avez plus besoin de composer vous-même la demande d'état. Vous créez simplement un lien à un site WebDB, sous forme de composant WebDB pointant sur la procédure en package de l'état. Les utilisateurs cliquent sur le lien pour exécuter l'état. Le serveur Reports Server utilise WebDB pour déterminer si les utilisateurs à l'origine de la demande ont accès à toutes les ressources requises. Si tel est le cas, l'état leur est fourni.

WebDB permet d'exécuter des états à la demande, ou de programmer l'exécution automatique d'états et de transmettre l'état résultant au site WebDB de destination.

Pour plus d'informations, reportez-vous au manuel Publishing Reports.


Groupement de serveurs Reports Server

Avec l'augmentation des exigences concernant la diffusion des informations, le groupement de serveurs est une solution simple et rentable qui permet d'améliorer les performances et d'équilibrer les charges de travail. Vous pouvez augmenter les capacités de traitement de Reports Server au fur et à mesure du développement de votre entreprise en branchant de nouveaux serveurs d'applications.

Il vous suffit de désigner un serveur Reports Server comme maître, puis de configurer d'autres serveurs Reports Server comme esclaves. Le serveur maître reçoit les demandes et les redirige vers les serveurs esclaves. Les moteurs esclaves traitent ces demandes, puis les renvoient au maître, qui livre la sortie.

Pour plus d'informations, reportez-vous au manuel Publishing Reports.


Base de données Reports Server
File d'attente de la base de données Reports Server

Vous pouvez définir votre base de données de manière à prendre des clichés de l'activité de la file d'attente Reports Server lors de l'exécution de travaux. Pour vous connecter à la base de données, définissez le paramètre REPOSITORYCONN dans le fichier de configuration de Reports Server. Pour créer la table d'activité de la file d'attente dans la base de données, exécutez un script SQL.

Lorsque vous démarrez Reports Server, une connexion est établie avec la base de données. Par défaut, Reports Server appelle une API pour supprimer les informations de file d'attente lorsque le serveur redémarre et pour mettre à jour les informations de file d'attente dans la table de base de données.

Pour plus d'informations, reportez-vous au manuel Publishing Reports.


A propos de la correspondance de polices

Les polices (c'est-à-dire la combinaison de types, de styles, de tailles, de caractères et autres) ne sont généralement pas les mêmes sur toutes les machines. Certaines machines n'ont tout simplement pas toutes les polices ou utilisent un système d'exploitation différent. Lorsque vous créez un état qui doit s'exécuter sur une autre machine pouvant avoir, ou non, les mêmes polices, vous avez donc deux possibilités :

•	Utiliser une police que vous savez exister sur l'interface graphique cible ou qui correspond bien à la police par défaut de l'interface graphique cible.

•	Etablir la correspondance (ou l'alias) de la police avec une autre police existant sur la machine sur laquelle l'état sera exécuté. Vous établissez la correspondance des polices dans le fichier uifont.ali.


uifont.ali

  Exemples

La syntaxe de chaque entrée du fichier uifont.ali est la suivante :

police_source = police_destination

Pour chaque police, vous pouvez indiquer les attributs suivants :

<police>.<taille>.<style>.<épaisseur>.<largeur>.<jeu_caractères>

Valeurs

<police>	Doit être le nom (chaîne/identificateur) d'une police de caractères.

<taille>	Doit être une taille explicite, en points.

<style>	Peut être soit une valeur numérique, soit un identificateur ou une chaîne prédéfinie.  Par exemple, simple et 0 sont des valeurs valides qui font référence au même style.

<épaisseur>	Peut être soit une valeur numérique, soit un identificateur ou une chaîne prédéfinie.  Par exemple, ultraMince et 1 sont des valeurs valides qui font référence à la même épaisseur.

<largeur>	Peut être soit une valeur numérique, soit un identificateur ou une chaîne prédéfinie. Par exemple, ultraDense et 1 sont des valeurs valides qui font référence à la même largeur.

<jeu_caractères>	Peut être soit une valeur numérique, soit un identificateur ou une chaîne prédéfinie. Par exemple, US7ASCII et 1 sont des valeurs valides qui font référence au même jeu de caractères.

Notes d'utilisation

•	Vous pouvez combiner les styles en utilisant le signe plus (+). Par exemple :

Arial..Italique+Surimpression = Helvetica.12.Italique.Gras

•	Pour la correspondance des polices, la différence entre majuscules et minuscules n'existe pas pour les chaînes. Les polices de caractère doivent parfois être indiquées en majuscules ou en minuscules lors de la consultation, selon la plate-forme et la surface. Vous devez donc choisir soigneusement les noms utilisés du côté droit. Cependant, lors de l'établissement de la correspondance, il n'y aura pas de différence entre majuscules et minuscules.

•	La barre oblique inversée (\) est utilisée comme caractère de suite. Les commentaires doivent être inclus de la manière suivante :

/* commentaire */

# commentaire

; commentaire

•	Si vous développez un état en utilisant un jeu de caractères (par exemple WE8ISO8859P1), puis utilisez un autre jeu de caractères (EEC8EUROPA3) lors de son exécution, assurez-vous que votre fichier d'alias de police (uifont.ali) comporte les entrées nécessaires pour établir la correspondance des polices entre les jeux de caractères. Par exemple :

"Courier New".....EEC8EUROPA3 = "CourierNew".....WE8ISO8859P1

Sinon, Report Builder utilise une correspondance par défaut, qui peut ne pas correspondre aux besoins de votre état.

•	Pour vous assurer que votre fichier uifont.ali est correct, utilisez le programme fontchk. qui recherche les erreurs éventuelles dans votre fichier. Pour analyser votre fichier de correspondance de polices, entrez :

fontchk nomfichier

•	Report Builder recherche le fichier de correspondance de polices à l'emplacement indiqué par la variable d'environnement TK2_FONTALIAS. Si cette variable n'est pas indiquée, Report Builder recherche le fichier à l'emplacement par défaut de votre système d'exploitation.


Styles valides

Style	Valeur numérique

Simple	0

Italique	1

Oblique	2

Souligné	4

Relief	8

Ombre	16

Inversé	32

Surimpression	64

Clignotant	128


Epaisseurs valides

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


Largeurs valides

Largeur	Valeur numérique

UltraDense	1

ExtraDense	2

Dense	3

SemiDense	4

Normal	5

SemiLarge	6

Large	7

ExtraLarge	8

UltraLarge	9


Fichier de correspondance de polices - Exemple

  Rubriques connexes 	  Tous les exemples

 [ Global ]  # Entrez ici les correspondances pour toutes les surfaces.

# Correspondance MS Windows
Arial             = helvetica
"Courier New"     = courier
"Times New Roman" = times
Modern            = helvetica
"MS Sans Serif"   = helvetica
"MS Serif"        = times
"Small Fonts"     = helvetica

# Correspondance Macintosh
"New Century Schlbk" = "new century schoolbook"
"New York"           = "times"

[ Printer ] # Entrez ici les correspondances pour toutes les imprimantes.

[ Printer:PostScript1 ]  /* Entrez ici les correspondances des imprimantes PostScript
                            de niveau 1. */

# Correspondance MS Windows
Roman             = palatino
Script            = "itc zapf chancery"
FixedSys          = courier
System            = helvetica

# Correspondance Macintosh
"Avant Garde"     = "itc avant garde gothic"

# Correspondance affichage Motif
fixed             = courier
clean             = times
lucidatypewriter  = courier
lucidabright      = times

# Exemple de correspondances 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 ]  /* Entrez ici les correspondances des imprimantes PostScript
                            de niveau 2. */
# Correspondance MS Windows
Roman             = palatino
Script            = "itc zapf chancery"
FixedSys          = courier
System            = helvetica

# Correspondance Macintosh
"Avant Garde"     = "itc avant garde gothic"

# Correspondance affichage Motif
fixed             = courier
clean             = times
lucidatypewriter  = courier
lucidabright      = times

# Exemple de correspondances 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 ] # Entrez ici les correspondances pour les surfaces d'affichage.

[ Display:Motif ] # Entrez ici les correspondances pour les affichages Motif.

# Correspondance MS Windows
Courier           = courier
Roman             = lucida
Script            = lucidabright
FixedSys          = fixed
System            = lucida

# Correspondance Macintosh
"Avant Garde"     = helvetica
"Bookman"         = times

[ Display:CM ]     # Entrez ici les correspondances pour tous les affichages CM.
# Ces correspondances sont propres à DEC et peuvent devoir être adaptées.
*..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.


REP-0001 : Fichier de messages de Report Builder introuvable. Vérifier votre installation.

Cause :	Le fichier de messages d'erreur n'a pas pu être ouvert, ou une erreur interne s'est produite pendant l'ouverture du fichier.
Action :	Tentez de réinstaller Report Builder ou contactez le Support technique Oracle. Pour plus d'informations, reportez-vous à Recours au Support technique Oracle.


REP-0002 : Extraction de chaîne du fichier de messages impossible.

Cause :	Report Builder n'a pas pu extraire la chaîne ou le message d'erreur nécessaire.
Action :	Contactez le Support technique Oracle. Pour plus d'informations, reportez-vous à Recours au Support technique Oracle.


REP-0003 : Avertissement ! Ouverture du fichier de préférences globales impossible.

Cause :	Le fichier de préférences globales n'a pas pu être ouvert. Comme ce message n'est fourni qu'à titre d'avertissement, le produit continue à s'exécuter. Causes possibles :
	Cas 1 :	Le fichier n'a pas pu être trouvé sous le nom indiqué à l'adresse indiquée.
	Cas 2 :	Vous n'aviez pas les privilèges nécessaires pour ouvrir le fichier.
	Cas 3 :	Une erreur système a empêché l'ouverture du fichier.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier prefs.ora est stocké dans le répertoire approprié. Pour plus d'informations, reportez-vous aux instructions d'installation ou contactez votre administrateur de bases de données.
	Cas 2 :	Assurez-vous que vous avez les privilèges nécessaires pour accéder au fichier. Dans le cas contraire, modifiez vos privilèges en conséquence.
	Cas 3 :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0004 : Avertissement ! Ouverture du fichier de préférences utilisateur impossible.

Cause :	Votre fichier de préférences locales (personnalisées) n'a pas pu être ouvert. Comme ce message n'est fourni qu'à titre d'avertissement, le produit continue à s'exécuter. Causes possibles :
	Cas 1 :	Le fichier n'a pas pu être trouvé sous le nom indiqué à l'adresse indiquée.
	Cas 2 :	Vous n'aviez pas les privilèges nécessaires pour ouvrir le fichier.
	Cas 3 :	Une erreur système a empêché l'ouverture du fichier.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier prefs.ora se trouve dans votre répertoire "racine" (si ce concept existe dans votre système). S'il ne s'y trouve pas, modifiez en conséquence le répertoire et/ou le nom de fichier.
	Cas 2 :	Assurez-vous que vous avez les privilèges nécessaires pour accéder au fichier. Dans le cas contraire, modifiez vos privilèges en conséquence.
	Cas 3 :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0005 : Avertissement ! Erreur de syntaxe à la ligne <numéro de ligne> du fichier de préférences globales.

Cause :	La ligne dont le numéro figure dans le message comporte une erreur d'indication d'une ou de plusieurs des préférences du fichier de préférences globales. Le problème provient probablement du fait que le fichier a été édité et qu'une ou plusieurs des préférences indiquées sont incorrectes. Report Builder ne tient pas compte des préférences incorrectes.
Action :	Editez le fichier de préférences globales et assurez-vous que toutes les préférences sont correctement indiquées. (Cette opération peut également être effectuée par votre administrateur de bases de données.) Si elles ne le sont pas, procédez aux mises à jour nécessaires.


REP-0006 : Avertissement ! Erreur de syntaxe à la ligne <numéro de ligne> du fichier de préférences utilisateur.

Cause :	La ligne dont le numéro figure dans le message comporte une erreur d'indication d'une ou de plusieurs des préférences du fichier de préférences utilisateur. Le problème provient probablement du fait que le fichier a été édité et qu'une ou plusieurs des préférences indiquées sont incorrectes. Report Builder ne tient pas compte des préférences incorrectes.
Action :	Editez le fichier de préférences globales et assurez-vous que toutes les préférences sont correctement indiquées. Si elles ne le sont pas, procédez aux mises à jour nécessaires.


REP-0007 : Impossible d'écrire dans le fichier de préférences utilisateur.
REP-0007 : Impossible d'écrire dans le fichier de préférences utilisateur

Cause :	Vous avez tenté d'enregistrer des préférences dans un fichier de préférences utilisateur que vous n'avez pas pu ouvrir. Causes possibles :
	Cas 1 :	Vous n'aviez pas les privilèges nécessaires pour écrire dans le fichier.
	Cas 2 :	Une erreur système a empêché l'écriture dans le fichier.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que vous avez les privilèges nécessaires pour écrire dans le fichier. Si vous ne les avez pas, modifiez vos privilèges en conséquence.
	Cas 2 :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0008 : Erreur mémoire imprévue durant l'initialisation des préférences.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0058 : Transfert de données vers serveur d'états éloigné non supporté.

Cause :	Vous avez demandé la transmission d'un groupe d'enregistrements à un état exécuté sur un serveur éloigné.
Action :	Si vous transmettez un groupe d'enregistrements, vous ne pouvez pas indiquer de serveur d'états..


REP-0059 : Ressources associées au sous-composant '<nom du composant>' introuvables. Rechercher le fichier ressource.
REP-0059 : Ressources associées au sous-composant '<nom du composant>'. Rechercher le fichier de ressources.

Cause :	L'un des sous-composants de Report Builder n'a pas pu localiser son fichier de ressources. Causes possibles
	Cas 1 :	Le fichier de ressources n'existe pas.
	Cas 2 :	Le fichier de ressources n'est pas au bon endroit.
	Cas 3 :	L'environnement n'est pas correctement configuré.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Vérifier l'existence des fichiers de ressources.
	Cas 2 :	Assurez-vous que les fichiers de ressources sont dans le répertoire approprié.
	Cas 3 :	Assurez-vous que l'environnement est correctement défini. Sous Unix, assurez-vous que la variable d'environnement appropriée est bien définie et, sous MS Windows, vérifiez le fichier oracle.ini.


REP-0060 : Exécution simultanée d'un travail et d'un autre état impossible.

Cause :	Vous tentez d'exécuter un état associé par l'exécutable Form Runtime et qui exige que les données soient transmises à partir de cet outil, mais un ou plusieurs autres états s'exécutent ou sont en file d'attente. Les états nécessitant la transmission de données doivent être exécutés immédiatement.
Action :	Attendez que tous les autres états figurant dans la file d'attente du serveur d'états soient exécutés, puis tentez à nouveau l'opération.


REP-0061 : Erreur interne - rxmobfree : compte de référence égal à zéro.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0062 : Erreur interne - rxmobnew : tailles non concordantes.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0063 : Erreur interne - rxmobnew : gestionnaires de mémoire non concordants.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0064 : Erreur interne - rxmobnew : types non concordants.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0065 : Erreur du système de mémoire virtuelle.
REP-0065 : Erreur du système de mémoire virtuelle

Cause :	Report Builder a détecté une erreur mémoire.
Action :	Notez le code correspondant à l'erreur et contactez le Support technique Oracle. Pour plus d'informations, reportez-vous à Recours au Support technique Oracle.


REP-0066 : Erreur d'exécution de l'utilitaire CA.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0067 : Valeur erronée pour le mot-clé STYPE. Options valides : DATABASE, REXFILE, RDFFILE, PLLDB, PLLFILE ou PLDFILE.

Cause :	Dans RWCON60, vous avez fourni un argument pour le mot-clé STYPE qui n'était pas valide.
Action :	Vérifiez la syntaxe du mot-clé. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant une valeur valide pour le ou les mots-clés.


REP-0068 : Valeur erronée pour le mot-clé STYPE. Options valides : DATABASE ou REXFILE.

Cause :	Dans RWCON60, vous avez fourni un argument pour le mot-clé STYPE qui n'était pas valide.
Action :	Vérifiez la syntaxe du mot-clé. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant une valeur valide pour le ou les mots-clés.


REP-0069: Erreur interne

Cause :	Code d'erreur interne de Report Builder.
Action :	Demandez l'intervention du support technique Oracle.


REP-0071 : Impossible d'affecter contexte SSL.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0072 : Impossible d'initialiser l'interface NNIT.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0073 : Tentative d'exécution d'un produit inconnu.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0074 : Echec de l'exécution d'un autre produit à l'aide de SSL.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0075 : Erreur lors de l'exécution du composant appelé.

Cause :	Report Builder a détecté une erreur après avoir appelé Forms Runtime ou Graphics Runtime. Le message d'erreur affiche l'erreur détectée par l'application appelée.
Action :	Corrigez l'erreur détectée par l'application appelée et tentez à nouveau d'exécuter l'opération


REP-0076 : Echec interne d'intégration de produit.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0077 : Colonne de l'interrogation '<nom de l'interrogation>' trop longue pour le transfert de données.

Cause :	Vous avez tenté de transmettre des données à une colonne de taille excessive (colonne de type LONG, par exemple). Cette opération n'est pas prise en charge.
Action :	Supprimez la colonne de la définition de l'état et la définition du document appelant.


REP-0078 : Intégration processus unique appelé avec batch=no.

Cause :	Vous avez utilisé un exécutable dans lequel Report Builder est lié à un autre produit et tenté d'appeler Report Builder en indiquant batch=no. Cette fonction n'est pas prise en charge.
Action :	Utilisez un exécutable permettant d'intégrer plusieurs processus. Sinon, Report Builder ne peut être appelé qu'avec batch=yes.


REP-0079 : Valeur erronée pour le mot-clé OVERWRITE. Options valides : YES, NO ou PROMPT.

Cause :	Dans RWCON60, vous avez fourni un argument pour le mot-clé OVERWRITE qui n'était pas valide.
Action :	Ré-entrez la commande en indiquant, pour le mot-clé OVERWRITE, la valeur YES, NO ou PROMPT.


REP-0080 : Entrer YES, NO ou CANCEL.

Cause :	Dans RWCON60, vous avez entré OVERWRITE=PROMPT dans la ligne de commande, puis une valeur autre que YES ou NO en réponse à l'invite du système.
Action :	Indiquez la valeur YES, NO ou CANCEL en réponse à l'invite.


REP-0081 : Erreur lors de l'opération d'E/S de fichier.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0082 : Erreur lors de l'exécution de l'utilitaire SCA.

Cause :	Causes possibles :
	Cas 1 :	Votre fichier d'initialisation n'est pas le fichier en cours.
	Cas 2 :	Condition anormale.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que votre fichier d'initialisation est le fichier en cours.
	Cas 2 :	Pour toute information, reportez-vous à Conditions anormales.


REP-0083 : Valeur erronée pour mot-clé DUNIT. Options valides : CENTIMETER, CHARACTER, INCH ou POINT.
REP-0083 : Valeur erronée pour le mot-clé DUNIT. Options valides : CENTIMETER, CHARACTER, INCH ou POINT.

Cause :	Dans RWCON60, vous avez fourni une valeur erronée pour le mot-clé DUNIT.
Action :	Vérifiez la syntaxe du mot-clé. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant une valeur valide pour le ou les mots-clés.


REP-0084 : Valeur erronée pour mot-clé PAGESIZE. La syntaxe doit être <largeur>x<hauteur>.
REP-0084 : Valeur erronée pour le mot-clé PAGESIZE. La syntaxe doit être <largeur>x<hauteur>.

Cause :	Dans RWCON60, vous avez fourni une valeur erronée pour le mot-clé PAGESIZE.
Action :	Vérifiez la syntaxe du mot-clé. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant, pour le mot-clé, une valeur valide et la syntaxe appropriée.


REP-0085 : Valeur erronée pour le mot-clé FORMSIZE. La syntaxe doit être <largeur>x<hauteur>.

Cause :	Dans RWCON60, vous avez fourni une valeur erronée pour le mot-clé FORMSIZE.
Action :	Vérifiez la syntaxe du mot-clé. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant, pour le mot-clé, une valeur valide et la syntaxe appropriée.


REP-0086 : La valeur de DUNIT doit être différente de l'unité de mesure de l'état source.

Cause :	Dans RWCON60, vous avez fourni, pour le mot-clé DUNIT, une valeur exprimée dans la même unité de mesure que l'état que vous voulez convertir.
Action :	Vérifiez la syntaxe du mot-clé. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant, pour le mot-clé, une valeur valide et la syntaxe appropriée.


REP-0087 : Valeur erronée pour mot-clé DESTYPE. Options valides : SCREEN, FILE, PRINTER, MAIL, INTEROFFICE, SYSOUT ou PREVIEW.

Cause :	Dans RWRUN60, vous avez fourni une valeur erronée pour le mot-clé DESTYPE.
Action :	Vérifiez la syntaxe du mot-clé. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant une valeur valide pour le ou les mots-clés.


REP-0088 : Valeur erronée pour mot-clé ONSUCCESS. Options valides : COMMIT, ROLLBACK ou NOACTION.

Cause :	Vous avez fourni une valeur erronée pour ONSUCCESS.
Action :	Indiquez COMMIT, ROLLBACK ou NOACTION soit dans l'onglet Paramètres d'exécution de la boîte de dialogue Options outils, soit dans la ligne de commande. (Pour vérifier la syntaxe de la ligne de commande, reportez-vous à Exécutables


REP-0089 : Valeur erronée pour mot-clé ONFAILURE. Options valides : COMMIT, ROLLBACK ou NOACTION.

Cause :	Vous avez fourni une valeur erronée pour ONFAILURE.
Action :	Indiquez COMMIT, ROLLBACK ou NOACTION soit dans l'onglet Paramètres d'exécution de la boîte de dialogue Options outils, soit dans la ligne de commande. (Pour vérifier la syntaxe de la ligne de commande, reportez-vous à Exécutables.)


REP-0090 : Valeur erronée pour mot-clé ACCESS. Options valides : FILE et DATABASE.

Cause :	Pour RWBLD60, vous avez fourni une valeur erronée pour ACCESS.
Action :	Indiquez FILE ou DATABASE. (Pour vérifier la syntaxe de la ligne de commande, reportez-vous à Exécutables.)


REP-0091 : Valeur erronée pour le param. '<nom du paramètre>'.

Cause :	Vous avez fourni une valeur erronée pour le paramètre nommé. Par exemple, dans la chaîne de commandes RWRUN60, vous avez fourni une valeur de type Char pour un paramètre dont le type de données est Number.
Action :	Tentez à nouveau d'exécuter l'opération en indiquant, pour le paramètre, une valeur valide.


REP-0092 : Avertissement ! Argument LANGUAGE version 1.1 non supporté. Utiliser la variable d'environnement ORACLE National Language.

Cause :	Pour RWBLD60 ou RWRUN60, vous avez fourni le mot-clé LANGUAGE dans la chaîne de la ligne de commande.
Action :	Supprimez de la chaîne de commande la chaîne d'arguments LANGUAGE et définissez la variable d'environnement ORACLE National Language NLS_LANG à la valeur appropriée. Pour plus d'informations, reportez-vous à Support de langue nationale (NLS).


REP-0094 : FORMSIZE doit être 80x24 si DUNIT est caractère.

Cause :	Lorsque vous avez utilisé RWCON60 avec DUNIT=Character, vous avez indiqué une taille de grille de paramètres différente de 80x24.
Action :	La taille de la grille de paramètres en mode caractère doit être 80x24. Indiquez un FORMSIZE de 80x24 si DUNIT=Character, ou n'indiquez pas de FORMSIZE.


REP-0095 : Valeur erronée pour mot-clé ORIENTATION. Options valides : DEFAULT, LANDSCAPE ou PORTRAIT.

Cause :	Vous avez fourni une valeur erronée pour ORIENTATION.
Action :	Indiquez DEFAULT, LANDSCAPE ou PORTRAIT soit dans l'onglet Paramètres d'exécution de la boîte de dialogue Options outils, soit dans la ligne de commande. (Pour vérifier la syntaxe de la ligne de commande, reportez-vous à Exécutables.)


REP-0096 : Valeur erronée pour mot-clé MODE. Options valides : DEFAULT, BITMAP ou CHARACTER.

Cause :	Vous avez fourni une valeur erronée pour MODE.
Action :	Indiquez DEFAULT, BITMAP ou CHARACTER soit dans l'onglet Paramètres d'exécution de la boîte de dialogue Options outils, soit dans la ligne de commande. (Pour vérifier la syntaxe de la ligne de commande, reportez-vous à Exécutables.)


REP-0097 : Valeur erronée pour mot-clé TRACEMODE. Options valides : TRACE_APPEND ou TRACE_REPLACE.

Cause :	Pour TRACEMODE, vous avez indiqué une valeur erronée ou encore vous n'avez indiqué aucune valeur, ou bien vous avez indiqué dans la ligne de commande des mots-clés dans un ordre incorrect, et sans les nommer.
Action :	Indiquez Ajouter ou Remplacer pour Mode Trace dans la boîte de dialogue Paramètres de trace, ou TRACE_APPEND ou TRACE_REPLACE dans la ligne de commande, ou encore vérifiez la syntaxe de votre commande. (Pour vérifier la syntaxe de la ligne de commande, reportez-vous à Exécutables.)


REP-0098 : Etat non exécuté : annulé par utilisateur dans la grille de paramètres.

Cause :	Votre état n'a pas été exécuté parce que vous avez sélectionné Annuler au lieu de Exécuter état dans la Grille de paramètres d'exécution.
Action :	Aucune.


REP-0099 : Abandon de l'état sur demande utilisateur.

Cause :	Vous avez arrêté un état en cours d'exécution.
Action :	Aucune.


REP-0100 : Impossible de placer le pointeur de fichier dans le fichier '<nom du fichier>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0101 : Impossible de lire le fichier '<nom du fichier>'.

Cause :	Report Builder a tenté de lire le fichier indiqué dans le message. Le fichier a pu être ouvert, mais n'a pas pu être lu.
Action :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0102 : Impossible d'écrire dans le fichier '<nom du fichier>'.

Cause :	Report Builder a tenté, sans succès, d'écrire dans le fichier indiqué dans le message. Causes possibles :
	Cas 1 :	Vous n'aviez pas les privilèges nécessaires pour écrire dans le fichier.
	Cas 2 :	Le système n'a pas suffisamment de place pour le fichier.
	Cas 3 :	Une erreur système a empêché l'ouverture du fichier.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que vous avez les privilèges nécessaires pour écrire dans le fichier. Si vous ne les avez pas, modifiez vos privilèges en conséquence.
	Cas 2 :	Faites de la place en supprimant les fichiers dont vous n'avez plus besoin ou en augmentant votre mémoire.
	Cas 3 :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0103 : Impossible de fermer le fichier '<nom du fichier>'.

Cause :	Report Builder a tenté, sans succès, de fermer le fichier indiqué. La cause la plus probable est qu'une erreur système a empêché la fermeture du fichier.
Action :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0104 : Impossible de supprimer le fichier '<nom du fichier>'.

Cause :	Report Builder a tenté, sans succès, de supprimer le fichier indiqué. La cause la plus probable est qu'une erreur système a empêché la suppression du fichier.
Action :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0105 : Impossible de verrouiller le fichier '<nom du fichier>' en mode exclusif.

Cause :	Report Builder a tenté, sans succès, de verrouiller le fichier indiqué. La cause la plus probable est qu'une erreur système a empêché le verrouillage du fichier.
Action :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0106 : Impossible de verrouiller le fichier '<nom du fichier>' en mode partagé.

Cause :	Report Builder a tenté, sans succès, de verrouiller le fichier indiqué. La cause la plus probable est qu'une erreur système a empêché le verrouillage du fichier.
Action :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0107 : Tentative d'ouverture d'un fichier à l'aide d'un nom erroné - '<nom du fichier>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0108 : Fichier '<nom du fichier>' introuvable.

Cause :	Report Builder a tenté d'accéder au fichier indiqué, mais n'a pas pu le trouver.
Action :	Assurez-vous que vous avez indiqué un nom de fichier correct. Indiquez un répertoire avant le nom de fichier, ou modifiez la variable d'environnement REPORTS30_PATH de façon à inclure le répertoire dans lequel se trouve le fichier.


REP-0109 : Fichiers ouverts trop nombreux.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0110 : Impossible d'ouvrir le fichier '<nom du fichier>'.

Cause :	Report Builder a tenté, sans succès, d'ouvrir le fichier indiqué. Causes possibles :
	Cas 1 :	Le fichier n'a pas pu être trouvé sous le nom indiqué à l'adresse indiquée.
	Cas 2 :	Vous n'aviez pas les privilèges nécessaires pour ouvrir le fichier.
	Cas 3 :	Une erreur système a empêché l'ouverture du fichier.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier est stocké dans le répertoire indiqué sous le nom indiqué. Dans le cas contraire, modifiez en conséquence le répertoire et/ou le nom de fichier.
	Cas 2 :	Assurez-vous que vous avez les privilèges nécessaires pour ouvrir le fichier. Dans le cas contraire, modifiez vos privilèges en conséquence.
	Cas 3 :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0111 : Répertoire '<chemin d'accès au répertoire>' protégé.

Cause :	Vous avez demandé à Report Builder de lire ou d'écrire dans un répertoire pour lequel vous n'avez pas d'autorisation de lecture ou d'écriture.
Action :	Modifiez les autorisations d'accès au répertoire afin de pouvoir lire ou écrire dans celui-ci.


REP-0112 : Le fichier '<nom du fichier>' est protégé en écriture.

Cause :	Vous avez demandé à Report Builder d'écrire dans un fichier protégé en écriture, c'est-à-dire dans lequel vous n'avez pas l'autorisation d'écrire.
Action :	Modifiez les autorisations en conséquence.


REP-0113 : Le fichier '<nom du fichier>' est protégé en lecture.

Cause :	Vous avez demandé à Report Builder de lire dans un fichier protégé en lecture, c'est-à-dire dans lequel vous n'avez pas l'autorisation de lire.
Action :	Modifiez les autorisations en conséquence.


REP-0114 : Le fichier '<nom du fichier>' n'existe plus.

Cause :	Vous avez demandé à Report Builder d'accéder à un fichier qui n'existe plus.
Action :	Supprimez l'appel au fichier, recréez le fichier ou indiquez un fichier différent.


REP-0115 : Impossible de lire le répertoire '<chemin d'accès au répertoire>'.

Cause :	Il est très probable que vous avez demandé à Report Builder de lire ou d'écrire dans un répertoire qui n'existe pas.
Action :	Assurez-vous que le répertoire que vous avez indiqué existe.


REP-0116 : Impossible de se connecter au répertoire '<chemin d'accès au répertoire>'.

Cause :	Report Builder n'a pas pu, pour une raison quelconque, accéder au répertoire indiqué.
Action :	Consultez votre administrateur système.


REP-0117 : Echec de la sortie vers le système d'exploitation hôte.

Cause :	Vous avez tenté de sortir du programme et de rendre le contrôle au système d'exploitation hôte.
Action :	Aucune.


REP-0118 : Impossible de créer un fichier temporaire.

Cause :	Report Builder a tenté, sans succès, de créer un fichier temporaire. Causes possibles :
	Cas 1 :	La variable d'environnement qui détermine le répertoire dans lequel doivent être créés les fichiers temporaires indique un répertoire erroné.
	Cas 2 :	Il n'y a pas suffisamment d'espace disponible sur le disque pour créer le fichier temporaire.
	Cas 3 :	Il existe déjà un fichier temporaire qui ne peut pas être modifié.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Définissez un répertoire valide dans votre variable d'environnement de fichiers temporaires.
	Cas 2 :	Libérez de l'espace sur votre disque.
	Cas 3 :	Si possible, supprimez le fichier temporaire existant.


REP-0119 : Fichier source '<nom du fichier>' associé à l'objet standard '<nom de l'objet standard>' introuvable.

Cause :	Report Builder a tenté, sans succès, de trouver le fichier source indiqué pour un objet standard externe. Causes possibles :
	Cas 1 :	Le fichier n'a pas pu être trouvé sous le nom indiqué à l'adresse indiquée.
	Cas 2 :	Vous n'aviez pas les privilèges nécessaires pour ouvrir le fichier.
	Cas 3 :	Une erreur système a empêché l'ouverture du fichier.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier est stocké dans le répertoire indiqué sous le nom indiqué. Dans le cas contraire, modifiez en conséquence le répertoire et/ou le nom de fichier.
	Cas 2 :	Assurez-vous que vous avez les privilèges nécessaires pour ouvrir le fichier. Dans le cas contraire, modifiez vos privilèges en conséquence.
	Cas 3 :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0120 : Document <nom du fichier> associé au graphique <nom du graphique> introuvable.

Cause :	Report Builder n'a pas pu trouver le document graphique. Causes possibles :
	Cas 1 :	Le document graphique ne se trouve pas sous le nom indiqué à l'adresse indiquée.
	Cas 2 :	Vous n'aviez pas les privilèges nécessaires pour ouvrir le document graphique.
	Cas 3 :	Une erreur système a rendu impossible l'ouverture du document graphique.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le document graphique est stocké dans le répertoire indiqué sous le nom indiqué. Dans le cas contraire, modifiez en conséquence le répertoire et/ou le nom de fichier.
	Cas 2 :	Assurez-vous que vous avez les privilèges nécessaires pour ouvrir le document graphique. Dans le cas contraire, modifiez vos privilèges en conséquence.
	Cas 3 :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0124 : Ecriture dans fichier temporaire impossible.

Cause :	Report Builder a tenté, sans succès, d'écrire dans le fichier temporaire. La cause pourrait être le manque d'espace disponible sur le disque.
Action :	Libérez de l'espace sur votre disque.


REP-0125 : Erreur interne : Chargement impossible du jeu de caractères NLS.

Cause :	ORA_NLS n'est pas défini ou le répertoire sur lequel il pointe n'existe pas.
Action :	Définissez ORA_NLS de manière à ce qu'il pointe sur le répertoire NLS contenant les fichiers de jeux de caractères.


REP-0150 : Trop d'arguments.

Cause :	Vous avez entré, pour la commande, un nombre d'arguments supérieur au nombre maximum autorisé.
Action :	Vérifiez la syntaxe de la commande. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez correctement la commande


REP-0151 : Spécification d'argument dupliqué pour mot-clé <mot-clé>.

Cause :	Vous avez entré plusieurs arguments pour le mot-clé indiqué. Causes possibles :
	Cas 1 :	Vous avez entré un argument de position pour le mot-clé, puis le mot-clé lui-même avec un autre argument.
	Cas 2 :	Vous avez entré deux fois le même mot-clé (par exemple, KEYWORD1=YES et KEYWORD1=NO).
Action :	Vérifiez la syntaxe de la commande. Pour plus d'informations, reportez-vous à Exécutables. Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Ré-entrez la commande en indiquant uniquement l'argument de position ou uniquement l'argument du mot-clé.
	Cas 2 :	Ré-entrez la commande en n'indiquant qu'une fois le mot-clé.


REP-0152 : Argument de position spécifié après mot-clé.

Cause :	Dans la ligne de commande, vous avez entré un argument sans son mot-clé, après avoir entré un argument avec son mot-clé. Lorsque vous avez utilisé un mot-clé dans la ligne de commande, vous devez obligatoirement fournir des mots-clés pour les arguments suivants.
Action :	Ré-entrez la commande en vous assurant qu'aucun argument de position (c'est-à-dire un argument dont le mot-clé est implicite) n'est indiqué après les arguments avec mot-clé.


REP-0153 : Valeurs multiples non autorisées pour mot-clé <mot-clé>.

Cause :	Dans votre commande, vous avez entré, pour l'argument du mot-clé, un nombre de valeurs numériques supérieur au maximum autorisé, par exemple, KEYWORD=(A, B), où KEYWORD n'accepte qu'une valeur.
Action :	Vérifiez la syntaxe de la commande. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande sans la ou les valeurs supplémentaires.


REP-0154 : Impossible d'ouvrir fichier de commandes.

Cause :	Vous avez entré une commande qui faisait référence au fichier de commandes indiqué, mais le système n'a pas pu ouvrir le fichier. Causes possibles :
	Cas 1 :	Le fichier n'a pas pu être trouvé sous le nom indiqué à l'adresse indiquée.
	Cas 2 :	Vous n'aviez pas les privilèges nécessaires pour ouvrir le fichier.
	Cas 3 :	Une erreur système a empêché l'ouverture du fichier.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier est stocké dans le répertoire indiqué sous le nom indiqué. S'il ne l'est pas, changez de répertoire et/ou de nom de fichier, ou faites passer le fichier dans le répertoire indiqué.
	Cas 2 :	Assurez-vous que vous avez les privilèges nécessaires pour accéder au fichier. Dans le cas contraire, modifiez vos privilèges en conséquence.
	Cas 3 :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-0155 : Valeur erronée pour mot-clé <mot-clé>.

Cause :	La valeur que vous avez entrée pour le mot-clé indiqué n'est pas valide.
Action :	Vérifiez la syntaxe du mot-clé. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en fournissant la valeur appropriée pour le ou les mots-clés.


REP-0156 : Valeur erronée pour mot-clé DESTYPE. Options valides : SCREEN, FILE, PRINTER, MAIL, INTEROFFICE ou SYSOUT.
REP-0156 : Valeur erronée pour mot-clé DESTYPE. Options valides : SCREEN, FILE, PRINTER, MAIL, NTEROFFICE ou SYSOUT.

Cause :	Dans RWRUN60, vous avez fourni un argument pour le paramètre DESTYPE qui n'était pas valide.
Action :	Vérifiez la syntaxe du mot-clé. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en fournissant la valeur appropriée pour le ou les mots-clés.


REP-0157 : La valeur pour <mot-clé> doit être YES ou NO.

Cause :	Vous avez entré, pour le mot-clé indiqué, une valeur autre que YES ou NO, alors que le mot-clé n'accepte que YES ou NO.
Action :	Ré-entrez la commande en utilisant soit YES soit NO pour le mot-clé indiqué.


REP-0158 : Mot-clé ligne de commande inconnu '<mot-clé>'.

Cause :	Vous avez entré la chaîne référencée sous la forme d'un mot-clé, alors que ce mot-clé n'existe pas.
Action :	Vérifiez la syntaxe de la commande. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande un utilisant les mots-clés appropriés à la tâche que vous voulez exécuter.


REP-0159 : Erreur de syntaxe sur la ligne de commande.

Cause :	La chaîne que vous avez entrée dans la ligne de commande n'a pas pu être analysée. La cause la plus probable de cette erreur est que vous avez entré des guillemets ou des parenthèses de début sans guillemets ou parenthèses de fin.
Action :	Vérifiez la syntaxe de la commande. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant la syntaxe appropriée.


REP-0160 : Erreur de syntaxe dans fichier de commandes.

Cause :	Un élément que vous avez entré dans votre fichier de commandes n'a pas pu être analysé. La cause la plus probable de cette erreur est que vous avez entré des guillemets ou des parenthèses de début sans guillemets ou parenthèses de fin.
Action :	Vérifiez la syntaxe de la ou des commandes. Pour plus d'informations, reportez-vous à Exécutables. Editez le fichier et modifiez les commandes en conséquence.


REP-0161 : Pas d'arguments de ligne de commande spécifié.

Cause :	Vous avez appelé RWCON60 sans indiquer d'arguments de ligne de commande.
Action :	Indiquez les arguments de ligne de commande appropriés (par exemple, SOURCE, DEST, etc.) pour RWCON60. Pour plus d'informations, reportez-vous à Exécutables.


REP-0162 : Valeur non valide pour mot-clé SHOWWINDOW. Options valides : DEFAULT, WIZARD et PREVIEWER.

Cause :	Vous avez fourni une valeur erronée pour le mot-clé SHOWWINDOW.
Action :	Vérifiez la syntaxe de la commande. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant la syntaxe appropriée.


REP-0163 : Valeur non valide pour mot-clé DESTYPE. Options valides : FILE, PRINTER, MAIL ou CACHE.

Cause :	Vous avez fourni, pour le paramètre DESTYPE, un argument non valide pour le serveur d'états.
Action :	Vérifiez la syntaxe de la commande. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant la syntaxe appropriée.


REP-0164 : Valeur non valide pour mot-clé PARAMFORM. Options valides : YES, NO ou HTML<action>.

Cause :	Vous avez appelé Report Runtime (seul ou comme moteur de serveur d'états) avec une valeur erronée pour le paramètre PARAMFORM.
Action :	Vérifiez la syntaxe de la commande. Pour plus d'informations, reportez-vous à Exécutables. Ré-entrez la commande en utilisant la syntaxe appropriée.


REP-0165 : La valeur requise pour le mot-clé SITENAME est manquante. Indiquez un nom de site WEBDB.

Cause :	La valeur du mot-clé SITENAME est introuvable. Cette valeur est requise afin de programmer un état.
Action :	Indiquez un nom de site WEBDB pour le mot-clé SITENAME.


REP-0171 : Extraction de sortie du serveur éloigné impossible

Cause :	Une erreur s'est produite pendant l'extraction de la sortie du serveur distant.
Action :	Il est possible que vous ayez indiqué un fichier local auquel vous n'avez pas accès ou que le serveur soit défini pour interdire l'extraction des sorties.


REP-0172 : Aucune valeur donnée pour le mot-clé SERVER.

Cause :	Vous n'avez pas fourni d'argument valide pour le mot-clé obligatoire SERVER.
Action :	Fournissez un argument valide pour le mot-clé SERVER et ré-exécutez la commande.


REP-0173 : Valeur non valide pour mot-clé SHOWJOBS. Options valides : PAST, CURRENT ou FUTURE.

Cause :	Dans Reports Queue Viewer, un argument de la ligne de commande pour le mot-clé SHOWJOBS n'est pas valide.
Action :	Ré-entrez la commande en indiquant la valeur PAST, CURRENT ou FUTURE pour le mot-clé SHOWJOBS.


REP-0174 : Une erreur interne s'est produite au cours de l'affichage d'informations sur la file d'attente du serveur d'états.

Cause :	Le serveur d'états n'a pas retourné à Queue Viewer d'informations valides sur sa file d'attente. Causes possibles :
	Cas 1 :	La connexion au serveur d'états a été brutalement interrompue.
	Cas 2 :	Le serveur d'états est instable ou a été arrêté.
Action :	Assurez-vous que le serveur d'états auquel vous êtes connecté fonctionne. Contactez l'administrateur du serveur d'états et tentez à nouveau d'exécuter la commande après avoir vérifié que le serveur d'états fonctionne. Si le problème persiste, il s'agit d'une condition anormale. Pour toute information, reportez-vous à Conditions anormales.


REP-0175 : Une erreur interne s'est produite au cours de l'affichage d'informations sur les propriétés du serveur d'états.

Cause :	Le serveur d'états n'a pas renvoyé à Queue Viewer d'informations valides sur ses propriétés. Causes possibles :
	Cas 1 :	La connexion au serveur d'états a été brutalement interrompue.
	Cas 2 :	Le serveur d'états est instable ou a été arrêté.
Action :	Assurez-vous que le serveur d'états auquel vous êtes connecté fonctionne. Contactez l'administrateur du serveur d'états et tentez à nouveau d'exécuter la commande après avoir vérifié que le serveur d'états fonctionne. Si le problème persiste, il s'agit d'une condition anormale. Pour toute information, reportez-vous à Conditions anormales.


REP-0176 : Le serveur '<serveur>' est en cours d'arrêt.

Cause :	L'arrêt en cours du serveur d'états indiqué empêche la soumission d'un état.
Action :	Soumettez l'état à un autre serveur d'états ou attendez que le serveur fonctionne à nouveau.


REP-0177 : Erreur au cours de l'exécution sur serveur éloigné.

Cause :	La ligne de commande indiquée n'a pas pu être exécutée sur le serveur distant.
Action :	Vérifiez la ligne de commande.


REP-0178 : Connexion impossible au serveur d'états 'serveur'.
REP-0178 : Connexion impossible au serveur d'états '<serveur>'.

Cause :	Impossible de se connecter au serveur d'états indiqué.
Action :	Vérifiez le réseau et l'état du serveur d'états en question.


REP-0179 : Interruption intempestive de l'exécution de l'état.

Cause :	Le moteur du serveur d'états est tombé en panne.
Action :	Contactez votre administrateur système.


REP-0180 : Etat annulé à partir du serveur d'états.

Cause :	Vous avez arrêté l'état en cours d'exécution ou vous l'avez supprimé de la file d'attente avant qu'il ne démarre.
Action :	Aucune.


REP-0181 : Erreur de lecture/écriture du fichier de configuration du serveur d'états.

Cause :	Le fichier de configuration n'a pas pu être ouvert, ou son contenu est incompréhensible.
Action :	Vérifiez le fichier de configuration et ses droits d'accès. Relancez le serveur d'états.


REP-0182 : Erreur de syntaxe sur la ligne de commande du serveur d'états.

Cause :	La chaîne que vous avez entrée dans la ligne de commande n'a pas pu être analysée. La cause la plus probable de cette erreur est que vous avez entré des guillemets ou des parenthèses de début sans guillemets ou parenthèses de fin.
Action :	Vérifiez la syntaxe de la commande. Ré-entrez la commande en utilisant la syntaxe appropriée.


REP-0183 : Vous devez entrer TNSNAME pour démarrer le serveur d'états.

Cause :	Vous avez tenté de démarrer le serveur d'états sans indiquer le TNSNAME que le serveur doit écouter.
Action :	Entrez le TNSNAME comme argument de ligne de commande.


REP-0184 : MAXCONNECTS indiqué hors plage.

Cause :	La valeur MAXCONNECTS que vous avez indiquée n'est pas comprise dans les limites admises pour cette plate-forme, c'est-à-dire entre 2 et 4096. Sur certaines plates-formes, cette limite est même plus faible.
Action :	Indiquez une valeur appropriée.


REP-0185 : Arguments de chargement incorrects indiqués au cours du démarrage du serveur d'états.

Cause :	Vous avez indiqué des valeurs incompatibles pour MAXCONNECTS, MINLOAD, MAXLOAD et INITLOAD.
Action :	Assurez-vous que 0 <= MINLOAD <= INITLOAD <= MAXLOAD < MAXCONNECTS.


REP-0186 : Le démon n'a pas réussi à écouter le port.

Cause :	Il est possible qu'un autre démon en cours d'exécution écoute déjà le port.
Action :	Aucune. Comme vous avez déjà un démon en cours, vous pouvez soumettre l'état que vous voulez exécuter.


REP-0187 : Le démon n'a pas réussi à lancer le moteur.

Cause :	Le démon n'a pas pu lancer l'exécutable du moteur et communiquer avec lui. Il s'agit probablement d'un problème d'installation.
Action :	Vérifiez l'installation.


REP-0188 : Le serveur d'états n'exécute que les travaux en traitement par lots.

Cause :	Vous avez soumis au serveur d'états un travail pour lequel vous avez indiqué batch=no, destype=screen, destype=preview ou destype=sysout.
Action :	Ces paramètres ne sont pas admis. Modifiez la ligne de commande en conséquence.


REP-0189 : Ecriture impossible dans la mémoire cache de Reports Server.

Cause :	Le serveur d'états n'a pas pu écrire dans sa mémoire cache.
Action :	Assurez-vous que le répertoire de la mémoire cache est indiqué dans le fichier de configuration et que les opérations d'écriture sont possibles.


REP-0190 : Impossible d'exécuter sur écran en arrière-plan.

Cause :	Vous avez demandé l'exécution de l'état en arrière-plan, mais vous avez également indiqué le paramètre Screen pour DESTYPE. Vous ne pouvez pas exécuter un état en arrière-plan alors que sa sortie est envoyée à l'écran.
Action :	Si vous voulez que la sortie soit envoyée à l'écran, vous devez l'exécuter au premier plan. Pour que l'état s'exécute en arrière-plan, indiquez un DESTYPE différent.


REP-0194 : Impossible d'exécuter un état caractères en mode Bitmap avec cet exécutable.

Cause :	Vous essayez d'utiliser l'exécutable en mode caractère pour exécuter un état en mode caractère avec MODE défini à BITMAP, ce qui est interdit.
Action :	Changez la valeur du mot-clé MODE en fonction du mode de l'exécutable ou exécutez l'état en utilisant un exécutable en mode Bitmap.


REP-0195 : Impossible d'exécuter l'état en mode Bitmap à l'écran avec cet exécutable.

Cause :	Vous essayez d'utiliser l'exécutable en mode caractère pour exécuter un état en mode Bitmap à l'écran, ce qui est interdit.
Action :	Exécutez l'état en utilisant BATCH=YES ou utilisez un exécutable en mode Bitmap.


REP-0196 : Impossible d'exécuter l'état en arrière-plan.

Cause :	Vous avez indiqué BACKGROUND = YES dans l'un des cas suivants, qui sont tous interdits :
	Cas 1 :	Vous exécutez l'état à partir de Designer.
	Cas 2 :	Vous avez défini BATCH = YES.
	Cas 3 :	Vous exécutez l'état en utilisant la procédure en package srw.run_report.
	Cas 4 :	La plate-forme sur laquelle vous exécutez l'état n'accepte pas la génération dynamique d'un autre processus.
Action :	Assurez-vous que BACKGROUND = NO lorsque l'une des conditions ci-dessus est remplie.


REP-0197 : BATCH=YES ou BACKGROUND=YES obligatoires sur la ligne de commande lors de l'exécution d'un état en mode Bitmap.

Cause :	Vous avez tenté d'exécuter un état en mode Bitmap en utilisant l'exécutable en mode caractère au premier plan ou au cours d'une session interactive, ce qui n'est pas autorisé.
Action :	Si vous voulez exécuter un état en mode Bitmap en utilisant l'exécutable en mode caractère, vous devez choisir soit BATCH=YES soit BACKGROUND=YES (contrairement à BATCH=YES, ce paramètre vous permet d'accéder à la grille de paramètres d'exécution).


REP-0200 : Impossible d'affecter suffisamment de mémoire.

Cause :	Report Builder ne peut pas obtenir du système suffisamment de mémoire pour achever la tâche en cours.
Action :	Libérez si possible de la mémoire ou demandez l'intervention de votre administrateur système


REP-0201 : Taille de bloc requise doit être négative ou égale à zéro.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0202 : Tentative de libération d'un pointeur non renseigné.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0203 : Pointeur non renseigné considéré comme descripteur.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0204 : Le descripteur ne pointe pas dans un bloc mp.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0205 : Trop nombreux verrous simultanés sur un seul objet.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0206 : Pointeur de mémoire cache non renseigné passé dans sous-programme de mémoire virtuelle.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0207 : Taille du bloc requis supérieure à espace mémoire virtuelle disponible.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0208 : Aucun identificateur de fonction attribué à rmaloc.
REP-0208 : Aucun identificateur de fonction attribué à rmaloc

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0209 : Aucun identificateur de structure attribué à rmaloc.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0210 : Opération interdite demandée sur descripteur verrouillé.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0211 : Tentative d'utilisation d'un descripteur après sa libération.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0212 : Aucune constante spécifiée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0213 : Echec de la tentative de verrouillage du descripteur.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0214 : Impossible d'affecter une mémoire tampon virtuelle de <nombre> Ko. Veuillez recommencer avec une plus petite taille.

Cause :	Report Builder a tenté d'attribuer une mémoire tampon virtuelle dont la taille est égale ou inférieure à la valeur indiquée (par vous ou par défaut) pour le mot-clé BUFFERS.
Action :	Indiquez, pour BUFFERS, une taille plus petite (soit dans l'onglet Paramètres d'exécution de la boîte de dialogue Outils options, soit dans la ligne de commande) ou libérez davantage de mémoire. (Pour vérifier la syntaxe de la ligne de commande, reportez-vous à Exécutables.)


REP-0215 : Erreur lors du verrouillage, de la déréférence ou de la libération d'un descripteur mémoire.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0230 : Erreur lors du démarrage d'une unité d'exécution (thread).

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0231 : Erreur lors de l'inscription du message de l'unité d'exécution (thread).

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0232 : Erreur lors de la lecture du message de l'unité d'exécution (thread).

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0235 : Valeur TNSNAME de Security Server non fournie dans le fichier de configuration

Cause :	La valeur TNSNAME de Security Server doit être indiquée dans le fichier de configuration de Reports Server en mode de sécurité.
Action :	Attribuez la valeur TNSNAME de Security Server au paramètre SECURITYTNSNAME du fichier de configuration de Reports Server.


REP-0236 : Connexion impossible au serveur Security

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0237 : Authentification du serveur Security réussie

Cause :	L'authentification a été effectuée avec succès.
Action :	Aucune.


REP-0238 : Echec d'authentification du serveur Security

Cause :	Votre ID utilisateur système ou votre mot de passe système n'est pas valide, ou vous ne disposez pas des privilèges nécessaires pour exécuter l'état.
Action :	Vérifiez si votre ID utilisateur système ou votre mot de passe système est correct, ou contactez l'administrateur système pour qu'il vous octroie les privilèges nécessaires.


REP-0239 : Echec d'authentification du serveur Security : nom utilisateur non valide

Cause :	Votre ID utilisateur système est incorrect.
Action :	Vérifiez si votre ID utilisateur système est correct, ou contactez l'administrateur système à cet effet.


REP-0240 : Echec d'authentification du serveur Security : mot de passe non valide

Cause :	Le mot de passe de votre ID utilisateur système est incorrect.
Action :	Vérifiez si le mot de passe de votre ID utilisateur système est correct ou contactez l'administrateur système à cet effet.


REP-0241 : Echec d'authentification du serveur Security : aucune autorisation sur le serveur Reports

Cause :	Votre ID utilisateur système ne possède pas les droits d'accès nécessaires sur Reports Server.
Action :	Contactez l'administrateur système pour les droits d'accès de votre ID utilisateur système sur Reports Server.


REP-0242 : Echec d'authentification du serveur Security : aucune autorisation sur l'imprimante

Cause :	Votre ID utilisateur système ne possède pas de droits d'accès sur l'imprimante.
Action :	Contactez l'administrateur système pour les droits d'accès de votre ID utilisateur système sur l'imprimante.


REP-0243 : Echec d'authentification du serveur Security : aucune autorisation sur le module

Cause :	Votre ID utilisateur système ne possède pas de droits d'accès sur le module.
Action :	Contactez l'administrateur système pour les droits d'accès de votre ID utilisateur système sur le module.


REP-0244 : Echec d'authentification du serveur Security : aucune autorisation pour ce type d'accès

Cause :	Votre ID utilisateur système ne dispose pas de privilèges sur ce type d'accès.
Action :	Contactez l'administrateur système pour les privilèges de votre ID utilisateur système sur ce type d'accès.


REP-0245 : Echec d'authentification du serveur Security : aucune autorisation pour ce type de sortie.
REP-0245 : Echec d'authentification du serveur Security : aucune autorisation pour ce type de sortie

Cause :	Votre ID utilisateur système ne dispose pas de privilèges sur ce type de sortie.
Action :	Contactez l'administrateur système pour les privilèges de votre ID utilisateur système sur ce type de sortie.


REP-0246 : Echec d'authentification du serveur Security : aucune autorisation pour l'heure donnée

Cause :	Votre ID utilisateur système ne dispose pas des privilèges nécessaires pour l'heure indiquée.
Action :	Contactez l'administrateur système pour les privilèges de votre ID utilisateur système pour l'heure indiquée.


REP-0247 : Echec d'authentification du serveur Security : aucune autorisation pour la date donnée

Cause :	Votre ID utilisateur système ne dispose pas des privilèges nécessaires pour la date indiquée.
Action :	Contactez l'administrateur système pour les privilèges de votre ID utilisateur système pour la date indiquée.


REP-0250 : Dépassement de table de symboles.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0251 : L'identificateur ne correspond à aucun symbole défini.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0252 : Avertissement ! Le chemin indiqué par la variable d'environnement '<nom de la variable d'environnement>' est trop long : il ne sera pas pris en compte.

Cause :	Le chemin indiqué par la variable d'environnement est trop long.
Action :	Raccourcissez le chemin indiqué.


REP-0253 : Avertissement ! Longueur totale des chemins de recherche trop longue : troncation probable.

Cause :	La longueur totale des chemins de recherche dans l'environnement des chemins est excessive. Elle ne peut pas être supérieure à 255 caractères.
Action :	Raccourcissez un ou plusieurs chemins d'accès dans l'environnement des chemins d'accès.


REP-0300 : Une erreur ORACLE s'est produite.

Cause :	Report Builder a détecté une erreur ORACLE.
Action :	Faites défiler le message d'erreur pour savoir où l'erreur s'est produite et remédiez-y si possible. Sinon, contactez votre administrateur de bases de données.


REP-0301 : L'instruction SELECT ne peut contenir de clause 'INTO'.

Cause :	Vous avez entré dans une instruction SELECT une clause INTO qui n'est pas autorisée dans Report Builder.
Action :	Supprimez la clause INTO.


REP-0302 : Paramètre '<nom du paramètre>' introuvable dans l'état.

Cause :	Vous avez fait référence à un paramètre qui n'est pas défini dans l'état. La cause la plus probable de cette erreur est que vous avez supprimé un paramètre sans supprimer toutes les références à ce paramètre.
Action :	Supprimez toutes les références au paramètre supprimé.


REP-0303 : L'instruction entrée n'est pas une instruction SELECT.

Cause :	Dans le champ Instruction SELECT, vous n'avez pas entré une instruction SELECT. Causes possibles :
	Cas 1 :	Vous avez entré, dans le champ Instruction SELECT, une information autre qu'une instruction SELECT.
	Cas 2 :	Vous avez fait référence à une interrogation externe qui ne contenait pas d'instruction SELECT.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Entrez une instruction SELECT valide.
	Cas 2 :	Modifiez l'interrogation externe ou faites référence à une autre interrogation externe.


REP-0304 : La mention '&' de l'instruction SELECT n'était pas suivie d'un paramètre lexical correct.

Cause :	L'instruction SELECT contient une esperluette (&) seule. Causes possibles :
	Cas 1 :	Vous aviez l'intention de faire une référence lexicale, mais vous avez omis le nom de la colonne ou du paramètre ou encore vous avez entré un espace entre l'esperluette et le nom de la colonne ou du paramètre.
	Cas 2 :	Lorsque vous avez entré l'instruction SELECT, vous avez entré une esperluette par inadvertance.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le nom de la colonne ou du paramètre suit immédiatement l'esperluette (c'est-à-dire sans aucun espace).
	Cas 2 :	Supprimez l'esperluette.


REP-0305 : '<référence lexicale>' ne correspond pas à une valeur de caractère et ne peut donc être utilisée comme paramètre lexical.

Cause :	Vous avez entré dans votre instruction SELECT une référence lexicale erronée. Vous ne pouvez entrer que des références lexicales pour des paramètres ou des colonnes contenant des données de type caractère. Causes possibles :
	Cas 1 :	Vous avez fait référence à une colonne ou à un paramètre erronés.
	Cas 2 :	Vous vouliez que la référence soit une référence de liaison, et non une référence lexicale.
	Cas 3 :	Vous avez créé le paramètre ou la colonne de référence avec des données qui n'étaient pas de type caractère.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Changez le nom qui suit l'esperluette (&) afin qu'il fasse référence à un paramètre ou à une colonne comportant des données de type caractère.
	Cas 2 :	Remplacez l'esperluette (&) par un signe deux-points (:) lorsque vous faites référence au paramètre ou à la colonne.
	Cas 3 :	Indiquez pour le paramètre ou la colonne, des données de type caractère, le cas échéant.


REP-0306 : '<nom>' ne correspond pas à un nom de paramètre correct.

Cause :	Lorsque vous avez fait référence à un paramètre, vous avez tenté de créer un paramètre ayant un nom erroné. Lorsque vous utilisez une référence de liaison, le système crée automatiquement une définition de paramètre en utilisant le nom indiqué dans le paramètre de liaison. Dans ce cas, Report Builder n'a pas pu créer le paramètre, car le nom que vous aviez fourni n'était pas valide
Action :	Vérifiez les conventions d'appellation des objets de modèle de données et les règles de noms de paramètre. Pour plus d'informations sur les conventions d'appellation, reportez-vous à Conventions d'appellation. Renommez le paramètre et changez le nom figurant dans la référence de liaison.


REP-0307 : L'instruction SELECT ne peut contenir de clause 'FOR UPDATE'.

Cause :	Vous avez entré dans l'instruction SELECT une clause FOR UPDATE qui n'est pas autorisée dans Report Builder.
Action :	Supprimez la clause FOR UPDATE.


REP-0308 : Erreur interne - Type de colonne inconnu.

Cause :	Causes possibles :
	Cas 1 :	Vous avez tenté d'afficher la valeur d'une colonne en utilisant SRW.MESSAGE, mais le type de données de la colonne (par exemple, LONG, LONG RAW, ROWID) n'est pas pris en charge pour cette opération.
	Cas 2 :	Vous avez tenté de transmettre la valeur d'une colonne à l'exécutable runtime d'application Forms ou de graphique sous la forme d'un paramètre, mais le type de données de la colonne (par exemple, LONG, LONG RAW, ROWID) n'est pas pris en charge pour cette opération.
Action :	Vous ne pouvez pas afficher ou transmettre la valeur de cette colonne.


REP-0309 : Connexion à la base de donnée indiquée impossible après trois tentatives : accès refusé.
REP-0309 : Connexion à la base de données indiquée impossible après trois tentatives : accès refusé.

Cause :	Un élément de la chaîne de connexion que vous avez entrée est erroné. Après trois échecs, Report Builder affiche une boîte de dialogue comportant ce message. Votre seule possibilité est de l'accepter. Report Builder vous fait alors revenir au système d'exploitation.
Action :	Acceptez la boîte de dialogue. Si nécessaire, demandez à votre administrateur de bases de données de confirmer vos informations de connexion. Revenez à Report Builder et tentez à nouveau de vous connecter à ORACLE. Si le problème persiste, vous devrez peut-être demander à votre administrateur de bases de données de créer pour vous une nouvelle connexion à ORACLE.


REP-0310 : Erreur lors du traitement des variables de lien dans l'interrogation.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0311 : Erreur interne - Mémoire segmentée utilisée pour le paramètre lexical.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0312 : Erreur interne - Erreur de prise en charge de la mémoire segmentée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0313 : Erreur interne - L'extraction d'enregistrements de données risque de provoquer un dépassement de la mémoire.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0314 : Nom de colonne dépasse les 256 car. permis : description impossible. Utiliser l'alias de colonne pour '<nom de la colonne>...'.

Cause :	L'une de vos instructions SQL SELECT contient une expression de plus de 256 caractères, mais sans alias.
Action :	Editez l'instruction SELECT et attribuez un alias à l'expression.


REP-0315 : Chaque instruction Select doit avoir le même nombre de col. dans une interrogation composée.

Cause :	Vous avez entré une interrogation, avec un opérateur UNION, INTERSECT ou MINUS, dans laquelle les instructions SELECT n'ont pas le même nombre de colonnes sélectionnées.
Action :	Modifiez les instructions SELECT afin qu'elles aient le même nombre de colonnes sélectionnées.


REP-0316 : Les colonnes d'une interrogation composée doivent être de type concordant.

Cause :	Vous avez entré une interrogation, avec un opérateur UNION, INTERSECT ou MINUS, dans laquelle les colonnes correspondantes sont de type différent -- par exemple, CHAR pour la colonne 1 de la première instruction SELECT et NUMBER pour la colonne 1 de la seconde instruction SELECT.
Action :	Modifiez les instructions SELECT afin que toutes les colonnes correspondantes aient le même type de données.


REP-0320 : Connexion à la base de données impossible.

Cause :	Une tentative de connexion à la base de données a échoué.
Action :	Vérifiez à nouveau l'ID utilisateur et le mot de passe, et faites une nouvelle tentative.


REP-0321 : Erreur interne - Echec de description d'interrogation.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0322 : Erreur interne - Impossible de réinsérer les lignes extraites.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0330 : Erreur interne - Echec des paramètres de localisation GET_REF.

Cause :	Un appel à CDE_MM.GET_REF, dans une interrogation, ne comporte pas de liste de paramètres.
Action :	Ajoutez la liste de paramètres à l'appel, dans l'instruction SELECT de votre interrogation.


REP-0331 : La fonction GET_REF PL/SQL nécessite 3 paramètres.

Cause :	La liste de paramètres d'un appel à CDE_MM.GET_REF, dans une interrogation, n'était pas complète.
Action :	Ajoutez le paramètre nécessaire à l'appel, dans l'instruction SELECT de votre interrogation.


REP-0332 : Le dernier paramètre de la fonction GET_REF PL/SQL doit être de type ROWID.

Cause :	Vous n'avez pas fourni de paramètre de type ROWID comme dernier paramètre d'une fonction GET_REF.
Action :	Vérifiez votre liste de paramètres et assurez-vous que le dernier est de type ROWID


REP-0340 : Vérification impossible du mot de passe de rôle. Etat non ouvert.

Cause :	Vous n'avez pas entré le bon mot de passe de rôle.
Action :	Confirmez que vous avez le bon mot de passe de rôle. Essayez d'ouvrir à nouveau votre état et entrez le bon mot de passe de rôle.


REP-0341 : Définition impossible des rôles indiqués dans l'état. Etat non ouvert.

Cause :	Le rôle indiqué dans l'état ne peut être défini à l'ouverture de l'état.
Action :	Confirmez que vous avez accès au rôle et que le mot de passe de rôle est correct. Essayez d'ouvrir à nouveau votre état et entrez le bon mot de passe de rôle.


REP-00342 : Avertissement ! Définition impossible des rôles indiqués dans la ligne de commande.
REP-0342 : Avertissement ! Définition impossible des rôles indiqués dans la ligne de commande.

Cause :	Le rôle indiqué dans la ligne de commande ne peut pas être défini.
Action :	Confirmez que vous avez accès au rôle et que le mot de passe de rôle est correct.


REP-0343 : Avertissement ! Définition impossible des rôles par défaut de l'utilisateur en cours.

Cause :	Report Builder ne peut pas définir les rôles par défaut de l'utilisateur actuel auquel des mots de passe ont été affectés.
Action :	N'utilisez pas de rôles par défaut avec les mots de passe.


REP-344 : Mot de passe du rôle incorrect. Le mot de passe de confirmation doit correspondre à celui du rôle.
REP-0344 : Mot de passe du rôle incorrect. Le mot de passe de confirmation doit correspondre à celui du rôle.

Cause :	Le mot de passe saisi dans le champ Confirmer mot de passe est différent de celui que contient le champ Mot de passe de rôle.
Action :	Ressaisissez le mot de passe dans le champ Confirmer mot de passe en veillant à ce qu'il corresponde exactement à celui entré dans le champ Mot de passe de rôle.


REP-345 : Le champ Rôle ne peut pas être vide tandis que le champ Mot de passe ne l'est pas.
REP-0345 : Le champ Rôle ne peut pas être vide tandis que le champ Mot de passe ne l'est pas.

Cause :	Vous avez indiqué le mot de passe associé à un rôle, et non ce dernier.
Action :	Indiquez un rôle, puis précisez le mot de passe, ou laissez tous les champs en blanc si vous ne souhaitez pas associer de rôle à cet état.


REP-0346 : Un nom de rôle ne peut dépasser <nombre> caractères, sous peine d'être tronqué.

Cause :	Vous avez indiqué un nom de rôle dépassant la longueur maximale autorisée. Il sera tronqué.
Action :	Entrez un nom de rôle plus court.


REP-0347 : Le mot de passe associé au rôle ne doit pas dépasser <nombre> caractères, sous peine d'être tronqué.

Cause :	Vous avez indiqué un mot de passe de rôle dépassant la longueur maximale autorisée. Il sera tronqué.
Action :	Entrez un mot de passe de rôle plus court.


REP-0348 : Mot de passe associé au rôle incorrect

Cause :	Vous avez saisi un mot de passe de rôle incorrect.
Action :	Entrez un mot de passe de rôle correct.


REP-0450 : <Erreur PL/SQL>

Si vous modifiez un objet associé à du code PL/SQL, tel qu'une colonne de formule, de marque de réservation ou de paramètre, cette erreur peut se produire. Les modifications apportées à un objet de Report Builder doivent également être associées à du code PL/SQL.

Cause :	Report Builder a détecté cette erreur pendant l'exécution d'un état.
Action :	Editez et recompilez le PL/SQL dans l'état pour éviter cette erreur.
Cause :	La taille d'un type de données n'a pas été déclarée.
Action :	Déclarez la taille de chaque type de données. Varchar2(10), par exemple.
Cause :	La valeur renvoyée pour une variable est trop importante par rapport à la taille indiquée pour le type de données.
Action :	Modifiez la taille de la variable afin de l'adapter à celle du champ sélectionné.
Cause :	L'état a été créé au moyen d'une ancienne version de PL/SQL.
Action :	Ouvrez l'état dans la version actuelle de Report Builder, enregistrez-le, puis fermez-le. Ouvrez-le de nouveau et exécutez-le.


REP-0451 : <Erreur PL/SQL>. <messages supplémentaires>.

Cause :	Report Builder a détecté cette erreur pendant l'exécution d'un état.
Action :	Editez et recompilez le PL/SQL dans l'état pour éviter cette erreur.


REP-0452 : <Erreur PL/SQL>. <message supplémentaire>. <message supplémentaire>.

Cause :	Report Builder a détecté cette erreur pendant l'exécution d'un état.
Action :	Editez et recompilez le PL/SQL dans l'état pour éviter cette erreur.


REP-0453 : <Erreur PL/SQL>. <message supplémentaire>. <message supplémentaire>. <message supplémentaire>.

Cause :	Report Builder a détecté cette erreur pendant l'exécution d'un état.
Action :	Editez et recompilez le PL/SQL dans l'état pour éviter cette erreur.


REP-0490 : Erreur interne - Contexte Toolkit non disponible.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0491 : Avertissement ! Troncature probable des données dans colonne '<nom de la colonne>'.
REP-0491 : Avertissement ! Des données peuvent être tronquées dans la colonne '<nom de la colonne>'.

Cause :	La largeur de la colonne de la base de données, dans l'état, est définie comme étant inférieure à sa largeur dans la base de données, ce qui peut arriver lorsque les colonnes de la base de données sont mises à jour à la suite de la définition de l'état. Ce message d'avertissement n'apparaît que lorsque RUNDEBUG a la valeur YES.
Action :	Imposez une réanalyse de l'interrogation. Vous pouvez également entrer un espace à la fin d'une ligne dans le champ Instruction SELECT, puis accepter la boîte de dialogue Instruction d'interrogation SQL.


REP-0492 : Sème non reconnu : '<nom du sème>'.

Cause :	L'instruction SELECT que vous avez entrée contient un élément qui ne fait pas partie de la syntaxe SQL.
Action :	Vérifiez votre instruction SELECT et assurez-vous qu'elle respecte la syntaxe SQL.


REP-0493 : Erreur interne - Impossible de développer les références lexicales.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0494 : Erreur interne - Impossible de traiter les références lexicales.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0495 : Erreur interne - Impossible d'utiliser un sème pour traiter l'interrogation.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0496 : Erreur interne - Impossible d'analyser l'interrogation.

Cause :	L'instruction SQL que vous avez entrée ne peut pas être analysée, car elle contient une erreur.
Action :	Vérifiez votre instruction SQL et assurez-vous qu'elle respecte la syntaxe SQL. Pour plus d'informations, reportez-vous à ORACLE8 Server SQL Language Reference Manual.


REP-0497 : Erreur interne - Echec de l'interrogation dans rodslt.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0498 : Le nombre de colonnes sélectionné par l'interrogation est incompatible avec la définition de l'état.

Cause :	L'interrogation sélectionne davantage de colonnes que la définition de l'état ne le prévoit, ce qui peut arriver lorsque vous utilisez une interrogation externe qui a été modifiée depuis la définition de l'état.
Action :	Mettez la définition de l'état à jour afin qu'elle accepte l'interrogation modifiée. Par exemple, passez à la boîte de dialogue Instruction d'interrogation SQL correspondant à l'interrogation qui fait référence à l'interrogation externe modifiée, et modifiez cette définition. Les formules, les récapitulatifs et les champs basés sur des colonnes modifiées devront peut-être également être mis à jour.


REP-0499 : La colonne sélectionnée par l'interrogation est incompatible avec la définition de l'état.

Cause :	Dans le champ Instruction SELECT, vous n'avez pas entré une instruction SELECT. Causes possibles :
	Cas 1 :	La définition de la colonne, dans la base de données, a été modifiée depuis la définition de l'état.
	Cas 2 :	L'état utilise une interrogation externe qui a été modifiée depuis la définition de l'état.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Mettez la définition de l'état à jour afin qu'elle accepte la colonne modifiée. Par exemple, si le type des données de la colonne a changé, validez à nouveau l'interrogation externe de la boîte de dialogue Instruction d'interrogation SQL afin de mettre à jour le type des données de la définition de l'état. Les formules, les récapitulatifs et les champs basés sur des colonnes modifiées devront peut-être également être mis à jour.
	Cas 2 :	Mettez la définition de l'état à jour afin qu'elle accepte l'interrogation modifiée. Par exemple, validez à nouveau la boîte de dialogue Instruction d'interrogation SQL qui fait référence à l'interrogation externe modifiée et validez cette définition. Les formules, les récapitulatifs et les champs basés sur des colonnes modifiées devront peut-être également être mis à jour.


REP-0500 : Nombre saisi hors plage.

Cause :	Vous avez entré une valeur trop élevée dans un paramètre.
Action :	Vérifiez les limites du champ. Reportez-vous au chapitre dans lequel le champ est décrit et entrez une valeur qui ne soit pas hors plage.


REP-0501 : Connexion à la base de données indiquée impossible.

Cause :	Report Builder a tenté sans succès de se connecter à ORACLE. Causes possibles :
	Cas 1 :	ORACLE est momentanément indisponible.
	Cas 2 :	Vos informations de connexion n'étaient pas valides.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Tentez à nouveau l'opération. Si le problème persiste, contactez votre administrateur de bases de données. Notez qu'après trois échecs, vous devrez sortir de Report Builder.
	Cas 2 :	Vérifiez vos informations de connexion. Si elles ne sont pas correctes, ré-entrez-les et tentez à nouveau de vous connecter. Notez qu'après trois échecs, vous devrez sortir de Report Builder.


REP-0502 : Erreur lors de la tentative d'ouverture du fichier terminal '<nom du fichier>'.

Cause :	Report Builder a tenté sans succès d'ouvrir le fichier de définition de terminal que vous avez indiqué. Il est possible que vous ayez indiqué un nom de fichier incorrect après le mot-clé TERM, ou que le fichier soit introuvable.
Action :	Vérifiez le nom du fichier de définition de terminal et assurez-vous que le chemin d'accès est correct. Si le problème persiste, contactez votre administrateur de bases de données.


REP-0503 : Nom d'état omis.

Cause :	Vous avez indiqué un nom erroné ou vous n'avez pas indiqué de nom d'état.
Action :	Indiquez le nom d'un état.


REP-0504 : Vous n'êtes pas connecté à une base de données.

Cause :	Vous avez tenté d'exécuter une opération pour laquelle vous deviez être connecté à la base de données, alors que vous ne l'étiez pas.
Action :	Connectez-vous à la base de données en utilisant Fichier [image] Connecter.


REP-0450<Erreur PL/SQL> - Exemples
REP-0450 : <Erreur PL/SQL> - Exemples


REP-0505 : Largeur attribuée à cette colonne incorrecte.

Cause :	La valeur que vous avez entrée pour Largeur est erronée. Causes possibles :
	Cas 1 :	Vous avez entré zéro ou une valeur négative. La largeur doit être supérieure à zéro.
	Cas 2 :	Vous avez entré une information qui n'était pas numérique.
	Cas 3 :	Pour une colonne de données de type non numérique, vous avez entré une largeur de la forme (x, y) où x est la précision et y, l'échelle. Ce type d'indication de largeur n'est valide que lorsque les données sont de type Number.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Entrez une valeur numérique supérieure à zéro.
	Cas 2 :	Entrez une valeur numérique supérieure à zéro.
	Cas 3 :	Entrez une valeur numérique supérieure à zéro ou, si possible, remplacez le type de données de la colonne par Number.


REP-0506 : Les colonnes de bases de données ne peuvent être déplacées entre les interrogations.

Cause :	Vous avez tenté de faire passer une colonne dans un autre groupe appartenant à une autre interrogation, et la colonne est une colonne de base de données. Ce type de colonne doit être sélectionné par l'interrogation qui est propriétaire de son groupe.
Action :	Sélectionnez la colonne, si possible, dans l'interrogation qui est propriétaire du groupe dans  lequel vous voulez la faire passer.


REP-0507 : Avant d'effectuer cette opération, vous devez entrer un nom de fichier.

Cause :	Dans une boîte de dialogue de sélection de fichier, vous avez tenté d'accepter la boîte de dialogue sans indiquer de nom de fichier.
Action :	Entrez un nom, puis acceptez ou annulez la boîte de dialogue.


REP-0508 : Avant d'effectuer cette opération, vous devez entrer un nom d'objet.

Cause :	Dans une boîte de dialogue de sélection d'objet de base de données, vous avez tenté d'accepter la boîte de dialogue sans indiquer de nom d'objet.
Action :	Entrez un nom, puis acceptez ou annulez la boîte de dialogue.


REP-0509 : Nombre erroné.

Cause :	Dans un champ numérique, vous avez entré une valeur autre qu'un chiffre ou un séparateur décimal.
Action :	Entrez une valeur numérique ne contenant que des chiffres et, si nécessaire, un séparateur décimal.


REP-0510 : Les options correctes sont 'Caractère', 'Pouce', 'Centimètre' ou 'Point'.

Cause :	Vous avez entré, dans le champ Unité de mesure, une unité de mesure erronée.
Action :	Sélectionnez dans la liste de valeurs l'option que vous voulez utiliser.


REP-0511 : Les options correctes sont 'De gauche à droite/vers le bas' ou 'Vers le bas/de gauche à droite'.

Cause :	Vous avez entré un ordre d'impression d'écran qui n'était pas l'une des deux options valides.
Action :	Sélectionnez dans la liste de valeurs l'option que vous voulez utiliser.


REP-0512 : Une valeur décimale n'est pas correcte dans ce cas.

Cause :	Cause : Le nombre entré est une valeur décimale alors que Report Builder attend une valeur non décimale.
Action :	Entrez une valeur non décimale.


REP-0513 : Vous devez entrer une unité de mesure.

Cause :	Le champ Unité de mesure n'est pas renseigné et vous avez tenté de passer à un autre paramètre.
Action :	Sélectionnez une option pour Unité de mesure.


REP-0514 : Vous devez indiquer une taille de page.

Cause :	Les champs Largeur de page et/ou Hauteur de page ne sont pas renseignés.
Action :	Entrez une valeur numérique pour Largeur de page et/ou Hauteur de page.


REP-0515 : Vous devez indiquer une taille pour la grille de paramètres.

Cause :	Les champs Largeur de grille de paramètres et/ou Hauteur de grille de paramètres ne sont pas renseignés.
Action :	Entrez une valeur numérique pour Largeur de grille de paramètres et/ou Hauteur de grille de paramètres.


REP-0516 : Vous devez indiquer la taille de page en caractères.

Cause :	La valeur que vous avez indiquée pour Taille de la page n'était pas exprimée en unités de caractère.
Action :	Entrez, pour Taille de la page, une valeur en caractères.


REP-0517 : Vous devez indiquer la taille de la grille en caractères.

Cause :	La valeur que vous avez indiquée pour Taille de la grille n'était pas exprimée en unités de caractère.
Action :	Entrez, pour Taille de la grille, une valeur en caractères.


REP-0518 : Les options correctes sont 'Base de données', 'Fichier' ou 'Fichier/Base de données'.

Cause :	Le paramètre Accès objet que vous avez entré n'était pas l'une des trois options valides.
Action :	Sélectionnez une option dans la liste de valeurs.


REP-0519 : Les options correctes sont 'Insérer' ou 'Remplacer'.

Cause :	Le mode d'édition de texte par défaut que vous avez entré n'était pas l'une des deux options valides.
Action :	Sélectionnez une option dans la liste de valeurs.


REP-0520 : La valeur de renfoncement associée au groupe/encadrement doit être comprise entre 0 et 4.

Cause :	La valeur de renfoncement, associée au groupe/encadrement, que vous avez entrée n'est pas comprise dans la plage valide.
Action :	Entrez une valeur numérique comprise entre 0 et 4.


REP-0521 : '<Nom>' est un nom erroné.

Cause :	Vous n'avez pas respecté les conventions d'appellation et vous avez donné à un objet un nom erroné (affiché).
Action :	Reportez-vous aux conventions d'appellation correspondant au type d'objet que vous créez et assurez-vous que le nom que vous indiquez respecte ces conventions. Pour plus d'informations, reportez-vous à Conventions d'appellation.


REP-0522 : Cet état ne comporte aucun groupe : vous ne pouvez donc construire aucune présentation par défaut.

Cause :	Vous avez sélectionné Outils [image] Présentation par défaut ou tracé une région en utilisant l'outil Présentation par défaut dans l'Editeur de modèle de présentation, avant d'avoir créé des groupes pour l'état. La création d'une présentation par défaut implique l'existence de groupes.
Action :	Créez une ou plusieurs interrogations pour permettre à Report Builder de créer automatiquement un groupe, puis tentez à nouveau d'exécuter l'opération.


REP-0523 : Style de présentation par défaut erroné. Reportez-vous à la liste de valeurs.

Cause :	Vous avez entré pour Style de présentation par défaut une valeur qui n'était pas l'une des options valides.
Action :	Sélectionnez un style de présentation dans la liste de valeurs.


REP-0524 : Orientation d'impression non valide. Reportez-vous à la liste de valeurs.

Cause :	Vous avez entré une valeur d'itération qui n'était pas l'une des options valides.
Action :	Sélectionnez une valeur d'itération dans la liste de valeurs.


REP-0525 : Les options correctes sont 'Screen', 'File', 'Printer', 'Mail' ou 'Sysout'.

Cause :	Vous avez entré, pour le paramètre système DESTYPE, un type de destination qui n'était pas l'une des options valides. Causes possibles :
	Cas 1 :	Vous avez entré comme Type de destination, dans Grille de paramètres d'exécution, une valeur erronée.
	Cas 2 :	Vous avez entré dans la palette de propriétés Paramètres une valeur initiale erronée pour DESTYPE.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Entrez une valeur valide : Screen, File, Printer, Mail ou Sysout.
	Cas 2 :	Sélectionnez comme valeur initiale une valeur de la liste de valeurs.


REP-0526 : La valeur initiale saisie dépasse la largeur de paramètre.

Cause :	Vous avez entré une valeur trop longue pour le paramètre de la Palette de propriétés Paramètre. Causes possibles :
	Cas 1 :	Vous avez entré dans Valeur initiale une valeur trop élevée, compte tenu des indications que vous avez fournies pour la largeur du paramètre.
	Cas 2 :	Vous avez entré une valeur de largeur insuffisante pour contenir les valeurs que vous voulez pouvoir entrer pour le paramètre.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Ré-entrez la valeur initiale en vous assurant qu'elle n'est pas supérieure à celle que vous avez indiquée dans Largeur.
	Cas 2 :	Supprimez la valeur initiale que vous avez entrée. Passez à l'option Largeur de paramètre et modifiez-la afin qu'elle puisse contenir la valeur initiale que vous avez indiquée. Ré-entrez la valeur initiale.


REP-0527 : Vous ne pouvez pas supprimer un paramètre système.

Cause :	Vous avez tenté de supprimer un paramètre en package de la palette de propriétés Paramètre.
Action :	Report Builder ne vous permet pas de supprimer un paramètre système. Cependant, vous pouvez supprimer l'affichage du paramètre dans la Grille de paramètres d'exécution en utilisant la boîte de dialogue Grille de paramètres par défaut ou l'Editeur de grille de paramètres. Pour plus d'informations, reportez-vous à Editeur de grille de paramètres.


REP-0528 : Les options correctes sont 'Character', 'Number' ou 'Date'.

Cause :	Le type de données que vous avez entré dans Type de données pour le paramètre n'était pas l'une des options correctes.
Action :	Sélectionnez un type de données dans la liste de valeurs.


REP-0529 : Les options correctes sont 'Boîte', 'Graphique', 'Trait' ou 'Texte'.

Cause :	La valeur que vous avez entrée dans Type pour le texte standard n'était pas l'une des options correctes.
Action :	Sélectionnez une valeur pour Type dans la liste de valeurs.


REP-0530 : Fichier trop long : doit être tronqué.

Cause :	Vous avez tenté d'importer un fichier dans un champ dont la largeur maximum est inférieure à la taille du fichier. Report Builder n'a importé que la partie de fichier correspondant à la taille du champ.
Action :	Si vous voulez importer tout le fichier, augmentez la taille du champ.


REP-0531 : Type d'objet erroné. Reportez-vous à la liste de valeurs.

Cause :	Dans la boîte de dialogue de navigation vers l'objet, vous avez entré pour Type d'objet une valeur erronée.
Action :	Sélectionnez l'une des valeurs de la liste de valeurs.


REP-0532 : Il n'existe aucun objet de ce type sous ce nom.

Cause :	La valeur que vous avez entrée dans le champ Nom d'objet de la boîte de dialogue de navigation vers l'objet ne correspond pas à un objet du type indiqué dans l'état.
Action :	Assurez-vous que vous avez indiqué le nom correctement et que l'objet se trouve dans l'état en cours.


REP-0533 : Vous ne pouvez importer que vers un champ texte modifiable.

Cause :	Vous avez sélectionné Edition [image] Importer alors que vous étiez dans un champ autre qu'un champ texte modifiable (par exemple, un champ qui n'accepte qu'une valeur numérique).
Action :	Si vous voulez effectuer une importation, passez à un champ texte modifiable.


REP-0534 : Vous ne pouvez exporter qu'à partir d'un champ texte modifiable.

Cause :	Vous avez sélectionné Edition [image] Exporter alors que vous étiez dans un champ autre qu'un champ texte modifiable (par exemple, un champ qui n'accepte qu'une valeur numérique).
Action :	Si vous voulez effectuer une exportation, passez à un champ texte modifiable.


REP-0535 : Cette base de données ne contient aucun objet du nom de '<nom de l'objet>'.

Cause :	Vous avez tenté d'exécuter une opération sur un document stocké dans la base de données, mais Report Builder n'a pas pu trouver l'objet.
Action :	Assurez-vous que vous avez indiqué le nom correctement et que vous êtes connecté à la base de données dans laquelle se trouve le document.


REP-0536 : Vous ne pouvez supprimer d'une base de données un objet dont vous n'êtes pas propriétaire.

Cause :	Vous avez tenté de supprimer un objet dont vous n'êtes pas propriétaire.
Action :	Demandez au propriétaire de supprimer l'objet, si possible.


REP-0537 : Vous ne pouvez renommer dans une base de données un objet dont vous n'êtes pas propriétaire.

Cause :	Vous avez tenté de renommer un objet dont vous n'êtes pas propriétaire.
Action :	Demandez au propriétaire de renommer l'objet, si possible.


REP-0538 : Un objet du nom de '<nom de l'objet>' existe déjà dans cette base de données.

Cause :	Le nom que vous avez entré est déjà utilisé pour un objet existant.
Action :	Donnez à l'objet un nom différent pour éviter le conflit ou supprimez l'objet existant.


REP-0539 : La grille de paramètres par défaut ne tient pas dans <nombre> page(s).

Cause :	La grille de paramètres par défaut est trop grande pour le nombre de pages indiqué.
Action :	Sélectionnez Outils [image] Grille de paramètres par défaut. Augmentez le nombre de pages que la grille de paramètres peut contenir.


REP-0540 : Taille de page insuffisante pour la grille de paramètres par défaut.

Cause :	Les paramètres de Largeur et Hauteur de grille sont trop insuffisants pour la grille de paramètres par défaut.
Action :	Augmentez la taille des pages de grille de paramètres dans la palette de propriétés Etat en modifiant les paramètres de Largeur et Hauteur de grille. Vous pouvez également réduire la taille de la grille de paramètres par défaut en sélectionnant Outils [image] Grille de paramètres par défaut, puis en modifiant sa valeur dans l'Editeur de grille de paramètres.


REP-0541 : Le document source doit être un état.

Cause :	Pour RWRUN60, RWCON60 ou Fichier [image] Convertir, vous avez indiqué un document source autre qu'un état. Toutes ces opérations doivent avoir comme source un état.
Action :	Indiquez un état.


REP-0542 : Aucun masque de date indiqué dans les préférences.

Cause :	Dans la palette de propriétés Paramètre ou Champ d'un paramètre/champ de type Date, vous avez choisi le bouton Liste comme Masque de saisie ou Masque de format, alors qu'aucun masque n'est indiqué dans la liste Masques de date de l'onglet Préférences de la boîte de dialogue Options outils.
Action :	Entrez manuellement un masque de format de date ou passez à l'onglet Préférences de la boîte de dialogue Options outils et entrez des masques de format de date dans la liste Masques de date.


REP-0543 : Aucun masque numérique indiqué dans les préférences.

Cause :	Dans la palette de propriétés Paramètre ou Champ d'un paramètre/champ de type Number, vous avez choisi le bouton Liste comme Masque de saisie ou Masque de format, alors qu'aucun masque n'est indiqué dans la liste Masques numériques de l'onglet Préférences de la boîte de dialogue Options outils.
Action :	Entrez manuellement un masque de format numérique ou passez à l'onglet Préférences de la boîte de dialogue Options outils et entrez des masques de format numérique dans la liste Masques numériques.


REP-0544 : Le système d'aide en ligne n'est pas disponible.

Cause :	Vous avez sélectionné Aide [image] Système d'aide, mais l'aide est introuvable. Il est possible que les fichiers d'aide soient introuvables ou qu'une erreur du système d'aide se soit produite.
Action :	Assurez-vous que les fichiers d'aide et le système sont correctement installés. S'ils le sont et que l'erreur persiste, contactez le Support technique Oracle. Pour plus d'informations, reportez-vous à Recours au Support technique Oracle.


REP-0545 : Ce nombre doit être supérieur à 0.

Cause :	Vous avez entré la valeur zéro comme Largeur de page, Hauteur de page ou Taille de page logique dans la palette de propriétés Etat. Vous devez entrer une valeur numérique supérieure à 0.
Action :	Entrez une valeur numérique supérieure à 0 pour Largeur de page, Hauteur de page ou Taille de page logique.


REP-0546 : Entrée d'un paramètre erroné.

Cause :	Dans la Grille de paramètres d'exécution, vous avez entré une valeur erronée pour un paramètre. Par exemple, vous avez entré un ou plusieurs caractères comme valeur de paramètre alors que les données sont de type Number.
Action :	Tentez à nouveau d'exécuter l'opération en entrant une valeur valide pour le paramètre.


REP-0548 : Problème d'initialisation de Oracle Toolkit.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0549 : Types de destination obligatoires en mode Traitement par lots : 'File', 'Printer', 'Mail', ou 'Sysout'.
REP-0549 : Types de destination obligatoires en mode Traitement par lots : 'File', 'Printer', 'Mail' ou 'Sysout'.

Cause :	Vous avez tenté d'exécuter un état en arrière-plan (c'est-à-dire avec BATCH=YES), mais vous avez indiqué un DESTYPE erroné pour l'exécution en arrière-plan.
Action :	Remplacez la valeur de DESTYPE par File, Printer, Mail ou Sysout, ou n'exécutez pas l'état avec BATCH=YES.


REP-0550 : Groupe père erroné.

Cause :	Le nom que vous avez entré n'identifie pas un groupe père valide dans l'état que vous définissez.
Action :	Sélectionnez un groupe de la liste de valeurs.


EP-0551 : Colonne père erronée.
REP-0551 : Colonne père erronée.

Cause :	Le nom que vous avez entré n'identifie pas une colonne père valide dans l'état que vous définissez. La colonne que vous avez indiquée n'existe pas dans le groupe père.
Action :	Sélectionnez une colonne dans la liste de valeurs. Si la colonne que vous voulez sélectionner n'apparaît pas, ajoutez-la à l'instruction SELECT de l'interrogation père du groupe indiqué dans Groupe père.


REP-0552 : Colonne fils erronée.

Cause :	Le nom que vous avez entré n'identifie pas une colonne fils valide dans l'état que vous définissez. La colonne que vous avez indiquée n'existe pas dans l'interrogation.
Action :	Sélectionnez une colonne dans la liste de valeurs. Si la colonne que vous voulez sélectionner n'apparaît pas, ajoutez-la à l'instruction SELECT de l'interrogation.


REP-0553 : Condition erronée.

Cause :	La condition que vous avez entrée pour l'interrogation ne figure pas parmi les choix valides.
Action :	Sélectionnez une valeur dans la liste de valeurs pour Condition.


REP-0554 : Les options correctes sont 'WHERE', 'HAVING' ou 'START WITH'.

Cause :	La valeur que vous avez entrée dans Clause SQL n'est pas un choix valide.
Action :	Sélectionnez une valeur dans la liste des valeurs pour Clause SQL.


REP-0555 : Avertissement ! 'START WITH' est une syntaxe SQL propre à ORACLE : exécution impossible d'un état sur une base non-ORACLE.

Cause :	La clause START WITH ne peut être utilisée qu'avec la base de données ORACLE. Ce message d'avertissement apparaît si vous n'êtes pas connecté à une base de données ou si vous êtes connecté à une base de données non ORACLE.
Action :	Assurez-vous que vous exécutez l'état en utilisant une base de données ORACLE ou supprimez la clause START WITH avant d'exécuter l'état avec une base de données  non ORACLE.


REP-0556 : Aucun lien de données créé. Aucune clé étrang. ds interro fils '<nom de l'interrogation>' fait réf. à clé primaire dans interro père '<nom de l'interrogation>'.

Cause :	Vous avez tenté de créer un lien d'interrogation à interrogation, mais l'interrogation fils ne comporte aucune clé étrangère.
Action :	Assurez-vous que les tables auxquelles vous faites référence sont présentes dans votre base de données locale et qu'elles sont accessibles. Si tel est le cas, ajoutez au besoin les contraintes de colonne appropriées, le cas échéant.


REP-0558 : Remarque : l'interrogation '<nom de l'interrogation>' a créé un ou plusieurs paramètres lexicaux '<nom du paramètre>'.

Cause :	L'interrogation indiquée fait référence à un ou plusieurs paramètres lexicaux qui n'existent pas.
Action :	Aucune. Report Builder a déjà créé le ou les paramètres lexicaux nécessaires.


REP-0559 : Remarque : l'interrogation '< nom de l'interrogation >' a créé un ou plusieurs paramètres de liaison '<nom du paramètre>'.

Cause :	L'interrogation indiquée fait référence à un ou plusieurs paramètres de liaison qui n'existent pas.
Action :	Aucune. Report Builder a déjà créé le ou les paramètres de liaison nécessaires.


REP-0560 : Groupe non valide.

Cause :	Le nom de groupe que vous avez entré dans Groupe n'est pas valide pour la colonne. Le groupe que vous avez indiqué n'existe pas ou ne peut pas être propriétaire de la colonne.
Action :	Créez ou modifiez le groupe afin qu'il puisse être propriétaire de la colonne. Une colonne de base de données doit appartenir au groupe associé à l'interrogation qui la sélectionne. Une colonne récapitulative ou de formule doit appartenir à une colonne de niveau inférieur au(x) groupe(s) propriétaire(s) des colonnes de récapitulation dans la hiérarchie des groupes (c'est-à-dire l'ordre dans lequel les groupes figurent dans l'éditeur modèle de données).


REP-0561 : Les options correctes sont 'Formule', 'Récapitulative' ou 'De réserve'.

Cause :	La valeur que vous avez entrée dans Type pour la colonne n'est pas un choix valide.
Action :	Sélectionnez pour Type, une valeur contenue dans la liste.


REP-0562 : Type de données de colonne erroné. Reportez-vous à la liste de valeurs.

Cause :	La valeur que vous avez entrée dans Type de données n'est pas un choix valide.
Action :	Sélectionnez, pour Type de données, une valeur contenue dans la liste.


REP-0563 : Les options correctes sont 'Ascendant', 'Descendant' ou vide.

Cause :	La valeur que vous avez entrée dans Type de données n'est pas un choix valide.
Action :	Sélectionnez, pour Type de données, une valeur contenue dans la liste.


REP-0564 : Type de fichier erroné.

Cause :	La valeur que vous avez entrée dans Lecture depuis fichier n'est pas un type valide. Vous avez mal orthographié la valeur, ou la valeur que vous avez entrée n'existe pas.
Action :	Sélectionnez, pour Lecture depuis fichier, un type de fichier contenu dans la liste.


REP-0565 : Fonction erronée. Reportez-vous à la liste de valeurs.

Cause :	La fonction que vous avez entrée n'est pas un choix valide.
Action :	Sélectionnez l'une des fonctions contenues dans la liste de valeurs.


REP-0566 : Vous ne pouvez pas supprimer une colonne de base de données.

Cause :	Vous avez tenté de supprimer une colonne de type Base de données.
Action :	Supprimez la colonne de la liste de l'interrogation qui la sélectionne afin que la colonne soit supprimée automatiquement.


REP-0567 : Source de résumé erronée. Reportez-vous à la liste de valeurs.

Cause :	La colonne que vous avez entrée dans Source pour le résumé n'est pas un choix valide. Causes possibles :
	Cas 1 :	La colonne n'existe pas.
	Cas 2 :	Les données de la Source sont de type Character ou Date. Vous ne pouvez utiliser de fonctions numériques (comme Percent, Sum ou Average) que si les données sont de type Number.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Sélectionnez une colonne dans liste des valeurs de la fonction.
	Cas 2 :	Entrez dans Source le nom d'une autre colonne de type Number.


REP-0568 : Valeur si non renseigné (Null) erronée.

Cause :	La valeur de Valeur si Null dans la palette de propriétés Colonne est erronée pour cette colonne. Ce message apparaît, par exemple, si les données de la colonne sont de type Number  et que vous indiquiez une chaîne de caractères dans Valeur si Null.
Action :	Indiquez une valeur valide pour Valeur si Null.


REP-0580 : Type de filtre erroné. Reportez-vous à la liste de valeurs.

Cause :	La valeur que vous avez entrée pour Type, sous Filtre, n'est pas un choix valide.
Action :	Sélectionnez l'un des types de filtre dans la liste de valeurs.


REP-0581 : Ceci est l'unique groupe de l'interro '<nom de l'interrogation>' ; vous ne pouvez pas le supprimer.

Cause :	Le groupe que vous avez tenté de supprimer est le seul groupe de l'interrogation. Chaque interrogation doit avoir au moins un groupe.
Action :	Si vous voulez supprimer le groupe, supprimez l'interrogation du groupe.


REP-0582 : Vous ne pouvez pas sortir un groupe de son interrogation.

Cause :	Vous ne pouvez pas déplacer un groupe d'une interrogation à l'autre. Les groupes ne peuvent être déplacés que dans l'ensemble de groupes appartenant à la même interrogation.
Action :	Vous pouvez créer un groupe semblable à celui que vous tentiez de déplacer sous l'autre interrogation, si possible.


REP-0583 : Instruction Select SQL incorrecte.

Cause :	L'instruction SQL SELECT que vous avez entrée n'est pas valide.
Action :	Vérifiez si l'instruction SELECT comporte des erreurs et corrigez-les. Pour plus d'informations, reportez-vous à ORACLE8 Server SQL Language Reference Manual.


REP-0584 : Les paramètres lexicaux ne sont pas autorisés dans les interrogations externes.

Cause :	Vous avez fait une référence lexicale dans votre interrogation externe.
Action :	Supprimez totalement la référence ou, si possible, remplacez-la par une référence de lien.


REP-0585 : Groupe père <nom du groupe> associé à interrogation fils <nom de l'interrogation> inexistant.

Cause :	Vous avez supprimé une interrogation sans supprimer les références à ses groupes dans les liens de données. Ce problème apparaît généralement lorsque vous avez supprimé une interrogation sans répercuter la suppression sur les objets qui lui sont associés.
Action :	Mettez le lien de donnés à jour dans l'interrogation fils.


REP-0586 : En ajoutant ce lien de données, vous créez une boucle.

Cause :	Le groupe que vous avez indiqué comme groupe père pour le lien de données ne peut pas être père car il est, directement ou indirectement, un fils de l'interrogation à laquelle vous le liez.
Action :	Si possible, déplacez le groupe afin qu'il ne soit pas un fils de l'interrogation, et ne puisse donc pas être choisi comme son groupe père. Sinon, aucune autre action n'est possible.


REP-0587 : Condition de filtre de groupe PL/SQL erronée.

Cause :	Vous avez sélectionné Condition  pour Type de filtre, mais vous n'avez pas entré de condition PL/SQL.
Action :	Entrez votre condition PL/SQL ou changez le type de filtre. Pour plus d'informations sur l'utilisation de PL/SQL dans Report Builder, reportez-vous à Interface PL/SQL. Pour plus d'informations sur PL/SQL, reportez-vous à PL/SQL User's Guide and Reference.


REP-0588 : Formule de colonne PL/SQL erronée.

Cause :	Vous avez sélectionné Formule  pour Type de la colonne, mais vous n'avez pas entré de PL/SQL pour la formule.
Action :	Créez une formule ou changez le type de la colonne. Pour plus d'informations sur l'utilisation de PL/SQL dans Report Builder, reportez-vous à Interface PL/SQL. Pour plus d'informations sur PL/SQL, reportez-vous à PL/SQL User's Guide and Reference.


REP-0590 : <nombre> page(s) formatées seulement. Dernière page affichée.

Cause :	Dans l'Aperçu interactif, vous avez tenté de passer à un numéro de page supérieur au nombre total de pages formatées, c'est-à-dire que vous avez tenté de passer à une page qui n'existe pas.
Action :	Aucune. Vous ne pouvez pas aller au-delà de la dernière page de l'état.


REP-0591 : Vous êtes déjà à la première page.

Cause :	Dans l'Aperçu interactif, vous avez sélectionné Première alors que vous étiez déjà à la première page de l'état.
Action :	Aucune. Vous ne pouvez pas aller plus haut que la première page de l'état.


REP-0592 : Vous êtes déjà à la dernière page.

Cause :	Dans l'Aperçu interactif, vous avez sélectionné Dernière alors que vous étiez déjà à la dernière page de l'état.
Action :	Aucune. Vous ne pouvez pas aller au-delà de la dernière page de l'état.


REP-0593 : La page <numéro de la page> est la page courante.

Cause :	Dans l'Aperçu interactif, vous avez entré le numéro de la page en cours et choisi Aller à.
Action :	Si vous voulez passer à une autre page, entrez un numéro de page différent et choisissez Aller à.


REP-0594 : Aucune sortie d'état générée.

Cause :	L'état que vous avez exécuté n'a généré aucune sortie.
Action :	Consultez les messages d'accompagnement du modèle et de la présentation de données. Si le problème persiste, contactez le Support technique Oracle. Pour plus d'informations, reportez-vous à Recours au Support technique Oracle.


REP-0595 : Définition d'état modifiée. Etat exécuté de nouveau.

Cause :	Vous avez exécuté un état et modifié sa définition pendant que sa sortie se trouvait toujours dans l'Aperçu interactif. Si vous retournez à Previewer sans ré-exécuter l'état, la sortie de l'état n'est pas mise à jour et ne reflète donc pas les dernières modifications. L'état doit alors être ré-exécuté.
Action :	Fermez l'Aperçu interactif et ré-exécutez l'état.


REP-0596 : Ce nombre ne peut être supérieur à <nombre> ou inférieur à 1.

Cause :	Vous avez entré pour Numéro de page dans la palette de propriétés Champ une valeur erronée pour un champ Grille de paramètres. La cause la plus probable de cette erreur est que vous avez entré zéro, un nombre négatif ou un nombre supérieur à la valeur autorisée la plus élevée.
Action :	Entrez un nombre compris dans les limites indiquées dans le message.


REP-0597 : Cette opération est erronée car elle place un/des objets(s) hors des limites.
REP-0597 : Cette opération est erronée car elle place un/des objet(s) hors des limites.

Cause :	Vous avez tenté de faire sortir de l'écran les objets de l'éditeur.
Action :	Tentez à nouveau d'exécuter l'opération de sorte que les objets ne sortent pas de l'écran.


REP-0598 : Vous avez placé le point d'ancrage hors des limites de l'objet ; veuillez recommencer.

Cause :	En déplaçant un point d'ancrage, vous l'avez fait sortir des limites de l'objet.
Action :	Déplacez le point d'ancrage de sorte que sa limite soit toujours comprise dans celle de l'objet.


REP-0599 : Ce texte standard n'est pas éditable.

Cause :	Vous avez tenté d'éditer le texte d'un objet standard de fichier de liaison, alors qu'il était affiché dans l'Editeur de modèle de présentation.
Action :	Si vous voulez éditer le texte d'un objet standard de fichier de liaison, sortez de l'état et éditez le fichier contenant le texte standard de fichier de liaison en utilisant un éditeur de texte.


REP-0600 : Il n'existe aucune liste de valeurs disponibles pour ce champ.

Cause :	Vous avez tenté d'accéder à une liste de valeurs pour le champ en cours, alors qu'aucune liste n'était disponible.
Action :	Aucune.


REP-0601 : La liste de valeurs disponibles pour ce champ est vide.

Cause :	Vous avez tenté de sélectionner une valeur dans une liste vide. Pour que des listes puissent contenir des valeurs, vous devez commencer par générer une autre partie de votre état. Cette erreur se produit, par exemple, si une liste de valeurs se compose uniquement de noms de colonne et que vous n'ayez pas rempli votre modèle de données.
Action :	Générez complètement votre état pour corriger cette erreur. Si l'erreur persiste, contactez le Support technique Oracle. Pour plus d'informations, reportez-vous à Recours au Support technique Oracle.


REP-0602 : Impossible de lancer une interrogation sur les tables accessibles.

Cause :	La vue du dictionnaire des tables accessibles n'est pas présente ou n'est pas disponible.
Action :	Signalez le problème à votre administrateur de bases de données.


REP-0603 : Impossible de décrire la table '<nom de la table>'.

Cause :	La vue du dictionnaire des tables accessibles n'est pas présente ou n'est pas disponible.
Action :	Signalez le problème à votre administrateur de bases de données.


REP-0604 : Impossible de construire instruction SELECT - aucune valeur sélectionnée.

Cause :	Vous avez accepté la boîte de dialogue Noms de table et de colonnes sans avoir sélectionné d'éléments permettant de construire l'instruction SELECT. Ce message d'erreur apparaît si vous choisissez le bouton d'option Colonnes ou Table sans que des colonnes ou des tables soient sélectionnées lorsque vous acceptez cette boîte de dialogue.
Action :	Sélectionnez une table et, le cas échéant, une ou plusieurs colonnes, ou choisissez le bouton d'option SELECTIONNER colonnes DEPUIS table , puis validez la boîte de dialogue. Pour éditer la boîte de dialogue sans construire d'instruction SELECT, choisissez le bouton Fermer.


REP-0606 : Impossible de lire le fichier de liaison '<nom du fichier>'. Vérifiez-en le format.
REP-0606 : Impossible de lire fichier de liaison '<nom du fichier>'. Vérifiez-en le format.

Cause :	Le fichier que vous avez indiqué dans le champ Fichier de liaison de la palette de propriétés Objet standard est introuvable, ou son format ne correspond pas à celui indiqué dans le champ Format.
Action :	Assurez-vous que vous avez correctement indiqué le nom du fichier et que la valeur que vous avez entrée dans le champ Format correspond au format de fichier.


REP-0607 : Le fichier '<nom du fichier>' à exécution seule (Run only) ne peut être ouvert.
REP-0607 : Le fichier '<nom du fichier>' à exécution seule (Run-only) ne peut être ouvert.

Cause :	Vous avez tenté d'ouvrir un fichier exécutable (c'est-à-dire un fichier ayant le suffixe .rep). Les fichiers exécutables ne peuvent pas être ouverts. Ils ne peuvent qu'être exécutés.
Action :	Ouvrez la définition de l'état associé au fichier .rep. Il doit avoir le suffixe .rdf.


REP-0608 : Type de source erroné. Reportez-vous à la liste de valeurs.

Cause :	Vous avez sélectionné Fichier-->Convertir... et le type de source que vous avez indiqué n'est pas valide.
Action :	Sélectionnez le type de source dans la liste de valeurs.


REP-0609 : Type de destination erroné. Reportez-vous à la liste de valeurs.

Cause :	Vous avez sélectionné Fichier-->Administration-->Convertir et le type de destination que vous avez indiqué n'est pas valide.
Action :	Sélectionnez le type de destination dans la liste de valeurs.


REP-0610 : Erreur lors de la tentative d'impression de l'écran. Vérifiez si le fichier de journalisation '<nom du fichier>' est accessible.

Cause :	Report Builder a tenté d'écrire le contenu de l'écran dans le fichier printdef.dat, mais n'a pas pu le trouver.
Action :	Pour savoir où se trouve le fichier printdef.dat, reportez-vous au guide d'installation.


REP-0611 : Les options correctes sont 'Screen', 'File', 'Printer' ou 'Mail'.
REP-0611 : Les options correctes sont 'Screen', 'File', 'Printer' ou 'Mail'.*

Cause :	Dans Grille des paramètres d'exécution, vous avez fourni pour Type de destination une valeur erronée.
Action :	Indiquez, pour Type de destination, Screen, File, Printer ou Mail.


REP-0612 : Masque de date erroné.

Cause :	Le masque de date que vous avez entré ne correspond pas à l'un des masques de date valide.
Action :	Assurez-vous que vous avez entré le masque correctement. Pour plus d'informations, reportez-vous à Masque de format.


REP-0613 : Cette valeur ne correspond pas au masque '<chaîne du masque>'.

Cause :	Le masque que vous avez entré dans Masque de format n'est pas valide. Causes possibles :
	Cas 1 :	La chaîne que vous avez entrée comme masque contenait des caractères erronés.
	Cas 2 :	Vous avez entré un masque de format numérique pour une chaîne de type Character.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Sélectionnez une valeur dans la liste de valeurs. Pour plus d'informations, reportez-vous à Masque de format.
	Cas 2 :	Si possible, remplacez le Type de données des champs par Number. Si le champ est considéré comme contenant des données de type Character et ne peut pas être modifié, vous ne pouvez pas indiquer de masque de format.


REP-0614 : Aucune fenêtre n'est active pour l'opération Rechercher/remplacer.

Cause :	Vous avez tenté d'exécuter une opération de recherche et de remplacement en utilisant la boîte de dialogue de recherche et de remplacement alors que le curseur n'était pas dans une fenêtre active de Report Builder.
Action :	Faites passer votre curseur dans un champ de saisie de texte avant d'exécuter une opération de recherche/remplacement.


REP-0615 : Vous ne pouvez lancer une opération Rechercher/remplacer que pour un champ de saisie de texte.

Cause :	Vous avez tenté d'exécuter une opération de recherche et de remplacement en utilisant la boîte de dialogue de recherche et de remplacement, mais le curseur n'était pas dans un champ de saisie de texte. Les opérations de recherche et de remplacement ne sont valides que dans des champs de saisie de texte.
Action :	Faites passer votre curseur dans un champ de saisie de texte avant d'exécuter une opération Rechercher/remplacer.


REP-0616 : Vous ne pouvez remplacer du texte dans une zone qui ne peut être éditée.

Cause :	Lorsque vous avez utilisé la boîte de dialogue de recherche et de remplacement, vous avez tenté de remplacer du texte dans un champ qui n'était pas accessible.
Action :	Vous ne pouvez remplacer du texte que dans des zones qui peuvent être éditées.


REP-0617 : Avertissement ! Grille paramètres exécution déjà ouverte. Pour en lancer une nouvelle, veuillez fermer l'ancienne et recommencer.

Cause :	Vous avez tenté d'exécuter un état alors que la Grille de paramètres d'exécution était déjà ouverte.
Action :	Fermez la Grille de paramètres d'exécution ouverte et tentez à nouveau d'exécuter l'état.


REP-0619 : Exécution impossible sans grille de présentation.

Cause :	Vous avez tenté d'exécuter un état sans grille de présentation. L'état sera vide.
Action :	Créez une présentation, puis exécutez votre état.


REP-0621 : Elasticité verticale erronée. Reportez-vous à la liste de valeurs.

Cause :	La valeur que vous avez entrée pour Elasticité verticale de l'objet n'est pas valide.
Action :	Sélectionnez l'une des valeurs de la liste de valeurs.


REP-0622 : Elasticité horizontale erronée. Reportez-vous à la liste de valeurs.

Cause :	La valeur que vous avez entrée pour Elasticité horizontale de l'objet n'est pas valide.
Action :	Sélectionnez l'une des valeurs de la liste de valeurs.


REP-0623 : Type de condition d'impression erroné. Reportez-vous à la liste de valeurs.

Cause :	La valeur que vous avez entrée pour Type de Condition d'impression n'est pas valide.
Action :	Sélectionnez l'une des valeurs de la liste de valeurs.


REP-0624 : Objet de condition d'impression erroné. Reportez-vous à la liste de valeurs.

Cause :	La valeur que vous avez entrée pour Objet de Condition d'impression n'est pas valide.
Action :	Sélectionnez l'une des valeurs de la liste de valeurs.


REP-0625 : Alignement de texte erroné. Reportez-vous à la liste de valeurs.

Cause :	La valeur que vous avez entrée pour Alignement n'est pas valide, compte tenu du type de données de l'objet. Les seules valeurs autorisées pour les champs de type Character sont : Alignement à gauche, Alignement au centre et Alignement à droite.
Action :	Sélectionnez l'une des valeurs de la liste de valeurs.


REP-0626 : Vous devez indiquer la position de l'objet.

Cause :	Vous avez entré une coordonnée x ou y qui est en dehors de la plage des coordonnées valides. Les coordonnées ne peuvent pas être exprimées sous forme de nombres négatifs.
Action :	Entrez une coordonnée valide.


REP-0627 : La hauteur ou la largeur d'un objet doit être un nombre entier positif.

Cause :	La valeur que vous avez entrée pour Largeur ou Hauteur n'est pas un nombre positif.
Action :	Entrez un nombre entier positif.


REP-0630 : La valeur doit être comprise entre <valeur1> et <valeur2>.

Cause :	La valeur que vous avez entrée est trop grande ou trop petite.
Action :	Indiquez une valeur se trouvant dans la plage précisée dans le message.


REP-0631 : La chaîne ne doit pas dépasser <nombre> caractère(s).

Cause :	La chaîne que vous avez entrée est trop longue.
Action :	Entrez une chaîne inférieure au nombre de caractères indiqué dans le message.


REP-0632 : Cette valeur existe déjà dans la liste.

Cause :	Vous avez tenté d'ajouter un élément à une liste, alors qu'il y était déjà. Ce message apparaît, par exemple, si vous avez tenté d'ajouter bibl1 à la liste des Bibliothèques PL/SQL attachées, alors que bibl1 figurait déjà dans cette liste.
Action :	Lorsqu'un élément a été ajouté à une liste, il n'a pas besoin d'être ajouté une seconde fois.


REP-0633 : Aucune valeur indiquée.

Cause :	Vous avez tenté d'exécuter une opération de liste sur un élément, alors que vous n'aviez pas indiqué d'élément. Ce message apparaît, par exemple, si vous avez tenté d'ajouter une bibliothèque PL/SQL à la liste Bibliothèques PL/SQL attachées, alors que vous n'avez pas renseigné le champ Bibliothèque PL/SQL de la boîte de dialogue Bibliothèques PL/SQL attachées, et que vous avez choisi le bouton Ajouter.
Action :	Avant de choisir un bouton, indiquez dans le champ approprié l'élément que vous voulez ajouter.


REP-0634 : Le nom de la destination doit comprendre moins de <nombre> caractères.

Cause :	Vous avez indiqué, pour une destination (probablement un nom de fichier) un nom trop long. Les noms de destination doivent comprendre moins de caractères.
Action :	Indiquez à nouveau un nom de fichier en vous assurant que sa longueur est valide.


REP-0635 : Valeur inexistante dans la liste.

Cause :	Vous avez indiqué une valeur qui ne figure pas parmi les choix valides. Il est possible que vous ayez entré une valeur au lieu d'utiliser la liste de valeurs.
Action :	Indiquez l'un des choix valides de la liste. Si possible, utilisez la liste de valeurs pour être certain que votre choix est valide.


REP-0636 : <nom de la propriété> ne doit pas dépasser <nombre> caractère(s). Il sera tronqué.

Cause :	Vous avez indiqué une chaîne trop longue. Elle sera tronquée.
Action :	Indiquez une chaîne plus courte.


REP-0637 : <nom de la propriété> ne doit pas dépasser <nombre> caractère(s). Veuillez recommencer.

Cause :	Vous avez indiqué un nom de fichier trop long.
Action :	Indiquez un nom de fichier plus court.


REP-0640 : Source de champ erronée. Reportez-vous à la liste de valeurs.

Cause :	Vous avez entré une valeur erronée dans le paramètre Source du champ.
Action :	Sélectionnez l'une des valeurs de la liste de valeurs.


REP-0650 : Groupe de sources erroné. Reportez-vous à la liste de valeurs.

Cause :	Le nom de groupe que vous avez entré dans Source, pour l'encadrement itératif, n'est pas valide.
Action :	Sélectionnez l'une des valeurs de la liste de valeurs.


REP-0651 : Orientation d'impression non valide. Reportez-vous à la liste de valeurs.

Cause :	La valeur que vous avez entrée pour Orientation d'impression n'est pas l'une des valeurs valides (En diagonale, Diag/Bas, Vers le bas,  Bas/diag et Matricel).
Action :	Sélectionnez l'une des valeurs de la liste de valeurs.


REP-0652 : Espacement vertical erroné.

Cause :	Vous n'avez pas entré de valeur numérique pour le champ Espacement vertical et vous avez tenté de sortir du champ ou d'accepter la palette de propriétés Encadrement itératif.
Action :	Entrez zéro ou un entier positif pour Espacement vertical.


REP-0653 : Espacement horizontal erroné.

Cause :	Vous n'avez pas entré de valeur numérique pour le champ Espacement horizontal et vous avez tenté de sortir du champ ou d'accepter la palette de propriétés Encadrement itératif.
Action :	Entrez zéro ou un entier positif pour Espacement horizontal.


REP-0654 : Valeur erronée pour le nombre maximum d'enregistrements par page.

Cause :	Vous n'avez pas entré de valeur numérique ou de blanc pour Nombre maximum d'enregistrements par page et vous avez tenté de sortir du champ ou d'accepter la palette de propriétés Encadrement itératif.
Action :	Entrez un blanc ou un nombre entier positif pour Nombre maximum d'enregistrements par page.


REP-0655 : Valeur erronée pour le nombre minimum d'enreg. affichables.

Cause :	Vous n'avez pas entré de valeur numérique ou de blanc pour Nombre minimum d'enregistrements affichables et vous avez tenté de sortir du champ ou d'accepter la palette de propriétés Encadrement itératif.
Action :	Entrez un blanc ou un entier positif pour Nombre minimum d'enregistrements affichables.


REP-0660 : Source bouton invalide. Vous devez sélectionner une colonne.

Cause :	Vous avez sélectionné Colonne multimédia comme source de votre action sur un bouton, mais n'avez ensuite pas indiqué de colonne source ou indiqué une colonne source erronée.
Action :	Assurez-vous que vous avez indiqué une colonne source pour votre action sur un bouton et, dans l'affirmative, assurez-vous qu'elle contient des sons, de la vidéo ou des images.


REP-0661 : Source bouton invalide. Vous devez indiquer un fichier source.

Cause :	Vous avez sélectionné Fichier multimédia comme source de votre action sur un bouton, mais n'avez ensuite pas indiqué de fichier source ou indiqué un fichier source erroné.
Action :	Assurez-vous que vous avez indiqué un fichier source pour votre action sur un bouton et, dans l'affirmative, assurez-vous qu'il contient des sons, de la vidéo ou des images.


REP-0662 : Icône de bouton non valide.

Cause :	Vous avez sélectionné Icône pour représenter un bouton, mais sans indiquer le nom d'une icône valide.
Action :	Entrez le nom d'un fichier d'icône valide dans le champ de texte fourni. Ajoutez toutes les informations nécessaires sur le chemin d'accès.


REP-0670 : Les options correctes sont 'Boîte', 'Graphique', 'Trait' ou 'Texte'.

Cause :	La valeur que vous avez entrée dans Type pour l'objet standard n'est pas l'une des valeurs valides (Boîte, Trait, Graphique ou Texte).
Action :	Sélectionnez un type dans la liste de valeurs.


REP-0671 : Nom de fichier de liaison non valide.

Cause :	Le fichier auquel vous avez tenté de lier l'objet standard n'est pas un fichier valide.
Action :	Ré-entrez le nom de fichier en vous assurant qu'il fait référence à un fichier existant dans le répertoire en cours.


REP-0672 : Valeur erronée pour le nombre minimum de lignes veuves affichables.

Cause :	Vous n'avez pas entré de valeur numérique ou de blanc pour Nbre minim. de lignes veuves dans la palette de propriétés, et vous avez tenté de sortir du champ ou d'accepter la palette de propriétés.
Action :	Entrez un blanc ou un nombre entier positif pour Nbre minim. de lignes veuves.


REP-0680 : Nom d'objet de référence incorrect. Reportez-vous à la liste de valeurs.

Cause :	Le nom d'objet que vous avez entré dans le champ Ancré à de la boîte de dialogue Position d'ancrage n'est pas le nom d'un objet auquel vous pouvez ancrer cet objet. Vous avez tenté d'accepter la boîte de dialogue sans entrer de nom d'objet de référence valide.
Action :	Sélectionnez pour Ancré à un nom d'objet de la liste de valeurs.


REP-0681 : Bord erroné. Reportez-vous à la liste de valeurs.

Cause :	La valeur que vous avez entrée pour Bord n'est pas l'une des valeurs valides (Haut, Gauche, Droite et Bas). Vous avez tenté de sortir du champ Bord Père ou Bord Objet sans entrer de bord d'ancrage valide.
Action :	Sélectionnez dans la liste de valeurs une valeur de bord père ou de bord d'objet.


REP-0682 : Le point d'ancrage doit correspondre à un pourcentage compris entre 0 et 100.

Cause :	Le pourcentage (%) que vous avez entré n'est pas compris dans la plage des valeurs valides (0 à 100). Vous avez tenté d'accepter la boîte de dialogue ou de passer à un autre champ sans entrer de pourcentage valide.
Action :	Entrez un pourcentage valide.


REP-0690 : Numéro de page de départ erroné.

Cause :	Vous n'avez pas rempli le champ Commencer à. Vous avez tenté de sortir du champ Commencer à ou d'accepter la boîte de dialogue Numérotation de page, sans entrer de valeur pour Commencer à.
Action :	Entrez zéro ou un nombre entier positif dans le champ Commencer à.


REP-0691 : Incrément de page erroné.

Cause :	Vous n'avez pas rempli le champ Augmenter de. Vous avez tenté de sortir du champ Augmenter de ou d'accepter la boîte de dialogue Numérotation de page, sans entrer de valeur pour Augmenter de.
Action :	Entrez zéro ou un nombre entier positif dans le champ Augmenter de.


REP-0692 : Réinitialisation de pagination erronée.

Cause :	Vous n'avez pas rempli le champ Remise à. Vous avez tenté de sortir du champ Remise à ou d'accepter la boîte de dialogue Numérotation de page, sans entrer de valeur pour Remise à.
Action :	Sélectionnez un nom d'encadrement itératif ou & Etat dans la liste de valeurs, pour indiquer l'endroit où vous voulez que la numérotation de page reprenne.


REP-0700 : Couleur erronée. Reportez-vous à la liste de valeurs.

Cause :	La couleur que vous avez entrée dans le champ n'est pas une option valide.
Action :	Sélectionnez une couleur dans la liste de valeurs.


REP-0701 : Motif erroné. Reportez-vous à la liste de valeurs.

Cause :	Le motif que vous avez entré dans le champ n'est pas une option valide.
Action :	Sélectionnez un motif dans la liste de valeurs.


REP-0702 : Largeur de plume erronée.

Cause :	La valeur que vous avez entrée comme largeur de plume n'est pas valide.
Action :	Sélectionnez une largeur de plume dans la liste de valeurs.


REP-0703 : Police de caractères erronée. Reportez-vous à la liste de valeurs.

Cause :	La police des caractères que vous avez entrée n'est pas une option valide.
Action :	Sélectionnez une police de caractères dans la liste de valeurs.


REP-0704 : Style de texte erroné. Reportez-vous à la liste de valeurs.

Cause :	Le style de texte que vous avez entré n'est pas valide.
Action :	Sélectionnez un style de texte dans la liste de valeurs.


REP-0705 : Epaisseur de texte erronée. Reportez-vous à la liste de valeurs.

Cause :	L'épaisseur de texte que vous avez entrée n'est pas valide.
Action :	Sélectionnez une épaisseur de texte dans la liste de valeurs.


REP-0706 : Taille de texte erronée.

Cause :	La taille de texte que vous avez entrée n'est pas une option valide.
Action :	Sélectionnez une taille de texte valide dans la liste de valeurs.


REP-0707 : Espacement de texte erroné.

Cause :	La valeur d'espacement que vous avez entrée n'est pas comprise dans la plage valide.
Action :	Entrez une valeur contenue dans cette plage.


REP-0708 : Attribut mode de caractères erroné. Reportez-vous à la liste de valeurs.

Cause :	La valeur que vous avez entrée dans ce champ n'est pas valide. Les valeurs que vous entrez dans Attribut de mode de caractères doivent figurer dans votre définition d'imprimante ou de Terminal Oracle. (Pour que ces attributs apparaissent dans la liste de valeurs, vous devez également les entrer dans VISUAL_PREFS, dans le fichier de préférences.)
Action :	Sélectionnez des valeurs dans la liste de valeurs. Si la valeur qui vous intéresse ne figure pas dans la liste, reportez-vous à votre définition d'imprimante ou de Terminal Oracle pour savoir si elle est valide.


REP-0709 : 'Sysout' est correct uniquement en mode traitement par lots (batch).

Cause :	Vous avez entré Sysout comme type de destination alors que vous n'exécutiez pas l'état en mode de traitement par lots. Causes possibles :
	Cas 1 :	Vous avez entré Sysout pour DESTYPE dans la Grille de paramètres d'exécution.
	Cas 2 :	Vous avez entré Sysout pour Valeur initiale de DESTYPE et vous l'avez acceptée alors que vos opérations ne s'exécutaient pas en mode Traitement par lots. Vous pourriez l'avoir acceptée sans savoir si la préférence Masquer grille de paramètres était cochée.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Exécutez à nouveau l'état, mais entrez pour DESTYPE une valeur autre que Sysout à moins que l'état ne s'exécute en mode Traitement par lots.
	Cas 2 :	Modifiez la valeur initiale de DESTYPE ou remplacez DESTYPE par une valeur autre que Sysout dans la Grille de paramètre d'exécution. Si vous conservez Sysout , vous devrez exécuter votre état en mode Traitement par lots avec Masquer grille de paramètres cochée.


REP-0710 : Le fichier de description de l'imprimante est introuvable.

Cause :	Report Builder n'a pas pu trouver le fichier de description de l'imprimante que vous avez indiqué pour DESFORMAT.
Action :	Indiquez un fichier de description d'imprimante valide pour DESFORMAT (par exemple, dflt).


REP-0711 : Type de destination lors d'une impression à partir de l'aperçu : 'file', 'printer' ou 'mail'.

Cause :	Vous avez appuyé sur le bouton Imprimer dans l'Aperçu interactif alors que DESTYPE était limité à une valeur autre que File, Printer ou Mail.
Action :	Avant de tenter une impression à partir de l'Aperçu interactif, assurez-vous que DESTYPE peut avoir l'une des valeurs ci-dessus.


REP-0712 : Aucune imprimante indiquée.

Cause :	Vous avez tenté d'imprimer un état sans indiquer de nom d'imprimante dans DESNAME ou dans la boîte de dialogue de choix d'imprimante.
Action :	Indiquez un nom d'imprimante valide dans DESNAME. Si vous utilisez souvent la même imprimante, entrez son nom dans la boîte de dialogue de choix d'imprimante. N'oubliez pas que si vous entrez un nom d'imprimante dans DESFORMAT, il remplacera le nom d'imprimante défini dans la boîte de dialogue de choix d'imprimante.


REP-0713 : Nom d'imprimante '<nom>' incorrect indiqué par paramètre <nom du paramètre>.

Cause :	Vous avez tenté d'imprimer un état sans indiquer de nom d'imprimante valide dans DESFORMAT (si DESTYPE avait la valeur File ou Mail) ou DESNAME (si DESTYPE avait la valeur Printer).
Action :	Indiquez un nom d'imprimante valide pour DESFORMAT si DESTYPE avait la valeur File ou Mail, ou un nom d'imprimante valide pour DESNAME si DESTYPE avait la valeur Printer.


REP-0714 : Destination d'envoi erronée.

Cause :	Vous avez tenté d'envoyer la sortie de l'état à un autre utilisateur, sans indiquer, pour DESNAME, un nom d'utilisateur valide.
Action :	Indiquez un nom d'utilisateur valide pour DESNAME.


REP-0715 : Vous devez indiquer un nom de fichier trace lors de l'opération de trace.

Cause :	Vous avez indiqué un mode de trace et/ou des options de trace, sans indiquer de fichier trace.
Action :	Indiquez un fichier trace.


REP-0716 : Option invalide indiquée pour la trace.

Cause :	Vous avez indiqué des options de trace erronées.
Action :	Ré-entrez vos options de trace. Pour plus d'informations, reportez-vous à TRACEOPTS.


REP-0717 : Impossible d'activer/désactiver des options hors opération de trace.

Cause :	Vous avez tenté d'indiquer ou d'annuler des options de trace, alors qu'aucune opération de trace n'était en cours.
Action :	Commencez le traçage avant de tenter de définir ou d'annuler des options.


REP-0718 : Impossible de suivre pas à pas les informations de ventilation en mode runtime.

Cause :	Vous avez tenté de suivre pas à pas les informations de ventilation lorsque vous exécutiez l'état en mode runtime.
Action :	N'indiquez pas l'option Ventilation lorsque vous exécutez un état en mode runtime.


REP-0719 : Impossible d'écrire dans le fichier trace '<nom du fichier >'.

Cause :	Vous avez indiqué un fichier trace dans lequel vous n'avez pas le droit d'écrire.
Action :	Assurez-vous que le nom du fichier trace est valide.


REP-0720 : Encadrement itératif non valide. Reportez-vous à la liste de valeurs.

Cause :	L'encadrement itératif que vous avez indiqué comme Encadrement vertical ou horizontal dans la palette de propriétés Matrice n'est pas valide. Vous avez tenté de sortir du champ Encadrement vertical ou horizontal sans indiquer d'encadrement itératif valide.
Action :	Sélectionnez dans la liste de valeurs un nom d'encadrement itératif.


REP-0721 : Groupe inter-produit non valide. Reportez-vous à la liste de valeurs.

Cause :	Le groupe que vous avez entré comme Groupe inter-produit dans la palette de propriétés Matrice est erroné.
Action :	Sélectionnez un nom de groupe dans la liste de valeurs.


REP-0724 : Impossible d'extraire la valeur de la colonne '<nom de la colonne>' ici.

Cause :	Vous avez tenté d'extraire la valeur de la colonne indiquée en entrant une commande dans la ligne de commande de l'Interpréteur PL/SQL ou en exécutant une unité de programme PL/SQL autonome. Vous ne pouvez extraire une valeur de colonne que pendant l'exécution d'un état.
Action :	Ne tentez pas d'utiliser l'Interpréteur PL/SQL ou une unité de programme PL/SQL pour extraire la valeur d'une colonne lorsque l'exécution de l'état est interrompue (par exemple, à un point d'interruption). Utilisez une autre méthode, par exemple un déclencheur de niveau état, pour extraire la valeur de la colonne.


REP-0725 : Impossible de définir la valeur de la colonne '<nom de la colonne>' ici.

Cause :	Vous avez tenté de définir la valeur de la colonne indiquée en entrant une commande dans la ligne de commande de l'Interpréteur PL/SQL ou en exécutant une unité de programme PL/SQL autonome. Vous ne pouvez définir une valeur de colonne que pendant l'exécution d'un état.
Action :	Ne tentez pas d'utiliser l'Interpréteur PL/SQL ou une unité de programme PL/SQL pour définir la valeur d'une colonne lorsque l'exécution de l'état est interrompue (par exemple, à un point d'interruption). Utilisez une autre méthode, par exemple un déclencheur de niveau état, pour extraire la valeur de la colonne.


REP-0726 : Impossible d'extraire la valeur du paramètre '<nom du paramètre>' ici.

Cause :	Vous avez tenté d'extraire la valeur du paramètre indiqué en entrant une commande dans la ligne de commande de l'Interpréteur PL/SQL ou en exécutant une unité de programme PL/SQL autonome. Vous ne pouvez exécuter une valeur de paramètre que pendant l'exécution d'une grille de paramètres.
Action :	Ne tentez pas d'utiliser l'Interpréteur PL/SQL ou une unité de programme PL/SQL pour extraire la valeur d'un paramètre lorsque l'exécution d'une grille de paramètres est interrompue (par exemple, à un point d'interruption). Utilisez une autre méthode, par exemple un déclencheur de niveau état, pour extraire la valeur du paramètre.


REP-0727 : Impossible de définir la valeur du paramètre '<nom du paramètre>' ici.

Cause :	Vous avez tenté de définir la valeur du paramètre indiqué en entrant une commande dans la ligne de commande de l'Interpréteur PL/SQL ou en exécutant une unité de programme PL/SQL autonome. Vous ne pouvez définir une valeur de paramètre que pendant l'exécution d'une grille de paramètres.
Action :	Ne tentez pas d'utiliser l'Interpréteur PL/SQL ou une unité de programme PL/SQL pour définir la valeur d'un paramètre lorsque l'exécution d'une grille de paramètres est interrompue (par exemple, à un point d'interruption). Utilisez une autre méthode, par exemple un déclencheur de niveau état, pour extraire la valeur du paramètre.


REP-0728 : Colonne '<nom de la colonne>' ne doit pas être référencée par déclencheurs de paramètres.

Cause :	Vous avez tenté de référencer une colonne dans un déclencheur lié à un paramètre (Before Form, After Form, Validation), ce qui est interdit.
Action :	Supprimez la ou les références du ou des déclencheurs liés au paramètre et ajoutez-les au déclencheur Before Report.


REP-0729 : Unité de programme '<nom de l'unité de programme>' de '<nombre>' octets trop grande pour être chargée sur la plate-forme courante qui est limitée à '<limite>'.
REP-0729 : Unité de programme '<nom de l'unité de programme>' de '<nombre>' octets, trop grande pour être chargée sur la plate-forme courante qui est limitée à '<limite>'.

Cause :	Votre unité de programme, créée sur une autre plate-forme d'exploitation, est trop volumineuse pour être chargée dans la plate-forme d'exploitation en cours.
Action :	Diminuez la taille de l'unité de programme PL/SQL que vous tentez de charger.


REP-0730 : La variable de lien suivante n'est pas définie.

Cause :	Vous avez fait une référence de lien à un paramètre ou à une colonne non encore définis. Vous devez commencer par définir le paramètre ou la colonne avant d'y faire une référence de lien.
Action :	Créez une définition de colonne ou de paramètre pour l'objet que vous voulez référencer. Vous pouvez également, si possible, tenter d'utiliser une référence lexicale à la place d'une référence de liaison.


REP-0732 : Erreur lors de la destruction de l'unité de programme.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0733 : Ce nom existe déjà. Veuillez choisir un autre nom.

Cause :	Vous avez tenté de créer un sous-programme PL/SQL dont le nom est identique à celui d'un sous-programme stocké dans l'état.
Action :	Renommez le nouveau sous-programme de façon à éviter les conflits avec des sous-programmes existants.


REP-0734 : Aucun argument autorisé. Supprimez-le.

Cause :	Vous avez entré une procédure ou une fonction PL/SQL demandant des arguments dans un champ PL/SQL qui n'autorise pas les procédures PL/SQL avec arguments - par exemple, dans un champ Déclencheur de format, un champ Formule ou comme filtre de groupe.
Action :	Supprimez le ou les arguments de la source PL/SQL.


REP-0735 : Chargement impossible de l'unité de prog. DE : essai de chargement du texte source PL/SQL. Connexion obligatoire à une base.

Cause :	Report Builder n'a pas pu charger la totalité de l'unité de programme. Il est possible que cette unité fasse référence à un ou plusieurs objets stockés dans la base de données, mais ces objets sont introuvables.
Action :	Assurez-vous que vous êtes connecté à la base de données voulue. Assurez-vous également que votre unité de programme fait les références nécessaires.


REP-0736 : Il existe des unités de programme non compilées.

Cause :	Vous avez tenté de convertir un état, ou de charger un ancien état, contenant une procédure PL/SQL qui doit être recompilée.
Action :	Changez l'état en utilisant RWBLD60 et modifiez l'unité ou les unités de programme DE.


REP-0737 : Doit être une fonction avec un type retour '<type retour>'.

Cause :	Vous avez entré une fonction PL/SQL qui n'a pas le type de retour approprié.
Action :	Remplacez le type de retour de la fonction par l'un de ceux indiqués dans le message.


REP-0738 : Fonction seule autorisée ici.

Cause :	Vous avez entré une information autre qu'une fonction, alors que le programme attendait une fonction.
Action :	Entrez une fonction.


REP-0739 : Impossible d'exécuter une procédure PL/SQL compilée sur une autre plate-forme.

Cause :	Vous avez tenté d'exécuter un état sur une plate-forme différente de celle sur laquelle la procédure PL/SQL de l'état avait été compilée. Comme l'état ne contient pas la source PL/SQL, Report Builder n'a pas pu recompiler la procédure PL/SQL sur la plate-forme en cours.
Action :	Exécutez l'état sur la plate-forme sur laquelle la procédure PL/SQL a été compilée. Vous pouvez également extraire une copie de l'état source comprenant la source PL/SQL et la recompiler sur la plate-forme en cours.


REP-0740 : Un point d'ancrage ne peut être associé à un autre objet.

Cause :	Vous avez tenté d'associer un point d'ancrage à un autre objet de présentation, ou d'associer un objet de présentation à un point d'ancrage.
Action :	Les points d'ancrage ne peuvent pas être associés à d'autres objets de présentation.


REP-0741 : Une matrice ne peut être associée à un autre objet.

Cause :	Vous avez tenté d'associer à l'objet de matrice un autre objet de présentation, ou d'associer un objet de présentation à un objet de matrice.
Action :	Les objets de matrice ne peuvent pas être associés à d'autres objets de présentation.


REP-0742 : Une marge ne peut être associée à un autre objet.

Cause :	Vous avez tenté d'associer la marge à un objet de présentation, ou d'associer un objet de présentation à la marge.
Action :	La marge ne peut pas être associée à des objets de présentation.


REP-0743 : L'encadrement itératif d'une matrice ne peut être associé à un autre objet.

Cause :	Vous avez tenté d'associer un encadrement itératif de matrice dont l'Orientation d'impression est Vers le bas ou De gauche à droite à un autre objet de présentation.
Action :	Les encadrements itératifs de matrice dont l'Orientation d'impression est Vers le bas ou De gauche à droite ne peuvent pas être associés à d'autres objets de présentation.


REP-0744 : Les objets père et fils d'un point d'ancrage doivent être différents.

Cause :	Vous avez tenté de créer un point d'ancrage dont les objets père et fils sont identiques - c'est-à-dire que vous avez tenté d'associer un objet à lui-même.
Action :	Vous ne pouvez pas associer un objet à lui-même. Les points d'ancrage doivent avoir des objets père et fils différents.


REP-0745 : Un objet ne peut pas être associé par point d'ancrage plus d'une fois.

Cause :	Vous avez tenté de créer deux points d'ancrage entre deux objets de présentation identiques.
Action :	Vous ne pouvez créer qu'un point d'ancrage entre deux objets de présentation identiques.


REP-0746 : La procédure PL/SQL référence un objet qui n'existe pas.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0747 : Un déclencheur Before Form ne peut pas référencer une colonne d'un état.

Cause :	Le déclencheur Before Form de l'état fait référence à une colonne de l'état. Vous ne pouvez pas utiliser le déclencheur Before Form pour faire référence à des colonnes.
Action :	Supprimez les références de colonne du déclencheur Before Form. (Si vous devez définir la valeur d'une colonne, faites-le à partir du déclencheur Before Report.)


REP-0748 : Un déclencheur de paramètre ne peut pas référencer une colonne d'un état.

Cause :	Un déclencheur de validation de paramètres fait référence à une ou plusieurs colonnes de l'état. Vous ne pouvez pas faire référence à des colonnes à partir d'un déclencheur de validation.
Action :	Supprimez les références de colonne du déclencheur de validation de la palette de propriétés Paramètre.


REP-0749 : Un déclencheur After Form ne peut pas référencer une colonne d'un état.

Cause :	Le déclencheur After Form de l'état fait référence à une colonne de l'état. Vous ne pouvez pas utiliser le déclencheur After Form pour faire référence à des colonnes.
Action :	Supprimez les références de colonne du déclencheur After Form. (Si vous devez définir la valeur d'une colonne, faites-le à partir du déclencheur Before Report.)


REP-0750 : Erreur lors de la fermeture de la bibliothèque PL/SQL.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0751 : Erreur lors de l'accès aux unités de programme à partir de la bibliothèque PL/SQL.

Cause :	Condition anormale. Si vous avez modifié votre bibliothèque PL/SQL, vous devez sélectionner Fichier [image] Enregistrer sous... et l'enregistrer sous un nom différent.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0752 : Impossible d'enregistrer la bibliothèque PL/SQL.

Cause :	Condition anormale. Si vous avez modifié votre bibliothèque PL/SQL, vous devez sélectionner Fichier [image] Enregistrer sous... et l'enregistrer sous un nom différent.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0753 : Erreur lors du rattachement de la bibliothèque PL/SQL '<nom de la bibliothèque>'.

Cause :	Vous avez tenté de rattacher une bibliothèque PL/SQL erronée. Il est possible que la bibliothèque soit altérée, ou que le fichier ou l'objet dont vous avez indiqué le nom ne contienne pas de bibliothèque PL/SQL.
Action :	Assurez-vous que le fichier ou l'objet dont vous avez indiqué le nom contient une bibliothèque PL/SQL valide.


REP-0754 : Erreur lors de l'insertion des unités de programme dans la bibliothèque PL/SQL.

Cause :	Vous avez tenté d'enregistrer une unité de programme dans une bibliothèque PL/SQL altérée, ou un fichier ou un objet qui n'est pas une bibliothèque PL/SQL.
Action :	Assurez-vous que le fichier ou l'objet dont vous avez indiqué le nom contient une bibliothèque PL/SQL valide. Utilisez Fichier [image] Enregistrer sous pour enregistrer l'unité de programme en cours.


REP-0755 : Erreur lors de l'ouverture de la bibliothèque PL/SQL '<nom de la bibliothèque>'.

Cause :	Vous avez tenté d'ouvrir une bibliothèque PL/SQL altérée, ou un fichier ou un objet autre qu'une bibliothèque PL/SQL.
Action :	Assurez-vous que le fichier ou l'objet que vous avez tenté d'ouvrir contient une bibliothèque PL/SQL valide.


REP-0756 : Avertissement ! Bibliothèque PL/SQL '<nom de la bibliothèque>' introuvable.

Cause :	Vous avez tenté d'attacher une bibliothèque PL/SQL qui n'existe pas, ou d'ouvrir un état auquel était attachée une ou plusieurs bibliothèques PL/SQL, mais qui étaient introuvables.
Action :	Assurez-vous que le fichier ou l'objet que vous voulez attacher existe. Si vous avez ouvert un état, attachez de nouveau la bibliothèque PL/SQL.


REP-0757 : Impossible de créer spéc. d'emplacement externe.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0758 : Bibliothèque PL/SQL '<nom de la bibliothèque>' déjà en cours d'utilisation.

Cause :	Vous avez tenté d'attacher une bibliothèque PL/SQL qui a le même nom qu'une autre bibliothèque PL/SQL déjà attachée. Ce problème peut se poser si vous avez renommé un fichier contenant une bibliothèque PL/SQL, alors que le nom interne reconnu par Report Builder n'a pas été modifié.
Action :	Utilisez Fichier [image] Enregistrer sous pour enregistrer la bibliothèque PL/SQL sous un autre nom.


REP-0759 : Une ou plusieurs bibliothèques PL/SQL ont été modifiées depuis le dernier enreg. de l'état. Recompilation de PL/SQL.

Cause :	Vous avez tenté d'ouvrir ou d'exécuter un état qui fait référence à une ou plusieurs bibliothèques PL/SQL, alors qu'une partie ou la totalité du PL/SQL a été modifiée, mais n'a pas été compilée depuis votre dernier enregistrement de l'état.
Action :	Aucune. Report Builder recompilera automatiquement PL/SQL.


REP-0760 : Vous vous trouvez dans la session d'impression de document.

Cause :	Vous avez déjà sélectionné Fichier [image] Administration [image] Etat de définitions d'état pour produire un état sur un ou plusieurs états.
Action :	Terminez la production de l'état sur les états, puis sélectionnez à nouveau Fichier [image] Administration [image] Etat de définitions d'état pour exécuter un autre état sur les états.


REP-0761 : Impossible d'ouvrir le fichier de ressources pour l'impression de l'état.

Cause :	Report Builder ne peut pas trouver les états (expédiés avec Report Builder) qui documentent vos états.
Action :	Assurez-vous que les états qui documentent d'autres états (expédiés avec Report Builder) se trouvent bien dans le répertoire approprié.


REP-0762 : Id utilisateur erroné pour connexion inter-bureau.

Cause :	Vous avez essayé d'enregistrer la sortie de l'état dans Interoffice, mais vous n'avez pas indiqué de chaîne de connexion valide pour le serveur de documents Interoffice.
Action :	Indiquez une chaîne de connexion valide pour le serveur de documents Interoffice.


REP-0763 : Echec de lancement du client inter-bureau $0.

Cause :	Vous avez essayé de lancer le client Interoffice, mais son démarrage a échoué pour une raison quelconque.
Action :	Vérifiez que le client Interoffice est installé correctement.


REP-0764 : Une erreur s'est produite au cours de l'exécution du client inter-bureau. Code d'erreur : $0.

Cause :	Vous avez utilisé le client Interoffice pour rechercher des documents, mais il a échoué sur le code d'erreur ci-dessus.
Action :	Reportez-vous au code ou au message d'erreur Interoffice pour connaître la raison de l'échec.


REP-769 : Vous ne pouvez pas passer à mail à partir de la grille de paramètres lorsque l'aperçu interactif est ouvert.

Cause :	L'Aperçu interactif est ouvert et le type de destination (DESTYPE) est défini à Mail.
Action :	Choisissez Mail directement à partir de l'Aperçu interactif, pas à partir de la Grille de paramètres d'exécution.


REP-0770 : Echec du déclencheur Before Form.

Cause :	Le déclencheur Before Form de votre état a retourné la valeur False.
Action :	Apportez les modifications voulues (dans la source PL/SQL dans le déclencheur Before Form ou dans l'état) pour que le déclencheur retourne la valeur True.


REP-0771 : Echec du déclencheur After Form.

Cause :	Le déclencheur After Form de votre état a retourné la valeur False.
Action :	Apportez les modifications voulues (dans la source PL/SQL dans le déclencheur After Form ou dans l'état) pour que le déclencheur retourne la valeur True.


REP-0772 : Les champs de la grille de paramètres '<nom du champ 1>' et '<nom du champ 2>' ne doivent pas comprendre la même source.

Cause :	Vous avez indiqué la même source pour deux champs de grille de paramètres. Les champs de grille de paramètres d'exécution doivent avoir des sources uniques.
Action :	Changez la source de l'un des champs.


REP-0773 : Pas de source indiquée dans le champ '<nom du champ>' de la grille de paramètres.

Cause :	Vous n'avez pas indiqué de source dans un champ de grille de paramètres, ou le paramètre de source a été supprimé du modèle de données. Les champs de la grille de paramètres d'exécution doivent avoir une source.
Action :	Indiquez dans le champ de grille de paramètres une source valide.


REP-0774 : Avertissement ! Aucune valeur ne peut être sélectionnée pour le paramètre LOV <nom du paramètre>.

Cause :	Vous n'avez pas indiqué de valeurs pour la liste de sélection des paramètres de la LOV, ou vous avez indiqué des valeurs qui ne peuvent pas être sélectionnées.
Action :	Vérifiez l'instruction SELECT ou assurez-vous que la liste des valeurs sélectionnables pour le paramètre contient des valeurs sélectionnables. Pour plus d'informations sur les paramètres LOV, reportez-vous à Propriétés de paramètre.


REP-0775 : Avertissement ! Le type de données de la 1re colonne de l'instruc. Select ne correspond pas au type donnée du param LOV <nom du paramètre>.

Cause :	Le type de données de la première colonne, que vous avez indiqué dans votre instruction SELECT, ne correspond pas au type de données que vous avez indiqué pour votre paramètre LOV.
Action :	Vérifiez le type de données du paramètre LOV, l'instruction SELECT et les colonnes des tables de base de données auxquelles l'instruction SELECT a accédé pour vous assurer qu'ils correspondent.


REP-0776 : Avertissement ! Présence de colonnes avec valeurs dans mémoire segmentée lors du remplissage du param LOV <nom du paramètre>. Seront ignorés.

Cause :	Vous avez sélectionné, pour la liste de sélection de votre paramètre LOV, des colonnes comportant des valeurs dans la mémoire segmentée, ce qui est interdit.
Action :	Sélectionnez d'autres colonnes ou déplacez les valeurs des colonnes.


REP-0777 : Avertissement ! Présence de colonnes dont le type ne peut être traité lors du chargement du param LOV <nom du paramètre>. Seront ignorées.

Cause :	Vous avez sélectionné des colonnes dont les types ne peuvent pas être traités (par exemple, des données binaires).
Action :	Sélectionnez des colonnes différentes.


REP-0778 : Avertissement ! Colonnes non formatées correctement lors du chargement du param LOV <nom du paramètre>. Elles ne seront pas prises en compte.

Cause :	L'instruction SELECT de sélection de valeurs  pour la LOV de votre paramètre extrait des colonnes dont les valeurs ne peuvent pas être formatées en fonction de leur type de données.
Action :	Convertissez les valeurs en valeurs valides ou vérifiez, dans la base de données, si les valeurs des colonnes sont valides.


REP-0779 : Avertissement ! Certains éléments du paramètre LOV <nom du paramètre> sont trop longs. Ils sont tronqués.

Cause :	Vous avez indiqué des éléments ou sélectionné des colonnes contenant des valeurs trop longues pour la liste de sélection de votre paramètre LOV.
Action :	Vérifiez les valeurs des éléments et diminuez leur longueur, si nécessaire.


REP-0780 : La valeur initiale entrée est erronée par rapport au masque de saisie '<masque de saisie>'.

Cause :	La valeur que vous avez entrée dans le champ Valeur initiale ne correspond pas au masque que vous avez indiqué dans le champ Masque de saisie.
Action :	Entrez une valeur différente dans le champ Valeur initiale ou changez le masque dans le champ Masque de saisie.


REP-0781 : Variables de liaison non autorisées dans l'instruction Select.

Cause :	Vous avez inclus des variables de lien dans votre instruction SELECT.
Action :	Supprimez les variables de lien de votre instruction SELECT.


REP-0782 : Le type de données du paramètre ne correspond pas au type de données de la colonne source.

Cause :	Vous avez sélectionné une colonne ayant un type de données erroné pour fournir des valeurs pour la liste de sélection de votre paramètre LOV.
Action :	Changez le type des données de la colonne ou indiquez une colonne différente.


REP-0783 : Listes de valeurs possible : syntaxe incorrecte.
REP-0783 : Liste de valeurs possible : syntaxe incorrecte.

Cause :	Vous avez commis une erreur de syntaxe lorsque vous avez créé la liste des valeurs possibles pour votre paramètre LOV.
Action :	Editez la liste des valeurs possibles pour vous assurer que ses différents éléments sont bien séparés par des virgules.


REP-0784 : Valeur possible : largeur incorrecte
REP-0784 : Valeur possible : largeur incorrecte.

Cause :	Une valeur que vous avez indiquée pour la liste des valeurs possibles pour votre paramètre LOV comporte une largeur erronée.
Action :	Editez la liste des valeurs possibles afin que toutes les valeurs possibles aient des largeurs valides, ou modifiez la largeur.


REP-0785 : Valeur possible non valide par rapport au masque de saisie.

Cause :	L'une des valeurs que vous avez indiquées pour la liste des valeurs possibles pour votre paramètre LOV n'est pas formatée selon le masque de saisie indiqué.
Action :	Editez la liste des valeurs possibles pour vous assurer qu'elles sont toutes valides par rapport au masque de saisie.


REP-0786 : Valeur initiale absente de valeurs possibles.

Cause :	La valeur initiale que vous avez indiquée pour votre paramètre LOV ne figure pas dans la liste des valeurs possibles.
Action :	Ajoutez à la liste des valeurs possibles la valeur initiale que vous avez indiquée.


REP-0787 : Avertissement ! Nom de 1re colonne de l'instr. Select du param LOV '<nom du paramètre>' diffère selon qu'il est Runtime ou Designer.

Cause :	Il y a une différence entre la ou les colonnes que vous avez indiquées dans votre instruction SELECT d'origine et le contenu de la ou des tables en question.
Action :	Reportez-vous à la base de données pour savoir si les tables en question ont été mises à jour depuis la création de la liste des paramètres, ou réappliquez l'instruction SELECT du paramètre LOV.


REP-0788 : Avertissement ! Valeur du paramètre LOV restreint <nom du paramètre> absente des valeurs sélectionnables.

Cause :	Vous avez indiqué, pour un paramètre LOV, une valeur qui ne figure pas dans la liste de sélection du paramètre.
Action :	Choisissez une valeur dans la liste de sélection du paramètre.


REP-0790 : Largeur et Hauteur de page doivent être toutes deux renseignées ou non renseignées.

Cause :	Vous avez laissé en blanc le champ Largeur de page ou Hauteur de page de l'onglet Paramètres d'exécution de la boîte de dialogue Options outils. Ces deux champs doivent contenir une valeur valide ou être laissés en blanc.
Action :	Indiquez une valeur valide pour le paramètre laissé en blanc, ou laissez en blanc les deux paramètres.


REP-0800 : Vous pouvez seulement sélectionner tout dans un champ texte modifiable.

Cause :	Vous avez sélectionné Edition [image] Sélectionner tout alors que le curseur se trouvait sur un élément d'une palette de propriétés autre qu'un champ texte.
Action :	Dans une palette de propriétés, Edition [image] Sélectionner tout n'est valide que dans un champ texte.


REP-0801 : Le canevas de présentation doit être assez grand pour contenir tous les objets de présentation.

Cause :	Vous avez diminué la taille de la région de coloriage de l'Editeur de modèle de présentation en modifiant une ou plusieurs définitions de la boîte de dialogue Propriétés d'état ou en redimensionnant la marge, mais la région de coloriage redimensionnée n'est pas suffisamment grande pour contenir tous les objets de présentation.
Action :	Assurez-vous que tous les objets de présentation des sections corps, marge, page de garde et page de fin de votre état tiennent dans la région redimensionnée.


REP-0802 : Le canevas grille de paramètres doit être assez grand pour contenir tous les objets de la grille.

Cause :	Vous avez diminué la taille de la région de coloriage de l'Editeur de grille de paramètres en modifiant une ou plusieurs définitions de la boîte de dialogue Propriétés d'état, mais la région de coloriage redimensionnée ne peut pas contenir tous les objets de la grille de paramètres.
Action :	Assurez-vous que tous les objets de la grille de paramètres tiennent dans la région redimensionnée.


REP-0803 : La taille de canevas indiquée est trop grande.

Cause :	Votre état contient une combinaison de définitions de taille de page/grille et soit de page logique, de page de corps, de page de garde, de page de fin, soit de nombre de pages de grille de paramètres donnant une valeur trop élevée pour Report Builder (c'est-à-dire une valeur en dpi supérieure à 2 giga-octets).
Action :	Réduisez la taille de page/grille ou diminuez la valeur de la taille de page logique, des pages de corps, des pages de garde, des pages de fin ou des pages de grille de paramètres.


REP-0804 : Définition d'état modifiée lors de l'exécution courante. Impossible de continuer exécution de la grille param ou état.

Cause :	Dans la grille de paramètres d'exécution, vous avez modifié l'état en utilisant un éditeur ou une palette de propriétés.
Action :	Annulez la grille des paramètres d'exécution et ré-exécutez l'état.


REP-0805 : Initialisation de menus impossible.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0806 : Erreur de lecture des ressources fenêtre.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-0807 : Vous devez saisir la taille de tableau (array size).

Cause :	Dans la boîte de dialogue Paramètres d'exécution, vous avez laissé en blanc le champ Taille de tableau. Ce champ doit être renseigné.
Action :	Entrez une taille de tableau comprise entre 1 et 9999.


REP-0808 : Vous devez saisir la taille du tampon (buffer size).

Cause :	Dans l'onglet Paramètres d'exécution de la boîte de dialogue Options outils, vous avez laissé en blanc le champ Taille de tampon. Ce champ doit être renseigné.
Action :	Entrez une taille de tampon comprise entre 1 et 9999.


REP-0809 : Vous devez saisir la taille Long Chunk.

Cause :	Dans l'onglet Paramètres d'exécution de la boîte de dialogue Options outils, vous avez laissé en blanc le champ Taille Long Chunk. Ce champ doit être renseigné.
Action :	Entrez une taille Long Chunk comprise entre 1 et 9999.


REP-0810 : Options valides : 'Noaction', 'Rollback' ou 'Commit'.

Cause :	Dans la boîte de dialogue Paramètres d'exécution en mode caractère, vous avez choisi une valeur erronée pour Sur succès/Sur échec. Les valeurs valides sont : Noaction, Rollback ou Commit.
Action :	Sélectionnez une valeur valide pour Sur succès/Sur échec.


REP-0811 : Options valides : '<In Report Definition>', 'Screen', 'File', 'Printer' ou 'Mail'.

Cause :	Dans la boîte de dialogue Paramètres d'exécution en mode caractère, vous avez choisi une valeur erronée pour Type de destination. Les valeurs valides sont : <In Report Definition>, Screen, File, Printer ou Mail.
Action :	Sélectionnez une valeur valide pour Type de destination.


REP-0812 : Options valides : '<In Report Definition>', 'Landscape', ou 'Portrait'.
REP-0812 : Options valides : '<In Report Definition>', 'Landscape' ou 'Portrait'.

Cause :	Dans la boîte de dialogue Paramètres d'exécution en mode caractère, vous avez choisi une valeur erronée pour Orientation. Les valeurs valides sont : <In Report Definition>, Landscape ou Portrait.
Action :	Sélectionnez une valeur valide pour Orientation.


REP-0813 : Options valides : '<In Report Definition>', 'Default', 'Bitmap' ou 'Character'.

Cause :	Dans la boîte de dialogue Paramètres d'exécution en mode caractère, vous avez choisi une valeur erronée pour Mode. Les valeurs valides sont : <In Report Definition>, Default, Bitmap ou Character.
Action :	Sélectionnez une valeur valide pour Mode.


REP-0814 : Options valides : '<In Report Definition>', 'Yes' ou 'No'.

Cause :	Dans la boîte de dialogue Paramètres d'exécution en mode caractère, vous avez choisi une valeur erronée pour Arrière-plan. Les valeurs valides sont : <In Report Definition>, Yes ou No.
Action :	Sélectionnez une valeur valide pour Arrière-plan.


REP-0815 : Options valides : 'Landscape' ou 'Portrait'.

Cause :	Dans la grille de paramètres d'exécution en mode caractère, vous avez choisi une valeur erronée pour Orientation. Les valeurs valides sont : Landscape ou Portrait.
Action :	Sélectionnez une valeur valide pour Orientation.


REP-0816 : Options valides : 'Bitmap' ou 'Character'.

Cause :	Dans la grille de paramètres d'exécution en mode caractère, vous avez choisi une valeur erronée pour Mode. Les valeurs valides sont : Bitmap ou Character.
Action :	Sélectionnez une valeur valide pour Mode.


REP-0817 : Options valides : 'Yes' ou 'No'.

Cause :	Dans la grille de paramètres d'exécution en mode caractère, vous avez choisi une valeur erronée pour Arrière-plan. Les valeurs valides sont : Yes ou No.
Action :	Sélectionnez une valeur valide pour Arrière-plan.


REP-0818 : Avertissement ! La hauteur de page a changé pour la grille de param. Les paramètres peuvent être coupés par limites de page.

Cause :	Vous avez modifié la hauteur de grille de paramètres d'exécution dans la palette de propriétés Etat. Report Builder vous indique que ce problème peut entraîner un déplacement de la limite de page, ce qui la fait apparaître au milieu d'un objet de la grille de paramètres.
Action :	Reportez-vous à la présentation de votre grille de paramètres dans l'éditeur de grille de paramètres, et assurez-vous qu'aucun objet ne se trouve directement sur une limite de page (c'est-à-dire sur la ligne sombre de l'éditeur). Vous pouvez également utiliser par défaut la grille de paramètres (ou la redéfinir par défaut).


REP-0819 : Impossible de positionner AUTOCOMMIT ON pour connexion serveur SQL.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales. Vous pouvez également supprimer toutes les instances de SRW.DO_SQL. Si vous pouvez exécuter cette opération en conservant toutes les fonctions nécessaires dans votre état, celui-ci s'exécutera.


REP-0820 : Impossible d'importer l'image indiquée.

Cause :	L'importation d'image que vous avez demandée est impossible.
Action :	Reportez-vous à votre fichier d'images pour vous assurer qu'il contient une image valide et qu'il n'a pas été altéré.


REP-0821 : Impossible d'exporter l'image indiquée
REP-0821 : Impossible d'exporter l'image indiquée.

Cause :	L'exportation d'image que vous avez demandée est impossible.
Action :	Créez ou sélectionnez une image à exporter.


REP-0822 : Aucun dessin importé.

Cause :	L'importation du dessin que vous avez demandée est impossible.
Action :	Reportez-vous à votre fichier de dessin pour vous assurer qu'il contient un dessin valide et qu'il n'a pas été altéré.


REP-0823 : Aucun dessin exporté.

Cause :	L'objet que vous tentez d'exporter sous la forme d'un dessin ne peut pas être exporté comme tel.
Action :	Créez ou sélectionnez un dessin à exporter.


REP-0824 : Dictionnaire de données non dispo ds la base à laquelle vous êtes connecté. Extraction d'infos sur table/col impossible.

Cause :	Vous tentez d'accéder à la boîte de dialogue Noms de table et de colonne alors que le Dictionnaire de données n'est pas disponible dans la base de données à laquelle vous êtes connecté.
Action :	Connectez-vous à une autre base de données.


REP-0825 : Vous êtes connecté à une base de données autre que ORACLE ou DB2. Celle-ci ne peut pas être utilisée pour enregistrer des documents.

Cause :	Vous tentez de stocker un document dans une base de données qui n'est ni ORACLE ni DB2, ce qui est interdit.
Action :	Connectez-vous à une base de données ORACLE ou DB2 ou stockez le document sous la forme d'un fichier.


REP-0828 : Les tables de Report Builder ne sont pas installées dans la base de données. Annulation en cours.

Cause :	Informations n'a pas pu être exécuté car la base de données ne comporte pas de tables Report Builder.
Action :	Signalez à votre administrateur de bases de données que les tables de Report Builder n'ont pas été correctement installées dans la base de données.


REP-0829 : Les tables de base de données de Report Builder semblent correspondre aux tables d'une version antérieure de Report Builder (<Version>). Annulation en cours.

Cause :	Les tables de Report Builder dans la base de données semblent avoir été installées à partir d'une version précédente du produit. Informations ne peut pas être exécuté sur une ancienne version d'état de la base de données
Action :	Indiquez à votre administrateur de bases de données que les tables de Report Builder de cette version n'ont pas été installées correctement dans la base de données.


REP-0830 : Les tables de base de données de Report Builder semblent altérées ou mal installées. Annulation en cours.

Cause :	Informations ne peut pas être exécuté car les tables de Report Builder sont dans un état instable.
Action :	Informez votre administrateur de bases de données que les tables de Report Builder sont soit altérées soit mal installées dans la base de données.


REP-0831 : Génération impossible de l'interrogation.

Cause :	Report Builder n'a pas pu générer l'interrogation prévue au démarrage. Il est probable que le compte de base de données sur lequel l'interrogation a été générée n'est pas correct. Sinon, il s'agit d'une condition anormale.
Action :	Si Report Builder a été lancé à partir d'un autre produit, vérifiez la chaîne de connexion à la base de données dans l'autre produit. Pour toute information sur les conditions anormales, reportez-vous à Conditions anormales.


REP-0900 : Impossible de fermer cet état lorsque PL/SQL est en cours d'exécution.

Cause :	Vous avez tenté de fermer un état pendant l'exécution du PL/SQL associé.
Action :	Finissez d'exécuter le PL/SQL ou interrompez-le, puis fermez l'état.


REP-0901 : Fonction Tables/colonnes non acceptée par ce serveur de base de données.

Cause :	Vous êtes connecté à un serveur de base de données qui n'a pas de Dictionnaire de données accessible pour dresser la liste des tables et des colonnes.
Action :	Aucune. La fonction Tables/colonnes n'existe pas pour ces bases de données.


REP-0910 : Assistants introuvables. Veuillez les réinstaller et recommencer.

Cause :	Vous avez tenté d'exécuter les Assistants, mais ils n'étaient pas installés correctement.
Action :	Réinstallez les Assistants.


REP-0911 : Aperçu produit introuvable. Veuillez le réinstaller et recommencer.

Cause :	Vous avez tenté d'exécuter l'Aperçu produit, mais il était mal installé.
Action :	Réinstallez l'Aperçu produit.


REP-0999 : Cette erreur n'a pas été mise en œuvre.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1010 : Ce nom n'est pas conforme aux standards d'attribution de nom SQL.

Cause :	Le nom que vous avez entré ne respecte pas les conventions d'appellation de SQL.
Action :	Vérifiez les conventions d'appellation de l'objet concerné. Pour plus d'informations, reportez-vous à Conventions d'appellation. Entrez un nom respectant ces conventions.


REP-1011 : Vous devez attribuer un nom à <Type de l'objet>.

Cause :	Vous avez laissé le champ Nom de l'objet en blanc, alors qu'il devait être renseigné.
Action :	Donnez un nom à l'objet en respectant les conventions d'appellation correspondantes. Pour plus d'informations, reportez-vous à Conventions d'appellation.


REP-1012 : Un autre objet <type de l'objet> porte déjà ce nom.
REP-1012 : Un autre <type de l'objet> porte déjà ce nom.

Cause :	Le nom que vous avez entré est le même que celui d'un autre objet du même type.
Action :	Changez le nom d'au moins un des objets.


REP-1013 : Ce nom ne peut être un mot réservé.

Cause :	Vous avez entré pour un paramètre un nom identique à un mot réservé.
Action :	Changez le nom du paramètre afin qu'il soit conforme aux conventions d'appellation. Pour plus d'informations, reportez-vous à Conventions d'appellation.


REP-1014 : Longueur Nom ne peut dépasser 30 octets.

Cause :	Le nom entré avait plus de 30 octets de long. Les noms SQL ne peuvent pas avoir plus de 30 octets de long.
Action :	Indiquez un nom d'un maximum de 30 octets.


REP-1048 : Avertissement ! Propriétaire et Liste d'accès non écrasés.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1049 : Ouverture impossible d'un état enregistré sous une plus récente version de Report Builder.

Cause :	Vous avez tenté d'ouvrir un état avec une version de Report Builder antérieure à celle avec laquelle l'état a été enregistré.
Action :	Pour ouvrir l'état, utilisez la même version de Report Builder ou une version plus récente.


REP-1050 : Impossible d'accéder aux noms de document dans la base de données.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1051 : Impossible d'enregistrer ce document dans le fichier '<nom du fichier>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1052 : Impossible d'enregistrer ce document dans la base de données.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1053 : Impossible d'obtenir un nouvel ID de document à partir de la base de données.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1054 : Suppression impossible à partir de la table '<nom de la table>'.

Cause :	Vous avez tenté, sans succès, d'effectuer une suppression dans une table. Il est possible que vous n'ayez pas les privilèges nécessaires.
Action :	Assurez-vous que vous avez les privilèges nécessaires. Dans le cas contraire, demandez à votre administrateur de bases de données, ou à une autre personne ayant les privilèges nécessaires, d'exécuter l'opération.


REP-1055 : Impossible de verrouiller la table '<nom de la table>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1056 : Impossible de renommer l'objet stocké dans cette base de données.

Cause :	Vous avez tenté, sans succès, de renommer un objet de base de données. Il est possible que vous n'ayez pas les privilèges nécessaires. Pour renommer un objet, vous devez en être propriétaire.
Action :	Si vous n'êtes pas propriétaire de l'objet, vous pouvez soit en faire une copie, soit demander au propriétaire d'en modifier le nom.


REP-1057 : '<nom du fichier>' n'est pas un fichier de Report Builder valide.

Cause :	Vous avez tenté d'accéder à un fichier dont le format n'est pas approprié à Report Builder.
Action :	Assurez-vous que vous accédez au fichier voulu.


REP-1058 : Impossible de lire le document à partir de la base de données.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1059 : Impossible de lire le document à partir du fichier '<nom du fichier>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1060 : Les tables de base de données de Report Builder n'ont pas été installées.

Cause :	Report Builder n'a pas pu accéder à la vue SRW2_DOCUMENT, dans la base de données en cours.
Action :	Vérifiez l'installation de Report Builder dans la base de données. Si vous avez besoin d'aide, contactez votre administrateur système.


REP-1061 : Impossible de lire le fichier externe '<nom du fichier>'.

Cause :	Vous avez activé Lecture depuis fichier et indiqué un nom de fichier comme valeur de colonne, mais Report Builder n'a pas pu ouvrir ou lire le fichier indiqué.
Action :	Vérifiez l'orthographe du nom du fichier dans la palette de propriétés Colonne et vérifiez l'existence du fichier. S'il existe, vérifiez les autorisations d'accès, pour vous assurer que vous avez au moins l'autorisation de le lire.


REP-1062 : Interrogation externe '<nom du fichier>' introuvable.

Cause :	Causes possibles :
	Cas 1 :	REPORTS60_PATH n'est pas défini.
	Cas 2 :	Vous n'êtes pas connecté à une base de données.
	Cas 3 :	L'interrogation externe indiquée n'existe pas.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Définissez REPORTS60_PATH à une valeur valide.
	Cas 2 :	Connectez-vous à une base de données.
	Cas 3 :	Assurez-vous que vous avez correctement indiqué le nom de l'interrogation externe.


REP-1063 : La procédure PL/SQL '<nom de l'unité de programme>' a dépassé la taille limite de la plate-forme.

Cause :	La procédure PL/SQL n'a pas pu être chargée car elle est trop grande pour votre système d'exploitation. Il est possible qu'elle ait été créée sur une plate-forme différente ayant une limite supérieure.
Action :	Diminuez la taille de la procédure PL/SQL afin qu'elle puisse être chargée sur votre plate-forme.


REP-1064 : Impossible de lire le document '<nom du document>'.

Cause :	Vous avez tenté d'ouvrir un document dont la définition, stockée soit dans la base de données soit dans le système de fichiers, est perdue ou altérée.
Action :	Ce document ne peut pas être utilisé.


REP-1065 : Lecture impossible de l'interrogation externe '<nom du fichier>'.

Cause :	Vous avez tenté de lire une interrogation externe dont la définition, stockée soit dans la base de données soit dans le système de fichiers, est perdue ou altérée.
Action :	Cette interrogation externe ne peut pas être utilisée.


REP-1066 : Avertissement ! Commentaire corrompu. Il sera perdu.

Cause :	Une erreur mémoire a entraîné l'altération d'un commentaire. Il ne sera pas pris en compte.
Action :	Aucune. Vous pouvez éventuellement recréer le commentaire dans Designer.


REP-1067 : Informations absentes de l'état.

Cause :	L'état est impossible à ouvrir car sa définition est incomplète. Il est possible qu'il ait été altéré.
Action :	Si l'état est stocké dans la base de données, utilisez SQLPlus pour savoir si les tables de Report Builder ont été altérées. Si l'état est un fichier .rdf, utilisez un utilitaire du système de fichiers pour savoir si le fichier est altéré. Prenez les mesures nécessaires pour récupérer vos données.


REP-1070 : Erreur lors de l'ouverture ou de l'enregistrement d'un document.

Cause :	Il s'est produit une erreur pendant l'ouverture ou l'enregistrement d'un document.
Action :	Assurez-vous que vous avez les privilèges nécessaires pour accéder au document.


REP-1071 : Fin du balayage d'objet/enregistrement.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1072 : Objet introuvable.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1073 : Objet trouvé à un moment inattendu.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1074 : Objet trop grand.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1075 : Objet non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1076 : Stockage erroné.

Cause :	Vous avez tenté d'utiliser un fichier ou un objet de base de données erroné.
Action :	Assurez-vous que l'objet que vous avez indiqué est un document Oracle valide, stocké dans un fichier ou dans la base de données.


REP-1077 : Le type associé à l'objet n'est pas valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1078 : Erreur fichier non spécifique.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1079 : Cette fonction n'est pas prise en charge.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1080 : Violation de clé unique.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1081 : Une division de page s'est produite.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1082 : Erreur de fermeture.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1083 : Erreur de version de fichier.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1084 : En-tête de fichier incorrect ou absent.

Cause :	Vous avez exécuté une opération qui impliquait que Report Builder ouvre un fichier. Le fichier n'avait pas d'en-tête ou n'avait pas l'en-tête voulu. Il est possible qu'un en-tête ait été modifié dans un éditeur ou que le fichier ne soit pas compatible avec cette version de Report Builder.
Action :	Vous pouvez tenter de modifier l'en-tête en utilisant un éditeur, mais ce type d'édition de fichiers de Report Builder est déconseillé. Si le fichier est incompatible avec cette version de Report Builder, vous devez le faire migrer. Pour plus d'informations, reportez-vous à "Migrating Report Builder and Printer Definitions" dans Report Builder Migration Manual.


REP-1085 : Erreur de création de fichier.

Cause :	Vous avez tenté d'exécuter une opération qui impliquait que Report Builder crée un fichier et il s'est produit une erreur. Il est possible que vous n'ayez pas les privilèges nécessaires pour créer le fichier.
Action :	Procurez-vous les privilèges nécessaires.


REP-1086 : Erreur lecture seule (read-only) lors de l'ouverture du fichier.

Cause :	Vous avez tenté d'exécuter une opération qui impliquait que Report Builder ouvre un fichier auquel vous n'avez pas accès. Il est possible que vous n'ayez pas les privilèges nécessaires pour ouvrir le fichier.
Action :	Procurez-vous les fichiers nécessaires pour ouvrir le fichier ou, si possible, accédez à un fichier pour lequel vous avez les privilèges nécessaires.


REP-1087 : Erreur lecture-écriture lors de l'ouverture du fichier.

Cause :	Vous avez tenté d'exécuter une opération qui impliquait que Report Builder ouvre un fichier auquel vous n'avez pas accès. Il est possible que vous n'ayez pas les privilèges nécessaires pour ouvrir le fichier.
Action :	Procurez-vous les fichiers nécessaires pour ouvrir le fichier ou, si possible, accédez à un fichier pour lequel vous avez les privilèges nécessaires.


REP-1088 : Erreur d'écriture de fichier.

Cause :	Vous avez tenté d'exécuter une opération qui impliquait que Report Builder écrive dans un fichier auquel vous n'avez pas accès. Il est possible que vous n'ayez pas les privilèges nécessaires pour écrire dans un fichier.
Action :	Procurez-vous les privilèges nécessaires pour écrire dans le fichier ou, si possible, accédez à un fichier pour lequel vous avez les privilèges d'écriture.


REP-1089 : Erreur de lecture de fichier.

Cause :	Vous avez tenté d'exécuter une opération qui impliquait que Report Builder lise un fichier auquel vous n'avez pas accès. Il est possible que vous n'ayez pas les privilèges nécessaires pour lire le fichier.
Action :	Procurez-vous les privilèges nécessaires pour lire le fichier ou, si possible, accédez à un fichier pour lequel vous avez les privilèges de lecture.


REP-1090 : Erreur de fermeture de fichier.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1091 : Disque ou système de fichiers saturé.

Cause :	Vous avez tenté d'enregistrer un objet mais il n'y avait pas suffisamment de place.
Action :	Supprimez les fichiers dont vous n'avez plus besoin ou augmentez la place disponible en mémoire.


REP-1092 : Violation de clé unique de fichier.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1093 : Echec d'affectation.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1094 : Nouvel échec d'affectation.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1095 : Echec de libération.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1096 : <type du document> actuellement verrouillé.

Cause :	Vous avez tenté d'ouvrir un document déjà ouvert (verrouillé) par un autre utilisateur.
Action :	Attendez que l'autre utilisateur ferme le document pour y accéder.


REP-1097 : PRODUCT_USER_PROFILE ou SYSTEM.PRODUCT_PROFILE inexistant.

Cause :	Causes possibles :
	Cas 1 :	La table n'existe pas.
	Cas 2 :	Vous n'avez pas les privilèges nécessaires pour accéder à la table.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Si la table n'est pas encore créée, créez-la.
	Cas 2 :	Accédez à la table en créant un synonyme public de cette table dans la table PRODUCT_USER_PROFILE ou en rendant la table publique à l'aide de la table PRODUCT_USER_PROFILE.


REP-1098 : Erreur de lecture des données PRODUCT_USER_PROFILE ou SYSTEM.PRODUCT_PROFILE.

Cause :	La table n'a pas été créée correctement.
Action :	Assurez-vous que la table a été créée avec les colonnes appropriées. Sinon, modifiez-la.


REP-1099 : Ouverture impossible de fichiers non créés avec Report Builder.

Cause :	Vous avez tenté d'ouvrir un fichier qui n'est pas un état Report Builder.
Action :	Assurez-vous que le fichier que vous ouvrez contient un état Report Builder.


REP-1100 : Votre modèle de données ne convient pas à ce type d'état.

Cause :	Vous avez tenté de créer une présentation par défaut avec un style de présentation qui ne correspond par à votre modèle de données.
Action :	Modifiez votre modèle de données pour qu'il corresponde au style de présentation sélectionné, ou sélectionnez un autre style de présentation correspondant à votre modèle de données.


REP-1101 : Le sens itératif du groupe '<nom du groupe>' n'est pas valide.

Cause :	Vous avez tenté de créer une présentation par défaut, mais le style de présentation sélectionné demande un sens itératif différent pour l'un de vos groupes. Certains styles de présentation imposent des restrictions aux sens itératifs que vous pouvez choisir pour vos groupes.
Action :	Modifiez le sens itératif pour qu'il corresponde aux conditions du style de présentation ou choisissez un autre style de présentation.


REP-1102 : Impossible de faire tenir la présentation par défaut sur une page de taille <nombre>.

Cause :	Report Builder a tenté de créer la présentation par défaut que vous avez sélectionnée, mais n'a pas pu faire tenir toute la présentation sur la page, car elle n'est pas suffisamment large.
Action :	Si possible, augmentez la largeur de page dans la palette de propriétés Etat ou disposez différemment les objets afin que la présentation tienne dans la page. Sinon, il est possible que vous soyez obligé de créer un état en plusieurs pages.


REP-1103 : Aucune colonne sélectionnée dans le groupe '<nom du groupe>'.

Cause :	Pendant que vous tentiez de créer une présentation par défaut, vous n'avez pas sélectionné de colonne pour un groupe sélectionné. Report Builder ne peut donc pas créer de présentation par défaut, car une ou plusieurs des dimensions de votre présentation n'ont pas de valeurs.
Action :	Dans l'assistant Report, sélectionnez au moins une colonne pour chaque groupe sélectionné.


REP-1104 : Les informations de niveau page ne sont pas supportées dans la présentation par défaut.

Cause :	Vous avez généré une présentation par défaut qui est trop grande pour la place disponible. Causes possibles :
	Cas 1 :	La présentation que vous avez générée est trop grande pour les dimensions indiquées dans la boîte de dialogue Propriétés d'état.
	Cas 2 :	La présentation est trop grande pour la taille de la zone délimitée dans l'éditeur de modèle de présentation.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Augmentez les dimensions de votre état en fonction de la taille de la présentation ou modifiez la présentation afin qu'elle tienne dans les dimensions en cours.
	Cas 2 :	Augmentez la taille de la zone délimitée.


REP-1106 : Avertissement ! Aucun champ généré pour la colonne '<nom de la colonne>'.

Cause :	Lorsque vous avez utilisé une présentation par défaut, aucun champ n'a été généré pour la colonne indiquée dans le message. La cause la plus probable de cette erreur est qu'un récapitulatif n'a pas été placé correctement dans le modèle de données. Par exemple, il est possible que vous ayez indiqué que la source d'une colonne récapitulative était une colonne d'un groupe se trouvant au-dessus du groupe récapitulatif, ce qui est interdit.
Action :	Déboguez votre modèle de données et modifiez la définition par défaut de votre présentation.


REP-1107 : Groupe horizontal ou vertical omis dans groupe inter-produit '<nom du groupe>'.

Cause :	Vous avez tenté de créer une présentation par défaut en sélectionnant le style Matrice dans l'assistant Report, mais tous les groupes de dimensions du groupe inter-produit avaient pour sens itératifs Vers le bas ou De gauche à droite. Chaque sens itératif doit être attribué aux groupes de dimensions de l'inter-produit.
Action :	Ré-affichez l'assistant Report et ré-attribuez les sens itératifs des groupes de dimensions en vous assurant que chaque sens itératif des différents groupes est attribué.


REP-1108 : Impossible de faire tenir la présentation par défaut, même dans la zone allant jusqu'aux limites de page.

Cause :	Vous tentez d'utiliser par défaut une présentation qui, si elle était créée à l'aide des paramètres en cours, serait trop grande pour la hauteur et la largeur définies pour une page d'état.
Action :	Revenez à l'assistant Report et diminuez les valeurs des paramètres par défaut (réduisez, par exemple, la largeur de certains champs). Vous pouvez également augmenter la taille d'une page d'état en utilisant la palette de propriétés Etat. Redéfinissez ensuite votre présentation par défaut. Poursuivez les modifications, le cas échéant.


REP-1109 : Sélection multigroupe incompatible avec le type de présentation monogroupe.

Cause :	Vous avez sélectionné plusieurs groupes à utiliser par défaut alors que vous aviez également sélectionné un style par défaut conçu pour un seul groupe.
Action :	Modifiez votre sélection de groupe pour qu'elle ne sélectionne qu'un seul groupe. Vous pouvez également modifier votre sélection de style de présentation en utilisant un style prenant en charge plusieurs groupes.


REP-1110 : Groupe de matrices de gauche à droite absent du groupe inter-produit '<nom du groupe>'.

Cause :	Vous avez tenté de créer une présentation par défaut en sélectionnant le style Matrice ou Matrice avec groupe dans l'assistant Report, alors que tous les groupes de dimensions du groupe inter-produit ont pour sens itératif Vers le bas.
Action :	Modifiez le sens itératif de l'un des groupes de dimensions inter-produit afin qu'il y ait au moins un groupe De gauche à droite et un groupe Vers le bas.


REP-1111 : Groupe de matrices vers le bas absent du groupe inter-produit '<nom du groupe>'.

Cause :	Vous avez tenté de créer une présentation par défaut en sélectionnant le style Matrice ou Matrice avec groupe dans l'assistant Report, alors que tous les groupes de dimension du groupe inter-produit ont pour sens itératif De gauche à droite.
Action :	Modifiez le sens itératif de l'un des groupes de dimensions inter-produit afin qu'il y ait au moins un groupe Vers le bas et un groupe De gauche à droite.


REP-1112 : Groupe de matrices inter-produit absent de l'état matriciel.

Cause :	Vous avez tenté de créer une présentation par défaut en sélectionnant le style Matrice ou Matrice avec groupe dans l'assistant Report, mais vous n'avez pas sélectionné de groupes inter-produit à utiliser comme groupe de matrices.
Action :	Modifiez le sens itératif de l'un des groupes inter-produit en le remplaçant par Matrice.


REP-1113 : Aucun groupe ou colonne de niveau état n'a été sélectionné.

Cause :	Lorsque vous avez tenté de créer une présentation par défaut, vous n'avez pas sélectionné de groupe ou de colonne de niveau état. Report Builder n'a donc pas pu créer de présentation par défaut car une ou plusieurs des dimensions de votre présentation n'ont pas de valeurs.
Action :	Dans l'assistant Report, sélectionnez au moins une colonne de niveau état ou un groupe que vous voulez utiliser par défaut.


REP-1114 : Sélection monogroupe incompatible avec le type de présentation multigroupe.

Cause :	Vous avez sélectionné un groupe à utiliser par défaut, mais vous avez également sélectionné un style par défaut conçu pour plusieurs groupes.
Action :	Modifiez votre sélection de groupe afin qu'elle permette la sélection d'un seul groupe. Vous pouvez également modifier la sélection de votre style par défaut en utilisant un style qui supporte les groupes uniques.


REP-1115 : Affichage impossible du modèle entier car celui-ci ne tient pas dans la page.

Cause :	Le modèle ne peut pas être affiché correctement car il ne tient pas dans les dimensions définies pour la page de l'état. Le fait qu'il ne puisse pas être affiché n'implique pas qu'il comporte des erreurs.
Action :	Pour afficher le modèle, augmentez temporairement les dimensions de la page de l'état. Pour cela, sélectionnez le modèle dans le Navigateur d'objet et ouvrez la palette de propriétés. Augmentez les propriétés Largeur et Hauteur sous le noeud Etat. N'oubliez pas de revenir aux propriétés de largeur et de hauteur initiales avant d'enregistrer votre modèle.


REP-1200 : Echec de compilation du flux.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1201 : Texte absent de l'interrogation '<nom de l'interrogation>'.

Cause :	Vous avez fourni le nom d'une interrogation et tenté de l'accepter, mais soit vous n'avez pas entré d'instruction SELECT, soit vous avez entré une information qui ne commençait pas par le mot-clé SELECT. La boîte de dialogue Instructions d'interrogation SQL n'accepte que des instructions SLQ SELECT.
Action :	Entrez une instruction SQL SELECT qui commence par le mot-clé SELECT (en majuscules ou en minuscules). Aucune autre instruction SQL n'est acceptée dans la boîte de dialogue Instructions d'interrogation SQL.


REP-1202 : Connexion ORACLE non précisée.

Cause :	Vous avez tenté d'exécuter un état sans avoir indiqué de connexion ORACLE.
Action :	Entrez une chaîne de connexion dans la boîte de dialogue Connexion et acceptez cette boîte de dialogue avant de ré-exécuter l'état.


REP-1203 : Le champ '<nom du champ>' fait référence à une colonne non valide.

Cause :	La colonne indiquée comme Source du champ est erronée ou n'existe pas.
Action :	Sélectionnez une colonne de la liste de valeurs.


REP-1204 : L'encadrement itératif '<nom de l'encadrement>' fait référence à un groupe non valide.

Cause :	Le nom de groupe que vous avez entré dans le champ Groupe de la palette de propriétés Encadrement itératif est erroné ou n'existe pas.
Action :	Sélectionnez un groupe de la liste de valeurs.


REP-1205 : L'arbre de dépendance de positionnement contient une boucle.

Cause :	Vous avez créé des points d'ancrage explicites selon lesquels un objet est directement ancré sur lui-même. Cette erreur apparaît, par exemple, si vous avez ancré l'objet A sur l'objet B, l'objet B sur l'objet C et l'objet C sur l'objet A.
Action :	Vous devez supprimer au moins un des points d'ancrage ayant provoqué la boucle.


REP-1206 : Un objet est "ancré" à plusieurs objets.

Cause :	Dans votre présentation, vous avez ancré un objet sur plusieurs objets. Un objet ne peut être ancré que sur un seul autre objet.
Action :	Eliminez les points d'ancrage sur les autres objets afin que l'objet ne soit ancré qu'à un seul autre objet.


REP-1207 : Procédure PL/SQL pour filtre de groupe '<nom du groupe>' introuvable.

Cause :	Vous avez entré Condition dans le champ Type de la palette de propriétés Groupe sans entrer de filtre valide.
Action :	Entrez une fonction PL/SQL valide ou changez le type de filtre.


REP-1208 : L'encadrement itératif de la matrice '<nom de la matrice>' ne peut pas être "ancré".

Cause :	Vous avez tenté d'exécuter un état comprenant un ancrage à partir d'un encadrement itératif faisant intersection sur un autre objet, ce qui est interdit.
Action :	Supprimez le point d'ancrage. Vous ne pouvez pas ancrer cet objet sur un autre objet.


REP-1209 : Impossible d'ancrer objet de matrice '<nom de la matrice>'.

Cause :	Vous avez tenté d'exécuter un état comportant un point d'ancrage d'un objet de matrice sur un autre objet. Cette opération est interdite.
Action :	Supprimez le point d'ancrage. Vous ne pouvez pas ancrer cet objet sur un autre objet.


REP-1211 : L'objet '<nom de l'objet1>' est plus grand que l'objet '<nom de l'objet2>' dans lequel il est inclus.
REP-1211 : L'objet '<nom de l'objet1>' est plus grand que l'objet '<nom de l'objet2> dans lequel il est inclus.

Cause :	Un objet est trop grand pour l'objet englobant. La cause la plus probable de cette erreur est que vous avez tenté d'entrer un objet dans un cadre fixe plus petit.
Action :	Identifiez l'objet et l'objet qui l'entoure et ajustez leurs tailles et leurs positions relatives jusqu'à ce que le résultat voulu soit atteint.


REP-1212 : L'objet '<nom de l'objet1>' n'est pas complètement délimité par l'objet '<nom de l'objet2>'.

Cause :	Causes possibles :
	Cas 1 :	Un objet est trop grand pour la page à laquelle il est destiné - c'est-à-dire qu'il dépasse les limites de la page.
	Cas 2 :	Un encadrement itératif formant une matrice se trouve une ou plusieurs couches au-dessus d'un encadrement itératif qu'il contient. Dans une présentation de matrice, les encadrements itératifs doivent se trouver en dessous de ceux qu'ils contiennent.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Déplacez ou redimensionnez l'objet afin qu'il ne dépasse pas les limites de la page. Vous pouvez également augmenter la taille de la page dans la palette de propriétés Etat.
	Cas 2 :	En utilisant Réorganisation [image] Passage en arrière-plan, Réorganisation [image] Passage au premier plan, Réorganisation [image] Déplacement arrière et Réorganisation [image] Déplacement avant, positionnez vos encadrements itératifs de telle sorte que, en termes de couches, les encadrements itératifs se trouvent en dessous de ceux qu'ils contiennent, et que les encadrements itératifs verticaux soient sous les encadrements itératifs horizontaux.


REP-1213 : Le champ '<nom du champ>' se réfère à une colonne '<nom de la colonne>' à une fréquence inférieure à celle de son groupe.

Cause :	La colonne source du champ est dans un groupe qui se trouve en dessous de celui de l'encadrement itératif qui l'entoure.
Action :	Faites passer le champ dans un encadrement itératif dont le groupe source est au-dessus ou au niveau du groupe contenant la colonne source du champ. Sinon, faites passer, si possible, la colonne source du champ dans le groupe de l'encadrement itératif qui l'entoure.


REP-1214 : L'encadrement itératif '<nom de l'encadrement>' est délimité par un encadrement itératif fils.

Cause :	Le groupe source de l'encadrement itératif délimité se trouve au-dessus du groupe source de l'encadrement itératif qui l'entoure.
Action :	Dans l'éditeur, transformez l'encadrement itératif délimité en encadrement itératif délimiteur. Vous pouvez également, si possible, changez votre hiérarchie de groupes afin que le groupe de l'objet délimité soit en dessous du groupe de l'objet délimiteur.


REP-1216 : '<Nom de l'objet>' comporte une condition d'impression qui est interdite.

Cause :	Vous avez défini une condition d'impression non valide pour l'objet indiqué. Par exemple, vous avez tenté de définir la condition d'impression d'un objet de marge.
Action :	Indiquez pour Condition d'impression de l'objet une définition valide.


REP-1218 : '<Nom de l'objet>' ne peut effectuer un changement de page prématuré ET ne pas être séparé du père.

Cause :	Vous avez défini un Saut de page avant pour un objet et Objet solidaire. Cependant, comme l'objet d'ancrage précède l'objet, les deux paramètres sont incompatibles.
Action :	Annulez Saut de Page avant ou Objet solidaire.


REP-1219 : Aucune taille indiquée pour '<nom de l'objet>' -- longueur ou largeur égale à zéro.

Cause :	En créant votre présentation, vous avez créé un objet de présentation de largeur ou de hauteur égale à zéro.
Action :	Agrandissez l'objet afin qu'il ait une hauteur et une largeur différentes de zéro.


REP-1220 : Le nombre min de lignes veuves pour '<nom de l'objet>' dépasse le nombre max de lignes par page.

Cause :	Le nombre maximum d'enregistrements par page est inférieur au nombre minimum d'enregistrements veufs, ce qui entraîne un conflit entre les deux paramètres et empêche l'impression des instances.
Action :	Diminuez le nombre minimum d'enregistrements veufs ou augmentez le nombre maximum d'enregistrements par page.


REP-1222 : Taille de corps erronée.

Cause :	Vous avez indiqué une largeur ou une hauteur des pages formant le corps de l'état qui est soit négative soit hors limites. Il est très probable que ce message est apparu lorsque vous avez donné à la taille des pages une valeur erronée en utilisant l'argument exécutable PAGESIZE.
Action :	Entrez une valeur valide en utilisant l'argument exécutable PAGESIZE, ou ajustez la taille des pages formant le corps de l'état en redimensionnant les marges dans l'Editeur de modèle de présentation.


REP-1223 : Taille de page erronée.

Cause :	Vous avez indiqué une largeur ou une hauteur des pages physiques qui est soit négative soit hors limites. Il est très probable que ce message est apparu lorsque vous avez donné à la taille des pages une valeur erronée en utilisant l'argument exécutable PAGESIZE.
Action :	Entrez une valeur valide en utilisant l'argument exécutable PAGESIZE, ou modifiez le paramètre de taille de pages physiques dans la palette de propriétés Etat.


REP-1225 : Taille de page logique erronée.

Cause :	Vous avez indiqué une hauteur de page logique négative.
Action :	Redéfinissez la hauteur des pages logiques en vous assurant que la valeur de hauteur de page n'est pas négative.


REP-1226 : Emplacement du corps hors de la zone d'impression.

Cause :	Le corps ne se trouve pas dans la page physique.
Action :	Ajustez la taille du corps en redimensionnant les marges dans l'Editeur de modèle de présentation.


REP-1229 : Encadrement itératif '<nom de l'encadrement itératif>' : valeur Entre enregistrement négative.
REP-1229 : Encadrement itératif '<nom de l'encadrement itératif>' : valeur Entre enregistrements négative.

Cause :	La valeur de Espacement vertical et/ou de Espacement horizontal d'un encadrement itératif est négative.
Action :	Modifiez la définition de l'espacement de l'encadrement itératif indiqué dans le message d'erreur.


REP-1230 : Le groupe de restauration de page du champ '<nom du champ>' est erroné.

Cause :	Dans le champ Remise à de la boîte de dialogue Numérotation de page, vous avez indiqué un encadrement itératif qui n'englobe pas le champ de présentation dans lequel vous voulez afficher le numéro de page. Vous avez peut-être indiqué un encadrement itératif erroné ou supprimé l'encadrement itératif après l'avoir indiqué.
Action :	Indiquez &Etat ou le nom d'un encadrement itératif valide comme valeur de Remise à pour le champ de numéro de page.


REP-1231 : Type de césure erroné dans '<nom de l'objet>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1232 : Matrice '<nom de la matrice>' : encadrement source erroné.

Cause :	Vous avez indiqué un objet erroné comme encadrement source de l'objet de la matrice, ou les encadrements itératifs que vous avez indiqués ont des orientations d'impression erronées.
Action :	Indiquez Vers le bas pour Orientation d'impression de l'encadrement itératif source horizontal et De gauche à droite pour Orientation d'impression de l'encadrement itératif source vertical.


REP-1233 : Intersection non parfaite entre les encadrements de la matrice '<nom de la matrice>'.

Cause :	L'intersection des encadrements itératifs qui forment la matrice n'est pas parfaite. Ce message d'erreur apparaît, par exemple, si vous avez deux encadrements itératifs vers le bas et deux encadrements itératifs de gauche à droite, et si l'un des encadrements itératifs vers le bas ne coupe complètement que l'un des encadrements itératifs vers le bas.
Action :	Indiquez à nouveau la présentation de matrice par défaut, si possible, ou déplacez les encadrements itératifs constituant la matrice, de façon à obtenir une intersection parfaite.


REP-1234 : Matrice '<nom de la matrice>' non positionnée à l'intersection de ses encadrements.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1235 : Groupe inter-produit : erreur de génération d'index.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1236 : Interrogation '<nom de l'interrogation>'erronée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1237 : Liaison de données non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1238 : Groupe '<nom du groupe>' non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1239 : Colonne '<nom de la colonne>' non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1240 : Point d'ancrage non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1241 : Dépendance colonne circulaire à partir de la colonne '<nom de la colonne>'.

Cause :	Vous avez créé une colonne qui fait directement ou indirectement référence à elle-même. Ce message d'erreur apparaît si, par exemple, la colonne A fait référence à la colonne B qui fait à son tour référence à la colonne A.
Action :	Mettez à jour ou supprimez la ou les colonnes pour éliminer la dépendance circulaire.


REP-1242 : Les encadrements verticaux des matrices doivent être situés au-dessous des encadrements horizontaux.

Cause :	Dans une présentation de matrices, les encadrements itératifs verticaux doivent se trouver en dessous des encadrements itératifs horizontaux.
Action :	En utilisant Réorganisation-->Passage en arrière-plan, Réorganisation-->Passage au premier plan, Réorganisation-->Déplacement arrière et Réorganisation-->Déplacement avant, disposez vos encadrements itératifs de telle sorte que, en termes de couches, les encadrements itératifs se trouvent en dessous de ceux qu'ils contiennent, et que les encadrements itératifs verticaux soient sous les encadrements itératifs horizontaux.


REP-1243 : Colonne '<nom de la colonne>' : type de fonction récapitulative (summary) non acceptée.

Cause :	Vous avez indiqué une fonction récapitulative qui n'est pas disponible.
Action :	Indiquez une fonction récapitulative valide.


REP-1245 : Fonction récapitulative (summary) de colonne '<nom de la colonne>' : nombre de colonnes source incorrect.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1246 : Document graphique introuvable.

Cause :	Report Builder n'a pas pu trouver le document graphique associé au graphique.
Action :	Corrigez le nom de fichier et le chemin d'accès au document graphique.


REP-1247 : PL/SQL non compilé dans l'état.

Cause :	Vous avez tenté d'exécuter votre état avant que tous les éléments PL/SQL référencés aient été compilés.
Action :	Compilez PL/SQL, puis exécutez votre état.


REP-1248 : Toutes les colonnes source de la colonne de réserve '<nom de la colonne>' doivent appartenir au même groupe.

Cause :	Vous avez tenté de définir la valeur d'une colonne de réserve à partir d'une ou plusieurs colonnes appartenant à des groupes différents.
Action :	Modifiez le groupe de la colonne de réserve afin qu'il corresponde au groupe de la ou des colonnes modifiant la valeur de la colonne de réserve.


REP-1249 : La colonne '<nom de la colonne>' ne contient aucune formule PL/SQL.

Cause :	Vous avez créé une colonne de type Formule dont le champ Formule n'était pas renseigné.
Action :	Créez une formule pour la colonne ou modifiez le type de la colonne.


REP-1250 : Dépendance interrogation circulaire.

Cause :	Votre état contient au moins deux interrogations, qui demandent toutes deux que l'autre soit exécutée en premier.
Action :	Editez une ou plusieurs de vos interrogations pour supprimer la dépendance circulaire.


REP-1251 : Dépendance interrogation circulaire à partir de l'interrogation '<nom de l'interrogation>'.

Cause :	Votre état contient au moins deux interrogations, qui demandent toutes deux que l'autre soit exécutée en premier. L'interrogation figurant dans le message est l'une de celles qui provoquent le conflit.
Action :	Editez l'interrogation figurant dans la liste, ou une autre interrogation conflictuelle, pour supprimer la dépendance circulaire.


REP-1252 : Groupe '<nom du groupe>' : la matrice doit être entourée par un encadrement itératif.

Cause :	Le modèle de données de votre état contient une matrice ayant un groupe père, mais dans la présentation, l'encadrement itératif du groupe père soit n'existe pas, soit n'entoure pas la matrice.
Action :	Modifiez la présentation de votre état pour que le groupe père comporte un encadrement itératif qui entoure la matrice.


REP-1253 : Les objets de la matrice se trouvent dans différentes zones de l'état.

Cause :	Les encadrements itératifs d'une matrice sont dans des zones différentes de la présentation (corps, marges, pages d'en-tête ou pages de fin).
Action :	Faites passer tous les encadrements itératifs de la matrice dans la même zone de l'état.


REP-1254 : Les objets ancrés se trouvent dans différentes zones de l'état.

Cause :	Les objets d'ancrage et les objets ancrés d'un point d'ancrage sont dans des zones différentes de la présentation (corps, marges, pages d'en-tête ou pages de fin).
Action :	Faites passer les objets mentionnés ci-dessus dans la même zone de l'état.


REP-1255 : Ancrage à un objet masqué impossible.

Cause :	L'objet ancré d'un point d'ancrage est un objet masqué.
Action :	Annulez le masquage de l'objet ancré ou supprimez le point d'ancrage.


REP-1256 : Fichier source absent du Texte standard du fichier de liaison.

Cause :	Vous n'avez pas indiqué de nom de fichier dans le champ Fichier de liaison de la palette de propriétés d'un objet standard du fichier de liaison.
Action :	Indiquez un chemin d'accès au répertoire et un nom de fichier dans le champ Fichier de liaison de la palette de propriétés Texte standard du fichier de liaison.


REP-1257 : Interrogation fils : transfert de données à partir de l'appelant impossible.

Cause :	Vous avez appelé Report Builder à partir d'un autre produit. Report Builder devait extraire, de l'appelant, des données pour une interrogation fils. Les données transmises à Report Builder ne peuvent provenir que d'une interrogation maître.
Action :	Modifiez les instructions de l'appelant pour que Report Builder ne demande pas de données pour une interrogation fils.


REP-1258 : Le groupe '<nom du groupe>' ne contient pas de colonnes.

Cause :	Vous avez créé un groupe sans colonne.
Action :	Supprimez le groupe ou attribuez-lui une ou plusieurs colonnes.


REP-1259 : Le groupe '<nom du groupe>' ne contient pas de colonnes de ventilation.

Cause :	Vous avez créé un groupe père sans colonne de ventilation.
Action :	Cochez la ou les cases d'ordre de ventilation de la ou des colonnes de ventilation du groupe.


REP-1260 : Impossible de lier les groupes '<nom1 du groupe>' et '<nom2 du groupe>' d'une même interrogation.

Cause :	Les données de deux groupes d'une même interrogation sont liées, ce qui est interdit.
Action :	Supprimez la liaison entre les données ou reliez-les à un autre groupe.


REP-1261 : Résolution du père du groupe '<nom du groupe>' impossible.

Cause :	Un groupe a deux interrogations comme père (ce qui est interdit).
Action :	Supprimez les liaisons de données entre le groupe et les différentes interrogations.


REP-1262 : Dépendance Liaison de données circulaire commençant à partir du groupe '<nom du groupe>'.

Cause :	Vous avez créé un cycle avec des liaisons de données (c'est-à-dire que vous avez indiqué qu'un père est son propre fils, soit directement, soit indirectement).
Action :	Supprimez au moins une des liaisons du cycle.


REP-1263 : Le groupe inter-produit '<nom du groupe>' ne comprend aucun groupe ou n'en comprend qu'un seul.

Cause :	Un groupe inter-produit ne comporte aucun groupe ou n'en comporte qu'un. Les groupes inter-produit doivent avoir au moins deux groupes dimension. Les groupes inter-produit multi-interrogations doivent avoir au moins deux interrogations dans le groupe inter-produit.
Action :	Supprimez le groupe inter-produit ou ajoutez des groupes dimension ou des interrogations de dimension (dans le cas d'interrogations multiples).


REP-1264 : Liaison de données du groupe '<nom du groupe>' au-delà des limites inter-produit.

Cause :	L'état de matrices multi-interrogations comprend une interrogation dont certains groupes sont à l'intérieur de l'inter-produit, et d'autres à l'extérieur.
Action :	Faites passer tous les groupes de l'interrogation à l'intérieur ou à l'extérieur du groupe inter-produit.


REP-1265 : Le groupe 'inter-produit '<nom du groupe>' ne contient pas de groupe fils.

Cause :	Un groupe inter-produit ne comporte pas de groupe fils, ce qui est obligatoire. Le groupe fils joue le rôle de cellule de la matrice.
Action :	Créez un groupe fils pour le groupe inter-produit.


REP-1266 : Colonne '<nom de la colonne>' : colonnes niveau Page non autorisées dans groupe inter-produit.

Cause :	Vous avez créé, dans un groupe inter-produit, une colonne qui est ou qui dépend d'un récapitulatif de niveau page (c'est-à-dire un récapitulatif dont le champ Remise à contient Page).
Action :	Un groupe inter-produit ne peut pas comporter une colonne qui est ou qui dépend d'un récapitulatif de niveau page. Supprimez la colonne du groupe inter-produit ou modifiez la valeur Remise à de la colonne ou le récapitulatif de niveau page  dont elle dépend.


REP-1267 : Le graphique '<nom du graphique>' fait référence à une colonne non valide comme paramètre de lien.

Cause :	Le graphique fait référence à une colonne qui n'existe pas. Il s'agit d'une condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1268 : Le graphique '<nom du graphique>' fait référence à une colonne de lien '<nom de la colonne>' à une fréquence incorrecte.

Cause :	La colonne indiquée pour le graphique se trouve dans un groupe inférieur à celui de l'encadrement itératif qui entoure le graphique.
Action :	Faites passer le graphique dans un encadrement itératif dont le groupe source est au niveau ou au-dessus du niveau du groupe contenant la colonne indiquée. Sinon, faites passer, si possible, la colonne indiquée dans le groupe de l'encadrement itératif qui l'entoure.


REP-1269 : Le graphique '<nom du graphique>' fait référence à un groupe d'états non valide.

Cause :	Le groupe d'états indiqué pour le graphique n'existe pas. Il s'agit là d'une condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1270 : Le graphique '<nom du graphique>' fait référence à un groupe d'états à une fréquence incorrecte.

Cause :	Le groupe d'états indiqué pour le graphique se trouve au-dessus du groupe source de l'encadrement itératif qui l'entoure.
Action :	Faites passer le graphique dans un encadrement itératif ayant un groupe source qui se trouve au niveau ou au-dessus de son groupe d'états.


REP-1271 : Nom de colonne de graphique '<nom de la colonne>' indiqué plusieurs fois dans le document graphique '<nom du graphique>'.

Cause :	Le document graphique fait plusieurs fois référence au paramètre ou à la colonne du graphique indiqué.
Action :	Vérifiez les colonnes et les paramètres que vous indiquez pour le graphique et supprimez les doublons.


REP-1272 : La colonne '<nom de la colonne>' ne doit pas être utilisée comme colonne de ventilation.

Cause :	Vous avez demandé un Ordre de ventilation pour une colonne récapitulative, de fonction ou de réserve. Ces types de colonne ne peuvent pas être utilisés comme colonnes de ventilation.
Action :	Reportez-vous aux règles indiquant les colonnes pouvant être utilisées comme colonnes de ventilation. Pour plus d'informations, reportez-vous à Ordre de ventilation.


REP-1273 : Groupes source de la matrice '<nom de la matrice>' n'appartient pas au même groupe inter-produit.
REP-1273 : Groupes source de la matrice '<nom de la matrice>' n'appartiennent pas au même groupe inter-produit.

Cause :	Les groupes source des encadrements itératifs formant les dimensions de la matrice ne se trouvent pas dans le même groupe inter-produit. Les dimensions d'une matrice doivent se trouver dans le même groupe inter-produit.
Action :	Modifiez les groupes source des encadrements itératifs ou choisissez des encadrements itératifs différents pour former les dimensions de la matrice.


REP-1274 : Matrice '<nom de la matrice>' : combinaison d'orientation non valide.

Cause :	Les encadrements itératifs de dimension de matrice dont les groupes source sont dans la même hiérarchie de "famille" (c'est-à-dire sont des descendants ou des ascendants l'un de l'autre) d'un même groupe inter-produit doivent avoir la même orientation d'impression. Les relations père-fils d'un groupe inter-produit sont utilisées pour créer l'imbrication de la matrice. Les encadrements itératifs associés à ces groupes doivent donc s'imprimer selon la même orientation de page.
Action :	Modifiez l'orientation d'impression des encadrements itératifs selon les besoins, choisissez des groupes source différents pour les encadrements itératifs, ou choisissez des encadrements itératifs différents pour former les dimensions de la matrice.


REP-1275 : Colonne niveau Page '<nom de la colonne>' ne doit pas être référencée à partir du déclencheur de mise en forme '<nom de l'unité de programme>'.

Cause :	La procédure PL/SQL entrée dans le déclencheur de format (ou de mise en forme) ne peut pas faire référence à des colonnes dont le champ Remise à ou Calculer à contient Page.
Action :	Supprimez la référence à la colonne de niveau page, ou remplacez le contenu du champ Remise à ou Calculer à de la colonne par une valeur autre que Page.


REP-1276 : Colonne de réserve '<nom de la colonne>' fait référence à une ou des colonnes qui ne sont pas des colonnes de formule.

Cause :	Une colonne de réserve contient SRW.REFERENCE, mais la colonne à laquelle il est fait référence n'est pas une colonne de formule. Pour les colonnes de réserve, SRW.REFERENCE doit faire référence à une colonne de formule.
Action :	Modifiez la colonne à laquelle il est fait référence, en utilisant SRW.REFERENCE.


REP-1277 : Elément de sélection non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1278 : Procédure PL/SQL non valide dans '<nom de l'unité de programme>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1279 : Encadrement ou encadrement itératif '<nom de l'encadrement>' non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1280 : Champ '<nom du champ>' non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1281 : Texte standard '<nom du texte standard>' non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1282 : Matrice '<nom de la matrice>' non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1283 : Document graphique '<nom du graphique>' non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1284 : L'interrogation '<nom de l'interrogation>' n'a pas de groupe.

Cause :	Votre modèle de données contient une interrogation sans groupe. Chaque interrogation de votre modèle de données doit avoir au moins un groupe associé.
Action :	Créez un nouveau groupe pour l'interrogation.


REP-1285 : L'interrogation '<nom de l'interrogation>' ne contient aucune instruction Select.

Cause :	Votre modèle de données contient une interrogation qui ne comporte aucune instruction SELECT. Chaque interrogation de votre modèle de données doit sélectionner au moins un élément.
Action :	Entrez dans l'interrogation une instruction SELECT qui sélectionne au moins un élément.


REP-1286 : Le groupe '<nom du groupe>' est tant un groupe inter-produit qu'un groupe dimension.
REP-1286 : Le groupe '<nom du groupe>' est un groupe inter-produit autant qu'un groupe dimension.

Cause :	Vous avez indiqué qu'un groupe doit être à la fois un groupe inter-produit et un groupe dimension pour un autre groupe inter-produit, ce qui est interdit.
Action :	Indiquez que le groupe est soit un groupe inter-produit soit un groupe dimension, mais pas les deux.


REP-1287 : Le groupe inter-produit '<nom du groupe>' ne peut avoir de filtre de groupe.

Cause :	Vous avez indiqué un filtre de groupe dans un groupe inter-produit, ce qui est interdit.
Action :	Supprimez le filtre de groupe du groupe inter-produit. Si nécessaire, créez le filtre de groupe pour un autre groupe.


REP-1288 : Omission d'argument numérique pour filtre de groupe '<nom du groupe>'.

Cause :	Vous avez indiqué Premier ou Dernier pour un filtre de groupe, mais vous n'avez pas indiqué combien le groupe doit filtrer d'enregistrements.
Action :	Indiquez une valeur numérique pour le filtre de groupe.


REP-1289 : Type de filtre de groupe indiqué dans groupe '<nom du groupe>' non mis en place.

Cause :	Vous avez indiqué un filtre de groupe qui n'est pas disponible ou qui est erroné.
Action :	Indiquez un filtre de groupe valide pour le groupe.


REP-1290 : Type de données source incompatible avec la fonction récapitulative de la colonne '<nom de la colonne>'.

Cause :	Vous avez attribué à votre colonne récapitulative une source dont le type de données est incompatible avec la fonction indiquée. Par exemple, vous avez peut-être demandé le calcul de la somme d'une colonne de type caractère.
Action :	Assurez-vous que le type de données de votre colonne source est compatible avec la fonction que vous avez indiquée dans la palette de propriétés Colonne récapitulative.


REP-1291 : Groupe Remise à la colonne '<nom de la colonne>' non valide.
REP-1291 : Groupe Remise à de la colonne '<nom de la colonne>' non valide.

Cause :	Vous avez indiqué, pour une colonne récapitulative, une valeur de Remise à qui était erronée. La valeur Remise à peut être définie pour le même groupe que la colonne récapitulative, tout groupe au-dessus de la colonne récapitulative, Page ou Etat.
Action :	Indiquez une valeur Remise à valide pour la colonne récapitulative dans sa palette de propriétés.


REP-1292 : Groupe Calcul de la colonne '<nom de la colonne>' non valide.

Cause :	Vous avez indiqué, pour une colonne récapitulative, une valeur de Calculer à qui était erronée. La valeur Calculer à peut être définie pour le même groupe que la colonne récapitulative, tout groupe au-dessus de la colonne récapitulative, Page ou Etat.
Action :	Indiquez une valeur Calculer à valide pour la colonne récapitulative dans sa palette de propriétés.


REP-1293 : Ordre de produit de la colonne '<nom de la colonne>' non valide.

Cause :	Vous avez attribué à une colonne d'un groupe inter-produit une valeur erronée pour Ordre de produit, ou vous n'avez indiqué aucune valeur.
Action :	Indiquez une valeur valide pour Ordre de produit (composée uniquement de groupes de dimension dans l'inter-produit) dans la palette de propriétés de la colonne.


REP-1294 : La largeur de colonne '<nom de la colonne>' dépasse limite autorisée.

Cause :	La largeur de la colonne est supérieure au maximum autorisé pour votre système d'exploitation.
Action :	Diminuez la largeur de la colonne dans la palette de propriétés Colonne.


REP-1295 : Format de données de la colonne '<nom de la colonne>' non accepté.

Cause :	Vous avez activé Lecture depuis fichier pour une colonne, mais le format de données que vous avez indiqué dans le champ Format de la palette de propriétés Colonne est erroné ou non disponible.
Action :	Indiquez dans le champ Format un format de données valide. La liste de valeurs affiche tous les formats valides. Notez que pour les colonnes de la base de données de type LONG, RAW et LONG RAW, les seules valeurs valides pour Format sont Texte et Format Oracle (Image).


REP-1296 : Une liaison de données fils ne peut appartenir à un groupe inter-produit '<nom du groupe>'.;
REP-1296 : Une liaison de données fils ne peut appartenir à un groupe inter-produit '<nom du groupe>'.

Cause :	Vous avez tenté de lier une colonne à une colonne d'un groupe inter-produit, ou au groupe inter-produit lui-même, ce qui est interdit.
Action :	Créez des liaisons de données entre des colonnes et des groupes autres que des groupes inter-produit et les colonnes qui leur sont associées.


REP-1297 : La colonne fils de liaison de données '<nom de la colonne>' doit être une colonne de base de données.

Cause :	Vous avez tenté de lier une colonne à une autre qui n'est pas une colonne de base de données (par exemple, une colonne récapitulative, de formule ou de réserve), ce qui est interdit.
Action :	Pour créer des liaisons de données, vous devez utiliser uniquement des groupes et des colonnes de base de données.


REP-1298 : Les colonnes '<nom de la colonne>' et '<nom de la colonne>' ont des types incompatibles ; ne peuvent être liés.

Cause :	Les colonnes père et fils de votre liaison de données ont des types de données incompatibles qui ne peuvent pas être liées. Vous avez, par exemple, tenté de lier une colonne de type Number à une colonne de type Character.
Action :	Assurez-vous que les colonnes père et fils que vous indiquez dans les liaisons de données ont des types de données compatibles.


REP-1299 : Les groupes '<nom du groupe>' et '<nom du groupe>' appartiennent à différents groupes inter-produits ; ne peuvent être liés.

Cause :	Vous avez tenté de créer une liaison de données entre des groupes dimensions de deux groupes inter-produit différents, ou entre des colonnes de groupes dimensions, ce qui est interdit.
Action :	Vous ne pouvez pas créer de liaisons de données entre deux groupes inter-produit différents ou entre leurs colonnes.


REP-1300 : Le texte standard '<nom du texte standard>' n'a pas de contenu.

Cause :	Vous avez créé un objet texte standard qui ne contient pas de texte.
Action :	Entrez du texte dans l'objet texte standard ou supprimez-le.


REP-1301 : Création d'un groupe frère '<nom du groupe>' par la liaison de données, dans groupe inter-produit.

Cause :	Vous avez créé une liaison de données créant un groupe frère pour un groupe dimension d'un groupe inter-produit. Aucun groupe frère de groupe dimension n'est autorisé dans le groupe inter-produit.
Action :	Les groupes dimension ne peuvent se composer que de chaînes de groupes. Aucun groupe frère n'est autorisé.


REP-1302 : Le groupe inter-produit comprend deux groupes fils ou plus.

Cause :	Un groupe inter-produit a plusieurs groupes fils, alors qu'un seul groupe est autorisé.
Action :	Supprimez tous les groupes fils du groupe inter-produit sauf un.


REP-1303 : L'interrogation doit être complètement à l'intérieur/extérieur du groupe inter-produit '<nom du groupe>'.

Cause :	Vous avez créé une interrogation dont les groupes ne se trouvent pas tous, respectivement, dans le groupe inter-produit, au-dessus du groupe inter-produit, ou en dessous du groupe inter-produit.
Action :	Assurez-vous que les groupes de chaque interrogation se trouvent tous dans un groupe inter-produit, au-dessus d'un groupe inter-produit ou en dessous d'un groupe inter-produit.


REP-1304 : Le groupe inter-produit '<nom du groupe>' contient un autre groupe inter-produit comme fils.

Cause :	Vous avez créé un groupe inter-produit qui est un fils d'un autre groupe inter-produit, ce qui est interdit.
Action :	Assurez-vous que le groupe fils du groupe inter-produit n'est pas lui-même un groupe inter-produit.


REP-1305 : Avertissement ! L'encadrement '<nom de l'encadrement>' coupe mais n'entoure pas l'objet '<nom de l'objet>'.

Cause :	Votre présentation d'état contient un encadrement qui n'entoure pas complètement l'objet nommé. L'objet n'est donc pas considéré comme se trouvant dans l'encadrement.
Action :	Si vous voulez que l'encadrement entoure l'objet, redimensionnez ou déplacez l'encadrement.


REP-1306 : La source de la colonne récapitulative '<nom de la colonne>' n'est pas valide.

Cause :	Vous avez indiqué une source erronée pour la colonne récapitulative. La source d'une colonne récapitulative doit provenir du même groupe que la colonne récapitulative, ou d'un groupe se trouvant en dessous de celle-ci.
Action :	Modifiez la source de la colonne récapitulative pour qu'elle provienne du même groupe que la colonne récapitulative ou d'un groupe en dessous de celle-ci.


REP-1307 : L'ordre produit de la colonne récapitulative '<nom de la colonne>' n'est pas valide.

Cause :	Causes possibles :
	Cas 1 :	Vous avez une colonne récapitulative qui n'est pas une colonne récapitulative courante (c'est-à-dire une colonne récapitulative dont le champ Remise à ne contient pas Etat), mais dont l'Ordre produit n'est pas un sous-ensemble de l'ordre produit de la colonne source. La colonne source de la colonne récapitulative doit être au moins aussi fréquente que la colonne récapitulative, ce qui signifie que l'Ordre produit de la colonne récapitulative doit être un sous-ensemble de l'Ordre produit de la colonne source.
	Cas 2 :	Vous avez une colonne récapitulative courante (c'est-à-dire dont le champ Remise à contient Etat), avec un Ordre produit qui n'est pas un préfixe de l'Ordre produit de la colonne source. Par exemple, si l'Ordre produit de la colonne source est A, B, C, l'Ordre produit de la colonne récapitulative doit être soit A (seul), soit A, B. L'Ordre produit de la colonne récapitulative ne peut pas être B, A.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Modifiez l'Ordre produit de la colonne récapitulative afin qu'il soit un sous-ensemble de l'Ordre produit de sa colonne source.
	Cas 2 :	Modifiez l'Ordre produit de la colonne récapitulative afin qu'il soit un préfixe de l'Ordre produit de la colonne source.


REP-1308 : Colonne de réserve '<nom de la colonne>' non acceptée dans groupe inter-produit.

Cause :	Vous avez tenté de créer une colonne de réserve dans un groupe inter-produit. Les groupes inter-produit ne peuvent pas contenir de colonnes de réserve.
Action :	Supprimez la colonne de réserve ou placez-la à l'extérieur du groupe inter-produit.


REP-1309 : La colonne récapitulative '<nom de la colonne>' de niveau Etat ne peut être un pourcentage du total.

Cause :	Vous avez créé une colonne récapitulative au niveau état (c'est-à-dire une colonne récapitulative à l'extérieur de tous les groupes du modèle de données) ayant pour fonction % Total. Cette fonction n'a pas de sens pour une colonne récapitulative de niveau état qui aura toujours la valeur 100 %.
Action :	Supprimez la colonne récapitulative ou faites-la passer dans un groupe dans lequel elle sera significative.


REP-1310 : Le texte standard '<nom du texte standard>' fait référence à '&<nom de la référence>' qui n'est pas un champ.

Cause :	Un objet de texte standard comporte une référence à un champ qui n'existe pas. Il est possible que le champ auquel il est fait référence ait été supprimé ou renommé et que cette référence, dans l'objet de texte standard, soit donc erronée.
Action :	Selon les cas, vous pouvez supprimer la référence, la remplacer par une référence à un autre champ ou créer le champ auquel elle fait référence.


REP-1311 : Objet '<nom de l'objet>' avec références page changé en taille fixe.

Cause :	Un champ ou un objet de texte standard comporte une référence à un calcul de page ou à un nombre total de pages variable (référence d'avance). Ces objets de présentation doivent avoir une taille horizontale et verticale fixe.
Action :	La taille verticale et horizontale de l'objet a été définie à Fixe par Report Builder. Vérifiez sur la sortie que les valeurs ne sont pas tronquées. Si elles le sont, agrandissez l'objet de présentation pour qu'il puisse contenir les valeurs.


REP-1312 : Colonne niveau page '<nom de la colonne>' ne doit pas être référencée à partir du graphique '<nom du graphique>'.

Cause :	L'une des colonnes de Report Builder que vous avez tenté de transmettre à un graphique est une colonne récapitulative de niveau page ou en dépend (c'est-à-dire une colonne récapitulative dont le champ Remise à ou Calculer à contient Page). Une colonne transmise à un graphique ne peut pas être une colonne récapitulative de niveau page ni en dépendre.
Action :	Ne transmettez pas la colonne au graphique.


REP-1313 : Colonne niveau page '<nom de la colonne>' ne doit pas être référencée à partir d'un filtre de groupe '<nom du groupe>'.

Cause :	L'une des colonnes de Report Builder à laquelle vous avez tenté de faire référence dans un filtre de groupe est une colonne récapitulative de niveau page ou en dépend (c'est-à-dire une colonne récapitulative dont le champ Remise à ou Calculer à contient Page). Une colonne à laquelle un filtre de groupe fait référence ne peut pas être une colonne récapitulative de niveau page ni en dépendre.
Action :	Ne faites pas référence à la colonne dans le filtre de groupe.


REP-1314 : Le filtre groupe '<nom de l'unité de programme>' référence une colonne '<nom de la colonne>' à une fréquence erronée.
REP-1314 : Déclencheur de mise en forme '<nom de l'unité de programme>' référence une colonne '<nom de la colonne>' à une mauvaise fréquence.

Cause :	L'un de vos déclencheurs de format fait référence à une colonne localisée sur une fréquence inappropriée.
Action :	Supprimez du déclencheur de format la référence à la colonne.


REP-1315 : Le filtre groupe '<nom de l'unité de programme>' référence une colonne '<nom de la colonne>' à une fréquence erronée.

Cause :	L'un de vos filtres de groupe a tenté de faire référence à une colonne inaccessible.
Action :	Supprimez du filtre de groupe la référence à la colonne.


REP-1316 : <Nom de l'objet> référence une colonne '<nom de la colonne>' à une fréquence erronée.

Cause :	Une procédure ou une fonction a tenté de faire référence à une colonne inaccessible.
Action :	Supprimez du sous-programme PL/SQL la référence à la colonne.


REP-1317 : Le texte standard '<nom du texte standard>' fait référence à '<nom de la colonne>' à une mauvaise fréquence.

Cause :	L'objet texte standard fait référence au champ utilisant &nomchamp, mais les deux objets ne sont pas situés à la même fréquence. Par exemple, l'objet de texte standard et le champ auquel il fait référence se trouvent dans des encadrements itératifs différents.
Action :	Donnez à l'objet de texte standard et au champ la même fréquence, ou supprimez la référence.


REP-1318 : Erreur lors de la définition de transaction lecture seule.

Cause :	Vous avez indiqué READONLY=YES, et cette erreur s'est produite au début de l'exécution de l'état, à la fin de la transaction en cours (par COMMIT) et au début de la transaction de lecture seule, ou à la fin de l'exécution de l'état, pendant la fin de la transaction de lecture seule (par COMMIT).
Action :	Assurez-vous que vous êtes connecté à une base de données et que la transaction précédente n'a laissé ni curseur ni verrou en attente.


REP-1319 : Avertissement ! Algorithme d'ancrage implicite ne peut identifier uniquement objet d'ancrage de '<nom de l'objet 1>'. Choix arbitraire '<nom de l'objet 2>'.

Cause :	L'objet indiqué (nom de l'objet 1) est dans le "push path" de deux objets et se trouve à égale distance des deux. Report Builder ne peut donc pas utiliser ses critères normaux (distance la plus courte) pour déterminer le point d'ancrage implicite. En l'absence de ses critères normaux, Report Builder crée de manière aléatoire un système d'ancrage implicite à l'objet indiqué (nom de l'objet 2). Notez que le point d'ancrage implicite peut varier d'une exécution de l'état à l'autre. Pour plus d'informations, reportez-vous à Ancrage implicite.
Action :	Pour éviter la création aléatoire d'un point d'ancrage implicite, ancrez explicitement l'objet indiqué (nom de l'objet 1) à un autre objet.


REP-1320 : L'unité de programme '<nom de l'unité de programme>' fait référence à une colonne dont l'ID est incorrect : <ID de la colonne>.

Cause :	Vous avez exécuté un état avec un PL/SQL erroné (c'est-à-dire non compilé). La source du PL/SQL comprenait une référence à colonne qui ne peut pas être résolue.
Action :	Vérifiez les références de colonne dans la source de votre PL/SQL, recompilez toute la source du PL/SQL de l'état et ré-exécutez l'état.


REP-1322 : Saut de page après '<nom de l'objet>' sans aucun effet.

Cause :	Vous avez activé Saut de page après pour un objet auquel n'est ancré (implicitement ou explicitement) aucun autre objet. Dans ce cas, Saut de page après est sans effet et n'est pas valide. Notez qu'il ne s'agit que d'un message d'avertissement, et non d'un message d'erreur.
Action :	Désactivez Saut de page après pour l'objet.


REP-1323 : Impossible d'avoir colonnes de sortie dans déclencheur de mise en forme '<nom de l'unité de programme>'.

Cause :	Dans le déclencheur de format (ou de mise en forme) de l'objet indiqué, vous avez tenté de définir la valeur d'un paramètre de colonne de Report Builder. Vous pouvez en effet utiliser la valeur d'une colonne appelée NOMBRE1 dans une condition (par exemple, IF:NOMBRE1 = 10), mais vous ne pouvez pas définir directement sa valeur dans une instruction d'affectation (par exemple, NOMBRE1 = 10).
Action :	Supprimez l'instruction d'affectation du déclencheur de format.


REP-1324 : Impossible d'avoir colonnes de sortie dans filtre groupe '<nom du groupe>'.

Cause :	Dans le filtre du groupe indiqué, vous avez tenté de définir la valeur d'une colonne ou d'un paramètre de Report Builder. Vous pouvez en effet utiliser la valeur d'une colonne appelée NOMBRE1 dans une condition (par exemple, IF:NOMBRE1 = 10), mais vous ne pouvez pas définir directement sa valeur dans une instruction d'affectation (par exemple, NOMBRE1 = 10).
Action :	Supprimer l'instruction d'affectation du filtre de groupe.


REP-1325 : Impossible d'avoir colonnes de sortie dans déclencheur Between Page.
REP-1325 : Impossible d'avoir colonnes de sortie dans déclencheur Between Page

Cause :	Dans le déclencheur Between Page, vous avez tenté de définir la valeur d'une colonne ou d'un paramètre de Report Builder. Vous pouvez en effet utiliser la valeur d'une colonne appelée NOMBRE1 dans une condition (par exemple, IF:NOMBRE1 = 10), mais vous ne pouvez pas définir directement sa valeur dans une instruction d'affectation (par exemple, NOMBRE1 = 10).
Action :	Supprimer l'instruction d'affectation du filtre de groupe.


REP-1326 : <nom du déclencheur> écrit dans colonne '<nom de la colonne>' à une fréquence erronée.

Cause :	Dans un déclencheur d'état, vous avez tenté de définir la valeur d'une colonne de Report Builder à une fréquence erronée dans l'état. Vous ne pouvez référencer et définir que des colonnes ou des paramètres de niveau état, à l'exclusion des colonnes dépendant de pages (c'est-à-dire dont le champ Remise à comporte Page) ou des colonnes qui font appel à des colonnes dépendant de pages.
Action :	Assurez-vous que les colonnes et les paramètres dont vous référencez ou définissez les valeurs sont des colonnes et des paramètres de niveau état.


REP-1327 : Colonne '<nom de la colonne>' écrit dans colonne '<nom de la colonne>' à une fréquence erronée.

Cause :	Dans une colonne de formule, vous avez tenté de définir la valeur d'une colonne de Report Builder à une fréquence erronée dans l'état. Vous pouvez référencer et définir uniquement des colonnes qui se trouvent dans le même groupe ou dans un groupe supérieur dans la hiérarchie des groupes. Par exemple, une formule pour une colonne de niveau état ne peut référencer que d'autres colonnes de niveau état.
Action :	Assurez-vous que les colonnes dont vous référencez ou définissez les valeurs se trouvent dans le même groupe ou dans un groupe supérieur de la hiérarchie des groupes.


REP-1328 : Impossible de lancer un état contenant une colonne ROWLABEL '<nom de la colonne>' dans un OS non sécurisé.

Cause :	Vous tentez d'exécuter un état qui demande une base de données sécurisée, alors que vous êtes connecté à une base de données non sécurisée.
Action :	Exécutez l'état lorsque vous êtes connecté à une base de données sécurisée.


REP-1329 : Colonne '<nom de la colonne>' ne peut être liée avec colonne '<nom de la colonne>', la colonne fils n'était pas une colonne de base de données.

Cause :	Vous avez créé une liaison de données dans laquelle la colonne fils est une colonne de réserve, de formule ou récapitulative. Vous ne pouvez lier que des colonnes de base de données.
Action :	Créez une liaison de données en utilisant des colonnes de base de données.


REP-1330 : Le paramètre lexical '<nom du paramètre>' dans interrogation '<nom de l'interrogation>' ne doit pas modifier les dépendances colonne.

Cause :	Vous avez créé un paramètre lexical qui modifie le numéro, le type ou le nom de colonne, ou introduit de nouvelles dépendances dans les colonnes calculées ou de nouvelles références de liaison lors de l'exécution de l'état.
Action :	Modifiez le paramètre lexical afin qu'il n'affecte pas les colonnes ou n'introduise pas de nouvelles dépendances ou références de liaison.


REP-1331 : La colonne '<nom de la colonne>' ne peut être liée avec col. '<nom de la colonne>', la colonne fils étant déterminée par un param. lexical.

Cause :	Vous avez créé une liaison de données dans laquelle la valeur de la colonne fils est déterminée par un paramètre lexical, ce qui est interdit.
Action :	Remplacez la colonne fils de la liaison de données par une autre colonne.


REP-1332 : Filtre groupe pour '<nom du groupe>' ne peut référencer colonne '<nom de la colonne>', car colonne de base de données non valide ou dépend d'une interro associée.

Cause :	Vous avez créé un filtre de groupe qui fait référence à une colonne de base de données qui ne figure pas dans l'interrogation du groupe ou dans une interrogation se trouvant au-dessus de celui-ci, ou qui fait référence à une colonne calculée qui dépend d'une colonne non liée.
Action :	Supprimez du filtre de groupe la référence qui pose problème.


REP-1333 : Présentation non acceptée ; une matrice ne peut en inclure une autre.

Cause :	Vous avez créé une présentation de matrice imbriquée dans une autre.
Action :	Les présentations de matrice ne peuvent pas être imbriquées les unes dans les autres. Modifiez votre présentation en conséquence.


REP-1335 : Avertissement ! Texte à rotation variable '<nom du texte standard>' considéré comme largeur fixe/contractée.

Cause :	Votre état contient un objet texte standard qui, à la suite d'une rotation, se trouve à un angle qui n'est pas un multiple de 90 degrés, bien que les valeurs Elasticité horizontale et verticale aient été définies à Variable ou Développer. Dans ce cas, l'Elasticité horizontale est considérée comme Fixe (si vous avez indiqué Développer) ou Contracter (si vous avez indiqué Variable) et ce message d'avertissement s'affiche.
Action :	Vous pouvez modifier les valeurs Elasticité horizontale et verticale de cet objet texte standard.


REP-1336 : La source du champ '<nom du champ>' est calculée au niveau Page '<nom de la colonne>'. <nom du groupe>.

Cause :	Le champ indiqué fait référence à un récapitulatif de page qui appartient au groupe indiqué, mais il n'y a pas pour ce groupe d'encadrement itératif qui entoure le champ.
Action :	Créez, pour le champ, un encadrement itératif dont la Source est le groupe indiqué. Si cet encadrement itératif existe déjà, étendez-le pour qu'il entoure le champ.


REP-1337 : L'objet standard '<nom du texte standard>' fait référence au champ '<nom du champ>', dont la source est calculée au niveau Page '<nom de la colonne>'. <nom du groupe>.

Cause :	L'objet standard indiqué fait référence au champ indiqué dont la Source est calculée au niveau page. Cependant, le champ n'est pas entouré d'un encadrement itératif (dont la Source est le groupe indiqué).
Action :	Créez, pour le champ, un encadrement itératif dont la Source est le groupe indiqué. Si cet encadrement itératif existe déjà, étendez-le pour qu'il entoure le champ.


REP-1338 : Mode colonne non autorisé dans encadrement itératif '<nom de l'encadrement>'.

Cause :	Vous avez activé Mode Colonne pour un encadrement itératif dont la définition ne répond à aucune des conditions suivantes :
	Orientation d'impression Vers le bas et Elasticité verticale Fixe.
	Orientation d'impression De gauche à droite et Elasticité horizontale Fixe.
Action :	Modifiez l'orientation d'impression ou l'Elasticité verticale/horizontale de l'encadrement itératif, ou désactivez Mode Colonne.


REP-1339 : Absence de spécification colonnes de données dans graphique '<nom du graphique>'.

Cause :	Vous avez indiqué une valeur pour le graphique Interrogation, mais vous n'avez pas indiqué de colonnes à transférer de l'état au document graphique.
Action :	Si vous ne voulez pas transférer des données de l'état au document graphique, laissez les colonnes Interrogation et Source du graphique non renseignées. Si vous voulez transférer des données, indiquez les colonnes à transférer en plus de Interrogation et Source du graphique.


REP-1340 : Impossible de faire concorder des colonnes 'Passed-in' avec définition d'état '<nom de l'état>'.

Cause :	Cette erreur se produit lorsqu'un autre composant (par exemple, Form Builder) transfère une interrogation à Report Builder et que les colonnes transférées ne correspondent pas aux colonnes attendues par Report Builder. Causes possibles :
	Cas 1 :	Report Builder attend un nombre de colonnes supérieur ou inférieur à celui qui lui a été transféré par l'application appelante.
	Cas 2 :	La description d'une colonne fournie par la liste des paramètres de l'application appelante est différente de la description attendue par Report Builder. Cette erreur apparaît, par exemple, si l'interrogation de l'état sélectionne une colonne de type caractère et que l'application appelante affecte à cette colonne des données de type date.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que l'application appelante transfère le nombre de colonnes qu'attend Report Builder.
	Cas 2 :	Assurez-vous que les noms et les types de données des colonnes transférées par l'application appelante correspondent aux types et aux noms de l'état.


REP-1341 : Avertissement ! Des données peuvent être tronquées dans la colonne '<nom de la colonne>'.

Cause :	La largeur de la colonne de la base de données définie pour l'état est inférieure à sa largeur dans la base de données. Ce problème peut se poser lorsque les colonnes de la base de données sont mises à jour à la suite de la création de la définition de l'état.
Action :	Imposez une nouvelle analyse de l'interrogation. Pour cela, vous pouvez entrer un espace à la fin d'une ligne du champ Instruction SELECT, puis accepter la boîte de dialogue Instruction d'interrogation SQL.


REP-1342 : Type de liaison de données à interroger '<nom de l'interrogation>' non autorisé pour serveur non-ORACLE.
REP-1342 : Type de liaison de données à interroger '<nom de l'interrogation>' : non autorisé pour serveur non-ORACLE.

Cause :	Ce message d'erreur apparaît si vous créez une liaison de données avec la clause START WITH et que vous l'exécutiez lorsque vous êtes connecté à une base de données non ORACLE. La clause START WITH n'est supportée que par ORACLE.
Action :	Supprimez la liaison de données qui utilise START WITH ou connectez-vous à ORACLE.


REP-1343 : Bouton '<nom du bouton>' non valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1344 : Le bouton '<nom du bouton>' ne comporte aucun fichier d'action source.

Cause :	Vous avez indiqué l'action Fichier multimédia pour le bouton indiqué, mais sans mentionner de fichier source, ou bien le fichier source indiqué n'existe pas.
Action :	Ouvrez la palette de propriétés du bouton indiqué et assurez-vous que vous avez choisi comme source de l'action du bouton un fichier valide. Pour plus d'informations, reportez-vous à Propriétés de bouton.


REP-1345 : Le bouton '<nom du bouton>' comporte une colonne source non valide.

Cause :	Vous avez indiqué l'action Colonne multimédia pour le bouton indiqué, mais sans indiquer de colonne source, ou bien la colonne indiquée n'est pas valide.
Action :	Ouvrez la palette de propriétés du bouton indiqué et assurez-vous que vous avez choisi comme source de l'action du bouton une colonne valide. Pour plus d'informations sur les boutons créés par l'utilisateur, reportez-vous à Propriétés de bouton.


REP-1346 : Le bouton '<nom du bouton>' fait référence à une colonne source '<nom de la colonne>' à une fréquence erronée.

Cause :	La colonne indiquée dans la palette de propriétés pour le bouton indiqué se trouve dans un groupe inférieur à celui de l'encadrement itératif qui entoure le bouton.
Action :	Faites passer le bouton dans un encadrement itératif dont le groupe source est au niveau ou au-dessus du groupe qui contient la colonne indiquée. Sinon, faites passer, si possible, la colonne indiquée dans le groupe de l'encadrement itératif qui l'entoure.


REP-1347 : Le bouton '<nom du bouton>' comporte un fichier d'icône erroné.

Cause :	Vous avez indiqué comme fichier d'icône pour le bouton soit un fichier erroné, soit un fichier qui n'existe pas.
Action :	Assurez-vous que le fichier d'icône existe, a le format voulu et n'est pas altéré.


REP-1348 : La colonne source du champ '<nom du champ>' est au format son ou vidéo.

Cause :	Vous avez indiqué comme source d'un champ une colonne contenant des sons ou de la vidéo, mais les champs ne peuvent pas afficher de son ni de vidéo.
Action :	Indiquez une autre colonne (ni son, ni vidéo) comme source du champ.


REP-1349 : Procédure PL/SQL absente pour le bouton '<nom du bouton>'.

Cause :	Le déclencheur PL/SQL qui sert d'action pour le bouton indiqué fait référence à un élément de procédure PL/SQL qui n'existe pas.
Action :	Déboguez votre déclencheur et assurez-vous qu'il fait référence à une unité de programme valide.


REP-1350 : Déclencheur d'action '<nom de l'unité de programme>' : colonnes de sortie impossibles.

Cause :	Le déclencheur PL/SQL qui sert d'action de bouton contient une variable de liaison qui retourne une valeur. Un déclencheur d'action PL/SQL ne peut pas retourner de valeur.
Action :	Supprimez la variable de liaison de votre déclencheur PL/SQL.


REP-1351 : Avertissement ! Icône '<nom de l'icône>' du bouton '<nom du bouton>' non trouvée.

Cause :	L'icône que vous avez indiquée comme bouton pour le bouton indiqué est introuvable. L'état s'exécutera mais le bouton apparaîtra vierge.
Action :	Ouvrez la palette de propriétés du bouton indiqué et assurez-vous que l'icône existe bien, avec le format correct, et que vous avez indiqué un chemin d'accès correct.


REP-1352 : Les polices appliquées à cet état n'existent pas dans le jeu de caractères indiqué dans NLS_LANG.

Cause :	La variable d'environnement NLS_LANG indique un jeu de caractères pour lequel il n'existe aucune police.
Action :	Choisissez une police qui existe dans le jeu de caractères indiqué par NLS_LANG. Vous pouvez également utiliser le fichier des alias de police pour obliger le système à utiliser une police disponible, au lieu de celle indiquée dans l'état.


REP-1353 : La propriété Web de l'objet de présentation '<nom de l'objet de présentation>' fait référence au champ ou à la colonne '<nom du champ ou de la colonne>' à une fréquence incorrecte.

Cause :	L'une des propriétés de l'objet de présentation : Signet, Action, Hyperlien ou Linktag fait référence au champ ou à la colonne &nomcolonne, mais les deux objets ne sont pas à la même fréquence. Par exemple, l'objet de présentation se trouve dans un encadrement itératif dont la source est un groupe différent de celui dans lequel se trouve la colonne.
Action :	Placez l'objet de présentation dans un encadrement itératif à la même fréquence que l'objet de la colonne, ou supprimez la référence.


REP-1354 : La propriété Web de l'objet de présentation '<nom de l'objet de présentation>' fait référence à la colonne ou au champ fondé sur des calculs de pages '<nom du champ ou de la colonne>'.

Cause :	L'une des propriétés de l'objet de présentation : Signet, Action, Hyperlien ou Linktag fait référence à un objet standard de champ comportant une référence à un calcul de page ou à un nombre total de pages variable. Les propriétés du Web ne peuvent faire référence qu'à des colonnes et à des champs qui ne sont pas fondés sur des calculs de page.
Action :	Supprimez la référence de la propriété du Web au champ ou à la colonne fondés sur des calculs de page.


REP -1355 : PL/SQL manquant dans l'interrogation PL/SQL '$0'.

Cause :	Vous avez créé une interrogation basée sur PL/SQL, mais vous n'avez entré aucun code PL/SQL.
Action :	Entrez le code PL/SQL de l'interrogation.


REP 1356 : Lien de colonne non autorisé pour relier l'interrogation PL/SQL '$0'.
REP -1356 : Lien de colonne non autorisé pour relier l'interrogation PL/SQL '$0'.

Cause :	Vous avez essayé de lier une colonne à une autre colonne qui se trouve dans une interrogation basée sur PL/SQL, comme variables liées pour définir des conditions de liaison de colonne.
Action :	Vous pouvez créer des liaisons de groupe et utiliser les colonnes d'une interrogation basée sur PL/SQL comme variables liées pour définir des conditions de liaison de colonne.


REP 1357 : La création automatique de liens de colonne de clé étrangère n'est autorisée que pour des interrogations SQL.
REP -1357 : La création automatique de liens de colonne de clé étrangère n'est autorisée que pour des interrogations SQL.

Cause :	Vous avez tracé un lien entre deux interrogations pour créer automatiquement des liaisons de colonnes sur la base de relations de clés étrangères. Cependant, cela ne peut se faire qu'entre deux interrogations de données SQL.
Action :	Effectuez cette opération sur deux interrogations de données SQL ou changez les interrogations basées sur PL/SQL en SQL.


REP-1365 : Lien de colonne non autorisé pour la liaison à l'interrogation Express <nom de l'interrogation>.
REP1365 : Lien de colonne non autorisé pour la liaison à l'interrogation Express <nom de l'interrogation>.

Cause :	Vous avez essayé de lier une colonne à une colonne de l'interrogation Express, ce qui n'est pas autorisé.
Action :	Vous pouvez créer des liens de groupe et utiliser les colonnes d'une interrogation Express comme variables liées pour définir des conditions de lien de colonne.


REP-1366 : Les paramètres XML de l'objet <nom de l'objet de présentation> font référence au champ ou à la colonne <nom du champ ou de la colonne> dépendant de la page.
REP 1366 : Les paramètres XML de l'objet <nom de l'objet> font référence au champ ou à la colonne <nom de la colonne> dépendant de la page.

Cause :	L'une des propriétés XML de l'objet fait référence à une colonne contenant un calcul de page ou à un nombre total de pages variable. Les paramètres XML ne peuvent pas faire référence aux colonnes de calcul de page.
Action :	Enlevez les références des paramètres XML à la colonne dépendant de la page.


REP-1367 : Les paramètres XML de l'objet <nom de l'objet> font référence au champ ou à la colonne <nom du champ ou de la colonne> à une fréquence incorrecte.
REP-1367 : Les paramètres XML de l'objet <nom de l'objet> font référence au champ ou à la colonne <nom de la colonne> à une fréquence incorrecte.

Cause :	L'une des propriétés XML de l'objet fait référence à la colonne, mais la fréquence de la colonne &nomdecolonne est supérieure à celle de cet objet (par exemple, la colonne peut appartenir à un autre groupe que celui de l'objet à laquelle il fait référence).
Action :	Déplacez l'objet pour que sa fréquence soit égale à celle du champ ou de la colonne (par exemple, ajoutez-les au même groupe ou à un groupe de niveau inférieur) à laquelle il fait référence. Vous pouvez également enlever la référence.


REP-1400 : Impossible d'initialiser coxr.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1401 : '<nom de l'unité de programme>' : Une erreur fatale PL/SQL s'est produite.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1402 : '<nom de l'unité de programme>' : Exception PL/SQL non mise en œuvre.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1403 : '<nom de l'unité de programme>' : Interruption de la procédure PL/SQL interdite.

Cause :	Un élément PL/SQL a été suspendu pendant l'exécution ou la génération.
Action :	Déboguez et recompilez vos éléments PL/SQL.


REP-1404 : Echec de compilation pour une raison non déterminée.

Cause :	Pendant la génération de votre état, la compilation PL/SQL a échoué.
Action :	Déboguez vos éléments PL/SQL.


REP-1405 : Code non exécutable.

Cause :	Un élément PL/SQL ne s'est pas compilé correctement ou, pour une autre raison, n'a pas pu s'exécuter.
Action :	Déboguez vos éléments PL/SQL.


REP-1406 : Impossible d'exécuter directement code paramétré.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1408 : Impossible d'initialiser PL/SQL.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1412 : Fonction PL/SQL '<nom de l'unité de programme>' a ramené une valeur erronée ou aucune valeur.

Cause :	Votre état contient une fonction PL/SQL qui n'indique pas de valeur de retour (par exemple, un déclencheur de format qui ne retourne ni TRUE ni FALSE).
Action :	Assurez-vous que la fonction comporte une instruction de retour pour chaque chemin de code.


REP-1414 : '<nom de l'unité de programme>' : Unité lib à exécuter introuvable.

Cause :	Très probablement une condition anormale.
Action :	Vérifiez votre code PL/SQL et recompilez-le. Si cette erreur se reproduit, reportez-vous à Conditions anormales.


REP-1415 : '<nom de l'unité de programme>' : Sortie utilisateur '<nom de la sortie utilisateur>' inconnue.

Cause :	La sortie utilisateur appelée est introuvable.
Action :	Assurez-vous que vous avez indiqué un nom de sortie utilisateur correct et que cette sortie a été compilée et liée.


REP-1416 : '<nom de l'unité de programme>' : Sortie utilisateur '<nom de la sortie utilisateur>'. <sous-message>.

Cause :	Il s'est produit une erreur dans une sortie utilisateur. Causes possibles : une référence à une colonne inconnue, une valeur de colonne tronquée, une source PL/SQL impossible à extraire ou la sortie utilisateur introuvable.
Action :	Selon le sous-message, déboguez la sortie utilisateur : assurez-vous que les colonnes référencées sont valides, et que le code PL/SQL et la sortie utilisateur sont accessibles. Liez les bibliothèques aux sorties utilisateur afin de permettre l'exécution de l'état en mode autonome.


REP-1417 : '<nom de l'unité de programme>' : Argument entier erroné transmis à <nom de la procédure>.

Cause :	La procédure en package à laquelle vous avez fait référence attendait un entier comme argument, mais vous n'en avez pas indiqué.
Action :	Assurez-vous que la procédure PL/SQL qui fait référence à la procédure en package lui a transmis correctement un entier. Pour plus d'informations sur les procédures en package PL/SQL, reportez-vous à Report Builder PL/SQL Package : SRW.


REP-1418 : '<nom de l'unité de programme>' : Arguments non renseignés transmis à <nom de la procédure>.

Cause :	L'exception SRW.NULL_ARGUMENTS a été générée soit par un sous-programme PL/SQL défini par l'utilisateur, soit par transmission d'un ou plusieurs arguments non renseignés par un sous-programme en package.
Action :	Recherchez le code PL/SQL pouvant générer cette exception. Vérifiez également la liste des arguments transmis au sous-programme en package indiqué.


REP-1419 : '<nom de l'unité de programme>' : Abandon du programme PL/SQL.

Cause :	Un élément PL/SQL qui comportait une erreur fatale a été interrompu.
Action :	Recherchez les erreurs dans vos éléments PL/SQL.
Cause :	Les erreurs de type REP-1419 'beforerep' peuvent être liées à des fichiers .RDF endommagés.
Action :	Reconstruisez le fichier .RDF.
Cause :	Des champs d'un état tentent d'accéder à des données non disponibles pour cet état, c'est-à-dire des références PL/SQL non valides.
Action :	Assurez-vous que toutes les tables/colonnes interrogées dans l'état sont a) disponibles et b) remplies de données répondant aux paramètres définis dans l'état.


REP-1420 : '<nom de l'unité de programme>' : Erreur programme indiquée par le programme PL/SQL.

Cause :	L'exception SRW.PROGRAM_ERROR a été générée, soit par un sous-programme PL/SQL défini par l'utilisateur, soit par une condition anormale.
Action :	Recherchez le code PL/SQL pouvant générer cette exception. Si vous n'en trouvez pas, reportez-vous à Conditions anormales.


REP-1421 : '<nom de l'unité de programme>' : Tentative de manipulation d'un type incorrect de colonne dans <nom de la procédure>.
REP-1421 : '<nom de l'unité de programme>' : Tentative de manipulation d'un type incorrect de colonne dans '<nom de la procédure>'.

Cause :	Le type des données de la colonne dont vous avez transmis le nom à une procédure en package est incompatible avec la procédure en package (par exemple, la procédure en package attendait une colonne de type Character alors que vous lui avez transmis une colonne d'un autre type).
Action :	Déboguez le code PL/SQL qui fait référence aux procédures en package et assurez-vous que vous transmettez à la procédure en package le nom d'une colonne d'un type correct. Vérifiez également la syntaxe de la procédure en package pour vous assurer que votre référence est correcte. Pour plus d'informations sur les procédures en package PL/SQL, reportez-vous à Report Builder PL/SQL Package : SRW.


REP-1422 : Une procédure du même nom existe déjà.

Cause :	Vous avez tenté de créer une nouvelle procédure PL/SQL ayant le même nom qu'une procédure PL/SQL existante.
Action :	Changez le nom de la nouvelle procédure ou celui de la procédure existante.


REP-1423 : '<nom de l'unité de programme>' : Impossible de définir le nombre maximum de lignes d'une interrogation une fois l'exécution commencée.

Cause :	Vous avez utilisé la procédure en package SRW.SET_MAX_ROW pour diminuer le nombre de lignes extraites par une interrogation. Cependant, vous avez appelé SRW.SET_MAX_ROW après l'extraction de l'interrogation.
Action :	Transférez votre procédure SRW.SET_MAX_ROW au déclencheur Before Report.


REP-1424 : '<nom de l'unité de programme>' : Erreur interne lors de l'exécution de <nom de la procédure>.
REP-1424 : '<nom de l'unité de programme>' : Erreur interne lors de l'exécution de '<nom de la procédure>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1425 : '<nom de l'unité de programme>' : Erreur au cours de l'exécution du package DO_SQL - '<message incorporé>'.

Cause :	Il s'est produit une erreur pendant que Report Builder exécutait un appel SRW.DO_SQL. Ce message comporte un message Report Builder et éventuellement un message d'erreur ORACLE qui décrit précisément l'erreur qui s'est produite.
Action :	Les erreurs de SRW.DO_SQL découlent souvent d'une erreur SQL. Reportez-vous au manuel .ORACLE8 Server SQL Language Reference Manual et assurez-vous que l'instruction SQL de votre appel SRW.DO_SQL est correcte.


REP-1426 : '<nom de l'unité de programme>' : Procédure <nom de la procédure> exécutée à partir d'un contexte incorrect.

Cause :	Vous avez tenté d'appeler la procédure en package nommée à partir d'une zone non valide. Par exemple, vous ne pouvez pas appeler SRW.SET_ATTR à partir d'une formule.
Action :	Modifiez votre code PL/SQL afin qu'il n'appelle pas la procédure en package à partir de ce contexte.


REP-1427 : '<nom de l'unité de programme>' : Nom d'interrogation indiqué dans <nom de la procédure> inexistant.

Cause :	Vous avez inclus dans un déclencheur Before Report un appel à la procédure SRW.SET_MAXROW, mais l'interrogation référencée dans l'appel de procédure n'existe pas.
Action :	Modifiez l'appel à la procédure SRW.SET_MAXROW afin qu'il fasse référence à une interrogation existant dans l'état.


REP-1428 : '<nom de l'unité de programme>' : Erreur au cours de l'exécution de <nom de la procédure>.

Cause :	L'exception SRW.RUN_REPORT_FAILURE a été générée soit par un sous-programme PL/SQL défini par l'utilisateur, soit par une condition anormale après l'appel de SRW.RUN_REPORT.
Action :	Recherchez le code PL/SQL pouvant générer cette exception. Si aucun code PL/SQL n'a généré l'exception, vérifiez la chaîne de ligne de commande transmise à SRW.RUN_REPORT. Assurez-vous que l'état indiqué existe et que toutes les valeurs de paramètres sont correctes. Notez également que BATCH=NO n'est pas autorisé si l'état qui possède le code PL/SQL est appelé par une chaîne de ligne de commande contenant BATCH=YES. Pour plus d'informations, reportez-vous à SRW.RUN_REPORT.


REP-1429 : '<nom de l'unité de programme>' : <nom de la procédure> Impossible d'appeler <nom de la procédure> avec batch=no.
REP-1429 : '<nom de l'unité de programme>' : Impossible d'appeler <nom de la procédure> avec batch=no.

Cause :	Vous avez inclus un appel à la procédure SRW.RUN_REPORT avec une chaîne de ligne de commande contenant BATCH=NO, ce qui est interdit.
Action :	Supprimez BATCH=NO de la chaîne de commande SRW.RUN_REPORT.


REP-1430 : Impossible de créer fichier REP pour l'état '<nom du fichier>'. Erreurs de compilation.

Cause :	Le PL/SQL de l'état que vous tentez de convertir comporte une erreur.
Action :	Ouvrez l'état et déboguez votre PL/SQL.


REP-1433 : '<nom de l'unité de programme>' : Erreur au cours de l'exécution de la sortie utilisateur '<nom de la sortie utilisateur>'.

Cause :	Il s'est produit une erreur pendant l'exécution de la sortie utilisateur mentionnée dans le message.
Action :	Déboguez votre sortie utilisateur et assurez-vous qu'elle est liée.


REP-1434 : '<nom de l'unité de programme>' : <nom de la procédure> ne peut être appelé avec un ID utilisateur.

Cause :	Vous avez inclus un appel à la procédure SRW.RUN_REPORT avec une chaîne de ligne de commande contenant un ID utilisateur/mot de passe, ce qui est interdit.
Action :	Supprimez l'ID utilisateur/mot de passe de la chaîne de commande SRW.RUN_REPORT.


REP-1435 : '<nom de l'unité de programme>' : La valeur de la colonne '<nom de la colonne>' a été tronquée.

Cause :	Vous avez attribué à une colonne (par exemple, une colonne de réserve) une valeur trop élevée pour sa largeur, ce qui a généré l'exception SRW.TRUNCATED_VALUE. Comme l'exception n'a pas été prise en compte, cette erreur a été générée.
Action :	Augmentez la largeur de la colonne pour qu'elle contienne la valeur attribuée, ou gérez l'exception dans votre source PL/SQL.


REP-1436 : '<nom de l'unité de programme>' : Un objet référencé par PL/SQL est hors norme.

Cause :	Dans le champ Déclencheur de validation d'un paramètre, vous avez entré une source PL/SQL qui fait référence à une colonne d'un état, ce qui est interdit.
Action :	Supprimez du déclencheur de validation du paramètre la référence à la colonne de l'état.


REP-1437 : Erreur d'exécution dans l'environnement de développement PL/SQL (DE).

Cause :	Très probablement une condition anormale.
Action :	Référez-vous au message d'erreur d'environnement de développement joint, qui comporte des détails sur le problème. Si vous ne pouvez pas régler le problème vous-même, reportez-vous à Conditions anormales.


REP-1438 : Paramètre de fonction GETREF '<nom du paramètre>' doit être de type LONG, LONG RAW ou RAW.

Cause :	Le second paramètre d'un appel à CDE_MM.GET_REF indique une colonne qui n'est pas de type LONG, LONG RAW ou RAW.
Action :	Dans le second paramètre, entrez une colonne de type correct.


REP-1439 : Compilation de programmes impossible : état runtime uniquement.

Cause :	Les unités de programme proviennent d'une plate-forme étrangère ou d'une précédente version de PL/SQL.
Action :	Utilisez le fichier .rdf au lieu du fichier .rep, ou régénérez le fichier .rep.


REP-1508 : Groupe inter-produit : valeur de calcul introuvable.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1510 : Gestionnaire de groupes : impossible de lancer calcul sur colonne '<nom de colonne>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1517 : La colonne '<nom de la colonne1>' fait référence à la colonne '<nom de la colonne2>', qui a une fréquence incompatible.

Cause :	Une colonne de votre modèle de données fait référence à une autre colonne (par exemple, dans le champ Formule) de votre modèle de données, mais elles sont toutes deux attribuées à des groupes incompatibles. Cette erreur apparaît, par exemple, si une colonne de formule ayant pour Groupe Etat fait référence à une colonne de Groupe G_Emp.
Action :	Supprimez la référence de la colonne ou attribuez la colonne de référence à un groupe compatible avec celui de la colonne référencée.


REP-1518 : Gestionnaire de groupes : erreur interne <<message Oracle>> lors du traitement du groupe '<nom du groupe>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1607 : Gestionnaire d'enregistrements : colonne '<nom de colonne>' de niveau état indisponible dans rdcagt().

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1610 : Gestionnaire d'enregistrements : 'Nombre max. de lignes' défini dans interrogation avec jointure interne.

Cause :	Il est très probable que vous avez utilisé SRW.SET_MAXROW pour définir le nombre maximum de lignes dans l'interrogation de cellule d'un groupe inter-produit multi-interrogation.
Action :	Supprimez l'appel à SRW.SET_MAXROW de l'interrogation de la cellule.


REP-1760 : Erreur Utilitaire : erreur interne #1.
REP-1760 : Erreur Utilitaire : erreur interne 1.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1761 : Erreur interne <<info du contexte>> lors du traitement de <nom d'objet> '<type d'objet>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1762 : Erreur interne <<info du contexte>>.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1780 : Utilitaire de pile : erreur au cours de l'opération d'allocation.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1781 : Utilitaire de pile : erreur au cours de l'opération 'push'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1782 : Utilitaire de pile : erreur au cours de l'opération 'pop'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1783 : Utilitaire de pile : tentative effectuée pour remonter une pile vide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1800 : Erreur du programme de formatage.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1801 : Champ 'Lire dans fichier' : type de fichier inconnu.

Cause :	Vous avez tenté de créer une colonne de fichier, mais le type de fichier que vous avez entré n'est pas valide.
Action :	Affichez la liste de valeurs et sélectionnez un type de fichier valide.


REP-1802 : Impossible de lire le contenu d'un champ à partir d'un fichier texte.

Cause :	Vous avez coché Lecture depuis fichier pour une colonne, mais Report Builder n'a pas pu trouver les fichiers sur lesquels pointait la colonne. Causes possibles :
	Cas 1 :	Les fichiers n'existent pas.
	Cas 2 :	Vous n'aviez pas les privilèges nécessaires pour accéder aux fichiers.
	Cas 3 :	Une erreur système a empêché le système de trouver les fichiers.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Supprimez Lecture depuis fichier ou créez les fichiers nécessaires.
	Cas 2 :	Si possible, mettez vos privilèges à jour.
	Cas 3 :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-1803 : Impossible d'ouvrir le fichier de destination '<nom du fichier>'.

Cause :	Le fichier de destination que vous avez indiqué pour l'état n'a pas pu être ouvert.
Action :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-1804 : Impossible d'ouvrir le fichier de destination de l'imprimante '<nom du fichier>'.
REP-1804 : Impossible d'ouvrir le fichier de définition de l'imprimante '<nom du fichier>'.

Cause :	Le fichier de définition d'imprimante que vous avez indiqué n'a pas pu être ouvert.
Action :	Consultez la documentation de votre système d'exploitation ou contactez votre administrateur système.


REP-1805 : Impossible d'ouvrir le fichier texte de courrier (mail text) '<nom du fichier>'.

Cause :	Vous avez tenté d'envoyer la sortie de l'état à un message électronique, mais le fichier de message n'a pas pu être ouvert.
Action :	Consultez votre documentation Oracle*Mail ou contactez le Support technique Oracle. Pour plus d'informations, reportez-vous à Recours au Support technique Oracle.


REP-1806 : Impossible d'ouvrir le fichier de commandes de courrier (Mail) '<nom du fichier>'.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1807 : Echec de la commande état courrier.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1808 : Impossible d'ouvrir le fichier de commandes d'impression.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1809 : Echec de la commande d'impression d'état.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1810 : Passage au pilote ASCII de Report Builder pour exécuter états en mode caractère.

Cause :	Vous tentez d'imprimer un état en mode caractère sur une imprimante ou dans un fichier en utilisant un pilote Postscript ou le pilote Generic Text de Microsoft Windows.
Action :	Aucune.


REP-1811 : Erreur au cours de la génération d'un graphique.

Cause :	Report Builder a appelé l'exécutable runtime graphique pour générer un graphique, mais aucun graphique n'a été créé.
Action :	Assurez-vous que le document graphique indiqué existe et peut s'exécuter.


REP-1812 : Pages formatées trop nombreuses. La définition de l'état contient trop de données ou une erreur.

Cause :	Causes possibles :
	Cas 1 :	Vous avez atteint une limite définie par l'utilisateur pour des données trop nombreuses.
	Cas 2 :	Vous avez détecté une erreur dans la définition de l'état.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Mettez prématurément fin à l'exécution du programme. Vérifiez la valeur de PAGE_LIMIT dans la table PRODUCT_PROFILE. Assurez-vous que ce champ contient la valeur '0', ce qui signifie que l'utilisateur est autorisé à formater un nombre illimité de pages ou une valeur suffisamment élevée pour permettre à l'utilisateur de formater l'état.
	Cas 2 :	Déboguez l'état dans Designer.


REP-1813 : Objet '<nom de l'objet>' trop grand pour tenir dans la cellule de matrice.

Cause :	Les données entrées dans une cellule de matrice dépassent la capacité de la cellule -- par exemple, la cellule peut contenir un champ variable, et les données peuvent être plus longues que prévu.
Action :	Agrandissez les cellules de matrice jusqu'à ce qu'elles puissent contenir les données entrées ou redéfinissez vos données.


REP-1814 : Formatage impossible de l'état. L'objet '<nom de l'objet>' ne tiendra jamais dans '<emplacement>'.

Cause :	Etant donné l'objet auquel il est fait référence, la dernière page formatée commence avec le même état que la page précédente. Le formatage se poursuivra donc jusqu'à ce qu'une fin anormale se produise. Causes possibles :
	Cas 1 :	Un objet dont le type Condition d'impression est Tous déborde sur la page suivante.
	Cas 2 :	Un objet de taille Variable ou Développer ne semble pas dépasser les limites de page dans l'Editeur de modèle de présentation, mais les dépasse lorsque l'état est formaté.
	Cas 3 :	Un encadrement itératif ne semble pas dépasser les limites de page dans l'Editeur de modèle de présentation, mais les dépasse lorsque l'état est formaté.
Action :	En utilisant l'objet référencé comme guide, recherchez dans votre présentation d'état les objets qui peuvent dépasser les limites de page. Remarque : L'objet mentionné dans le message est celui qui dépasse la limite. Il peut être poussé au-delà de la limite par un autre objet, qui peut devoir être modifié.


REP-1815 : Numéro Oracle incorrect
REP-1815 : Numéro Oracle incorrect.

Cause :	Une formule fournissant la valeur d'une colonne n'a pas pu indiquer de valeur.
Action :	Déboguez les formules des colonnes de votre état et assurez-vous que chacune d'elles indique une valeur si nécessaire.


REP-1816 : COPIES : pas de valeur indiquée, pas de sortie créée.

Cause :	Dans la grille de paramètres d'exécution ou la boîte de dialogue Impression, vous avez indiqué un nombre de copies nul.
Action :	Indiquez une valeur positive.


REP-1817 : Page de début après page de fin : pas de sortie de page.

Cause :	Dans la boîte de dialogue Impression, vous avez indiqué un numéro de première page supérieur au numéro de dernière page.
Action :	Modifiez soit le numéro de première page, soit le numéro de dernière page afin que le numéro de la première page soit inférieur au numéro de la dernière.


REP-1818 : Impossible de lire des données en format image.

Cause :	Causes possibles :
	Cas 1 :	Vous avez tenté de lire une colonne de fichier ou de base de données qui devait contenir une image, mais qui était d'un format erroné.
	Cas 2 :	La largeur de la colonne de Report Builder que vous avez indiquée est trop faible et l'image risque d'être tronquée.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que vous avez indiqué un fichier ou une colonne contenant une image d'un format valide.
	Cas 2 :	Modifiez la largeur de la colonne de Report Builder afin qu'elle soit suffisante pour afficher l'image.


REP-1819 : Nom de fichier '<nom du fichier>' plus long que nombre maxi de caractères <nombre> autorisé par la plate-forme.

Cause :	Vous avez indiqué un nom de fichier plus long que le maximum autorisé pour la plate-forme. Ce problème risque surtout de se poser lorsque vous accéder à un fichier en utilisant Lecture depuis fichier et que le nom de fichier de la base de données est trop long.
Action :	Assurez-vous que votre base de données n'est pas altérée, et/ou exécutez l'état sur une plate-forme qui accepte les noms de fichiers de la longueur indiquée.


REP-1820 : Pilote ASCII de Report Builder non compatible avec l'exécution d'un état bitmap.

Cause :	Vous avez tenté d'imprimer un état en mode bitmap alors que le pilote ASCII de Report Builder est votre imprimante par défaut, ce qui est interdit.
Action :	Choisissez une autre imprimante, puis imprimez votre état.


REP-1825 : Valeur FALSE ramenée par déclencheur Before Report
REP-1825 : Valeur FALSE ramenée par déclencheur Before Report.

Cause :	Votre état comporte un déclencheur Before Report qui a retourné la valeur FALSE et non TRUE. Lorsqu'un déclencheur retourne la valeur FALSE, la mise en forme de l'état s'arrête.
Action :	Assurez-vous que votre déclencheur d'état doit retourner la valeur FALSE.


REP-1826 : Valeur FALSE ramenée par déclencheur Between Page.

Cause :	Votre état comporte un déclencheur Between Page qui a retourné la valeur FALSE et non TRUE. Lorsqu'un déclencheur retourne la valeur FALSE, la mise en forme de l'état s'arrête.
Action :	Assurez-vous que votre déclencheur d'état doit retourner la valeur FALSE.


REP-1827 : Déséquilibre des parenthèses dans le masque de format.

Cause :	Votre masque de format ne comporte pas autant de parenthèses ouvrantes que de parenthèses fermantes.
Action :	Editez votre masque de format et insérez  la ou les parenthèses nécessaires.


REP-1828 : Un masque de format ne peut contenir qu'un seul jeu de parenthèses au maximum.

Cause :	Votre masque de format comporte plusieurs jeux de parenthèses.
Action :	Utilisez un seul jeu de parenthèses dans votre masque de format.


REP-1829 : Dans un masque de format, la parenthèse gauche doit précéder la parenthèse droite.

Cause :	Vous avez inversé l'ordre des parenthèses dans votre masque de format, c'est-à-dire que vous avez utilisé la parenthèse droite, ou parenthèse fermante, avant la parenthèse gauche ou parenthèse ouvrante.
Action :	Editez votre masque de format et inversez l'ordre des parenthèses.


REP-1830 : Dans un masque de format, le champ Exposant doit contenir exactement 4 E.

Cause :	En indiquant que vous voulez utiliser la notation scientifique pour le champ, vous avez entré trop ou trop peu de E. Entrez quatre E.
Action :	Entrez quatre E dans le masque de format. Si vous voulez que des E supplémentaires apparaissent dans la sortie, entrez-les entre apostrophes (").


REP-1831 : Guillemet de fermeture manquant dans le masque de format.

Cause :	Vous avez entré dans le masque de format des guillemets d'ouverture (") avant la chaîne, mais vous avez omis les guillemets de fermeture. Causes possibles :
	Cas 1 :	Vous n'avez pas pu entrer les guillemets de fermeture après la chaîne.
	Cas 2 :	Vous avez entré un guillemet simple dans les guillemets qui commencent et terminent la chaîne.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Ajoutez des guillemets de fermeture après la chaîne.
	Cas 2 :	Entrez un autre guillemet après celui qui se trouve dans la chaîne.


REP-1832 : Caractère '<caractère>' non autorisé dans le masque de format.

Cause :	Vous avez entré dans un masque de format un caractère non valide pour les masques de format.
Action :	Supprimez le caractère non valide. Pour plus d'informations, reportez-vous à Masque de format.


REP-1833 : Un masque de format doit contenir au minimum un chiffre.

Cause :	Le masque de format que vous avez entré ne contient pas de chiffre. Votre masque doit comporter au moins un sème représentant un chiffre.
Action :	Entrez dans votre masque de format un sème qui représente un chiffre. Les sèmes qui représentent des chiffres sont 0, 9, * et S. Pour plus d'informations, reportez-vous à Masque de format.


REP-1834 : Un masque de format peut contenir au maximum un caractère '<'.

Cause :	Vous avez entré deux chevrons gauches (<<) dans votre masque de format. Il est possible que vous ayez involontairement tapé un chevron gauche de trop ou que vous vouliez que le chevron supplémentaire fasse partie d'une chaîne. Remarque : Il n'est pas nécessaire que les chevrons soient entrés l'un à la suite de l'autre pour que cette erreur apparaisse.
Action :	Supprimez les chevrons excédentaires ou entrez-les entre guillemets (") s'ils doivent faire partie d'une chaîne devant figurer dans la sortie.


REP-1835 : Un masque de format peut contenir au maximum un caractère '>'.

Cause :	Vous avez entré deux chevrons droits (>>) dans votre masque de format. Il est possible que vous ayez involontairement tapé un chevron droit de trop, ou que vous vouliez que le chevron supplémentaire fasse partie d'une chaîne. Remarque : Il n'est pas nécessaire que les chevrons soient entrés l'un à la suite de l'autre pour que cette erreur apparaisse.
Action :	Supprimez les chevrons excédentaires ou entrez-les entre guillemets (") s'ils doivent faire partie d'une chaîne devant figurer dans la sortie.


REP-1836 : Dans un masque de format, '<' doit être placé avant '>'.

Cause :	Le chevron gauche (<) doit précéder le chevron droit (>) dans un masque de format.
Action :	Assurez-vous que tous les chevrons qui doivent figurer dans la sortie sont bien entre guillemets ("). Pour les chevrons qui délimitent le début et la fin de la partie de texte alignée sur la décimale, assurez-vous que le chevron gauche précède le chevron droit dans le masque de format.


REP-1837 : Un masque de format peut contenir au maximum une décimale.

Cause :	Vous avez entré un masque de format comportant plusieurs décimales.
Action :	Placez entre guillemets (") les décimales que vous voulez voir apparaître dans la sortie. Enlevez celles qui se trouvent en dehors des guillemets.


REP-1838 : Un masque de format peut contenir au maximum un point d'échelle.

Cause :	Vous avez entré plusieurs fois le sème V dans votre masque de format.
Action :	Si vous voulez que les V supplémentaires apparaissent dans la sortie, entrez-les entre guillemets ("). Sinon, supprimez les V pour qu'il n'en reste plus qu'un dans le masque de format.


REP-1839 : Dans un masque de format : ',' ne peut être placé avant le premier chiffre.

Cause :	Vous avez entré une virgule avant le premier chiffre du masque de format, ce qui est interdit.
Action :	Si vous voulez qu'une virgule précède les chiffres de la sortie, entrez la virgule entre guillemets (") sous la forme d'une chaîne. Sinon, supprimez la virgule.


REP-1840 : Dans un masque de format : ',' ne peut être placé après le dernier chiffre.

Cause :	Vous avez entré une virgule après le dernier chiffre du masque de format, ce qui est interdit.
Action :	Si vous voulez qu'une virgule apparaisse après les chiffres de la sortie, entrez la virgule entre guillemets (") sous la forme d'une chaîne. Sinon, supprimez la virgule.


REP-1841 : Dans un masque de format, ',' ne peut être placé après une décimale.

Cause :	Vous avez entré une virgule après la décimale du masque de format.
Action :	Si vous voulez qu'une virgule apparaisse après la décimale dans la sortie, entrez la virgule entre guillemets (") sous la forme d'une chaîne. Sinon, supprimez la virgule.


REP-1842 : Un masque de format peut contenir au maximum un champ d'exposant.

Cause :	Vous avez entré plusieurs fois le sème EEEE dans votre masque de format. Ce sème n'est autorisé qu'une fois dans le masque de format.
Action :	Si vous voulez que les E supplémentaires apparaissent dans la sortie, entrez-les entre guillemets ("). Sinon, supprimez les sèmes EEEE excédentaires pour qu'il n'en reste plus qu'un dans le masque de format.


REP-1843 : Dans les masques de format contenant des champs d'exposant, la décimale doit être précédée d'un chiffre.

Cause :	Vous avez entré un masque de format en notation scientifique, mais sans indiquer de chiffre, ou en indiquant plusieurs chiffres à gauche de la décimale.
Action :	Si votre masque de format comporte plusieurs chiffres à gauche de la décimale, supprimez-les pour qu'il n'en reste plus qu'un. Si votre masque ne comportait pas de chiffre à gauche de la décimale, ajoutez-en un.


REP-1844 : Erreur interne : Index incorrect dans un tableau flexible.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1845 : Dans un masque de format, la décimale doit être placée entre '<' et '>'.

Cause :	Vous avez entré une décimale en dehors des chevrons gauche et droit (< et >) de votre masque de format.
Action :	Editez votre masque de format en enlevant la décimale ou en la plaçant entre les chevrons.


REP-1846 : Un masque de format en chiffres romains doit simplement indiquer "RN" ou "rn".

Cause :	Si vous indiquez un sème de masque de format en chiffres romains (RN ou rn), vous ne pouvez pas indiquer d'autres sèmes de masque de format.
Action :	Si vous voulez que les valeurs soient formatées en chiffres romains, éliminez tous les sèmes du masque de format, sauf RN ou rn. Sinon, n'utilisez pas le sème RN ou rn.


REP-1847 : Echec lors de la tentative de configuration d'impression
REP-1847 : Echec lors de la tentative de configuration d'impression.

Cause :	Vous avez tenté d'imprimer un état. Causes possibles :
	Cas 1 :	Dans la grille de paramètres d'exécution ou dans la ligne de commande, vous avez indiqué Printer pour DESTYPE, mais vous avez indiqué pour DESNAME un nom d'imprimante erroné.
	Cas 2 :	Vous exécutez un état qui en exécute un autre à l'aide de SRW.RUN_REPORT. Le champ DESTYPE des deux états est défini soit à File soit à Printer, alors que le premier état doit être exécuté à l'écran.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Faites une nouvelle tentative en indiquant pour DESNAME un nom d'imprimante valide.
	Cas 2 :	Remplacez DESTYPE du premier état par Screen ou Previewer et ré-exécutez l'état.


REP-1848 : Echec lors du lancement de l'impression
REP-1848 : Echec lors du lancement de l'impression.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1849 : Echec au cours de l'impression
REP-1849 : Echec au cours de l'impression.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1850 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> :  Fin de fichier dans la chaîne entre guillemets.

Cause :	Votre fichier de définition d'imprimante contient une chaîne entre guillemets qui ne se terminait pas par des guillemets avant la fin du fichier.
Action :	Utilisez l'adresse indiquée dans le message pour localiser l'erreur et ajoutez des guillemets de fermeture à la chaîne de votre fichier de définition d'imprimante.


REP-1851 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : la chaîne dépasse <nombre> caractères.

Cause :	Une chaîne de votre fichier de définition d'imprimante dépasse le nombre maximum de caractères autorisé.
Action :	Raccourcissez la chaîne.


REP-1852 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : mot-clé "<mot-clé>..." inconnu.

Cause :	Votre fichier de définition d'imprimante comporte un mot-clé erroné.
Action :	Pour toute information sur les mots-clés valides, reportez-vous à Syntaxe du fichier de définition d'imprimante.


REP-1853 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : mot-clé "<mot-clé>" inconnu.
REP-1853 : Erreur colonne <numéro>, ligne <numéro> du fichier <nom du fichier> : de définition d'imprimante : mot-clé "<mot-clé>" inconnu.

Cause :	Votre fichier de définition d'imprimante comporte un mot-clé erroné.
Action :	Pour plus d'informations sur les mots-clés valides, reportez-vous à Syntaxe du fichier de définition d'imprimante.


REP-1854 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : caractère de contrôle "<caractère>".
REP-1854 : Erreur colonne <numéro>, ligne <numéro> du fichier d'imprimante <nom du fichier> : caractère de contrôle "<caractère>".

Cause :	Votre fichier de définition d'imprimante comporte un caractère de contrôle erroné.
Action :	Remplacez ou enlevez le caractère de contrôle erroné de votre fichier de définition d'imprimante.


REP-1855 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : caractère "<caractère>" inconnu.

Cause :	Votre fichier de définition d'imprimante comporte un caractère inconnu.
Action :	Remplacez ou enlevez le caractère inconnu de votre fichier de définition d'imprimante.


REP-1856 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : caractère <caractère> n'est pas un caractère ASCII correct.
REP-1856 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : <caractère> n'est pas un caractère ASCII correct.

Cause :	Votre fichier de définition d'imprimante comporte un caractère ASCII erroné.
Action :	Remplacez ou enlevez le caractère ASCII erroné de votre fichier de définition d'imprimante.


REP-1857 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : ")" doit suivre <caractère>.

Cause :	Votre fichier de définition d'imprimante comporte une parenthèse ouvrante, mais pas de parenthèse fermante.
Action :	Editez votre fichier de définition d'imprimante et ajoutez la parenthèse manquante.


REP-1858 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : (<nombre>) octal n'est pas un caractère ASCII correct.
REP-1858 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : (<nombre>) octal n'est pas un caractère ASCII valide.

Cause :	Le code octal d'un caractère ASCII de votre fichier de définition d'imprimante est erroné.
Action :	Editez votre fichier de définition d'imprimante et corrigez le code hexa du caractère ASCII.


REP-1859 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> :  (<caractère>) hexadécimal n'est pas un caractère ASCII correct.
REP-1859 : Erreur colonne <numéro>, ligne <numéro> fichier de définition d'imprimante <nom du fichier> : (<caractère>) hexadécimal n'est pas un caractère ASCII correct.

Cause :	Le code hexa d'un caractère ASCII de votre fichier de définition d'imprimante est erroné.
Action :	Editez votre fichier de définition d'imprimante et corrigez le code hexa du caractère ASCII.


REP-1860 : Err. colonne <numéro>, ligne <numéro> fichier de définition d'imprim. <nom du fichier> : "gauche", "centre" ou "droite" doivent suivre "<caractère>".

Cause :	Votre fichier de définition d'imprimante contient une chaîne de codes incomplète.
Action :	Editez votre fichier de définition d'imprimante et ajoutez le mot manquant à la chaîne de codes.


REP-1861 : Colonne <numéro>, ligne <numéro> du fichier <nom du fichier> : "horizontal",  "vertical",  "haut",  "centre" ou "bas" doit suivre "boîte".

Cause :	Votre fichier de définition d'imprimante contient une chaîne de codes "boîte" incomplète.
Action :	Editez votre fichier de définition d'imprimante et ajoutez le mot manquant à la chaîne de codes "boîte".


REP-1862 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : mot-clé "imprimante" attendu.

Cause :	Votre fichier de définition d'imprimante ne comporte pas le mot-clé "imprimante" obligatoire.
Action :	Editez votre fichier de définition d'imprimante et ajoutez le mot "imprimante" obligatoire suivi du nom de l'imprimante dans une chaîne entre guillemets, de préférence sur la première ligne du fichier de définition d'imprimante.


REP-1863 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : nom de l'imprimante entre guillemets attendu.

Cause :	Votre fichier de définition d'imprimante contient le nom de l'imprimante après le code "imprimante", mais le nom ne figure pas dans une chaîne entre guillemets.
Action :	Editez votre fichier de définition d'imprimante et ajoutez des guillemets (") avant et après le nom de l'imprimante, après le code "imprimante".


REP-1864 : Col <numéro>, ligne <numéro> du fichier <nom du fichier> : "larg., haut., retour, chang. ligne, before report, after page, after report ou code prévu".
REP-1864 : Col. <numéro> ligne <numéro>, fich. <nom du fichier> : "larg., haut., retour, chang. ligne, before report, after page, after report ou code prévu".

Cause :	Votre fichier de définition d'imprimante ne contient aucun des mots de code que doit contenir un fichier de définition d'imprimante.
Action :	Editez votre fichier de définition d'imprimante et ajoutez les mots de code manquants.


REP-1865 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> :  chiffre attendu après "largeur".

Cause :	Votre fichier de définition d'imprimante contient le code "largeur", mais il n'est pas suivi de la valeur numérique indiquant la largeur de l'état.
Action :	Editez votre fichier de définition d'imprimante et ajoutez, après le code "largeur", une valeur numérique indiquant la largeur de l'état.


REP-1866 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : chiffre attendu après "hauteur".

Cause :	Votre fichier de définition d'imprimante contient le code "hauteur", mais il n'est pas suivi de la valeur numérique indiquant la hauteur de l'état.
Action :	Editez votre fichier de définition d'imprimante et ajoutez, après le code "hauteur", une valeur numérique indiquant la hauteur de l'état.


REP-1867 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "report" doit suivre "before".

Cause :	Votre fichier de définition d'imprimante contient le mot "before", mais non son complément, le mot "report".
Action :	Editez le fichier de définition d'imprimante afin qu'il comporte une entrée "before report" complète.


REP-1868 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "pages" doit suivre "between".

Cause :	Votre fichier de définition d'imprimante contient le mot "between", mais non son complément, le mot "pages".
Action :	Editez le fichier de définition d'imprimante afin qu'il comporte une entrée "between pages" complète.


REP-1869 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "report" ou "page" doit suivre "after".

Cause :	Votre fichier de définition d'imprimante (pour un état en plusieurs pages) contient le mot "after", mais non son complément, le mot "report".
Action :	Editez le fichier de définition d'imprimante afin qu'il comporte une entrée "after report" complète.


REP-1870 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : nom de code entre guillemets attendu.

Cause :	Votre fichier de définition d'imprimante contient le code "code" avec une chaîne définie par l'utilisateur, mais qui n'est pas entre guillemets.
Action :	Editez votre fichier de définition d'imprimante et entrez des guillemets avant et après la chaîne "code" définie par l'utilisateur.


REP-1871 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(" doit suivre "dec".

Cause :	Votre fichier de définition d'imprimante contient une chaîne généralisée utilisant "dec", mais "dec" n'est pas suivi d'une parenthèse ouvrante.
Action :	Editez votre fichier de définition d'imprimante et ajoutez des parenthèses autour de la valeur qui suit "dec".


REP-1872 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(" doit être suivi d'un chiffre.
REP-1872 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(". doit être suivi d'un chiffre.

Cause :	Votre fichier de définition d'imprimante contient une chaîne généralisée (par exemple, dec, octal), mais la parenthèse gauche n'est suivie d'aucune valeur.
Action :	Editez votre fichier de définition d'imprimante et ajoutez une valeur entre les parenthèses de la chaîne généralisée.


REP-1873 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(" doit suivre "octal".

Cause :	Votre fichier de définition d'imprimante contient une chaîne généralisée utilisant "octal", mais "octal" n'est pas suivi d'une parenthèse gauche.
Action :	Editez votre fichier de définition d'imprimante et ajoutez des parenthèses autour de la valeur qui suit "octal".


REP-1874 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(" doit être suivi d'un chiffre.
REP-1874 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(". doit être suivi d'un chiffre.

Cause :	Votre fichier de définition d'imprimante contient une chaîne généralisée (par exemple, dec, octal), mais la parenthèse gauche n'est suivie d'aucune valeur.
Action :	Editez votre fichier de définition d'imprimante et ajoutez une valeur entre les parenthèses de la chaîne généralisée.


REP-1875 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(" doit suivre "hex".

Cause :	Votre fichier de définition d'imprimante contient une chaîne généralisée utilisant "hex", mais "hex" n'est pas suivi d'une parenthèse gauche.
Action :	Editez votre fichier de définition d'imprimante et ajoutez des parenthèses autour de la valeur qui suit "hex".


REP-1876 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(" doit être suivi d'un chiffre.
REP-1876 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(". doit être suivi d'un chiffre.

Cause :	Votre fichier de définition d'imprimante contient une chaîne généralisée (par exemple, dec, octal), mais la parenthèse gauche n'est suivie d'aucune valeur.
Action :	Editez votre fichier de définition d'imprimante et ajoutez une valeur entre les parenthèses de la chaîne généralisée.


REP-1877 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : doit être suivi d'un caractère de contrôle "^".

Cause :	Votre fichier de définition d'imprimante contient une chaîne généralisée utilisant "^", mais "^" n'est suivi d'aucun caractère de contrôle.
Action :	Editez votre fichier de définition d'imprimante et ajoutez un caractère de contrôle après "^".


REP-1878 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(" doit suivre "control".

Cause :	Votre fichier de définition d'imprimante contient un mot-clé et une chaîne généralisée (par exemple, after report, before report), mais le mot "control" n'est pas suivi d'une parenthèse gauche.
Action :	Editez votre fichier de définition d'imprimante et ajoutez une parenthèse gauche après le mot "control".


REP-1879 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : "(" doit être suivi d'un caractère de contrôle.

Cause :	Votre fichier de définition d'imprimante contient un mot-clé et une chaîne généralisée (par exemple, after report, before report), mais la parenthèse gauche n'est pas suivie d'un caractère de contrôle.
Action :	Editez votre fichier de définition d'imprimante et ajoutez un caractère de contrôle entre les  parenthèses après le mot "control".


REP-1880 : Err col <numéro>, ligne <numéro> fich de déf d'imprimante <nom du fichier> : longueur chaîne de dessin de boîte doit être égale à 1 car.

Cause :	Votre fichier de définition d'imprimante contient la chaîne de codes "boîte", mais la chaîne de dessein indiquée entre guillemets a plus d'un caractère de long.
Action :	Editez votre fichier de définition d'imprimante en vous assurant que la chaîne de dessin ne se compose que d'un seul caractère.


REP-1881 : Erreur colonne <numéro>, ligne <numéro> du fichier de définition d'imprimante <nom du fichier> : Chaîne avec car. de dessin de boîte attendue.

Cause :	Votre fichier de définition d'imprimante contient la chaîne de codes "boîte", mais aucune chaîne de dessin n'est indiquée.
Action :	Editez votre fichier de définition d'imprimante et indiquez une chaîne de dessin.


REP-1882 : Colonne <numéro>, ligne <numéro> du fichier <nom du fichier> : "horizontal",  "vertical",  "haut",  "centre" ou "bas" doit suivre "boîte".

Cause :	Votre fichier de définition d'imprimante contient la chaîne de codes "boîte", mais le mot suivant ("horizontal", "vertical", "haut", "centre" ou "bas"), obligatoire, n'est pas indiqué.
Action :	Editez votre fichier de définition d'imprimante et ajoutez le mot obligatoire manquant.


REP-1883 : Fin inattendue du fichier de définition de l'imprimante.

Cause :	Report Builder a pu ouvrir votre fichier de définition d'imprimante, mais il s'est produit une erreur pendant sa lecture.
Action :	Assurez-vous que vous avez indiqué le fichier de définition d'imprimante correct. Vérifiez également son contenu. Editez-le si nécessaire.


REP-1884 : Arrêt imprévu lors de l'envoi de la sortie.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1885 : Impossible d'envoyer sortie à l'imprimante.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-1886 : "I" doit suivre "M".

Cause :	La lettre M que vous avez entrée dans un masque de format n'était pas suivie d'un I. Le seul sème qui commence par M est le sème MI.
Action :	Si vous voulez utiliser le sème MI, entrez I après M. Si vous voulez que le caractère M apparaisse dans votre sortie, entrez-le entre guillemets ("). Sinon, supprimez le M du masque de format.


REP-1887 : "R" doit suivre "P".

Cause :	La lettre P que vous avez entrée dans un masque de format n'était pas suivie d'un R. Le seul sème qui commence par P est le sème PR.
Action :	Si vous voulez utiliser le sème PR, entrez R après P. Si vous voulez que le caractère M apparaisse dans votre sortie, entrez-le entre guillemets ("). Sinon, supprimez le M du masque de format.


REP-1888 : Un seul sème autorisé : + ou -.

Cause :	Vous avez entré plus d'un sème de signe dans un masque de format.
Action :	Supprimez du masque de format tous les sèmes de signe sauf un.


REP-1889 : Un indicateur de fin doit être à la fin.

Cause :	Vous n'avez pas entré de sème de signe à la fin du masque de format.
Action :	Placez le sème de signe (par exemple, MI, PR, DB et CR) à la fin du masque de format.


REP-1890 : Sème "S" doit être positionné au début ou à la fin.

Cause :	Vous n'avez pas entré de sème de signe à la fin du masque de format.
Action :	Placez le sème S au début ou à la fin du masque de format, ou supprimez-le.


REP-1891 : Sèmes parenthèses doivent entourer d'autres sèmes.

Cause :	Des sèmes parenthèses doivent entourer tous les autres sèmes du masque de format. (Les parenthèses n'entourent pas tous les autres sèmes).
Action :	Placez des parenthèses autour de tous les autres sèmes du masque de format.


REP-1892 : Le type de destination indiqué n'est pas supporté pour pdf ou html.
REP-1892 : Le type de destination indiqué n'es pas supporté pour pdf ou html.

Cause :	Vous avez entré un type de destination non valide pour la sortie PDF ou HTML.
Action :	Tentez à nouveau d'exécuter l'opération en entrant l'un des types de destination valides.


REP-1893 : Le type de destination indiqué n'est pas supporté sur cette plate-forme.

Cause :	Vous avez entré un type de destination qui n'est pas valide pour votre système d'exploitation (par exemple, Sysout sous Microsoft Windows).
Action :	Tentez à nouveau d'exécuter l'opération en entrant l'un des types de destination valides.


REP-1894 : Définition d'état modifiée lors de l'exécution en cours. Pas de nouvelle page générée.

Cause :	Pendant la prévisualisation d'un état (en utilisant RWBLD60), vous avez modifié la définition de l'état (c'est-à-dire que vous avez modifié une interrogation, ajouté ou supprimé des objets, etc.), puis vous êtes revenu à l'Aperçu interactif et avez tenté de visualiser d'autres pages.
Action :	Cette opération n'est pas autorisée. Comme Report Builder ne peut pas garantir que toutes les informations utilisées lors de l'exécution sont toujours présentes, la mise en forme est arrêtée.


REP-1895 : Erreur de formatage de date lors du traitement <nom du champ>.

Cause :	Report Builder n'a pas pu formater le champ date indiqué.
Action :	Vérifiez le masque de format du champ date indiqué.


REP-1896 : Erreur : colonne <numéro>, ligne <numéro> fichier de définition d'imprimante <nom du fichier> : 'backspace' ou 'overstrike' attendus après 'hilight'.

Cause :	Le fichier de définition d'imprimante indiqué contient le paramètre 'hilight', mais la définition n'est pas complète.
Action :	Ajoutez ou supprimez 'overstrike' ou 'backspace <séquence>' après 'hilight'.


REP-1897 : Erreur : colonne <numéro>, ligne <numéro> fichier de définition d'imprimante <nom du fichier> : Codes imprim non num. définis par utils non supportés
REP-1897 : Erreur : colonne <numéro>, ligne <numéro> fichier de définition d'imprimante <nom du fichier> : Codes imprim non num. définis par utils non supportés.

Cause :	Le fichier de définition d'imprimante indiqué contient un code d'imprimante, défini par l'utilisateur, qui n'est pas numérique.
Action :	Remplacez le code d'imprimante défini par l'utilisateur par une valeur numérique.


REP-1898 : Erreur : colonne <numéro>, ligne <numéro> fichier de définition d'imprimante <nom du fichier> : Paramètre 'Hilight' ne peut être spécif. qu'une fois.

Cause :	Le fichier de définition d'imprimante indiqué contient plusieurs paramètres 'hilight'.
Action :	Supprimez du fichier de définition d'imprimante tous les paramètres hilight sauf un.


REP-1899 : Conversion impossible d'un affichage Graphics ou d'une icône au format .gif - image sautée.

Cause :	Report Builder n'a pas pu convertir en format GIF une icône ou un affichage graphique incorporé à afficher dans un document HTML. Cette erreur ne se produit que lorsque Report Builder ne peut pas accéder à un système de fenêtre pour tracer l'image.
Action :	Exécutez l'état en utilisant l'exécutable bitmap sous un système de fenêtre pour permettre à Report Builder d'accéder à un affichage.


REP-1920 : Exécution en mode caractère non compatible avec DESFORMAT de PDF, HTML, HTMLCSS ou RTF.

Cause :	Vous tentez d'exécuter un état dont le nom de destination est PDF ou HTML. La sortie PDF et HTML n'est possible que lorsque l'état utilise un environnement bitmap et produit une sortie bitmap.
Action :	Réexécutez l'état avec un exécutable bitmap ou définissez MODE=BITMAP si vous utilisez déjà un exécutable bitmap.


REP-1940 : Colonne <numéro> ligne <numéro> de <nom du fichier> : visualorder, logicalorder, contextualshaping. . . attendu

Cause :	Votre fichier de définition d'imprimante contient la chaîne de code nls, mais le mot obligatoire manque.
Action :	Editez votre fichier de définition d'imprimante et ajoutez le mot manquant (visualorder, logicalorder, contextualshaping, contextuallayout, multibyte ou pcharset).


REP-1941 : Colonne <numéro> ligne <numéro> de <nom du fichier> : yes ou no attendu.

Cause :	Votre fichier de définition d'imprimante contient l'un des mots suivants : visualorder, logicalorder, contextualshaping, contextuallayout, multibyte ou pcharset, mais l'indication yes ou no manque.
Action :	Editez votre fichier de définition d'imprimante et indiquez soit yes soit no.


REP-1942 : Colonne <numéro> ligne <numéro> de <nom du fichier> : Le nom du jeu de caractères attendu doit suivre pcharset.

Cause :	Votre fichier de définition d'imprimante contient pcharset, mais le nom du jeu de caractères n'est pas indiqué.
Action :	Editez votre fichier de définition d'imprimante et indiquez le nom du jeu de caractères.


REP-1943 : Colonne <numéro> ligne <numéro> de <nom du fichier> : Jeu de caractères d''imprimante défini non pris en charge.

Cause :	Votre fichier de définition d'imprimante fait référence à un jeu de caractères non pris en charge.
Action :	Editez votre fichier de définition d'imprimante et assurez-vous que le nom du jeu de caractères est correct.


REP-1950 : Source erronée spécifiée.

Cause :	La source que vous avez indiquée pour RWCON60 n'est pas valide.
Action :	Vérifiez le nom du fichier ou de l'objet, et assurez-vous que le STYPE est correct pour ce fichier ou cet objet.


REP-1951 : Destination spécifiée erronée.

Cause :	La destination que vous avez indiquée pour RWCON60 n'est pas valide.
Action :	Vérifiez le nom du fichier ou de l'objet, et assurez-vous que le DTYPE est correct pour ce fichier ou cet objet.


REP-1952 : Nombre d'éléments Destination doit être 0 ou correspondre au nombre d'éléments source.

Cause :	Dans la boîte de dialogue Conversion, ou lors de l'utilisation de RWCON60, vous avez indiqué une liste d'éléments Destination, mais le nombre d'éléments indiqué est supérieur à zéro et ne correspond pas au nombre d'éléments Source indiqué.
Action :	Pour que Report Builder puisse extraire les noms Destination des noms Source indiqués, laissez Destination en blanc. Sinon, assurez-vous que le nombre de noms Destination indiqué correspond au nombre de noms Source indiqué. Remarque : Si vous utilisez des jokers dans le nom Source, assurez-vous que le nombre de noms Destination correspond au nombre d'éléments Source de la liste étendue des caractères génériques.


REP-2000 : Erreur de sortie utilisateur.

Cause :	Il s'est produit une erreur dans la sortie utilisateur.
Action :	Si vous avez créé la sortie utilisateur, déboguez le code. Sinon, contactez votre administrateur de bases de données.


REP-2001 : IAF GET : colonne '<nom de la colonne>' inconnue.

Cause :	Vous avez indiqué, dans l'instruction IAF GET de votre sortie utilisateur, un nom de colonne inconnu.
Action :	Assurez-vous que le nom de la colonne, indiqué dans l'instruction IAF GET, est valide.


REP-2002 : IAF PUT : colonne '<nom de la colonne>' inconnue.

Cause :	Vous avez indiqué, dans l'instruction IAF PUT de votre sortie utilisateur, un nom de colonne inconnu.
Action :	Assurez-vous que le nom de la colonne, indiqué dans l'instruction IAF PUT, est valide.


REP-2003 : Impossible de trouver sortie utilisateur.

Cause :	Report Builder n'a pas pu trouver la sortie utilisateur qu'il était censé exécuter à ce stade. La cause la plus probable est que le nom et/ou l'adresse du code de sortie utilisateur étaient erronés.
Action :	Si vous avez créé la sortie utilisateur, vérifiez que vous avez indiqué un nom et une adresse de code corrects lorsque vous l'avez installé. Sinon, contactez votre administrateur de bases de données.


REP-2004 :  Avertissement ! Impossible de retrouver code source PL/SQL'<nom de l'objet>'.

Cause :	Vous avez sélectionné Fichier [image] Administration [image] Informations pour documenter un ou plusieurs états, mais la sortie utilisateur RWEPLS n'a pas pu extraire le code source PL/SQ d'un objet. Il s'agit probablement d'une condition anormale.
Action :	Vérifiez le code source PL/SQL dans l'objet indiqué dans le message. Pour obtenir des informations, reportez-vous à Conditions anormales.


REP-2005IAF PUT : valeur de la colonne '<nom de la colonne>' tronquée
REP-2005 :  IAF PUT : valeur de colonne '<nom de la colonne>' tronquée

Cause :	Votre instruction IAF PUT attribue une valeur à la colonne nommée, mais la colonne n'est pas suffisamment large pour contenir toute la valeur, qui est donc tronquée.
Action :	Agrandissez la colonne pour qu'elle puisse contenir toute la valeur.


REP-2100 :  Erreur du Gestionnaire de calculs (Calculation Manager).

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-2101 :  Gestionnaire de calculs : colonne source ne peut utiliser la mémoire segmentée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-2102 :  Gestionnaire de calculs : colonne calculée ne peut utiliser la mémoire segmentée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-2103 :  Colonne '<nom de la colonne>' : la formule PL/SQL a ramené une valeur erronée ou pas de valeur du tout.

Cause :	Vous avez entré une instruction SRW.DO_SQL qui a entraîné l'affichage du message ORACLE.
Action :	Editez l'instruction SRW.DO_SQL. Pour plus d'informations sur les messages ORACLE, reportez-vous à ORACLE8 Server Messages and Codes Manual.


REP-2300 :  <Message Oracle>

Cause :	Vous avez entré une instruction SRW.DO_SQL qui a entraîné l'affichage du message ORACLE.
Action :	Editez l'instruction SRW.DO_SQL. Pour plus d'informations sur les messages ORACLE, reportez-vous à ORACLE8 Server Messages and Codes Manual.


REP-2301 :  Erreur d'affectation de descripteur SQLDBA. <Message Oracle>

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-2302 :  Erreur lors de l'analyse de l'instruction SQL. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant l'analyse de l'instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi l'instruction SQL n'a pas pu être analysée.


REP-2303 :  Erreur lors de la description variables de lien. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant la description des variables de lien d'une instruction SRW.DO-SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi les variables de lien n'ont pas pu être décrites.


REP-2304 :  Erreur d'ouverture de curseur SQL. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant l'ouverture d'un curseur dans une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi le curseur n'a pas pu être ouvert.


REP-2305 :  Erreur lors de la description de liste de sélection. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant la description de la liste de sélection d'une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi les variables de lien n'ont pas pu être décrites.


REP-2306 :  Erreur d'extraction de variables de lien. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant l'extraction des variables de lien d'une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi les variables de lien n'ont pas pu être extraites.


REP-2307 :  Erreur d'extraction d'enregistrements. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant l'extraction d'un enregistrement de données d'une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi l'enregistrement de données n'a pas pu être extrait.


REP-2308 :  Erreur de traitement de la liste de sélection. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant le traitement de la liste de sélection d'une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi la liste de sélection n'est pas valide.


REP-2309 :  Erreur formatage de champ date. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant le formatage d'un champ de date d'une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi le champ de date n'a pas pu être formaté.


REP-2310 :  Erreur lors de l'insertion d'une valeur dans la colonne. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant une tentative d'insertion d'une valeur dans une colonne d'une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi la valeur n'a pas pu être affectée.


REP-2311 :  Erreur lors de la validation. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant une tentative de validation dans une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi la validation a échoué.


REP-2312 :  Erreur d'affectation d'enregistrements de données. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant l'affectation d'un enregistrement de données dans une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi l'enregistrement n'a pas pu être affecté.


REP-2313 :  Erreur lors de l'analyse de la liste de sélection. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant l'analyse de la liste de sélection d'une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi la liste de sélection n'a pas pu être analysée.


REP-2314 :  Erreur de fermeture de curseur SQL. <Message Oracle>

Cause :	Report Builder a détecté une erreur pendant la tentative de fermeture d'un curseur SQL dans une instruction SRW.DO_SQL.
Action :	Reportez-vous au message ORACLE pour savoir pourquoi le curseur n'a pas pu être fermé.


REP-2315 :  Erreur de libération d'enregistrement. <Message Oracle>

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-2316 :  Colonne inconnue '<nom de la colonne>'

Cause :	Une colonne mentionnée dans une instruction SRW.DO_SQL est introuvable.
Action :	Déboguez votre  PL/SQL et assurez-vous que votre instruction SRW.DO_SQL contient le nom correct de la colonne.


REP-2317 :  La valeur de la colonne '<Nom de la colonne>' a été tronquée.

Cause :	Une valeur de colonne obtenue par une instruction SRW.DO_SQL a été tronquée.
Action :	Passez à la palette de propriétés de la colonne et augmentez sa largeur, ou limitez la taille de la valeur que votre instruction SRW.DO_SQL entre dans la colonne.


REP-2400 : DEBUG : internal error 0

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-2500  Erreur $0. Pour plus d'informations sur cette erreur, reportez-vous au fichier de notes sur la version (relnotes).
REP-2500  Erreur <numéro de l'erreur>. Pour plus d'informations sur cette erreur, reportez-vous au fichier de notes sur la version (relnotes).

Cause :	Lorsque l'assistant Etat a tenté d'adopter la présentation par défaut, une erreur est survenue.
Action :	Remédiez au problème identifié par le code d'erreur indiqué dans le texte du message d'erreur.


REP-3000 :  Erreur interne au démarrage de Oracle Toolkit.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3001 :  Erreur interne à l'initialisation de la boîte de dialogue Fichier.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3002 :  Erreur d'initialisation de l'imprimante. Veuillez vous assurer qu'elle est bien installée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3020 :  Erreur interne au démarrage du gestionnaire de ressources Oracle.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3021 :  Erreur interne lors du traitement des ressources de menu.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3022 :  Erreur interne lors du traitement des ressources de fenêtre.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3023 :  Fichier de ressources introuvable.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3040 :  Erreur interne au démarrage de Oracle Observer Model.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3060 :  Erreur interne lors de l'initialisation de la table de couleurs. Vérification ressources VGS recommandée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3080 : Erreur interne lors de l'initialisation de Oracle Image
REP-3080 :  Erreur interne lors de l'initialisation de Oracle Image.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3081 : Erreur lors de l'exécution de image Viewer
REP-3081 :  Erreur lors de l'exécution de image Viewer.

Cause :	Vous avez sélectionné un bouton de l'Aperçu interactif avec une action d'affichage d'une image, mais l'image Viewer n'est pas disponible. Causes possibles :
	Cas 1 :	Le format de l'image indiquée comme source est erroné.
	Cas 2 :	Vous manquez de mémoire.
	Cas 3 :	Condition anormale.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier image indiqué comme source de l'action du bouton est dans un format affichable.
	Cas 2 :	Libérez si possible de la mémoire ou demandez l'intervention de votre administrateur système
	Cas 3 :	Pour toute information, reportez-vous à Conditions anormales.


REP-3082 :  Erreur lors du lancement du Dialogue Son.

Cause :	Vous avez sélectionné un bouton de l'Aperçu interactif avec une action d'exécution d'un son, mais le dialogue son n'est pas disponible. Causes possibles :
	Cas 1 :	Le fichier son indiqué comme source est erroné.
	Cas 2 :	Vous manquez de mémoire.
	Cas 3 :	Condition anormale.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier son indiqué comme source de l'action du bouton est dans un format exécutable.
	Cas 2 :	Libérez si possible de la mémoire ou demandez l'intervention de votre administrateur système
	Cas 3 :	Pour toute information, reportez-vous à Conditions anormales.


REP-3083 :  Erreur lors du lancement du lecteur vidéo.

Cause :	Vous avez sélectionné un bouton de l'Aperçu interactif avec une action d'exécution d'une vidéo, mais le lecteur vidéo n'est pas disponible. Causes possibles :
	Cas 1 :	Le fichier vidéo indiqué comme source est erroné.
	Cas 2 :	Vous manquez de mémoire.
	Cas 3 :	Condition anormale.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier vidéo indiqué comme source de l'action du bouton est dans un format exécutable.
	Cas 2 :	Libérez si possible de la mémoire ou demandez l'intervention de votre administrateur système
	Cas 3 :	Pour toute information, reportez-vous à Conditions anormales.


REP-3085 : Fichier source multimédia '<nom du fichier>' introuvable.
REP-3085 :  Fichier source multimedia '<nom du fichier>' introuvable.

Cause :	Vous avez activé le bouton de l'Aperçu interactif, mais la source de l'action prévue pour le bouton (son, image ou vidéo) est introuvable ou a été altérée.
Action :	Ouvrez la palette de propriétés du bouton en question et vérifiez l'existence, le format et le chemin d'accès du fichier source indiqué.


REP-3086 : Fichier source multimédia erroné
REP-3086 :  Fichier source multimedia erroné.

Cause :	Vous avez activé le bouton de l'Aperçu interactif, mais la source de l'action prévue pour le bouton (son, image ou vidéo) a été altérée.
Action :	Ouvrez la palette de propriétés du bouton en question et vérifiez l'existence, le format et le chemin d'accès du fichier source indiqué. Si ces informations sont correctes, vérifiez le fichier lui-même.


REP-3087 :  ImageViewer non accepté dans cette configuration.

Cause :	Votre plate-forme et/ou votre configuration ne prendront pas en charge l'affichage d'images par ImageViewer.
Action :	Aucune.


REP-3088 :  Son non accepté dans cette configuration.

Cause :	Votre plate-forme et/ou votre configuration ne prendront pas en charge la lecture de fichiers son.
Action :	Aucune.


REP-3089 :  Vidéo non acceptée dans cette configuration.

Cause :	Votre plate-forme et/ou votre configuration ne prendront pas en charge la lecture de fichiers vidéo.
Action :	Aucune.


REP-3100 : La matrice doit comprendre au moins un encadrement itératif horizontal (bas) et vertical (gauche-droite).

Cause :	Vous avez tenté de créer une matrice (en utilisant Outils [image] Créer matrice), sans que les objets appropriés soient sélectionnés dans l'Editeur de modèle de présentation. Pour une présentation de matrice, il faut qu'au moins un groupe ait comme orientation itérative Bas et un autre Gauche-droite.
Action :	Sélectionnez deux encadrements itératifs (un Bas et un Gauche-droite) qui se chevauchent, puis choisissez Réorganisation [image] Créer matrice.


REP-3101 :  Tous les encadrements itératifs sélectionnés horizontaux et verticaux doivent être imbriqués.

Cause :	Vous avez tenté de créer une matrice (en utilisant Réorganisation [image] Créer matrice) mais les encadrements itératifs Bas et Gauche-droite ont un problème de chevauchement et d'imbrication.
Action :	Avant de créer la matrice, assurez-vous que les encadrements itératifs Bas et Gauche-droite sélectionnés se chevauchent et sont imbriqués correctement.


REP-3102 :  Points d'ancrage, matrices et marges ne peuvent être groupés.

Cause :	Vous avez choisi Réorganisation [image] Groupe, et au moins un des objets sélectionnés est un point d'ancrage, une matrice ou une marge.
Action :	Avant de grouper des objets, annulez la sélection de tous les points d'ancrage, de toutes les matrices et de toutes les marges.


REP-3103 :  Seuls les objets standard texte et graphiques peuvent pivoter.

Cause :	Vous avez tenté de faire pivoter un encadrement, un champ, une marge, un point d'ancrage, un objet matrice, un élément de texte standard de fichier de liens, un graphique, un objet OLE2 ou un bouton. Aucun de ces objets ne peut pivoter
Action :	Vous pouvez faire pivoter tous les objets texte standard, à l'exception des images et des textes standard des fichiers de liens. Si votre système d'exploitation le permet, vous pouvez voir le texte standard qui pivote.


REP-3104 :  Points d'ancrage et matrices ne peuvent être dimensionnés distinctement de leurs objets associés.

Cause :	Vous avez tenté de dimensionner l'un des objets présentation mentionnés ci-dessus, sans dimensionner aussi l'objet qui lui est associé, ce qui est interdit.
Action :	Sélectionnez au moins un objet associé (objet d'ancrage pour les points d'ancrage, encadrements itératifs pour les matrices), puis tentez à nouveau d'exécuter l'opération de dimensionnement.


REP-3105 :  Une colonne graphique doit être sélectionnée pour l'interrogation.

Cause :	Vous avez entré un nom d'interrogation sans sélectionner de colonne de graphique. Si vous indiquez l'interrogation, vous devez également indiquer les colonnes du graphique.
Action :	Indiquez les colonnes du graphique ou supprimez la valeur d'interrogation.


REP-3106 :  Avertissement ! Colonne graphique sélectionnée sans nom d'interrogation. La colonne sélectionnée ne sera pas prise en compte.

Cause :	Vous avez sélectionné une source ou une colonne de graphique sans entrer de nom d'interrogation.
Action :	Entrez le nom de l'interrogation à laquelle vous souhaitez transmettre des données.


REP-3107 : Impossible de placer objet <nom de l'objet> devant objet fils <nom de l'objet>. Opération non autorisée.
REP-3107 :  Impossible de placer objet '<nom de l'objet>' devant objet fils <nom de l'objet>. Opération non autorisée.

Cause :	Vous avez tenté de faire passer un objet présentation devant ses objets enfant.
Action :	Si vous souhaitez encore déplacer l'objet présentation, désactivez le mode Confiné, puis déplacez l'objet. Sinon, aucune action n'est nécessaire


REP-3108 :  Impossible de placer objet <nom de l'objet> derrière objet parent <nom de l'objet>. Opération non autorisée.

Cause :	Vous avez tenté de faire passer un objet présentation derrière ses objets parent.
Action :	Si vous souhaitez encore déplacer l'objet présentation, désactivez le mode Confiné, puis déplacez l'objet. Sinon, aucune action n'est nécessaire


REP-3109 :  Avertissement ! Echec d'alignement en raison de contraintes du conteneur. Annuler modif. pour revenir à l'état initial.

Cause :	Vous avez tenté d'aligner plusieurs objets présentation, mais le résultat de cette opération aurait violé les contraintes de conteneur (c'est-à-dire aurait fait sortir un champ de son encadrement).
Action :	Sélectionnez Edition [image] Annuler pour vous assurer que votre présentation est la même qu'avant la tentative d'alignement. Vous pouvez alors soit redimensionner, soit repositionner le conteneur en question pour pouvoir exécuter l'opération, ou ne tenter aucune action.


REP-3110 :  Avertissement ! Echec de redimensionnement en raison de contraintes du conteneur. Annuler modif. pour revenir à l'état initial.

Cause :	Vous avez tenté de donner la même taille à un ou plusieurs objets présentation, mais le résultat de cette opération aurait violé les contraintes de conteneur (c'est-à-dire aurait rendu un champ plus grand que son encadrement).
Action :	Sélectionnez Edition [image] Annuler pour vous assurer que votre présentation est la même qu'avant la tentative de redimensionnement. Vous pouvez alors soit redimensionner, soit repositionner le conteneur en question pour pouvoir exécuter l'opération, ou ne tenter aucune action.


REP-3111 :  La modification de la largeur des bordures de '<nom de l'objet>' viole les contraintes du mode Confiné. Opération non autorisée.

Cause :	Vous avez tenté de modifier la largeur des bordures d'un objet, et le résultat aurait violé les contraintes du conteneur (c'est-à-dire aurait agrandi la bordure d'un objet standard qui aurait alors dépassé les limites de son encadrement).
Action :	Aucune.


REP 3112. Création d'objets impossible au niveau corps de présentation de modèle.

Cause :	Vous avez tenté de créer un objet dans la couche du corps de la présentation d'un modèle. Vous ne pouvez créer des objets que dans la marge, les pages d'en-tête ou les pages de fin d'un modèle.
Action :	Aucune.


REP-3130 :  Rotation impossible des champs grille de paramètres et images.

Cause :	Vous avez tenté de faire pivoter l'un des objets de grille de paramètres énumérés ci-dessus, ce qui est interdit.
Action :	Vous pouvez faire pivoter n'importe quel objet texte standard, sauf des images, dans l'Editeur de grille de paramètres. Si votre système d'exploitation le permet, vous pouvez voir le texte standard qui pivote.


REP-3131 :  Texte standard de la grille de paramètres ne tient pas dans la page.

Cause :	Vous avez entré, dans le champ Titre, Message d'aide, Etat ou Libellé du Générateur de grille de paramètres, un texte trop long pour la page.
Action :	Raccourcissez le contenu du champ texte concerné.


REP-3140 :  Erreur interne de l'éditeur d'unité de programme. Extraction du descripteur de document impossible.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3150 :  Pour chaque état, un éditeur graphique doit rester ouvert.

Cause :	Vous avez tenté de fermer les trois éditeurs (Modèle de données, Modèle de présentation et Grille de paramètres) d'un état. Vous devez laisser au moins un éditeur ouvert..
Action :	Laissez un éditeur ouvert pour chaque état.


REP-3151 :  Largeur invalide pour col. '<nom de la colonne>' ne peut être en surbrillance tant que groupe '<nom du groupe>' non sélectionné.

Cause :	La largeur d'une colonne de l'assistant Report comporte une valeur erronée. Comme le groupe propriétaire de la colonne n'est pas sélectionné, la colonne ne figure pas dans la liste.
Action :	Sélectionnez la liste propriétaire de la colonne. Passez à la colonne et entrez une valeur de largeur valide.


REP-3152 : La création de liaison, points d'ancrage ou polygone doit être terminée dans l'éditeur graphique avant cette opération.

Cause :	Vous avez tenté d'exécuter une opération (par exemple, la fermeture de l'état) avant de terminer la création d'une liaison de données dans l'Editeur de modèles de données, ou d'un point d'ancrage dans l'Editeur de modèles de présentation, ou d'un polygone dans l'Editeur de modèles de présentation ou l'Editeur de grilles de paramètres.
Action :	Terminez l'objet avant de poursuivre.


REP-3153 : Ressources insuffisantes pour création de fenêtre
REP-3153 : Ressources insuffisantes pour création de fenêtre.

Cause :	Il n'y avait pas suffisamment de ressources disponibles pour créer la fenêtre demandée.
Action :	Libérez des ressources en fermant des fenêtres ou d'autres applications.


REP-3154 : Ressources insuffisantes pour création de document
REP-3154 : Ressources insuffisantes pour création de document.

Cause :	Il n'y avait pas suffisamment de ressources disponibles pour créer le module demandé (état, interrogation externe, bibliothèque PL/SQL). Vous avez probablement sélectionné Fichier [image] Nouveau, Fichier [image] Ouvrir ou Fichier [image] Rétablir.
Action :	Libérez des ressources en fermant des fenêtres ou d'autres applications.


REP-3200 : Opérations simultanées dans aperçu interdites
REP-3200 : Opérations simultanées dans aperçu interdites.

Cause :	Vous tentez d'activer plusieurs boutons à la fois, dans le même aperçu ou dans plusieurs. Par exemple, vous tentez d'exécuter un son et, en même temps, d'afficher une vidéo, ce qui est interdit.
Action :	N'activez qu'un bouton à la fois.


REP-3300 : Erreur fatale <messages supplémentaires>.

Condition anormale. Pour obtenir des informations, reportez-vous à Conditions anormales.

Conseil 1 : assurez-vous que le répertoire ORACLE_HOME\REPORTS60\TMP dispose de suffisamment d'espace pour créer le fichier et que vous possédez des droits d'accès en écriture sur ce répertoire.

Conseil 2 : déterminez le pilote d'imprimante utilisé par votre système. Essayez d'utiliser un autre pilote pour résoudre le problème.

Cause :	Vous avez migré le serveur et tenté d'exécuter d'anciens états via le nouveau serveur.
Action :	A l'aide d'Installer, installez tous les anciens fichiers .DLL d'Oracle Server dans le répertoire oracle_home/bin qui contient Reports, Oracle Server et la base de données Oracle.
Cause :	Vous avez tenté d'exécuter un état nécessitant des polices non installées.
Action :	Téléchargez et installez les polices requises.


REP-3301 : Une erreur s'est produite <messages supplémentaires>.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3302 : Une erreur fatale s'est produite lors de l'opération Quitter. Sortie de Report Builder.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3335 : Erreur interne CA non traitée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3350 : Erreur interne UI non traitée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3351 : Echec non déterminé dans UI.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3352 : Erreur inattendue dans UI.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3353 : Tentative de création à l'aide d'un attribut qui ne peut être créé.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3354 : Tentative de définition avec un attribut qui ne peut être défini.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3355 : Tentative de définition avec un attribut impossible à obtenir.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3356 : Tentative de définition/d'obtention d'un attribut inconnu.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3357 : Tentative de définition de valeurs d'attribut conflictuelles.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3358 : Tentative de donner à un attribut une valeur située hors des limites.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3359 : Appel fonction hors contexte.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3360 : Impossible de faire défiler cette classe de vue.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3361 : Cet appel de fonction entraîne une récursivité non autorisée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3362 : Echec du programme interne d'affectation de mémoire api.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3363 : Echec des fonctions d'affectation de mémoire fournies par le client.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3364 : Tentative d'utilisation d'une fonction qui n'est pas prise en charge.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3365 : Tentative de définition d'attributs hors contexte.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3366 : Tentative d'exécution d'une opération non autorisée dans une vue principale.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3367 : L'un des paramètres attribués aux fonctions dépasse les limites.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3368 : Echec de la connexion au système de création de fenêtres.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3369 : La connexion au système de création de fenêtres a été interrompue.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3370 : Echec du système de création de fenêtres.
REP-3370 : Echec du système de création de fenêtres

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3371 : uiER_CL_FORMAT_UNAVAILABLE

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3372 : uiER_CL_FORMAT_UNREGISTERED

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3373 : Le délai imparti à l'opération est écoulé.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3374 : uiER_NOT_FOUND

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3375 : uiER_ILLEGAL_TOPITEM

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3376 : uiER_SE_BAD_FORMAT

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3377 : La classe de vue ne prend pas en charge l'interface de défilement.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3378 : Tentative de suppression de couleur READSHARE d'une palette

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3379 : Impossible de créer une fenêtre
REP-3379 : Impossible de créer une fenêtre.

Cause :	Report Builder n'a pas pu créer une fenêtre. Il est possible que vous ayez ouvert trop d'états ou trop de fenêtres, ou que vous manquiez de mémoire.
Action :	Fermez des états et des fenêtres.


REP-3380 : Impossible de créer une vue
REP-3380 : Impossible de créer une vue.

Cause :	Report Builder n'a pas pu créer une vue. Il est possible que vous ayez ouvert trop d'états ou trop de fenêtres, ou que vous manquiez de mémoire.
Action :	Fermez des états et des fenêtres.


REP-3381 : Impossible de créer une palette de couleurs
REP-3381 : Impossible de créer une palette de couleurs.

Cause :	Report Builder n'a pas pu créer une palette de couleurs. Il est possible que vous ayez ouvert trop d'états ou trop de fenêtres, ou que vous manquiez de mémoire
Action :	Fermez des états et des fenêtres.


REP-3400 : Erreur lors de l'initialisation de DE. Vérification ressources DE recommandée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3420 : Erreur interne dans Report Builder

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3430 : Erreur interne HH non traitée
REP-3430 : Erreur interne HH non traitée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3431 : Valeur d'attribut erronée
REP-3431 : Valeur d'attribut erronée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3432 : Contexte erroné
REP-3432 : Contexte erroné.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3433 : Mot spécifié introuvable
REP-3433 : Mot spécifié introuvable.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3434 : Lien avec document externe
REP-3434 : Lien avec document externe.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3435 : Session d'aide non renseignée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3436 : Ce document n'est pas un document d'aide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3437 : La révision du document est plus récente que l'aide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3438 : L'attribut spécifié ne peut être défini.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3439 : L'attribut spécifié ne peut être obtenu.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3440 : Lien erroné.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3441 : Attributs logiques manquants ou incorrects.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3442 : Chaîne de langue NLS manquante ou incorrecte.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3443 : Aucun critère de recherche spécifié.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3444 : Chaîne commençant par un signe de pourcentage
REP-3444 : Chaîne commençant par un signe de pourcentage.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3445 : Erreur toolkit inconnue.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3446 : Erreur inconnue de stockage d'objet.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3447 : Mémoire insuffisante
REP-3447 : Mémoire insuffisante.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3448 : Erreur inconnue du gestionnaire de ressources
REP-3448 : Erreur inconnue du gestionnaire de ressources.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3480 : Erreur interne REM non traitée
REP-3480 : Erreur interne REM non traitée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3485 : Erreur interne VGS non traitée
REP-3485 : Erreur interne VGS non traitée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3500 : Erreur interne UT non traitée
REP-3500 : Erreur interne UT non traitée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3510 : Erreur interne ZOM non traitée
REP-3510 : Erreur interne ZOM non traitée.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3600 : Noeuds document et non-document sélectionnés. Ne sélectionner que des noeuds appartenant à l'un des deux types.

Cause :	Vous avez choisi Navigateur [image] Supprimer mais les noeuds objet et les noeuds document sont sélectionnés. Vous ne pouvez pas fermer de documents et supprimer d'objets au cours d'une même opération.
Action :	Si vous voulez supprimer des objets, désélectionnez tous les noeuds document. Si vous voulez fermer des documents, désélectionnez tous les noeuds objet. Puis sélectionnez à nouveau Navigateur [image] Supprimer.


REP-3601 : Ce type d'état ne peut avoir qu'une section.

Cause :	Les états de type Tabulaire, Lettre type et Etiquette de publipostage ne peuvent avoir qu'une section chacun.
Action :	Vous devez indiquer toutes les substitutions dans la section existante.


REP 3602 : Suppression impossible du nombre minimum de niveaux.

Cause :	Les états de type Tabulaire, Lettre type et Etiquette de publipostage ont une section chacun. Groupe - niveau supérieur et Groupe - gauche ont deux sections chacun. Matriciel et Matrice avec groupe ont une section chacun sous normal, en diagonale, vers le bas, cellule.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3700 : Echec d'initialisation de Selection Observer
REP-3700 : Echec d'initialisation de Selection Observer.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-3701 : Echec de Selection Observer lors de l'arrêt
REP-3701 : Echec de Selection Observer lors de l'arrêt.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-4001 : Erreur dans le sous-système OLE
REP-4001 : Erreur dans le sous-système OLE.

Cause :	Une erreur non indiquée OLE2 s'est produite pendant l'initialisation. Pour plus d'informations, reportez-vous au message d'erreur OLE qui l'accompagne. Autres causes possibles d'apparition de cette erreur :
	Cas 1 :	Votre serveur OLE2 ne fonctionne pas correctement.
	Cas 2 :	Il s'est produit une erreur pendant l'installation de Report Builder et la fonction OLE2 ne s'est pas installée correctement.
	Cas 3 :	Condition anormale.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Pour plus d'informations, reportez-vous à la documentation concernant le serveur OLE2.
	Cas 2 :	Réinstallez Report Builder.
	Cas 3 :	Pour toute information, reportez-vous à Conditions anormales.


REP-4002 : Erreur lors de l'initialisation du sous-système OLE
REP-4002 : Erreur lors de l'initialisation du sous-système OLE.

Cause :	Il s'est produit une erreur pendant l'initialisation des bibliothèques OLE2. Pour plus d'informations, reportez-vous au message d'erreur OLE qui l'accompagne. Autres causes possibles d'apparition de cette erreur :
	Cas 1 :	Votre serveur OLE2 ne fonctionne pas correctement.
	Cas 2 :	Il s'est produit une erreur pendant l'installation de Report Builder et la fonction OLE2 ne s'est pas installée correctement.
	Cas 3 :	Condition anormale.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Pour plus d'informations, reportez-vous à la documentation concernant le serveur OLE2.
	Cas 2 :	Réinstallez Report Builder.
	Cas 3 :	Pour toute information, reportez-vous à Conditions anormales.


REP-4003 : Erreur lors de la création d'un objet OLE
REP-4003 : Erreur lors de la création d'un objet OLE.

Cause :	Vous tentiez de créer un objet OLE2 lorsqu'une erreur OLE s'est produite.
Action :	Pour plus d'informations, reportez-vous au message d'erreur OLE2 qui l'accompagne.


REP-4004 : Erreur lors de la restauration d'un objet OLE
REP-4004 : Erreur lors de la restauration d'un objet OLE.

Cause :	Vous tentiez de restaurer un objet OLE2 lorsqu'une erreur OLE s'est produite.
Action :	Pour plus d'informations, reportez-vous au message d'erreur OLE2 qui l'accompagne.


REP-4005 : Erreur lors de l'enregistrement d'un objet OLE
REP-4005 : Erreur lors de l'enregistrement d'un objet OLE.

Cause :	Vous tentiez d'enregistrer un objet OLE2 lorsqu'une erreur OLE s'est produite.
Action :	Pour plus d'informations, reportez-vous au message d'erreur OLE2 qui l'accompagne.


REP-4006 : Erreur lors de l'exécution de l'opération Couper/Coller. Objet OLE non positionné sur le presse-papiers.

Cause :	Vous tentiez de couper ou de copier un objet OLE2 lorsqu'une erreur OLE s'est produite.
Action :	Pour plus d'informations, reportez-vous au message d'erreur OLE2 qui l'accompagne.


REP-4007 : Erreur lors du collage d'un objet OLE à partir du presse-papiers
REP-4007 : Erreur lors du collage d'un objet OLE à partir du presse-papiers.

Cause :	Vous tentiez de coller un objet OLE stocké dans le presse-papiers lorsqu'une erreur OLE s'est produite.
Action :	Pour plus d'informations, reportez-vous au message d'erreur OLE2 qui l'accompagne.


REP-4008 : Erreur lors de l'exécution de l'opération définie par objet OLE
REP-4008 : Erreur lors de l'exécution de l'opération définie par objet OLE.

Cause :	Vous tentiez d'exécuter une action normalement prise en charge par le serveur OLE2.
Action :	Pour plus d'informations, reportez-vous au message d'erreur OLE qui l'accompagne.


REP-4009 : Erreur lors de la tentative de déclenchement de l'objet OLE
REP-4009 : Erreur lors de la tentative de déclenchement de l'objet OLE.

Cause :	Vous tentiez d'activer un objet OLE2 (par exemple, par un double clic dans l'Aperçu interactif) lorsqu'une erreur OLE s'est produite.
Action :	Pour plus d'informations, reportez-vous au message d'erreur OLE2 qui l'accompagne.


REP-4020 : Echec de conversion de l'objet OLE en un type différent
REP-4020 : Echec de conversion de l'objet OLE en un type différent.

Cause :	Vous tentiez de convertir un objet OLE2, se trouvant dans un texte standard, en objet OLE2 d'un type différent lorsqu'une erreur OLE s'est produite. Ce message indique un problème de serveur OLE2.
Action :	Vérifiez que l'objet est correctement installé et, si nécessaire, réinstallez-le.


REP-4021 : La fonction OLE (Liaison et incorporation d'objet) de Microsoft n'est pas acceptée sur cette plate-forme.

Cause :	Vous exécutez un état créé avec des objets OLE2 sur la plate-forme prenant en charge OLE2, mais l'exécution s'effectue sur une plate-forme qui ne prend pas en charge OLE2. Vous tentez d'accéder à la représentation visuelle de ce qui était auparavant un objet OLE2.
Action :	Aucune. Si nécessaire, supprimez l'objet.


REP-4022 : Version de bibliothèques OLE incorrecte : désactivation des fonctions OLE
REP-4022 : Version de bibliothèques OLE incorrecte : désactivation des fonctions OLE.

Cause :	Les bibliothèques OLE2 installées sur votre machine sont incompatibles avec celles prises en charge par votre version de Report Builder. Comme Report Builder ne peut pas garantir que votre support OLE2 fonctionnera, il désactive les fonctions OLE2.
Action :	Installez les bibliothèques voulues.


REP-4023 : Opération abandonnée faute de mémoire suffisante
REP-4023 : Opération abandonnée faute de mémoire suffisante.

Cause :	Votre système n'a plus suffisamment de mémoire pour exécuter l'opération demandée.
Action :	Sortez des applications dont vous n'avez plus besoin. Si cela ne suffit pas, recherchez dans votre documentation Microsoft les procédures conseillées pour améliorer l'utilisation de la mémoire.


REP-4024 : Services DOS SHARE nécessaires à la réussite de l'opération. SHARE non actif.

Cause :	L'opération demande l'utilisation des services DOS SHARE, mais SHARE n'est pas en cours d'exécution.
Action :	Assurez-vous que SHARE s'exécute.


REP-4025 : Echec de lecture
REP-4025 : Echec de lecture.

Cause :	La lecture des données ne peut pas être effectuée sur l'unité indiquée.
Action :	Vérifiez le bon fonctionnement de l'unité. En cas de mauvais fonctionnement, reportez-vous à la documentation la concernant pour connaître les procédures de redressement d'erreurs appropriées.


REP-4026 : Echec d'écriture
REP-4026 : Echec d'écriture.

Cause :	L'écriture des données ne peut pas être effectuée sur l'unité indiquée.
Action :	Vérifiez l'unité pour savoir si elle est en lecture seule. Sinon, contactez la documentation la concernant pour connaître les procédures de redressement d'erreurs appropriées.


REP-4027 : Trop de fichiers ouverts : ressources insuffisantes pour pouvoir ouvrir un autre fichier
REP-4027 : Trop de fichiers ouverts : ressources insuffisantes pour pouvoir ouvrir un autre fichier.

Cause :	Vous tentez d'ouvrir davantage de fichiers que Windows n'en prend en charge.
Action :	Fermez certaines applications. Reportez-vous également à votre fichier config.sys et assurez-vous que le paramètre FILES n'est pas défini à une valeur inférieure à 20. Remarque : N'oubliez pas que les objets standard OLE2 réservent deux ou trois descripteurs de fichiers par objet et que vous pouvez donc ouvrir davantage de fichiers que vous ne le pensez.


REP-4028 : Espace insuffisant sur l'unité
REP-4028 : Espace insuffisant sur l'unité.

Cause :	L'unité indiquée est saturée.
Action :	Supprimez les données dont vous n'avez plus besoin ou stockez-les sur une autre unité.


REP-4029 : Echec de présentation de l'objet OLE. Rendu de l'objet OLE impossible.

Cause :	Vous avez tenté d'afficher un objet OLE2 dans un état, mais les aspects d'affichage définis par le serveur OLE2 n'étaient pas disponibles.
Action :	Assurez-vous que l'objet OLE2 n'a pas été altéré et que le serveur est installé correctement. Si nécessaire, réinstallez le serveur.


REP-4030 : Echec de rétablissement de l'affichage antérieur de l'objet OLE. Utilisation du contenu de l'objet.

Cause :	Vous avez tenté d'afficher un objet OLE2 dans un état, mais les aspects d'affichage définis par le serveur OLE2 étaient altérés ou stockés dans la base de données, et n'ont pas pu être restaurés. Report Builder affichera l'objet en utilisant l'aspect par défaut.
Action :	Assurez-vous que l'objet OLE2 n'a pas été altéré et que le serveur est installé correctement. Si nécessaire, réinstallez le serveur.


REP-4031 : Application serveur introuvable. Vérifiez que l'application est bien installée et enregistrée correctement.

Cause :	Vous tentez d'accéder à un serveur OLE2 via un objet OLE2, mais le serveur est actuellement inaccessible. Il est possible qu'il ait été supprimé, renommé ou réinstallé manuellement à un autre emplacement.
Action :	Vérifiez l'installation du serveur et réinstallez-le si nécessaire.


REP-4032 : Connexion impossible à source d'objet OLE lié. Vérifiez que liaison source non déplacée, renommée ou supprimée.

Cause :	Report Builder tente, mais sans succès, une connexion à la source indiquée du texte standard d'objet OLE2.
Action :	Assurez-vous que la source de l'objet OLE2 n'a pas été déplacée ou supprimée et que son nom de fichier n'a pas été modifié.


REP-4033 : Connexion impossible au source de l'objet OLE lié, car dans un réseau non connecté à cette machine.

Cause :	Vous tentez de vous connecter à un objet OLE2 stocké sur une unité à laquelle vous n'êtes pas connecté.
Action :	Connectez-vous à l'unité appropriée.


REP-4034 : Fichier introuvable ou nom de fichier appelé par objet OLE incorrect
REP-4034 : Fichier introuvable ou nom de fichier appelé par objet OLE incorrect.

Cause :	Un objet OLE2 tente d'accéder à un fichier introuvable.
Action :	Assurez-vous que le fichier n'a pas été altéré, déplacé ou renommé.


REP-4035 : Une violation de partage s'est produite lors d'une opération sur un objet OLE.

Cause :	Vous tentez de vous connecter au même fichier via plusieurs objets OLE2, ou d'accéder au même fichier temporaire via différentes applications.
Action :	Assurez-vous que plusieurs objets OLE2 ne tentent pas d'accéder simultanément au même fichier. Vérifiez également l'installation de votre serveur OLE2.


REP-4036 : Accès refusé lors de l'exécution d'une opération sur l'objet OLE
REP-4036 : Accès refusé lors de l'exécution d'une opération sur l'objet OLE.

Cause :	Vous tentez de mettre à jour un objet OLE2 pour lequel vous n'avez pas d'autorisation d'écriture.
Action :	Procurez-vous les autorisations appropriées avant de tenter de mettre un fichier à jour.


REP-4037 : Echec de l'opération sur objet OLE : le disque est protégé en écriture.

Cause :	Vous avez tenté d'enregistrer un objet OLE2 dans un fichier, mais le disque est protégé en écriture.
Action :	Si possible, enregistrez l'objet sur un disque pour lequel vous avez l'autorisation d'écriture. Sinon, aucune action n'est nécessaire.


REP-4038 : Erreur imprévue dans système de fichiers lors de l'exécution d'une opération sur objet OLE
REP-4038 : Erreur imprévue dans système de fichiers lors de l'exécution d'une opération sur objet OLE.

Cause :	Il s'est produit une erreur fichier non spécifique, comme l'altération du disque dur.
Action :	Pour plus d'informations, reportez-vous à la documentation de votre système d'exploitation.


REP-4039 : Erreur imprévue remontée par OLE.

Cause :	Il s'est produit une erreur OLE non spécifique.
Action :	Pour plus d'informations, reportez-vous à votre documentation Microsoft.


REP-4040 : Données Objet OLE incorrectes ou altérées. Objet OLE non restaurable à partir de ces données.

Cause :	Les informations utilisées par le serveur Oracle pour restaurer l'objet OLE2 dans votre état sont erronées ou altérées. Causes possibles :
	Cas 1 :	S'il s'agit d'un problème de texte standard, le fichier est altéré.
	Cas 2 :	S'il s'agit d'un champ, la base de données est altérée, ou la colonne LONG RAW référencée ne contient pas d'objet OLE2.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Vérifiez la viabilité de l'objet en l'incorporant dans un conteneur utilisant une autre application.
	Cas 2 :	Utilisez SQLPlus pour vérifier la table de la base de données et le contenu de la colonne.


REP-4041 : Aucune opération définie pour cet objet ou l'objet est statique.

Cause :	Vous avez tenté d'exécuter une opération sur un objet OLE2, alors qu'aucune opération n'a été définie comme s'appliquant à l'objet. Il est possible que l'objet ait été converti en bitmap statique.
Action :	Aucune.


REP-4042 : Opération demandée sur objet OLE valide, mais inexécutable à ce moment. Serveur d'objets probablement occupé.

Cause :	Vous avez tenté d'exécuter une opération valide sur un objet OLE2, mais l'opération n'a pas pu être exécutée faute de ressources de serveur. Il est possible que vous tentiez d'ouvrir une instance secondaire d'une application mono-instance.
Action :	Vérifiez les ressources du système (mémoire, etc.) et augmentez-les si possible, ou tentez à nouveau d'exécuter l'opération à un stade ultérieur.


REP-4043 : Opération demandée sur objet OLE non valide et inexécutable à ce moment. Vérifiez la bonne installation de l'appli.

Cause :	L'opération que vous avez tenté d'exécuter sur un objet OLE2 n'est pas reconnue comme valide.
Action :	Vérifiez l'installation de la version appropriée du serveur OLE2. Réinstallez-la si nécessaire.


REP-4044 : Accès impossible au registre système. Vérifiez que les ressources système sont suffisantes et le registre non altéré.

Cause :	Une opération de lecture ou d'écriture du registre système a échoué.
Action :	Consultez votre documentation Microsoft.


REP-4045 : Problème dans le registre système. Vérifiez la bonne installation du serveur d'objets.

Cause :	Il manque certaines informations sur le serveur dans le registre.
Action :	Vérifiez l'installation du serveur OLE2. Réinstallez-le si nécessaire.


REP-4200 : Erreur dans le sous-système de messagerie.

Cause :	Il s'est produit une erreur non indiquée pendant une opération de messagerie. Pour plus d'informations, reportez-vous au message d'erreur qui l'accompagne. Autres causes possibles :
	Cas 1 :	MAPI n'est pas installé correctement.
	Cas 2 :	Votre fournisseur de messagerie Windows n'est pas correctement installé.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Si vous avez d'autres applications qui utilisent MAPI, vérifiez leur fonctionnement. En cas de problème, réinstallez MAPI.
	Cas 2 :	Assurez-vous que votre fournisseur de messagerie Windows est installé et que vous avez un compte sur le système. En cas de problème, contactez votre administrateur de messagerie.


REP-4201 : Erreur au cours de l'initialisation du sous-système de messagerie.

Cause :	Report Builder a tenté, mais sans succès, d'initialiser MAPI. Pour plus d'informations, reportez-vous au message d'erreur qui l'accompagne. Autres causes possibles :
	Cas 1 :	MAPI n'est pas installé, MAPI DLL est périmé, ou l'entrée Mail de votre fichier WIN.INI ou de votre registre système pointe sur une adresse erronée.
	Cas 2 :	Il n'y a pas suffisamment de mémoire disponible pour l'opération.
	Cas 3 :	Lorsque vous vous êtes connecté, vous avez entré un nom de profil de service, un nom utilisateur ou un mot de passe erroné.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Réinstallez MAPI ou corrigez l'entrée Mail de votre fichier WIN.INI ou de votre registre système.
	Cas 2 :	Sortez des applications dont vous n'avez plus besoin. Si cela ne suffit pas, recherchez dans votre documentation Microsoft les procédures conseillées pour améliorer l'utilisation de la mémoire.
	Cas 3 :	Vérifiez vos informations de connexion et faites une nouvelle tentative. En cas d'échec, vérifiez les informations concernant votre compte avec votre administrateur de messagerie.


REP-4202 : Erreur au cours de la connexion au sous-système de messagerie.

Cause :	Lorsque vous avez tenté de vous connecter au sous-système de messagerie, il s'est produit une erreur. Pour plus d'informations, reportez-vous au message d'erreur qui l'accompagne. Autres causes possibles :
	Cas 1 :	Vous avez entré un nom de profil de service, un nom utilisateur ou un mot de passe erroné.
	Cas 2 :	Il n'y pas suffisamment de mémoire disponible.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Vérifiez vos informations de connexion et faites une nouvelle tentative. En cas d'échec, vérifiez les informations concernant votre compte avec votre administrateur de messagerie.
	Cas 2 :	Sortez des applications dont vous n'avez plus besoin. Si cela ne suffit pas, recherchez dans votre documentation Microsoft les procédures conseillées pour améliorer l'utilisation de la mémoire.


REP-4203 : Erreur au cours de l'envoi de courrier
REP-4203 : Erreur au cours de l'envoi de courrier.

Cause :	Il s'est produit une erreur pendant que vous rédigiez ou envoyiez un message sur votre messagerie. Pour plus d'informations, reportez-vous au message d'erreur qui l'accompagne. Autres causes possibles :
	Cas 1 :	Il n'y a pas suffisamment d'espace sur votre disque.
	Cas 2 :	Il n'y pas suffisamment de mémoire disponible.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Libérez de l'espace sur votre disque.
	Cas 2 :	Sortez des applications dont vous n'avez plus besoin. Si cela ne suffit pas, recherchez dans votre documentation Microsoft les procédures conseillées pour améliorer l'utilisation de la mémoire.


REP-4204 : Erreur au cours de la validation du nom et adresse du destinataire
REP-4204 : Erreur au cours de la validation du nom et adresse du destinataire.

Cause :	Il s'est produit une erreur pendant que Report Builder tentait de valider l'adresse de destination de votre message électronique.
Action :	Vérifiez que le compte du destinataire est valide ou interrogez votre administrateur de messagerie. Pour plus d'informations, reportez-vous au message d'erreur qui l'accompagne.


REP-4220 : Problème de sous-système de messagerie
REP-4220 : Problème de sous-système de messagerie.

Cause :	Il s'est produit une erreur non précisée pendant une opération de messagerie.
Action :	Essayez de libérer de l'espace sur le disque ou sortez des applications dont vous n'avez plus besoin. Si d'autres applications utilisent MAPI, assurez-vous qu'elles fonctionnent correctement. Sinon, tentez de réinstaller MAPI.


REP-4221 : Accès au fichier de pièce jointe impossible
REP-4221 : Accès au fichier de pièce jointe impossible.

Cause :	Il s'est produit une erreur pendant une tentative d'accès au fichier de pièce jointe. Causes possibles :
	Cas 1 :	Le fichier de pièce jointe était introuvable.
	Cas 2 :	Le fichier de pièce jointe n'a pas pu être ouvert, ou il s'est produit une erreur pendant sa lecture ou son écriture.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Sortez des applications dont vous n'avez plus besoin. Si cela ne suffit pas, recherchez dans votre documentation Microsoft les procédures conseillées pour améliorer l'utilisation de la mémoire.
	Cas 2 :	Libérez de l'espace sur votre disque.


REP-4222 : Mémoire insuffisante pour terminer l'opération
REP-4222 : Mémoire insuffisante pour terminer l'opération.

Cause :	L'opération de messagerie n'a pas pu être menée à bien, car il n'y a pas suffisamment d'espace disponible en mémoire.
Action :	Sortez des applications dont vous n'avez plus besoin. Si cela ne suffit pas, recherchez dans votre documentation Microsoft les procédures conseillées pour améliorer l'utilisation de la mémoire.


REP-4223 : Espace insuffisant sur l'unité
REP-4223 : Espace insuffisant sur l'unité.

Cause :	L'opération de messagerie n'a pas pu être menée à bien car il n'y a pas suffisamment d'espace sur votre disque.
Action :	Libérez de l'espace sur votre disque.


REP-4224 : Nom utilisateur, mot de passe ou nom de profil de service incorrect
REP-4224 : Nom utilisateur, mot de passe ou nom de profil de service incorrect.

Cause :	Les informations de connexion que vous avez entrées sont erronées.
Action :	Vérifiez vos informations de connexion et faites une nouvelle tentative. En cas d'échec, vérifiez les informations concernant votre compte avec votre administrateur de messagerie.


REP-4225 : Cette opération ne peut être accomplie, car l'utilisateur n'est pas connecté.

Cause :	L'opération de messagerie n'a pas pu être exécutée.
Action :	Connectez-vous au sous-système de messagerie et relancez l'opération.


REP-4226 : Mot de passe nécessaire
REP-4226 : Mot de passe nécessaire.

Cause :	Vous avez tenté de vous connecter au sous-système de messagerie sans indiquer le mot de passe.
Action :	Indiquez un mot de passe valide et faites une nouvelle tentative de connexion. En cas d'échec, contactez votre administrateur de messagerie.


REP-4227 : Configuration de service non valide
REP-4227 : Configuration de service non valide.

Cause :	Le sous-système de messagerie n'est pas configuré correctement.
Action :	Contactez votre administrateur de messagerie.


REP-4228 : MAPI ne prend pas en charge le service demandé par Report Builder.

Cause :	L'application MAPI a des fonctions limitées.
Action :	Vous devez peut-être passer à une version supérieure de votre fournisseur de service messagerie Windows. Contactez votre administrateur de messagerie.


REP-4229 : Le jeu de caractères demandé n'est pas accepté.

Cause :	Le jeu de caractères par défaut n'est pas accepté par MAPI.
Action :	Contactez votre administrateur de messagerie.


REP-4230 : La chaîne de caractères passée est trop longue.

Cause :	Vous avez transmis une chaîne de caractères trop longue pour la mise en oeuvre de MAPI.
Action :	Raccourcissez la chaîne et relancez l'opération.


REP-4232 : Trop de fichiers ouverts
REP-4232 : Trop de fichiers ouverts.

Cause :	La mise en oeuvre de MAPI n'accepte pas le nombre de fichiers ouverts.
Action :	Fermez les documents dont vous n'avez pas besoin.


REP-05000 : Le fichier modèle de notification n'est pas défini pour les travaux réussis.

Cause :	Aucun paramètre SUCCNOTEFILE n’est défini dans le fichier de configuration de Reports Server pour le fichier modèle de notification indiquant qu’un travail a réussi.
Action :	Ajoutez le paramètre SUCCNOTEFILE au fichier de configuration de Reports Server en le faisant pointer vers le fichier modèle de notification des travaux réussis. Pour plus d’informations, contactez l’administrateur de votre système.


REP-05001 : Le fichier modèle de notification n'est pas défini pour les travaux ayant échoué.

Cause :	Aucun paramètre FAILNOTEFILE n’est défini dans le fichier de configuration de Reports Server pour le fichier modèle de notification indiquant l’échec d’un travail.
Action :	Ajoutez le paramètre FAILNOTEFILE au fichier de configuration de Reports Server en le faisant pointer vers le fichier modèle de notification des travaux ayant échoué. Pour plus d’informations, contactez l’administrateur de votre système.


REP-05002 : Fichier modèle de notification introuvable.

Cause :	Le fichier indiqué par SUCCNOTEFILE ou par FAILNOTEFILE dans le fichier de configuration de Reports Server n’existe pas.
Action :	Vérifiez que SUCCNOTEFILE ou FAILNOTEFILE pointe vers un nom de fichier modèle de notification valide. Pour plus d’informations, contactez l’administrateur de votre système.


REP-05003 : Ouverture impossible du fichier modèle de notification.

Cause :	Le fichier modèle de notification indiqué par SUCCNOTEFILE ou par FAILNOTEFILE dans le fichier de configuration de Reports Server ne peut pas être ouvert.
Action :	Vérifiez que SUCCNOTEFILE ou FAILNOTEFILE pointe vers un nom de fichier modèle de notification valide. Vérifiez que ce fichier est lisible. Pour plus d’informations, contactez l’administrateur de votre système.


REP-05004 : Lecture impossible du fichier modèle de notification.

Cause :	Le fichier modèle de notification indiqué par SUCCNOTEFILE ou par FAILNOTEFILE dans le fichier de configuration de Reports Server ne peut pas être lu.
Action :	Vérifiez que SUCCNOTEFILE ou FAILNOTEFILE pointe vers un nom de fichier modèle de notification valide. Vérifiez que ce fichier est lisible. Pour plus d’informations, contactez l’administrateur de votre système.


REP-06000 : Création impossible d'une interrogation pour la boîte d'interrogation Express.

Cause :	L’interrogation est très volumineuse et requiert une quantité de mémoire trop importante.
Action :	Simplifiez l’interrogation.


REP-06001 : Echec d'appel de la boîte de dialogue d'interrogation Express.

Cause :	L’interrogation est très volumineuse et requiert une quantité de mémoire trop importante.
Action :	Simplifiez l’interrogation.


REP-06002 : Mémoire insuffisante pour mener à bien l'opération.

Cause :	La machine manque de mémoire.
Action :	Augmentez la quantité de mémoire en fermant des applications. Une solution à plus long terme consiste à augmenter la taille du fichier d’échange ou à installer davantage de mémoire sur la machine.


REP-06003 : Echec de démarrage d'une session du serveur Express.

Cause :	Le serveur Express n’est pas actif ou SNAPI n’est pas installé.
Action :	Démarrez le serveur Express Server s’il n’est pas déjà actif et vérifiez que SNAPI est installé. Pour obtenir de l’aide, contactez l’administrateur de la base de données du serveur Express.


REP-06004 : Echec de connexion au serveur Express.

Cause :	Le serveur Express n’est pas actif, le système manque de mémoire, ou SNAPI n’est pas installé ou ne fonctionne pas correctement.
Action :	Démarrez le serveur Express s’il n’est pas déjà actif. Augmentez la quantité de mémoire en fermant des applications. Une solution à plus long terme consiste à augmenter la taille du fichier d’échange ou à installer davantage de mémoire sur la machine. Vérifiez que SNAPI est installé. Pour obtenir de l’aide, contactez l’administrateur de la base de données du serveur Express.


REP-06005 : Echec d'initialisation de la boîte de dialogue d'interrogation Express en fonction de l'indicateur SNAPI fourni.

Cause :	Une erreur interne s’est produite.
Action :	Redémarrez le produit et soumettez de nouveau l’interrogation.


REP-06006 : Le fichier d'initialisation Express XPDATA.INI n'existe pas.

Cause :	Le fichier XPDATA.INI est introuvable.
Action :	Vérifiez que le fichier XPDATA.INI existe et que son chemin d’accès est correct.


REP-06007 : Entrée du fichier XCF introuvable dans la section [Install] du fichier d'initialisation Express XPDATA.INI.

Cause :	Il manque une entrée dans le fichier XPDATA.INI
Action :	Ajoutez une entrée XCF au fichier XPDATA.INI ou remplacez le fichier .INI par un fichier XPDATA.INI valide.


REP-06008 : ORACLE_HOME introuvable.

Cause :	Le répertoire ORACLE_HOME est introuvable.
Action :	Vérifiez que votre paramètre ORACLE_HOME est correct. Pour plus d’informations, reportez-vous aux instructions d’installation du serveur Express.


REP-06009 : Entrée Oracle SNAPI (OSN) introuvable dans la section [Install] du fichier d'initialisation Express XPDATA.INI.

Cause :	Il manque une entrée dans le fichier XPDATA.INI.
Action :	Ajoutez une entrée OSN au fichier XPDATA.INI ou remplacez le fichier .INI par un fichier XPDATA.INI valide.


REP-06010 : Description du serveur Express introuvable dans les fichiers de connexion Express (XCF).

Cause :	Il manque certaines informations dans les fichiers XCF.
Action :	Vérifiez ou recréez les fichiers XCF.


REP-06011 : La taille de l'instruction SQL select générée est supérieure à 64 kilo-octets.

Cause :	L’instruction SQL est trop volumineuse.
Action :	Modifiez votre interrogation pour réduire la taille de l’instruction SQL.


REP-06012 : Echec de suppression de l'interrogation Express temporaire.

Cause :	Une interrogation temporaire ne peut pas être supprimée.
Action :	Déconnectez-vous d’Express, reconnectez-vous, puis soumettez de nouveau l’interrogation ou recréez-la.


REP-06013 : Echec exécution interro. Boîte de dialogue interro Express appelée avec mesures/dimensions d'une interro précédente.

Cause :	Les mesures ou les dimensions ne sont pas valides, ou l’interrogation est altérée.
Action :	Vérifiez que la base de données est disponible, puis réexaminez les mesures et les dimensions de l’interrogation.


REP-06014 : XPFetch[N]() principal appelé avec un id d'état non défini.

Cause :	Une erreur interne s’est produite.
Action :	Redémarrez le produit et soumettez de nouveau l’interrogation.


REP-06015 : XPPrepare() principal appelé avec un id d'état en double.

Cause :	Une erreur interne s’est produite.
Action :	Redémarrez le produit et soumettez de nouveau l’interrogation.


REP-06016 : Erreur lors de la tentative de lecture de la cellule de données suivante depuis SNAPI.

Cause :	Une erreur interne s’est produite.
Action :	Redémarrez le produit et soumettez de nouveau l’interrogation.


REP-06017 : L'interrogation enregistrée contient des informations incorrectes, ou des informations sont absentes.

Cause :	L’interrogation n’est pas valide.
Action :	Formulez de nouveau l’interrogation.


REP-06018 : Echec de rattachement des bases de données système Express internes.

Cause :	Les bases de données système Express ne peuvent pas être rattachées.
Action :	Vérifiez que le serveur Express est actif, que les bases de données système sont installées et que le paramètre ExpressServerDBPath est correct.


REP-06019 : Echec de rattachement de la base de données Express indiquée dans l'interrogation enregistrée.

Cause :	Les bases de données système Express ne peuvent pas être rattachées.
Action :	Vérifiez que le serveur Express est actif, que la base de données est installée et que le paramètre ExpressServerDBPath est correct.


REP-06020 : Echec d'analyse de l'interrogation Express.

Cause :	L’instruction Select est endommagée.
Action :	Formulez de nouveau l’interrogation.


REP-06021 : Le support Oracle Express n'est pas installé.

Cause :	Les fichiers de support pour l’exécution avec Express ne sont pas installés.
Action :	Installez les fichiers de support Express. Pour plus d’informations, reportez-vous à la documentation sur l’installation.


REP-06022 : Echec de démarrage du serveur Express.

Cause :	Le serveur Express n’est pas actif.
Action :	Démarrez le serveur Express s’il n’est pas déjà actif. Pour obtenir de l’aide, contactez l’administrateur de la base de données du serveur Express.


REP-06023 : Fin de ligne inattendue lors de l'analyse de l'interrogation Express.

Cause :	Une erreur Express s’est produite.
Action :	Vérifiez dans l’interrogation Express qu’il ne manque aucun symbole \ en fin de ligne.


REP-06024 : Echec de la commande execute d'Express.

Cause :	Une erreur Express s’est produite.
Action :	Démarrez le serveur Express s’il n’est pas déjà actif. Pour obtenir de l’aide, contactez l’administrateur de la base de données du serveur Express.


REP-06025 : Echec de la commande fetch d'Express.

Cause :	Une erreur Express s’est produite.
Action :	Démarrez le serveur Express s’il n’est pas déjà actif. Pour obtenir de l’aide, contactez l’administrateur de la base de données du serveur Express.


REP-06026 : Id d'état en double détecté.

Cause :	Une erreur interne s’est produite.
Action :	Redémarrez le produit et soumettez de nouveau l’interrogation.


REP-06027 : Id d'état non défini détecté.

Cause :	Une erreur interne s’est produite.
Action :	Redémarrez le produit et soumettez de nouveau l’interrogation.


REP-06028 : Erreur de support Express inconnue.

Cause :	Une erreur Express s’est produite.
Action :	Démarrez le serveur Express s’il n’est pas déjà actif. Pour obtenir de l’aide, contactez l’administrateur de la base de données du serveur Express.


REP-6029 : Erreur Express.

Cause :	Une erreur Express s’est produite.
Action :	Pour plus d’informations, reportez-vous à votre documentation Express.


REP-6030 : xconnect.ini manquant ou non valide.

Cause :	xconnect.ini est peut-être manquant. Si ce fichier contient une zone [Général] non valide, cette erreur sera également générée.
Action :	Recherchez xconnect.ini dans Oracle_Home/olap/ecf620. Assurez-vous que ce fichier comprend une zone [Général].


REP-6101 : Le démarrage de la machine virtuelle Java a échoué. Vérifiez l'installation de l'environnement Java Runtime.

Cause :	En général, l'échec du démarrage est dû à une valeur non valide de la variable d'environnement REPORTS60_CLASSPATH ou à l'installation non valide de l'environnement Java Runtime.
Action :	Vérifiez l'installation de l'environnement Java Runtime. Assurez-vous que la variable d'environnement REPORTS60_CLASSPATH contient une spécification valide de classes.zip ou de rt.jar, selon la plate-forme utilisée. Si nécessaire, réinstallez Reports Runtime ou Report Builder afin de régénérer cet environnement et la définition de cette variable d'environnement.


REP-6102 : Le démarrage de l'analyseur XML a échoué.

Cause :	L'analyseur XML d'Oracle n'a pas pu démarrer car une application n'a pas été correctement installée. En général, cet échec est dû à une valeur non valide de REPORTS60_CLASSPATH.
Action :	Assurez-vous que REPORTS60_CLASSPATH contient une spécification valide de l'analyseur XML et des fichiers .jar du produit. Si nécessaire, réinstallez Reports Runtime ou Report Builder afin de régénérer la définition de la variable d'environnement REPORTS60_CLASSPATH.


REP-6103 : Erreur d'installation de l'environnement Java Runtime.

Cause :	Installation incorrecte ou manquante de l'environnement Java Runtime.
Action :	Réinstallez Reports Runtime ou Report Builder.


REP-6104 : Définition d'état XML non valide.

Cause :	Définition d'état XML non valide ou manquante.
Action :	Indiquez une définition d'état XML valide ou corrigez l'erreur indiquée dans la définition de l'état.


REP-6106 : Erreur dans la définition de l'état XML à la ligne <numéro de la ligne> dans <URL>

Cause :	Une erreur s'est produite dans la définition d'état XML indiquée, au numéro de ligne spécifié.
Action :	Corrigez l'erreur détectée dans la définition d'état XML, au numéro de ligne indiqué.


REP16500.  Ce programme ne peut être appelé que comme exécutable CGI.
REP-16500.  Ce programme ne peut être appelé que comme exécutable CGI.

Cause :	Un exécutable CGI Web a été appelé hors du contexte du serveur Web.
Action :	Un exécutable CGI doit être appelé par un serveur Web pour fonctionner correctement.


REP16501.  Le fichier de correspondance de clés Reports Web Agent est mal défini.
REP-16501.  Le fichier de correspondance de clés Reports Web Agent est mal défini.

Cause :	Le fichier de correspondances de clés est introuvable à l'emplacement indiqué.
Action :	Vérifiez l'emplacement du fichier.


REP 16504 :  Initialisation impossible du système de messages. S'assurer que le système de messages est bien installé.

Cause :	Le fichier de messages est introuvable ou ne peut pas être ouvert.
Action :	Vérifiez votre installation.


REP16505.  Erreur générale au cours de l'initialisation. Vérifier l'installation.
REP-16505.  Erreur générale au cours de l'initialisation. Vérifier l'installation.

Cause :	Message d'erreur général.
Action :	Vérifiez votre installation et la disponibilité des ressources système.


REP16506.  Votre URL contient des échappements mal formés.
REP-16506.  Votre URL contient des échappements mal formés.

Cause :	L'URL soumise est mal formée.
Action :	Consultez les règles concernant les URL dans la documentation Web Agent.


REP16507.  Clé non reconnue.
REP-16507.  Clé non reconnue.

Cause :	La configuration de correspondance de clés est active, mais la clé indiquée dans l'URL n'est pas reconnue - impossible de générer la ligne de commande.
Action :	Vérifiez la valeur de la clé , ainsi que la configuration et le contenu du fichier de correspondance de clés.


REP16508.  Clé \"%s\" non reconnue. Causes poss. : syntaxe URL incorr. ; URL introuv. dans fichier corresp. de clés.
REP-16508.  Clé \"%s\" non reconnue. Causes poss. : syntaxe URL incorr. ; URL introuv. dans fichier corresp. de clés.

Cause :	La configuration de correspondance de clés est active, mais la clé indiquée dans l'URL n'est pas reconnue - impossible de générer la ligne de commande.
Action :	Vérifiez la valeur de la clé , ainsi que la configuration et le contenu du fichier de correspondance de clés.


REP16509.  Erreurs de syntaxe dans le fichier de correspondance de clés. Veuillez vérifier la définition de la clé soumise.
REP-16509.  Erreurs de syntaxe dans le fichier de correspondance de clés. Veuillez vérifier la définition de la clé soumise.

Cause :	Erreurs de syntaxe dans le fichier de correspondance de clés.
Action :	Vérifiez le contenu du fichier de correspondance de clés (pour connaître les règles applicables, consultez la documentation Web Agent).


REP16510.  Utilisation incorrecte.
REP-16510.  Utilisation incorrecte.

Cause :	Message d'erreur général pour l'exécution non verbeuse.
Action :	Activer la consignation en mode verbeux et vérifiez le message réel.


REP16511.  Votre URL contient trop de paramètres.
REP-16511.  Votre URL contient trop de paramètres.

Cause :	L'URL contient trop de paramètres (elle est trop longue).
Action :	Utilisez une URL plus courte ou des fichiers de correspondance de clés pour raccourcir l'URL utilisée.


REP16512.  Mémoire saturée.
REP-16512.  Mémoire saturée.

Cause :	Mémoire insuffisante.
Action :	Assurez-vous que suffisamment de ressources système sont disponibles.


REP16513.  Communication impossible avec Reports Server.
REP-16513.  Communication impossible avec Reports Server.

Cause :	Reports Server ne répond pas.
Action :	Vérifiez que Reports Server est actif et qu'une entrée correcte lui correspondant figure dans le fichier de configuration réseau TNSNAMES.ORA.


REP16514.  Exécution impossible de l'état.
REP-16514.  Exécution impossible de l'état.

Cause :	Message d'erreur général en cas d'échec de l'exécution de l'état.
Action :	Consultez le message d'erreur détaillé de Reports Server se rapportant au présent message.


REP16515.  Accès impossible à la sortie d'état.
REP-16515.  Accès impossible à la sortie d'état.

Cause :	Web Agent ne peut accéder à la sortie d'exécution de Report Server.
Action :	Vérifiez la configuration de Web Agent (en particulier la variable WEBLOC).


REP16516.  Reports Server va s'arrêter.
REP-16516.  Reports Server va s'arrêter.

Cause :	Avertissement - Reports Server va s'arrêter.
Action :	Réessayez ultérieurement.


REP 16517.  Travail d'état annulé par l'utilisateur.
REP-16517.  Travail d'état annulé par l'utilisateur.

Cause :	Le travail a été annulé par vous-même ou par l'administrateur de Reports Server.
Action :	Réessayez si nécessaire.


REP16518.  Reports Server Engine s'est arrêté anormalement.
REP-16518.  Reports Server Engine s'est arrêté anormalement.

Cause :	Reports Server Engine a des difficultés avec votre état.
Action :	Prenez contact avec l'administrateur de Reports Server.


REP16519.  Le travail d'état s'est arrêté à cause d'une erreur.
REP-16519.  Le travail d'état s'est arrêté à cause d'une erreur.

Cause :	Message d'erreur général en cas d'erreur d'exécution de l'état.
Action :	Consultez le message détaillé associé.


REP16520.  Une erreur s'est produite au cours de la mise en file d'attente du travail dans Reports Server.
REP-16520.  Une erreur s'est produite au cours de la mise en file d'attente du travail dans Reports Server.

Cause :	Une erreur s'est produite au cours de la mise en file d'attente du travail dans Reports Server.
Action :	Réessayez ultérieurement.


REP16521.  Une erreur s'est produite au cours de l'analyse de la ligne de commande de Reports Server.
REP-16521.  Une erreur s'est produite au cours de l'analyse de la ligne de commande de Reports Server.

Cause :	Une erreur s'est produite au cours de l'exécution de l'état et du traitement de la ligne de commande.
Action :	Prenez contact avec l'administrateur de Reports Server.


REP16522.  Le nom de Reports Server n'est pas indiqué.
REP-16522.  Le nom de Reports Server n'est pas indiqué.

Cause :	Une erreur s'est produite au cours de l'exécution de l'état et du traitement de la ligne de commande.
Action :	Prenez contact avec l'administrateur de Reports Server.


REP16523.  Le nom d'état n'est pas indiqué.
REP-16523.  Le nom d'état n'est pas indiqué.

Cause :	Une erreur s'est produite au cours de l'exécution de l'état et du traitement de la ligne de commande.
Action :	Prenez contact avec l'administrateur de Reports Server. Vérifiez le nom de l'état sur la ligne de commande.


REP16524.  Connexion de base de données non indiquée.
REP-16524.  Connexion de base de données non indiquée.

Cause :	Une erreur s'est produite au cours de l'exécution de l'état et du traitement de la ligne de commande.
Action :	Prenez contact avec l'administrateur de Reports Server. Vérifiez la connexion à la base de données sur la ligne de commande.


REP16525.  Interprétation impossible de la commande de programmation.
REP-16525.  Interprétation impossible de la commande de programmation.

Cause :	Une erreur s'est produite au cours de l'exécution de l'état et du traitement de la ligne de commande.
Action :	Prenez contact avec l'administrateur de Reports Server. Vérifiez le paramètre SCHEDULE.


REP16526.  Interprétation impossible de la tolérance de temps.
REP-16526.  Interprétation impossible de la tolérance de temps.

Cause :	Une erreur s'est produite au cours de l'exécution de l'état et du traitement de la ligne de commande.
Action :	Prenez contact avec l'administrateur de Reports Server. Vérifiez le paramètre TOLERANCE.


REP16527.  Type de paramètre non valide.
REP-16527.  Type de paramètre non valide.

Cause :	Une erreur s'est produite au cours de l'exécution de l'état et du traitement de la ligne de commande.
Action :	Prenez contact avec l'administrateur de Reports Server. Vérifiez le paramètre PARAMFORM.


REP16528.  Une erreur s'est produite au cours de la communication avec Reports Server.
REP-16528.  Une erreur s'est produite au cours de la communication avec Reports Server.

Cause :	Problème de communication.
Action :	Réessayez ultérieurement.


REP16529.  Suppression impossible du travail :
REP-16529.  Suppression impossible du travail :

Cause :	Message général concernant la suppression du travail.
Action :	Recherchez la cause du problème.


REP16530.  Id de travail non valide.
REP-16530.  Id de travail non valide.

Cause :	L'ID du travail Reports Server sur lequel porte l'action n'est pas valide.
Action :	Indiquez un ID valide.


REP16531.  Travail déjà terminé.
REP-16531.  Travail déjà terminé.

Cause :	L'ID du travail Reports Server sur lequel porte l'action n'est pas valide
Action :	Indiquez un ID valide.


REP16532.  Le travail n'est pas encore exécuté. Réessayer ultérieurement.
REP-16532.  Le travail n'est pas encore exécuté. Réessayer ultérieurement.

Cause :	L'ID du travail Reports Server sur lequel porte l'action n'est pas valide.
Action :	Indiquez un ID valide.


REP 16533  Privilèges insuffisants pour exécuter l'action demandée.
REP-16533.  Privilèges insuffisants pour exécuter l'action demandée.

Cause :	L'ID du travail Reports Server sur lequel porte l'action n'est pas valide.
Action :	Vérifiez la saisie de l'ID et assurez-vous de disposer des privilèges nécessaires.


REP16534.  Accès impossible à la sortie d'état. Vérifier la configuration (REPORTS 60_WEBLOC)
REP-16534.  Accès impossible à la sortie d'état. Vérifier la configuration (REPORTS 60_WEBLOC)

Cause :	Le répertoire de sortie n'est pas accessible.
Action :	Vérifiez la définition du répertoire.


REP 16535. ou Reports60_WEBLOC_TRANSLATED probablement non valide.)
REP-16535 : ou Reports60_WEBLOC_TRANSLATED probablement non valide)

Cause :	Le répertoire de sortie n'est pas accessible.
Action :	Vérifiez la définition du répertoire.


REP 16537. (L'environnement REPORTS60_WEBLOC_TRANSLATED pointe probablement sur le même emplacement qu'un cache de Reports Server.)
REP-16537 : (L'environnement REPORTS60_WEBLOC_TRANSLATED pointe probablement sur le même emplacement qu'un cache de Reports Server.)

Cause :	Il existe déjà dans le répertoire Web une sortie portant le nom renvoyé.
Action :	Vérifiez la configuration de Web Agent.


REP 16538.  La sortie d'état a été imprimée avec succès.
REP-16538 :  La sortie d'état a été imprimée avec succès.

Cause :	Succès de l'envoi de l'état à l'imprimante.
Action :	Aucune.


REP 16539 La sortie d'état a été envoyée avec succès.
REP-16539 :  La sortie d'état a été envoyée avec succès.

Cause :	Succès de l'envoi de l'état à la messagerie électronique.
Action :	Aucune.


REP 16540 La sortie d'état a été enregistrée avec succès à la destination demandée.
REP-16540 :  La sortie d'état a été enregistrée avec succès à la destination demandée.

Cause :	Succès de l'envoi de l'état vers la destination demandée.
Action :	Aucune.


REP-16541 Vous devez ouvrir une session avant d'exécuter l'état.
REP-16541 :  Vous devez ouvrir une session avant d'exécuter l'état.

Cause :	Vous n'avez pas ouvert de session avant d'exécuter l'état.
Action :	Ouvrez une session avant d'exécuter l'état.


REP-16542 La sortie d'état a été enregistrée avec succès dans le référentiel InterOffice.
REP-16542 :  La sortie d'état a été enregistrée avec succès dans le référentiel InterOffice.

Cause :	L'état a été exécuté avec succès dans le référentiel InterOffice.
Action :	Aucune.


REP-16543 REPORTS60_PHYSICAL_MAP ou REPORTS60_SHARED_CACHE probablement non valide.)
REP-16543 :  REPORTS60_PHYSICAL_MAP ou REPORTS60_SHARED_CACHE probablement non valide.

Cause :	Le répertoire de sortie n'est pas accessible.
Action :	Vérifiez la définition du répertoire.


REP-20091 :  Voulez-vous enregistrer le module courant avant de vous déconnecter de la base ?

Cause :	Un module ouvert est stocké dans la base de données. Si vous vous déconnectez de cette base, vous ne pouvez pas enregistrer les modifications apportées.
Action :	Sélectionnez Oui pour enregistrer le module avant de vous déconnecter de la base de données ; le module reste ouvert afin que vous puissiez vous connecter à nouveau au besoin et l'enregistrer dans la base de données. Sélectionnez Non pour vous déconnecter de la base de données sans enregistrer le module ; ce dernier reste ouvert. Sélectionnez Annuler pour rester connecté à la base de données sans rien enregistrer ; le module reste ouvert.


REP-20099 :  Modification d'imprimante au cours de l'aperçu. Troncature probable. Voulez-vous poursuivre l'impression ?

Cause :	Entre l'exécution de l'état et la sélection d'Imprimer dans l'Aperçu, votre imprimante par défaut a changé.
Action :	Sélectionnez Oui pour poursuivre l'impression ou bien sélectionnez Non pour arrêter l'impression, puis fermez l’état. Dans ce cas, vous pouvez soit réinitialiser l’imprimante et exécuter à nouveau l’état, soit réexécuter directement l’état afin de le formater pour l'imprimante en cours.


REP-20128 : Avertissement ! Etat non exécuté avec DESTYPE=PREVIEW. Troncature probable. Voulez-vous poursuivre l'impression ?

Cause :	Vous avez sélectionné Imprimer dans l'Aperçu interactif, mais indiqué Screen au lieu de Preview, ce qui met votre état en forme comme si vous utilisiez les polices de l'imprimante, et offre une vue plus précise de la sortie imprimée de votre état
Action :	Sélectionnez Yes pour poursuivre l'impression ou No pour l'arrêter. Puis fermez votre état et exécutez-le à nouveau en indiquant Preview pour le mettre en forme en vue de son impression.


REP-20129 : Attention ! Ouverture d'un état enregistré avec une version plus récente de Report Builder. Risque de perte de fonctionnalité. Voulez-vous continuer ?
REP-20129 Attention ! Ouverture d'un état enregistré avec une version plus récente de Report Builder. Risque de perte de fonctionnalité. Voulez-vous continuer ?

Cause :	Vous avez tenté d'ouvrir un état avec une version de Report Builder antérieure à celle utilisée pour créer l'état. Si l'état utilise des fonctions qui n'existaient pas dans l'ancienne version, celles-ci seront éliminées de l'état.
Action :	Si vous craignez de perdre des fonctions, n'ouvrez l'état qu'après avoir installé la version la plus récente de Report Builder.


REP-20135 : Exécution impossible sans présentation. Voulez-vous créer une présentation par défaut ?

Cause :	Vous avez tenté d'exécuter votre état après avoir créé un modèle de données mais avant de créer une présentation.
Action :	Créez une présentation, puis exécutez votre état.


REP-20136 : Zone choisie pour présentation par défaut trop petite. L'étendre aux limites de la page ?

Cause :	Vous avez utilisé l'outil Présentation par défaut supplémentaire de la palette Outils pour tracer pour une présentation, une zone qui n'était pas suffisamment grande pour les paramètres indiqués dans l'assistant Report.
Action :	Sélectionnez Oui pour que Report Builder agrandisse la plage de la présentation aux limites d'une page d'état, ou sélectionnez Non et modifiez les paramètres de l'assistant Report pour diminuer la taille de la présentation.


REP-20138 : Il se peut que les tables de Report Builder ne soient pas installées dans la base de données.

Cause :	Report Builder n'a pas pu accéder à ses tables, dans la base de données.
Action :	Signalez à votre administrateur de bases de données que les tables de Report Builder n'ont pas été correctement installées dans la base de données.


REP-20139 : La présentation de grille de paramètres ne tient pas dans sa taille actuelle. Voulez-vous augmenter le nombre de pages ?

Cause :	La nouvelle grille de paramètres est trop grande pour le nombre de pages indiqué pour la grille dans la boîte de dialogue Propriétés d'état.
Action :	Sélectionnez Oui pour que Report Builder augmente le nombre de pages dans la grille de paramètres, ou sélectionnez Non et modifiez les paramètres de la boîte de dialogue Propriétés d'état pour agrandir la grille de paramètres.


REP-20140 : Avertissement ! Ceci va supprimer l'encadrement et tous les objets qu'il contient. Voulez-vous continuer ?


REP-20141 : Avertissement ! Ceci va détruire la matrice entière. Voulez-vous continuer ?


REP-20142 : Avertissement ! Le mode de l'état a été changé pour CHARACTER. L'état sera exécuté dans une fenêtre distincte.


REP-20143 : Avertissement ! Des objets ont pu être déplacés de la page, menant à un état ne pouvant pas être formaté.


REP-20144 : Ouverture d'un état enregistré avec une version plus récente de Report Builder. Risque de perte de fonctionnalité.

Cause :	Vous avez tenté d'ouvrir un état avec une version de Report Builder antérieure à celle utilisée pour créer l'état. Si l'état utilise des fonctions qui n'existaient pas dans l'ancienne version, celles-ci seront éliminées de l'état.
Action :	Si vous craignez de perdre des fonctions, n'ouvrez l'état qu'après avoir installé la version la plus récente de Report Builder.


REP-20146 : Cette action peut invalider les références aux colonnes dans l'objet référencé.

Cause :	La réduction de colonnes de base de données de type Ref, table imbriquée ou Varray peut empêcher l'utilisation externe des colonnes référencées (par exemple, dans des unités de programmes PL/SQL ou dans des colonnes récapitulatives).
Action :	Pour utiliser les colonnes référencées, ne réduisez pas les colonnes de base de données de type Ref, table imbriquée ou Varray qui y font référence.


REP-20147 : Impossible de mettre en oeuvre le lien de colonne pour cette interrogation SQL détail. Conversion en un lien de groupe.

Cause :	Les liens de données établis entre une interrogation et une interrogation de détail d'objet ne sont pas pris en charge.
Action :	Si vous cliquez sur Oui, vous créez un lien entre les groupes parents et les deux interrogations. Si vous cliquez sur Annuler, vous ne créez pas de lien. Vous pouvez cependant en créer un manuellement via SQL.dans l'interrogation de détail.


REP-20148 : Attention ! L'état va s'exécuter vers des destinations multiples. Voulez-vous continuer ?

Cause :	La propriété Diffusion de l'état que vous exécutez envoie la sortie vers plusieurs destinations.
Action :	Si vous cliquez sur Continuer, l'état est exécuté et la sortie est envoyée vers toutes les destinations définies. Si vous cliquez sur Annuler, l'état n'est pas exécuté.


REP-20150 : Attention ! Largeur de page de l'état '<nom de l'état>' changée pour contenir la police d'une cellule de caractère. Il se peut que cela soit causé par la correspondance de polices dans le fichier des alias police.

Cause :	Une police de caractères a remplacé une police bitmap dans l'état que vous avez ouvert et la largeur de page a été ajustée en conséquence. Il est possible qu'un état bitmap soit ouvert dans le moteur d'exécution en mode caractère.
Action :	Si vous voulez que la police soit remplacée par une police spécifique, modifiez le fichier d'alias police (uifont.ali ou Oracle Font Aliases, selon votre plate-forme), pour que ces polices correspondent à celles que vous voulez utiliser. Sinon, aucune action n'est nécessaire.


REP-20151 : Avertissement ! Des polices ont été changées conformément à correspondance de polices dans fichier alias police.

Cause :	Une ou plusieurs polices enregistrées avec l'état ont été remplacées par d'autres en raison d'un changement de plate-forme, d'écran, de destination d'état ou de mode.
Action :	Si vous voulez que la police soit remplacée par une police spécifique, modifiez le fichier d'alias police (uifont.ali ou Oracle Font Aliases, selon votre plate-forme), pour que ces polices correspondent à celles que vous voulez utiliser. Sinon, aucune action n'est nécessaire.


REP-20190 : Quitter met fin à l'état en cours et à tous les états en attente.

Cause :	Vous avez indiqué que vous vouliez quitter le serveur d'états ou le moteur d'arrière-plan d'états, alors que un ou plusieurs états étaient en cours ou en attente d'exécution.
Action :	Si vous voulez que vos états finissent de s'exécuter, annulez l'opération. Sinon, acceptez le dialogue d'avertissement.


REP-20191 : Impossible de quitter Windows pendant l'exécution de ce programme. Fermer le serveur d'états et quitter Windows.

Cause :	Le moteur d'arrière-plan d'états requiert Windows, mais vous avez indiqué que vous vouliez sortir de Windows pendant que le moteur d'arrière-plan d'états s'exécutait.
Action :	Sortez du moteur d'arrière-plan d'états avant de quitter Windows.


REP-25204 : Conversion réussie

Cause :	La conversion demandée a été effectuée avec succès.
Action :	Aucune.


REP-25206 : Echec de conversion de '<nom de la source>' en '<nom de la destination>'
REP-25206 : Echec de conversion de '<nom de la source>' en '<nom de la destination>'.

Cause :	Il est très probable que le type de source que vous avez indiqué était erroné.
Action :	Vérifiez le type de source du fichier source.


REP-25207 : Conversion erronée : Stype et Dtype ne sont pas du même type de document.

Cause :	Vous avez tenté de convertir un document d'un type en un autre type, c'est-à-dire tenté de convertir l'un des fichiers d'état en fichier PL/SQL, ou vice versa.
Action :	Assurez-vous que le fichier source et le fichier cible de votre conversion sont de même type.


REP-25401 : Impossible de localiser '<fichier .DLL sortie utilisateur>'
REP-25401 : Impossible de localiser '<fichier .DLL sortie utilisateur>'.

Cause :	Votre état a tenté d'exécuter une sortie utilisateur, mais n'a pas pu trouver le fichier .DLL. Ce fichier réside généralement dans :
	•	le répertoire courant,
	•	le répertoire Windows (généralement \WINDOWS),
	•	le répertoire système Windows (en général \WINDOWS\SYSTEM),
	•	le répertoire contenant le fichier exécutable de la tâche en cours,
	•	les répertoires indiqués dans la variable d'environnement PATH,
	•	la liste des répertoires mappés en réseau.
Action :	Localisez le fichier .DLL indiqué et placez-le dans l'un des répertoires mentionnés ci-dessus.


REP-25402 : Erreur interne - Impossible de localiser '<fichier .DLL sortie utilisateur>' dans '<nom du fichier>'
REP-25402 : Erreur interne - Impossible de localiser '<fichier .DLL sortie utilisateur>' dans '<nom du fichier>'.

Cause :	Votre état a tenté d'exécuter une sortie utilisateur, mais certaines fonctions utilisées pour localiser et exécuter ce type de sortie n'ont pas pu être localisées dans le fichier de sortie utilisateur .DLL . Cela signifie que le fichier de sortie utilisateur .DLL a été mal conçu, car ces fonctions se trouvent dans un fichier .OBJ fourni avec Report Builder, qui doit toujours être lié au fichier de sortie utilisateur .DLL.
Action :	Recréez correctement le fichier de sortie utilisateur .DLL indiqué.


REP-31681 : Attention : La connexion à une base de données différente peut invalider le modèle de données existant.

Cause :	Vous ne pouvez établir qu'une seule connexion simultanée à une base de données. Si vous persistez à vous connecter à une autre base de données, le modèle de données existant risque de ne plus être valide par la suite.
Action :	Afin de préserver la validité du modèle de données existant, ne vous reconnectez à une autre base de données que si vous êtes sûr que les interrogations sont compatibles avec la connexion à cette nouvelle base de données.


REP-31700 : Définition de l'état incomplète ou interro sans groupe de ventil. Exécution imposs. de l'Assistant Web.

Cause :	Vous devez compléter la définition de l'état avant d'exécuter l'assistant Web. Pour que l'assistant Web puisse être lancé, il faut que la définition de l'état contienne un modèle de données comportant plusieurs groupes et un modèle de présentation valide.
Action :	Créez au moins une interrogation avec plusieurs groupes et employez par défaut la présentation qui utilise l'assistant Report.


REP-31800 : Fichier image <nom du fichier> introuvable
REP-31800 : Fichier image <nom du fichier> introuvable.

Cause :	Report Builder n'a pas pu trouver l'un de ses fichiers image. Causes possibles :
	Cas 1 :	Le fichier image n'existe pas.
	Cas 2 :	Le fichier image n'est pas à l'endroit voulu.
	Cas 3 :	L'environnement n'est pas correctement configuré.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier image existe.
	Cas 2 :	Assurez-vous que le fichier image est dans le répertoire voulu.
	Cas 3 :	Assurez-vous que l'environnement est correctement défini. Sous Unix, assurez-vous que la variable d'environnement appropriée est bien définie et, sous MS Windows, vérifiez le fichier oracle.ini.


REP-31801 : Le fichier image <nom du fichier> indiqué dans le modèle est introuvable.

Cause :	Report Builder n'a pas pu trouver l'image correspondant au modèle choisi. Causes possibles :
	Cas 1 :	Le fichier image n'existe pas.
	Cas 2 :	Le fichier image n'est pas à l'endroit voulu.
	Cas 3 :	L'environnement n'est pas correctement configuré.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier image existe.
	Cas 2 :	Assurez-vous que le fichier image est dans le répertoire voulu.
	Cas 3 :	Assurez-vous que l'environnement est correctement défini. Sous Unix, assurez-vous que la variable d'environnement appropriée est bien définie et, sous MS Windows, vérifiez le fichier oracle.ini.


REP-31802 : Vous devez entrer une instruction SQL dans cette page.

Cause :	L'assistant Report ne peut créer votre état que s'il existe un texte SQL valide.
Action :	Entrez une instruction SQL.


REP-31803 : Vous devez vous connecter à une base de données pour que votre texte SQL soit vérifié.

Cause :	L'assistant Report demande une connexion à une base de données pour pouvoir vérifier votre texte SQL.
Action :	Pour vous connecter à une base de données, tapez votre chaîne de connexion dans la boîte de dialogue Connexion. Le message demandant de vous connecter à une base de données n'apparaît qu'en cas de besoin. Si vous avez du mal à vous connecter, vérifiez vos informations de connexion auprès de votre administrateur de bases de données (DBA).


REP-31804 : Votre texte SQL est correct.

Cause :	Votre assistant Report a comparé votre texte SQL à la base de données et confirme qu'il est correct.
Action :	Aucune.


REP-31805 : Le niveau de ventilation <numéro de niveau de ventilation> ne compte pas de colonnes de ventilation valides.

Cause :	Chaque niveau de ventilation doit comporter au moins une colonne de ventilation valide. Une colonne de ventilation ne peut pas être une colonne récapitulative ou une colonne de réserve, et ne peut être de type Raw, Longraw ou Long.
Action :	Fournissez au moins une colonne de ventilation valide pour le niveau de ventilation ou transférez toutes les colonnes de ce niveau de ventilation à un autre niveau contenant une colonne de ventilation valide.


REP-31806 : Désignation impossible de tous les champs comme champs de ventilation
REP-31806 : Désignation impossible de tous les champs comme champs de ventilation.

Cause :	Vous avez désigné tous vos champs comme champs de ventilation. Chaque champ de ventilation regroupe les données des champs qui ne sont pas des champs de ventilation. Cette opération n'est pas valide, car vous n'avez défini aucun champ comme champ autre que champ de ventilation
Action :	Déclarez au moins un champ comme n'étant pas un champ de ventilation. Il est conseillé de supprimer tous les champs de ventilation de votre niveau de ventilation le plus élevé (c'est-à-dire du bas de votre liste de champs de ventilation).


REP-31807 : Fichier modèle '<nom du fichier>' introuvable
REP-31807 : Fichier modèle '<nom du fichier>' introuvable.

Cause :	Report Builder n'a pas pu trouver le fichier modèle dont vous avez indiqué le nom. Causes possibles :
	Cas 1 :	Le fichier image n'existe pas.
	Cas 2 :	Le fichier image n'est pas à l'endroit voulu.
	Cas 3 :	L'environnement n'est pas correctement configuré.
Action :	Pour corriger cette erreur, vous pouvez exécuter les actions suivantes :
	Cas 1 :	Assurez-vous que le fichier image existe.
	Cas 2 :	Assurez-vous que le fichier image est dans le répertoire voulu.
	Cas 3 :	Assurez-vous que l'environnement est correctement défini. Sous Unix, assurez-vous que la variable d'environnement appropriée est bien définie et, sous MS Windows, vérifiez le fichier oracle.ini.


REP-31808 : Vous devez entrer une instruction SQL...

Cause :	Vous devez entrer une instruction SQL pour que l'assistant Report génère un état.
Action :	Utilisez l'assistant Report pour entrer une instruction SQL.


REP-31809 : Vous devez choisir un champ à afficher au minimum.

Cause :	Vous n'avez pas sélectionné de champ à afficher.
Action :	Sélectionnez des champs à afficher.


REP-31810 : Vous devez choisir un groupe de ventilation au minimum.

Cause :	Le type d'état en cours nécessite des groupes de ventilation.
Action :	Créez des groupes de ventilation.


REP-31811 : Vous devez choisir une ligne de matrice au minimum.

Cause :	Vous n'avez sélectionné aucune ligne de matrice.
Action :	Sélectionnez des colonnes comme lignes de matrice.


REP-31812 : Vous devez choisir une colonne de matrice au minimum.

Cause :	Vous n'avez sélectionné aucune ligne de matrice.
Action :	Sélectionnez des colonnes comme lignes de matrice.


REP-31813 : Vous devez choisir une cellule de matrice au minimum.

Cause :	Vous n'avez sélectionné aucune ligne de matrice.
Action :	Sélectionnez des colonnes comme lignes de matrice.


REP-31814 : Vous devez choisir une ventilation de matrice au minimum.

Cause :	Vous n'avez sélectionné aucune ligne de matrice.
Action :	Sélectionnez des colonnes comme groupes de ventilation de matrice.


REP-31815 : Vous devez avoir un champ affiché par groupe.

Cause :	Vous n'avez sélectionné aucune ventilation de matrice. Causes possibles :
	1) Vous avez choisi ce champ comme champ de groupe.
	2) Vous avez choisi d'utiliser par défaut le groupe de ce champ, et le champ est le seul qui ait été marqué "à utiliser par défaut" dans son groupe.
Action :	1) Si vous avez choisi ce champ comme champ de groupe, vous pouvez passer à la page de groupe pour annuler la sélection du champ.
	2) Si vous avez choisi d'utiliser par défaut le groupe de cette colonne, vous pouvez passer à la page de groupe pour annuler la sélection de ce groupe.


REP-31816 : Vous devez définir des groupes par défaut.

Cause :	Vous n'avez pas défini de groupe par défaut.
Action :	Définissez des groupes par défaut.


REP-31817 : Sommet du groupe : déplacement vers le haut impossible
REP-31817 : Sommet du groupe : déplacement vers le haut impossible.

Cause :	Cette colonne se trouve au sommet de son groupe.
Action :	N'essayez pas de déplacer cette colonne vers le bas.


REP-31818 : Bas du groupe : déplacement vers le bas impossible
REP-31818 : Bas du groupe : déplacement vers le bas impossible.

Cause :	Cette colonne se trouve en bas de son groupe.
Action :	N'essayez pas de déplacer cette colonne vers le bas.


REP-31819 : Réorganisation impossible des colonnes de niveau d'état ici
REP-31819 : Réorganisation impossible des colonnes de niveau d'état ici.

Cause :	Les colonnes de niveau d'état n'ont pas l'attribut POS.
Action :	Choisissez l'endroit où vous voulez afficher les colonnes de niveau Etat dans l'Editeur de modèle de présentation.


REP-31820 : Les groupes sélectionnés ne comportent pas de colonnes.

Cause :	Les groupes sélectionnés ne comportent pas de colonnes. Aucun état ne peut donc être généré.
Action :	Sélectionnez un autre groupe comportant des colonnes.


REP-31821 : Aucun texte n'est indiqué dans l'éditeur de texte.

Cause :	Le texte d'un état de lettre type ou d'étiquette de publipostage est vide.
Action :	Entrez du texte dans l'Editeur de texte.


REP-31822 : Vous devez d'abord sélectionner un groupe.

Cause :	Vous n'avez sélectionné aucun groupe.
Action :	Passez à la page de groupe et sélectionnez un groupe.


REP-31823 : Vous ne devez sélectionner qu'un seul groupe.

Cause :	Vous avez sélectionné plusieurs groupes.
Action :	Ne sélectionnez qu'un seul groupe.


REP-31824 : Sélectionnez un autre groupe, car le groupe sélectionné ne comporte pas de colonnes.

Cause :	Le groupe sélectionné ne comporte pas de colonnes.
Action :	Sélectionnez un autre groupe comportant des colonnes.


REP-31825 : Annuler l'assistant et corriger l'anomalie dans les éditeurs d'état.

Cause :	Le modèle de données n'est pas valide ou la zone par défaut est trop petite.
Action :	Réglez le problème dans l'Editeur de modèle de données ou l'Editeur de modèle de présentation.


$ REP-31827 Orientation d'impression non valide ou valeur de la colonne récapitulative de niveau de page par défaut non autorisée.
REP-31827 : Orientation d'impression non valide ou valeur de colonne récapitulative de niveau de page par défaut non autorisée.

Cause :	L'orientation d'impression d'un ou de plusieurs groupes n'est pas valide pour le style par défaut indiqué, ou la colonne récapitulative de niveau de page a été sélectionnée comme valeur par défaut (les récapitulatifs de niveau de page ne sont pas pris en charge par la valeur par défaut).
Action :	Demandez à l'utilisateur de modifier l'orientation d'impression du groupe ou du style par défaut, ou désélectionnez tous les récapitulatifs de niveau de page.


REP-31950 : Erreur survenue dans le support graphique de Report Builder
REP-31950 : Erreur survenue dans le support graphique de Report Builder.

Cause :	Il s'est produit une erreur pendant l'initialisation de l'assistant Graphique.
Action :	Vérifiez l'installation de tous les composants. Redémarrez le produit.


REP-31951 : Initialisation impossible de l'assistant Graphique. Assurez-vous qu'il est correctement installé.

Cause :	La bibliothèque de Chart Builder n'a pas pu être initialisée.
Action :	Vérifiez l'installation de l'assistant Chart Builder et de l'exécutable runtime et assurez-vous qu'il y a suffisamment de ressources système disponibles.


REP-31952 : Initialisation impossible de l'assistant Graphique. Version des bibliothèques incorrecte.
REP-31952 : Initialisation impossible de l'assistant Grahique. Version des bibliothèques incorrecte.

Cause :	La bibliothèque de Chart Builder n'a pas pu être initialisée.
Action :	Vérifiez l'installation des bibliothèques de l'assistant Chart Builder et assurez-vous qu'il y a suffisamment de ressources système disponibles.


REP-31953 : Erreur survenue dans l'assistant Graphique de Report Builder.

Cause :	La bibliothèque de Chart Builder n'a pas pu être initialisée.
Action :	Vérifiez l'installation des bibliothèques de l'assistant Chart Builder et assurez-vous qu'il y a suffisamment de ressources système disponibles.


REP-31954 : Erreur survenue dans l'interface utilisateur de l'assistant Graphique de Report Builder.

Cause :	L'Assistant graphique n'a pas pu être chargé.
Action :	Vérifiez l'installation des bibliothèques de l'assistant Chart Builder et assurez-vous qu'il y a suffisamment de ressources système disponibles.


REP-31955 : Erreur dans l'exécutable runtime lors de la création d'un graphique
REP-31955 : Erreur dans l'exécutable runtime lors de la création d'un graphique.

Cause :	L'Assistant graphique n'a pas pu être chargé.
Action :	Vérifiez l'installation des bibliothèques de l'assistant Chart Builder et assurez-vous qu'il y a suffisamment de ressources système disponibles.


REP-31980 : Correspondance de champs indiquée incorrecte. Le graphique ne sera pas généré.

Cause :	Vous n'avez pas indiqué de champ pour les axes de catégorie et de valeur dans l'assistant Graphique.
Action :	Revenez à l'assistant Graphique et indiquez des champs pour les axes Catégorie et Valeur.


REP-31981 : Modèle de données d'état vide ou non valide. Créer un modèle de données et essayer de nouveau.

Cause :	L'utilisateur a tenté d'appeler l'assistant Graphique dans un état vide.
Action :	Créez un état (au moins un modèle de données) et recommencez l'opération.


REP-32600 : Erreur imprévue : abandon
REP-32600 : Erreur imprévue : abandon.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-32601 : Cet état existe déjà dans le fichier NX.

Cause :	Vous avez tenté de remplacer un fichier de traduction existant.
Action :	Donnez un autre nom au fichier de traduction.


REP-32602 : Initialisation impossible de Report Builder
REP-32602 : Initialisation impossible de Report Builder.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-32603 : Initialisation du système VGS impossible
REP-32603 : Initialisation du système VGS impossible.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-32604 : Erreur fatale lors du chargement de l'état '<nom de l'état>'. Vérifiez la version.

Cause :	L'état indiqué n'a pas pu être chargé.
Action :	Assurez-vous que vous ouvrez la bonne version de l'état.


REP-32605 : Ouverture impossible du fichier état en vue de lecture
REP-32605 : Ouverture impossible du fichier état en vue de lecture.

Cause :	Le fichier état est illisible.
Action :	Vérifiez l'autorisation de lecture du fichier état.


REP-32606 : Ouverture impossible du fichier '<fichier de transaction>' en vue de lecture
REP-32606 : Ouverture impossible du fichier '<fichier de transaction>' en vue de lecture.

Cause :	Le fichier indiqué n'a pas pu être ouvert.
Action :	Assurez-vous que le fichier existe et est lisible.


REP-32607 : Arborescence du générateur de traduction inexistante
REP-32607 : Arborescence du générateur de traduction inexistante.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-32608 : Il n'existe aucune traduction dans cette langue.

Cause :	Le gestionnaire de traduction ne peut pas traduire dans la langue cible indiquée.
Action :	Assurez-vous que la langue cible est prise en charge.


REP-32609 : Cette arborescence Report Builder n'est pas valide.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-32610 : Fichier de données source ('<nom du fichier>') non concordant
REP-32610 : Fichier de données source ('<nom du fichier>') non concordant.

Cause :	Le fichier de traduction que vous fusionnez dans l'état n'a pas été créé à partir de l'état sélectionné.
Action :	Fusionnez le fichier de traduction dans l'état d'origine.


REP-32612 : Langue source : fusion impossible
REP-32612 : Langue source : fusion impossible.

Cause :	Vous tentez de fusionner à nouveau les chaînes non traduites dans l'état d'origine.
Action :	Traduisez les chaînes dans le fichier de traduction et recommencez l'opération.


REP-32613 : Chaîne VGX concordante introuvable dans le fichier NX
REP-32613 : Chaîne VGX concordante introuvable dans le fichier NX.

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-32614 : Langue '<nom de la langue>' : fusion de chaînes réussie
REP-32614 : Langue '<nom de la langue>' : fusion de chaînes réussie.

Cause :	L'opération a été exécutée sans erreur.
Action :	Aucune.


REP-32615 : Echec de la fusion
REP-32615 : Echec de la fusion.

Cause :	La fusion a donné naissance à des erreurs.
Action :	Pour plus d'informations, consultez le fichier journal.


REP-32616 : Traductions introuvables dans le fichier NX
REP-32616 : Traductions introuvables dans le fichier NX.

Cause :	Le fichier de traduction ne contient pas de chaînes traduites.
Action :	Assurez-vous que vous utilisez le fichier de traduction correspondant à l'état indiqué.


REP-32617 : Fichier NX altéré !

Cause :	Condition anormale.
Action :	Pour toute information, reportez-vous à Conditions anormales.


REP-32618 : Ouverture du fichier NX impossible en vue de lecture
REP-32618 : Ouverture du fichier NX impossible en vue de lecture.

Cause :	Le fichier de traduction n'a pas pu être ouvert.
Action :	Assurez-vous que le fichier existe et est lisible.


REP-32750 : Eclatement des données de l'image '<nom de l'image>' impossible. L'image a été supprimée.

Cause :	Les données image sont altérées.
Action :	Importez à nouveau l'image.


REP-32751 : Avertissement ! Des segments texte manquent.

Cause :	Il manque des segments de texte dans une partie du texte standard. Il est possible que l'état soit altéré.
Action :	Vérifiez les objets texte standard dans l'état. Supprimez ceux qui semblent douteux et créez des textes de remplacement.


REP-34300 : Aucune liste de diffusion disponible
REP-34300 : Aucune liste de diffusion disponible.

Cause :	Aucune cible de diffusion.
Action :	Affectez une cible de diffusion.


REP-34301 : Valeur de champ non valide.

Cause :	Aucune valeur n'a été saisie.
Action :	Entrez une valeur.


REP-34302 : Format de destination incompatible avec le mode exécution.

Cause :	Le format n'est pas compatible avec le mode (par exemple, l'état est un bitmap, alors que la destination de diffusion est paramétrée sur le mode caractère.
Action :	Vérifiez le format de votre destination.


REP-34303 : Diffusion réussie !

Cause :	La diffusion a réussi.
Action :	Aucune.


REP-34304 : Echec de diffusion ! Vérifiez la liste de diffusion !

Cause :	La diffusion a échoué.
Action :	Vérifiez votre liste de diffusion.


REP-34305 : Définition de mot-clé incorrecte pour destid= <valeur>.

Cause :	Les paramètres de mots-clés (par exemple DESNAME) ne sont pas corrects dans le fichier de diffusion.
Action :	Vérifiez ces paramètres et apportez les modifications qui s'imposent.


REP-34306 : Aucun ID de diffusion indiqué pour la destination !

Cause :	Le fichier de diffusion ne comporte pas d'ID de destination.
Action :	Ajoutez un ID de diffusion unique à la ligne de destination.


REP-34307 : L'ID de diffusion indiqué n'est pas unique !

Cause :	Dans le fichier de diffusion, l'ID de destination n'est pas unique.
Action :	Ajoutez un ID de diffusion unique à la ligne de destination.


Rubrique non disponible

La rubrique sur laquelle vous avez demandé de l'aide n'est pas disponible dans ce système. Si Report Builder est dans votre système, vous pouvez également rechercher la rubrique dans l'Index du système d'aide de Report Builder.


Messages

  Rubriques connexes

Cliquez sur une plage de messages puis, à l'aide des boutons de navigation, parcourez les pages jusqu'au message recherché.

REP-0001 à REP-0089

REP-0090 à REP-0159

REP-0160 à REP-0249

REP-0250 à REP-0499

REP-0500 à REP-0539

REP-0540 à REP-0589

REP-0590 à REP-0659

REP-0660 à REP-0719

REP-0720 à REP-0779

REP-0780 à REP-0899

REP-0900 à REP-1059

REP-1060 à REP-1209

REP-1210 à REP-1259

REP-1260 à REP-1299

REP-1300 à REP-1339

REP-1340 à REP-1429

REP-1430 à REP-1819

REP-1820 à REP-1869

REP-1870 à REP-1999

REP-2000 à REP-3079

REP-3080 à REP-3349

REP-3350 à REP-3439

REP-3440 à REP-4039

REP-4040 à REP-16519

REP-16520 à REP-25339

REP-25400 à REP-32599

REP-32600 à REP-32307


Conventions d'appellation des documents

Lorsque vous utilisez des documents, vous devez respecter certaines conventions d'appellation. Celles-ci diffèrent selon que le document est stocké dans la base de données ou dans un fichier du système d'exploitation.

Objets de base de données

Les conventions d'appellation des documents Report Builder stockées dans la base de données sont similaires aux normes d'appellation SQL. En particulier, les noms de documents :

•	peuvent avoir une longueur maximum de 30 octets ;

•	doivent commencer par une lettre ;

•	ne font pas de distinction entre majuscules et minuscules ;

•	peuvent contenir des lettres, des chiffres et les caractères spéciaux $, #, @ et _ ;

•	ne peuvent pas être identiques au nom d'un autre objet de même type (deux états, par exemple, ne peuvent pas porter le même nom).

Fichiers

Lorsque vous nommez des objets stockés dans les fichiers du système d'exploitation, vous devez respecter, outre les conventions d'appellation des objets de base de données (voir section précédente), les conventions d'appellation de fichiers de votre système d'exploitation. Si vous enregistrez un objet en tant que fichier du système d'exploitation, il est stocké au format ASCII avec l'extension suivante :

•	.rex (pour un état)

•	.sql (pour une interrogation externe)

•	.pls (pour une bibliothèque PL/SQL externe)


Conventions d'appellation des objets de modèle de données

Les conventions d'appellation des objets de modèle de données sont identiques aux normes d'appellation SQL. En particulier, les noms d'objets de modèle de données :

•	peuvent avoir une longueur maximum de 30 octets ;

•	doivent commencer par une lettre ;

•	ne font pas de distinction entre majuscules et minuscules ;

•	peuvent contenir des lettres, des chiffres et les caractères spéciaux $, #, @ et _ ;

•	ne peuvent pas être identiques au nom d'un autre objet de modèle de données de même type dans le même état.

Notes d'utilisation

•	Outre les conventions d'appellation des objets de modèle de données énumérées ci-dessus, les noms de paramètres ne doivent être identiques à aucun nom d'objet de Report Builder ou mot-clé de ligne de commande de RWRUN60.


Conventions d'appellation des objets de présentation

Les conventions d'appellation des objets de présentation sont identiques aux normes d'appellation SQL. En particulier, les noms d'objets de présentation :

•	peuvent avoir une longueur maximum de 30 octets ;

•	doivent commencer par une lettre ;

•	ne font pas de distinction entre majuscules et minuscules ;

•	peuvent contenir des lettres, des chiffres et les caractères spéciaux $, #, @ et _ ;

•	ne peuvent pas être identiques au nom d'un autre objet de présentation de même type dans le même état.


Conventions d'appellation des objets de grille de paramètres

Lorsque vous utilisez des objets de grille de paramètres, vous devez respecter certaines conventions d'appellation. Celles-ci dont identiques aux normes d'appellation SQL. En particulier, les noms d'objets de grille de paramètres :

•	peuvent avoir une longueur maximum de 30 octets ;

•	doivent commencer par une lettre ;

•	ne font pas de distinction entre majuscules et minuscules ;

•	peuvent contenir des lettres, des chiffres et les caractères spéciaux $, #, @ et _ ;

•	ne peuvent pas être identiques au nom d'un autre objet de grille de paramètres de même type dans le même état.


Assistant Graphique : page Bienvenue

A propos de l'assistant Graphique

L'assistant Graphique vous explique, étape par étape, la création d'un graphique à partir d'un état, et vous permet d'effectuer les opérations suivantes :

•	Indiquer un type et un sous-type de graphique.

•	Indiquer le groupe de données ou l'interrogation qui contient les données que vous voulez attribuer aux colonnes du graphique.

•	Indiquer les données qui apparaîtront sur l'axe Catégorie (X) du graphique.

•	Indiquer les données qui apparaîtront sur l'axe Valeur (Y) du graphique.

•	Indiquer l'emplacement du graphique et sa fréquence dans l'état.

Pour indiquer les paramètres du graphique que vous voulez créer, suivez les messages de chaque page de l'assistant.

L'assistant Graphique est invariant

L'une des principales qualités de l'assistant Graphique est sa possibilité de fonctionner en mode invariant. Dans ce mode, vous pouvez utiliser l'assistant Graphique pour modifier les graphiques créés à l'aide de cet assistant.

Pour appeler l'assistant Graphique en mode invariant, sélectionnez l'objet graphique dans le Navigateur d'objet, puis choisissez Outils [image] Assistant Graphique dans le menu.

Navigation dans l'assistant Graphique

L'assistant Graphique comporte cinq boutons qui vous permettent de vous déplacer dans ses différentes pages :

•	Annuler - annule toutes les modifications que vous avez effectuées et vous fait sortir de l'assistant.

•	Aide - affiche le texte d'aide en ligne de la page en cours de l'assistant.

•	Précédent - vous fait revenir à la page précédente de l'assistant.

•	Suivant - vous fait passer à la page suivante de l'assistant.

•	Fin - enregistre vos modifications (si nécessaire) et vous fait sortir de l'assistant.

Remarque : Si vous cliquez sur Suivant ou sur Précédent avant d'avoir entré toutes les informations concernant une page d'assistant donnée, l'assistant vous empêche de passer à la page suivante ou de revenir à la page précédente. De même, si vous n'avez pas entré toutes les informations nécessaires lorsque vous cliquez sur Fini l'assistant affiche automatiquement la page dans laquelle vous pouvez entrer les données nécessaires.


Assistant Graphique : page Type

  A propos de l'assistant

Pour indiquer un type de graphique à l'aide de l'assistant Graphique :

1	(Facultatif) Dans le champ Titre, entrez le titre qui apparaîtra au-dessus du graphique.

2	Dans la liste Type de graphique, sélectionnez un type. Le type de graphique indique le format de base de l'affichage (par exemple, graphique à secteurs ou graphique à barres). La fenêtre de l'affichage comporte un exemple du type de graphique que vous avez sélectionné.

3	Dans la liste Sous-type de graphique, sélectionnez un sous-type. Le sous-type est un modèle ou un style propre à l'affichage (ombre, par exemple). La liste Sous-type de graphique affiche les sous-types que vous pouvez sélectionner pour le type de graphique choisi.


Assistant Graphique : page Groupe de données

  A propos de l'assistant

Pour sélectionner un groupe de données (interrogation) pour votre graphique à l'aide de l'assistant Graphique :

Remarque : Cette page n'apparaît que si votre état contient plusieurs interrogations ou groupes de branchement. Elle vous permet d'indiquer l'interrogation ou le groupe de données que vous utiliserez pour créer votre graphique.

  Dans la liste Groupes de  données, sélectionnez l'interrogation ou le groupe de données qui contient les données que vous voulez copier dans vos colonnes de graphique. Le groupe que vous sélectionnez détermine les champs qui pourront être attribués aux axes Catégorie et Valeur de votre graphique.


Assistant Graphique : page Catégorie

  A propos de l'assistant

Pour établir la correspondance des données avec l'axe Catégorie (X) de votre graphique à l'aide de l'assistant Graphique :

1	Dans la liste Champs disponibles, sélectionnez le champ dont vous voulez établir la correspondance avec l'axe Catégorie (X) du graphique. Remarque :Vous devez sélectionner au moins un champ avant de passer à la page suivante.

2	Cliquez sur [image] pour transférer le champ sélectionné de la liste Champs disponibles à la liste Axe Catégorie. Conseil

Remarque :  Vous devez transférer au moins un champ de la liste Champs disponibles à la liste Catégorie avant de passer à la page suivante.


Assistant Graphique : page Valeur

  A propos de l'assistant

Pour établir la correspondance des données avec l'axe Valeur (Y) de votre graphique à l'aide de l'assistant Graphique :

1	Dans la liste Champs disponibles, sélectionnez le champ dont vous voulez établir la correspondance avec l'axe Valeur (Y) du graphique

2	Cliquez sur [image] pour transférer le champ sélectionné de la liste Champs disponibles à la liste Axe Valeur. Conseil

Remarque :  Vous devez transférer au moins un champ de la liste Champs disponibles à la liste Valeur avant de passer à la page suivante.


Assistant Graphique : page Ventilation

  A propos de l'assistant

Pour indiquer l'endroit de l'état où apparaîtra le graphique à l'aide de l'assistant Graphique :

  Dans la liste Graphique, sélectionnez l'indication de groupe de graphiques qui précise où, et à quelle fréquence, le graphique apparaîtra par rapport aux champs de l'état. Vous pouvez afficher le graphique :

•	Au début de l'état

•	A la fin de l'état

•	Une fois par encadrement itératif. Si l'état contient plusieurs encadrements itératifs, chacun d'eux apparaît sous la forme d'une option de sélection  dans la liste Graphique.

Si vous placez le graphique dans un encadrement itératif, il apparaît à la gauche des champs contenus dans cet encadrement, à moins qu'il ne dépasse les limites de la page. Dans ce cas, il apparaît sous les champs de l'encadrement itératif.

Lorsque vous avez créé un graphique, vous pouvez le repositionner en le sélectionnant et en le faisant glisser à son nouvel emplacement.


Assistant Graphique : page Nom de fichier

  A propos de l'assistant

Pour enregistrer votre graphique sous le nom de fichier par défaut :

  Cliquez sur Fin. Le graphique est enregistré sous le nom par défaut qui est généré automatiquement et affiché dans le champ Nom de fichier. Le graphique terminé apparaît sur la présentation ou dans l'Aperçu interactif, en fonction de la vue dans laquelle vous étiez lorsque vous avez créé le graphique.

Pour enregistrer votre graphique sous un nom de fichier autre que le nom par défaut :

1	Cliquez sur Enregistrer sous.

2	Dans la boîte de dialogue Enregistrer sous, passez au répertoire dans lequel vous voulez enregistrer le graphique et entrez le nouveau nom de fichier. Cliquez sur Enregistrer.

3	Cliquez sur Fin. Le graphique apparaît sur la présentation ou dans l'Aperçu interactif, en fonction de la vue dans laquelle vous étiez lorsque vous avez créé le graphique.

Etape suivante

Lorsque vous cliquez sur Fin, Form Builder affiche votre graphique terminé. Pour revenir à l'assistant, vous pouvez sélectionner l'objet graphique terminé et choisir Outils [image] Assistant Graphique dans le menu.

Pour tout renseignement complémentaire sur la création de graphiques, reportez-vous à l'aide en ligne.

1	Consultez les aperçus produit qui contiennent des présentations d'ensemble :

•	Choisissez Aide [image] Aperçu produit.

2	Etudiez les différents assistants pour savoir comment exécuter les tâches les plus courantes :

•	Choisissez Aide [image] Assistants.

3	Accédez aux manuels en ligne/imprimés :

•	Choisissez Aide [image] Manuels.

4	Localisez les rubriques d'aide :

•	Pour la table des matières et l'index, choisissez Aide [image] Rubriques d'aide.

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


Conseil

Cliquez sur [image] pour retransférer un champ sélectionné de la liste Axe Catégorie à la liste Champs disponibles.


Conseil

Cliquez sur [image] pour retransférer un champ sélectionné de la liste Axe Valeur à la liste Champs disponibles.


Notes concernant l'utilisation d'Oracle8
Notes d'utilisation d'Oracle8 pour Report Builder

Objets colonne et colonnes Ref

•	Pour référencer les colonnes d'attribut ou les méthodes d'un objet colonne, vous devez qualifier leur nom à l'aide d'un alias de table ou d'une variable de corrélation, comme :

select e.empno, e.address.street, e.address.city from emp e

•	Vous pouvez déplacer les objets colonne ou les colonnes Ref en un seul bloc, ou déplacer leur colonnes d'attribut respectives. Lorsque vous déplacez une colonne d'attribut en dehors de l'objet colonne auquel elle est associée, cette colonne d'attribut est détachée de l'objet colonne et traitée comme toute autre colonne. Seul son nom est mis à jour pour indiquer l'association avec l'objet colonne (par exemple ADDRESS_ZIP).

•	Les objets colonne ne peuvent pas être la source d'un objet de présentation, mais leurs colonnes d'attribut peuvent l'être. Prenez par exemple le cas d'un objet colonne nommé ADRESSE et composé de RUE, VILLE, PAYS et CODE POSTAL. ADRESSE ne peut pas être la source d'un champ, mais RUE, VILLE, PAYS ou CODE POSTAL peuvent l'être.

•	Les objets colonne ou les colonnes Ref doivent résider dans le groupe de niveau le plus bas où réside l'une de leurs colonnes d'attribut. La raison en est que la fréquence de l'objet colonne ou de la colonne Ref doit être identique à celle de la colonne d'attribut possédant la fréquence la plus élevée. Si l'objet colonne ou la colonne Ref appartiennent à un groupe supérieur à celui de leurs colonnes d'attribut, leur fréquence est trop faible et une erreur apparaît. Ainsi, supposez que l'objet colonne ADRESSE appartienne à un groupe nommé G_MASTER et que l'une de ses colonnes d'attribut soit CODE POSTAL. Si vous faites glisser CODE POSTAL vers un fils de G_MASTER nommé G_DETAIL, alors ADRESSE doit aussi être placé dans G_DETAIL.

•	Les objets colonne ne peuvent pas servir de variables de lien (column_name), mais leurs colonnes d'attribut le peuvent.

•	Ni les objets colonne ni les colonnes Ref ne peuvent être ventilés. Par conséquent, un objet colonne ou une colonne Ref ne peut pas être la seule colonne d'un groupe de ventilation. Cependant, vous pouvez ventiler les colonnes d'attribut d'un objet colonne. Ainsi, vous pouvez faire glisser l'objet colonne et toutes ses colonnes d'attribut dans un groupe de ventilation et affecter un ordre de ventilation à autant de colonnes d'attribut que vous le souhaitez.

•	Vous ne pouvez pas utiliser d'objets colonne ni de colonnes Ref dans les liens de modèles de données. Vous ne pouvez utiliser que leurs colonnes d'attribut respectives dans les liens. Prenez par exemple le cas d'un objet colonne nommé ADRESSE et composé de RUE, VILLE, PAYS et CODE POSTAL. Vous pouvez créer un lien à l'aide de l'une des colonnes d'attribut d'ADRESSE (par exemple VILLE).

Récapitulatifs, formules et colonnes de réserve

•	Les données d'une colonne de formule ou d'une colonne de réserve doivent appartenir à l'un des types de données intégrés Oracle7 (par exemple CHAR ou VARCHAR). Les nouveaux types de données Oracle8 ne sont pas encore pris en charge.

•	Les colonnes récapitulatives dont la source est un objet colonne ou une colonne Ref ne peuvent utiliser que les fonctions First, Last et Count.

Tableaux variables et tables imbriquées

•	Les types de tableau variable et de table imbriquée ne sont pas encore pris en charge. Si vous sélectionnez un objet colonne appartenant à l'un de ces types dans une interrogation, une icône spéciale apparaît dans la vue du modèle de données pour indiquer que ce type n'est pas pris en charge.

Objets LOB

•	Les LOB (Large Object) ne sont pas encore pris en charge. Si vous sélectionnez un LOB dans une interrogation, une icône spéciale apparaît dans la vue du modèle de données pour indiquer que cet objet n'est pas encore pris en charge.


A propos de la Palette de propriétés

La Palette de propriétés comporte une interface conviviale qui vous permet de visualiser, de localiser et de définir des propriétés d'objet. Ses principales caractéristiques sont les suivantes :

•	noeuds pouvant être développés et réduits

•	édition de propriétés intégrées

•	fonctions de recherche

•	sélection multiple

•	boîtes de dialogue de propriétés complexes

•	possibilité d'appeler plusieurs instances de la Palette de propriétés

Lorsque vous sélectionnez un objet dans le navigateur ou dans un éditeur, la Palette de propriétés est mise à jour pour indiquer les propriétés de cet objet. Par défaut, la liste des propriétés de la palette est synchronisée lorsque vous sélectionnez un autre objet. Vous pouvez activer ou désactiver la synchronisation d'une palette particulière en cliquant sur l'outil Figer/libérer, dans la barre d'outils de la Palette de propriétés.

Pour comparer les propriétés de deux objets, vous pouvez figer la palette en cours et en appeler d'autres.

La Palette de propriétés offre les fonctions suivantes :

Liste de propriétés

La liste de propriétés présente, sur deux colonnes, les noms et les valeurs des propriétés. Lorsqu'aucun objet n'est sélectionné, la liste est vide. Les propriétés sont regroupées sous des en-têtes d'objet ou de fonction (propriétés Informations générales et Champ, par exemple). Pour sélectionner des propriétés de la liste, cliquez sur celles qui vous intéressent, puis naviguez à l'aide des touches de défilement vers le haut ou vers le bas. Pour définir des propriétés dans la liste de propriétés, sélectionnez la propriété, puis tapez ou cliquez deux fois, selon le cas.

Propriété Nom

Le champ Nom contient le nom de l'objet sélectionné dans le navigateur ou dans un éditeur. Il ne s'affiche pas lorsqu'aucun objet n'est sélectionné. Lorsque plusieurs objets sont sélectionnés simultanément, une liste de noms s'affiche en haut de la Palette de propriétés.

Définition de contrôle de propriété

Lorsqu'une propriété est sélectionnée dans la liste de propriétés, un champ texte, une liste instantanée, une zone de liste déroulante ou un bouton Suite... s'affiche en regard de la propriété :

Un champ texte s'affiche lorsque la propriété peut être définie par la saisie d'une valeur de texte. Pour les propriétés qui demandent des valeurs de texte plus longues, un bouton icône, à côté du champ texte, permet d'appeler un éditeur modal.

Une liste instantanée s'affiche lorsque la propriété peut avoir la valeur vrai ou faux, ou un ensemble de valeurs valides. Pour faire défiler les valeurs, cliquez deux fois aussi souvent que nécessaire.

Une zone de liste déroulante s'affiche lorsque la propriété en cours peut être définie par la saisie d'une valeur ou par la sélection d'une option dans une liste instantanée.

Un bouton Suite... s'affiche lorsque la propriété en cours demande des valeurs plus complexes. Ce bouton appelle une boîte de dialogue dans laquelle vous entrez les informations requises.

La Palette de propriétés est la zone dans laquelle vous définissez les propriétés des objets que vous créez dans des documents.


A propos des sélections multiples dans la Palette de propriétés

  Rubriques connexes

Pour sélectionner simultanément plusieurs objets, appuyez sur la touche Maj ou Ctrl et cliquez dans les navigateurs ou dans les éditeurs. Une fois que vous avez sélectionné plusieurs objets, la liste des noms d'objet s'affiche en haut de la Palette de propriétés.

La commande Intersection/union de la barre d'outils de la Palette de propriétés détermine les propriétés qui s'affichent dans la liste de propriétés lorsque plusieurs objets sont sélectionnés. Le fait d'alterner entre Intersection et Union change la liste de propriétés affichée dans la Palette de propriétés, mais est sans effet sur la définition des propriétés.

Intersection (par défaut) Seules les propriétés communes à tous les objets sélectionnés sont affichées.

Union Toutes les propriétés de tous les objets sélectionnés sont affichées.

Les propriétés communes à plusieurs objets d'une sélection multiple ne figurent qu'une fois, et la définition de la propriété est affichée de la manière suivante :

•	Si la propriété a la même définition pour tous les objets sélectionnés pour laquelle elle est commune, la définition commune est affichée.

•	Si la propriété est définie différemment pour les objets pour lesquels elle est commune, la chaîne ***** s'affiche.


A propos des commandes de la barre d'outils de la Palette de propriétés

  Rubriques connexes

La barre d'outils permet d'accéder rapidement aux commandes. Cliquez une fois sur l'icône correspondant à la commande que vous voulez exécuter.

Hériter	ne s'applique qu'aux sections, pages de garde, corps et récapitulatifs des modèles. Définit la propriété en cours à sa valeur par défaut. Vous pouvez sélectionner plusieurs propriétés et cliquer sur Hériter.
Localiser	ne s'applique qu'aux sections, pages de garde, corps et récapitulatifs des modèles. Rend la propriété en cours locale (c'est-à-dire non héritée). Vous pouvez sélectionner plusieurs propriétés et cliquer sur Localiser.
Champ Rechercher	chaîne que vous voulez rechercher dans la palette de propriétés.
Recherche avant	exécute une recherche avant de la chaîne indiquée dans le champ Rechercher.
Recherche arrière	exécute une recherche arrière de la chaîne indiquée dans le champ Rechercher.
Intersection/ union	alterne entre les modes d'affichage Intersection et Union. Cette option détermine les propriétés qui s'affichent lorsque vous sélectionnez simultanément plusieurs objets (sélection multiple). En mode Intersection (par défaut), seules les propriétés communes aux objets sélectionnés sont affichées. En mode Union, les propriétés de tous les objets de la sélection en cours sont affichées.
Figer/libérer	alterne entre l'activation et la désactivation de la synchronisation de la Palette de propriétés. Lorsque la commande Figer est désactivée (par défaut), la liste de propriétés est mise à jour pour afficher les propriétés des objets que vous sélectionnez dans les navigateurs et dans les autres fenêtres. Lorsque la commande Figer est activée, la liste de propriétés est bloquée et n'est pas mise à jour pour que vous puissiez la comparer avec d'autres listes de propriétés.


Affichage de la Palette de propriétés

Pour afficher la Palette de propriétés pour un objet, faites l'une des opérations suivantes :

•	Cliquez deux fois sur l'objet. Pour appeler une seconde Palette de propriétés, figez la palette en cours et cliquez deux fois sur une icône d'objet.

•	Cliquez sur l'objet, puis choisissez Outils [image] Palette de propriétés.

•	Dans le menu instantané (sous Windows, cliquez avec le bouton droit de la souris), sélectionnez Palette de propriétés.

•	Cliquez deux fois sur l'icône des propriétés de l'objet dans le Navigateur.


Fermeture de la Palette de propriétés

Pour fermer la Palette de propriétés :

 Cliquez deux fois sur la case Fermer dans l'angle supérieur gauche.


Définition de propriétés en utilisant la Palette de propriétés

Pour définir des propriétés en utilisant la Palette de propriétés :

1	Affichez la Palette de propriétés pour l'objet dont vous voulez définir les propriétés.

2	Sélectionnez la propriété que vous voulez définir.

Pour définir des propriétés, vous pouvez cliquer ou naviguer en utilisant les touches de déplacement du curseur vers le haut ou vers le bas. Lorsqu'une propriété est sélectionnée, un champ texte, une liste instantanée, une zone de liste déroulante ou le bouton Suite... s'affiche en regard de la propriété.

3	Définissez la propriété.


Définition de propriétés de sélections multiples

  Exemples 	  Rubriques connexes

Pour définir les propriétés de sélections multiples :

1	Dans le Navigateur d'objet ou les éditeurs, sélectionnez les objets dont vous voulez définir les propriétés. Ils peuvent être de type différent ou même se trouver dans des documents différents.

2	Choisissez Outils [image] Palette de propriétés.

3	Dans la Palette de propriétés, cliquez sur [image] (l'outil Union) pour afficher toutes les propriétés de tous les objets, ou laissez l'outil à [image] (l'outil Intersection) pour n'afficher que les propriétés communes aux objets.

4	Définissez les propriétés.

Tout changement apporté à une définition de propriété est répercuté sur tous les objets de la sélection en cours auxquels s'applique cette propriété.


Définition de propriétés de sélections multiples - Exemple

  Rubriques connexes 	  Tous les exemples

Un état comporte plusieurs champs qui affichent tous la date. Comme la propriété Type de données de chaque champ est DATE, les dates sont affichées dans le format ORACLE par défaut, JJ-MOI-AA.

Pour utiliser un format de date différent dans toute l'application, définissez la propriété Masque de format pour chaque champ qui affiche des dates. Au lieu de définir la propriété Masque de format pour chaque champ, sélectionnez tous les éléments, puis définissez une fois la propriété Masque de format pour changer le masque de format de chaque élément sélectionné.


Comparaison des propriétés de deux objets

Pour comparer les propriétés de deux objets :

1	Dans le Navigateur d'objet ou les éditeurs, cliquez deux fois sur le premier objet afin que ses propriétés soient affichées dans la Palette de propriétés.

2	Dans la Palette de propriétés, cliquez sur [image] pour désactiver la synchronisation et " figer " la Palette de propriétés.

3	Dans le Navigateur d'objet, sélectionnez le second objet, puis choisissez Palette de propriétés dans le menu instantané.

Une seconde Palette de propriétés s'affiche. Si la seconde fenêtre se trouve sur la première, déplacez-la pour l'afficher le long de la première.


Propriétés de point d'ancrage

  Restrictions	  Exemples

% du bord fils

Type de bord fils

Nom d'objet fils

Réduire horizontalement

Réduire verticalement

Commentaires

Nom

% du bord père

Type de bord père

Nom d'objet père


Points d'ancrage - Restrictions

•	Un objet ne peut être ancré qu'à un seul autre objet.

•	Les objets de matrice, les points d'ancrage et la marge ne peuvent pas être ancrés (c'est-à-dire qu'ils ne peuvent pas être l'objet père ou l'objet fils d'un point d'ancrage).

•	Un encadrement itératif qui est l'encadrement itératif vertical ou horizontal d'une matrice ne peut pas être ancré à un autre objet, mais d'autres objets peuvent être ancrés à l'encadrement itératif (c'est-à-dire peuvent être l'objet père, mais non l'objet fils, d'un point d'ancrage).

•	Un objet masqué (c'est-à-dire un objet dont la propriété Visible est définie à Non) n'accepte aucun ancrage.

•	Le déplacement d'un point d'ancrage provoque également le déplacement des deux objets qu'il ancre ensemble.

•	Il n'est pas possible de créer un ancrage d'objets créant une dépendance circulaire. Par exemple :

•	Si l'objet A et l'objet B sont ancrés l'un à l'autre et si l'objet A est le père, l'objet B ne peut pas être le père d'un autre point d'ancrage situé entre l'objet A et l'objet B. En outre, l'objet B ne peut pas être le père d'un point d'ancrage à l'objet C si l'objet C est le père d'un point d'ancrage sur l'objet A.

 Cliquez ici.

•	Soit l'encadrement A qui contient le champ B, le champ B se trouvant au-dessus de l'encadrement A dans le Modèle de présentation : si l'encadrement A est ancré au champ C, qui ne se trouve pas à l'intérieur de l'encadrement A, et si le champ C est le père, le champ C ne peut pas être le père d'un point d'ancrage au champ B. Comme le champ B se trouve à l'intérieur de l'encadrement A, il ne peut pas être ancré au champ C si le champ C est le père.

 Cliquez ici.

•	Pour copier un point d'ancrage, vous devez sélectionner le point d'ancrage et les deux objets qu'il ancre l'un à l'autre. Si vous sélectionnez uniquement le point d'ancrage, aucun élément ne sera copié dans la mémoire tampon de collage. Si vous sélectionnez le point d'ancrage et l'un des objets, seul l'objet sera placé dans le presse-papiers.

•	Un point d'ancrage ne peut pas être redimensionné.

•	Un point d'ancrage doit toujours se trouver au-dessus des objets qu'il ancre (c'est-à-dire qu'il doit se trouver une ou plusieurs couches au-dessus des objets père et fils). Report Builder vous empêche de faire passer le point d'ancrage dans une couche inférieure à ces objets père et fils.

•	Vous ne pouvez pas utiliser les options Aligner, Aligner objets ou Définir taille objets du menu Réorganisation sur des points d'ancrage.


propriété % du bord fils
% du bord fils

Description  La propriété % du bord fils permet d'indiquer le pourcentage vertical ou horizontal (de haut en bas ou de gauche à droite) du bord de l'objet fils contenant le point d'ancrage. Cette option indique la position du point d'ancrage sur le bord, lors du remplissage de l'objet.

Valeurs  Tout entier compris entre 0 et 100.

Application  Points d'ancrage


propriété Type de bord fils
Type de bord fils

Description  La propriété Type de bord fils permet d'indiquer le bord de l'objet fils sur lequel se trouve le point d'ancrage.

Valeurs  Haut, Bas, Gauche et Droite

Application  Points d'ancrage


propriété Nom d'objet fils
Nom d'objet fils

Description  La propriété Nom d'objet fils permet d'indiquer le nom de l'objet fils. Ce champ est en lecture seule.

Application  Points d'ancrage


propriété Réduire horizontalement
Réduire horizontalement

  Exemples

Description  La propriété Réduire horizontalement permet d'indiquer si le point d'ancrage doit avoir une largeur nulle si, pour une raison quelconque, l'objet père ne s'imprime pas (en raison de ses propriétés Activation de l'impression d'objets, Activation de l'impression de base ou Déclencheur de format). Si l'objet père ne s'imprime pas, l'objet fils se déplace horizontalement dans l'espace laissé vacant par l'objet père.

Application  Points d'ancrage


propriété Réduire verticalement
Réduire verticalement

  Exemples

Description La propriété Réduire verticalement permet d'indiquer si le point d'ancrage doit avoir une hauteur nulle si, pour une raison quelconque, l'objet père ne s'imprime pas (en raison de ses propriétés Activation de l'impression d'objets, Activation de l'impression de base ou Déclencheur de format). Si l'objet père ne s'imprime pas, l'objet fils se déplace verticalement dans l'espace laissé vacant par l'objet père.

Application  Points d'ancrage


Exemple de centrage horizontal (champs)

  Rubriques connexes 	  Tous les exemples

Supposons que vous vouliez centrer un champ horizontalement dans un encadrement itératif dont la propriété Elasticité horizontale est définie à Variable, et que vous vouliez également que le champ se trouve à une distance fixe du bord supérieur de l'encadrement itératif. Comme vous ne connaissez pas la future dimension de l'encadrement itératif, vous devez utiliser des points d'ancrage pour centrer le champ.

Pour centrer le champ horizontalement dans l'encadrement itératif, procédez de la manière suivante :

•	Placez le champ dans l'encadrement itératif de telle sorte que la coordonnée x du centre du haut du champ est la même que la coordonnée x du centre du haut de l'encadrement itératif. Voir la figure ci-dessous.

•	Tracez un point d'ancrage reliant le centre du haut du champ au centre du haut de l'encadrement itératif. Conseil

Le champ sera centré horizontalement dans l'encadrement itératif.

 Cliquez ici.


Exemple de centrage vertical (champs)

  Rubriques connexes 	  Tous les exemples

Supposons que vous vouliez centrer un champ verticalement dans un encadrement itératif dont la propriété Elasticité verticale est définie à Variable, et que vous vouliez également que le champ se trouve à une distance fixe du bord supérieur de l'encadrement itératif. Comme vous ne connaissez pas la future dimension de l'encadrement itératif, vous devez utiliser des points d'ancrage pour centrer le champ.

Pour centrer un champ verticalement dans l'encadrement itératif, tracez un point d'ancrage reliant le centre du bord gauche du champ au centre du bord gauche de l'encadrement itératif. Conseil

Le champ sera centré verticalement dans l'encadrement itératif.

 Cliquez ici.


Exemple de réduction verticale (champs)

  Rubriques connexes 	  Tous les exemples

Supposons que vous ayez ancré le champ B sur le champ A et défini Réduire verticalement à Oui.

 Cliquez ici.

Supposons que, sur la première page logique de l'état, l'impression du champ A demande tellement de place que le champ B doit être imprimé sur la seconde page logique où le champ A n'apparaît pas. Comme la propriété Réduire verticalement est définie à Oui, le point d'ancrage est réduit dans le sens y. Le champ B conserve sa position par rapport au champ A dans le sens x, même si le champ A n'apparaît pas sur la page logique.

 Cliquez ici.


Exemple de réduction verticale et horizontale (champs)

  Rubriques connexes 	  Tous les exemples

Supposons que vous ayez ancré le champ B sur le champ A et que vous vouliez que le champ B se déplace verticalement et horizontalement dans l'espace dans lequel le champ A se serait imprimé dans la page logique. Pour cela :

•	Tracez un point d'ancrage reliant le haut du champ B au bas du champ A.

•	Définissez à Oui les propriétés Réduire horizontalement et Réduire verticalement.

 Cliquez ici.

Sur la première page logique de l'état, l'impression du champ A demande tellement de place que le champ B doit être imprimé sur la seconde page logique où le champ A n'apparaît pas. Comme la propriété Réduire verticalement est définie à Oui, le point d'ancrage est réduit et le champ B passe à la position à laquelle le champ A aurait dû apparaître sur la page logique.

 Cliquez ici.

Lorsque les champs A et B s'impriment sur la même page logique, le point d'ancrage n'est pas réduit et les champs conservent leurs positions relatives respectives.


Lorsque vous placez un point d'ancrage sur le bord d'un objet, appuyez sur la touche maj tout en cliquant avec la souris pour vous déplacer le long du bord par incréments de 25 %.


propriété % du bord père
% du bord père

Description  La propriété % du bord père permet d'indiquer le pourcentage vertical ou horizontal (de haut en bas ou de gauche à droite) du bord de l'objet père contenant le point d'ancrage. Cette option indique la position du point d'ancrage sur le bord, lors du remplissage de l'objet.

Valeurs  Tout entier compris entre 0 et 100.

Application  Points d'ancrage


propriété Type de bord père
Type de bord père

Description  La propriété Type de bord père permet d'indiquer le bord de l'objet fils sur lequel se trouve le point d'ancrage.

Valeurs  Haut, Bas, Gauche et Droite

Application  Points d'ancrage


propriété Nom d'objet père
Nom d'objet père

Description  La propriété Nom d'objet père permet d'indiquer le nom de l'objet fils. Ce champ est en lecture seule.

Application  Points d'ancrage


Propriétés de texte standard

  Restrictions

Attributs d'hyperlien supplémentaire

Ligne de commande d'application (PDF)

Activation de l'impression de base

Signet

Commentaires

Contient balises HTML

Nom d'affichage

Déclencheur de format

Elasticité horizontale

Hyperlien

Destination hyperlien

Objet solidaire

Etirement de ligne avec encadrement

Nbre min de lignes veuves

Nom

Saut de page après

Saut de page avant

Protection pge

Activation de l'objet d'impression

Code d'imprimante après

Code d'imprimante avant

Format de fichier source

Nom de fichier source

Type

Elasticité verticale


Texte standard - Restrictions

•	La taille maximum du texte standard est de 64 Ko de texte par paragraphe. Cette limite est fonction de votre système d'exploitation.

•	Le texte standard doit se trouver devant l'encadrement itératif qui le contient.

Attention : Lorsque vous redimensionnez un texte standard, vous devez vous assurer que le texte n'est pas trop grand pour l'objet. Si les jambages des caractères de la police (c'est-à-dire l'espace laissé pour la partie inférieure des lettres comme g et q) sont trop grands pour l'objet, la ligne de texte apparaît dans l'Editeur d'état, mais lorsque l'état est exécuté, la ligne peut ne pas apparaître dans la sortie, en fonction des options choisies pour Elasticité horizontale et verticale.


Propriété Contient références HTML
Contient références HTML

  Restrictions 	  Exemples 	  Rubriques connexes

Description  Cette propriété permet d'indiquer que l'objet texte standard ou champ contient des références HTML. Report Builder fixe l'objet verticalement et horizontalement et le formate comme un objet texte ordinaire (c'est-à-dire que toutes les références de champ sont traduites). Si vous voulez fournir la largeur et la hauteur de l'objet sous forme de paramètres, vous pouvez utiliser les variables ObjectWidth et ObjectHeight, comme indiqué dans l'exemple ci-après.

Application  texte standard et champs

Obligatoire/Facultatif  facultatif

Valeur par défaut  Non


Variables ObjectWidth et ObjectHeight : sortie vers HTML - Exemple

  Rubriques connexes 	  Tous les exemples

Dans un objet texte standard, vous pouvez taper l'applet Java suivant, appelé NervousText.class, qui utilise la largeur et la hauteur de l'objet comme paramètres :

<base href=http://cagney.uk.oracle.com/java/NervousText/>
<applet code="NervousText.class" width=&ObjectWidth height=&<ObjectHeight>>
<param name=text value="&deptno">
</applet>

Sortie vers HTML :

<base href=http://cagney.uk.oracle.com/java/NervousText/>
<applet code="NervousText.class" width=84 height=72>
<param name=text value="10">
</applet>


Objet texte standard (hyperlien) - Exemple

  Rubriques connexes 	  Tous les exemples

Cet exemple représente un objet texte standard marqué comme hyperlien.

Créez l'objet texte standard suivant :

<a href=http://votre_serveur_Web/états/mon_état.html><img src=oracle.gif> </a>

Une fois l'objet standard sélectionné, ouvrez la palette de propriétés. Sous Paramètres Web, paramétrez la propriété Contient des marques HTML sur Oui.


Contient références HTML - Restrictions

•	Contient références HTML ne peut être utilisé que pour un texte standard, un texte standard de liaison avec un format de fichier source texte et des champs avec un type de données source caractère.


Propriété Nbre min de lignes veuves
Nbre min de lignes veuves

  Restrictions 	  Exemples

Description  La propriété Nbre min de lignes veuves permet d'indiquer le nombre minimum de lignes de texte standard ou de texte de champ qui doivent apparaître sur la page logique sur laquelle l'objet commence à s'imprimer. Si le nombre de lignes indiqué pour cette propriété ne peut pas tenir sur la page logique, toutes les lignes du texte passent à la page suivante.

Remarque : Cette propriété ne s'applique qu'aux lignes initiales de texte dans l'objet texte standard ou champ. Elle n'offre pas de protection des lignes veuves des paragraphes individuels.

Valeurs  Tout entier positif compris entre 1 et 32 Ko.

Application  texte standard et champs

Obligatoire/Facultatif  facultatif

Valeur par défaut  0 (le texte qui peut tenir dans la page logique doit être imprimé avant de passer à la page suivante)


Nbre min de lignes veuves - Restrictions

•	Nbre min de lignes veuves ne peut être utilisé que pour un texte standard, un texte standard de liaison avec un format de fichier source texte et des champs avec un type de données source caractère.


Nbre min de lignes veuves (défini à 1 et à 2) - Exemple

  Rubriques connexes 	  Tous les exemples

Si Nbre min de lignes veuves est défini à 1, il se peut que vous obteniez un résultat semblable à celui de la première figure, dans laquelle la première ligne du champ est imprimée au bas d'une page logique, et le reste sur la page logique suivante. Si Nbre min de lignes veuves est défini à 2 (ou plus), vous pouvez éviter d'obtenir une ligne d'un champ au bas de la page logique, comme illustré dans la seconde figure.

 Cliquez ici.


propriété Format de fichier source
Format de fichier source

Description  La propriété Format de fichier source permet d'indiquer le format du fichier externe auquel le texte standard est lié.

Valeurs

Texte	Texte en format ASCII
Image	Image bitmap
CGM	Tracé de ligne en format CGM
Format Oracle (Dessin)	Tracé de ligne en format Oracle
URL d'image	Lien URL vers une image
Remarque : Tous les autres formats d'image sont fournis pour vous permettre d'ouvrir l'état dans la version 2.0. Si vous envisagez d'ouvrir ou d'exécuter l'état en version 2.0, sélectionnez le format d'image du texte standard. Sinon, vous pouvez choisir l'une des valeurs ci-dessus.

Application  texte standard externe

Obligatoire/Facultatif  obligatoire


propriété Nom de fichier source
Nom de fichier source

  Restrictions

Description  La propriété Nom de fichier source permet d'indiquer le nom du fichier externe ou l'URL image auquel est lié le texte standard. La liaison à un fichier permet d'inclure le contenu de fichiers qui risquent de changer. Le texte standard est automatiquement mis à jour pour refléter le dernier contenu du fichier lorsque vous effectuez une des opérations suivantes :

•	validation de la fenêtre de propriété

•	collage de l'objet

•	import de l'objet (s'il est en format Oracle)

•	ouverture de l'état

•	exécution de l'état

Le contenu d'un fichier lié à un objet de texte standard apparaît dans l'Editeur d'état, mais ne peut pas être édité dans l'Editeur d'état.

Valeurs  Entrez un nom de fichier ou une URL d'image valide, qui ne dépasse pas 1 Ko de longueur. Vous pouvez faire précéder le nom de fichier d'un chemin d'accès. Si tel n'est pas le cas, Report Builder utilise son ordre de recherche de chemin pour trouver le fichier.

Application  texte standard externe

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc

Notes d'utilisation

•	Pour garantir la portabilité de vos états, utilisez la variable d'environnement REPORTS60_PATH de Report Builder qui permet d'indiquer le ou les répertoires par défaut dans lesquels vous voulez que Report Builder recherche les fichiers externes que vous utilisez dans vos états (par exemple, interrogations externes, texte standard et PL/SQL). De cette façon, vous évitez de programmer dans votre état les chemins d'accès aux répertoires.

•	Vous pouvez également inclure des fichiers dans l'état via l'option Lecture depuis fichier.


Nom de fichier source - Restrictions

•	La taille maximum du fichier que vous indiquez dépend de votre système d'exploitation.

•	Le nom de fichier source peut dépendre du système d'exploitation. Si vous transférez l'état à un autre système d'exploitation, vous devrez parfois mettre le nom de fichier à jour.

•	Ce champ n'apparaît que pour les objets créés avec l'outil Fichier de liaison.

•	Si vous indiquez un fichier qui contient un objet de présentation et ses propriétés (c'est-à-dire un fichier qui contient un objet de présentation exporté), le fichier est considéré comme un objet graphique anonyme (c'est-à-dire que les propriétés de l'objet ne seront pas prises en compte). Si vous voulez que les propriétés de l'objet soient utilisées, vous devez importer l'objet au lieu de lier le fichier.


Propriété Type

Description  La propriété Type permet d'indiquer le format (par exemple, texte) de l'objet standard. Ce champ est en lecture seule.

Application  texte standard


propriété Etirement de ligne avec encadrement
Etirement de ligne avec encadrement

  Restrictions	  Exemples

Description  La propriété Etirement de ligne avec encadrement permet d'indiquer le nom de l'encadrement ou de l'encadrement itératif auquel la ligne de texte standard est associée. Lorsqu'elle est définie, cette propriété ancre la ligne aux deux extrémités à l'encadrement associé. La ligne se prolonge donc autant que l'encadrement associé lorsque l'état est mis en forme.

Si la ligne est verticale, l'extrémité supérieure est ancrée en haut de l'encadrement et l'extrémité inférieure au bas de l'encadrement. Si la ligne est horizontale, l'extrémité est ancrée au côté gauche de l'encadrement et l'extrémité droite au côté droit de l'encadrement.

Valeurs   Sélectionnez un encadrement ou un encadrement itératif dans la liste de ceux qui figurent dans l'état. Null indique que la propriété n'est pas définie et la taille de la ligne de texte standard reste fixe lors de la mise en forme de l'état.

Application  lignes de texte standard

Obligatoire/Facultatif  facultatif

Valeur par défaut  Null

Notes d'utilisation

•	La propriété Etirement de ligne avec encadrement peut être définie pour toute ligne de texte standard, quelle que soit sa position dans la présentation.

•	Si vous utilisez cette propriété pour associer une largeur de ligne à un encadrement itératif, le ligne doit être complètement délimitée dans l'encadrement itératif.


Etirement de ligne avec grille d'encadrement - Exemple

  Rubriques connexes 	  Tous les exemples

Supposons que vous vouliez séparer les lignes et les colonnes d'un état par une grille.

 Cliquez ici.

En utilisant des points d'ancrage, des lignes de texte standard et la propriété Etirement de ligne avec encadrement, éditez la présentation en procédant de la manière suivante :

•	Développez l'encadrement du groupe intérieur (GF2) et l'encadrement itératif détail (RF2), pour qu'ils englobent les deux champs de groupe, afin que tous les champs soient englobés dans l'encadrement itératif détail.

•	Ancrez chacun des champs de groupe à l'encadrement itératif maître (RF1).

•	Créez la ligne de texte standard L1 sous les champs de l'encadrement itératif détail (RF2).

•	Créez les lignes de texte standard L2 à L5 et associez-les à l'encadrement de groupe qui les entoure (GF1) à l'aide de la propriété Etirement de ligne avec encadrement.

 Cliquez ici.

Lorsque l'état est mis en forme, les points d'ancrage explicites font apparaître les champs de groupe à la même fréquence que l'encadrement itératif maître. La ligne L1 se répète pour chaque enregistrement de l'encadrement itératif détail et les lignes L2 à L5 s'étendent pour couvrir toute la longueur de l'encadrement de groupe extérieur.


Etirement de ligne avec encadrement - Restrictions

•	Etirement de ligne avec encadrement n'accepte que les lignes horizontales et verticales. Si cette propriété est définie pour une diagonale, celle-ci devient une ligne horizontale ou verticale lorsqu'elle est mise en forme.

•	Lorsque cette propriété est définie, l'algorithme d'ancrage implicite n'est pas valide.


Propriétés de bouton

  Restrictions 	  Rubriques connexes

Attributs d'hyperlien supplémentaire

Ligne de commande d'application (PDF)

Activation de l'impression de base

Signet

Commentaires

Déclencheur de format

Elasticité horizontale

Hyperlien

Destination hyperlien

Nom icône

Objet solidaire

Type de libellé

Colonne multimédia

Type de colonne multimédia

Fichier multimédia

Type de fichier multimédia

Nom

Saut de page après

Saut de page avant

Protection pge

Déclencheur PL/SQL

Activation de l'objet d'impression

Code d'imprimante après

Code d'imprimante avant

Texte

Type

Elasticité verticale


Boutons - Restrictions

•	Les boutons n'apparaissent ni dans la sortie imprimée, ni lorsque les états qui les contiennent sont exécutés en mode caractère.

•	Les boutons apparaissent dans la vue Aperçu interactif avec les caractéristiques des boutons natifs de votre plate-forme. Les modifications apportées dans la vue Modèle de présentation et modifiant l'aspect du bouton (remplacement des bordures par des traits discontinus, par exemple) peuvent donc ne pas apparaître dans votre sortie imprimée. Si vous remplacez la bordure par un un trait discontinu, la modification apparaîtra dans la vue Modèle de présentation, mais non dans la vue Aperçu interactif.

•	La possibilité d'attribuer différentes couleurs et différents motifs à des boutons définis par l'utilisateur est propre à la plate-forme considérée.

•	Vous ne pouvez pas faire pivoter un bouton.

•	Un bouton est toujours affiché dans la couche supérieure des objets de la vue Aperçu interactif. Cependant, il peut ne pas être affiché sur la couche supérieure de la vue Modèle de présentation ; par exemple, s'il est recouvert par un encadrement itératif dans la vue Modèle de présentation, il apparaîtra sur les objets situés dans l'encadrement itératif de la vue Aperçu interactif, mais ne se répétera pas dans l'encadrement itératif.


Propriété Type de libellé
Type de libellé

  Restrictions

Description  La propriété Type de libellé indique le type d'identificateur qui doit apparaître sur le bouton.

Valeurs

Texte	Indique que vous voulez utiliser une chaîne de texte comme libellé de bouton. Utilisez le champ Texte sous Libellé de bouton pour entrer la chaîne de texte du libellé.
Icône	Indique que vous voulez utiliser une icône comme libellé de bouton. Utilisez le champ Nom d'icône sous Libellé de bouton pour indiquer l'icône du libellé. Report Builder utilisera le chemin d'accès défini par la variable d'environnement UI_ICON.
Application  boutons

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Texte


Type de libellé - Restrictions

•	Une icône utilisée comme libellé doit avoir le format standard des icônes de votre plate-forme, avec le suffixe .ico. Les icônes ne sont pas portables.


Propriété Texte
Texte

  Restrictions

Description  La propriété Texte indique le libellé de texte qui apparaîtra sur le bouton si vous sélectionnez Texte comme Type de libellé. La chaîne de texte indiquée est centrée horizontalement et verticalement sur le bouton.

Valeurs  Toute chaîne de texte d'un maximum de 2 Ko de long. Cependant, la longueur réelle dépend de la taille du bouton.

Application  boutons

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc

Notes d'utilisation

•	Vous pouvez modifier la police, la taille, le poids et le style du libellé en utilisant les options du menu Format. Cependant, certaines options de menu (espacement et justification) sont sans effet sur le texte des boutons.


Texte - Restrictions

•	Si le texte est trop grand pour le bouton, il ne passera pas automatiquement à la ligne suivante, mais sera tronqué à gauche et à droite.


Propriété Nom d'icône
Nom d'icône

Description  La propriété Nom d'icône indique le nom du fichier d'icône qui apparaîtra sur le bouton si vous sélectionnez Icône comme Type de libellé.

Valeurs  Tout fichier d'icône valide dans le format standard des icônes de votre plate-forme, avec le suffixe .ico. Si vous n'indiquez pas de chemin d'accès complet, Report Builder utilise le chemin d'accès défini par la variable d'environnement UI_ICON.

Application  boutons

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc


Propriété Type

  Restrictions

Description  La propriété Type indique l'action qui devra être exécutée lorsque l'utilisateur appuie sur le bouton.

Valeurs

Fichier multimédia	Indique que l'action se trouve dans un fichier de votre système d'exploitation, indiqué par la propriété Fichier multimédia.
Colonne multimédia	Indique que l'action se trouve dans la colonne de la base de données, indiquée par la propriété Colonne multimédia.
PL/SQL	Indique que l'action est sous le contrôle de l'unité de programme PL/SQL associée au bouton, indiquée par la propriété Déclencheur PL/SQL.
Application  boutons

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Fichier multimédia


Type - Restrictions

•	Si vous indiquez Déclencheur PL/SQL et que votre PL/SQL utilise SRW.RUN_REPORT, la grille de paramètres d'exécution n'apparaît pas par défaut lorsque l'utilisateur sélectionne le bouton. Si vous voulez que la grille de paramètres d'exécution apparaisse, vous devez indiquer PARAMFORM=YES dans l'appel à SRW.RUN_REPORT.

•	Si vous indiquez Déclencheur PL/SQL et que vous génériez SRW.PROGRAM_ABORT dans le déclencheur d'action du bouton, la fenêtre Aperçu générée par le bouton se ferme.


Propriété Fichier multimédia
Fichier multimédia

  Restrictions%!Alink(r30rpbumfr,JUMP , , )

Description  La propriété Fichier multimédia indique le nom du fichier multimédia (son, vidéo ou image).

Valeurs  Tout fichier son, vidéo ou image valide.

Application  boutons

Obligatoire/facultatif  Obligatoire, si Fichier multimédia est défini à Type.

Valeur par défaut  blanc

Notes d'utilisation

•	Pour garantir la portabilité de vos états, utilisez la variable d'environnement REPORTS60_PATH de Report Builder qui permet d'indiquer le ou les répertoires par défaut dans lesquels vous voulez que Report Builder recherche les fichiers externes que vous utilisez dans vos états (par exemple, interrogations externes, texte standard et PL/SQL). De cette façon, vous évitez de programmer dans votre état les chemins d'accès aux répertoires.


Fichier multimédia - Restrictions

•	Si vous sélectionnez Fichier multimédia, vous devez indiquer le nom de fichier dans le champ de texte approprié. Si vous n'indiquez pas le chemin du fichier, Report Builder utilise son ordre de recherche de chemin pour trouver le fichier.


Propriété Type de fichier multimédia
Type de fichier multimédia

Description  La propriété Type de fichier multimédia indique le format du fichier indiqué par la propriété Fichier multimédia.

Valeurs  Image, Vidéo et Son.

Application  boutons

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Image


Propriété Colonne multimédia
Colonne multimédia

  Restrictions

Description  La propriété Colonne multimédia indique le nom d'une colonne de la base de données de l'état qui contient un objet multimédia (son, vidéo ou image).

Valeurs  Toute colonne de base de données valide de l'état contenant un objet multimédia.

Application  boutons

Obligatoire/facultatif  Obligatoire, si Colonne multimédia est défini à Type.

Valeur par défaut  blanc


Colonne multimédia - Restrictions

•	Si vous indiquez une Colonne multimédia comme action d'un bouton, puis supprimez cette colonne de votre état (c'est-à-dire si vous sélectionnez une colonne d'image, indiquez qu'elle doit être la Colonne multimédia d'un bouton, puis supprimez cette colonne ou transformez son format en format non multimédia), votre bouton n'a plus accès aux données à afficher, et Colonne multimédia devient non défini.

Si la fenêtre de propriété du bouton est ouverte au moment où la colonne multimédia devient non définie, vous devez choisir une autre colonne avant de valider la fenêtre de propriétés. Si cette fenêtre est fermée au moment où la colonne multimédia devient non définie, vous n'en serez informé que lorsque vous exécuterez l'état et tenterez d'activer le bouton. Cette opération générera une erreur.


Propriété Type de colonne multimédia
Type de colonne multimédia

Description  La propriété Type de colonne multimédia indique le format de l'objet multimédia stocké dans la colonne de base de données indiquée par la propriété Colonne multimédia.

Valeurs  Image, Vidéo et Son.

Application  boutons

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Lorsque Colonne multimédia est indiqué, le type de colonne multimédia correspondant est automatiquement sélectionné. Sinon, la valeur par défaut est Image.


Propriété Déclencheur PL/SQL
Déclencheur PL/SQL

  Rubriques connexes

Description  La propriété Déclencheur PL/SQL  est une procédure PL/SQL exécutée lorsqu'un bouton est sélectionné dans la vue Aperçu interactif. Le déclencheur peut être utilisé pour appeler dynamiquement un autre état (descente de niveau) ou exécuter une autre procédure PL/SQL.

Application  boutons

Obligatoire/facultatif  Obligatoire, si le type de bouton est PL/SQL

Valeur par défaut  blanc


Propriétés de graphique

  Restrictions 	  Exemples

Attributs d'hyperlien supplémentaire

Ligne de commande d'application (PDF)

Activation de l'impression de base

Signet

Nom de fichier de graphique

Hyperliens graphiques

Commentaires

Déclencheur de format

Elasticité horizontale

Hyperlien

Destination hyperlien

Objet solidaire

Nom

Saut de page après

Saut de page avant

Protection pge

Paramètres et colonnes

Activation de l'objet d'impression

Code d'imprimante après

Code d'imprimante avant

Elasticité verticale


Graphique d'état de groupe - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un état de groupe avec le modèle de données suivant :

 Cliquez ici.

Dans Graphics Builder, vous avez créé un affichage Graphics Builder (empsal.ogd) représentant un graphique à barres du salaire de chaque employé, que vous voulez inclure dans votre état. En utilisant l'outil Graphique de la vue Modèle de présentation, vous commencez par dessiner un objet graphique dans l'encadrement itératif pour l'encadrement itératif maître (R_Dept). Le graphique à barres apparaît une fois pour chacun des départements.

Vous passez ensuite à la palette de propriétés de l'objet graphique et paramétrez la propriété Nom d'affichage sur empsal.ogd. Ce nom peut, en option, contenir un chemin d'accès mais, dans le cas présent, aucun chemin d'accès n'a été indiqué, car vous voulez que Report Builder utilise le chemin indiqué pour la variable d'environnement REPORTS60_PATH.

Paramétrez les propriétés de la palette de la manière suivante :

Source	G_Emp
Affichage de l'interrogation	Q_OG_Emp
Colonne Etat/Affichage	ENAME/OG_NAME SAL/OG_SALARY
Source est le groupe (G_Emp) récapitulé par l'affichage.

Interrogation d'affichage est le nom d'une interrogation de l'affichage. Q_OG_Emp contient l'instruction SELECT suivante :

SELECT ENAME OG_NAME, SAL OG_SALARY FROM EMP

Comme vous avez indiqué Q_OG_Emp comme Interrogation d'affichage, cette interrogation extraira les valeurs de ENAME et SAL de Report Builder et non de la base de données.

Colonne d'état et Colonne d'affichage établissent la correspondance entre les colonnes de l'état et les colonnes de l'affichage. Vous avez sélectionné ENAME et SAL dans la liste sous Colonne d'état. Vous devez entrer les noms des colonnes d'affichage qui correspondent à ENAME et à SAL dans Colonne d'affichage. (Colonne d'affichage ne peut pas rester en blanc si Colonne d'état est indiqué.)


Graphique - Restrictions

•	Un affichage/graphique de Graphics Builder qui transmet des données peut être placé en n'importe quel endroit de la vue Modèle de présentation, à moins que son groupe source soit une dimension d'une matrice. Si un groupe source d'affichage/graphique de Graphics Builder est un groupe de dimensions (c'est-à-dire un groupe dans un groupe inter-produit), il doit apparaître dans le ou les encadrements itératifs des ancêtres de son groupe source (le cas échéant).

•	Un affichage/graphique de Graphics Builder qui transmet des paramètres doit être placé dans un encadrement itératif dont le groupe source est le groupe (ou un descendant du groupe) qui contient les colonnes ou les paramètres qu'il transfère. Si une colonne en cours de transfert est un récapitulatif appartenant à un groupe inter-produit, l'affichage/graphique de Graphics Builder doit être placé dans l'ensemble d'encadrements itératifs dont les sources sont les groupes de l'Ordre produit. de la colonne récapitulative.


propriété Nom de fichier de graphique
Nom de fichier de graphique

  Restrictions

Description  La propriété Nom de fichier de graphique permet d'indiquer le nom du fichier dans lequel se trouve l'affichage/graphique de Graphics Builder.

Valeurs  Entrez tout nom de fichier valide (d'un maximum de 512 octets de long) d'un affichage/graphique de Graphics Builder (le suffixe .ogd est facultatif).

Application  objets graphiques

Obligatoire/Facultatif  obligatoire

Valeur par défaut  blanc

Notes d'utilisation

•	Vous pouvez faire précéder le nom de fichier d'un chemin d'accès. Si aucun nom de chemin d'accès ne précède le nom du fichier, Report Builder utilise son ordre de recherche pour trouver le fichier.

•	Pour garantir la portabilité de vos états, utilisez la variable d'environnement REPORTS60_PATH de Report Builder qui permet d'indiquer le ou les répertoires par défaut dans lesquels vous voulez que Report Builder recherche les fichiers externes que vous utilisez dans vos états (par exemple, interrogations externes, texte standard et PL/SQL). De cette façon, vous évitez de programmer dans votre état les chemins d'accès aux répertoires.


Nom de fichier de graphique - Restrictions

•	Vous ne pouvez faire référence qu'à des affichages/graphiques stockés dans des fichiers ; ceux qui sont stockés dans la base de données ne peuvent pas être référencés dans Nom de fichier de graphique.


Propriété Hyperlien graphique
Hyperlien graphique

  Restrictions 	  Rubriques connexes

Description  La propriété Hyperlien graphique est un hyperlien que vous pouvez définir de manière unique pour chaque section graphique. Remarque

Valeurs

Tout objet de votre état, d'un autre état ou toute destination d'hyperlien valide

Application

objets graphique

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc

Notes d'utilisation

•	Vous devez définir la propriété Destination hyperlien pour paramétrer la propriété Hyperlien graphique d'un graphique indiquant un autre objet comme destination.

•	Vous ne pouvez pas utiliser la propriété Attributs d'hyperlien supplémentaire pour appliquer d'autres attributs HTML à un lien défini par la propriété Hyperlien graphique.

•	Vous pouvez définir un autre état en tant que propriété Hyperlien graphique en exécutant le second état depuis votre état. Pour plus d'informations, reportez-vous à d2kcfg.htm dans ORACLE_HOME.

•	Vous ne pouvez pas définir cette propriété via PL/SQL étant donné que le déclencheur de mise en forme n'est exécuté qu'une fois pas graphique. Vous devez donc indiquer &<nom_colonne> comme propriété Hyperlien graphique.


La propriété Hyperlien graphique ne se comporte pas comme la propriété Hyperlien car Report Builder évalue la propriété pour chaque ligne de données extraite.


Propriétés de colonnes et de paramètres de graphique

Colonne de graphique

Paramètre de graphique

Interrogation de graphique

Colonne d'état (pour colonne de graphique)

Colonne d'état (pour paramètre de graphique)

Groupe d'état


propriété Paramètre de graphique
Paramètre de graphique

  Rubriques connexes

Description  La propriété Paramètre de graphique est un paramètre de l'affichage/graphique de Graphics Builder qui correspond à la colonne ou au paramètre indiqués dans Colonne d'état.

Remarque:  Une colonne ou un paramètre d'état peut correspondre à plusieurs paramètres de graphique, mais un paramètre de graphique ne peut correspondre qu'à une colonne ou un paramètre d'état.

Valeurs  Entrez le nom (maximum de 1Ko de long) d'un paramètre valide dans votre affichage/graphique de Graphics Builder. Vous pouvez  également entrer une liste de noms de paramètre valides dans votre affichage/graphique de Graphics Builder, en les séparant par des virgules (par exemple, param1,param2,param3).

Application  objets graphiques

Obligatoire/Facultatif  facultatif

Valeur par défaut  Nom de paramètre de Report Builder


propriété Colonne d'état (pour Paramètre de graphique)
Colonne d'état (pour Paramètre de graphique)

  Restrictions	  Rubriques connexes

Description  La propriété Colonne d'état (pour Paramètre de graphique) regroupe la liste de colonnes et de paramètres de votre état pouvant être utilisés pour fournir la valeur d'un paramètre dans l'affichage/graphique de Graphics Builder. La sélection d'une colonne ou d'un paramètre signifie qu'il y a un paramètre correspondant dans l'affichage/graphique et que le paramètre d'affichage/graphique extraira sa valeur de la colonne ou du paramètre de l'état sélectionné. Si le paramètre de l'affichage/graphiquea un nom différent de celui de la colonne ou du paramètre de l'état, vous devez indiquer son nom dans le champ Paramètre de graphique correspondant.

Valeurs  Sélectionnez une ou plusieurs colonnes ou paramètres valides dans votre état.

Application  objets graphiques

Obligatoire/Facultatif  facultatif

Valeur par défaut  désélectionné


Colonne d'état (pour Paramètre de graphique) - restrictions

•	Une colonne récapitulative de niveau page (c'est-à-dire un récapitulatif dont l'option Réinitialiser à ou Calculer à est définie à Page) ne peut pas être transférée à un affichage/graphique de GraphicsBuilder. De même, une colonne récapitulative ou une colonne de formule qui dépend d'un récapitulatif de niveau page ne peut pas être transmise à un affichage/graphique.


propriété Interrogation de graphique
Interrogation de graphique

  Rubriques connexes

Description  La propriété Interrogation de graphique indique le nom de l'interrogation de l'affichage/graphique de GraphicsBuilder qui doit obtenir ses enregistrements de Report Builder. Si vous indiquez un nom d'interrogation, cette interrogation extraira ses enregistrements de Report Builder et non de la base de données. Cette possibilité permet à votre affichage/graphique de refléter le filtrage ou la récapitulation que votre état exécute sur les données. Interrogation de graphique garantit que les données utilisées dans l'affichage /graphique sont les mêmes que les données de état.

Remarque:  Si vous indiquez un nom d'interrogation, vous devez également indiquer les colonnes ou les paramètres d'état dont les valeurs doivent être utilisées par l'interrogation d'affichage/graphique.

Valeurs  Entrez  un nom d'interrogation valide (maximum de 512 octets) de l'affichage/graphique de Graphics Builder, indiqué dans Nom de fichier de graphique.

Application  objets graphiques

Obligatoire/Facultatif  facultatif


propriété Groupe d'état
Groupe d'état

  Restrictions	  Rubriques connexes

Description  La propriété Groupe d'état indique le groupe de l'état qui est récapitulé par l'affichage/graphique de GraphicsBuilder.

Valeurs  Sélectionnez tout nom de groupe dans la liste valeurs.

Application  objets graphiques

Obligatoire/facultatif  obligatoire, si vous avez entré une valeur pour Interrogation de graphique.


Groupe d'état - restrictions

•	Vous ne pouvez pas indiquer de groupe inter-produit comme Groupe d'état.

•	Les colonnes que vous transférez à l'affichage/graphique de GraphicsBuilder par Colonne d'état (pour Colonne de graphique) doivent figurer dans le groupe d'état ou son ancêtre.

•	Si vous indiquez un Groupe d'état sans indiquer d'Interrogation de graphique, le Groupe d'état est désélectionné lorsque vous validez la fenêtre de propriétés.


propriété Colonne de graphique
Colonne de graphique

  Rubriques connexes

Description  La propriété Colonne de graphique est une colonne ou une liste de colonnes de l'affichage/graphique de GraphicsBuilder qui correspond à la colonne ou au paramètre indiqués dans Colonne d'état.

Remarque:  Une colonne ou un paramètre d'un état peut correspondre à plusieurs colonnes d'un graphique, mais chaque colonne de graphique ne peut correspondre qu'à une colonne ou à un paramètre de l'état.

Valeurs  Entrez le nom (maximum 1Ko de long) d'une colonne valide dans votre affichage/graphique de GraphicsBuilder. Vous pouvez également entrer une liste de noms de colonne valides dans votre affichage/graphique de GraphicsBuilder, séparés par des virgules (par exemple, col1,col2,col3).

Application  objets graphiques

Obligatoire/Facultatif  facultatif

Valeur par défaut  Nom de colonne de Report Builder


propriété Colonne d'état (pour Colonne de graphique)
Colonne d'état (pour Colonne de graphique)

  Restrictions	  Rubriques connexes

Description  La propriété Colonne d'état (pour Colonne de graphique) est la liste des colonnes et des paramètres de votre état pouvant être utilisés par l'interrogation indiquée dans Interrogation de graphique. La sélection d'une colonne ou d'un paramètre indique qu'il y a une ou plusieurs colonnes correspondantes dans l'affichage/graphique de GraphicsBuilder et que la ou les colonnes d'affichage/graphique extrairont leur valeur de la colonne ou du paramètre d'état sélectionnés. Si la ou les colonnes de l'affichage/graphique ont un nom différent de celui de la colonne ou du paramètre d'état, vous devez indiquer son nom dans le champ Colonne de graphique correspondant.

Valeurs  Sélectionnez une ou plusieurs colonnes ou paramètres valides dans votre état.

Application  objets graphiques

Obligatoire/facultatif  obligatoire, si vous avez entré une valeur pour Interrogation de graphique.


Colonne d'état (pour Colonne de graphique) - restrictions

•	Les colonnes que vous transférez à l'affichage/graphique de GraphicsBuilder par Colonne d'état (pour Colonne de graphique) doivent figurer dans le groupe d'état ou son ancêtre.

•	Une colonne récapitulative de niveau page (c'est-à-dire un récapitulatif dont l'option Réinitialiser à ou Calculer à est définie à Page) ne peut pas être transférée à un affichage/graphique de GraphicsBuilder. De même, une colonne récapitulative ou une colonne de formule qui dépend d'un récapitulatif de niveau page ne peut pas être transmise à un affichage/graphique.


Propriétés de colonnes communes

Ordre de ventilation

Commentaire

Type de colonne

Type de données

Format de fichier

Nom

Lecture depuis fichier

Définir ordre de ventilation

Valeur si Null

Largeur


propriété Ordre de ventilation
Ordre de ventilation

  Restrictions 	  Exemples

Description  La propriété Ordre de ventilation permet d'indiquer l'ordre dans lequel les valeurs de la colonne doivent être affichées. Cette propriété s'applique uniquement aux colonnes qui identifient des valeurs distinctes de groupes créés par l'utilisateur (c'est-à-dire des groupes de ventilation). L'ordre des valeurs de colonne, dans un groupe par défaut, est déterminé par la clause ORDER BY de l'interrogation pour les interrogations SQL et par la colonne de tri pour les interrogations Express. Cependant, pour les valeurs de colonne des groupes créés par l'utilisateur, vous devez utiliser Ordre de ventilation pour indiquer comment les valeurs de la colonne de ventilation doivent être classées.

Valeurs

none

Ascendant

Descendant

Application  colonnes

Obligatoire/facultatif  Obligatoire, si Définir ordre de ventilation est défini à Oui

Valeur par défaut Ascendant pour les colonnes de base de données et de tri. Aucun pour les colonnes de base de données qui représentent des dimensions dans les interrogations Oracle Express associées à des groupes de ventilation.


Ordre de ventilation (descendant) - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un état créé avec l'interrogation suivante :

SELECT NODEPT, POSTE, NOME, SAL FROM EMP
ORDER BY SAL

dans lequel vous créez deux groupes, G_DEPT et G_JOB. G_DEPT contient la colonne NODEPT et G_JOB contient la colonne POSTE. Si vous indiquez un Ordre de ventilation Descendant pour la colonne NODEPT et Ascendant pour la colonne POSTE, votre sortie se présente de la manière suivante (si vous avez choisi le style Tabulaire) :

Nodépt   Poste          NomE                Sal

------   ----------   ----------        ---------

    30   EMPLOYE       JAMIN             9500,00

         DIRECTEUR     BERNARD          28500,00

         VENDEUR       WALTER           12500,00

                       MARTIN           12500,00

                       TRAVERS          15000,00

                       ALLEN            16000,00

    20   ANALYSTE      SCOTT            30000,00

                       FORD             30000,00

         EMPLOYE       SIMON             8000,00

                       ADAM             11000,00

         DIRECTEUR     JACQUES          29750,00

    10   EMPLOYE       MILOT            13000,00

         DIRECTEUR     CARLIER          24500,00

         PRESIDENT     KLEBER           50000,00


Ordre de ventilation (ORDER BY) - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un état A gauche du groupe, comportant NODEPT et NOME. Dans l'interrogation, vous avez indiqué ORDER BY NODEPT. Vous avez également indiqué un Ordre de ventilation Descendant pour la colonne NODEPT. La sortie se présente de la manière suivante :

Nodépt   NomE

------   ----------

    30   JAMIN

         XALTER

         MARTIN

         TRAVERS

         ALLEN

         BERNARD

    20   SIMON

         ADAM

         JACQUES

         SCOTT

         FORD

    10   MILOT

         CARLIER

         KLEBER

Notez que la propriété Ordre de ventilation a priorité sur la clause ORDER BY (c'est-à-dire que les numéros de département sont classés en ordre décroissant).


Ordre de ventilation - restrictions

•	La propriété Ordre de ventilation est sans effet sur les colonnes qui appartiennent au groupe le moins élevé d'une interrogation donnée. Elle n'a d'effet que sur les colonnes des groupes situés au-dessus du groupe fils le plus bas d'une interrogation.

•	Chaque groupe situé au-dessus du groupe fils le plus bas d'une interrogation doit avoir au moins une colonne dont l'Ordre de ventilation est défini.

•	La propriété Ordre de ventilation ne peut pas être définie pour les colonnes de type Long ou Long Row

•	L'ordre de ventilation ne porte que sur le classement de la colonne sur laquelle porte la ventilation, et non sur l'ordre des colonnes du groupe de ventilation. Par exemple, vous demandez une ventilation sur NODEPT avec une liste NOME pour chaque département. Si l'ordre de ventilation est Ascendant, les numéros de département sont imprimés en ordre croissant, mais les noms à l'intérieur de chaque département sont imprimés dans l'ordre indiqué par l'interrogation. (Vous devez utiliser une clause ORDER BY dans votre instruction SELECT pour modifier cet ordre dans les interrogations SQL et l'outil Trier du Sélecteur pour le modifier dans les interrogations Express.)

•	Une colonne récapitulative ne peut pas être une colonne de ventilation et ne peut pas avoir la propriété Ordre de ventilation définie.

•	Une colonne de formule qui dépend d'une colonne récapitulative ne peut pas être une colonne de ventilation et ne peut pas avoir la propriété Ordre de ventilation définie.


Propriété Type de colonne
Type de colonne

Description  La propriété Type de colonne indique la catégorie à laquelle appartient une colonne.

Valeurs

Base de données - Objet

Base de données - Réf

Base de données - Scalaire

Base de données - Inconnue indique que le type de la colonne n'est pas pris en charge.

Formules

De réserve

Tri (pour Oracle Express uniquement)

Récapitulatif


Propriété Commentaire

Description  La propriété Commentaire correspond à un champ de texte dans lequel vous pouvez documenter la colonne.

Valeurs  Entrez un texte d'un maximum de 64 Ko de long.

Application  colonnes

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc


Propriété Nom de colonne de base de données
Nom de colonne de base de données

Description  La propriété Nom de colonne de base de données correspond au nom complet utilisé par le serveur Oracle pour identifier une colonne. Par exemple, supposez qu'un objet colonne intitulé ADDRESS contienne un objet colonne COUNTRY, qui contient lui-même une colonne CITY. Dans ce cas, le nom de colonne de base de données de CITY est ADDRESS.COUNTRY.CITY.

Application  colonnes

Obligatoire/Facultatif  obligatoire


Propriété Type de données
Type de données

  Restrictions

Description  La propriété Type de données permet d'indiquer le type du contenu de la colonne.

Valeurs

Caractère (Character)

Date (Date)

Long

Long Raw

Nombre (Number)

Raw

Varchar

Varchar2

Les types de données Oracle sécurisé (MLSLABEL et ROWLABEL) sont pris en charges par Report Builder. En cas d'exécution sur un système d'exploitation avec Oracle sécurisé, Report Builder traite ces colonnes comme des types de données Oracle sécurisé, et les colonnes peuvent donc être correctement triées. En cas d'exécution sur un système d'exploitation sans Oracle sécurisé (par exemple, Windows), Report Builder traite ces colonnes comme des données de type caractère.

Application  colonnes

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Pour les colonnes de base de données, le type de données par défaut est dérivé de la base de données. Pour les colonnes récapitulatives ayant la Fonction Décompte, le type de données par défaut est Nombre. Pour les autres colonnes récapitulatives, la valeur par défaut est dérivée de Source. Pour les colonnes de formule, de réserve et de tri, le type de données par défaut est Nombre.


Type de données - Restrictions

•	Vous ne pouvez éditer que le type de données d'une colonne de formule ou d'une colonne de réserve. Pour les colonnes de formule et les colonnes de réserve, vous pouvez définir le type de données à Character, Date et Number.

•	Sauf indication contraire dans le champ Format de fichier, une colonne de type Long, Long Raw ou Raw est traitée comme du texte.

•	Si une colonne a un alias et si vous modifiez votre interrogation, et par conséquent si vous changez le type de données de la colonne, la modification apportée au type de données se reflétera automatiquement dans le type de données lorsque vous validerez l'interrogation.


propriété Format de fichier
Format de fichier

  Restrictions

Description  La propriété Format de fichier permet d'indiquer le format de l'objet extrait de la base de données par la colonne. Cette propriété indique à Report Builder si l'objet est un graphique, une image ou un texte, et le format dans lequel il est stocké.

Valeur

Texte	Texte en format ASCII
Image	Image bitmap
CGM	Tracé de ligne en format CGM
Format Oracle (dessin)	Tracé de ligne en format Oracle
Son	Objet son au format longraw
Vidéo	Objet vidéo au format longraw
OLE2	Objet lié à incorporer dans votre état
URL d'image	Lien URL vers une image
Application  colonnes


Format - restrictions

•	Format de fichier ne peut être indiqué que si la colonne est de type Long, Long Raw ou Raw.Vous ne pouvez accéder aux sources Son et Vidéo qu'à partir de boutons créés par l'utilisateur.


propriété Lecture depuis fichier
Lecture depuis fichier

  Restrictions 	  Exemples	  Rubriques connexes

Description  La propriété Lecture depuis fichier permet d'indiquer que la colonne contient les noms des fichiers. Lorsque vous définissez Lecture depuis fichier à Oui, vous devez indiquer le format des fichiers dans la liste des valeurs affichées à côté.

Cette liste de valeurs est semblable à celle de Format de fichier. Lecture depuis fichier est utile si vous avez des fichiers d'images, de graphiques ou de textes sur lesquels pointe une colonne d'une table. Si vous définissez Lecture depuis fichier à Oui, le contenu des fichiers est importé et utilisé comme valeurs de la colonne. Si Lecture depuis fichier est défini à Non, la colonne extrait ses valeurs de la base de données. Si une colonne contient des noms de fichiers et si Lecture depuis fichier est défini à Non, les noms de fichier seront donc imprimés, et non le contenu des fichiers.

Vous pouvez utiliser Lecture depuis fichier avec des colonnes de base de données, récapitulatives, de formule ou de réserve (à condition que les valeurs de la colonne soient des noms de fichier).Vous pouvez également inclure des fichiers dans votre état sous la forme d'un texte standard. Pour plus d'informations, reportez-vous à "Fichier de liaison"SRWREBLAYLinkF.

Application  colonnes

Obligatoire/Facultatif  facultatif

Notes d'utilisation

•	Vous pouvez faire précéder de chemins d'accès les noms de fichier de la colonne. Si un chemin ne précède pas le nom de fichier, Report Builder utilise son ordre de recherche de cheminr pour trouver le fichier.

•	Pour garantir la portabilité de vos états, utilisez la variable d'environnement REPORTS60_PATH de Report Builder qui permet d'indiquer le ou les répertoires par défaut dans lesquels vous voulez que Report Builder recherche les fichiers externes que vous utilisez dans vos états (par exemple, interrogations externes, texte standard et PL/SQL). De cette façon, vous évitez de programmer dans votre état les chemins d'accès aux répertoires.


Lecture depuis fichier (image) - Exemple

  Rubriques connexes 	  Tous les exemples

Supposons que, pour chacun de vos employés, vous ayez un fichier .bmp contenant une image de l'employé. Dans votre table des employés, une colonne appelée PICTURE contient le nom du fichier .bmp, avec l'image de l'employé.

Pour générer un état affichant les images des employés, sélectionnez la colonne PICTURE dans votre interrogation. Dans la fenêtre de propriétés Colonne de la colonne PICTURE, définissez à Oui Lecture depuis fichier et indiquez Image comme format de fichier. Report Builder affiche alors les fichiers sur lesquels pointait la colonne PICTURE partout où vous avez référencé la colonne PICTURE dans votre présentation

Remarque :  Si la propriété Lecture depuis fichier est définie à Non, les noms de fichier sont imprimés, et non les images.


Lecture depuis fichier (colonne de formule) - Exemple

  Rubriques connexes 	  Tous les exemples

Vous voulez créer une liste d'employés, accompagnée d'un texte extrait d'un fichier, en regard des informations concernant chaque employé. Si le salaire de l'employé est supérieur à $ 2000, vous voulez que le texte d'un fichier appelé salaire.txt apparaisse en regard de l'employé. Si le salaire de l'employé est inférieur à $ 2000, vous voulez que le texte d'un fichier appelé salaire2.txt apparaisse en regard de l'employé.

Vous créez une colonne de formule de type caractère et définissez Lecture depuis fichier à Oui (et Format de fichier à Texte). Dans le champ Formule de la colonne, vous entrez l'instruction PL/SQL suivante :

if :sal > $ 2000 then
  return('/home/jsmith/txt/salaire1.txt');
else
  return('/home/jsmith/txt/salaire2.txt');
end if;


Lecture depuis fichier - restrictions

•	La taille de chaque fichier ne peut pas être supérieure à 4 giga-octests. (Sous certains systèmes d'exploitation, le fichier peut être au maximum de 64 Ko.)

•	Lecture depuis fichier ne peut être défini à Oui que si le type de données de colonne est compatible au niveau caractère (c'est-à-dire, Character, VARCHAR ou VARCHAR2).

•	Si vous définissez Lecture depuis fichier à Oui dans une colonne récapitulative ou une colonne de formule, le récapitulatif ou la formule est calculé avant que le fichier soit lu. De même pour les colonnes de réserve pour lesquelles Lecture depuis fichier est défini à Oui, la valeur de la colonne est calculée en premier.


propriété Valeur si Null
Valeur si Null - restrictions

  Restrictions

Description  La propriété Valeur si Null permet d'indiquer une valeur qui doit remplacer toutes les valeurs nulles de la colonne. Par exemple, si vous entrez X dans ce champ pour une colonne de type caractère, X sera affiché pour les valeurs nulles extraites pour la colonne. Si ce champ est laissé en blanc, aucune substitution ne sera effectuée pour les valeurs nulles.

Valeurs  Entrez toute valeur valide conforme au type de données de la colonne. Valeur si Null ne peut pas avoir plus de 1 Ko de long.

Application  colonnes

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc

Notes d'utilisation

•	Si vous entrez une chaîne pour Valeur si Null dans une colonne de ventilation, Report Builder commence par extraire toutes les lignes du groupe de la colonne de ventilation, ce qui peut dégrader les performances lorsque vous exécutez l'état. Pour éviter cette opération, utilisez la fonction NVL dans votre interrogation au lieu d'entrer une chaîne pour Valeur si Null


Valeur si Null - Restrictions

•	Pour les colonnes de type caractère (par exemple, VARCHAR), si la largeur de la chaîne que vous entrez pour Valeur si Null dépasse la largeur de la colonne, la chaîne est tronquée.

•	Si une colonne est référencée par une référence lexicale dans une interrogation, la propriété Valeur si Null de cette colonne est utilisée pour valider l'interrogation.

•	La valeur entrée pour Valeur si Null doit avoir le même type de données que la colonne. Par exemple, si le type de données de la colonne est Number, vous ne pouvez pas indiquer "XX" dans Valeur si Null, mais un nombre.

•	Si vous entrez une valeur de date dans Valeur si Null, elle est validée par comparaison au masque interne des dates (c'est-à-dire JJ-MOI-AA) de Report Builder. (Les valeurs de types Number et Character ne sont pas validées.)


Propriété Largeur
Largeur

  Restrictions

Description  La propriété Largeur permet d'indiquer le nombre maximum de caractères que les valeurs de la colonne peuvent occuper. Cette largeur fait référence à la largeur que Report Builder utilise en interne pour la colonne. Elle conditionne un certain nombre d'éléments comme les calculs des récapitulatifs et des formules. Cependant, la taille utilisée pour afficher les données de la colonne est déterminée par la taille du champ associé dans la vue Modèle de présentation et ses propriétés Elasticité horizontale et verticale.

Valeurs

Entrez un nombre compris entre 1 et 64 Ko.

Entrez deux nombres sous la forme a,b où a indique le nombre de chiffres à gauche du séparateur décimal et b le nombre de chiffres à droite du séparateur décimal. (Cette forme ne peut être utilisée que pour la définition de la largeur des nombres.)

Application  colonnes

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Pour les colonnes de bases de données, la largeur par défaut est dérivée de la base de données. Pour les colonnes de tri, la largeur par défaut est 38. Pour les colonnes récapitulatives et les colonnes de formule, la largeur par défaut est 10. Si une colonne est de type récapitulatif, Report Builder met la largeur à jour en fonction des valeurs que vous entrez dans Source et Fonction de la colonne.

Notes d'utilisation

•	Si la colonne est de type Database Scalar et si les données sont de type Character, Date, Number ou Raw, la propriété Largeur ne peut pas être éditée. Cependant, cela ne signifie pas que vous ne pouvez pas contrôler la largeur des valeurs de la colonne dans la sortie de l'état. Pour modifier la largeur des valeurs de la sortie, modifiez la largeur du champ dans la boîte de dialogue Présentation par défaut ou la fenêtre de propriétés Champ.

•	Si la colonne est de type Database Scalar ou colonne de réserve et que les données soient de type Long ou Long Raw, vous pouvez entrer une valeur dans Largeur. Notez que si vous n'indiquez pas de largeur pour une colonne Long ou Long Raw, Report Builder attribue à la colonne la largeur maximum. Vous pouvez également entrer une largeur pour une colonne de type Formule.

•	Si la colonne est de type Database Ref, la propriété Largeur est modifiable.

•	Si la colonne est de type Tri, vous pouvez éditer sa largeur.


Largeur - Restrictions

Attention : Si la valeur d'une colonne de type base de données et contenant des données de type Long ou Long Raw dépasse la Largeur de la colonne, la valeur est tronquée.

•	Si la valeur d'une colonne de type colonne de réserve ou formule dépasse la largeur de la colonne, un message d'exception est généré.

•	Si une colonne comporte un alias et si, après une modification apportée à votre interrogation, la largeur de la colonne change, le changement de largeur sera automatiquement répercuté sur la largeur lorsque vous validerez l'interrogation.


propriété Définir ordre de ventilation
Définir ordre de ventilation

Description  La propriété Définir ordre de ventilation permet de d'indiquer l'ordre dans lequel les valeurs de la colonne seront affichées, en utilisant la propriété Ordre de ventilation.

Application  colonnes

Obligatoire/Facultatif  facultatif

Valeur par défaut  Oui


Propriétés d'objets de présentation communs

  Restrictions

Attributs d'hyperlien supplémentaire

Ligne de commande d'application (PDF)

Activation de l'impression de base

Signet

Commentaires

Mise en forme conditionnelle

Nom d'affichage

Déclencheur de format

Elasticité horizontale

Hyperlien

Destination hyperlien

Objet solidaire

Nom

Saut de page après

Saut de page avant

Protection pge

Activation de l'objet d'impression

Code d'imprimante avant

Code d'imprimante après

Elasticité verticale


Propriétés d'objets de présentation communs - Restrictions

•	Vous devez vous assurer que les propriétés des objets, identiques ou différents, ne sont pas en conflit les unes avec les autres. Les propriétés de présentation sont d'une telle puissance qu'elles risquent parfois d'être incompatibles. Vous devez donc éviter les combinaisons de propriétés de présentation du même objet, telles qu'elles sont énumérées ci-dessous, pour ne pas risquer la génération d'un message d'erreur :

•	Activation de l'impression de base définie à Englobant et Activation de l'objet d'impression définie à Dernière page

•	Activation de l'impression de base définie à Englobant et Activation de l'objet d'impression définie à Tout sauf dernière page

•	Activation de l'objet d'impression définie à Tout et Saut de page avant définie à Oui

•	Activation de l'objet d'impression définie à Tout sauf première page et Saut de page avant définie à Oui

•	Activation de l'objet d'impression définie à Tout sauf dernière page et Saut de page avant définie à Oui

•	Objet solidaire et Saut de page avant définies à Oui (pour un objet situé après son objet d'ancrage) ou Saut de page après définie à Oui (pour un objet qui se trouve devant son objet d'ancrage).

•	De même, les combinaisons de propriétés d'objets différents peuvent entraîner des résultats imprévisibles ou un état infini. Soit, par exemple, deux objets standard ancrés ensemble dans un encadrement. L'objet père a la propriété Activation de l'objet d'impression définie à Tout et Activation de l'impression de base définie à Englobant. L'objet fils a une propriété Activation de l'objet d'impression définie à Première page, Activation de l'impression de base définie à Ancrage et Saut de page avant définie à Oui. La figure ci-dessous illustre cette présentation. Lorsque vous exécutez l'état, l'objet fils n'apparaît pas dans la sortie. Comme Saut de page avant est définie à Oui, l'objet fils ne peut jamais répondre à ses conditions Activation de l'objet d'impression (Première page) et Activation de l'impression de base (Ancrage). Notez cependant que l'objet se trouvant sous l'objet fils (B_Plate3) apparaît.

 Cliquez ici.


propriété Commentaires
Commentaires

Description  La propriété Commentaires contient un champ de texte dans lequel vous pouvez documenter l'objet. Entrez tout texte d'un maximum de 64 Ko.

Application  objets

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc


propriété Elasticité horizontale
Elasticité horizontale

  Exemples

Description  La propriété Elasticité horizontale permet d'indiquer comment la dimension horizontale de l'objet change, lors de l'exécution, en fonction des objets ou des données qu'il contient :

•	Pour les encadrements et les encadrements itératifs, l'élasticité indique si la taille de l'encadrement ou de l'encadrement itératif varie en fonction des objets qu'il contient.

•	Pour les objets contenant du texte, l'élasticité indique si le champ ou le texte standard varie en fonction de la taille du texte. Le texte de taille fixe passe à la ligne dans la taille définie pour l'objet et peut être tronqué s'il n'y a pas suffisamment de place. Les données numériques ou de date s'affichent sous la forme d'astérisques si les données ne peuvent pas tenir dans la taille indiquée.

•	Pour les images, les dessins et les objets graphiques, Report Builder utilise la mise à l'échelle proportionnelle. Les options d'élasticité des images, des schémas et des objets graphiques déterminent le facteur de mise à l'échelle.

 Cliquez ici.

Valeurs

Contracter	Indique que la dimension horizontale de l'objet diminue si les objets mis en forme ou les données qu'ils contiennent sont suffisamment larges, mais ne peut cependant pas  atteindre une largeur supérieure à celle indiquée dans l'Editeur d'état. Les données peuvent être tronquées ; reportez-vous aux exemples. (Cette option peut être considérée comme signifiant "contracter uniquement, ne pas développer".)
Développer	Indique que la dimension horizontale de l'objet augmente si les objets mis en forme ou les données qu'ils contiennent sont suffisamment larges, mais ne peut pas être réduite à une largeur inférieure à celle indiquée dans l'Editeur d'état. (Cette option peut être considérée comme signifiant "développer uniquement, ne pas contracter".)
Fixe	Indique que la largeur de l'objet est la même sur chaque page logique, quelle que soit la taille des objets ou des données qu'il contient. Les objets peuvent être tronqués. Reportez-vous aux exemples. La largeur de l'objet est définie comme étant sa largeur dans l'Editeur d'état.
Variable	Indique que l'objet peut se développer ou se contracter horizontalement en fonction des objets ou des données qu'il contient (sans espace supplémentaire), ce qui signifie que la largeur indiquée dans l'Editeur d'état est sans effet sur la largeur de l'objet lors de l'exécution.
Application  objets de présentation

Obligatoire/Facultatif  obligatoire

Valeur par défaut  est fonction de l'objet

Notes d'utilisation

•	Si vous créez dans votre état un objet graphique avec la propriété Elasticité horizontale et verticale définie à Fixe, Report Builder met l'écran à l'échelle en fonction des dimensions que vous avez définies pour l'objet.


Elasticité horizontale (champ) - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un champ offrant les caractéristiques suivantes :

Caractéristiques	Valeur
Largeur	1 pouce
Elasticité horizontale	Contracter
hauteur	1 pouce
Elasticité verticale	Fixe
 Cliquez ici.

Notez que lorsque les données ont moins d'un pouce de large, la taille du champ passe au minimum nécessaire pour contenir les données. Notez également que si les données ont plus d'un pouce de long, elles seront tronquées car le champ ne peut pas s'étendre verticalement ou horizontalement.


Elasticité horizontale (encadrement) - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un encadrement appelé M_1, offrant les caractéristiques suivantes :

Caractéristiques	Valeur
Elasticité horizontale	Variable
hauteur	7 pouces
Elasticité verticale	Fixe
Supposons en outre que la largeur de page que vous avez définie dans la fenêtre de propriétés de l'état soit de 8 pouces. M_1 contient un encadrement itératif dont l'unique champ s'appelle F_Ename. La première valeur de F_Ename a 4 pouces de large, la suivante 3 pouces, la suivante 4 pouces et la dernière 4 pouces. Le schéma ci-dessous illustre la façon dont l'encadrement peut être mis en forme :

 Cliquez ici.

Notez que les deux première instances du champ F_Ename s'impriment sur la première page logique, mais que les deux instances suivantes, en raison du manque de place sur la première page logique, s'impriment sur la deuxième. Notez également que si l'Elasticité horizontale était définie à Contracter ou Fixe, et non Variable, l'encadrement ne s'imprimerait que s'il pouvait tenir totalement sur une page logique.


propriété Objet solidaire
Objet solidaire

  Restrictions	  Exemples

Description  La propriété Objet solidaire permet d'indiquer si un objet et l'objet auquel il est ancré doivent être maintenus sur la même page logique. Cette propriété étant définie à Oui, si l'objet et/ou son objet d'ancrage ne peuvent pas tenir sur la page logique, ils passent à la page logique suivante.

Si vous définissez Objet solidaire à Oui pour un encadrement itératif, la première instance de l'encadrement itératif doit pouvoir tenir sur la même page que son objet d'ancrage. Sinon, la condition Objet solidaire n'est pas remplie. Si vous définissez Objet solidaire à Oui pour un objet de présentation autre qu'un encadrement itératif, l'objet doit pouvoir être mis en forme totalement sur la même page que son objet d'ancrage.

Le point d'ancrage entre deux objets peut être explicite ou implicite. Par conséquent, l'option Objet solidaire peut avoir une incidence même si vous n'avez pas explicitement créé de point d'ancrage entre les deux objets.

Application  objets de présentation

Obligatoire/Facultatif  facultatif

Valeur par défaut  Non


Objet solidaire - Exemple

  Rubriques connexes	  Tous les exemples

Soit trois objets standard :

 Cliquez ici.

B_2 et B_3 ont chacun la propriété Objet solidaire définie à Oui. Sur la page logique sur laquelle Report Builder tente d'abord d'imprimer ces objets, il y a suffisamment de place pour B_1 et B_2 mais pas pour B_3. Comme B_3 a la propriété Objet solidaire définie à Oui et que son objet d'ancrage est B_2, B_2 et B_3 passent à la page logique suivante. Comme B_2 a également la propriété Objet solidaire définie à Oui et que son objet d'ancrage est B_1, B_1 passe également à la page logique suivante.


Objet solidaire - Restrictions

•	La propriété Objet solidaire ne s'applique qu'à la première page logique sur laquelle le programme déclenche la mise en forme de l'objet. Cette propriété n'est pas prise en compte sur les pages suivantes.

•	Si le passage de l'objet et de son objet d'ancrage à la page logique suivante risque de laisser la page logique en cours vierge ou avec uniquement des objets répétés (par exemple, un en-tête de page), la propriété Objet solidaire n'est pas appliquée, pour éviter la présence de pages vierges superflues dans votre état.

•	Si l'objet d'ancrage est un encadrement itératif et si l'objet en cours se trouve en dehors de cet encadrement, l'objet d'ancrage fait référence à l'encadrement itératif considéré comme un tout (toutes les instances de l'encadrement itératif).

•	Si deux objets sont ancrés à leur encadrement englobant dont la propriété Elasticité verticale et/ou horizontale est définie à Contracter ou Variable, les trois objets doivent pouvoir être mis en forme sur la même page pour que la condition Objet solidaire soit remplie. Si les deux objets se trouvent dans un encadrement itératif et non dans un encadrement, cette règle s'applique à chaque instance de l'encadrement itératif. Sur la figure, B_1, B_2 et M_1 doivent tous pouvoir être mis en forme sur la même page pour que la condition Objet solidaire soit remplie.

 Cliquez ici.


Propriété Nom

  Restrictions

Description  La propriété Nom permet d'indiquer le nom que Report Builder utilise pour identifier l'objet en cours. Entrez un nom valide, d'un maximum de 30 octets.

Application  objets

Obligatoire/Facultatif  obligatoire

Valeur par défaut

texte standard	B_n, où n est un nombre unique parmi les noms de texte standard pour l'état.
objets bouton	U_n, où n est un nombre unique parmi les noms de champs de l'état.
objets graphique	D_n, où n est un nombre unique parmi les noms d'objets graphiques de l'état
colonnes de base de données	nom de la colonne tel qu'il figure dans l'instruction SELECT de l'interrogation SQL (affichage seul).
champs	F_n, où n est un nombre unique parmi les champs de l'état.
colonnes de formule	CF_n, où n est un nombre unique parmi les noms de formule de l'état.
encadrements	M_n, où n est un nombre unique parmi les noms d'encadrement de l'état.
interrogations	Q_n, où n est un nombre unique parmi les noms d'interrogation de l'état.
groupes	G_nom d'interrogation, où nom d'interrogation est le nom de l'interrogation et un nombre unique parmi les groupes. Si l'interrogation a un nom par défaut (par exemple, Q_1), le nom de groupe par défaut se présente sous la forme : G_n, où n est un nombre unique parmi les noms de groupe de l'état. Si le groupe n'est pas associé à une interrogation (c'est-à-dire un groupe inter-produit), le nom de groupe par défaut est aussi G_n.
objets matrice	X_n, où n est un nombre unique parmi les noms de matrice de l'état.
objets OLE2	B_n, où n est un nombre unique parmi les noms d'objet OLE2 de l'état.
paramètres	P_n, où n est un nombre unique parmi les noms de colonne de l'état. Si vous créez un paramètre en entrant une référence de lien dans votre interrogation, le nom que vous avez utilisé dans l'interrogation est le nom par défaut.
colonnes de réserve	CP_n, où n est un nombre unique parmi les noms de colonne de réserve de l'état.
encadrements itératifs	R_n, où n est un nombre unique parmi les noms d'encadrement itératif de l'état.
colonnes de tri	(Oracle Express uniquement) S_dimension, où dimension est le nom de la colonne de base de données à laquelle la colonne de tri fait référence.
colonnes récapitulatives	CS_n, où n est un nombre unique parmi les noms de colonne récapitulative de l'état.


Nom - Restrictions

•	Vous ne pouvez pas éditer le nom des colonnes de base de données.

•	Report Builder utilise le nom de la colonne, l'alias ou le texte de l'expression de l'interrogation comme nom par défaut d'une colonne de base de données.

•	Vous ne pouvez pas renommer des paramètres sytème.


propriété Saut de page après
Saut de page après

  Restrictions 	  Exemples

Description  La propriété Saut de page après permet d'indiquer que vous voulez que tous les fils de l'objet passent à la page suivante. En d'autres termes, tout objet qui est un fils d'un point d'ancrage (implicite ou explicite) à cet objet sera considéré comme si sa propriété Saut de page avant était définie à Oui. Notez que cela n'implique pas nécessairement que tous les objets sous celui dont la propriété Saut de page après a été définie passent à la page suivante.

Application  objets de présentation

Obligatoire/Facultatif  facultatif

Valeur par défaut  Non


Saut de page après - Restrictions

•	Saut de page après diffère uniquement la mise en forme des objets fils d'un objet. La mise en forme des objets ayant le même père immédiat n'est pas différée car il n'y a pas de hiérarchie (c'est-à-dire de relation père-fils) permettant à Report Builder de déterminer l'ordre de mise en forme des objets ayant le même père immédiat. Cela étant, un objet doit être ancré (implicitement ou explicitement) à un autre objet en tant que père pour que la propriété Saut de page après soit effective.

 Cliquez ici.

 Cliquez ici.

•	Pour les encadrements itératifs, la propriété Saut de page après définit un saut de page logique après l'encadrement itératif global. Pour avoir un saut de page après chaque instance de l'encadrement itératif, vous devez également définir la propriété Nbre max d'enregistrements par page à 1, dans la fenêtre de propriétés de l'encadrement itératif.

•	Les objets se trouvant sous un objet dont la propriété Saut de page après est définie à Oui peuvent ne pas passer à la page suivante. Si un objet n'est pas un fils de l'objet dont la propriété Saut de page après est définie à Oui, cet objet peut, s'il y a suffisamment de place, s'imprimer sur la même page que l'objet dont la propriété Saut de page après est définie à Oui.

 Cliquez ici.

•	Dans le cas d'un objet auquel aucun objet externe n'est ancré (implicitement ou explicitement), la propriété Saut de page après est sans effet.


propriété Saut de page avant
Saut de page avant

  Restrictions 	  Exemples

Description  La propriété Saut de page avant permet d'indiquer que vous voulez que l'objet soit mis en forme sur la page qui suit celle sur laquelle son impression a été déclenchée à l'origine. Notez que cela ne signifie pas obligatoirement que tous les objets se trouvant en dessous de l'objet dont la propriété Saut de page avant a été définie à Oui passeront à la page suivante.

Application  objets de présentation

Obligatoire/Facultatif  facultatif

Valeur par défaut  Non


Saut de page avant - Restrictions

•	Pour les encadrements itératifs, la propriété Saut de page avant définit un saut de page logique avant l'encadrement itératif global. Pour avoir un saut de page avant chaque instance de l'encadrement itératif, vous devez également définir à 1 la propriété Nbre max d'enregistrements par page, dans la fenêtre de propriétés de l'encadrement itératif.

•	Les objets se trouvant sous un objet dont la propriété Saut de page avant est définie à Oui peuvent ne pas passer à la page suivante. Si un objet doit par définition s'imprimer sur une page, mais passe à la suivante en raison de la propriété Saut de page avant, d'autres objets peuvent, s'il y a suffisamment de place, être placés à l'endroit où l'objet devait s'imprimer à l'origine.

 Cliquez ici.


propriété Protection pge
Protection pge

  Restrictions	  Exemples

Description  La propriété Protection pge permet d'indiquer si le programme doit tenter de maintenir tout l'objet et son contenu sur la même page logique. Si la propriété Protection pge est définie à Oui,, et si le contenu de l'objet ne peut pas tenir sur la page logique en cours, l'objet et la totalité de son contenu passeront à la page logique suivante.

Remarque : Si vous utilisez Protection pge, les objets se trouvant sous le ou les objets de la page protégée peuvent éventuellement apparaître au-dessus du ou des objets de la page protégée.

Application  objets de présentation

Obligatoire/Facultatif  facultatif

Valeur par défaut  Non


Protection pge (objet de petite taille) - Exemple

  Rubriques connexes 	 Tous les exemples

Vous avez créé un encadrement appelé M_1 avec un certain nombre de champs qui affichent des colonnes et des récapitulatifs. Pour faciliter la lecture, vous voulez que tous les champs de M_1 restent sur la même page logique afin que le lecteur puisse voir d'un même coup d'oeil les colonnes et leurs récapitulatifs.

Indiquez Protection pge pour M_1. Si M_1 et tous ses champs ne peuvent pas tenir sur la première page logique sur laquelle Report Builder tente de les imprimer, une tentative d'impression a lieu sur la page logique suivante

 Cliquez ici.

 Cliquez ici.


Protection pge (objet LOB) - Exemple

  Rubriques connexes 	 Tous les exemples

Vous avez créé un encadrement appelé M_1 avec un certain nombre de champs qui affichent des colonnes et des récapitulatifs. Pour faciliter la lecture, vous voulez que tous les champs de M_1 restent sur la même page logique afin que le lecteur puisse voir d'un même coup d'œil les colonnes et leurs récapitulatifs.

Indiquez Protection pge pour M_1. Si M_1 et tous ses champs ne peuvent pas tenir sur la première page logique sur laquelle Report Builder tente de les imprimer, une tentative d'impression a lieu sur la page logique suivante

Supposons en outre que M_1 et tous ses champs ne puissent pas tenir sur la deuxième page logique sur laquelle Report Builder tente de les imprimer. Une partie aussi importante que possible de M_1 sera imprimée sur la page logique, puis le reste sur la page logique suivante.


Protection pge (état de groupe) - Exemple

  Rubriques connexes 	 Tous les exemples

Vous avez un état de groupe et vous voulez que tous les détails et la partie maître apparaissent, si possible, sur la même page. Pour cela, vous indiquez Protection pge pour l'encadrement itératif maître (l'encadrement itératif extérieur). Si les détails et l'encadrement maître ne peuvent pas tenir sur la première page sur laquelle ils doivent s'imprimer, l'impression aura lieu sur la page suivante.


Protection pge - Restrictions

•	La propriété Protection pge s'applique uniquement à la première page logique sur laquelle la mise en forme de l'objet doit être déclenchée. Cette propriété n'est pas prise en compte sur les pages suivantes.

•	Pour les encadrements itératifs, Protection pge fait référence à chaque instance de l'encadrement itératif. Chaque instance de l'encadrement itératif et les objets qu'il entoure seront rendus solidaires par Protection pge. Seule exception  : Protection pge ne s'applique pas à la première instance d'une page autre que la première de l'encadrement itératif. Par exemple, dans le schéma ci-dessous, Protection pge s'applique aux instances 1, 2 et 4, mais non 3. L'instance 3 est la première à être mise en forme sur la seconde page de l'encadrement itératif. Notez que, dans ce cas, si la propriété Protection pge avait été appliquée à l'instance 3, elle aurait commencé sur la page 3 et non sur la page 2, ce qui aurait laissé la page 2 pratiquement totalement vierge.

 Cliquez ici.

•	La propriété Protection pge n'est pas prise en charge pour les encadrements itératifs qui font partie d'une matrice. Lorsque des encadrements itératifs sont liés par un objet de matrice, la définition de la propriété Protection pge est sans effet.

•	Si, lorsque vous faites passer l'objet et son contenu à la page logique suivante, la page logique en cours reste vierge ou ne contient que des objets répétés (par exemple, un en-tête de page), la propriété Protection pge n'est pas appliquée, ce qui évite la présence de pages vierges superflues dans votre état.

•	Si la propriété Protection pge déclenche le passage d'un objet à la page logique suivante lors de la mise en forme, un objet se trouvant le long de l'objet de la page protégée peut, ou non, être également déplacé. Si l'objet se trouvant le long de l'objet de la page protégée n'est pas ancré (implicitement ou explicitement) à un objet de la page protégée et que cet objet puisse tenir dans l'espace dans lequel l'objet de la page protégée ne peut pas tenir, l'objet est imprimé sur cette page logique. Sinon, il passe, avec l'objet de la page protégée, à la page logique suivante.


propriété Activation de l'impression de base
Activation de l'impression de base

  Rubriques connexes

Description  La propriété Activation de l'impression de base permet d'indiquer l'objet sur lequel fonder la propriété Activation de l'objet d'impression de l'objet en cours. Par exemple, si vous définissez Activation de l'objet d'impression à Tout et Activation de l'impression de base à Objet d'ancrage, l'objet en cours est imprimé sur chaque page logique sur laquelle apparaît son objet d'ancrage (objet père).

Valeurs

Objet d'ancrage	Indique l'objet père auquel l'objet en cours est ancré (implicitement ou explicitement).

Objet englobant	Indique l'objet qui entoure l'objet en cours.

Application  objets de présentation

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Objet d'ancrage


propriété Activation de l'objet d'impression
Activation de l'objet d'impression

  Restrictions	  Exemples	  Rubriques connexes

Description  La propriété Activation de l'objet d'impression permet d'indiquer la fréquence à laquelle vous voulez que l'objet apparaisse dans l'état. Les options de cette propriété indiquent la ou les pages logiques sur lesquelles l'objet doit s'imprimer par rapport à la propriété Activation de l'impression de base.

Remarque : Le fait que l'objet doive s'imprimer sur une page logique n'implique pas qu'il s'imprimera sur cette page logique. D'autres options (par exemple Saut de page avant) ou la place disponible sur la page peuvent imposer à Report Builder d'imprimer un objet sur une page autre que celle sur laquelle il devait initialement s'imprimer.

Lorsqu'il applique ces options, Report Builder considère que la première page d'un objet est la première page logique sur laquelle une partie de l'objet est imprimée. De même, la dernière page est considérée comme étant la dernière page logique sur laquelle une partie de l'objet est imprimée. Par exemple, si vous définissez la propriété Activation de l'objet d'impression à Première page et Activation de l'impression de base à Objet englobant, l'objet sera envoyé pour impression à la première page logique sur laquelle son objet englobant apparaît.

Valeurs

Tout	Indique que l'objet et tout son contenu seront imprimés sur toutes les pages logiques de l'objet Activation de l'impression de base. L'objet se répétera sur toutes les pages supplémentaires de l'objet Activation de l'impression de base et sera tronqué à la limite de page logique si nécessaire.
Tout sauf première page	Indique que l'objet et tout son contenu seront imprimés sur toutes les pages logiques de l'objet Activation de l'impression de base sauf la première page logique. L'objet ne sera mis en forme que sur les pages supplémentaires de l'objet Activation de l'impression de base et sera tronqué à la limite de page logique si nécessaire.
Tout sauf dernière page	Indique que l'objet et tout son contenu seront imprimés sur toutes les pages logiques de l'objet Activation de l'impression de base, sauf la dernière. L'objet sera répété sur les pages supplémentaires de l'objet Activation de l'impression de base sauf la dernière, et sera tronqué à la limite de page logique, si nécessaire.
*Par défaut	Signifie que Report Builder utilisera le positionnement des objets pour paramétrer l'option Activation de l'objet d'impression sur *Première page ou *Dernière page. (L'astérisque indique que Report Builder a défini le paramètre à votre place.)
Première page	Indique que l'objet et tout son contenu ne seront imprimés que sur la première page logique de l'objet Activation de l'impression de base. L'objet sera mis en forme et passera aux pages suivantes, si nécessaire.
Dernière page	Indique que l'objet et tout son contenu ne seront imprimés que sur la dernière page logique de l'objet Activation de l'impression de base. L'objet sera mis en forme après l'objet Activation de l'impression de base et passera aux pages suivantes, si nécessaire.
Application  objets de présentation

Obligatoire/Facultatif  obligatoire

Valeur par défaut  est fonction de l'objet


Activation de l'objet d'impression (Tout) - Exemple

  Rubriques connexes 	  Tous les exemples

Vous avez créé une colonne récapitulative, appelée Col_Sum, qui récapitule les valeurs d'une colonne d'un groupe appelé Group_1. Col_Sum est la source d'un champ (F_1) englobé dans un encadrement itératif (R_1), qui contient les valeurs de Group_1. Si vous définissez Activation de l'objet d'impression à Tout et Activation de l'impression de base à Objet englobant pour F_1, l'objet s'imprime à chaque instance de R_1 sur chaque page logique.


Activation de l'objet d'impression (débordement) - Exemple

  Rubriques connexes 	  Tous les exemples

 Cliquez ici.

Comme l'objet se trouve en dehors de l'encadrement itératif C, la définition d'Activation de l'impression de base de l'objet standard D fait référence à l'encadrement itératif pris dans son ensemble. Comme les objets se trouvent dans l'encadrement itératif, la définition de Activation de l'impression de base des objets standard A et B fait référence à chaque instance de l'encadrement itératif C.

L'objet D apparaît sur toutes les pages logiques sur lesquelles l'encadrement itératif C apparaît. Cependant l'objet A ne s'imprime que lorsqu'une instance de l'encadrement itératif C déborde. La définition de Activation de l'objet d'impression à Tout sauf la première page déclenche dans ce cas l'impression de l'objet sur chaque page logique de chaque instance de l'encadrement itératif, sauf la première page, sur laquelle s'imprime une instance.

Comme l'encadrement itératif C ne contient que deux objets (objets standard A et B), il ne passe à une seconde page que lorsque l'objet standard B déborde. Si vous vous référez à la définition de la propriété Activation de l'objet d'impression des objets A et B (Tout sauf première page et Première page), vous pourriez penser que ces deux objets n'apparaîtront jamais sur la même page. Cependant, dans ce cas, ils ne peuvent apparaître que sur la même page.


Activation de l'objet d'impression - Restrictions

Attention : Si le contenu d'un objet ne peut pas tenir dans la page logique sur laquelle il commence à s'imprimer, cet objet, dont la propriété Activation de l'objet d'impression est définie à Tout, Tout sauf première page ou Tout sauf dernière page, ne peut pas passer aux pages suivantes. Dans ce cas, le contenu de l'objet est tronqué et l'objet s'imprime, avec le même contenu tronqué, sur chaque page logique sur laquelle il doit s'imprimer.

•	Si le contenu d'un objet ne peut pas tenir dans la page logique sur laquelle il commence à s'imprimer, cet objet, dont la propriété Activation de l'objet d'impression est définie à Première page ou Dernière page, peut passer aux pages suivantes. Même s'il doit s'imprimer uniquement sur la première ou la dernière page, il peut donc déborder au-delà de la première ou de la dernière page. Dans ce cas, les définitions de la propriété Activation de l'objet d'impression à Première page et à Tout sauf dernière page ne sont pas obligatoirement mutuellement exclusives. Par exemple, si un objet a la propriété Activation de l'objet d'impression définie à Première page, et un autre à Tout sauf première page, et s'ils ont tous deux la même définition de la propriété Activation de l'impression de base, vous pourriez penser que ces deux objets ne pourront jamais apparaître sur la même page. Cependant, si l'objet dont la propriété est définie à Première page déborde sur la deuxième page, les deux objets peuvent apparaître sur la même page.

•	Un objet qui est implicitement ou explicitement ancré à l'encadrement itératif ou à l'encadrement qui l'entoure ne peut pas avoir sa propriété Activation de l'objet d'impression définie à Dernière page ou Tout sauf dernière page. Un objet qui est ancré à un autre objet situé dans son encadrement itératif ou son encadrement ne peut pas avoir la propriété Activation de l'objet d'impression définie à Dernière page ou Tout sauf dernière page, avec la propriété Activation de l'impression de base définie à Objet englobant.

 Cliquez ici.

•	Si la définition de la propriété Activation de l'impression de base d'un objet est un encadrement itératif qui entoure l'objet, l'objet fait référence à chaque instance de l'encadrement itératif auquel l'objet est ancré.

•	Si la définition de la propriété Activation de l'impression de base d'un objet est un encadrement et si l'objet se trouve à l'extérieur de l'encadrement itératif, l'objet fait référence à l'encadrement itératif considéré dans son ensemble. Par exemple, la propriété Activation de l'objet d'impression, définie à Première page, indique la première page logique sur laquelle l'encadrement itératif doit s'imprimer.

•	Lorsque la définition de la propriété Activation de l'impression de base fait référence à un encadrement itératif considéré dans son ensemble ou aux instances d'un encadrement itératif, la définition de la propriété Activation de l'objet d'impression fait toujours référence à des pages logiques. Supposons, par exemple, que la propriété Activation de l'impression de base d'un objet définisse un encadrement itératif et que l'objet se trouve en dehors de cet encadrement itératif. Dans ce cas, la propriété Activation de l'impression de base ne fera référence qu'aux instances de l'encadrement itératif. Cependant, Activation de l'impression de base définie à Première page ne signifie pas la première instance de l'encadrement itératif, mais la première page logique sur laquelle chaque instance de l'encadrement itératif doit s'imprimer.

•	Les objets se trouvant dans la région des marges sont relancés sur chaque page physique. Les définitions de la propriété Activation de l'objet d'impression ne sont donc pas toutes intéressantes pour les objets se trouvant dans les marges. Comme les objets sont relancés sur chaque page, tout se passe comme si vous étiez toujours sur la première page de l'objet. Première page équivaut donc à Tout. Dernière page et Tout sauf dernière page ne sont pas valides, car la "dernière" page n'est jamais atteinte. Si vous définissez Tout sauf première page, l'objet n'apparaît jamais, car il ne va jamais au-delà de la "première" page.


propriété Code d'imprimante avant
Code d'imprimante avant

  Restrictions	  Exemples

Description  Les codes d'imprimante sont des références à des séquences d'échappement d'imprimante qui définissent des instructions d'impression particulières (par exemple, la mise en évidence ou des tailles de police spéciales) pour l'objet. La propriété Code d'imprimante avant fait référence à la séquence qui doit être exécutée avant chaque ligne de l'objet. Ces séquences sont insérées après le déclenchement de l'impression de l'objet, mais avant l'impression effective.

Valeurs Entrez une référence de code d'imprimante valide d'un maximum de 256 octets. Les entrées peuvent se présenter sous la forme &nombre, où nombre est un nombre attribué soit à un code d'imprimante Report Builder en package, soit à un code d'imprimante que vous avez créé vous-même.

Application  objets de présentation

Notes d'utilisation

•	Dans la plupart des cas, vous devez pouvoir effectuer toutes les mises en forme spéciales en écrivant un code PL/SQL pour les objets de présentation.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET BEFORE PRINTING CODE.


propriété Code d'imprimante après
Code d'imprimante après

  Restrictions	  Exemples

Description Les codes d'imprimante sont des références à des séquences d'échappement d'imprimante qui définissent des instructions d'impression particulières (par exemple, la mise en évidence ou des tailles de police spéciales) pour l'objet. La propriété Code d'imprimante après fait référence à la séquence qui doit être exécutée après chaque ligne de l'objet. Ces séquences sont insérées après le déclenchement de l'impression de l'objet, mais avant l'impression effective.

Valeurs Entrez une référence de code d'imprimante valide d'un maximum de 256 octets. Les entrées peuvent se présenter sous la forme &nombre, où nombre est un nombre attribué soit à un code d'imprimante Report Builder en package, soit à un code d'imprimante que vous avez créé vous-même.

Application  objets de présentation

Notes d'utilisation

•	Dans la plupart des cas, vous devez pouvoir effectuer toutes les mises en forme spéciales en écrivant un code PL/SQL pour les objets de présentation.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET AFTER PRINTING CODE.


Code d'imprimante (police spéciale) - Exemple

  Rubriques connexes%!Alink(Printer Code After;Printer Code Before;cat_layoutmodel_examps, , , ) 	  Tous les exemples%!Alink(cat_examps,JUMP , , )

Dans votre fichier de définition d'imprimante, vous avez créé deux codes d'imprimante appelés &123 et &456. Le code &123 déclenche l'impression d'une police spéciale, alors que le code &456 déclenche l'impression de la police normale. Vous voulez, en outre, que tous les champs d'un encadrement itératif (R_1) soient imprimés avec la police spéciale. Vous pouvez soit utiliser le code d'imprimante pour chaque champ, soit l'utiliser pour tout l'encadrement itératif. Ce dernier cas est plus facile à créer et à actualiser.

Dans la fenêtre de propriétés de l'encadrement itératif R_1, entrez &123 comme Code d'imprimante avant, et &456 comme Code d'imprimante après. Lorsque R_1 est imprimé, le code d'imprimante est exécuté avant et après l'impression de chaque ligne de R_1.

 Cliquez ici.


Code d'imprimante - Restrictions

•	Les codes d'imprimante ne sont utilisés que lors de l'exécution de votre état en mode caractère, et non pour l'exécution en mode bitmap.


propriété Elasticité verticale
Elasticité verticale

  Restrictions 	  Exemples

Description  La propriété Elasticité verticale permet d'indiquer comment la dimension verticale de l'objet change, lors de l'exécution, en fonction des objets ou des données qu'il contient :

•	Pour les encadrements et les encadrements itératifs, l'élasticité indique si la taille de l'encadrement ou de l'encadrement itératif varie en fonction des objets qu'il contient.

•	Pour les objets contenant du texte, l'élasticité indique si le champ ou le texte standard varie en fonction de la taille du texte. Le texte de taille fixe passe à la ligne dans la taille définie pour l'objet et peut être tronqué s'il n'y a pas suffisamment de place. Les données numériques ou de date s'affichent sous la forme d'astérisques si les données ne peuvent pas tenir dans la taille indiquée.

•	Pour les images, les dessins et les objets graphiques, Report Builder utilise la mise à l'échelle proportionnelle. Les options d'élasticité des images, des schémas et des objets graphiques déterminent le facteur de mise à l'échelle.

 Cliquez ici.

Valeurs

Contracter	Indique que la dimension verticale de l'objet diminue si l'objet ou les données qu'il contient sont suffisamment petits, mais ne peut cependant pas atteindre une hauteur supérieure à celle indiquée dans l'Editeur d'état. Les données peuvent être tronquées ; reportez-vous aux exemples. (Cette option peut être considérée comme signifiant "contracter uniquement, ne pas développer".)
Développer	Indique que la dimension verticale de l'objet augmente si les objets mis en forme ou les données qu'ils contiennent sont suffisamment hauts, mais ne peut pas être réduite à une hauteur inférieure à celle indiquée dans l'Editeur d'état. (Cette option peut être considérée comme signifiant "développer uniquement, ne pas contracter".)
Fixe	Indique que la hauteur de l'objet est la même sur chaque page logique, quelle que soit la taille des objets ou des données qu'il contient. Les objets peuvent être tronqués. Reportez-vous aux exemples. La hauteur de l'objet est définie comme étant sa hauteur dans l'Editeur d'état.
Variable	Indique que l'objet peut se développer ou se contracter verticalement en fonction des objets ou des données qu'il contient (sans espace supplémentaire), ce qui signifie que la hauteur indiquée dans l'Editeur d'état est sans effet sur la hauteur de l'objet lors de l'exécution.
Application  objets de présentation

Obligatoire/Facultatif  obligatoire

Valeur par défaut  est fonction de l'objet

Notes d'utilisation

•	Si vous créez dans votre état un objet graphique avec la propriété Elasticité horizontale et verticale définie à Fixe, Report Builder met l'écran à l'échelle en fonction des dimensions que vous avez définies pour l'objet.


Elasticité verticale (Développer) - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un champ offrant les caractéristiques suivantes :

Caractéristiques	Valeur
Largeur	1 pouce
Elasticité horizontale	Fixe
hauteur	2 pouces
Elasticité verticale	Développer
 Cliquez ici.


Elasticité verticale (Variable) - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un encadrement, appelé M_2, offrant les caractéristiques suivantes :

Caractéristiques	Valeur
Largeur	5 pouces
Elasticité horizontale	Fixe
Elasticité verticale	Variable
Supposons en outre que la hauteur de page de l'état soit de 12 pouces. Etant donné la taille des objets qu'il contient, M_2 demande une hauteur verticale de 8 pouces pour la mise en forme. Un autre encadrement, appelé M_1, précède M_2 sur la page logique et occupe 6 pouces.

Le schéma ci-dessous illustre la façon dont l'encadrement peut être mis en forme :

 Cliquez ici.

Notez que M_2 ne peut pas tenir complètement sur la première page logique. Etant donné que la propriété Elasticité verticale est définie à Variable, les cinq premiers pouces de M_2 sont imprimés sur la première page logique, et les deux suivants sur la deuxième page logique. Si la propriété Elasticité verticale avait été définie à Fixe, M_2 se serait imprimé en totalité sur la deuxième page logique.


Elasticité verticale - Restrictions

Attention :  Si le contenu d'un objet dépasse la hauteur définie, son Elasticité verticale et horizontale détermine si le contenu déborde sur la page suivante ou est tronqué. Les images, les dessins et les objets graphiques ne peuvent pas passer à la page suivante. Pour plus de détails sur les images, les schémas et les affichages Graphics Builder, reportez-vous aux règles ci-dessous.

 Cliquez ici.

Informations complémentaires : Si vous voulez que vos données soient tronquées, utilisez la fonction SQL SUBSTR dans votre interrogation. Par exemple, si vous voulez uniquement les quatre premiers caractères d'une colonne, utilisez SUBSTR dans votre instruction SELECT pour extraire uniquement ces caractères de la base de données.

•	Lors de la mise en forme d'un objet, si la propriété Elasticité verticale est définie à Fixe, Report Builder ne met l'objet en forme sur une page logique que s'il y a suffisamment de place sur la page pour la totalité de l'objet.

•	Si la propriété Elasticité verticale est définie à Développer, Report Builder ne met en forme l'objet sur une page logique que s'il y a suffisamment de place sur la page pour contenir la hauteur définie pour l'objet (c'est-à-dire sa taille minimum). Si la mise en forme n'est pas complète, l'objet passe à la page suivante.

•	Si la propriété Elasticité verticale est définie à Variable ou Contracter, Report Builder met en forme une aussi grande partie de l'objet que possible sur la première page logique et, si nécessaire, termine la mise en forme de l'objet sur la ou les pages logiques suivantes.

•	Si un nombre est trop grand pour son champ, celui-ci affichera des astérisques (*) au lieu de la valeur. Pour que la valeur apparaisse, vous devez soit redimensionner l'objet, soit changer son élasticité pour Développer ou Variable.

•	Règles d'élasticité applicables aux objets (par exemple, aux champs ou au texte standard) contenant une image, un dessin ou un affichage Graphics Builder :

•	Si l'élasticité de l'objet de présentation est variable (c'est-à-dire si Elasticité verticale et Elasticité horizontale sont définies à Variable), le contenu apparaît de la même taille que dans la source (par exemple, le fichier source).

•	Si l'élasticité de l'objet de présentation est fixe (c'est-à-dire si Elasticité horizontale et Elasticité verticale sont définies à Fixe), le programme effectue une mise à l'échelle proportionnelle sur son contenu. Dans certains cas, cette opération peut déclencher l'apparition d'espaces vides ou "blancs" entre le contenu et le bord de l'objet. Par exemple, si un objet est fixe horizontalement et verticalement, et si l'image est trop grande pour l'objet, l'image ne remplira l'objet que dans une direction. Dans l'autre, l'image sera plus courte que l'objet. Pour éviter ce problème, vous pouvez soit changer l'élasticité (c'est-à-dire la définir horizontalement et/ou verticalement à Variable) soit redimensionner manuellement l'objet.

•	Si un objet contenant une image, un dessin ou un affichage Graphics Builder est Fixe dans une direction seulement, Report Builder tentera toujours de remplir l'objet à la dimension Fixe.

•	Si l'élasticité de l'objet est Contracter dans une direction et Fixe dans l'autre, son contenu risque d'être tronqué. Pour éviter que le contenu soit tronqué, vous pouvez soit modifier l'élasticité (c'est-à-dire définir l'élasticité horizontale et verticale à Variable) soit redimensionner manuellement l'objet.

•	Si l'élasticité de l'objet est Variable (c'est-à-dire si l'élasticité horizontale ou verticale est définie à Variable), et si l'objet ne peut pas tenir dans l'objet qui l'entoure (par exemple un encadrement ou la page logique), l'état fera une boucle sans fin (parce que l'objet ne pourra jamais être mis en forme).

•	Si une valeur à afficher dans la sortie de l'état dépend de la mise en forme de l'état, le champ ou l'objet standard qui affiche la valeur doit avoir les propriétés Elasticité verticale et Elasticité horizontale définies à Fixe (ce qui est parfois appelé système de référence dépendant des pages). Si l'élasticité n'est pas fixe, Report Builder la change en Fixe lors de l'exécution.

Un champ ayant pour Source &Total pages logiques constitue un cas typique de système de référence dépendant des pages. Le nombre total de pages logiques ne peut être déterminé que lorsque l'état est totalement mis en forme. Cependant Report Builder doit mettre le champ en forme avant la fin de l'état et ne peut pas attendre que celui-ci soit totalement mis en forme pour déterminer la taille à donner au champ. L'élasticité du champ doit donc être fixe, pour que Report Builder sache combien de place il doit lui réserver avant que sa valeur Source soit déterminée.

Des cas de référencement dépendant des pages, dans lesquels l'élasticité d'un objet standard ou d'un champ doit être fixe, car la valeur de source dépend de la mise en forme de l'état, sont décrits ci-dessous :

•	Si une colonne récapitulative a la propriété Remise à ou Calculer à définie à Page, le champ ou l'objet standard qui affiche sa valeur doit avoir une élasticité fixe.

•	Si une colonne de formule ou une colonne récapitulative dépend d'une colonne récapitulative dont la propriété Remise à ou Calculer à définie à Page, le champ ou l'objet standard qui affiche sa valeur doit avoir une élasticité fixe.

•	Si la source d'un champ est &Numéro de page logique, &Numéro d'écran, &Numéro de page physique, &Total pages logiques, &Total écrans ou &Total pages physiques, tout objet qui affiche le champ (soit le champ lui-même, soit un objet standard) doit avoir une élasticité fixe.

•	Si un champ a un numéro de page comme Source et si, dans la boîte de dialogue Numérotation de page, Remise à est un encadrement itératif, tout objet de présentation qui affiche sa valeur doit avoir une élasticité fixe.

Remarque : Si un champ contenant une référence dépendant des pages a la propriété Visible définie à Non, il peut avoir la propriété Elasticité horizontale définie à Variable, Développer ou Contracter. Tout objet standard qui fait référence au champ doit cependant avoir une élasticité fixe.


propriété Hyperlien
Hyperlien

  Restrictions 	  Rubriques connexes	  Exemples

Description  La propriété Hyperlien permet d'indiquer une spécification de lien URL qui affiche un document ou une destination dans un document lorsque l'utilisateur clique sur l'objet dans l'explorateur Web ou le visualiseur PDF.

Valeurs  Tout lien valide à :

•	une destination dans le document actuel (par exemple, #mon_nom_dest) ;

•	une destination dans un document local (par exemple, fichier:/privé/docpluriel.pdf#un_nom_dest) ;

•	un document sur la machine locale (par exemple, fichier:/privé/monnouvdoc.pdf ou fichier:///C|/temp/monnouvdoc.pdf) ;

•	un document sur une machine distante (par exemple, http://www.newmach.com/newdoc.pdf, http://www.newmach.com/newdoc.html, ftp://www.reposit.com/filetoget.example, http://www.somemch.com/cgi-bin/webmenu?choice1) ;

•	une destination dans un document distant (par exemple, http://www.newmach.com/newdoc.pdf#un_nom_dest).

Application  objets de présentation

Valeur par défaut  blanc

Notes d'utilisation

•	Si une propriété Hyperlien est indiquée pour un encadrement, elle sera transférée à tous les objets fils (intérieurs) dont la propriété Hyperlien n'est pas indiquée. Si la propriété ne peut pas être transférée aux objets fils, la valeur Hyperlien de l'encadrement est perdue.

•	Un état au format PDF peut comprendre à la fois des hyperliens et des liens de ligne de commande d'application. Si la propriété Ligne de commande d'application est définie pour un objet, elle lui sera appliquée. Sinon, la propriété Hyperlien est appliquée.

•	Si vous avez défini la propriété Hyperlien pour un objet inséré dans un encadrement, le fait de cliquer sur cet objet remplace, par défaut, l'encadrement par une fenêtre entière affichant la destination de l'hyperlien. Pour ne remplacer que l'encadrement, insérez les codes HTML suivants dans la valeur de la propriété Attributs d'hyperlien supplémentaire : target=nom_fichier, où nom_fichier correspond au nom de l'encadrement à remplacer.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET HYPERLINK.


Hyperlien - Restrictions

•	Pour suivre les liens Web entre un visualiseur PDF et un serveur distant ou un document HTML, il faut que la configuration du visualiseur PDF permette l'utilisation d'un explorateur Web (par exemple, configuré comme application d'aide ou installé comme module complémentaire dans votre visualiseur WEB).


Destination d'hyperlien

  Exemples

Description  La propriété Destination hyperlien est un identificateur d'objet unique, qui peut être utilisé comme destination d'un lien Web.

Valeurs  Tout nom unique valide, qui n'utilise que les 26 lettres de l'ASCII américain en majuscules et en minuscules, les nombres et les caractères de soulignement. Les autres caractères spéciaux seront automatiquement convertis en caractères de soulignement.

Application  objets de présentation

Obligatoire/facultatif  Obligatoire, si vous voulez définir une propriété Hyperlien pour un objet qui indique cet objet comme sa destination.

Valeur par défaut  blanc

Notes d'utilisation

•	Si une propriété Destination hyperlien est indiquée pour un encadrement, la propriété est transférée à l'objet visible le plus proche de l'angle supérieur gauche de l'encadrement.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET LINKTAG.


propriété Signet
Signet

  Restrictions 	  Exemples

Description  La propriété Signet permet d'indiquer un lien Web qui apparaît dans un cadre de signet du document HTML maître ou dans la zone de signet du visualiseur PDF. Cliquer sur le signet affiche l'objet associé dans la partie supérieure de la fenêtre.

Valeurs

Une chaîne de texte sans indentation/classement. Le signet apparaît dans la liste des signets en fonction du moment où l'objet est rendu par l'état.

Une chaîne de texte avec classement/indentation explicite de la forme x#nom_de_signet, où x est un numéro d'ordre. Le signe # et le numéro d'ordre n'apparaissent pas dans la fenêtre de signet, mais sont utilisés pour déterminer le classement et l'indentation.

Application  objets de présentation

Valeur par défaut  blanc

Notes d'utilisation

•	Si une propriété Signet est indiquée pour un cadre, la propriété est transférée à l'objet visible le plus proche de l'angle supérieur gauche de l'encadrement.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET_BOOKMARK.


Signet (avec mise en retrait et tri) - Exemple

  Rubriques connexes 	  Tous les exemples

1#Expense Summary Section
2#Expense Detail Section
2.1#Expenses for the Administration Department
2.2#Expenses for the Engineering Department
2.3#Expenses for the Sales Department
2.3.1#Expenses for the Eastern Sales Region
2.3.2#Expenses for the Northern Sales Region
2.3.3#Expenses for the Southern Sales Region
2.3.4#Expenses for the Western Sales Region


Signet - Restrictions

•	Si vous utilisez plusieurs fois le même numéro, toutes les entrées apparaissent, mais leur ordre est défini par le stade auquel les objets sont rendus par l'état.

•	S'il y a des "trous" dans les numéros, de deux choses l'une : si le trou se trouve entre des numéros de niveau pair, il n'y aura aucun effet visible (par exemple, 1.3.1 et 1.3.3, comme il n'y a pas de 1.3.2, apparaîtront côte à côte et au même niveau d'indentation). Si le trou se trouve entre un numéro de niveau supérieur à un numéro de niveau inférieur, les niveaux intermédiaires seront générés (par exemple, 1.1 suivi de 2.1.1 entraînera la définition des entrées factices 2 et 2.1, dont les titres seront identiques à ceux de l'entrée réelle suivante).


propriété Ligne de commande d'application (PDF)
Ligne de commande d'application (PDF)

  Restrictions 	  Exemples

Description  La propriété Ligne de commande d'application (PDF) permet d'indiquer une ligne de commande qui s'exécute sur la machine locale lorsque l'utilisateur clique sur l'objet (d'un document PDF) dans le visualiseur PDF .

Valeurs  Toute ligne de commande valide sur la machine locale (par exemple, c:\orawin\bin\rwrun60 userid=scott/tiger report=example.rdf or /usr/local/bin/phone smith)

Application  objets de présentation

Valeur par défaut  blanc

•	Un état au format PDF peut comprendre à la fois des hyperliens et des liens de ligne de commande d'application. Si la propriété Ligne de commande d'application est définie pour un objet, elle lui sera appliquée. Sinon, la propriété Hyperlien est appliquée.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET_PDF ACTION.


Ligne de commande d'application (PDF) - Restrictions

•	La propriété Ligne de commande d'application (PDF) n'est disponible que pour la sortie PDF.


Propriété Mise en forme conditionnelle
Mise en forme conditionnelle

  Rubriques connexes

Description  La propriété Mise en forme conditionnelle utilise les valeurs indiquées dans la boîte de dialogue Mise en forme conditionnelle pour définir la mise en forme de la sortie pour l'objet de présentation sélectionné lorsque la ou les conditions indiquées sont vraies (TRUE).

Application  objets de présentation

Obligatoire/facultatif  Facultatif


Propriété Nom d'affichage
Nom d'affichage

  Exemples

Description  La propriété Nom d'affichage consiste en un texte affiché dans une zone instantanée lorsque vous placez le curseur de la souris sur un objet image dans un état au format HTML ou HTMLCSS.

Valeurs  Chaîne de texte, limitée à 256 caractères.

Application  Objets image dans les états HTML.

Valeur par défaut  blanc

Notes d'utilisation

•	Lorsque vous générez un état au format HTML ou HTMLCSS, la valeur de la propriété Nom d'affichage est insérée dans la balise IMG à l'aide d'une balise HTML ALT.

•	Si un hyperlien a été défini sur cet objet image, vous pouvez également utiliser la propriété Attributs d'hyperlien supplémentaire pour générer une ligne d'informations dans la barre d'état.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET DISPLAY NAME.


Attributs d'hyperlien supplémentaire, propriété
Attributs d'hyperlien supplémentaire

  Exemples	  Rubriques connexes

Description  La propriété Attributs d'hyperlien supplémentaire définit des attributs HTML supplémentaires à appliquer au lien défini par la propriété Hyperlien.

Valeurs  Toute balise HTML valide pour le lien défini par la propriété Hyperlien.

Application  Objets de présentation comportant un lien défini par la propriété Hyperlien. Si aucun lien n'est défini, cette propriété n'a aucun effet.

Valeur par défaut  blanc

Notes d'utilisation

•	Si vous avez défini la propriété Hyperlien pour un objet inséré dans un encadrement, le fait de cliquer sur cet objet remplace, par défaut, l'encadrement par une fenêtre entière affichant la destination de l'hyperlien. Pour ne remplacer que l'encadrement, insérez les codes HTML suivants dans la valeur de la propriété Attributs d'hyperlien supplémentaire : target=nom_fichier, où nom_fichier correspond au nom de l'encadrement à remplacer.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET HYPERLINK ATTR.


Propriété Fin de la section de présentation
Fin de la section de présentation

Description  La propriété Fin de la section de présentation détermine l'endroit où la vue Aperçu interactif arrêtera la recherche des objets alignés. Cette propriété est principalement utilisée en mode caractère afin de restreindre l'étendue de la recherche des objets.

Valeurs

Oui	Signifie que la vue Aperçu interactif arrêtera la recherche des objets alignés à la fin du cadre.
Non	Signifie que l'Aperçu interactif recherchera tous les objets alignés dans la même direction.
Application  cadres

Obligatoire/Facultatif  obligatoire

Valeur par défaut  est fonction de l'objet


Ce schéma indique les points auxquels chaque code d'imprimante est appelé :


Ce schéma illustre la façon dont le champ peut se présenter lorsqu'il est mis en forme. Notez que le champ occupe toujours au moins 2 pouces de hauteur et 1 pouce de largeur. Si les données occupent plus de 1 pouce de largeur et 2 pouces de hauteur, le champ est agrandi en conséquence dans le sens de la hauteur.


Le tableau ci-dessous indique les combinaisons d'objets et d'options d'élasticité qui entraînent un dépassement de capacité et une troncation. (Dans le tableau Développée et Variable s'appliquent si l'élasticité horizontale ou verticale est Développée ou Variable)

Objet	Fixe/ Contracter	Développer	Variable
encadrement itératif	pas de dépassement	pas de dépassement	pas de dépassement
instances et encadrements
(contenu <= hauteur
définie)
encadrement itératif	pas de dépassement	dépassement si	dépassement si
instances et encadrements		ne tient pas	ne tient pas
(contenu > hauteur		sur la page	sur la page
définie)
champs et texte standard	pas de dépassement	pas de dépassement	pas de dépassement
(contenu <= hauteur
définie)
champs et texte standard	troncation**	dépassement si	dépassement si
(contenu > hauteur		ne tient pas	ne tient pas
définie)		sur la page	sur la page
* Pour éviter la troncation, définissez la propriété Elasticité verticale du champ ou du texte standard à

Variable et faites-les précéder et suivre d'un encadrement dont l'élasticité verticale est fixe.

Notez également qu'en cas de troncation du texte, celle-ci intervient lorsque

le texte standard ou le champ a été renvoyé à la ligne.


Ce schéma illustre une présentation et la sortie résultante.


 Notez comment B_Graph, qui apparaît sous R_Sal dans la présentation, finit par s'imprimer sur la page 1, au lieu de la page 2.


Dans ce schéma, la propriété Saut de page après est définie à Oui pour l'encadrement M_Dept. M_Dept et M_Emp ont une élasticité verticale et horizontale définies à Fixe. Dans ce cas, la propriété Saut de page après est sans effet car M_Dept et M_Emp sont des fils ayant le même père immédiat dans l'encadrement père M_Parent.


Dans ce schéma, la seule différence avec le cas précédent est que M_Dept est explicitement ancré à M_Emp comme père. Dans ce cas, la propriété Saut de page après diffère la mise en forme de M_Emp, car M_Dept est le père de M_Emp


Sur ce graphique, B_Graph qui apparaît sous R_Sal dans la présentation, finit par s'imprimer sur la page 1 avec R_Sal, parce que B_Graph n'est pas un fils de R_Sal. Si vous aviez explicitement ancré B_Graph comme fils de R_Sal, B_Graph serait apparu sur la page 2 et non sur la page 1.


Propriétés de colonne de base de données

  Restrictions

Ordre de ventilation

Type de colonne

Commentaire

Contient balises XML

Nom de colonne de base de données

Type de données

Exclure de la sortie XML

Format de fichier

Nom

Lecture depuis fichier

Valeur si Null

Largeur

Balise XML

Attributs de balise XML


Colonne de base de données - Restrictions

•	Seul Report Builder peut créer des colonnes de base de données (à raison d'une colonne par élément dans les listes SELECT de vos interrogations). Pour créer une colonne de base de données, vous devez l'ajouter à la liste SELECT de votre interrogation. La colonne de base de données est alors créée automatiquement par Report Builder.

•	Les colonnes de base de données ne peuvent être supprimées que par suppression de l'élément associé dans la liste SELECT.


Propriétés de champ

  Rubriques connexes 	  Restrictions

Attributs d'hyperlien supplémentaire

Ligne de commande d'application (PDF)

Activation de l'impression de base

Signet

Commentaires

Contient balises HTML

Masque de format

Déclencheur de format

Elasticité horizontale

Hyperlien

Destination hyperlien

Objet solidaire

Nbre min de lignes veuves

Nom

Saut de page après

Saut de page avant

Numérotation de page

Protection pge

Activation de l'objet d'impression

Code d'imprimante après

Code d'imprimante avant

Source

Type de données source

Elasticité verticale

Visible


Champ - Restrictions

•	La taille maximum du texte d'un champ est de 64 Ko de texte par paragraphe. Cette limite est fonction de votre système d'exploitation.

•	Le contenu des champs passe à la ligne suivante aux frontières de mot, c'est-à-dire aux espaces, tirets et tabulations. Les autres signes de ponctuation sont considérés comme étant le dernier caractère du mot qu'ils suivent. Les caractères de changement de ligne du contenu du champ imposent le passage à la ligne suivante. Il n'y a pas de limite au nombre de lignes qui peuvent être créées.

•	Dans la vue Modèle de présentation, un champ doit être placé dans un encadrement itératif dont le groupe source est le groupe (ou un descendant du groupe) qui contient la colonne source du champ. Si la source d'un champ est un récapitulatif appartenant à un groupe intrer-produit, le champ doit être placé dans l'ensemble des encadrements itératifs dont les sources sont les groupes Product Order de la colonne récapitulative.

•	Un champ doit se trouver devant l'encadrement itératif qui le contient.

•	Si un nombre est trop grand pour son champ, celui-ci affichera des astérisques (*) au lieu de la valeur. Pour que la valeur apparaisse, vous devez soit redimensionner l'objet, soit changer son élasticité pour Développer ou Variable.


propriété Type de données source
Type de données source

Description  La propriété Type de données source est indiquée par un champ en lecture seule qui affiche le type de données de la source du champ.

Application  champs

Notes d'utilisation

•	Un champ dont le type de données est Long, Long Raw ou Raw est considéré comme un champ de texte, à moins que vous n'indiquiez un autre type dans le champ Format de la palette de propriétés de la colonne.


propriété Masque de format
Masque de format

 Syntaxe de masque de format	  Restrictions 	  Exemples

Description  La propriété Masque de format permet de définir la façon dont vous voulez afficher les valeurs de date et de nombre dans le champ. Vous pouvez entrer des masques personnalisés pour les nombres et les dates ou en sélectionner dans la liste de valeurs. Les valeurs de type caractère n'ont pas de masque de format.

Les valeurs affichées au départ dans la liste sont déterminées par le type de données du champ (par exemple, pour un champ de type Number, seuls les masques de nombre sont indiqués dans la liste. Si vous entrez, pour Masque de format, un masque qui ne figure pas dans la liste et que vous validiez la palette de propriétés du champ, le nouveau masque de format apparaît dans la liste de valeurs.

Valeurs  Tout masque de format de nombre ou de date valide, d'un maximum de 1 Ko. Si la propriété est laissée en blanc, Report Builder met les valeurs en forme en fonction du type de données de la source du champ.

Application  champs

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc

Notes d'utilisation

•	Si vous laissez ce champ en blanc et que le type de données de la source du champ soit Date, le masque de format est le masque par défaut de votre langue (par exemple, aux Etats-Unis, 'JJ-MOI-AA') ; si le type de données de la source du champ est Number, les valeurs sont mises en forme en fonction de la largeur de la source (voir le tableau ci-après).

 Cliquez ici.

Ce comportement par défaut est le même que dans SQL*ReportWriter, version 1.1.

•	Les masques de format personnalisés ne sont valides que pendant la session Report Builder en cours. Si vous quittez Report Builder, puis l'appelez à nouveau, la liste de valeurs du champ Masque de format ne contient pas les masques de format que vous avez créés au cours de la précédente session de Report Builder (à moins que vous n'ouvriez les états qui utilisaient ces masques). Pour inclure des masques dans la liste qui sera utilisée d'une session à l'autre, utilisez Editer masques dans la boîte de dialogue Options d'outils (Outils --> Préférences).

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET FORMAT MASK.


Syntaxe des masques de format de date et d'heure

Les tableaux ci-après décrivent les masques de format de date et d'heure,ainsi que les suffixes que vous pouvez y ajouter.

Masque de format	Explication
SCC ou CC	Siècle, en abrégé; "S" fait précéder "BC" d'un signe moins (-)
SYYYY ou YYYY	Année ; "S" fait précéder la date "BC" d'un signe moins (-)
I ou IY ou IYY	1, 2 ou 3 chiffres de l'année
Y ou YY ou YYY	1, 2 ou 3 chiffres de l'année
Y,YYY	Année avec virgule
SYEAR ou YEAR	Année, en toutes lettres; "S" fait précéder la date "BC" d'un signe moins (-)
RRRR ou SRRRR	Année ; "S" fait précéder la date "BC" d'un signe moins (-)
RR	2 derniers chiffres de l'année
BC, AD, ou B.C., A.D.	Indicateur du siècle
Q	Trimestre (janvier-mars=1er trimestre)
MM	Mois, exprimé en chiffres (janvier = 01)
MONTH ou MON	Nom du mois, ou abrégé en trois lettres
WW, IW	Semaine de l'année
W	Semaine (calendrier julien)
J	Jour (calendrier julien) ; nombre de jours depuis le 1er janvier -4712
DDD, DD, ou D	Jour de l'année, mois ou semaine
DAY	Jour de la semaine en toutes lettres (LUNDI)
DY	Nom du jour, ou abrégé en trois lettres (LUN)
AM, PM, ou A.M., P.M.	Indicateur du méridien
HH ou HH12	Heure (1 à 12)
HH24	Heure du jour (0 à 23)
MI	Minute
SS; SSSSS	Seconde de minute; secondes de journée
FM	Changement de mode de remplissage qui remplace les blancs multiples avant ou entre les dates, les nombres ou les mots par un seul espace
Les suffixes qui peuvent être ajoutés aux masques de format sont les suivants :

Suffixe	Explication
TH	Nombre avec suffixe ("DDth" pour "4th")
SP	Nombre en toutes lettres ("DDSP" pour "FOUR")
SPTH ou THSP	Numéro en toutes lettres et avec suffixe ("DDSPTH" pour "FOURTH")


Syntaxe des masques de format de nombre

Les sèmes que vous pouvez utiliser pour créer un masque de format de nombre sont décrits ci-après :

Sème de format	Explication
0	Imprime un chiffre.
N	Imprime un chiffre, sauf s'il s'agit d'un zéro de gauche, à gauche du séparateur décimal, ou d'un zéro de fin à droite du séparateur décimal.
*	Imprime un chiffre, sauf s'il s'agit d'un zéro de gauche, à gauche du séparateur décimal, cas dans lequel un astérisque (*) est imprimé. Les zéros de droite, à droite du séparateur décimal, sont imprimés.
9	Imprime un chiffre, sauf s'il s'agit d'un zéro de gauche, à gauche du séparateur décimal, cas dans lequel un espace est imprimé. Les zéros de droite, à droite du séparateur décimal, sont imprimés.
+	Imprime un signe plus (+) avant les valeurs positives et un signe moins (-) avant les valeurs négatives. Ce sème doit précéder le masque.
-	Imprime un signe moins (-) pour les valeurs négatives et rien pour les valeurs positives. Ce sème doit précéder les autres sèmes.
MI	Imprime un signe moins (-) après les valeurs négatives et un espace après les valeurs positives. Ce sème doit suivre les autres sèmes.
S	Imprime un signe moins (-) pour les valeurs négatives et un signe plus (+) pour les valeurs positives (lorsque le S apparaît dans le masque). Ce sème doit précéder ou suivre les autres sèmes.
PR	Imprime des chevrons (<>) de part et d'autre des valeurs négatives et des espaces de part et d'autre des valeurs positives. Ce sème doit suivre les autres sèmes.
( )	Imprime des parenthèses autour des valeurs négatives et des espaces autour des valeurs positives. Les parenthèses doivent précéder et suivre les autres sèmes
DB	Imprime le signe "DB" après les valeurs positives. Ce sème doit suivre les autres sèmes.
CR	Imprime le signe "CR" après les valeurs négatives. Ce sème doit suivre les autres sèmes.
Y	N'imprime aucun symbole de signe pour les valeurs positives ou négatives.
V	Multiplie le nombre par 10N, où N est le nombre de sèmes 0, 9, * et S qui figurent à droite du V.
EEEE	Imprime le nombre en notation scientifique. Tous les sèmes de chiffres font référence à des chiffres de la mantisse. Il doit y avoir exactement un chiffre à gauche du séparateur décimal (affiché ou implicite). Le sème EEEE est imprimé sous la forme E suivi d'un signe plus (+), si l'ordinal est positif ou nul, et d'un signe moins (-) si l'ordinal est négatif, et de deux chiffres représentant l'ordinal (par exemple, E-99).
"string"	Imprime la chaîne entre guillemets. Pour avoir des guillemets à l'intérieur de la chaîne, tapez des guillemets dos à dos ("").
. (period)	Imprime un point (.) pour séparer la partie entière de la partie décimale d'un nombre.
D	Imprime le caractère décimal local séparant la partie entière de la partie décimale d'un nombre.
, (comma)	Imprime une virgule (,) comme séparateur de groupe/des milliers.
G	Imprime le séparateur local de groupe/des milliers.
$	Imprime $.
L	Imprime le symbole monétaire local.
C	Imprime le symbole monétaire ISO.
%	Imprime %.
" "	Imprime un blanc (n'entrez pas de guillemets dans un masque).
B	Imprime un blanc pour toutes les valeurs nulles, quels que soient les autres sèmes.
K	Imprime un blanc.
<>	Délimite le début et la fin de la région alignée sur le séparateur décimal (c'est-à-dire de la partie du nombre que vous voulez aligner sur le séparateur décimal dans le masque de format). Les chevrons indiquent que le nombre doit toujours occuper le même espace. Si nécessaire, les valeurs sont remplies de blanc à gauche ou à droite du séparateur décimal.
RN, rn	Imprime les valeurs en chiffres romains majuscules ou minuscules, respectivement. Vous ne pouvez pas entrer d'autres sèmes avec celui-ci.


Masques de format - Exemples

  Rubriques connexes 	  Tous les exemples

Exemple de masques de format :

Exemple de format de date	Date affichée
MM/DD/YY	03/04/85
DD MON YYYY	04 MAR 1985
Mon. DD, YYYY	Mar. 4, 1985
Day Month DD fmHH:MI AM	Monday March 4 11:35 AM
Dy Mon ddth fmHH24:MI:SS	Mon Mar 4th 23:35:22
Day "the" ddthsp "of" Month	Monday the fourth of March
Exemple de format de nombre	Nombre (Number)	Valeur affichée
-0000	7934	"7934"
	-7934	"-7934"
-00000	7934	"07934"
-NNNN	7639	"7639"
	535	"535"
-NNN	7639	"****"
-****	7902	"7902"
-*****	7902	"*7902"
+NNNN	100	"+100"
	-99	"-99"
(NNNN)	1600	" 1600 "
	-800	"(800)"
NNNNPR	1600	" 1600 "
	-800	"<800>"
NNNNMI	1600	"1600 "
	-800	"800-"
NNNVNN	343	"34300"
N.NNEEEE	7369	"7.37E+03"
"SRW"-0000	7782	"SRW7782"
-$NNNN.NN	800	"$800"
	1600	"$1600"
-%NNN	10	"%10"
-NN NNN.NN	3000	"3 000"
+KKNNNNN.00	1950	"+  1950.00"
	900	"+   900.00"
$<NNNNN.00>	1200	"$  1200.00"
	500	"$   500.00"
$<NNNNN.00> DB	1200	"$  1200.00 DB"
	-500	"$   500.00"
$<NNNNN.00> CR	1200	"$  1200.00"
	-500	"$   500.00 CR"
* Les guillemets n'apparaîtront pas à la sortie. Ils sont utilisés dans ces exemples pour indiquer clairement où se situent les blancs de début ou de fin.


Masques de format - Restrictions

•	Pour les masques de format de nombre, si la valeur réelle est plus longue que le masque de format indiqué, elle apparaît sous la forme d'une chaîne d'astérisques (*) dans la sortie de l'état, quelle que soit la largeur du champ. Par exemple, si un champ fixe a une largeur de 8, et si la valeur est 1234567 et le masque de format <NNNNNN>, votre sortie imprimée se présentera sous la forme *******.

De même, si à la suite de l'application du masque de format de nombre la valeur est supérieure à la largeur du champ, la valeur sera remplacée par des étoiles. Par exemple, si le champ fixe a une largeur de 6, et si la valeur est 1234, et le masque de format -99999999, votre sortie imprimée se présentera sous la forme ******, parce que le sème de format 9 imprime un blanc pour les zéros de gauche, à gauche du séparateur décimal. La valeur est donc trop longue pour être affichée dans un champ de largeur 6.

•	Si vous n'indiquez pas de sème de signe dans le masque de format, les valeurs positives sont précédées d'un espace et les valeurs négatives d'un signe moins (-). Ce comportement diffère du comportement par défaut de SQL*ReportWriter version 1.1. Si vous indiquez Y comme sème de masque de format, le comportement par défaut est celui de la version 1.1.

•	Lorsque vous créez un masque de format, il n'apparaît dans la liste de valeurs que s'il convient au type de données de la Source, c'est-à-dire que les masques de format des nombres s'affichent lorsque la source est un nombre et les masques de format des dates s'affichent lorsque la source est une date.

•	Les masques de format qui impriment des espaces pour les zéros (par exemple, 9) augmentent le nombre d'octets qu'occupe votre sortie sur chaque page.


propriété Visible
Visible

  Restrictions 	  Exemples

Description  La propriété Visible permet d'indiquer si le champ doit, ou non, être mis en forme. Si elle est définie à Non, le champ est masqué (c'est-à-dire non mis en forme). Cette propriété est utilisée pour les champs auxquels vous ne voulez faire référence que dans le texte standard. Les champs masqués sont souvent utilisés pour les états de lettres types, dans lesquels les champs sont référencés dans l'objet de texte standard.

Application  champs

Obligatoire/Facultatif  facultatif

Valeur par défaut  Oui

Notes d'utilisation

•	Une référence à un champ masqué peut apparaître n'importe où dans un texte standard. Si vous voulez placer la référence du champ à côté d'un autre texte sans espace entre, faites précéder et suivre Nom de champ de chevrons (par exemple, &<nomdechamp>Kg). Sinon, Report Builder considère que tout le texte entre la perluète et l'espace suivant fait partie du nom du champ. Notez cependant que vous pouvez entrer des références les unes à côté des autres, sans espace et sans chevrons (par exemple, &champ1& champ2& champd3).


Référence à un champ masqué - Exemple

  Rubriques connexes 	  Tous les exemples

Vous créez un état de style lettre type et souhaitez insérer dans la lettre le nom, l'adresse et le numéro de téléphone du destinataire. Vous créez un champ appelé NOM1 pour le nom du destinataire, un champ ADRESSE pour l'adresse et un champ TEL pour le numéro de téléphone. Comme ces champs ne doivent apparaître que dans le texte standard, vous sélectionnez Non. Dans le texte standard où vos voulez que ces valeurs apparaissent, insérez les références suivantes :

Monsieur &NOM1,

D'après nos dossiers, votre adresse et votre numéro de téléphone sont

les suivants :

&ADRESSE

&TEL

Dans la sortie, la lettre se présentera de la manière suivante :

Monsieur J. Smith,

D'après nos dossiers, votre adresse et votre numéro de téléphone sont

les suivants :

23, avenue du Moulin

92200 GARCHES

415-363-1234


Champ masqué - Restrictions

Les propriétés et les attributs d'un champ masqué, appliqués aux références au champ masqué, sont les suivants :

•	Sélections de menu de format (Police, Taille, Poids, Style, Justification)

•	Taille horizontale

•	Masque de format

•	Attributs de numérotation de page (dans la boîte de dialogue de numérotation de page)

•	Déclencheur de format


propriété Numérotation de page
Numérotation de page

  Restrictions 	  Exemples

Description  La propriété Numérotation de page permet de déterminer le mode de calcul des numéros de page pour les champs dont la source est &Numéro de page physique, &Total pages physiques, &Numéro de page logique ou &Total pages logiques.

 Cliquez ici.

Remarque : Les définitions de chaque page sont basées sur la page logique ou physique indiquée par la source du champ.


Numérotation de page (corps du document) - Exemple

  Rubriques connexes 	  Tous les exemples

Supposons que vous vouliez numéroter les pages physiques de la section principale de votre état :

1	Créez un champ intitulé F_PAGE et définissez sa propriété Source sur Numéro de page physique.

2	Dans la palette de propriétés du champ F_PAGE, définissez la propriété Numérotation de page en remplissant la boîte de dialogue correspondante de la manière suivante :

•	Cochez Section principale et désélectionnez Section d'en-tête et Section de fin, car vous voulez uniquement numéroter les pages de la section principale.

•	Entrez 1 dans Commencer à.

•	Entrez 1 dans Augmenter de.

•	Entrez &Etat sous Remise à, puisque vous voulez numéroter toutes les pages de la section principale de manière consécutive.

3	Positionnez enfin F_PAGE dans la vue Modèle de présentation.


Numérotation de page (« Page n de m ») - Exemple
Numérotation de page ("Page n de m") - Exemple

  Rubriques connexes 	  Tous les exemples

Supposons que vous vouliez que le numéro de page soit imprimé en haut de chaque page de votre état et qu'il se présente sous la forme "Page n de m" :

1	Créez un champ intitulé F_PAGE et définissez sa propriété Source sur Numéro de page physique.

2	Dans la palette de propriétés du champ, définissez la propriété Numérotation de page en remplissant la boîte de dialogue correspondante comme suit :

•	Cochez Section principale et désélectionnez Section d'en-tête et Section de fin, car vous voulez uniquement numéroter les pages de la section principale.

•	Entrez 1 dans Commencer à.

•	Entrez 1 dans Augmenter de.

•	Entrez &Etat sous Remise à, puisque vous voulez numéroter toutes les pages de la section principale de manière consécutive.

3	Créez un champ appelé F_TOTPGE et définissez sa propriété Source sur le nombre total de pages physiques.

4	Effectuez l'une des opérations suivantes :

•	Masquez ces champs (en définissant la propriété Visible sur Non) et faites-y référence dans le texte standard :

Page &F_PAGE de &F_TOTPGE

•	Vous pouvez également positionner F_PAGE et F_TOTPGE l'un à côté de l'autre. Insérez le texte standard à gauche de F_PAGE qui contient le texte "Page", et insérez entre F_PAGE et F_TOTPGE le texte standard qui contient le texte "de".


Numérotation de page (instances d'encadrement itératif) - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un encadrement itératif (R_1) avec des instances qui occupent plusieurs pages. Vous voulez numéroter les pages physiques correspondant à chaque instance et vous voulez également que le numéro de page soit sous la forme "Page n de m" :

1	Créez un champ intitulé F_PAGE et définissez sa propriété Source sur Numéro de page physique.

2	Dans la palette de propriétés du champ F_PAGE, définissez la propriété Numérotation de page en remplissant la boîte de dialogue correspondante de la manière suivante :

•	Cochez Section principale et désélectionnez Section d'en-tête et Section de fin, car vous voulez uniquement numéroter les pages de la section principale.

•	Entrez 1 dans Commencer à.

•	Entrez 1 dans Augmenter de.

•	Entrez &R_1 sous Remise à, puisque vous voulez remettre à zéro le numéro des pages à chaque instance de l'encadrement itératif.

3	Créez un champ appelé F_TOTPGE et définissez sa propriété Source sur le nombre total de pages physiques.

4	Dans la palette de propriétés du champ F_TOTPGE, définissez la propriété Numérotation de page en remplissant la boîte de dialogue correspondante comme suit :

•	Entrez &R_1 sous Remise à, puisque vous voulez remettre à zéro le numéro des pages à chaque instance de l'encadrement itératif.

5	Définissez la condition d'impression de F_PAGE et de F_TOTPGE de manière à ce qu'ils s'impriment sur toutes les pages logiques de R_1 :

•	Définissez le type de condition d'impression sur Tout.

•	Définissez l'objet de condition d'impression sur Objet englobant.

6	Effectuez l'une des opérations suivantes :

•	Masquez ces champs (en définissant la propriété Visible sur Non) et créez dans R_1 un objet de texte standard comportant le texte suivant :

Page &F_PAGE de &F_TOTPGE

•	Vous pouvez également positionner F_PAGE et F_TOTPGE l'un à côté de l'autre, dans R_1, en utilisant la vue Modèle de présentation. Insérez le texte standard à gauche de F_PAGE qui contient le texte "Page", et entre F_PAGE et F_TOTPGE le texte standard qui contient le texte "de".


Numérotation de page - Restrictions

Si la valeur Remise à est un encadrement itératif, le champ ne doit pas apparaître sur les pages sur lesquelles l'encadrement itératif n'apparaît pas. Comme la valeur du champ est déterminée par l'encadrement itératif, le résultat sera imprévisible sur les pages où l'encadrement itératif ne figure pas. Pour éviter ce problème, vous pouvez exécuter une des opérations suivantes :

•	Placer le champ dans l'encadrement itératif auquel sa valeur est réinitialisée. Dans ce cas, le champ n'apparaît que lorsque l'encadrement itératif apparaît.

•	Créer un déclencheur de format pour le champ, de sorte qu'il ne sera affiché que sur les pages où sa valeur est intéressante, c'est-à-dire celles sur lesquelles apparaît une instance de l'encadrement itératif.

De même, si le champ ne se trouve pas dans l'encadrement itératif concerné par la réinitialisation, et si plusieurs instances apparaissent sur la même page, Report Builder ne peut pas déterminer la valeur du champ et les résultats sont, là aussi, imprévisibles. Pour éviter ce problème, vous pouvez exécuter une des opérations suivantes :

•	Placer le champ dans l'encadrement itératif auquel sa valeur est réinitialisée.

•	Définir Nombre maximum d'enregistrements par page à 1 pour l'encadrement itératif sur lequel la valeur du champ est réinitialisée.


Propriété Source
Source

  Restrictions 	  Exemples

Description  La propriété Source permet d'indiquer l'endroit duquel le champ extrait sa valeur (généralement, une colonne ou un paramètre).

Remarque : Si Source est une valeur de numéro de page(par exemple, &Numéro de page logique), vous pouvez sélectionner Numérotation de page pour contrôler la numérotation.

Valeurs  Tout nom de colonne ou de paramètre valide.

&Date en cours	Date du système d'exploitation au moment de l'exécution de l'état, après la fin de la Grille des paramètres d'exécution.
&Numéro de page logique	Numéro de la page en cours, en fonction de la numérotation de la sortie par pages logiques.
&Numéro de fenêtre	Numéro de la fenêtre en cours dans la page logique.
&Numéro de page physique	Numéro de la page en cours, en fonction de la numérotation de la sortie par pages physiques.
&Total pages logiques	Nombre total de pages, en fonction de la numérotation de la sortie par pages logiques.
&Total fenêtres	Nombre total de fenêtres d'une page logique.
&Total pages physiques	Nombre total de pages, en fonction de la numérotation de la sortie par pages physiques.
Application  champs

Obligatoire/Facultatif  obligatoire


Source - Exemple

  Rubriques connexes 	  Tous les exemples

Supposons que le modèle de données de votre état se présente comme celui de la figure. Supposons, en outre que G_Dept est la source de l'encadrement itératif R_Dept et G_Emp la source de l'encadrement itératif R_Emp.

 Cliquez ici.


Source - Restrictions

•	Si un champ se trouve dans un encadrement itératif, la colonne utilisée comme source doit être dans le même groupe de source - ou dans un ancêtre du groupe de source - de l'encadrement itératif qui entoure le champ.

La figure ci-dessous représente une arborescence de groupe. Si le groupe source de l'encadrement itératif est 6, le champ Source peut être 1, 3 ou 6. Si le champ n'est pas entouré d'un encadrement itératif, la colonne doit être une colonne de niveau Etat, c'est-à-dire doit appartenir à l'état.

 Cliquez ici.

•	Si, pour une colonne, Remise à est défini à Page, les champs qui utilisent la colonne comme source  doivent se trouver dans des encadrements itératifs qui utilisent le groupe de la colonne comme source. En outre, les objets de texte standard qui font référence aux champs doivent également se trouver dans des encadrements itératifs qui utilisent le groupe de la colonne comme source.

•	Si vous indiquez une source pour un champ, puis supprimez cette source de votre état (c'est-à-dire si vous créez une colonne récapitulative, en indiquant qu'elle est la source d'un champ, puis supprimez cette colonne récapitulative), votre champ n'a plus accès aux données à afficher, et *INDEFINI* apparaît dans le champ Source.

•	Si la source d'un champ est &Numéro de page logique, &Numéro de fenêtre , &Numéro de page physique, &Total pages logiques, &Total fenêtres ou &Total pages physiques, tout objet de présentation qui affiche le champ (soit le champ lui-même, soit un objet de texte standard) doit avoir une taille fixe.

•	Un champ ne peut pas avoir comme Source Son ou Vidéo.


Le tableau ci-après illustre la mise en forme des valeurs numériques en fonction de la largeur de la source du champ.

Valeur	Largeur de la source	Sortie affichée
9.99999	4	10.0
9.99999	3	10.
9.99999	2	10
9.99999	1	*
-9.99999	4	-10.
-9.99999	3	-10
-9.99999	2	**
400	2	**
4.563	5	4.563
4.563	4	4.56
4.563	3	4.6
0.001	5	.001
0.001	4	.001
0.001	3	.00
0.001	2	.0
0.001	1	.
-0.01	4	-.01
-0.01	3	-.0
-.01	2	-.


La figure illustre les différences entre la numérotation des pages logiques, des pages physiques et des fenêtres. Notez que chaque région peut contenir plusieurs pages logiques. En outre, vous pouvez avoir plusieurs fenêtres dans une même page logique. Dans la figure, les pages physiques sont numérotées de manière consécutive à partir des pages de la section d'en-tête, ce qui présuppose que vous avez sélectionné Section d'en-tête, Section principale et Section de fin dans la boîte de dialogue Numérotation de page.


 Dans cet exemple, DEPTNO et DNAME pourraient être la source des champs de R_Dept ou de R_Emp. ENAME et SAL pourraient être uniquement la source des champs de R_Emp.


Propriétés de colonne de formule

  Restrictions

Ordre de ventilation

Type de colonne

Commentaire

Type de données

Exclure de la sortie XML

Format de fichier

Nom

Formule PL/SQL

Ordre produit

Lecture depuis fichier

Définir ordre de ventilation

Valeur si Null

Largeur

Balise XML

Attributs de balise XML


Colonne de formule - Restrictions

•	Vous pouvez donner à des colonnes de réserve ou à des colonnes de formule l'un des types de données suivants : Character, Number et Date.


Propriétés d'encadrement

Attributs d'hyperlien supplémentaire

Ligne de commande d'application (PDF)

Activation de l'impression de base

Signet

Commentaires

Déclencheur de format

Fin de la section de présentation

Elasticité horizontale

Hyperlien

Destination hyperlien

Objet solidaire

Nom

Saut de page après

Saut de page avant

Protection pge

Activation de l'objet d'impression

Code d'imprimante après

Code d'imprimante avant

Elasticité verticale


Propriétés de groupe

  Restrictions

Dimension fils

Commentaire

Exclure de la sortie XML

Type de filtre

Nom

Nombre d'enregistrements

Balise XML externe

Attributs XML externes

Filtre PL/SQL

Balise XML

Attributs de balise XML


Groupe - Restrictions

•	Tout groupe qui n'est pas le groupe le moins élevé et qui appartient à une interrogation doit contenir au moins une colonne pour laquelle Ordre de ventilation a été indiqué.

•	Pour les règles concernant les groupes inter-produit, reportez-vous à "Matrice - Restrictions".


propriété Dimension fils
Dimension fils

  Restrictions 	  Exemples

Description  La propriété Dimension fils indique si un groupe est un groupe de dimension fils dans un modèle de données à matrice imbriquée. En identifiant les groupes de dimension fils, vous éliminez les lignes et/ou colonnes vides de votre matrice.

Valeurs

Oui	Identifie le groupe comme étant de dimension fils dans un état à matrice imbriquée.
Non	Identifie le groupe comme n'étant pas de dimension fils dans un état à matrice imbriquée.
S'applique à  Groupes de dimension dans un modèle de données matriciel à interrogation simple.

Obligatoire/Facultatif  facultatif

Valeur par défaut  Non

Notes d'utilisation

•	Lorsque Dimension fils a pour valeur Non, les lignes entre les groupes d'un groupe inter-produit apparaissent en pointillés. Lorsque vous donnez à Dimension fils la valeur Oui, la ligne entre ce groupe et son père prend la forme d'un trait continu.


Dimension fils (valeur Non) - Exemple

  Rubriques connexes 	  Tous les exemples

Dans le cas de la matrice ci-dessous, le groupe contenant deptno (G_DEPTNO) a sa Dimension fils définie à Non. Notez la façon dont toutes les lignes sont imprimées, même si elles ne contiennent aucune valeur.


Dimension fils (valeur Oui) - Exemple

  Rubriques connexes 	  Tous les exemples

Dans le cas de la matrice ci-dessous, le groupe contenant deptno (G_DEPTNO) a sa Dimension fils définie à Oui. Notez que seules les lignes contenant des valeurs sont imprimées.


Dimension fils - Restrictions

•	La propriété Dimension fils n'est valide que pour les groupes de dimension dans les modèles de données matriciels à interrogation simple.

•	La propriété Dimension fils n'est pas valide pour le groupe le plus au-dessus dans le modèle de données.

•	Dans l'exemple de modèle de données ci-dessous, la Dimension fils ne serait pas valide pour G_1, G_Cross et G_YEAR. En revanche, elle serait valide pour G_DEPTNO et G_JOB.


propriété Type de filtre
Type de filtre

  Restrictions 	  Exemples

Description  Type de filtre permet d'indiquer le type de filtre que Report Builder doit appliquer aux enregistrements extraits pour le groupe.

Valeurs

none	Indique que vous n'utilisez pas de filtre pour le groupe.
Premier	Indique que les n premiers enregistrements extraits doivent être inclus dans le groupe, où n est un nombre indiqué dans la propriété Nombre d'enregistrements.
Dernier	Indique que les n derniers enregistrements extraits doivent être inclus dans le groupe, où n est un nombre indiqué dans la propriété Nombre d'enregistrements.
PL/SQL	Indique qu'une fonction PL/SQL permettant de déterminer les enregistrements à inclure dans le groupe est définie (ou référencée).
S'applique à  groupes

Obligatoire/Facultatif  facultatif

Valeur par défaut  Aucun


Type de filtre - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un groupe appelé EMP qui contient deux colonnes (NOM E et SAL). Le groupe père de EMP est DEPT, qui contient une colonne (NODEPT). Vous indiquez Premier comme Type de filtre, 3 comme Nombre d'enregistrements pour DEPT, Premier comme Type de filtre et 5 comme Nombre d'enregistrements pour EMP. Les 3 premiers numéros de département extraits par Report Builder seront retournés avec les 5 premiers noms et salaires extraits pour chaque département.


Type de filtre - Restrictions

•	Si Type de filtre est défini à Premier ou Dernier, vous devez indiquer un entier positif dans le champ associé. Ce nombre ne peut pas avoir plus de 64 Ko de long.

•	Il n'est pas possible d'appliquer un filtre à un groupe inter-produit.

•	Les enregistrements exclus du groupe par un filtre ne sont pas utilisés dans les calculs. Si vous voulez utiliser des données dans un calcul sans qu'elles apparaissent dans la sortie de l'état, utilisez un déclencheur de format pour limiter les informations qui apparaîtront dans la sortie.


Propriété Nom

Description  La propriété Nom permet d'indiquer le nom que Report Builder utilise pour identifier le groupe actuel. Entrez tout nom de groupe valide, d'un maximum de 30 octets.

S'applique à  groupes

Obligatoire/Facultatif  obligatoire

Valeur par défaut  G_nom d'interrogation, où nom d'interrogation est le nom de l'interrogation et une valeur numérique unique parmi les groupes. Si l'interrogation a un nom par défaut (par exemple, Q_1), le nom de groupe par défaut se présente sous la forme  G_n, où n est un nombre qui est unique parmi les noms de groupe de l'état. Si le groupe n'est pas associé à une interrogation (c'est-à-dire s'il s'agit d'un groupe inter-produit), le nom de groupe par défaut est également G_n.


Propriété Commentaire

Description  La propriété Commentaire contient le texte qui documente le groupe. Vous pouvez par exemple décrire un groupe de ventilation afin qu'une tierce personne puisse comprendre rapidement les opérations qu'elle exécute. Entrez un texte ne dépassant pas 64 Ko.

S'applique à  groupes

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc


propriété Nombre d'enregistrements
Nombre d'enregistrements

Description  La propriété Nombre d'enregistrements indique le nombre d'enregistrements à inclure dans le groupe lorsque Type de filtre est défini à Premier ou à Dernier. Par exemple, si Type de filtre est défini à Premier et que le Nombre d'enregistrements soit défini à 20, les 20 premiers enregistrements extraits seront inclus dans le groupe.

Valeurs  Entrez un entier positif ne dépassant pas 64 Ko de long.

S'applique à  groupes

Obligatoire/facultatif  Obligatoire lorsque la propriété Type de filtre est définie à Premier ou Dernier.

Valeur par défaut  0


Propriété Filtre PL/SQL
Filtre PL/SQL

  Rubriques connexes

Description  La propriété Filtre PL/SQL est un bouton qui permet d'afficher l'Editeur PL/SQL dans lequel vous pouvez entrer une fonction PL/SQL permettant de déterminer les enregistrements à inclure dans le groupe.

S'applique à  groupes

Obligatoire/facultatif  Obligatoire lorsque la propriété Type de filtre est définie à PL/SQL.


Propriétés de liaison de modèle de données

  Restrictions 	 Exemples

Colonne fils

Interrogation fils

Condition

Colonne père

Groupe père

Clause SQL


Liaison de clause WHERE - Exemple

  Rubriques connexes 	  Tous les exemples

Supposons que vous créiez un état maître-détail comportant les deux interrogations suivantes :

Q_1:   SELECT DISTINCT ENAME, EMPNO
       FROM EMP
       WHERE JOB = 'VENDEUR'

Q_2:   SELECT REPID, AMOUNT
       FROM SALES
       ORDER BY REPID

Pour joindre ces deux interrogations, créez une liaison dont la palette de propriétés offre les options suivantes :

Clause SQL	Colonne père	Condition	Colonne fils
WHERE	NOEMP	=	REPID
La liaison créée est la même que si vous écriviez une interrogation sous la forme :

SELECT DISTINCT ENAME, EMPNO, REPID, AMOUNT
FROM EMP, SALES
WHERE EMPNO = REPID (+) AND JOB = 'VENDEUR'
ORDER BY REPID

Conseil

Si vous utilisez un style tabulaire, votre sortie se présente comme suit :

Ename        Empno   Repid        Amount

-----------  ------  ------  ------------

ALLEN         7499    7499          3000

                      7499           810

                      7499           847

                      7499            24

                      7499          1500

                      7499           340

                      7499           240

                      7499           400

                      7499           180

                      7499           280

                      7499           250

MARTIN        7654    7654         16569

                      7654          2301

                      7654          3306

                      7654          5600

TURNER        7844    7844           350

                      7844           485

                      7844           293

                      7844            50

                      7844          1703


Liaison START WITH - Exemple

  Rubriques connexes 	  Tous les exemples

Supposons que vous vouliez créer un état dressant la liste des employés par poste occupé dans la hiérarchie. Les interrogations que vous pouvez utiliser sont les suivantes :

Q_1:   SELECT EMPNO FROM EMP
       WHERE JOB = 'DIRECTEUR'

Q_2:   SELECT  ENAME, JOB, EMPNO, MGR, LEVEL
       FROM EMP
       CONNECT BY PRIOR EMPNO = MGR

Pour joindre ces deux interrogations, créez une liaison dont la palette de propriétés offre les options suivantes :

Clause SQL	Colonne père	Condition	Colonne fils
START WITH	NOEMP	=	NOEMP1
Si vous utilisez une présentation tabulaire par défaut, votre sortie se présente de la manière suivante :

 Empno  Ename       Job          Empno1    Mgr     Level

------  ----------   ---------   ------  ------  --------

  7566  JONES       MANAGER      7566     7839         1

        SCOTT       ANALYST      7788     7566         2

        ADAMS       CLERK        7876     7788         3

        FORD        ANALYST      7902     7566         2

        SMITH       CLERK        7369     7902         3

  7698  BLAKE       MANAGER      7698     7839         1

        ALLEN       SALESMAN     7499     7698         2

        WARD        SALESMAN     7521     7698         2

        MARTIN      SALESMAN     7654     7698         2

        TURNER      SALESMAN     7844     7698         2

        JAMES       CLERK        7900     7698         2

  7782  CLARK       MANAGER      7782     7839         1

        MILLER      CLERK        7934     7782         2


Liaison de modèle de données - Restrictions

•	Si vous créez un lien en indiquant des colonnes, vous devez avoir une colonne père et une colonne fils, et les colonnes doivent avoir des types de données compatibles. Si la colonne père est de type Character (par exemple, VARCHAR), la colonne fils doit également être de type Character (par exemple, CHAR).


Si vous avez utilisé une seule interrogation, vous devez également créer un groupe de ventilation pour ENAME et EMPNO.


propriété Colonne fils
Colonne fils

  Restrictions

Description  La propriété Colonne fils permet d'indiquer le nom d'une colonne de l'interrogation enfant qui concerne une colonne du groupe parent (par exemple, colonne parent). La colonne enfant doit être une colonne de base de données, et ne peut pas être une colonne récapitulative ou une colonne de formule. Elle ne peut pas non plus dépendre d'une référence lexicale (voir Colonne fils - Restrictions").

S'applique à  liaisons


Colonne fils - Restrictions

•	Un lien Report Builder ne doit pas dépendre d'une référence lexicale, c'est-à-dire que ni la colonne fils d'un lien ni son nom de table ne doivent être déterminés par une référence lexicale. Pour obtenir cette fonctionnalité, vous devez créer un lien sans indiquer de colonnes, puis entrer la clause SQL (par exemple, WHERE) du lien directement dans l'interrogation. Par exemple, vos interrogations père et fils peuvent s'écrire de la manière suivante :

Parent Query:  SELECT DEPTNO FROM EMP
Child Query:   SELECT &PARM_1 COL_1, &PARM2
               COL_2
               FROM EMP
               WHERE &PARM_1 = :DEPTNO

Notez la façon dont la clause WHERE crée une référence de liaison à DEPTNO, qui a été sélectionné dans l'interrogation père. En outre, cet exemple présuppose que vous avez créé un lien entre les interrogations de la vue Modèle de données, sans indiquer de colonnes.


propriété Interrogation fils
Interrogation fils

  Restrictions

Description  La propriété Interrogation fils correspond au nom de l'interrogation définie comme enfant lorsque vous créez le lien dans la vue Modèle de données. Ce champ est en lecture seule.

S'applique à  liaisons


Interrogation fils - Restrictions

•	Une interrogation fils ne peut avoir qu'un seul groupe père. Les pères multiples d'un même fils ne sont pas autorisés.


propriété Condition
Condition

Description  La propriété Condition permet d'indiquer qu'un opérateur SQL qui définit la relation entre la Colonne père et la Colonne fils. Pour tout détail sur les opérateurs SQL, reportez-vous à ORACLE8 Server SQL Language Reference Manual.

Valeurs

=	(égal à)
<	(inférieur à)
<=	(inférieur ou égal à)
<>	(différent de)
>	(supérieur à)
>=	(supérieur ou égal à)
Like	Indique que la condition est vraie lorsque la valeur d'une colonne correspond au motif de l'autre colonne. Le motif peut contenir % et _ comme caractères génériques.
Not Like	Indique que la condition est vraie lorsque la valeur d'une colonne ne correspond pas au motif de l'autre. Le motif peut contenir % et _ comme caractères génériques.
S'applique à  liaisons

Obligatoire/facultatif  obligatoire, si Colonne père est indiqué.

Valeur par défaut  = (signe égal)


propriété Colonne père
Colonne père

Description  La propriété Colonne père permet d'indiquer une colonne du groupe parent qui est liée à une colonne du groupe enfant (c'est-à-dire, colonne enfant). La colonne parent peut être une colonne de base de données, une colonne récapitulative ou une colonne de formule du groupe parent. Si la colonne parent est une colonne récapitulative ou une colonne de formule, elle ne peut pas dépendre, directement ou indirectement, d'une colonne appartenant à l'interrogation enfant. Ce champ est en lecture seule.

S'applique à  liaisons


propriété Groupe père
Groupe père

  Restrictions

Description  La propriété Groupe père correspond au nom du groupe défini comme parent lorsque vous créez le lien dans la vue Modèle de données. Ce champ est en lecture seule.

S'applique à  liaisons

Notes d'utilisation

•	Vous pouvez créer une liaison entre un groupe père et une interrogation fils sans indiquer de colonne à utiliser comme liaison. Cette opération crée une relation entre les deux objets ; cependant, tous les enregistrements détail s'affichent pour chaque enregistrement maître du groupe père.


Groupe père - Restrictions

•	Un Groupe père ne peut pas avoir l'interrogation fils comme l'un de ses ancêtres. En d'autres termes, vos liaisons ne peuvent pas créer de dépendance circulaire (c'est-à-dire une situation dans laquelle l'interrogation fils dépend du groupe père et le groupe dépend de l'interrogation fils).


propriété Clause SQL
Clause SQL

Description  La propriété Clause SQL permet d'indiquer le type de clause qui lie le groupe père à l'interrogation fils. Pour tous détails, reportez-vous à ORACLE8 Server SQL Language Reference Manual.

Valeurs

HAVING

START WITH

WHERE

S'applique à  liaisons

Obligatoire/facultatif  obligatoire si vous avez une ou plusieurs Colonnes père.

Valeur par défaut  WHERE

Notes d'utilisation

•	Si vous utilisez une clause SQL START WITH, l'instruction SELECT de l'interrogation fils doit contenir une clause CONNECT BY (sans clause START WITH, puisqu'elle est contenue dans cette propriété). De même, si vous utilisez la clause SQL HAVING, l'instruction SELECT de l'interrogation fils doit contenir une clause GROUP BY (sans clause HAVING, puisqu'elle est contenue dans cette propriété.).


Propriétés de matrice

  Restrictions 	  Exemples

Attributs d'hyperlien supplémentaire

Liste de commande d'application (PDF)

Signet

Commentaires

Groupe inter-produit

Encadrement itératif horizontal

Hyperlien

Destination hyperlien

Nom

Encadrement itératif vertical


Propriété Groupe inter-produit
Groupe inter-produit

Description  La propriété Groupe inter-produit permet d'indiquer le groupe qui contient les groupes source des encadrements itératifs horizontaux et verticaux. Le groupe inter-produit établit le lien entre les valeurs d'un ou de plusieurs groupes pour produire les données de la matrice.

Valeurs  Entrez un nom de groupe inter-produit valide

S'applique à  matrices

Obligatoire/facultatif  obligatoire

Valeur par défaut  blanc


Matrice - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un groupe, Group1, contenant une colonne appelée C_DEPTNO qui extrait ses valeurs de la colonne de la base de données DEPTNO. Un groupe, appelé Group2, contient la colonne C_JOB qui extrait ses valeurs de la colonne de la base de données JOB et la colonne C_DEPTNO1, utilisée pour la liaison avec l'interrogation du Group1. Un groupe, appelé Group3, contient une colonne appelée SUMSAL qui récapitule la colonne de base de données SAL.

                           Poste

            Analyste     Employé     Directeur

      10                 $1300         $2450

Dépt  20     $6000       $1900         $2975

      30                 $ 950         $2850

Dans cet exemple :

•	L'encadrement itératif vertical est l'encadrement itératif qui contient le Group2 (les intitulés des postes).

•	L'encadrement itératif horizontal est l'encadrement itératif qui contient le Group1 (numéros de département).

•	Le groupe inter-produit est le Group4 (le groupe père de Group1 et Group2).

Pour créer une matrice plus complexe, ajoutez des colonnes à Group1 et à Group2. Par exemple, Group1, outre les numéros de département, pourrait également contenir les emplacements (EMPLACEMENT) des départements. La matrice pourrait alors être représentée de la manière suivante :

                                 Poste

EMPLACEMENT  Dépt    Analyste    Employé    Directeur

Paris        10                   $1300         $2450

Londres      20       $6000       $1900         $2975

New York     30                   $ 950         $2850


Matrice - Restrictions

•	Les encadrements itératifs verticaux (vers le bas) doivent se trouver en dessous des encadrements itératifs horizontaux (de gauche à droite) d'une matrice.

•	L'objet d'une matrice doit toujours se trouver au-dessus des encadrements itératifs qui le constituent (c'est-à-dire une ou plusieurs couches au-dessus de ses encadrements itératifs horizontaux et verticaux). Report Builder vous empêche de faire passer la matrice en dessous de ses encadrements itératifs horizontaux et verticaux.

•	Le déplacement d'une matrice provoque également le déplacement de ses deux encadrements itératifs.

•	Un objet de matrice ne peut pas être ancré à un autre objet, et d'autres objets ne peuvent pas être ancrés à cet objet (c'est-à-dire qu'un objet de matrice ne peut pas être l'objet père ou l'objet fils d'un point d'ancrage).

•	Pour copier une matrice, sélectionnez la matrice et ses deux encadrements itératifs. Si vous sélectionnez uniquement la matrice, elle ne sera pas copiée dans la mémoire tampon de collage. Si vous sélectionnez la matrice et l'un de ses encadrements itératifs, seul l'encadrement itératif sera placé dans la mémoire tampon de collage.

•	Pour redimensionner un objet de matrice, il faut obligatoirement redimensionner les encadrements itératifs qui lui sont associés.

•	Vous ne pouvez pas utiliser les options Aligner, Aligner objets ou Définir taille objets du menu Réorganisation sur des objets de matrice.

•	Les groupes source des encadrements itératifs qui constituent les dimensions d'une matrice doivent provenir du même groupe inter-produit.

•	Les encadrements itératifs dont les groupes source se trouvent dans la même hiérarchie "familiale" (c'est-à-dire qui sont les descendants ou les ancêtres les uns des autres) doivent avoir la même Orientation d'impression. Les relations père-fils, dans un groupe inter-produit, sont utilisées pour créer une imbrication dans la matrice. Les encadrements itératifs associés à ces groupes doivent donc s'imprimer selon la même orientation de page.

•	Vous ne pouvez pas placer une bordure sur un objet de matrice comme vous le feriez pour un autre objet, mais la largeur sera toujours la largeur minimum possible. Vous ne pouvez pas agrandir la bordure en raison de la proximité des objets dans une présentation de matrice.


Propriété Encadrement itératif horizontal
Encadrement itératif horizontal

  Restrictions

Description  La propriété Encadrement itératif horizontal permet d'indiquer l'encadrement itératif dont les valeurs produisent les en-têtes de ligne et les récapitulatifs et de calculer l'inter-produit de la matrice.

Valeurs  Entrez tout nom d'encadrement itératif valide.

S'applique à  matrices

Obligatoire/facultatif  obligatoire

Valeur par défaut  blanc


Encadrements itératifs horizontal et vertical - Restrictions

•	Les groupes source des encadrements itératifs indiqués dans les propriétés Encadrement itératif horizontal et Encadrement itératif vertical doivent se trouver dans le même groupe inter-produit.


Propriété Encadrement itératif vertical
Encadrement itératif vertical

  Restrictions

Description  La propriété Encadrement itératif vertical permet d'indiquer l'encadrement itératif dont les valeurs produisent les en-têtes de colonne et les récapitulatifs, et de calculer l'inter-produit de la matrice.

Valeurs Entrez tout nom d'encadrement itératif valide.

S'applique à  matrices

Obligatoire/facultatif  obligatoire

Valeur par défaut  blanc


Propriétés des objets colonne de base de données

Commentaire

Type de colonne

Type de données

Nom


Propriétés OLE2

Attributs d'hyperlien supplémentaire

Ligne de commande d'application (PDF)

Activation de l'impression de base

Signet

Commentaires

Déclencheur de format

Elasticité horizontale

Hyperlien

Destination hyperlien

Objet solidaire

Nom

Saut de page après

Saut de page avant

Protection page

Activation de l'impression d'objets

Code d'imprimante après

Code d'imprimante avant

Elasticité verticale


Propriétés de paramètre

Ajouter

Attributs supplémentaires (HTML)

Commentaire

Type de données

Masquer première colonne

Valeur initiale

Masque de saisie

Liste de valeurs

Nom

Supprimer

Restreindre la liste à des valeurs prédéterminées

Instruction SELECT/Valeurs statiques

Déclencheur de validation

Valeur

Largeur


Paramètres système

BACKGROUND	Indique si l'état doit s'exécuter en arrière-plan ou au premier plan.
COPIES	Indique le nombre d'exemplaires de l'état qui devront être imprimés.
CURRENCY	Indique le symbole monétaire utilisé (par exemple, "$").
DECIMAL	Indique le symbole du séparateur décimal (par exemple, ".").
DESFORMAT	Indique la définition du format de l'unité de sortie (par exemple, mode paysage pour une imprimante). Ce paramètre est utilisé lors de l'exécution d'un état dans un environnement en mode caractère et lors de l'envoi d'un état bitmap à un fichier (par exemple, pour créer une sortie PDF ou HTML).
DESNAME	Indique le nom de l'unité de sortie (par exemple, le nom du fichier, le nom de l'imprimante ou l'ID utilisateur de messagerie).
DESTYPE	Indique le type de l'unité à laquelle la sortie de l'état devra être envoyée (screen, file, mail, printer ou screen en format PostScript).
MODE	Indique si l'état doit s'exécuter en mode caractère ou en mode bitmap.
ORIENTATION	Indique l'orientation d'impression de l'état (portrait, paysage, valeur par défaut).
PRINTJOB	Indique si la boîte de dialogue d'impression doit apparaître avant l'exécution de l'état.
THOUSANDS	Indique le symbole du séparateur des milliers (par exemple, ",").


propriété Ajouter
Ajouter

Description  Le bouton Ajouter permet de placer la valeur du champ Valeur dans la liste des valeurs statiques.

S'applique à  paramètres

Obligatoire/facultatif  obligatoire si vous voulez ajouter cette valeur aux valeurs statiques.


Propriété Attributs supplémentaires (HTML)
Attributs supplémentaires (HTML)

  Exemples	  Rubriques connexes

Description  La propriété Attributs supplémentaires (HTML) contient des gestionnaires d'événements JavaScript qui déclenchent différentes sorties ou sélectionnent des événements (par exemple, l'émission de messages d'erreur lors de la saisie de valeurs non valides ou lors du formatage de valeurs d'entrée) dans la grille de paramètres Runtime lorsque l'état est exécuté via le Web.

Valeurs  Tout gestionnaire d'événements JavaScript valide

S'applique à  champs de grille de paramètres

Valeur par défaut  blanc


Propriété Commentaire

Description  La propriété Commentaire contient le texte qui documente le paramètre. Par exemple, vous pouvez l'utiliser pour décrire la finalité du paramètre, afin que quelqu'un d'autre puisse comprendre rapidement ce que fait le paramètre. Entrez un texte ne dépassant pas 64 Ko.

S'applique à  paramètres

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc


propriété Type de données (paramètre)
Type de données

  Restrictions

Description  La propriété Type de données indique le type des valeurs que contient le paramètre (par exemple, des nombres).

Valeurs

Caractère (Character)

Date (Date)

Nombre (Number)

S'applique à  paramètres

Obligatoire/Facultatif  obligatoire

Par défaut  Caractère (Character)


Type de données - Restrictions

•	Les valeurs fournies par un paramètre doivent être conformes au type de données du paramètre, même lors de l'exécution.

•	Le type de données ne peut pas être édité s'il s'agit de paramètres en package (par exemple, DESTYPE).

•	Les paramètres ayant pour type de données CHAR ne sont pas remplis, à moins que vous ne le demandiez explicitement dans une instruction SQL.


propriété Masquer première colonne
Masquer première colonne

  Exemples

Description  La propriété Masquer première colonne est une case à cocher qui indique si la première colonne de votre liste SELECT doit être affichée dans la liste de valeurs du paramètre. Cette option permet de masquer les valeurs que l'utilisateur ne connaît pas ou qui sont confidentielles.

S'applique à  paramètres

Valeur par défaut  cochée


Masquer première colonne - Exemple

  Rubriques connexes 	  Tous les exemples

Supposons que vous vouliez créer un état qui dresse la liste des employés d'un département que l'utilisateur indique lors de l'exécution. Les tables que vous utiliserez ont comme clé primaire/étrangère DEPTNO. Les personnes qui utiliseront l'état ne connaissent ces départements que par leur nom et non par leur numéro. L'interrogation de l'état se présente de la manière suivante :

SELECT * FROM EMP
WHERE DEPTNO = :MYDEPT

Dans l'onglet Données/Sélection de la fenêtre de propriétés Paramètre, choisissez Instruction SELECT et, pour remplir la liste de valeurs, entrez l'instruction SQL suivante :

SELECT DEPTNO, DNAME FROM DEPT

Cochez Masquer première colonne : DEPTNO n'apparaît pas dans la liste de valeurs lors de l'exécution de l'état. Seul DNAME apparaît. Lorsque l'utilisateur sélectionne une valeur DNAME dans la liste, la valeur correspondante de DEPTNO est utilisée pour le paramètre MYDEPT.


propriété Valeur initiale
Valeur initiale

  Restrictions

Description  La propriété Valeur initiale indique la valeur par défaut du paramètre. Cette valeur est utilisée si elle n'est pas remplacée dans la ligne de commande ou dans la grille de paramètres d'exécution. Entrez la valeur de vote choix pour le type de données du paramètre. La valeur initiale ne peut pas avoir plus de 1 Ko de long. Si ce paramètre est laissé en blanc, il n'a pas de valeur par défaut.

S'applique à  paramètres

Obligatoire/Facultatif  facultatif

Valeur par défaut  Pour DESTYPE, Screen.  Pour DESFORMAT, dflt.  Pour COPIES, 1.  Pour tous les autres paramètres, blanc.


Valeur initiale - Restrictions

•	La propriété Valeur initiale est validée en fonction du type de données et de la largeur du paramètre. En outre, cette propriété est validée par comparaison avec les masques de format :

•	Si vous en indiquez un, le masque de Masque de format est utilisé.

•	Si vous n'en indiquez pas et que la valeur soit une date, le masque interne de Report Builder (par exemple, JJ-MOI-AA) est utilisé. (Les valeurs numériques et alphabétiques ne sont validées que si vous indiquez un Masque de format.)

•	Si aucune valeur n'est indiquée et que le paramètre soit référencé dans SQL ou PL/SQL, la valeur Null est utilisée pour analyser le SQL ou le PL/SQL. Si la valeur Null entraîne une erreur d'analyse de l'élément SQL ou PL/SQL, le système génère une erreur.


propriété Masque de saisie
Masque de saisie

  Restrictions

Description  La propriété Masque de saisie indique le masque de format que Report Builder utilise pour valider la valeur fournie pour le paramètre dans la ligne de commande ou dans la grille de paramètres d'exécution. Elle est également utilisée pour valider la valeur initiale du paramètre. Entrez tout masque de format valide d'un maximum de 128 octets ou sélectionnez une valeur de la liste.

S'applique à  paramètres

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc, impliquant que lorsque le type de données est date, le masque de saisie est le masque par défaut de votre langue (par exemple, aux Etats-Unis, 'JJ-MOI-AA'), alors que lorsque le type de données est Number, le masque de saisie est -9999.


Masque de saisie - Restrictions

•	Les valeurs affichées au départ dans la liste de valeurs Masque de saisie sont déterminées par le type de données du paramètre (par exemple, si le paramètre est de type Number, seuls les masques numériques sont affichés dans la liste). Si vous entrez un nouveau masque de format et validez la fenêtre de propriétés, la nouvelle valeur apparaît dans la liste. Cependant, ces masques de format ne sont valides que pendant la session Report Builder en cours. Si vous quittez Report Builder, puis l'appelez à nouveau, la liste de valeurs ne contiendra pas les masques de format que vous avez créés au cours de la précédente session Report Builder (à moins que vous n'ouvriez le ou les états qui utilisaient ces masques). Pour ajouter de nouveaux masques à la liste qui sera conservée d'une session à l'autre, utilisez le bouton Editer masques de la boîte de dialogue Préférences.

•	La propriété Masque de saisie ne s'applique pas aux paramètres dont les données sont de type Character.


propriété Supprimer
Supprimer

Description  Le bouton Supprimer permet de supprimer de la liste des valeurs statiques la ou les valeurs sélectionnées.

S'applique à  paramètres

Obligatoire/facultatif  obligatoire, si vous voulez supprimer des valeurs statiques.


propriété Restreindre la liste à des valeurs prédéterminées
Restreindre la liste à des valeurs prédéterminées

Description  La propriété Restreindre la liste à des valeurs prédéterminées est une case à cocher qui indique si une valeur du paramètre doit figurer dans la liste de valeurs. Par exemple, si vous cochez Restreindre la liste à des valeurs prédéterminées et que la valeur initiale ne corresponde pas à une valeur de la liste, le système génère une erreur lorsque vous validez la fenêtre de propriétés Paramètre. De même, si vous définissez dans la ligne de commande ou dans un script de commande une valeur de paramètre qui ne correspond pas à une valeur de la liste de valeurs, le système génère une erreur lorsque l'état est exécuté. Si vous cochez Restreindre la liste à des valeurs prédéterminées, une liste de valeurs apparaît dans la grille de paramètres d'exécution. Si vous ne la cochez pas, une liste déroulante apparaît (c'est-à-dire que vous pouvez entrer des valeurs et en sélectionner dans la liste).

S'applique à  paramètres

Valeur par défaut  cochée


propriété Instruction SELECT/Valeurs statiques
Instruction SELECT/Valeurs statiques

Description  La propriété Instruction SELECT/Valeurs statiques est un bouton d'option qui permet d'indiquer si vous voulez utiliser une instruction SELECT (interrogation SQL) ou une liste statique pour remplir la liste de valeurs du paramètre.

Valeurs

Instruction SELECT	Indique que vous voulez entrer une instruction SELECT pour remplir la liste de valeurs du paramètre. Si vous sélectionnez cette option, vous devez entrer une instruction SELECT dans la zone située sous le bouton d'option Instruction SELECT.
Liste statique	Indique que vous voulez entrer manuellement des valeurs pour remplir la liste de valeurs du paramètre. Si vous sélectionnez cette option, vous devez créer manuellement une liste de valeurs. Pour cela, entrez une valeur dans le champ Valeur, puis choisissez le bouton Ajouter. Répétez cette opération pour chaque valeur qui doit figurer dans la liste. Pour supprimer une ou plusieurs valeurs, sélectionnez-les dans la liste, puis choisissez le bouton Supprimer.
S'applique à  paramètres

Obligatoire/Facultatif  obligatoire


propriété Déclencheur de validation
Déclencheur de validation

  Rubriques connexes

Description  La propriété Déclencheur de validation est un bouton qui permet d'afficher l'Editeur PL/SQL dans lequel vous pouvez entrer le code PL/SQL à valider et, si nécessaire, modifier le paramètre.

S'applique à  paramètres


propriété Valeur
Valeur

Description  La propriété Valeur permet d'indiquer une valeur qui s'ajoute à la liste statique des valeurs du paramètre lorsque vous choisissez le bouton Ajouter. Entrez une valeur valide pour le paramètre, puis choisissez le bouton Ajouter pour ajouter cette valeur à la liste statique des valeurs.

S'applique à  paramètres

Obligatoire/facultatif obligatoire, si vous voulez ajouter une valeur à la liste statique.


propriété Largeur (paramètre)
Largeur

  Restrictions

Description  La propriété Largeur permet d'indiquer le nombre maximum de caractères de la valeur de paramètre entrée dans la ligne de commande et la Grille de paramètres d'exécution. Entrez une valeur comprise entre 1 et 64 Ko.

S'applique à  paramètres

Obligatoire/Facultatif  obligatoire

Valeur par défaut  40 caractères


Largeur - Restrictions

•	Toute valeur de paramètre supérieure à la valeur indiquée par Largeur et fournie lors de l'exécution est tronquée par Report Builder.

•	La largeur ne peut pas être éditée pour les paramètres en package (par exemple, DESNAME).


propriété Liste de valeurs
Liste de valeurs

Ajouter

Masquer première colonne

Supprimer

Restreindre la liste à des valeurs prédéterminées

Instruction SELECT/Valeurs statiques

Valeur


Propriétés de texte standard de grille de paramètres

Commentaires

Nom

Type


Propriété Nom (propriétés de texte standard de grille de paramètres)
Nom

Description  La propriété Nom indique le nom que Report Builder utilise pour identifier le texte standard en cours.

Valeurs  Entrez tout nom de texte standard de grille de paramètres valide.

S'applique à  texte standard de grille de paramètres

Obligatoire/facultatif  obligatoire

Valeur par défaut  PB_n, où n est un numéro qui identifie l'état sans ambiguïté dans les noms de texte standard de grille de paramètres pour l'état.


Propriété Type (propriétés de texte standard de grille de paramètres)
Type

Description  La propriété Type affiche le format (par exemple, texte) de l'objet standard. Ce champ est en lecture seule.


Propriétés de champ de grille de paramètres

Commentaires

Type de données

Nom

Source


Propriété Type de données(champ de grille de paramètres)
Type de données

Description  La propriété Type de données est un champ en lecture seule qui affiche le type de données de la source du champ de grille de paramètres.


Propriété Nom (champ de grille de paramètres)
Nom

Description  La propriété Nom indique le nom que Report Builder utilise pour identifier le champ en cours.

Valeurs  Entrez tout nom de champ de grille de paramètres valide.

S'applique à champ de grille de paramètres

Obligatoire/facultatif  obligatoire

Valeur par défaut  PF_n, où n est un numéro qui identifie l'état sans ambiguïté  dans les noms champ de grille de paramètres pour l'état.


Propriété Source (champ de grille de paramètres)
Source

  Restrictions

Description  La propriété Source indique le paramètre dont le champ de grille de paramètres extrait sa valeur. La liste de valeurs contient tous les paramètres de l'état.

Valeurs  Entrez tout nom de paramètre valide.

S'applique à  champs de grille de paramètres

Obligatoire/facultatif  obligatoire

Valeur par défaut  blanc


Source - Restrictions

•	La source d'un champ de grille de paramètres doit être un paramètre de modèle de données.

•	Vous ne pouvez pas indiquer plusieurs champs de grille de paramètres ayant la même source.


Propriétés de colonne de réserve

  Exemples	  Restrictions

Ordre de ventilation

Type de colonne

Commentaire

Type de données

Format de fichier

Nom

Formule PL/SQL

Ordre produit

Lecture depuis fichier

Définir ordre de ventilation

Valeur si Null

Largeur


Colonnes de réserve pour récapitulatif spécial - Exemple

Supposons que vous vouliez créer un état maître-détail fournissant la liste du ou des employés les mieux payés dans chaque département. La sortie peut se présenter de la manière suivante :

nomD COMPTABILITE      Empl PARIS        Employés

                                        les mieux payés :

  NomE        Poste            Sal

  ----------  ---------  ---------

  DUPONT      DIRECTEUR    2450.00       VACHER

  VACHER      PRESIDENT    5000.00

  LAVIOLETTE  EMPLOYE      1300.00

NomD RECHERCHE      Empl LONDRES        Employés

                                        les mieux payés :

  NomE        Poste            Sal

  ----------  ---------  ---------

  MARTIN      EMPLOYE       800.00      JAQUET et ADAMS

  JULES       DIRECTEUR    2975.00

  JAQUET      ANALYSTE     3000.00

  SIMON       EMPLOYE      1100.00

  ADAMS       ANALYSTE     3000.00

Pour extraire le nom des employés les mieux payés, créez une colonne de réserve, appelée HIGHEST_PAID_EMP, de type character. La valeur de HIGHEST_PAID_EMP est définie par une colonne de formule, appelée SET_HIGHEST_PAID_EMP, de type character. R_COUNT est une colonne récapitulative dont la fonction est Décompte (Count). SET_HIGHEST_PAID_EMP contient dans Formule la fonction PL/SQL suivante :

fonction set_plch_high_emp return character is
begin
   /* Vérifier si nous sommes dans le premier enregistrement de fils ; si oui,
      remettre la colonne de réserve à zéro. */
   if (:r_count <= 1) then
     :highest_paid_emp := ' ';
   end if;
   /* Cet enregistrement fils correspond-il au salaire maximum
      du département ?  Si oui, et si la colonne de réserve est déjà
      définie (c'est-à-dire si nous avons déjà plusieurs salaires maxi), définir la
      colonne de réserve à la chaîne concaténée. Sinon,
      définir la colonne de réserve au nom de l'employé. */
   if (:sal = :max_dept_sal) then
     if (:highest_paid_emp <> ' ') then
       :highest_paid_emp := :highest_paid_emp||' and '
       ||:ename;
     else
       :highest_paid_emp := :ename;
     end if;
   end if;
   return (:highest_paid_emp);
  end;


Colonne de réserve - Restrictions

•	Vous pouvez donner à des colonnes de réserve ou à des colonnes de formule l'un des types de données suivants : Character, Number et Date.

•	Vous ne pouvez attribuer la valeur d'une colonne de réserve qu'à partir d'un groupe. Vous ne pouvez pas attribuer sa valeur dans des groupes multiples.


PL/SQL propriété Formule
Formule PL/SQL

  Rubriques connexes

Description  La propriété Formule PL/SQL est un bouton qui affiche l'Editeur PL/SQL dans lequel vous pouvez entrer votre formule.

S'applique à  colonnes de formule et colonnes de réserve.


Liste alphabétique des propriétés

Ajouter

Attributs supplémentaires (HTML)

Attributs d'hyperlien supplémentaire

Type Après formulaire

Valeur Après formulaire

Type Après page

Valeur Après page

Type Après état

Valeur Après état

Aligner récapitulatifs sur les champs

Alignement

Ligne de commande d'application (PDF)

Couleur d'arrière-plan

Activation de l'impression de base

Type Avant formulaire

Valeur Avant formulaire

Type Avant page

Valeur Avant page

Type Avant état

Valeur Avant état

Entre champ et libellés (horizontal)

Entre encadrement et champs (horizontal)

Entre encadrement et champs (vertical)

Entre maître et détail (horizontal)

Entre maître et détail (vertical)

Entre page et encadrements (horizontal)

Entre page et encadrements (vertical)

Entre encadrements de même père (horizontal)

Entre encadrements de même père (vertical)

Signet

Bordures

Ordre de ventilation

Alignement de caractères

Colonne de graphique

Nom de fichier de graphique

Hyperliens graphiques

Paramètre de graphique

Interrogation de graphique

Colonne fils

% du bord fils

Type de bord fils

Nom d'objet fils

Interrogation fils

Réduire horizontalement

Réduire verticalement

Mode colonne

Type de colonne

Commentaires

Calculer à

Condition

Mise en forme conditionnelle

Contient balises XML

Groupe inter-produit

Tiret

Type de données (colonne)

Type de données (paramètre)

Type de données (champ de grille de paramètres)

Alignement de dates

Concevoir en unités caractère

Orientation

Diffusion (section)

Diffusion (état)

Désactiver l'option de menu hôte

Désactiver la touche Ecran partagé

Désactiver la touche zoom

Nom d'affichage

Couleur d'arrière-plan du bord

Couleur de premier plan du bord

Motif du bord

Exclure de la sortie XML

Fichier source d'interrogation externe

Champs par ligne

Format de fichier

Motif de remplissage

Police

Couleur de premier plan

Type de filtre

Masque de format

Déclencheur de format

Fonction

Hauteur (fenêtre Grille de paramètres)

Hauteur (page physique de la section)

Masquer première colonne

Espacement horiz. entre encadrements

Elasticité horizontale

Panneaux horizontaux par page

Encadrement itératif horizontal

Hyperlien

Destination hyperlien

Nom icône

Image

Inclure objets bitmap

Inclure bordures

Valeur initiale

Masque de saisie

Inter-champ (horizontal)

Inter-champ (vertical)

Interencadrement (horizontal)

Interencadrement (vertical)

Justification

Objet solidaire

Type de libellé

Etirement de ligne avec encadrement

Liste de valeurs

Corps - nbre de pages horizontales max

Corps - nbre de pages verticales max

Nbre max d'enregistrements par page

Nombre maximum de lignes à extraire

Nbre min de lignes veuves

Nbre min d'enregistrements veufs

Type de colonne multimédia

Colonne multimédia

Type de fichier multimédia

Fichier multimédia

Nom

Nombre de pages

Nombre d'enregistrements

Alignement de nombres

Orientation

Balise XML externe

Attribut de balise XML externe

Saut de page après

Saut de page avant

Type Contrôle de navigation de page

Valeur Contrôle de navigation de page

Numérotation de page

Protection pge

Ordre d'impression écran

Colonne père

% du bord père

Type de bord père

Groupe père

Nom d'objet père

Filtre PL/SQL

Formule PL/SQL (colonne de formule/de réserve)

Instruction PL/SQL

Déclencheur PL/SQL

Placer libellés au-dessus des champs

Texte de ligne d'aide de l'aperçu

Texte de ligne d'état de l'aperçu

Orientation d'impression

Activation de l'objet d'impression

Code d'imprimante après

Code d'imprimante avant

Ordre produit

Lecture depuis fichier

Supprimer

Colonne d'état (pour colonne de graphique)

Colonne d'état (pour paramètre de graphique)

Groupe d'état

Hauteur de l'état

Largeur de l'état

Remise à

Nom de rôle

Restreindre la liste à des valeurs prédéterminées

Instruction SELECT/Valeurs statiques

Définir ordre de ventilation

Type de données source

Format de fichier source

Nom de fichier source

Source (colonne récapitulative)

Source (encadrement itératif)

Source (champ de grille de paramètres)

Source (champ)

Clause SQL

Instruction d'interrogation SQL

Démarrer sur le zoom

Style

Supprimer le titre de l'aperçu

Texte (bouton)

Texte (modèle)

Couleur de texte

Titre

Type (standard)

Type (bouton)

Type (interrogation)

Unité de mesure

Utiliser ligne d'aide de l'aperçu

Utiliser ligne d'état de l'aperçu

Utiliser espacement vertical

Déclencheur de validation

Valeur si Null

Valeur

Espacement vert. entre encadrements

Elasticité verticale

Panneaux verticaux par page

Encadrement itératif vertical

Visible

Largeur (colonne)

Largeur (paramètre)

Largeur (fenêtre Grille de paramètres)

Largeur (page physique de la section)

Type de prologue XML

Valeur du prologue XML

Balise XML

Attributs de balise XML


Aucune propriété ne commence par cette lettre.


Propriétés d'interrogation

Commentaire

Fichier source d'interrogation externe

Nombre maximum de lignes à extraire

Nom

Instruction d'interrogation SQL

Type


Propriété Commentaire

Description  La propriété Commentaire contient le texte qui documente l'interrogation. Par exemple, vous pouvez décrire l'opération effectuée par l'interrogation pour qu'un autre utilisateur puisse la comprendre rapidement. Entrez un texte ne dépassant pas 64 Ko de long.

S'applique à  interrogations

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc

Notes d'utilisation

•	Vous pouvez aussi insérer des commentaires directement dans votre instruction SQL SELECT en utilisant les délimiteurs de commentaires SQL standard d'Oracle (par exemple, /* commentaire */). Pour plus d'informations, reportez-vous à ORACLE8 Server SQL Language Reference Manual.


Propriété Fichier source d'interrogation externe

Description  La propriété Fichier source d'interrogation externe permet d'indiquer le nom d'une interrogation stockée dans la base de données ou dans un fichier dont l'instruction SELECT doit être utilisée comme instruction SELECT de l'interrogation en cours. Entrez un nom de fichier source d'interrogation externe valide, ne dépassant pas 1 Ko. Le fichier source d'interrogation externe auquel vous faites référence ne peut pas avoir plus de 32 Ko de long. Sinon, il est tronqué et entraîne la génération d'un message d'avertissement. Si l'interrogation est stockée dans un fichier, vous pouvez faire précéder le nom de l'interrogation d'un chemin d'accès. Si le nom de fichier n'est pas précédé d'un chemin d'accès, Report Builder utilise son ordre de recherche de chemin d'accès pour trouver le fichier. Si l'interrogation est stockée dans la base de données, vous pouvez faire précéder son nom de DB: pour indiquer qu'elle est stockée dans la base de données. Par exemple :

DB:moninterro

Si vous faites précéder le nom de l'interrogation de DB:, Report Builder recherche directement l'interrogation dans la base de données. Si vous n'êtes pas connecté à la base de données, Report Builder ne peut pas trouver l'interrogation et émet un message pour vous le signaler.

Remarque : Pour garantir la portabilité de vos états, vous pouvez utiliser la variable d'environnement REPORTS60_PATH. Vous pouvez utiliser cette variable pour indiquer les répertoires par défaut dans lesquels vous voulez rechercher les fichiers externes que vous utilisez dans vos états (par exemple, interrogations externes, texte standard et PL/SQL). Cette solution vous évite d'avoir à programmer des chemins d'accès aux répertoires dans votre état.

S'applique à  interrogations

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc

Notes d'utilisation

•	L'instruction SELECT du fichier interrogation source d'interrogation externe auquel vous faites référence à partir de ce champ est validée lorsque vous acceptez la fenêtre de propriétés de l'interrogation.

•	Si vous mettez à jour le fichier source d'interrogation externe, vous devez vous assurer que cette mise à jour n'invalide pas la définition de l'état. Par exemple, si l'état comporte une colonne NODEPT et que vous supprimiez NODEPT de la liste SELECT du fichier source d'interrogation externe, l'état ne peut pas être exécuté.

•	Lorsque vous indiquez un nom de fichier source d'interrogation externe, l'instruction SELECT de l'interrogation externe apparaît en lecture seule dans le champ Instruction d'interrogation SQL. Pour modifier le nom, vous devez ouvrir le fichier source d'interrogation externe.


Propriété Nbre max de lignes à extraire

Description  La propriété Nbre max de lignes à extraire permet d'indiquer le nombre de lignes de données que l'interrogation doit extraire. Report Builder n'extrait que le nombre de lignes que vous indiquez dans cette propriété. Lorsque vous créez un état, vous devez souvent l'exécuter plusieurs fois pour le finaliser. Si votre état extrait un grand nombre de données, vous risquez de perdre un temps considérable. Cette propriété peut améliorer les performances en diminuant le nombre de données extraites et mises en forme.

Valeurs  Un entier compris entre 1 et 32 Ko. Si ce champ est laissé en blanc, toutes les lignes seront extraites.

Pour limiter le nombre de lignes extraites par certains des groupes d'une interrogation, utilisez Filtre dans la fenêtre de propriétés Groupe.

S'applique à  interrogations

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc

Notes d'utilisation

Les lignes qui n'ont pas été extraites parce qu'elles se trouvaient au-delà du nombre maximum indiqué ne sont pas utilisées dans les calculs indiqués par Report Builder. Par exemple, si vous définissez Nbre max de lignes à extraire à 5 pour une interrogation fils, un récapitulatif du fils contenu dans le groupe père n'utilise que les cinq enregistrements extraits par l'interrogation. Si vous voulez utiliser des données dans des calculs, sans qu'elles apparaissent dans la sortie de l'état, limitez le contenu de la sortie à l'aide d'un déclencheur de format.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET MAXROW.


Propriété Nom

Description  La propriété Nom permet d'indiquer l'identificateur que Report Builder utilise pour faire référence à l'interrogation en cours. Entrez un nombre valide ne dépassant pas 30 octets.

S'applique à  interrogations

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Q_n, où n est un nombre unique dans les noms d'interrogation de l'état.


Propriété Instruction d'interrogation SQL

  Restrictions 	  Exemples

Description  La propriété Instruction d'interrogation SQL est une instruction SQL SELECT qui extrait de la base de données des données qui seront utilisées pour votre état. Entrez une instruction SELET valide ne dépassant pas 64 Ko. La limite supérieure est fonction du système d'exploitation utilisé. Toutes les fonctions d'instruction SELECT sont prises en charge, sauf les clauses INTO et FOR UPDATE. Lorsque vous écrivez votre instruction SELECT, vous pouvez :

•	utiliser la boîte de dialogue Tables et colonnes ;

•	insérer des commentaires ;

•	insérer des références de lien et des références lexicales ;

•	visualiser les erreurs SQL.

S'applique à  interrogations

Obligatoire/Facultatif  obligatoire


Instruction d'interrogation SQL - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple d'instruction SQL :

SELECT O.CUSTID, P.DESCRIP, I.ITEMTOT, O.ORDERDATE,
   I.ORDID
FROM ORD O, PRODUCT P, ITEM I
WHERE O.ORDID = I.ORDID AND
   I.PRODID = P.PRODID
ORDER BY O.CUSTID, P.PRODID, O.ORDERDATE
/* Pour chaque client, afficher les produits qu'ils ont achetés */
/* (DESCRIP), le coût du produit */
/* (ITEMTOT), la date de commande du produit */
/* (ORDERDATE),et l'ID de commande (ITEM.ORDID) de la */
/* commande passée. */


Instruction d'interrogation SQL avec référence de lien et référence lexicale - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple d'instruction SELECT utilisant des références de lien et des références lexicales :

SELECT CUSTID, SUM(TOTAL) TOTAL
FROM &FROMGROUP
HAVING SUM(TOTAL) > :MINTOTAL

où :

&FROMGROUP	Est ORD GROUP BY CUSTID (ou toute autre valeur que vous entrez lors de l'exécution). Notez que, dans ce cas, vous devez définir un paramètre FROMGROUP ayant une valeur initiale indiquée. Si la valeur de &FROMGROUP est nulle lorsque l'instruction SELECT est analysée, vous recevez un message d'erreur, car l'instruction ne comporte pas de nom de table après FROM.
:MINTOTAL	Est une colonne d'une autre interrogation utilisée pour sélectionner les clients ayant passé un nombre minimum de commandes.


Instruction d'interrogation SQL avec référence lexicale - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple d'instruction SELECT utilisant une référence lexicale à un paramètre :

SELECT ENAME, EMPNO
FROM EMP
WHERE ENAME LIKE UPPER (&NAME)

où :

&NAME	Fait référence à un paramètre ayant comme valeur par défaut 'JO%'. Notez que vous pouvez également indiquer une valeur de paramètre lors de l'exécution. Par exemple, dans la ligne de commande, vous pouvez entrer :

RWRUN60 REP SCOTT/TIGER NAME='SM%'


Instruction d'interrogation SQL - Restrictions

Attention : Si une colonne de la base de données a été agrandie après la création de votre état, vous devez mettre à jour le modèle de données et le modèle de présentation. Sinon, vos données risquent d'être tronquées. Les colonnes de la base de données sont automatiquement mises à jour lorsque l'interrogation est analysée à nouveau (par exemple, entrez un espace dans l'instruction d'interrogation SQL et sélectionnez OK). Vous devez mettre à jour manuellement la largeur des colonnes récapitulatives, de formule et de réserve dont la largeur des colonnes source a été agrandie. De même, vous devez redimensionner les champs de la présentation ou modifier leurs options de taille, en fonction de l'augmentation de la taille de leurs colonnes sources.

•	L'instruction SELECT doit respecter toutes les règles syntaxiques de SQL. Pour tous détails, reportez-vous à ORACLE8 Server SQL Language Reference Manual. Report Builder vérifie la syntaxe lorsque vous sortez de l'instruction d'interrogation SQL et que l'état est généré ou exécuté.

•	L'instruction SELECT ne doit pas se terminer par un point virgule, une barre oblique ou tout autre caractère.

•	Pour que l'instruction SELECT puisse être validée, il faut que vous ayez les autorisations appropriées sur les tables et les vues auxquelles elle fait référence.

•	Une interrogation fils, dans une liaison avec une clause SQL START WITH, doit contenir une clause CONNECT BY dans son instruction d'interrogation SQL (sans clause START WITH, puisqu'elle figure dans le lien du modèle de données). De même, l'interrogation fils, dans une liaison sans clause SQL HAVING, doit contenir une clause GROUP BY dans son instruction d'interrogation SQL (sans clause HAVING, puisqu'elle figure dans le lien de modèle de données).

•	Si les expressions SELECT d'une interrogation font l'objet d'un ajout, d'un changement de nom ou d'une suppression, Report Builder crée ou supprime automatiquement les colonnes correspondantes. Si la présentation a été définie (c'est-à-dire si le modèle de présentation contient des objets), Report Builder ne met pas à jour le modèle de présentation en fonction des modifications apportées à l'instruction SELECT. Vous devez mettre à jour manuellement les objets concernés dans la vue Modèle de présentation ou créer une nouvelle présentation par défaut pour l'état. La mise à jour du modèle de présentation n'est pas effectuée automatiquement par Report Builder pour vous éviter de perdre accidentellement les modifications apportées par vous à la présentation par défaut.

•	Si vous modifiez, dans la base de données, le type de données ou le nom des colonnes sélectionnées par votre interrogation, vous devez apporter manuellement les modifications nécessaires aux colonnes et aux champs de Report Builder qui utilisent comme Source la colonne modifiée.

•	L'ordre des colonnes dans l'instruction SELECT détermine l'ordre initial des colonnes. Les modifications ultérieures à l'ordre des colonnes dans l'instruction SELECT ne modifient pas l'ordre initial des colonnes. Si vous ajoutez des colonnes à l'instruction SELECT, elles sont ajoutées à la fin du groupe fils le moins élevé appartenant à l'interrogation. L'ordre des colonnes est utilisé pour classer les champs associés, dans la présentation par défaut.


Propriété Type

Description  La propriété Type figure dans un champ en lecture seule qui décrit le type d'interrogation.

S'applique à  interrogations


Propriétés des colonnes Ref de base de données

Ordre de ventilation

Commentaire

Type de colonne

Type de données

Nom

Largeur


Propriétés d'encadrement itératif

  Restrictions

Attributs d'hyperlien supplémentaire

Ligne de commande d'application (PDF)

Activation de l'impression de base

Signet

Mode colonne

Commentaires

Déclencheur de format

Espacement horiz. entre encadrements

Elasticité horizontale

Hyperlien

Destination hyperlien

Objet solidaire

Nbre max d'enregistrements par page

Nbre min d'enregistrements veufs

Nom

Saut de page après

Saut de page avant

Protection pge

Activation de l'objet d'impression

Code d'imprimante après

Code d'imprimante avant

Orientation d'impression

Source

Espacement vert. entre encadrements

Elasticité verticale


Encadrement itératif - Restrictions

•	Un encadrement itératif peut être placé à tout endroit du modèle de présentation, sauf si son groupe source est une dimension de matrice.

•	Un encadrement itératif doit se trouver derrière les objets (par exemple, champs et texte standard) qu'il contient.


propriété Mode colonne
Mode colonne

  Restrictions 	  Exemples

Description  Cette propriété permet de contrôler la façon dont Report Builder extrait et met en forme les données des instances d'encadrement itératif. Lorsque Mode colonne est défini à Oui, la mise en forme de l'instance suivante d'un encadrement itératif peut commencer avant la fin de l'instance précédente.

 Cliquez ici.

Lorsque Mode colonne est défini à Non, la mise en forme de la prochaine instance ne peut pas commencer avant la fin de l'instance précédente.

 Cliquez ici.

Mode colonne est utilisé essentiellement pour les encadrements itératifs maîtres ou les encadrements itératifs contenant des champs qui peuvent être développés horizontalement ou verticalement (c'est-à-dire pour lesquels la propriété d'élasticité correspondante est Variable ou Développer).

S'applique à encadrements itératifs

Obligatoire/Facultatif  facultatif

Valeur par défaut  Non


Mode colonne - Exemple

  Rubriques connexes 	  Tous les exemples

 Cliquez ici.

 Cliquez ici.

 Cliquez ici.


Mode colonne - Restrictions

•	Vous ne pouvez indiquer Mode colonne que pour les encadrements itératifs pour lesquels :

•	Orientation d'impression a été définie à Gauche-droite et Elasticité horizontale à Fixe ;

•	Orientation a été définie à Vers le bas et Elasticité verticale à Fixe.

•	Il n'est pas possible d'indiquer le Mode colonne pour les encadrements itératifs dont l'Orientation d'impression est définie à Gauche-droite/Vers le bas ou Vers le bas/Gauche-droite


propriété Espacement horiz. entre encadrements
Espacement horiz. entre encadrements

  Restrictions

Description  Cette propriété permet d'indiquer l'espace (exprimé dans l'unité de mesure de l'état) qui doit séparer horizontalement les instances de l'encadrement itératif. Entrez un nombre supérieur ou égal à zéro. Le maximum dépend de l'unité de mesure utilisée. Pour les pouces, il est de 512, pour les centimètres, il est de 1312 et pour les picas, il est de 36864.

 Cliquez ici.

S'applique à encadrements itératifs

Obligatoire/Facultatif  obligatoire

Valeur par défaut  0


Espacement horiz. entre encadrements - Restrictions

•	Lorsque Orientation d'impression est définie à Vers le bas, cette propriété est sans effet.

•	Lorsque Orientation d'impression est définie à Vers le bas/Gauche-droite, cette propriété conditionne l'espace séparant les instances situées les unes à côté des autres.


propriété Nbre max d'enregistrements par page
Nbre max d'enregistrements par page

  Exemples

Description  Cette propriété permet d'indiquer le nombre maximum d'instances de l'encadrement itératif qui seront mises en forme sur une page logique. Soit un encadrement itératif comportant de nombreuses instances. Pour améliorer la présentation de votre état, vous préférez avoir au moins trois instances de l'encadrement itératif sur une page logique donnée. Pour être certain de ne jamais avoir plus de trois instances sur une page logique, définissez à 3 la propriété d'enregistrements par page.

Valeurs

un nombre entier compris entre 1 et 32 Ko	Indique le nombre maximum d'instances qui pourront être mises en forme sur une page logique.
Blanc	Indique que le système pourra mettre en forme autant d'instances de l'encadrement itératif que possible sur une page logique.
S'applique à encadrements itératifs

Obligatoire/Facultatif  facultatif

Valeur par défaut  blanc


Nbre max d'enregistrements par page - Exemple

  Rubriques connexes 	  Tous les exemples

Vous voulez que chaque instance d'un encadrement itératif se trouve seule sur une page logique. Commencez par définir Nbre max d'enregistrements par page à 1 pour l'encadrement itératif, afin que chaque page logique ne comporte qu'une instance, puis indiquez Saut de page avant et Saut de page après pour être certain que la première instance de l'encadrement itératif commence sur une nouvelle page logique.


propriété Nbre min d'enregistrements veufs
Nbre min d'enregistrements veufs

  Restrictions 	  Exemples

Description  Cette propriété permet d'indiquer le nombre minimum d'instances qui doivent apparaître sur la page logique sur laquelle l'encadrement itératif commence à s'imprimer. Si le nombre d'instances, indiqué pour cette propriété, ne peut pas tenir sur la page logique sur laquelle l'encadrement itératif doit au départ s'imprimer, l'encadrement itératif commencera à être mis en forme sur la page suivante. SI cette propriété est définie à 1, il n'y a pas de minimum et l'encadrement itératif commencera à être mis en forme sur toute page logique pouvant recevoir une instance.

Si, pour améliorer la présentation de votre état, vous voulez être certain de ne pas avoir la première instance de l'encadrement itératif imprimée seule au bas d'une page logique, définissez Nbre min d'enregistrements veufs à 2 de façon à avoir au moins deux instances sur la page logique.

Valeurs

un nombre entier compris entre 1 et 32 Ko	Indique le nombre minimum d'instances qui pourront être mises en forme sur une page logique.
Blanc	Indique qu'il n'y a pas de minimum
S'applique à  encadrement itératif

Obligatoire/Facultatif  obligatoire

Valeur par défaut  blanc


Nbre min d'enregistrements veufs - Exemple

  Rubriques connexes 	  Tous les exemples

Vous voulez que toutes les instances d'un encadrement itératif apparaissent sur une page logique. Pour cela, définissez Nbre min d'enregistrements veufs à une valeur très élevée. Si toutes les instances ne peuvent pas tenir sur la première page logique sur laquelle l'encadrement itératif doit s'imprimer, aucune ne sera mise en forme sur cette page et elles seront toutes mises en forme sur la page logique suivante. Notez cependant que sur toutes les pages suivantes, la propriété Nbre min d'enregistrements veufs n'est pas prise en compte. Comme vous commencez sur une page vierge, si toutes les instances ne tiennent pas sur cette page logique, elles ne tiendront pas non plus sur les autres pages logiques.


Nbre min d'enregistrements veufs - Restrictions

•	La propriété Nbre min d'enregistrements veufs s'applique uniquement à la première page logique sur laquelle l'objet doit s'imprimer. Cette propriété n'est pas prise en compte sur les pages suivantes.

•	Si la propriété Nbre min d'enregistrements veufs est supérieure au nombre total d'instances de l'encadrement itératif, toutes les instances doivent pouvoir tenir sur la première page logique dans laquelle l'encadrement itératif doit être mis en forme. Sinon, l'encadrement itératif commencera à être mis en forme sur la page suivante.


propriété Orientation d'impression
Orientation d'impression

  Restrictions 	  Exemples

Description  Cette propriété permet d'indiquer le sens dans lequel les différentes instances de l'encadrement itératif apparaissent.

Valeurs

Gauche-droite	Indique que chaque instance de l'encadrement itératif suivant la première est imprimée à droite de la précédente, sur la page logique.
Diag/bas	Indique que chaque instance de l'encadrement itératif suivant la première est imprimée à droite de la précédente, jusqu'à ce qu'une instance ne puisse pas tenir complètement entre l'instance précédente et la marge droite de la page logique. A ce stade, Report Builder imprime l'instance sous l'instance de gauche de la page logique, à condition qu'il y ait suffisamment de place en hauteur pour que l'instance s'imprime complètement sur cette page.
Vers le bas	Indique que chaque instance de l'encadrement itératif suivant la première est imprimée sous l'instance précédente, sur la page logique.
Bas/diag	Indique que chaque instance de l'encadrement itératif suivant la première est imprimée sous la précédente jusqu'à ce qu'une instance ne puisse pas tenir complètement dans la marge du bas de la page logique. A ce stade, Report Builder imprime l'instance à droite de l'instance du haut de la page logique, à condition qu'il y ait suffisamment de place pour que l'instance soit imprimée complètement sur cette page.
S'applique à encadrements itératifs

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Vers le bas


Orientation d'impression Gauche-droite/Vers le bas - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un encadrement itératif dont l'Orientation d'impression est définie à Gauche-droite/Vers le bas. Les instances de l'encadrement itératif s'impriment de gauche à droite, puis de haut en bas.

 Cliquez ici.

 Cliquez ici.

Cependant, s'il y a un objet (par exemple, un graphique) sur une page qui empêche deux instances de l'encadrement itératif de se positionner de gauche à droite de la page, les instances de l'encadrement itératif ne s'imprimeront que de haut en bas. S'il y a suffisamment de place pour imprimer plusieurs instances de gauche à droite, les instances de l'encadrement itératif commencent à s'imprimer de gauche à droite, puis de haut en bas.

 Cliquez ici.

 Cliquez ici.


Orientation d'impression - Restrictions

•	Si vous avez défini la propriété Orientation d'impression d'un encadrement itératif imbriqué sur Gauche-droite et celle de l'encadrement itératif qui l'entoure sur Vers le bas, l'encadrement itératif Gauche-droite peut, s'il est trop large pour la page en cours, entraîner un dépassement. La prochaine instance de l'encadrement itératif extérieur dont l'orientation d'impression est vers le bas ne sera imprimée que lorsque les instances précédentes de l'encadrement itératif Gauche-droite seront imprimées. Remarque : Si vous voulez que A3 de la page 1 soit aligné sur le dépassement de A3 de la page 2, utilisez Mode colonne.

 Cliquez ici.

•	Les encadrements itératifs de dimensions de matrice dont les groupes source sont dans la même hiérarchie de "famille" (c'est-à-dire sont des descendants ou des ancêtres les uns des autres) dans un groupe inter-produit, doivent avoir la même Orientation d'impression. Les relations père-fils dans un groupe inter-produit sont utilisées pour créer l'imbrication de la matrice. Les encadrements itératifs associés à ces groupes doivent donc s'imprimer selon la même orientation sur la page.


Propriété Source
Source

Description  Cette propriété permet d'indiquer le groupe qui est propriétaire des données de l'encadrement itératif. Sélectionnez un nom de groupe valide.

S'applique à encadrements itératifs

Obligatoire/Facultatif  obligatoire

Notes d'utilisation

•	Source ne peut pas être un groupe inter-produit.


propriété Espacement vert. entre encadrements
Espacement vert. entre encadrements

  Restrictions

Description  Cette propriété permet d'indiquer l'espace (exprimé dans l'unité de mesure de l'état) qui doit séparer verticalement les instances de l'encadrement itératif. Entrez un nombre supérieur ou égal à zéro. Le maximum dépend de l'unité de mesure utilisée. Pour les pouces, il est de 512, pour les centimètres, il est de 1312 et pour les picas, il est de 36864.

 Cliquez ici.

S'applique à encadrements itératifs

Obligatoire/Facultatif  obligatoire

Valeur par défaut  0


Espacement vert. entre encadrements - Restrictions

•	Lorsque la propriété Orientation d'impression est définie à Gauche-droite, cette propriété est sans effet.

•	Lorsque la propriété Orientation d'impression est définie à Gauche-droite /Vers le bas, cette propriété conditionne l'espace séparant les instances situées les unes en dessous des autres.


Notez que A3 comporte trop d'instances de B pour qu'elles tiennent sur la première page logique. A3 déborde donc sur la deuxième page logique et A4 ne peut commencer que lorsque A3 est terminée.


Ces figures illustrent l'impact de la propriété Mode colonne sur la mise en forme des instances des encadrements itératifs. L'instance 3 commence à être mise en forme sur la page 1 et ne se termine qu'à la page 2. En outre, lorsqu'une instance déborde sur une autre page, le dépassement est aligné d'une page sur l'autre. Sur la figure, l'instance 3 apparaît à la même position relative de la page 2 qu'à la page 1.


Sur cette figure, l'instance 3 commence à être mise en forme sur la page 2 car l'instance ne se termine que sur la page 2. En outre, si une instance déborde, le dépassement n'est pas aligné d'une page sur l'autre. Sur la figure, l'instance 3 est mise en forme sur le côté droit de la page 1 et son dépassement sur le côté gauche de la page 2.


Cette figure constitue un exemple de présentation dans lequel vous pouvez utiliser la propriété Mode colonne. (Si vous avez défini la propriété Elasticité horizontale X à Fixe.)


Cette figure représente les instances 1 à 3 si la propriété Mode colonne de l'encadrement itératif X est définie à Oui. Le positionnement est le même sur les pages logiques 1 et 2, même si l'instance 2 s'est terminée sur la page logique 2. Notez que la largeur de la page logique limite le nombre d'instances dont la mise en forme peut commencer sur la page 1. Les instances 4 et 5 sont donc mises en forme sur la page 3.


Cette figure représente l'emplacement des instances 1 à 5 si la propriété Mode colonne de l'encadrement itératif X n'est pas définie à Oui. L'instance 2 s'achève à une position différente sur la page logique : l'instance 3, qui ne s'est pas terminée sur la page logique 1, se trouve à un emplacement différent sur la page 2 et sur la page 1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Propriétés d'état

Type Après formulaire

Valeur Après formulaire

Type Après page

Valeur Après page

Type Après état

Valeur Après état

Type Avant formulaire

Valeur Avant formulaire

Type Avant page

Valeur Avant page

Type Avant état

Valeur Avant état

Commentaires

Concevoir en unités caractère

Orientation

Désactiver l'option de menu hôte

Désactiver la touche Ecran partagé

Désactiver la touche zoom

Diffusion

Hauteur (fenêtre Grille de paramètres)

Inclure bordures

Inclure objets bitmap

Corps - nbre de pages horizontales max

Corps - nbre de pages verticales max

Nom

Nombre de pages

Type Contrôle de navigation de page

Valeur Contrôle de navigation de page

Ordre d'impression écran

Texte de ligne d'aide de l'aperçu

Texte de ligne d'état de l'aperçu

Nom de rôle

Supprimer le titre de l'aperçu

Démarrer sur le zoom

Titre

Unité de mesure

Utiliser ligne d'aide de l'aperçu

Utiliser ligne d'état de l'aperçu

Largeur (fenêtre Grille de paramètres)

Balise XML

Attributs de balise XML

Type de prologue XML

Valeur du prologue XML


propriété Unité de mesure
Unité de mesure

Description   La propriété Unité de mesure indique la mesure standard utilisée pour définir les dimensions de l'état et de la grille de paramètres.

Valeurs

Centimètre

Pouce

Point 	Taille de la police imprimante qui aboutit à un pica. Chaque pica contient douze points et équivaut à un sixième de pouce.

Application  Etats

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Pouce


propriété Corps - nbre de pages horizontales max
Corps - nbre de pages horizontales max

Description   La propriété Corps - nbre de pages horizontales max indique le nombre maximum de pages de corps en largeur que vous voulez voir apparaître dans votre état.

Valeurs  Tout nombre entier de 1 à 999

Application  Etats

Obligatoire/Facultatif  obligatoire

Valeur par défaut  10


propriété Corps - nbre de pages verticales max
Corps - nbre de pages verticales max

Description   La propriété Corps - nbre de pages verticales max indique le nombre maximum de pages de corps en hauteur que vous voulez voir apparaître dans votre état.

Valeurs  Tout nombre entier de 1 à 999

Application  Etats

Obligatoire/Facultatif  obligatoire

Valeur par défaut  10


propriété Ordre d'impression écran
Ordre d'impression panneau

Description   La propriété Ordre d'impression écran est l'ordre selon lequel les pages physiques formant une page logique doivent s'imprimer. Il détermine également l'ordre de numérotation des panneaux dans la page logique. La figure ci-après présente les pages logiques, les pages physiques et les panneaux.

 Cliquez ici.

Valeurs

Diag/bas	Les pages physiques du corps de l'état s'impriment de gauche à droite puis de haut en bas.
Bas/diag	Les pages physiques du corps de l'état s'impriment de haut en bas puis de gauche à droite.
Application  Etats

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Diag/bas


propriété Orientation
Orientation

  Restrictions

Description   La propriété Orientation vous permet d'indiquer l'ordre de lecture de l'état dans son ensemble. La valeur de la propriété Orientation sert de valeur par défaut pour les objets de présentation de l'état (champs, objets standard, etc.). Cette propriété contrôle également l'orientation de l'Editeur d'état (par exemple, si la propriété Orientation a pour valeur Droite-gauche, l'orientation de l'Editeur d'état sera de droite à gauche). Cela signifie que vous n'avez pas besoin de déplacer les objets manuellement pour simuler une orientation de droite à gauche dans l'Editeur d'état.

Valeurs

Gauche-droite

Droite-gauche

Application  Etats

Obligatoire/Facultatif  obligatoire

Valeur par défaut  Orientation naturelle de l'écriture dans la langue.


Orientation - Restrictions

•	Le changement d'orientation de l'état ou de tout objet ne prend effet que lors de l'exécution sur une plate-forme bidirectionnelle.


Propriété Diffusion (état)
Diffusion

Description  La propriété Diffusion utilise les valeurs définies dans la boîte de dialogue de diffusion pour définir la diffusion de l'état dans son intégralité.

Application  Etats

Obligatoire/Facultatif  facultatif


propriété Titre
Titre

Description   Le Titre est le texte qui apparaît en haut de l'état dans la vue Aperçu interactif. Pour modifier le titre par défaut, entrez le texte de votre choix dans le champ prévu à cet effet.

Valeurs  Entrez une chaîne alphanumérique ne dépassant pas 256 octets. Pour restaurer le titre par défaut, il vous suffit de supprimer le texte que vous avez entré.

Application  Etats


propriété Nom de rôle
Nom de rôle

  Restrictions	  Related Topics

Description  La propriété Nom de rôle indique le rôle de base de données à définir pour l'état au moment de l'exécution. Vous pouvez recourir à cet option pour donner à l'utilisateur final la possibilité d'exécuter des états interrogeant des tables de base de données auxquelles il n'a normalement pas le droit d'accéder. Reports Runtime ne peut définir un rôle que s'il est autorisé dans la base de données. Si Reports Runtime ne peut définir de rôle, l'état n'est pas exécuté.

Valeurs   Entrez un rôle de base de données valide ne dépassant pas 30 caractères.

Application  Etats

Obligatoire/Facultatif  facultatif

Valeur par défaut  Le ou les rôle(s) par défaut indiqués pour l'utilisateur dans la base de données, qui sont définis lorsque l'utilisateur se connecte à la base de données.

Notes d'utilisation

•	Vous pouvez définir la propriété Nom de rôle dans la Palette de propriétés pour l'état ; pour définir (le cas échéant) un mot de passe de rôle, cliquez deux fois sur le bouton dans le champ de valeur Nom de rôle pour afficher la boîte de dialogue de définition de rôle.

•	Si vous indiquez un rôle utilisant la ligne de commande avec Reports Runtime (RWRUN60), il remplace les paramètres de rôle dans l'état.

•	Vous ne pouvez définir qu'un seul rôle par état. Pour définir plusieurs rôles, vous devez définir un rôle auquel les autres rôles sont autorisés.


Nom de rôle - Restrictions

•	La définition d'un rôle dans un déclencheur PL/SQL peut entraîner des conflits et n'est donc pas recommandée.


propriété Largeur (fenêtre Grille de paramètres)
Largeur (fenêtre Grille de paramètres)

  Restrictions

Description  La propriété Largeur indique la largeur d'une page de grille de paramètres, exprimée dans l'unité de mesure.

Valeurs  Saisissez une largeur valide supérieure ou égale à zéro. La largeur maximale dépend de l'unité de mesure. Elle est de 512 pouces, de 1 312 centimètres ou de 36 864 points.

Application  Etats

Obligatoire/Facultatif  obligatoire

Valeur par défaut  4 pouces, 10 centimètres ou 300 points.


Largeur (fenêtre Grille de paramètres) - Restrictions

•	Si vous changez d'unité de mesure après avoir déjà indiqué la largeur, celle-ci est automatiquement convertie en une largeur approximativement égale dans la nouvelle unité de mesure.


propriété Hauteur (fenêtre Grille de paramètres)
Hauteur (fenêtre Grille de paramètres)

  Restrictions

Description  La propriété Hauteur indique la hauteur d'une page de grille de paramètres, exprimée dans l'unité de mesure.

Valeurs  Saisissez une hauteur valide supérieure ou égale à zéro. La hauteur maximale dépend de l'unité de mesure. Elle est de 512 pouces, de 1 312 centimètres ou de 36 864 points.

Application  Etats

Obligatoire/Facultatif  obligatoire

Valeur par défaut  4 pouces, 10 centimètres ou 300 points.


Hauteur (fenêtre Grille de paramètres) - Restrictions

•	Si vous changez d'unité de mesure après avoir déjà indiqué la hauteur, celle-ci est automatiquement convertie en une hauteur approximativement égale dans la nouvelle unité de mesure.


propriété Nombre de pages
Nombre de pages

Description  La propriété Nombre de pages indique le nombre total de pages désiré dans la grille de paramètres d'exécution.

Valeurs  Tout nombre entier de 1 à 9.999

Application  Etats

Obligatoire/Facultatif  obligatoire

Valeur par défaut  1


propriété Type Contrôle de navigation de page
Type Contrôle de navigation de page

 Rubriques connexes

Description Cette propriété indique la manière dont sera défini le script de création des boutons de navigation pour les états au format pages HTML.

Valeurs

Fichier	Tout fichier texte valide contenant du code de génération de script HTML permettant de créer des contrôles de navigation de page.
Texte	Toute chaîne de texte contenant du code de génération de script HTML permettant de créer des contrôles de navigation de page.
Application  Etats au format pages HTML ou HTMLCSS

Obligatoire/Facultatif  facultatif

Valeur par défaut  Texte

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET_PAGE_NAVIGATION_HTML.


propriété Valeur Contrôle de navigation de page
Valeur Contrôle de navigation de page

 Rubriques connexes

Description  La propriété Valeur Contrôle de navigation de page indique le nom de fichier ou le code de script correspondant aux boutons de navigation d'un état au format pages HTML.

Valeurs  Tout nom de fichier valide ou toute chaîne de texte contenant des commandes HTML valides, selon l'option Type Contrôle de navigation de page définie. Vous pouvez cliquer sur le champ de valeur (libellé …) pour modifier les commandes JavaScript intégrées selon vos besoins.

Application  Etats au format pages HTML ou HTMLCSS

Obligatoire/Facultatif  facultatif

Valeur par défaut  Commandes JavaScript intégrées Report Builder

Notes d'utilisation

Si vous choisissez d'utiliser votre propre script de génération de contrôles de navigation, vous devez inclure dans votre script trois variables :

•	&TotalPages (nombre total de pages)

•	&file_name (nom du fichier de destination de la sortie, par exemple, monétat)

•	&file_ext (extension du fichier ; par exemple, htm)

Report Builder affecte des valeurs à ces variables au cours de la mise en forme.

La hauteur de l'encadrement des contrôles de navigation de page est codée en dur en 70 points sans barre de défilement. La largeur de cet encadrement est variable. Pour y utiliser des icônes et des images, gardez ces dimensions à l'esprit.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET_PAGE_NAVIGATION_HTML.


propriété Type Avant état
Type Avant état

 Rubriques connexes

Description  La propriété Type Avant état indique le type d'en-tête qui apparaîtra au début de votre document lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Si vous générez un état au format pages HTML, cette propriété s'applique à la première page de votre état. Pour l'appliquer à tout l'état (par exemple, pour modifier la couleur de fond ou les images, ou tout autre attribut HTML <body>), vous devez utiliser la propriété Avant page.

Valeurs

Texte	Toute chaîne de texte contenant des commandes HTML valides.
Fichier	Tout fichier texte ou graphique valide.
Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué une Valeur Avant état.

Valeur par défaut  Texte

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET BEFORE REPORT HTML.


propriété Valeur Avant état
Valeur Avant état

  Restrictions	  Exemples	 Rubriques connexes

Description  La propriété Valeur Avant état indique un en-tête qui apparaîtra au début de votre document lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Si vous générez un état au format pages HTML, cette propriété s'applique à la première page de votre état. Pour l'appliquer à tout l'état (par exemple, pour modifier la couleur de fond ou les images, ou tout autre attribut HTML <body>), vous devez utiliser la propriété Avant page.

Valeurs  Tout nom de fichier valide ou une chaîne de texte contenant des commandes HTML valides, selon ce que vous avez indiqué comme Type Avant état.

Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué Fichier comme Type Avant état.

Valeur par défaut  Les commandes HTML par défaut incluses au début d'un état :

<html>
<body bgcolor="#ffffff">

Notes d'utilisation

•	Cette propriété est particulièrement utile pour insérer un logo ou des liens standard au début d'un document HTML.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET BEFORE REPORT HTML.


Valeur Avant état - Restrictions

•	Si vous remplacez le texte par défaut, assurez-vous que le nouveau texte contient les commandes HTML équivalentes.


propriété Type Après état
Type Après état

 Rubriques connexes

Description  La propriété Type Après état indique le type de page de fin qui apparaîtra à la fin de votre document lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Si vous générez un état au format pages HTML, cette propriété s'applique à la dernière page de votre état. Pour l'appliquer à tout l'état (par exemple, pour modifier la couleur de fond ou les images, ou tout autre attribut HTML <body>), vous devez utiliser la propriété Avant page.

Valeurs

Texte	Toute chaîne de texte contenant des commandes HTML valides.
Fichier	Tout fichier texte ou graphique valide.
Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué une Valeur Après état.

Valeur par défaut  Texte

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET AFTER REPORT HTML.


propriété Valeur Après état
Valeur Après état

  Restrictions	  Exemples	 Rubriques connexes

Description  La propriété Valeur Après état indique une page de fin qui apparaîtra à la fin de votre document lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web..

Si vous générez un état au format pages HTML, cette propriété s'applique à la dernière page de votre état. Pour l'appliquer à tout l'état (par exemple, pour modifier la couleur de fond ou les images, ou tout autre attribut HTML <body>), vous devez utiliser la propriété Avant page.

Valeurs  Tout nom de fichier valide ou une chaîne de texte contenant des commandes HTML valides, selon ce que vous avez indiqué comme Type Après état.

Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué Fichier comme Type Après état.

Valeur par défaut  Les commandes HTML par défaut incluses à la fin d'un état :

</body></html>

Notes d'utilisation

•	Cette propriété est particulièrement utile pour insérer un logo ou des liens standard à la fin d'un document HTML.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET AFTER REPORT HTML.


Valeur Après état - Restrictions

•	Si vous remplacez le texte par défaut, assurez-vous que le nouveau texte contient les commandes HTML équivalentes.


propriété type Avant page
Type Avant page

 Rubriques connexes

Description  La propriété Type Avant page indique le type d'en-tête qui apparaîtra au début de chaque page de votre document lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Si vous générez un état au format pages HTML, cette propriété s'applique à toutes les pages de votre état (par exemple, pour modifier la couleur de fond ou les images, ou tout autre attribut HTML <body>). Pour l'appliquer uniquement à la première page (page d'en-tête) ou à la dernière page (page de fin) de votre état, vous devez utiliser respectivement les propriétés Avant état ou Après état.

Valeurs

Texte	Toute chaîne de texte contenant des commandes HTML valides.
Fichier	Tout fichier texte ou graphique valide.
Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué une Valeur Avant page.

Valeur par défaut  Texte

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET BEFORE PAGE HTML.


propriété Valeur Avant page
Valeur Avant page

  Exemples	 Rubriques connexes

Description  La propriété Valeur Avant page indique l'en-tête qui apparaîtra au début de chaque page de votre document lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Si vous générez un état au format pages HTML, cette propriété s'applique à toutes les pages de votre état (par exemple, pour modifier la couleur de fond ou les images, ou tout autre attribut HTML <body>). Pour l'appliquer uniquement à la première page (page d'en-tête) ou à la dernière page (page de fin) de votre état, vous devez utiliser respectivement les propriétés Avant état ou Après état.

Valeurs  Tout nom de fichier valide ou une chaîne de texte contenant des commandes HTML valides, selon ce que vous avez indiqué comme Type Avant page.

Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué Fichier comme Type Avant page.

Valeur par défaut  blanc

Notes d'utilisation

•	Cette propriété est particulièrement utile pour insérer un logo ou des liens standard au début de chaque page d'un document HTML.

•	Si vous souhaitez que cette valeur ne s'applique qu'à la page en cours, vous pouvez l'indiquer dans un déclencheur de mise en forme pour un objet de cette page.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET BEFORE PAGE HTML.


propriété Type Après page
Type Après page

 Rubriques connexes

Description  La propriété Type Après page indique le type de pied de page qui apparaîtra à la fin de chaque page de votre document lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Si vous générez un état au format pages HTML, cette propriété s'applique à toutes les pages de votre état (par exemple, pour modifier la couleur de fond ou les images, ou tout autre attribut HTML <body>). Pour l'appliquer uniquement à la première page (page d'en-tête) ou à la dernière page (page de fin) de votre état, vous devez utiliser respectivement les propriétés Avant état ou Après état.

Valeurs

Texte	Toute chaîne de texte contenant des commandes HTML valides.
Fichier	Tout fichier texte ou graphique valide.
Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué une Valeur Après page.

Valeur par défaut  Texte

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET AFTER PAGE HTML.


propriété Valeur Après page
Valeur Après page

  Restrictions	  Exemples	 Rubriques connexes

Description  La propriété Valeur Après page indique le pied de page qui apparaîtra à la fin de chaque page de votre document lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Si vous générez un état au format pages HTML, cette propriété s'applique à toutes les pages de votre état (par exemple, pour modifier la couleur de fond ou les images, ou tout autre attribut HTML <body>). Pour l'appliquer uniquement à la première page (page d'en-tête) ou à la dernière page (page de fin) de votre état, vous devez utiliser respectivement les propriétés Avant état ou Après état.

Valeurs  Tout nom de fichier valide ou une chaîne de texte contenant des commandes HTML valides, selon ce que vous avez indiqué comme Type Après page.

Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué Fichier comme Type Après page.

Valeur par défaut  Les commandes HTML par défaut incluses à la fin d'une page :

<hr size=5 noshade>

Notes d'utilisation

•	Cette propriété est particulièrement utile pour insérer un logo ou des liens standard à la fin de chaque page d'un document HTML.

•	Si vous souhaitez que cette valeur ne s'applique qu'à la page en cours, vous pouvez l'indiquer dans un déclencheur de mise en forme pour un objet de cette page.

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET AFTER PAGE HTML.


Valeur Après page - Restrictions

•	Si vous remplacez le texte par défaut, assurez-vous que le nouveau texte contient les commandes HTML équivalentes.


propriété Type Avant formulaire
Type Avant formulaire

Description  La propriété Type Avant formulaire indique le type d'en-tête qui apparaîtra au début de votre grille de paramètres d'exécution lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Valeurs

Texte	Toute chaîne de texte contenant des commandes HTML valides.
Fichier	Tout fichier texte ou graphique valide.
Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué une Valeur Avant formulaire.

Valeur par défaut  Texte

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET BEFORE FORM HTML.


propriété Valeur Avant formulaire
Valeur Avant formulaire

  Restrictions 	  Exemples

Description  La propriété Valeur Avant formulaire indique l'en-tête qui apparaîtra au début de votre grille de paramètres d'exécution lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Valeurs  Tout nom de fichier valide ou une chaîne de texte contenant des commandes HTML valides, selon ce que vous avez indiqué comme Type Avant formulaire.

Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué Fichier comme Type Avant formulaire.

Valeur par défaut  Les commandes HTML par défaut incluses au début d'une grille de paramètres Runtime :

<html>
<body bgcolor="#ffffff">
<form method=post>
<center>
<p><hr>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td><input type=submit>
<td width=15>
<td><input type=reset>>
</table>
<p><hr><p>

Notes d'utilisation

•	Cette propriété est particulièrement utile pour insérer un logo ou des liens standard au début de la grille de paramètres d'exécution d'un document HTML.

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET BEFORE FORM HTML.


Valeur Avant formulaire - Restrictions

•	Si vous remplacez le texte par défaut, assurez-vous que le nouveau texte contient les commandes HTML équivalentes.


propriété Type Après formulaire
Type Après formulaire

Description  La propriété Type Après formulaire indique le type de pied de page qui apparaîtra à la fin de votre grille de paramètres d'exécution lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Valeurs

Texte	Toute chaîne de texte contenant des commandes HTML valides.
Fichier	Tout fichier texte ou graphique valide.
Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué une Valeur Après formulaire.

Valeur par défaut  Texte

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET_AFTER_FORM_HTML.


propriété Valeur Après formulaire
Valeur Après formulaire

  Restrictions

Description  La propriété Valeur Après formulaire indique le pied de page qui apparaîtra à la fin de votre grille de paramètres d'exécution lors de la sortie de l'état vers un fichier HTML pour affichage dans un navigateur Web.

Valeurs  Tout nom de fichier valide ou une chaîne de texte contenant des commandes HTML valides, selon ce que vous avez indiqué comme Type Après formulaire.

Application  Etats

Obligatoire/facultatif  Obligatoire si vous avez indiqué Fichier comme Type Après formulaire.

Valeur par défaut  Les commandes HTML par défaut incluses à la fin d'une grille de paramètres d'exécution :

</center>
</body>
</form>
</html>

Notes d'utilisation

•	Cette propriété est particulièrement utile pour insérer un logo ou des liens standard à la fin de la Grille des paramètres Runtime d'un document HTML.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET_AFTER_FORM_HTML.


Valeur Après formulaire - Restrictions

•	Si vous remplacez le texte par défaut, assurez-vous que le nouveau texte contient les commandes HTML équivalentes.


propriété Concevoir en unités caractère
Concevoir en unités caractère

Description   La propriété Concevoir en unités caractère indique que l'Editeur d'état et sa grille utilisent des cellules en unités caractère. Cette propriété et la propriété Inclure bordures font que l'Editeur d'état affiche des bordures en mode caractère pour les objets dont la largeur de ligne est supérieure à zéro.

Valeur par défaut  Non


propriété Utiliser ligne d'aide de l'aperçu
Utiliser ligne d'aide de l'aperçu

Description  La ligne d'aide de l'aperçu est la ligne qui apparaît en vue Aperçu interactif sur l'avant-dernière ligne de votre écran. Pour modifier la ligne d'aide par défaut, sélectionnez Oui, puis entrez le texte de votre choix dans la propriété Texte de ligne d'aide de l'aperçu.

Valeurs  Si égale à Oui, entrez votre texte dans la propriété Texte de ligne d'aide de l'aperçu.

Application  Etats

Valeur par défaut  Non

Notes d'utilisation

•	Pour restaurer la ligne d'aide par défaut, supprimez le texte d'aide que vous avez entré dans la propriété Texte de ligne d'aide de l'aperçu et attribuez la valeur Non à la propriété Utiliser ligne d'aide de l'aperçu.


propriété Texte de ligne d'aide de l'aperçu
Texte de ligne d'aide de l'aperçu

Description  La ligne d'aide de l'aperçu est la ligne qui apparaît en vue Aperçu interactif sur l'avant-dernière ligne de votre écran.

Valeurs  Entrez une chaîne alphanumérique ne dépassant pas 80 caractères.

Application  Etats


propriété Utiliser ligne d'état de l'aperçu
Utiliser ligne d'état de l'aperçu

  Restrictions

Description La ligne d'état de l'aperçu est la dernière ligne de la vue Aperçu interactif. Pour modifier la ligne d'état par défaut, sélectionnez Oui, puis entrez le texte de votre choix dans la propriété Texte de ligne d'état de l'aperçu.

Valeurs  Si égale à Oui, entrez votre texte dans la propriété Texte de ligne d'état de l'aperçu.

Application  Etats

Valeur par défaut  Non

Notes d'utilisation

•	Pour restaurer la ligne d'état par défaut, supprimez le texte d'état que vous avez entré dans la propriété Texte de ligne d'état de l'aperçu et attribuez la valeur Non à la propriété Utiliser ligne d'état de l'aperçu.


Utiliser ligne d'état de l'aperçu - Restrictions

•	Si la ligne d'état de l'aperçu a pour valeur Non, Report Builder ne lui réserve pas de ligne, ce qui vous permet d'afficher à l'écran une ligne supplémentaire de votre état.

•	Lorsque vous modifiez le Texte de ligne d'état de l'aperçu, le nom de l'état n'apparaît dans la ligne d'état que si vous l'entrez vous-même. Vous pouvez par exemple entrer :

Cet état ne s'adresse qu'au personnel des Ressources humaines (Etat : deptinfo).


propriété Texte de ligne d'état de l'aperçu
Texte de ligne d'état de l'aperçu

Description  La ligne d'état de l'aperçu est la dernière ligne de la vue Aperçu interactif.

Valeurs  Entrez une chaîne alphanumérique ne dépassant pas 80 caractères.

Application  Etats


propriété Inclure objets bitmap
Inclure objets bitmap

Description   La propriété Inclure objets bitmap convertit tous les objets bitmap (c'est-à-dire les affichages et objets standard de Graphics Builder, à l'exception du texte, des lignes et des rectangles) en boîtes lors de l'exécution de l'état en mode caractère. Si cette propriété a pour valeur Non, tous les objets bitmap et les points d'ancrage explicites qui leur sont reliés sont supprimés lors de l'exécution de l'état en mode caractère.

Application  Etats

Valeur par défaut  Non


Inclure objets bitmap - Restrictions

  Restrictions

•	Les lignes qui ne sont ni horizontales ni verticales seront toujours converties en lignes horizontales ou verticales en mode caractère, indépendamment de ce paramètre. De même, les rectangles pivotés seront convertis en rectangles non pivotés en mode caractère, indépendamment de ce paramètre.


propriété Inclure bordures
Inclure bordures

Description   La propriété Inclure bordures active les bordures en mode caractère pour tous les objets dont la largeur de ligne est supérieure à zéro en mode bitmap. Si cette propriété a pour valeur Non, toutes les bordures sont désactivées en mode caractère.

Application  Etats

Valeur par défaut  Non

Notes d'utilisation

•	Si cette propriété et la propriété Concevoir  en unités caractère ont toutes deux la valeur Oui, l'Editeur d'état affiche des bordures en mode caractère pour les objets dont la largeur de ligne est supérieure à zéro.


propriété Désactiver l'option de menu hôte
Désactiver l'option de menu hôte

Description  La propriété Désactiver l'option de menu hôte désactive l'option hôte dans le menu Fichier des vues Grille de paramètres d'exécution et Aperçu interactif. L'option hôte apparaît dans le menu Fichier de Report Builder en mode caractère.

Application  Etats

Valeur par défaut  Non


propriété Désactiver la touche Ecran partagé
Désactiver la touche Ecran partagé

Description   La propriété Désactiver la touche Ecran partagé désactive les touches de fonction [Partage vertical] et [Partage horizontal].

Application  Etats

Valeur par défaut  Non


propriété Désactiver la touche Zoom
Désactiver la touche Zoom

  Restrictions

Description  La propriété Désactiver la touche Zoom désactive la touche de fonction [Zoom avant/Zoom arrière] dans la vue Aperçu interactif.

Application  Etats

Valeur par défaut  Non


Désactiver la touche Zoom - Restrictions

•	Cette fonction est uniquement disponible sous UNIX.

•	Si les propriétés Désactiver la touche Zoom et Démarrer sur le zoom ont toutes deux pour valeur Oui, la vue Aperçu interactif s'affichera avec le zoom activé et vous ne pourrez pas le désactiver.


propriété Démarrer sur le zoom
Démarrer sur le zoom

  Restrictions

Description  La propriété Démarrer sur le zoom affiche la vue Aperçu interactif avec le zoom activé (c'est-à-dire que la bordure qui apparaît normalement autour de l'Aperçu interactif n'est pas visible et que vous ne voyez que le document de l'état).

Application  Etats

Valeur par défaut  Non


Démarrer sur le zoom - Restrictions

•	Cette fonction est uniquement disponible sous UNIX.

•	Si les propriétés Désactiver la touche Zoom et Démarrer sur le zoom ont toutes deux pour valeur Oui, la vue Aperçu interactif s'affichera avec le zoom activé et vous ne pourrez pas le désactiver.


propriété Supprimer le titre de l'aperçu
Supprimer le titre de l'aperçu

Description  La propriété Supprimer le titre de l'aperçu permet de supprimer l'affichage du titre dans la vue Aperçu interactif.

Application  Etats

Valeur par défaut  Oui


L'ordre d'impression des pages physiques pour chaque page logique sera le suivant :


La langue est définie par les variables d'environnement NLS.


Propriétés d'interrogation de curseur de référence

Commentaire

Nombre maximum de lignes à extraire

Nom

Instruction PL/SQL

Type


Propriété Instruction PL/SQL
Instruction PL/SQL

  Rubriques connexes

Description  La propriété Instruction PL/SQL est un bouton qui permet d'afficher l'Editeur PL/SQL. Vous pouvez y entrer une fonction PL/SQL faisant appel à un curseur de référence pour retourner des données.

S'applique à  interrogations

Obligatoire/facultatif  Obligatoire


Pour obtenir de l'aide sur l'une des propriétés répertoriées sous ce noeud, cliquez sur la propriété, puis appuyez sur F1. Pour obtenir de l'aide concernant la palette de propriétés elle-même, maintenez la touche Ctrl enfoncée tout en cliquant sur les propriétés sélectionnées pour les désélectionner, puis appuyez sur F1.


Propriétés des sections

Diffusion

Hauteur

Panneaux horizontaux par page

Orientation

Hauteur de l'état

Largeur de l'état

Panneaux verticaux par page

Largeur


Propriété Diffusion (section)
Diffusion

Description  La propriété Diffusion utilise les valeurs de la boîte de dialogue Diffusion pour définir la diffusion de la section en cours.

Application  sections

Obligatoire/Facultatif  facultatif


Propriété Hauteur (section)
Hauteur

  Restrictions

Description  La propriété Hauteur correspond à la hauteur d'une page physique (marge incluse) dans l'unité de mesure choisie (par exemple, 11 pouces).

Valeurs  Saisissez une hauteur valide supérieure ou égale à zéro. La hauteur maximale dépend de l'unité de mesure. Elle est de 512 pouces, de 1 312 centimètres ou de 36 864 points.

Application  sections

Obligatoire/Facultatif  obligatoire

Valeur par défaut  27,94 cm


Hauteur - Restrictions (section)
Hauteur - Restrictions

•	La page doit être suffisamment grande pour contenir la section. Par exemple, si un encadrement figurant dans une section s'étend jusqu'à dépasser la valeur de Hauteur, l'état n'est pas exécuté.

•	Si vous changez d'unité de mesure après avoir défini la hauteur, celle-ci change automatiquement pour prendre une valeur équivalente dans la nouvelle unité de mesure.

•	Si vous modifiez la largeur ou la hauteur de la page physique, les dimensions de la page logique sont modifiées en conséquence afin que les dimensions de la marge soient préservées chaque fois que possible.

Attention : Sur certaines imprimantes, la zone d'impression de la page physique est limitée. Par exemple, l'imprimante peut accepter des feuilles de papier de 8,5 x 11 pouces, mais elle ne peut imprimer que sur une zone de 8 x 10,5 pouces. Si vous définissez une largeur et une hauteur supérieures à la zone d'impression admise par l'imprimante, votre sortie d'état peut être tronquée. Pour éviter cela, vous pouvez augmenter la zone d'impression de votre imprimante (si votre système d'exploitation le permet) ou définir une largeur et une hauteur correspondant à la taille de la zone d'impression de la page.

•	Vous pouvez remplacer les dimensions d'une page en entrant des valeurs différentes pour le paramètre PAGESIZE sur la ligne de commande.

•	Par défaut, la marge du haut et celle du bas sont toutes deux d'un demi pouce.


propriété Panneaux horizontaux par page
Panneaux horizontaux par page

  Exemples

Description  La propriété Panneaux horizontaux par page correspond à la largeur de la page logique (la page de l'état) en pages physiques (pages de l'imprimante). Par exemple, si la propriété Panneaux horizontaux par page vaut 1, la largeur de chaque page logique correspond à celle d'une page physique.

Valeurs  Tout nombre entier de 1 à 50

Application  sections

Obligatoire/Facultatif  obligatoire

Valeur par défaut  1


Panneaux horizontaux/verticaux par page - Exemple

Les panneaux représentent les pages physiques dans une page logique. Dans cet exemple, une page logique se compose de six pages physiques. La largeur de la page logique correspond à trois pages physiques et sa hauteur à deux pages physiques. Par conséquent, la valeur de Panneaux horizontaux par page est de 3 et celle de Panneaux verticaux par page, de 2. Pour que la largeur de la page logique soit de deux pages physiques et que sa hauteur soit de trois pages physiques, définissez Panneaux horizontaux par page sur 2 et Panneaux verticaux par page, sur 3.

 Cliquez ici.


Propriété Orientation (section)
Orientation

  Restrictions

Description  La propriété Orientation indique si la sortie de la section se fait au format portrait ou au format paysage. Ce paramètre remplace l'orientation définie par le paramètre ORIENTATION de la ligne de commande, par le paramètre système ou par la boîte de dialogue Mise en page.

Valeurs

Valeur par défaut	Orientation définie par le paramètre ORIENTATION de la ligne de commande, par le paramètre système ou par la boîte de dialogue Mise en page.
Portrait	Sortie verticale de la section.
Paysage	Sortie horizontale de la section.
Application  sections

Obligatoire/Facultatif  facultatif

Valeur par défaut  Valeur par défaut


Restrictions d'orientation

•	Les paramètres d'orientation sont ignorés lorsque vous imprimez des états sur une imprimante PCL fonctionnant sous Motif. L'état est traité avec les paramètres par défaut.


propriété Hauteur de l'état
Hauteur de l'état

  Restrictions

Description  La propriété Hauteur de l'état correspond à la hauteur de page de votre état exprimée en nombre de caractères.

Valeurs  Tout nombre entier de 1 à 9 999

Application  sections

Obligatoire/Facultatif  obligatoire

Valeur par défaut  80 caractères


Hauteur de l'état - Restrictions

•	Lors de l'affichage d'un état en mode caractère dans l'Aperçu bitmap interactif, Report Builder utilise ce paramètre pour choisir la police à afficher. La police peut être légèrement plus grande ou plus petite que la taille réelle de la cellule des caractères. De ce fait, les caractères risquent d'être tronqués.


propriété Largeur de l'état
Largeur de l'état

  Restrictions

Description  La propriété Largeur de l'état correspond à la largeur de votre page d'état en nombre de caractères.

Valeurs  Tout nombre entier de 1 à 9 999

Application  sections

Obligatoire/Facultatif  obligatoire

Valeur par défaut  66 caractères


Largeur d'état - Restrictions

•	Lors de l'affichage d'un état en mode caractère dans l'Aperçu bitmap interactif, Report Builder utilise ce paramètre pour choisir la police à afficher. La police peut être légèrement plus grande ou plus petite que la taille réelle de la cellule des caractères. De ce fait, les caractères risquent d'être tronqués.


propriété Panneaux verticaux par page
Panneaux verticaux par page

  Exemples

Description  La propriété Panneaux verticaux par page correspond à la hauteur de la page logique (page d'état) en pages physiques (pages d'imprimante). Ainsi, si la propriété Panneaux verticaux par page a pour valeur 1, chaque page logique a pour hauteur une page physique.

Valeurs  Tout nombre entier de 1 à 50

Application  sections

Obligatoire/Facultatif  obligatoire

Valeur par défaut  1


Propriété Largeur (section)
Largeur

  Restrictions

Description  La propriété Largeur correspond à la largeur d'une page physique (marge incluse) dans l'unité de mesure choisie (par exemple, 8,5 pouces).

Valeurs  Saisissez une largeur valide supérieure ou égale à zéro. La largeur maximale dépend de l'unité de mesure. Elle est de 512 pouces, de 1 312 centimètres ou de 36 864 points.

Application  sections

Obligatoire/Facultatif  obligatoire

Valeur par défaut  21,59 cm


Largeur - Restrictions (section)
Largeur - Restrictions

•	La page doit être suffisamment grande pour contenir la section. Par exemple, si un encadrement figurant dans une section s'étend jusqu'à dépasser la valeur de Largeur, l'état n'est pas exécuté.

•	Si vous changez d'unité de mesure après avoir défini la largeur, celle-ci change automatiquement pour prendre une valeur équivalente dans la nouvelle unité de mesure.

•	Si vous modifiez la largeur ou la hauteur de la page physique, les dimensions de la page logique sont modifiées en conséquence afin que les dimensions de la marge soient préservées chaque fois que possible.

Attention : Sur certaines imprimantes, la zone d'impression de la page physique est limitée. Par exemple, l'imprimante peut accepter des feuilles de papier de 8,5 x 11 pouces, mais elle ne peut imprimer que sur une zone de 8 x 10,5 pouces. Si vous définissez une largeur et une hauteur supérieures à la zone d'impression admise par l'imprimante, votre sortie d'état peut être tronquée. Pour éviter cela, vous pouvez augmenter la zone d'impression de votre imprimante (si votre système d'exploitation le permet) ou définir une largeur et une hauteur correspondant à la taille de la zone d'impression de la page.

•	Vous pouvez remplacer les dimensions d'une page en entrant des valeurs différentes pour le paramètre PAGESIZE sur la ligne de commande.

•	La valeur par défaut de la marge de droite et de celle de gauche est de zéro.


Propriétés des colonnes de tri

  Restrictions

Ordre de ventilation

Type de colonne

Commentaire

Nom de colonne de base de données

Type de données

Exclure de la sortie XML

Format de fichier

Nom

Lecture depuis fichier

Valeur si Null

Largeur

Balise XML

Attributs de balise XML


Restrictions des colonnes de tri

•	Les colonnes de tri sont uniquement disponibles pour les interrogations Express.

•	Seules les dimensions Express disposent de colonnes de tri correspondantes ; les mesures n'en ont pas.

•	Vous pouvez éditer les propriétés des colonnes de tri depuis la vue Modèle de données et le Navigateur d'objet.

•	Lorsque vous déplacez une valeur de dimension vers un autre groupe dans le modèle de données, vous devez déplacer en même temps la colonne de tri correspondante.

•	Les colonnes de tri n'apparaissent pas dans les assistants Données et Etat, ni dans les vues Modèle de présentation et Aperçu interactif.

•	Report Builder crée des colonnes de tri pour chaque dimension dans l'interrogation Express.

•	L'outil Trier du Sélecteur permet de modifier l'ordre des dimensions.


Propriétés de colonne récapitulative

Ordre de ventilation

Type de colonne

Commentaire

Calculer à

Type de données

Exclure de la sortie XML

Fonction

Format de fichier

Nom

Ordre produit

Lecture depuis fichier

Remise à

Définir ordre de ventilation

Source

Valeur si Null

Largeur

Balise XML

Attributs de balise XML


propriété Calculer à
Calculer à

  Restrictions	  Exemples

Description  Cette propriété permet d'indiquer le groupe sur lequel est calculée une colonne récapitulative % du total. Cette propriété est utilisée uniquement pour les colonnes dont la propriété Fonction est % du total. Lorsque vous calculez un pourcentage, vous divisez une valeur par un total (par exemple, salaire de Dupont/total des salaires du département). La propriété Calculer à définit le total pour un calcul de pourcentage. En utilisant ce champ, Report Builder détermine le total dont chaque valeur de colonne source est un pourcentage. Pour les états matriciels, la propriété Calculer à peut se composer de plusieurs groupes.

Valeurs

Page	Permet de calculer la colonne source sous la forme d'un pourcentage du total des valeurs d'une page.
Etat	Permet de calculer la colonne source sous la forme d'un pourcentage du total des valeurs de l'état.
<noms>	Permet de calculer la colonne source sous la forme d'un pourcentage du total des valeurs du ou des groupes.
S'applique à  colonnes récapitulatives

Obligatoire/facultatif  obligatoire, pour les colonnes récapitulatives dont la propriété Fonction est % du total.

Valeur par défaut  Le groupe père du groupe de la colonne récapitulative.


Calculer à état de groupe - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un état qui se présente de la manière suivante :

Nodépt  10    NomD  Comptabilité

 NomE              Sal    %Dépt     % du total

 ----------- ----------   ------   ------

 MARTIN        1300,00    14,86%        6,62%

 CLEMENT       2450,00    28,00%       12,48%

 KARL          5000,00    57,14%       25,48%

Déptno  20    NomD  RECHERCHE

 NomE              Sal    %Dépt     % du total

 ----------- ----------   ------   ------

 SIMON          800,00     7,36%        4,08%

 ADAM          1100,00    10,11%        5,61%

 JEAN          2975,00    27,36%       15,16%

 SCOTT         3000,00    27,59%       15,29%

 FORD          3000,00    27,59%       15,29%

Le groupe père, G_DEPT, contient les colonnes NODEPT et NOMD. Le groupe fils, G_EMP, contient les colonnes NOME et SAL.

Pour avoir un récapitulatif qui calcule le salaire de chaque employé sous la forme d'un pourcentage du total des salaires du département (Pct_Dept), créez une colonne récapitulative dans G_EMP de la manière suivante :

Fonction	Remise à	Calculer à
% du total	G_EMP	G_DEPT
Dans ce cas, la propriété Remise à indique que le récapitulatif doit être remis à Null pour chaque employé, parce que vous voulez un pourcentage par employé. La propriété Calculer à indique que le total des salaires du département est la valeur totale (100 %) qui sera utilisée pour calculer les pourcentages. Notez également que ce récapitulatif est placé dans le groupe G_EMP parce que vous voulez le pourcentage de chaque employé.

Pour obtenir un récapitulatif qui calcule le salaire de chaque employé sous la forme d'un pourcentage du total des salaires de la totalité de l'état (Pct_Total), créez une colonne récapitulative dans G_EMP se présentant de la manière suivante :

Fonction	Remise à	Calculer à
% du total	G_EMP	Etat
Dans ce cas, la propriété Calculer à indique que le total des salaires  de la totalité de l'état est le montant total (100 %) qui sera utilisé pour calculer les pourcentages. Comme avec le récapitulatif Pct_Dept ci-dessus, la propriété Remise à indique que le récapitulatif doit être remis à Null pour chaque employé et doit être placé dans le groupe G_EMP, car vous voulez voir le pourcentage pour chaque employé.


Calculer à état de matrice - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un état matriciel qui se présente comme ci-dessous, auquel vous voulez ajouter des colonnes récapitulatives de pourcentage.

Dépt  Analyste   Employé   Directeur   Total

10              1300      2450    3750

20      6000    1900      2975   10875

30               950      2850    3800

Total    6000                  4150                  8275                 18425

Le groupe G_JOB contient la colonne JOB, G_DEPT contient NODEPT, G_SAL contient TOTSAL et G_CROSS est le groupe inter-produit. (G_CROSS contient tous les récapitulatifs de la matrice.)

Pour obtenir un récapitulatif qui calcule le total des salaires de chaque catégorie d'emploi par département sous la forme d'un pourcentage du total des salaires pour cet emploi dans tous les départements, entrez, pour une colonne récapitulative de G_CROSS, les données suivantes :

Fonction	Remise à	Calculer à	Ordre produit
% du total	G_DEPT	G_JOB	G_JOB, G_DEPT
Dans ce cas, la propriété Remise à indique que le récapitulatif doit être remis à Null pour chaque département, parce que vous voulez un pourcentage par département. La propriété Calculer à indique que le total des salaires de cette catégorie d'emploi est le montant total (100 %) à utiliser pour calculer les pourcentages. Notez également que ce récapitulatif est placé dans le groupe G_CROSS, parce que tous les récapitulatifs qui s'appliquent à la matrice elle-même doivent appartenir au groupe inter-produit.

Remarque : Comme cet état est matriciel, vous devez utiliser Ordre produit pour le récapitulatif. Pour plus d'informations à ce sujet, reportez-vous à "Ordre produit". (L'un des exemples utilise la même sortie que cet exemple et explique davantage l'utilisation de Ordre produit)

 Cliquez ici.


Calculer à - Restrictions

•	La propriété Calculer à n'est éditable que lorsque la colonne est récapitulative et que la propriété Fonction est % du total.

•	Le groupe Calculer à d'une colonne récapitulative peut être tout groupe se trouvant au-dessus de la colonne récapitulative, Etat et Page compris, si le groupe de la colonne récapitulative n'est pas Etat.

•	Les colonnes récapitulatives qui appartiennent à un groupe inter-produit ne peuvent pas avoir la propriété Calculer à définie à Page.

•	Si la propriété Calculer à d'un récapitulatif est définie sur Page, la taille du champ ou de l'objet standard qui l'affiche doit être fixe.


            Dépt   Analyste   %_emploi   Employé   %_emploi   Directeur   %_emploi   Total

    Dépt   -------- -------  ------ -------  -------- ------- ------

    10                         1300  31.33%      2450  29.61%   3750

    20         6000 100.00%    1900  45.78%      2975  35.95%  10875

    30                          950  22.89%      2850  34.44%   3800

    Total    6000                  4150                  8275                 18425

             (100%)          (100%)            (100%)


propriété Fonction
Fonction

  Restrictions

Description  Cette propriété permet d'indiquer le calcul à effectuer sur les valeurs de la colonne indiquée dans Source. Pour créer des récapitulatifs courants, placez la colonne dans le groupe approprié et utilisez la propriété Fonction avec la propriété Remise à.

Valeurs

Moyenne	Calcule la moyenne des valeurs de la colonne dans le groupe de réinitialisation.
Décompte	Compte le nombre d'enregistrements dans le groupe de réinitialisation.
Premier	Imprime la première valeur de la colonne, extraite pour le groupe de réinitialisation.
Dernier	Imprime la dernière valeur de la colonne, extraite pour le groupe de réinitialisation.
Max	Calcule la valeur la plus élevée de la colonne dans le groupe de réinitialisation.
Min	Calcule la valeur la moins élevée de la colonne dans le groupe de réinitialisation;
% du total	Calcule le pourcentage du total de la colonne dans le groupe de réinitialisation.
Ecart type	Calcule la racine carrée positive de l'écart de la colonne pour le groupe de réinitialisation.
Somme	Calcule le total des valeurs de la colonne dans le groupe de réinitialisation.
Variance	Totalise les carrés de la distance de chaque valeur de colonne à partir de la valeur moyenne du groupe de réinitialisation et divise le total par le nombre de valeurs moins 1.
S'applique à  colonnes récapitulatives

Obligatoire/facultatif  obligatoire, si la colonne est récapitulative.

Valeur par défaut  blanc


Fonction - Restrictions

•	La propriété Fonction n'est éditable que lorsque Type de colonne est défini à est Récapitulative.

•	Somme, Moyenne, % du total, Ecart type et Variance ne peuvent s'appliquer qu'aux champs dont le type de données est Number.

•	Report Builder définit le type de données du récapitulatif en fonction du type de données de la colonne récapitulée.

•	En cas de changement de colonne récapitulée, le type de données du récapitulatif est changé en conséquence.

•	La propriété Fonction d'un récapitulatif de niveau Etat ne peut pas être définie à % du total. Cette colonne n'aurait pas de sens, car elle aurait toujours pour valeur 100 %.

Une colonne dont la propriété Fonction est définie à % du total, Somme ou Variance ne peut pas être une colonne de ventilation et ne peut pas avoir une définition de la propriété Ordre de ventilation.

•	La fonction Moyenne ignore les valeurs Null d'une colonne (c'est-à-dire qu'elle ne suppose pas qu'une valeur Null est égale à zéro).


propriété Ordre produit
Ordre produit

  Restrictions	  Exemples

Description  Cette propriété permet d'indiquer l'ordre dans lequel les groupes sont évalués dans un groupe inter-produit, c'est-à-dire que la colonne récapitulative, la colonne de formule ou la colonne de réserve a une valeur pour chaque combinaison de valeurs des groupes de son Ordre produit. La propriété Ordre produit n'est utilisée que pour les colonnes appartenant à des groupes inter-produit. Un inter-produit étant lié à plusieurs groupes, ceux-ci peuvent être évalués dans l'un des nombreux ordres possibles. Lorsque vous créez un récapitulatif pour un inter-produit, vous devez donc utiliser Ordre produit pour indiquer à Report Builder le groupe qui doit être évalué en premier, puis en second et ainsi de suite. Vous devez également utiliser Ordre produit pour indiquer la fréquence d'une colonne récapitulative, d'une colonne de formule ou d'une colonne de réserve dans l'inter-produit.

Valeurs  Toute combinaison de groupes valide

S'applique à  une colonne récapitulative, de formule ou de réserve

Obligatoire/facultatif  obligatoire, si la colonne est une colonne récapitulative ou de formule appartenant à un groupe inter-produit.


Ordre produit-groupe simple - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un état matriciel.

 Cliquez ici.

Le groupe G_JOB contient la colonne JOB, G_DEPT contient NODEPT, G_YEAR contient ANNEE, G_SAL contient TOTSAL et G_CROSS est le groupe inter-produit. (G_CROSS contient tous les récapitulatifs de la matrice.)

Pour obtenir le récapitulatif des salaires par emploi, vous créez une colonne récapitulative dans G_CROSS de la manière suivante :

Fonction	Remise à	Ordre produit
% du total	G_JOB	G_JOB
Dans ce cas, vous voulez que le récapitulatif calcule une somme pour chaque enregistrement de G_JOB (c'est-à-dire chaque catégorie d'emploi). Ordre produit est donc G_JOB. (Ce récapitulatif apparaît au bas de la matrice.)

Pour obtenir le récapitulatif des salaires par année, créez dans G_CROSS une colonne récapitulative se présentant de la manière suivante :

Fonction	Remise à	Ordre produit
Somme	G_YEAR	G_YEAR
Dans ce cas, vous voulez que le récapitulatif calcule une somme pour chaque enregistrement de G_YEAR (c'est-à-dire chaque année) et Ordre produit est donc G_YEAR. (Ce récapitulatif apparaît le long du bord droit de la matrice, directement sous une ligne de texte standard.)

Pour obtenir le récapitulatif des salaires de chaque département pour chaque année, créez dans G_CROSS une colonne récapitulative se présentant de la manière suivante :

Fonction	Remise à	Ordre produit
Somme	G_DEPT	G_YEAR, G_DEPT
Dans ce cas, vous voulez que le récapitulatif calcule une somme pour chaque département et chaque année (G_DEPT et G_YEAR). Pour ce récapitulatif, G_YEAR a la fréquence la plus faible (c'est-à-dire ne change qu'une fois par groupe de trois enregistrements de G_DEPT) et G_DEPT a la fréquence la plus élevée (c'est-à-dire change trois fois par enregistrement de G_YEAR). G_YEAR (fréquence la moins élevée) apparaît donc en premier et G_DEPT (fréquence la plus élevée) apparaît en second dans Ordre produit.


Ordre produit-groupe multiple - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un état matriciel qui se présente comme ci-dessous, auquel vous voulez ajouter des colonnes récapitulatives de pourcentage.

Dépt  Analyste   Employé   Directeur   Total

10              1300     2450   3750

20      6000    1900     2975  10875

30               950     2850   3800

Total    6000                  4150                  8275                 18425

Le groupe G_JOB contient la colonne JOB, G_DEPT contient NODEPT, G_SAL contient TOTSAL et G_CROSS est le groupe inter-produit.

Pour obtenir une colonne récapitulative qui calcule, pour chaque département, le total des salaires de chaque catégorie d'emploi sous la forme d'un pourcentage du total des salaires de cet emploi dans tous les départements, entrez les données suivantes pour une colonne récapitulative de G_CROSS se présentant comme suit :

Fonction	Remise à	Calculer à	Ordre produit
% du total	G_DEPT	G_JOB	G_JOB, G_DEPT
Dans ce cas, vous voulez que le récapitulatif s'effectue vers le bas de la matrice, puis de gauche à droite. Comme le récapitulatif s'effectue d'abord de haut en bas, G_JOB a la fréquence la moins élevée (c'est-à-dire ne change qu'une fois tous les trois départements) et est le premier groupe de Ordre produit. Comme le récapitulatif s'effectue ensuite de gauche à droite de la matrice, G_DEPT a la fréquence la plus élevée (change trois fois par travail) et est le second groupe de Ordre produit.

 Cliquez ici.

Pour obtenir un récapitulatif qui calcule, pour chaque catégorie d'emploi, le total des salaires de chaque département sous la forme d'un pourcentage du total des salaires de ce département, entrez les données suivantes pour une colonne récapitulative de G_CROSS se présentant comme suit :

Fonction	Remise à	Calculer à	Ordre produit
% du total	G_JOB	G_DEPT	G_DEPT, G_JOB
Dans ce cas, vous voulez que le récapitulatif s'effectue de gauche à droite de la matrice, puis de haut en bas. Comme le récapitulatif s'effectue d'abord de gauche à droite, G_DEPT a la fréquence la moins élevée (c'est-à-dire ne change qu'une fois tous les trois emplois) et est le premier groupe de Ordre produit. Comme le récapitulatif s'effectue de haut en bas après s'être effectué de gauche à droite et ensuite vers le bas de la matrice, G_JOB a la fréquence la plus élevée (change trois fois par département) et est le second de Ordre produit.

 Cliquez ici.

Pour obtenir un récapitulatif qui calcule, pour chaque département, le total des salaires par emploi sous la forme d'un pourcentage du total des salaires de l'état, entrez les données suivantes pour une colonne récapitulative de G_CROSS

Fonction	Remise à	Calculer à	Ordre produit
% du total	G_JOB	Etat	G_DEPT, G_JOB
Dans ce cas, le récapitulatif peut s'effectuer de gauche à droite de la matrice, puis de haut en bas, ou de haut en bas, puis de gauche à droite, puisque vous le calculez pour la totalité de l'état (par exemple, la propriété Calculer à définie à Etat). La propriété Ordre produit peut être soit G_DEPT, soit G_JOB (de gauche à droite, vers le bas) ou G_JOB, G_DEPT (vers le bas, de gauche à droite). Notez cependant que la propriété Remise à doit être le groupe qui a la fréquence la plus élevée : G_DEPT si Ordre produit est G_JOB, G_DEPT; G_JOB si Ordre produit est G_DEPT, G_JOB.

 Cliquez ici.


Ordre produit-formule - Exemple

  Rubriques connexes 	  Tous les exemples

Soit un état matriciel qui se présente comme ci-dessous, auquel vous voulez ajouter une colonne de formule.

Dépt  Analyste   Employé  Directeur  Président  Vendeur

10              1300     2450      5000

20      6000    1900     2975

30               950     2850                 5600

Le groupe G_JOB contient la colonne JOB, G_DEPT contient NODEPT, G_SAL contient TOTSAL et G_CROSS est le groupe inter-produit.

Pour ajouter une colonne de formule qui calcule la somme des salaires après impôt de chaque département, commencez par créer dans G_CROSS une colonne récapitulative (TOTDEPT) se présentant de la manière suivante :

Fonction	Remise à	Ordre produit
% du total	G_DEPT	G_DEPT
Créez ensuite dans G_CROSS une formule (AFTERTAX) se présentant de la manière suivante :

Formules	Ordre produit
:totdept * .9	G_DEPT
Comme la formule se trouve dans G_CROSS, vous devez lui donner une propriété Ordre produit. Dans ce cas, la fréquence de la colonne de formule est la même que celle de la colonne récapitulative TOTDEPT. La formule sera calculée de la manière suivante :

Dépt   Analyste   Employé   Directeur   Président   Vendeur   Compta

10              1300     2450      5000             7875

20      6000    1900     2975                       9788

30               950     2850                 5600  8460


Ordre produit - Restrictions

•	Ce champ n'est disponible que si le groupe de la colonne récapitulative, de formule ou de réserve est un inter-produit.

•	Un récapitulatif qui n'est pas un récapitulatif courant (c'est-à-dire dont la propriété Remise à n'est pas définie à Etat) doit avoir un Ordre produit qui est un sous-ensemble de l'Ordre produit de sa colonne Source. La colonne Source du récapitulatif doit être au moins aussi fréquente que le récapitulatif, ce qui signifie que l'Ordre produit du récapitulatif doit être un sous-ensemble de l'Ordre de la colonne Source.

•	Un récapitulatif courant (c'est-à-dire dont la propriété Remise à est définie à Etat) doit avoir un Ordre produit qui est un préfixe de l'Ordre produit de la colonne Source. Par exemple, si l'Ordre produit de la colonne Source est A,B,C, l'Ordre produit de la colonne récapitulative doit être soit A (seul), soit A,B. L'Ordre produit du récapitulatif ne peut pas être B,A.


Emploi    ANALYSTE    EMPLOYE    DIRECTEUR    PRESIDENT    VENDEUR

            -------    -----      -------    ---------    --------

Année  Département

----  ----

80      10

        20               800                                            800

        30

                                                                     ------

                                                                        800

81      10                           2450         5000                 7450

        20     3000                  2975                              5975

        30               950         2850                     5600     9400

                                                                     ------

                                                                      22825

82      10              1300                                           1300

        20     3000                                                    3000

        30

                                                                     ------

                                                                       4300

83      10

        20              1100                                           1100

        30

                                                                     ------

                                                                       1100

            -------    -----      -------    ---------    --------

               6000     4150         8275         5000        5600


       Dépt   Analyste   %_emploi   Employé   %_emploi   Directeur   %_emploi   Total

Dépt   -------- -------  ------ -------  -------- ------- ------

10                         1300  31.33%      2450  29.61%   3750

20         6000 100.00%    1900  45.78%      2975  35.95%  10875

30                          950  22.89%      2850  34.44%   3800

Total    6000                  4150                  8275                 18425

                100%             100%              100%


       Dépt   Analyste   %_emploi   Employé   %_emploi   Directeur   %_emploi   Total

Dépt   -------- -------  ------ -------  -------- ------- ------

10                         1300  34.67%      2450  65.33%   3750

                                                            100%

20         6000  55.17%    1900  17.47%      2975  27.36%  10875

                                                            100%

30                          950  25.00%      2850  75.00%   3800

                                                            100%

Total    6000                  4150                  8275                 18425


        Dépt   Analyste   %_emploi   Employé   %_emploi   Directeur   %_emploi   Total

Dépt   -------- -------  ------ -------  -------- ------- ------

10                         1300   7.06%      2450  13.30%   3750

20         6000  32.56%    1900  10.31%      2975  16.15%  10875

30                          950   5.16%      2850  15.47%   3800

Total    6000                  4150                  8275                 18425

                                                            100%


propriété Remise à
Remise à

  Restrictions	  Exemples

Description  Cette propriété permet d'indiquer le groupe auquel la valeur de la colonne récapitulative est remise à zéro (si la propriété Fonction est définie à Décompte), null (si la propriété Fonction n'est pas définie à Décompte), ou Valeur si Null (si la colonne en comporte une). Cette propriété comporte une liste de valeurs contenant les groupes de réinitialisation valides. Elle détermine si le récapitulatif est un récapitulatif courant ou périodique (par exemple, de niveau groupe).

Valeurs

Page	Est utilisée pour les récapitulatifs de niveau page. Le récapitulatif est réinitialisé entre les pages.
Etat	Est utilisé pour les récapitulatifs qui s'appliquent à la totalité de l'état, comme les totaux globaux. Le récapitulatif est réinitialisé après l'état (c'est-à-dire n'est jamais réinitialisé).
<noms>	Est un nom de groupe valide. Le récapitulatif est réinitialisé après chaque enregistrement du groupe.
S'applique à  colonnes récapitulatives

Obligatoire/facultatif  obligatoire, pour les colonnes de type récapitulatif.

Notes d'utilisation

•	Le groupe de réinitialisation d'une colonne récapitulative peut être son groupe ou tout groupe au-dessus du sien, Etat et Page compris.

•	Pour être certain que les récapitulatifs de page se comportent de la manière prévue, assurez-vous que chaque enregistrement tient sur une page ou, si cela n'est pas possible, forcez chaque nouvel enregistrement à s'imprimer sur une page distincte.


Remise à groupe - Exemple

  Rubriques connexes 	  Tous les exemples

Vous voulez créer un état de groupe se présentant de la manière suivante :

DEPT    NOM    SAL    SOMMEREINIT    SOMMECOUR

---- ------- ---- -------- ------

10      SIMON  1000   1000           1000

     JEAN   1000   2000           2000

     KING   1000   3000           3000

20    JAMIN   1500       1500           4500

     WOLF    1000       2500           5500

Le groupe père G_DEPT, contient la colonne DEPT. Le groupe fils, G_EMP, contient NOM et SAL. Pour obtenir le total des salaires de chaque département (SOMMEREINIT), créez dans G_EMP une colonne récapitulative se présentant de la manière suivante :

Fonction	Remise à
Somme	G_DEPT
Dans ce cas, la propriété Remise à indique que le récapitulatif doit être défini à Null après chaque département.

Pour obtenir la somme des salaires (SOMMECOUR), créez dans G_EMP une colonne récapitulative se présentant de la manière suivante :

Fonction	Remise à
Somme	Etat
Dans ce cas, la propriété Remise à indique que le récapitulatif ne doit pas être réinitialisé à Null, mais doit se cumuler sur tout l'état.


Remise à - Restrictions

•	La propriété Remise à n'est éditable que pour les colonnes récapitulatives.

•	Pour les colonnes récapitulatives qui appartiennent à un groupe inter-produit, la propriété Remise à ne peut pas être définie à Page.

•	Si la propriété Remise à d'un récapitulatif est définie sur Page, la taille du champ ou de l'objet standard qui l'affiche doit être fixe.

•	Si,  pour  une colonne, la propriété Remise à est définie à Page, les champs qui l'utilisent comme Source doivent se trouver dans les encadrements itératifs qui utilisent comme source le groupe de la colonne.

•	Définir à Page la propriété Remise à n'est pas valide pour les états dans lesquels plusieurs encadrements itératifs sont associés à un groupe qui participe au récapitulatif. Exemple courant : un état de matrice. Les états de matrice ne peuvent pas avoir de récapitulatif de niveau page.

•	Pour les colonnes récapitulatives multiples qui se trouvent dans des groupes fils qui partagent le même groupe père, définir à Page la propriété Remise à peut donner des résultats incorrects.

•	SI votre modèle de données contient plusieurs groupes fils ayant un père commun (par exemple, Maître-détail-détail), les colonnes récapitulatives dont la propriété Remise à est définie à Page peuvent donner des résultats imprévisibles.


Propriété Source
Source

  Restrictions

Description  Cette propriété permet d'indiquer le nom de la colonne dont la valeur sera récapitulée.

Valeurs  Tout nom de colonne valide.

S'applique à  colonnes récapitulatives

Obligatoire/facultatif  obligatoire, si la colonne est récapitulative.

Valeur par défaut  blanc


Source - Restrictions

•	La source d'une colonne récapitulative peut être toute colonne se trouvant dans ou sous le groupe de la colonne récapitulative (ayant un type de données de fonction valide).

•	Si vous changez la source d'une colonne récapitulative, le type de données de cette colonne change en fonction du type de données de la nouvelle colonne source, à moins que vous n'ayez indiqué la propriété Lecture depuis fichier pour la colonne

•	Toute colonne peut être la source de plusieurs colonnes récapitulatives.

•	Si vous indiquez une source pour une colonne récapitulative, puis supprimez cette colonne source de votre état, votre colonne récapitulative n'aura plus accès aux données à récapituler.


Propriétés de modèle

Alignement

Aligner récapitulatifs sur les champs

Couleur d'arrière-plan

Entre champ et libellés (horizontal)

Entre encadrement et champs (horizontal)

Entre encadrement et champs (vertical)

Entre maître et détail (horizontal)

Entre maître et détail (vertical)

Entre page et encadrements (horizontal)

Entre page et encadrements (vertical)

Entre encadrements de même père (horizontal)

Entre encadrements de même père (vertical)

Bordures

Alignement de caractères

Tiret

Alignement de dates

Couleur d'arrière-plan du bord

Couleur de premier plan du bord

Motif du bord

Champs par ligne

Motif de remplissage

Police

Couleur de premier plan

Image

Inter-champ (horizontal)

Inter-champ (vertical)

Interencadrement (horizontal)

Interencadrement (vertical)

Justification

Alignement de nombres

Placer libellés au-dessus des champs

Position

Style

Texte

Couleur de texte

Utiliser espacement vertical


Propriété Alignement
Alignement

Description  La propriété Alignement définit la façon dont les libellés et les champs sont positionnés sur la page. Cette propriété ne s'applique que si le Style est Formulaire. Le nombre de champs et de colonnes par ligne est déterminé par la propriété Champs par ligne.

Valeurs

Gauche	Le libellé ou le champ le plus à gauche est aligné sur le bord gauche de la page.
	Cliquez ici.
Droite	Le libellé ou le champ le plus à droite est aligné sur le bord droit de la page.
	Cliquez ici.
Centre	Les libellés et les champs sont centrés sur la page.
	Cliquez ici.
Justification	Les libellés et les champs sont espacés régulièrement sur la page, le libellé ou le champ le plus à gauche étant aligné sur le bord gauche de la page et le libellé ou le champ le plus à droite sur le bord droit de la page.
	Cliquez ici.
Colonne	Les libellés et les champs sont alignés en colonnes espacées régulièrement sur la page, sur la base du libellé le plus large et du champ le plus large.
	Cliquez ici.
Application  Modèles

Valeur par défaut  Gauche


Propriété Aligner récapitulatifs sur les champs
Aligner récapitulatifs sur les champs

Description  La propriété Aligner récapitulatifs sur les champs place les champs récapitulatifs en-dessous de leur champ source si sa valeur est Oui. Cette propriété ne s'applique que si le Style est Formulaire.

 Cliquez ici.

Application  Modèles

Valeur par défaut  Oui


Propriété Couleur d'arrière-plan
Couleur d'arrière-plan

Description  La propriété Couleur d'arrière-plan définit la couleur d'arrière-plan de la propriété Motif de remplissage.

Valeurs   Choisissez une couleur valide dans la palette de couleurs.

Application  Modèles

Valeur par défaut   Blanc

Notes d'utilisation

•	Si la propriété Motif de remplissage a pour valeur transparent, les propriétés Couleur d'arrière-plan et Couleur de premier plan ne sont pas prises en compte.

•	Si la propriété Motif de remplissage a pour valeur opaque, la propriété Couleur d'arrière-plan n'est pas prise en compte et seule la Couleur de premier plan est visible.

PL/SQL  Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET BACKGROUND FILL COLOR.


Propriété Entre champ et libellés (horizontal)
Entre champ et libellés (horizontal)

Description  La propriété Entre champ et libellés (horizontal) définit l'espacement horizontal entre les champs et les libellés associés dans un groupe. Cette propriété ne s'applique que si le Style est Formulaire, dans lequel les libellés se trouvent à gauche des champs. Il n'y a donc pas d'équivalent vertical à cette propriété.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Entre encadrement et champs (horizontal)
Entre encadrement et champs (horizontal)

Description  La propriété Entre encadrement et champs (horizontal) définit l'espacement horizontal entre les encadrements et les champs qu'ils englobent.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Entre encadrement et champs (vertical)
Entre encadrement et champs (vertical)

Description  La propriété Entre encadrement et champs (vertical) définit l'espacement vertical entre les encadrements et les champs qu'ils englobent.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Entre maître et détail (horizontal)
Entre maître et détail (horizontal)

Description  La propriété Entre maître et détail (horizontal) définit l'espacement horizontal entre l'encadrement du groupe maître et l'encadrement du groupe détail.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Entre maître et détail (vertical)
Entre maître et détail (vertical)

Description  La propriété Entre maître et détail (vertical) définit l'espacement vertical entre l'encadrement du groupe maître et l'encadrement du groupe détail.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Entre page et encadrements (horizontal)
Entre page et encadrements (horizontal)

Description  La propriété Entre page et encadrements (horizontal) définit l'espacement horizontal entre le bord de la page et l'encadrement du groupe de plus haut niveau.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Entre page et encadrements (vertical)
Entre page et encadrements (vertical)

Description  La propriété Entre page et encadrements (vertical) définit l'espacement vertical entre le bord de la page et l'encadrement du groupe de plus haut niveau.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Entre encadrements de même père (horizontal)
Entre encadrements de même père (horizontal)

Description  La propriété Entre encadrements de même père (horizontal) définit l'espacement horizontal entre les encadrements de groupes de même niveau. Ces groupes peuvent être indépendants ou issus du même groupe père.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Entre encadrements de même père (vertical)
Entre encadrements de même père (vertical)

Description  La propriété Entre encadrements de même père (vertical) définit l'espacement vertical entre les encadrements de groupes de même niveau. Ces groupes peuvent être indépendants ou issus du même groupe père.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Bordures
Bordures

Description  La propriété Bordures définit les bordures à afficher pour les objets.

Valeurs

Tout	Affiche toutes les bordures.
Haut seulement	Affiche les bordures supérieures seulement.
Bas seulement	Affiche les bordures inférieures seulement.
Gauche seulement	Affiche les bordures gauches seulement.
Droite seulement	Affiche les bordures droites seulement.
Haut et bas	Affiche les bordures supérieures et inférieures seulement.
Gauche et droite	Affiche les bordures gauches et droites seulement.
Haut et droite	Affiche les bordures supérieures et droites seulement.
Haut et gauche	Affiche les bordures supérieures et gauches seulement.
Bas et droite	Affiche les bordures inférieures et droites seulement.
Haut et gauche	Affiche les bordures inférieures et gauches seulement.
Tout sauf haut	Affiche toutes les bordures sauf les bordures supérieures.
Tout sauf bas	Affiche toutes les bordures sauf les bordures inférieures.
Tout sauf gauche	Affiche toutes les bordures sauf les bordures gauches.
Tout sauf droite	Affiche toutes les bordures sauf les bordures droites.
Aucun	N'affiche aucune bordure.
Application  Modèles

Valeur par défaut  All


Propriété Alignement de caractères
Alignement de caractères

Description  La propriété Alignement de caractères définit la méthode à utiliser pour aligner le texte du champ ou du libellé si le type de données de la source du champ est CHARACTER.

Valeurs

Gauche	Le texte est aligné à gauche.
Centre	Le texte est centré.
Droite	Le texte est aligné à droite.
Début	Le texte est aligné à gauche ou à droite, selon le point de départ de l'écriture dans la langue. Par exemple, pour les langues qui s'écrivent de gauche à droite, Début aligne le texte à gauche. Inversement, pour les langues qui s'écrivent de droite à gauche, Début aligne le texte à droite.
Fin	Le texte est aligné à gauche ou à droite, selon le point de fin de l'écriture dans la langue. Par exemple, pour les langues qui s'écrivent de gauche à droite, Fin aligne le texte à droite. Inversement, pour les langues qui s'écrivent de droite à gauche, Fin aligne le texte à gauche.
Application  Modèles

Valeur par défaut  Début

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET JUSTIFICATION.


Propriété Tiret
Tiret

Description  La propriété Tiret définit le style de tiret de l'objet.

Valeurs   Choisissez un motif de tiret valide dans la liste.

Application  Modèles

Valeur par défaut  Plein


Propriété Alignement de dates
Alignement de dates

Description  La propriété Alignement de dates définit la méthode à utiliser pour aligner le texte du champ ou du libellé si le type de données de la source du champ est DATE.

Valeurs

Gauche	Le texte est aligné à gauche.
Centre	Le texte est centré.
Droite	Le texte est aligné à droite.
Début	Le texte est aligné à gauche ou à droite, selon le point de départ de l'écriture dans la langue. Par exemple, pour les langues qui s'écrivent de gauche à droite, Début aligne le texte à gauche. Inversement, pour les langues qui s'écrivent de droite à gauche, Début aligne le texte à droite.
Fin	Le texte est aligné à gauche ou à droite, selon le point de fin de l'écriture dans la langue. Par exemple, pour les langues qui s'écrivent de gauche à droite, Fin aligne le texte à droite. Inversement, pour les langues qui s'écrivent de droite à gauche, Fin aligne le texte à gauche.
Valeur Entrez

Application  Modèles

Valeur par défaut  Début

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET JUSTIFICATION.


Propriété Couleur de premier plan du bord
Couleur de premier plan du bord

Description  La propriété Couleur de premier plan du bord définit la couleur de premier plan de la propriété Motif du bord.

Valeurs   Choisissez une couleur valide dans la palette de couleurs.

Application  Modèles

Valeur par défaut  Noir

Notes d'utilisation

•	Si la propriété Motif du bord a pour valeur transparent, les propriétés Couleur de premier plan du bord et Couleur d'arrière-plan du bord ne sont pas prises en compte.

•	Si la propriété Motif du bord a pour valeur opaque, seule la propriété Couleur de premier plan du bord est visible (la propriété Couleur d'arrière-plan du bord n'est pas prise en compte).

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET FOREGROUND BORDER COLOR.


Propriété Couleur d'arrière-plan du bord
Couleur d'arrière-plan du bord

Description  La propriété Couleur d'arrière-plan du bord définit la couleur d'arrière-plan de la propriété Motif du bord.

Valeurs   Choisissez une couleur valide dans la palette de couleurs.

Application  Modèles

Valeur par défaut  Blanc

Notes d'utilisation

•	Si la propriété Motif du bord a pour valeur transparent, les propriétés Couleur d'arrière-plan du bord et Couleur de premier plan du bord ne sont pas prises en compte.

•	Si la propriété Motif du bord a pour valeur opaque, seule la propriété Couleur d'arrière-plan du bord est visible (la propriété Couleur de premier plan du bord n'est pas prise en compte).

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET BACKGROUND BORDER COLOR.


Propriété Motif du bord
Motif du bord

Description  La propriété Motif du bord définit le motif à utiliser pour les bordures des objets. Vous pouvez définir les couleurs d'arrière-plan et de premier plan du motif du bord à l'aide des propriétés Couleur de premier plan du bord et Couleur d'arrière-plan du bord.

Valeurs   Choisissez une couleur valide dans la palette de couleurs.

Application  Modèles

Valeur par défaut  Transparent

Notes d'utilisation

•	Si la propriété Motif du bord a pour valeur transparent, les propriétés Couleur de premier plan du bord et Couleur d'arrière-plan du bord ne sont pas prises en compte.

•	Si la propriété Motif du bord a pour valeur opaque, seule la propriété Couleur de premier plan du bord est visible .

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET BORDER PATTERN.


Propriété Champs par ligne
Champs par ligne

Description  La propriété Champs par ligne définit le nombre maximum de combinaisons champ/libellé qui peuvent apparaître sur une ligne, sous réserve d'espace disponible. Par exemple, s'il n'y a de l'espace que pour deux combinaisons champ/libellé et que cette valeur est fixée à trois, seules deux combinaisons champ/libellé apparaîtront. En revanche, s'il y a suffisamment d'espace pour quatre combinaisons champ/libellé et que la valeur est trois, seules trois apparaîtront car c'est le nombre maximum autorisé. Cette propriété ne s'applique que si le Style est Formulaire.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Zéro indique qu'il n'y a pas de maximum et qu'il peut apparaître sur la ligne autant de combinaisons champ/libellé qu'elle est capable d'en contenir.

Application  Modèles

Valeur par défaut  0


Propriété Motif de remplissage
Motif de remplissage

Description  La propriété Motif de remplissage définit le motif à utiliser pour l'espace englobé par les objets. Vous pouvez définir les couleurs d'arrière-plan et de premier plan du motif de remplissage à l'aide des propriétés Couleur de premier plan et Couleur d'arrière-plan.

Valeurs   Choisissez un motif valide dans la palette de motifs.

Application  Modèles

Valeur par défaut  Transparent

Notes d'utilisation

•	Si la propriété Motif de remplissage a pour valeur transparent, les propriétés Couleur de premier plan et Couleur d'arrière-plan ne sont pas prises en compte.

•	Si la propriété Motif de remplissage a pour valeur opaque, seule la propriété Couleur de premier plan est visible.

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET FILL PATTERN.


Propriété Police
Police

Description  La propriété Police définit la police utilisée pour le texte des objets.

Valeurs   Choisissez une police valide parmi la liste de polices de votre système.

Application  Modèles

Valeur par défaut  Courier, 10 pt., Normal

PL/SQL Pour définir la police via PL/SQL, utilisez la procédure SRW.SET FONT FACE. Pour définir la taille de police via PL/SQL, utilisez la procédure SRW.SET FONT SIZE. Pour définir le style de police via PL/SQL, utilisez la procédure SRW.SET FONT STYLE.


Propriété Couleur de premier plan
Couleur de premier plan

Description  La propriété Couleur de premier plan définit la couleur de premier plan de la propriété Motif de remplissage.

Valeurs   Choisissez une couleur valide dans la palette de couleurs.

Application  Modèles

Valeur par défaut  Noir

Notes d'utilisation

•	Si la propriété Motif de remplissage a pour valeur transparent, les propriétés Couleur de premier plan et Couleur d'arrière-plan ne sont pas prises en compte.

•	Si la propriété Motif de remplissage a pour valeur opaque, seule la propriété Couleur de premier plan est visible (la propriété Couleur d'arrière-plan n'est pas prise en compte).

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET FOREGROUND FILL COLOR.


Propriété Image
Image

Description  La propriété Image indique le fichier de remplacement à utiliser pour les images référencées dans les objets standard (externes) de fichier de liaison dans vos modèles.

Valeurs   Entrez le nom d'un fichier texte valide.

Application  Modèles

Valeur par défaut  Aucune


Propriété Inter-champ (horizontal)
Inter-champ (horizontal)

Description  La propriété Inter-champ (horizontal) définit l'espacement horizontal entre les champs dans un groupe. Si le style est Formulaire, cette propriété définit l'espacement horizontal entre la fin d'une combinaison champ/libellé et le début d'une autre combinaison champ/libellé dans un groupe. La distance entre le champ et le libellé est déterminée par la propriété Entre champ et libellés (horizontal).

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0,174 pouces

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Inter-champ (vertical)
Inter-champ (vertical)

Description  La propriété Inter-champ (vertical) définit l'espacement vertical entre les champs dans un groupe.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Interencadrement (horizontal)
Interencadrement (horizontal)

Description  La propriété Interencadrement (horizontal) définit l'espacement horizontal entre les encadrements dans un groupe.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0,0087 pouces

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Interencadrement (vertical)
Interencadrement (vertical)

Description  La propriété Interencadrement (horizontal) définit l'espacement vertical entre les encadrements dans un groupe.

Valeurs   Entrez une valeur supérieure ou égale à zéro. Cette valeur sera exprimée dans l'unité de mesure de l'état (pouces, centimètres ou points).

Application  Modèles

Valeur par défaut  0,0136 pouces

Notes d'utilisation

•	Si la grille magnétique est activée, les objets se fixent au point le plus proche de la grille, indépendamment de ce paramètre. Si vous désirez un meilleur contrôle de l'espacement, vous pouvez désactiver la grille magnétique à la création de l'état. Dans ce cas, les objets ne se fixeront plus aux points de la grille.

•	Si vous changez l'unité de mesure de l'état, vous devrez modifier ce paramètre en conséquence.


Propriété Justification
Justification

Description  La propriété Justification définit la méthode utilisée pour aligner le texte dans le titre.

Valeurs

Gauche	Le texte est aligné à gauche.
Centre	Le texte est centré.
Droite	Le texte est aligné à droite.
Début	Le texte est aligné à gauche ou à droite, selon le point de départ de l'écriture dans la langue. Par exemple, pour les langues qui s'écrivent de gauche à droite, Début aligne le texte à gauche. Inversement, pour les langues qui s'écrivent de droite à gauche, Début aligne le texte à droite.
Fin	Le texte est aligné à gauche ou à droite, selon le point de fin de l'écriture dans la langue. Par exemple, pour les langues qui s'écrivent de gauche à droite, Fin aligne le texte à droite. Inversement, pour les langues qui s'écrivent de droite à gauche, Fin aligne le texte à gauche.
Application  Modèles

Valeur par défaut  Début


Propriété Alignement de nombres
Alignement de nombres

Description  La propriété Alignement de nombres définit la méthode utilisée pour aligner le texte d'un champ ou d'un libellé, si le type de données de la source du champ est NUMBER.

Valeurs

Gauche	Le texte est aligné à gauche.
Centre	Le texte est centré.
Droite	Le texte est aligné à droite.
Début	Le texte est aligné à gauche ou à droite, selon le point de départ de l'écriture dans la langue. Par exemple, pour les langues qui s'écrivent de gauche à droite, Début aligne le texte à gauche. Inversement, pour les langues qui s'écrivent de droite à gauche, Début aligne le texte à droite.
Fin	Le texte est aligné à gauche ou à droite, selon le point de fin de l'écriture dans la langue. Par exemple, pour les langues qui s'écrivent de gauche à droite, Fin aligne le texte à droite. Inversement, pour les langues qui s'écrivent de droite à gauche, Fin aligne le texte à gauche.
Application  Modèles

Valeur par défaut  Début

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET JUSTIFICATION.


Propriété Placer libellés au-dessus des champs
Placer libellés au-dessus des champs

Description  La propriété Placer libellés au-dessus des champs positionne les libellés au-dessus des champs et non à leur gauche si elle a pour valeur Oui.  Cette propriété ne s'applique que si le Style est Formulaire.

Application  Modèles

Valeur par défaut  Non


Propriété Position
Position

Description  La propriété Position définit le positionnement de l'objet parent par rapport à l'objet enfant.

Application  Modèles

Valeur par défaut L'objet parent apparaît au-dessus de l'objet enfant.


Propriété Style
Style

Description  La propriété Style définit si le groupe a une présentation de style Tabulaire ou Formulaire. Vous pouvez utiliser cette propriété pour remplacer les valeurs par défaut énumérées ci-dessous.

Valeurs

Tabulaire	Les libellés apparaissent au-dessus des champs et se trouvent en-dehors de l'encadrement itératif contenant les champs.
	Cliquez ici.
Formulaire	Les libellés apparaissent à gauche des champs et se trouvent à l'intérieur de l'encadrement itératif contenant les champs.
	Cliquez ici.

Application  Modèles

Valeur par défaut  Le style par défaut est déterminé par le style de présentation du modèle, comme suit :

Tabulaire	Tabulaire
Groupe - gauche	Tabulaire
Groupe - niveau supérieur	Formulaire, pour les groupes avec groupe fils. Tabulaire, pour les groupes sans groupe fils.
Formulaire	Formulaire
Lettre type	Non applicable (remplacement impossible).
Etiquette de publipostage	Non applicable (remplacement impossible).
Matriciel	Tabulaire (remplacement impossible).
Matriciel avec groupe	Tabulaire (remplacement impossible).


Propriété Texte
Texte

  Rubriques connexes

Description  La propriété Texte indique le fichier de remplacement à utiliser pour les objets texte standard dans les modèles.

Valeurs   Entrez le nom d'un fichier texte valide.

Application  Modèles

Valeur par défaut  Aucune


Propriété Couleur de texte
Couleur de texte

Description  La propriété Couleur de texte définit la couleur à utiliser pour le texte des objets.

Valeurs   Choisissez une couleur valide dans la palette de couleurs.

Application  Modèles

Valeur par défaut  Noir

PL/SQL Pour définir cet attribut via PL/SQL, utilisez la procédure SRW.SET COLOR TEXT.


Propriété Utiliser espacement vertical
Utiliser espacement vertical

Description  La propriété Utiliser espacement vertical place les objets dans les espaces inutilisés des lignes précédentes, si elle a pour valeur Oui. Par exemple, si un objet d'une ligne peut loger dans un espace inutilisé d'une ligne précédente, il est déplacé vers le haut pour occuper cet espace inutilisé.

 Cliquez ici.

Cette propriété ne s'applique que si le Style est Formulaire.

Application  Modèles

Valeur par défaut  Oui


Lorsque cette propriété a pour valeur Non, l'espace inutilisé des lignes précédentes reste vierge.

Lorsque cette propriété a pour valeur Oui, les objets se déplacent vers le haut pour occuper l'espace inutilisé.


Lorsque cette propriété a pour valeur Oui, les résumés sont alignés avec leur source.

Lorsque cette propriété a pour valeur Non, les résumés peuvent être placés ailleurs ou dans l'enregistrement maître, comme indiqué.


Propriétés XML

Balise XML

Attributs de la balise XML

Exclure de la sortie XML

Type de prologue XML

Valeur du prologue XML

Balise XML externe

Attributs XML externes

Contient des balises XML


Paramètres XML

  Rubriques connexes

Description  Ces propriétés vous permettent de gérer les paramètres XML par défaut d’un état. Certaines propriétés contrôlent les éléments aux niveaux état, groupe et colonne, tandis que d'autres ne concernent qu'un ou deux niveaux.

Pour obtenir de l'aide sur l'une des propriétés figurant sous ce noeud d’en-tête, cliquez sur la propriété désirée puis appuyez sur F1. Pour obtenir de l'aide sur la palette de propriétés, cliquez sur Ctrl pour désélectionner toute propriété éventuellement en surbrillance, puis appuyez sur F1 ou sur le bouton [image] de la palette de propriétés.


Balise XML

  Rubriques connexes	 Exemple

Description  La propriété Balise XML contient le nom d’élément de l’état, du groupe ou de la colonne actuellement sélectionné(e), et peut être définie par l’utilisateur. Vous pouvez donner n’importe quel nom à l’élément, car le rôle de la balise XML est d’identifier de façon unique l’objet comme un type ou une catégorie de données spécifique. Une raison justifiant la génération d’une sortie XML est de configurer les objets selon les spécifications DTD externes permettant l’intégration de votre état avec une application tierce.

Application  état, groupe ou colonne

Obligatoire/Facultatif  Facultatif

Valeur par défaut  nom d’objet (tel qu’affiché dans la propriété Nom)

Notes d'utilisation

•	Peut contenir tous les caractères en une chaîne de longueur illimitée.

•	Le nom de l’élément XML dépend de celui de l’objet dans la palette de propriétés. La modification de la propriété Nom entraîne la modification correspondante de la propriété Balise XML.

•	Si vous ne souhaitez par de sortie XML pour cet objet, mais que vous souhaitez sortir des balises et des données enfants, ne renseignez pas cette propriété. Pour plus d’informations, reportez-vous à la rubrique Exemple de propriété Balise XML.


Attributs de la balise XML

  Rubriques connexes	 Exemples

Description  La propriété Attributs de la balise XML vous permet de définir des attributs XML. L’ajout d’un attribut à une balise d’objet permet de mieux décrire ou localiser la valeur de cette balise. L’utilisation d'attributs est une méthode vous permettant d’organiser la sortie XML. Si vous l’employez, vous devez  entrer une valeur pour cette propriété. L’autre méthode consiste à affecter une balise distincte à chaque type (groupe ou colonne) de données. Dans ce cas, vous ne devez pas renseigner cette propriété.

Application  état, groupe ou colonne

Obligatoire/Facultatif  Facultatif

Valeur par défaut Vide

Syntaxe  Les attributs XML doivent être entrés comme des paires nom-valeur séparées par des espaces. Par exemple :

Attributs de la balise XML :	[nom d'attribut]="&[nom d'objet d'état]"
où le texte entre crochets ([ ]) est défini par vous-même. Le nom d’objet d’état peut correspondre à toute colonne ou paramètre utilisateur de l’état. Vous pouvez ajouter autant d’attributs que vous le souhaitez à ce champ de propriété, en laissant un espace entre chacun d’entre eux.

Notes d'utilisation

•	Tout objet de donnée ajouté en tant qu’attribut à une autre balise XML doit lui-même être exclu de la sortie XML afin de minimiser les redondances. Reportez-vous à la rubrique  Exemple de propriété Attributs de balise XML (niveau groupe) pour plus d’informations.

•	Les attributs doivent se référer à des colonnes ou à des variables intervenant à une fréquence identique ou inférieure


Exclure de la sortie XML

  Rubriques connexes	 Exemples

Description  La propriété Exclure de la sortie XML vous permet de supprimer à la fois la balise XML et les sorties de données associées, dont les données enfants, pour le groupe ou la colonne sélectionné(e). Lorsque vous excluez un objet, il ne sort plus la balise XML, les attributs, les valeurs de données et les données enfants (par exemple les colonnes dans les groupes). Cette propriété est utile pour reformater le document XML afin d'exclure les données pouvant sembler redondantes ou inutiles.

Application état, groupe et colonne.

Obligatoire/Facultatif  Facultatif

Valeur par défaut  Non

Valeurs

Oui

Non

Notes d'utilisation

•	Cette propriété est particulièrement utile lorsque vous avez ajouté un objet comme attribut à un autre élément et que vous ne souhaitez plus que les données de cet objet apparaissent comme un élément distinct dans la sortie XML.

•	Si vous définissez à Oui la propriété Exclure de la sortie XML au niveau état, vous ne pourrez pas générer de sortie XML à partir de l’état, car toutes les données sont des enfants de l’état.


Type de prologue XML

  Rubriques connexes

Description  La propriété Type de prologue XML vous permet de choisir entre un fichier de prologue externe et un prologue texte généré par Report Builder. Le prologue XML peut inclure une déclaration XML, des commentaires, des instructions de traitement (PI) ainsi qu'une  déclaration de type de document (DTD). Pour plus d’informations sur la modification du prologue, reportez-vous à la rubrique Valeur du prologue XML.

Application état

Obligatoire/Facultatif  Obligatoire

Valeur par défaut  Texte

Valeurs

Texte	Entrez le prologue comme du texte dans la propriété Valeur du prologue XML
Fichier	Naviguez vers le fichier de prologue externe à l’aide de la propriété Valeur du prologue XML


Valeur du prologue XML

  Rubriques connexes	 Exemples

Description  La propriété Valeur du prologue XML vous permet de modifier les valeurs du prologue XML devant apparaître au début de toute sortie XML correcte. Le prologue XML doit inclure une déclaration XML mais également des commentaires, des instructions de traitement (telles qu’une feuille de style [XSL]) et une DTD.

Application état

Obligatoire/Facultatif  Une déclaration XML est nécessaire pour toute sortie XML correcte. Cependant, tout caractère alphanumérique dans ce champ de propriété permet la génération de sorties XML brutes dans Report Builder.

Valeurs par défaut  <?xml version="1.0"?>

Exemples de syntaxe

Déclaration XML :	<?xml version="1.0" encoding="UTF-8"?>
Commentaires :	<!-- this is how you do comments in XML -->
Instruction de traitement (PI) :	<?xml:stylesheet type="text/xsl" href="emp.xsl" ?>
Déclaration du type de document (DTD) :	<!DOCTYPE EMP_TABULAR    [ <!ELEMENT EMP_TABULAR (EMP_ITEM)*> <!ELEMENT EMP_ITEM (EMPNO)> <!ELEMENT EMPNO (#PCDATA)> ]>


Balise XML externe

  Rubriques connexes	 Exemple

Description  Le champ de la propriété Balise XML externe affiche le nom du groupe sélectionné, avec le préfixe LIST_. Le but de la balise XML externe est de regrouper toutes les balises et données des instances d’un objet de groupe. Dans un état, vous pouvez avoir des instances itératives d’un objet de groupe (par exemple le numéro de département (DEPTNO), qui sort 10, 20, 30, etc.). La balise XML externe englobe simplement les données de toutes les instances itératives.

Application groupe

Obligatoire/Facultatif  Facultatif

Valeur par défaut  <LIST_G_[groupname]>

Notes d'utilisation

•	Vous pouvez laisser ce champ vide, mais cela peut s’avérer utile uniquement si vous ne disposez que d’une seule instance d’un groupe dans l’interrogation de votre état.


Attributs XML externes

  Rubriques connexes	  Exemple

Description  La propriété Attributs XML externes vous permet d’entrer les attributs XML d’une balise XML externe. L’ajout d’un attribut à une balise externe vous permet de mieux décrire ou localiser la valeur des données de cette balise.

Application  groupe

Obligatoire/Facultatif  Facultatif

Valeur par défaut  Vide

Syntaxe  Les attributs XML externes doivent être entrés comme des paires nom-valeur séparées par des espaces (comme pour les attributs HTML). Par exemple :

Attributs XML externes :	[nom d'attribut]="&[nom d'objet d'état]"
où le texte entre crochets ([ ]) est défini par vous-même. Vous pouvez ajouter autant d’attributs que vous le souhaitez à cette propriété, en laissant un espace entre chacun d’entre eux.

Notes d'utilisation

•	Notez que tout objet de données ajouté en tant qu’attribut à une autre balise XML doit lui-même être exclu de la sortie XML afin de minimiser les redondances. Reportez-vous à la rubrique Exclure de la sortie XML  pour plus d’informations.

•	Les attributs doivent se référer à des colonnes ou à des variables intervenant à une fréquence identique ou inférieure.


Contient des balises XML

  Rubriques connexes 	  Exemple

Description  La propriété Contient des balises XML indique si une colonne d’état contient ou non des balises XML. Si vous définissez cette propriété à Oui, Report Builder ne convertit pas les caractères de syntaxe XML tels que <, >, et &, en &lt;, &gt; et &amp; respectivement.

Application  colonne avec un type de données source égal à caractère

Obligatoire/Facultatif  Facultatif

Valeur par défaut  Non


Exemple de propriété Attributs de la balise XML (niveau groupe)

  Rubriques connexes  	 Tous les exemples

Supposons que votre état utilise l’interrogation suivante :

SELECT * FROM DEPT

La sortie XML par défaut ressemble à ce qui suit :

<MODULE2>
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>10</DEPTNO>
      <DNAME>ACCOUNTING</DNAME>
      <LOC>NEW YORK</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>20</DEPTNO>
      <DNAME>RESEARCH</DNAME>
      <LOC>DALLAS</LOC>
    </G_DEPTNO>

Pour réduire le nombre d’éléments de la sortie, vous pouvez générer une sortie XML qui regroupe toutes les données associées à un numéro de département particulier (DEPTNO) dans l'élément <DEPTNO> de chaque numéro de département.

Dans le modèle de données, indiquez les propriétés suivantes pour la colonne DEPTNO :

Balise XML	DEPTNO
Attributs de la  balise XML :	NAME="&DNAME" LOCATION="&LOC"
où &DNAME est un nom de département et &LOC est le site de ce département. Ces deux objets se répètent à une fréquence identique à celle de DEPTNO.

La nouvelle sortie XML ressemble à ce qui suit :

<G_DEPTNO>
  <DEPTNO NAME="ACCOUNTING" LOCATION="NEW YORK">10</DEPTNO>
  <DNAME>ACCOUNTING</DNAME>
  <LOC>NEW YORK</LOC>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="RESEARCH" LOCATION="DALLAS">20</DEPTNO>
  <DNAME>RESEARCH</DNAME>
  <LOC>DALLAS</LOC>
</G_DEPTNO>

Comme vous pouvez le constater, les valeurs de DNAME et de LOC apparaissent désormais deux fois : une fois en tant qu’attributs, et une fois en tant qu’éléments XML. Afin de les éliminer en tant qu’éléments XML, vous devez également utiliser la propriété Exclure de la sortie XML.

Dans le modèle de données, définissez la propriété Exclure de la sortie XML à Oui pour les colonnes DNAME et LOC :

Le résultat de la sortie  XML ressemble à ce qui suit :

<G_DEPTNO>
  <DEPTNO NAME="ACCOUNTING" LOCATION="NEW YORK">10</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="RESEARCH" LOCATION="DALLAS">20</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="SALES" LOCATION="CHICAGO">30</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="OPERATIONS" LOCATION="BOSTON">40</DEPTNO>
</G_DEPTNO>


Exemple de propriété Attributs de la balise XML (niveau état)

  Rubriques connexes  	 Tous les exemples

L’exemple suivant démontre l’utilité d’un attribut de niveau état dans XML.

Supposons que votre état utilise l’interrogation suivante :

select deptno, job, ename, hiredate from emp

Vous avez conçu votre état avec les groupes à gauche, avec DEPTNO comme groupe de premier niveau et JOB comme groupe de deuxième niveau. Pour les besoins de cet exemple, vous avez sélectionné les colonnes DEPTNO et JOB dans le modèle de données et vous avez défini la propriété Ordre de ventilation à Descendant. Les flèches à gauche des colonnes DEPTNO et JOB dans le modèle de données doivent maintenant pointer vers le bas.

Votre modèle de données ressemble à ce qui suit :

La sortie XML commence comme suit :

<MODULE2>
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <LIST_G_JOB>
        <G_JOB>
          <JOB>SALESMAN</JOB>
          <LIST_G_ENAME>
            <G_ENAME>
              <ENAME>ALLEN</ENAME>
              <HIREDATE>20-FEB-81</HIREDATE>
            </G_ENAME>
            <G_ENAME>
              <ENAME>WARD</ENAME>
              <HIREDATE>22-FEB-81</HIREDATE>
            </G_ENAME>
            <G_ENAME>
              <ENAME>MARTIN</ENAME>
              <HIREDATE>28-SEP-81</HIREDATE>
            </G_ENAME>

Pour référence ultérieure, notez que dans le département numéro 30, les dates d’embauche des trois premiers employés vont du 20 FEV 81 au 28 SEP 81.

Vous ajouterez ensuite un paramètre utilisateur à votre état, permettant de sélectionner ou d'exclure des données en fonction de la date d’embauche. Cliquez deux fois sur l’interrogation (Q_1) dans le modèle de données.

Dans la boîte de dialogue Instruction d’interrogation SQL, ajoutez le texte suivant à la fin de l’interrogation existante :

where hiredate > :p_date

votre interrogation devient donc :

Select deptno, job, ename, hiredate from emp where hiredate > :p_date

Cette instruction SQL demande à Report Builder de créer le paramètre appelé p_date. Cependant, vous devez modifier manuellement la propriété Type de données en Date.

1.	Dans le Navigateur d’objet, cherchez des paramètres utilisateur sous Modèle de données. Cliquez sur le signe plus (+) à gauche de Paramètres utilisateur.

2.	Cliquez deux fois sur l’objet P_DATE.

3.	Dans la palette de propriétés, cliquez sur le champ de la propriété Type de données et sélectionnez Date dans le menu déroulant.

Vous voulez ensuite affecter ce paramètre utilisateur en tant qu’attribut à l’élément au niveau état. Ce paramètre fournira la règle d’inclusion ou d’exclusion des divers éléments dans toute la sortie XML de l’état.

Cliquez deux fois sur le noeud de l’état dans le Navigateur d’objet.

Dans la palette de propriétés, entrez HiredateLaterThan="&p_date" dans le champ de la propriété Attributs de la balise XML.

Exécutez l’état dans l'Aperçu interactif. Une grille de paramètres d'exécution apparaît, vous demandant d’entrer une valeur de date (P Date). Entrez 1-JUL-81 et cliquez sur [image].

La sortie XML ressemble maintenant à ce qui suit :

<MODULE2 HiredateLaterThan="01-JUL-81">
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <LIST_G_JOB>
        <G_JOB>
          <JOB>SALESMAN</JOB>
          <LIST_G_ENAME>
            <G_ENAME>
              <ENAME>MARTIN</ENAME>
              <HIREDATE>28-SEP-81</HIREDATE>
            </G_ENAME>

Notez que les instances du groupe G_ENAME avec des valeurs HIREDATE antérieures au 1er juillet 81 ne sont plus disponibles dans XML. L’attribut qui définit ce paramètre, HiredateLaterThan="01-JUL-81", apparaît maintenant dans l’élément au niveau état, MODULE2.


Exemple de propriété Exclure de la sortie XML (sortie des données limitée)
Exemple de propriété Exclure de la sortie XML (sortie de données limitée)

  Rubriques connexes  	 Tous les exemples

Supposons que vous souhaitiez créer une sortie XML limitant les données à quelques éléments spécifiques. Actuellement, la sortie XML inclut le numéro du département (DEPTNO), le nom du département (DNAME) ainsi que le site (LOC), et ressemble à ce qui suit :

    <G_DEPTNO>
      <DEPTNO>10</DEPTNO>
      <DNAME>ACCOUNTING</DNAME>
      <LOC>NEW YORK</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>20</DEPTNO>
      <DNAME>RESEARCH</DNAME>
      <LOC>DALLAS</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <DNAME>SALES</DNAME>
      <LOC>CHICAGO</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>40</DEPTNO>
      <DNAME>OPERATIONS</DNAME>
      <LOC>BOSTON</LOC>
    </G_DEPTNO>

Vous décidez de supprimer la balise <LOC> et ses données associées.

Dans le modèle de données, cliquez deux fois sur la colonne LOC et indiquez la propriété suivante dans la palette de propriétés :

Exclure de la sortie XML :	Oui
La sortie XML ressemble maintenant à ce qui suit :

  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>10</DEPTNO>
      <DNAME>ACCOUNTING</DNAME>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>20</DEPTNO>
      <DNAME>RESEARCH</DNAME>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <DNAME>SALES</DNAME>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>40</DEPTNO>
      <DNAME>OPERATIONS</DNAME>
    </G_DEPTNO>
  </LIST_G_DEPTNO>

Si vous souhaitez supprimer la balise <LIST_G_DEPTNO> ou la balise <G_DEPTNO> sans exclure de données enfants (telles que DEPTNO ou DNAME), sélectionnez le groupe  G_DEPTNO dans le modèle de données et ouvrez sa palette de propriétés. Supprimez la balise XML G_DEPTNO dans le champ de la propriété Balise XML et supprimez la balise XML LIST_G_DEPTNO XML dans le champ de la propriété Balise XML externe. Reportez-vous à la rubrique Balise XML externe pour plus d’informations.


Exemple de propriété Exclure de la sortie XML (redondance limitée)

  Rubriques connexes  	 Tous les exemples

Supposons que vous ayez décidé d’utiliser des attributs dans la sortie XML, qui ressemble maintenant à ce qui suit :

<G_DEPTNO>   <DEPTNO NAME="ACCOUNTING" LOCATION="NEW YORK">10</DEPTNO>   <DNAME>ACCOUNTING</DNAME>   <LOC>NEW YORK</LOC> </G_DEPTNO> <G_DEPTNO>   <DEPTNO NAME="RESEARCH" LOCATION="DALLAS">20</DEPTNO>   <DNAME>RESEARCH</DNAME>   <LOC>DALLAS</LOC> </G_DEPTNO>
Afin d’éliminer les redondances, vous devez exclure les éléments DNAME et LOC de la sortie XML.

Dans le modèle de données, affichez la palette de propriétés des colonnes DNAME et LOC et indiquez la propriété suivante :

Exclure de la sortie  XML :	Oui
La sortie XML ressemble maintenant à ce qui suit :

<G_DEPTNO>
  <DEPTNO NAME="ACCOUNTING" LOCATION="NEW YORK">10</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="RESEARCH" LOCATION="DALLAS">20</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="SALES" LOCATION="CHICAGO">30</DEPTNO>
</G_DEPTNO>
<G_DEPTNO>
  <DEPTNO NAME="OPERATIONS" LOCATION="BOSTON">40</DEPTNO>
</G_DEPTNO>


Exemple de propriété Balise XML

  Rubriques connexes  	 Tous les exemples

Supposons que vous souhaitiez créer une sortie XML pour l’état, les groupes et les colonne de votre interrogation. Une instruction d’interrogation telle que :

SELECT deptno, dname, loc FROM dept

dans un état génère la sortie XML suivante :

<MODULE1>
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>10</DEPTNO>
      <DNAME>ACCOUNTING</DNAME>
      <LOC>NEW YORK</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>20</DEPTNO>
      <DNAME>RESEARCH</DNAME>
      <LOC>DALLAS</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <DNAME>SALES</DNAME>
      <LOC>CHICAGO</LOC>
    </G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>40</DEPTNO>
      <DNAME>OPERATIONS</DNAME>
      <LOC>BOSTON</LOC>
    </G_DEPTNO>
  </LIST_G_DEPTNO>
</MODULE1>

Si vous ne souhaitez plus que certaines balises apparaissent dans la sortie, supprimez simplement leur nom par défaut dans le champ de la propriété Balise XML, en le laissant vide. Vous éliminerez ainsi la sortie de la balise sans exclure cependant les données enfants associées à ces balises enfants.

Par exemple, si vous supprimez la balise G_DEPTNO, la sortie XML ressemblera à ce qui suit :

<MODULE1>
  <LIST_>
    <DEPTNO>10</DEPTNO>
    <DNAME>ACCOUNTING</DNAME>
    <LOC>NEW YORK</LOC>
    <DEPTNO>20</DEPTNO>
    <DNAME>RESEARCH</DNAME>
    <LOC>DALLAS</LOC>
    <DEPTNO>30</DEPTNO>
    <DNAME>SALES</DNAME>
    <LOC>CHICAGO</LOC>
    <DEPTNO>40</DEPTNO>
    <DNAME>OPERATIONS</DNAME>
    <LOC>BOSTON</LOC>
  </LIST_>
</MODULE1>

Notez que la balise précédemment appelée <LIST_G_DEPTNO>s’appelle maintenant <LIST_>. Elle est appelée Balise XML externe et est associée uniquement à des balises de groupe. Le nom de la balise XML externe est sélectionné à partir du nom de balise XML du groupe. Si vous souhaitez également supprimer la balise <LIST_>, vous pouvez laisser le champ Balise XML externe vide. Reportez-vous à la rubrique Balise XML externe pour plus d’informations.


Exemple de propriété Balise XML externe

  Rubriques connexes  	 Tous les exemples

Supposons que votre état contienne l’interrogation suivante :

SELECT * from EMP

Vous avez décidé d’afficher ces données sous la forme d’un état avec les groupes à gauche, avec DEPTNO comme groupe de premier niveau et JOB comme groupe de deuxième niveau.

Pour les besoins de cet exemple, vous souhaitez inverser l’ordre de sortie des groupes DEPTNO et JOB, de ascendant en descendant

1.	Dans le modèle de données, sélectionnez la colonne DEPTNO et ouvrez la palette de propriétés.

2.	Modifiez la propriété Ordre de ventilation de Ascendant en Descendant.

3.	Répétez ces deux étapes pour la colonne JOB.

Votre modèle de données ressemble à ce qui suit :

Vous pouvez maintenant afficher la structure hiérarchique de la sortie XML pour les groupes de votre état. Ayant fait du groupe G_JOB un enfant du groupe G_DEPTNO, vous décidez de réduire tous les éléments du groupe externe <LIST_G_DEPTNO> afin de développer la structure de données d’un niveau à la fois.

- <MODULE1>
- <LIST_G_DEPTNO>
+ <G_DEPTNO>
+ <G_DEPTNO>
+ <G_DEPTNO>
  </LIST_G_DEPTNO>
  </MODULE1>

Dans l’exemple XML ci-dessus, vous pouvez constater que pour le groupe G_DEPTNO (représenté par la balise externe <LIST_G_DEPTNO>), il existe trois instances uniques des données DEPTNO. Vous souhaitez maintenant voir le groupe de prochain niveau, G_JOB, qui est un enfant de G_DEPTNO. Si vous développez la première balise XML <G_DEPTNO>, la sortie suivante apparaît :

- <MODULE1>
- <LIST_G_DEPTNO>
- <G_DEPTNO>
<DEPTNO>30</DEPTNO>
+ <LIST_G_JOB>
  </G_DEPTNO>
+ <G_DEPTNO>
+ <G_DEPTNO>
  <LIST_G_DEPTNO>
  </MODULE1>

Tout comme <LIST_G_DEPTNO> contient des instances itératives de <G_DEPTNO>, + <LIST_G_JOB> contient des instances itératives de <G_JOB>. Si vous développez l’élément + <LIST_G_JOB>, la sortie XML suivante apparaît à sa place :

- <LIST_G_JOB>
+ <G_JOB>
+ <G_JOB>
+ <G_JOB>
- </LIST_G_JOB>

Si vous développez le premier élément G_JOB (+<G_JOB>), la sortie XML suivante apparaît à sa place :

- <G_JOB>
<JOB>SALESMAN</JOB>
+ <LIST_G_EMPNO>
  </G_JOB>

Comme vous pouvez le constater, <G_JOB> contient des instances d’un autre groupe itératif, <G_EMPNO>. Si vous développez +<LIST_G_EMPNO>, les instances de <G_EMPNO> apparaissent. Dans ce cas, il n’y aura pas d’autre groupes enfants, mais un certain nombre de valeurs de colonnes sont disponibles pour le groupe G_EMPNO. La sortie XML ressemble à ce qui suit :

- <LIST_G_EMPNO>
- <G_EMPNO>
<EMPNO>7499</EMPNO>
<ENAME>ALLEN</ENAME>
<MGR>7698</MGR>
<HIREDATE>20-FEB-81</HIREDATE>
<SAL>1600</SAL>
<COMM>300</COMM>
</G_EMPNO>
  </LIST_G_EMPNO>

L’élément externe <LIST_[groupname]> est utile en tant que conteneur de groupes itératifs.


Exemple de propriété Attributs XML externes

  Rubriques connexes  	 Tous les exemples

Supposons que votre état utilise l’interrogation suivante :

SELECT deptno, job, ename, sal FROM EMP

Vous avez décidé d’afficher ces données sous la forme d’un état avec les groupes à gauche, avec DEPTNO comme groupe de premier niveau et JOB comme groupe de  deuxième niveau.

Pour les besoins de cet exemple, vous souhaitez inverser l’ordre de sortie des groupes DEPTNO et JOB, de ascendant en descendant.

1.	Dans le modèle de données, sélectionnez la colonne DEPTNO et ouvrez la palette de propriétés.

2.	Modifiez la propriété Ordre de ventilation de Ascendant en Descendant.

3.	Répétez ces deux étapes pour la colonne JOB.

Votre modèle de données ressemble à ce qui suit :

Actuellement, la sortie XML ressemble à ce qui suit :

<MODULE1>
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <LIST_G_JOB>
        <G_JOB>
          <JOB>SALESMAN</JOB>
          <LIST_G_ENAME>
            <G_ENAME>
              <ENAME>ALLEN</ENAME>
              <SAL>1600</SAL>
            </G_ENAME>
            <G_ENAME>
              <ENAME>WARD</ENAME>
              <SAL>1250</SAL>
            </G_ENAME>

où une valeur unique de <JOB> s’applique au moins à deux occurrences de <G_ENAME>. De façon plus précise, au moins deux employés (ALLEN et WARD) occupent des postes de SALESMAN. Au lieu d’imbriquer le titre du poste (<JOB>) dans une balise XML distincte sur une ligne séparée, vous voulez intégrer cette valeur unique dans l’élément <LIST_G_ENAME> puisque la valeur de <JOB> apparaît une seule fois par occurrence de <LIST_G_ENAME>.

Dans le modèle de données, indiquez les propriétés suivantes :

Objet groupe	Propriété	Action	Valeur
G_ENAME	Attributs XML externes	Type	JOBTITLE="&JOB"
JOB	Exclure de la sortie XML	[Sélectionner]	Oui
G_JOB	Balise XML	Supprimer	G_JOB
La sortie XML ressemble maintenant à ce qui suit :

<MODULE1>
  <LIST_G_DEPTNO>
    <G_DEPTNO>
      <DEPTNO>30</DEPTNO>
      <LIST_G_JOB>
        <LIST_G_ENAME JOBTITLE="SALESMAN">
          <G_ENAME>
            <ENAME>ALLEN</ENAME>
            <SAL>1600</SAL>
          </G_ENAME>
          <G_ENAME>
            <ENAME>WARD</ENAME>
            <SAL>1250</SAL>
          </G_ENAME>


Exemple de propriété Valeur du prologue XML (type de prologue : texte)

  Rubriques connexes  	 Tous les exemples

Supposons que vous souhaitiez inclure le prologue sous la forme d’un texte au début de la sortie XML.

Avec un état ouvert dans Report Builder, sélectionnez l’icône d’état dans le Navigateur d’objet et affichez la palette de propriétés. Définissez la propriété suivante :

Type de prologue XML :	Texte
Cliquez ensuite une fois sur le champ de la propriété Valeur du prologue XML pour afficher le bouton [image]. Cliquez sur ce bouton pour afficher la boîte de dialogue Valeur du prologue XML. Entrez le texte du prologue et cliquez sur OK.

L’exemple de texte de prologue suivant contient (dans l'ordre) une déclaration XML, un commentaire, une instruction de traitement (PI) et une déclaration de type de document (DTD) :

<?xml version="1.0" encoding="UTF-8"?>
<!-- This is how you make comments in XML -->
<?xml:stylesheet type="text/xsl" href="emp.xsl" ?>
<!DOCTYPE EMP_TABULAR   [
<!ELEMENT EMP_TABULAR (EMP_ITEM)*>
<!ELEMENT EMP_ITEM (EMPNO)>
<!ELEMENT EMPNO (#PCDATA)>
]>


Exemple de propriété Valeur du prologue XML (type de prologue : fichier)

  Rubriques connexes  	 Tous les exemples

Supposons que vous souhaitiez avoir votre prologue dans un fichier externe.

Un état étant ouvert dans Report Builder, définissez la propriété suivante au niveau de l’état :

Type de prologue XML	Fichier
Cliquez ensuite une fois dans le champs de la propriété Valeur du prologue XML pour afficher le bouton [image]. Cliquez sur ce bouton pour naviguer vers le fichier externe contenant le texte du prologue.

L’exemple de texte de prologue suivant contient (dans l'ordre) une déclaration XML, un commentaire, une instruction de traitement (PI) et une déclaration de type de document (DTD) :

<?xml version="1.0" encoding="UTF-8"?>
<!-- This is how you make comments in XML -->
<?xml:stylesheet type="text/xsl" href="emp.xsl" ?>
<!DOCTYPE EMP_TABULAR   [
<!ELEMENT EMP_TABULAR (EMP_ITEM)*>
<!ELEMENT EMP_ITEM (EMPNO)>
<!ELEMENT EMPNO (#PCDATA)>
]>


Exemple de propriété Contient des balises XML

  Rubriques connexes  	 Tous les exemples

Supposons que votre base de données contienne déjà des balises XML incluses dans les valeurs d’une colonne. Dans la première instance ci-dessous, la balise XML DESTINATION représente un paramètre défini par l’utilisateur appelé &p_dest. Si la propriété Contient des balises XML est définie à Oui, Report Builder reconnaît <DESTINATION> comme étant une balise XML, interprète &p_dest comme une valeur variable selon les spécifications de l’utilisateur, et insère une valeur unique à la place de &p_dest dans la sortie XML. Ceci est vrai pour toute valeur dans une colonne ayant la syntaxe "&[nom d'objet d'état]".

Valeur de colonne variable avec balise XML :

Chaîne de texte d’origine dans la colonne :	<DESTINATION>&p_dest<DESTINATION>
Contient des balises XML = Oui :	<DESTINATION>FIJI<DESTINATION>
Contient des balises XML = Non :	&lt;DESTINATION&gt;&amp;p_dest&lt;DESTINATION&gt;

Valeur de colonne fixe avec balise XML :

Chaîne de texte d’origine dans la colonne :	<JOB>Clerk<JOB>
Contient des balises XML = Oui :	<JOB>Clerk<JOB>
Contient des balises XML = Non :	&lt;JOB&gt;Clerk&lt;JOB&gt;


A propos des fichiers de définition d'imprimante

  Rubriques connexes

Un fichier de définition d'imprimante est une sorte de "traducteur" : il contient des codes qui indiquent à l'imprimante comment gérer les caractères graphiques, les soulignés, les gras utilisés dans les traits, les encadrements et autres. Les fichiers de définition d'imprimante sont des fichiers texte (ASCII, EBCDIC ...) qui s'utilisent sans compression ou compilation supplémentaire.

Attention : Les définitions d'imprimante et de terminal ne sont nécessaires que sur les plates-formes en mode caractère, et non sur celles en mode bitmap.


Utilisation d'un fichier de définition d'imprimante

  Rubriques connexes

Pour utiliser un fichier de définition d'imprimante (uniquement lors de l'exécution d'un état sur une plate-forme en mode caractère) :

1	Indiquez au paramètre système DESFORMAT le nom du fichier de définition d'imprimante.

2	Attribuez la valeur Printer à DESTYPE et le nom de l'imprimante à DESNAME.


Fichiers de définition d'imprimante en package

  Rubriques connexes

dec.prt	Fichier générique pour la plupart des imprimantes DEC qui acceptent les formats de page 66x80 pour les imprimantes LN03, LPS40, LP05 et LA50.
Decland.prt	Fichier générique qui imprime en mode paysage et accepte les formats de page 66x132.
Decwide.prt	Identique à dec, mais accepte les formats de page 66x132.
Dec180.prt	Identique à decland, mais accepte les formats de page 66x180.
Dflt.prt	Fichier générique qui ne tient pas compte des attributs de mise en évidence et accepte les formats de page 66x180.
Hpl.prt	Fichier générique pour imprimante HP LaserJet, qui accepte les formats de page 66x180.
Hplwide.prt	Identique à hpl, mais accepte les formats de page 66x132.
Psland.prt	Fichier PostScript qui imprime en mode paysage et accepte les formats de page 110x51.
Psl132.prt	Fichier PostScript qui imprime en mode paysage et accepte les formats de page 132x66.
Psl180.prt	Fichier PostScript qui imprime en mode paysage et accepte les formats de page 180x66.
Psport.prt	Fichier PostScript qui imprime en mode portrait et accepte les formats de page 85x66.
Psp132.prt	Fichier PostScript qui imprime en mode portrait et accepte les formats de page 132x120.
Wide.prt	Fichier générique qui ne tient pas compte des attributs de mise en évidence et accepte les formats de page 66x132.
Wide180.prt	Identique à wide, mais accepte les formats de page 66x180.
Notes d'utilisation

•	Il est possible que vous n'ayez pas toutes les définitions d'imprimante décrites ci-dessus, et que vous en ayez d'autres, car les définitions d'imprimante fournies avec Report Builder sont propres au système utilisé.

•	Comme les fichiers de définition d'imprimante sont des fichiers texte (EBCDIC, ASCII, ...), vous pouvez les créer ou les modifier en utilisant l'éditeur de texte de votre choix. N'oubliez pas de les enregistrer en format texte lorsque vous avez terminé. Pour utiliser une définition d'imprimante nouvelle ou modifiée, utilisez alors le mot-clé DESFORMAT.


Syntaxe de fichier de définition d'imprimante (codes d'imprimante)

  Restrictions [image]  Exemples	  Rubriques connexes

Un fichier de définition d'imprimante contient des codes d'imprimante. Certains noms de code d'imprimante sont utilisés pour la définition de l'imprimante PostScript et en mode caractère, alors que d'autres ne sont significatifs que pour l'un ou l'autre.

Codes d'imprimante communs aux imprimantes PostScript et en mode caractère

Nom de code et syntaxe	Utilisation
after report <chaîne_gén>	Indique le code <chaîne_gén> à envoyer à l'imprimante après l'impression de l'état. Ce code est généralement utilisé pour garantir que le prochain travail d'impression commence sur une nouvelle page.
before report <chaîne_gén>	Semblable à AFTER REPORT, mais le code <chaîne_gén> est envoyé avant le début de l'impression de l'état.
after page <chaîne_gén>	Indique le code <chaîne_gén> à envoyer à l'imprimante après chaque page physique (c'est-à-dire chaque page d'imprimante), dernière page comprise.
between pages <chaîne_gén>	Indique le code <chaîne_gén> à envoyer à l'imprimante après chaque page physique (c'est-à-dire chaque page d'imprimante), à l'exception de la dernière.
code *chaîne* <chaîne_gén>	Indique un code défini par l'utilisateur ou reconnu par Report Builder. Voir *chaîne* ci-dessous.
height <entier>	Indique la hauteur de l'état, en caractères.
printer <chaîne>	Indique le nom de l'imprimante.
width <entier>	Indique la largeur de l'état, en caractères.
Codes spécifiques de caractères

Nom de code et syntaxe	Utilisation
automargin	Indique qu'un retour chariot ne doit pas être ajouté à la fin du fichier lorsque le caractère de la dernière colonne n'est pas Null.
autopage	Indique qu'un saut de page ne doit pas être exécuté à la fin d'une page dont la dernière ligne n'est pas vierge.
box bottom center <chaîne_gén>	Indique la chaîne à utiliser pour tracer le centre du bord inférieur d'une boîte (8).
box bottom left <chaîne_gén>	Indique la chaîne à utiliser pour tracer l'angle inférieur gauche d'une boîte (7).
box bottom right <chaîne_gén>	Indique la chaîne à utiliser pour tracer l'angle inférieur droit d'une boîte (9)
box center center <chaîne_gén>	Indique la chaîne à utiliser pour tracer le centre d'une boîte (5).
box center left <chaîne_gén>	Indique la chaîne à utiliser pour tracer le centre du bord gauche d'une boîte (4).
box center right <chaîne_gén>	Indique la chaîne à utiliser pour tracer le centre du bord droit d'une boîte (6).
box horizontal <chaîne_gén>	Indique la chaîne à utiliser pour tracer les bords supérieur et inférieur d'une boîte.
box top center <chaîne_gén>	Indique la chaîne à utiliser pour tracer le centre du bord supérieur d'une boîte (2).
box top left <chaîne_gén>	Indique la chaîne à utiliser pour tracer l'angle supérieur gauche d'une boîte (1).
box top right <chaîne_gén>	Indique la chaîne à utiliser pour tracer l'angle supérieur droit d'une boîte (3).
box vertical <chaîne_gén>	Indique la chaîne à utiliser pour tracer les bords droit et gauche de la boîte.
hilight backspace <chaîne_gén>	Imprime un caractère gras ou souligné en imprimant le caractère, en effectuant un retour arrière et en réimprimant le caractère. Le retour arrière est effectué en fonction du code <chaîne_gén> (par exemple, ("0m")
hilight overstrike	Simule le gras/souligné en imprimant les lignes puis en réimprimant les mentions qui doivent figurer en gras ou en souligné, le cas échéant.
landscape <chaîne_gén>	Indique la chaîne <chaîne_gén> à utiliser pour obtenir une impression en mode paysage.
linefeed <chaîne_gén>	Indique la chaîne <chaîne_gén> à utiliser à la fin de chaque ligne d'une page.
return string <chaîne_gén>	Indique la chaîne <chaîne_gén> à utiliser pour faire revenir l'imprimante au début de la ligne en cours.
Codes spécifiques PostScript

Nom de code et syntaxe	Utilisation
postscript	Indique que le fichier de définition concerne une imprimante PostScript.


chaîne_gén

Pour les imprimantes en mode caractère, < chaîne_gén > indique une combinaison des éléments ci-dessous, dans l'ordre de votre choix :

•	chaîne, par exemple, "abc"

•	entier, par exemple, 10

•	déc(nombre_décimal), par exemple, dec(10)

•	octal(nombre_octal), par exemple, octal(10)

•	hex(nombre_hexa), par exemple, hex(1A)

•	^caractère de contrôle, par exemple, ^L

•	contrôle(caractère_de_contrôle), par exemple, ctrl(L)

•	esc chaîne_d'échappement, par exemple, esc "abc"

Pour les imprimantes PostScript, <chaîne_gén> indique une combinaison des éléments ci-dessous, dans l'ordre de votre choix, qui doivent être précédés et suivis de guillemets :

•	BOLD, c'est-à-dire, passe à l'impression en gras

•	BOLDFONT, c'est-à-dire, passe à la police gras

•	BOLDOBLIQUE, c'est-à-dire, passe à l'italique gras

•	BOLDOBLIQUEFONT, c'est-à-dire, passe à la police italique gras

•	BOTTOMMARGIN, c'est-à-dire, passe à la marge basse

•	BOX, c'est-à-dire, passe à la police de boîtes

•	FONTSIZE, c'est-à-dire, change la taille de police de caractères

•	LANDSCAPE, c'est-à-dire, passe au mode paysage

•	LEFTMARGIN, c'est-à-dire, définit la taille de la marge non imprimable

•	MONOSPACE, c'est-à-dire, passe à l'espacement simple (applique la matrice de caractères)

•	NORMAL, c'est-à-dire, passe au mode normal

•	NORMALFONT, c'est-à-dire, passe à police normale

•	OBLIQUE, c'est-à-dire, passe en italique

•	OBLIQUEFONT, c'est-à-dire, passe à la police italique

•	PAGEHT, c'est-à-dire, définit le nombre de caractères devant tenir en hauteur dans une page

•	PAGEWD, c'est-à-dire, définit le nombre de caractères devant tenir dans la largeur dans une page

•	PAPERHT, c'est-à-dire, définit la hauteur du papier en pouces

•	PAPERWD, c'est-à-dire, définit la largeur du papier en pouces

•	PORTRAIT, c'est-à-dire, passe au mode portrait

•	PROPORTIONAL, c'est-à-dire, passe à l'espacement proportionnel (sans application de la matrice de caractères)

•	RIGHTMARGIN, c'est-à-dire, définit la largeur de la marge de droite

•	ROTATE2, c'est-à-dire, imprime deux pages par page après rotation

•	TOPMARGIN, c'est-à-dire, définit la largeur des marges du haut

•	UNDERLINE, c'est-à-dire, passe au mode souligné

•	UNDERLINESTOP, c'est-à-dire, annule le mode souligné


chaîne

<chaîne> indique un ou plusieurs caractères alphanumériques, signes de ponctuation inclus, qui doivent être précédés et suivis de guillemets.


*chaîne*

*chaîne* indique l'un des deux types de nom de code : créés par l'utilisateur ou reconnus par Report Builder. Un nom de code défini par l'utilisateur est un code que vous créez. Un code en package est un nom de code que Report Builder utilise lorsque vous sélectionnez un attribut (par exemple, GRAS) dans une boîte de dialogue de fenêtre d'affichage d'objet de présentation.

•	bold off

•	bold on

•	bold italic underline off

•	bold italic underline on

•	bold underline off

•	bold underline on

•	italic off

•	italic on

•	italic underline off

•	italic underline on

•	plain off

•	plain on

•	underline off

•	underline on

Notes d'utilisation

•	Si vous créez un code d'imprimante et voulez que Report Builder utilise une chaîne généralisée créée par l'utilisateur sur un objet, au lieu d'une chaîne en package, vous pouvez :

•	Entrer votre nom de code d'imprimante dans la propriété Code d'imprimante avant ou après de l'objet de présentation

•	Utiliser les procédures PL/SQL en package SRW.DEFAULT_BEFORE_CODE et SRW.DEFAULT_AFTER_CODE.


Fichiers de définition d'imprimante - Restrictions

•	Un fichier de définition d'imprimante ne peut contenir qu'une définition d'imprimante.

•	L'ordre d'entrée des codes est sans importance.

•	Les codes doivent être séparés par des blancs ou des retours chariot ; vous pouvez donc entrer plusieurs codes sur la même ligne.

•	Les sauts de ligne et les espaces sont traités de la même manière, c'est-à-dire que si vous entrez un retour chariot à la fin de la ligne, il sera interprété comme un espace. Exception : Lorsque qu'un retour chariot est placé dans une chaîne, il est interprété comme un retour chariot.

•	Lorsque vous indiquez des codes d'imprimante, les blancs supplémentaires, les majuscules et l'ordre ne sont pas pris en compte. Par exemple, sont considérés par le programme comme identiques:

bold underline off
bold UNDERLINE OfF
Underline Bold Off

•	Certains systèmes d'exploitation peuvent demander des guillemets simples au lieu des guillemets classiques pour les chaînes.  En outre, votre ficher de définition d'imprimante peut faire la différence entre les majuscules et les minuscules.

•	Les codes d'imprimante précédés de zéros sont considérés comme identiques. Par exemple, 001 équivaut à 1.

•	Si vous entrez une chaîne vierge ("") comme code after page, des sauts de ligne seront insérés jusqu'au début d'une nouvelle page.

•	Les codes HILIGHT OVERSTRIKE et HILIGHT BACKSPACE sont mutuellement exclusifs. En outre, si une séquence d'imprimante reconnue (par exemple, BOLD ON ou BOLDOFF) est indiquée dans un fichier avec les codes HILIGHT, la séquence d'imprimante reconnue a priorité.

•	Lorsque vous indiquez un fichier de définition pour DESFORMAT, la recherche du fichier s'effectue en fonction de l'ordre de recherche de fichiers de définition de terminal et d'imprimante


dflt.prt - Exemple

  Rubriques connexes 	  Tous les exemples

printer "dflt"

height   66

width    80

after report  control(L)

after page control(L)

return      ""

linefeed    control(J)


declno3.prt - Exemple

  Rubriques connexes 	  Tous les exemples

printer "dec LNO3"

height   66

width    80

return      ""

linefeed  10

after report  control(L)

after page control(L)

box horizontal    "-"

box vertical      "|"

box top left      "+"

box top center    "+"

box top right     "+"

box center left   "+"

box center center "+"

box center right  "+"

box bottom left   "+"

box bottom center "+"

box bottom right  "+"

code "box on"        ""

code "box off"       ""

code "bold on"         esc "[1m"

code "bold off"        esc "[0m"

code "underline on"    esc "[4m"

code "underline off"   esc "[0m"

code "500"   esc "[2N"


dec180.prt - Exemple

  Rubriques connexes 	  Tous les exemples

printer "dec180"

height   66

width    180

before report control(L)

after report  control(L)

after page control(L)

return      ""

linefeed    control(J)

code "bold on"         esc "[1m"

code "bold off"        esc "[0m"

code "underline on"    esc "[4m"

code "underline off"   esc "[0m"


hplwide.prt - Exemple

  Rubriques connexes 	  Tous les exemples

printer "hplwide"

height   66

width    132

before report esc "(s0P" esc "&k2S" esc "&17.27c66F"

after report  control(L)

after page control(L)

return      ""

linefeed    control(J)

code "bold on"         esc "(s7B"

code "bold off"        esc "(s0B"

code "underline on"    esc "&dD"

code "underline off"   esc "&d@"


psport85.prt - Exemple

  Rubriques connexes 	  Tous les exemples

printer "postscript portrait"       % définit type d'imprimante

postscript        %% déclare l'imprimante comme étant de type PostScript

height   66      %% hauteur de la page, en caractères

width   85      %% largeur de la page, en caractères

return   ""       %% non nécessaire pour PostScript

linefeed ""       %% non nécessaire pour PostScript

before report "

PORTRAIT          %% définit le mode portrait

12 FONTSIZE       %% sélectionne une taille de police appropriée

8.5 PAPERWD       %% format de papier : 8.5 x 11

11 PAPERHT        %%

66 PAGEHT         %% format de chaque page : 80 x 66

85 PAGEWD         %%

0.2 LEFTMARGIN    %% laisse une petite bordure

0.2 RIGHTMARGIN   %%

0.2 TOPMARGIN     %%

0.2 BOTTOMMARGIN  %%

NORMAL            %% définit la police Courier normal

after report ""   %% non nécessaire pour PostScript

after page ""     %% non nécessaire pour PostScript

box horizontal    "a"

box vertical      "b"

box top left      "c"

box top center    "d"

box top right     "e"

box center left   "f"

box center center "g"

box center right  "h"

box bottom left   "i"

box bottom center "j"

box bottom right  "k"

code "box on"     "BOX"

code "box off"                    "NORMAL"

code "bold on"                    "BOLD"

code "bold off"                   "NORMAL"

code "underline on"               "UNDERLINE"

code "underline off"              "UNDERLINESTOP"

code "italic on"                  "OBLIQUE"

code "italic off"                 "NORMAL"

code "bold italic on"             "BOLDOBLIQUE"

code "bold italic off"            "NORMAL"

code "bold underline on"          "BOLD UNDERLINE"

code "bold underline off"         "NORMAL UNDERLINESTOP"

code "italic underline on"        "OBLIQUE UNDERLINE"

code "italic underline off"       "NORMAL UNDERLINESTOP"

code "bold italic underline on"   "BOLDOBLIQUE UNDERLINE"

code "bold italic underline off"  "NORMAL UNDERLINESTOP"

code "1" " PROPORTIONAL /Times-Bold 14 SETFONT "

code "2" " MONOSPACE NORMAL "


Description

Le terme "ressources de terminal" regroupe les données qui indiquent les fonctionnalités de votre terminal. Ces ressources contiennent des définitions décrivant à Report Builder les attributs des différents terminaux (par exemple, largeur et hauteur d'écran, fonctions graphiques, etc.). En outre, les ressources de terminal associent les fonctions des applications à des touches spécifiques de terminal, en utilisant des "associations de touches". Ces ressources sont stockées dans les fichiers de ressources de terminal.

Attention :  Les définitions d'imprimante et de terminal ne sont nécessaires que sur les plates-formes en mode caractère, et non sur celles en mode bitmap.


Définitions de terminal en package

Nom de fichier	Description
dflt.res	Indique un fichier de ressources génériques qui offre un minimum de ressources et d'associations de touches. Il est utilisé si aucun fichier de ressources n'est indiqué lors de l'appel de Report Builder.
sun4.res	Indique un fichier de ressources qui contient la définition et les associations de touches d'un terminal Sun4.
sun10.res	Indique un fichier de ressources qui contient la définition et les associations de touches d'un terminal Sun10.
vt100.res	Indique un fichier de ressources qui contient la définition et les associations de touches d'un terminal VT100.
vt220.res	Indique un fichier de ressources qui contient la définition et les associations de touches d'un terminal VT220.
vt320.res	Indique un fichier de ressources qui contient la définition et les associations de touches d'un terminal VT320.
Notes d'utilisation

•	Il est possible que vous n'ayez pas tous les fichiers de ressources de terminal décrits ci-dessus, et que vous en ayez d'autres, car les définitions d'imprimante, fournies avec Report Builder, sont propres au système utilisé.


Ressources de terminal

Les fichiers de ressources de Report Builder sont créés et actualisés à l'aide d'un outil appelé Oracle Terminal. Pour modifier vos fichiers de ressources de terminal, vous devez accéder à l'Editeur de ressources d'Oracle Terminal ot.

Vous ne pouvez utiliser l'éditeur de ressources d'Oracle Terminal pour configurer les ressources du terminal pour une application donnée que si celle-ci a été créée avec Oracle Terminal Support. Pour Report Builder, cela signifie que vous ne pouvez pas configurer les ressources de terminal pour la version bitmap. En outre, les ressources en mode caractère que vous configurez sont limitées à :

  Associations de touches

 Fichiers de définition de terminal

Notes d'utilisation

•	Vous ne pouvez pas modifier l'aspect de l'interface runtime (boîtes de dialogue, etc.).

•	Lorsque vous modifiez les ressources de terminal en mode caractère, nous vous conseillons d'utiliser le mode caractère de l'exécutable, comme décrit ci-dessous. Bien que vous puissiez éditer les ressources de toutes les plates-formes sur toutes les plates-formes, vous devez générer les associations de touches sur la plate-forme pour laquelle elles seront utilisées.

•	Comme vous utiliserez des exécutables en mode caractère, vous devez connaître les conventions de représentation des touches de fonction correspondant au mode caractère. Les touche de fonction de Report Builder et d'Oracle Terminal sont représentées par le nom de la fonction entre crochets (par exemple, [Page suivante]). Vous pouvez faire référence à un schéma de pavé de touches ou à l'écran Afficher touches (accessible par l'Aide) pour établir la correspondance entre ces touches de fonction et les touches physiques de votre clavier.

•	Ce système d'aide n'est pas prévu pour couvrir la totalité des possibilités offertes par Oracle Terminal, ni pour fournir un tutoriel d'Oracle Terminal. Seuls sont traités les aspects d'Oracle Terminal qui concernent Report Builder. En outre, les exemples ne portent pas sur toutes les tâches, et notamment sur l'ajout d'unités à la liste des unités reconnues par Report Builder, qui peut être considéré comme une tâche administrative.

•	Pour plus d'informations sur Oracle Terminal et les différents types de ressources qu'il permet d'éditer, reportez-vous à Oracle Terminal User's Guide.

•	Oracle Terminal remplace l'utilitaire TERMDEF de SQL*ReportWriter V1.1 .


Associations de touches

Les associations de touches "associent" certaines touches à certaines fonctions. Vous pouvez les modifier mais c'est à Report Builder qu'il appartient de définir les fonctions auxquelles vous pouvez associer des touches.

Pour modifier des associations de touches :

1	Utilisez la commande de copie de votre système d'exploitation pour copier le fichier de ressources contenant les associations de touches que vous voulez modifier, et enregistrez le fichier sous un nom unique. (Généralement, vous n'avez pas le droit d'écrire dans les fichiers utilisés par Report Builder ; cette opération vous fournit un fichier à éditer.)

2	A l'invite du système d'exploitation, tapez la commande ot et appuyez sur Retour.

3	Dans la boîte de dialogue de sélection de fichiers, sélectionnez le fichier de ressources à modifier. Dans la fenêtre principale de l'Editeur de ressources qui s'affiche, choisissez le produit (par exemple, Report Builder), l'unité ou le terminal dont vous voulez modifier les ressources (par exemple VT100, Sun4, etc.), puis un type d'action.

4	Lorsque le curseur est dans le champ Produit, appuyez sur [Liste]. A partir de la liste de valeurs, sélectionnez Report Builder.

5	Appuyez sur [Champ suivant] jusqu'à ce que le curseur se trouve sur le champ en regard de Unité. Appuyez sur [Liste]. A partir de la liste de valeurs affichant le nom de tous les terminaux et des fichiers de ressources de terminal disponibles, sélectionnez le type de terminal.

6	Appuyez sur [Appeler menu] pour accéder au menu principal, puis sélectionnez Fonction [image] Editer touches. Dans l'Editeur d'association de touches ot, vous pouvez modifier l'association de touches de votre choix pour votre application.

7	Sélectionnez un composant en appuyant sur [Champ suivant] jusqu'à ce que vous arriviez à la liste des composants, puis appuyez sur [Sélectionner] lorsque le curseur se trouve sur le composant à modifier.

Si un composant comporte des sous-composants, le fait d'appuyer sur [Sélectionner] ne sélectionne pas le composant, mais affiche, dans la liste des composants, le niveau inférieur suivant, dans la hiérarchie des composants.

Dans ce cas, un composant représente une partie de Report Builder - soit un emplacement, comme la grille des paramètres d'exécution ou l'Aperçu interactif, soit une catégorie d'action, comme Navigation - pour laquelle un groupe d'associations de touches est valide. Les associations globales sont valides à partir de n'importe où dans le moteur d'exécution. Les associations courantes sont valides non seulement dans Report Builder, mais aussi dans d'autres outils Oracle.

Notez que lorsque vous sélectionnez un composant, le bouton Editer associations de touches est mis en évidence.

8	Appuyez sur [Champ suivant] jusqu'à ce que le curseur se trouve sur Editer associations de touches, puis appuyez sur [Accepter].

9	L'Editeur d'association de touches affiche la table de définition des associations de touches, qui indique toutes les actions faisant partie des composants sélectionnés, ainsi que les touches auxquelles les actions sont liées.

10	10 Appuyez une fois sur [Champ suivant] pour faire passer le curseur dans la liste des associations, puis appuyez sur [Elément suivant] jusqu'à ce que vous parveniez à l'association à modifier. Remplacez le nom de la touche à laquelle l'action est liée par le nom de la touche que vous voulez utiliser.

11	Lorsque vous avez terminé vos modifications, sélectionnez OK.

12	Dans la fenêtre principale, vous pouvez appliquer ou annuler vos modifications, selon le cas. Pour les annuler, appuyez sur [Appeler menu], puis sélectionnez Fichier [image] Fermer, ou Fichier [image] Quitter, sans enregistrer votre fichier. Pour enregistrer vos modifications, passez à l'étape suivante.

13	Appuyez sur [Appeler menu], puis sélectionnez Fichier [image] Enregistrer.

A ce stade, vous n'avez pas enregistré la version modifiée de votre fichier de ressources, mais vous avez enregistré les modifications à apporter au fichier source. Pour incorporer les nouvelles associations de touches dans votre fichier de ressources, vous devez le régénérer.

14	Appuyez sur [Appeler menu], puis choisissez Fonction [image] Générer.

Le nouveau fichier de ressources que vous créez ainsi comprend les modifications que vous avez apportées aux associations de touches.

Un message d'alerte indique que votre fichier de ressources a été généré. Validez ce message.

Si vous recevez non pas un message d'alerte, mais un message d'erreur, reportez-vous à Oracle Terminal User's Guide.

15	Appuyez sur [Appeler menu], puis sélectionnez Fichier [image] Enregistrer.

Cette étape enregistre le fichier de ressources, que vous pouvez alors utiliser pour déterminer les associations de touches utilisées par votre terminal pour Report Builder.

16	Pour quitter l'Editeur de ressources ot, appuyez sur [Appeler menu], puis choisissez Fichier [image] Quitter.

17	Pour tester vos nouvelles associations de touches, appelez le moteur d'exécution de Report Builder en mode caractère et affichez l'écran Afficher touches.

18	Entrez dans la ligne de commande : rwrun60 term=resfile, sans oublier toutes les informations nécessaires relatives au chemin d'accès.

Dans la commande ci-dessus, l'argument term=resfile a un double but : indiquer à Report Builder le fichier de ressources de terminal à utiliser, et identifier votre terminal à l'intention de Report Builder. Pour pouvoir utiliser les nouvelles associations de touches que vous venez de créer, il faut que la partie resfile de l'argument fasse référence au fichier de ressources que vous venez de générer.

19	Affichez l'écran Afficher touches et assurez-vous que les touches reflètent les modifications apportées aux associations de touches.


Fichiers de définition de terminal

  Restrictions

Les fichiers de définition de terminal contiennent des informations sur les fonctionnalités des différents types de terminal. Ils ne s'appliquent qu'aux terminaux en mode caractère et en mode bloc, et à tous les terminaux émulant ces unités. Report Builder est livré avec plusieurs fichiers de définition des terminaux standard comme ceux de la famille DEC, VT100, VT200 et VT320. Si nécessaire, vous pouvez modifier ces fichiers pour disposer d'une définition pour un terminal non standard.

A la différence des associations de touches, les définitions de terminal décrivent les fonctionnalités intrinsèques d'un terminal. Les explications ci-dessous indiquent donc où et comment modifier une définition de terminal, mais n'exécutent pas ces opérations. Nous vous conseillons de ne modifier une définition de terminal que si vous créez une nouvelle définition pour un terminal non standard et disposez de toutes les spécifications nécessaires. (Reportez-vous à la documentation de votre terminal.)

Pour modifier les associations de touches :

1	A l'invite du système d'exploitation, tapez la commande ot et appuyez sur Retour.

2	Dans la boîte de dialogue de sélection de fichiers qui s'affiche, sélectionnez le fichier de ressources à modifier. Dans la fenêtre principale de l'Editeur de ressources qui s'affiche, choisissez le produit (par exemple, Report Builder), l'unité ou le terminal dont vous voulez modifier les ressources (par exemple VT100, Sun4, etc.), puis un type d'action.

3	Lorsque le curseur est dans le champ Produit, appuyez sur [Liste]. La liste des valeurs qui s'affiche énumère les produits dont vous pouvez modifier les ressources en utilisant ot. Sélectionnez Report Builder

4	Appuyez sur [Appeler menu] et choisissez Fonction [image] Editer unités....  L'Editeur de classe d'unités affiche toutes les unités figurant dans le produit indiqué (dans ce cas, Report Builder), ainsi que les classes d'ancêtres de ces unités (pour un terminal VT220, cette classe peur être "mode caractère"). Utilisez cet éditeur pour sélectionner l'unité dont vous voulez modifier la définition de terminal. Si vous devez ajouter une définition pour un terminal non standard, il est généralement plus facile de sélectionner un terminal similaire et de modifier sa définition de terminal, puis d'enregistrer les modifications sous un nouveau nom.

5	Appuyez sur [Champ suivant] jusqu'à ce que le curseur se trouve dans la liste des unités ("Cette classe"). Si la désignation de votre terminal n'y figure pas, il est possible que votre terminal soit à un niveau inférieur dans la hiérarchie des unités.

Dans la représentation graphique de la hiérarchie des unités, affichée à droite de la liste des classes, recherchez l'ancêtre de votre terminal. Lorsque vous l'avez trouvé, placez le curseur sur cette unité dans la liste des classes et appuyez sur [Accepter]. Suivez les niveaux de classe en ordre descendant jusqu'à ce la désignation de votre terminal apparaisse dans la liste. Faites passer le curseur sur le nom du terminal et appuyez sur [Sélectionner].

6	Editer unité est en évidence.  Appuyez sur [Champ suivant] jusqu'à ce que le curseur se trouve sur le bouton Editer unité, puis appuyez sur [Accepter]. L'écran de définition d'affichage d'unité qui apparaît comporte une liste des caractéristiques des unités à laquelle Report Builder fait référence lorsque qu'il communique avec votre terminal. Pour changer l'une de ces valeurs, appuyez sur [Champ suivant] jusqu'à ce que le curseur se trouve sur le champ approprié, puis entrez la valeur de votre choix.

Les boutons Attributs, Modificateurs, Touches standard et Touches utilisateur permettent de passer à d'autres boîtes de dialogue pour modifier d'autres aspects de la définition de terminal. Pour plus d'informations sur ces boîtes de dialogue, reportez-vous à Oracle Terminal User's Guide.

A moins que vous ayez l'intention de créer un nouveau fichier de définition pour un terminal non standard, ne modifiez aucune de ces valeurs. Elles sont fonction de l'unité utilisée et ne sont pas définissables par l'utilisateur.

Si vous créez un nouveau fichier de définition pour un terminal non standard, reportez-vous à la documentation de votre terminal pour connaître les valeurs à utiliser.

7	Lorsque vous avez fini de modifier le fichier, appuyez sur [Appeler menu] et sélectionnez Fenêtres, puis sélectionnez la fenêtre principale qui est identifiée par le nom du fichier de ressources que vous éditez.

8	Appuyez sur [Appeler menu], puis choisissez Fonction [image] Générer.

Le nouveau fichier de ressources que vous créez ainsi comprend les modifications que vous avez apportées aux associations de touches.

Un message d'alerte indique que votre fichier de ressources a été généré. Validez ce message.

Si vous recevez non pas un message d'alerte, mais un message d'erreur, reportez-vous à Oracle Terminal User's Guide.

9	Appuyez sur [Appeler Menu], puis choisissez Fichier [image] Enregistrer sous.

10	Pour quitter l'Editeur de ressources ot, appuyez sur [Appeler menu], puis choisissez Fichier [image] Quitter.


Définition de terminal - Restrictions

•	Certains systèmes d'exploitation requièrent des guillemets simples au lieu de guillemets doubles pour les chaînes. De plus, votre fichier de ressources de terminal peut faire la distinction entre les majuscules et les minuscules.


Références aux fichiers de ressources de terminal

Pour utiliser un fichier de ressources de terminal autre que le fichier par défaut, utilisez le paramètre système TERM.


Alias

Vous pouvez utiliser des alias dans votre instruction d'interrogation SELECT, comme vous le feriez dans n'importe quelle autre instruction SELECT. Pour plus d'informations sur les alias, reportez-vous à Oracle8 Server SQL Language Reference Manual. Si vous utilisez un alias pour une colonne, cet alias devient le nom de la colonne dans Report Builder.

Lorsque vous utilisez un alias avec un paramètre, vous ne devez pas oublier de modifier la colonne associée à l'alias. Vous avez, par exemple, créé pour votre interrogation l'instruction SELECT suivante :

SELECT &NAME NAME, &PAY PAY FROM EMP

Lors de la création de l'état, &NAME est le nom d'une colonne de type CHAR et &PAY est le nom d'une colonne de type NUMBER. Si, lors de l'exécution, vous entrez pour le paramètre &NAME un nom de colonne qui n'est pas de type CHAR, vous recevez un message d'erreur. Comme le nom de l'alias n'a pas changé, Report Builder considère que la colonne a le même type de données que lorsque vous avez créé l'état (c'est-à-dire de type CHAR).


Commentaires

Vous pouvez insérer des commentaires directement dans votre instruction SELECT en utilisant les délimiteurs de commentaires SQL standard d'ORACLE (par exemple, /*Commentaires*/). Reportez-vous à Oracle8 Server SQL Language Reference Manual.

Remarque : Vous pouvez également utiliser le bouton Commentaires de la fenêtre de propriétés Interrogation pour entrer des commentaires.


Référence à des colonnes et à des paramètres - Restrictions

•	Lorsque vous utilisez des références de liens et des références lexicales dans une interrogation, vous devez indiquer respectivement une Valeur initiale ou une Valeur si Null pour le paramètre ou la colonne, si l'interrogation ne s'analyse pas correctement sans la valeur. Par exemple, une interrogation doit avoir une clause FROM. Si vous créez une interrogation qui utilise une référence lexicale pour la clause FROM, le paramètre correspondant à cette référence lexicale doit avoir une Valeur initiale (par exemple, EMP) pour que l'instruction SELECT soit valide.

•	Les paramètres ayant pour type de données CHAR ne sont pas remplis, à moins que vous ne le demandiez explicitement dans une instruction SQL.

•	Si une colonne Report Builder est un récapitulatif pour lequel vous avez indiqué que la propriété Remise à est définie à Page, elle ne peut pas être référencée (par une référence de liens ou une référence lexicale) dans une interrogation. Par exemple, si SAL_MOY est une colonne récapitulative qui calcule le salaire moyen pour chaque page de votre état, la référence de liens n'est pas valide:

SELECT SAL FROM EMP
WHERE SAL > :SAL_MOY

•	Une interrogation ne peut contenir que des références à des colonnes de type base de données, appartenant à un groupe au-dessus de l'interrogation (c'est-à-dire à un groupe qui est un père ou un ancêtre de l'interrogation). Soit, par exemple, le groupe G_1 qui contient une colonne de base de données appelée SAL et appartient à l'interrogation I_1. De plus, le groupe G_1 est propriétaire d'une interrogation appelée I_2. Vous pouvez faire référence à SAL dans I_2 mais non dans I_1.

•	Une interrogation ne peut contenir que des références à une colonne de formule ou à une colonne récapitulative dont la colonne source se trouve en dessous de l'interrogation. Supposons, par exemple, que vous créez une colonne récapitulative appelée SAL_TOT dans le groupe G_1. SAL_TOT récapitule la colonne appelée SAL qui se trouve également dans le groupe G_1. G_1 appartient à l'interrogation Y_1 et est propriétaire d'une interrogation appelée Y_2. L'interrogation I_1 peut donc contenir une référence à SAL_TOT, mais l'interrogation I_2 ne peut pas contenir ce type de référence.

•	Si vous faites référence à un paramètre de type DATE utilisé dans une expression, vous devez faire appel à une fonction TO_DATE.


Références de lien

  Restrictions 	  Exemples	  Rubriques connexes

Les références (ou les variables) de lien sont utilisées pour remplacer une seule valeur dans SQL ou PL/SQL (par exemple, une chaîne de caractères, un nombre ou une date). Plus précisément, les références de lien peuvent être utilisées pour remplacer des expressions dans les clauses d'interrogation SELECT, WHERE, GROUP BY, ORDER BY, HAVING, CONNECT BY et START WITH. Les références de lien ne peuvent pas être mentionnées dans des clauses FROM ou à la place de clauses ou de mots réservés.

Pour créer une référence de lien, entrez deux-points (:), suivis immédiatement du nom de la colonne ou du paramètre. Si vous ne créez pas de colonne ou de paramètre avant d'indiquer une référence de lien à cette colonne ou ce paramètre dans une instruction SELECT, Report Builder crée automatiquement un paramètre.


Références de lien - Restrictions

•	Les références de lien ne doivent pas avoir le même nom qu'un mot-clé réservé SQL. Pour plus d'informations, reportez-vous à Oracle8 Server SQL Language Reference Manual.


Références de lien - Exemples

  Rubriques connexes 	  Tous les exemples

Clause SELECT

SELECT CUSTID, NVL(COMMPLAN, :DFLTCOMM) COMMPLAN  FROM ORD

La valeur de DFLTCOMM remplace les valeurs Null de COMMPLAN dans les lignes sélectionnées.

Clause WHERE

SELECT ORDID, TOTAL  FROM ORD WHERE CUSTID = :CUST

La valeur de CUST permet de sélectionner un seul client.

Clause GROUP BY

SELECT NVL(COMMPLAN, :DFLTCOMM) COMMPLAN, SUM(TOTAL) TOTAL FROM ORD GROUP BY NVL(COMMPLAN, :DFLTCOMM)

Toutes les expressions non cumulées de type NVL(COMMPLAN, :DFLTCOMM) de la clause SELECT doivent être dupliquées dans la clause GROUP BY.

Clause HAVING

SELECT CUSTID, SUM(TOTAL) TOTAL FROM ORD GROUP BY CUSTID  HAVING SUM(TOTAL) > :MINTOTAL

La valeur de MINTOTAL permet de sélectionner les clients auxquels correspond un nombre minimum de commandes.

Clause ORDER BY

SELECT ORDID, SHIPDATE, ORDERDATE, TOTAL  FROM ORD ORDER BY DECODE(:SORT, 1, SHIPDATE, 2, ORDERDATE)

La valeur de SORT permet de sélectionner soit SHIPDATE soit ORDERDATE comme critère de tri. Notez que cette clause est différente de la clause ORDER BY 1, car :SORT est utilisée comme valeur et non pour identifier la position d'une expression dans la liste SELECT. Notez également que, dans cet exemple, DECODE est obligatoire : vous ne pouvez pas utiliser une variable de lien dans une clause ORDER BY sans indiquer également DECODE.

Clauses CONNECT BY et START WITH

Dans les clauses CONNECT BY et START WITH, les références sont utilisées comme dans les clauses WHERE et HAVING.

PL/SQL

procedure double is  begin; :my_param := :my_param*2; end;

La valeur de myparam est multipliée par 2 et attribuée à monparam.


Références lexicales

  Restrictions 	  Exemples

Les références lexicales sont des repères pour texte que vous incorporez dans une instruction SELECT. Vous pouvez les utiliser pour remplacer les clauses apparaissant après SELECT, FROM, WHERE, GROUP BY, ORDER BY, HAVING, CONNECT BY et START WITH.

Vous ne pouvez pas effectuer de références lexicales dans une instruction PL/SQL, mais vous pouvez utiliser une référence de lien pour définir la valeur d'un paramètre référencé lexicalement dans SQL. Reportez-vous à l'exemple ci-dessous.

Pour créer une référence lexicale, entrez une perluète (&), suivie immédiatement du nom de la colonne ou du paramètre. Comme aucune définition par défaut n'est fournie pour les références lexicales, vous devez :

•	Avant de créer votre interrogation, définir une colonne ou un paramètre dans le modèle de données pour chaque référence lexicale de l'interrogation. Pour les colonnes, vous devez entrer Valeur si Null et, pour les paramètres, une Valeur initiale. Report Builder utilise ces valeurs pour valider une interrogation comportant une référence lexicale.

•	Créer votre interrogation contenant des références lexicales.


Références lexicales - Restrictions

•	Vous ne pouvez pas faire de références lexicale dans une instruction PL/SQL.

•	En cas d'utilisation d'une colonne ou d'un paramètre comme référence lexicale dans une interrogation, le type des données doit être Character.

•	Si vous voulez utiliser des références lexicales dans votre clause SELECT, vous devez créer une référence lexicale distincte pour chaque colonne que vous remplacerez et, en outre, attribuer un alias à chaque référence lexicale, ce qui vous permet d'utiliser le même champ de présentation et le même libellé de texte standard pour les valeurs que vous entrez pour la valeur lexicale dans la Grille des paramètres d'exécution.

•	Si vous utilisez des références lexicales dans votre clause SELECT, vous devez indiquer le même nombre d'éléments lors de l'exécution que dans le modèle de données de l'état. Chaque valeur que vous indiquez pour vos références lexicales, lors de l'exécution, doit avoir le même type de données que sa Valeur initiale.

•	Si vous utilisez des références lexicales dans votre clause SELECT, la largeur de la colonne est dérivée de la valeur unitiale du paramètre. Vous devez donc vous assurer que la valeur initiale du paramètre correspond à la colonne la plus large que vous souhaitez utiliser.

•	Un lien Report Builder ne doit pas dépendre d'une référence lexicale, c'est-à-dire que ni la colonne fils d'un lien ni son nom de table ne doivent être déterminés par une référence lexicale. Pour obtenir cette fonctionnalité, vous devez créer un lien sans indiquer de colonnes, puis entrer la clause SQL (par exemple, WHERE) du lien directement dans l'interrogation. Par exemple, vos interrogations père et fils peuvent s'écrire de la manière suivante :

Interrogation père:  SELECT DEPTNO FROM EMP
Interrogation fils:  SELECT &PARM_1 COL_1,
                     &PARM2 COL_2 FROM EMP
                     WHERE &PARM_1 = :DEPTNO

•	Notez la façon dont la clause WHERE établit une référence de lien à la colonne DEPTNO, sélectionnée dans l'interrogation père. Cette exemple présuppose en outre que vous avez créé un lien entre les interrogations de l'Editeur de modèle de données sans indiquer de colonnes.

•	Une référence lexicale ne peut pas être utilisée pour créer des variables de liens supplémentaires après l'activation du déclencheur After Form. Soit, par exemple, une interrogation de type (notez que la clause WHERE est remplacée par une référence lexicale):

SELECTIONNEZ ENAME, SAL FROM EMP
&where_clause

Si la valeur du paramètre WHERE_CLAUSE contient une référence à une variable de lien, vous devez indiquer la valeur dans le déclencheur Before Report ou After Report. Si vous avez fourni la valeur ci-dessous pour le paramètre dans le déclencheur Before Report, un message d'erreur s'affiche:

WHERE SAL = :new_bind

Si vous fournissez cette même valeur dans le déclencheur After Form, l'état sera exécuté.


Références lexicales - Exemples

  Rubriques connexes 	  Tous les exemples

Clause SELECT

SELECT &P_ENAME NAME, &P_EMPNO ENO, &P_JOB ROLE  FROM EMP

Les références P_ENAME, P_EMPNO et P_JOB peuvent être utilisées pour modifier les colonnes sélectionnées lors de l'exécution. Par exemple vous pouvez entrer DEPTNO comme valeur de P_EMPNO dans la Grille de paramètres d'exécution. Notez que, dans ce cas, vous devez utiliser des alias pour vos colonnes. Sinon, si vous changez les colonnes sélectionnées lors de l'exécution, les noms de colonnes de la liste SELECT ne correspondront pas aux colonnes de Report Builder et l'état ne sera pas exécuté.

Clause FROM

SELECT ORDID, TOTAL FROM &ATABLE

ATABLE permet de changer la table dans laquelle les colonnes sont sélectionnées lors de l'exécution. Par exemple, vous pouvez entrer ORD pour ATABLE lors de l'exécution. Si vous changez dynamiquement le nom de la table en procédant de la sorte, vous pouvez également utiliser des références lexicales pour la clause SELECT (voir exemple précédent), si les noms de colonnes diffèrent d'une table à l'autre.

Clause WHERE

SELECT ORDID, TOTAL FROM ORD WHERE &CUST

CUST permet de limiter les enregistrements extraits de ORD. Toute forme de clause WHERE peut être indiquée lors de l'exécution.

Clause GROUP BY

SELECT NVL(COMMPLAN, DFLTCOMM) CPLAN, SUM(TOTAL) TOTAL  FROM ORD GROUP BY &NEWCOMM

La valeur de NEWCOMM peut être utilisée pour définir la clause GROUP BY

Clause HAVING

SELECT CUSTID, SUM(TOTAL) TOTAL  FROM ORD GROUP BY CUSTID  HAVING &MINTOTAL

La valeur de MINTOTAL peut, par exemple, être utilisée pour sélectionner les clients auxquels correspond un nombre minimum de commandes.

Clause ORDER BY

SELECT ORDID, SHIPDATE, ORDERDATE, TOTAL  FROM ORD ORDER BY &SORT

La valeur de SORT peut être utilisée pour sélectionner SHIPDATE, ORDERDATE, ORDID ou toute combinaison de ces éléments comme critères de tri. Elle peut également être utilisée pour ajouter des clauses à l'interrogation (clauses CONNECT BY et START WITH).

Clauses CONNECT BY et START WITH

Les paramètres des clauses CONNECT BY et START WITH sont utilisés comme dans les clauses WHERE et HAVING.

Clauses multiples

SELECT &COLSTABLE

COLSTABLE permet de modifier la clause SELECT et la clause FROM lors de l'exécution. Par exemple, vous pouvez entrer DNAME ENAME, LOC SAL FROM DEPT pour COLSTABLE lors de l'exécution.

SELECT * FROM EMP &WHEREORD

WHEREORD permet de modifier la clause WHERE et la clause ORDER BY lors de l'exécution. Par exemple, vous pouvez entrer WHERE SAL > 1000 ORDER BY DEPTNO pour &WHEREORD lors de l'exécution.

PL/SQL et SQL

SELECT &BREAK_COL C1, MAX(SAL)  FROM EMP  GROUP BY &BREAK_COL

BREAK_COL permet de modifier  la liste SELECT et la clause GROUP BY lors de l'exécution. La Valeur initiale du paramètre &BREAK_COL est JOB. Lors de l'exécution, l'utilisateur de l'état peut fournir une valeur pour un paramètre appelé GROUP_BY_COLUMN (de type Character). Dans le déclencheur de validation de GROUP_BY_COLUMN, vous appelez la procédure SQL suivante et lui transmettez la valeur de GROUP_BY_COLUMN :

procedure conv_param (in_var IN char) is
begin
 if upper(in_var) in ('NODEPT','NOEMP','EMBAUCHE') then
   :break_col := 'to_char('||in_var||')' ;
 else
   :break_col := in_var;
 end if;
end;

Ce PL/SQL garantit que, si nécessaire, un TO_CHAR est placé de part et d'autre de la colonne de ventilation choisie par l'utilisateur. Notez comment, dans SQL, vous indiquez une référence lexicale à BREAK_COL. Dans PL/SQL, vous devez indiquer une référence de lien à BREAK_COL car les références lexicales ne sont pas autorisées.


DML et DDL

Pour utiliser DML ou DDL dans votre PL/SQL, vous devez faire appel à la fonction en package SRW.DO_SQL. Notez que cette fonction ne doit être utilisée que pour DMS et DDL, et non pour extraire des données. Pour plus d'informations sur DML et DDL, reportez-vous à Oracle8 Server SQL Language Reference Manual.

Etant donné le modèle de traitement de Report Builder, il est conseillé d'utiliser uniquement DDL dans les déclencheurs Before Report et After Report.

DML peut être entré à tout endroit qui accepte PL/SQL.

Remarque : L'utilisation de SRW.DO_SQL rallonge la durée de l'exécution de l'état.


Fichiers pris en charge

Fichier	Contenu	Portable?	Utilisé ...	Créé ...
.afc	Son AIFC (fichier binaire)	-	Associé à un bouton	Non créé par Report Builder
.aff	Son AIFF (fichier binaire)	-	Associé à un bouton	Non créé par Report Builder
.au	Son AU (fichier binaire)	-	Associé à un bouton	Non créé par Report Builder
.avi	Vidéo Windows (fichier binaire)	-	Dans l'Aperçu interactif	Non créé par Report Builder
.cal	Image CALS (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.bmp	Image BMP (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.cgm	Dessin CGM (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.gif	Image GIFF (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.jfi	Image JFIF (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.moo	Vidéo Quicktime (fichier binaire)	-	Associé à un bouton	Non créé par Report Builder
.odf	Dessin Oracle (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.oif	Image Oracle (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.pal	Palette de couleurs (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.pcx	Image PCX (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.pic	Image PICT (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.pld	Biliothèque PL/SQL (fichier texte)	Oui	Fichier [image] Adminis- tration [image] Convertir	Fichier [image] Enregistrer Fichier [image] Enregistrer sous
.pll	Bibliothèque PL/SQL (fichier binaire avec code P/Source)	Oui	Bibliothèques attachées dans le Navigateur d'objet	Fichier [image] Enregistrer Fichier [image] Enregistrer sous
.prt	Définition d'imprimante en mode caractère (fichier texte)	Oui	DESFORMAT	Non créé par Report Builder
.ras	Image trame Sun (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.rdf	Définition d'état (fichier binaire avec code P-/source)	Oui	Fichier [image] Ouvrir fichier [image] Exécuter fichier [image] Adminis-tration Convertir	Fichier [image] Enregistrer Fichier [image] Enregistrer sous Fichier Administration Convertir
.rep	Définition d'état (fichier binaire avec code P-/source)	Oui, s'il n'a pas de PL/SQL compilé	Pour exécuter un état	Fichier Administration Convertir
.rex	Une ou plusieurs définitions d'état (fichier texte)	Oui	Fichier [image] Adminis- tration [image] Convertir	Fichier Administration Convertir
.sql	Définition d'interrogation (fichier texte)	Oui	Pour créer une interrogation	Fichier [image] Enregistrer Fichier [image] Enregistrer sous
.snd	Son SND (fichier binaire)	-	Associé à un bouton	Non créé par Report Builder
.tif	Image TIFF (fichier binaire)	-	Dans l'Editeur d'état (Aperçu interactif, Présentation ou Grille de paramètres)	Fichier [image] Exporter
.wav	Son WAVE (fichier binaire)	-	Associé à un bouton	Non créé par Report Builder
Notes d'utilisation

•	Les scripts SQL livrés avec Report Builder sont également des fichiers ayant le suffixe .sql.

•	Oracle ne prend pas en charge les documents modifiés par l'édition de fichiers .rex ou .pld.

•	Les fichiers de définition d'imprimante ne sont utilisés que par les états exécutés dans un environnement en mode caractère ou les états exécutés avec le pilote ASCII Report Builder. Pour les états qui s'exécutent sur des plates-formes bitmap, les codes d'imprimante et les définitions d'imprimante ne sont pas pris en compte, car leur fonction est remplacée par les paramètres du menu Format (par exemple, police et graisse).

•	Tout objet exporté de Report Builder  vers CGM peut être décomposé en plusieurs objets dans CGM. Par exemple, si vous exportez un rectangle comportant un motif de remplissage, cet objet devient deux objets dans CGM : l'un créé pour le rectangle lui-même, l'autre pour le motif de remplissage.

•	Report Builder peut afficher des objets OLE2. Pour les objets OLE2 stockés dans la base de données, définissez la propriété Format à OLE2. Pour les objets OLE2 stockés dans des fichiers, sélectionnez Lecture depuis fichier et définissez Format à OLE2 dans la palette de propriétés de la colonne (ce qui suppose que la colonne de la base de données contient les noms des objets OLE2).

•	En fonction des options que vous indiquez, Report Builder peut générer l'un des fichiers suivants :

•	fichier journal Profiler

•	fichier journal d'erreurs

•	fichier journal de trace

•	fichier de préférences

•	fichier de séquences de touches (mode caractère uniquement)

•	fichier journal d'impression d'écran (mode caractère uniquement)


Fichier de préférences

Les préférences que vous définissez par Outils [image] Options d'outils sont enregistrées dans un fichier de préférences et extraites de ce fichier. (Ce fichier contient également des préférences pour tous les autres outils Oracle.)

Si vous n'avez pas votre propre fichier de préférences, Report Builder extrait les préférences d'un fichier de préférences global créé pendant l'installation. Lorsque vous éditez les préférences et que vous les enregistrez, Report Builder crée votre propre fichier local de préférences. Lorsque vous avez votre propre fichier de préférences, Report Builder l'utilise à la place du fichier global de préférences.

Les noms et les emplacements exacts de ces fichiers peuvent dépendre du système d'exploitation utilisé. Le contenu du fichier de préférences est portable mais, si vous le transférez à un autre système d'exploitation, vérifiez que vous le stockez à l'endroit approprié et sous le nom approprié pour cette plate-forme.


Fichier de correspondance de polices

Report Builder prend en charge les alias de police. Les correspondances de police utilisées par Report Builder sont définie dans le fichier uifont.ali . Pour modifier ces correspondances, vous devez éditer ce fichier. L'emplacement du fichier est fonction de votre système d'exploitation. Pour plus d'informations sur les fichiers que vous utilisez pour installer Report Builder, reportez-vous à vos instructions d'installation.


Fichiers temporaires

Pendant l'exécution des états, Report Builder crée des fichiers temporaires :

•	Les copies sur disque sont créées lorsque vous exécutez un état qui demande plusieurs passes pour être mis en forme (c'est-à-dire un état qui a des références avant, par exemple un champ ayant pour Source &Total pages logiques). La copie sur disque contient une copie de première passe de chaque page de l'état que Report Builder utilise pour déterminer la longueur de l'état et résoudre les éventuelles références avant. Lorsque toutes les pages ont été formatées, cette copie a approximativement deux fois la taille de la sortie finale. Lorsque vous développez un état, vous avez intérêt à exclure les champs de référence avant pour diminuer les temps de test.

Les copies sur disque ont pour nom un identificateur unique.

•	Les fichiers de cache de données sont utilisés pour entrer, dans une mémoire cache, tous les enregistrements de données extraits de la base de données, ainsi que les valeurs de tous les récapitulatifs de l'état. La taille de ce fichier reflète le volume de données des données de l'état. Les enregistrements sont condensés de façon que l'espace attribué à chaque colonne soit juste suffisant pour contenir la valeur en cours, et non la taille maximum de chaque colonne.

Les fichiers de cache de données sont appelés datXXXX, où XXXX est unique.

•	Les fichiers d'index sont utilisés pour garder la trace des ruptures de l'état. Ils contiennent des structures arborescentes mises au point pour parcourir les données en fonction des relations définies dans le modèle de données de l'état. La taille de ce fichier dépend :

•	du nombre de groupes de l'état

•	du nombre d'enregistrements de chaque groupe

•	de la taille de la ou des colonne(s) de ventilation de chaque groupe

•	de l'imbrication de l'arbre des groupes

Les fichiers index sont appelés idxXXXXX, où XXXX est unique.

Taille des fichiers temporaires

Les fichiers temporaires peuvent, pour un certain nombre de raisons, devenir très volumineux. Pour réduire ce risque, essayez les solutions suivantes :

•	Exécutez les calculs dans des interrogations, ce qui peut diminuer la taille du fichier de cache de données, car l'état n'a pas besoin d'extraire autant de données que si les calculs étaient exécutés dans des colonnes de formule ou des colonnes récapitulatives.

•	Diminuez la taille et le nombre des colonnes de ventilation par groupe de ventilation, ce qui peut réduire la taille du fichier d'index, du fait de la diminution de la taille de la structure arborescente du fichier.

•	Eliminez les références avant (c'est-à-dire les champs dont la propriété Source est définie à &Total pages logiques), ce qui peut éliminer la copie sur disque, car Report Builder n'a pas à enregistrer une copie de la sortie de l'état dans la copie sur disque avant la mise en forme.


Méthode de recherche de fichiers

Lorsque vous faites références à un fichier, dans Report Builder, la recherche du fichier se fait dans l'ordre suivant :

1	Le chemin d'accès qui précède le nom du fichier (par exemple /home/jsmith), le cas échéant.

2	Le chemin d'accès que votre système d'exploitation considère comme le chemin en cours.

3	Le chemin d'accès indiqué dans la variable d'environnement REPORT60_PATH.

4	Le chemin d'accès indiqué dans la variable d'environnement ORACLE_PATH.

5	L'endroit où vous vous trouviez lorsque vous avez appelé Report Builder.

Notes d'utilisation

•	Si vous n'indiquez pas de suffixe, Report Builder en ajoute un avant de lancer la recherche. Si le fichier est introuvable, Report Builder le recherche alors sans son suffixe.

•	L'ordre de recherche utilisé n'est pas le même lorsque la recherche porte sur des définitions d'imprimante et de terminal et des icônes.


Méthode de recherche de fichiers de définition d'imprimante et de terminal

Méthode de recherche de fichiers de définition d'imprimante

1	Le chemin d'accès que votre système d'exploitation considère comme le chemin en cours.

2	Le chemin d'accès indiqué dans la variable d'environnement REPORT60_PATH.

3	Le chemin d'accès indiqué dans la variable d'environnement ORACLE_PATH.

4	Le dossier ou le sous-répertoire ORACLE_HOME/REPORT60/printers.

Méthode de recherche de fichiers de définition de terminal

1	Le chemin d'accès indiqué dans la variable d'environnement REPORT60_TERMINAL.

2	Le chemin d'accès indiqué dans la variable d'environnement ORACLE_TERMINAL.

3	Le dossier ou le sous-répertoire ORACLE_HOME/REPORT60/admin/terminal.


Méthode de recherche de fichiers d'icône

Si vous créez un bouton dans Report Builder, vous pouvez lui attribuer une icône et non un libellé. Si vous n'indiquez pas le chemin d'accès complet à l'icône, Report Builder le recherche dans le chemin défini par la variable d'environnement UI_ICON.


Tables de base de données

Report Builder utilise trois ensemble de tables :

Tables de démos	Contiennent des exemples de données utilisés par les états de démonstration.
Tables de données	Contiennent vos propres données.
Tables Report Builder	Contiennent les états, les interrogations externes et les bibliothèques externes PL/SQL. Vous devez installer ces tables si vous voulez stocker des états dans la base de données. Pour plus d'informations, reportez-vous à vos instructions d'installation..


Sécurité de la base de données et restrictions

  Rubriques connexes

En matière de restrictions susceptibles d'être imposées aux utilisateurs de Report Builder, vous pouvez :

•	Accorder et révoquer des droits d'accès à Report Builder

•	Autoriser et interdire l'accès à un état stocké dans la base de données

Pour plus d'informations sur l'accord ou la révocation des droits d'accès, reportez-vous à vos instructions d'installation.

Notes d'utilisation

•	Le système de sécurité de Report Builder s'ajoute aux commandes GRANT et REVOKE d'ORACLE, en offrant des mesures de contrôle supplémentaires. Toutes les restrictions imposées par GRANT et REVOKE restent valables.

•	Les fichiers sont protégés par les moyens mis en place pour votre système de fichiers. Report Builder n'assure aucune sécurité supplémentaire des fichiers.

•	Seul le créateur d'un état peut accorder aux autres utilisateurs un droit d'accès à cet état. En outre, seul le créateur d'un état peut le modifier, même s'il a accordé des droits d'accès aux autres utilisateurs.


Création d'une colonne récapitulative (de totaux ou de sous-totaux)
Création d'une colonne récapitulative

  Rubriques connexes

Pour créer une colonne récapitulative (de totaux ou de sous-totaux) à l'aide de l'assistant Données :

1	Dans la vue Modèle de données, cliquez sur l'interrogation contenant la colonne dont vous voulez effectuer le total.

2	Choisissez Outils [image] Assistant Données.

3	Sur la page Totaux, suivez l'assistant pour ajouter la colonne de votre choix à votre état. Remarque

Pour créer une colonne récapitulative (de totaux ou de sous-totaux) à l'aide de la palette d'outils :

1	Dans la vue Modèle de données, cliquez une fois sur [image] dans la palette d'outils, puis :

•	Pour créer une colonne dans un groupe, cliquez dans le groupe à l'endroit où vous voulez placer la colonne dans la hiérarchie.

•	Pour créer une colonne de niveau état, cliquez dans une zone de la région de canevas.

2	Cliquez deux fois sur l'objet de colonne récapitulative pour afficher la Palette de propriétés.

3	Sous le noeud Récapitulatif :

•	Définissez la propriété Fonction en choisissant un type de récapitulatif dans la liste déroulante.

•	Définissez la propriété de source de la colonne dont vous voulez créer le récapitulatif.


Création ou édition d'une colonne de formule

  Rubriques connexes

Pour créer ou éditer une colonne de formule :

1	Dans la vue Modèle de données, cliquez une fois [image] dans la palette d'outils, puis :

•	Pour créer une colonne dans un groupe, cliquez dans le groupe à l'endroit où vous voulez placer la colonne dans la hiérarchie.

•	Pour créer une colonne de niveau état, cliquez dans une zone de la région de canevas.

2	Cliquez deux fois sur l'objet de colonne de formule pour afficher la Palette de propriétés.

3	Sous le noeud Colonne de réserve/Formule, cliquez deux fois dans le champ de valeurs de propriété Formule PL/SQL.

4	Dans l'Editeur PL/SQL, définissez le PL/SQL de la formule (par exemple, SAL * 0,07).


Création ou édition d'une colonne de réserve

  Etape suivante	  Rubriques connexes

Pour créer ou éditer une colonne de réserve :

1	Dans la vue Modèle de données, cliquez une fois [image] dans la palette d'outils.

•	Pour créer une colonne dans un groupe, cliquez dans le groupe à l'endroit où vous voulez placer la colonne dans la hiérarchie.

•	Pour créer une colonne de niveau état, cliquez dans une zone de la région de canevas.

2	Cliquez deux fois sur l'objet de colonne de réserve.

3	Dans la Palette de propriétés, définissez les propriétés de la colonne de réserve.

Vous pouvez définir la valeur d'une colonne de réserve dans :

•	le déclencheur Before Report, si la colonne de réserve est de niveau état

•	une colonne de formule de niveau état, si la colonne de réserve est de niveau état

•	une formule du groupe de la colonne de réserve ou d'un groupe inférieur (si la valeur est définie une fois par enregistrement du groupe)


Création de numéros de page

  Etape suivante	  Rubriques connexes	  Exemples

Pour créer des numéros de page par défaut :

1	Dans la vue Aperçu interactif, cliquez sur [image] dans la barre d'outils. Remarque

2	Choisissez l'emplacement du numéro de page dans la liste déroulante.

3	Cliquez sur le format du numéro de page de votre choix : Numéro de page seul ou Numéro de page et nbre total de pages.

4	(Facultatif) Modifiez les attributs par défaut du texte du numéro de page, si nécessaire.

Pour créer des numéros de page personnalisés :

1	Dans la vue Modèle de présentation, cliquez sur [image] dans la barre d'outils.  Remarque

2	Dans la zone de marge, créez un objet de champ pour chaque valeur de numéro de page de votre choix (par exemple, Numéro de page physique, Total pages physiques).

3	Dans la palette de propriétés du champ, sous le noeud Champ, définissez la propriété Source à la source du numéro de page, et la propriété Visible à Non. Sous le noeud Présentation générale, définissez la propriété Elasticité horizontale à Variable.

4	Créez un objet de texte standard  dans la zone de marge, et faites référence au(x) champ(s) de numéro de page en utilisant &nomchamp.


Redéfinition de numéros de page

Pour revenir aux numéros de page par défaut (créés avec [image] ou Insérer [image] Numéro de page) :

1	Cliquez dans le champ de numéro de page par défaut, puis choisissez Editer [image] Effacer pour le supprimer.

2	Créez des numéros de page personnalisés.

3	Dans la Palette de propriétés du champ de numéro de page, sous le noeud Champ, cliquez deux fois sur le champ de valeur de la propriété Numérotation de page.

4	Dans la boîte de dialogue, cliquez sur une option Remise à. Les numéros de page sont redéfinis à la valeur de début chaque fois que l'encadrement sélectionné est mis en forme. Cliquez sur OK.


Création d'un horodatage (heure et/ou date)

  Rubriques connexes

Pour ajouter un horodatage (date et/ou heure)

1	Dans la vue Aperçu interactif, cliquez sur [image] dans la barre d'outils. Remarque

2	Choisissez l'emplacement de la date ou de l'heure dans la liste déroulante.

3	Cliquez sur le format de date et/ou d'heure de votre choix ou cliquez sur Personnaliser pour définir votre propre format.


Création d'un hyperlien à l'aide de la palette de propriétés
Création d'un hyperlien

  Restrictions	  Exemples	  Rubriques connexes

Pour ajouter un hyperlien à votre état :

1	Créez une destination d'hyperlien, qui correspond à la cible de la liaison Web.

2	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis le noeud contenant l'objet qui sera la source de la liaison Web. Remarque

3	Cliquez deux fois sur l'objet qui sera la source de la liaison Web pour afficher la Palette de propriétés.

4	Sous le noeud Paramètres Web, définissez la propriété Hyperlien sur la destination du lien. Remarque

5	Pour appliquer d'autres attributs HTML à l'hyperlien, définissez la propriété Attributs d'hyperlien supplémentaire de la manière appropriée. Exemples

6	Pour ajouter un hyperlien à une section de graphique, créez un hyperlien graphique.


Création d'un lien de ligne de commande d'application à l'aide de la palette de propriétés
Création d'un lien de ligne de commande d'application

  Restrictions	  Exemples	  Rubriques connexes

Pour associer une commande à un objet de votre état :

1	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis le noeud qui contient l'objet auquel vous voulez associer une commande. Remarque

2	Cliquez deux fois sur l'objet auquel vous voulez associer une commande pour afficher la Palette de propriétés.

3	Sous le noeud Paramètres Web, définissez la propriété Ligne de commande d'application à la commande qui doit s'exécuter lorsque l'utilisateur clique sur l'objet. Remarque


Création d'un signet à l'aide de l'assistant Web ou de la palette de propriétés
Création d'un signet

 Exemples	  Rubriques connexes

Pour créer un signet pour chaque groupe de ventilation de la zone de signet de votre document HTML ou PDF :

1	Choisissez Outils [image] Assistant Web.

2	Sur la page Signets de l'assistant, faites passer les colonnes de votre choix dans la liste Signets.

3	Dans la page Terminé, sélectionnez une sortie et enregistrez-la dans un fichier à afficher dans votre visualiseur Web ou votre visualiseur PDF.

Pour créer un signet pour d'autres objets d'état dans la zone de signet de votre document HTML ou PDF :

1	Dans le Navigateur d'objet, développez  le noeud Modèle de présentation, puis le noeud contenant l'objet auquel vous voulez associer un signet (généralement, l'objet est un encadrement itératif ou un objet qui englobe la section concernée de l'état).  Remarque.

2	Cliquez deux fois sur l'objet auquel vous voulez associer un signet pour afficher la Palette de propriétés.

3	Sous le noeud Paramètres Web, définissez la propriété Signet à la chaîne qui doit apparaître dans la zone de signet de l'état mis en forme.


Création d'une destination hyperlien à l'aide de la palette de propriétés
Création d'une destination hyperlien

  Exemples	  Etape suivante	  Rubriques connexes

Pour ajouter une destination hyperlien à votre état :

1	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis celui contenant l'objet qui sera la destination d'une liaison Web. Remarque

2	Cliquez deux fois sur l'objet qui sera la destination d'une liaison Web pour afficher la Palette de propriétés.

3	Sous le noeud Paramètres Web, définissez la propriété Destination hyperlien à un identificateur de l'objet.


Liaison d'un objet image à un URL

  Exemples 	  Rubriques connexes

Pour lier un objet image à un URL :

1	Dans la vue Aperçu interactif, cliquez sur [image] dans la palette d'outils. Remarque

2	Cliquez et faites glisser un rectangle.

3	Cliquez deux fois sur l'objet du fichier de liaison pour afficher la Palette de propriétés.

4	Sous le noeud Texte standard de fichier de liaison :

•	Définissez la propriété Format de fichier source à URL image.

•	Définissez la propriété Nom de fichier source sur URL à l'endroit où se trouve l'image, en respectant le protocole requis. Exemples


Sélection d'un URL image dans la base de données

  Rubriques connexes

Pour sélectionner un URL dans la base de données :

1	Créez une interrogation, avec une instruction SELECT qui sélectionne une colonne contenant des URL.

2	Dans la vue Modèle de données, cliquez deux fois sur la colonne contenant les URL.

3	Dans la Palette de propriétés, sous le noeud Colonne  :

•	Définissez la propriété Lecture depuis fichier à Oui.

•	Définissez la propriété Format de fichier à URL image.


Création d'un objet texte standard pour références HTML

  Exemples	  Rubriques connexes

Pour créer un objet texte standard pour références HTML :

1	Cliquez sur [image] dans la palette d'outils de la vue Aperçu interactif, de la vue Modèle de présentation ou de la vue Grille de paramètres.

2	Cliquez et faites glisser un rectangle.

3	Dans le nouvel objet standard, entrez ou importez (choisissez Fichier [image] Importer [image] Texte) le fichier HTML souhaité. Remarque

4	Cliquez en dehors de l'objet texte standard.

5	Cliquez deux fois sur l'objet texte standard (ou affichez le menu instantané de l'objet et cliquez sur la Palette de propriétés).

6	Dans la Palette de propriétés, sous le noeud Paramètres Web, définissez la propriété Contient des références HTML sur Oui.


Liaison d'un objet HTML à un fichier

  Rubriques connexes

Pour lier un objet HTML à un fichier :

1	Dans la vue Aperçu interactif ou la vue Modèle de présentation, cliquez sur [image] ou dans la palette d'outils.

2	Cliquez et faites glisser un rectangle.

3	Cliquez deux fois sur l'objet du fichier de liaison pour afficher la Palette de propriétés.

4	Sous le noeud Texte standard de fichier de liaison :

•	Définissez la propriété Format de fichier source à Texte.

•	Définissez la propriété Nom de fichier source au nom du fichier contenant les références HTML.

5	Sous le noeud Paramètres Web, définissez la propriété Contient des références HTML sur Oui.


Sélection de références HTML dans la base de données

  Rubriques connexes

Pour sélectionner des références HTML dans la base de données :

1	Créez une interrogation, avec une instruction SELECT qui sélectionne une colonne contenant des références HTML ou les noms de fichier contenant des références HTML.

2	Dans la vue Modèle de données, cliquez deux fois sur la colonne des références HTML pour afficher la Palette de propriétés.

3	Si la colonne contient les noms de fichier comprenant les références HTML, plutôt que les références HTML elles-mêmes :

•	Sous le noeud Colonne, définissez la propriété Lecture depuis fichier sur Oui

•	Définissez la propriété Format de fichier à Texte.

4	Dans la vue Modèle de présentation, créez un objet champ qui référencie la colonne.

5	Cliquez deux fois sur l'objet champ.

6	Dans la Palette de propriétés, sous le noeud Paramètres Web, définissez la propriété Contient des références HTML sur Oui.


Création d'un en-tête de document HTML

  Exemples	  Rubriques connexes

Pour insérer un fichier HTML dans l'en-tête de votre document HTML :

1	Choisissez Outils [image] Assistant Web.

2	Dans la troisième page de l'assistant, entrez le nom du Fichier HTML d'en-tête ou cliquez sur Parcourir pour le rechercher.

3	Dans la dernière page, sélectionnez Générer sortie HTML maintenant ou Générer sortie feuille de style HTML maintenant (si votre visualiseur prend en charge les extensions de feuille de style HTML) et enregistrez la sortie dans un fichier à afficher dans votre visualiseur Web.

Pour ajouter d'autres éléments à l'en-tête de votre document HTML :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés de l'état) pour afficher la Palette de propriétés.

2	Sous le noeud Echappement d'état, définissez la propriété Type Avant état à Texte (si vous voulez entrer l'en-tête) ou à Fichier (si vous voulez importer l'en-tête d'un fichier).

3	Définissez la propriété Valeur Avant état en cliquant sur le bouton ... pour entrer le code HTML dans la boîte de dialogue ou sélectionner un fichier HTLM à importer.


Création d'un pied de document HTML

  Exemples	  Rubriques connexes

Pour insérer un fichier HTML dans le pied de page de votre document HTML :

1	Choisissez Outils [image] Assistant Web.

2	Dans la troisième page de l'assistant, entrez le nom du Fichier HTML de pied de page ou cliquez sur Parcourir pour le rechercher

3	Dans la dernière page, sélectionnez Générer sortie HTML maintenant ou Générer sortie feuille de style HTML maintenant (si votre visualiseur prend en charge les extensions de feuille de style HTML) et enregistrez la sortie dans un fichier à afficher dans votre visualiseur Web.

Pour ajouter d'autres éléments au pied de page de votre document HTML :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés de l'état) pour afficher la Palette de propriétés.

2	Sous le noeud Echappement d'état, définissez la propriété Type Avant état à Texte (si vous voulez entrer le pied de page) ou à Fichier (si vous voulez importer le pied de page d'un fichier).

3	Définissez la propriété Valeur Après Etat en cliquant sur le bouton ... pour entrer le code HTML dans la boîte de dialogue ou sélectionner un fichier HTLM à importer.


Création d'un en-tête de page HTML

  Exemples%!Alink(ex_befaftpgex1b, , , )	  Rubriques connexes%!Alink(plsqlbefpgesc;aftpgesc;a_hyperhtml;, , , )

Pour ajouter un en-tête à chaque page de votre document HTML :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés de l'état) pour afficher la Palette de propriétés.

2	Sous le noeud Echappement d'état, définissez la propriété Type Avant page à Texte (si vous voulez entrer l'en-tête) ou à Fichier (si vous voulez importer l'en-tête d'un fichier).

3	Définissez la propriété Valeur Avant page en cliquant sur le bouton ... pour entrer le code HTML dans la boîte de dialogue ou sélectionner un fichier HTML à importer.

Pour ajouter un en-tête à une seule page de votre document HTML :

  Cliquez sur le bouton Rubriques connexes et reportez-vous à la procédure de création d'un en-tête de page à l'aide de PL/SQL.


Création d'un pied de page HTML à l'aide de la Palette de propriétés
Création d'un pied de page HTML

  Exemples	  Rubriques connexes

Pour ajouter un pied de page à chaque page de votre document HTML :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés de l'état) pour afficher la Palette de propriétés.

2	Sous le noeud Echappement d'état, définissez la propriété Type Après page à Texte (si vous voulez entrer le pied de page) ou à Fichier (si vous voulez importer le pied de page d'un fichier).

3	Définissez la propriété Valeur Après page en cliquant sur le bouton ... pour entrer le code HTML dans la boîte de dialogue ou sélectionner un fichier HTML à importer.

Pour ajouter un pied de page à une seule page de votre document HTML :

  Cliquez sur le bouton Rubriques connexes et reportez-vous à la procédure de création d'un bas de page à l'aide de PL/SQL.


Création d'un en-tête de Grille de paramètres HTML via la palette de propriétés

  Exemples	  Rubriques connexes

Pour ajouter des éléments dans la partie supérieure de la Grille de paramètres HTML :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés de l'état) pour afficher la Palette de propriétés.

2	Sous le noeud Echappement d'état, définissez la propriété Type Avant formulaire à Texte (si vous voulez entrer l'en-tête) ou Fichier (si vous voulez importer l'en-tête d'un fichier).

3	Définissez la propriété Valeur Avant formulaire en cliquant sur le bouton ... pour entrer le code HTML dans la boîte de dialogue ou sélectionner un fichier HTML à importer.


Création d'un pied de Grille de paramètres HTML via la palette de propriétés

  Exemples	  Rubriques connexes

Pour ajouter des éléments dans la partie inférieure de la Grille de paramètres HTML :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés de l'état) pour afficher la Palette de propriétés.

2	Sous le noeud Echappement d'état, définissez la propriété Type Après formulaire à Texte (si vous voulez entrer le pied) ou Fichier (si vous voulez importer le pied d'un fichier).

3	Définissez la propriété Valeur Après formulaire en cliquant sur le bouton ... pour entrer le code HTML dans la boîte de dialogue ou sélectionner un fichier HTML à importer.


Création d'événements d'entrée ou de sélection de grille de paramètres HTML

  Exemples	  Rubriques connexes

Pour créer un champ de grille de paramètres contenant des événements d'entrée ou de sélection :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] pour afficher l'Editeur de grille de paramètres.

2	Créez ou éditez un champ de grille de paramètres.

3	Dans la palette de propriétés, sous le noeud Paramètres Web, configurez la propriété Attributs supplémentaires (HTML) sur un gestionnaire d'événements JavaScript valide. Remarque

Pour insérer le code JavaScript dans le déclencheur Before Form :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés de l'état) pour afficher la Palette de propriétés.

2	Sous le noeud Echappement d'état, définissez la propriété Type Avant formulaire à Texte (si vous voulez entrer le code JavaScript) ou Fichier (si vous voulez importer le code JavaScript d'un fichier).

3	Définissez la propriété Valeur Avant formulaire en cliquant sur le bouton ... pour entrer le code JavaScript dans la boîte de dialogue ou sélectionner un fichier contenant le code JavaScript à importer.


Ajout de contrôles de navigation sur la sortie au format pages HTML via la palette de propriétés

 Rubriques connexes

Pour ajouter des contrôles de navigation sur la sortie au format pages HTML :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés de l'état) pour afficher la Palette de propriétés.

2	Définissez les propriétés Type Contrôle de navigation de page et Valeur Contrôle de navigation de page. Remarque


Création d'un objet graphique

  Rubriques connexes

Pour créer un objet graphique

1	Dans la vue Modèle de présentation, cliquez sur un outil graphique de la palette d'outils (par exemple, Rectangle, Ellipse, Ligne polygonale, etc.). Remarque

2	Pour créer une ligne, un rectangle arrondi, un rectangle, une ellipse, un arc ou un objet en format libre, cliquez dans la zone principale (région de canevas) de la fenêtre et faites glisser pour créer l'objet.

3	Pour créer un polygone ou une ligne polygonale, cliquez dans la zone principale (région de canevas) à l'endroit choisi pour chaque point de l'objet, puis cliquez deux fois pour créer l'objet.

4	Pour créer des objets contraints (c'est-à-dire, des cercles et des carrés parfaits, etc.), maintenez enfoncée la touche de contrainte (par exemple, la touche Maj) lorsque vous dessinez le graphique.

5	Cliquez deux fois sur l'objet graphique.

6	Dans la Palette de propriétés,, définissez les propriétés de votre choix.


Création d'un graphique Graphics Builder

  Rubriques connexes

Pour créer un nouveau graphique Graphics Builder dans votre état :

1	Choisissez Outils [image] Assistant Graphique.

2	Suivez l'assistant pour créer le graphique et placez-le dans votre état.

3	Modifiez la sortie de l'état dans l'Aperçu interactif ou choisissez Outils [image] Assistant Graphique pour revenir à l'assistant.

4	Pour affiner et personnaliser davantage votre graphique, en utilisant des fonctionnalités qui ne figurent pas dans l'assistant Graphique, ou pour créer des affichages complexes, utilisez Graphics Builder, puis intégrez l'affichage dans votre état.


Un affichage complexe est un affichage interactif, contenant des interrogations multiples ou encore des objets ou des graphiques.


Incorporation d'un affichage Graphics Builder existant

  Rubriques connexes

Pour incorporer dans votre état un affichage Graphics Builder existant :

1	Dans la vue Modèle de présentation, cliquez sur [image] dans la palette d'outils.

2	Cliquez et faites glisser un rectangle.

3	Cliquez deux fois sur le nouvel objet d'affichage Graphics Builder pour afficher la Palette de propriétés.

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

5	Si vous voulez que l'affichage soit imprimé une fois pour chaque groupe de l'état, cliquez deux fois sur le champ de valeur Paramètres et Colonnes pour afficher la boîte de dialogue Graphique.

6	Dans la page Paramètres :

•	Sous Colonne d'état, cliquez sur les colonnes ou les paramètres d'état correspondant aux paramètres de l'affichage.

•	Sous Paramètre de graphique, entrez les noms des paramètres d'affichage correspondant à chaque colonne ou paramètre d'état sélectionné

7	Dans la page Colonnes :

•	Dans le champ Interrogation de graphique, entrez le nom de l'interrogation dans l'affichage Graphics Builder qui doit extraire ses données de l'état. Assurez-vous de sélectionner une interrogation choisissant les colonnes correspondant aux colonnes ou aux paramètres que vous voulez transmettre depuis l'état.

•	Dans le champ Groupe d'état, choisissez depuis la liste déroulante le groupe contenant les colonnes et les paramètres utilisés dans l'interrogation indiquée.

•	Sous Colonne d'état, cliquez sur les colonnes d'état correspondant aux colonnes de l'affichage.

•	Sous Colonne de graphique, entrez les noms des colonnes d'affichage correspondant à chaque colonne d'état sélectionnée.

8	Cliquez sur OK.


Sélection d'une image dans la base de données

  Exemples 	  Rubriques connexes

Pour sélectionner une image dans la base de données :

1	Créez une interrogation, avec une instruction SELECT qui sélectionne une colonne contenant des images ou les noms de fichier d'objets image.

2	Dans la vue Modèle de données, cliquez deux fois sur la colonne image à afficher dans la Palette de propriétés.

3	Si la colonne contient les noms de fichier des objets image, plutôt que les images elles-mêmes :

•	Sous le noeud Colonne, définissez la propriété Lecture depuis fichier à Oui. Exemple

4	Sous le noeud Colonne, définissez la propriété Format de fichier à Image.


Liaison d'un objet image à un fichier

  Rubriques connexes

Pour lier un objet image à un fichier :

1	Dans la vue Aperçu interactif, cliquez sur [image] dans la palette d'outils. Remarque

2	Cliquez et faites glisser un rectangle.

3	Cliquez deux fois sur l'objet du fichier de liaison pour afficher la Palette de propriétés.

4	Sous le noeud Texte standard de fichier de liaison :

•	Définissez la propriété Format de fichier source à Image.

•	Définissez la propriété Nom de fichier source au nom de fichier contenant l'image.


Création d'un bouton pour un objet image, son ou vidéo

  Rubriques connexes

Pour créer un bouton pour un objet image, son ou vidéo :

1	Dans la vue Modèle de présentation, cliquez sur [image] dans la palette d'outils.

2	Cliquez et faites glisser un rectangle.

3	Cliquez deux fois sur l'objet bouton pour afficher la Palette de propriétés.

4	Sous le noeud Libellé de bouton, définissez la propriété Type de libellé à Texte ou Icône :

•	Si le libellé du bouton est un texte, définissez la propriété Texte au texte qui doit apparaître sur le bouton.

•	Si le libellé de bouton est une icône, définissez la propriété Nom d'icône sur le nom du fichier contenant l'icône (le fichier doit résider dans le répertoire indiqué par la variable d'environnement UI_ICON).

5	Sous le noeud Comportement de bouton :

•	Pour afficher une image, un son ou une vidéo stockés dans un fichier, définissez la propriété Type à Fichier multimédia. Définissez la propriété Fichier multimédia au Nom de fichier et la propriété Type de fichier multimédia à Image, Son ou Vidéo.

•	Pour afficher une image ou un son stockés dans la base de données (valides si vous avez défini une interrogation qui sélectionne une colonne de base de données contenant l'objet, et si vous avez défini le format dans la Palette de propriétés de la colonne), définissez la propriété Type à Colonne multimédia. Définissez la propriété Colonne multimédia au Nom de colonne et la propriété Type de colonne multimédia à Image ou à Son.

6	Pour activer le bouton, exécutez l'état dans l'Aperçu interactif, puis affichez-le dans l'Aperçu Runtime.


Sélection d'un objet OLE2 dans la base de données

  Rubriques connexes

Pour sélectionner un objet OLE2 dans la base de données :

1	Créez une interrogation avec une instruction SELECT qui sélectionne une colonne contenant les objets OLE2 ou les noms de fichier des objets OLE2.

2	Dans la vue Modèle de données, cliquez deux fois sur la colonne OLE2 pour afficher la Palette de propriétés.

3	Si la colonne contient les noms de fichier des objets OLE2 plutôt que les objets OLE2 eux-mêmes :

•	Sous le noeud Colonne, définissez la propriété Lecture depuis fichier sur Oui

4	Définissez la propriété Format de fichier à OLE2.


Liaison d'un objet OLE2 à un fichier

  Rubriques connexes

Pour lier un objet OLE2 à un fichier :

1	Dans la vue Modèle de présentation, cliquez sur [image] dans la palette d'outils.

2	Cliquez et faites glisser un rectangle pour afficher la boîte de dialogue Insérer objet.

3	Pour choisir le type d'objet que vous voulez créer, cliquez sur Créer nouveau.

4	Pour indiquer le nom d'un fichier, cliquez sur Créer depuis fichier ou sur Parcourir pour choisir un fichier. Cliquez également sur Lier si vous voulez que l'objet soit lié au fichier (et non copié dans l'état).

5	Pour insérer un contrôle OLE2, cliquez sur Créer contrôle et sélectionnez le type de contrôle à insérer.

6	Pour afficher l'objet OLE2 dans l'état sous la forme d'une icône, cliquez sur Afficher sous forme d'icône.

7	Pour activer un objet OLE2 dans la présentation de l'état, cliquez sur l'objet tout en maintenant enfoncé le bouton droit de la souris. Dans un menu déroulant, sélectionnez l'élément Objet pour afficher un sous-menu d'actions qui peuvent être exécutées par le serveur de l'objet.


Sélection d'un objet son ou vidéo dans la base de données

  Rubriques connexes

Pour sélectionner un objet son et/ou vidéo dans la base de données :

1	Créez une interrogation avec une instruction SELECT qui sélectionne une colonne contenant les objets son ou les noms de fichier des objets vidéo.

2	Dans la vue Modèle de données, cliquez deux fois sur la colonne multimédia pour afficher la Palette de propriétés.

3	Pour les colonnes qui contiennent des noms de fichier d'objets vidéo ou son :

•	Sous le noeud Colonne, définissez la propriété Lecture depuis fichier à Oui

4	Sous le noeud Colonne, définissez la propriété Format de fichier à Vidéo ou à Son.


Import et export d'un dessin, d'une palette de couleurs ou d'une image

  Rubriques connexes

Pour importer un dessin, une palette de couleurs ou une image :

1	Dans la vue Aperçu interactif , choisissez Fichier [image] Importer et cliquez sur le type d'objet à importer. Remarque

2	Dans la boîte de dialogue, indiquez le nom et le format du fichier. Cliquez sur OK.

3	Faites passer l'objet à la position de votre choix.

Pour exporter un dessin, une palette de couleurs ou une image :

1	Dans la vue Modèle de présentation, cliquez sur l'objet que vous voulez exporter. Remarque

2	Choisissez Fichier [image] Exporter et cliquez sur le type d'objet que vous voulez exporter.

3	Dans la boîte de dialogue, indiquez le nom et le format du fichier. Cliquez sur OK.


Création d'un objet marge

  Rubriques connexes

Pour créer un objet ou un en-tête dans la marge d'un état :

1	Dans la vue Modèle de présentation, cliquez sur [image] dans la barre d'outils.  Remarque

2	Pour ajuster la marge, cliquez sur le bord de la marge, puis faites glisser une poignée jusqu'à l'emplacement voulu. Vous pouvez ajuster la marge sur les quatre côtés d'un état.

3	Référez-vous à Rubriques connexes pour créer les objets voulus dans la zone de la marge. Les objets apparaîtront sur toutes les pages de l'état.

4	Cliquez sur [image] dans la barre d'outils, pour réactiver le corps de l'état.


Création d'un en-tête comportant des valeurs de base de données

  Rubriques connexes

Pour créer un en-tête comportant des valeurs de données :

1	Choisissez Outils [image] Assistant Report.

2	Dans la page Totaux, créez les totaux que vous voulez incorporer dans l'en-tête.

3	Dans la page Champs, assurez-vous que les champs et les totaux que vous voulez inclure dans l'en-tête sont soit disponibles, soit affichés dans l'état.

4	Dans la vue Modèle de présentation, cliquez sur [image] dans la barre d'outils.  Remarque

5	Créez un objet de champ dans la zone de marge pour chaque valeur de base de données que vous voulez inclure dans l'en-tête. Dans la Palette de propriétés, sous le noeud Champ, définissez la propriété Source à la colonne source de la valeur, la propriété Visible à Non et la propriété Masque de format pour des valeurs numériques. Sous le noeud Présentation générale, définissez la propriété Elasticité horizontale à Variable.

6	Créez un objet de texte standard dans la zone de marge, et faites référence au(x) champ(s) que vous voulez inclure dans l'en-tête.


Création d'un en-tête ou d'un pied de page de groupe

  Rubriques connexes

Pour créer un en-tête ou un pied de page au-dessus ou au-dessous de chaque groupe d'enregistrements :

1	Dans la vue Modèle de présentation, assurez-vous que le mode Confiné est désactivé et que le mode Flexible est activé (les boutons de la barre d'outils s'affichent sous la forme [image] et [image]).

2	Cliquez sur l'encadrement itératif du groupe auquel vous voulez ajouter un en-tête ou un pied de page, puis faites glisser et redimensionnez l'encadrement pour qu'il y ait suffisamment de place pour entrer le texte de l'en-tête ou du pied de page.

3	Créez un objet de texte standard pour le texte de l'en-tête ou du pied de page.


Création d'un objet page de garde ou page de fin

Grâce au sectionnement d'état, les pages de garde et de fin sont identiques aux pages de corps. En réalité, cela signifie que ces trois types de page constituent trois sections d'un état. Pour conserver la compatibilité avec les versions antérieures, ces sections sont appelées Section d'en-tête, Section principale et Section de fin sous le noeud Modèle de présentation dans le Navigateur d'objet. Vous pouvez utiliser la marge et le corps des sections d'en-tête et de fin pour créer des « pages » de garde et de fin, comme dans les versions précédentes. Les prochaines versions permettront d'ajouter et de supprimer des sections.


Création d'un code à barres

  Rubriques connexes

Créer un code à barres en utilisant une police de codes à barres :

1	Installez une police de code à barres sur votre machine (par exemple, sous Windows, installez la police de codes à barres dans la fenêtre de contrôle de Windows Police). Les polices de code à barres sont vendues dans la plupart des boutiques informatiques. Remarque

2	Créez une interrogation qui sélectionne une colonne dans la base de données contenant les numéros des codes à barres que vous voulez introduire dans votre état.

3	Dans la vue Aperçu interactif, cliquez sur le champ de code à barres, et choisissez Format [image] Police pour appliquer au champ la police du code à barres. Remarque


Création d'un objet standard pour un texte

  Rubriques connexes

Pour créer un objet standard pour un texte :

1	Dans la Vue Aperçu interactif, cliquez sur [image] dans la palette d'outils. Remarque

2	Cliquez et faites glisser un rectangle.

3	Dans le nouvel objet standard, entrez le texte de votre choix.

Le texte que vous entrez se compose de paragraphes séparés par des changements de ligne. Le texte d'un paragraphe passe automatiquement à la ligne en fonction de la longueur de l'objet standard.

4	Cliquez en dehors de l'objet texte standard.


Entrée directe de texte dans l'état

  Rubriques connexes

Pour entrer un texte directement dans l'état :

1	Dans la Vue Aperçu interactif, cliquez sur [image] dans la palette d'outils. Remarque

2	Cliquez à l'endroit où vous voulez que le texte commence et commencez la saisie.

Le texte que vous entrez se compose de paragraphes séparés par des changements de ligne. Comme l'objet texte s'agrandit au fur et à mesure de la saisie, le texte ne passe pas à la ligne. Appuyez sur Retour pour passer à la ligne suivante.

3	Cliquez en dehors de l'objet texte.


Référence à un champ dans un texte standard

  Rubriques connexes

Pour faire référence à un champ dans un texte standard :

1	Dans la vue Aperçu interactif, cliquez sur le texte standard où vous voulez que la référence à un champ apparaisse. Remarque

2	Tapez une esperluette (&), suivie du nom du champ.

Si vous voulez placer la référence du champ à côté d'un autre texte, sans qu'il en soit séparé par des espaces, faites précéder et suivre le nom du champ de chevrons (par exemple, &<nom de champ>Oracle). Notez cependant que vous pouvez entrer des références côte à côte, sans qu'elles soient séparées par des espaces et sans chevrons (par exemple, &champ1&champ2&champ3).


Liaison d'un objet texte à un fichier

  Rubriques connexes

Pour lier un objet texte à un fichier :

1	Dans la vue Aperçu interactif, cliquez sur [image] dans la palette d'outils.

2	Cliquez et faites glisser un rectangle.

3	Cliquez deux fois sur l'objet du fichier de liaison pour afficher la Palette de propriétés.

4	Sous le noeud Texte standard de fichier de liaison :

•	Définissez la propriété Format de fichier source à Texte.

•	Définissez la propriété Nom de fichier source au nom du fichier contenant le texte.


Import et export de texte d'objet standard

  Rubriques connexes

Pour importer un texte dans un objet standard :

1	Dans la Vue Aperçu interactif, cliquez sur [image] dans la palette d'outils. Remarque

2	Cliquez et faites glisser un rectangle.

3	Choisissez Fichier [image] Importer [image] Texte.

4	Dans la boîte de dialogue, entrez ou sélectionnez le nom du fichier contenant l'objet à importer. Cliquez sur Ouvrir.

5	Faites passer l'objet texte à l'endroit de votre choix.

Pour exporter un texte d'un objet standard :

1	Pour exporter la totalité du texte d'un objet standard, cliquez sur l'objet standard.

2	Pour n'exporter qu'une partie du texte, cliquez sur [image] dans la palette d'outils, puis sur l'objet standard et faites glisser sur le texte pour le mettre en évidence.

3	Choisissez Fichier [image] Exporter [image] Texte.

4	Dans la boîte de dialogue, entrez ou sélectionnez le nom du fichier dans lequel vous voulez importer le texte. Cliquez sur Enregistrer.


Création d'un objet champ

  Rubriques connexes

Pour créer un objet champ dans la présentation d'état :

1	Cliquez sur [image] dans la palette d'outils de la vue Aperçu interactif, de la vue Modèle de présentation ou de la vue Grille de paramètres.

2	Cliquez et faites glisser un rectangle.

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

4	Sous le noeud Champ, définissez la propriété Source à la colonne ou au paramètre qui fournira la valeur pour le champ.

5	Définissez d'autres propriétés, le cas échéant..


Création d'un encadrement ou d'un encadrement itératif

  Rubriques connexes

Pour créer manuellement un encadrement ou un encadrement itératif :

1	Dans la vue Modèle de présentation, cliquez sur [image] ou [image] dans la palette d'outils.

2	Cliquez et faites glisser un rectangle.

3	Cliquez deux fois sur le nouvel objet d'encadrement.

4	Dans la Palette de propriétés,, définissez les propriétés de votre choix.


Création d'une présentation d'état supplémentaire

  Rubriques connexes

Pour ajouter une nouvelle section de présentation à un état sans remplacer les présentations existantes :

1	Dans la vue Modèle de présentation, cliquez sur [image] dans la palette d'outils.

2	Cliquez et faites glisser un rectangle pour que la présentation par défaut affiche l'assistant Report.

3	Suivez l'assistant pour sélectionner les données à afficher dans la nouvelle section de présentation.

4	Pour réorganiser les sections de présentation, cliquez dessus et faites-les glisser à leur nouvel emplacement dans la vue Modèle de présentation.

5	Modifiez la sortie de l'état dans la vue Aperçu interactif, ou choisissez Outils [image] Assistant Report pour revenir à l'assistant.


Ajout d'un titre à un état

  Rubriques connexes

Pour ajouter un titre à un état :

1	Dans le Navigateur d'objet, sélectionnez ou ouvrez l'état.

2	Choisissez Outils [image] Assistant Report.

3	Sur la page Style, entrez le titre de l'état dans le champ Titre.

4	Pour définir les attributs par défaut (tels que police et couleur) du titre dans un modèle sélectionné :

•	Dans le Navigateur d'objet, ouvrez le modèle.

•	Développez le noeud Modèle de présentation, puis le noeud Corps.

•	Cliquez deux fois sur [image] (icône de propriétés) en regard du noeud Par défaut pour afficher la Palette de propriétés.

•	Sous le noeud Titre, modifiez les propriétés comme vous le souhaitez.

5	Pour définir la position et les attributs de remplacement (tels que police et couleur) du titre dans un modèle sélectionné :

•	Dans la vue Modèle de présentation du modèle, créez un objet de texte standard pour le titre dans la marge.

•	Dimensionnez et positionnez le titre, puis modifiez les attributs de couleur et de texte comme vous le souhaitez.

•	Cliquez deux fois sur l'objet titre pour afficher sa Palette de propriétés.

•	Sous le noeud Présentation générale, donnez à la propriété Nom la valeur B_OR$REPORT_TITLE.


Génération d'une sortie délimitée

  Rubriques connexes

Pour générer une sortie délimitée :

1	Créez un état ou ouvrez-en un existant.

2	Dans la boîte de dialogue de sortie délimitée, choisissez dans la liste déroulante le caractère qui doit séparer les cellules dans votre sortie d'état ou saisissez-le dans la zone appropriée.

3	Pour utiliser des options de formatage, sélectionnez-les dans la zone déroulante ou entrez un masque de format de date ou un masque de format de nombre.

4	Pour utiliser un intercalaire de cellule, sélectionnez dans la liste déroulante le caractère à placer autour des cellules de votre sortie d'état ou saisissez-le dans la zone appropriée.

5	Cliquez sur OK.


Création d'un hyperlien graphique

  Exemples 	  Rubriques connexes

Pour créer un hyperlien graphique à l'aide de l'assistant Web :

1	Sélectionnez Outils [image] Assistant Web. Remarque

2	Dans la page des hyperliens graphiques de l'assistant, cliquez sur les graphiques voulus dans la liste Graphiques disponibles. Remarque

3	Cliquez sur [image] pour déplacer le graphique vers la liste des graphiques.

4	13 Cliquez sur Fin.

Pour créer un hyperlien graphique à l'aide de la palette de propriétés :

1	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis celui qui contient l'objet graphique.

2	Cliquez deux fois sur cet objet pour afficher la palette de propriétés.

3	Sous le noeud Graphique, paramétrez la propriété Hyperlien graphique sur la destination du lien. Si vous la paramétrez sur un objet, vous devez également paramétrer la propriété Destination hyperlien sur la destination de l'objet.


Génération d'une sortie XML

  Rubriques connexes

Pour générer un fichier de sortie XML à partir de l'état actuel :

1	Ouvrez l'état à sortir au format XML. Actuellement, tous les styles d'état peuvent être générés sous forme de sortie XML, mais la prise en charge des états de style matriciel est limitée. (Pour plus d'informations, reportez-vous aux notes sur la version de Report Builder.)

2	Dans le Navigateur d'objet, sélectionnez l'état voulu, puis cliquez sur Fichier [image] Générer dans fichier [image] XML. Conseil

3	Enregistrez le fichier de sortie XML dans le répertoire de votre choix. Remarque

Pour visualiser le contenu d'un fichier XML dans un navigateur Web :

1	Lorsqu'un état est ouvert dans le Navigateur d'objet, cliquez deux fois sur [image]. L'Aperçu interactif doit être activé pour que vous puissiez passer à l'étape suivante. Remarque

2	Choisissez Afficher [image] Aperçu Web [image] Utiliser XML. (Vous changez ainsi le mode de gestion de l'état par le navigateur lors de la préparation de l'aperçu.)

3	Cliquez sur [image] (bouton d'aperçu Web) pour démarrer le navigateur et afficher l'aperçu de l'état sous forme de sortie XML. Remarque

Lorsque vous modifiez l'état via la palette de propriétés dans la vue Modèle de données, le navigateur affiche la sortie XML correspondante dans le navigateur Web chaque fois que vous cliquez sur [image].

Pour afficher un aperçu du contenu d'un fichier XML dans un navigateur Web avec un appel de ligne de commande :

1.	Sur la ligne de commande, exécutez l'état avec les arguments DESFORMAT=XML, DESTYPE=FILE et DESNAME=[nom].XML. (Pour plus d'informations sur l'appel d'une ligne de commande, reportez-vous à la rubrique RWRUN60.)

2.	Ouvrez un navigateur Web compatible XML.

3.	Choisissez Fichier [image] Ouvrir pour accéder au fichier .XML que vous venez de générer. Ce fichier apparaîtra dans la fenêtre du navigateur.

4.	Si vous modifiez la sortie XML dans l'état et que vous génériez à nouveau le fichier .XML avec le même nom, cliquez sur le bouton Régénérer du navigateur pour afficher la sortie XML mise à jour.


Création d'une sortie XML

  Rubriques connexes

Vous pouvez modifier les propriétés XML qui contrôlent la sortie XML de l'état, au niveau de l'état, au niveau du groupe ou au niveau de la colonne. Dans les fichiers XML générés par Report Builder, la sortie imite le modèle de données (elle est structurée en groupes et en colonnes). Pour obtenir des informations sur l'affichage des modifications dans une sortie XML, reportez-vous à la rubrique Génération d'une sortie XML.

Conseil

Pour modifier les propriétés XML de l'intégralité de l'état :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] pour afficher la Palette de propriétés.

2	Sous le noeud Paramètres XML, définissez les propriétés XML comme il convient pour cet état.

Pour modifier les propriétés XML d'un groupe :

1	Dans la vue Modèle de données de l'état, sélectionnez l'objet groupe à éditer.

2	Cliquez deux fois sur la barre de titre du groupe pour ouvrir la Palette de propriétés.

3	Sous le noeud Paramètres XML, définissez les propriétés XML de la manière appropriée pour ce groupe.

Pour modifier les propriétés XML d'une colonne :

1	Dans la vue Modèle de données de l'état, sélectionnez la colonne à éditer.

2	Cliquez deux fois sur la colonne pour afficher la Palette de propriétés.

3	Sous le noeud Paramètres XML, définissez les propriétés XML de la manière appropriée pour cette colonne.


Dans certains cas (par exemple, lors de l'émission de messages), vous devez saisir du code JavaScript dans le déclencheur Before Form.


Une extension .XML est requise par les navigateurs compatibles XML pour reconnaître le format XML et l'afficher comme tel.


Report Builder crée une sortie XML « de format correct ». Cela signifie que le prologue du document XML contient une déclaration XML, mais pas systématiquement une DTD (définition de type de document). Pour créer une sortie XML « valide », vous devez ajouter la DTD au champ de propriétés Valeur du prologue XML, au niveau de l'état.


Lorsque vous apportez des modifications dans la Palette de propriétés, veillez à cliquer sur une autre propriété avant de fermer la Palette de propriétés afin d'enregistrer vos modifications.


Cette opération requiert un navigateur Web compatible XML.


L'état apparaît si vous avez défini des objets de présentation. Dans le cas contraire, un écran vide apparaîtra dans l'Aperçu interactif.


• 9


Autorisation et interdiction de l'accès à un état

  Rubriques connexes

Pour autoriser ou interdire l'accès à un état (stocké dans la base de données) :

1	Dans le Navigateur d'objet, cliquez sur l'état.

2	Choisissez Fichier [image] Administration [image] Accès document.

3	Pour autoriser un utilisateur à accéder à l'état (y compris aux interrogations SQL externes et aux bibliothèques SQL externes), entrez son ID utilisateur et cliquez sur Ajouter. Pour interdire un accès, cliquez sur l'ID utilisateur puis sur Supprimer.


Définition d'un rôle de base de données

  Rubriques connexes

Pour définir un rôle de base de données sur un état :

1	Vérifiez que l'administrateur de bases de données a créé ce rôle, lui a accordé les droits nécessaires et l'a affecté à des utilisateurs finaux autorisés. Pour plus d'informations, reportez-vous aux manuels Oracle 7 Application Developer's Guide ou Oracle 8 Application Developer's Guide.

2	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés) de l'état pour afficher la Palette de propriétés.

3	Dans le noeud Etat, définissez la propriété Nom de rôle comme indiqué par l'administrateur de bases de données dans la base de données.

4	(Facultatif) Pour définir un mot de passe pour le rôle, cliquez deux fois sur le bouton du champ de valeur Nom du rôle afin d'afficher la boîte de dialogue Définir rôles.

Remarques :

•	Les paramètres de rôle de l'état sont remplacés si vous indiquez un rôle à l'aide de la ligne de commande et de Reports Runtime (RWRUN60).

•	Vous ne pouvez définir qu'un seul rôle par état. Pour définir plusieurs rôles, vous devez définir un rôle auquel les autres rôles sont autorisés.

Avertissement : Ne tentez pas de définir le rôle dans un déclencheur PL/SQL : le code PL/SQL ne serait alors pas compilé.


Génération d'un état standard

  Rubriques connexes

Pour générer un état d'interrogation simple :

1	Dans le Navigateur d'objet, cliquez sur le noeud Etats, puis sur [image] dans la barre d'outils.

2	Choisissez Outils [image] Assistant Report.

3	Dans la page de Style, cliquez sur le style d'état voulu, puis suivez l'assistant pour créer votre état.

4	Modifiez la sortie de l'état dans la vue Aperçu interactif ou cliquez sur [image] dans la barre d'outils pour revenir à l'assistant.

Pour générer un état d'interrogation multiple :

1	Créez chacune des interrogations à l'aide de l'assistant Données.

2	Créez une présentation pour l'état.


Génération d'un état de style groupe-niveau supérieur d'interrogation multiple

  Rubriques connexes	  Exemples

Pour générer un état de style groupe-niveau supérieur d'interrogation multiple :

1	Dans le Navigateur d'objet, cliquez sur le noeud Etats, puis sur [image] dans la barre d'outils.

2	Cliquez deux fois sur [image] (icône du noeud Modèle de données) sous le nouvel état.

3	Créez la première interrogation via l'outil d'interrogation SQL. Exemple

4	Créez la seconde interrogation via l'outil d'interrogation SQL. Exemple

5	Définissez un lien de colonne à colonne entre la colonne père (par exemple, NOEMP) et la colonne fils (par exemple, IDREP),

6	Cliquez sur [image] dans la barre d'outils, puis sur Oui lorsque vous êtes invité à créer une présentation par défaut.

7	Dans l'assistant Report, dans la page Style, cliquez sur Groupe-niveau supérieur.

8	Dans la page Groupes, déplacez le ou les champs de regroupement de l'état à la liste des groupes affichés, en les sélectionnant dans la liste des champs disponibles, puis en cliquant sur le bouton d'orientation de l'impression correspondant.

9	Dans la page Champs, déplacez vers la liste des champs affichés les champs à afficher dans cet état. Vérifiez que la colonne fille n'a pas changé de position (afin qu'elle n'apparaisse pas dans la partie détail de l'état).

10	12 Dans la page Libellés, personnalisez les libellés de colonne de la manière voulue.

11	13 Cliquez sur Fin.

12	14 Modifiez la sortie de l'état, dans la vue Aperçu interactif, ou cliquez sur [image] dans la barre d'outils pour revenir à l'assistant.

13	13 (Facultatif) Pour afficher uniquement un enregistrement maître par page :

•	Dans la vue Modèle de présentation, cliquez deux fois sur l'encadrement itératif maître. Conseil

•	Dans la Palette de propriétés, sous le noeud Encadrement itératif, définissez Nbre max d'enregistrements par page à 1.


Génération d'un état de style matriciel imbriqué

  Rubriques connexes	  Exemples

Pour générer un état de style matriciel imbriqué :

1	Dans le Navigateur d'objet, cliquez sur le noeud Etats, puis sur [image] dans la barre d'outils.

2	Cliquez deux fois sur [image] (icône du noeud Modèle de données) sous le nouvel état.

3	Créez la première interrogation à l'aide de l'outil d'interrogation SQL. Exemple

4	Créez un modèle de données de style matriciel imbriqué :

  Démo

•	Cliquez sur la barre de titre de l'objet de groupe nouvellement créé, tout en maintenant enfoncé le bouton de la souris, et faites glisser la barre vers le bas.

•	Faites glisser les deux colonnes "ligne" (par exemple, ANNEE et NODEPT) et une colonne "colonne" (par exemple, POSTE) dans l'espace permettant de créer trois nouveaux groupes.

•	Cliquez une fois sur [image] dans la palette d'outils.

•	Faites glisser une boîte autour des trois groupes que vous venez de créer pour en créer un quatrième.

5	Cliquez deux fois sur le groupe imbriqué (par exemple, NODEPT) pour afficher la Palette de propriétés.

6	Sous le noeud Groupe, donnez à la propriété Dimension fils la valeur Oui (pour créer une matrice non creuse, ce qui signifie que les lignes sans données n'apparaîtront pas sur la sortie de votre état).

7	Cliquez sur [image] dans la barre d'outils.

8	Dans l'assistant Report, dans la page Style, cliquez sur Matriciel.

9	Dans la page Lignes, sélectionnez les deux colonnes "Lignes" pour les niveaux de ventilation primaire et secondaire.

10	10 Dans la page Colonnes, sélectionnez la colonne "colonne".

11	11 Dans la page Cellule, sélectionnez la colonne qui contient la valeur des cellules.

12	12 Dans la page Libellés, personnalisez les libellés de colonne de la manière voulue.

13	13 Cliquez sur Fin.

14	14 Modifiez la sortie de l'état, dans la vue Aperçu interactif, ou cliquez sur [image] dans la barre d'outils pour revenir à l'assistant.


Génération d'un état de style multimédia

  Rubriques connexes

Pour générer un état de style multimédia, vous pouvez :

•	Sélectionner une image dans la base de données

•	Sélectionner un son ou une vidéo dans la base de données

•	Créer un bouton pour une image, un son ou une vidéo stocké dans la base de données ou dans un fichier


Génération d'un état OLE2

  Rubriques connexes

Pour générer un état OLE2, vous pouvez :

•	Sélectionner des objets OLE2 dans la base de données

•	Importer un objet OLE2 d'un fichier dans la présentation d'état


Création d'une interrogation locale

  Rubriques connexes

Pour créer une interrogation pour un état à interrogation simple, utilisez l'une des méthodes suivantes :

•	Assistant Report

•	Outil d'interrogation SQL (pour une interrogation SQL)

•	Outil d'interrogation de curseur de référence (pour utiliser des curseurs de référence)

Pour créer une interrogation pour un état à interrogation multiple, utilisez l'une des méthodes suivantes :

•	Assistant Données

•	Outil d'interrogation SQL (pour une interrogation SQL)

•	Outil d'interrogation de curseur de référence (pour utiliser des curseurs de référence)


Création d'une interrogation locale : assistant Report

  Etape suivante 	  Rubriques connexes

Pour créer une interrogation à l'aide de l'assistant Report :

1	Choisissez Outils [image] Assistant Report.

2	Dans la page Style, cliquez sur le style d'état voulu, puis suivez l'assistant pour indiquer l'instruction SELECT de l'interrogation, les champs à afficher, les champs de groupe et d'éventuels totaux.


Création d'une interrogation locale : assistant Données

  Etape suivante 	  Rubriques connexes

Pour créer une interrogation à l'aide de l'assistant Données:

1	Dans la vue Modèle de données, choisissez Outils [image] Assistant Données.  Remarque

2	Suivez l'assistant pour créer la première interrogation du modèle de données.

3	Répétez les étapes 1 et 2  pour chaque interrogation que vous voulez créer.

4	Modifiez le modèle de données résultant dans la vue Modèle de données ou choisissez Outils [image] Assistant Données pour revenir à l'assistant.

Remarque : Dans la présente version, l'assistant Données ne prend pas en charge la création de liaisons de données entre interrogations. Pour définir des relations d'interrogation père-fils, vous pouvez créer une liaison de données manuellement.


Assurez-vous qu'aucun objet n'est sélectionné dans la vue Modèle de données.


Création d'une interrogation locale : outil d'interrogation SQL

  Etape suivante 	  Rubriques connexes

Pour créer une interrogation SQL :

  Démo

1	Dans la vue Modèle de données, cliquez une fois sur [image] dans la palette d'outils.

2	Cliquez dans la zone principale (région du canevas) de la fenêtre. Conseil

3	Dans la boîte de dialogue Instruction d'interrogation SQL, définissez une instruction SELECT pour l'interrogation :

•	Pour utiliser les boîtes de dialogue de Query Builder, cliquez sur Query Builder.

•	Pour importer une interrogation d'un fichier, cliquez sur Importer interrogation SQL.

•	Pour entrer vous-même l'instruction SELECT, tapez-la dans la zone Instruction d'interrogation SQL. Conseil

4	Cliquez sur OK.

5	Affinez l'interrogation à l'aide d'une des méthodes suivantes :

•	Cliquez sur l'objet d'interrogation, puis choisissez Outils [image] Palette de propriétés pour afficher la Palette de propriétés, puis définissez les propriétés voulues.

•	Cliquez sur l'objet d'interrogation, puis choisissez Outils [image] Assistant Données pour indiquer les champs à afficher, les champs de groupe et d'éventuels totaux.

6	Répétez les étapes 1 à 5 pour chaque interrogation que vous voulez créer.

Remarque : Si vous définissez plusieurs interrogations dans la vue Modèle de données de votre état, la page Données n'apparaît pas lorsque vous appelez l'assistant Report pour définir une présentation par défaut.


Création d'une interrogation locale : outil d'interrogation de curseur de référence

  Etape suivante	  Rubriques connexes

Pour créer une interrogation de type curseur de référence :

1	Créez un package qui définit un type de curseur de référence de l'une des façons suivantes :

•	Créez une unité de programme locale.

•	Créez une bibliothèque PL/SQL externe.

•	Créez une unité de programme stockée.

2	Si le package créé à l'étape 1 est une bibliothèque PL/SQL externe, celle-ci doit être attachée à l'état pour que vous puissiez y faire référence.

3	Dans la vue Modèle de données, cliquez une fois sur [image] dans la palette d'outils.

4	Cliquez dans la zone principale (région du canevas) de la fenêtre. Conseil

5	Dans l'éditeur PL/SQL, entrez le code PL/SQL d'une fonction qui ouvre un curseur et renvoie une variable de curseur ayant le type de curseur de référence défini dans le package. Exemple

6	Affinez votre interrogation comme vous le souhaitez.

•	Cliquez sur l'objet d'interrogation de type curseur de référence, puis choisissez Outils [image] Palette de propriétés pour modifier ses propriétés.

•	Cliquez sur l'objet d'interrogation, puis choisissez Outils [image] Assistant Données pour indiquer les champs à afficher, les champs de groupe et d'éventuels totaux.

7	Répétez les étapes 1 à 6 pour chaque interrogation de type curseur de référence que vous voulez créer.


Création d'une interrogation externe (partageable)

  Rubriques connexes

Pour créer une interrogation externe (partageable) :

1	Dans le Navigateur d'objet, cliquez sur le noeud Interrogations SQL externes.

2	Cliquez sur [image] dans la barre d'outils.

3	Cliquez deux fois sur l'icône du noeud de la nouvelle interrogation externe.

4	Dans la boîte de dialogue Définition d'interrogation externe, entrez l'instruction SELECT pour l'interrogation.

5	Cliquez sur [image] dans la barre d'outils pour enregistrer l'interrogation dans le système de fichiers.


Création d'un groupe de ventilation

  Etape suivante	  Rubriques connexes

Pour créer un groupe de ventilation à l'aide de l'assistant Données :

1	Dans la vue Modèle de données, cliquez sur l'interrogation, puis choisissez Outils [image] Assistant Données.

2	Sur la page Groupes, sélectionnez une ou plusieurs colonnes pour les groupes de ventilation.

Pour créer un groupe de ventilation manuellement :

  Démo

1	Dans la vue Modèle de données, faites glisser la barre de titre de l'objet de groupe vers le bas.

2	Faites glisser la colonne de ventilation (par exemple, NODEPT) au-dessus du groupe pour créer un groupe. Remarque

3	(Facultatif) Cliquez deux fois sur le nouvel objet de groupe pour afficher la Palette de propriétés et définissez les propriétés de votre choix.


(Oracle Express uniquement) Vous devez également faire glisser la colonne de tri correspondante vers le nouveau groupe pour trier les valeurs de dimension.


Création d'un groupe matriciel (table d'analyse croisée)

  Etape suivante	  Rubriques connexes

Pour créer un groupe matriciel (table d'analyse croisée) à l'aide de l'assistant Données :

1	Dans la vue Modèle de données, cliquez sur l'interrogation, puis choisissez Outils [image] Assistant Données.

2	Sur la page Nom de l'interrogation, activez la case à cocher Interrogation matricielle.

3	Suivez l'assistant pour sélectionner les colonnes pour les groupes, lignes, colonnes et cellules de la matrice.

Pour créer un groupe matriciel (table d'analyse croisée) manuellement :

  Démo

1	Dans la vue Modèle de données, faites glisser la barre de titre de l'objet de groupe vers le bas.

2	Faites glisser la colonne "ligne" et la colonne "colonne" à l'endroit prévu pour la création de deux nouveaux groupes.

3	Cliquez une fois sur [image] dans la palette de propriétés.

4	Faites glisser une boîte autour des groupes que vous voulez inclure dans le groupe matriciel (table d'analyse croisée).

5	Si le groupe de cellules est une interrogation distincte des groupes matriciels (tables d'analyse croisée), créez les liens appropriés entre les colonnes des groupes matriciels et le groupe de cellules.


Création d'une liaison de données

  Rubriques connexes

Pour créer une liaison de données :

  Démo

1	Dans la vue Modèle de données, cliquez une fois sur [image] dans la palette d'outils.Remarque

•	Créez une liaison d'interrogation à interrogation  Pour créer une liaison de données pour chaque contrainte de base de données, définie entre les tables de deux interrogations, cliquez sur l'interrogation parent, puis faites-la glisser sur l'interrogation enfant. Remarque.

•	Créez une liaison de groupe à groupe  Pour créer une liaison entre le groupe d'une interrogation et le groupe d'une autre interrogation, ce qui est intéressant lorsque vous voulez que l'interrogation fils connaisse les données de l'interrogation père, cliquez sur le groupe père (en évitant les colonnes du groupe) et faites glisser une liaison sur le groupe fils.

•	Créez une liaison de colonne à colonne  Pour créer une liaison entre colonnes, cliquez sur une colonne de l'interrogation père et faites glisser une liaison sur une colonne de l'interrogation fils.

2	Cliquez deux fois sur le nouvel objet de liaison.

3	Dans la Palette de propriétés,, définissez les propriétés de votre choix.


Création de la présentation par défaut d'un état

  Rubriques connexes

Pour créer la présentation par défaut d'un état :

1	Pour affecter à l'état en cours la présentation par défaut (la section principale de l'état est utilisée par défaut), choisissez Outils [image] Assistant Report, puis suivez l'assistant pour créer la présentation du style d'état que vous avez choisi.

2	Pour ajouter une autre section de présentation à la présentation de l'état en cours, créez une présentation d'état supplémentaire.

3	Modifiez manuellement la présentation par défaut dans la vue Modèle de présentation. Attention : Si vous réactivez ensuite l'Assistant Report, une partie des modifications apportées sont perdues lorsque vous cliquez sur le bouton Terminer de cet assistant, qui rétablit la présentation par défaut.


Création de la présentation par défaut d'une section

  Rubriques connexes

Pour créer la présentation par défaut d'une section d'un état :

1	Dans la vue Modèle de présentation, affichez la vue de présentation à appliquer à la section.

2	Choisissez Outils [image] Assistant Report.

3	Suivez les instructions fournies par l'assistant afin de créer la présentation par défaut de l'état.

4	Pour créer une présentation ou des objets dans la marge d'une section, cliquez sur [image] dans la barre d'outils afin d'afficher ou de modifier cette marge.

5	Pour ajouter une autre présentation à la présentation en cours, créez une présentation d'état supplémentaire.

6	Modifiez manuellement la présentation par défaut dans la vue Modèle de présentation. Attention : Si vous réactivez ensuite l'Assistant Report, une partie des modifications apportées sont perdues lorsque vous cliquez sur le bouton Terminer de cet assistant, qui rétablit la présentation par défaut.

7	Définissez les propriétés de la section à votre convenance.


Préparation d'un état pour transmission sur le Web

  Etape suivante	  Rubriques connexes

Pour préparer un état à transmettre sur le Web :

1	(Facultatif) Ajoutez les liens Web souhaités à un état (nouveau ou existant) :

•	Créez un hyperlien (et, en cas de création d'un lien avec un objet de l'état, créez une destination de l'hyperlien associé)

•	Créez un lien de ligne de commande d'application (sortie PDF uniquement)

•	Créez un signet.

•	Créez un en-tête de document HTML.

•	Créez un pied de document HTML

•	Créez un en-tête de page HTML.

•	Créez un pied de page HTML.

•	Créez un en-tête de grille de paramètres HTML.

•	Créez un pied de grille de paramètres HTML.

2	Sélectionnez une imprimante ou utilisez l'imprimante par défaut (les pilotes de l'imprimante sélectionnée sont utilisés pour produire la sortie ; vous devez avoir une imprimante configurée pour la machine sur laquelle vous exécutez l'état).

3	Choisissez Outils [image] Assistant Web.

4	Sur la dernière page de l'assistant, sélectionnez la sortie de votre choix et enregistrez-la dans un fichier qui s'affichera dans votre visualiseur Web ou dans le visualiseur PDF.


Définition des propriétés pour un état ASCII (mode caractère)

  Rubriques connexes

Pour définir les propriétés pour un état ASCII (en mode caractère) :

1	S'il s'agit d'un nouvel état :

•	Dans le Navigateur d'objet, cliquez sur le noeud Etats, puis sur [image] dans la barre d'outils.

2	Cliquez deux fois sur [image] (icône de propriétés) en regard du noeud d'état pour afficher la Palette de propriétés.

3	Sous le noeud Etats, définissez les propriétés Largeur et Hauteur de votre choix (par exemple, 11 (ou 15) de large x 8.5 de haut pour le mode Paysage ou 8.5 de large x 11 (ou 15) de haut pour le mode Portrait).

4	Sous le noeud Mode caractère :

•	Définissez Définir en unités à Oui.

•	Définissez la largeur et la hauteur de l'état aux dimensions en mode caractère appropriées (par exemple, 132 (ou 180) de large x 66 de haut pour le mode Paysage ou 102 de large x 85 (ou 116) de haut pour le mode Portrait).

5	Dans le Navigateur d'objet, développez le noeud Modèle de données, puis le noeud Paramètres système.

6	Cliquez deux fois sur l'icône de propriétés MODE pour afficher la Palette de propriétés.

7	Sous le noeud Paramètres, définissez la propriété Valeur initiale à Caractère.

8	Dans le Navigateur d'objet, cliquez deux fois sur [image] (l'icône du noeud Modèle de présentation).

9	Dans la vue Modèle de présentation, choisissez Format [image] Options de présentation [image] Règles pour afficher la boîte de dialogue Paramètres de règle.

10	10 Définissez Unités à Cellules de caractère et Nombre de points magnétiques par pas de grille à 1. Cliquez sur OK.

11	11 Cliquez sur Affichage dans la barre de menu et assurez-vous que Grille magnétique est coché.

12	12 Choisissez Outils [image] Préférences pour afficher la boîte de dialogue Préférences.

13	13 Dans la page Préférences, définissez Inter-champ horizontal à 1 et Inter-champ vertical à 0. Cliquez sur OK.

14	14 Choisissez Format [image] Police et sélectionnez la police, le type et la taille les plus proches de la police en mode caractère (par exemple, Courier normal 12 points).

S'il s'agit d'un nouvel état, vous êtes maintenant prêt à définir votre modèle et votre présentation de données. Reportez-vous aux instructions concernant le type d'état que vous voulez créer (par exemple, Tabulaire, Groupe-gauche, etc.).


Conversion d'un état bitmap en ASCII (mode caractère)

  Rubriques connexes

Pour convertir un état bitmap en état ASCII (mode caractère) :

1	Dans le Navigateur d'objet, sous le noeud Etat, cliquez sur l'état que vous voulez convertir.

2	Choisissez Fichier [image] Administration [image] Conversion.

3	Dans la boîte de dialogue Conversion, sur la page Conversion :

•	Définissez Type de document à Etat.

•	Définissez Type de source à Fichier binaire d'état (RDF).

•	Définissez Source au nom de l'état bitmap existant.

•	Définissez Type de destination à Fichier binaire d'état (RDF).

•	Définissez Destination au nom du nouvel état en mode caractère.

4	Sur la page Options, définissez Unité de destination à Caractère.

5	Cliquez sur OK.

6	Définissez les propriétés de votre nouvel état en mode caractère.


A propos de la conversion d'un état bitmap en ASCII (mode caractère)

  Rubriques connexes

Lorsque vous utilisez Report Builder pour convertir un état bitmap en état ASCII (mode caractère), le processus génère une nouvelle version en mode caractère de votre état bitmap original, lequel demeure inchangé.

Après la conversion, la plupart de vos champs et objets texte devront être redimensionnés. De même, les objets graphiques tels que les images et les dessins ne seront pas inclus dans l'état en mode caractère. La liste ci-après récapitule ce qui est pris en charge par chacun des formats :

Mode caractère	Bitmap

Boîtes	Images
Lignes horizontales	Couleurs
Lignes verticales	Dessins
Texte ASCII	Ellipses/Cercles
Texte en gras	Boutons
Soulignements	Texte en italique
Motifs bitmap
Lignes diagonales
Objets multimédias


Préparation d'un état multi-plate-forme

  Rubriques connexes

Pour préparer un état devant s'éxécuter sur plusieurs plates-formes, tenez compte des différences d'interface graphique suivantes :

Polices  Il est possible qu'un type, un style ou une taille de police ne soient pas disponibles sur l'interface graphique cible. Dans ce cas, vous avez le choix entre deux possibilités :

•	Utiliser une police que vous savez exister sur l'interface graphique cible ou qui correspond bien à la police par défaut de l'interface graphique cible.

•	Modifier le fichier de définition de polices, uifont.ali, pour vous assurer que la correspondance des polices s'effectue correctement

Couleurs  Il est possible qu'une couleur n'existe pas dans l'interface graphique cible. Si possible, utilisez une couleur que vous savez exister sur l'interface graphique cible ; sinon, utilisez une couleur qui correspond bien à la couleur par défaut de l'interface graphique cible. Les couleurs présentes généralement sur la plupart des plates-formes sont les suivantes : bleu, magenta, rouge, cyan, vert, jaune.

PPP  Le nombre de points par pouce (PPP) que votre moniteur utilise peut ne pas être le même que celui utilisé par la personne qui exécute l'état. Ce paramètre n'affecte que la façon dont les caractères alphanumériques passent automatiquement à la ligne à l'écran. Si vous créez un état qui peut s'afficher dans la vue Aperçu interactif, essayez d'utiliser la même valeur de PPP que les utilisateurs qui l'exécuteront. Evitez également de donner aux objets de la présentation une taille fixe.

Pour des informations plus détaillées relatives aux états concernant plusieurs plates-formes, reportez-vous à Guidelines for Building Application.


Préparation d'un état destiné à être traduit dans d'autres langues

Pour plus d'informations sur le support NLS (National Language Support), affichez la fenêtre Rubriques d'aide, puis développez la Référence Report Builder, puis le support NLS.


Affichage de la vue de la présentation d'une section

  Rubriques connexes

Pour afficher la vue de la présentation de la section d'un état :

•	Dans la vue Modèle de présentation, effectuez l'une des opérations suivantes :

•	Sélectionnez Affichage [image] Section de présentation, puis la section à afficher et à vérifier, que vous souhaitiez ou non afficher ou modifier la marge.

•	Dans la barre d'outils, cliquez sur [image], sur [image] ou sur [image] afin d'afficher respectivement les sections d'en-tête, principale ou de fin. Ensuite, cliquez sur [image] pour afficher ou modifier la marge.


Définition des propriétés d'une section

  Rubriques connexes

Pour définir les propriétés de la section d'un état (y compris la taille et l'orientation de la page) :

1	Dans le Navigateur d'objet, agrandissez le noeud Modèle de présentation, puis cliquez sur la section d'en-tête, principale ou de fin.

2	Choisissez Outils [image] Palette de propriétés.

3	Dans la Palette de propriétés, définissez les propriétés de cette section à votre convenance.


Modification des paramètres d'affichage du Navigateur d'objet

Pour modifier les paramètres d'affichage du Navigateur d'objet afin de simplifier le débogage :

1	Dans le Navigateur d'objet, choisissez Navigateur [image] Options navigateur.

2	Dans la fenêtre de propriétés, modifiez les paramètres de votre choix. Cliquez sur OK.

3	Pour afficher la hiérarchie des objets, choisissez Affichage [image] Organisation hiérarchique.

4	Pour afficher les objets par type, choisissez Affichage [image] Organisation par type d'objet.


Suivi de l'exécution de l'état

Pour définir les options de traçage, vous avez le choix entre plusieurs possibilités :

•	Choisir Outils [image] Trace et remplir la boîte de dialogue.

Dans la ligne de commande, indiquer les options de traçage en utilisant la commande RWBLD60 ou RWRUN60 avec les mot-clés TRACEFILE, TRACEMODE et TRACEOPTS.

Indiquer les options de traçage via le package intégré de Report Builder à l'aide de SRW.TRACE_START, SRW.TRACE_END, SRW.TRACE_ADD_OPTIONS et SRW.TRACE_REM_OPTIONS.


Suivi de la diffusion de l'état

  Rubriques connexes

Pour effectuer le suivi de la diffusion d'un état :

1	Indiquez le nom du fichier de trace dans le champ approprié de la boîte de dialogue Paramètres de trace (exécution).

2	Cochez la case Diffusion.

3	Cliquez sur OK.

4	Exécutez l'état.

5	Utilisez un éditeur de texte (par exemple, Wordpad) afin d'ouvrir et d'afficher le contenu du fichier de trace dont les listes de diffusion ont été employées. Vous pouvez utiliser ces informations pour connaître la destination de chaque section envoyée. Notez que le format du fichier de trace est très similaire à celui du fichier .DST, de façon à ce que ce dernier puisse être généré via un copier-coller depuis le fichier de trace.


Définition d'un point d'interruption

  Etape suivante

Pour définir un point d'interruption dans l'exécution de votre état :

1	Si l'Interpréteur PL/SQL n'est pas encore affiché, choisissez Programme [image] Interpréteur PL/SQL.

2	Dans le Navigateur d'objet, cliquez une fois sur un noeud d'unité de programme compilée pour afficher l'unité de programme dans la fenêtre Source de l'Interpréteur. Remarque

3	Cliquez deux fois sur une instruction exécutable dans laquelle vous voulez créer le point d'interruption. Conseil

Le point d'interruption est inséré et indiqué par B00n, où n est le numéro du point d'interruption. Lorsque vous exécutez l'unité de programme, l'exécution est interrompue à la ligne qui précède immédiatement le point d'interruption.


Définition d'un déclencheur de débogage

  Etape suivante

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

1	Si l'Interpréteur PL/SQL n'est pas encore affiché, choisissez Programme [image] Interpréteur PL/SQL.

2	Dans le Navigateur d'objet, cliquez une fois sur un noeud d'unité de programme compilée pour afficher l'unité de programme dans la fenêtre Source de l'Interpréteur. Remarque

3	Sélectionnez la ligne dans laquelle vous voulez créer le déclencheur de débogage et cliquez sur le bouton droit de la souris, puis choisissez la commande Déclencheur dans le menu déroulant. Conseil

4	Si vous voulez que le déclencheur soit activé ailleurs que dans l'unité de programme en cours, sélectionnez un emplacement dans la liste déroulante Emplacement.

5	Entrez le déclencheur de débogage dans la boîte de texte Corps du déclencheur.

6	Cliquez sur OK.


Insertion d'une fenêtre du Navigateur dans l'Interpréteur PL/SQL

  Rubriques connexes

Pour insérer une fenêtre du Navigateur d'objet dans l'Interpréteur PL/SQL :

  Démo

1	Si l'Interpréteur PL/SQL n'est pas encore affiché, choisissez Programme [image] Interpréteur PL/SQL.

2	Choisissez Affichage [image] Fenêtre Navigateur pour insérer la fenêtre du Navigateur d'objet dans l'Interpréteur PL/SQL.

Notez que la barre de boutons est mise à jour et contient les nouveaux boutons du Navigateur d'objet.

3	(En option)  Utilisez les barres de partage pour redimensionner les proportions des trois fenêtres.


Défilement du code

  Etape suivante	  Rubriques connexes

Pour faire défiler le code :

Avant de poursuivre, vous devez déjà avoir défini une action de débogage, par exemple un point d'interruption, et exécuté votre unité de programme à l'invite PL/SQL> de l'Interpréteur PL/SQL, pour interrompre l'exécution de cette unité de programme.

Pour passer à la prochaine ligne de l'unité de programme interrompue :

  Démo

  Cliquez sur [image] dans la barre d'outils de l'interpréteur pour exécuter la prochaine ligne de code exécutable de l'unité de programme en cours.

Si cette ligne est un appel à un sous-programme imbriqué, Step Into arrête l'exécution à la première ligne du sous-programme imbriqué.

Pour sauter un appel de sous-programme imbriqué dans l'unité de programme interrompue :

  Démo

  Cliquez sur [image] dans la barre d'outils de l'interpréteur PL/SQL.

Step Over exécute les appels aux sous-programmes imbriqués, puis arrête l'exécution à la prochaine ligne exécutable de l'unité de programme en cours.

Pour sortir d'un sous-programme imbriqué et revenir à l'unité de programme extérieure :

  Démo

  Cliquez sur [image] dans la barre d'outils de l'interpréteur PL/SQL.

Si vous avez précédemment utilisé Step in pour passer à un sous-programme imbriqué, Step out termine l'exécution du sous-programme imbriqué et revient à la prochaine ligne de l'unité de programme d'origine.

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

  Cliquez sur [image] dans la barre d'outils de l'interpréteur PL/SQL.

L'exécution de l'unité de programme s'achève, à moins qu'elle ne soit interrompue à nouveau par une autre action de débogage.

Notez que si votre action de débogage se trouve dans une boucle PL/SQL, l'utilisation de Go déclenche un cycle de boucle.

Pour sortir de l'exécution interrompue au niveau de débogage en cours :

  Cliquez sur [image] dans la barre d'outils de l'interpréteur PL/SQL.

Le contrôle est rendu à l'Interpréteur ou à un niveau de débogage extérieur (le cas échéant).


Consultation ou modification de variables locales

  Etape suivante

Pour consulter ou modifier les valeurs des variables locales, il faut qu'une unité de programme interrompue se trouve dans l'Interpréteur PL/SQL.

Pour consulter les valeurs des variables locales :

1	Dans le Navigateur d'objet, développez le noeud Pile pour afficher les trames de pile d'appels.

2	Sous le noeud Pile, cliquez deux fois sur le noeud de l'unité de programme dont vous voulez consulter ou modifier les variables.

Chaque variable locale est affichée avec sa valeur en cours.

Pour éditer les valeurs de variables locales :

1	Dans le Navigateur d'objet, développez le noeud Pile pour afficher les trames de pile d'appels.

2	Sous le noeud Pile, cliquez deux fois sur le noeud de l'unité de programme dont vous voulez consulter ou modifier les variables.

Chaque variable locale est affichée avec sa valeur en cours.

3	Cliquez sur la valeur de la variable dans le Navigateur d'objet.

4	Cliquez à nouveau sur la valeur de la variable pour passer en mode Edition.

5	Modifiez la valeur de la variable.

6	Cliquez dans une zone vierge du Navigateur d'objet pour sortir du mode Edition et validez la valeur modifiée.

7	Reprenez l'exécution de l'unité de programme de l'Interpréteur PL/SQL pour tester l'effet de la nouvelle valeur.


Activation ou désactivation d'une action de débogage

  Etape suivante	  Rubriques connexes

Pour désactiver une action de débogage active :

1	Dans le Navigateur d'objet, développez le noeud Actions de débogage, puis cliquez sur l'action que vous voulez désactiver.

2	Cliquez sur le bouton droit de la souris et choisissez Désactiver dans le menu instantané.

Pour activer une action de débogage désactivée :

1	Dans le Navigateur d'objet, développez le noeud Actions de débogage, puis cliquez sur l'action que vous voulez désactiver.

2	Cliquez sur le bouton droit de la souris et choisissez Activer dans le menu instantané.


Edition d'une action de débogage

Pour éditer une action de débogage :

1	Dans le Navigateur d'objet, développez le noeud Actions de débogage, puis cliquez deux fois sur l'icône de débogage pour afficher la boîte de dialogue appropriée.

2	Editez le contenu ou les propriétés de l'action de débogage dans la boîte de dialogue.

3	Cliquez sur OK.


Suppression d'une action de débogage

Pour supprimer une action de débogage :

1	Dans le Navigateur d'objet, développez le noeud Actions de débogage, puis cliquez sur l'action que vous voulez supprimer.

2	Cliquez sur [image] dans la barre d'outils.


Instruction SELECT - Exemple : première interrogation d'un état de style groupe-niveau supérieur d'interrogation multiple

  Rubriques connexes 	  Tous les exemples

Exemple d'instruction SELECT pour la première interrogation d'un état de style groupe-niveau supérieur d'interrogation multiple :

SELECT ENAME, EMPNO FROM EMP WHERE JOB = 'VENDEUR'


Instruction SELECT - Exemple : seconde interrogation d'un état de style groupe-niveau supérieur d'interrogation multiple

  Rubriques connexes 	  Tous les exemples

Exemple d'instruction SELECT pour la seconde interrogation d'un état de style groupe-niveau supérieur d'interrogation multiple :

SELECT REPID, PRODNAME, AMOUNT, CUSTNAME FROM SALES ORDER BY REPID, CUSTNAME


Instruction SELECT - Exemple : matrice imbriquée

  Rubriques connexes 	  Tous les exemples

Exemple d'instruction SELECT pour un état de style matriciel imbriqué :

SELECT TO_CHAR(HIREDATE,'YY') YEAR, DEPTNO, JOB, SUM(SAL) FROM EMP GROUP BY TO_CHAR(HIREDATE,'YY'), DEPTNO, JOB ORDER BY TO_CHAR(HIREDATE,'YY'), NODEPT, JOB


Destination hyperlien (statique) - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Destination hyperlien permettant d'identifier un objet "lien1" :

LIEN1


Destination hyperlien (dynamique) - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple de valeur pour la propriété Destination hyperlien, permettant de créer dynamiquement un identificateur :

'DEPT_DETAILS_' || LTRIM(TO_CHAR(:DEPTNO))

où :DEPTNO est une valeur de colonne extraite de la base de données lors de l'exécution.


Hyperlien (statique) - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Hyperlien, permettant d'indiquer un lien à une destination identifiée comme "lien1" :

#LIEN1


Hyperlien (dynamique) - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple de valeur pour la propriété Hyperlien, permettant d'indiquer un lien à une destination identifiée de manière dynamique :

'DEPT_DETAILS_' || LTRIM(TO_CHAR(:DEPTNO))

où :DEPTNO est une valeur de colonne extraite de la base de données lors de l'exécution.


Hyperlien - Exemple : hyperlien à un document HTML sur un serveur distant

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Hyperlien, permettant d'indiquer un lien à un document HTML sur un serveur Web distant :

HTTP://WWW.NETMACH.COM/MYDOC.HTM


Hyperlien - Exemple : hyperlien à un script sur un serveur distant

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Hyperlien, permettant d'indiquer un lien à un script sur un serveur Web distant (peut retourner un document PDF ou HTML) :

HTTP://WWW.NETMACH.COM/CGI-BIN/DOCSTUFF?PARAM1+PARAM2+PARAM3


Ligne de commande d'application - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Ligne de commande d'application, permettant d'ajouter un lien à un objet qui exécute la commande indiquée lorsque l'utilisateur clique sur le lien dans l'état mis en forme :

C:\ORAWIN95\BIN\RWRUN60.EXE USERID=SCOTT/TIGER REPORT=EXAMPLE.RDF


Signet - Exemple : chaîne de signets statique

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Signet, permettant de créer une chaîne de signet "Récapitulatif des dépenses"

RECAPITULATIF DES DEPENSES


Signet - Exemple : liste de signets dynamique

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Signet, permettant de créer dynamiquement une chaîne de signet :

:CATEGORY || ' DEPENSES'

où :CATEGORY est une valeur de colonne extraite de la base de données lors de l'exécution.


Signet - Exemple : liste de signets classés

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Signet, permettant de classer explicitement la liste des signets, par exemple, pour classer dans la liste de signets un élément qui doit être le premier de la liste :  Remarque

1#EXPENSE SUMMARY


Signet - Exemple : liste de signets classés, en retrait

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Signet, permettant de classer et d'indenter explicitement la liste des signets, par exemple, pour indenter une entrée de signet sous le premier élément de la liste des signets : Remarque

'1.1#':CATEGORY || ' DEPENSES'


Valeur Avant état - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Valeur Avant état, permettant d'inclure dans la page d'en-tête un fichier HTML contenant un logo de société.

LOGO.HTM

Vous devez définir la propriété Type Avant état sur Fichier avant de définir Valeur Avant état.


Valeur Après état - Exemple : ajout de texte

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Valeur Après état, permettant d'ajouter un texte au document HTML :

<ADDRESS>

QUESTIONS? -

<A HREF=MAILTO:WEBMASTER@XYZTECH.COM>WEBMASTER@XYZTECH.COM</A>

</ADDRESS>

</BODY>

</HTML>


Valeur Après état - Exemple : liens aux pages initiales

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Valeur Après état, permettant d'insérer deux liens aux pages initiales (home) à la fin de la sortie de l'état.

<CENTER>

<A HREF="HTTP://WWW.ORACLE.COM/">ORACLE CORPORATION</A> -

<A HREF="HTTP://HOME.NETSCAPE.COM/">NETSCAPE</A>

</CENTER>

</BODY>

</HTML>'


Valeur Avant page - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple de valeur des propriétés Valeur Avant page et Valeur Après page, permettant de centrer le document dans l'explorateur :

Valeur Avant page:  <CENTER>

Valeur Après page:  </CENTER>


Valeur Après page - Exemple : insertion d'un fichier GIF

  Rubriques connexes 	  Tous les exemples

Exemple d'une valeur de la propriété Valeur Après page permettant d'insérer un fichier GIF comme séparateur de pages :

<CENTER><IMG ALT="RULER" SRC="LINE.GIF" VSPACE=10><BR></CENTER>


Valeur Avant formulaire - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Avant formulaire permettant d'insérer un fichier HTML qui contient le logo d'une société, dans la partie supérieure de la grille des paramètres HTML :

LOGO.HTM


Valeur Après formulaire - Exemple : ajout de texte

  Rubriques connexes 	  Tous les exemples

Exemple de valeur de la propriété Après formulaire permettant d'ajouter du texte à la partie inférieure de la grille des paramètres HTML :

<B><FONT FACE="Arial, Helvetica"><FONT COLOR="#FF0000">

Cliquez sur <IMG SRC=»RUN.GIF» HEIGHT=18 WIDTH=18> pour exécuter l'état en utilisant les paramètres définis ci-dessus.

</FONT></FONT></B>


Déclencheur de format - Exemple : insertion d'espaces entre des groupes de lignes

  Rubriques connexes 	  Tous les exemples

Exemple de déclencheur de format qui insère des espaces entre des groupes de lignes (affiche un rectangle standard lorsque le nombre de lignes divisé par la valeur de SPACE ne laisse pas de reste).

FUNCTION SPACING RETURN BOOLEAN IS
BEGIN
  IF :CountENAMEPerReport MOD :SPACE = 0 THEN
    RETURN (TRUE);
  ELSE RETURN (FALSE);
  END IF;
END;


Messagerie MAPI (Windows) en mode de traitement par lots - Exemple : destinataires identifiés par leur prénom et leur nom

  Rubriques connexes 	  Tous les exemples

Voici un exemple d'indication de destinataires de courrier électronique par leurs nom et prénom pour l'envoi d'un état en mode par lots : Remarque

RWRUN60 monthly.rdf USERID=scott/tiger DESTYPE=mail DESNAME="John Robertson,Mary Johnson,Anne" BATCH=yes


Messagerie MAPI (Windows) en mode de traitement par lots - Exemple : destinataires dont le nom comprend une apostrophe

  Rubriques connexes 	  Tous les exemples

Voici un exemple d'indication d'un destinataire de courrier électronique dont le nom contient une apostrophe (O'Hara) pour l'envoi d'un état en mode par lots :  Remarque

RWRUN60 monthly.rdf USERID=scott/tiger DESTYPE=mail DESNAME="John,Tim O''Hara,Mary Johnson,Anne" BATCH=yes


MAPI (Windows) Exemple de courrier électronique : destinataires par nom et prénom
Messagerie MAPI (Windows) - Exemple : destinataires identifiés par leur prénom et leur nom

  Rubriques connexes 	  Tous les exemples

Voici un exemple d'indication de destinataires de courrier électronique par leurs nom et prénom :  Remarque

"John Robertson,Steve Johnson,Paul"


MAPI (Windows) Exemple de courrier électronique:  recipient with apostrophe in name
Messagerie MAPI (Windows) - Exemple : destinataires dont le nom comprend une apostrophe

  Rubriques connexes 	  Tous les exemples

Voici un exemple d'indication d'un destinataire de courrier électronique dont le nom contient une apostrophe (O'Hara) :  Remarque

"John,Tim O''Hara,Steve Johnson,Paul"


Oracle*Mail (UNIX) Exemple de courrier électronique : destinataire dont le nom contient une apostrophe
Messagerie Oracle*Mail (UNIX) - Exemple : plusieurs destinataires

  Rubriques connexes 	  Tous les exemples

Voici un exemple d'indication de plusieurs destinataires de courrier électronique :  Remarque

(JROBERTS, SJOHNSON, PHARVEY)


URL - Exemples : lien à une image

  Rubriques connexes 	  Tous les exemples

Exemples d'indication d'URL pour des images :

1	HTTP://www.oracle.com/images/logo.gif

2	HTTP://&<P_SERVER_NAME>/images/logo.gif

où P_SERVER_NAME est un paramètre utilisateur de type CHAR.

A l'exécution, l'utilisateur final peut indiquer une valeur pour le paramètres (par exemple, P_SERVER_NAME = www.oracle.us.com pour un lien URL dynamique de HTTP://www.oracle.us.com/images/logo.gif).

3	FILE://c:/images/logo.gif

Remarque : Si vous cliquez sur Parcourir pour retrouver un fichier, Report Builder ajoute automatiquement FILE:// au début du chemin retourné.


Curseur de référence - Exemple

  Rubriques connexes 	  Tous les exemples

empCur rcPackage.empCurType;

BEGIN
  OPEN empCur FOR SELECT * FROM emp;
  RETURN empCur;
END;

/* Remarque : rcPackage est une unité de programme locale définie comme suit :*/

PACKAGE rcPackage IS
  TYPE empCurType IS REF CURSOR RETURN emp%ROWTYPE;
END;


Attributs d'hyperlien supplémentaire - Exemple

  Rubriques connexes 	  Tous les exemples

Exemple 1

Pour indiquer la grille HTML à remplacer par la destination de l'hyperlien, ajoutez-la au paramètre Attributs d'hyperlien supplémentaire :

TARGET=<nom de la grille à remplacer>.

Vous pouvez également cliquer sur l'objet pour remplacer par défaut cette grille par l'intégralité de la fenêtre de la destination de l'hyperlien.

Exemple 2

Pour créer une ligne d'état d'informations au bas du navigateur Web, lorsque le pointeur de la souris est positionné sur un objet représentant un panier, le paramètre Attributs d'hyperlien supplémentaire contient la commande HTML suivante :

onMouseover "window.status='Cliquez ici pour connaître le contenu de votre panier';return true" onMouseout ="window.status=' ';return true"

Résultat : Le message « Cliquez ici pour connaître le contenu de votre panier » apparaît au bas du navigateur Web lorsque le pointeur de la souris est positionné sur un objet représentant un panier.

Vous pouvez également paramétrer la valeur Attributs d'hyperlien supplémentaire pour appeler des fonctions JavaScript, qui exécutent l'opération souhaitée, telle que le changement de la couleur d'un objet sur lequel le pointeur est placé :

onMouseover="fSwitch(2, 1)" onMouseout ="fSwitch(2, 0)" onClick=»fSelect(2)»

Remarque : Pour utiliser ces fonctions d'appel JavaScript, modifiez la valeur d'échappement Avant état afin d'ajouter un code similaire au suivant :

<!--  //masquage dans les anciens navigateurs

// iCurrentSelect correspond à l'option
// de menu sélectionnée, qui sert d'index à l'option
// figurant dans le tableau de
// noms d'image de base
var iCurrentSelect = -1

// le tableau BaseImgName contient le nom
// d'image de base de chaque option du document.
// Si vous en ajoutez, le 'nom' de
// l'image et le fichier gif doivent correspondre
// à la valeur ajoutée au tableau

aBaseImgName = new Array(9)
aBaseImgName[0] = "nw"
aBaseImgName[1] = "db"
aBaseImgName[2] = "tl"
aBaseImgName[3] = "ap"
aBaseImgName[4] = "dw"
aBaseImgName[5] = "ol"
aBaseImgName[6] = "it"
aBaseImgName[7] = "ot"
aBaseImgName[8] = "mo"

// créez les tableaux d'images de chaque
// option de menu

aChoice0 = new Array(2)
aChoice1 = new Array(2)
aChoice2 = new Array(2)
aChoice3 = new Array(2)
aChoice4 = new Array(2)
aChoice5 = new Array(2)
aChoice6 = new Array(2)
aChoice7 = new Array(2)
aChoice8 = new Array(2)

// préchargez les images dans les tableaux d'images

for (var i = 0 ; i < aBaseImgName .length; i++) {
  eval("aChoice" + i)[0] = new Image(150,27)
  eval("aChoice" + i)[0].src = "roll_images/" + aBaseImgName[i] + "_off.gif"
  eval("aChoice" + i)[1] = new Image(150,27)
  eval("aChoice" + i)[1].src = "roll_images/" + aBaseImgName[i] + "_on.gif"
}

function fSwitch(choiceNum, state) {
  // choiceNum = index de tableau du
  // nom d'image de base remplacé
  // - nw=0, db=1 ....
  // state = index de tableau d'images à
  // utiliser - 0=off, 1=on,
  // (2=sel non mise en oeuvre)
  if (iCurrentSelect != choiceNum) {
  // ne basculez pas la sélection actuelle
    eval("document." + aBaseImgName[choiceNum]).src = eval("aChoice" + choiceNum)[state].src
  }

  return true
}

function fSelect(choiceNum) {
  // si une sélection existe déjà,
  // effacez-la (state 0)
  if (iCurrentSelect > -1) {
    eval("document." + aBaseImgName[iCurrentSelect]).src = eval("aChoice" + iCurrentSelect)[0].src
  }

  // état d'image 1 peut être
  // transmis comme variable
  eval("document." + aBaseImgName[choiceNum]).src = eval("aChoice" + choiceNum)[1].src
  // stockez la nouvelle sélection
  iCurrentSelect = choiceNum

  return true;
}

// fin du masquage -->


Hyperlien graphique - Exemple

Supposez que vous générez un état indiquant le salaire de chaque employé. Vous pouvez créer un graphique pour afficher les mêmes données. Dans la page des hyperliens graphiques de l'Assistant Web, déplacez un graphique de la liste des graphiques disponibles vers la liste Graphiques. Cliquez sur Terminer, puis cliquez deux fois, dans la vue Modèle de présentation, sur l'objet graphique à afficher dans la Palette de propriétés. Dans la propriété Hyperlien graphique, vous devez voir apparaître la commande suivante :

#chart_name&sumsal

chart_name fait référence au nom du graphique et sumsal, à la colonne récapitulative de l'état. Notez que ces deux valeurs sont différentes selon le type d'interrogation utilisé.

Dans la sortie d'état, l'utilisateur Runtime peut cliquer sur une section du graphique pour accéder à la ligne de données correspondante. Dans ce graphique, vous pouvez afficher le poste occupé par Monsieur Miller, ainsi que son nom et son salaire.


Grille de paramètres HTML (entrée par défaut en majuscules) - Exemple

  Rubriques connexes 	  Tous les exemples

L'exemple suivant indique que les valeurs d'entrée de données sont par défaut en majuscules lorsqu'elles sont saisies dans un champ de la grille de paramètres. Dans l'Editeur de grille de paramètres, créez un champ de grille de paramètres appelé PF_DESFORMAT, dont la source est DESFORMAT. Dans la Palette de propriétés, sous Paramètres Web, définissez la propriété Attributs supplémentaires (HTML) de la manière suivante :

onChange="this.value=this.value.toUpperCase()"

Si un utilisateur final indique « pdf » comme format de destination, la valeur passera en majuscules (« PDF ») dans la grille de paramètres Runtime lorsque vous exécuterez l'état via le Web.


Grille de paramètres HTML (validation des entrées de données) - Exemple

  Rubriques connexes 	  Tous les exemples

L'exemple suivant montre comment définir les champs de la grille de paramètres pour la validation des entrées lorsque l'état est exécuté via le Web. Cette opération entraîne l'émission d'un message lorsque l'utilisateur final entre des données non valides dans un champ de la grille de paramètres.

Dans l'Editeur de grille de paramètres, créez un champ de grille de paramètres appelé PF_DEPTNO et ouvrez la Palette de propriétés. Sous Champ Grille de paramètres, définissez la propriété Source sur DEPTNO. Sous Paramètres Web, définissez la propriété Attributs supplémentaires (HTML) sur le gestionnaire d'événements JavaScript suivant :

onChange="checkIt(this.form)"

Dans le Navigateur d'objet, cliquez sur [image] (icône des propriétés de l'état) et ouvrez la Palette de propriétés. Sous Echappements d'état, définissez l'option Type Avant formulaire sur Texte et insérez le code JavaScript suivant dans la propriété Valeur Avant formulaire :

<SCRIPT LANGUAGE = "JavaScript">

function isNumber(inputStr){

   for (var i = 0; i < inputStr.length; i++) {

var oneChar = inputStr.charAt(i)

if (oneChar < "0" || oneChar > "9") {

alert("Entrez une valeur numérique.")

return false

             }

     }

    return true

}

function checkIt(form) {

inputStr = form.DEPTNO.value

if (isNumber(inputStr)) {

// instruction si la valeur est Vrai

} else {

form.numeric.focus()

form.numeric.select()

}

}

</SCRIPT>

Au moment de l'exécution de l'état via le Web, si l'utilisateur final entre le nom du service dans la grille de paramètres Runtime au lieu du numéro de service, le message suivant apparaît :

Entrez une valeur numérique.


Grille de paramètres HTML (validation des sélections) - Exemple

  Rubriques connexes 	  Tous les exemples

L'exemple suivant montre comment définir les champs de la grille de paramètres pour la validation des sélections lorsque l'état est exécuté via le Web. Cette opération entraîne l'émission d'un message lorsque l'utilisateur final sélectionne Imprimante dans la liste des valeurs DESTYPE de la grille de paramètres Runtime.

Dans l'Editeur de grille de paramètres, créez un champ de grille de paramètres appelé PF_ DESTYPE et ouvrez la Palette de propriétés. Sous Champ Grille de paramètres, définissez la propriété Source sur DESTYPE. Sous Paramètres Web, définissez la propriété Attributs supplémentaires (HTML) sur le gestionnaire d'événements JavaScript suivant :

onChange="isPrinter(this.form)"

Dans le Navigateur d'objet, cliquez sur [image] (icône des propriétés de l'état) et ouvrez la Palette de propriétés. Sous Echappements d'état, définissez l'option Type Avant formulaire sur Texte et insérez le code JavaScript suivant dans la propriété Valeur Avant formulaire :

<SCRIPT LANGUAGE = "JavaScript">

function isPrinter(form) {

  if( form.DESTYPE.options[form.DESTYPE.selectedIndex].value == 'Imprimante')

    alert("Vérifiez que votre imprimante est installée et fonctionne.")

    return true}

   }

</SCRIPT>

Au moment de l'exécution, si l'utilisateur final sélectionne Imprimante dans la liste des valeurs du champ DESTYPE, le message suivant apparaît :

Vérifiez que votre imprimante est installée et fonctionne.


Génération d'une sortie utilisateur

  Rubriques connexes

Pour générer une sortie utilisateur :

1	Créez votre état sans sortie utilisateur.

2	Choisissez les sorties utilisateur dont vous avez besoin.

3	Ecrivez la sortie utilisateur en utilisant l'un des langages de programmation hôte.

4	Mettez en oeuvre la sortie utilisateur en modifiant le fichier exemple source ou en créant votre propre fichier source.

5	Créez l'objet Report Builder et l'appel à la sortie utilisateur (suivis des arguments que vous voulez transmettre).


Génération d'un appel de procédure

  Rubriques connexes

Pour produire un programme contenant un appel de procédure :

1	Ecrivez un programme en utilisant l'un des langages hôte d'interface de programmation ORACLE (Ada, C, COBOL, FORTRAN, Pascal ou PL/l). Entrez dans votre programme un ou plusieurs appels de procédure.

2	Compilez votre programme. Cette opération crée un fichier objet.

3	Chaque appel de procédure Report Builder a été écrit en C. Ces programmes C ont été compilés, et les fichiers objet résultants expédiés avec Report Builder. Liez votre programme au(x) fichier(s) objet Report Builder auxquels il est fait référence.


Modification d'une interrogation

  Rubriques connexes	  Etape suivante

Pour modifier une instruction d'interrogation SQL ou les colonnes affichées dans votre état :

1	Dans la vue Modèle de données, cliquez sur l'interrogation, puis choisissez Outils [image] Assistant Données.

•	Pour modifier l'instruction SELECT, cliquez sur l'onglet Données.

•	Pour modifier les groupes de ventilation, cliquez sur l'onglet Groupes.

•	Pour ajouter ou modifier les colonnes récapitulatives des totaux, cliquez sur l'onglet Totaux.

2	Pour sélectionner d'autres colonnes de la base de données à afficher dans votre état, choisissez Outils [image] Assistant Report, puis cliquez sur l'onglet Champs.

Pour modifier les propriétés d'une interrogation :

1	Dans la vue Modèle de données, cliquez sur l'interrogation, puis choisissez Outils [image] Palette de propriétés.

2	Dans la palette de propriétés, modifiez les propriétés comme vous le souhaitez.


Edition de texte

  Rubriques connexes

Pour insérer et remplacer du texte :

1	Dans la vue Aperçu interactif, cliquez sur l'objet de texte.  Remarque

2	Cliquez sur le texte pour passer en mode Edition.

3	Modifiez le texte, puis cliquez en dehors de l'objet de texte.

Pour supprimer du texte :

1	Dans la vue Aperçu interactif, cliquez sur l'objet de texte.  Remarque

2	Pour couper tout le texte, choisissez Editer [image] Effacer.

3	Pour couper certaines parties de texte, cliquez et faites glisser pour délimiter le texte que vous voulez couper, puis appuyez sur Supprimer.

Pour couper, copier ou coller du texte :

1	Dans la vue Modèle de présentation, cliquez sur l'objet de texte.  Remarque

2	Cliquez et faites glisser pour délimiter le texte que vous voulez couper ou copier.

3	Choisissez Edition [image] Couper ou Editer [image] Copier.

4	Pour coller le texte, choisissez Edition [image] Coller.


Modification d'attributs de texte

  Rubriques connexes

Pour modifier la police, la justification, l'espacement ou le sens de lecture du texte :

1	Dans la vue Aperçu interactif, cliquez sur le(s) objet(s) de texte.  Conseil  Remarque

2	Dans le menu Format, choisissez Police, Justification, Interlignage ou Orientation.


Renvoi à la ligne de texte d'un champ

  Rubriques connexes

Pour faire passer à la ligne le texte d'un champ :

1	Choisissez Outils [image] Assistant Report.

2	Dans l'assistant Report, cliquez sur l'onglet Libellés.

3	Modifiez comme vous le souhaitez la valeur de la colonne Largeur du champ dans lequel vous voulez que le texte passe à la ligne.

4	Cliquez sur Appliquer.

5	Dans la vue Modèle de présentation, cliquez deux fois sur le champ.  Remarque

6	Dans la Palette de propriétés, sous le noeud Présentation générale, assurez-vous que la propriété Elasticité verticale est définie à Développer


Modification d'attributs de bordure d'objet

  Rubriques connexes

Pour modifier les bordures autour d'un objet :

1	Dans la vue Aperçu interactif, cliquez sur le ou les objets. Conseil  Remarque.

2	Pour modifier la largeur du trait, choisissez Format [image] Largeur de trait.

3	Pour sélectionner un motif, choisissez Format [image] Tiret. Même s'il apparaît dans la sortie, le motif de tiret est parfois masqué par le contour de l'objet. Vous pouvez choisir Format [image] Options de présentation [image] Modèle de présentation et désactiver Options : contours encadrement.

4	Pour "encadrer" la bordure, choisissez [image] Relief.


Affichage ou masquage de bordures d'objet

  Rubriques connexes

Pour afficher ou masquer les bordures d'un objet :

1	Dans la vue Aperçu interactif, cliquez sur le ou les objets. Conseil  Remarque.

2	Cliquez sur [image] (l'outil de couleur de ligne) dans la palette d'outils.

3	Pour ajouter une bordure, cliquez sur le carré noir.

4	Pour supprimer une bordure, cliquez sur Pas de ligne, au bas de la palette de couleurs.  Conseil

5	Pour afficher ou masquer une partie de la bordure, sélectionnez Format [image] Bordure, puis, à partir du menu, faites votre choix entre afficher ou masquer les bordures.


Changement de couleurs via l'interface utilisateur
Changement de couleurs

  Rubriques connexes

Pour changer la couleur d'un objet :

1	Dans la vue Aperçu interactif, cliquez sur le(s) objet(s).  Conseil  Remarque

2	Cliquez sur [image] (l'outil de couleur de remplissage), [image] (l'outil de couleur de ligne) ou [image] (l'outil de couleur de texte) dans la palette d'outils, en fonction de la partie de l'objet à laquelle vous voulez appliquer une couleur.

3	Dans la palette de couleurs, cliquez sur une couleur.


Changement de motifs

  Rubriques connexes

Pour changer le motif d'un objet :

1	Dans la vue Aperçu interactif, cliquez sur le(s) objet(s).  Conseil  Remarque

2	Cliquez sur [image] (l'outil de couleur de remplissage) ou [image] (l'outil de couleur de ligne) dans la palette d'outils, en fonction de la partie de l'objet à laquelle vous voulez appliquer un motif.

3	Dans la palette de couleurs, cliquez sur Motifs.

4	Dans la palette de motifs, cliquez sur un motif. Pour changer les couleurs de premier plan et d'arrière-plan, choisissez la palette de couleurs déroulante, au bas de la palette de motifs.

5	Cliquez deux fois sur l'icône Menu système pour fermer la palette de motifs.


Application d'un masque de format à un objet numérique

  Rubriques connexes

Pour appliquer un masque de format à un objet numérique :

1	Dans la vue Aperçu interactif, cliquez sur les objets. Conseil.

2	Pour appliquer le format monétaire à l'objet, cliquez sur [image] dans la barre d'outils.

3	Pour appliquer le format de pourcentage à l'objet, cliquez sur [image] dans la barre d'outils.

4	Pour ajouter des virgules à la valeur de l'objet, cliquez sur [image] dans la barre d'outils. Pour déplacer la virgule vers la droite ou vers la gauche, cliquez sur [image] ou [image].

5	Choisissez Outils [image] Palette de propriétés.  Conseil

6	Sous le noeud Champ, assurez-vous que la propriété Masque de format est définie au format voulu.

7	Définissez d'autres propriétés, le cas échéant..


Application d'un masque de format à un objet date

  Rubriques connexes

Pour appliquer un masque de format à un objet date :

1	Dans la vue Aperçu interactif, cliquez sur les objets. Conseil.

2	Choisissez Outils [image] Palette de propriétés.  Conseil

3	Sous le noeud Champ, définissez la propriété Masque de format au format de date voulu.

4	Définissez d'autres propriétés, le cas échéant..


Déplacement de plusieurs objets

  Rubriques connexes

Pour déplacer plusieurs objets :

1	Cliquez sur les objets que vous voulez déplacer, ou faites glisser une boîte autour de ces objets.  Conseil

2	Utilisez les touches de déplacement du curseur de votre clavier pour déplacer les objets.


Extraction d'un objet de son père

  Rubriques connexes

Pour extraire un objet fils de l'objet père qui l'entoure :

  Démo

1	Dans la vue Modèle de présentation, assurez-vous que le mode Confiné est désactivé (le bouton de la barre d'outils s'affiche sous la forme [image]).

2	Cliquez et faites glisser le(s) objet(s) fils.  Conseil


Ajustement automatique des bordures de l'objet père

  Rubriques connexes

Pour ajuster les bordures des objets père lorsque vous déplacez les objets fils :

  Démo

1	Dans la vue Aperçu interactif, assurez-vous que le mode Flexible est activé (le bouton de la barre d'outils s'affiche sous la forme [image]).  Remarque

2	Cliquez et faites glisser le(s) objet(s) fils.  Conseil

3	Pour déplacer horizontalement ou verticalement un objet aligné avec un autre (par exemple, un champ et son libellé), maintenez la touche Ctrl enfoncée et faites glisser le premier objet. Pour déplacer les deux objets simultanément, n'utilisez pas la touche Ctrl.


Déplacement d'une colonne dans une sortie d'état

  Rubriques connexes

Pour déplacer une colonne dans une sortie d'état :

1	Dans la vue Aperçu interactif, cliquez sur la colonne.  Remarque

2	Assurez-vous que le mode Flexible est activé (le bouton de la barre d'outils s'affiche sous la forme [image]).

3	Faites glisser la colonne à l'emplacement voulu.


Alignement d'objets

  Rubriques connexes

Pour aligner des objets :

1	Dans la vue Modèle de présentation ou dans la vue Grille de paramètres, cliquez sur les objets que vous voulez aligner.  Conseil

2	Choisissez Réorganisation [image] Aligner objets.

3	Dans la boîte de dialogue, indiquez l'alignement de votre choix.

4	Cliquez sur OK.

Pour appliquer l'alignement en cours à d'autres objets :

1	Dans la vue Modèle de présentation ou dans la vue Grille de paramètres, cliquez sur les objets que vous voulez aligner.  Conseil

2	Choisissez Réorganisation [image] Répéter alignement.


Déplacement d'un point d'ancrage

  Rubriques connexes

Pour déplacer un point d'ancrage :

1	Dans la vue Modèle de présentation, cliquez sur le point d'ancrage.

2	Cliquez sur [image] dans la palette d'outils, puis faites glisser l'une des extrémités du point d'ancrage à son nouvel emplacement sur le bord de l'objet.

Pour déplacer un point d'ancrage le long du bord d'un objet par incréments de 25 % :

  Appuyez sur la touche de contrainte (par exemple, la touche Majuscules) lorsque vous déplacez le point d'ancrage..


Modification de l'ordre d'empilage des objets

  Rubriques connexes

Pour modifier l'ordre d'empilage des objets :

1	Dans la vue Modèle de présentation, assurez-vous que le mode Confiné est désactivé (le bouton de la barre d'outils s'affiche sous la forme [image]).

2	Cliquez sur l'objet que vous voulez déplacer.  Remarque

3	Dans le menu Réorganisation, choisissez l'une des options suivantes :

•	Passer au premier plan pour faire passer l'objet devant tous les autres.

•	Passer en arrière-plan pour faire passer l'objet derrière tous les autres.

•	Déplacement avant pour faire passer l'objet devant celui est immédiatement au-dessus de lui.

•	Déplacement arrière pour faire passer l'objet derrière celui qui est immédiatement sous lui.


Rotation d'un objet standard

  Rubriques connexes

Pour faire pivoter un objet standard :

1	Dans la vue Modèle de présentation ou la vue Grille de paramètres, cliquez sur le(s) objet(s), ou le ou les groupes que vous voulez faire pivoter.  Conseil

2	Cliquez sur [image] dans la palette d'outils.

3	Faites glisser une poignée pour faire pivoter l'objet ou le groupe.


Redimensionnement d'un objet

  Rubriques connexes

Pour redimensionner un ou plusieurs objets : Remarque

1	Cliquez sur le(s) objet(s). Conseil

2	Définissez la taille :

•	Pour un objet de taille fixe, faites glisser la poignée de l'un des objets sélectionnés. Tous les objets sélectionnés changeront de taille.

•	Ou, choisissez Outils [image] Palette de propriétés.  Dans la Palette de propriétés commune, sous le noeud Présentation générale, définissez les propriétés Elasticité verticale et Elasticité horizontale à Contracter, Développer, Fixe ou Variable.


Redimensionnement de plusieurs objets

  Rubriques connexes

Pour appliquer la même taille à plusieurs objets :

1	Dans la vue Modèle de présentation ou la vue Grille de paramètres, cliquez sur les objets que vous voulez redimensionner.  Conseil

2	Choisissez Réorganisation [image] Dimensionner objets.

3	Dans la boîte de dialogue, indiquez les paramètres de votre choix. Cliquez sur OK.

Pour répéter une option Réorganisation [image] Dimensionner objets :

1	Dans la vue Modèle de présentation ou la vue Grille de paramètres, cliquez sur les objets que vous voulez redimensionner.  Conseil

2	Choisissez Réorganisation [image] Répéter élasticité.


Ajustement des marges

  Rubriques connexes

Pour ajuster des marges :

1	Dans la vue Modèle de présentation, cliquez sur [image] dans la barre d'outils.  Remarque

2	Cliquez sur la bordure de la marge, puis faites glisser une poignée jusqu'à l'endroit voulu. Vous pouvez ajuster la marge des quatre côtés d'un état.

3	Cliquez sur [image] dans la barre d'outils, pour réactiver le corps de l'état.


Modification de libellés ou de largeurs de colonne

  Rubriques connexes

Pour modifier le libellé ou la largeur des colonnes :

1	Choisissez Outils [image] Assistant Report.

2	Dans l'assistant Report, cliquez sur l'onglet Libellés.

3	Modifiez les valeurs des colonnes Libellés et Largeur, le cas échéant.

4	Cliquez sur Appliquer.


Modification de l'espacement dans un champ

  Rubriques connexes

Pour modifier l'espacement dans un champ :

1	Dans la vue Aperçu interactif, cliquez sur le(s) champ(s).  Conseil  Remarque

2	Choisissez Format [image] Espacement texte et sélectionner l'espacement voulu.


Modification de l'intervalle de la présentation par défaut

  Rubriques connexes

Pour modifier l'intervalle de la présentation par défaut :

1	Choisissez Outils [image] Préférences pour afficher la fenêtre de propriétés.

2	Cliquez sur l'onglet Assistants.

3	Pour augmenter l'espace entre les objets et les objets qu'ils entourent, entrez des valeurs supérieures pour Intervalle horizontal et Intervalle vertical.

4	Pour augmenter l'espace entre les champs, entrez des valeurs supérieures dans Interchamp horizontal et Interchamp vertical.

5	Cliquez sur OK.


Modification de l'interlignage

  Rubriques connexes

Pour modifier l'interlignage à l'aide de l'Aperçu interactif :

1	Dans la vue Aperçu interactif, cliquez sur le deuxième enregistrement.

2	Faites glisser le deuxième enregistrement vers le bas pour créer l'espace souhaité entre toutes les lignes de l'état en sortie.

Pour modifier l'interlignage à l'aide de la Palette de propriétés :

1	Dans la vue Aperçu interactif, cliquez sur un champ du corps de l'état. Remarque

2	Cliquez sur [image] (Sélection d'encadrement père) dans la barre d'outils.

3	Choisissez Outils [image] Palette de propriétés.  Conseil

4	Sous le noeud Encadrement itératif, définissez la propriété Espace vert. entre encadrements (pouces) à la valeur de l'espace à laisser entre les lignes de l'état en sortie (par exemple, 0,25).


Ajout de lignes vierges entre des groupes de lignes

{ [image]  Rubriques connexes	  Exemples

Pour ajouter des lignes vierges entre des groupes :

1	Créez une colonne récapitulative.  Dans la page Totaux de l'assistant Données (ou de l'assistant Report), sélectionnez un champ qui apparaît dans chaque ligne de la sortie, et Nombre comme calcul. Dans la page Champs, supprimez le récapitulatif de la colonne des champs affichés.

2	Créez un paramètre utilisateur appelé ESPACE. Dans la Palette de propriétés,sous le noeud Paramètre, définissez la propriété Type de données à Number et la propriété Valeur initiale au nombre d'enregistrements prévus pour chaque groupe (par exemple, 5).

3	Dans la vue Modèle de présentation, assurez-vous que le mode Flexible est activé et le mode Confiné désactivé (les boutons de la barre d'outils s'affichent sous la forme [image] et [image]).

4	Cliquez sur l'encadrement itératif de l'enregistrement, puis faites glisser la poignée sur le bas de l'encadrement pour créer un espace légèrement plus important que celui que vous voulez ajouter entre les groupes de lignes de l'état en sortie.

5	Choisissez Outils [image] Palette de propriétés pour afficher la Palette de propriétés de l'encadrement itératif.

6	Sous le noeud Présentation générale, définissez la propriété Elasticité verticale à Variable.

7	Cliquez sur [image] dans la palette d'outils.

8	Dessinez un rectangle dans l'espace qui se trouve sous l'enregistrement.

9	Cliquez deux fois sur l'objet rectangle.

10	Dans la Palette de propriétés, sous le noeud Présentation avancée, cliquez deux fois dans le champ Valeur de propriété Déclencheur de format.

11	Dans l'Editeur PL/SQL définissez le PL/SQL du déclencheur de format.  Exemple

12	Masquez la bordure de l'objet rectangle.


Ajout d'un saut de page

  Rubriques connexes

Pour ajouter un saut de page

1	Dans la vue Aperçu interactif, cliquez sur un champ qui fait partie de l'image dans laquelle vous voulez insérer un saut de page. Remarque

2	Cliquez sur [image] (Sélection d'encadrement père) dans la barre d'outils.

3	Choisissez Outils [image] Palette de propriétés.  Conseil

4	Pour définir un saut de page

•	avant ou après l'encadrement sélectionné : sous le noeud Présentation générale, définissez la propriété Saut pge avant ou Saut pge après à Oui.

•	après un certain nombre de lignes sur chaque page : sous le noeud Encadrement itératif, définissez la propriété Nbre max d'enregistrements par page au nombre minimum de lignes de chaque page.

5	Pour afficher des icônes indiquant l'endroit où sont définis les sauts de page, choisissez Affichage [image] Sauts de page dans la vue Modèle de présentation (l'icône [image] indique que le saut de page va être placé avant, tandis que l'icône [image] indique le contraire).

Remarque : Report Builder ne permet pas de placer un saut de page sur une ligne précise de l'état.


Ancrage d'objets

  Rubriques connexes

Pour ancrer des objets :  Remarque

1	Dans la vue Modèle de présentation, cliquez sur [image] dans la palette d'outils.

2	Cliquez sur un bord de l'objet fils et cliquez deux fois sur un bord de l'objet père.

L'objet fils est relié à l'objet père par une ligne. Un petit carré apparaît à l'extrémité de la ligne attachée à l'objet père.


Application d'une mise en forme conditionnelle à un objet

  Rubriques connexes

Pour appliquer une mise en forme conditionnelle à un objet de présentation :

1	Cliquez sur l'objet, puis choisissez Format [image] Formatage conditionnel. Conseil

2	Dans la boîte de dialogue Formatage conditionnel, cliquez sur Nouveau pour afficher la boîte de dialogue Exception de format.

3	Indiquez les conditions et les attributs de mise en page à appliquer lorsque ces conditions ont pour valeur TRUE.

4	Cliquez sur OK.


Création d'un groupe de ventilation (vidéo)
Création d'un groupe de ventilation

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


A propos du mode Confiné (vidéo)
A propos du mode Confiné

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


A propos du mode Flexible (vidéo)
A propos du mode Flexible

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Création d'une liaison de données (vidéo)
Création d'une liaison de données

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Création d'un modèle de données matriciel (vidéo)
Création d'un modèle de données matriciel

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Création d'un objet Modèle de données

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Ajout d'une unité de programme à une bibliothèque ouverte (vidéo)
Ajout d'une unité de programme à une bibliothèque ouverte

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Déplacement d'une unité de programme du client au serveur (vidéo)
Déplacement d'une unité de programme du client au serveur

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Compilation d'une unité de programme (vidéo)
Compilation d'une unité de programme

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Insertion d'une fenêtre du Navigateur dans l'Interpréteur PL/SQL (vidéo)
Insertion d'une fenêtre du Navigateur dans l'Interpréteur PL/SQL

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Saut d'un appel à un sous-programme imbriqué (vidéo)
Saut d'un appel à un sous-programme imbriqué

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Saut à la prochaine ligne du code exécutable (vidéo)
Saut à la prochaine ligne du code exécutable

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Sortie d'un sous-programme imbriqué (vidéo)
Sortie d'un sous-programme imbriqué

  Rubriques connexes

Cliquez sur [image] au bas du lecteur vidéo pour lancer la démo animée.


Suppression d'un objet

Pour supprimer un objet :

1	Cliquez sur le(s) objet(s). Conseil

2	Choisissez Editer [image] Effacer.


Changement de mode (Confiné ou Flexible)

  Rubriques connexes

Pour définir ou remplacer le mode Confiné

  Démo

  Dans la vue Modèle de présentation , cliquez sur [image] ou [image] dans la barre d'outils pour passer d'un mode à l'autre :

Activé : les objets fils ne peuvent pas être extraits des objets père qui les entourent.

Désactivé : les objets fils peuvent être extraits des objets père qui les entourent.

Pour définir ou remplacer le mode Flex :

  Démo

  Dans la vue Modèle de présentation, cliquez sur [image] ou [image] dans la barre d'outils pour passer d'un mode à l'autre :

•	Activé : les bordures des objets père "s'étirent" lorsque les objets fils viennent en contact avec eux.

•	Désactivé : les bordures des objets père restent fixes lorsque les objets fils viennent en contact avec eux.


Connexion à une base de données

Pour vous connecter à une base de données, utilisez une des méthodes suivantes :

•	Connexion explicite

•	Connexion automatique

•	Connexion à distance


Définition des propriétés d'état

Pour définir les propriétés d'un état :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés) de l'état pour afficher la Palette de propriétés.

2	Définissez les propriétés d'état de la manière voulue.


Indication des préférences pour l'état

Pour indiquer les préférences relatives à un état :

1	Choisissez Outils [image] Préférences.

2	Définissez les valeurs comme vous le souhaitez.


Changement du titre de l'Aperçu interactif

Pour changer le titre dans la barre d'outils de l'Aperçu interactif :

1	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés) de l'état pour afficher la Palette de propriétés.

2	Sous le noeud Etat, définissez la propriété Titre de la manière voulue.


Affichage de la Grille de paramètres lors de l'exécution

  Etape suivante	  Rubriques connexes

Pour afficher la Grille de paramètres d'exécution :

1	Lorsque vous exécutez votre état : choisissez Outils [image] Préférences.  Sur la page Paramètres d'exécution, assurez-vous que la case Grille de paramètres est cochée.

2	Exécutez l'une des opérations suivantes :

•	Dans la vue Grille de paramètres, créez les objets voulus.

•	Cliquez deux fois sur [image] (icône de propriétés) du paramètre de votre choix pour afficher la Palette de propriétés.

3	Sous le noeud Paramètre, définissez la propriété Valeur initiale, le cas échéant.

4	Pour valider la valeur du paramètre lors de l'exécution, cliquez deux fois sur le champ de valeur de la propriété Déclencheur de validation. Dans l'Editeur PL/SQL, définissez le PL/SQL à déclencher lors de l'exécution.


Utilisation d'un paramètre système prédéfini

  Etape suivante	  Rubriques connexes

Pour utiliser un paramètre système :

1	Dans le Navigateur d'objet, développez le noeud Modèle de données, puis le noeud Paramètres système.

2	Cliquez deux fois sur [image] (icône de propriétés) du paramètre de votre choix pour afficher la Palette de propriétés.

3	Sous le noeud Paramètre, définissez la propriété Valeur initiale, le cas échéant.

4	Pour valider la valeur du paramètre lors de l'exécution, cliquez deux fois sur le champ de valeur de la propriété Déclencheur de validation. Dans l'Editeur PL/SQL, définissez le PL/SQL à déclencher lors de l'exécution.


Création d'un paramètre utilisateur

  Etape suivante	  Rubriques connexes

Pour créer un paramètre utilisateur :

1	Dans le Navigateur d'objet, développez le noeud Modèle de données, puis cliquez sur le noeud Paramètres utilisateur.

2	Cliquez sur [image] dans la barre d'outils.

3	Cliquez deux fois sur [image] (icône de propriétés) pour afficher la Palette de propriétés.

4	Sous le noeud Informations générales, remplacez la propriété Nom par le nom du paramètre de votre choix.

5	Sous le noeud Paramètre, définissez les propriétés Valeur initiale et Liste de valeurs, le cas échéant.

6	Pour valider la valeur du paramètre lors de l'exécution, cliquez deux fois sur le champ de valeur de la propriété Déclencheur de validation. Dans l'Editeur PL/SQL, définissez le PL/SQL à déclencher lors de l'exécution.


Création d'une liste de valeurs (LOV) pour un paramètre

Pour créer une LOV pour un paramètre :  Conseil

1	Dans le Navigateur d'objet, développez le noeud Modèle de données, puis le noeud Paramètres utilisateur.

2	Cliquez deux fois sur [image] (icône de propriétés) du paramètre pour lequel vous voulez créer une LOV pour afficher la Palette de propriétés.

3	Sous le noeud Paramètre, cliquez deux fois sur le champ de valeur de la propriété Liste de valeurs pour afficher la boîte de dialogue Liste de valeurs du paramètre.

4	Sélectionnez le type de liste que vous voulez créer :

•	Pour Valeurs statiques, entrez une valeur dans la boîte de texte Valeur et cliquez sur Ajouter. Répétez cette opération pour chaque valeur à ajouter (cliquez sur Supprimer pour supprimer des éléments de la liste).

Pour Instruction SELECT, entrez une interrogation pour remplir la liste de valeurs. Vous pouvez sélectionner plusieurs colonnes à afficher dans la LOV, dans laquelle la première colonne contient la valeur à attribuer au paramètre. La LOV affiche les colonnes dans l'ordre indiqué dans l'interrogation.

5	Si vous voulez que la valeur du paramètre soit limitée à celles de la LOV, cochez la case Restreindre la liste à des valeurs prédéterminées. Pour afficher une zone de liste déroulante autorisant les utilisateurs à éditer les valeurs ou à entrer une valeur différente dans la Grille de paramètres d'exécution, désactivez cette case à cocher.

6	Si vous ne voulez pas que la première colonne (qui contient la valeur du paramètre) de votre interrogation soit affichée dans la LOV, cochez la case Masquer première colonne. S'il n'est pas nécessaire de conserver la confidentialité de la première colonne, désactivez cette case à cocher.

Attention :

Si vous envoyez la sortie d'état à un fichier HTML, soit depuis Report Builder ou en l'exécutant dans votre explorateur Web, la valeur de la première colonne sera visible dans la source HTML, même si Masquer première colonne est sélectionné.

Si vous exécutez l'état depuis un explorateur Web et que la liste de valeurs ne soit pas d'accès réservé, la Grille de paramètres HTML affichera une zone de liste déroulante sous forme de champ texte et une liste de valeurs statiques que vous pouvez copier et coller dans le champ texte. Dans ce cas, la Grille de paramètres affichera toujours la première colonne, même si Masquer première colonne est sélectionné.

7	Cliquez sur OK.


Validation d'une valeur de paramètre lors de l'exécution

  Exemples	   Rubriques connexes

Pour valider une valeur de paramètre lors de l'exécution : Conseil

1	Dans le Navigateur d'objet, développez le noeud Modèle de données, puis le noeud Paramètres système ou Paramètres utilisateur.

2	Cliquez deux fois sur [image] (icône PL/SQL) du paramètre pour lequel vous voulez ajouter un déclencheur de validation PL/SQL.

3	Dans l'Editeur PL/SQL, définissez le PL/SQL à déclencher lors de l'exécution.


Création d'une grille de paramètres par défaut

  Etape suivante	  Rubriques connexes

Pour créer une grille de paramètres par défaut :

1	Choisissez Outils [image] Générateur de grilles de paramètres.

2	Cliquez sur OK pour afficher la vue Grille de paramètres avec la grille de paramètres par défaut.


Sélection de paramètres à inclure dans la Grille de paramètres d'exécution

  Rubriques connexes

Pour sélectionner les paramètres à inclure dans la Grille de paramètres d'exécution : Conseil

1	Choisissez Outils [image] Générateur de grilles de paramètres.

2	Sélectionnez les paramètres à inclure dans la Grille de paramètres d'exécution.

3	Modifiez les libellés de paramètre, le cas échéant.

4	Cliquez sur OK pour afficher la vue Grille de paramètres.


Ajout de pages à la Grille de paramètres d'exécution

Pour ajouter des pages à la Grille de paramètres d'exécution

1	Dans le Navigateur d'objet, cliquez sur [image] (icône d'état) en regard du nom de l'état.

2	Dans la Palette de propriétés, sous le noeud Fenêtre Grille de paramètres, définissez la propriété Nombre de pages.


Définition de PL/SQL

  Rubriques connexes

Pour définir une instruction PL/SQL :

1	Dans l'Editeur PL/SQL, entrez ou éditez le code PL/SQL de l'unité de programme.

2	Cliquez sur Compiler.

3	Si nécessaire, cliquez sur une erreur pour passer à son emplacement dans le code source.  Conseil

4	Une fois la compilation du code achevée, cliquez sur Fermer.


Création d'un hyperlien en utilisant PL/SQL

  Restrictions	  Exemples	  Etape suivante	  Rubriques connexes

Pour ajouter un hyperlien à votre état en utilisant PL/SQL au lieu de la Palette de propriétés :

1	Dans le Navigateur d'objet, développez  le noeud Modèle de présentation, puis le noeud contenant l'objet qui sera la source de la liaison Web. Remarque

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard de l'objet qui sera la source de la liaison Web.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_HYPERLINK pour définir le code PL/SQL du déclencheur de format.

4	Pour appliquer d'autres attributs HTML à l'hyperlien, utilisez SRW.SET_HYPERLINK_ATTRS.


Création d'un lien de ligne de commande d'application en utilisant PL/SQL

  Restrictions	  Exemples	  Rubriques connexes

Pour associer une commande à un objet de votre état en utilisant PL/SQL au lieu de la Palette de propriétés :

1	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis le noeud qui contenant l'objet auquel vous voulez associer un lien de ligne de commande d'application.  Remarque.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard de l'objet auquel vous voulez associer un lien de ligne de commande d'application.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_PDF_ACTION pour définir le code PL/SQL du déclencheur de format.


Création d'un signet en utilisant PL/SQL

  Exemples	  Rubriques connexes

Pour ajouter une chaîne de signet dans la zone de signets de votre état en utilisant PL/SQL au lieu de la Palette de propriétés :

1	Dans le Navigateur d'objet, développez  le noeud Modèle de présentation, puis le noeud contenant l'objet auquel vous voulez associer un signet (généralement, l'objet est un encadrement itératif ou un objet qui englobe la section concernée de l'état).  Remarque.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard de l'objet auquel vous voulez associer un signet.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_BOOKMARK pour définir le code PL/SQL du déclencheur de format.


Création d'une destination d'hyperlien en utilisant PL/SQL

  Exemples	  Etape suivante	  Rubriques connexes

Pour ajouter une destination d'hyperlien à votre état en utilisant PL/SQL au lieu de la Palette de propriétés :

1	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis le noeud contenant l'objet qui sera la destination d'une liaison Web. Remarque.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard de l'objet qui sera la destination d'une liaison Web.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_LINKTAG pour définir le code PL/SQL du déclencheur de format.


Création d'un en-tête de document HTML en utilisant PL/SQL

  Exemples 	  Rubriques connexes

Pour ajouter des éléments à l'en-tête de votre document HTML en utilisant PL/SQL au lieu de la Palette de propriétés :  Remarque

1	Dans le Navigateur d'objet, développez le noeud Déclencheurs d'état.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard du déclencheur Before Report.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_BEFORE_REPORT_HTML pour définir le code PL/SQL du déclencheur de format.


Création d'un pied de page de document HTML en utilisant PL/SQL

  Exemples 	  Rubriques connexes

Pour ajouter des éléments au pied de page de votre document HTML en utilisant PL/SQL au lieu de la Palette de propriétés :  Remarque

1	Dans le Navigateur d'objet, développez le noeud Déclencheurs d'état.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard du déclencheur Before Report.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_AFTER_REPORT_HTML pour définir le code PL/SQL du déclencheur de format.


Création d'un en-tête de page HTML en utilisant PL/SQL

  Exemples 	  Rubriques connexes

Pour ajouter un en-tête à chaque page de votre document HTML en utilisant PL/SQL au lieu de la Palette de propriétés :  Remarque

1	Dans le Navigateur d'objet, développez le noeud Déclencheurs d'état.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard du déclencheur Before Report.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_BEFORE_PAGE_HTML pour définir le code PL/SQL du déclencheur de format.

Pour ajouter un en-tête à une seule page de votre document HTML en utilisant PL/SQL : Remarque

1	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis le noeud contenant l'objet qui devra activer le déclencheur lors de la mise en forme.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard de l'objet qui devra activer le déclencheur lors de la mise en forme.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_BEFORE_PAGE_HTML pour définir le code PL/SQL du déclencheur de format.


Création d'un pied de page HTML en utilisant PL/SQL

  Exemples 	  Rubriques connexes

Pour ajouter un pied de page à chaque page de votre document HTML en utilisant PL/SQL au lieu de la Palette de propriétés :  Remarque

1	Dans le Navigateur d'objet, développez le noeud Déclencheurs d'état.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard du déclencheur Before Report.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_AFTER_PAGE_HTML pour définir le code PL/SQL du déclencheur de format.

Pou ajouter un pied de page à une seule page de votre document HTML en utilisant PL/SQL:  Remarque

1	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis le noeud contenant l'objet qui devra activer le déclencheur lors de la mise en forme.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard de l'objet qui devra activer le déclencheur lors de la mise en forme.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_AFTER_PAGE_HTML pour définir le code PL/SQL du déclencheur de format.


Création d'un en-tête de grille de paramètres HTML en utilisant PL/SQL

  Exemples 	  Rubriques connexes

Pour ajouter des éléments dans la partie supérieure de la Grille de paramètres en utilisant PL/SQL au lieu de la Palette de propriétés :  Remarque

1	Dans le Navigateur d'objet, développez le noeud Déclencheurs d'état.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard du déclencheur Before Parameter Form.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_BEFORE_FORM_HTML pour définir le code PL/SQL du déclencheur de format.


Création d'un pied de grille de paramètres HTML en utilisant PL/SQL

  Exemples 	  Rubriques connexes

Pour ajouter des éléments dans la partie inférieure de la Grille de paramètres en utilisant PL/SQL au lieu de la Palette de propriétés :  Remarque

1	Dans le Navigateur d'objet, développez le noeud Déclencheurs d'état.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard du déclencheur Before Parameter Form.

3	Dans l'Editeur PL/SQL, incluez SRW.SET_AFTER_FORM_HTML pour définir le code PL/SQL du déclencheur de format.


Ajout de contrôles de navigation sur la sortie au format pages HTML, à l'aide de PL/SQL

 Rubriques connexes

Pour ajouter des contrôles de navigation sur la sortie au format pages HTML :

•	Dans un déclencheur Avant état, utilisez la procédure SRW.SET_PAGE_NAVIGATION_HTML.


Utilisation d'un package intégré

  Rubriques connexes

Pour utiliser un package intégré :

1	Dans le Navigateur d'objet, développez le noeud Packages intégrés.

2	Développez le package que vous voulez utiliser.

3	Cliquez deux fois sur [image] (icône PL/SQL) en regard d'une procédure, d'une fonction ou d'une exception, pour visualiser le code PL/SQL.

4	Ajoutez la procédure ou la fonction dans les unités de programme PL/SQL


Création d'une unité de programme locale

  Etape suivante	  Rubriques connexes

Pour créer une unité de programme locale (côté client) :

1	Dans le Navigateur d'objet, cliquez sur le noeud Unités de programme.

2	Cliquez sur [image] dans la barre d'outils.

3	Dans la boîte de dialogue, entrez le nom de l'unité de programme dans la boîte de texte Nom.

4	Si votre unité de programme n'est pas une procédure, cliquez sur le bouton d'option Fonction, Spéc de package ou Corps de package.  Cliquez sur OK.

5	Dans l'Editeur PL/SQL, définissez le code PL/SQL de l'unité de programme.


Création d'une unité de programme stockée

  Etape suivante	  Rubriques connexes

Pour créer une unité de programme stockée (côté serveur) :

1	Choisissez Programme [image] Editeur de PL/SQL stocké.

2	Dans l'éditeur de PL/SQL stocké, sélectionnez un nom de propriétaire de base de données dans la liste déroulante Propriétaire, pour indiquer où l'unité de programme sera stockée dans la base de données.

3	Cliquez sur Nouveau.

4	Dans la boîte de dialogue, entrez le nom de l'unité de programme dans la boîte de texte Nom.

5	Si votre unité de programme n'est pas une procédure, cliquez sur le bouton d'option Fonction, Spéc de package ou Corps de package.  Cliquez sur OK.

6	Dans l'Editeur PL/SQL, définissez le code PL/SQL pour l'unité de programme stockée.


Edition d'une unité de programme

  Etape suivante	  Rubriques connexes

Pour éditer une unité de programme :

1	Dans le Navigateur d'objet, développez le noeud Unités de programme.

2	Cliquez deux fois sur [image] (icône PL/SQL) de l'unité de programme que vous voulez éditer.

3	Dans l'Editeur PL/SQL, éditez le code PL/SQL de l'unité de programme.


Suppression d'une unité de programme

  Etape suivante	  Rubriques connexes

Pour supprimer une unité de programme :

1	Dans le Navigateur d'objet, développez le noeud Unités de programme.

2	Cliquez sur l'unité de programme que vous voulez supprimer.

3	Cliquez sur [image] dans la barre d'outils.

4	Dans la boîte de messages, cliquez sur Oui.


Import de code source d'un fichier texte

  Etape suivante	  Rubriques connexes

Pour importer un code source d'un fichier texte :

1	Dans le Navigateur d'objet, cliquez sur le noeud Unités de programme.

2	Cliquez sur [image] dans la barre d'outils.

3	Dans la boîte de dialogue, entrez le nom de l'unité de programme dans la boîte de texte Nom.

4	Si votre unité de programme n'est pas une procédure, cliquez sur le bouton d'option Fonction, Spéc de package ou Corps de package.  Cliquez sur OK.

5	Dans l'Editeur PL/SQL, placez le curseur dans la fenêtre Source à l'endroit où vous voulez insérer le fichier texte.

6	Choisissez Fichier [image] Importer texte.

7	Dans la boîte de dialogue, indiquez le nom et l'emplacement du fichier texte à importer. Cliquez sur OK.

8	(En option) Editez le fichier texte, si nécessaire.

9	Cliquez sur Compiler.

10	Si nécessaire, cliquez sur une erreur pour passer à son emplacement dans le code source.  Conseil

11	Une fois la compilation du code achevée, cliquez sur Fermer.


Création d'un déclencheur d'état

  Rubriques connexes

Pour créer un déclencheur d'état :

1	Dans le Navigateur d'objet, développez le noeud Déclencheurs d'état.

2	Cliquez deux fois sur [image] pour le déclencheur que vous voulez créer.

3	Dans l'Editeur PL/SQL, définissez le code PL/SQL du déclencheur d'état.


Suppression d'un déclencheur d'état

  Rubriques connexes

Pour supprimer un déclencheur d'état :

1	Dans le Navigateur d'objet, développez le noeud Déclencheurs d'état.

2	Cliquez deux fois sur [image] (icône PL/SQL) du déclencheur que vous voulez supprimer.

3	Dans l'Editeur PL/SQL, faites glisser pour sélectionner le code PL/SQL.

4	Choisissez Editer [image] Effacer.


Création d'un bouton pour exécuter le PL/SQL

  Exemples	  Rubriques connexes

Pour créer dans la présentation d'état un bouton destiné à l'exécution du code PL/SQL :

1	Dans la vue Modèle de présentation, cliquez sur [image] dans la palette d'outils.  Remarque

2	Cliquez et faites glisser un rectangle.

3	Cliquez deux fois sur l'objet bouton pour afficher la Palette de propriétés.

4	Sous le noeud Libellé de bouton, définissez la propriété Type de libellé à Texte ou Icône :

•	Si le libellé du bouton est un texte, définissez la propriété Texte au texte qui doit apparaître sur le bouton.

•	Si le libellé de bouton est une icône, définissez la propriété Nom d'icône sur le nom du fichier contenant l'icône (le fichier doit résider dans le répertoire indiqué par la variable d'environnement UI_ICON).

5	Sous le noeud Comportement de bouton, définissez la propriété Type à PL/SQL.

6	Cliquez deux fois sur le champ de valeur de propriété Déclencheur PL/SQL.

7	Dans l'Editeur PL/SQL, définissez le code PL/SQL du déclencheur d'action ou de mise en forme lorsque l'utilisateur clique sur le bouton dans l'état mis en forme.

8	Définissez d'autres propriétés, le cas échéant..

9	Pour activer le bouton, exécutez l'état, puis affichez-le dans l'Aperçu Runtime.


Export de code source vers un fichier texte

  Rubriques connexes

Pour enregistrer un code source dans un fichier :

1	Dans le Navigateur d'objet, développez le noeud Unités de programme.

2	Cliquez deux fois sur [image] (icône PL/SQL) de l'unité de programme que vous voulez enregistrer dans un fichier.

3	Pour exporter une partie de l'unité de programme, sélectionnez le texte à exporter, sinon l'unité de programme sera exportée en totalité.

4	Choisissez Fichier [image] Exporter texte.

5	Dans la boîte de dialogue, entrez le nom et l'emplacement du répertoire du fichier texte de l'unité de programme exportée. Par défaut, les unités de programme exportées ont le suffixe de fichier .pls.

6	Cliquez sur OK.


Création ou édition d'un filtre de groupe

  Restrictions 	  Rubriques connexes

Pour créer ou éditer un filtre de groupe :

1	Dans la vue Modèle de données, cliquez deux fois sur la barre de titre du groupe pour afficher la Palette de propriétés.

2	Faites défiler la fenêtre jusqu'au noeud Groupe.

3	Pour afficher les n premiers enregistrements du groupe, définissez la propriété Type d'action à Premier et la propriété Nombre d'enregistrements à n.

4	Pour afficher les n derniers enregistrements du groupe, définissez la propriété Type d'action à Dernier et la propriété Nombre d'enregistrements à n.

5	Pour créer votre propre filtre en utilisant PL/SQL, définissez la propriété Type d'action à PL/SQL et cliquez deux fois sur le champ de valeur de propriété Filtre PL/SQL. Dans l'Editeur PL/SQL, définissez le code PL/SQL du filtre.

6	Définissez d'autres propriétés, le cas échéant..


Création ou édition d'un déclencheur de format

  Exemples	  Rubriques connexes

Pour créer ou éditer un déclencheur de format à l'aide de la palette de propriétés :

1	Dans la vue de l'aperçu interactif, cliquez deux fois sur l'objet pour lequel vous voulez créer ou modifier un déclencheur de mise en forme afin d'afficher la palette de propriétés. Remarque

2	Sous le noeud Présentation avancée, définissez la propriété déclencheur de mise en forme en cliquant sur le champ Valeur (libellé …) pour afficher l'éditeur PL/SQL.

3	Dans l'Editeur PL/SQL, définissez le code PL/SQL du déclencheur de format.

Pour créer ou modifier un déclencheur de mise en forme à l'aide du Navigateur d'objet :

1	Dans le Navigateur d'objet, développez  le noeud Modèle de présentation, puis le noeud contenant l'objet pour lequel vous voulez créer ou éditer un déclencheur de format.  Remarque.

2	Cliquez deux fois sur [image] (icône PL/SQL) en regard de l'objet pour lequel vous voulez créer ou éditer un déclencheur de format.

3	Dans l'Editeur PL/SQL, définissez le code PL/SQL du déclencheur de format.


Création ou modification d'un déclencheur d'action

  Exemples	  Rubriques connexes

Pour créer ou modifier un déclencheur d'action à l'aide de la palette de propriétés :

1	Dans la vue Modèle de présentation, cliquez deux fois sur l'objet bouton pour lequel vous voulez créer ou modifier un déclencheur d'action afin d'afficher la palette de propriétés.

2	Sous le noeud Comportement de bouton :

•	Paramétrez la propriété Type sur PL/SQL.

•	Définissez la propriété du déclencheur PL/SQL en cliquant sur le champ Valeur (libellé …) pour afficher l'éditeur PL/SQL.

3	Dans cet éditeur, assurez-vous que la liste déroulante Nom indique Déclencheur d'action.

Pour créer ou modifier un déclencheur d'action à l'aide du Navigateur d'objet :

1	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis celui qui contient l'objet bouton pour lequel vous voulez créer ou modifier un déclencheur d'action. Remarque.

2	Cliquez deux fois sur [image] (icône PL/SQL) situé à côté de l'objet bouton pour lequel vous voulez créer ou modifier un déclencheur de mise en forme.

3	Dans l'éditeur PL/SQL, définissez l'instruction PL/SQL du déclencheur d'action.


Exécution d'une unité de programme dans l'Interpréteur PL/SQL

  Etape suivante	  Rubriques connexes

Pour exécuter une unité de programme dans l'Interpréteur PL/SQL :

1	Si l'Interpréteur PL/SQL n'est pas encore affiché, choisissez Programme [image] Interpréteur PL/SQL pour l'afficher.

2	A l'invite PL/SQL> de l'Interpréteur, entrez le nom de l'unité de programme, suivi d'un point-virgule (;). Si l'unité de programme requiert des arguments, indiquez-les entre parenthèses. Par exemple : getdata(SCOTT).

3	Appuyez sur la touche Entrée ou Retour pour déclencher l'une des opérations suivantes :

•	Affichage, dans la ligne de commande, de la sortie générée par l'unité de programme et retour à l'invite PL/SQL> pour indiquer que l'opération s'est déroulée de manière satisfaisante.

•	Affichage de l'invite secondaire (+>) pour indiquer que vous n'avez pas fini d'entrer une instruction exécutable. Si vous avez oublié le point-virgule de fin, entrez-le et appuyez sur Entrée ou Retour. Sinon, cliquez sur le bouton droit de la souris et choisissez une Nouvelle invite dans le menu instantané.

•	Affichage, dans la ligne de commande, des erreurs d'exécution, puis apparition de l'invite PL/SQL>. Vous devez éditer ou déboguer votre unité de programme.

•	Suspension de l'exécution et affichage d'une nouvelle invite sous la forme : (debug n)PL/SQL>, si vous avez défini un point d'interruption ou un déclencheur de débogage dans l'unité de programme.


Transfert d'une unité de programme entre le client et le serveur

  Rubriques connexes

Pour transférer une unité de programme au serveur :

  Démo

1	Dans le Navigateur d'objet, cliquez deux fois sur le noeud Objets de base de données. Si ce noeud est désactivé, la boîte de dialogue Connexion s'affiche pour vous permettre de créer une nouvelle connexion avec la base de données.

2	Développez le sous-noeud correspondant au nom utilisateur de base de données que vous avez utilisé pour vous connecter à la base de données pour afficher le noeud Unités de programme stockées.

3	Dans la section Etats du Navigateur d'objet, développez le noeud Unités de programme.

4	Cliquez sur l'unité de programme à stocker dans la base de données et faites-la glisser du noeud Unités de programme au sous-noeud Unités de programme stockées.

5	Relâchez le bouton de la souris pour transférer une copie de l'unité de programme sur le serveur.

Pour transférer une unité de programme au client :

1	Dans le Navigateur d'objet, cliquez deux fois sur le noeud Objets de base de données. Si ce noeud est désactivé, la boîte de dialogue Connexion s'affiche pour vous permettre de créer une nouvelle connexion avec la base de données.

2	Développez le sous-noeud correspondant au nom utilisateur de base de données que vous avez utilisé pour vous connecter à la base de données.

3	Développez le noeud Unités de programme stockées.

4	Cliquez sur l'unité de programme stockée que vous voulez transférer au client et faites-la glisser du noeud Unités de programme stockées au noeud Unités de programme, dans la section Etats du Navigateur d'objet.

5	Relâchez le bouton de la souris pour transférer une copie de l'unité de programme au client.


Création d'une bibliothèque PL/SQL externe

  Etape suivante	  Rubriques connexes

Pour créer une bibliothèque PL/SQL externe :

1	Dans le Navigateur d'objet, cliquez sur le noeud Bibliothèques PL/SQL.

2	Cliquez sur [image] dans la barre d'outils.

La bibliothèque que vous venez de créer (qui s'appelait au départ LIB_xxx) est automatiquement ouverte. Lorsqu'une bibliothèque a été créée, son contenu peut être modifié par insertion ou suppression d'unités de programme ou attachement d'autres bibliothèques.


Ajout d'une unité de programme à une bibliothèque ouverte

  Etape suivante	  Rubriques connexes

Pour ajouter une unité de programme à une bibliothèque ouverte :

  Démo

1	Exécutez l'une des opérations ci-dessous dans le Navigateur d'objet, en fonction de l'état de vos opérations :

•	si la bibliothèque est ouverte, développez le noeud Bibliothèque,

•	si la bibliothèque n'est pas encore ouverte, cliquez sur le noeud Bibliothèques PL/SQL et choisissez Fichier [image] Ouvrir pour ouvrir la bibliothèque.

2	Sous le noeud Etats, développez le noeud Unités de programme.

3	Faites glisser l'unité de programme que vous voulez ajouter à la bibliothèque sous le noeud Unités de programme de la bibliothèque.

4	Relâchez le bouton de la souris pour ajouter une copie de l'unité de programme dans la bibliothèque.


Suppression d'une unité de programme d'une bibliothèque ouverte

  Etape suivante	  Rubriques connexes

Pour supprimer une unité de programme d'une bibliothèque ouverte :

1	Exécutez l'une des opérations ci-après, en fonction de l'état de vos opérations :

•	si la bibliothèque est ouverte dans le Navigateur d'objet, développez le noeud Bibliothèque,

•	si la bibliothèque n'est pas encore ouverte, cliquez sur le noeud Bibliothèques PL/SQL et choisissez Fichier [image] Ouvrir pour l'ouvrir.

2	Sous le noeud Unités de programme de la bibliothèque ouverte, cliquez sur l'unité de programme de bibliothèque à supprimer.

3	Cliquez sur [image] dans la barre d'outils.

4	Dans la boîte de messages, cliquez sur Oui.


Edition d'une unité de programme dans une bibliothèque ouverte

  Etape suivante	  Rubriques connexes

Pour éditer une unité de programme dans une bibliothèque ouverte :

1	Exécutez l'une des opérations ci-après, en fonction de l'état de vos opérations :

•	si la bibliothèque est ouverte dans le Navigateur d'objet, développez le noeud Bibliothèque,

•	si la bibliothèque n'est pas encore ouverte, cliquez sur le noeud Bibliothèques et choisissez Fichier [image] Ouvrir pour l'ouvrir.

2	Sous le noeud Unités de programme de la bibliothèque, cliquez deux fois sur [image] (icône d'unité de programme de bibliothèque) à éditer.

3	Dans l'Editeur PL/SQL, éditez le code PL/SQL de l'unité de programme.


Attachement d'une bibliothèque

  Restrictions	  Rubriques connexes

Pour attacher une bibliothèque :

1	Dans le Navigateur d'objet, cliquez sur le noeud Bibliothèques attachées.

2	Cliquez sur [image] dans la barre d'outils.

3	Dans la boîte de dialogue, entrez le nom de la bibliothèque PL/SQL externe dans la boîte de texte Bibliothèque ou cliquez sur Parcourir pour rechercher la bibliothèque PL/SQL externe à référencer.

4	Cliquez sur Attacher.


Compilation de toutes les unités de programme

  Rubriques connexes

Pour compiler toutes les unités de programme :

1	Dans le Navigateur d'objet, cliquez sur l'état ou la bibliothèque pour lesquels vous voulez compiler toutes les unités de programme (y compris les sous-programmes PL/SQL, les déclencheurs d'état, les formules, les filtres de groupe, les déclencheurs de format et les déclencheurs de validation).

2	Choisissez Programme [image] Compiler [image] Tout pour compiler toutes les unités de programme, quel que soit leur état de compilation.

3	Dans la boîte de dialogue Compiler, cliquez sur une erreur, puis sur Atteindre pour passer à la source de l'erreur dans l'unité de programme.  Conseil


Compilation d'une unité de programme

  Rubriques connexes

Pour compiler une unité de programme :

  Démo

1	Dans le Navigateur d'objet, cliquez sur l'unité de programme que vous voulez compiler (sous-programme PL/SQL, déclencheur d'état, formule, filtre de groupe déclencheur de format ou déclencheur de validation).

2	Choisissez Programme [image] Compiler sélection pour compiler l'unité de programme sélectionnée, quel que soit son état de compilation.

3	Dans la boîte de dialogue Compiler, cliquez sur une erreur, puis sur Atteindre pour passer à la source de l'erreur dans l'unité de programme.  Conseil


Compilation de toutes les unités de programme non compilées

  Rubriques connexes

Pour compiler toutes les unités de programme non compilées :

1	Dans le Navigateur d'objet, cliquez sur l'état ou la bibliothèque pour lesquels vous voulez compiler toutes les unités de programme non compilées (y compris les sous-programmes PL/SQL, les déclencheurs d'état, les formules, les filtres de groupe, les déclencheurs de format et les déclencheurs de validation).

2	Choisissez Programme [image] Compiler [image] Incrémentiel pour compiler toutes les unités de programme non compilées.

3	Dans la boîte de dialogue Compiler, cliquez sur une erreur, puis sur Atteindre pour passer à la source de l'erreur dans l'unité de programme.  Conseil


Recherche et remplacement de texte dans une unité de programme

  Etape suivante	  Rubriques connexes

Pour rechercher et remplacer du texte dans une unité de programme :

1	Dans le Navigateur d'objet, développez le noeud Unités de programme.

2	Cliquez deux fois sur [image] (icône PL/SQL) de l'unité de programme à éditer.

3	Dans l'Editeur PL/SQL, placez votre curseur à l'endroit où vous voulez commencer la recherche.

4	Choisissez Editer [image] Rechercher/remplacer.

5	Dans la boîte de dialogue, entrez vos critères de recherche et, en option, la chaîne de remplacement. Vous pouvez indiquer, pour le texte à rechercher, soit une chaîne de texte, soit une expression normale.

6	Cliquez sur Rechercher.

7	Lorsque le programme trouve une instance des critères de recherche, cliquez sur Remplacer pour remplacer une seule instance, sur Remplacer tout pour remplacer toutes les instances, ou bien éditez le texte directement dans l'Editeur PL/SQL.

8	Cliquez sur Rechercher pour passer à l'instance suivante ou sur Annuler pour fermer la boîte de dialogue.

9	Lorsque vous avez fini de remplacer tout le texte de l'unité de programme, cliquez sur Compiler pour recompiler l'unité de programme.  Conseil

10	Une fois la compilation du code achevée, cliquez sur Fermer.  Conseil


Liens et états Web - Restrictions

Les objets OLE ne sont pas pris en charge dans la sortie des états dans des fichiers HTML ou PDF.


Hyperliens - Restrictions

(Sortie PDF uniquement)  Un objet qui est la source d'un lien Web ne peut pas être également associé à un lien de ligne de commande d'application.


Liens de ligne de commande d'application - Restrictions

Un objet qui est associé à un lien de ligne de commande d'application ne peut pas également être la source d'un lien Web (hyperlien).


Diffusion d'un état vers plusieurs destinations

  Rubriques connexes

Pour diffuser un état vers plusieurs destinations, utilisez l'une des méthodes suivantes pour définir le type de diffusion :

•	Dans la boîte de dialogue Diffusion, créez une liste de diffusion pour l'état complet et/ou n'importe laquelle de ses sections.

•	Sur la ligne de commande, utilisez le mot-clé DESTINATION afin d'indiquer le nom d'un fichier .DST. Remarque : Pour utiliser ce fichier en vue de la diffusion d'une section, employez le mot-clé LEVEL dans la définition de sortie.

Pour diffuser l'état, effectuez l'une des opérations suivantes :

•	Entrez DISTRIBUTE=YES sur la ligne de commande.

•	Sélectionnez Fichier [image] Diffuser.


Exécution et distribution d'un état bitmap

  Exemples	  Rubriques connexes

Pour exécuter et distribuer un état bitmap :

1	Sélectionnez ou ouvrez l'état.

2	Si ce n'est pas déjà fait, connectez-vous à une base de données.

3	Cliquez sur [image] dans la barre d'outils.

4	Dans la Grille de paramètres d'exécution, indiquez les options correspondant à la sortie de votre choix :  Conseil

•	Aperçu de la sortie dans l'Aperçu interactif en utilisant les polices d'écran

•	Aperçu de la sortie dans l'Aperçu interactif en utilisant les polices d'imprimante

•	Envoi de la sortie dans un fichier HTML, y compris l'extension de feuille de style  Remarque

•	Envoi de la sortie dans un fichier HTML  Remarque

•	Envoi de la sortie dans un fichier PDF  Remarque

•	Envoi de la sortie dans un fichier XML

•	Envoi de la sortie dans un fichier RTF  Remarque

•	Envoi de la sortie à un fichier

•	Envoi de la sortie à une imprimante

•	Envoi de la sortie à un format délimité en vue de l'importation dans d'autres applications (par exemple, Microsoft Excel)

•	(Windows 95 et Windows NT uniquement) Envoi de la sortie par messagerie via votre application cliente de courrier électronique compatible MAPI

•	(UNIX uniquement) Envoi de la sortie par messagerie via votre application native UNIX de courrier électronique.

•	Affichage de la sortie dans votre navigateur Web

5	Cliquez sur [image] dans la barre d'outils.

6	Si une boîte de dialogue s'affiche, entrez les informations demandées.

Remarque :

Pour exécuter et imprimer un état bitmap dans un environnement en mode caractère, utilisez RWRUN60 dans la ligne de commande. Indiquez BATCH=YES et envoyez l'état dans un fichier ou une unité bitmap (une imprimante PostScript, par exemple).

•	Si vous générez la sortie de l'état au format PDF ou HTML, vous pouvez utiliser l'Assistant Web ou la propriété Hyperlien graphique afin d'associer des sections graphiques à tout objet de cette sortie, à un état différent ou à toute autre destination d'hyperlien valide.


Exécution et distribution d'un état ASCII (en mode caractère)

  Exemples	  Rubriques connexes

Pour exécuter et distribuer un état ASCII (en mode caractère) dans Report Builder en mode bitmap :

1	Sélectionnez ou ouvrez l'état.

2	Si ce n'est pas déjà fait, connectez-vous à une base de données.

3	Cliquez sur [image] dans la barre d'outils.

4	Si la Grille de paramètres d'exécution apparaît, indiquez les options correspondant à la sortie de votre choix : Conseil

•	Aperçu de la sortie en utilisant des polices d'écran

•	Aperçu de la sortie en utilisant des polices d'imprimante

•	Envoi de la sortie à un fichier

•	Envoi de la sortie à une imprimante

•	Envoi de la sortie au format délimité ou XML en vue de l'import vers d'autres applications (par exemple, Microsoft Excel ou un navigateur compatible XML)

•	(UNIX uniquement) Envoi de la sortie par messagerie via Oracle*Mail

•	(Windows 95 et Windows NT uniquement) Envoi de la sortie par messagerie à l'aide de MAPI

5	Dans la Grille des paramètres d'exécution, cliquez sur [image] dans la barre d'outils.

6	Si une boîte de dialogue s'affiche, entrez les informations demandées.

Remarques :

•	Pour exécuter et imprimer un état en mode caractère dans un environnement en mode caractère, utilisez RWRUN60 dans la ligne de commande.

•	Si vous voulez que l'état soit imprimé en mode paysage, vous devez définir la taille des pages dans la Palette de propriétés. Cependant, si votre imprimante n'accepte pas la taille de page indiquée, vos résultats risquent d'être tronqués. Pour que les imprimantes en mode caractère acceptent le mode paysage (ou d'autres tailles de page), vous pouvez définir les séquences d'échappement d'imprimante dans les fichiers de définition d'imprimante. Pour connaître les séquences d'échappement à utiliser, reportez-vous à la documentation de votre imprimante.


Définissez Type destination à Screen.


Définissez Type destination à Preview. Pour Nom destination, entrez le nom du pilote d'imprimante.


Définissez Type destination à File. Pour Nom destination, entrez le chemin d'accès et le nom de fichier. Pour Format destination, entrez HTMLCSS. Assurez-vous que le paramètre système MODE est défini à BITMAP.


Définissez Type destination à File. Pour Nom destination, entrez le chemin d'accès et le nom du fichier. Pour Format destination, entrez HTML. Assurez-vous que le paramètre système MODE est défini à BITMAP.


Définissez Type destination à File. Pour Nom destination, entrez le chemin d'accès et le nom du fichier. Pour Format destination, entrez PDF. Assurez-vous que le paramètre système MODE est défini à BITMAP.


Définissez Type destination à File. Pour Nom destination, entrez le chemin d'accès et le nom du fichier. Pour Format destination, entrez RTF. Assurez-vous que le paramètre système MODE est défini à BITMAP.


Définissez Type destination à File. Pour Nom destination, entrez le nom du fichier. Pour Format destination, entrez le nom du pilote d'imprimante.


Définissez Type destination à File. Pour Nom destination, entrez le nom du fichier. Pour Format destination, entrez le nom du fichier .prt.


Définissez Type destination sur Fichier. Pour Nom destination, entrez le nom du fichier. Pour Format destination, entrez le nom du fichier .xml.


Définissez Type destination à Printer. Pour Nom destination, entrez le nom du pilote d'imprimante.


Définissez Type destination à Printer. Pour Nom destination, entrez le nom de l'imprimante. Pour Format destination, entrez le nom du fichier .prt.


Définissez Type destination à Mail. Pour Nom destination, entrez l'ID messagerie (voir Exemples). Pour Format destination, entrez le nom du pilote d'imprimante.


Définissez Type destination à Mail. Pour Nom destination, entrez l'ID messagerie (voir Exemples). Pour Format destination, entrez le nom du fichier .prt.


Définissez Type destination à Mail. Laissez Nom destination en blanc. Dans la boîte de dialogue de messagerie, entrez les destinataires et la ligne contenant l'objet (voir Exemples).


Exécution d'un état à partir de la ligne de commande

  Rubriques connexes

Pour exécuter un fichier .rep (fichier d'exécution) ou .rdf (fichier de définition d'état) à partir de la ligne de commande :

1	Tapez ORACLE_HOME\BIN\RWRUN60, suivi du nom de l'état et des arguments désirés.

2	Si vous avez exécuté l'état en traitement par lots et envoyé la sortie dans un fichier (DESTYPE=file DESNAME=nomfichier BATCH=yes), ouvrez ou imprimez le fichier pour vérifier la sortie.


Exécution d'un état à l'aide d'un fichier de commandes

  Rubriques connexes

Pour exécuter un état en utilisant un fichier de commande :

1	Créez un fichier texte à l'aide de l'éditeur de votre choix.

2	Tapez ORACLE_HOME\BIN\RWRUN60, suivi du nom de l'état et des arguments désirés.

3	Si vous avez exécuté l'état en mode batch et envoyé la sortie dans un fichier (DESTYPE=FILE DESNAME=filename BATCH=YES), ouvrez ou imprimez le fichier pour vérifier la sortie.


Exécution d'un état sur un serveur d'états distant

  Rubriques connexes

Pour exécuter un état sur un serveur d'états distant (RWMTS60) :

  Entrez ORACLE_HOME\BIN\RWMTS60, suivi du nom de l'état, du nom du serveur et des arguments nécessaires.

Pour plus d'informations, reportez-vous au guide Publishing Reports manual. Pour afficher la version HTML de ce document :

•	Dans le Navigateur d'informations Oracle, choisissez Aide [image] Manuels.


Exécution d'un état à partir de Form Builder ou de Graphics Builder

Vous pouvez exécuter un état à partir de Form Builder ou de Graphics Builder en transmettant à l'état les données et les paramètres nécessaires à l'aide soit :

•	de l'exécutable Reports Server (RWMTS60), qui vous permet de planifier et de gérer les états d'exécution sur un serveur éloigné. Utilisez RWMTS60 pour envoyer des états à Reports Server.

•	(environnement Windows uniquement) de Reports Background Engine (RWRBE60), qui attend les lignes de commande et qui les mets en file d'attente pour exécuter localement les états. Reports Background Engine reçoit les lignes de commande de la procédure en package RUN_PRODUCT ou d'un état utilisant SRW.RUN_REPORT.

Vous pouvez également créer des états dans une application Forms dont sont indiqués les arguments de ligne de commande pour exécuter les états. Pour plus d'informations, reportez-vous à l'aide en ligne de Form Builder.


Transmission électronique d'un état en mode batch (via MAPI sur Windows)
Transmission électronique d'un état en mode batch (sous Windows)

  Exemples	  Rubriques connexes

Pour transmettre par messagerie un état en mode batch :  Remarque

1	Connectez-vous à la messagerie de votre système en utilisant votre application de messagerie client compatible MAPI.

2	Exécutez l'état à partir de la ligne de commande, en indiquant BATCH=YES, DESTYPE=MAIL et DESNAME=destinataire1,destinataire2,destinataire3, etc.


Transmission électronique d'un état à partir de Report Builder (via MAPI sur Windows)
Transmission électronique d'un état à partir de Report Builder (sous Windows)

  Exemples	  Rubriques connexes

Pour transmettre un état à partir de Report Builder sans le visualiser :

1	Connectez-vous à la messagerie de votre système en utilisant votre application de messagerie client compatible MAPI.

2	Sélectionnez ou ouvrez l'état.

3	Si ce n'est pas déjà fait, connectez-vous à une base de données.

4	Choisissez Fichier [image] Envoyer.

5	Dans la Grille de paramètres d'exécution, définissez Type destination à Mail ; laissez Nom destination en blanc.

6	Cliquez sur [image] dans la barre d'outils.

7	Dans la boîte de dialogue de messagerie, indiquez les destinataires et l'objet de l'état que vous voulez transmettre.

Pour transmettre un état à partir de Report Builder après l'avoir visualisé :

1	Connectez-vous à la messagerie de votre système en utilisant votre application de messagerie client compatible MAPI.

2	Sélectionnez ou ouvrez l'état.

3	Si ce n'est pas déjà fait, connectez-vous à une base de données.

4	Cliquez sur [image] dans la barre d'outils.

5	Dans la Grille des paramètres d'exécution, définissez Type destination à Preview ; laissez Nom destination en blanc.  Conseil

6	Cliquez sur [image] dans la barre d'outils pour afficher l'état dans l'Aperçu interactif.

7	(En option) Visualisez la sortie de l'état dans l'Aperçu Runtime .

8	Cliquez sur [image] dans la barre d'outils.

9	Dans la boîte de dialogue, indiquez les destinataires et l'objet de l'état que vous voulez transmettre.


Changement d'orientation

  Rubriques connexes

Pour changer l'orientation (portrait ou paysage) de la section d'un état :

1	Dans le Navigateur d'objet, agrandissez le noeud Modèle de présentation, puis cliquez sur celui de cette section (par défaut, un état est défini dans la section principale). Sélectionnez Outils [image] Palette de propriétés.

2	Dans la Palette de propriétés, située sous le noeud Section :

•	Définissez les propriétés Largeur et Hauteur (par exemple, 11 (ou 15) de large x 8.5 de haut pour le mode paysage ou 8.5 de large x 11 (ou 15) pour le mode portrait).

•	Paramétrez la propriété Orientation sur la valeur souhaitée.

3	Si vous voulez modifier l'orientation au cours de l'exécution, choisissez Outils [image] Générateur de grilles de paramètres pour afficher ce générateur:

•	Cliquez sur le paramètre système ORIENTATION.

•	Cliquez sur OK pour afficher la vue Grille de paramètres.

•	Cliquez deux fois sur le champ de valeur d'orientation (PF_ORIENTATION) pour que la Palette de propriétés  apparaisse.

•	Sous le noeud Paramètre, définissez la propriété Valeur initiale à Portrait ou à Paysage.

•	Cliquez sur [image] dans la barre d'outils.

•	A partir de la liste déroulante Orientation, changez l'orientation, si nécessaire.


Impression d'un état sur un formulaire pré-imprimé

  Rubriques connexes

Pour imprimer un état sur un formulaire pré-imprimé :

1	Mesurez soigneusement les positions et la longueur des champs de l'imprimé.

2	Si ce n'est pas déjà fait, créez un état avec un modèle de données pour les données principales à imprimer sur le formulaire.

3	Dans la vue Modèle de présentation, cliquez sur [image] dans la barre d'outils pour afficher la zone de marge.  Remarque :

4	Cliquez sur la bordure de la marge, puis faites glisser les poignées sur le bord supérieur et sur le bord inférieur pour supprimer les marges du haut et du bas.

5	Cliquez sur [image] dans la barre d'outils, pour réactiver le corps de l'état.

6	Si le formulaire demande des formats de données différents (par exemple, un format d'étiquettes de publipostage, suivi d'un format de tableau), créez une présentation supplémentaire pour chaque format supplémentaire.

7	Changez les largeurs de colonnes en fonction des champs du formulaire.

8	Déplacez et redimensionnez les objets au format du formulaire.


Affichage de sortie de l'état dans l'Aperçu Runtime

  Rubriques connexes

Pour afficher la sortie de votre état dans l'Aperçu Runtime :

1	Dans la vue Aperçu interactif , choisissez Affichage [image] Aperçu Runtime.

2	Dans l'Aperçu Runtime, utilisez l'une des fonctions suivantes :

•	défilement et pagination

•	partage horizontal et vertical

•	agrandissement et réduction

•	ouverture de plusieurs Aperçus Runtime


Affichage de sortie d'état dans l'Aperçu interactif

  Rubriques connexes

Pour afficher la sortie de votre état dans l'Aperçu interactif :

  Dans la vue Aperçu interactif, utilisez les fonctions suivantes :

•	défilement et pagination

•	partage horizontal et vertical

•	agrandissement et réduction


Défilement et pagination dans un état en sortie
Défilement et changement de page

Pour vous déplacer parmi les pages de l'état à l'aide des barres de défilement et des boutons de pagination :

•	Utilisez le pointeur de la souris pour faire glisser le curseur des barres de défilement horizontal et vertical afin de vous déplacer dans la page en cours.

•	Cliquez sur [image], [image], [image] et [image] dans la barre d'outils pour afficher les pages de l'état correspondantes.

•	Pour afficher une page en particulier, entrez son numéro dans le champ Page.


Partage de la région d'affichage de l'Aperçu Runtime

Pour créer deux vues de la sortie de l'état en partageant horizontalement ou verticalement la région d'affichage de l'Aperçu Runtime : Remarque

1	Faites glissez la case qui se trouve au-dessus de la barre de défilement vertical (pour un partage horizontal) ou à gauche de la barre de défilement horizontal (pour un partage vertical).

2	Relâchez le bouton de la souris à l'endroit où vous voulez partager la zone d'affichage.

Vous pouvez utiliser le défilement et la pagination dans chaque vue indépendamment.


Vous ne pouvez pas partager la zone d'affichage à la fois horizontalement et verticalement.


Partage de la région d'affichage de l'Aperçu interactif

Pour créer deux vues de la sortie d'état en partageant horizontalement et/ou verticalement la région d'affichage de l'Aperçu interactif :

1	Faites glisser la barre noire en dessous de la barre de défilement verticale (pour un partage horizontal) ou à droite de la barre de défilement horizontale (pour un partage vertical).

2	Relâchez le bouton de la souris à l'endroit où vous voulez partager la zone d'affichage.

Vous pouvez utiliser le défilement et la pagination dans chaque vue indépendamment.


Agrandissement et réduction

Pour agrandir une partie difficile à lire de votre état ou réduire la taille de l'image pour en avoir une vue d'ensemble :

•	Pour agrandir la sortie affichée dans la zone d'affichage, cliquez sur [image] dans la barre d'outils.

•	Pour réduire la taille de la sortie affichée, cliquez sur [image] dans la barre d'outils.


Ouverture de plusieurs Aperçus Runtime

Pour ouvrir une nouvelle fenêtre d'Aperçu Runtime ayant le même contenu que la fenêtre en cours :

•	Cliquez sur [image] dans la barre d'outils.


Impression d'un état à partir de l'Aperçu Runtime

  Rubriques connexes

Pour imprimer un état à partir de l'Aperçu Runtime :

1	Dans l'Aperçu Runtime , cliquez sur [image] dans la barre d'outils pour vérifier la configuration de votre imprimante.

2	Cliquez sur [image] dans la barre d'outils.

3	Dans la boîte de dialogue, entrez le nombre de pages et d'exemplaires que vous voulez imprimer.

Si vous avez exécuté l'état avec DESTYPE égal à Screen, un message apparaît pour vous avertir que vous devez exécuter l'état avec DESTYPE égal à Preview avant de l'imprimer. Preview crée une sortie PostScript, ce qui est généralement préférable à l'impression d'états en mode bitmap.

4	Cliquez sur OK.


Impression d'un état à partir de l'Aperçu interactif

  Rubriques connexes

Pour imprimer un état à partir de l'Aperçu interactif :

1	Dans la vue Aperçu interactif, cliquez sur [image] dans la barre d'outils.

2	Dans la boîte de dialogue, entrez le nombre de pages et d'exemplaires que vous voulez imprimer.

Si vous avez exécuté l'état en indiquant comme type de destination Screen, un message d'avertissement vous indique que vous devez exécuter l'état avec comme type de destination Preview avant de l'imprimer. L'Aperçu crée une sortie PostScript qui est généralement préférable pour la sortie des états bitmap.

3	Cliquez sur OK.


Impression d'un état à partir de votre navigateur Web

  Rubriques connexes

Pour imprimer un état à partir de votre navigateur Web :

1	Si votre état est mis en forme avec des extensions de feuilles de style HTML (HTMLCSS), configurez votre navigateur de façon à imprimer le document HTML de la même façon que l'état.  Remarque

•	Dans votre explorateur, choisissez Fichier [image] Mise en page et modifiez les paramètres de marge comme vous le souhaitez.

•	Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône de propriétés) pour que l'état affiche la Palette de propriétés.

•	Définissez les propriétés Largeur et Hauteur comme vous le souhaitez, en soustrayant les profondeurs de marge (par exemple, pour une page de 8.5 x 11 avec des marges du haut, du bas de gauche et de droite de .25, définissez la largeur à 8 et la hauteur à 10,5).

2	Affichez la sortie de l'état dans votre navigateur Web.

3	Choisissez Fichier [image] Imprimer.


Transfert de plateau d'imprimante

  Rubriques connexes	  Exemples

Pour changer de  plateau d'imprimante :

1	Choisissez Fichier [image] Mise en page et notez le nom des plateaux définis pour votre imprimante.

2	Utilisez SRW.SET_PRINTER_TRAY pour définir le déclencheur souhaité :

Pour changer de plateau d'imprimante avant le début du formatage de l'état, créez un déclencheur Before Report. Remarque

Pour changer de plateau d'imprimante entre les pages de l'état, créer un déclencheur Between Pages.

Pour changer de plateau pour une page donnée sur laquelle s'imprime un objet particulier, créez un déclencheur de format pour cet objet.


Affichage de la sortie de l'état dans votre navigateur Web

  Rubriques connexes

Pour afficher la sortie de l'état dans votre navigateur Web :

1	Sélectionnez ou ouvrez l'état, puis cliquez sur [image] dans la barre d'outils pour exécuter l'état.

2	Dans la vue Aperçu interactif, indiquez le format de sortie.

•	Pour formater l'état en vue de la sortie HTML, choisissez Affichage [image] Web Preview [image] Use HTML.

•	Pour formater l'état en vue de la sortie HTML, incluez les extensions de feuilles de style (HTMLCSS), choisissez Affichage [image] Web Preview [image] Use HTML Style Sheets.  Remarque

•	Pour envoyer la sortie dans un fichier PDF, choisissez Affichage [image] Web Preview [image] Use PDF.

•	Pour formater l'état en vue de la sortie XML, choisissez Affichage [image] Aperçu Web [image] Utiliser XML.

3	Indiquez la plage de la sortie que vous voulez afficher :

•	Pour afficher uniquement la page en cours de l'état, choisissez Affichage [image] Web Preview [image] Show Current Page.

•	Pour afficher toutes les pages, choisissez Affichage [image] Web Preview [image] Show All Pages. Remarque : Si vous choisissez d'afficher toutes les pages de la sortie de votre état et que vous fassiez défiler une page HTML, la première page est affichée dans le navigateur Web et vous pouvez accéder rapidement à une autre page de l'état.

4	Choisissez Affichage [image] Web Preview [image] Generate to Web Browser.  Remarque

5	Pour enregistrer votre état sous forme de fichier HTML ou PDF, choisissez Fichier [image] Enregistrer sous dans votre navigateur Web.


La mise en forme avec des extensions de feuilles de style pagine le document HTML de la même façon que l'état ; la mise en forme sans extensions de feuilles de style génère une sortie HTML sans saut de page entre les pages de l'état.


Affichage de chaque page d'une sortie d'état HTML

 Rubriques connexes

Pour faire défiler les pages de la sortie HTML d'un état :

1	Indiquez les commandes de navigation de cette sortie de l'une des manières suivantes :

•	dans la Palette de propriétés d'état ;

•	via PL/SQL.

2	Faites défiler ces pages en exécutant l'état depuis la ligne de commande PAGESTREAM=YES.


(Sortie PDF uniquement)  Un lien de ligne de commande d'application est un attribut d'un objet qui indique la ligne de commande à exécuter lorsque l'utilisateur clique sur l'objet.


Un échappement Après page est un attribut indiquant des commandes de texte, de graphique ou HTML qui doivent apparaître à la fin d'une page ou de toutes les pages de votre document.


Un échappement Après état est un attribut indiquant des commandes de texte, de graphique ou HTML qui doivent apparaître à la fin de votre document.


Un échappement Après état doit être défini dans un déclencheur activé avant la mise en forme de l'état (déclencheur Before Report, par exemple).


Un échappement Après état est un attribut indiquant des commandes de texte, de graphique ou HTML qui doivent apparaître au bas de la grille de paramètres HTML.


Un échappement Après formulaire doit être défini dans un déclencheur activé avant la mise en forme de la grille de paramètres (déclencheur Before Parameter Form, par exemple).


Un objet ne peut être ancré qu'à un autre objet.


Si vous effectuez de nombreuses éditions, vous aurez peut-être intérêt à cliquer sur Appliquer pour enregistrer vos modifications de manière incrémentielle, sans avoir à compiler.


Pour la portabilité entre plates-formes, vous pouvez utiliser une police de code à barres PostScript, de façon à imprimer votre état sur toute unité de sortie PostScript.


Un échappement Avant page est un attribut indiquant des commandes de texte, de graphique ou HTML qui doivent apparaître au début d'une page ou de toutes les pages de votre document.


Si vous voulez que l'échappement s'applique à chaque page, définissez-le dans un déclencheur activé avant la mise en forme de l'état (déclencheur Before Report, par exemple). Si vous voulez que l'échappement s'applique uniquement à une page, définissez-le dans un déclencheur de format.


Un échappement Avant état est un attribut indiquant des commandes de texte, de graphique ou HTML qui doivent apparaître au début de votre document.


Un échappement Avant état doit être défini dans un déclencheur activé avant la mise en forme de l'état (déclencheur Before Report, par exemple).


Un échappement Avant formulaire est un attribut indiquant des commandes de texte, de graphique ou HTML qui doivent apparaître en haut de la grille de paramètres HTML.


Un échappement Avant formulaire doit être défini dans un déclencheur activé avant la mise en forme de la grille de paramètres (déclencheur Before Parameter Form, par exemple).


Le corps d'un sous-programme contient les mêmes informations que la spécification, ainsi que son application réelle (c'est-à-dire sa séquence d'actions). Dans la plupart des cas, il suffit d'un corps par sous-programme.


Un signet est un attribut d'un objet indiquant une chaîne qui est un lien à l'objet.


Le numéro et « # » n'apparaissent pas dans la zone des signets.


Les unités de programme non compilées sont signalées par un astérisque (*) après leur nom.


En cas de remplacement d'un texte dans plusieurs unités de programme, vous pouvez les recompiler en bloc lorsque vous avez terminé.


Lorsque vous créez l'état, utilisez le Générateur de grilles de paramètres (choisissez Outils [image] Générateur de grilles de paramètres) pour sélectionner les paramètres système qui devront apparaître dans la grille de paramètres d'exécution.


Si vous définissez un paramètres dans un modèle, vous devez appliquer le modèle à un état pour sélectionner ce paramètre pour la Grille de paramètres d'exécution.


Si vous cliquez deux fois sur l'outil, vous créez un nouvel objet chaque fois que vous cliquez sur le canevas. L'outil reste sélectionné jusqu'à ce que vous cliquiez sur un autre outil. Cliquez sur [image] pour restaurer le mode.


Recherchez les points-virgules manquants à la fin des instructions, ou les erreurs de syntaxe.


Cliquez sur l'icône [image] pour développer le noeud. Cliquez sur l'icône [image] pour le réduire.


Une fonction est un sous-programme PL/SQL qui exécute la séquence d'actions indiquée, puis retourne une valeur.


Pour tester votre lien hypertexte, transférez la sortie de votre état à un fichier HTML et affichez-la dans votre explorateur Web.


Un hyperlien est un attribut d'un objet qui indique un lien hypertexte à l'une des destinations suivantes :

•	un objet identifié par une destination hyperlien dans le même état.

•	un autre document HTML ou PDF sur la même machine ou sur un serveur Web distant.

Vous pouvez définir la propriété Attributs d'hyperlien supplémentaire pour indiquer un autre document HTML à appliquer à l'hyperlien.


Pour tester votre lien hypertexte, transférez la sortie de votre état à un fichier HTML ou PDF et affichez-la dans votre explorateur Web browser.


Une destination hyperlien est un attribut d'un objet qui identifie la destination d'un lien hypertexte.


Vous pouvez également exécuter cette tâche dans la vue Modèle de présentation..


Vous pouvez également utiliser certains outils de dessin de la vue Aperçu interactif et de la vue Grille de paramètres.


Vous pouvez également exécuter cette tâche dans la vue Modèle de présentation. Pour afficher la marge, cliquez sur [image] dans la barre d'outils. Cliquez sur [image] dans la barre d'outils pour réactiver le corps de l'état.


Vous pouvez également exécuter cette tâche dans la vue Modèle de présentation ou la vue Grille de paramètres.


Vous pouvez également exécuter cette tâche dans la vue Aperçu interactif ou la vue Grille de paramètres.


Vous pouvez également exécuter cette tâche dans la vue Grille de paramètres.


Si vous utilisez BATCH=yes, Report Builder utilise une liste cc et une ligne objet vierges. Pour indiquer la ligne objet et les listes cc, vous devez indiquer BATCH=no (exécution interactive).


Entourez de guillemets les ID de messagerie et séparez-les par des virgules..


Utilisez deux paires de guillemets pour "O'Hara".


La zone de marge est définie par un trait noir épais qui la sépare du corps. Si vous créez des objets dans la partie corps d'un état, tout en affichant la zone de marge, vous ne pouvez éditer les objets que lorsque la marge est affichée.


Un package est une méthode d'encapsulage et de stockage de procédures, de fonctions, de variables et autres éléments liés ensemble et constituant une unité dans la base de données. Les packages simplifient les tâches d'organisation de l'administrateur de bases de données ou du développeur d'applications et offrent des fonctionnalités accrues et des performances améliorées de la base de données.


Lecteur autonome ou enfichable, comme le lecteur Acrobat Adobe, qui vous permet d'afficher votre fichier PDF.


Une sortie d'état en format PDF peut comprendre à la fois des hyperliens et des liens de ligne de commande d'application. Lorsque la propriété Ligne de commande d'application est définie pour un objet, elle lui est appliquée. Sinon, la propriété Hyperlien est appliquée.


Vous pouvez également accéder à PL/SQL, pour un filtre de groupe, par l'intermédiaire du Navigateur d'objet (sous le noeud Groupes ou le noeud Unités de programme).


Pour afficher l'aide sur les propriétés de la Palette de propriétés, cliquez sur une propriété et appuyez sur F1.


Une procédure est un sous-programme PL/SQL qui exécute une séquence d'actions indiquée.


Vous pouvez redimensionner les interrogations, les groupes, les cadres, les encadrements itératifs, les champs, les objets matrices et le texte standard. Un point d'ancrage est automatiquement redimensionné si vous déplacez l'un des objets qu'il ancre.


Pour sélectionner plusieurs objets, cliquez sur un objet, puis tout en maintenant la touche Maj enfoncée, cliquez sur tous les autres objets. Pour sélectionner tous les objets, choisissez Editer [image] Sélectionner tout.


Sélectionnez les colonnes dans l'ordre dans lequel vous voulez qu'elles apparaissent dans la sortie de l'état.


Dans le Navigateur d'objet, sous le noeud Modèle de présentation, développez le noeud Corps pour sélectionner l'encadrement itératif par son nom.


Dans le Navigateur d'objet, sous le noeud Modèle de présentation, développez le noeud Corps pour sélectionner le champ par son nom.


Une spécification d'unité de programme définit le nom, les paramètres et le type de retour (pour les fonctions uniquement) du sous-programme.


Si vous choisissez Editer [image] Sélectionner tout pour supprimer les bordures de tous les objets, vous supprimez également les caractères de soulignement des titres de colonnes. Pour ajouter des caractères de soulignement, cliquez sur les objets de soulignement (actuellement invisibles) et utilisez la palette d'outils Couleurs de ligne pour sélectionner la couleur des caractères de soulignement.


Si vous définissez un modèle, vous pouvez sélectionner des objets dans la marge. Les objets du corps sont inconnus tant que le modèle n'est pas appliqué à un état et ne peuvent donc pas être définis comme des liens hypertexte.


Si vous définissez un modèle, vous pouvez créer des objets de présentation dans la marge. Cliquez sur [image], [image] ou [image] pour exposer ces zones du modèle.


Entourez de parenthèses les ID de messagerie et séparez-les par des virgules.


Explorateur conforme à HTML 3.0 (par exemple, Netscape 2.2).


Vous ne pouvez pas placer un point d'interruption dans une instruction BEGIN, END ou NULL, ni dans un commentaire.


Vous ne pouvez pas placer de déclencheur de débogage dans une instruction BEGIN, END ou NULL, ni dans un commentaire.


N'oubliez pas le point-virgule (;) de fin, ni les arguments éventuels.


Utilisez Navigateur [image] Compiler ou Fichier [image] Compiler pour exécuter des compilations par lots de plusieurs unités de programme.


Si vous ne connaissez pas exactement l'emplacement et le nom de la bibliothèque, cliquez sur le bouton <b>Rechercher</b> pour parcourir la structure de vos répertoires ou les espaces de nom de votre base de données.


Si une invite secondaire (<tt>+&gt; </tt>) s'affiche dans la ligne de commande, vous avez probablement oublié le point-virgule de fin. Entrez-le en réponse à l'invite secondaire et appuyez à nouveau sur la touche Retour ou Entrée.


Un bloc est l'unité de programme de base de PL/SQL, définie par les mots-clés DECLARE, BEGIN, EXCEPTION et END.


Pour traduire un programme source en format binaire exécutable, les unités de programme PL/SQL doivent être compilées avant de pouvoir être exécutées.


La présentation est la zone d'un éditeur dans laquelle vous créez, modifiez, positionnez ou supprimez des objets, tout en affichant leurs représentations graphiques.


Une bibliothèque est un ensemble d'unités de programme PL/SQL, stockées ensemble dans un fichier ou une base de données, et qui peuvent être référencées simultanément par plusieurs applications.


Le chemin d'accès de chargement est un ensemble d'emplacements de répertoire que Procédure Builder utilise comme chemin de recherche.


Un sous-programme imbriqué est une unité de programme appelée à partir d'une autre unité de programme.


Un noeud est un emplacement spécifique dans la hiérarchie des objets du Navigateur d'objet. Ils peuvent être développés pour fournir des informations sur un objet, par exemple des références croisées à d'autres objets.


Une fenêtre est une partie distincte, généralement redimensionnable, d'un éditeur dans laquelle un travail est exécuté.


PL/SQL est une extension procédurale de SQL qui fournit des éléments de programmation, par exemple des conditions et des procédures.


Une unité de programme est une structure de code que vous pouvez créer en utilisant PL/SQL comme un package, ou un sous-programme comme une procédure ou une fonction.


Une interrogation est une instruction SQL SELECT qui indique les données que vous voulez extraire d'une ou de plusieurs tables ou vues d'une base de données.


Un enregistrement est un ensemble de données extraites par une instruction SELECT.


Un schéma est un ensemble d'objets de base de données liés. Chaque utilisateur d'une base de données a un schéma portant le même nom.


Une session correspond à la période de temps qui s'écoule entre l'appel et la sortie de l'exécutable.


Le code source se compose d'instructions PL/SQL fournies dans un sous-programme ou un package. Vous devez avoir le code source d'une unité de programme pour pouvoir la compiler sous une forme exécutable.


Une instruction est un élément PL/SQL utilisé pour un contrôle conditionnel, itératif et séquentiel et pour la gestion des erreurs. Chaque instruction PL/SQL doit se terminer par un point-virgule (;).


Une unité de programme stockée est une procédure, une fonction ou un package qui réside et s'exécute dans Oracle7 Server.


Style tabulaire, style formulaire, style étiquette de publipostage, style lettre type.


Groupe-gauche, groupe-niveau supérieur, matrice, matrice avec point d'interruption.


Dans la Palette de propriétés :

•	Sous le noeud Style, définissez les propriétés du noeud d'encadrement sélectionné.

•	Sous le noeud Labels, définissez les propriétés du noeud de libellé sélectionné.

•	Sous le noeud Fields, définissez les propriétés du noeud de champ sélectionné.


Un déclencheur est une procédure PL/SQL exécutée ou "activée" lorsqu'un événement spécifique se produit.


Une variable est un objet nommé auquel peut être attribuée une valeur susceptible de changer avec le passage du temps.


Un lien est toujours tracé entre le groupe père et l'interrogation fils.


Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône du noeud Modèle de données) pour afficher la vue Modèle de données de votre état. Dans les autres vues, choisissez Affichage [image] Modèle de données ou cliquez sur [image] dans la barre d'outils.


Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône du noeud Modèle de présentation) pour afficher la vue Modèle de présentation de votre état. Dans les autres vues, choisissez Affichage [image] Modèle de présentation ou cliquez sur [image] dans la barre d'outils.


Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône du noeud Modèle de présentation) pour afficher la vue Modèle de présentation de votre modèle.


Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône du noeud Aperçu interactif) pour afficher la vue Aperçu interactif de votre état. Dans les autres vues, choisissez Affichage [image] Aperçu interactif ou cliquez sur [image] dans la barre d'outils.


Dans le Navigateur d'objet, cliquez deux fois sur [image] (icône du noeud Grille de paramètres) pour afficher la vue Grille de paramètres de votre état. Dans les autres vues, choisissez Affichage [image] Grille de paramètres ou cliquez sur [image] dans la barre d'outils.


Dans la vue Aperçu interactif, choisissez Affichage [image] Aperçu Runtime pour afficher l'Aperçu Runtime.


Les paramètres que vous avez créés sont automatiquement sélectionnés ; si vous voulez afficher les paramètres système dans la Grille de paramètres d'exécution, vous devez les sélectionner dans le Générateur de grilles de paramètres.


Le plateau d'imprimante indiqué dans la boîte de dialogue Mise en page est utilisé comme plateau d'imprimante par défaut ; créez un déclencheur Before Report pour modifier cette valeur par défaut.


Le texte entré sera formaté pour une sortie HTML uniquement ; pour tous les autres formats de sortie, l'objet texte ne figurera pas dans l'état.


Pour les états avec groupe, l'assistant Report et l'assistant Données créent n champs récapitulatifs dans le modèle de données pour chaque colonne récapitulative que vous définissez : une à chaque niveau de groupe situé au-dessus de la colonne récapitulative que vous définissez et une au niveau de l'état. Par exemple, si un état est groupé par divisions, puis par services, la colonne récapitulative définie pour une somme des salaires crée des champs pour la somme des salaires de chaque division et de chaque service (récapitulatifs de niveau de groupe), et pour la somme de tous les salaires (récapitulatif de niveau d'état).


Si cette option est déjà activée, Report Builder affiche automatiquement l'état dans votre navigateur Web par défaut lorsque vous l'exécutez.


Lorsque vous affichez la sortie de l'état sous Microsoft Word dans Office 95, vous devez choisir Affichage [image] Mise en page pour voir tous les graphiques et objets de votre état.


Vous pouvez également afficher automatiquement la sortie de l'état dans votre navigateur Web, puis enregistrer le fichier temporaire sous forme de fichier HTML ou PDF. Cliquez sur le bouton Rubriques connexes en haut de la présente rubrique pour accéder à la rubrique Affichage de la sortie de l'état dans votre navigateur Web.


Vous ne pouvez supprimer des noeuds que jusqu'au minimum requis pour le style d'état sélectionné.


Les sections correspondent aux groupes de l'état. Pour plus d'informations, cliquez sur le bouton Rubriques connexes en haut de la présente rubrique pour accéder à la rubrique A propos des attributs de modèle.


Oracle Reports ne prend pas en charge les liens de données entre les interrogations contenant des objets colonne. Si vous tentez de créer ce type de lien, un message apparaît ; il vous permet de demander à Reports de créer une interrogation groupe à groupe au lieu de ce type de lien (à l'aide des groupes pères) ou d'annuler l'opération. Pour créer un lien entre un type de colonne quelconque et un objet colonne, entrez manuellement l'instruction SQL en utilisant les alias de colonnes appropriés.


Lorsque vous créez un lien de colonne à colonne, Report Builder ajoute une clause WHERE à l'interrogation.


Lorsque vous créez un lien de groupe à groupe, Report Builder n'ajoute pas de clause WHERE à l'interrogation.


Pour afficher la boîte de dialogue de sortie délimitée, sélectionnez Fichier [image] Générer dans fichier [image] Sortie délimitée.


Les données de votre sortie d'état sont des instances d'objets standard ou d'objets de champ.


Les objets image, graphiques et OLE n'apparaissent pas dans les sorties délimitées.


Pour utiliser la fonction Hyperlien graphique, assurez-vous que le graphique se situe à l'intérieur d'un encadrement itératif.


Lorsque vous indiquez un hyperlien graphique à l'aide de l'assistant Web, Report Builder définit automatiquement la propriété Destination hyperlien de l'objet associé. Si vous modifiez la destination d'hyperlien, mettez à jour la propriété Hyperlien graphique afin de conserver la relation entre la destination et l'objet (pour plus d'informations, reportez-vous à la rubrique d'aide concernant cette propriété).


Pour afficher la boîte de dialogue Diffusion : dans la palette de propriétés de l'état ou de la section, sous le noeud Présentation générale, cliquez deux fois sur le champ de valeur Diffusion (intitulé . . .).


Pour afficher la boîte de dialogue des paramètres de traçage Runtime, sélectionnez Outils [image] Trace.


Pour afficher la boîte de dialogue Préférences, sélectionnez Outils [image] Préférences.


Si vous ne modifiez pas la valeur par défaut Contrôle de navigation de page, Report Builder utilise par défaut le script intégré JavaScript pour créer des contrôles de navigation entre les pages de la sortie.


Vous ne devez pas utiliser les colonnes de formules pour définir des valeurs de paramètres.


Tâches d'état Developer/2000 - Aide


Assistants

  Rubriques Assistant


Création d'un modèle

  Rubriques connexes

Pour créer un modèle :

1	Dans le Navigateur d'objet, cliquez sur le noeud Modèles, puis sur [image] dans la barre d'outils.

2	Définissez les attributs du modèle par défaut pour tous les styles d'état.

3	(En option)  Définissez les attributs de modèle de remplacement pour un style d'état particulier.

4	Pour définir les paramètres système, les paramètres utilisateur, les unités de programme, les bibliothèques attachées et les déclencheurs d'état du modèle, cliquez deux fois sur les noeuds correspondants dans le Navigateur d'objet.


Définition des attributs de modèle par défaut

  Rubriques connexes

Pour définir les attributs par défaut des objets d'état dans un modèle qui s'applique à tous les styles d'état :

1	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis le noeud Corps et enfin le noeud Section par défaut.

2	Pour modifier les propriétés par défaut de la présentation générale et l'espacement dans les styles d'état, cliquez deux fois sur [image] (icône de propriétés de la section) en regard du noeud Par défaut pour afficher la Palette des propriétés.

3	Pour modifier les propriétés par défaut des encadrements, des en-têtes/libellés de champ, des champs, des libellés récapitulatifs et des récapitulatifs (totaux), développez complètement le noeud Par défaut, puis cliquez deux fois sur l'icône de propriétés pour afficher la Palette de propriétés.

Remarque : La vue Modèle de présentation est synchronisée avec le Navigateur d'objet ; lorsque vous sélectionnez un objet de présentation, le noeud qui lui est associé est mis en évidence dans le Navigateur d'objet. Pour sélectionner l'encadrement-père d'un objet de présentation, cliquez sur cet objet, puis sur [image] (Sélectionner encadrement-père) dans la barre d'outils.

4	Pour visualiser votre définition de modèle, affichez la vue Modèle de présentation de l'Editeur de modèles. Dans la liste déroulante Styles d'état, sélectionnez l'option d'affichage de la présentation des différents styles d'état.

5	Pour apporter d'autres modifications au style d'état affiché, revenez au Navigateur d'objet ou cliquez deux fois sur un objet pour afficher la Palette de propriétés. Notez que les modifications que vous apportez à un style d'état donné remplaceront les attributs définis sous le noeud Par défaut.


Définition d'attributs de modèle de remplacement

  Rubriques connexes

Pour définir des attributs de remplacement pour un style d'état sélectionné :

1	Dans le Navigateur d'objet, développez le noeud Modèle de présentation, puis le noeud Corps, sur le noeud Remplacement et enfin sur le noeud du style d'état pour lequel vous voulez définir des options de remplacement (par exemple, Tabulaire, Groupe gauche).

2	Pour modifier les propriétés par défaut de la présentation générale et l'espacement pour une section du style d'état sélectionné, cliquez deux fois sur [image] (icône de propriétés) en regard du noeud Section (Niveau n) pour afficher la Palette de propriétés.

3	Pour créer plus de sections que le nombre de sections par défaut pour un style d'état en particulier, cliquez sur un noeud Section (Niveau n), puis sur [image] dans la barre d'outils.

4	Pour supprimer une section dans un état particulier, cliquez sur un noeud Section (Niveau n), puis sur [image] dans la barre d'outils.  Remarque

5	Pour chacune des sections pour laquelle vous voulez définir des valeurs de remplacement, développez complètement le noeud Section (Niveau n), puis cliquez deux fois sur l'icône de propriétés pour afficher la Palette de propriétés des encadrements, des en-têtes/libellés de champs, des champs, des libellés récapitulatifs et des récapitulatifs (totaux).

Remarque : La vue Modèle de présentation est synchronisée avec le Navigateur d'objet ; lorsque vous sélectionnez un objet de présentation, le noeud qui lui est associé est mis en évidence dans le Navigateur d'objet. Pour sélectionner l'encadrement-père d'un objet de présentation, cliquez sur cet objet, puis sur [image] (Sélectionner encadrement-père) dans la barre d'outils.

6	Pour visualiser votre définition de modèle, affichez la vue Modèle de présentation de l'Editeur de modèles. Dans la liste déroulante Styles d'état, sélectionnez l'option d'affichage de la présentation des différents styles d'état.

7	Pour apporter d'autres modifications au style d'état affiché, revenez au Navigateur d'objet ou cliquez deux fois sur un objet de présentation pour afficher la Palette de propriétés. Notez que les modifications que vous apportez à un style d'état donné remplaceront les attributs définis sous le noeud Par défaut.


Ajout d'éléments et d'objets à un modèle

  Etape suivante	  Rubriques connexes

Pour ajouter des éléments et des objets à un modèle :

1	Dans la vue Modèle de présentation de l'Editeur de modèles, cliquez sur [image] dans la barre d'outils.

2	Reportez-vous aux rubriques Etapes suivant pour créer des objets dans la marge de votre modèle. Vous ne pouvez pas créer d'objets dans le corps d'un modèle.


Modification des objets d'un modèle

  Etape suivante	  Rubriques connexes

Pour modifier les objets dans la marge d'un modèle :

1	Dans la vue Modèle de présentation de l'Editeur de modèles, cliquez sur [image] dans la barre d'outils.

2	Reportez-vous aux rubriques Etape suivante pour modifier des objets dans la marge de votre modèle.


Modification de la couleur, du motif ou de la bordure des objets corps dans un modèle

  Etape suivante	  Rubriques connexes

Pour modifier les objets dans la marge d'un modèle :

1	Dans la vue Modèle de présentation de l'Editeur de modèles, faites votre choix dans la liste déroulante Style d'état.

•	Sélectionnez Par défaut pour modifier tous les styles d'état.

•	Sélectionnez un style d'état en particulier pour ne modifier que celui-là.

2	Reportez-vous aux rubriques Etape suivante pour modifier la couleur, le motif ou la bordure d'un objet.


Application d'un modèle à un état

  Rubriques connexes

Pour appliquer un modèle à un état :

1	Dans le Navigateur d'objet, cliquez sur l'état (ou la section de l'état) auquel vous voulez appliquer un modèle. Remarque

2	Choisissez Outils [image] Assistant Report.

3	Dans la page Modèle, sélectionnez un modèle prédéfini ou cliquez sur Fichier de modèle et sur Parcourir pour ouvrir le modèle choisi.

4	Cliquez sur Fin pour appliquer le modèle à la section actuelle de l'état.


Ajout d'un modèle à la liste de modèles prédéfinis

  Rubriques connexes

Pour ajouter votre propre modèle à la liste de modèles prédéfinis dans l'assistant Report :

1	Dans un éditeur de texte (par exemple, Wordpad), ouvrez le fichier de préférences.

2	Déplacez-vous jusqu'aux descriptions de modèle identifiées par Reports.xxx_Template_Desc (où xxx représente un style d'état).

3	Pour chaque style d'état pour lequel le modèle est défini :

à la liste Reports.xxx_Template_Desc, ajoutez la description à afficher sur la page Modèle de l'assistant Report ;

à la liste Reports.xxx_Template_File correspondante, ajoutez le nom de fichier de votre modèle au même endroit que celui de l'ajout effectué à la liste de descriptions.

4	Copiez le fichier de modèle (nomfichier.tdf) dans le répertoire indiqué par la variable d'environnement REPORTS30_PATH.

Pour inclure une image exemple de votre modèle dans l'assistant Report :

1	Pour chaque style d'état (tabulaire, etc.) pour lequel le modèle est défini, appliquez le modèle à un état exemple.

2	Utilisez un outil de capture d'écrans pour capturer une partie de chaque état exemple (pas plus de 2 pouces de largeur et de 3 pouces de hauteur) en format .bmp, en utilisant la convention d'appellation suivante :

yyyz.bmp

où

yyy	correspond au nom de fichier indiqué dans la liste Reports.xxx_Template_File
liste

z	identifie le style d'état :
a	Groupe - niveau supérieur
f	Formulaire
g	Matriciel avec groupe
l	Groupe - gauche
m	Etiquette de publipostage
r	Lettre type
t	Tabulaire
x	Matriciel

3	Copiez ou créez le fichier .bmp à utiliser par défaut (c'est-à-dire si aucun bitmap n'existe pour un style d'état donné) et nommez-le yyy.bmp.

4	Copiez chaque fichier .bmp dans le répertoire indiqué par la variable d'environnement REPORTS30_PATH.


Sous Windows, ouvrez ORACLE_HOME\CAUPREFS.ORA (préférences utilisateur) s'il existe ; sinon, ouvrez ORACLE_HOME\CAGPREFS.ORA (préférences globales).

Sous UNIX, ouvrez your_home_directory/prefs.ora (préférences utilisateur) s'il existe ; sinon, ouvrez $ORACLE_HOME/tools/admin/prefs.ora (références globales).


Tabular, BreakAbove, BreakLeft,FormLetter,Formlike, MailingLabel, Matrix, MatrixBreak.


Si vous sélectionnez dans le Navigateur d'objet le noeud correspondant à état dans son entier, le modèle est par défaut appliqué à la section principale de l'état. Pour l'appliquer à une section de votre état, sélectionnez le noeud correspondant dans le Navigateur d'objet.


Condition pour la liaison de deux interrogations

Par exemple :

Interrogation 1	deptno,ename,sal

Interrogation 2	salgrade,hisal,losal

Si vous indiquez ensuite un lien entre sal et hisal, puis un autre lien entre sal et losal, vous aboutirez probablement à l'état suivant :

WHERE SAL >= LOSAL AND SAL <= HISAL

mais si vous voulez vraiment un état de type :

WHERE SAL <= LOSAL OR SAL >= HISAL

vous ne pouvez pas seulement inverser les signes, sinon vous obtiendrez :

WHERE SAL <= LOSAL AND SAL >= HISAL

ce qui renvoie des lignes égales à zéro. Cela est-il possible ?

Les conditions de jointure entre les interrogations de Report Builder ne se limitent pas à celles que vous pouvez indiquer via des " liaisons de modèles de données " (c'est-à-dire la flèche que vous tracez entre deux colonnes dans le dessinateur de modèle de données). Si la condition de jointure ne peut être construite à l'aide d'une ou plusieurs liaisons de modèles de données, vous disposez des possibilités suivantes :

1	Etablissez la relation père-fils désirée entre les deux groupes en créant un " lien factice " (choisissez l'" outil lien " et cliquez sur le groupe père, puis sur le groupe fils).

2	Entrez la condition de jointure dans la clause WHERE de l'interrogation fille, en faisant référence aux colonnes de l'interrogation mère en tant que variables de lien. Dans votre cas, ajoutez ceci à la clause WHERE :
"WHERE :SAL <=LOSAL OR :SAL >=HISAL"

Et voilà ! Notez que les colonnes appartenant à l'interrogation mère peuvent être référencées en un endroit quelconque de l'interrogation fille et la condition de jointure peut être néanmoins complexe.


Liens entre les interrogations

Report Builder version 3.0 et versions ultérieures autorise les liens =, < ,<= ,<> ,>, >=,LIKE et NOT LIKE.


Différences entre les paramètres lexicaux et les paramètres de lien

Les références de lien permettent de remplacer une seule valeur dans SQL ou dans PL/SQL. En particulier, vous pouvez recourir aux références de lien pour remplacer des expressions dans les clauses SELECT, WHERE, GROUP BY, ORDER BY, HAVING,CONNECT BY et START WITH des interrogations. Les liens ne peuvent être référencés dans la clause FROM. Par exemple :

SELECT ORDID,TOTAL
FROM ORD
WHERE CUSTID = :CUST

Les références lexicales sont des variables permettant de remplacer du texte que vous incorporez dans une instruction SELECT. Vous pouvez recourir à 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 pas faire de références lexicales dans PL/SQL. Avant de référencer un paramètre lexical dans une interrogation, vous devez avoir prédéfini ce paramètre et lui avoir attribué une valeur initiale. Par exemple :

SELECT ORDID, TOTAL
FROM &ATABLE


Groupes de ventilation et leur création

Un groupe de ventilation permet de créer un état dans lequel des valeurs identiques dans des lignes successives ne sont imprimées qu'une seule fois pour les enregistrements associés. (En d'autres termes, un groupe de ventilation divise les colonnes d'une interrogation en sous-ensembles.)

Pour créer un groupe de ventilation :

1	Dans la vue Modèle de données de l'Editeur d'état, faites glisser le groupe contenant les colonnes sur lesquelles vous voulez ventiler votre état environ 5 centimètres en-dessous de l'objet interrogation.

2	Sélectionnez la colonne que vous voulez utiliser pour partager votre état (par exemple, si vous voulez regrouper une liste de données sur les employés par numéro de service, sélectionnez la colonne du numéro de service), puis faites-la glisser en-dehors et au-dessus du groupe pour créer un nouveau groupe.

3	Cliquez deux fois sur la barre de titre du nouvel objet groupe pour afficher sa feuille de propriétés. Remplacez le nom figurant dans le champ GENERAL : Nom si vous ne souhaitez pas utiliser la valeur par défaut. Remplissez le reste de la feuille de propriété et validez-la.


Différences entre les filtres de groupe et la propriété Nbre max de lignes

La propriété Nbre max de lignes limite le nombre réel d'enregistrements extraits par l'interrogation, alors qu'un filtre de groupe détermine quels enregistrements inclure ou exclure une fois que tous les enregistrements ont été extraits par l'interrogation. Puisque cette la propriété limite effectivement la quantité de données extraites, elle s'avère plus rapide d'un filtre de groupe dans la plupart des cas. Si vous utilisez un filtre Last ou Conditional, Report Builder doit extraire tous les enregistrements du groupe avant d'appliquer le filtre. De même, vous devez tenir compte du fait que l'utilisation de la propriété Nbre max de lignes dans une interrogation peut affecter les champs récapitulatifs dans les autres groupes dépendant de cette interrogation. Par exemple, si vous attribuez à cette propriété la valeur 8, tous les récapitulatifs basés sur cette interrogation n'utiliseront que les 8 enregistrements extraits.


Groupes dont l'impression commence à mi-page

Ce problème survient lorsque vous avez un nombre important d'interrogations et que chacune possède son propre encadrement de groupe associé. Le deuxième encadrement et les suivants sont implicitement ancrés à la page et donc poussés vers le bas jusqu'à leur position absolue dans la présentation. Pour y remédier, vérifiez que le deuxième encadrement et les suivants sont implicitement ancrés à l'encadrement précédent ; ainsi, lorsque le premier encadrement disparaît, le deuxième encadrement et les suivants remontent. Pour ce faire, le premier encadrement doit avoir une croissance verticale (variable) et les encadrements suivants ne doivent pas se trouver dans le chemin du premier.


Impression des numéros de page impairs à droite et pairs à gauche

Il vous faut créer deux champs, un à droite et l'autre à gauche. Dans le déclencheur de mise en forme de chaque champ, testez s'il s'agit d'une page impaire ou paire à l'aide de SRW.GET_PAGE_NUM. Ensuite, affichez ou non ce champ.


Léger décalage des objets de détail dans un état maître-détail

Il n'existe pas de paramètre modifiable vous permettant d'obtenir le décalage de votre choix, mais avec les versions 3.0 et ultérieures, vous pouvez utiliser le mode flexible pour déplacer vos objets de détail vers la gauche. Avec ce nouveau mode de présentation, cette opération est facile et rapide.


Nombre dynamique de valeurs dans les cellules d'un état matriciel

Au moment de l'exécution, il est possible d'ajuster la taille verticale des cellules de la matrice en fonction du nombre de valeurs correspondant à chaque cellule. Cela n'est pas possible dans la version 2.0, mais les versions 3.0 et ultérieures de Report Builder sont capables de gérer les cellules variables dans le sens vertical.


Modification simultanée du masque de format pour un ensemble de champs

Procédez simplement comme suit :

1	Ouvrez la vue Modèle de présentation de l'Editeur d'état.

2	Sélectionnez les champs à modifier.

3	Choisissez Outils [image] Palette de propriétés.

4	Sélectionnez un nouveau masque de format pour la propriété Masque de format.


Zone imprimable et sa visualisation

La zone imprimable est la partie matérielle de la page physique sur laquelle votre imprimante peut imprimer. La plupart des imprimantes ne peuvent généralement pas imprimer jusqu'au bord de la page et laissent ainsi une zone vierge non imprimable. Avec Report Builder versions 3.0 et ultérieures, vous pouvez visualiser la zone imprimable en procédant comme suit :

1	Sélectionnez votre imprimante, puis Fichier [image] Configuration de l'imprimante

2	Entrez dans la vue Modèle de présentation de l'Editeur d'état et cliquez sur

A l'écran, la zone imprimable correspond à la zone comprise entre les lignes pointillées dans la zone de marge.

3	Choisissez Afficher [image] Zoom arrière pour agrandir la zone affichée.


Performances lors de la modification ou du déplacement d'un objet

Avant tout, sachez que cela n'intervient que pour des états très volumineux comportant un grand nombre d'objets. Pour améliorer les performances, il vous suffit de procéder comme suit :

1	Choisissez Affichage [image] Type d'objet ou réduisez le Navigateur d'objet.

2	Désactivez le mode Confiné.


Affichage des ancrages implicites dans l'Editeur de présentation

Vous ne pourrez voir que les points d'ancrage explicites créés à partir de la vue Modèle de présentation de l'Editeur d'état. Il existe cependant une option du Navigateur vous permettant d'afficher les informations d'ancrage. Si vous choisissez cette option, vous pourrez voir à partir du Navigateur d'objet toutes les informations relatives aux points d'ancrage implicites et explicites.


Moment exact de l'activation du déclencheur Before Report

Le déclencheur Before Report se déclenche avant l'exécution de l'état mais après l'analyse des interrogations.

L'ordre est donc le suivant :

1	Les interrogations sont analysées.

2	Le déclencheur Before Report est déclenché.

3	L'état est exécuté (c'est-à-dire que les données sont extraites et que la sortie est formatée).

La cohérence est garantie en cas de DML ou de DDL dans (ou avant) le déclencheur After Form. Elle n'est pas garantie dans le déclencheur Before Report, car des travaux doivent être faits sur les curseurs de données avant ce déclencheur sur la base de la définition de l'état. Les tables impliquées et les curseurs ouverts doivent toujours être décrits avant l'activation du déclencheur Before Report. Toute modification ultérieure des tables n'apparaîtra pas dans l'état.


Ordre des déclencheurs d'état

1	Before Parameter Form

2	After Parameter Form

3	Before Report

4	Between Pages

5	After Report


Horloges

Actuellement, les versions 3.0 et ultérieures de Report Builder ne prennent pas en charge les horloges de la même façon que Graphic Builder. Il est possible d'activer et de visualiser les canaux de base de données et les horloges à l'aide de Report Builder, si nécessaire. Si vous utilisez le serveur d'états pour exécuter vos états, vous pouvez recourir à RWCLI60 ou au gestionnaire de files d'attente d'états pour planifier les travaux.


Bibliothèques attachées et PL/SQL local

Le code PL/SQL local s'exécute plus rapidement qu'une référence à une procédure ou à une fonction dans une bibliothèque PL/SQL externe. Par conséquent, ne recourez aux bibliothèques PL/SQL externes que si les avantages du partage du code par plusieurs applications compensent l'altération des performances.


Unités de programme faisant largement appel à SQL sur le client ou sur le serveur

Dans tous les cas où vous avez des unités de programme qui font largement appel à SQL, vous obtiendrez de meilleures performances en partitionnant ces unités de programme sur le serveur. Une autre possibilité consiste à les ajouter au modèle de données chaque fois que c'est possible. Elles seront ainsi traitées comme une interrogation.


Migration d'états SQL*Report

Etant donné les différences entre les deux produits, il n'existe pas de conversion directe à partir de SQL*Report(RPT). Voici cependant quelques conseils :

•	La plupart des macros SELECT principales seront transformées en interrogations. Vous pouvez les enregistrer dans un fichier puis importer le texte dans la feuille de propriétés de l'interrogation, sans oublier de supprimer la clause INTO.

•	Toutes les instructions .ASK deviendront des paramètres.

•	La logique conditionnelle est désormais transformée en PL/SQL à l'intérieur de l'état.

•	Toutes les instructions .TELL deviendront SRW.MESSAGE.

•	Une fois les interrogations créées, laissez Report Builder créer une présentation par défaut.

•	Ajoutez la logique conditionnelle nécessaire et modifiez la présentation par défaut le cas échéant.

Une autre possibilité consiste à décompiler les états RPT dans Designer/2000 et générer ainsi des états Report Builder.


Mise à niveau directe de SQL*ReportWriter 1.1 à la version 2.5

Utilisez simplement l'exécutable R25MREP. Pour plus de détails, reportez-vous au manuel Report Builder 2.5 Migration Manual. R25MREP est inclus dans Reports version 2.5, mais pas dans Report Builder version 3.0. Puisque les états de la version 2.5 peuvent s'ouvrir dans les versions 3.0 et ultérieures, un exécutable de mise à niveau pour les versions 3.0 et ultérieures est inutile.


Mise à niveau de la version 2.5 vers les versions 3.0 et ultérieures

Aucune mise à niveau n'est nécessaire, car les versions 3.0 et ultérieures peuvent ouvrir les états de la version 2.5.


Utilisation du paramètre ORACLE.INI de Windows pour rechercher des fichiers externes dans un état (fichiers rdf/rep ou .sql, fichiers image)

Algorithme et paramètres de Report Builder utilisés pour la recherche de fichiers :

Numéro de version	Algorithme de recherche
2.00,12.x	RW20_PATH dans le fichier ORACLE.INI
2.00,13.x	RW20_PATH dans le fichier ORACLE.INI
2.0.14.x	Recherche dans le répertoire de travail, puis dans les répertoires indiqués par REPORTS_PATH dans ORACLE.INI, et ensuite dans les répertoires indiqués par ORACLE_PATH dans le fichier ORACLE.INI.
2,5.x	Recherche dans le répertoire de travail, puis dans les répertoires indiqués par REPORTS25_PATH dans ORACLE.INI, et ensuite dans les répertoires indiqués par ORACLE_PATH dans le fichier ORACLE.INI.
3.0.x	Recherche dans le répertoire de travail, puis dans les répertoires indiqués par REPORTS30_PATH dans ORACLE.INI, et ensuite dans les répertoires indiqués par ORACLE_PATH dans le fichier ORACLE.INI.
Remarques :

•	Vous pouvez indiquer pour les paramètres ci-dessus plusieurs répertoires séparés par des points-virgules. La syntaxe suivante, par exemple, est valide :

REPORTS60_PATH=C:\ORAWIN\APPS;C:\APPS;D:\TEST

•	Les versions 6.0 et ultérieures utilisent la base de registres, et non ORACLE.INI, pour configurer l'environnement. REPORTST60_PATH établit le répertoire de stockage des fichiers externes.


Utilisation du paramètre ORACLE.INI de Windows pour modifier l'emplacement de création des fichiers temporaires

Numéro de version	Modification de l'emplacement des fichiers temporaires
2.00,12.x	Variable TMP en environnement DOS. Ajoutez SET TMP=<répertoire valide> dans le fichier AUTOEXEC.BAT.
2.00,13.x	Paramètre %TMP% dans ORACLE.INI et TMP en environnement DOS. Ajoutez %TMP%=<répertoire valide> dans le fichier ORACLE.INI. Ajoutez SET TMP=<répertoire valide> dans le fichier AUTOEXEC.BAT.
2.0.14.x	Paramètre REPORTS_TMP dans ORACLE.INI. S'il n'est pas défini, utilisez le répertoire de travail.
2,5.x	Paramètre REPORTS25_TMP dans ORACLE.INI. S'il n'est pas défini, utilisez le répertoire de travail.
3.0.x	Paramètre REPORTS30_TMP dans ORACLE.INI. S'il n'est pas défini, utilisez le répertoire de travail.
Remarque : Les versions 6.0 et ultérieures utilisent la base de registres, et non ORACLE.INI, pour définir les variables d'environnement. REPORTST60_TMP établit le répertoire de stockage des fichiers temporaires de Report Builder.


Prise en charge de OLE2

Les versions 3.0 et ultérieures de Report Builder se comportent comme un conteneur OLE2, ce qui permet d'incorporer un objet OLE2 statique ou dynamique. Ces objets peuvent être stockés dans la base de données ou dans le système de fichiers.

L'utilisation de OLE2 Automation est également possible. Vous trouverez dans l'état de démonstration OLEX.RDF un exemple à ce sujet.


Création d'un état ASCII qui s'imprime en mode paysage

Créez votre état comme tout autre état ASCII. L'étape la plus importante consiste à vérifier que le fichier de définition d'imprimante (fichier .PRT) utilisé par l'état contient les séquences d'échappement nécessaires à l'imprimante pour modifier l'orientation de l'impression sur le papier. Ces séquences d'échappement varient selon les imprimantes.

Pour connaître les séquences d'échappement adéquates, reportez-vous à la documentation de votre imprimante. Vérifiez également que la hauteur et la largeur indiquées dans le fichier .PRT correspondent à celles figurant dans la définition de l'état.


Prise en charge de PCL5

La version 2.5.5.2 et les versions ultérieures sous Motif et sous Windows prennent en charge le langage PCL (niveau 5) de Hewlett-Packard. Les versions précédentes ne prennent en charge PCL que sous Windows.


Génération de code PostScript

Report Builder crée du code PostScript niveaux 1 et 2 sous MS-Windows et sous Motif. Tous les autres pilotes d'imprimante sont également pris en charge sous Windows et PCL5 est pris en charge sous Motif.


Impression sur une imprimante PostScript comme à l'écran

La sortie papier aura exactement la même apparence que dans l'Aperçu (contrairement à la présentation qui constitue un niveau supérieur).


Boîte de dialogue de progression de RUN_PRODUCT

La boîte de dialogue de progression de RUN_PRODUCT est appelée en MODE synchrone.


Définition des valeurs de paramètres pour une exécution à partir de Form Builder

Si vous désirez supprimer la grille de paramètres de Report Builder et que l'état attribue une valeur par défaut à DESTYPE, il vous faudra créer un paramètre de liste pour transmettre explicitement les valeurs de DESTYPE et de PARAMFORM.


Affichages Graphics Builder illisibles

Lorsque vous créez un objet Graphics Builder, vous faites normalement glisser une zone de dimensions n x n pour contenir cet objet. Par défaut, les options de dimensionnement de cet objet ont pour valeur FIXE, horizontalement comme verticalement.

Lorsque vous créez votre graphique dans Graphics Builder, une zone de dimensions n x n est également définie pour l'affichage. Vous devez vérifier que l'objet Graphics Builder créé dans Report Builder a les mêmes dimensions n x n ou que ses options de dimensionnement ne sont pas de type FIXE.

Par exemple, vous avez défini dans Graphics Builder une taille de 3 x 5 pour un graphique, et dans Report Builder, l'objet Graphics Builder a une taille définie de 3 x 3. Au moment de l'exécution, Report Builder doit mettre à l'échelle l'affichage de 3 x 5 pour qu'il tienne dans la taille de 3 x 3 définie dans l'état. Pour certains objets Graphics Builder, cela peut entraîner la création d'un graphique incorporé illisible. Pour résoudre ce problème, modifiez simplement les propriétés de dimensionnement de l'objet en leur donnant la valeur VARIABLE.

Si, pour une raison quelconque, le problème subsiste, vous pouvez modifier la taille de présentation de l'affichage pour qu'elle ait les mêmes dimensions que le graphique défini.

Remarque : Normalement, la modification des propriétés de dimensionnement dans Report Builder suffit à résoudre le problème.


Transfert de paramètres (par exemple, plages de données) à Report Builder fonctionnant par lots

Utilisez simplement des variables de lien dans votre interrogation pour la limiter et transmettez-lui vos valeurs à l'aide des paramètres de la ligne de commande :

Interrogation :

SELECT * FROM EMP WHERE HIREDATE BETWEEN
:FROM_DATE AND :END_DATE

Exécution :

RWRUN60 REP1 SCOTT/TIGER FROM_DATE='12-JUN-92'
END_DATE='24-JUN-92'


Erreur d'état infini

Dans la version 2.5, si la bordure d'un objet s'étend au-delà de la limite d'une page, il se produit une erreur d'état infini. Dans les versions 3.0 et ultérieures, Report Builder repousse automatiquement ces objets à l'intérieur des limites de la page et évite ainsi l'erreur d'état infini. Puisque la version 2.5 n'offre pas cette fonctionnalité, un état qui s'exécute sans erreur dans la version 3.0 ou dans les versions ultérieures peut générer une erreur d'état infini dans la version 2.5.


Mots réservés

Les mots réservés de Report Builder comprennent les arguments de ligne de commande ainsi que les procédures, les fonctions et les exceptions de Report Builder. Reportez-vous à RWCON60, RWBLD60, RWRUN60 et Package  PL/SQL Report Builder (SRW).


Limitation des interrogations

Reports Runtime peut limiter le nombre de pages produites par un utilisateur. Pour cela, insérez dans la table PRODUCT_PROFILE un enregistrement correspondant à cet utilisateur.


Redémarrage d'un état interrompu pendant son traitement

Il n'existe aucune possibilité pour ce faire.


Désactivation par programme du bouton Imprimer de l'Aperçu

Il s'agit actuellement d'une demande d'amélioration, envisagée pour une future version du produit.


Agrandissement par programme de l'Aperçu à l'exécution et indication de sa position à l'écran

Il s'agit actuellement d'une demande d'amélioration, envisagée pour une future version du produit.


Interception de toutes les erreurs pour afficher des messages personnalisés comparables aux déclencheurs d'applications Forms ON-ERROR et ON-MESSAGE

Il s'agit actuellement d'une demande d'amélioration, envisagée pour une future version du produit.


Installation des tables spécifiques au produit pour Report Builder

Avec Report Builder versions 3.0 et ultérieures, il n'est pas indispensable d'installer les tables propres au produit. Le seul moment où ces tables sont nécessaires est lors de l'exécution d'un état sur un état particulier. Pour qu'un état sur un état puisse s'exécuter, il faut en effet que l'état concerné soit stocké dans la base de données.


Déplacement des objets et des couches dans la vue Modèle de présentation

  Rubriques connexes

Dans la vue Modèle de présentation de l'Editeur d'état, les objets doivent faire partie d'une couche supérieure à celle des objets qui les englobent. Par exemple, les champs appartenant à un encadrement itératif doivent être au moins une couche au-dessus de cet encadrement itératif dans la vue Modèle de présentation. Dans le cas contraire, ils ne sont plus considérés comme englobés par l'encadrement itératif, ce qui entraîne une erreur de fréquence au moment de l'exécution. Si vous déplacez ou regroupez des objets dans la vue Modèle de présentation, la modification de l'organisation des couches peut entraîner des erreurs de fréquence lors de l'exécution de l'état. Pour éviter ce problème, recourez au mode Confiné ou au mode Flexible pour déplacez des objets dans la vue Modèle de présentation.


Temps de connexion de SQL*Net TCP/IP
Temps de connexion d'Oracle Net8

Une cause fréquente de l'allongement des temps de connexion est l'utilisation de DNS (Domain Name Service) alors qu'il n'est pas disponible sur le réseau ou ne fonctionne pas très bien. Certaines installations de TCP/IP utilisent DNS par défaut. Si tel est le cas et qu'aucun serveur DNS n'est disponible sur votre réseau ou qu'il ne fonctionne pas correctement, le temps de connexion peut atteindre 1 minute ou davantage. Par exemple, si aucun serveur DNS ne répond à une demande de résolution de nom d'hôte, cette demande sera réitérée plusieurs fois, en doublant le délai entre chaque tentative. Si, après plusieurs tentatives, cette demande n'obtient aucune réponse, elle consulte alors un fichier de noms d'hôte local.

Ainsi, si vous constatez un temps de connexion inhabituellement long bien que vous utilisiez un fichier de noms d'hôte local, assurez-vous que votre installation TCP n'essaye pas d'abord d'utiliser DNS. Un moyen facile de le vérifier consiste à remplacer le nom d'hôte dans votre chaîne de connexion par l'adresse IP du serveur auquel vous essayez de vous connecter.


SQL*Net TCP/IP Version 1 vers Net8

Bien que les temps de connexion de SQL*Net TCP/IP version 2 peuvent s'avérer plus longs que ceux de SQL*Net TCP/IP version 1, la différence ne devrait pas être très importante. Certains des produits antérieurs de SQL*Net TCP/IP version 1 étaient microcodés de façon à utiliser un fichier local de noms d'hôte et contenaient du code permettant de vérifier le nom réel eux-mêmes en transmettant une adresse IP à la pile de protocole. Ainsi, la pile de protocole n'avait aucune résolution à effectuer.

Net8, en revanche, n'effectue plus aucune résolution lui-même. Il transmet simplement la valeur obtenue de TNSNAMES.ORA à la pile de protocole pour résolution du nom. Si votre pile de protocole est configurée pour essayer d'abord la résolution par DNS et que vous ne disposiez d'aucun serveur DNS qui fonctionne correctement, le passage de la version 1 vers Net8 allongera les temps de connexion dans des proportions énormes.

Si vous craignez que ce soit le cas, essayez de remplacer le nom d'hôte par une adresse IP en construisant vos adresses TNS et voyez si vous constatez une amélioration significative des temps de connexion.


Délai par défaut Net8

Le délai de la première tentative de connexion est contrôlé par le protocole sous-jacent et n'a rien à voir avec la détection d'une connexion interrompue (ni avec Net8). Une application utilisant une connexion non bloquante (7.2 OCI ou version ultérieure) peut quelque peu tempérer ce fait (puisqu'elle peut décider de sortir pour accomplir d'autres tâches si elle découvre que la connexion est sur le point de se bloquer).


Traçage d'état

La meilleure façon de suivre les performances de votre état consiste à recourir aux arguments exécutables de trace de Report Builder. Pour ce faire, procédez comme suit :


SQL TRACE

La fonction TRACE vous communique exactement les instructions qui sont en cours d'analyse. Une fois que vous les connaissez, vous pouvez calculer leur durée dans SQL*Plus et multiplier cette durée par le nombre estimé de lignes à extraire de la base de données. (Ne comparez que des choses comparables, c'est-à-dire l'envoi de données vers un fichier et non vers l'écran. Ne changez rien aux instructions SQL en les transférant dans SQL*Plus ; la plus petite modification dans la clause WHERE peut avoir d'énormes conséquences en matière de performances.)

Vous disposez de deux possibilités pour suivre la trace de vos états : au niveau utilisateur et au niveau système. Nous vous recommandons le niveau utilisateur (car vous trouverez plus facilement les informations dont vous avez besoin), mais vous trouverez ci-dessous la procédure correspondant aux deux méthodes. Pour plus d'informations sur SQL TRACE, reportez-vous à ORACLE8 Server SQL Language Reference Manual.

Trace au niveau utilisateur

1	Ouvrez l'état pour lequel vous souhaitez obtenir des données de performances.

2	Créez une colonne formule au niveau état nommée SQL-TRACE dont la formule est la suivante :

SRW.DO_SQL ('ALTER SESSION SET SQL_TRACE=TRUE');
return(1);  --Formulas must return a value.

Remarque : Vous pouvez également appeler SQL TRACE à partir du déclencheur Before Form.

3	Exécutez l'état. Un nouveau fichier du nom de <numéro>.trc est créé dans ORACLE_HOME/rdbms/log ou dans l'emplacement indiqué par le paramètre USER_DUMP_DEST de init.ora. (L'horodatage du fichier peut vous permettre de déterminer quel est le fichier .trc qui vous appartient.)

4	Utilisez la commande TKPROF pour mettre en forme le fichier de trace en sortie.

Si vous exécutez plusieurs traces pendant une session RWBLD60, les sorties de trace sont concaténées dans le même fichier.

Trace au niveau système

1	Insérez ces instructions dans votre fichier init.ora : SQL_TRACE=TRUE et TIMED_STATISTICS=TRUE.

2	Arrêtez, puis redémarrez votre base de données.

Toute interaction avec la base de données sera tracée et le fichier ORACLE_HOME/rdbms/log est susceptible d'atteindre une taille très importante.


Préférences de conception

Adoptez les préférences suivantes pour accélérer le développement de votre état :

•	Supprimer Editeur d'état à l'ouverture

•	Supprimer extraction de liste sur entrée

•	Accès objets (de Système de fichiers)

Commentaire :     L'option Supprimer l'Editeur d'état à l'ouverture  empêche Report Builder d'ouvrir l'Editeur d'état chaque fois que vous ouvrez un état. L'option Supprimer extraction de liste sur entrée réduit le temps nécessaire à l'ouverture d'une boîte de dialogue, car Report Builder n'extrait pas les listes qu'elle contient. La définition de Accès objets à Fichier ou à Base de données évite l'affichage de la boîte de dialogue lorsque vous accédez à des fichiers, à d'autres modules ou à des objets de base de données.


Modèles

Si certains éléments d'état se répètent dans plusieurs des états que vous créez, envisagez de créer un modèle pour ces états.

Commentaire : L'utilisation de modèles permet de gagner du temps en vous évitant d'avoir à recréer les mêmes objets et paramètres chaque fois que vous créez un nouvel état.


Nombre d'interrogations

Réduit au minimum le nombre d'interrogations de votre état. En général, moins il y a d'interrogations, plus l'état s'exécute rapidement. Bien que les modèles de données multi-interrogations soient souvent plus faciles à comprendre, les modèles de données mono-interrogations ont tendance à s'exécuter plus rapidement.

Les seuls cas où vous devez utiliser un modèle de données multi-interrogation sont les suivants :

•	lorsque vous extrayez de nombreuses colonnes de grande taille de la base de données père et seulement quelques petites colonnes de la base de données fils ;

•	lorsque vous essayez d'effectuer des tâches qui ne sont pas directement prises en charge par SELECT (par exemple, une jointure externe multidirectionnelle) ;

•	lorsque vous avez des vues complexes (par exemple, des interrogations réparties ou des interrogations GROUP BY) ;

•	lorsque vous avez besoin d'une vue mais que vous ne devez ou ne voulez pas l'utiliser.

Commentaire : Dans le cas d'un état mono-interrogation, Report Builder n'ouvre qu'un seul curseur pour extraire tous les enregistrements maître et détail. Dans le cas d'un état à deux interrogations, Report Builder ouvre deux curseurs (un pour chaque interrogation) après avoir ajouté le lien de l'interrogation détail à la clause WHERE appropriée. Ainsi, pour chaque enregistrement maître extrait dans l'interrogation maître, Report Builder doit relier, exécuter et extraire les données de l'interrogation détail.


Instructions SQL

L'exécution d'opérations dans SQL est plus rapide que dans Report Builder ou dans PL/SQL. La liste ci-dessous énumère les cas les plus courants dans lesquels SQL améliore les performances :

•	effectuez les calculs directement dans votre interrogation plutôt que dans une formule ou dans un récapitulatif ;

•	utilisez une clause WHERE au lieu d'un filtre de groupe ou d'un déclencheur de mise en forme pour exclure des enregistrements ;

•	utilisez la fonction SUBSTR pour tronquer les chaînes de caractères au lieu de le faire dans Report Builder.

Commentaire : SQL effectue les calculs plus rapidement qu'un récapitulatif ou une formule. Les clauses WHERE et SUBSTR réduisent le nombre d'extractions inutiles car elles agissent sur les données pendant leur extraction, et non après. L'amélioration des performances est plus nette lors de l'extraction de milliers d'enregistrements que lors de l'extraction de quelques enregistrements.


Modifications d'interrogations

Report Builder modifie vos interrogations dans les cas suivants :

•	Pour chaque lien que vous créez, Report Builder ajoute une clause à la fin de l'interrogation fils comme indiqué dans le lien. Prenons l'exemple de l'interrogation suivante :

     SELECT DEPTNO, ENAME, SAL FROM EMP
     WHERE SAL > 1000

Si vous créez un lien vers cette interrogation en utilisant DEPTNO comme colonne fils, une clause SQL WHERE, et une condition = (égal à), votre interrogation sera modifiée comme suit :

     SELECT DEPTNO, ENAME, SAL FROM EMP
     WHERE (SAL > 1000) AND (DEPTNO = :DEPTNO)

Remarque : Cela ne s'applique pas aux modèles de données d'états matriciels multi-interrogations.

•	Pour chaque colonne de base de données dont l'ordre de ventilation est défini, Report Builder ajoute une clause ORDER BY au début de l'interrogation. Prenons l'exemple de l'interrogation suivante :

     SELECT DEPTNO, ENAME, SAL FROM EMP
     ORDER BY SAL

Si vous créez un groupe de ventilation avec DEPTNO comme colonne de ventilation, votre interrogation sera modifiée comme suit :

     SELECT DEPTNO, ENAME, SAL FROM EMP
     ORDER BY 1, SAL

Ces instructions SQL seront envoyées à la base de données et c'est ensuite le rôle de l'optimiseur SQL de déterminer la meilleur façon d'extraire les données de la base de données et de les retourner à Report Builder. L'optimiseur détermine s'il faut ou non utiliser des index, la table à utiliser comme table " pilote ", etc.

Pour plus d'informations sur les instructions SQL, reportez-vous à ORACLE8 Server Application Developer's Guide. Pour plus d'informations sur l'optimiseur SQL, reportez-vous à ORACLE8 Server Concepts Manual.


Index

Ajoutez des index sur les colonnes utilisées dans les clauses WHERE des instructions SELECT, sur les colonnes clés de base de données et sur les tables des interrogations détail. Les index ont peut d'impact sur les interrogations maître car celles-ci n'accèdent à la base de données qu'une seule fois. Cependant, les index améliorent de façon significative les performances des états maître/détail. Plus faible est le rapport entre les enregistrements maître et détail, plus importants deviennent les index sur l'interrogation détail pour les états à deux interrogations.

Commentaire : Les index sont recommandés sur les tables des interrogations détail, car Report Builder crée de façon implicite une clause WHERE à partir des relations père-fils et l'ajoute à l'interrogation détail.


Instructions SRW.DO_SQL

N'utilisez la procédure SRW.DO_SQL qu'en cas de nécessité. Affectez-la alors à un groupe qui n'extrait que quelques enregistrements ou à un objet au niveau de l'état (qui est analysé, ouvre un état et ne s'exécute qu'une seule fois). SRW.DO_SQL vous permet d'ajouter une opération DDL ou DML quelconque à votre état. Cette fonctionnalité est très précieuse mais peut s'avérer très coûteuse si on en abuse.

Commentaire : Tout comme les interrogations, les instructions SRW.DO_SQL sont analysées, ouvrent un curseur vers la base de données et s'exécutent. Contrairement aux interrogations, cependant, l'instruction SRW.DO_SQL effectue ces opérations chaque fois que son propriétaire (par exemple, un groupe) extrait des données. (Par exemple, si votre instruction SRW.DO_SQL appartient à un groupe qui extrait 10 enregistrements, l'instruction sera analysée 10 fois, 10 curseurs seront ouverts et l'instruction sera exécutée 10 fois.) Pour cette raison, les calculs (par exemple, :sal + :com) doivent être exécutés à partir de l'interrogation ou de PL/SQL, et non dans une instruction SRW.DO_SQL appartenant à un groupe.


Nombre maximum de lignes et filtres de groupe

Utilisez la propriété Nbre max de lignes à extraire de votre interrogation (ou la procédure SRW.SET_MAXROW) pour limiter le nombre d'enregistrements extraits par les interrogations de l'état. Lorsque vous concevez un état qui extrait de nombreux enregistrements ou accède à des informations sur un réseau très chargé, il peut s'avérer intéressant de réduire la quantité des données extraites pour accélérer l'exécution de l'état pendant la période de test.

Commentaire : La propriété Nbre max de lignes à extraire limite le nombre d'enregistrements extraits par l'interrogation. Un filtre de groupe détermine les enregistrements à inclure et à exclure. Puisque la propriété Nbre max de lignes à extraire limite effectivement la quantité de données extraites, elle est plus rapide qu'un filtre de groupe dans la plupart des cas. Si vous utilisez un filtre de type Last ou PL/SQL, Report Builder doit extraire tous les enregistrements du groupe avant d'appliquer les critères du filtre. Par conséquent, la propriété Nbre max de lignes à extraire ou un filtre de type First sont plus rapides.

Lorsque vous indiquez un filtre de type First n pour un groupe, Report Builder extrait autant de tableaux que nécessaire pour obtenir les n premiers enregistrements du groupe. La taille du tableau extrait est déterminée par le paramètre ARRAYSIZE. Par conséquent, un filtre de type First peut extraire plus d'enregistrements que nécessaire. Par exemple, si vous indiquez un filtre de type First 5 et un paramètre ARRAYSIZE tel que chaque tableau contient 10 enregistrements, 5 enregistrements inutiles seront extraits. Lorsque vous indiquez pour une interrogation la propriété Nbre max de lignes à extraire, Report Builder n'extrait que le nombre d'enregistrements que vous avez indiqué. Un paramètre de 5 pour Nbre max de lignes à extraire aboutit à l'extraction de seulement 5 enregistrements.

Généralement, la propriété Nbre max de lignes à extraire est plus rapide qu'un filtre de type First, car elle n'extrait que le nombre d'enregistrements nécessaires. Les différences de performances, cependant, peuvent varier selon le paramètre ARRAYSIZE que vous avez indiqué.

Remarque : Soyez prudent en utilisant la propriété Nbre max de lignes à extraire sur des interrogations dont dépend un groupe. Par exemple, si vous donnez la valeur 5 à la propriété Nbre max de lignes à extraire pour une interrogation fils, un récapitulatif de l'interrogation fils contenu dans le groupe père n'utilisera que les 5 enregistrements extraits par l'interrogation.


Objets de modèle de données inutilisés

Vérifiez que vous effacez ou supprimez tous les objets de modèle de données qui ne sont pas effectivement utilisés dans votre état. Si votre modèle de données contient une interrogation qui n'est utilisée que dans certains cas (c'est-à-dire, lorsqu'un paramètre a une certaine valeur), vous pouvez supprimer cette interrogation de façon conditionnelle à l'aide de la procédure SRW.SET_MAXROW. SRW. SET_MAXROW (interrogation, 0) empêche l'interrogation d'extraire des enregistrements.

Commentaire : Report Builder traite tout ce qui se trouve dans la vue Modèle de données, ce qui peut ralentir inutilement votre état, sauf si vous effacez ou supprimez toutes les interrogations inutiles.


Colonnes de ventilation

Lorsque vous créez un groupe de ventilation, insérez aussi peu de colonnes que possible dans ce groupe. Autant que faire se peut, limitez à une seule le nombre de colonnes de ventilation par groupe de ventilation.

De plus, essayez de faire en sorte que la colonne de ventilation soit la plus petite possible. Une colonne de ventilation plus courte donne généralement de meilleures performances qu'une colonne plus longue. Pour les colonnes de ventilation de taille plus importante, il peut être bénéfique pour les performances de recourir à la fonction SUBSTR pour réduire la longueur de la colonne.

Commentaire : Report Builder ajoute les colonnes de ventilation de chaque groupe de ventilation au début de la clause ORDER BY de l'interrogation. (La seule exception à cette règle est le cas où la colonne de ventilation est une colonne formule.) En réduisant le nombre de colonnes de ventilation dans vos groupes de ventilation, vous réduisez le nombre de colonnes ajoutées à la clause ORDER BY. Moins il y a de colonnes dans la clause ORDER BY, moins important est le traitement nécessaire lors de l'exécution de l'interrogation. La taille de la clé utilisée de façon interne par Report Builder pour créer les index sera également plus réduite, d'où une amélioration des performances.


Plusieurs présentations et une seule source

Report Builder peut afficher les données d'une même source plusieurs fois dans la sortie d'un état. Si vous voulez afficher les mêmes données plusieurs fois sur la sortie, utilisez le même objet de modèle de données comme source pour tous les objets de présentation.

Supposons par exemple que vous voulez faire apparaître dans une liste tous les employés qui gagnent plus de 10000 F et dans une autre liste tous ceux qui gagnent moins de 10000 F. Pour ce faire, vous écrivez une interrogation qui sélectionne toutes les données, puis vous créez deux présentations distinctes basées sur les mêmes données. Dans une présentation, l'encadrement itératif contiendra un déclencheur de mise en forme qui n'affiche que les instances où SAL est égal ou supérieur à 10000 F. Dans l'autre, l'encadrement itératif contiendra un déclencheur de mise en forme qui n'affiche que les instances où SAL est inférieur à 10000 F.

Commentaire : Un état qui extrait les données une seule fois et les présente plusieurs fois s'exécute plus rapidement qu'un état qui extrait les données une fois pour chaque présentation différente.


Matrices

Deux méthodes peuvent améliorer les performances des états matriciels :

Interrogations moins nombreuses

Clauses WHERE

Remarque : Les groupes inter-produits génèrent toujours une " extraction aval ". La raison en est que pour résoudre les références croisées des données d'un groupe inter-produit, Report Builder doit d'abord extraire toutes les données.


Interrogations moins nombreuses

Comme avec les autres types d'états, des interrogations moins nombreuses aboutissent à une exécution plus rapide. Afin d'améliorer les performances, n'utilisez qu'une seule interrogation dans vos états matriciels.

Commentaire : Dans le cas d'un état mono-interrogation, Report Builder n'ouvre qu'un seul curseur pour extraire tous les enregistrements maître et détail. Dans le cas d'un état multi-interrogation, Report Builder ouvre plusieurs curseurs.


Clauses WHERE

Pensez à ajouter une clause WHERE pour l'interrogation de cellules matricielles d'un modèle de données multi-interrogation. Si vous utilisez un modèle de données multi-interrogation et que vos interrogations de dimension sont limitées par une clause WHERE, l'ajout d'une clause WHERE à l'interrogation de cellules matricielles garantit que vous ne pourrez pas extraire plus d'enregistrements que nécessaire. Prenons l'exemple des interrogations de dimensions suivantes :

Q_Dept:

SELECT DEPTNO FROM DEPT
            WHERE DEPTNO < 100

Q_Job:

SELECT DISTINCT JOB FROM EMP
            WHERE DEPTNO < 100

Pour garantir que votre interrogation de cellules n'extrait que les enregistrements nécessaires, écrivez l'instruction SELECT suivante :

Q_Filler:

SELECT DEPTNO, JOB, SUM(SAL) FROM EMP
             WHERE DEPTNO IN (SELECT DEPTNO FROM DEPT
             WHERE DEPTNO < 100) AND JOB IN (SELECT
             DISTINCT JOB FROM EMP WHERE DEPTNO < 100)
             GROUP BY DEPTNO, JOB

Si vous n'avez pas ajouté de clause WHERE à cette interrogation, tous les enregistrements seront extraits de la base de données, indépendamment de votre sélection dans Q_Dept et Q_Job.

Remarque : Si vous avez ajouté une clause WHERE qui n'utilise pas les sous-interrogations (par exemple, WHERE EMP.DEPTNO = DEPT.DEPTNO), l'interrogation sera exécutée une fois pour chaque combinaison de valeurs du groupe inter-produit. Cela peut entraîner une exécution excessive de l'interrogation de remplissage si les combinaisons sont nombreuses.

Commentaire :  Report Builder n'ajoute pas de clause WHERE à l'interrogation de remplissage dans un modèle de données matriciel multi-interrogation. La raison en est que l'interrogation de remplissage  ne sera exécutée qu'une seule fois. (Sinon, l'interrogation serait effectuée une fois pour chaque combinaison de valeurs dans le groupe inter-produit.) Cependant, si vos interrogations de dimension limitent de façon significative le nombre d'enregistrements extraits, l'absence de clause WHERE sur l'interrogation de remplissage peut entraîner l'extraction d'un grand nombre d'enregistrements inutiles. Pour éviter cela, vous pouvez ajouter vous-même la clause WHERE. Puisque cette méthode implique la charge supplémentaire des sous-interrogations, ne l'utilisez que si elle empêche l'extraction d'un grand nombre d'enregistrements inutiles.


Encadrements inutilisés

Supprimez de la présentation tous les encadrements inutilisés. Lorsque Report Builder crée une présentation par défaut, il ajoute des encadrements à pratiquement tout les éléments, afin de protéger les objets qui se trouvent dans ces encadrements contre tout remplacement intempestif lors de la sortie. Si vous savez par expérience que les objets d'un encadrement ne sont pas menacés de remplacement, vous pouvez supprimer cet encadrement sans aucun effet indésirable sur la sortie de votre état.

Commentaire : Moins il y a d'objets dans la présentation, moins Report Builder devra en mettre en forme au moment de l'exécution. Par conséquent, la diminution du nombre d'objets dans la présentation a un effet positif sur les performances.


Objets transparents

Attribuez aux objets de présentation (tels qu'encadrements et encadrements itératifs) une bordure et un motif de remplissage transparents.

Commentaire : Les objets transparents ne sont pas rendus dans un fichier PostScript. Par conséquent, le traitement est plus rapide lorsque les objets sont transparents.


Dimensionnement des objets non graphiques

Attribuez à vos objets de présentation non graphiques (tels que texte standard ou champs contenant du texte) une taille fixe, c'est-à-dire la valeur Fixe pour leur Elasticité verticale et leur Elasticité horizontale. En particulier, l'attribution d'une taille fixe aux encadrements itératifs et à leur contenu peut avoir un effet positif sur les performances.

Commentaire : Les objets non graphiques de taille variable nécessitent davantage de traitement car Report Builder doit déterminer leur taille avant de les mettre en forme. Les objets non graphiques de taille fixe ne requièrent pas ce traitement supplémentaire car leur taille est déjà connue.


Dimensionnement des objets graphiques

Attribuez à vos objets de présentation graphique (tels que les images et les objets Oracle Graphics) une taille variable, c'est-à-dire la valeur Variable pour leur Elasticité verticale et leur Elasticité horizontale.

Commentaire : Les objets graphiques de taille fixe nécessitent généralement une mise à l'échelle de leur contenu pour que celui-ci tienne dans l'objet. la mise à l'échelle du contenu d'un objet nécessite davantage de traitement. Si l'objet est de taille variable, il peut s'agrandir ou rétrécir avec son contenu, évitant ainsi la mise à l'échelle.


Réduction de la résolution des images

Utilisez Format [image] Options de dessin [image] Réduire la résolution d'image sur les objets image dont vous réduisez la taille.

Commentaire : Lorsque vous réduisez la taille d'une image, moins d'informations sont nécessaires pour l'afficher ensuite. La réduction de la résolution d'image élimine les informations inutiles et diminue la quantité d'espace nécessaire pour stocker l'image. Cela peut s'avérer particulièrement utile pour les images de grande taille et comportant de nombreuses couleurs.


Passage des mots à la ligne

Attribuez aux champs contenant du texte une longueur égale à une ligne et assurez-vous que leur contenu tient dans la largeur indiquée (par exemple, à l'aide de la fonction SUBSTR).

Commentaire : Si un champ contenant du texte s'étend au-delà d'une ligne, Report Builder doit utiliser son algorithme de passage à la ligne pour mettre le champ en forme. En vous assurant que le champ n'aura qu'une seule ligne à mettre en forme, vous évitez le traitement supplémentaire dû à l'algorithme de passage à la ligne.


Attributs de mise en forme

Evitez l'utilisation de plusieurs attributs de mise en forme (tels que les polices) à l'intérieur d'un même champ ou texte standard.

Commentaire : Si le texte d'un champ ou d'un objet standard contient de nombreux attributs de mise en forme, il sera plus long à mettre en forme.


Déclencheurs de mise en forme

Placez PL/SQL dans le déclencheur de mise en forme de l'objet ayant la fréquence la plus faible. Par exemple, l'exécution d'un état sera normalement plus rapide si PL/SQL se trouve dans le déclencheur de mise en forme d'un encadrement plutôt que dans un champ.

Commentaire : Le code PL/SQL qui se trouve dans le déclencheur de mise en forme est exécuté pour chaque instance de son objet. Moins la fréquence de cet objet est élevée, moins souvent le code PL/SQL sera exécuté et plus rapide sera l'exécution de l'état.

Notes d'utilisation

•	Puisque vous ne pouvez pas être certain du nombre de déclenchements d'un déclencheur de mise en forme pour un objet donné, n'effectuez pas de calculs et n'utilisez pas DML dans un déclencheur de mise en forme.


Nombre total de pages

Limitez l'utilisation de nombres totaux de pages (par exemple, nombre total de pages logiques) comme source de champ.

Commentaire : Lorsque vous utilisez un nombre total de page comme source de champ, Report Builder doit enregistrer toutes les pages en mémoire temporaire afin de déterminer le nombre total de pages. Cela peut augmenter de façon significative la quantité d'espace disque temporaire utilisée par Report Builder et les accès supplémentaires en écriture dans les fichiers peuvent ralentir les performances.


Intégration de Graphics Builder

Si un affichage Graphics Builder référencé par un état utilise tout ou partie des mêmes données que cet état,, transférez ces données de l'état à l'affichage. Vous pouvez indiquer ce transfert des données dans la palette de propriétés de l'affichage dans Report Builder

Commentaire : Si l'état et l'affichage utilisent les mêmes données, le transfert des données réduit le volume de l'extraction nécessaire. Si vous ne transférez pas les données de l'état à l'affichage, celles-ci sont en fait extraites deux fois : une fois pour l'état et une fois pour l'affichage.


PL/SQL et sorties utilisateur

Selon les circonstances, c'est le code PL/SQL ou une sortie utilisateur qui donne les meilleurs résultats. Voici les éléments à prendre en compte avant d'opter pour PL/SQL ou pour une sortie utilisateur :

•	Si vous devez faire de nombreuses références aux objets Report Builder, PL/SQL est généralement plus rapide.

•	Si l'état nécessite une certaine portabilité ou si l'action est exécutée au niveau du groupe ou de l'état, utilisez PL/SQL.

•	Si l'état ne nécessite aucune portabilité, utilisez des sorties utilisateur au lieu de PL/SQL pour exécuter DML.

•	Les sorties utilisateurs sont particulièrement avantageuses lorsque l'action est exécutée pour chaque enregistrement d'un état volumineux ou qu'elle nécessite l'exécution de nombreux calculs.

Commentaire : PL/SQL est fortement recommandé, car il permet un code procédural, d'où une certaine portabilité. PL/SQL offre également des avantages en matière de performances lors des références aux objets au niveau de l'état. Les sorties utilisateur offrent de meilleures performances, mais elles nécessitent une liaison et ne sont pas portables. Il est intéressant d'inclure une sortie utilisateur si l'action requise est exécutée pour tous les enregistrements d'un état de très grande taille ou qu'elle effectue de nombreux calculs.

Une procédure PL/SQL est plus intéressante si l'action ne concerne que chaque groupe ou se situe au niveau de l'état. En outre, il n'est pas possible de tout faire en PL/SQL : certaines actions telles que le contrôle des périphériques externes doivent être réalisées dans un programme en langage C.

Remarque : En l'absence de souci de performances ou de toute autre bonne raison d'utiliser une sortie utilisateur, utilisez PL/SQL, qui offre facilité et portabilité.


PL/SQL et SRW.DO_SQL pour DML

Utilisez PL/SQL pour DML, sauf si vous voulez transmettre des paramètres à vos instructions DML.

Commentaire : L'écriture d'instructions DML en PL/SQL est plus rapide qu'un appel SRW.DO_SQL contenant la même instruction. L'avantage d'utiliser des instructions SRW.DO_SQL pour DML est qu'il est possible de concaténer des paramètres de lien pour construire l'instruction DML. Par exemple, vous pouvez créer à l'aide de SRW.DO_SQL une table dont le nom est déterminé par un paramètre entré dans la grille des paramètres d'exécution :

SRW.DO_SQL ('CREATE TABLE' || :tname || '(ACOUNT NUMBER
           NOT NULL PRIMARY KEY, COMP NUMBER (10,2))');

Notes d'utilisation

•	Vous pouvez également utiliser le package dbms_sql fourni avec ORACLE version 7.1 ou ultérieure pour DML. Pour plus d'informations, reportez-vous à votre documentation ORACLE 7.


Procédures stockées et PL/SQL local

Utilisez des procédures stockées pour le code PL/SQL qui effectue des opérations de base de données. Recourez au PL/SQL local pour le code PL/SQL qui n'implique pas d'opérations de base de données.

Commentaire : Du fait que les procédures stockées s'exécutent dans ORACLE, elles peuvent effectuer les opérations de base de données plus rapidement que le code PL/SQL local par rapport à votre état.

Exceptions : Si vous vous trouvez sur un réseau lourdement chargé avec un temps de réponse particulièrement lent, l'utilisation de procédures stockées peut ne pas s'avérer plus rapide pour les opérations de base de données. Inversement, si votre serveur est nettement plus rapide que votre ordinateur local, l'utilisation de PL/SQL local ne sera peut-être pas plus rapide pour les opérations qui ne portent pas sur des bases de données.


PL/SQL local et bibliothèques PL/SQL externes

Ecrivez votre code PL/SQL aussi " localement " que possible. Utilisez le noeud Unités de programme de votre état dans le Navigateur d'objet au lieu d'une bibliothèque PL/SQL externe.

Commentaire : Le code PL/SQL local s'exécute plus rapidement d'une référence à une procédure ou une fonction qui se trouvent dans une bibliothèque PL/SQL externe. Par conséquent, n'utilisez les bibliothèques PL/SQL externes que si les avantages du partage du code par plusieurs applications compense l'altération des performances.


SRW.SET_ATTR

Réduisez le nombre d'appels à SRW.SET_ATTR en indiquant plusieurs attributs dans un même appel. Vous pouvez indiquer plusieurs attributs par appel à SRW.SET_ATTR au lieu de faire un appel distinct pour chaque attribut.

Commentaire : Moins vous ferez d'appels à SRW.SET_ATTR, plus l'exécution de PL/SQL sera rapide.


ARRAYSIZE

Pour l'argument exécutable ARRAYSIZE de Report Builder (par exemple, ARRAYSIZE=10), entrez une valeur la plus élevée possible, particulièrement si vous utilisez Report Builder en environnement client-serveur. La taille de tableau est exprimée en kilo-octets et non en lignes. La taille de ARRAYSIZE indique le nombre de kilo-octets de mémoire que Report Builder peut utiliser par interrogation lors de l'exécution de votre état.

Report Builder utilise le traitement de tableaux de ORACLE qui extrait plusieurs enregistrements par lots et non un par un. Par conséquent, vous pouvez contrôler la quantité de données à extraire par les processus par lots.

Commentaire : Plus grande est la taille de tableau, plus important est le nombre de lignes qui peuvent être extraites simultanément. Ainsi, moins d'appels à la base de données seront nécessaires. L'augmentation de la taille de tableau présente également un avantage en environnement réparti, où le trafic réseau constitue généralement un goulet d'étranglement et où la surcharge associée au nombre de paquets envoyés sur le réseau n'est pas à négliger.


LONGCHUNK

Pour l'argument exécutable LONGCHUNK de Report Builder (par exemple, LONGCHUNK=10), entrez une valeur la plus élevée possible. LONGCHUNK détermine la taille des incréments selon lesquels Report Builder extrait une valeur de type LONG. La taille de LONGCHUNK est exprimée en kilo-octets.

Commentaire : En augmentant au maximum la taille de LONGCHUNK, vous pouvez réduire le nombre d'incréments nécessaires à Report Builder pour extraire les valeurs de type LONG.


RUNDEBUG

Désactivez l'argument exécutable RUNDEBUG. RUNDEBUG demande à Report Builder d'effectuer un contrôle d'erreurs supplémentaire lorsqu'il exécute votre état. Ce contrôle d'erreurs supplémentaire est utile lorsque vous concevez un état mais, une fois l'état en production, il n'est probablement plus nécessaire.

Commentaire : Le contrôle d'erreurs supplémentaire effectué par RUNDEBUG ralentit l'état.


COPIES

Lorsque vous imprimez sur une imprimante PostScript, indiquez COPIES=1.

Commentaire : Si COPIES a une valeur supérieure à 1 pour un état PostScript, Report Builder doit enregistrer les pages en mémoire temporaire afin de les assembler. Cela peut augmenter de façon significative la quantité d'espace disque temporaire utilisée par Report Builder et les opérations d'écriture supplémentaires dans les fichiers peuvent ralentir les performances.


Aperçu

Evitez le phénomène d'" extraction aval " lorsque vous envoyez un état à l'Aperçu ou à l'Aperçu interactif. Cela a pour effet d'afficher la première page plus rapidement que la normale.

Commentaire : L'Aperçu ou l'Aperçu interactif sont parfois ralentis par des éléments exigeant une extraction aval. Par exemple, si le nombre total de pages d'un état apparaît sur sa toute première page, l'état doit être traité dans sa totalité avant que la première page puisse apparaître dans l'Aperçu ou dans l'Aperçu interactif.

Les éléments suivants peuvent tous entraîner une extraction aval lorsqu'ils sont référencés avant les données sur lesquels ils portent :

•	nombre total de pages/panneaux

•	totaux généraux

•	colonnes de ventilation qui sont des formules

•	colonnes de ventilation pour lesquelles est indiqué Valeur si nul

Les groupes inter-produits entraînent également une extraction aval. Afin de résoudre les références croisées des données dans un groupe inter-produit, Report Builder doit d'abord extraire toutes les données.

Il faut remarquer que ces points ne constituent pas à proprement parler des " problèmes " de performances. Ils ralentissent l'Aperçu ou l'Aperçu interactif mais n'affectent pas les performances lors de l'écriture vers un fichier ou vers une autre destination.

Remarque : Une colonne peut entraîner une extraction aval même si elle n'est pas affichée. Par exemple, un total général peut ne pas apparaître dans l'état final mais, puisqu'il se trouve dans l'état, une extraction aval risque de se produire lorsque Report Builder le calcule.


Stockage dans des fichiers ou dans la base de données

Stockez vos documents dans des fichiers pour améliorer les performances et stockez vos états dans la base de données pour des raisons de sécurité. Si vous ouvrez ou enregistrez un état dans une base de données, certaines tables de Report Builder seront placées en mémoire. Par conséquent, vous devez vous assurer que vous disposez de ressources suffisantes pour accueillir les tables en mémoire cache.

Commentaire : En ce qui concerne les documents, l'écriture et la lecture à partir de fichiers s'avèrent beaucoup plus rapides qu'à partir de la base de données.

Exception : Si vous devez utiliser un réseau surchargé ou un ordinateur lent pour accéder aux fichiers, vous ne gagnerez peut-être pas en performances en recourant au stockage dans des fichiers.


Recherche de fichiers

Indiquez des variables de chemin pour accélérer la recherche de fichiers, et la création ou l'ouverture de fichiers temporaires. (N'oubliez pas que Report Builder propose deux variables d'environnement, REPORTS60_PATH et REPORTS60_TMP, qui régissent la recherche des fichiers et le stockage des fichiers temporaires.)

Pour REPORTS60_PATH, indiquez le chemin dans lequel se trouvent les fichiers référencés par l'état. Pour REPORTS30_TMP, indiquez un chemin qui dispose de suffisamment d'espace disponible pour les fichiers temporaires et qui se trouve sur un périphérique offrant un temps de réponse rapide (par exemple, un disque RAM).

Commentaire : REPORTS60_PATH est le chemin par défaut dans lequel Report Builder recherche les fichiers (par exemple, les fichiers de liaison standard). En indiquant le chemin dans lequel se trouvent les fichiers référencés par l'état, vous pouvez réduire la recherche effectuée par Report Builder pour extraire ces fichiers. (En utilisant REPORTS60_PATH au lieu de microcoder les chemins dans la définition d'état, vous préservez également la portabilité de votre état.) REPORTS60_TMP indique le chemin dans lequel Report Builder crée ses fichiers temporaires.


Partage de tables

Utilisez un jeu de tables pour plusieurs concepteurs. ORACLE permet à plusieurs concepteurs d'états de partager un jeu de tables Report Builder.

Commentaire : Le partage de tables vous permet de partager les états entre développeurs et de ne mettre en mémoire cache qu'un seul jeu de tables. Cela permet de meilleures performances lors de l'ouverture ou de l'enregistrement d'un état dans la base de données et économise la mémoire.


Client-serveur

Si vous disposez d'un serveur puissant et d'un réseau rapide, vous pouvez envisager de faire fonctionner Report Builder sur le serveur. Dans le cas contraire ou si vous prévoyez beaucoup de tâches interactives (par exemple, la navigation), il est préférable d'installer Report Builder sur votre ordinateur local. Pour déterminer quelle est la meilleure solution dans votre cas, contactez votre administrateur système.

Commentaire : En environnement client-serveur, les performances de Report Builder peuvent être sérieusement affectées par les éléments suivants :

•	vitesse et charge des ordinateurs client et serveur

•	trafic sur le réseau


Déclencheurs d'état et Aperçu interactif

Dans l'Aperçu interactif, les déclencheurs d'état peuvent ne pas se déclencher exactement comme dans l'Aperçu Runtime. Pour tester les déclencheurs d'état de façon précise, utilisez l'Aperçu Runtime.


Rafraîchissement de l'Aperçu interactif

Dans certains cas, il se peut qu'une modification que vous avez apportée à un objet dans la palette de propriétés n'apparaisse pas immédiatement dans l'Aperçu interactif. Si cela se produit, vous pouvez exécuter à nouveau l'état pour voir l'effet de votre modification.


Troncation de la sortie HTML

HTML dispose de sept tailles de texte différentes. Par conséquent, Report Builder doit faire correspondre des plages de polices à ces sept tailles de texte. Lorsque vous concevez un état pour une sortie HTML, vous devez vous assurer que les champs et le texte standard sont dimensionnés de façon à ce qu'il puissent supporter une éventuelle augmentation de taille due à cette correspondance. Une méthode pour y parvenir consiste à choisir des tailles de police au sommet d'une plage (par exemple, 8, 9, 12, 15, 20, 30). Vous pouvez également prévoir dans vos champs et dans vos objets texte standard suffisamment d'espace pour accepter toute augmentation de taille.

Les tailles de police de l'état sont mise en correspondance selon le tableau ci-après. Notez que l'utilisateur a la possibilité de modifier la taille indiquée à partir de son navigateur.

Taille de polices d'état	Taille HTML
inférieure à 8	1
8 à 9	2
10 à 12	3
13 à 15	4
16 à 20	5
21 à 30	6
plus de 30	7


Marges de la sortie HTML

Il peut arriver, lors de l'impression d'un état à partir de votre navigateur, que celui-ci ait tendance à déborder de la page (c'est-à-dire être tronqué). La cause peut en être une marge dans la mise en page du navigateur. A l'impression, cette marge est ajoutée à la marge définie dans l'état, d'où une troncation. Vous pouvez essayer, pour obtenir une impression correcte, de réduire la marge de la mise en page du navigateur à zéro.


Déclencheur de filtre de groupe
Filtre de groupe

  Restrictions 	  Exemples	  Rubriques connexes

Description  Un filtre de groupe est une fonction PL/SQL qui détermine les enregistrements à inclure dans un groupe si la propriété Type de filtre est PL/SQL. La fonction doit retourner une valeur booléenne (TRUE ou FALSE). Selon le résultat de la fonction, l'enregistrement en cours est inclus dans l'état ou en est exclu. Vous pouvez accéder aux filtres de groupe à partir du Navigateur d'objet, de la Palette de propriétés (propriété Filtre PL/SQL) ou de l'Editeur PL/SQL.

Niveau de définition  groupe

Sur échec  Exclut du groupe l'enregistrement en cours.


Déclencheur de filtre de groupe - Exemple
Filtre de groupe - Exemple

  Rubriques connexes 	  Tous les exemples

function filter_comm return boolean is
begin
   if :comm IS NOT NULL then
      if :comm < 100 then
         return (FALSE);
      else
         return (TRUE);
      end if;
   else
     return (FALSE); -- pour les lignes dont les commissions sont NULL
   end if;
end;


Filtre de groupe - Restrictions

•	Les filtres de groupe ne peuvent pas être ajoutés au groupe si Type de filtre est Premier ou Dernier.

•	Les filtres de groupe ne peuvent pas être ajoutés à des groupes inter-produit.

•	Dans un filtre de groupe, vous pouvez lire les valeurs des colonnes et des paramètres de Report Builder qui ont la fréquence correcte (voir la règle ci-après), mais vous ne pouvez pas définir directement leurs valeurs. Par exemple, vous pouvez utiliser la valeur d'un paramètre appelé NOMBRE1 dans une condition (par exemple IF :NOMBRE1 = 10), mais vous ne pouvez pas définir directement sa valeur dans une instruction d'affectation (par exemple, :NOMBRE1 = 10). Notez également que l'utilisation des variables globales PL/SQL pour définir indirectement les valeurs de colonnes ou de paramètres n'est pas prise en charge, car elle risque de donner des résultats imprévisibles. Vous ne pouvez pas non plus faire référence à des colonnes dépendant de page (c'est-à-dire pour lesquelles la propriété Remise à est définie à Page) ou des colonnes qui utilisent des colonnes dépendant de pages.

•	La fonction que vous entrez pour un filtre de groupe ne peut dépendre que des colonnes suivantes :

•	une colonne de base de données appartenant à l'interrogation du groupe ou à une interrogation au-dessus d'elle dans la hiérarchie des modèles de données,

•	des colonnes calculées (formules ou récapitulatifs) qui dépendent d'interrogations non liées (c'est-à-dire des colonnes calculées qui ne dépendent pas des colonnes du groupe, des ancêtres du groupe ou des descendants du groupe).


Déclencheur de formule
Formules

  Exemples	  Restrictions 	  Rubriques connexes

Description  Les formules sont des fonctions PL/SQL qui remplissent des colonnes de réserve ou des colonnes de formule. Vous pouvez accéder à PL/SQL pour obtenir des formules à partir du Navigateur d'objet, de l'Editeur PL/SQL ou de la Palette de propriétés (c'est-à-dire la propriété Formule PL/SQL).

Une colonne de type Number ne peut avoir qu'une formule qui retourne une valeur de type NUMBER. Une colonne de type Date ne peut avoir qu'une formule qui retourne une valeur de type DATE. Une colonne de type Character ne peut avoir qu'une formule qui retourne une valeur de type CHARACTER, VARCHAR, ou VARCHAR2.

Niveau de définition  colonne

Sur échec  Aucune valeur n'est retournée pour la colonne.


Formule d'ajout de valeurs - Exemple

  Rubriques connexes 	  Tous les exemples

function salcomm return NUMBER is
begin
  return(:sal + :comm);
end;


Formule avec condition - Exemple

  Rubriques connexes 	  Tous les exemples

function calcomm return NUMBER is
  temp number;
begin
   if :comm IS NOT NULL then
     temp := :sal + :comm;
   else
     temp := :sal;
   end if;
   return (temp);
end;


Formule - Restrictions

•	Dans une formule, vous pouvez lire et attribuer des valeurs à la colonne elle-même, aux colonnes de réserve et aux paramètres ayant la fréquence correcte (voir la règle ci-dessous). Par exemple, vous pouvez utiliser la valeur d'une colonne appelée COMP dans une condition (par exemple, IF :COMP = 10) et définir directement sa valeur dans une instruction d'affectation (par exemple, :COMP := 15).

•	Une formule ne peut faire référence qu'à des colonnes se trouvant dans le même groupe ou dans un groupe supérieur de la hiérarchie des groupes. Par exemple, une formule d'une colonne de niveau Etat ne peut faire référence qu'à d'autres colonnes de niveau Etat.

•	Le calcul des formules s'effectue de sorte que les colonnes référencées dans la formule sont calculées en premier. Pour cela, Report Builder crée une liste de dépendances, pour garantir l'ordre des calculs. Notez que les dépendances circulaires, dans lesquelles une colonne fait référence à une autre colonne qui fait à son tour référence à la première colonne, soit directement, soit indirectement ne sont pas autorisées.

•	Une sortie utilisateur ne peut modifier que la valeur d'une colonne de réserve.

•	Lorsque vous utilisez SRW.DO_SQL, il est conseillé de ne pas lire de valeurs de base de données qui sont mises à jour ou insérées dans le même état. Le stade exact auquel Report Builder extrait les enregistrements de la base de données en vue de la mise en forme de l'état n'est pas garanti. Report Builder effectue une "lecture anticipée interne des données" pour optimiser les performances et peut donc avoir déjà accédé à un enregistrement particulier avant sa mise en forme. Report Builder crée des listes de dépendances internes qui garantissent que les événements (appel de sortie utilisateur, calculs de récapitulatifs, etc.) se déroulent dans l'ordre voulu. Cependant, Report Builder ne peut pas garantir que ces événements seront synchronisés sur l'accès aux données internes ou sur la mise en forme des données.


Déclencheur de validation

  Exemples	  Restrictions 	  Rubriques connexes

Description  Les déclencheurs de validation sont des fonctions PL/SQL exécutées, si des valeurs de paramètres sont indiquées dans la ligne de commande, lorsque vous validez la Grille de paramètres d'exécution. (Notez que cela signifie que chaque déclencheur de validation peut être activé deux fois lorsque vous exécutez l'état). Les déclencheurs de validation sont également utilisés pour valider la propriété Valeur initiale du paramètre. La fonction doit retourner une valeur booléenne (TRUE ou FALSE). Selon le résultat de la fonction, l'utilisateur revient ou non à la Grille de paramètres d'exécution. Vous pouvez accéder aux déclencheurs de validation à partir du Navigateur d'objet, de l'Editeur PL/SQL ou de la Palette de propriétés (propriété Déclencheur de Validation).

Niveau de définition  paramètre

Sur échec  L'utilisateur revient à la valeur du paramètre dans la Grille de paramètres d'exécution où il peut soit la modifier, soit annuler la Grille de paramètres d'exécution.


Déclencheur de validation - Exemple

  Rubriques connexes 	  Tous les exemples

/* Cette fonction empêche l'utilisateur runtime
** d'envoyer la sortie d'état vers toute destination
** autre que l'imprimante. L'utilisateur est invité à
** modifier la Grille paramètres d'exécution à moins que l'option IMPRIMANTE
** soit sélectionnée comme type de destination (DESTYPE).
*/

function DESTYPEValidTrigger return boolean is
begin
  IF UPPER(:DESTYPE) = 'IMPRIMANTE' THEN
  RETURN(TRUE);
ELSE
  RETURN(FALSE);
END IF;
end;


Déclencheur de validation - Restrictions

•	Le PL/SQL d'un déclencheur de validation peut avoir jusqu'à 32 Ko caractères de long. La limite supérieure est fonction du système d'exploitation utilisé.

•	Dans un déclencheur de validation, vous pouvez lire et attribuer des valeurs aux paramètres de Report Builder. Vous ne pouvez pas lire ou attribuer de valeur à des colonnes. Par exemple, vous pouvez utiliser la valeur d'un paramètre appelé NOMBRE1 dans une condition (par exemple, IF :NOMBRE1 = 10) et définir directement sa valeur dans une instruction d'affectation (par exemple, :NOMBRE1 = 15). Cependant, dans certains cas, le déclencheur de validation peut s'activer plusieurs fois pour le même paramètre. Ainsi, il est généralement préférable d'attribuer des valeurs de paramètre dans un déclencheur After Parameter Form.  Notez également que l'utilisation de variables globales PL/SQL pour définir indirectement les valeurs de colonnes n'est pas prise en charge, car elle risque de donner des résultats imprévisibles.

n	Vous ne devez pas utiliser DDL dans dé clencheurs de Validation.

•	Pour les états qui sont des processus générés dynamiquement (par exemple, exécution avec BACKGROUND=YES), vous devez valider les modifications apportées à la base de données dans les déclencheurs Before Form, After Form et Validation avant l'exécution de l'état. Les processus générés dynamiquement utilisent la connexion de leur processus père à la base de données pour les déclencheurs Before Form, After Form et Validation. Cependant, lorsque le processus généré dynamiquement exécute l'état, il crée sa propre connexion à la base de données. Les modifications apportées à la base de données et non validées au moment où l'état fils est exécuté sont donc perdues.


Déclencheur de format

  Restrictions 	  Exeples	  Rubriques connexes

Description  Les déclencheurs de format sont des fonctions PL/SQL exécutées avant la mise en forme de l'objet. Le déclencheur permet de modifier dynamiquement les attributs de mise en forme de l'objet. La fonction doit retourner une valeur booléenne (TRUE ou FALSE). Selon les résultats de la fonction, l'instance en cours de l'objet est incluse dans la sortie de l'état ou en est exclue. Vous pouvez accéder aux déclencheurs de format à partir du Navigateur d'objet, de la Palette de propriétés ou de l'Editeur PL/SQL.

Niveau de définition  objet de présentation

Sur échec  Exclut de la sortie l'instance en cours de l'objet.

Notes d'utilisation

Les déclencheur de format sont sans effet sur les données extraites par l'état. Par exemple, si un déclencheur de format retourne FALSE pour un champ, les données du champ sont extraites, même si le champ n'apparaît pas dans la sortie.

•	Si un déclencheur de format supprime la sortie de l'état à la dernière page, cette page est quand même mise en forme et envoyée à la sortie appropriée. Elle est également incluse dans le nombre total de pages.


Déclencheur de format pour la mise en évidence d'une valeur - Exemple

  Rubriques connexes 	  Tous les exemples

/* Vous créez un état bancaire et
** vous voulez qu'il indique si un client est à découvert.
** Pour cela, donnez à l'encadrement itératif qui entoure les
** informations sur le client un déclencheur de format qui
** déclenche l'insertion d'une bordure uniquement si le solde du compte d'un client
** est inférieur à 0 (ou au minimum
** requis).
*/

function my_formtrig return BOOLEAN is
begin
if :bal < 0 then
   srw.attr.mask := SRW.BORDERWIDTH_ATTR;
   srw.attr.borderwidth := 1;
   srw.set_attr (0, srw.attr);
end if;
return (true);
end;


Déclencheur de format pour la suppression de libellés - Exemple

  Rubriques connexes 	  Tous les exemples

/* Vous créez un état maître/détail
** et, si aucun enregistrement détail n'est extrait pour un
** enregistrement maître, vous ne voulez pas que les libellés standard
** apparaissent. Pour cela, commencez par créer une colonne récapitulative
** appelée MONCOMPTE ayant pour Fonction Count dans
** le groupe source de l'encadrement itératif maître.
** Dans le déclencheur de format de l'encadrement de groupe qui
** entoure l'encadrement itératif détail et ses libellés,
** entrez :
*/

function mon_décl_de_format return BOOLEAN is
begin
if :moncompte = 0 then
   return (false);
else
   return (true);
end if;
end;


Déclencheur de format pour la suppression de valeurs - Exemple

  Rubriques connexes 	  Tous les exemples

/* Vous créez un état des salaires et
** vous voulez uniquement voir les salaires supérieurs à $2500. Dans le
** récapitulatif de tous les salaires, vous voulez cependant que tous
** les salaires soient inclus. Pour cela, créez un modèle
** de données pour l'état, sans limiter les enregistrements
** extraits, puis entrez le déclencheur de format ci-dessous
** pour l'encadrement itératif. La sortie de l'état n'indiquera
** que les salaires supérieurs à $2500, mais le récapitulatif
** qui calcule la somme de tous les salaires comprendra tous les
** salaires extraits de la base de données.
*/

function my_formtrig return BOOLEAN is
begin
if :sal > 2500 then
   return (true);
else
   return (false);
end if;
end;


Déclencheur de format pour l'insertion de virgules entre les champs - Exemple

  Rubriques connexes 	  Tous les exemples

/* Vous voulez créer une liste de
** noms d'employé, séparés par des virgules. Commencez par créer
** un champ dans un encadrement itératif ayant pour orientation
** d'impression de gauche à droite. A côté du champ, créez un objet
** texte standard contenant une virgule suivie d'un
** blanc. Pour être certain que la virgule n'apparaîtra pas
** après le dernier nom de la liste, entrez pour l'objet standard
** le déclencheur de format ci-dessous.
** NOM est une colonne récapitulative ayant pour source NOME,
** pour fonction Dernier et pour Remise à Etat.
*/

function my_formtrig return BOOLEAN is
begin
if :nome <> :nom then
   return (true);
else
   return (false);
end if;
end;


Déclencheur de format - Restrictions

Attention :  Le code PL/SQL d'un déclencheur de format est exécuté chaque fois que Report Builder tente de mettre l'objet de présentation en forme. Cela étant, les déclencheurs de format ne doivent contenir que des unités de programme PL/SQL qui définissent des attributs de mise en forme (par exemple, couleur et mise en évidence). N'utilisez pas d'autres actions, comme l'insertion de données dans une table, car vous ne pouvez pas prévoir quand ou combien de fois le déclencheur sera activé. Par exemple, si vous avez défini Protection page pour un objet, il est possible que l'objet ne soit pas mis en forme sur la page logique dans laquelle le déclencheur est activé. En outre, le déclencheur peut être exécuté plusieurs fois.

•	Lorsqu'un déclencheur de format retourne FALSE pour un objet de la dernière page de l'état et qu'aucun autre objet n'est mis en forme sur cette page, celle-ci est blanche.

•	Les commentaires insérés directement dans le code PL/SQL doivent utiliser les délimiteurs de commentaires PL/SQL.

•	Dans un déclencheur de format, vous pouvez lire les valeurs des colonnes et des paramètres Report Builder de la fréquence correcte (reportez-vous à la règle ci-dessous), mais vous ne pouvez pas définir directement leurs valeurs. Par exemple, vous pouvez utiliser la valeur d'un paramètre appelé NOMBRE1 dans une condition (par exemple, IF :NOMBRE1 = 10), mais vous ne pouvez pas définir directement sa valeur dans une instruction d'affectation (par exemple, :NOMBRE1 = 10). (Cette restriction s'applique également aux sorties utilisateur appelées à partir du déclencheur de format.) Notez également que l'utilisation de variables globales PL/SQL pour définir indirectement les valeurs de colonnes ou de paramètres n'est pas prise en charge. Si vous exécutez cette opération, vous risquez d'obtenir des résultats imprévisibles.

•	Vous ne pouvez pas faire référence à des colonnes ou à des variables dans le déclencheur de format d'un objet ayant une fréquence différente de celle de l'objet. Par exemple, si vous créez un état maître/détail, l'encadrement itératif du groupe père ne peut pas avoir un déclencheur de format basé sur une valeur du groupe fils. Pour chaque père, il peut y avoir plusieurs fils. Au niveau des enregistrement père, Report Builder ne peut donc pas déterminer les enregistrements fils à utiliser. En outre, vous ne pouvez pas faire référence à des colonnes dépendant d'une page (par exemple, Remise à définie à Page) ou à des colonnes basées sur des colonnes dépendant d'une page dans un déclencheur de format, car cela entraîne une dépendance circulaire, c'est-à-dire que la valeur d'une colonne dépendant d'une page ne peut pas être calculée tant que l'état n'est pas mis en forme, mais l'état ne peut pas être mis en forme tant que le déclencheur de format n'est pas exécuté.

•	Si un déclencheur de format retourne FALSE et si l'objet n'est pas mis en forme, il est possible que d'autres objets ne s'impriment pas. Par exemple, si un encadrement itératif n'est pas mis en forme, les objets (champs, texte standard, encadrements ou autre encadrements itératifs) qu'il entoure ne seront pas non plus mis en forme.

•	Pour les encadrements itératifs, le déclencheur de format est exécuté pour chaque instance de l'encadrement itératif. Pour créer un déclencheur de format agissant immédiatement sur toutes les instances d'un encadrement itératif, créez un encadrement autour de l'encadrement itératif et entrez un déclencheur pour cet encadrement. Si le déclencheur de format retourne FALSE pour chaque instance d'un encadrement itératif d'une page logique, l'encadrement itératif n'occupera pas de place sur la page logique et les points d'ancrage aux autres objets ne seront pas exécutés (s'ils sont indiqués).

•	Le code PL/SQL d'un déclencheur de format doit retourner des résultats cohérents pour le même objet. Par exemple, si vous avez un encadrement dont le déclencheur de format retourne FALSE lorsqu'une certaine condition est remplie, si l'encadrement occupe deux pages, le déclencheur de format sera activé deux fois (une fois pour chaque page sur laquelle l'encadrement est mis en forme). La condition dans votre PL/SQL doit retourner le même résultat chaque fois que le déclencheur de format est activé. Sinon, l'encadrement ne sera que partiellement mis en forme (c'est-à-dire que seule sera mise en forme la partie de l'encadrement située sur la première page).

•	Si le déclencheur de format d'un encadrement itératif d'un état matriciel retourne FALSE, une ligne ou une colonne complète de matrice ne sera pas mise en forme. Par exemple, si une instance de l'encadrement itératif de dimension horizontale n'est pas mise en forme, la colonne ne sera pas mise en forme en totalité dans la matrice.

•	Si vous voulez appliquer une modification conditionnelle à la cellule d'une matrice, vous devez placer un encadrement autour du champ, à l'intérieur de la matrice, et utiliser le déclencheur de format pour l'encadrement.


Déclencheur d'action

  Exemples 	  Rubriques connexes

Description  Les déclencheurs d'action sont des procédures PL/SQL exécutées lorsque l'utilisateur sélectionne un bouton dans l'Aperçu Runtime. Le déclencheur peut être utilisé pour appeler dynamiquement un autre état (descente de niveau) ou exécuter un autre PL/SQL. Vous pouvez accéder à des déclencheurs d'action à partir du Navigateur d'objet, de la Palette de propriétés (propriété Déclencheur PL/SQL) ou de l'Editeur PL/SQL.

Niveau de définition  bouton

Notes d'utilisation

Les déclencheurs d'action PL/SQL ne peuvent pas être testés dans l'Aperçu interactif, car les boutons n'y sont pas activés. Vous devez faire appel à l'Aperçu Runtime (choisissez Affichage [image] Aperçu Runtime dans l'Aperçu interactif).

Vous ne pouvez pas utiliser l'Interpréteur PL/SQL pour déboguer des déclencheurs d'action, car celui-ci n'est pas accessible à partir de l'Aperçu Runtime et les boutons ne peuvent pas être activés dans l'Aperçu interactif. Pour tester un déclencheur d'action à partir de l'Aperçu interactif, déplacez le code de votre déclencheur d'action dans un déclencheur d'état.


Déclencheur d'action - Exemple

  Rubriques connexes 	  Tous les exemples

/* Lorsque l'utilisateur clique sur le bouton, le déclencheur
** d'action défini par cette procédure affiche la Grille
** de paramètres d'un état intitulé web4.rdf, puis affiche à
** l'écran la sortie d'état obtenue.
*/

procedure U_1ButtonAction is
begin
  srw.run_report('module=web4.rdf destype=Screen paramform=yes');
end;


Interrogation de curseur de référence

  Exemples 	  Rubriques connexes

Description  Une interrogation de curseur de référence utilise PL/SQL pour extraire des données pour l'état. Dans une interrogation de curseur de référence, vous indiquez une fonction PL/SQL qui renvoie une valeur de curseur à partir d'une variable de curseur.

Niveau de définition  Interrogation

En cas d'échec  Aucune donnée n'est renvoyée à l'interrogation.

Notes d'utilisation

•	Lorsque vous effectuez une interrogation de curseur de référence sur le fils d'une liaison de données, cette liaison ne peut être qu'une liaison groupe à groupe. Il ne peut pas s'agir d'une liaison colonne à colonne.

•	Si vous utilisez une unité de programme stockée pour mettre en oeuvre des curseurs de référence, vous profitez également des avantages inhérents au stockage de vos unités de programme dans la base de données Oracle.


Package avec curseur de référence - Exemple

  Rubriques connexes 	  Tous les exemples

/* Cette définition de package présente un type
** de curseur de référence qui peut être référencé à partir
** d'une fonction d'interrogation de curseur de référence.
** Si vous créez cette définition comme procédure
** stockée dans un outil tel que SQL*Plus,
** il vous faudra utiliser la commande CREATE
** PACKAGE.
*/

PACKAGE cv IS
  type comp_rec is RECORD
       (deptno number,
        ename  varchar(10),
        compensation number);
  type comp_cv is REF CURSOR return comp_rec;
END;


Package avec curseur de référence et fonction - Exemple

  Rubriques connexes 	  Tous les exemples

/* Cette définition et ce corps de package
** présentent un type de curseur de référence ainsi qu'une fonction
** qui utilise le curseur de référence pour renvoyer des données.
** La fonction peut être référencée à partir de l'interrogation
** de curseur de référence, ce qui simplifie grandement le code
** PL/SQL dans l'interrogation elle-même.
** Si vous créez cette définition et ce corps
** dans une procédure stockée dans un outil tel que
** SQL*Plus, il vous faudra utiliser
** les commandes CREATE PACKAGE et CREATE
** PACKAGE BODY.
*/

PACKAGE cv IS
  type comp_rec is RECORD
       (deptno number,
        ename  varchar(10),
        compensation number);
  type comp_cv is REF CURSOR return comp_rec;
  function emprefc(deptno1 number) return comp_cv;
END;

PACKAGE BODY cv IS
function emprefc(deptno1 number) return comp_cv is
      temp_cv cv.comp_cv;
begin
      if deptno1 > 20 then
       open temp_cv for select deptno, ename,
         1.25*(sal+nvl(comm,0)) compensation
         from emp where deptno = deptno1;
     else
       open temp_cv for select deptno, ename,
         1.15*(sal+nvl(comm,0)) compensation
         from emp where deptno = deptno1;
     end if;
     return temp_cv;
end;
END;


Interrogation de curseur de référence - Exemple

  Rubriques connexes 	  Tous les exemples

/* Cette fonction d'interrogation de curseur de référence serait
** codée dans l'interrogation elle-même. Elle utilise
** le curseur cv.comp_cv du package cv pour renvoyer
** des données pour l'interrogation.
*/

function DS_3RefCurDS return cv.comp_cv is
  temp_cv cv.comp_cv;
begin
  if :deptno > 20 then
     open temp_cv for select deptno, ename,
       1.25*(sal+nvl(comm,0)) compensation
       from emp where deptno = :deptno;
  else
     open temp_cv for select deptno, ename,
       1.15*(sal+nvl(comm,0)) compensation
       from emp where deptno = :deptno;
  end if;
  return temp_cv;
end;


Fonction appelante d'interrogation de curseur de référence - Exemple

  Rubriques connexes 	  Tous les exemples

/* Cette fonction d'interrogation de curseur de référence serait
** codée dans l'interrogation elle-même. Elle utilise
** le curseur cv.comp_cv et la fonction cv.emprefc du package cv
** pour renvoyer des données pour l'interrogation.
** Du fait qu'elle utilise la fonction du package cv,
** la logique de l'interrogation réside principalement
** à l'intérieur du package. L'administration et la maintenance
** de l'interrogation peuvent être effectuées au niveau du package
** (par exemple, la modification des clauses SELECT peut se faire
** par la mise à jour du package).
** Vous pouvez également facilement
** déplacer le package dans la base de données.
** Cet exemple implique la définition
** préalable du paramètre utilisateur deptno.
*/

function DS_3RefCurDS return cv.comp_cv is
  temp_cv cv.comp_cv;
begin
  temp_cv := cv.emprefc(:deptno);
  return temp_cv;
end;


Déclencheur After Parameter Form

  Rubriques connexes

Description  Le déclencheur After Parameter Form est activé après l'affichage de la Grille de paramètres d'exécution. Il vous permet d'accéder aux paramètres et de vérifier leurs valeurs. Il peut également être utilisé pour modifier les valeurs des paramètres ou, en cas d'erreur, retourner à la Grille de paramètres d'exécution. Il ne permet pas d'accéder aux colonnes du Modèle de données. Ce déclencheur est activé même si la Grille de paramètres d'exécution est supprimée. Vous pouvez donc l'utiliser pour valider des paramètres de ligne de commande ou d'autres données.

Niveau de définition  état

Sur échec

Revient à la Grille de paramètres d'exécution. Si l'application Forms est supprimée, retour à l'endroit à partir duquel vous avez exécuté l'état.


Déclencheur After Report

  Rubriques connexes

Description  Le déclencheur After Report est activé après sortie de l'Aperçu Runtime, ou après envoi de la sortie de l'état à une destination spécifique (fichier, imprimante ou ID messagerie). Il permet de supprimer les traitement initiaux (suppression de table, par exemple) qui ont été effectués. Notez cependant que ce déclencheur est toujours activé, que votre état s'exécute correctement ou non.

Niveau de définition  état

Sur échec

Est sans effet sur la mise en forme, car l'état est terminé. Vous pouvez cependant générer un message pour indiquer que l'état ne s'est pas exécuté correctement. Par exemple, vous pouvez entrer l'heure système dans une variable du déclencheur Before Report, puis la comparer à l'heure système du déclencheur After Report. Si l'exécution de l'état a duré plus longtemps que prévu, vous pouvez générer une erreur.

Notes d'utilisation

•	Le déclencheur de type After Report n'est pas activé lorsque vous vous trouvez dans la vue Aperçu interactif.


Déclencheur Before Parameter Form

  Rubriques connexes

Description  Le déclencheur Before Parameter Form est activé avant l'affichage de la Grille de paramètres d'exécution. Il permet d'accéder aux valeurs des paramètres, aux variables globales PL/SQL et aux colonnes de niveau Etat, et de les modifier. Ce déclencheur est activé même si la Grille de paramètres d'exécution est supprimée. Vous pouvez donc l'utiliser pour valider des paramètres de ligne de commande.

Niveau de définition  état

Sur échec

Affiche un message d'erreur, puis revient à l'endroit à partir duquel vous avez exécuté l'état.


Déclencheur Before Report

  Rubriques connexes

Description  Le déclencheur Before Report est activé avant l'exécution de l'état, mais après l'analyse des interrogations et l'extraction des données.

Niveau de définition  état

Sur échec

Affiche un message d'erreur, puis revient à l'endroit à partir duquel vous avez exécuté l'état.


Déclencheur Between Pages

  Rubriques connexes

Description  Le déclencheur Between Page est activé avant la mise en forme de chaque page de l'état, sauf la première. Il permet la mise en forme personnalisée des pages. Dans l'Aperçu interactif ou l'Aperçu Runtime, il n'est activé que la première fois que vous passez à une page. Si vous revenez ultérieurement à cette page, le déclencheur n'est pas réactivé.

Niveau de définition  état

Sur échec

Affiche un message d'erreur lorsque vous tentez de passer à la page pour laquelle le déclencheur à retourné FALSE. Les pages suivant celle qui a retourné FALSE ne sont pas mises en forme. Si le déclencheur retourne FALSE sur la dernière page, aucune opération n'est exécutée, puisque la mise en forme de l'état est achevée. Le déclencheur Between Page n'est pas activé avant la première page. S'il retourne FALSE sur la première page, celle-ci est affichée mais, si vous tentez de passer à la deuxième, un message d'erreur s'affiche.


Choix du déclencheur d'état à utiliser

  Exemples	  Rubriques connexes

En règle générale, tout traitement qui affecte les données extraites par l'état peut être exécuté dans les déclencheur Before Form ou After Form. (Ces déclencheurs d'état sont les deux seuls qui sont activés avant toute analyse ou extraction.) Tout traitement qui n'affecte pas les données extraites par l'état peut être exécuté dans les autres déclencheurs.

Report Builder comporte cinq déclencheurs d'état globaux. Vous ne pouvez pas en créer d'autres. Les noms de déclencheurs indiquent le stade auquel ils sont activés :

Before Report	Activé avant l'exécution de l'état, mais après l'analyse des interrogations.
After Report	Activé après la sortie de l'Aperçu interactif, ou après l'envoi de la sortie de l'état à la destination prévue (fichier, imprimante ou ID utilisateur de Oracle Office, par exemple). Ce déclencheur permet de supprimer tout traitement initial exécuté (suppression de table, par exemple). Notez cependant que ce déclencheur est toujours activé, que votre état s'exécute correctement ou non.
Between Pages	Activé avant la mise en forme de chaque page de l'état, sauf la première. Il permet la mise en forme personnalisée des pages. Dans l'Aperçu interactif, il n'est activé que la première fois que vous passez à une page. Si vous revenez ultérieurement à cette page, le déclencheur n'est pas réactivé.
Before Parameter Form	Activé avant l'affichage de la Grille de paramètres d'exécution. Il permet d'accéder aux valeurs des paramètres, aux variables globales PL/SQL et aux colonnes de niveau Etat, et de les modifier. Ce déclencheur est activé même si la Grille de paramètres d'exécution est supprimée. Vous pouvez donc l'utiliser pour valider des paramètres de ligne de commande.
After Parameter Form	Activé après l'affichage de la Grille de paramètres d'exécution. Il vous permet d'accéder aux paramètres et de vérifier leurs valeurs. Il permet également de modifier les valeurs des paramètres ou, en cas d'erreur, de retourner à la Grille de paramètres d'exécution. Il ne permet pas d'accéder aux colonnes du Modèle de données. Ce déclencheur est activé même si la Grille de paramètres d'exécution est supprimée. Vous pouvez donc l'utiliser pour valider des paramètres de ligne de commande ou d'autres données.


Ordre d'exécution des déclencheurs d'état

  Rubriques connexes

L'ordre d'exécution des événements, lorsqu'un état est exécuté, est le suivant :

1	Le déclencheur Before Form est activé.

2	La Grille de paramètres d'exécution s'affiche (si elle n'a pas été supprimée).

3	Le déclencheur After Form est activé (à moins que l'utilisateur ne l'annule dans la Grille de paramètres d'exécution).

4	L'état est "compilé".

5	Les interrogations sont analysées.

6	Le déclencheur Before Report est activé.

7	La fonction SET TRANSACTION READONLY est exécutée (si elle a été indiquée par l'argument ou l'option READONLY).

8	L'état est exécuté et le déclencheur Between Page est activé pour chaque page, sauf la dernière. (Notez que les données peuvent être extraites à n'importe quel stade de la mise en forme de l'état.) Les procédures COMMIT peuvent être exécutées à ce stade, en raison de l'une des sorties utilisateur ci-après avec DDL, SRW.DO_SQL avec DDL, ou si ONFAILURE=COMMIT, et l'exécution de l'état échoue.

9	La procédure COMMIT est exécutée (si READONLY est indiquée) pour mettre fin de la transaction.

10	Le déclencheur After Report est activé.

11	La procédure COMMIT/ROLLBACK/NOACTION est exécutée en fonction de l'argument ou de l'option ONSUCCESS.

Attention

•	Aux étapes 4 à 9, évitez les instructions DDL qui modifieraient les tables sur lesquelles repose l'état. L'étape 3 prend un "instantané" des tables, qui doit rester valide pendant toute l'exécution de l'état. Aux étapes 7 à 9, évitez les instructions DML qui modifieraient le contenu des tables sur lesquelles repose l'état. Comme les interrogations peuvent être exécutées dans n'importe quel ordre, les instructions DML ne sont pas fiables (à moins qu'elles ne soient exécutées sur des tables qui ne sont pas utilisées par l'état.

•	Si vous indiquez READONLY, évitez également DDL. Lorsque vous exécutez une instruction DDL (par exemple par l'intermédiaire de SRW.DO_SQL ou d'une sortie utilisateur), une procédure COMMIT est automatiquement émise. Si vous utilisez READONLY, la transaction commencée par SET TRANSACTION READONLY prend fin prématurément.


Déclencheurs d'état - Restrictions

•	Si vous envoyez la sortie de votre état à l'Aperçu Runtime ou à l'Aperçu interactif, les déclencheurs d'état peuvent être activés en partie ou en totalité, avant que vous visualisiez la sortie de l'état. Par exemple, si vous utilisez SRW.MESSAGE pour émettre un message dans le déclencheur Between Page lorsqu'une condition est remplie, alors que l'état comporte des références Avant (par exemple, un nombre total de pages affiché avant la dernière page), Report Builder peut devoir effectuer une mise en forme anticipée pour calculer les références Avant. Même si vous n'avez visualisé aucune page, l'état peut déjà avoir été mis en forme et le déclencheur activé.

•	Dans les déclencheurs d'état, vous pouvez utiliser les valeurs des paramètres et des colonnes de niveau Etat, par exemple la valeur d'un paramètre appelé NOMBRE1 dans une condition (par exemple, IF :NOMBRE1 = 10). Notez cependant que vous ne pouvez pas faire référence à des colonnes dépendant de pages (c'est-à-dire des colonnes pour lesquelles la propriété Remise à a été définie à Page) ou des colonnes qui utilisent des colonnes dépendant de pages.

•	Dans les déclencheurs Before et After Form et Before et After Report, vous pouvez définir les valeurs des paramètres (par exemple, leur donner une valeur dans une instruction d'affectation, :NOMBRE1 = 15). Dans les déclencheurs Before et After Report, vous pouvez également définir les valeurs des colonnes de réserve de niveau état.

•	Dans le déclencheur Between Page, vous ne pouvez pas définir les valeurs d'objets de modèle de données. Notez également que l'utilisation de variables globales PL/SQL pour définir indirectement les valeurs de colonnes ou de paramètres n'est pas conseillée, sous peine de résultats imprévisibles.

•	Si vous exécutez un état à partir de Report Builder Runtime (c'est-à-dire sans passer par la ligne de commande ou SRW.RUN_REPOR), vous devez valider les modifications apportées à la base de données dans les déclencheurs Before Form, After Form et Validation avant l'exécution de l'état. Dans ce cas, ces déclencheurs partagent la connexion du processus père à la base de données. Cependant, lorsque l'état est exécuté effectivement, il crée sa propre connexion à la base de données.

•	Vous ne pouvez pas utiliser de référence lexicale pour créer des variables de lien supplémentaires après l'activation du déclencheur After Form. Soit, par exemple, une interrogation du type :

SELECTIONNEZ ENAME, SAL FROM EMP
&where_clause

dans laquelle la clause WHERE est remplacée par une référence lexicale. Si la valeur du paramètre WHERE_CLAUSE contient une référence à une variable de lien, vous devez indiquer la valeur dans le déclencheur After Form ou avant le déclencheur. Si vous avez indiqué la valeur du paramètre dans le déclencheur Before Report, vous générez une erreur, mais si vous l'avez indiquée dans le déclencheur After Form, l'état est exécuté.

WHERE SAL = :new_bind


Syntaxe des appels de procédure

  Rubriques connexes

Report Builder est livré avec des procédures de deux types :

•	celles qui acceptent un paramètre (une ligne de commande Report Builder valide pour l'exécutable appelé),

•	celles qui acceptent deux paramètres (une ligne de commande Report Builder valide pour l'exécutable appelé et la longueur de cette chaîne).

(Les procédures qui acceptent deux paramètres sont utiles si votre langage de programmation ne gère pas les chaînes terminées par des caractères NULL.

Noms des procédures C de Report Builder :

Exécutable	Proc (1 paramètre)	Proc (2 paramètres)

RWCON60	RWCCON	RW2CON

RWRUN60--bitmap	RWCRRB	RW2RRB

RWRUN60--mode caractère	RWCRUN	RW2RUN

RWBLD60--bitmap	RWCSRB	RW2SRB

Exemples en C

Exemples d'appels de procédure RWRUN60 (illustrés ci-dessous en C)

Exécutable	Nom de procédure	Syntaxe d'appel de procédure

RWRUN60	RWCRRB	long rwcrrb
(bitmap)	( /*_ char _*/)

RWRUN60	RWCRUN	long rwcrun
(mode caractère)	( /*_ char _*/ )

RWRUN60	RW2RRB	long rw2rrb
(bitmap)	( /*_ char *, long * _*/ )

RWRUN60	RW2RUN	long rw2run
(mode caractère)	( /*_ char *, long * _*/ )

Exemple d'appel de procédure RWRUN60 de Report Builder (dans un programme C type) :

Appel d'un paramètre

long ret, rwcrun (); if (ret = rwcrun ("report=areport userid=scott/tiger myparam=AB") ) 	goto error;

Appel de deux paramètres

long len, ret, rw2run (); len = 44;  if (ret = rw2run ("report=areport userid=scott/tiger myparam=AB", &len) ) 	goto error;

Notes d'utilisation

•	La bibliothèque RWOCI60.LIB est fournie pour les plates-formes Windows 32 bits (Windows 95 ou NT). Un programme en C (ocismp.c) proposé à titre d'exemple (répertoire SAMPLES) décrit comment appeler la bibliothèque OCI. Son makefile, ocismp.mak (pour Microsoft Visual C++), est inclus pour référence.

•	Si vous créez un projet, les fichiers suivants sont les fichiers OCI standard (ils se trouvent dans le répertoire %ORACLE_HOME%\REPORT30\OCI) que vous devez ajouter au projet parallèlement à vos fichiers en C :

rwbld60.res	fichier ressource Report Builder
rwoci.h	fichier d'en-tête
rwoci60.lib	bibliothèque Report Builder
•	RWOCI60.DLL doit figurer dans la variable d'environnement PATH actuelle.


Contrôle d'erreurs des appels de procédure

  Rubriques connexes

Si l'appel de procédure détecte une erreur, il retourne à votre programme un nombre positif  ; sinon, il retourne un zéro.


Appel de procédure - Restrictions

  Rubriques connexes

•	Si la ligne de commande comporte un ID utilisateur et un mot de passe, comme dans les exemples ci-dessus, Report Builder tente de se connecter à ce compte ORACLE.

•	Si le programme appelant est déjà connecté à ORACLE, la ligne de commande ne doit pas contenir d'ID utilisateur ni de mot de passe, et Report Builder utilise donc la connexion active.

•	Report Builder se déconnecte d'ORACLE uniquement s'il était connecté. Si le programme appelant était déjà connecté, la connexion reste active au retour de Report Builder.

•	Les mots-clés ONSUCCESS et ONFAILURE de RWBLD60 et RWRUN60 déterminent si Report Builder exécute une procédure COMMIT, une procédure ROLLBACK ou aucune opération après l'exécution ou l'échec d'un état.

•	L'appel de procédure peut comporter un maximum de 2047 caractères alphanumériques.

•	Les appels de procédure Report Builder (par exemple, RWCRUN) sont écrits en C. La façon dont vous transférez des arguments d'un programme à un sous-programme en C dépend du compilateur de votre langage hôte (Ada, C, COBOL, FORTRAN, Pascal ou PL/l). Pour plus de détails sur l'interfaçage avec les appels de procédure en C, reportez-vous à la documentation de votre compilateur.

•	Lorsqu'il est appelé, l'exécutable lance les états dans le cadre d'un ou plusieurs processus, selon les arguments SERVER et BACKGROUND placés sur la ligne de commande. Si SERVER and BACKGROUND=NO, l'état est exécuté de façon synchrone par Reports Server. Si SERVER and BACKGROUND=YES, il est exécuté de façon asynchrone. Si vous ne précisez pas que SERVER and BACKGROUND=NO, l'état est exécuté dans l'application utilisateur. Si vous ne précisez pas que SERVER and BACKGROUND=YES, il est exécuté par Reports Background Engine.


Exemples de programme d'appel de procédure

  Rubriques connexes

Vous trouverez un exemple complet d'utilisation de l'interface d'appel dans $ORACLE_HOME/REPORT30/OCI/Samples. Vous pouvez également consulter le fichier oci_info.txt dans $ORACLE_HOME/REPORT30/OCI.

Les exemples énumérés ci-dessous exécutent des appels de procédure à l'exécutable RWRUN60. Chaque programme est écrit dans un langage hôte d'interface de programmation différent :

Ada

C

COBOL

FORTRAN

Pascal

PL/l

Ces exemples de programme ont été exécutés sous VMS en utilisant des compilateurs VAX standard et liés à la bibliothèque Report Builder.

Remarque : La syntaxe exacte de vos appels de sous-programme est fonction de votre compilateur de langage hôte.


Ada - Exemple

  Rubriques connexes 	  Tous les exemples

with TEXT_IO; use TEXT_IO ;
procedure srwada  is

usr	: STRING(1..11) := "Scott/Tiger";
S	: STRING(1..160);
RES 	: STRING(1..10);
LEN 	: INTEGER;

function rwcrun ( S : string) return Integer;
pragma interface (C,rwcrun);
pragma import_function ( internal = RWCRUN ,
PARAMETER_TYPES = (STRING),
MECHANISM = (REFERENCE),
RESULT_MECHANISM = VALUE,
RESULT_TYPE = INTEGER);

package INT_IO is new INTEGER_IO (INTEGER); use INT_IO;
ret_code	: INTEGER;

begin
S(1..79) := "ETAT=T USERID=SCOTT/TIGER PARAMFORM=NO
  DESNAME=ADA.TXT DESTYPE=FILE BATCH=YES";
S(80) := standard.ASCII.nul;	-- null terminating
-- the string

PUT_LINE (" Appel à rwcrun #1 imminent");
ret_code := rwcrun (S);
if ret_code = 0 then
  PUT_LINE(" L'appel à Rwcrun a réussi. ");
else
  PUT_LINE(" le code retourné est ");
put (ret_code);new_line;
  PUT_LINE (" Erreur pendant l'appel de Runform");
end if;

end srwada;


C - Exemple

  Rubriques connexes 	  Tous les exemples

#include <stdio.h>
long  ret,
rwcrun (),
rwcsql ();
main()
{
  char options[132];
  long len;
  strcpy(options,"userid=scott/tiger report=t batch=yes
  paramform=no destype=file desname=report.txt");
  printf("\nOptions : %s", options);
  len=strlen (options);
  ret=rw2run(options);
  printf ("\nValeur du code de retour : %d", ret);
  exit();
}


COBOL - Exemple

  Rubriques connexes 	  Tous les exemples

IDENTIFICATION DIVISION.
PROGRAM-ID. COBREP.
ENVIRONMENT DIVISION.
DATA DIVISION.
WORKING-STORAGE SECTION.
*
01  OPTIONS.
  02  OPTION-TEXT	PIC X(132) VALUE "REPORT=SAMPLE1
USERID=SCOTT/TIGER BATCH=YES PARAMFORM=NO DESTYPE=FILE
DESNAME=SAMPLE1.TXT".
  02  FILLER 	PIC S9(4) COMP VALUE 0.
*
01  RETURN-CODE 	PIC S9(9) COMP.
PROCEDURE DIVISION.
MAIN-PROGRAM.
CALL "RWCRUN"
  USING BY REFERENCE OPTIONS
  GIVING RETURN-CODE.
DISPLAY "Code de retour après premier appel à rwcrun : "
RETURN-CODE
STOP RUN.


FORTRAN - Exemple

  Rubriques connexes 	  Tous les exemples

program fortran
 integer*4 status
 integer*4 rwcrun
 character*100 command
 command = 'report=test userid=system/manager batch=yes
1 destype=file desname=fortran.txt paramform=no'
 status = rwcrun (%REF(commande))
 write(*,1) status
1 format(1x,I4)
 end


Pascal - Exemple

  Rubriques connexes 	  Tous les exemples

PROGRAM srwpas(input,output);
Type
short = [WORD]  -32768..32767;
OptType = packed array[1..256] of char;
[external] function rwcrun (var options : OptType) :
  short Extern;
Var
Options : OptType;
RetCode : short;
Begin
Options := 'USERID=SCOTT/TIGER BATCH=YES REPORT=PASCAL 	PARAMFORM=NO';
Options[56] := CHR(0);
RetCode := rwcrun(options);
Writeln ('Code de retour du premier appel : ', RetCode);
End.


PL/l - Exemple

  Rubriques connexes 	  Tous les exemples

PLI: PROCEDURE OPTIONS(MAIN);
DECLARE OPTIONS CHAR(100),
 PART1   CHARACTER(79) DEFINED OPTIONS,
 ENDCHAR CHARACTER(1) DEFINED OPTIONS POSITION (100);
DECLARE RWCRUN ENTRY (CHARACTER(100))  RETURNS (FIXED
 BINARY(15));
DECLARE RETCODE FIXED BINARY(15);
 PART1='USERID=SCOTT/TIGER BATCH=YES REPORT=T
 DESNAME=PLI.TXT DESTYPE=FILE PARAMFORM=NO';
 ENDCHAR = LOW(1);
PUT SKIP EDIT('Options : ', OPTIONS) (A,A);
RETCODE = RWCRUN(OPTIONS);
PUT SKIP EDIT('Code de retour : ', RETCODE) (A, B(15));
PUT SKIP(2) LIST('************');
END PLI;


Types de sortie utilisateur

  Rubriques connexes

Vous pouvez écrire les types de sorties utilisateur suivants :

Sorties utilisateur Précompilateur ORACLE

Sorties utilisateur OCI (ORACLE Call Interface)

Sorties utilisateur autres que ORACLE

Vous pouvez aussi écrire une sortie utilisateur qui allie l'interface du Précompilateur ORACLE et l'OCI.


Sorties utilisateur du Précompilateur ORACLE

Une sortie utilisateur du Précompilateur ORACLE comprend l'interface du Précompilateur ORACLE qui permet :

•	D'écrire un sous-programme dans l'un des langages hôte (Ada, C, COBOL, FORTRAN, Pascal, PL/l) et d'inclure des commandes SQL.

•	D'accéder à ORACLE (par des commandes SQL incorporées) et aux variables, paramètres et colonnes de Report Builder.

Ces fonctions vous permettent d'écrire 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 à votre documentation Programmer's Guide to the ORACLE Precompilers.

Remarque : Les systèmes d'exploitation n'acceptent pas tous les langages mentionnés.


Sorties utilisateur OCI (ORACLE Call Interface)

Une sortie utilisateur OCI comprend l'Interface d'appel ORACLE (ORACLE Call Interface) qui vous permet d'écrire un sous-programme contenant des appels à ORACLE. Une sortie utilisateur qui comprend uniquement l'OCI (et non l'interface du Précompilateur ORACLE) ne peut pas accéder aux variables, paramètres et colonnes de Report Builder.

Pour plus d'informations sur l'OCI, reportez-vous à Programmer's Guide to the ORACLE Call Interface.


Sorties utilisateur autres que ORACLE

Une sortie utilisateur autre que ORACLE ne comprend ni l'OCI ni l'interface du Précompilateur ORACLE. Par exemple, une sortie utilisateur autre que ORACLE peut être écrite entièrement en C. Par définition, elle ne peut pas accéder aux variables, aux paramètres et aux colonnes d'ORACLE ou de Report Builder.


Ecriture d'une sortie utilisateur

Pour écrire une sortie utilisateur, vous devez disposer des informations suivantes :

 Fonctions prises en charge

 Syntaxe de l'appel à une sortie utilisateur transmise

 Contrôle des erreurs et génération de messages d'erreur

Notes d'utilisation

•	Vous ne pouvez pas exécuter d'entrée/sortie écran en langage hôte à partir d'une sortie utilisateur de Précompilateur ORACLE, car les routines Runtime utilisées par un langage hôte pour exécuter des entrées/sorties écran sont incompatibles avec les routines utilisées par Report Builder pour exécuter ses entrées/sorties.

•	Cette section s'applique exclusivement aux sorties utilisateur du Précompilateur ORACLE, car c'est le type de sortie utilisateur que vous utiliserez le plus souvent (elle peut accéder aux variables, aux paramètres et aux colonnes de Report Builder et aux données ORACLE) et c'est le type conseillé par ORACLE pour la plupart des tâches.

•	Cette section n'explique pas comment écrire un appel à une sortie utilisateur (c'est-à-dire comment appeler la sortie utilisateur à partir de Report Builder). Pour plus d'informations sur l'écriture des appels aux sorties utilisateur, reportez-vous à "Appel d'une sortie utilisateur".


Fonctions prises en charge

Une sortie utilisateur que vous écrivez dans l'un des langages hôte du Précompilateur ORACLE peut exécuter des opérations procédurales par des instructions en langage hôte, et d'autres fonctions par les types d'instructions suivants :

Types d'instruction	Utilisation
EXEC SQL	Exécute des commandes SQL.
EXEC IAF GET	Transmet des valeurs de Report Builder à une sortie utilisateur.
EXEC IAF PUT	Transmet des valeurs d'une sortie utilisateur à Report Builder.
EXEC ORACLE	Exécute les options du Précompilateur ORACLE.


Instructions SQL EXEC

Une instruction SQL EXEC est une commande SQL précédée de "EXEC SQL". Cette instruction vous permet d'exécuter toute commande SQL dans une sortie utilisateur du Précompilateur ORACLE, par exemple de sélectionner ou de manipuler des données à partir d'une sortie utilisateur.

Syntaxe

EXEC SQL instruction_sql;

où :

instruction_sql	est toute instruction SQL ORACLE valide, à l'exception des commandes restreintes mentionnées dans cette section.

Il n'est pas nécessaire d'exécuter une instruction CONNECT explicite dans une sortie utilisateur de Précompilateur ORACLE, car Report Builder crée automatiquement la connexion. Cependant, ORACLE ne prend pas en charge des connexions simultanées. Pour plus d'informations, reportez-vous à Programmer's Guide to the ORACLE Precompilers.

Attention :  Evitez d'utiliser DDL lorsque vous indiquez READONLY. L'exécution d'une instruction DDL (par exemple par SRW.DO_SQL ou une sortie utilisateur) s'accompagne automatiquement d'une procédure COMMIT. Si vous utilisez READONLY, la transaction débutée par SET TRANSACTION READONLY prend fin prématurément. Pour plus d'informations, reportez-vous à "READONLY".

Notes d'utilisation

•	Les mots-clés ONSUCCESS et ONFAILURE de RWBLD60 et RWRUN60 déterminent si Report Builder exécute une procédure COMMIT, une procédure ROLLBACK ou aucune opération après l'exécution ou l'échec d'un état. A tous les autres stades, vous pouvez demander une procédure COMMIT dans votre sortie utilisateur ou dans PL/SQL (après votre appel à la sortie utilisateur, ajoutez SRW.DO_SQL('commit'); ).


EXEC IAF GET

Une instruction EXEC IAF GET transmet une valeur de Report Builder à une sortie utilisateur du Précompilateur ORACLE. Plus précisément, elle entre la valeur d'un paramètre ou d'une colonne de Report Builder dans une variable en langage hôte. La valeur transmise par Report Builder à une sortie utilisateur peut être utilisée par cette dernière pour des opérations de calcul, de modification ou de mise à jour.

Syntaxe

EXEC IAF GET variable_état_1[, variable_état_2, ...] INTO :variable_hôte_1[, :variable_hôte_2, ...];

où :

variable_état_n	Contient le nom du paramètre ou de la colonne de Report Builder dont est extraite la valeur.

variable_hôte_n	Indique le nom de la variable en langage hôte dans laquelle vous placez une valeur.

Notes d'utilisation

•	Variable_état_n peut être une référence à l'un des éléments suivants :

•	un nom de paramètre ou de colonne Report Builder non ambigu. (Pour extraire la date du jour, créez un paramètre en indiquant pour Source : &DATE, puis extrayez (GET) la valeur du paramètre. Pour extraire le numéro de la page logique en cours, appelez la fonction en package SRW.GET_PAGE_NUM, puis transmettez la valeur à une sortie utilisateur par votre appel à la sortie utilisateur).

•	une variable en langage hôte (précédée de deux points) dont la valeur est l'un des éléments mentionnés dans le paragraphe précédent.

•	Si Value If Null a été indiqué pour la colonne transmise, EXEC IAF GET l'utilise pour les éventuelles valeurs nulles de la colonne. Si Value If Null n'est pas indiqué, aucune valeur n'est retournée par EXEC IAF GET. Pour éviter cela, définissez la valeur d'une variable hôte avant d'exécuter EXEC IAF GET, de façon à savoir si la valeur de la variable a été modifiée par EXEC IAF GET.

•	Pour connaître les restrictions éventuelles sur les variables en langage hôte, reportez-vous à Programmer's Guide to the ORACLE Precompilers.

•	Si les données d'un objet Report Builder ont plus de 64 000 octets de long, la valeur retournée par EXEC IAF GET est tronquée aux 64 000 premiers octets.


EXEC IAF PUT

Une instruction EXEC IAF PUT transmet une valeur d'une sortie utilisateur du Précompilateur ORACLE à Report 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 ou une colonne de Report Builder.

Syntaxe

EXEC IAF PUT variable_état[, ...]  VALUES ({:variable_hôte | constante}[, ...]);

où :

variable_état	Indique le nom du paramètre ou de la colonne de Report Builder dans laquelle vous introduisez une valeur ou d'une variable hôte (précédée d'un signe deux points) dont la valeur est le nom d'un paramètre ou d'une colonne de Report Builder).

variable_hôte	Indique le nom de la variable en langage hôte dont vous extrayez une valeur.

constante	Est la constante à transmettre.

Notes d'utilisation

•	Les données de plus de 64 000 octets ne peuvent pas être transmises par EXEC IAF PUT dans un objet Report Builder (elles seront tronquées aux 64 000 premiers octets).

•	Vous devez représenter les variables hôtes et les constantes en format SQL standard :

•	les chaînes et les constantes sont transmises telles quelles

•	les dates sont transmises en format AAAAMMJJHH24MISS

•	les variables hôte sont précédées d'un signe deux-points (:)

•	Le tableau ci-dessous est fourni à titre d'exemple :

Valeur	Résultat

Summit Sporting	Indique comment la valeur de la chaîne constante Summit
Goods	Sporting Goods est transmise.

413.60	Indique comment la valeur numérique de la constante, 413,60 est
transmise.

19910414083000	Indique comment la valeur de la date 14 avril 1991, 8 h 30 est
transmise.

:holder1	Indique comment la valeur de la variable hôte holder1 est
transmise.


Instructions ORACLE EXEC

Une instruction ORACLE EXEC est une instruction qui n'est pas une instruction SQL standard et qui est utilisée pour exécuter les options du Précompilateur ORACLE. Pour plus d'informations, reportez-vous à Programmer's Guide to the ORACLE Precompilers.

Notes d'utilisation

Attention :  Evitez d'utiliser DDL lorsque vous indiquez READONLY. L'exécution d'une instruction DDL (par exemple par SRW.DO_SQL ou une sortie utilisateur) s'accompagne automatiquement d'une procédure COMMIT. Si vous utilisez "READONLY", la transaction débutée par SET TRANSACTION READONLY prend fin prématurément.

•	Les mots-clés ONSUCCESS et ONFAILURE de RWBLD60 et RWRUN60 déterminent si Report Builder exécute une procédure COMMIT, une procédure ROLLBACK ou aucune opération après l'exécution ou l'échec d'un état. A tous les autres stades, vous pouvez demander une procédure COMMIT dans votre sortie utilisateur.

•	Vous pouvez exécuter des entrées/sorties de fichiers en langage hôte à partir d'une sortie utilisateur.


Syntaxe d'un appel à une sortie utilisateur transmise

Votre programme de sortie utilisateur recevra l'appel de la sortie utilisateur sous la forme d'une chaîne contenant le nom de la sortie utilisateur puis, en option, une liste d'arguments. Les arguments de la liste sont séparés par des blancs.

Exemples

L'appel :

SRW.USER_EXIT('quota 10 20 Q4');

est transmis à la sortie utilisateur sous la forme :

'quota 10 20 Q4'

L'appel :

SRW.USER_EXIT('quota');

est transmis à la sortie utilisateur sous la forme :

'quota'

Notes d'utilisation

•	C'est la sortie utilisateur, et non Report Builder, qui doit analyser la chaîne de l'appel de sortie utilisateur.

•	S'il y a plusieurs blancs entre les arguments transmis avec le nom de la sortie utilisateur, Report Builder supprime les blancs 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'


Génération de messages d'erreur à partir de la sortie utilisateur

Dans votre programme de sortie utilisateur, vous pouvez définir un message d'erreur et le générer dans la région de message de Report Builder en copiant la chaîne d'erreur dans le tampon d'erreurs SRWERB.

Remarque : Dans Report Builder, vous pouvez définir et générer un message d'erreur par l'intermédiaire de PL/SQL. Pour plus d'informations, reportez-vous à "Appel d'une sortie utilisateur".

Utilisation du tampon d'erreur SRWERB

Vous pouvez définir un message d'erreur dans la sortie utilisateur en écrivant la chaîne d'erreur dans un tampon de 256 octets nommé SRWERB. Report Builder initialise ce tampon lors de l'exécution de l'état. Si, lors du retour d'une sortie utilisateur, Report Builder constate que le tampon n'est pas vide (c'est-à-dire si le premier caractère du tampon n'est pas nul), il génère une erreur en utilisant le contenu du tampon comme message d'erreur.


Mise en oeuvre des sorties utilisateur

Vous pouvez mettre en oeuvre des sorties utilisateur de deux façons différentes :

en modifiant le fichier source exemple ;

en créant un fichier source à partir de la table IAPXTB .

Remarque : La modification du fichier source est la solution la plus simple.


Modification du fichier source exemple

Pour mettre en oeuvre les sorties utilisateur, vous pouvez  simplement ajouter des entrées au fichier source exemple, ue_xtb.c, pour chaque sortie utilisateur. L'emplacement de ce fichier est fonction du système d'exploitation utilisé.

Fichier source exemple :

/* Définir la table de sorties utilisateur */
extern exitr iapxtb[] =  {  /* Contient la routine de sortie */     "UE_OK",         ue_ok, XITCC,
"UE_ERR",        ue_err, XITCC,
"UE_MB",         ue_mb,  XITCC,
"UE_EMP_PLAN",   ue_emp_plan,  XITCC,
(char *) 0, 0, 0         /* une entrée ayant la valeur zéro indique la fin */
};

/* fin de iapxtb */

Le premier élément de l'entrée est le nom (entre guillemets) que vous utiliserez dans Report Builder pour faire référence à la sortie utilisateur. Le deuxième est le nom réel de la routine de sortie utilisateur. Le dernier (XITCC) indique que la sortie utilisateur est appelée à l'aide du langage C. Pour les autres langages, utilisez comme dernier élément :

XITCOB /* COBOL */

XITFOR /* FORTRAN */

XITPLI /* PL/I */

XITPAS /* PASCAL */

XITAda /* ADA */

Après avoir modifié le fichier source, compilez-le, ainsi que votre programme de sortie utilisateur. Liez ensuite le fichier objet IAPXTB résultant aux exécutables RWBLD60 et RWRUN60.


Création du fichier source à partir de la table IAPXTB

Pour créer le fichier source à partir de la table IAPXTB, procédez de la manière suivante :

1	Créez une table IAPXTB.

2	Insérez chaque nom de sortie utilisateur (à raison d'une ligne par sortie utilisateur) dans la table IAPXTB.

3	Générez un fichier source à partir de la table IAPXTB et compilez-le ainsi que le programme que vous avez écrit. Liez les modules objets résultants à RWBLD60 et RWRUN60.

Pour pouvoir mettre en oeuvre une sortie utilisateur (sur un système d'exploitation quelconque), vous devez avoir le programme GENXTB et l'application Form Builder GENXTB.

Remarque : Le processus de mise en oeuvre d'une sortie utilisateur est propre à chaque système d'exploitation. Pour plus d'informations sur la marche à suivre, reportez-vous à Developer/2000 Installation Guide, pour votre système d'exploitation.


Création de la table IAPXTB

Utilisez le programme GENXTB pour créer la table IAPXTB, qui est la table de base qui sera utilisée par l'application Forms Form Builder GENXTB. Si vous n'avez pas Form Builder, créez vous-même une table IAPXTB en utilisant SQL*Plus. Pour plus d'informations sur la création des tables, reportez-vous à ORACLE8 Server SQL Language Reference Manual.

Syntaxe

La table IAPXTB contient la liste de toutes les sorties utilisateur que vous lierez à Report Builder. Chacune des colonnes de cette table est décrite ci-dessous.

Nom de colonne	Description	Utilisation
XTB$XNM	NOM	Cette colonne indique le nom de la sortie utilisateur (qui n'est pas forcément celui du fichier qui contient la sortie utilisateur). Notez que certains langages hôtes font la différence entre les majuscules et les minuscules.
XTB$XTY	TYPE	Cette colonne indique le langage dans lequel est écrite la sortie utilisateur.
XTB$REM	REMARQUES	Cette colonne indique une chaîne de texte qui décrit la raison d'être de la sortie utilisateur.  Cette chaîne peut avoir jusqu'à 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.
Remarque : Stockez les versions texte de vos sorties utilisateur dans une table IAPXTB distincte, pour le cas où la table serait supprimée accidentellement.


Insertion de lignes dans la table IAPXTB

Utilisez l'application Forms GENXTB, qui est une application Form Builder, pour insérer des descriptions de vos sorties utilisateur dans la table IAPXTB. En l'absence de Form Builder, utilisez SQL*Plus pour insérer les lignes (reportez-vous à votre manuel SQL*Plus pour tous détails sur la façon d'insérer des lignes dans une table).

Vous devez entrer dans la table IAPXTB une ligne par nom de sortie utilisateur. (Cette condition est valable pour les sorties utilisateur du Précompilateur ORACLE, qu'elles soient dans un fichier qui sera précompilé et compilé seul, ou avec d'autres sorties utilisateur.) En outre, vous devez tenir à jour toutes les sorties utilisateur de production d'un système dans une table IAPXTB.

Notes d'utilisation

•	La table GENXTB doit contenir les noms de toutes les sorties utilisateur que vous voulez utiliser. Par exemple, si vous avez déjà une table GENXTB contenant des sorties utilisateur Form Builder, vous devrez ajouter les sorties utilisateur en package Report Builder (c'est-à-dire, RWECPF, RWEPLS, RWEATS, RWECAT, RWECTY) et les nouvelles sorties utilisateur que vous créez.


Génération du fichier source et compilation

Utilisez le programme GENXTB pour introduire les informations dans la table IAPXTB et générer son fichier source. Ce fichier source est le fichier de points d'entrée nécessaire pour lier vos sorties utilisateur.

Compilez le fichier source IAPXTB et votre programme de sortie utilisateur. Liez ensuite le fichier objet IAPXTB résultant aux exécutables RWBLD60 et RWRUN60.


Génération de DLL de sortie utilisateur sous Windows NT et Windows 95

Pour générer une sortie utilisateur pour Windows NT et Windows 95, vous devez générer un DLL appelé R60XTB32.DLL  (en suivant les instructions du manuel consacré à votre compilateur).

Exemple

L'exemple ci-dessous explique comment créer le DLL avec Microsoft Visual C++ pour les plates-formes 32 bits Windows.  (Tous les fichiers mentionnés dans cet exemple se trouvent dans $ORACLE_HOME\REPORT60\USEREXIT.)

1	Dans R60XTB32.MAK, mettez à jour la macro LINK32_OBJS qui doit comporter la liste de vos fichiers objets de sortie utilisateur. Si vous utilisez des éléments PRO/C incorporés ou des appels à EXEC IAF, vous devez également lier SQLLIB18.LIB et SQXLIB18.LIB.

2	Modifiez le fichier source exemple (ue_xtb.c) en ajoutant une entrée pour chaque sortie utilisateur.

3	Editez une copie du fichier exemple RWXTB60.DEF et ajoutez des entrées pour exporter les fonctions de sortie utilisateur.

4	Créez le nouvel exécutable en utilisant la commande suivante :

NMAKE -f RWXTB60.MAK all CFG=»rwxtb60 - Win32 Debug" \
INCLUDE=.;\msdev\include

\msdev\include est un répertoire exemple ; vous devez utilisez le chemin d'accès de votre répertoire d'inclusion MSVC.

CFG peut également être "rwxtb60 - Win32 Release" pour créer le langage DLL de distribution.

5	Transférez votre nouveau RWXTB60.DLL dans le répertoire approprié (par exemple, %ORACLE_HOME%\bin).

Notes d'utilisation

•	Le nom et l'emplacement du langage DLL de sortie utilisateur peuvent être différents du nom et de l'emplacement par défaut (rwxtb60.dll dans %ORACLE_HOME%\bin). Pour cela, ajoutez une nouvelle valeur à la touche HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE dans votre fichier de base de registres :

•	Nom de valeur :  REPORTS60_USEREXIT

•	Type de données :  REG_SZ

•	Chaîne de valeur :  chemin d'accès et nom complets de votre langage DLL de sorties utilisateur.

•	Vous pouvez utiliser plusieurs langages DLL de sorties utilisateur en ajoutant les chemins d'accès et les noms complets de vos langages DLL aux chaînes Valeur de REPORTS60_USEREXIT et en les séparant par des points-virgules.


Appel d'une sortie utilisateur

Appel d'une sortie utilisateur ou Report Builder :

1	Ecriture d'un appel à une sortie utilisateur

2	Contrôle des erreurs et génération de messages d'erreur


Ecriture d'un appel à une sortie utilisateur

Vous pouvez appeler la sortie utilisateur à partir de tout endroit dans lequel vous pouvez entrer dans PL/SQL à partir de Report Builder. Utilisez la syntaxe suivante :

Syntaxe

[SRW.REFERENCE(:nom_1_objet);] [SRW.REFERENCE(:nom_2_objet2); ...]; SRW.USER_EXIT(nom_sortie_utilisateur [liste_arguments]');

où :

nom_objet_n	Indique le nom d'un paramètre ou d'une colonne de Report Builder dont la valeur sera transmise à la sortie utilisateur dans la chaîne de sortie utilisateur, ce qui déclenche la génération d'une liste de dépendances : Report Builder vérifie que chaque objet référencé contiendra la valeur calculée ou extraite en dernier, avant de la transmettre à la sortie utilisateur.  Remarque :  Vous devez faire référence à chaque paramètre ou à chaque colonne séparément.  Pour tous détails, reportez-vous à "SRW.REFERENCE".

utilisateur	Indique le nom de la sortie utilisateur à laquelle vous transmettez le contrôle. Ce nom peut avoir la longueur de votre choix. (Sur certains systèmes d'exploitation, la longueur est limitée à 6 caractères. Interrogez votre administrateur système.)

liste_arguments	Peut contenir les noms des paramètres et des colonnes, constantes, chaînes de caractères ou toute combinaison de ceux-ci, que vous voulez transmettre à la sortie utilisateur. La liste d'arguments peut avoir la longueur de votre choix.  Remarque : La syntaxe ci-dessus devra être incorporée dans une unité de programme PL/SQL.

Si vous voulez que vos appels aux sorties utilisateur aient le même format que les appels aux sorties utilisateur de Form Builder, vous pouvez utiliser SRW.USER_EXIT20 à la place de SRW.USER_EXIT.

Exemples

Vous avez écrit une sortie utilisateur (appelée INTEGRAL) qui calcule la surface sous une courbe, en fonction de deux points de la courbe. Soit deux colonnes de Report Builder (appelées POINT1 et POINT2) dont les valeurs contiennent les coordonnées x et y des deux points. Pour transmettre des copies des valeurs de colonnes à la sortie utilisateur, vous devez référencer les noms de colonnes en utilisant SRW.REFERENCE.  SRW.REFERENCE vérifie que les valeurs sont calculées avant d'être transmises à la sortie utilisateur.

Pour l'instant, votre code PL/SQL doit se présenter de la manière suivante :

srw.reference(:point1);

srw.reference(:point2);

Vous devez maintenant définir l'appel à la sortie utilisateur. Pour cela, utilisez la procédure SRW.USER_EXIT et transmettez les arguments suivants :

•	le nom de la sortie utilisateur (dans le cas présent, INTEGRAL.)

•	des arguments (dans le cas présent, les colonnes de Report Builder, POINT1 et POINT2.)

Votre code PL/SQL de la sortie utilisateur doit alors se présenter de la manière suivante :

srw.reference(:point1);

srw.reference(:point2);

srw.user_exit('integral point1 point2');

Enfin, supposons que vous voulez que le programme de sortie utilisateur retourne EXEC IAF PUT (la surface calculée dans la colonne de Report Builder appelée SURFACE). Pour cela, écrivez une fonction PL/SQL et, comme argument RETURN, référencez SURFACE.

Votre appel à la sortie utilisateur doit donc se présenter de la manière suivante :

   function compute_surface return char is

   begin

      srw.reference(:point1);

      srw.reference(:point2);

      srw.user_exit('integral point1 point2');

   return(:surface);

   end;

Remarques :  Vous faites référence à SURFACE comme argument RETURN pour être certain qu'une autre sortie utilisateur n'entrera pas (PUT) de valeur dans la colonne SURFACE après INTEGRAL (c'est-à-dire que tous les autres EXEC JIAF PUT de sortie utilisateur entrant dans cette colonne se produiront avant que la sortie utilisateur INTEGER soit activée). Comme les formules de colonne doivent retourner une valeur, vous devez écrire non pas une procédure, mais une fonction.

Notes d'utilisation

•	Les noms de sortie utilisateur doivent respecter les règles pour votre système d'exploitation et de votre langage hôte. N'oubliez pas que ces règles peuvent imposer de faire la différence entre les majuscules et les minuscules.

•	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 comptés. Ces limites peuvent dépendre du système d'exploitation utilisé. Pour connaître les limites exactes, interrogez votre administrateur système.

•	Les arguments doivent être séparés les uns des autres par un espace. S'il y a plusieurs espaces entre les arguments de la liste, Report 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'

•	Pour faire référence à des guillemets de littéral dans une liste d'arguments, utilisez \".  La barre oblique inversée sera supprimée avant la transmission de l'argument.

•	Si la liste d'arguments contient le nom d'un objet Report Builder (dont vous voulez transmettre la valeur à la sortie utilisateur), faites référence au nom de l'objet en utilisant la procédure PL/SQL SRW.REFERENCE.  SRW.REFERENCE garantit que l'objet contient la valeur calculée ou extraite en dernier avant sa transmission à la sortie utilisateur. Cependant, rien ne garantit qu'une sortie utilisateur pour un objet de présentation sera calculée sur la page sur laquelle l'objet de présentation est imprimé.

•	L'appel à la sortie utilisateur fait partie d'un élément de valeur PL/SQL qui introduit des valeurs dans d'autres objets, l'élément de valeur doit retourner (RETURN) l'objet Report Builder auquel appartient le code PL/SQL. Par exemple, si vous écrivez une fonction PL/SQL dans le champ Formule de la colonne EMP, la fonction doit retourner (RETURN) la colonne EMP : RETURN(:EMP);.  (Ce qui garantit qu'une autre sortie utilisateur n'entrera pas (PUT) une valeur dans l'objet lorsque la sortie utilisateur aura retourné sa valeur dans l'objet.)


Recherche et définition des erreurs de sortie utilisateur dans PL/SQL

Dans votre code PL/SQL, vous pouvez rechercher les erreurs, puis définir et générer un message d'erreur.

SRW.USER_EXIT_FAILURE

SRW.MESSAGE

Remarque : Vous pouvez également définir et générer un message dans votre programme de sortie utilisateur. Pour plus d'informations, reportez-vous à "Génération d'erreurs de la sortie utilisateur".


Recherche d'erreurs à l'aide de SRW.USER_EXIT_FAILURE

Dans PL/SQL, vous pouvez déterminer, à l'aide de l'exception PL/SQL en package "SRW.USER_EXIT_FAILURE", si une sortie utilisateur a échoué. Cette exception a la valeur TRUE si le tampon SRWERB n'est pas vide ; sinon, elle a la valeur FALSE. Pour plus d'informations sur le tampon SRWERB, reportez-vous à Génération d'erreurs de la sortie utilisateur.

Exemples

Vous avez une sortie utilisateur appelée MASORTIE et vous voulez savoir pourquoi elle a échoué. Votre sortie utilisateur peut se présenter de la manière suivante :

begin
   srw.user_exit('masortie');
exception
   when srw.user_exit_failure then
   srw.message(2000, 'La sortie utilisateur MASORTIE a échoué.');
   when others then
   srw.message (3000, 'Erreur d'état survenue avant
le retour de la sortie utilisateur MASORTIE.');
end;

Remarque : Dans cet exemple, la recherche d'erreurs s'effectue dans la partie corps du code PL/SQL. Vous auriez pu également l'entrer dans la partie EXCEPTION du code.


Définition du message d'erreur à l'aide de SRW.MESSAGE

Dans PL/SQL vous pouvez définir un message d'erreur et le générer dans la région des messages de Report Builder, en utilisant la procédure PL/SQL en package SRW.MESSAGE.  (Remarque :  Vous pouvez également définir et générer des messages d'erreur à partir du programme de sortie utilisateur. Pour plus d'informations, reportez-vous à Génération d'erreurs de la sortie utilisateur.

La syntaxe de SRW.MESSAGE est la suivante :

SRW.MESSAGE (no_msg NUMBER, texte_msg CHAR);

Il vous suffit donc de référencer SRW.MESSAGE avec le numéro d'erreur et la chaîne de votre choix. Exemples d'utilisation de SRW.MESSAGE pour générer un message d'erreur :

Exemples

Soit une sortie utilisateur, appelée MAGASIN, à laquelle vous voulez transmettre des valeurs de salaires provenant de Report Builder. Pour cela, vous pouvez écrire la formule suivante :

   function foo return boolean is
   begin
   if :sal >= 0 then
      srw.reference(:sal);
      srw.user_exit('sal magasin');
   else
      srw.message(100, 'Détection d'un salaire négatif.  Vérifier
        la table EMP.');
   end if;
   exception
   when srw.unknown_user_exit then
      srw.message(200, 'Sortie utilisateur MAGASIN inconnue.
        Vérifier si elle est liée.');
   when srw.user_exit_failure then
      srw.message(200, 'Echec de la sortie utilisateur MAGASIN. Vérifier
         son code.');
   return(true);
   end;

En cas d'échec de la sortie utilisateur, si le programme de sortie utilisateur n'enregistre pas de message dans le tampon SRWERB, SRW.USER_EXIT_FAILURE aura la valeur FALSE et Report Builder ne générera pas de message d'erreur. Si le programme de sortie utilisateur enregistre un message dans le tampon SRWERB, SRW.USER_EXIT_FAILURE aura la valeur TRUE et Report Builder générera le message "Echec de la sortie utilisateur MAGASIN. Vérifier son code".

Soir une sortie utilisateur, appelée GRANDE_SORTIE, qui contient un code d'auto-contrôle pour la recherche d'erreurs à trois emplacements différents. En présence d'une erreur, le code retourne (EXEC IAF PUT) l'une des valeurs suivantes : A si la partie A de GRANDE_SORTIE a échoué, B si la partie B a échoué, C si la partie C a échoué. Votre sortie utilisateur peut se présenter de la manière suivante :

  Procedure multi_errors is
     function inner return char is
     begin
        srw.user_exit('grande_sortie');
     return(:error);
     end;
  begin
  if :error='A'
     srw.message(100, 'Echec de partie A de GRANDE_SORTIE.');
  elsif :error='B'
     srw.message(200, 'Echec de partie B de GRANDE_SORTIE.');
  else
     srw.message(300, 'Echec de partie C de GRANDE_SORTIE.');
  end if;
  end;


Sorties utilisateur Report Builder en package

  Rubriques connexes

RWEATS

RWECAT

RWECPF

RWECTY

RWEPLS


RWEATS

Cette sortie utilisateur convertit une valeur d'attribut, stockée en format interne de Report Builder, en une chaîne associée extraite du fichier de messages de Report Builder. Cette sortie utilisateur est utilisée par Report Builder lors de la documentation de vos états stockés dans la base de données, à l'aide de Fichier [image] Administration [image] Etat sur états.

Syntaxe

SRW.USER_EXIT('rweats source destination no_attribut');

où :

source	Indique la valeur de table/de colonne à convertir : si la source indiquée ne contient pas de valeur, la colonne de destination sera vierge.

destination	Indique le nom de l'objet Report Builder dans lequel sera placée la valeur convertie.

no_attribut	Indique le numéro d'attribut de la colonne de la table de base de données de Report Builder.

Table	Colonne	Attributs	Description
SRW2_LAYOUT	UNITS	1	Unité de mesure d'état
SRW2_PARAM_FORM	UNITS	1	Unité de mesure de Grille de paramètres
SRW2_LAYOUT	ORIENT	2	Ordre d'impression panneau
SRW2_LAYOUT	RUN_FLAGS	3	Utiliser unité Caractère dans Designer
SRW2_LAYOUT	RUN_FLAGS	4	Utiliser unité Caractère dans l'explorateur
SRW2_LAYOUT	RUN_FLAGS	5	Désactiver l'hôte
SRW2_LAYOUT	RUN_FLAGS	6	Désactiver la fonction écran partagé
SRW2_LAYOUT	RUN_FLAGS	7	Désactiver le zoom
SRW2_LAYOUT	RUN_FLAGS	8	Démarrer sur le zoom
SRW2_LAYOUT	RUN_FLAGS	9	Afficher titre de l'explorateur
SRW2_LAYOUT	RUN_FLAGS	10	Afficher ligne de message de l'explorateur
SRW2_LAYOUT	RUN_FLAGS	11	Afficher état de l'explorateur
TOOL_PLSQL	TYPE	12	Type de déclencheur d'état
SRW2_LAYOUT	SETTINGS	13	Options d'affichage - Section état
SRW2_LAYOUT	SETTINGS	14	Options d'affichage - Afficher champ
SRW2_LAYOUT	SETTINGS	15	Options d'affichage - Afficher icônes commentaire
SRW2_LAYOUT	SETTINGS	16	Options d'affichage - Afficher noms
SRW2_LAYOUT	SETTINGS	18	Options d'affichage - Afficher contours de champ
SRW2_LAYOUT	SETTINGS	19	Options d'affichage - Afficher contours texte standard
SRW2_LAYOUT	SETTINGS	20	Options d'affichage - Afficher contours d'encadrement
SRW2_LAYOUT	SETTINGS	21	Options d'affichage - Afficher icônes de changement de page
SRW2_LAYOUT	SETTINGS	22	Options d'affichage - Afficher icônes de protection de page
SRW2_LAYOUT	SETTINGS	23	Options d'affichage - Afficher icônes objets solidaires
SRW2_LAYOUT	SETTINGS	24	Options d'affichage - Afficher points d'ancrage
SRW2_COLUMN	SOURCE_ID	25	Source colonne
SRW2_COLUMN	COMPUTE_ID	25	Calculer colonne
SRW2_COLUMN	RESET_ID	25	Réinitialisation de colonne
SRW2_FRAME	GROUP_ID	25	Groupe encadrement itératif
SRW2_FIELD	SOURCE_ID	25	Source champ
SRW2_FIELD	PGN_RESET	25	Numérotation page champ Réinitialisation de l'encadrement itératif
SRW2_COLUMN	DATA_TYPE	26	Type de données colonne/paramètre
SRW2_COLUMN	FILE_TYPE	27	Type de format de colonne
SRW2_BOILERPLATE SRW2_BOILERPLATE	GRAPH_TYPE	27	Type de format texte standard
SRW2_FRAME	FORMATFLAG	28	Région encadrement/encadrement itératif
SRW2_FIELD	FORMATFLAG	28	Région champ
SRW2_BOILERPLATE SRW2_BOILERPLATE	FORMATFLAG	28	Région texte standard
SRW2_OG_DOCUMENT SRW2_OG_DOCUMENT	FORMATFLAG	28	Région document Oracle Graphics
SRW2_FRAME	FORMATFLAG	29	Dimensionnement vertical Encadrement/Encadrement itératif
SRW2_FIELD	FORMATFLAG	29	Dimensionnement vertical de champ
SRW2_BOILERPLATE SRW2_BOILERPLATE	FORMATFLAG	29	Dimensionnement vertical de texte standard
SRW2_OG_DOCUMENT SRW2_OG_DOCUMENT	FORMATFLAG	29	Dimensionnement vertical de document Oracle Graphics
SRW2_FRAME	FORMATFLAG	30	Dimensionnement horizontal Encadrement/Encadrement itératif
SRW2_FIELD	FORMATFLAG	30	Dimensionnement horizontal de champ
SRW2_BOILERPLATE SRW2_BOILERPLATE	FORMATFLAG	30	Dimensionnement horizontal de texte standard
SRW2_OG_DOCUMENT SRW2_OG_DOCUMENT	FORMATFLAG	30	Dimensionnement horizontal de document Oracle Graphics
SRW2_FRAME	FORMATFLAG	31	Type de condition d'impression d'encadrement/encadrement itératif
SRW2_FIELD	FORMATFLAG	31	Type de condition d'impression de champ
SRW2_BOILERPLATE SRW2_BOILERPLATE	FORMATFLAG	31	Type de condition d'impression de texte standard
SRW2_OG_DOCUMENT SRW2_OG_DOCUMENT	FORMATFLAG	31	Type de condition d'impression de document Oracle Graphics
SRW2_FRAME	FORMATFLAG	32	Objet condition d'impression de cadre/encadrement itératif
SRW2_FIELD	FORMATFLAG	32	Objet condition d'impression de champ
SRW2_BOILERPLATE SRW2_BOILERPLATE	FORMATFLAG	32	Objet condition d'impression standard
SRW2_OG_DOCUMENT SRW2_OG_DOCUMENT	FORMATFLAG	32	Objet condition d'impression de document Oracle Graphics
SRW2_FRAME	FORMATFLAG	33	Valeur par défaut de la condition d'impression de cadre/encadrement itératif
SRW2_FIELD	FORMATFLAG	33	Valeur par défaut de la condition d'impression de champ
SRW2_BOILERPLATE SRW2_BOILERPLATE	FORMATFLAG	33	Valeur par défaut de la condition d'impression de texte standard
SRW2_OG_DOCUMENT SRW2_OG_DOCUMENT	FORMATFLAG	33	Valeur par défaut de la condition d'impression de document Oracle Graphics
SRW2_FRAME	FORMATFLAG	34	Cadre/encadrement itératif - Saut de page avant
SRW2_FIELD	FORMATFLAG	34	Champ - Saut de page avant
SRW2_BOILERPLATE SRW2_BOILERPLATE	FORMATFLAG	34	Texte standard - Saut de page avant
SRW2_OG_DOCUMENT SRW2_OG_DOCUMENT	FORMATFLAG	34	Document Oracle Graphics - Saut de page avant
SRW2_FRAME	FORMATFLAG	35	Cadre/encadrement itératif - Saut de page après
SRW2_FIELD	FORMATFLAG	35	Champ - Saut de page après
SRW2_BOILERPLATE SRW2_BOILERPLATE	FORMATFLAG	35	Texte standard - Saut de page après
SRW2_OG_DOCUMENT SRW2_OG_DOCUMENT	FORMATFLAG	35	Document Oracle Graphics - Saut de page après
SRW2_FRAME	FORMATFLAG	36	Cadre/encadrement itératif - Protection de page
SRW2_FIELD	FORMATFLAG	36	Champ - Protection de page
SRW2_BOILERPLATE SRW2_BOILERPLATE	FORMATFLAG	36	Texte standard - Protection de page
SRW2_OG_DOCUMENT SRW2_OG_DOCUMENT	FORMATFLAG	36	Document Oracle Graphics - Protection de page
SRW2_FRAME	FORMATFLAG	37	Cadre/encadrement itératif - Objets solidaires
SRW2_FIELD	FORMATFLAG	37	Champ - Objets solidaires
SRW2_BOILERPLATE SRW2_BOILERPLATE	FORMATFLAG	37	Texte standard - Objets solidaires
SRW2_OG_DOCUMENT SRW2_OG_DOCUMENT	FORMATFLAG	37	Document Oracle Graphics - Objets solidaires
SRW2_FIELD	ALIGNMENT	38	Champ - Justification
SRW2_BOILERPLATE SRW2_BOILERPLATE	ALIGNMENT	38	Texte standard - Justification
SRW2_QUERY	MAX_ROWS	39	Nombre maximal de lignes dans l'interrogation
SRW2_GROUP	GLF_TYPE	40	Filtre de groupe
SRW2_GROUP	CROSS_PROD	41	Groupe inter-produit
SRW2_GROUP	PRODUCT_ID	42	Groupe dans groupe inter-produit
SRW2_COLUMN	FLAGS	43	Colonne - Utilisation dans la ventilation
SRW2_COLUMN	FLAGS	44	Colonne - Lecture depuis fichier
SRW2_COLUMN	OPERATOR	45	Fonction de la colonne
SRW2_FRAME	DIRECTION	46	Encadrement itératif - Orientation de l'impression
SRW2_FRAME	DIRECTION	47	Encadrement itératif - Mode colonne
SRW2_FIELD	FORMATFLAG	48	Champ masqué
SRW2_FIELD	PGN_FLAGS	49	Champ - Numérotation des pages avec en-tête
SRW2_FIELD	PGN_FLAGS	50	Champ - Numérotation des pages avec corps
SRW2_FIELD	PGN_FLAGS	51	Champ - Numérotation des pages avec pied de page
SRW2_BOILERPLATE SRW2_BOILERPLATE	TYPE	52	Type standard (mode caractère)
SRW_DISPLAY_TAG	FONTSTYLE	53	Style de police
SRW_DISPLAY_TAG	FONTWEIGHT	54	Graisse de la police
SRW_DISPLAY_TAG	FONTSIZE	55	Taille de la police
SRW_DISPLAY_TAG	DASHSTYLE	56	Apparence des tirets
SRW_DISPLAY_TAG	CAPSTYLE	57	Style des lettres majuscules
SRW_DISPLAY_TAG	JOINSTYLE	58	Style des lignes jointes
SRW_DISPLAY_TAG	LINEPAT	59	Motif de ligne
SRW_DISPLAY_TAG	FILLPAT	59	Motif de remplissage


RWECAT

Cette sortie utilisateur concatène des chaînes, en ajoutant la source à la fin de la destination. Cette sortie utilisateur concatène des chaînes, en ajoutant la source à la fin de la destination.

Syntaxe

SRW.USER_EXIT('rwecat source destination');

où :

source	Indique la chaîne à concaténer.

destination	Indique le nom de l'objet Report Builder dans lequel sera placée la chaîne.


RWECPF

Cette sortie utilisateur copie les données dans source et place le résultat dans destination.

Syntaxe

SRW.USER_EXIT('rwecpf source destination');

où :

source	Indique le nom de l'objet Report Builder dont la valeur doit être copiée.

destination	Indique le nom de l'objet Report Builder dans lequel sera placée la valeur.

Remarque : RWECPF est utile pour les types LONG, LONG RAW et RAW en raison de la limite de PL/SQL fixée à 256 caractères. RWECPF accepte 64 000 octets.


RWECTY

Cette sortie utilisateur convertit les propriétés de colonne et les informations source en une chaîne de type colonne, extraite du fichier de messages Report Builder. Les valeurs entrées doivent être les colonnes FLAGS et SOURCE de la table SRW2_COLUMN. Cette sortie utilisateur est utilisée par Report Builder lors de la documentation d'états stockés dans la base de données à l'aide de Fichier [image] Administration [image] Etat sur états.

Syntaxe

SRW.USER_EXIT('rwecty flag source destination');

où :

flag	Indique la valeur de la colonne FLAGS de la table SRW2_COLUMN pour l'objet dont la valeur doit être copiée.

source	Indique le nom de l'objet Report Builder dont la valeur doit être copiée.

destination	Indique le nom de l'objet Report Builder dans lequel sera placée la valeur.


RWEPLS

Cette sortie utilisateur convertit le code source PL/SQL, stocké dans des colonnes LONG RAW, en texte source PL/SQL. Cette sortie utilisateur est utilisée par Report Builder lors de la documentation de vos états, stockés dans la base de données, à l'aide de Fichier [image] Administration [image] Etat sur états.

Syntaxe

SRW.USER_EXIT('rwepls source1 source2 destination');

où :

source1	Indique le MODID de l'objet source (par exemple, un champ) des tables Report Builder.

source2	Indique l'ID de l'objet source (par exemple, un champ) des tables Report Builder.

destination	Indique une colonne de formule, de type caractère, à laquelle est attribué le texte du code Source PL/SQL.


Fin de sortie utilisateur - Exemple

  Rubriques connexes 	  Tous les exemples

Cet exemple illustre :

  Un appel à une sortie utilisateur

  La sortie utilisateur

Report Builder est livré avec un exemple d'état qui utilise une sortie utilisateur appelée userexit.rdf. L'emplacement de l'état est fonction de votre système d'exploitation.


Appel de sortie utilisateur - Exemple

  Rubriques connexes 	  Tous les exemples

Vous voulez appeler la sortie utilisateur UE_EMP_PLAN. A partir d'une colonne de formule, entrez la fonction suivante :

function CF_Set_PlanFormula return Number is
begin
/* Appeler la sortie utilisateur pour définir la colonne de réserve CP_PLAN */
srw.user_exit('UE_EMP_PLAN CP_PLAN');
  return 1;
exception
  when srw.user_exit_failure then
/* La sortie utilisateur n'a pas retourné de chaîne pour cette */
/* valeur NOEMP                                */     srw.message(1000,
       ' La sortie utilisateur n'a pas retourné de plan pour Noemp: '||
       to_char(:Noemp));
  :CP_Plan := 'Pas de plan';
  return 1;
end;


Sortie utilisateur - Exemple

  Rubriques connexes 	  Tous les exemples

L'exemple de sortie utilisateur ci-dessous se trouve dans le fichier ue_samp1.pc.

EXEC SQL INCLUDE SQLCA;

/* Définir des variables locales à utiliser dans la routine testexit ci-dessous. */
EXEC SQL BEGIN DECLARE SECTION;
     varchar  targetcol[250];    /* nom de cible OU col */
     varchar  empid[50];         /* valeur de Noemp OU col */
     varchar  plan[250];         /* chaîne de plan */
EXEC SQL END DECLARE SECTION;#include <string.h>
#include <ue.h>
/*--------------------------------------------------------------+
 | ue_emp_plan:
 | ------------
 |
 | Cette sortie utilisateur PCC a été écrite pour illustrer à un
 | niveau très simple l'interaction entre une sortie utilisateur PCC
 | et un document Report Builder. Elle illustre les fonctions
 | suivantes :
 |  * Lecture d'une colonne Report Builder à partir d'une sortie utilisateur
 |  * Définition d'une colonne Report Builder à partir d'une sortie utilisateur
 |  * Retour d'une erreur à Report Builder
 | La seule hypothèse est qu'elle est appelée à partir
 | d'un document Report Builder comportant les colonnes suivantes :
 |
 |   noemp  NUMBER    (Valeur lue dans sortie utilisateur)
 |
 | Cet exemple (relativement limité) consulte une table prédéfinie,
 | "ue_samp_plan", qui associe différents employés à une
 | chaîne de texte indiquant leurs plans, une citation favorite ou
 | une idée personnelle. Par exemple,
 |       Matricule #                  Plan
 |       ---------                   ----
 |       7856                        "Vacances à Hawaii jusqu'au 1er janvier 1995
 |
 | Dans cette sortie utilisateur, nous extrayons l'ID employé de la colonne d'état
 | NOEMP, consultons la table "ue_samp_plan", extrayons
 | le "plan" associé et définissons la colonne <cible> indiquée dans la
 | chaîne de paramètres. Pour illustrer la gestion des erreurs, nous retournons
 | une erreur si l'ID employé n'existe pas dans la table.
 |
 | La chaîne de paramètres de cette sortie utilisateur doit indiquer exactement
 | un (1) identificateur qui indique la colonne Cible (Report Builder)
 | dans laquelle le "plan" doit être copié. (Cette fonction illustre
 | l'utilisation de EXEC IAF PUT avec des variables hôtes.)
 |
 | Par exemple, SRW.USER_EXIT('PLAN ue_emp_plan') aura le résultat suivant :
 |
 |    + La colonne NOEMP de Report Builder sera entrée dans "IDEmp".
 |    + La colonne PLAN de Report Builder sera définie avec la chaîne "plan"
 |      associée à la valeur de IDEmp.
 |    + Si aucune correspondance n'est trouvée, une erreur sera générée.
 |
 | Les ID employé de la table ue_samp_plan correspondent à ceux des tables
 | SCOTT/TIGER DEMO.
 |
 +------------------------------------------------------------------------------------------*/
typedef struct empplan
{
  int empid;
  char   *plan;
} empplan;
empplan ue_samp_plan[] =
{
  { 7369, "Vacances à Hawaii à partir du 1er janvier 1995"},
  { 7499, "Non à la guerre !"},
  { 7521, "Aidez les pauvres musiciens. Apprenez la musique !"},
  { 7566, "Les électrons sont 100 % recyclables."},
  { 7654, "Impressionner CHRISTIANE BRINKLEY avec des réparties astucieuses
           sur le sujet"},
  { 7698, "Etude de production"},
  { 7782, "Desktop - Oracle 7 pour Windows"},
  { 7788, "Pas de problème"},
  { 7839, "But : retraite à 45 ans"},
  { 7844, "Devenir hippie !"},
  { 7876, "Derniers mots célèbres - Ça doit marcher !"},
  { 7900, "Assister à toutes les réunions - envoyer des courriers"}
  /* 7902 et 7934 non inclus pour illustrer la gestion des erreurs */
};

int ue_emp_plan(ue_options, ue_strlen)
char    *ue_options;        /* ligne de commande */
int     *ue_strlen;         /* longueur de la ligne de commande */
{
    int i;
    char *sep = " "; /* Séparateurs de sèmes pour l'analyse des options_ue */
    char *token;
   /*----------------------------------------------------------+
    | Définir le nom de la colonne cible Oracle Report à laquelle transférer
    | les chaînes de plan
    |
    | La chaîne de paramètres nous fournit ce nom.
    +-----------------------------------------------------------*/
    token = strtok(ue_options, sep);  /* Nom de UE */
    token = strtok((char*) 0, sep);   /* Paramètre - Col cible */

    (void) strcpy(targetcol.arr, token);
    targetcol.len = strlen(ue_options);

   /*------------------------------------------------------------+
    | Extraire valeur NOEMP - EXEC IAF GET. Remarque : Comme idemp est déclaré
    | de type VARCHAR, la conversion implicite de NUMBER à VARCHAR est exécutée.
    +-----------------------------------------------------------*/

    EXEC IAF GET EMPNO INTO :idemp;
    /*-------------------------------------------------+
     | Rechercher l'idemp dans la table ue_samp_plan
     +-------------------------------------------------*/
    for (i=0; i<sizeof(ue_samp_plan)/sizeof(empplan); i++)
    {
        if (ue_samp_plan [i].idemp == atoi(idemp.arr))
        {
           /*
            | idemp trouvé, copier le plan dans la colonne cible
            | Le nom de la colonne cible est dans la variable hôte "colcible".
            */
           plan.len = strlen(ue_samp_plan [i].plan);
           (void) strcpy(plan.arr, ue_samp_plan [i].plan);

           EXEC IAF PUT :targetcol VALUES (:plan);

           return 0;      /* retour exécuté correctement */
        }
    }
/*-------------------------------------------------------------+
 | Erreur : nous n'avons pas trouvé de correspondance.
 |
 | Définir SRWERB pour générer l'exception SRW.USER_EXIT_FAILURE. Voir les explications
 | dans ue.h.
 +-------------------------------------------------------------*/
    (void) strcpy(SRWERB, "Erreur - Aucun plan trouvé");
    return 1;             /* Echec de retour */
}


Attributs HTML

  Restrictions 	  Rubriques connexes

Lorsque vous créez un état en vue d'une sortie HTML, vous pouvez lui affecter des attributs Web. Pour cela, utilisez SRW.SET_ATTR ou les procédures de définition d'attributs. SRW.SET_ATTR est pris en charge pour des raisons de compatibilité avec les versions antérieures, mais il est fortement recommandé d'utiliser les nouvelles procédures simplifiées.

Les attributs Web utilisables pour la sortie HTML par l'intermédiaire de SRW.SET_ATTR sont les suivants :

  HYPERLINK

  BOOKMARK

  BOOKMARK

  LINKTAG

  BEFREPORT_ESCAPE

  AFTREPORT_ESCAPE

  BEFPAGE_ESCAPE

  AFTPAGE_ESCAPE

  BEFFORM_ESCAPE

  AFTFORM_ESCAPE


Attributs PDF

  Restrictions 	  Rubriques connexes

Lorsque vous créez un état en vue d'une sortie HTML, vous pouvez lui affecter des attributs Web. Pour cela, utilisez SRW.SET_ATTR ou les SRW.SET_ATTRou les procédures de définition d'attributs. SRW.SET_ATTR est pris en charge pour des raisons de compatibilité avec les versions antérieures, mais il est fortement recommandé d'utiliser les nouvelles procédures simplifiées.

Les attributs Web utilisables pour la sortie HTML par l'intermédiaire de SRW.SET_ATTR sont les suivants :

  HYPERLINK

  BOOKMARK

  ACTION

  LINKTAG


Notes d'utilisation de HTML

•	Vous pouvez définir Report Builder de façon à ce qu'il affiche automatiquement la sortie de votre état dans votre navigateur Web, en cliquant sur l'outil Aperçu Web dans la vue Aperçu interactif.

•	Les signets déclenchent la création de plusieurs fichiers HTML : un fichier maître avec deux encadrements, un pour les signets et un pour la sortie de l'état ; un fichier HTML pour chacun de ces encadrements. Le nom de fichier du document maître est le nom indiqué dans le paramètre DESNAME. Le nom de fichier de signets est desnameb.htm. Le nom du fichier de sortie d'état est desnamed.htm.

•	Les images liées, les champs d'image et les graphiques d'un état déclenchent la création de fichiers GIF et leur référence à partir du document HTML. Notez qu'un nouveau fichier GIF est généré, même si le champ d'image ou de texte standard lié fait référence à un fichier GIF externe,

•	Si la base de données comporte une image, le programme peut générer un fichier GIF pour chaque occurrence de l'image dans l'état. Si une image est stockée dans un fichier (par exemple, images importées, texte standard lié ou champs d'image faisant référence à des fichiers), le programme ne générera qu'un fichier GIF par image, quel que soit le nombre de fois où elle se répète dans l'état.

•	Les fichiers d'image GIF générés pour la sortie HTML ont un numéro de séquence (par exemple, desname0.gif ... desname17.gif).

•	Les boutons avec libellés de texte sont convertis en texte. Les boutons avec icône sont convertis en fichiers GIF. Dans un cas comme dans l'autre, les informations de liaison sont maintenues.

•	Dans le document maître, un bloc de commentaires contient le nom de tous les fichiers associés au document maître.

•	HTML comporte différentes tailles de polices de texte. La comparaison des tailles de police de l'état utilise le tableau ci-dessous. Notez que l'utilisateur peut remplacer la taille indiquée dans le fichier HTML à partir de son explorateur.

Taille de polices d'état	Taille HTML
inférieure à 8	1
8 à 9	2
10 à 12	3
13 à 15	4
16 à 20	5
21 à 30	6
plus de 30	7

•	Si la police utilisée dans l'état est non proportionnelle, le mode TeleType est activé pour le fichier HTML généré.

•	Dans HTML, le concept de page n'existe pas. Les pages de l'état sont séparées par des lignes de séparation. C'est l'explorateur qui détermine si vous devez, ou non, faire défiler l'écran pour voir la totalité de la page de l'état. En outre, si vous imprimez le document HTML à partir de votre explorateur, l'imprimante n'imprime pas obligatoirement les lignes de séparation au bas de chaque page. Si vous ne voulez pas les voir ou si vous voulez utiliser une ligne de séparation différente, vous pouvez utiliser SRW.SET_AFTER_PAGE_HTML pour la modifier.


HTML - Restrictions

•	Des objets ne peuvent pas se chevaucher. Par exemple, vous ne pouvez pas avoir du texte sur une image.

•	Si les objets se chevauchent légèrement (d'un maximum de 2 caractères), l'objet sous-jacent est tronqué.

•	Si les objets se chevauchent beaucoup (ou si un objet en recouvre complètement un autre), l'objet sous-jacent est totalement supprimé. Dans ce cas, les informations de liaison de l'objet supprimé sont transférées selon les mêmes règles que s'il s'agissait d'un encadrement (voir ci-après les règles concernant les encadrements).

•	Le texte a toujours priorité sur les lignes horizontales, quel que soit celui qui recouvre l'autre - pour éviter que le trait qui souligne un libellé de colonne élimine le texte du libellé.

•	Lors de la génération de plusieurs fichiers de sortie (par exemple, en cas d'utilisation de signets), tous les fichiers, à l'exception du fichier maître, sont remplacés sans confirmation. Par exemple, les fichiers GIF et les fichiers de signets sont écrasés sans qu'un message vous demande de confirmer l'opération. Les notes d'utilisation HTML expliquent les cas de génération de plusieurs fichiers.

•	Dans la sortie HTML, les encadrements d'état ne sont pas visibles. Les attributs de remplissage ou de bordure des encadrements n'apparaissent pas dans la sortie HTML.

•	Si l'encadrement d'un état est la cible d'un lien ou d'un signet, cet attribut est transféré à l'objet visible le plus proche de l'angle supérieur gauche de l'encadrement au format HTML. Si l'objet encadrement est un hyperlien, cet attribut est transféré à tous les objets fils (intérieurs) qui ne sont pas des hyperliens. Si l'attribut d'hyperlien ne peut pas être transféré aux objets fils, l'hyperlien de l'encadrement est perdu.

•	Le seul objet de dessin pris en charge par HTML est une ligne horizontale continue noire. Selon l'explorateur la largeur de la ligne indiquée dans l'état est ou non prise en compte. Tous les autres objets de dessin (par exemple, rectangles ou cercles de la présentation de l'état) n'apparaissent pas dans la sortie HTML. La place qu'ils occupent est réservée, mais ils ne sont pas représentés visuellement sur la sortie HTML.

•	Dans la sortie HTML, les couleurs/motifs du fond (remplissage) et de la bordure (lignes) du texte n'existent pas. Le gras, l'italique, le souligné et la couleur de premier plan (texte) sont pris en charge si l'explorateur les prend en charge.

•	L'attribut d'action PDF n'est pas pris en compte pour la sortie HTML.

•	Les objets OLE ne sont pas pris en compte lors de la génération des sorties PDF ou HTML, mais l'espace correspondant est réservé dans la sortie.

•	Les personnalisations apportées à l'explorateur affecteront la façon dont la sortie HTML générée est affichée.


PDF - Restrictions

•	Pour les sorties PDF, les pilotes bitmap (par exemple, PostScript) de l'imprimante sélectionnée sont utilisés pour produire la sortie. Vous devez avoir une imprimante bitmap configurée pour la machine sur laquelle vous exécutez l'état.

•	Les objets OLE ne sont pas pris en compte lors de la génération des sorties PDF ou HTML, mais l'espace correspondant est réservé dans la sortie.

•	La largeur maximale de page d'Adobe Acrobat Reader est de 45 pouces. Si la page de votre état dépasse cette valeur et que vous générez une sortie PDF, Acrobat Reader ne l'affiche pas.


Default HtmlWinHelp URL Topic